@explorins/pers-sdk 1.0.0-alpha.1 → 1.1.2

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

@@ -0,0 +1,103 @@
+import { RedemptionApi } from '../api/redemption-api';
+import { 
+  RedemptionCreateRequestDTO, 
+  RedemptionDTO, 
+  RedemptionTypeDTO, 
+  RedemptionUserRedeemDetailedDTO, 
+  RedemptionUserRedeemDTO 
+} from '@explorins/pers-shared';
+import { TokenUnitCreateRequestDTO } from '../../campaign'; // ✅ CORRECTED: Proper cross-domain import
+
+/**
+ * Platform-Agnostic Redemption Service
+ * 
+ * Contains redemption business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ * 
+ * Focuses only on actual backend capabilities.
+ */
+export class RedemptionService {
+  constructor(private redemptionApi: RedemptionApi) {}
+
+  // ==========================================
+  // PUBLIC OPERATIONS
+  // ==========================================
+
+  /**
+   * PUBLIC: Get active redemptions
+   */
+  async getActiveRedemptions(): Promise<RedemptionDTO[]> {
+    return this.redemptionApi.getActiveRedemptions();
+  }
+
+  /**
+   * PUBLIC: Get redemption types
+   */
+  async getRedemptionTypes(): Promise<RedemptionTypeDTO[]> {
+    return this.redemptionApi.getRedemptionTypes();
+  }
+
+  // ==========================================
+  // AUTHENTICATED OPERATIONS
+  // ==========================================
+
+  /**
+   * AUTH: Redeem a redemption
+   */
+  async redeemRedemption(redemptionId: string): Promise<RedemptionUserRedeemDetailedDTO> {
+    return this.redemptionApi.redeemRedemption(redemptionId);
+  }
+
+  /**
+   * AUTH: Get user redemptions
+   */
+  async getUserRedeems(): Promise<RedemptionUserRedeemDTO[]> {
+    return this.redemptionApi.getUserRedeems();
+  }
+
+  // ==========================================
+  // ADMIN OPERATIONS
+  // ==========================================
+
+  /**
+   * ADMIN: Get redemptions with optional active filter
+   */
+  async getRedemptionsAsAdmin(active?: boolean): Promise<RedemptionDTO[]> {
+    return this.redemptionApi.getRedemptionsAsAdmin(active);
+  }
+
+  /**
+   * ADMIN: Create redemption
+   */
+  async createRedemption(redemption: RedemptionCreateRequestDTO): Promise<RedemptionDTO> {
+    return this.redemptionApi.createRedemption(redemption);
+  }
+
+  /**
+   * ADMIN: Update redemption
+   */
+  async updateRedemption(id: string, redemptionCreateRequest: RedemptionCreateRequestDTO): Promise<RedemptionDTO> {
+    return this.redemptionApi.updateRedemption(id, redemptionCreateRequest); // ✅ CORRECTED: Fixed parameter
+  }
+
+  /**
+   * ADMIN: Toggle redemption active status
+   */
+  async toggleRedemptionActive(redemptionId: string): Promise<RedemptionDTO> {
+    return this.redemptionApi.toggleRedemptionActive(redemptionId);
+  }
+
+  /**
+   * ADMIN: Create redemption token unit
+   */
+  async createRedemptionTokenUnit(redemptionId: string, redemptionTokenUnit: TokenUnitCreateRequestDTO): Promise<RedemptionDTO> {
+    return this.redemptionApi.createRedemptionTokenUnit(redemptionId, redemptionTokenUnit);
+  }
+
+  /**
+   * ADMIN: Delete redemption token unit
+   */
+  async deleteRedemptionTokenUnit(redemptionId: string, redemptionTokenUnitId: string): Promise<RedemptionDTO> {
+    return this.redemptionApi.deleteRedemptionTokenUnit(redemptionId, redemptionTokenUnitId);
+  }
+}

package/src/shared/interfaces/pers-shared-lib.interfaces.ts

