@explorins/pers-sdk 1.1.2 → 1.2.0

package/src/business/api/business-api.ts

@@ -1,234 +0,0 @@
-import { PersApiClient } from '../../core/pers-api-client';
-import { 
-  BusinessDTO, 
-  BusinessTypeDTO, 
-  BusinessUpdateRequestDTO,
-  BusinessCreateRequestDTO,
-  BusinessToggleActiveRequestDTO,
-  BusinessApiKeyDTO,
-  BusinessTokenBalancesDTO,
-  BusinessTypeCreateRequestDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Platform-Agnostic Business API Client
- * 
- * Updated to match the new RESTful /businesses endpoints.
- * Uses @explorins/pers-shared DTOs for full type safety and consistency with backend.
- */
-export class BusinessApi {
-  constructor(private apiClient: PersApiClient) {}
-
-  private readonly basePath = '/businesses';
-
-  // ==========================================
-  // 🌐 BUSINESS TYPES MANAGEMENT
-  // ==========================================
-
-  /**
-   * Get all business types (project key required)
-   * 
-   * Endpoint: GET /businesses/types
-   * Auth: @ApiSecurity('projectKey')
-   */
-  async getAllBusinessTypes(): Promise<BusinessTypeDTO[]> {
-    return this.apiClient.get<BusinessTypeDTO[]>(`${this.basePath}/types`);
-  }
-
-  /**
-   * ADMIN: Create business type
-   * 
-   * Endpoint: POST /businesses/types
-   * Auth: @TenantAdmin()
-   */
-  async createBusinessType(dto: BusinessTypeCreateRequestDTO): Promise<BusinessTypeDTO> {
-    return this.apiClient.post<BusinessTypeDTO>(`${this.basePath}/types`, dto);
-  }
-
-  /**
-   * ADMIN: Update business type
-   * 
-   * Endpoint: PUT /businesses/types
-   * Auth: @TenantAdmin()
-   */
-  async updateBusinessType(dto: BusinessTypeDTO): Promise<BusinessTypeDTO> {
-    return this.apiClient.put<BusinessTypeDTO>(`${this.basePath}/types`, dto);
-  }
-
-  /**
-   * ADMIN: Delete business type
-   * 
-   * Endpoint: DELETE /businesses/types/{id}
-   * Auth: @TenantAdmin()
-   */
-  async deleteBusinessType(id: number): Promise<boolean> {
-    return this.apiClient.delete<boolean>(`${this.basePath}/types/${id}`);
-  }
-
-  // ==========================================
-  // 🏢 BUSINESS MANAGEMENT
-  // ==========================================
-
-  /**
-   * Get current business info (business authentication required)
-   * 
-   * Endpoint: GET /businesses/me
-   * Auth: @Business()
-   */
-  async getCurrentBusiness(): Promise<BusinessTokenBalancesDTO> {
-    return this.apiClient.get<BusinessTokenBalancesDTO>(`${this.basePath}/me`);
-  }
-
-  /**
-   * Get all active businesses (project key required)
-   * 
-   * Endpoint: GET /businesses
-   * Auth: @ApiSecurity('projectKey')
-   * Note: Regular users automatically get active businesses only
-   */
-  async getActiveBusinesses(): Promise<BusinessDTO[]> {
-    return this.apiClient.get<BusinessDTO[]>(`${this.basePath}`);
-  }
-
-  /**
-   * Get all businesses with filtering (admin users can access inactive)
-   * 
-   * Endpoint: GET /businesses?active={boolean}&sanitize={mode}
-   * Auth: @ApiSecurity('projectKey') (enhanced with role-based filtering)
-   */
-  async getAllBusinesses(options?: {
-    active?: boolean;
-    sanitize?: 'soft' | 'hard';
-  }): Promise<BusinessDTO[]> {
-    const params = new URLSearchParams();
-    
-    if (options?.active !== undefined) {
-      params.append('active', String(options.active));
-    }
-    
-    if (options?.sanitize) {
-      params.append('sanitize', options.sanitize);
-    }
-
-    const queryString = params.toString();
-    const url = queryString ? `${this.basePath}?${queryString}` : this.basePath;
-    
-    return this.apiClient.get<BusinessDTO[]>(url);
-  }
-
-  /**
-   * ADMIN: Get all businesses (admin endpoint with full access)
-   * 
-   * Endpoint: GET /businesses/admin
-   * Auth: @TenantAdmin()
-   */
-  async getAllBusinessesAdmin(options?: {
-    active?: boolean;
-    sanitize?: 'soft' | 'hard';
-  }): Promise<BusinessDTO[]> {
-    const params = new URLSearchParams();
-    
-    if (options?.active !== undefined) {
-      params.append('active', String(options.active));
-    }
-    
-    if (options?.sanitize) {
-      params.append('sanitize', options.sanitize);
-    }
-
-    const queryString = params.toString();
-    const url = queryString ? `${this.basePath}?${queryString}` : this.basePath;
-    
-    return this.apiClient.get<BusinessDTO[]>(url);
-  }
-
-  /**
-   * Get business by ID
-   * 
-   * Endpoint: GET /businesses/{id}
-   * Auth: @ApiSecurity('projectKey')
-   */
-  async getBusinessById(businessId: string): Promise<BusinessDTO> {
-    return this.apiClient.get<BusinessDTO>(`${this.basePath}/${businessId}`);
-  }
-
-  /**
-   * Get business by account address
-   * 
-   * Endpoint: GET /businesses/account/{accountAddress}
-   * Auth: @ApiSecurity('projectKey')
-   */
-  async getBusinessByAccount(accountAddress: string): Promise<BusinessDTO> {
-    return this.apiClient.get<BusinessDTO>(`${this.basePath}/account/${accountAddress}`);
-  }
-
-  // ==========================================
-  // 🔧 ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Create business
-   * 
-   * Endpoint: POST /businesses
-   * Auth: @TenantAdmin()
-   * Returns: BusinessApiKeyDTO | BusinessTokenBalancesDTO
-   */
-  async createBusiness(dto: BusinessCreateRequestDTO): Promise<BusinessApiKeyDTO | BusinessTokenBalancesDTO> {
-    return this.apiClient.post<BusinessApiKeyDTO | BusinessTokenBalancesDTO>(`${this.basePath}`, dto);
-  }
-
-  /**
-   * ADMIN: Create business by display name (convenience method)
-   * 
-   * This is a convenience wrapper that creates the proper DTO structure
-   */
-  async createBusinessByDisplayName(displayName: string): Promise<BusinessApiKeyDTO | BusinessTokenBalancesDTO> {
-    const dto: BusinessCreateRequestDTO = {
-      displayName,
-      // Add other required fields based on BusinessCreateRequestDTO structure
-      // You may need to check the DTO definition for required fields
-    };
-    return this.createBusiness(dto);
-  }
-
-  /**
-   * ADMIN: Create businesses from URL
-   * 
-   * Endpoint: POST /businesses/bulk/url
-   * Auth: @TenantAdmin()
-   */
-  async createBusinessesFromUrl(url: string): Promise<BusinessDTO[]> {
-    return this.apiClient.post<BusinessDTO[]>(`${this.basePath}/bulk/url`, { url });
-  }
-
-  /**
-   * ADMIN: Update business
-   * 
-   * Endpoint: PUT /businesses/{id}
-   * Auth: @TenantAdmin()
-   */
-  async updateBusiness(id: string, businessData: BusinessUpdateRequestDTO): Promise<BusinessDTO> {
-    return this.apiClient.put<BusinessDTO>(`${this.basePath}/${id}`, businessData);
-  }
-
-  /**
-   * ADMIN: Toggle business active status
-   * 
-   * Endpoint: PUT /businesses/{id}/activate
-   * Auth: @TenantAdmin()
-   */
-  async toggleBusinessActive(id: string, isActive: boolean): Promise<BusinessDTO> {
-    const dto: BusinessToggleActiveRequestDTO = { isActive };
-    return this.apiClient.put<BusinessDTO>(`${this.basePath}/${id}/status`, dto);
-  }
-
-  /**
-   * ADMIN: Generate new business API key
-   * 
-   * Endpoint: PUT /businesses/{id}/api-key
-   * Auth: @TenantAdmin()
-   */
-  async generateNewBusinessApiKey(id: string): Promise<string> {
-    return this.apiClient.put<string>(`${this.basePath}/${id}/api-key`, {});
-  }
-}

package/src/business/index.ts

@@ -1,53 +0,0 @@
-/**
- * @explorins/pers-sdk-business
- * 
- * Platform-agnostic Business Domain SDK for PERS ecosystem
- * Focuses on non-admin business operations
- */
-
-// API Layer
-export { BusinessApi } from './api/business-api';
-
-// Service Layer  
-export { BusinessService } from './services/business-service';
-
-// Models & Types - re-export all centralized interfaces
-export * from '../shared/interfaces/pers-shared-lib.interfaces';
-
-import { BusinessUpdateRequestDTO } from '../shared/interfaces/pers-shared-lib.interfaces';
-// Factory function for creating business SDK instance
-import { PersApiClient } from '../core/pers-api-client';
-import { BusinessApi } from './api/business-api';
-import { BusinessService } from './services/business-service';
-
-/**
- * Create a complete Business SDK instance
- * 
- * @param apiClient - Configured PERS API client
- * @returns Business SDK with flattened structure for better DX
- */
-export function createBusinessSDK(apiClient: PersApiClient) {
-  const businessApi = new BusinessApi(apiClient);
-  const businessService = new BusinessService(businessApi);
-  
-  return {
-    // Direct access to service methods (primary interface)
-    getActiveBusinesses: () => businessService.getActiveBusinesses(),
-    getAllBusinessTypes: () => businessService.getAllBusinessTypes(),
-    getBusinessById: (businessId: string) => businessService.getBusinessById(businessId),
-    getBusinessByAccount: (accountAddress: string) => businessService.getBusinessByAccount(accountAddress),
-    getBusinessesByType: (typeId: string) => businessService.getBusinessesByType(typeId),
-    
-    // Admin methods
-    getAllBusinesses: () => businessService.getAllBusinesses(),
-    createBusinessByDisplayName: (displayName: string) => businessService.createBusinessByDisplayName(displayName),
-    updateBusiness: (id: string, businessData: BusinessUpdateRequestDTO) => businessService.updateBusiness(id, businessData),
-    toggleBusinessActive: (id: string, isActive: boolean) => businessService.toggleBusinessActive(id, isActive),
-    
-    // Advanced access for edge cases
-    api: businessApi,
-    service: businessService
-  };
-}
-
-export type BusinessSDK = ReturnType<typeof createBusinessSDK>;

package/src/business/models/index.ts

@@ -1,13 +0,0 @@
-/**
- * Business Domain Models
- * 
- * Re-exports from @explorins/pers-shared for consistency with backend
- * and to provide a single import source for business-related types.
- */
-
-// Core business entities from centralized pers-shared interfaces
-export type {
-  BusinessDTO,
-  BusinessTypeDTO,
-  BusinessUpdateRequestDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';

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

@@ -1,88 +0,0 @@
-import { BusinessApi } from '../api/business-api';
-import { 
-  BusinessDTO, 
-  BusinessTypeDTO,
-  BusinessUpdateRequestDTO
-} from '../../shared/interfaces/pers-shared-lib.interfaces';
-
-/**
- * Platform-Agnostic Business Service
- * 
- * Contains business logic and operations that work across platforms.
- * No framework dependencies - pure TypeScript business logic.
- * 
- * Focuses only on actual backend capabilities.
- */
-export class BusinessService {
-  constructor(private businessApi: BusinessApi) {}
-
-  /**
-   * Get all active businesses
-   */
-  async getActiveBusinesses(): Promise<BusinessDTO[]> {
-    return this.businessApi.getActiveBusinesses();
-  }
-
-  /**
-   * Get all business types
-   */
-  async getAllBusinessTypes(): Promise<BusinessTypeDTO[]> {
-    return this.businessApi.getAllBusinessTypes();
-  }
-
-  /**
-   * Get business by ID
-   */
-  async getBusinessById(businessId: string): Promise<BusinessDTO> {
-    return this.businessApi.getBusinessById(businessId);
-  }
-
-  /**
-   * Get business by account address
-   */
-  async getBusinessByAccount(accountAddress: string): Promise<BusinessDTO> {
-    return this.businessApi.getBusinessByAccount(accountAddress);
-  }
-
-  /**
-   * Get businesses by type (client-side filtering)
-   */
-  async getBusinessesByType(typeId: string): Promise<BusinessDTO[]> {
-    const businesses = await this.getActiveBusinesses();
-    return businesses.filter(business => 
-      business.businessType && business.businessType.id === parseInt(typeId)
-    );
-  }
-
-  // ==========================================
-  // ADMIN OPERATIONS
-  // ==========================================
-
-  /**
-   * ADMIN: Get all businesses (active and inactive)
-   */
-  async getAllBusinesses(): Promise<BusinessDTO[]> {
-    return this.businessApi.getAllBusinesses();
-  }
-
-  /**
-   * ADMIN: Create business by display name
-   */
-  async createBusinessByDisplayName(displayName: string): Promise<BusinessDTO> {
-    return this.businessApi.createBusinessByDisplayName(displayName);
-  }
-
-  /**
-   * ADMIN: Update business
-   */
-  async updateBusiness(id: string, businessData: BusinessUpdateRequestDTO): Promise<BusinessDTO> {
-    return this.businessApi.updateBusiness(id, businessData);
-  }
-
-  /**
-   * ADMIN: Toggle business active status
-   */
-  async toggleBusinessActive(id: string, isActive: boolean): Promise<BusinessDTO> {
-    return this.businessApi.toggleBusinessActive(id, isActive);
-  }
-}