@caspay/sdk 1.0.0

package/dist/browser.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Browser bundle entry point
+ * Exposes CasPay SDK to window.CasPay for script tag usage
+ *
+ * @example
+ * ```html
+ * <script src="https://cdn.jsdelivr.net/npm/@caspay/sdk/dist/caspay.min.js"></script>
+ * <script>
+ *   const caspay = new CasPay({
+ *     apiKey: 'cp_live_...',
+ *     merchantId: 'MERCH_...'
+ *   });
+ * </script>
+ * ```
+ */
+import CasPay from './index';
+export default CasPay;

package/dist/caspay.min.js

@@ -0,0 +1 @@
+!function(t,e){"object"==typeof exports&&"undefined"!=typeof module?module.exports=e():"function"==typeof define&&define.amd?define(e):(t="undefined"!=typeof globalThis?globalThis:t||self).CasPay=e()}(this,function(){"use strict";class t{constructor(t){if(this.SDK_VERSION="1.0.0",this.baseUrl=t.baseUrl||"https://api.caspay.link",this.apiKey=t.apiKey,this.merchantId=t.merchantId,!this.apiKey)throw new Error("CasPay SDK: apiKey is required");if(!this.merchantId)throw new Error("CasPay SDK: merchantId is required")}async request(t,e,r){const s=`${this.baseUrl}${e}`;try{const e=await fetch(s,{method:t,headers:{"Content-Type":"application/json","X-CasPay-Key":this.apiKey,"X-CasPay-SDK-Version":this.SDK_VERSION,"User-Agent":`CasPay-SDK-JS/${this.SDK_VERSION}`},body:r?JSON.stringify(r):void 0}),i=await e.json();if(!e.ok){throw{error:i.error||"Request failed",code:i.code||"UNKNOWN_ERROR",status:e.status}}return i}catch(t){if(t.error&&t.code)throw t;throw{error:t.message||"Network error",code:"NETWORK_ERROR",status:0}}}getMerchantId(){return this.merchantId}}class e{constructor(t){this.client=t}async create(t){if(!t.senderAddress)throw{error:"senderAddress is required",code:"INVALID_PARAMS",status:400};if(!t.amount||t.amount<=0)throw{error:"amount must be greater than 0",code:"INVALID_PARAMS",status:400};if(!t.productId&&!t.subscriptionPlanId)throw{error:"Either productId or subscriptionPlanId is required",code:"INVALID_PARAMS",status:400};const e={merchant_id:this.client.getMerchantId(),sender_address:t.senderAddress,transaction_hash:t.transactionHash||`mock_tx_${Date.now()}`,product_id:t.productId,subscription_plan_id:t.subscriptionPlanId,amount:t.amount,currency:t.currency||"USD"};return this.client.request("POST","/api/v1/payments/record",e)}}class r{constructor(r){this.client=new t(r),this.payments=new e(this.client)}static get version(){return"1.0.0"}}return"undefined"!=typeof window&&(window.CasPay=r),r});

package/dist/core/client.d.ts

@@ -0,0 +1,14 @@
+import type { CasPayConfig } from '../types';
+/**
+ * HTTP Client for CasPay API
+ * Handles all API requests with authentication and error handling
+ */
+export declare class HttpClient {
+    private baseUrl;
+    private apiKey;
+    private merchantId;
+    private readonly SDK_VERSION;
+    constructor(config: CasPayConfig);
+    request<T>(method: string, path: string, body?: Record<string, any>): Promise<T>;
+    getMerchantId(): string;
+}

package/dist/index.d.ts

@@ -0,0 +1,38 @@
+import { Payments } from './resources/payments';
+import type { CasPayConfig } from './types';
+/**
+ * CasPay SDK
+ * Official JavaScript/TypeScript SDK for CasPay payment gateway
+ *
+ * @example
+ * ```typescript
+ * import CasPay from '@caspay/sdk';
+ *
+ * const caspay = new CasPay({
+ *   apiKey: 'cp_live_...',
+ *   merchantId: 'MERCH_...'
+ * });
+ *
+ * const payment = await caspay.payments.create({
+ *   senderAddress: '0x123...',
+ *   productId: 'prod_abc',
+ *   amount: 100
+ * });
+ * ```
+ */
+export default class CasPay {
+    /** Payments resource for creating and managing payments */
+    payments: Payments;
+    private client;
+    /**
+     * Create a new CasPay SDK instance
+     * @param config - SDK configuration
+     */
+    constructor(config: CasPayConfig);
+    /**
+     * Get SDK version
+     */
+    static get version(): string;
+}
+export { CasPay };
+export * from './types';

