@mui-toolpad-extended-tuni/core 3.2.0 → 3.3.0

package/dist/API/ApiConfigContext.d.ts

@@ -1,5 +1,5 @@
 import { default as React, ReactNode } from 'react';
-import { ApiConfig, CoursesApiEndpoints, UsersApiEndpoints, CalendarApiEndpoints } from './types';
+import { StandardApiEndpoints } from './types';
 /**
  * Get the current API configuration from module-level store.
  * This can be called from non-React contexts (e.g., network functions).
@@ -9,15 +9,11 @@ import { ApiConfig, CoursesApiEndpoints, UsersApiEndpoints, CalendarApiEndpoints
 export declare const getApiConfig: () => ApiConfigContextValue | null;
 /**
  * API Configuration Context Value
- * Provides merged endpoint configurations for all microservices.
+ * Provides generic endpoint configuration registry for all microservices.
  */
 export interface ApiConfigContextValue {
-    /** Courses microservice endpoints (merged with defaults) */
-    courses: CoursesApiEndpoints;
-    /** Users microservice endpoints (merged with defaults) */
-    users: UsersApiEndpoints;
-    /** Calendar microservice endpoints (merged with defaults) */
-    calendar: CalendarApiEndpoints;
+    /** Map of service key to endpoint configuration */
+    endpoints: Map<string, StandardApiEndpoints>;
     /** Base URL for API requests (from axios config) */
     baseUrl: string;
 }
@@ -25,8 +21,6 @@ export interface ApiConfigContextValue {
  * Props for ApiConfigProvider component
  */
 export interface ApiConfigProviderProps {
-    /** User-provided API configuration (optional) */
-    apiConfig?: ApiConfig;
     /** Base URL for API requests (defaults to "/") */
     baseUrl?: string;
     /** Child components */
@@ -35,34 +29,58 @@ export interface ApiConfigProviderProps {
 /**
  * ApiConfigProvider Component
  *
- * Provides API endpoint configuration to all child components.
- * Merges user-provided configuration with default values for backward compatibility.
+ * Provides API endpoint configuration registry to all child components.
+ * Microservices register their endpoints via registerApiEndpoints().
  *
  * @example
  * ```tsx
- * <ApiConfigProvider
- *   apiConfig={{
- *     courses: {
- *       get: "https://api.example.com/courses",
- *       post: "https://api.example.com/courses"
- *     }
- *   }}
- * >
+ * <ApiConfigProvider baseUrl="/">
  *   <YourApp />
  * </ApiConfigProvider>
  * ```
  */
 export declare const ApiConfigProvider: React.FC<ApiConfigProviderProps>;
 /**
- * Hook to access API configuration context.
+ * Register API endpoints for a microservice.
+ * This function can be called from any component or module-level code.
  *
- * @returns API configuration context value
+ * @param serviceKey - Unique identifier for the microservice (e.g., 'courses', 'users')
+ * @param endpoints - Endpoint configuration for the microservice (user-provided, will be merged with defaults)
+ *
+ * @example
+ * ```tsx
+ * registerApiEndpoints('courses', {
+ *   get: "https://api.example.com/courses",
+ *   post: "https://api.example.com/courses"
+ * });
+ * ```
+ */
+export declare const registerApiEndpoints: (serviceKey: string, endpoints: StandardApiEndpoints) => void;
+/**
+ * Hook to access API configuration for a specific service.
+ *
+ * @param serviceKey - The service key (e.g., 'courses', 'users', 'calendar')
+ * @returns Endpoint configuration for the specified service, or undefined if not registered
+ * @throws Error if used outside of ApiConfigProvider
+ *
+ * @example
+ * ```tsx
+ * const coursesConfig = useServiceApiConfig('courses');
+ * const endpoint = coursesConfig?.get; // "api/courses/" or user-provided value
+ * ```
+ */
+export declare const useServiceApiConfig: (serviceKey: string) => StandardApiEndpoints | undefined;
+/**
+ * Hook to access the full API configuration context.
+ * Generally prefer useServiceApiConfig() for accessing specific service configs.
+ *
+ * @returns Full API configuration context value
  * @throws Error if used outside of ApiConfigProvider
  *
  * @example
  * ```tsx
- * const { courses, users } = useApiConfig();
- * const endpoint = courses.get; // "api/courses/" or user-provided value
+ * const { endpoints, baseUrl } = useApiConfigContext();
+ * const coursesConfig = endpoints.get('courses');
  * ```
  */
-export declare const useApiConfig: () => ApiConfigContextValue;
+export declare const useApiConfigContext: () => ApiConfigContextValue;

package/dist/API/types.d.ts

@@ -40,14 +40,7 @@ export interface UsersApiEndpoints extends StandardApiEndpoints {
 export interface CalendarApiEndpoints extends StandardApiEndpoints {
 }
 /**
- * Complete API configuration for all microservices.
- * Each microservice can be configured independently.
+ * Generic service API endpoints type alias.
+ * Allows microservices to define their own endpoint interfaces.
  */
-export interface ApiConfig {
-    /** Courses microservice endpoint configuration */
-    courses?: CoursesApiEndpoints;
-    /** Users microservice endpoint configuration */
-    users?: UsersApiEndpoints;
-    /** Calendar microservice endpoint configuration */
-    calendar?: CalendarApiEndpoints;
-}
+export type ServiceApiEndpoints = StandardApiEndpoints;