@explorins/pers-sdk 1.1.2 → 1.1.3

package/src/donation/services/donation-service.ts

@@ -1,25 +0,0 @@
-import { DonationApi } from '../api/donation-api';
-import { DonationTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Platform-Agnostic Donation Service
- * 
- * Contains donation business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework DonationApiService capabilities exactly.
- */
-export class DonationService {
-  constructor(private donationApi: DonationApi) {}
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get all donation types
-   * ✅ ONLY method actually used by framework
-   */
-  async getAllDonationTypes(): Promise<DonationTypeDTO[]> {
-    return this.donationApi.getAllDonationTypes();
-  }
-}

package/src/index.ts

@@ -1,55 +0,0 @@
-/**
- * @explorins/pers-sdk - Main Entry Point
- * 
- * Platform-agnostic PERS SDK - Core and Business domains only
- */
-
-// Re-export everything from core
-export * from './core'
-
-// Re-export everything from business domain
-export * from './business';
-
-// Re-export everything from transaction domain
-export * from './transaction';
-
-// Re-export everything from analytics domain
-export * from './analytics';
-
-// Re-export everything from auth-admin domain
-export * from './auth-admin';
-
-// Re-export everything from campaign domain
-export * from './campaign';
-
-// Re-export everything from donation domain
-export * from './donation';
-
-// Re-export everything from analytics domain
-export * from './payment';
-
-// Re-export everything from analytics domain
-export * from './redemption';
-
-// Re-export everything from analytics domain
-export * from './tenant';
-
-// Re-export everything from analytics domain
-export * from './token';
-
-// Re-export everything from user domain
-export * from './user';
-
-// Re-export everything from user-status domain
-export * from './user-status';
-
-// Re-export everything from web3-chain domain
-export * from './web3-chain';
-
-// Re-export everything from web3 domain
-export * from './web3';
-
-// NOTE: Angular integration available in separate package '@explorins/pers-sdk-angular'
-// Future domains will be added here
-// export * from './campaign';
-// export * from './challenge';

package/src/payment/api/payment-api.ts

@@ -1,185 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { 
-  PurchaseTokenDTO,
-  PurchaseDTO,
-  PurchaseCurrency,
-  PurchaseCreateRequestDTO,
-  PaymentIntentDTO,
-  PaymentIntentCreateDTO,
-  PurchaseCreateResponseDTO,
-  DonationTypeDTO
-} from '../models';
-
-/**
- * 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.
- */
-export class PurchaseApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  private readonly 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?: boolean): Promise<PurchaseTokenDTO[]> {
-    let url = `${this.basePath}/tokens`;
-    if (active !== undefined) {
-      url += `?active=${active}`;
-    }
-    return this.apiClient.get<PurchaseTokenDTO[]>(url);
-  }
-
-  /**
-   * PUBLIC: Get donation types
-   * 
-   * RESTful endpoint: GET /purchases/donation-types
-   * Replaces: GET /purchase/donation/type
-   */
-  async getDonationTypes(): Promise<DonationTypeDTO[]> {
-    return this.apiClient.get<DonationTypeDTO[]>(`${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: number, currency: PurchaseCurrency, receiptEmail: string, description: string): Promise<PaymentIntentDTO> {
-    const body: PaymentIntentCreateDTO = {
-      amount,
-      currency,
-      receiptEmail,
-      description
-    };
-    return this.apiClient.post<PaymentIntentDTO>(`${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: string, amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string): Promise<PaymentIntentDTO> {
-    const body: PaymentIntentCreateDTO = {
-      amount,
-      currency,
-      receiptEmail,
-      description
-    };
-    return this.apiClient.put<PaymentIntentDTO>(`${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: string): Promise<PaymentIntentDTO> {
-    return this.apiClient.delete<PaymentIntentDTO>(`${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: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string): Promise<PurchaseCreateResponseDTO> {
-    const body: PurchaseCreateRequestDTO = {
-      quantity: amount,
-      purchaseTokenId: purchaseTokenId || '',
-      donationTypeId,
-      donationAccountAddress,
-      paymentIntentId
-    };
-    return this.apiClient.post<PurchaseCreateResponseDTO>(`${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(): Promise<PurchaseDTO[]> {
-    return this.apiClient.get<PurchaseDTO[]>(`${this.basePath}/me/history`);
-  }
-
-  // ==========================================
-  // CONVENIENCE METHODS (Backward Compatibility)
-  // ==========================================
-
-  /**
-   * @deprecated Use getPurchaseTokens() instead
-   * Backward compatibility alias for getActivePurchaseTokens
-   */
-  async getActivePurchaseTokens(active: boolean = true): Promise<PurchaseTokenDTO[]> {
-    return this.getPurchaseTokens(active);
-  }
-
-  /**
-   * @deprecated Use createUserPurchase() instead
-   * Backward compatibility alias for createPurchase
-   */
-  async createPurchase(paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string): Promise<PurchaseCreateResponseDTO> {
-    return this.createUserPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
-  }
-
-  /**
-   * @deprecated Use getUserPurchaseHistory() instead
-   * Backward compatibility alias for getAllUserPurchases
-   */
-  async getAllUserPurchases(): Promise<PurchaseDTO[]> {
-    return this.getUserPurchaseHistory();
-  }
-}
-
-// Backward compatibility - export as PaymentApi as well
-export { PurchaseApi as PaymentApi };

package/src/payment/index.ts

@@ -1,64 +0,0 @@
-/**
- * @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
-export { PaymentApi } from './api/payment-api';
-
-// Service Layer  
-export { PaymentService } from './services/payment-service';
-
-// Models & Types
-export * from './models';
-export * from '../shared/interfaces/pers-shared-lib.interfaces';
-
-// Models & Types
-export * from './models';
-
-// Factory function for creating payment SDK instance
-import { PersApiClient } from '../core/pers-api-client';
-import { PaymentApi } from './api/payment-api';
-import { PurchaseCurrency } from './models';
-import { PaymentService } from './services/payment-service';
-
-/**
- * Create a complete Payment SDK instance
- * 
- * @param apiClient - Configured PERS API client
- * @returns Payment SDK with flattened structure for better DX
- */
-export function createPaymentSDK(apiClient: PersApiClient) {
-  const paymentApi = new PaymentApi(apiClient);
-  const paymentService = new PaymentService(paymentApi);
-  
-  return {
-    // Direct access to service methods (primary interface)
-    
-    // Public methods
-    getActivePurchaseTokens: (active?: boolean) => paymentService.getActivePurchaseTokens(active),
-    // ✅ FIXED: Proper type instead of any
-    createPaymentIntent: (amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string) => 
-      paymentService.createPaymentIntent(amount, currency, receiptEmail, description),
-    // ✅ FIXED: Proper type instead of any
-    updatePaymentIntent: (paymentIntentId: string, amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string) => 
-      paymentService.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description),
-    cancelPaymentIntent: (paymentIntentId: string) => paymentService.cancelPaymentIntent(paymentIntentId),
-    
-    // Auth methods
-    createPurchase: (paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string) => 
-      paymentService.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress),
-    getAllUserPurchases: () => paymentService.getAllUserPurchases(),
-    
-    // Advanced access for edge cases
-    api: paymentApi,
-    service: paymentService
-  };
-}
-
-export type PaymentSDK = ReturnType<typeof createPaymentSDK>;

package/src/payment/models/index.ts

@@ -1,29 +0,0 @@
-/**
- * Payment Domain Models
- * 
- * Re-exports from centralized pers-shared interfaces for consistency with backend
- * and to provide a single import source for payment-related types.
- */
-
-// Core payment entities from centralized pers-shared interfaces
-export type {
-  UserDTO,
-  PurchaseDTO,
-  PurchaseTokenDTO,
-  PurchaseTypeDTO,
-  PaymentIntentDTO,
-  PurchaseCreateRequestDTO,
-  PurchaseCreateResponseDTO,
-  PaymentIntentCreateDTO,
-  PurchaseCurrency,
-  DonationTypeDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-// Import for local interface usage
-import { PaymentIntentCreateDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-// Local payment interfaces
-export interface PaymentIntentUpdateDTO extends PaymentIntentCreateDTO {
-  paymentIntentId: string;
-}
-

package/src/payment/services/payment-service.ts

@@ -1,70 +0,0 @@
-import { PaymentApi } from '../api/payment-api';
-import { 
-  PurchaseTokenDTO,
-  PurchaseDTO,
-  PurchaseCurrency,
-  PaymentIntentDTO,
-} from '../models';
-
-/**
- * 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.
- */
-export class PaymentService {
-  constructor(private paymentApi: PaymentApi) {}
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get active purchase tokens
-   */
-  async getActivePurchaseTokens(active: boolean = true): Promise<PurchaseTokenDTO[]> {
-    return this.paymentApi.getActivePurchaseTokens(active);
-  }
-
-  /**
-   * PUBLIC: Create payment intent
-   */
-  async createPaymentIntent(amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string): Promise<PaymentIntentDTO> {
-    return this.paymentApi.createPaymentIntent(amount, currency, receiptEmail, description);
-  }
-
-  /**
-   * PUBLIC: Update payment intent
-   */
-  async updatePaymentIntent(paymentIntentId: string, amount: number, currency: PurchaseCurrency, receiptEmail: string, description: string): Promise<PaymentIntentDTO> {
-    return this.paymentApi.updatePaymentIntent(paymentIntentId, amount, currency, receiptEmail, description);
-  }
-
-  /**
-   * PUBLIC: Cancel payment intent
-   */
-  async cancelPaymentIntent(paymentIntentId: string): Promise<PaymentIntentDTO> {
-    return this.paymentApi.cancelPaymentIntent(paymentIntentId);
-  }
-
-  // ==========================================
-  // AUTHENTICATED OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Create purchase
-   */
-  async createPurchase(paymentIntentId: string, amount: number, purchaseTokenId?: string, donationTypeId?: number, donationAccountAddress?: string): Promise<PurchaseDTO> {
-    return this.paymentApi.createPurchase(paymentIntentId, amount, purchaseTokenId, donationTypeId, donationAccountAddress);
-  }
-
-  /**
-   * AUTH: Get all user purchases
-   */
-  async getAllUserPurchases(): Promise<PurchaseDTO[]> {
-    return this.paymentApi.getAllUserPurchases();
-  }
-}

package/src/pers-sdk.ts

@@ -1,45 +0,0 @@
-/**
- * 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 class PersSDK {
-  private apiClient: PersApiClient;
-
-  constructor(httpClient: HttpClient, config: PersConfig) {
-    this.apiClient = new PersApiClient(httpClient, config);
-  }
-
-  /**
-   * Get the API client for direct PERS API calls
-   * This is the main interface - keep it simple!
-   */
-  api(): PersApiClient {
-    return this.apiClient;
-  }
-
-  /**
-   * Quick config check
-   */
-  isProduction(): boolean {
-    return this.apiClient.getConfig().environment === 'production';
-  }
-}
-
-/**
- * Simple factory function
- */
-export function createPersSDK(
-  httpClient: HttpClient,
-  config: PersConfig
-): PersSDK {
-  return new PersSDK(httpClient, config);
-}