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

package/src/auth-admin/api/auth-admin-api.ts

@@ -0,0 +1,42 @@
+import { PersApiClient } from '../../core/pers-api-client';
+import { 
+  AdminDTO,
+  SessionAuthResponseDTO as TokenRefreshResponse,
+  SessionAuthResponseDTO as AdminLoginResponseDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
+
+/**
+ * Platform-Agnostic Auth Admin API Client
+ * 
+ * Handles authentication and authorization admin operations using the PERS backend.
+ * Uses @explorins/pers-shared DTOs for consistency with backend.
+ * 
+ * Note: Special header handling (bypass-auth-interceptor) may need to be implemented
+ * at the PersApiClient level or through a specialized auth client.
+ */
+export class AuthAdminApi {
+  constructor(private apiClient: PersApiClient) {}
+
+  private readonly basePath = '/auth';
+
+  // ==========================================
+  // ADMIN AUTHENTICATION OPERATIONS
+  // ==========================================
+
+  /**
+   * ADMIN: Login tenant admin with JWT
+   * Note: JWT handling and auth bypass headers may need special implementation
+   */
+  async loginTenantAdmin(jwt: string): Promise<AdminLoginResponseDTO> {
+    // TODO: Implement proper JWT and bypass header handling when PersApiClient supports it
+    return this.apiClient.post<AdminLoginResponseDTO>(`${this.basePath}/token`, {});
+  }
+
+  /**
+   * ADMIN: Refresh access token
+   * Note: Bypass header handling may need special implementation
+   */
+  async refreshAccessToken(refreshToken: string): Promise<TokenRefreshResponse> {
+    return this.apiClient.post<TokenRefreshResponse>(`${this.basePath}/refresh`, { refreshToken });
+  }
+}

package/src/auth-admin/index.ts

@@ -0,0 +1,47 @@
+/**
+ * @explorins/pers-sdk-auth-admin
+ * 
+ * Platform-agnostic Auth Admin Domain SDK for PERS ecosystem
+ * Handles authentication and authorization admin operations
+ */
+
+// API Layer
+export { AuthAdminApi } from './api/auth-admin-api';
+
+// Service Layer  
+export { AuthAdminService } from './services/auth-admin-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 auth admin SDK instance
+import { PersApiClient } from '../core/pers-api-client';
+import { AuthAdminApi } from './api/auth-admin-api';
+import { AuthAdminService } from './services/auth-admin-service';
+
+/**
+ * Create a complete Auth Admin SDK instance
+ * 
+ * @param apiClient - Configured PERS API client
+ * @returns Auth Admin SDK with flattened structure for better DX
+ */
+export function createAuthAdminSDK(apiClient: PersApiClient) {
+  const authAdminApi = new AuthAdminApi(apiClient);
+  const authAdminService = new AuthAdminService(authAdminApi);
+  
+  return {
+    // Direct access to service methods (primary interface)
+    
+    // Admin authentication methods
+    loginTenantAdmin: (jwt: string) => authAdminService.loginTenantAdmin(jwt),
+    refreshAccessToken: (refreshToken: string) => authAdminService.refreshAccessToken(refreshToken),
+    
+    // Advanced access for edge cases
+    api: authAdminApi,
+    service: authAdminService
+  };
+}
+
+export type AuthAdminSDK = ReturnType<typeof createAuthAdminSDK>;

package/src/auth-admin/services/auth-admin-service.ts

@@ -0,0 +1,36 @@
+import { AuthAdminApi } from '../api/auth-admin-api';
+import { 
+  AdminDTO,
+  SessionAuthResponseDTO as TokenRefreshResponse,
+  SessionAuthResponseDTO as AdminLoginResponseDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
+
+/**
+ * Platform-Agnostic Auth Admin Service
+ * 
+ * Contains auth admin business logic and operations that work across platforms.
+ * No framework dependencies - pure TypeScript business logic.
+ * 
+ * Focuses only on actual backend capabilities.
+ */
+export class AuthAdminService {
+  constructor(private authAdminApi: AuthAdminApi) {}
+
+  // ==========================================
+  // ADMIN AUTHENTICATION OPERATIONS
+  // ==========================================
+
+  /**
+   * ADMIN: Login tenant admin with JWT
+   */
+  async loginTenantAdmin(jwt: string): Promise<AdminLoginResponseDTO> {
+    return this.authAdminApi.loginTenantAdmin(jwt);
+  }
+
+  /**
+   * ADMIN: Refresh access token
+   */
+  async refreshAccessToken(refreshToken: string): Promise<TokenRefreshResponse> {
+    return this.authAdminApi.refreshAccessToken(refreshToken);
+  }
+}

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

@@ -1,72 +1,234 @@
 import { PersApiClient } from '../../core/pers-api-client';
-import { BusinessDTO, BusinessTypeDTO, BusinessUpdateRequestDTO } from '@explorins/pers-shared';
+import { 
+  BusinessDTO, 
+  BusinessTypeDTO, 
+  BusinessUpdateRequestDTO,
+  BusinessCreateRequestDTO,
+  BusinessToggleActiveRequestDTO,
+  BusinessApiKeyDTO,
+  BusinessTokenBalancesDTO,
+  BusinessTypeCreateRequestDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
 
 /**
  * Platform-Agnostic Business API Client
  * 
- * Focuses on non-admin business operations using the PERS backend.
- * Uses @explorins/pers-shared DTOs for consistency with backend.
+ * 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);
+  }
+
   /**
-   * Get all active businesses (public endpoint)
+   * 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[]>('/business');
+    return this.apiClient.get<BusinessDTO[]>(`${this.basePath}`);
   }
 
   /**
-   * Get all business types (public endpoint)
+   * 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 getAllBusinessTypes(): Promise<BusinessTypeDTO[]> {
-    return this.apiClient.get<BusinessTypeDTO[]>('/business/type');
+  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>(`/business/${businessId}`);
+    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>(`/business/account/${accountAddress}`);
+    return this.apiClient.get<BusinessDTO>(`${this.basePath}/account/${accountAddress}`);
   }
 
   // ==========================================
-  // ADMIN OPERATIONS
+  // 🔧 ADMIN OPERATIONS
   // ==========================================
 
   /**
-   * ADMIN: Get all businesses (active and inactive)
+   * 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 getAllBusinesses(): Promise<BusinessDTO[]> {
-    return this.apiClient.get<BusinessDTO[]>('/business/admin');
+  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 business by display name
+   * ADMIN: Create businesses from URL
+   * 
+   * Endpoint: POST /businesses/bulk/url
+   * Auth: @TenantAdmin()
    */
-  async createBusinessByDisplayName(displayName: string): Promise<BusinessDTO> {
-    return this.apiClient.post<BusinessDTO>('/business/admin/', { displayName });
+  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>(`/business/admin/${id}`, businessData);
+    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> {
-    return this.apiClient.put<BusinessDTO>(`/business/admin/activate/${id}`, { isActive });
+    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

@@ -11,9 +11,10 @@ export { BusinessApi } from './api/business-api';
 // Service Layer  
 export { BusinessService } from './services/business-service';
 
-// Models & Types
-export * from './models';
+// 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';
@@ -40,7 +41,7 @@ export function createBusinessSDK(apiClient: PersApiClient) {
     // Admin methods
     getAllBusinesses: () => businessService.getAllBusinesses(),
     createBusinessByDisplayName: (displayName: string) => businessService.createBusinessByDisplayName(displayName),
-    updateBusiness: (id: string, businessData: any) => businessService.updateBusiness(id, businessData),
+    updateBusiness: (id: string, businessData: BusinessUpdateRequestDTO) => businessService.updateBusiness(id, businessData),
     toggleBusinessActive: (id: string, isActive: boolean) => businessService.toggleBusinessActive(id, isActive),
     
     // Advanced access for edge cases

package/src/business/models/index.ts

@@ -5,9 +5,9 @@
  * and to provide a single import source for business-related types.
  */
 
-// Core business entities
-export type { 
+// Core business entities from centralized pers-shared interfaces
+export type {
   BusinessDTO,
   BusinessTypeDTO,
-  BusinessUpdateRequestDTO 
-} from '@explorins/pers-shared';
+  BusinessUpdateRequestDTO
+} from '../../shared/interfaces/pers-shared-lib.interfaces';

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

@@ -3,7 +3,7 @@ import {
   BusinessDTO, 
   BusinessTypeDTO,
   BusinessUpdateRequestDTO
-} from '../models';
+} from '../../shared/interfaces/pers-shared-lib.interfaces';
 
 /**
  * Platform-Agnostic Business Service