package/dist/index.esm.js

@@ -0,0 +1,160 @@
+/**
+ * HTTP Client for CasPay API
+ * Handles all API requests with authentication and error handling
+ */
+class HttpClient {
+    constructor(config) {
+        this.SDK_VERSION = '1.0.0';
+        // Use production API by default
+        this.baseUrl = config.baseUrl || 'https://api.caspay.link';
+        this.apiKey = config.apiKey;
+        this.merchantId = config.merchantId;
+        // Validate required config
+        if (!this.apiKey) {
+            throw new Error('CasPay SDK: apiKey is required');
+        }
+        if (!this.merchantId) {
+            throw new Error('CasPay SDK: merchantId is required');
+        }
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CasPay-Key': this.apiKey,
+                    'X-CasPay-SDK-Version': this.SDK_VERSION,
+                    'User-Agent': `CasPay-SDK-JS/${this.SDK_VERSION}`,
+                },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                const error = {
+                    error: data.error || 'Request failed',
+                    code: data.code || 'UNKNOWN_ERROR',
+                    status: response.status,
+                };
+                throw error;
+            }
+            return data;
+        }
+        catch (error) {
+            // Re-throw CasPay errors
+            if (error.error && error.code) {
+                throw error;
+            }
+            // Wrap network errors
+            throw {
+                error: error.message || 'Network error',
+                code: 'NETWORK_ERROR',
+                status: 0,
+            };
+        }
+    }
+    getMerchantId() {
+        return this.merchantId;
+    }
+}
+
+/**
+ * Payments Resource
+ * Handle payment creation and verification
+ */
+class Payments {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new payment record
+     *
+     * @param params - Payment parameters
+     * @returns Payment response with transaction details
+     * @throws {CasPayError} If payment creation fails
+     *
+     * @example
+     * ```typescript
+     * const payment = await caspay.payments.create({
+     *   senderAddress: '0x123...',
+     *   productId: 'prod_abc123',
+     *   amount: 100,
+     *   currency: 'USD'
+     * });
+     * ```
+     */
+    async create(params) {
+        // Validate required fields
+        if (!params.senderAddress) {
+            throw {
+                error: 'senderAddress is required',
+                code: 'INVALID_PARAMS',
+                status: 400,
+            };
+        }
+        if (!params.amount || params.amount <= 0) {
+            throw {
+                error: 'amount must be greater than 0',
+                code: 'INVALID_PARAMS',
+                status: 400,
+            };
+        }
+        if (!params.productId && !params.subscriptionPlanId) {
+            throw {
+                error: 'Either productId or subscriptionPlanId is required',
+                code: 'INVALID_PARAMS',
+                status: 400,
+            };
+        }
+        const payload = {
+            merchant_id: this.client.getMerchantId(),
+            sender_address: params.senderAddress,
+            transaction_hash: params.transactionHash || `mock_tx_${Date.now()}`,
+            product_id: params.productId,
+            subscription_plan_id: params.subscriptionPlanId,
+            amount: params.amount,
+            currency: params.currency || 'USD',
+        };
+        return this.client.request('POST', '/api/v1/payments/record', payload);
+    }
+}
+
+/**
+ * CasPay SDK
+ * Official JavaScript/TypeScript SDK for CasPay payment gateway
+ *
+ * @example
+ * ```typescript
+ * import CasPay from '@caspay/sdk';
+ *
+ * const caspay = new CasPay({
+ *   apiKey: 'cp_live_...',
+ *   merchantId: 'MERCH_...'
+ * });
+ *
+ * const payment = await caspay.payments.create({
+ *   senderAddress: '0x123...',
+ *   productId: 'prod_abc',
+ *   amount: 100
+ * });
+ * ```
+ */
+class CasPay {
+    /**
+     * Create a new CasPay SDK instance
+     * @param config - SDK configuration
+     */
+    constructor(config) {
+        this.client = new HttpClient(config);
+        this.payments = new Payments(this.client);
+    }
+    /**
+     * Get SDK version
+     */
+    static get version() {
+        return '1.0.0';
+    }
+}
+
+export { CasPay, CasPay as default };

