@tapsilat/tapsilat-js 1.0.2

package/CHANGELOG.md

@@ -0,0 +1,34 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- Initial SDK implementation
+- Payment operations (create, get, list, cancel)
+- Refund operations (create, get, list)
+- Customer operations (CRUD)
+- Webhook verification
+- TypeScript support
+- Comprehensive error handling
+- Input validation and sanitization
+- Retry mechanism with exponential backoff
+- Zero external dependencies
+
+### Security
+- Automatic metadata sanitization
+- HMAC-SHA256 webhook verification
+- Input validation for all requests
+
+## [1.0.0] - 2024-12-XX
+
+### Added
+- Initial release of Tapsilat JS SDK
+- Full TypeScript support
+- Modern fetch-based HTTP client
+- Comprehensive test suite
+- Documentation and examples 

package/LICENSE

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

package/README.md

@@ -0,0 +1,257 @@
+# Tapsilat TypeScript SDK
+
+<div align="center">
+
+[![Tapsilat Logo](https://tapsilat.dev/assets/logo.png)](https://tapsilat.dev)
+
+**Enterprise-grade TypeScript SDK for Tapsilat Payment Processing Platform**
+
+[![npm version](https://img.shields.io/npm/v/tapsilat-js.svg?style=flat-square)](https://www.npmjs.com/package/tapsilat-js)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0+-blue.svg?style=flat-square)](https://www.typescriptlang.org/)
+[![MIT License](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
+
+</div>
+
+## 🏢 About Tapsilat
+
+**Tapsilat** is Turkey's leading fintech platform providing comprehensive payment processing solutions for businesses of all sizes. Our cutting-edge technology enables secure, fast, and reliable payment transactions with support for multiple payment methods, currencies, and advanced fraud protection.
+
+---
+
+## 🚀 Installation
+
+```bash
+npm install @tapsilat/tapsilat-js
+```
+
+---
+
+## ⚡ Quick Start
+
+### Initialize the SDK
+
+```typescript
+import { TapsilatSDK } from "@tapsilat/tapsilat-js";
+
+const tapsilat = new TapsilatSDK({
+  bearerToken: process.env.TAPSILAT_BEARER_TOKEN!,
+  baseURL: "https://acquiring.tapsilat.dev/api/v1",
+});
+```
+
+### Create an Order
+
+```typescript
+const order = await tapsilat.createOrder({
+  amount: 150.75,
+  currency: "TRY",
+  locale: "tr",
+  buyer: {
+    name: "John",
+    surname: "Doe",
+    email: "john.doe@example.com",
+    phone: "+905551234567",
+  },
+  description: "Premium subscription - Monthly plan",
+});
+```
+
+### Check Order Status
+
+```typescript
+const status = await tapsilat.getOrderStatus(order.reference_id);
+console.log("Order status:", status.status);
+```
+
+---
+
+## 📖 API Methods & Examples
+
+### Order Management
+
+#### Create Order
+```typescript
+const order = await tapsilat.createOrder({
+  amount: 299.99,
+  currency: 'TRY',
+  locale: 'tr',
+  buyer: {
+    name: 'Ahmet',
+    surname: 'Yılmaz',
+    email: 'ahmet@example.com',
+    phone: '+905551234567'
+  },
+  description: 'Product purchase',
+  callbackUrl: 'https://mystore.com/success',
+  metadata: {
+    productId: 'PROD_123',
+    campaignCode: 'DISCOUNT20'
+  }
+});
+```
+
+#### Get Order Details
+```typescript
+const order = await tapsilat.getOrder('order-reference-id');
+console.log('Order amount:', order.amount);
+console.log('Order status:', order.status);
+```
+
+#### Check Order Status
+```typescript
+const status = await tapsilat.getOrderStatus('order-reference-id');
+if (status.status === 'completed') {
+  console.log('Payment successful!');
+}
+```
+
+#### List Orders
+```typescript
+const orders = await tapsilat.getOrders({ page: 1, per_page: 10 });
+orders.rows.forEach(order => {
+  console.log(`Order ${order.reference_id}: ${order.amount} ${order.currency}`);
+});
+```
+
+#### Cancel Order
+```typescript
+try {
+  await tapsilat.cancelOrder('order-reference-id');
+  console.log('Order cancelled successfully');
+} catch (error) {
+  console.error('Cannot cancel order:', error.message);
+}
+```
+
+### Payment Operations
+
+#### Get Payment Details
+```typescript
+const paymentDetails = await tapsilat.getOrderPaymentDetails('order-reference-id');
+paymentDetails.forEach(detail => {
+  console.log(`Payment: ${detail.amount} ${detail.currency}`);
+});
+```
+
+#### Get Transaction History
+```typescript
+const transactions = await tapsilat.getOrderTransactions('order-reference-id');
+transactions.forEach(tx => {
+  console.log(`${tx.type}: ${tx.amount} on ${tx.created_at}`);
+});
+```
+
+#### Get Checkout URL
+```typescript
+const checkoutUrl = await tapsilat.getCheckoutUrl('order-reference-id');
+// Redirect customer to checkout
+window.location.href = checkoutUrl;
+```
+
+### Refund Operations
+
+#### Process Partial Refund
+```typescript
+const refund = await tapsilat.refundOrder({
+  reference_id: 'order-reference-id',
+  amount: 50.00,
+  reason: 'Customer request',
+  metadata: {
+    refundType: 'partial',
+    ticketId: 'TICKET_789'
+  }
+});
+console.log('Refund ID:', refund.id);
+```
+
+#### Process Full Refund
+```typescript
+const fullRefund = await tapsilat.refundAllOrder('order-reference-id');
+console.log('Full refund processed:', fullRefund.amount);
+```
+
+### Webhook Handling
+
+#### Verify Webhook Signature
+```typescript
+import express from 'express';
+
+const app = express();
+app.use(express.raw({ type: 'application/json' }));
+
+app.post('/webhooks/tapsilat', async (req, res) => {
+  const payload = req.body.toString();
+  const signature = req.headers['x-tapsilat-signature'];
+  
+  const isValid = await tapsilat.verifyWebhook(
+    payload, 
+    signature, 
+    process.env.WEBHOOK_SECRET
+  );
+  
+  if (!isValid) {
+    return res.status(401).json({ error: 'Invalid signature' });
+  }
+  
+  const event = JSON.parse(payload);
+  
+  switch (event.type) {
+    case 'order.completed':
+      console.log('Order completed:', event.data.reference_id);
+      // Process successful payment
+      break;
+    case 'order.failed':
+      console.log('Order failed:', event.data.reference_id);
+      // Handle failed payment
+      break;
+  }
+  
+  res.json({ received: true });
+});
+```
+
+### Health Monitoring
+
+#### API Health Check
+```typescript
+const health = await tapsilat.healthCheck();
+console.log('API Status:', health.status);
+console.log('Timestamp:', health.timestamp);
+```
+
+---
+
+## 🔐 Authentication
+
+Use Bearer Token authentication:
+
+```typescript
+const tapsilat = new TapsilatSDK({
+  bearerToken: process.env.TAPSILAT_BEARER_TOKEN!,
+});
+```
+
+Get your API token from the [Tapsilat Dashboard](https://tapsilat.dev) → Settings → API Keys
+
+---
+
+## 📜 License
+
+This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
+
+---
+
+## 🔗 Resources
+
+- 🌐 **Website**: [https://tapsilat.dev](https://tapsilat.dev)
+- 📚 **API Documentation**: [https://docs.tapsilat.dev](https://docs.tapsilat.dev)
+- 📞 **Support**: [support@tapsilat.dev](mailto:support@tapsilat.dev)
+- 🐛 **Issues**: [GitHub Issues](https://github.com/tapsilat/tapsilat-js/issues)
+
+---
+
+<div align="center">
+
+[![Tapsilat](https://img.shields.io/badge/Tapsilat-Payment%20Solutions-blue?style=for-the-badge)](https://tapsilat.dev)
+
+</div>

package/dist/TapsilatSDK.d.ts

@@ -0,0 +1,293 @@
+import { TapsilatConfig, PaginatedResponse, Order, OrderRefundRequest, OrderRefundResponse, OrderStatusResponse, OrderPaymentDetail, Address, Currency } from "./types";
+/**
+ * Supported locales for the Tapsilat API.
+ */
+export type Locale = "tr" | "en";
+/**
+ * Represents the buyer information.
+ * Based on BuyerDTO from the Python SDK.
+ */
+export interface Buyer {
+    name: string;
+    surname: string;
+    email: string;
+    phone?: string;
+    identityNumber?: string;
+    shippingAddress?: Address;
+    billingAddress?: Address;
+}
+/**
+ * Represents the data required to create a new order.
+ * Based on OrderCreateDTO from the Python SDK.
+ */
+export interface OrderCreateRequest {
+    amount: number;
+    currency: Currency;
+    locale: Locale;
+    buyer: Buyer;
+    description?: string;
+    callbackUrl?: string;
+    conversationId?: string;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Represents the response received after creating an order.
+ */
+export interface OrderCreateResponse {
+    referenceId: string;
+    conversationId: string;
+    checkoutUrl: string;
+    status: string;
+    qrCodeUrl?: string;
+}
+/**
+ * Main SDK class for Tapsilat payment operations
+ *
+ * @example
+ * ```typescript
+ * const tapsilat = new TapsilatSDK({
+ *   bearerToken: 'your-bearer-token',
+ *   baseURL: 'https://api.tapsilat.com/v1'
+ * });
+ *
+ * const payment = await tapsilat.createPayment({
+ *   amount: 100.50,
+ *   currency: 'TRY',
+ *   paymentMethod: 'credit_card'
+ * });
+ * ```
+ */
+export declare class TapsilatSDK {
+    private readonly httpClient;
+    private readonly config;
+    /**
+     * Creates a new TapsilatSDK instance
+     *
+     * @param config - SDK configuration options
+     * @throws {TapsilatValidationError} When Bearer token is invalid
+     */
+    constructor(config: TapsilatConfig);
+    /**
+     * Creates a new order and returns a checkout URL.
+     *
+     * @param orderRequest - The order details including amount, currency, and buyer information
+     * @returns Promise resolving to the created order response including reference ID and checkout URL
+     * @throws {TapsilatValidationError} When order request data is invalid
+     * @throws {TapsilatNetworkError} When API request fails due to network issues
+     * @throws {TapsilatError} When API returns an error response
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const orderResponse = await tapsilat.createOrder({
+     *     amount: 100.50,
+     *     currency: 'TRY',
+     *     locale: 'en',
+     *     buyer: {
+     *       name: 'John',
+     *       surname: 'Doe',
+     *       email: 'john.doe@example.com'
+     *     }
+     *   });
+     *   console.log(`Checkout URL: ${orderResponse.checkoutUrl}`);
+     * } catch (error) {
+     *   console.error(`Order creation failed: ${error.message}`);
+     * }
+     * ```
+     */
+    createOrder(orderRequest: OrderCreateRequest): Promise<OrderCreateResponse>;
+    /**
+     * Validates an order request object
+     * @private
+     */
+    private validateOrderRequest;
+    /**
+     * Basic email validation
+     * @private
+     */
+    private isValidEmail;
+    /**
+     * Generic response handler - consistent way to handle API responses across SDK methods
+     * @private
+     *
+     * @param response - The API response to process
+     * @param errorContext - Descriptive context for error messages
+     * @returns The data from a successful response
+     * @throws {TapsilatError} On any response error
+     */
+    private handleResponse;
+    /**
+     * Generic error handler - consistent way to handle errors across SDK methods
+     * @private
+     *
+     * @param error - The caught error to process
+     * @param errorContext - Descriptive context for error messages
+     * @throws {TapsilatError} Always throws an appropriate error type
+     */
+    private handleError;
+    /**
+     * Gets an order by reference ID.
+     *
+     * @param referenceId - The unique reference ID of the order
+     * @returns Promise resolving to the complete order details
+     * @throws {TapsilatValidationError} When referenceId is invalid
+     * @throws {TapsilatNetworkError} When API request fails due to network issues
+     * @throws {TapsilatError} When API returns an error response
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const order = await tapsilat.getOrder("ord_123456789");
+     *   console.log(`Order amount: ${order.amount} ${order.currency}`);
+     * } catch (error) {
+     *   console.error(`Failed to get order: ${error.message}`);
+     * }
+     * ```
+     */
+    getOrder(referenceId: string): Promise<Order>;
+    /**
+     * Lists orders with pagination support.
+     *
+     * @param params - Optional pagination parameters (page number and items per page)
+     * @returns Promise resolving to paginated list of orders
+     * @throws {TapsilatNetworkError} When API request fails due to network issues
+     * @throws {TapsilatError} When API returns an error response
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   // Get the second page with 20 items per page
+     *   const orderList = await tapsilat.getOrders({ page: 2, per_page: 20 });
+     *   console.log(`Total orders: ${orderList.total}`);
+     *   orderList.rows.forEach(order => {
+     *     console.log(`Order ${order.referenceId}: ${order.amount} ${order.currency}`);
+     *   });
+     * } catch (error) {
+     *   console.error(`Failed to list orders: ${error.message}`);
+     * }
+     * ```
+     */
+    getOrders(params?: {
+        page?: number;
+        per_page?: number;
+    }): Promise<PaginatedResponse<Order>>;
+    /**
+     * Cancels an order by reference_id.
+     */
+    cancelOrder(referenceId: string): Promise<Order>;
+    /**
+     * Gets the status of an order by reference ID.
+     *
+     * @param referenceId - The unique reference ID of the order
+     * @returns Promise resolving to the current order status, including status code and last update time
+     * @throws {TapsilatValidationError} When referenceId is invalid
+     * @throws {TapsilatNetworkError} When API request fails due to network issues
+     * @throws {TapsilatError} When API returns an error response
+     *
+     * @example
+     * ```typescript
+     * try {
+     *   const orderStatus = await tapsilat.getOrderStatus("ord_123456789");
+     *   console.log(`Order status: ${orderStatus.status}`);
+     * } catch (error) {
+     *   if (error instanceof TapsilatValidationError) {
+     *     console.error("Invalid reference ID format");
+     *   } else if (error instanceof TapsilatError) {
+     *     console.error(`API error: ${error.message}`);
+     *   }
+     * }
+     * ```
+     */
+    getOrderStatus(referenceId: string): Promise<OrderStatusResponse>;
+    /**
+     * Partially refunds an order.
+     * Based on `refund_order` from the Python SDK.
+     *
+     * @param refundData - The refund details, including referenceId and amount.
+     * @returns Promise resolving to the refund transaction details.
+     */
+    refundOrder(refundData: OrderRefundRequest): Promise<OrderRefundResponse>;
+    /**
+     * Fully refunds an order by its reference ID.
+     * Based on `refund_all_order` from the Python SDK.
+     *
+     * @param referenceId - The unique identifier of the order to fully refund.
+     * @returns Promise resolving to the refund transaction details.
+     */
+    refundAllOrder(referenceId: string): Promise<OrderRefundResponse>;
+    /**
+     * Retrieves the payment details for an order.
+     * Based on `get_order_payment_details` from the Python SDK.
+     *
+     * @param referenceId - The unique identifier of the order.
+     * @param conversationId - Optional conversation ID for more specific querying.
+     * @returns Promise resolving to a list of payment details.
+     */
+    getOrderPaymentDetails(referenceId: string, conversationId?: string): Promise<OrderPaymentDetail[]>;
+    /**
+     * Gets an order by conversation_id.
+     * Based on `get_order_by_conversation_id` from the Python SDK.
+     */
+    getOrderByConversationId(conversationId: string): Promise<Order>;
+    /**
+     * Gets order transactions by reference_id.
+     * Based on `get_order_transactions` from the Python SDK.
+     */
+    getOrderTransactions(referenceId: string): Promise<any[]>;
+    /**
+     * Gets order submerchants with pagination.
+     * Based on `get_order_submerchants` from the Python SDK.
+     */
+    getOrderSubmerchants(params?: {
+        page?: number;
+        per_page?: number;
+    }): Promise<any>;
+    /**
+     * Gets checkout URL for an order.
+     * Based on `get_checkout_url` from the Python SDK.
+     */
+    getCheckoutUrl(referenceId: string): Promise<string>;
+    /**
+     * Verifies webhook signature for security
+     *
+     * @param payload - Raw webhook payload string
+     * @param signature - Webhook signature from headers
+     * @param secret - Your webhook secret key
+     * @returns Promise resolving to true if signature is valid
+     *
+     * @example
+     * ```typescript
+     * const isValid = await sdk.verifyWebhook(
+     *   JSON.stringify(req.body),
+     *   req.headers['x-tapsilat-signature'],
+     *   'your-webhook-secret'
+     * );
+     * ```
+     */
+    verifyWebhook(payload: string, signature: string, secret: string): Promise<boolean>;
+    /**
+     * Checks API service health and availability
+     *
+     * @returns Promise resolving to service status
+     */
+    healthCheck(): Promise<{
+        status: string;
+        timestamp: string;
+    }>;
+    /**
+     * Gets current SDK configuration (without sensitive data)
+     *
+     * @returns Copy of current configuration
+     */
+    getConfig(): Omit<TapsilatConfig, "bearerToken"> & {
+        hasBearerToken: boolean;
+    };
+    /**
+     * Updates SDK configuration
+     *
+     * @param newConfig - Partial configuration to update
+     * @throws {TapsilatValidationError} When Bearer token is invalid
+     */
+    updateConfig(newConfig: Partial<TapsilatConfig>): void;
+}
+//# sourceMappingURL=TapsilatSDK.d.ts.map

package/dist/TapsilatSDK.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TapsilatSDK.d.ts","sourceRoot":"","sources":["../src/TapsilatSDK.ts"],"names":[],"mappings":"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"}

package/dist/errors/TapsilatError.d.ts

@@ -0,0 +1,22 @@
+import { APIError } from '../types';
+export declare class TapsilatError extends Error {
+    readonly code: string;
+    readonly details?: Record<string, any>;
+    constructor(message: string, code: string, details?: Record<string, any>);
+    static fromAPIError(apiError: APIError): TapsilatError;
+}
+export declare class TapsilatNetworkError extends TapsilatError {
+    readonly statusCode?: number;
+    constructor(message: string, code: string, statusCode?: number, details?: Record<string, any>);
+}
+export declare class TapsilatValidationError extends TapsilatError {
+    constructor(message: string, details?: Record<string, any>);
+}
+export declare class TapsilatAuthenticationError extends TapsilatError {
+    constructor(message?: string);
+}
+export declare class TapsilatRateLimitError extends TapsilatError {
+    readonly retryAfter?: number;
+    constructor(message?: string, retryAfter?: number);
+}
+//# sourceMappingURL=TapsilatError.d.ts.map

package/dist/errors/TapsilatError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TapsilatError.d.ts","sourceRoot":"","sources":["../../src/errors/TapsilatError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAEpC,qBAAa,aAAc,SAAQ,KAAK;IACtC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;gBAElC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAYxE,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,aAAa;CAGvD;AAED,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAK9F;AAED,qBAAa,uBAAwB,SAAQ,aAAa;gBAC5C,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;CAI3D;AAED,qBAAa,2BAA4B,SAAQ,aAAa;gBAChD,OAAO,GAAE,MAAgC;CAItD;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,SAAgB,UAAU,CAAC,EAAE,MAAM,CAAC;gBAExB,OAAO,GAAE,MAA8B,EAAE,UAAU,CAAC,EAAE,MAAM;CAKzE"}