@explorins/pers-sdk 1.1.2 → 1.1.3

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

@@ -1,104 +0,0 @@
-import { TransactionDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-import { TransactionApi } from '../api/transaction-api';
-import { 
-  TransactionRequestDTO,
-  ClientTransactionRequestDTO,
-  ClientTransactionRequestResponseDto,
-  TransactionPaginationParams,
-  TransactionPaginationResponse,
-  UserBurnTokenRequestDTO
-} from '../models';
-
-/**
- * Platform-Agnostic Transaction Service
- * 
- * Contains transaction business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * 
- * Focuses only on actual backend capabilities.
- */
-export class TransactionService {
-  constructor(private transactionApi: TransactionApi) {}
-
-  /**
-   * Get transaction by ID
-   */
-  async getTransactionById(transactionId: string): Promise<TransactionDTO> {
-    return this.transactionApi.getTransactionById(transactionId);
-  }
-
-  // ==========================================
-  // AUTHENTICATED OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Create authenticated transaction
-   */
-  async createAuthTransaction(request: TransactionRequestDTO): Promise<TransactionDTO> {
-    return this.transactionApi.createAuthTransaction(request);
-  }
-
-  /**
-   * AUTH: Get user transaction history by type
-   */
-  async getUserTransactionHistory(type: string): Promise<TransactionDTO[]> {
-    return this.transactionApi.getUserTransactionHistory(type);
-  }
-
-  /**
-   * AUTH: Prepare client signed transaction
-   */
-  async prepareClientSignedTransaction(request: ClientTransactionRequestDTO): Promise<ClientTransactionRequestResponseDto> {
-    return this.transactionApi.prepareClientSignedTransaction(request);
-  }
-
-  /**
-   * AUTH: Burn user tokens
-   */
-  async burnUserTokens(request: UserBurnTokenRequestDTO): Promise<TransactionDTO> {
-    return this.transactionApi.burnUserTokens(request);
-  }
-
-  // ==========================================
-  // BUSINESS OPERATIONS
-  // ==========================================
-
-  /**
-   * BUSINESS: Create business transaction
-   */
-  async createBusinessTransaction(request: TransactionRequestDTO): Promise<TransactionDTO> {
-    return this.transactionApi.createBusinessTransaction(request);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create admin transaction
-   */
-  async createAdminTransaction(request: TransactionRequestDTO): Promise<TransactionDTO> {
-    return this.transactionApi.createAdminTransaction(request);
-  }
-
-  /**
-   * ADMIN: Get all tenant transactions
-   */
-  async getTenantTransactions(): Promise<TransactionDTO[]> {
-    return this.transactionApi.getTenantTransactions();
-  }
-
-  /**
-   * ADMIN: Get paginated transactions with filtering and sorting
-   */
-  async getPaginatedTransactions(params: TransactionPaginationParams): Promise<TransactionPaginationResponse> {
-    return this.transactionApi.getPaginatedTransactions(params);
-  }
-
-  /**
-   * ADMIN: Export transactions to CSV
-   */
-  async exportTransactionsCSV(): Promise<Blob> {
-    return this.transactionApi.exportTransactionsCSV();
-  }
-}

package/src/user/api/user-api.ts

@@ -1,98 +0,0 @@
-import { UserDTO, UserCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-import { PersApiClient } from '../../core/pers-api-client';
-import { UserPublicProfileDTO } from '../models';
-
-/**
- * Platform-Agnostic User API Client
- * 
- * Handles user operations using the PERS backend RESTful API.
- * Updated to use new /users endpoints with enhanced security and consistency.
- * Maintains framework UserApiService method compatibility.
- */
-export class UserApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  private readonly basePath = '/users';
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get all users public profiles with optional filtering
-   * ✅ UPDATED: Uses new RESTful /users/public endpoint
-   */
-  async getAllUsersPublicProfiles(filter: {key: string, value: string} | null = null): Promise<UserPublicProfileDTO[]> {
-    let url = `${this.basePath}/public`;
-    
-    if (filter) {
-      // ✅ MAINTAINED: Same parameter pattern for compatibility
-      const params = new URLSearchParams();
-      params.set('filterKey', filter.key);
-      params.set('filterValue', filter.value);
-      url += `?${params.toString()}`;
-    }
-    
-    return this.apiClient.get<UserPublicProfileDTO[]>(url);
-  }
-
-  // ==========================================
-  // AUTHENTICATED OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Get current authenticated user
-   * ✅ UPDATED: Uses new RESTful /users/me endpoint
-   */
-  async getRemoteUser(): Promise<UserDTO> {
-    return this.apiClient.get<UserDTO>(`${this.basePath}/me`);
-  }
-
-  /**
-   * AUTH: Update current authenticated user
-   * ✅ UPDATED: Uses new RESTful /users/me endpoint
-   */
-  async updateRemoteUser(updateRequest: UserCreateRequestDTO): Promise<UserDTO> {
-    return this.apiClient.put<UserDTO>(`${this.basePath}/me`, updateRequest);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Get all remote users with query parameters
-   * ✅ UPDATED: Uses new RESTful /users endpoint with role-based access
-   * Note: Admin users get full data, non-admin users get public profiles only
-   */
-  async getAllRemoteUsers(): Promise<UserDTO[]> {
-    // ✅ MAINTAINED: Same merge=soft parameter for compatibility
-    const url = `${this.basePath}?merge=soft`;
-    return this.apiClient.get<UserDTO[]>(url);
-  }
-
-  /**
-   * ADMIN: Update user as admin
-   * ✅ UPDATED: Uses new RESTful /users/{id} endpoint
-   */
-  async updateUserAsAdmin(id: string, userData: UserCreateRequestDTO): Promise<UserDTO> {
-    return this.apiClient.put<UserDTO>(`${this.basePath}/${id}`, userData);
-  }
-
-  /**
-   * ADMIN: Toggle user active status
-   * ✅ UPDATED: Uses new consistent /users/{id}/status endpoint
-   * Enhanced: Follows RESTful status management pattern across all domains
-   */
-  async toggleUserActiveStatusByUser(user: UserDTO): Promise<UserDTO> {
-    return this.apiClient.put<UserDTO>(`${this.basePath}/${user.id}/status`, {});
-  }
-
-  /**
-   * ADMIN: Get user by unique identifier
-   * ✅ UPDATED: Uses new RESTful /users/{id} endpoint
-   */
-  async getUserByUniqueIdentifier(id: string): Promise<UserDTO> {
-    return this.apiClient.get<UserDTO>(`${this.basePath}/${id}`);
-  }
-}

package/src/user/index.ts

@@ -1,62 +0,0 @@
-/**
- * @explorins/pers-sdk-user
- * 
- * Platform-agnostic User Domain SDK for PERS ecosystem
- * Handles user management, profiles, and authentication operations
- */
-
-// API Layer
-export { UserApi } from './api/user-api';
-
-// Service Layer  
-export { UserService } from './services/user-service';
-
-// Models & Types
-export * from './models';
-export * from '../shared/interfaces/pers-shared-lib.interfaces';
-
-// Factory function for creating user SDK instance
-import { PersApiClient } from '../core/pers-api-client';
-import { UserApi } from './api/user-api';
-import { UserService } from './services/user-service';
-import { UserDTO, UserCreateRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Create a complete User SDK instance
- * 
- * @param apiClient - Configured PERS API client
- * @returns User SDK with flattened structure for better DX
- */
-export function createUserSDK(apiClient: PersApiClient) {
-  const userApi = new UserApi(apiClient);
-  const userService = new UserService(userApi);
-  
-  return {
-    // Direct access to service methods (primary interface)
-    
-    // Public methods - matches framework exactly
-    getAllUsersPublicProfiles: (filter: {key: string, value: string} | null = null) => 
-      userService.getAllUsersPublicProfiles(filter),
-    
-    // Auth methods - matches framework exactly
-    getRemoteUser: () => userService.getRemoteUser(),
-    updateRemoteUser: (updateRequest: UserCreateRequestDTO) => 
-      userService.updateRemoteUser(updateRequest),
-    
-    // Admin methods - matches framework exactly
-    getAllRemoteUsers: () => userService.getAllRemoteUsers(),
-    updateUserAsAdmin: (id: string, userData: UserCreateRequestDTO) => 
-      userService.updateUserAsAdmin(id, userData),
-    toggleUserActiveStatusByUser: (user: UserDTO) => 
-      userService.toggleUserActiveStatusByUser(user),
-
-    getUserByUniqueIdentifier: (id: string) =>
-      userService.getUserByUniqueIdentifier(id),
-    
-    // Advanced access for edge cases
-    api: userApi,
-    service: userService
-  };
-}
-
-export type UserSDK = ReturnType<typeof createUserSDK>;

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

@@ -1,75 +0,0 @@
-import { UserDTO, UserCreateRequestDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-import { UserApi } from '../api/user-api';
-import { UserPublicProfileDTO } from '../models';
-
-/**
- * Platform-Agnostic User Service
- * 
- * Contains user business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework UserApiService capabilities exactly.
- */
-export class UserService {
-  constructor(private userApi: UserApi) {}
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get all users public profiles with optional filtering
-   * ✅ FIXED: Uses framework-compatible inline filter type
-   */
-  async getAllUsersPublicProfiles(filter: {key: string, value: string} | null = null): Promise<UserPublicProfileDTO[]> {
-    return this.userApi.getAllUsersPublicProfiles(filter);
-  }
-
-  // ==========================================
-  // AUTHENTICATED OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Get current authenticated user
-   */
-  async getRemoteUser(): Promise<UserDTO> {
-    return this.userApi.getRemoteUser();
-  }
-
-  /**
-   * AUTH: Update current authenticated user
-   */
-  async updateRemoteUser(updateRequest: UserCreateRequestDTO): Promise<UserDTO> {
-    return this.userApi.updateRemoteUser(updateRequest);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Get all remote users
-   * ✅ FIXED: Matches API method signature (no parameters needed)
-   */
-  async getAllRemoteUsers(): Promise<UserDTO[]> {
-    return this.userApi.getAllRemoteUsers();
-  }
-
-  /**
-   * ADMIN: Update user as admin
-   */
-  async updateUserAsAdmin(id: string, userData: UserCreateRequestDTO): Promise<UserDTO> {
-    return this.userApi.updateUserAsAdmin(id, userData);
-  }
-
-  async getUserByUniqueIdentifier(id: string): Promise<UserDTO> {
-    return this.userApi.getUserByUniqueIdentifier(id);
-  }
-
-  /**
-   * ADMIN: Toggle user active status by user object
-   * ✅ FIXED: Matches API method signature exactly
-   */
-  async toggleUserActiveStatusByUser(user: UserDTO): Promise<UserDTO> {
-    return this.userApi.toggleUserActiveStatusByUser(user);
-  }
-}

package/src/user-status/api/user-status-api.ts

@@ -1,78 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { UserStatusTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Platform-Agnostic User Status API Client
- * 
- * Handles user status operations using the PERS backend.
- * Matches framework UserStatusApiService methods exactly.
- * 
- * ✅ UPDATED: All endpoints updated to new RESTful /users patterns
- * 
- * Error handling patterns follow framework implementation:
- * - getRemoteEarnedUserStatus() uses silent fallback (empty array)
- * - Other operations throw errors for proper error handling
- */
-export class UserStatusApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  private readonly basePath = '/users';
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get remote user status types
-   * ✅ UPDATED: /user/status-type → /users/status-types
-   */
-  async getRemoteUserStatusTypes(): Promise<UserStatusTypeDTO[]> {
-    try {
-      return await this.apiClient.get<UserStatusTypeDTO[]>(`${this.basePath}/status-types`);
-    } catch (error) {
-      console.error('Error getting user status types', error);
-      throw error;
-    }
-  }
-
-  // ==========================================
-  // AUTHENTICATED OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Get earned user status for authenticated user
-   * ✅ UPDATED: /user/auth/status → /users/me/status
-   * ✅ FIXED: Returns UserStatusTypeDTO[] to match framework exactly
-   * Note: Uses silent fallback pattern from framework - returns empty array on error
-   */
-  async getRemoteEarnedUserStatus(): Promise<UserStatusTypeDTO[]> {
-    try {
-      return await this.apiClient.get<UserStatusTypeDTO[]>(`${this.basePath}/me/status`);
-    } catch (error) {
-      console.error('Error getting user status', error);
-      // ✅ FIXED: Silent fallback pattern from framework implementation
-      return [];
-    }
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create user status type
-   * ✅ UPDATED: /user/admin/status-type → /users/status-types
-   */
-  async createUserStatusType(userStatusType: UserStatusTypeDTO): Promise<UserStatusTypeDTO> {
-    try {
-      return await this.apiClient.post<UserStatusTypeDTO>(`${this.basePath}/status-types`, userStatusType);
-    } catch (error) {
-      console.error('Error creating user status type', error);
-      throw error;
-    }
-  }
-
-  // ❌ REMOVED: Methods not present in framework
-  // - updateUserStatusType() - Framework doesn't have this operation
-  // - toggleUserStatusTypeActive() - Framework doesn't have this operation
-}

package/src/user-status/index.ts

@@ -1,55 +0,0 @@
-/**
- * @explorins/pers-sdk-user-status
- * 
- * Platform-agnostic User Status Domain SDK for PERS ecosystem
- * Handles user status management and type operations
- */
-
-// API Layer
-export { UserStatusApi } from './api/user-status-api';
-
-// Service Layer  
-export { UserStatusService } from './services/user-status-service';
-
-// Models & Types - re-export all centralized interfaces
-export * from '../shared/interfaces/pers-shared-lib.interfaces';
-
-// Models & Types - imported from centralized interfaces
-
-// Factory function for creating user-status SDK instance
-import { PersApiClient } from '../core/pers-api-client';
-import { UserStatusApi } from './api/user-status-api';
-import { UserStatusService } from './services/user-status-service';
-import { UserStatusTypeDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Create a complete User Status SDK instance
- * 
- * @param apiClient - Configured PERS API client
- * @returns User Status SDK with flattened structure for better DX
- */
-export function createUserStatusSDK(apiClient: PersApiClient) {
-  const userStatusApi = new UserStatusApi(apiClient);
-  const userStatusService = new UserStatusService(userStatusApi);
-  
-  return {
-    // Direct access to service methods (primary interface)
-    // ✅ FRAMEWORK ALIGNED: Only methods actually used by framework
-    
-    // Public methods
-    getRemoteUserStatusTypes: () => userStatusService.getRemoteUserStatusTypes(),
-    
-    // Auth methods
-    getRemoteEarnedUserStatus: () => userStatusService.getRemoteEarnedUserStatus(),
-    
-    // Admin methods
-    createUserStatusType: (userStatusType: UserStatusTypeDTO) => 
-      userStatusService.createUserStatusType(userStatusType),
-    
-    // Advanced access for edge cases
-    api: userStatusApi,
-    service: userStatusService
-  };
-}
-
-export type UserStatusSDK = ReturnType<typeof createUserStatusSDK>;

package/src/user-status/services/user-status-service.ts

@@ -1,51 +0,0 @@
-import { UserStatusApi } from '../api/user-status-api';
-import { UserStatusTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Platform-Agnostic User Status Service
- * 
- * Contains user status business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework UserStatusApiService capabilities exactly.
- */
-export class UserStatusService {
-  constructor(private userStatusApi: UserStatusApi) {}
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get remote user status types
-   */
-  async getRemoteUserStatusTypes(): Promise<UserStatusTypeDTO[]> {
-    return this.userStatusApi.getRemoteUserStatusTypes();
-  }
-
-  // ==========================================
-  // AUTHENTICATED OPERATIONS
-  // ==========================================
-
-  /**
-   * AUTH: Get earned user status for authenticated user
-   */
-  async getRemoteEarnedUserStatus(): Promise<UserStatusTypeDTO[]> {
-    return this.userStatusApi.getRemoteEarnedUserStatus();
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create user status type
-   */
-  async createUserStatusType(userStatusType: UserStatusTypeDTO): Promise<UserStatusTypeDTO> {
-    return this.userStatusApi.createUserStatusType(userStatusType);
-  }
-
-  // ❌ REMOVED: Business logic methods not present in framework
-  // - hasUserReachedStatusLevel() - Framework doesn't need this logic
-  // - getUserHighestStatusLevel() - Framework doesn't need this logic
-  // These can be added later if actually needed
-}

package/src/web3/api/web3-api.ts

@@ -1,68 +0,0 @@
-import { Web3ChainService } from '../../web3-chain/services/web3-chain-service';
-import type { ContractAbi } from 'web3';
-import { 
-  getAddressTokenBalanceByContract,
-  getSmartContractInstance,
-  getTokenOfOwnerByIndex, 
-  getTokenUri
-} from '@explorins/web3-ts';
-
-
-export class Web3Api {
-  
-  constructor(
-    private web3ChainService: Web3ChainService,
-  ) {}
-
-  async getTokenBalance(request: {
-    accountAddress: string;
-    contractAddress: string;
-    abi: ContractAbi;
-    tokenId: string | null;
-    chainId: number;
-  }): Promise<number> {
-    const web3 = await this.web3ChainService.getWeb3ByChainId(request.chainId);
-
-    const tokenContract = getSmartContractInstance(request.contractAddress, request.abi, web3);
-    const balance = await getAddressTokenBalanceByContract(
-      tokenContract, 
-      request.accountAddress, 
-      request.tokenId
-    );
-    
-    return Number(balance);
-  }
-
-  async getTokenUri(request: {
-    contractAddress: string;
-    abi: ContractAbi;
-    tokenId: string;
-    chainId: number;
-  }): Promise<string> {
-    const web3 = await this.web3ChainService.getWeb3ByChainId(request.chainId);
-    
-    // ✅ DIRECT: Use web3-ts functions directly
-    const tokenContract = getSmartContractInstance(request.contractAddress, request.abi, web3);
-    const tokenId = Number(request.tokenId);
-    const tokenUri = await getTokenUri(tokenContract, tokenId);
-    
-    return String(tokenUri);
-  }
-
-
-  async getTokenOfOwnerByIndex(request: {
-    contractAddress: string;
-    abi: ContractAbi;
-    accountAddress: string;
-    tokenIndex: number;
-    chainId: number;
-  }): Promise<string> {
-    const web3 = await this.web3ChainService.getWeb3ByChainId(request.chainId);
-    
-    // ✅ DIRECT: Use web3-ts functions directly
-    const tokenContract = getSmartContractInstance(request.contractAddress, request.abi, web3);
-    const tokenId = await getTokenOfOwnerByIndex(tokenContract, request.accountAddress, request.tokenIndex);
-    
-    return String(tokenId);
-  }
-}

package/src/web3/index.ts

@@ -1,38 +0,0 @@
-import { PersApiClient } from '../core/pers-api-client';
-import { Web3Api } from './api/web3-api';
-import { Web3Service } from './services/web3-service';
-import { createWeb3ChainSDK } from '../web3-chain';
-import { ContractAbi, ERC1155CollectionRequest, ERC20BalanceRequest, ERC721CollectionRequest, ERC721CollectionResponse, Web3BalanceRequest, Web3BalanceResponse, Web3TokenListRequest, Web3TokenListResponse } from './models';
-import { Web3ProviderService } from '../web3-chain/services/provider.service';
-
-export function createWeb3SDK(
-  apiClient: PersApiClient,
-  web3ProviderService: Web3ProviderService,
-) {
-  const web3ChainSDK = createWeb3ChainSDK(apiClient, web3ProviderService);
-  
-  const web3Api = new Web3Api(
-    web3ChainSDK.service, 
-  );
-  
-  const web3Service = new Web3Service(web3Api, web3ChainSDK.service);
-  
-  return {
-
-    getCreditsBalance: (request: ERC20BalanceRequest): Promise<Web3BalanceResponse> => 
-      web3Service.getERC20Balance(request),
-    
-    getRewardsCollection: (request: ERC1155CollectionRequest): Promise<Web3TokenListResponse> => 
-      web3Service.getERC1155Collection(request),
-    
-    getStampsCollection: (request: ERC721CollectionRequest): Promise<ERC721CollectionResponse> => 
-      web3Service.getERC721Collection(request),
-    
-    api: web3Api,
-    service: web3Service
-  };
-}
-
-export * from './models';
-export type { ERC20BalanceRequest, ERC1155CollectionRequest, ERC721CollectionRequest, ERC721CollectionResponse, NFTItem } from './models';
-export * from '../shared/interfaces/pers-shared-lib.interfaces';