@explorins/pers-sdk 1.1.2 → 1.2.0

package/dist/payment.cjs

@@ -0,0 +1,258 @@
+'use strict';
+
+/**
+ * Platform-Agnostic Purchase API Client (RESTful Architecture)
+ *
+ * Handles purchase and payment operations using the PERS backend's new RESTful endpoints.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ *
+ * Migration Status: Updated to match /purchases controller (replaces /purchase endpoints)
+ *
+ * Available Access Levels:
+ * - PUBLIC: Project key authentication for catalog browsing and payment operations
+ * - USER: Requires user authentication JWT (purchase creation, history access)
+ * - ADMIN: Requires tenant admin privileges (not implemented in this client)
+ *
+ * Note: This SDK focuses on backend purchase operations only.
+ * Payment provider integrations (Stripe, etc.) should remain in infrastructure layer.
+ */
+class PurchaseApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/purchases';
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS (Project Key)
+    // ==========================================
+    /**
+     * PUBLIC: Get purchase tokens (Intelligent Access)
+     *
+     * RESTful endpoint: GET /purchases/tokens
+     * Replaces: GET /purchase/token
+     *
+     * INTELLIGENT ACCESS:
+     * - PUBLIC (Project Key): Returns active tokens only (active parameter ignored)
+     * - ADMIN (Tenant Admin JWT): Returns filtered results based on active parameter
+     */
+    async getPurchaseTokens(active) {
+        let url = `${this.basePath}/tokens`;
+        if (active !== undefined) {
+            url += `?active=${active}`;
+        }
+        return this.apiClient.get(url);
+    }
+    /**
+     * PUBLIC: Get donation types
+     *
+     * RESTful endpoint: GET /purchases/donation-types
+     * Replaces: GET /purchase/donation/type
+     */
+    async getDonationTypes() {
+        return this.apiClient.get(`${this.basePath}/donation-types`);
+    }
+    // ==========================================
+    // PAYMENT OPERATIONS (FINANCIAL - CRITICAL)
+    // ==========================================
+    /**
+     * PUBLIC: Create payment intent (FINANCIAL OPERATION)
+     *
+     * RESTful endpoint: POST /purchases/payment-intents
+     * Replaces: POST /purchase/payment-intent
+     *
+     * CRITICAL: Handles real money operations - tenant context required
+     */
+    async createPaymentIntent(amount, currency, receiptEmail, description) {
+        const body = {
+            amount,
+            currency,
+            receiptEmail,
+            description
+        };
+        return this.apiClient.post(`${this.basePath}/payment-intents`, body);
+    }
+    /**
+     * PUBLIC: Update payment intent (FINANCIAL OPERATION)
+     *
+     * RESTful endpoint: PUT /purchases/payment-intents/{paymentIntentId}
+     * Replaces: PUT /purchase/payment-intent/{paymentIntentId}
+     *
+     * CRITICAL: Handles real money operations - tenant context required
+     */
+    async updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description) {
+        const body = {
+            amount,
+            currency,
+            receiptEmail,
+            description
+        };
+        return this.apiClient.put(`${this.basePath}/payment-intents/${paymentIntentId}`, body);
+    }
+    /**
+     * PUBLIC: Cancel payment intent (FINANCIAL OPERATION)
+     *
+     * RESTful endpoint: DELETE /purchases/payment-intents/{paymentIntentId}
+     * Replaces: DELETE /purchase/payment-intent/{paymentIntentId}
+     *
+     * CRITICAL: Handles real money operations - tenant context required
+     */
+    async cancelPaymentIntent(paymentIntentId) {
+        return this.apiClient.delete(`${this.basePath}/payment-intents/${paymentIntentId}`);
+    }
+    // ==========================================
+    // USER OPERATIONS (JWT + Project Key)
+    // ==========================================
+    /**
+     * USER: Create purchase (BUSINESS CRITICAL - FINANCIAL TRANSACTION)
+     *
+     * RESTful endpoint: POST /purchases
+     * Replaces: POST /purchase/auth
+     *
+     * USER-ONLY: Requires user authentication JWT for purchase creation
+     * CRITICAL: Real financial transaction with Stripe integration
+     */
+    async createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
+        const body = {
+            quantity: amount,
+            purchaseTokenId: purchaseTokenId || '',
+            donationTypeId,
+            donationAccountAddress,
+            paymentIntentId
+        };
+        return this.apiClient.post(`${this.basePath}`, body);
+    }
+    /**
+     * USER: Get user purchase history
+     *
+     * RESTful endpoint: GET /purchases/me/history
+     * Replaces: GET /purchase/auth
+     *
+     * USER-ONLY: Get authenticated user's purchase history
+     * FINANCIAL RECORDS: User attribution critical for compliance
+     */
+    async getUserPurchaseHistory() {
+        return this.apiClient.get(`${this.basePath}/me/history`);
+    }
+    // ==========================================
+    // CONVENIENCE METHODS (Backward Compatibility)
+    // ==========================================
+    /**
+     * @deprecated Use getPurchaseTokens() instead
+     * Backward compatibility alias for getActivePurchaseTokens
+     */
+    async getActivePurchaseTokens(active = true) {
+        return this.getPurchaseTokens(active);
+    }
+    /**
+     * @deprecated Use createUserPurchase() instead
+     * Backward compatibility alias for createPurchase
+     */
+    async createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
+        return this.createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
+    }
+    /**
+     * @deprecated Use getUserPurchaseHistory() instead
+     * Backward compatibility alias for getAllUserPurchases
+     */
+    async getAllUserPurchases() {
+        return this.getUserPurchaseHistory();
+    }
+}
+
+/**
+ * Platform-Agnostic Payment Service
+ *
+ * Contains payment business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ * Payment provider logic (Stripe, etc.) should remain in infrastructure layer.
+ */
+class PaymentService {
+    constructor(paymentApi) {
+        this.paymentApi = paymentApi;
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * PUBLIC: Get active purchase tokens
+     */
+    async getActivePurchaseTokens(active = true) {
+        return this.paymentApi.getActivePurchaseTokens(active);
+    }
+    /**
+     * PUBLIC: Create payment intent
+     */
+    async createPaymentIntent(amount, currency, receiptEmail, description) {
+        return this.paymentApi.createPaymentIntent(amount, currency, receiptEmail, description);
+    }
+    /**
+     * PUBLIC: Update payment intent
+     */
+    async updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description) {
+        return this.paymentApi.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description);
+    }
+    /**
+     * PUBLIC: Cancel payment intent
+     */
+    async cancelPaymentIntent(paymentIntentId) {
+        return this.paymentApi.cancelPaymentIntent(paymentIntentId);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Create purchase
+     */
+    async createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
+        return this.paymentApi.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
+    }
+    /**
+     * AUTH: Get all user purchases
+     */
+    async getAllUserPurchases() {
+        return this.paymentApi.getAllUserPurchases();
+    }
+}
+
+/**
+ * @explorins/pers-sdk-payment
+ *
+ * Platform-agnostic Payment Domain SDK for PERS ecosystem
+ * Handles payment intents, purchases, and purchase tokens
+ *
+ * Note: Payment provider integrations (Stripe, etc.) are kept separate
+ * in the infrastructure layer to maintain platform-agnostic principles.
+ */
+// API Layer
+/**
+ * Create a complete Payment SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Payment SDK with flattened structure for better DX
+ */
+function createPaymentSDK(apiClient) {
+    const paymentApi = new PurchaseApi(apiClient);
+    const paymentService = new PaymentService(paymentApi);
+    return {
+        // Direct access to service methods (primary interface)
+        // Public methods
+        getActivePurchaseTokens: (active) => paymentService.getActivePurchaseTokens(active),
+        // ✅ FIXED: Proper type instead of any
+        createPaymentIntent: (amount, currency, receiptEmail, description) => paymentService.createPaymentIntent(amount, currency, receiptEmail, description),
+        // ✅ FIXED: Proper type instead of any
+        updatePaymentIntent: (paymentIntentId, amount, currency, receiptEmail, description) => paymentService.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description),
+        cancelPaymentIntent: (paymentIntentId) => paymentService.cancelPaymentIntent(paymentIntentId),
+        // Auth methods
+        createPurchase: (paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) => paymentService.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress),
+        getAllUserPurchases: () => paymentService.getAllUserPurchases(),
+        // Advanced access for edge cases
+        api: paymentApi,
+        service: paymentService
+    };
+}
+
+exports.PaymentApi = PurchaseApi;
+exports.PaymentService = PaymentService;
+exports.createPaymentSDK = createPaymentSDK;
+//# sourceMappingURL=payment.cjs.map