package/dist/index.js

@@ -0,0 +1,165 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+/**
+ * HTTP Client for CasPay API
+ * Handles all API requests with authentication and error handling
+ */
+class HttpClient {
+    constructor(config) {
+        this.SDK_VERSION = '1.0.0';
+        // Use production API by default
+        this.baseUrl = config.baseUrl || 'https://api.caspay.link';
+        this.apiKey = config.apiKey;
+        this.merchantId = config.merchantId;
+        // Validate required config
+        if (!this.apiKey) {
+            throw new Error('CasPay SDK: apiKey is required');
+        }
+        if (!this.merchantId) {
+            throw new Error('CasPay SDK: merchantId is required');
+        }
+    }
+    async request(method, path, body) {
+        const url = `${this.baseUrl}${path}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers: {
+                    'Content-Type': 'application/json',
+                    'X-CasPay-Key': this.apiKey,
+                    'X-CasPay-SDK-Version': this.SDK_VERSION,
+                    'User-Agent': `CasPay-SDK-JS/${this.SDK_VERSION}`,
+                },
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            const data = await response.json();
+            if (!response.ok) {
+                const error = {
+                    error: data.error || 'Request failed',
+                    code: data.code || 'UNKNOWN_ERROR',
+                    status: response.status,
+                };
+                throw error;
+            }
+            return data;
+        }
+        catch (error) {
+            // Re-throw CasPay errors
+            if (error.error && error.code) {
+                throw error;
+            }
+            // Wrap network errors
+            throw {
+                error: error.message || 'Network error',
+                code: 'NETWORK_ERROR',
+                status: 0,
+            };
+        }
+    }
+    getMerchantId() {
+        return this.merchantId;
+    }
+}
+
+/**
+ * Payments Resource
+ * Handle payment creation and verification
+ */
+class Payments {
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Create a new payment record
+     *
+     * @param params - Payment parameters
+     * @returns Payment response with transaction details
+     * @throws {CasPayError} If payment creation fails
+     *
+     * @example
+     * ```typescript
+     * const payment = await caspay.payments.create({
+     *   senderAddress: '0x123...',
+     *   productId: 'prod_abc123',
+     *   amount: 100,
+     *   currency: 'USD'
+     * });
+     * ```
+     */
+    async create(params) {
+        // Validate required fields
+        if (!params.senderAddress) {
+            throw {
+                error: 'senderAddress is required',
+                code: 'INVALID_PARAMS',
+                status: 400,
+            };
+        }
+        if (!params.amount || params.amount <= 0) {
+            throw {
+                error: 'amount must be greater than 0',
+                code: 'INVALID_PARAMS',
+                status: 400,
+            };
+        }
+        if (!params.productId && !params.subscriptionPlanId) {
+            throw {
+                error: 'Either productId or subscriptionPlanId is required',
+                code: 'INVALID_PARAMS',
+                status: 400,
+            };
+        }
+        const payload = {
+            merchant_id: this.client.getMerchantId(),
+            sender_address: params.senderAddress,
+            transaction_hash: params.transactionHash || `mock_tx_${Date.now()}`,
+            product_id: params.productId,
+            subscription_plan_id: params.subscriptionPlanId,
+            amount: params.amount,
+            currency: params.currency || 'USD',
+        };
+        return this.client.request('POST', '/api/v1/payments/record', payload);
+    }
+}
+
+/**
+ * CasPay SDK
+ * Official JavaScript/TypeScript SDK for CasPay payment gateway
+ *
+ * @example
+ * ```typescript
+ * import CasPay from '@caspay/sdk';
+ *
+ * const caspay = new CasPay({
+ *   apiKey: 'cp_live_...',
+ *   merchantId: 'MERCH_...'
+ * });
+ *
+ * const payment = await caspay.payments.create({
+ *   senderAddress: '0x123...',
+ *   productId: 'prod_abc',
+ *   amount: 100
+ * });
+ * ```
+ */
+class CasPay {
+    /**
+     * Create a new CasPay SDK instance
+     * @param config - SDK configuration
+     */
+    constructor(config) {
+        this.client = new HttpClient(config);
+        this.payments = new Payments(this.client);
+    }
+    /**
+     * Get SDK version
+     */
+    static get version() {
+        return '1.0.0';
+    }
+}
+
+exports.CasPay = CasPay;
+exports.default = CasPay;

package/dist/resources/payments.d.ts

@@ -0,0 +1,28 @@
+import type { HttpClient } from '../core/client';
+import type { PaymentCreateParams, PaymentResponse } from '../types';
+/**
+ * Payments Resource
+ * Handle payment creation and verification
+ */
+export declare class Payments {
+    private client;
+    constructor(client: HttpClient);
+    /**
+     * Create a new payment record
+     *
+     * @param params - Payment parameters
+     * @returns Payment response with transaction details
+     * @throws {CasPayError} If payment creation fails
+     *
+     * @example
+     * ```typescript
+     * const payment = await caspay.payments.create({
+     *   senderAddress: '0x123...',
+     *   productId: 'prod_abc123',
+     *   amount: 100,
+     *   currency: 'USD'
+     * });
+     * ```
+     */
+    create(params: PaymentCreateParams): Promise<PaymentResponse>;
+}

package/dist/types/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * CasPay SDK Configuration
+ */
+export interface CasPayConfig {
+    /** Your CasPay API key (starts with cp_live_ or cp_test_) */
+    apiKey: string;
+    /** Your merchant ID (starts with MERCH_) */
+    merchantId: string;
+    /** Optional: Override API base URL (default: https://api.caspay.link) */
+    baseUrl?: string;
+}
+/**
+ * Payment Creation Parameters
+ */
+export interface PaymentCreateParams {
+    /** Sender's Casper wallet address */
+    senderAddress: string;
+    /** Optional: Casper transaction hash (auto-generated in mock mode) */
+    transactionHash?: string;
+    /** Product ID for one-time payments */
+    productId?: string;
+    /** Subscription plan ID for recurring payments */
+    subscriptionPlanId?: string;
+    /** Payment amount */
+    amount: number;
+    /** Currency code (default: USD) */
+    currency?: string;
+}
+/**
+ * Subscription Creation Parameters
+ */
+export interface SubscriptionCreateParams {
+    /** Subscriber's Casper wallet address */
+    senderAddress: string;
+    /** Optional: Casper transaction hash */
+    transactionHash?: string;
+    /** Subscription plan ID */
+    planId: string;
+    /** Payment amount */
+    amount: number;
+    /** Currency code (default: USD) */
+    currency?: string;
+}
+/**
+ * Payment Response
+ */
+export interface PaymentResponse {
+    success: boolean;
+    payment: {
+        id: string;
+        transaction_hash: string;
+        amount: number;
+        token: string;
+        status: string;
+        invoice_number: string;
+        created_at: string;
+    };
+    verification?: {
+        verified: boolean;
+        transaction_hash: string;
+        amount: number;
+    };
+    duplicate?: boolean;
+    responseTime?: string;
+}
+/**
+ * Subscription Response
+ */
+export interface SubscriptionResponse {
+    success: boolean;
+    payment: {
+        id: string;
+        subscription_plan_id: string;
+        amount: number;
+        status: string;
+    };
+    subscription_id?: string;
+}
+/**
+ * API Error Response
+ */
+export interface CasPayError {
+    error: string;
+    code: string;
+    status?: number;
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@caspay/sdk",
+  "version": "1.0.0",
+  "description": "Official CasPay JavaScript/TypeScript SDK - Accept crypto payments with Casper blockchain",
+  "main": "dist/index.js",
+  "module": "dist/index.esm.js",
+  "browser": "dist/caspay.min.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "dev": "rollup -c -w",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Error: no test specified\" && exit 0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/caspay/sdk.git"
+  },
+  "bugs": {
+    "url": "https://github.com/caspay/sdk/issues"
+  },
+  "homepage": "https://caspay.link",
+  "keywords": [
+    "caspay",
+    "payment",
+    "casper",
+    "blockchain",
+    "cryptocurrency",
+    "subscription",
+    "payment-gateway",
+    "web3",
+    "crypto-payments"
+  ],
+  "author": "CasPay <support@caspay.link>",
+  "license": "MIT",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@rollup/plugin-commonjs": "^25.0.7",
+    "@rollup/plugin-node-resolve": "^15.2.3",
+    "@rollup/plugin-typescript": "^11.1.5",
+    "rollup": "^4.9.1",
+    "rollup-plugin-terser": "^7.0.2",
+    "tslib": "^2.8.1",
+    "typescript": "^5.3.3"
+  }
+}