@@ -0,0 +1,99 @@
+/**
+ * Centralized PERS Shared Library Interfaces
+ * 
+ * Single source of truth for all @explorins/pers-shared type exports
+ * used throughout the PERS SDK. This ensures consistent type usage
+ * and makes it easier to manage dependencies.
+ */
+
+// Auth Admin Domain
+export {
+  type AdminDTO,
+  type SessionAuthResponseDTO
+} from '@explorins/pers-shared';
+
+// Business Domain
+export {
+  type BusinessDTO,
+  type BusinessTypeDTO,
+  type BusinessUpdateRequestDTO,
+  type BusinessCreateRequestDTO,
+  type BusinessToggleActiveRequestDTO,
+  type BusinessApiKeyDTO,
+  type BusinessTokenBalancesDTO,
+  type BusinessTypeCreateRequestDTO
+} from '@explorins/pers-shared';
+
+// Campaign Domain
+export {
+  type CampaignDTO,
+  type CampaignCreateRequestDTO,
+  type CampaignUserClaimDTO,
+  type CampaignClaimRequestDTO,
+  type CampaignTriggerDTO,
+  type CampaignBusinessEngagementCreateRequestDTO,
+  type TokenUnitCreateRequestDTO,
+  type CampaignTriggerType
+} from '@explorins/pers-shared';
+
+// Donation Domain
+export {
+  type DonationTypeDTO
+} from '@explorins/pers-shared';
+
+// Payment Domain
+export {
+  type UserDTO,
+  type PurchaseDTO,
+  type PurchaseTokenDTO,
+  type PurchaseTypeDTO,
+  type PaymentIntentDTO,
+  type PurchaseCreateRequestDTO,
+  type PurchaseCreateResponseDTO,
+  type PaymentIntentCreateDTO,
+  type PurchaseCurrency
+} from '@explorins/pers-shared';
+
+// Redemption Domain
+export {
+  type RedemptionDTO,
+  type RedemptionCreateRequestDTO,
+  type RedemptionRedeemRequestDTO,
+  type RedemptionTypeDTO,
+  type RedemptionTypeCreateRequestDTO,
+  type RedemptionUserRedeemDTO,
+  type RedemptionUserRedeemDetailedDTO
+} from '@explorins/pers-shared';
+
+// Tenant Domain
+export {
+  type TenantClientConfigDTO,
+  type TenantDTO,
+  type TenantPublicDTO
+} from '@explorins/pers-shared';
+
+// Token Domain
+export {
+  type TokenMetadataDTO,
+  type TokenDTO,
+  type TokenCreateRequestDTO,
+  type TokenUpdateRequestDTO,
+  type TokenStorageData,
+  type TokenTypeDTO
+} from '@explorins/pers-shared';
+
+// Transaction Domain
+export {
+  type TransactionDTO,
+  type TransactionRequestDTO,
+  type ClientTransactionRequestDTO,
+  type ClientTransactionRequestResponseDto,
+  type UserToBusinessTokenTransactionCreateRequestDTO,
+  type AccountSelectorDTO
+} from '@explorins/pers-shared';
+
+// User Domain
+export {
+  type UserCreateRequestDTO,
+  type UserStatusTypeDTO
+} from '@explorins/pers-shared';

package/src/tenant/api/tenant-api.ts