package/dist/payment.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.cjs","sources":["../src/payment/api/payment-api.ts","../src/payment/services/payment-service.ts","../src/payment/index.ts"],"sourcesContent":[null,null,null],"names":["PaymentApi"],"mappings":"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"}

package/dist/payment.js

@@ -0,0 +1,254 @@
+/**
+ * Platform-Agnostic Purchase API Client (RESTful Architecture)
+ *
+ * Handles purchase and payment operations using the PERS backend's new RESTful endpoints.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ *
+ * Migration Status: Updated to match /purchases controller (replaces /purchase endpoints)
+ *
+ * Available Access Levels:
+ * - PUBLIC: Project key authentication for catalog browsing and payment operations
+ * - USER: Requires user authentication JWT (purchase creation, history access)
+ * - ADMIN: Requires tenant admin privileges (not implemented in this client)
+ *
+ * Note: This SDK focuses on backend purchase operations only.
+ * Payment provider integrations (Stripe, etc.) should remain in infrastructure layer.
+ */
+class PurchaseApi {
+    constructor(apiClient) {
+        this.apiClient = apiClient;
+        this.basePath = '/purchases';
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS (Project Key)
+    // ==========================================
+    /**
+     * PUBLIC: Get purchase tokens (Intelligent Access)
+     *
+     * RESTful endpoint: GET /purchases/tokens
+     * Replaces: GET /purchase/token
+     *
+     * INTELLIGENT ACCESS:
+     * - PUBLIC (Project Key): Returns active tokens only (active parameter ignored)
+     * - ADMIN (Tenant Admin JWT): Returns filtered results based on active parameter
+     */
+    async getPurchaseTokens(active) {
+        let url = `${this.basePath}/tokens`;
+        if (active !== undefined) {
+            url += `?active=${active}`;
+        }
+        return this.apiClient.get(url);
+    }
+    /**
+     * PUBLIC: Get donation types
+     *
+     * RESTful endpoint: GET /purchases/donation-types
+     * Replaces: GET /purchase/donation/type
+     */
+    async getDonationTypes() {
+        return this.apiClient.get(`${this.basePath}/donation-types`);
+    }
+    // ==========================================
+    // PAYMENT OPERATIONS (FINANCIAL - CRITICAL)
+    // ==========================================
+    /**
+     * PUBLIC: Create payment intent (FINANCIAL OPERATION)
+     *
+     * RESTful endpoint: POST /purchases/payment-intents
+     * Replaces: POST /purchase/payment-intent
+     *
+     * CRITICAL: Handles real money operations - tenant context required
+     */
+    async createPaymentIntent(amount, currency, receiptEmail, description) {
+        const body = {
+            amount,
+            currency,
+            receiptEmail,
+            description
+        };
+        return this.apiClient.post(`${this.basePath}/payment-intents`, body);
+    }
+    /**
+     * PUBLIC: Update payment intent (FINANCIAL OPERATION)
+     *
+     * RESTful endpoint: PUT /purchases/payment-intents/{paymentIntentId}
+     * Replaces: PUT /purchase/payment-intent/{paymentIntentId}
+     *
+     * CRITICAL: Handles real money operations - tenant context required
+     */
+    async updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description) {
+        const body = {
+            amount,
+            currency,
+            receiptEmail,
+            description
+        };
+        return this.apiClient.put(`${this.basePath}/payment-intents/${paymentIntentId}`, body);
+    }
+    /**
+     * PUBLIC: Cancel payment intent (FINANCIAL OPERATION)
+     *
+     * RESTful endpoint: DELETE /purchases/payment-intents/{paymentIntentId}
+     * Replaces: DELETE /purchase/payment-intent/{paymentIntentId}
+     *
+     * CRITICAL: Handles real money operations - tenant context required
+     */
+    async cancelPaymentIntent(paymentIntentId) {
+        return this.apiClient.delete(`${this.basePath}/payment-intents/${paymentIntentId}`);
+    }
+    // ==========================================
+    // USER OPERATIONS (JWT + Project Key)
+    // ==========================================
+    /**
+     * USER: Create purchase (BUSINESS CRITICAL - FINANCIAL TRANSACTION)
+     *
+     * RESTful endpoint: POST /purchases
+     * Replaces: POST /purchase/auth
+     *
+     * USER-ONLY: Requires user authentication JWT for purchase creation
+     * CRITICAL: Real financial transaction with Stripe integration
+     */
+    async createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
+        const body = {
+            quantity: amount,
+            purchaseTokenId: purchaseTokenId || '',
+            donationTypeId,
+            donationAccountAddress,
+            paymentIntentId
+        };
+        return this.apiClient.post(`${this.basePath}`, body);
+    }
+    /**
+     * USER: Get user purchase history
+     *
+     * RESTful endpoint: GET /purchases/me/history
+     * Replaces: GET /purchase/auth
+     *
+     * USER-ONLY: Get authenticated user's purchase history
+     * FINANCIAL RECORDS: User attribution critical for compliance
+     */
+    async getUserPurchaseHistory() {
+        return this.apiClient.get(`${this.basePath}/me/history`);
+    }
+    // ==========================================
+    // CONVENIENCE METHODS (Backward Compatibility)
+    // ==========================================
+    /**
+     * @deprecated Use getPurchaseTokens() instead
+     * Backward compatibility alias for getActivePurchaseTokens
+     */
+    async getActivePurchaseTokens(active = true) {
+        return this.getPurchaseTokens(active);
+    }
+    /**
+     * @deprecated Use createUserPurchase() instead
+     * Backward compatibility alias for createPurchase
+     */
+    async createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
+        return this.createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
+    }
+    /**
+     * @deprecated Use getUserPurchaseHistory() instead
+     * Backward compatibility alias for getAllUserPurchases
+     */
+    async getAllUserPurchases() {
+        return this.getUserPurchaseHistory();
+    }
+}
+
+/**
+ * Platform-Agnostic Payment Service
+ *
+ * Contains payment business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ *
+ * Focuses only on actual backend capabilities.
+ * Payment provider logic (Stripe, etc.) should remain in infrastructure layer.
+ */
+class PaymentService {
+    constructor(paymentApi) {
+        this.paymentApi = paymentApi;
+    }
+    // ==========================================
+    // PUBLIC OPERATIONS
+    // ==========================================
+    /**
+     * PUBLIC: Get active purchase tokens
+     */
+    async getActivePurchaseTokens(active = true) {
+        return this.paymentApi.getActivePurchaseTokens(active);
+    }
+    /**
+     * PUBLIC: Create payment intent
+     */
+    async createPaymentIntent(amount, currency, receiptEmail, description) {
+        return this.paymentApi.createPaymentIntent(amount, currency, receiptEmail, description);
+    }
+    /**
+     * PUBLIC: Update payment intent
+     */
+    async updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description) {
+        return this.paymentApi.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description);
+    }
+    /**
+     * PUBLIC: Cancel payment intent
+     */
+    async cancelPaymentIntent(paymentIntentId) {
+        return this.paymentApi.cancelPaymentIntent(paymentIntentId);
+    }
+    // ==========================================
+    // AUTHENTICATED OPERATIONS
+    // ==========================================
+    /**
+     * AUTH: Create purchase
+     */
+    async createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) {
+        return this.paymentApi.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
+    }
+    /**
+     * AUTH: Get all user purchases
+     */
+    async getAllUserPurchases() {
+        return this.paymentApi.getAllUserPurchases();
+    }
+}
+
+/**
+ * @explorins/pers-sdk-payment
+ *
+ * Platform-agnostic Payment Domain SDK for PERS ecosystem
+ * Handles payment intents, purchases, and purchase tokens
+ *
+ * Note: Payment provider integrations (Stripe, etc.) are kept separate
+ * in the infrastructure layer to maintain platform-agnostic principles.
+ */
+// API Layer
+/**
+ * Create a complete Payment SDK instance
+ *
+ * @param apiClient - Configured PERS API client
+ * @returns Payment SDK with flattened structure for better DX
+ */
+function createPaymentSDK(apiClient) {
+    const paymentApi = new PurchaseApi(apiClient);
+    const paymentService = new PaymentService(paymentApi);
+    return {
+        // Direct access to service methods (primary interface)
+        // Public methods
+        getActivePurchaseTokens: (active) => paymentService.getActivePurchaseTokens(active),
+        // ✅ FIXED: Proper type instead of any
+        createPaymentIntent: (amount, currency, receiptEmail, description) => paymentService.createPaymentIntent(amount, currency, receiptEmail, description),
+        // ✅ FIXED: Proper type instead of any
+        updatePaymentIntent: (paymentIntentId, amount, currency, receiptEmail, description) => paymentService.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description),
+        cancelPaymentIntent: (paymentIntentId) => paymentService.cancelPaymentIntent(paymentIntentId),
+        // Auth methods
+        createPurchase: (paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress) => paymentService.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress),
+        getAllUserPurchases: () => paymentService.getAllUserPurchases(),
+        // Advanced access for edge cases
+        api: paymentApi,
+        service: paymentService
+    };
+}
+
+export { PurchaseApi as PaymentApi, PaymentService, createPaymentSDK };
+//# sourceMappingURL=payment.js.map

