@explorins/pers-sdk 1.1.2 → 1.1.3

package/src/token/token-sdk.ts

@@ -1,231 +0,0 @@
-import { TokenApi } from './api/token-api';
-import { TokenService } from './services/token-service';
-import { PersApiClient } from '../core/pers-api-client';
-import { 
-  TokenDTO,
-  TokenStorageData,
-  TokenCreateRequestDTO,
-  TokenUpdateRequestDTO,
-  TokenMetadataDTO
-} from './models';
-import { TokenTypeDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Token SDK - Class-based Promise SDK for Token Operations
- * 
- * Modern, performant SDK with direct method access and excellent TypeScript support.
- * Optimized for bundle size, performance, and developer experience.
- * 
- * Usage:
- *   const tokenSDK = new TokenSDK(apiClient);
- *   const tokens = await tokenSDK.getTokens();
- *   const creditToken = await tokenSDK.getActiveCreditToken();
- */
-export class TokenSDK {
-  private readonly tokenApi: TokenApi;
-  private readonly tokenService: TokenService;
-  
-  constructor(apiClient: PersApiClient) {
-    this.tokenApi = new TokenApi(apiClient);
-    this.tokenService = new TokenService(this.tokenApi);
-  }
-
-  // ==========================================
-  // CONVENIENCE METHODS - Direct Promise API
-  // ==========================================
-  // Simplified method names for better developer experience
-
-  /**
-   * Get all tokens
-   * @returns Promise with all available tokens
-   */
-  async getTokens(): Promise<TokenDTO[]> {
-    return this.tokenService.getRemoteTokens();
-  }
-
-  /**
-   * Get all token types
-   * @returns Promise with all available token types
-   */
-  async getTokenTypes(): Promise<TokenTypeDTO[]> {
-    return this.tokenService.getRemoteTokenTypes();
-  }
-
-  /**
-   * Get the active credit token
-   * @returns Promise with the current active credit token
-   */
-  async getActiveCreditToken(): Promise<TokenDTO> {
-    return this.tokenService.getRemoteActiveCreditToken();
-  }
-
-  /**
-   * Get all reward tokens
-   * @returns Promise with all reward tokens
-   */
-  async getRewardTokens(): Promise<TokenDTO[]> {
-    return this.tokenService.getRemoteRewardTokens();
-  }
-
-  /**
-   * Get all status tokens
-   * @returns Promise with all status tokens
-   */
-  async getStatusTokens(): Promise<TokenDTO[]> {
-    return this.tokenService.getRemoteStatusTokens();
-  }
-
-  /**
-   * Get token by contract address
-   * @param contractAddress - The contract address to search for
-   * @param contractTokenId - Optional contract token ID
-   * @returns Promise with the matching token
-   */
-  async getTokenByContract(contractAddress: string, contractTokenId: string | null = null): Promise<TokenDTO> {
-    return this.tokenService.getTokenByContractAddress(contractAddress, contractTokenId);
-  }
-
-  // ==========================================
-  // ADMIN METHODS - Token Management
-  // ==========================================
-
-  /**
-   * Create token metadata
-   * @param tokenId - The token ID
-   * @param tokenData - The token storage data
-   * @returns Promise with the updated token
-   */
-  async createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO> {
-    return this.tokenService.createTokenMetadata(tokenId, tokenData);
-  }
-
-  /**
-   * Toggle token active status
-   * @param tokenId - The token ID to toggle
-   * @returns Promise with the updated token
-   */
-  async toggleTokenActive(tokenId: string): Promise<TokenDTO> {
-    return this.tokenService.toggleTokenActive(tokenId);
-  }
-
-  /**
-   * Create a new token
-   * @param tokenData - The token creation data
-   * @returns Promise with the created token
-   */
-  async createToken(tokenData: TokenCreateRequestDTO): Promise<TokenDTO> {
-    return this.tokenService.createToken(tokenData);
-  }
-
-  /**
-   * Update an existing token
-   * @param tokenId - The token ID to update
-   * @param tokenData - The token update data
-   * @returns Promise with the updated token
-   */
-  async updateToken(tokenId: string, tokenData: TokenUpdateRequestDTO): Promise<TokenDTO> {
-    return this.tokenService.updateToken(tokenId, tokenData);
-  }
-
-  /**
-   * Set mainnet contract address for a token
-   * @param tokenId - The token ID
-   * @param contractAddress - The contract address
-   * @param chainId - The blockchain chain ID
-   * @returns Promise with the updated token
-   */
-  async setMainnetContract(tokenId: string, contractAddress: string, chainId: number): Promise<TokenDTO> {
-    return this.tokenService.setMainnetContract(tokenId, contractAddress, chainId);
-  }
-
-  /**
-   * Toggle token metadata status
-   * @param metadataId - The metadata ID to toggle
-   * @returns Promise with the updated metadata
-   */
-  async toggleTokenMetadataStatus(metadataId: string): Promise<TokenMetadataDTO> {
-    return this.tokenService.toggleTokenMetadataStatus(metadataId);
-  }
-
-  /**
-   * Create a new token type
-   * @param tokenType - The token type data
-   * @returns Promise with the created token type
-   */
-  async createTokenType(tokenType: TokenTypeDTO): Promise<TokenTypeDTO> {
-    return this.tokenService.createTokenType(tokenType);
-  }
-
-  // ==========================================
-  // ADVANCED ACCESS - For Complex Operations
-  // ==========================================
-
-  /**
-   * Get direct access to the token service for advanced operations
-   * @returns The underlying TokenService instance
-   */
-  getTokenService(): TokenService {
-    return this.tokenService;
-  }
-
-  /**
-   * Get direct access to the token API for low-level operations
-   * @returns The underlying TokenApi instance
-   */
-  getTokenApi(): TokenApi {
-    return this.tokenApi;
-  }
-
-  // ==========================================
-  // FRAMEWORK COMPATIBILITY METHODS
-  // ==========================================
-  // These maintain compatibility with existing framework method names
-
-  /**
-   * @deprecated Use getTokens() instead
-   * Framework compatibility method
-   */
-  async getRemoteTokens(): Promise<TokenDTO[]> {
-    return this.getTokens();
-  }
-
-  /**
-   * @deprecated Use getTokenTypes() instead
-   * Framework compatibility method
-   */
-  async getRemoteTokenTypes(): Promise<TokenTypeDTO[]> {
-    return this.getTokenTypes();
-  }
-
-  /**
-   * @deprecated Use getActiveCreditToken() instead
-   * Framework compatibility method
-   */
-  async getRemoteActiveCreditToken(): Promise<TokenDTO> {
-    return this.getActiveCreditToken();
-  }
-
-  /**
-   * @deprecated Use getRewardTokens() instead
-   * Framework compatibility method
-   */
-  async getRemoteRewardTokens(): Promise<TokenDTO[]> {
-    return this.getRewardTokens();
-  }
-
-  /**
-   * @deprecated Use getStatusTokens() instead
-   * Framework compatibility method
-   */
-  async getRemoteStatusTokens(): Promise<TokenDTO[]> {
-    return this.getStatusTokens();
-  }
-
-  /**
-   * @deprecated Use getTokenByContract() instead
-   * Framework compatibility method
-   */
-  async getTokenByContractAddress(contractAddress: string, contractTokenId: string | null): Promise<TokenDTO> {
-    return this.getTokenByContract(contractAddress, contractTokenId);
-  }
-}

package/src/transaction/api/transaction-api.ts

@@ -1,296 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { 
-  TransactionDTO, 
-  TransactionRequestDTO, 
-  ClientTransactionRequestDTO, 
-  ClientTransactionRequestResponseDto,
-  AccountSelectorDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
-import { TransactionPaginationParams, TransactionPaginationResponse, UserBurnTokenRequestDTO } from '../models';
-
-/**
- * Platform-Agnostic Transaction API Client (UPDATED FOR NEW RESTful ENDPOINTS)
- * 
- * Handles transaction operations using the PERS backend.
- * Uses @explorins/pers-shared DTOs for consistency with backend.
- * 
- * MIGRATION NOTES:
- * - All endpoints changed from /transaction to /transactions
- * - Role-based paths removed (no more /auth, /admin, /business in URLs)
- * - New RESTful resource-based structure
- * - Added new client-side transaction flow methods
- * - Enhanced admin query capabilities
- */
-export class TransactionApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  private readonly basePath = '/transactions';
-
-  /**
-   * Get transaction by ID (public endpoint)
-   * 
-   * UPDATED: /transaction/{id} → /transactions/{id}
-   */
-  async getTransactionById(transactionId: string): Promise<TransactionDTO> {
-    return this.apiClient.get<TransactionDTO>(`${this.basePath}/${transactionId}`);
-  }
-
-  // ==========================================
-  // AUTHENTICATED USER OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Create authenticated user transaction
-   * 
-   * UPDATED: /transaction/auth/transaction → /transactions/user
-   */
-  async createAuthTransaction(request: TransactionRequestDTO): Promise<TransactionDTO> {
-    return this.apiClient.post<TransactionDTO>(`${this.basePath}/user`, request);
-  }
-
-  /**
-   * AUTH: Get user's sent transactions
-   * 
-   * UPDATED: /transaction/auth/sender → /transactions/me/sent
-   */
-  async getUserSentTransactions(): Promise<TransactionDTO[]> {
-    const params = new URLSearchParams({
-      timestamp: Date.now().toString()
-    });
-
-    return this.apiClient.get<TransactionDTO[]>(`${this.basePath}/me/sent?${params.toString()}`);
-  }
-
-  /**
-   * AUTH: Get user's received transactions
-   * 
-   * UPDATED: /transaction/auth/recipient → /transactions/me/received
-   */
-  async getUserReceivedTransactions(): Promise<TransactionDTO[]> {
-    const params = new URLSearchParams({
-      timestamp: Date.now().toString()
-    });
-
-    return this.apiClient.get<TransactionDTO[]>(`${this.basePath}/me/received?${params.toString()}`);
-  }
-
-  /**
-   * AUTH: Get user transaction history by type (backwards compatibility)
-   * 
-   * UPDATED: Maps to appropriate /transactions/me/* endpoints
-   */
-  async getUserTransactionHistory(type: string): Promise<TransactionDTO[]> {
-    const params = new URLSearchParams({
-      timestamp: Date.now().toString()
-    });
-    
-    // Map legacy type parameter to new endpoints
-    switch (type.toLowerCase()) {
-      case 'sender':
-      case 'sent':
-        return this.apiClient.get<TransactionDTO[]>(`${this.basePath}/me/sent?${params.toString()}`);
-      case 'recipient':
-      case 'received':
-        return this.apiClient.get<TransactionDTO[]>(`${this.basePath}/me/received?${params.toString()}`);
-      default:
-        // Default to sent transactions for backwards compatibility
-        return this.apiClient.get<TransactionDTO[]>(`${this.basePath}/me/sent?${params.toString()}`);
-    }
-  }
-
-  /**
-   * AUTH: Prepare client signed transaction
-   * 
-   * UPDATED: /transaction/auth/prepare-signing → /transactions/prepare
-   */
-  async prepareClientSignedTransaction(request: ClientTransactionRequestDTO): Promise<ClientTransactionRequestResponseDto> {
-    return this.apiClient.post<ClientTransactionRequestResponseDto>(`${this.basePath}/prepare`, request);
-  }
-
-  /**
-   * AUTH: Prepare existing transaction for client-side signing
-   * 
-   * NEW ENDPOINT: GET /transactions/{id}/prepare
-   */
-  async prepareExistingTransaction(transactionId: string): Promise<ClientTransactionRequestResponseDto> {
-    return this.apiClient.get<ClientTransactionRequestResponseDto>(`${this.basePath}/${transactionId}/prepare`);
-  }
-
-  /**
-   * AUTH: Submit client-side signed transaction
-   * 
-   * NEW ENDPOINT: POST /transactions/{id}/submit
-   */
-  async submitSignedTransaction(transactionId: string, signedData: any): Promise<TransactionDTO> {
-    return this.apiClient.post<TransactionDTO>(`${this.basePath}/${transactionId}/submit`, signedData);
-  }
-
-  /**
-   * AUTH: Burn user tokens
-   * 
-   * UPDATED: Uses new user transaction endpoint with burn-specific parameters
-   * Note: This might need backend confirmation on burn functionality implementation
-   */
-  async burnUserTokens(request: UserBurnTokenRequestDTO): Promise<TransactionDTO> {
-    // Map burn request to TransactionRequestDTO format for new endpoint
-    const transactionRequest: TransactionRequestDTO = {
-      ...request,
-      // Add any specific burn transaction parameters here
-    } as any;
-
-    return this.apiClient.post<TransactionDTO>(`${this.basePath}/user`, transactionRequest);
-  }
-
-  // ==========================================
-  // BUSINESS OPERATIONS
-  // ==========================================
-
-  /**
-   * BUSINESS: Create business transaction
-   * 
-   * UPDATED: /transaction/business/transaction → /transactions/business
-   */
-  async createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionDTO> {
-    return this.apiClient.post<TransactionDTO>(`${this.basePath}/business`, request);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create admin transaction
-   * 
-   * UPDATED: /transaction/admin/transaction → /transactions/admin
-   */
-  async createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionDTO> {
-    return this.apiClient.post<TransactionDTO>(`${this.basePath}/system`, request);
-  }
-
-  /**
-   * ADMIN: Get all tenant transactions
-   * 
-   * UPDATED: /transaction/admin → /transactions
-   */
-  async getTenantTransactions(): Promise<TransactionDTO[]> {
-    const result = await this.apiClient.get<TransactionPaginationResponse>(`${this.basePath}`);
-    // If the new endpoint returns paginated response, extract the data array
-    if ('data' in result) {
-      return result.data;
-    }
-    // Fallback for direct array response
-    return result as any as TransactionDTO[];
-  }
-
-  /**
-   * ADMIN: Get paginated transactions with filtering and sorting
-   * 
-   * UPDATED: /transaction/admin → /transactions (same endpoint, better structure)
-   */
-  async getPaginatedTransactions(params: TransactionPaginationParams): Promise<TransactionPaginationResponse> {
-    // Build query parameters
-    const queryParams: Record<string, string> = {
-      page: params.page.toString(),
-      limit: params.limit.toString()
-    };
-
-    // Add sorting parameters if provided
-    if (params.sortBy) {
-      queryParams['sortBy'] = params.sortBy;
-    }
-    if (params.sortOrder) {
-      queryParams['sortOrder'] = params.sortOrder;
-    }
-
-    // Add user-specific filtering if provided
-    if (params.participantId) {
-      queryParams['participantId'] = params.participantId;
-    }
-
-    // Add status filtering if provided
-    if (params.status) {
-      queryParams['status'] = params.status;
-    }
-
-    // Add additional filters if provided
-    if (params.filters) {
-      if (params.filters.startDate) {
-        queryParams['startDate'] = params.filters.startDate;
-      }
-      if (params.filters.endDate) {
-        queryParams['endDate'] = params.filters.endDate;
-      }
-      if (params.filters.type && params.filters.type.length > 0) {
-        queryParams['type'] = params.filters.type.join(',');
-      }
-      if (params.filters.tokenType && params.filters.tokenType.length > 0) {
-        queryParams['tokenType'] = params.filters.tokenType.join(',');
-      }
-    }
-
-    // Build query string
-    const queryString = Object.entries(queryParams)
-      .map(([key, value]) => `${key}=${encodeURIComponent(value)}`)
-      .join('&');
-
-    return this.apiClient.get<TransactionPaginationResponse>(`${this.basePath}?${queryString}`);
-  }
-
-  /**
-   * ADMIN: Export transactions to CSV
-   * 
-   * UPDATED: /transaction/admin/export/csv → /transactions/export/csv
-   */
-  async exportTransactionsCSV(): Promise<Blob> {
-    return this.apiClient.get<Blob>(`${this.basePath}/export/csv`, 'blob');
-  }
-
-  // ==========================================
-  // NEW ADMIN QUERY METHODS
-  // ==========================================
-
-  /**
-   * ADMIN: Query transactions by sender
-   * 
-   * NEW ENDPOINT: POST /transactions/query-sender
-   */
-  async queryTransactionsBySender(accountSelector: AccountSelectorDTO): Promise<TransactionDTO[]> {
-    return this.apiClient.post<TransactionDTO[]>(`${this.basePath}/query-sender`, accountSelector);
-  }
-
-  /**
-   * ADMIN: Query transactions by recipient
-   * 
-   * NEW ENDPOINT: POST /transactions/query-recipient
-   */
-  async queryTransactionsByRecipient(accountSelector: AccountSelectorDTO): Promise<TransactionDTO[]> {
-    return this.apiClient.post<TransactionDTO[]>(`${this.basePath}/query-recipient`, accountSelector);
-  }
-
-  /**
-   * ADMIN: Get transaction analytics
-   * 
-   * NEW ENDPOINT: POST /transactions/analytics
-   */
-  async getTransactionAnalytics(analyticsRequest: any): Promise<any> {
-    return this.apiClient.post<any>(`${this.basePath}/analytics`, analyticsRequest);
-  }
-
-  // ==========================================
-  // CONVENIENCE METHODS (BACKWARDS COMPATIBILITY)
-  // ==========================================
-
-  /**
-   * Convenience method: Get user sent transactions (alias)
-   */
-  async getUserSenderTransactions(): Promise<TransactionDTO[]> {
-    return this.getUserSentTransactions();
-  }
-
-  /**
-   * Convenience method: Get user received transactions (alias)
-   */
-  async getUserRecipientTransactions(): Promise<TransactionDTO[]> {
-    return this.getUserReceivedTransactions();
-  }
-}

package/src/transaction/index.ts

@@ -1,65 +0,0 @@
-/**
- * @explorins/pers-sdk-transaction
- * 
- * Platform-agnostic Transaction Domain SDK for PERS ecosystem
- * Handles transaction operations across different authorization levels
- */
-
-// API Layer
-export { TransactionApi } from './api/transaction-api';
-
-// Service Layer  
-export { TransactionService } from './services/transaction-service';
-
-// Models & Types
-export * from './models';
-export * from '../shared/interfaces/pers-shared-lib.interfaces';
-
-// Models & Types
-export * from './models';
-
-import { ClientTransactionRequestDTO, TransactionRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-// Factory function for creating transaction SDK instance
-import { PersApiClient } from '../core/pers-api-client';
-import { TransactionApi } from './api/transaction-api';
-import { TransactionService } from './services/transaction-service';
-import { TransactionPaginationParams, UserBurnTokenRequestDTO } from './models';
-
-/**
- * Create a complete Transaction SDK instance
- * 
- * @param apiClient - Configured PERS API client
- * @returns Transaction SDK with flattened structure for better DX
- */
-export function createTransactionSDK(apiClient: PersApiClient) {
-  const transactionApi = new TransactionApi(apiClient);
-  const transactionService = new TransactionService(transactionApi);
-  
-  return {
-    // Direct access to service methods (primary interface)
-    
-    // Public methods
-    getTransactionById: (transactionId: string) => transactionService.getTransactionById(transactionId),
-    
-    // Auth methods
-    createAuthTransaction: (request: TransactionRequestDTO) => transactionService.createAuthTransaction(request),
-    getUserTransactionHistory: (type: string) => transactionService.getUserTransactionHistory(type),
-    prepareClientSignedTransaction: (request: ClientTransactionRequestDTO) => transactionService.prepareClientSignedTransaction(request),
-    burnUserTokens: (request: UserBurnTokenRequestDTO) => transactionService.burnUserTokens(request),
-    
-    // Business methods
-    createBusinessTransaction: (request: TransactionRequestDTO) => transactionService.createBusinessTransaction(request),
-    
-    // Admin methods
-    createAdminTransaction: (request: TransactionRequestDTO) => transactionService.createAdminTransaction(request),
-    getTenantTransactions: () => transactionService.getTenantTransactions(),
-    getPaginatedTransactions: (params: TransactionPaginationParams) => transactionService.getPaginatedTransactions(params),
-    exportTransactionsCSV: () => transactionService.exportTransactionsCSV(),
-    
-    // Advanced access for edge cases
-    api: transactionApi,
-    service: transactionService
-  };
-}
-
-export type TransactionSDK = ReturnType<typeof createTransactionSDK>;

package/src/transaction/models/index.ts

@@ -1,60 +0,0 @@
-/**
- * Transaction Domain Models
- * 
- * Re-exports from @explorins/pers-shared for consistency with backend
- * and to provide a single import source for transaction-related types.
- */
-
-// Core transaction entities from centralized pers-shared interfaces
-export type {
-  TransactionDTO,
-  TransactionRequestDTO,
-  ClientTransactionRequestDTO,
-  ClientTransactionRequestResponseDto,
-  UserToBusinessTokenTransactionCreateRequestDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-// Import for local interface usage
-import { TransactionDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-// Local transaction interfaces
-// TODO: Move these to @explorins/pers-shared when standardized across domains
-export interface TransactionPaginationParams {
-  page: number;
-  limit: number;
-  participantId?: string; // User ID for filtering user transactions
-  status?: string;
-  sortBy?: string;      // ✅ ADD: Column to sort by
-  sortOrder?: 'ASC' | 'DESC'; // ✅ ADD: Sort direction
-  filters?: {
-    startDate?: string;
-    endDate?: string;
-    type?: string[];
-    tokenType?: string[];
-  };
-}
-
-export interface TransactionPaginationResponse {
-  data: TransactionDTO[];
-  pagination: {
-    page: string;
-    limit: string;
-    total: number;
-    pages: number;
-    hasNext: boolean;
-    hasPrev: boolean;
-  };
-}
-
-export interface UserBurnTokenRequestDTO {
-  tokenAddress: string;
-  tokenMetadataIncrementalId: string;
-  chainId: number;
-  amount: number;
-}
-
-// Transaction account types (domain-specific enum)
-export enum TransactionAccountType {
-  // Add specific transaction account types as needed
-  // This should match the enum used in the infrastructure layer
-}