@ibdop/platform-kit 1.0.10 → 1.0.12

package/src/hooks/useShellAuth.ts

@@ -7,6 +7,7 @@
 
 import { useEffect, useState, useCallback, useRef } from 'react'
 import type { ShellAuth } from '../types'
+import { getShellAuth } from '../utils/shellAuth'
 
 // Development mode flag
 const isDev = import.meta.env?.DEV === true || import.meta.env?.MODE === 'development'
@@ -23,27 +24,6 @@ const logger = {
   },
 }
 
-/**
- * Получить auth из window globals
- */
-function getAuth(): ShellAuth | null {
-  if (typeof window === 'undefined') return null
-
-  // Try __SHELL_AUTH_INSTANCE__ first
-  const win = window as unknown as { __SHELL_AUTH_INSTANCE__?: ShellAuth }
-  if (win.__SHELL_AUTH_INSTANCE__) {
-    return win.__SHELL_AUTH_INSTANCE__
-  }
-
-  // Try __SHELL_AUTH__ format
-  const win2 = window as unknown as { __SHELL_AUTH__?: { authInstance?: ShellAuth } }
-  if (win2.__SHELL_AUTH__?.authInstance) {
-    return win2.__SHELL_AUTH__.authInstance
-  }
-
-  return null
-}
-
 /**
  * Централизованный хук для получения состояния авторизации из shell
  * 
@@ -66,7 +46,7 @@ export function useShellAuth(): ShellAuth {
   const maxAttempts = 20 // 10 seconds max wait (20 * 500ms)
 
   const getAuthState = useCallback((): ShellAuth | null => {
-    return getAuth()
+    return getShellAuth()
   }, [])
 
   useEffect(() => {
@@ -118,7 +98,7 @@ export function useShellAuth(): ShellAuth {
     isLoading: isLoading,
     signinRedirect: async () => {
       logger.log('Redirecting to login')
-      const shellAuth = getAuth()
+      const shellAuth = getShellAuth()
       if (shellAuth?.signinRedirect) {
         await shellAuth.signinRedirect()
       } else {
@@ -128,7 +108,7 @@ export function useShellAuth(): ShellAuth {
       }
     },
     removeUser: async () => {
-      const shellAuth = getAuth()
+      const shellAuth = getShellAuth()
       if (shellAuth?.removeUser) {
         await shellAuth.removeUser()
       }
@@ -141,5 +121,5 @@ export function useShellAuth(): ShellAuth {
   return result
 }
 
-// Named exports for specific helpers
-export { getAuth }
+// Re-export shell auth utilities for convenience
+export { getShellAuth }

package/src/services/api.ts

@@ -6,6 +6,7 @@
 
 import axios, { AxiosInstance, AxiosError, InternalAxiosRequestConfig } from 'axios'
 import type { ApiError, ApiResponse } from '../types'
+import { getAuthState, redirectToLogin } from '../utils/shellAuth'
 
 // MF Name for logging
 const MF_NAME = 'platform-kit'
@@ -38,6 +39,8 @@ export interface ApiConfig {
   timeout?: number
   baseURL?: string
   name?: string
+  retries?: number
+  retryDelay?: number
 }
 
 /**
@@ -49,29 +52,6 @@ export interface ApiErrorResponse {
   status?: number
 }
 
-/**
- * Получить состояние авторизации из shell
- */
-function getAuthState(): { isAuthenticated: boolean; user?: { profile?: { access_token?: string } } } | null {
-  if (typeof window === 'undefined') {
-    return { isAuthenticated: false }
-  }
-
-  // Try __SHELL_AUTH_INSTANCE__
-  const shellAuth = (window as unknown as { __SHELL_AUTH_INSTANCE__?: { isAuthenticated: boolean; user?: { profile?: { access_token?: string } } } }).__SHELL_AUTH_INSTANCE__
-  if (shellAuth) {
-    return shellAuth
-  }
-
-  // Try __SHELL_AUTH__ format
-  const shellAuth2 = (window as unknown as { __SHELL_AUTH__?: { authInstance?: { isAuthenticated: boolean; user?: { profile?: { access_token?: string } } } } }).__SHELL_AUTH__
-  if (shellAuth2?.authInstance) {
-    return shellAuth2.authInstance
-  }
-
-  return { isAuthenticated: false }
-}
-
 /**
  * Получить mfeName из window
  */
@@ -83,23 +63,6 @@ function getMfeName(): string {
   return MF_NAME
 }
 