package/dist/payment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"payment.js","sources":["../src/payment/api/payment-api.ts","../src/payment/services/payment-service.ts","../src/payment/index.ts"],"sourcesContent":[null,null,null],"names":["PaymentApi"],"mappings":"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"}

package/dist/pers-sdk.d.ts

@@ -0,0 +1,29 @@
+/**
+ * PERS SDK - Minimal platform-agnostic client with built-in authentication
+ * Authentication is now handled at the SDK core level for better scalability
+ */
+import { HttpClient } from './core/abstractions/http-client';
+import { PersConfig } from './core/pers-config';
+import { PersApiClient } from './core/pers-api-client';
+/**
+ * Minimal PERS SDK - API client with authentication built-in
+ * Platform adapters provide auth providers and HTTP clients
+ */
+export declare class PersSDK {
+    private apiClient;
+    constructor(httpClient: HttpClient, config: PersConfig);
+    /**
+     * Get the API client for direct PERS API calls
+     * This is the main interface - keep it simple!
+     */
+    api(): PersApiClient;
+    /**
+     * Quick config check
+     */
+    isProduction(): boolean;
+}
+/**
+ * Simple factory function
+ */
+export declare function createPersSDK(httpClient: HttpClient, config: PersConfig): PersSDK;
+//# sourceMappingURL=pers-sdk.d.ts.map

package/dist/pers-sdk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pers-sdk.d.ts","sourceRoot":"","sources":["../src/pers-sdk.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,SAAS,CAAgB;gBAErB,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU;IAItD;;;OAGG;IACH,GAAG,IAAI,aAAa;IAIpB;;OAEG;IACH,YAAY,IAAI,OAAO;CAGxB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,UAAU,GACjB,OAAO,CAET"}