Feature/typescript sdk

go-sdk/client/payment.go

@@ -12,26 +12,26 @@ import (
 
 // Payment represents a payment information
 type Payment struct {
-	PaymentID        string `json:"payment_id"`
-	AccountID        string `json:"account_id"`
-	TokenID          string `json:"token_id"`
-	ProductID        string `json:"product_id"`
-	ProductTokenID   string `json:"product_token_id"`
-	Count            int    `json:"count"`
-	Status           string `json:"status"`
-	PayerEmail       string `json:"payer_email,omitempty"`
-	CreatedAt        string `json:"created_at"`
-	UpdatedAt        string `json:"updated_at"`
-	PaidAt           string `json:"paid_at,omitempty"`
-	ClosedAt         string `json:"closed_at,omitempty"`
-	CloseReason      string `json:"close_reason,omitempty"`
-	TransactionHash  string `json:"transaction_hash,omitempty"`
-	BlockNumber      int64  `json:"block_number,omitempty"`
-	GasUsed          int64  `json:"gas_used,omitempty"`
-	GasPrice         string `json:"gas_price,omitempty"`
-	TotalAmount      string `json:"total_amount"`
-	FeeAmount        string `json:"fee_amount"`
-	RecipientAmount  string `json:"recipient_amount"`
+	PaymentID       string `json:"payment_id"`
+	AccountID       string `json:"account_id"`
+	TokenID         string `json:"token_id"`
+	ProductID       string `json:"product_id"`
+	ProductTokenID  string `json:"product_token_id"`
+	Count           int    `json:"count"`
+	Status          string `json:"status"`
+	PayerEmail      string `json:"payer_email,omitempty"`
+	CreatedAt       string `json:"created_at"`
+	UpdatedAt       string `json:"updated_at"`
+	PaidAt          string `json:"paid_at,omitempty"`
+	ClosedAt        string `json:"closed_at,omitempty"`
+	CloseReason     string `json:"close_reason,omitempty"`
+	TransactionHash string `json:"transaction_hash,omitempty"`
+	BlockNumber     int64  `json:"block_number,omitempty"`
+	GasUsed         int64  `json:"gas_used,omitempty"`
+	GasPrice        string `json:"gas_price,omitempty"`
+	TotalAmount     string `json:"total_amount"`
+	FeeAmount       string `json:"fee_amount"`
+	RecipientAmount string `json:"recipient_amount"`
 }
 
 // ListPaymentsResponse represents the response for listing payments
@@ -258,7 +258,6 @@ type PaymentReceiver struct {
 	Rate             string `json:"rate"`   // percentage
 }
 
-
 // ExternalCreatePaymentRequest represents the request for creating an external payment
 type ExternalCreatePaymentRequest struct {
 	ProductID      string `json:"product_id"`
@@ -277,7 +276,6 @@ type ExternalCreatePaymentResponse struct {
 	Decimals         int                `json:"decimals"`
 }
 
-
 // ExternalCreatePayment creates a new external payment
 func (c *Client) ExternalCreatePayment(req *ExternalCreatePaymentRequest) (*ExternalCreatePaymentResponse, error) {
 	reqBody, err := json.Marshal(req)

reddio-pay-sdk-ts/.gitignore

@@ -0,0 +1,30 @@
+# Dependencies
+node_modules/
+
+# Build outputs
+dist/
+*.tsbuildinfo
+
+# Environment files
+.env
+.env.local
+.env.*.local
+
+# Test configuration (contains API keys)
+test-config.js
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*

reddio-pay-sdk-ts/README.md

@@ -0,0 +1,179 @@
+# Reddio Pay TypeScript SDK
+
+TypeScript SDK for Reddio Pay services - A complete payment solution for crypto transactions.
+
+## Features
+
+- 🔐 Automatic JWT authentication and token refresh
+- 🛍️ Product management (create, list, manage digital products)
+- 💳 Payment processing (create orders, query status)
+- 🪙 Token support (multi-chain crypto tokens)
+- 📊 Payment analytics and reporting
+- 🔔 Webhook notifications
+- 📘 Full TypeScript support with type definitions
+- 🌐 Support for production and development environments
+
+## Installation
+
+```bash
+npm install reddio-pay-sdk
+# or
+yarn add reddio-pay-sdk
+```
+
+## Quick Start
+
+```typescript
+import { ReddioClient } from 'reddio-pay-sdk';
+
+// Create client for production environment
+const client = new ReddioClient({
+  apiKey: 'your-api-key',
+  environment: 'prod' // or 'dev' for development
+});
+
+// Initialize the client (authenticate)
+await client.initialize();
+
+// Get product list
+const products = await client.product.listProducts();
+console.log(`Found ${products.length} products`);
+
+// Clean up when done
+client.destroy();
+```
+
+## API Reference
+
+### Client Initialization
+
+```typescript
+// Standard initialization
+const client = new ReddioClient({
+  apiKey: 'your-api-key',
+  environment: 'prod', // 'prod' or 'dev'
+  timeout: 30000 // optional, default 30 seconds
+});
+
+// Factory methods
+const prodClient = ReddioClient.createProd('your-api-key');
+const devClient = ReddioClient.createDev('your-api-key');
+const customClient = ReddioClient.create('https://custom-url.com', 'your-api-key');
+```
+
+### Product Management
+
+```typescript
+// List all products
+const products = await client.product.listProducts();
+
+// Get product by ID
+const product = await client.product.getProduct('product_id');
+
+// Create new product
+const newProduct = await client.product.createProduct({
+  name: 'Premium Plan',
+  description: 'Full access to all features',
+  amount: '99.00',
+  currency: 'USD'
+});
+
+// Add token support to product
+await client.product.addProductToken('product_id', 'token_id');
+```
+
+### Payment Processing
+
+```typescript
+// Create payment order
+const payment = await client.payment.createPayment({
+  productId: 'product_id',
+  receiverEmail: 'customer@example.com',
+  amount: '99.00',
+  currency: 'USD',
+  description: 'Order #12345',
+  callbackUrl: 'https://your-site.com/callback'
+});
+
+// Get payment status
+const status = await client.payment.getPayment('payment_id');
+
+// List payment history
+const payments = await client.payment.listPayments({
+  limit: 10,
+  offset: 0
+});
+
+// Send payment success notification
+await client.payment.sendPaymentSuccessNotification({
+  paymentId: 'payment_id',
+  customMessage: 'Thank you for your purchase!'
+});
+```
+
+### Token Management
+
+```typescript
+// List available tokens
+const tokens = await client.token.listTokens();
+
+// Get token details
+const token = await client.token.getToken('token_id');
+
+// Create new token
+const newToken = await client.token.createToken({
+  name: 'USDT',
+  symbol: 'USDT',
+  chainId: 1,
+  contractAddress: '0x...'
+});
+```
+
+### Webhook Configuration
+
+```typescript
+// Update webhook URL
+await client.account.updateWebhook('https://your-site.com/webhook');
+```
+
+## Error Handling
+
+```typescript
+import { ReddioPayError, AuthenticationError, NetworkError } from 'reddio-pay-sdk';
+
+try {
+  await client.payment.createPayment(data);
+} catch (error) {
+  if (error instanceof AuthenticationError) {
+    console.error('Authentication failed:', error.message);
+  } else if (error instanceof NetworkError) {
+    console.error('Network error:', error.message);
+  } else {
+    console.error('Unknown error:', error);
+  }
+}
+```
+
+## Environment Variables
+
+Enable debug logging:
+```bash
+export LOG_LEVEL=debug
+```
+
+## Examples
+
+See the [examples](./examples) directory for more detailed usage examples.
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+MIT License - see the [LICENSE](LICENSE) file for details.
+
+## Support
+
+- GitHub Issues: [https://github.com/reddio-com/reddio-pay-sdk/issues](https://github.com/reddio-com/reddio-pay-sdk/issues)
+- Documentation: [https://docs.reddio.com](https://docs.reddio.com)