@@ -0,0 +1,92 @@
+import { 
+  AdminDTO,
+  TenantPublicDTO,
+  TenantClientConfigDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
+import { PersApiClient } from '../../core/pers-api-client';
+
+// Local interfaces
+interface AdminCreateRequestDTO {
+  [key: string]: any;
+}
+
+/**
+ * Platform-Agnostic Tenant API Client
+ * 
+ * Handles tenant and admin operations using the PERS backend.
+ * Matches framework TenantApiService methods exactly.
+ * 
+ * Note: Special header handling (bypass-auth-interceptor) should be handled by PersApiClient internally
+ * or through endpoint-specific configuration.
+ */
+export class TenantApi {
+  constructor(private apiClient: PersApiClient) {}
+
+  private basePath = '/tenants';
+  private adminPath = '/admins';
+
+  // ==========================================
+  // PUBLIC OPERATIONS
+  // ==========================================
+
+  /**
+   * PUBLIC: Get tenant public information
+   * ✅ FIXED: Matches framework cache busting pattern exactly
+   */
+  async getRemoteTenant(): Promise<TenantPublicDTO> {
+    const timestamp = Date.now().toString();
+    const url = `${this.basePath}/public?date=${timestamp}`;
+    return this.apiClient.get<TenantPublicDTO>(url);
+  }
+
+  /**
+   * PUBLIC: Get remote login token
+   */
+  async getRemoteLoginToken(): Promise<string> {
+    return this.apiClient.get<string>(`${this.basePath}/login-token`);
+  }
+
+  /**
+   * PUBLIC: Get remote client configuration
+   * ✅ FIXED: Removed second parameter - PersApiClient handles bypass auth internally
+   * Note: The /tenants/client-config endpoint should be configured to bypass auth at the API client level
+   */
+  async getRemoteClientConfig(): Promise<TenantClientConfigDTO> {
+    return this.apiClient.get<TenantClientConfigDTO>(`${this.basePath}/client-config`);
+  }
+
+  // ==========================================
+  // ADMIN OPERATIONS
+  // ==========================================
+
+  /**
+   * ADMIN: Update tenant information
+   * ✅ FIXED: Uses TenantPublicDTO directly like framework
+   */
+  async updateRemoteTenant(tenantData: TenantPublicDTO): Promise<TenantPublicDTO> {
+    return this.apiClient.put<TenantPublicDTO>(`${this.basePath}`, tenantData);
+  }
+
+  /**
+   * ADMIN: Get all tenant admins
+   */
+  async getAdmins(): Promise<AdminDTO[]> {
+    return this.apiClient.get<AdminDTO[]>(`${this.adminPath}`);
+  }
+
+  /**
+   * ADMIN: Create new admin
+   * ✅ FIXED: Renamed to match framework postAdmin method
+   */
+  async postAdmin(adminData: AdminCreateRequestDTO): Promise<AdminDTO> {
+    return this.apiClient.post<AdminDTO>(`${this.adminPath}`, adminData);
+  }
+
+  /**
+   * ADMIN: Update admin (toggle tenant association)
+   * ✅ FIXED: Renamed to match framework putAdmin method
+   */
+  async putAdmin(adminId: string, adminData: AdminCreateRequestDTO): Promise<AdminDTO> {
+    return this.apiClient.put<AdminDTO>(`${this.adminPath}/${adminId}/tenant`, adminData);
+  }
+}

package/src/tenant/index.ts

@@ -0,0 +1,61 @@
+/**
+ * @explorins/pers-sdk-tenant
+ * 
+ * Platform-agnostic Tenant Domain SDK for PERS ecosystem
+ * Handles tenant management and admin operations for multi-tenant architecture
+ */
+
+// API Layer
+export { TenantApi } from './api/tenant-api';
+
+// Service Layer  
+export { TenantService } from './services/tenant-service';
+
+// Models & Types
+export * from './models';
+export * from '../shared/interfaces/pers-shared-lib.interfaces';
+
+// Models & Types
+export * from './models';
+
+// Factory function for creating tenant SDK instance
+import { PersApiClient } from '../core/pers-api-client';
+import { TenantApi } from './api/tenant-api';
+import { TenantService } from './services/tenant-service';
+import { TenantPublicDTO, AdminCreateRequestDTO } from './models';
+
+/**
+ * Create a complete Tenant SDK instance
+ * 
+ * @param apiClient - Configured PERS API client
+ * @returns Tenant SDK with flattened structure for better DX
+ */
+export function createTenantSDK(apiClient: PersApiClient) {
+  const tenantApi = new TenantApi(apiClient);
+  const tenantService = new TenantService(tenantApi);
+  
+  return {
+    // Direct access to service methods (primary interface)
+    // ✅ FRAMEWORK ALIGNED: Only methods actually used by framework
+    
+    // Public methods
+    getRemoteTenant: () => tenantService.getRemoteTenant(),
+    getRemoteLoginToken: () => tenantService.getRemoteLoginToken(),
+    getRemoteClientConfig: () => tenantService.getRemoteClientConfig(),
+    
+    // Admin methods - ✅ FIXED: Matches framework method names exactly
+    updateRemoteTenant: (tenantData: TenantPublicDTO) => 
+      tenantService.updateRemoteTenant(tenantData),
+    getAdmins: () => tenantService.getAdmins(),
+    postAdmin: (adminData: AdminCreateRequestDTO) => 
+      tenantService.postAdmin(adminData),
+    putAdmin: (adminId: string, adminData: AdminCreateRequestDTO) => 
+      tenantService.putAdmin(adminId, adminData),
+    
+    // Advanced access for edge cases
+    api: tenantApi,
+    service: tenantService
+  };
+}
+
+export type TenantSDK = ReturnType<typeof createTenantSDK>;

package/src/tenant/models/index.ts

@@ -0,0 +1,20 @@
+/**
+ * Tenant Domain Models
+ * 
+ * Re-exports from centralized pers-shared interfaces for consistency with backend
+ * and to provide a single import source for tenant-related types.
+ */
+
+// Core tenant entities from centralized pers-shared interfaces
+export type {
+  TenantClientConfigDTO,
+  TenantDTO,
+  TenantPublicDTO,
+  AdminDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
+
+// Local tenant interfaces
+export interface AdminCreateRequestDTO {
+  // Add properties as needed
+  [key: string]: any;
+}

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

@@ -0,0 +1,78 @@
+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

@@ -0,0 +1,129 @@
+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);
+  }
+}