@explorins/pers-sdk 1.1.2 → 1.2.0

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

@@ -1,78 +0,0 @@
-import { AdminDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-import { TenantApi } from '../api/tenant-api';
-import { 
-  TenantPublicDTO,
-  TenantClientConfigDTO,
-  AdminCreateRequestDTO
-} from '../models';
-
-/**
- * Platform-Agnostic Tenant Service
- * 
- * Contains tenant business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework TenantApiService capabilities exactly.
- */
-export class TenantService {
-  constructor(private tenantApi: TenantApi) {}
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get tenant public information
-   */
-  async getRemoteTenant(): Promise<TenantPublicDTO> {
-    return this.tenantApi.getRemoteTenant();
-  }
-
-  /**
-   * PUBLIC: Get remote login token
-   */
-  async getRemoteLoginToken(): Promise<string> {
-    return this.tenantApi.getRemoteLoginToken();
-  }
-
-  /**
-   * PUBLIC: Get remote client configuration
-   */
-  async getRemoteClientConfig(): Promise<TenantClientConfigDTO> {
-    return this.tenantApi.getRemoteClientConfig();
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Update tenant information
-   * ✅ FIXED: Uses TenantPublicDTO directly like framework
-   */
-  async updateRemoteTenant(tenantData: TenantPublicDTO): Promise<TenantPublicDTO> {
-    return this.tenantApi.updateRemoteTenant(tenantData);
-  }
-
-  /**
-   * ADMIN: Get all tenant admins
-   */
-  async getAdmins(): Promise<AdminDTO[]> {
-    return this.tenantApi.getAdmins();
-  }
-
-  /**
-   * ADMIN: Create new admin
-   * ✅ FIXED: Renamed to match framework postAdmin method
-   */
-  async postAdmin(adminData: AdminCreateRequestDTO): Promise<AdminDTO> {
-    return this.tenantApi.postAdmin(adminData);
-  }
-
-  /**
-   * ADMIN: Update admin (toggle tenant association)
-   * ✅ FIXED: Renamed to match framework putAdmin method
-   */
-  async putAdmin(adminId: string, adminData: AdminCreateRequestDTO): Promise<AdminDTO> {
-    return this.tenantApi.putAdmin(adminId, adminData);
-  }
-}

package/src/token/api/token-api.ts

@@ -1,129 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { 
-  TokenDTO,
-  TokenTypeDTO,
-  TokenCreateRequestDTO,
-  TokenStorageData,
-  TokenUpdateRequestDTO,
-  TokenMetadataDTO
-} from '../models';
-
-
-export class TokenApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  private basePath = '/tokens';
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get all remote tokens
-   * ENHANCED: Added admin filtering capability
-   */
-  async getRemoteTokens(includeInactive: boolean = false): Promise<TokenDTO[]> {
-    const url = includeInactive ? `${this.basePath}?active=false` : `${this.basePath}`;
-    return this.apiClient.get<TokenDTO[]>(url);
-  }
-
-  /**
-   * PUBLIC: Get all remote token types
-   */
-  async getRemoteTokenTypes(): Promise<TokenTypeDTO[]> {
-    return this.apiClient.get<TokenTypeDTO[]>(`${this.basePath}/types`);
-  }
-
-  /**
-   * PUBLIC: Get active point token (was credit token)
-   */
-  async getRemoteActiveCreditToken(): Promise<TokenDTO> {
-    return this.apiClient.get<TokenDTO>(`${this.basePath}/points`);
-  }
-
-  /**
-   * PUBLIC: Get reward tokens
-   * ENHANCED: Added admin filtering capability
-   */
-  async getRemoteRewardTokens(includeInactive: boolean = false): Promise<TokenDTO[]> {
-    const url = includeInactive ? `${this.basePath}/rewards?active=false` : `${this.basePath}/rewards`;
-    return this.apiClient.get<TokenDTO[]>(url);
-  }
-
-  /**
-   * PUBLIC: Get stamp tokens (was status tokens)
-   * ENHANCED: Added admin filtering capability
-   */
-  async getRemoteStatusTokens(includeInactive: boolean = false): Promise<TokenDTO[]> {
-    const url = includeInactive ? `${this.basePath}/stamps?active=false` : `${this.basePath}/stamps`;
-    return this.apiClient.get<TokenDTO[]>(url);
-  }
-
-  /**
-   * PUBLIC: Get token by contract address
-   */
-  async getTokenByContractAddress(contractAddress: string, contractTokenId: string | null): Promise<TokenDTO> {
-    let url = `${this.basePath}/address/${contractAddress}`;
-    if (contractTokenId) {
-      url += `?contractTokenId=${contractTokenId}`;
-    }
-    return this.apiClient.get<TokenDTO>(url);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create new token
-   */
-  async createToken(tokenData: TokenCreateRequestDTO): Promise<TokenDTO> {
-    return this.apiClient.post<TokenDTO>(`${this.basePath}`, tokenData);
-  }
-
-  /**
-   * ADMIN: Update token
-   */
-  async updateToken(tokenId: string, tokenData: TokenUpdateRequestDTO): Promise<TokenDTO> {
-    return this.apiClient.put<TokenDTO>(`${this.basePath}/${tokenId}`, tokenData);
-  }
-
-  /**
-   * ADMIN: Toggle token active status
-   * FIXED: Now calls correct endpoint
-   */
-  async toggleTokenActive(tokenId: string): Promise<TokenDTO> {
-    return this.apiClient.put<TokenDTO>(`${this.basePath}/${tokenId}/status`, {});
-  }
-
-  /**
-   * ADMIN: Set mainnet contract address
-   */
-  async setMainnetContract(tokenId: string, contractAddress: string, chainId: number): Promise<TokenDTO> {
-    return this.apiClient.put<TokenDTO>(`${this.basePath}/${tokenId}/mainnet`, {
-      contractAddress,
-      chainId
-    });
-  }
-
-  /**
-   * ADMIN: Create token metadata
-   */
-  async createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO> {
-    return this.apiClient.post<TokenDTO>(`${this.basePath}/${tokenId}/metadata`, tokenData);
-  }
-
-  /**
-   * ADMIN: Toggle token metadata status (separate from token status)
-   */
-  async toggleTokenMetadataStatus(metadataId: string): Promise<TokenMetadataDTO> {
-    return this.apiClient.put<TokenMetadataDTO>(`${this.basePath}/metadata/${metadataId}/status`, {});
-  }
-
-  /**
-   * ADMIN: Create token type
-   */
-  async createTokenType(tokenType: TokenTypeDTO): Promise<TokenTypeDTO> {
-    return this.apiClient.post<TokenTypeDTO>(`${this.basePath}/types`, tokenType);
-  }
-}

package/src/token/base/base-token-service.ts

@@ -1,167 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { TokenApi } from '../api/token-api';
-import { TokenService as TokenBusinessService } from '../services/token-service';
-import { 
-  TokenDTO,
-  TokenStorageData,
-  TokenCreateRequestDTO,
-  TokenUpdateRequestDTO,
-  TokenMetadataDTO
-} from '../models';
-import { TokenTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Abstract Base Token Service - Explicit Initialization Pattern
- * 
- * Platform-agnostic token operations with Promise-based API.
- * Framework services extend this and control initialization lifecycle.
- * 
- * Benefits:
- * - Explicit initialization control
- * - Better error boundaries  
- * - Clear lifecycle management
- * - Testable initialization state
- * - Zero framework dependencies
- */
-export abstract class BaseTokenService {
-  // Private token service layers - initialized explicitly
-  private _tokenApi?: TokenApi;
-  private _tokenBusinessService?: TokenBusinessService;
-  private _isInitialized = false;
-
-  // ==========================================
-  // INITIALIZATION LIFECYCLE
-  // ==========================================
-
-  /**
-   * LIFECYCLE: Initialize token service with API client
-   * Must be called before using any token operations
-   */
-  protected initializeTokenService(apiClient: PersApiClient): void {
-    if (!apiClient) {
-      throw new Error('Cannot initialize TokenService: apiClient is null or undefined');
-    }
-
-    if (!this._isInitialized) {
-      this._tokenApi = new TokenApi(apiClient);
-      this._tokenBusinessService = new TokenBusinessService(this._tokenApi);
-      this._isInitialized = true;
-    }
-  }
-
-  /**
-   * LIFECYCLE: Check if token service is initialized
-   */
-  protected get isTokenServiceInitialized(): boolean {
-    return this._isInitialized;
-  }
-
-  /**
-   * INTERNAL: Get token business service (throws if not initialized)
-   */
-  private get tokenBusinessService(): TokenBusinessService {
-    if (!this._tokenBusinessService) {
-      throw new Error('TokenService not initialized. Call initializeTokenService(apiClient) first.');
-    }
-    return this._tokenBusinessService;
-  }
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get all remote tokens
-   */
-  public getRemoteTokens(): Promise<TokenDTO[]> {
-    return this.tokenBusinessService.getRemoteTokens();
-  }
-
-  /**
-   * PUBLIC: Get all remote token types
-   */
-  public getRemoteTokenTypes(): Promise<TokenTypeDTO[]> {
-    return this.tokenBusinessService.getRemoteTokenTypes();
-  }
-
-  /**
-   * PUBLIC: Get active credit token
-   */
-  public getRemoteActiveCreditToken(): Promise<TokenDTO> {
-    return this.tokenBusinessService.getRemoteActiveCreditToken();
-  }
-
-  /**
-   * PUBLIC: Get reward tokens
-   */
-  public getRemoteRewardTokens(): Promise<TokenDTO[]> {
-    return this.tokenBusinessService.getRemoteRewardTokens();
-  }
-
-  /**
-   * PUBLIC: Get status tokens
-   */
-  public getRemoteStatusTokens(): Promise<TokenDTO[]> {
-    return this.tokenBusinessService.getRemoteStatusTokens();
-  }
-
-  /**
-   * PUBLIC: Get token by contract address
-   */
-  public getTokenByContractAddress(contractAddress: string, contractTokenId: string | null): Promise<TokenDTO> {
-    return this.tokenBusinessService.getTokenByContractAddress(contractAddress, contractTokenId);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create token metadata
-   */
-  public createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO> {
-    return this.tokenBusinessService.createTokenMetadata(tokenId, tokenData);
-  }
-
-  /**
-   * ADMIN: Toggle token active status
-   */
-  public toggleTokenActive(tokenId: string): Promise<TokenDTO> {
-    return this.tokenBusinessService.toggleTokenActive(tokenId);
-  }
-
-  /**
-   * ADMIN: Create new token
-   */
-  public createToken(tokenData: TokenCreateRequestDTO): Promise<TokenDTO> {
-    return this.tokenBusinessService.createToken(tokenData);
-  }
-
-  /**
-   * ADMIN: Update token
-   */
-  public updateToken(tokenId: string, tokenData: TokenUpdateRequestDTO): Promise<TokenDTO> {
-    return this.tokenBusinessService.updateToken(tokenId, tokenData);
-  }
-
-  /**
-   * ADMIN: Set mainnet contract address
-   */
-  public setMainnetContract(tokenId: string, contractAddress: string, chainId: number): Promise<TokenDTO> {
-    return this.tokenBusinessService.setMainnetContract(tokenId, contractAddress, chainId);
-  }
-
-  /**
-   * ADMIN: Toggle token metadata status
-   */
-  public toggleTokenMetadataStatus(metadataId: string): Promise<TokenMetadataDTO> {
-    return this.tokenBusinessService.toggleTokenMetadataStatus(metadataId);
-  }
-
-  /**
-   * ADMIN: Create token type
-   */
-  public createTokenType(tokenType: TokenTypeDTO): Promise<TokenTypeDTO> {
-    return this.tokenBusinessService.createTokenType(tokenType);
-  }
-}

package/src/token/index.ts

@@ -1,38 +0,0 @@
-/**
- * @explorins/pers-sdk-token
- * 
- * Platform-agnostic Token Domain SDK for PERS ecosystem
- * Modern class-based approach for optimal performance and developer experience
- */
-
-// 🚀 MAIN SDK EXPORT - Recommended approach
-export { TokenSDK } from './token-sdk';
-
-// 🔧 CORE COMPONENTS - For advanced usage
-export { TokenApi } from './api/token-api';
-export { TokenService } from './services/token-service';
-
-// 📋 MODELS & TYPES
-export * from './models';
-export * from '../shared/interfaces/pers-shared-lib.interfaces';
-
-// 🔄 LEGACY EXPORTS - For backward compatibility (deprecated)
-export { BaseTokenService } from './base/base-token-service';
-// Note: ConcreteTokenService has been replaced by TokenSDK class-based approach
-
-// ==========================================
-// INHERITANCE PATTERN - CLEAN ARCHITECTURE
-// ==========================================
-// Framework services extend TokenService directly:
-//
-// Example usage:
-//   export class TokenSdkApiService extends TokenService {
-//     private persSDK = inject(PERS_ANGULAR_SDK_SERVICE);
-//     protected get apiClient() { return this.persSDK.api(); }
-//   }
-//
-// Benefits:
-// - Zero boilerplate: Just extend and provide apiClient
-// - Type safety: Full IntelliSense support
-// - Platform agnostic: SDK stays pure Promise-based
-// - Framework flexibility: Add Observable wrappers as needed

package/src/token/models/index.ts

@@ -1,30 +0,0 @@
-/**
- * Token Domain Models
- * 
- * Re-exports from @explorins/pers-shared for consistency with backend
- * and to provide a single import source for token-related types.
- */
-
-// Core token entities from centralized pers-shared interfaces
-export type {
-  TokenDTO,
-  TokenTypeDTO,
-  TokenCreateRequestDTO,
-  TokenUpdateRequestDTO,
-  TokenMetadataDTO,
-  TokenStorageData
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-// Local token interfaces
-export interface TokenMetadataAttribute {
-  trait_type: TokenMetadataAttributeType;
-  value: string;
-}
-
-export type TokenMetadataAttributeType = 'expiry_date' | 'creator_account_address' | 'preview_url' | 'creatorAccountAddress'
-
-export interface TokenAttribute {
-  trait_type: string;
-  value: string | number;
-  display_type?: string;
-}

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

@@ -1,125 +0,0 @@
-import { TokenApi } from '../api/token-api';
-import { 
-  TokenDTO,
-  TokenStorageData,
-  TokenCreateRequestDTO,
-  TokenUpdateRequestDTO,
-  TokenMetadataDTO
-} from '../models';
-import { TokenTypeDTO } from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Platform-Agnostic Token Service
- * 
- * Contains token business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * Matches framework TokenApiService capabilities exactly.
- */
-export class TokenService {
-  constructor(private tokenApi: TokenApi) {}
-
-  // ==========================================
-  // PUBLIC OPERATIONS
-  // ==========================================
-
-  /**
-   * PUBLIC: Get all remote tokens
-   */
-  async getRemoteTokens(): Promise<TokenDTO[]> {
-    return this.tokenApi.getRemoteTokens();
-  }
-
-  /**
-   * PUBLIC: Get all remote token types
-   */
-  async getRemoteTokenTypes(): Promise<TokenTypeDTO[]> {
-    return this.tokenApi.getRemoteTokenTypes();
-  }
-
-  /**
-   * PUBLIC: Get active credit token
-   */
-  async getRemoteActiveCreditToken(): Promise<TokenDTO> {
-    return this.tokenApi.getRemoteActiveCreditToken();
-  }
-
-  /**
-   * PUBLIC: Get reward tokens
-   */
-  async getRemoteRewardTokens(): Promise<TokenDTO[]> {
-    return this.tokenApi.getRemoteRewardTokens();
-  }
-
-  /**
-   * PUBLIC: Get status tokens
-   */
-  async getRemoteStatusTokens(): Promise<TokenDTO[]> {
-    return this.tokenApi.getRemoteStatusTokens();
-  }
-
-  /**
-   * PUBLIC: Get token by contract address
-   * ✅ FIXED: Matches framework parameter types exactly
-   */
-  async getTokenByContractAddress(contractAddress: string, contractTokenId: string | null): Promise<TokenDTO> {
-    return this.tokenApi.getTokenByContractAddress(contractAddress, contractTokenId);
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create token metadata
-   */
-  async createTokenMetadata(tokenId: string, tokenData: TokenStorageData): Promise<TokenDTO> {
-    return this.tokenApi.createTokenMetadata(tokenId, tokenData);
-  }
-
-  /**
-   * ADMIN: Toggle token active status
-   */
-  async toggleTokenActive(tokenId: string): Promise<TokenDTO> {
-    return this.tokenApi.toggleTokenActive(tokenId);
-  }
-
-  /**
-   * ADMIN: Create new token
-   */
-  async createToken(tokenData: TokenCreateRequestDTO): Promise<TokenDTO> {
-    return this.tokenApi.createToken(tokenData);
-  }
-
-  /**
-   * ADMIN: Update token
-   */
-  async updateToken(tokenId: string, tokenData: TokenUpdateRequestDTO): Promise<TokenDTO> {
-    return this.tokenApi.updateToken(tokenId, tokenData);
-  }
-
-  /**
-   * ADMIN: Set mainnet contract address
-   */
-  async setMainnetContract(tokenId: string, contractAddress: string, chainId: number): Promise<TokenDTO> {
-    return this.tokenApi.setMainnetContract(tokenId, contractAddress, chainId);
-  }
-
-  /**
-   * ADMIN: Toggle token metadata status
-   */
-  async toggleTokenMetadataStatus(metadataId: string): Promise<TokenMetadataDTO> {
-    return this.tokenApi.toggleTokenMetadataStatus(metadataId);
-  }
-
-  /**
-   * ADMIN: Create token type
-   */
-  async createTokenType(tokenType: TokenTypeDTO): Promise<TokenTypeDTO> {
-    return this.tokenApi.createTokenType(tokenType);
-  }
-
-  // ❌ REMOVED: Business logic methods not present in framework
-  // - validateTokenMetadata() - Framework doesn't need this logic
-  // - processTokenTransaction() - Framework doesn't handle transactions
-  // These can be added later if actually needed
-}