-/**
- * Обработка ошибок авторизации - редирект на логин
- */
-function handleAuthError(): void {
-  if (typeof window === 'undefined') return
-
-  const shellAuth = (window as unknown as { __SHELL_AUTH_INSTANCE__?: { signinRedirect?: () => Promise<void> } }).__SHELL_AUTH_INSTANCE__
-
-  if (shellAuth?.signinRedirect) {
-    shellAuth.signinRedirect().catch((err) => {
-      logger.error('Failed to redirect to login:', err)
-    })
-  } else {
-    window.location.href = '/'
-  }
-}
-
 /**
  * Форматирование API ошибки в консистентную структуру
  */
@@ -130,6 +93,27 @@ function formatApiError(error: AxiosError<ApiErrorResponse>): ApiError {
   }
 }
 
+/**
+ * Default retry configuration
+ */
+const DEFAULT_RETRIES = 3
+const DEFAULT_RETRY_DELAY = 1000
+
+/**
+ * Check if error is retryable
+ */
+function isRetryableError(status?: number): boolean {
+  // Retry on network errors, 5xx, and 429 (rate limit)
+  return !status || status >= 500 || status === 429
+}
+
+/**
+ * Sleep utility for retry delay
+ */
+function sleep(ms: number): Promise<void> {
+  return new Promise(resolve => setTimeout(resolve, ms))
+}
+
 /**
  * Создание API клиента с interceptors
  * 
@@ -144,6 +128,8 @@ function formatApiError(error: AxiosError<ApiErrorResponse>): ApiError {
  */
 export function createApiClient(config: ApiConfig = {}): AxiosInstance {
   const clientName = config.name || MF_NAME
+  const retries = config.retries ?? DEFAULT_RETRIES
+  const retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY
 
   const clientLogger = {
     log: (...args: unknown[]) => logger.log(`[API:${clientName}]`, ...args),
@@ -185,20 +171,34 @@ export function createApiClient(config: ApiConfig = {}): AxiosInstance {
     }
   )
 
-  // Response interceptor - обработка ошибок
+  // Response interceptor - обработка ошибок с retry
   client.interceptors.response.use(
     (response) => {
       clientLogger.log(`Response ${response.status}:`, response.config.url)
       return response
     },
-    (error: AxiosError<ApiErrorResponse>) => {
+    async (error: AxiosError<ApiErrorResponse>) => {
       const status = error.response?.status
       const url = error.config?.url
+      const retryCount = (error.config as InternalAxiosRequestConfig & { _retryCount?: number })?._retryCount ?? 0
+
+      // Retry logic for retryable errors
+      if (isRetryableError(status) && retryCount < retries) {
+        const configWithRetry = error.config as InternalAxiosRequestConfig & { _retryCount?: number }
+        configWithRetry._retryCount = retryCount + 1
+        
+        // Exponential backoff: delay * 2^retryCount
+        const backoffDelay = retryDelay * Math.pow(2, retryCount)
+        clientLogger.warn(`Retrying (${configWithRetry._retryCount}/${retries}) after ${backoffDelay}ms:`, url)
+        
+        await sleep(backoffDelay)
+        return client.request(configWithRetry)
+      }
 
       // Categorize errors
       if (status === 401) {
         clientLogger.warn('401 Unauthorized - triggering re-auth')
-        handleAuthError()
+        redirectToLogin()
       } else if (status === 403) {
         clientLogger.warn('403 Forbidden - insufficient permissions')
       } else if (status === 404) {

package/src/types/index.ts

@@ -225,3 +225,102 @@ export type MfeNameSource =
   | 'sessionStorage.mf-config'
   | 'import.meta.env.VITE_MFE_NAME'
   | 'import.meta.env.MFE_NAME'
+
+// ==================== Feature Types ====================
+
+/**
+ * Feature toggle for a user
+ */
+export interface FeatureToggleInfo {
+  name: string
+  enabled: boolean
+  description?: string
+  roles?: string[]
+  percentage?: number
+  microfrontends?: string[]
+  userEnabled: boolean
+  mfDependencies?: string[]
+}
+
+/**
+ * Response from /api/features endpoint
+ */
+export interface FeaturesResponse {
+  features: FeatureToggleInfo[]
+  totalCount: number
+  userRoles: string[]
+}
+
+/**
+ * Admin feature toggle (full info)
+ */
+export interface FeatureToggleAdmin {
+  name: string
+  enabled: boolean
+  description: string
+  roles: string[]
+  percentage: number
+  microfrontends: string[]
+  mfDependencies: string[]
+}
+
+/**
+ * Admin response from /api/features/admin endpoint
+ */
+export interface FeatureAdminResponse {
+  featureToggles: FeatureToggleAdmin[]
+  isAdmin: boolean
+  microfrontends: string[]
+  totalCount: number
+}
+
+/**
+ * Feature creation request
+ */
+export interface FeatureCreateRequest {
+  name: string
+  enabled?: boolean
+  description?: string
+  roles?: string[]
+  percentage?: number
+  microfrontends?: string[]
+}
+
+/**
+ * Feature update request
+ */
+export interface FeatureUpdateRequest {
+  enabled?: boolean
+  description?: string
+  roles?: string[]
+  percentage?: number
+  microfrontends?: string[]
+}
+
+/**
+ * Microfrontend with its features
+ */
+export interface MicrofrontendWithFeatures {
+  name: string
+  description?: string
+  featureToggles: string[]
+  features: FeatureInfo[]
+}
+
+/**
+ * Feature info for a microfrontend
+ */
+export interface FeatureInfo {
+  name: string
+  enabled: boolean
+  global: boolean
+  required: boolean
+}
+
+/**
+ * Response from /api/features/microfrontends endpoint
+ */
+export interface MicrofrontendsFeaturesResponse {
+  microfrontends: MicrofrontendWithFeatures[]
+  totalCount: number
+}

package/src/utils/index.ts

@@ -15,5 +15,15 @@ export {
   type MfeNameProps,
 } from './mfeName'
 
+// Shell Auth utilities
+export {
+  getShellAuth,
+  getAuthState,
+  getAccessToken,
+  isAuthenticated,
+  redirectToLogin,
+  logout,
+} from './shellAuth'
+
 // Re-export types
 export type { MfeNameSource } from '../types'

package/src/utils/shellAuth.ts

@@ -0,0 +1,106 @@
+/**
+ * Shell Auth Utilities - Централизованные утилиты для работы с Shell Auth
+ * 
+ * Используются в hooks/useShellAuth.ts и services/api.ts
+ */
+
+import type { ShellAuth } from '../types'
+
+/**
+ * Получить auth instance из window globals
+ * 
+ * Поддерживает два формата:
+ * - window.__SHELL_AUTH_INSTANCE__ (прямой доступ)
+ * - window.__SHELL_AUTH__.authInstance (вложенный формат)
+ * 
+ * @returns ShellAuth instance или null
+ */
+export function getShellAuth(): ShellAuth | null {
+  if (typeof window === 'undefined') return null
+
+  // Try __SHELL_AUTH_INSTANCE__ first (direct format)
+  const win = window as unknown as { __SHELL_AUTH_INSTANCE__?: ShellAuth }
+  if (win.__SHELL_AUTH_INSTANCE__) {
+    return win.__SHELL_AUTH_INSTANCE__
+  }
+
+  // Try __SHELL_AUTH__ format (nested format)
+  const win2 = window as unknown as { __SHELL_AUTH__?: { authInstance?: ShellAuth } }
+  if (win2.__SHELL_AUTH__?.authInstance) {
+    return win2.__SHELL_AUTH__.authInstance
+  }
+
+  return null
+}
+
+/**
+ * Получить auth state (упрощённый формат для API interceptors)
+ * 
+ * @returns Auth state с isAuthenticated и user
+ */
+export function getAuthState(): { 
+  isAuthenticated: boolean
+  user?: { 
+    profile?: { 
+      access_token?: string 
+    } 
+  } 
+} | null {
+  const auth = getShellAuth()
+  
+  if (!auth) {
+    return { isAuthenticated: false }
+  }
+  
+  return {
+    isAuthenticated: auth.isAuthenticated,
+    user: auth.user ?? undefined,
+  }
+}
+
+/**
+ * Получить access token из shell auth
+ * 
+ * @returns Access token или null
+ */
+export function getAccessToken(): string | null {
+  const auth = getShellAuth()
+  
+  if (!auth?.isAuthenticated) {
+    return null
+  }
+  
+  return auth.user?.profile?.access_token ?? null
+}
+
+/**
+ * Проверить авторизован ли пользователь
+ */
+export function isAuthenticated(): boolean {
+  const auth = getShellAuth()
+  return auth?.isAuthenticated ?? false
+}
+
+/**
+ * Инициировать редирект на страницу логина
+ */
+export async function redirectToLogin(): Promise<void> {
+  const auth = getShellAuth()
+  
+  if (auth?.signinRedirect) {
+    await auth.signinRedirect()
+  } else if (typeof window !== 'undefined') {
+    window.location.href = '/'
+  }
+}
+
+/**
+ * Выход из системы
+ */
+export async function logout(): Promise<void> {
+  const auth = getShellAuth()
+  
+  if (auth?.removeUser) {
+    await auth.removeUser()
+  }
+}