@cloudscaile-eng/web-ext-utils 0.0.1

package/LICENSE

@@ -0,0 +1,86 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+“License” shall mean the terms and conditions for use, reproduction, and distribution as defined by Sections 1 through 9 of this document.
+
+“Licensor” shall mean the copyright owner or entity authorized by the copyright owner that is granting the License.
+
+“Legal Entity” shall mean the union of the acting entity and all other entities that control, are controlled by, or are under common control with that entity. For the purposes of this definition, “control” means (i) the power, direct or indirect, to cause the direction or management of such entity, whether by contract or otherwise, or (ii) ownership of fifty percent (50%) or more of the outstanding shares, or (iii) beneficial ownership of such entity.
+
+“You” (or “Your”) shall mean an individual or Legal Entity exercising permissions granted by this License.
+
+“Source” form shall mean the preferred form for making modifications, including but not limited to software source code, documentation source, and configuration files.
+
+“Object” form shall mean any form resulting from mechanical transformation or translation of a Source form, including but not limited to compiled object code, generated documentation, and conversions to other media types.
+
+“Work” shall mean the work of authorship, whether in Source or Object form, made available under the License, as indicated by a copyright notice that is included in or attached to the work.
+
+“Derivative Works” shall mean any work, whether in Source or Object form, that is based on (or derived from) the Work and for which the editorial revisions, annotations, elaborations, or other modifications represent, as a whole, an original work of authorship.
+
+“Contribution” shall mean any work of authorship, including the original version of the Work and any modifications or additions to that Work or Derivative Works thereof, that is intentionally submitted to Licensor for inclusion in the Work.
+
+“Contributor” shall mean Licensor and any individual or Legal Entity on behalf of whom a Contribution has been received by Licensor and subsequently incorporated within the Work.
+
+2. Grant of Copyright License.
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable copyright license to reproduce, prepare Derivative Works of, publicly display, publicly perform, sublicense, and distribute the Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License.
+
+Subject to the terms and conditions of this License, each Contributor hereby grants to You a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable patent license to make, have made, use, offer to sell, sell, import, and otherwise transfer the Work.
+
+4. Redistribution.
+
+You may reproduce and distribute copies of the Work or Derivative Works thereof in any medium, with or without modifications, and in Source or Object form, provided that You meet the following conditions:
+
+(a) You must give any other recipients of the Work or Derivative Works a copy of this License; and
+
+(b) You must cause any modified files to carry prominent notices stating that You changed the files; and
+
+(c) You must retain, in the Source form of any Derivative Works that You distribute, all copyright, patent, trademark, and attribution notices from the Source form of the Work.
+
+(d) If the Work includes a “NOTICE” text file as part of its distribution, then any Derivative Works that You distribute must include a readable copy of the attribution notices contained within such NOTICE file.
+
+5. Submission of Contributions.
+
+Unless You explicitly state otherwise, any Contribution intentionally submitted for inclusion in the Work by You to the Licensor shall be under the terms and conditions of this License.
+
+6. Trademarks.
+
+This License does not grant permission to use the trade names, trademarks, service marks, or product names of the Licensor, except as required for reasonable and customary use in describing the origin of the Work.
+
+7. Disclaimer of Warranty.
+
+Unless required by applicable law or agreed to in writing, Licensor provides the Work on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied, including, without limitation, any warranties or conditions of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A PARTICULAR PURPOSE.
+
+8. Limitation of Liability.
+
+In no event and under no legal theory, whether in tort (including negligence), contract, or otherwise, unless required by applicable law, shall any Contributor be liable to You for damages, including any direct, indirect, special, incidental, or consequential damages arising out of the use or inability to use the Work.
+
+9. Accepting Warranty or Additional Liability.
+
+While redistributing the Work or Derivative Works thereof, You may choose to offer support, warranty, indemnity, or other liability obligations, but only on Your own behalf.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+Copyright 2026 CloudScaile
+
+Licensed under the Apache License, Version 2.0 (the “License”);
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an “AS IS” BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+ 

package/README.md

@@ -0,0 +1,248 @@
+# Web Extension Utils
+
+Extension utilities for micro-frontend architecture.
+
+# Installation
+
+Install the package:
+```bash
+npm install @cloudscaile-eng/web-ext-utils
+```
+
+### Peer Dependencies
+
+This package requires the following peer dependencies to be installed in the host application:
+
+```bash
+npm install @mui/material @reduxjs/toolkit axios
+```
+
+**Note on TypeScript Support**: TypeScript type definitions for peer dependencies are bundled with this package's distribution. You will receive full IntelliSense support even during the initial installation. However, at runtime, the peer dependencies must be installed in your project for the package to function correctly.
+
+## Host Application
+
+The host application must initialize shared resources before any micro-frontends can access them.
+
+```typescript
+import { initializeHost } from '@cloudscaile-eng/web-ext-utils';
+
+const hostAPI = initializeHost({
+  extAxios: axiosFunction,
+  reduxStore: store,
+  eventBus: eventBusInstance,
+  injectReducers: injectReducerFunction,
+  registerTranslation: registerTranslationFunction,
+  theme: themeObject,
+  toast: toastFunction,
+  getUser: getUserFunction,
+  validateUserPermission: validateUserPermissionFunction,
+  triggerLogin: triggerLoginFunction
+});
+```
+
+## Micro-Frontend Application
+
+A micro-frontend can access shared resources using individual functions with an extension object.
+
+```js
+import {
+  getExtension,
+  getExtAxios,
+  getReduxStore,
+  getEventBus,
+  injectReducers,
+  registerTranslation,
+  getNsForTranslation,
+  getTheme,
+  toast,
+  getUser,
+  validateUserPermission,
+  triggerLogin
+} from '@cloudscaile-eng/web-ext-utils';
+
+// Create extension object
+const extension = getExtension('<tenant>', '<extension>');
+
+// Access shared resources
+const axiosInstance = getExtAxios(extension, { errorToast: true });
+const store = getReduxStore(extension);
+const eventBus = getEventBus(extension);
+
+// Inject additional reducers into the host application
+injectReducers(extension, {
+  reducers: { auth: authSlice.reducer },
+  whitelist: ['auth']
+});
+
+// Register translations
+registerTranslation(extension, {
+  ns: 'auth',
+  translation: { en: { login: 'Login', logout: 'Logout' } }
+});
+
+// Get namespace for translations
+const ns = getNsForTranslation(extension, 'auth');
+
+// Access theme, show toast, and get user information
+const theme = getTheme(extension);
+toast(extension, 'Welcome!', 'success');
+const user = getUser(extension);
+const permissions = validateUserPermission(extension, ['payment.refund', 'inventory.bill']); // Returns {"payment.refund": true, "inventory.bill": false}
+
+// Trigger login with redirect
+triggerLogin(extension, { redirect: '/home/dash' });
+```
+
+## API Reference
+
+### `initializeHost(config)`
+
+Initializes shared resources in the host application.
+
+#### Parameters
+
+- `config.extAxios`: The shared Axios instance function.
+- `config.reduxStore`: The shared Redux store.
+- `config.eventBus`: The shared event bus.
+- `config.injectReducers`: Function to inject reducers into the host.
+- `config.registerTranslation`: Function to register translations into the host.
+- `config.theme`: Theme object to share with micro-frontends.
+- `config.toast`: Function to show toast notifications.
+- `config.getUser`: Function to get user information.
+- `config.validateUserPermission`: Function to validate user permissions.
+- `config.triggerLogin`: Function to trigger login in the host.
+- `config.validateUserPermission`: Function to validate user permissions.
+
+#### Returns
+
+- `getSharedResources()`: Returns the shared resources object.
+
+### `getExtension(tenant, name)`
+
+Creates an extension object with tenant and name identifiers.
+
+#### Parameters
+
+- `tenant`: The tenant identifier specified in the manifest.
+- `name`: The extension name as defined in the manifest.
+
+#### Returns
+
+Extension object.
+
+### Individual Resource Functions
+
+All resource functions require an `extension` object as the first parameter:
+
+#### `getExtAxios(extension, config)`
+
+Returns the shared Axios instance with optional configuration.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+- `config`: Optional configuration object with properties like `errorToast`, `errorMessage`, `host`, `type`, `open`, `local`.
+
+#### `getReduxStore(extension)`
+
+Returns the shared Redux store.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+
+#### `getEventBus(extension)`
+
+Returns the shared event bus.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+
+#### `injectReducers(extension, options)`
+
+Injects reducers into the host application.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+- `options`: Object with `reducers`, `whitelist`, and `replace` properties.
+
+#### `registerTranslation(extension, options)`
+
+Registers translations into the host application.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+- `options`: Object with `ns` (namespace) and `translation` properties.
+
+#### `getNsForTranslation(extension, extensionNs)`
+
+Returns the namespace string for translations.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+- `extensionNs`: The extension-specific namespace.
+
+#### `getTheme(extension)`
+
+Returns the shared theme object.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+
+#### `toast(extension, message, type)`
+
+Shows a toast notification.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+- `message`: The message to display.
+- `type`: Toast type ('success', 'error', 'info', 'warn').
+
+#### `getUser(extension)`
+
+Returns the user information from the host application.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+
+#### `validateUserPermission(extension, permissions)`
+
+Validates user permissions for the given extension.
+
+**Parameters:**
+
+- `extension`: Extension object from `getExtension()`.
+
+- `permissions`: Array of permission keys (e.g., `['payment.refund', 'inventory.bill']`).
+
+**Returns:**
+
+An object mapping each permission to a boolean (e.g., `{"payment.refund": true, "inventory.bill": false}`).
+
+### `triggerLogin(extension, config)`
+
+Triggers the login process in the host application for the given extension.
+
+#### Parameters
+
+- `extension`: Extension object from `getExtension()`.
+
+- `config`: Optional configuration object with properties like `redirect` (e.g., `'/home/dash'`).
+
+**Returns:**
+
+The result of the triggerLogin resource.
+
+## Error Handling
+
+- If the host has not initialized resources, individual resource functions will throw an error.
+- Ensure `initializeHost()` is called before loading any micro-frontends.
+- If required resources are missing during host initialization, an error will be thrown.
+- Extension validation will throw errors if `tenant` or `name` is missing from the extension

package/dist/cs-ext-utils.untrimmed.d.ts

@@ -0,0 +1,298 @@
+import { AxiosError } from 'axios';
+import { AxiosInstance } from 'axios';
+import { AxiosRequestConfig } from 'axios';
+import { AxiosResponse } from 'axios';
+import { CssVarsTheme } from '@mui/material/styles';
+import { EnhancedStore } from '@reduxjs/toolkit';
+import { StoreEnhancer } from '@reduxjs/toolkit';
+import { Theme } from '@mui/material/styles';
+import { ThemeOptions } from '@mui/material/styles';
+import { ThunkDispatch } from '@reduxjs/toolkit';
+import { Tuple } from '@reduxjs/toolkit';
+import { UnknownAction } from '@reduxjs/toolkit';
+
+export { AxiosError }
+
+export { AxiosInstance }
+
+export { AxiosRequestConfig }
+
+export { AxiosResponse }
+
+export { CssVarsTheme }
+
+export { EnhancedStore }
+
+/**
+ * Callback function type for event handlers
+ * @public
+ */
+export declare type EventCallback<T = unknown> = (data: T) => void;
+
+/**
+ * Configuration options for the extension axios instance
+ * @public
+ */
+export declare type ExtAxiosConfig = {
+    errorToast?: boolean;
+    errorMessage?: string;
+    host?: boolean;
+    type?: string;
+    open?: boolean;
+    local?: boolean;
+};
+
+/**
+ * Extension interface containing identification information
+ * @public
+ */
+export declare interface Extension {
+    tenant: string;
+    name: string;
+}
+
+/**
+ * Returns the Event Bus resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The Event Bus resource instance.
+ * @public
+ */
+export declare function getEventBus(extension: Extension): SharedResources['eventBus'];
+
+/**
+ * Returns the extAxios resource for the given extension.
+ * @param extension - The extension object.
+ * @param config - Optional configuration for extAxios.
+ * @returns The extAxios resource instance.
+ * @public
+ */
+export declare function getExtAxios(extension: Extension, config?: ExtAxiosConfig): AxiosInstance;
+
+/**
+ * Creates an extension object with tenant and name.
+ * @param tenant - The tenant identifier.
+ * @param name - The extension name.
+ * @returns The extension object.
+ * @throws Will throw an error if tenant or name is missing.
+ * @public
+ */
+export declare function getExtension(tenant: string, name: string): Extension;
+
+/**
+ * Generates a translation namespace string for the given extension.
+ * @param extension - The extension object.
+ * @param extensionNs - The extension-specific namespace.
+ * @returns The generated namespace string.
+ * @public
+ */
+export declare function getNsForTranslation(extension: Extension, extensionNs: string): string;
+
+/**
+ * Returns the Redux store resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The Redux store resource instance.
+ * @public
+ */
+export declare function getReduxStore(extension: Extension): SharedResources['reduxStore'];
+
+/**
+ * Returns the theme resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The MUI theme resource instance.
+ * @public
+ */
+export declare function getTheme(extension: Extension): Theme;
+
+/**
+ * Retrieves the user information for the given extension.
+ * @param extension - The extension object.
+ * @returns The user information resource instance.
+ * @public
+ */
+export declare function getUser(extension: Extension): User;
+
+/**
+ * Host API interface returned by initializeHost
+ * @public
+ */
+export declare interface HostAPI {
+    getSharedResources(): SharedResources;
+}
+
+/**
+ * Host initialization configuration
+ * @public
+ */
+export declare interface HostConfig {
+    extAxios: SharedResources['extAxios'];
+    reduxStore: SharedResources['reduxStore'];
+    eventBus: SharedResources['eventBus'];
+    injectReducers: SharedResources['injectReducers'];
+    registerTranslation: SharedResources['registerTranslation'];
+    toast: SharedResources['toast'];
+    getUser: SharedResources['getUser'];
+    validateUserPermission: SharedResources['validateUserPermission'];
+    triggerLogin: SharedResources['triggerLogin'];
+    theme: SharedResources['theme'];
+    initialized?: boolean;
+}
+
+/**
+ * Initialize the communication package in the host application
+ * @param config - Configuration object containing:
+ *   - extAxios: The axios interceptor from the host
+ *   - reduxStore: The Redux store from the host
+ *   - eventBus: The Event Bus from the host
+ *   - injectReducers: Function to inject a reducer into the host store
+ *   - registerTranslation: Function to register translations in the host
+ *   - theme: The theme resource from the host
+ *   - toast: Function to trigger toast notifications in the host
+ *   - getUser: Function to get the user information from the host
+ *   - validateUserPermission: Function to validate user permissions in the host
+ *   - triggerLogin: Function to trigger login in the host
+ * @throws Will throw an error if any required configuration is missing
+ * @returns Object with method to access shared resources
+ * @public
+ */
+export declare function initializeHost(config: HostConfig): HostAPI;
+
+/**
+ * Configuration for injecting reducers into the Redux store
+ * @public
+ */
+export declare type InjectedReducer = {
+    reducers: Record<string, unknown>;
+    whitelist?: string[];
+    replace?: string[];
+};
+
+/**
+ * Injects reducers into the host Redux store for the given extension.
+ * @param extension - The extension object.
+ * @param params - Reducer injection options.
+ * @returns The result of the injectReducers resource.
+ * @public
+ */
+export declare function injectReducers(extension: Extension, params: InjectedReducer): boolean;
+
+/**
+ * Configuration for registering translations
+ * @public
+ */
+export declare type RegisterTranslation = {
+    ns: string;
+    translation: Record<string, unknown>;
+};
+
+/**
+ * Registers a translation namespace and content for the given extension.
+ * @param extension - The extension object.
+ * @param params - Translation registration options.
+ * @returns The result of the registerTranslation resource.
+ * @public
+ */
+export declare function registerTranslation(extension: Extension, params: RegisterTranslation): boolean;
+
+/**
+ * Shared resources interface representing data shared between host and micro-frontends
+ * @public
+ */
+export declare interface SharedResources {
+    extAxios: (config: ExtAxiosConfig & {
+        name: string;
+        tenant: string;
+    }) => AxiosInstance;
+    reduxStore: EnhancedStore<{
+        store: {
+            store: number;
+            active: number;
+        };
+    }, UnknownAction, Tuple<[
+    StoreEnhancer<{
+        dispatch: ThunkDispatch<{
+            store: {
+                store: number;
+                active: number;
+            };
+        }, undefined, UnknownAction>;
+    }>,
+    StoreEnhancer
+    ]>>;
+    eventBus: {
+        events: Record<string, EventCallback[]>;
+        on<T = unknown>(event: string, callback: EventCallback<T>): void;
+        emit<T = unknown>(event: string, data: T): void;
+    };
+    injectReducers: (params: InjectedReducer) => boolean;
+    registerTranslation: (params: RegisterTranslation) => boolean;
+    toast: (message: string, type: ToastType) => void;
+    getUser: () => User;
+    validateUserPermission: (extension: Extension, permissions: string[]) => Record<string, boolean>;
+    triggerLogin: (config?: TriggerLoginConfig) => unknown;
+    theme: Theme;
+    initialized: boolean;
+}
+
+export { StoreEnhancer }
+
+export { Theme }
+
+export { ThemeOptions }
+
+export { ThunkDispatch }
+
+/**
+ * Triggers a toast notification for the given extension.
+ * @param extension - The extension object.
+ * @param message - The message to display in the toast.
+ * @param type - The type of toast (e.g., 'success', 'error').
+ * @public
+ */
+export declare function toast(extension: Extension, message: string, type: ToastType): void;
+
+/**
+ * Type of toast notification
+ * @public
+ */
+export declare type ToastType = 'success' | 'error' | 'info' | 'warn';
+
+/**
+ * Triggers the login process in the host application for the given extension.
+ * @param extension - The extension object.
+ * @param config - Optional configuration for login.
+ * @returns The result of the triggerLogin resource.
+ * @public
+ */
+export declare function triggerLogin(extension: Extension, config?: TriggerLoginConfig): unknown;
+
+/**
+ * Configuration for triggering the login process
+ * @public
+ */
+export declare type TriggerLoginConfig = {
+    redirect?: string;
+};
+
+export { Tuple }
+
+export { UnknownAction }
+
+/**
+ * User information object
+ * @public
+ */
+export declare type User = {
+    data: object | null;
+    isAuthenticated: boolean;
+};
+
+/**
+ * Validates user permissions for the given extension.
+ * @param extension - The extension object.
+ * @param permissions - The list of permissions to validate.
+ * @returns The result of the validateUserPermission resource.
+ * @public
+ */
+export declare function validateUserPermission(extension: Extension, permissions: string[]): Record<string, boolean>;
+
+export { }

package/dist/index.d.ts

@@ -0,0 +1,298 @@
+import { AxiosError } from 'axios';
+import { AxiosInstance } from 'axios';
+import { AxiosRequestConfig } from 'axios';
+import { AxiosResponse } from 'axios';
+import { CssVarsTheme } from '@mui/material/styles';
+import { EnhancedStore } from '@reduxjs/toolkit';
+import { StoreEnhancer } from '@reduxjs/toolkit';
+import { Theme } from '@mui/material/styles';
+import { ThemeOptions } from '@mui/material/styles';
+import { ThunkDispatch } from '@reduxjs/toolkit';
+import { Tuple } from '@reduxjs/toolkit';
+import { UnknownAction } from '@reduxjs/toolkit';
+
+export { AxiosError }
+
+export { AxiosInstance }
+
+export { AxiosRequestConfig }
+
+export { AxiosResponse }
+
+export { CssVarsTheme }
+
+export { EnhancedStore }
+
+/**
+ * Callback function type for event handlers
+ * @public
+ */
+export declare type EventCallback<T = unknown> = (data: T) => void;
+
+/**
+ * Configuration options for the extension axios instance
+ * @public
+ */
+export declare type ExtAxiosConfig = {
+    errorToast?: boolean;
+    errorMessage?: string;
+    host?: boolean;
+    type?: string;
+    open?: boolean;
+    local?: boolean;
+};
+
+/**
+ * Extension interface containing identification information
+ * @public
+ */
+export declare interface Extension {
+    tenant: string;
+    name: string;
+}
+
+/**
+ * Returns the Event Bus resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The Event Bus resource instance.
+ * @public
+ */
+export declare function getEventBus(extension: Extension): SharedResources['eventBus'];
+
+/**
+ * Returns the extAxios resource for the given extension.
+ * @param extension - The extension object.
+ * @param config - Optional configuration for extAxios.
+ * @returns The extAxios resource instance.
+ * @public
+ */
+export declare function getExtAxios(extension: Extension, config?: ExtAxiosConfig): AxiosInstance;
+
+/**
+ * Creates an extension object with tenant and name.
+ * @param tenant - The tenant identifier.
+ * @param name - The extension name.
+ * @returns The extension object.
+ * @throws Will throw an error if tenant or name is missing.
+ * @public
+ */
+export declare function getExtension(tenant: string, name: string): Extension;
+
+/**
+ * Generates a translation namespace string for the given extension.
+ * @param extension - The extension object.
+ * @param extensionNs - The extension-specific namespace.
+ * @returns The generated namespace string.
+ * @public
+ */
+export declare function getNsForTranslation(extension: Extension, extensionNs: string): string;
+
+/**
+ * Returns the Redux store resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The Redux store resource instance.
+ * @public
+ */
+export declare function getReduxStore(extension: Extension): SharedResources['reduxStore'];
+
+/**
+ * Returns the theme resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The MUI theme resource instance.
+ * @public
+ */
+export declare function getTheme(extension: Extension): Theme;
+
+/**
+ * Retrieves the user information for the given extension.
+ * @param extension - The extension object.
+ * @returns The user information resource instance.
+ * @public
+ */
+export declare function getUser(extension: Extension): User;
+
+/**
+ * Host API interface returned by initializeHost
+ * @public
+ */
+export declare interface HostAPI {
+    getSharedResources(): SharedResources;
+}
+
+/**
+ * Host initialization configuration
+ * @public
+ */
+export declare interface HostConfig {
+    extAxios: SharedResources['extAxios'];
+    reduxStore: SharedResources['reduxStore'];
+    eventBus: SharedResources['eventBus'];
+    injectReducers: SharedResources['injectReducers'];
+    registerTranslation: SharedResources['registerTranslation'];
+    toast: SharedResources['toast'];
+    getUser: SharedResources['getUser'];
+    validateUserPermission: SharedResources['validateUserPermission'];
+    triggerLogin: SharedResources['triggerLogin'];
+    theme: SharedResources['theme'];
+    initialized?: boolean;
+}
+
+/**
+ * Initialize the communication package in the host application
+ * @param config - Configuration object containing:
+ *   - extAxios: The axios interceptor from the host
+ *   - reduxStore: The Redux store from the host
+ *   - eventBus: The Event Bus from the host
+ *   - injectReducers: Function to inject a reducer into the host store
+ *   - registerTranslation: Function to register translations in the host
+ *   - theme: The theme resource from the host
+ *   - toast: Function to trigger toast notifications in the host
+ *   - getUser: Function to get the user information from the host
+ *   - validateUserPermission: Function to validate user permissions in the host
+ *   - triggerLogin: Function to trigger login in the host
+ * @throws Will throw an error if any required configuration is missing
+ * @returns Object with method to access shared resources
+ * @public
+ */
+export declare function initializeHost(config: HostConfig): HostAPI;
+
+/**
+ * Configuration for injecting reducers into the Redux store
+ * @public
+ */
+export declare type InjectedReducer = {
+    reducers: Record<string, unknown>;
+    whitelist?: string[];
+    replace?: string[];
+};
+
+/**
+ * Injects reducers into the host Redux store for the given extension.
+ * @param extension - The extension object.
+ * @param params - Reducer injection options.
+ * @returns The result of the injectReducers resource.
+ * @public
+ */
+export declare function injectReducers(extension: Extension, params: InjectedReducer): boolean;
+
+/**
+ * Configuration for registering translations
+ * @public
+ */
+export declare type RegisterTranslation = {
+    ns: string;
+    translation: Record<string, unknown>;
+};
+
+/**
+ * Registers a translation namespace and content for the given extension.
+ * @param extension - The extension object.
+ * @param params - Translation registration options.
+ * @returns The result of the registerTranslation resource.
+ * @public
+ */
+export declare function registerTranslation(extension: Extension, params: RegisterTranslation): boolean;
+
+/**
+ * Shared resources interface representing data shared between host and micro-frontends
+ * @public
+ */
+export declare interface SharedResources {
+    extAxios: (config: ExtAxiosConfig & {
+        name: string;
+        tenant: string;
+    }) => AxiosInstance;
+    reduxStore: EnhancedStore<{
+        store: {
+            store: number;
+            active: number;
+        };
+    }, UnknownAction, Tuple<[
+    StoreEnhancer<{
+        dispatch: ThunkDispatch<{
+            store: {
+                store: number;
+                active: number;
+            };
+        }, undefined, UnknownAction>;
+    }>,
+    StoreEnhancer
+    ]>>;
+    eventBus: {
+        events: Record<string, EventCallback[]>;
+        on<T = unknown>(event: string, callback: EventCallback<T>): void;
+        emit<T = unknown>(event: string, data: T): void;
+    };
+    injectReducers: (params: InjectedReducer) => boolean;
+    registerTranslation: (params: RegisterTranslation) => boolean;
+    toast: (message: string, type: ToastType) => void;
+    getUser: () => User;
+    validateUserPermission: (extension: Extension, permissions: string[]) => Record<string, boolean>;
+    triggerLogin: (config?: TriggerLoginConfig) => unknown;
+    theme: Theme;
+    initialized: boolean;
+}
+
+export { StoreEnhancer }
+
+export { Theme }
+
+export { ThemeOptions }
+
+export { ThunkDispatch }
+
+/**
+ * Triggers a toast notification for the given extension.
+ * @param extension - The extension object.
+ * @param message - The message to display in the toast.
+ * @param type - The type of toast (e.g., 'success', 'error').
+ * @public
+ */
+export declare function toast(extension: Extension, message: string, type: ToastType): void;
+
+/**
+ * Type of toast notification
+ * @public
+ */
+export declare type ToastType = 'success' | 'error' | 'info' | 'warn';
+
+/**
+ * Triggers the login process in the host application for the given extension.
+ * @param extension - The extension object.
+ * @param config - Optional configuration for login.
+ * @returns The result of the triggerLogin resource.
+ * @public
+ */
+export declare function triggerLogin(extension: Extension, config?: TriggerLoginConfig): unknown;
+
+/**
+ * Configuration for triggering the login process
+ * @public
+ */
+export declare type TriggerLoginConfig = {
+    redirect?: string;
+};
+
+export { Tuple }
+
+export { UnknownAction }
+
+/**
+ * User information object
+ * @public
+ */
+export declare type User = {
+    data: object | null;
+    isAuthenticated: boolean;
+};
+
+/**
+ * Validates user permissions for the given extension.
+ * @param extension - The extension object.
+ * @param permissions - The list of permissions to validate.
+ * @returns The result of the validateUserPermission resource.
+ * @public
+ */
+export declare function validateUserPermission(extension: Extension, permissions: string[]): Record<string, boolean>;
+
+export { }

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -0,0 +1,219 @@
+/*
+Copyright 2026 CloudScaile
+
+Licensed under the Apache License, Version 2.0
+http://www.apache.org/licenses/LICENSE-2.0
+*/
+// ============ Implementation ============
+let globalStore = {
+    initialized: false
+};
+const ERROR_MAPS = {
+    extAxios: 'Axios Interceptor',
+    reduxStore: 'Redux Store',
+    eventBus: 'Event Bus',
+    injectReducers: 'Inject Reducers',
+    registerTranslation: 'Register Translation',
+    theme: 'Theme',
+    toast: 'Toast',
+    getUser: 'Get User',
+    validateUserPermission: 'Validate User Permission',
+    triggerLogin: 'Trigger Login'
+};
+/**
+ * Initialize the communication package in the host application
+ * @param config - Configuration object containing:
+ *   - extAxios: The axios interceptor from the host
+ *   - reduxStore: The Redux store from the host
+ *   - eventBus: The Event Bus from the host
+ *   - injectReducers: Function to inject a reducer into the host store
+ *   - registerTranslation: Function to register translations in the host
+ *   - theme: The theme resource from the host
+ *   - toast: Function to trigger toast notifications in the host
+ *   - getUser: Function to get the user information from the host
+ *   - validateUserPermission: Function to validate user permissions in the host
+ *   - triggerLogin: Function to trigger login in the host
+ * @throws Will throw an error if any required configuration is missing
+ * @returns Object with method to access shared resources
+ * @public
+ */
+export function initializeHost(config) {
+    Object.keys(ERROR_MAPS).forEach((key) => {
+        if (!config[key]) {
+            throw new Error(`${ERROR_MAPS[key]} is required`);
+        }
+    });
+    globalStore = {
+        ...globalStore,
+        ...config,
+        initialized: true
+    };
+    window.__MF_SHARED_RESOURCES__ = globalStore;
+    return {
+        getSharedResources: () => ({ ...globalStore })
+    };
+}
+/**
+ * Retrieves a shared resource from the global window object.
+ * @param resource - The name of the resource to retrieve.
+ * @returns The requested shared resource instance.
+ * @throws Will throw an error if the resource is not found or not initialized by the host app.
+ */
+function getResource(resource) {
+    if (!window.__MF_SHARED_RESOURCES__?.[resource]) {
+        throw new Error(`Resource not found: ${resource}. Please ensure the host app has initialized this resource.`);
+    }
+    return window.__MF_SHARED_RESOURCES__[resource];
+}
+/**
+ * Validates that the extension object contains required properties.
+ * @param extension - The extension object to validate.
+ * @throws Will throw an error if the extension name or tenant is missing.
+ */
+function validateExtension(extension) {
+    if (!extension?.name) {
+        throw new Error('Extension name is required');
+    }
+    if (!extension?.tenant) {
+        throw new Error('Tenant is required for the extension');
+    }
+}
+/**
+ * Creates an extension object with tenant and name.
+ * @param tenant - The tenant identifier.
+ * @param name - The extension name.
+ * @returns The extension object.
+ * @throws Will throw an error if tenant or name is missing.
+ * @public
+ */
+export function getExtension(tenant, name) {
+    if (!name || !tenant) {
+        throw new Error('Tenant and extension name required');
+    }
+    return { tenant, name };
+}
+/**
+ * Returns the extAxios resource for the given extension.
+ * @param extension - The extension object.
+ * @param config - Optional configuration for extAxios.
+ * @returns The extAxios resource instance.
+ * @public
+ */
+export function getExtAxios(extension, config = {}) {
+    validateExtension(extension);
+    const extAxios = getResource('extAxios');
+    return extAxios({ ...config, name: extension.name, tenant: extension.tenant });
+}
+/**
+ * Returns the Redux store resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The Redux store resource instance.
+ * @public
+ */
+export function getReduxStore(extension) {
+    validateExtension(extension);
+    return getResource('reduxStore');
+}
+/**
+ * Returns the Event Bus resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The Event Bus resource instance.
+ * @public
+ */
+export function getEventBus(extension) {
+    validateExtension(extension);
+    return getResource('eventBus');
+}
+/**
+ * Injects reducers into the host Redux store for the given extension.
+ * @param extension - The extension object.
+ * @param params - Reducer injection options.
+ * @returns The result of the injectReducers resource.
+ * @public
+ */
+export function injectReducers(extension, params) {
+    validateExtension(extension);
+    const injectReducersResource = getResource('injectReducers');
+    return injectReducersResource(params);
+}
+/**
+ * Registers a translation namespace and content for the given extension.
+ * @param extension - The extension object.
+ * @param params - Translation registration options.
+ * @returns The result of the registerTranslation resource.
+ * @public
+ */
+export function registerTranslation(extension, params) {
+    validateExtension(extension);
+    const registerTranslationResource = getResource('registerTranslation');
+    return registerTranslationResource(params);
+}
+/**
+ * Generates a translation namespace string for the given extension.
+ * @param extension - The extension object.
+ * @param extensionNs - The extension-specific namespace.
+ * @returns The generated namespace string.
+ * @public
+ */
+export function getNsForTranslation(extension, extensionNs) {
+    validateExtension(extension);
+    return `${extension.tenant}_${extension.name}_${extensionNs}`;
+}
+/**
+ * Returns the theme resource for the given extension.
+ * @param extension - The extension object.
+ * @returns The MUI theme resource instance.
+ * @public
+ */
+export function getTheme(extension) {
+    validateExtension(extension);
+    return getResource('theme');
+}
+/**
+ * Triggers a toast notification for the given extension.
+ * @param extension - The extension object.
+ * @param message - The message to display in the toast.
+ * @param type - The type of toast (e.g., 'success', 'error').
+ * @public
+ */
+export function toast(extension, message, type) {
+    validateExtension(extension);
+    const toastResource = getResource('toast');
+    toastResource(message, type);
+}
+/**
+ * Retrieves the user information for the given extension.
+ * @param extension - The extension object.
+ * @returns The user information resource instance.
+ * @public
+ */
+export function getUser(extension) {
+    validateExtension(extension);
+    const getUserResource = getResource('getUser');
+    return getUserResource();
+}
+/**
+ * Validates user permissions for the given extension.
+ * @param extension - The extension object.
+ * @param permissions - The list of permissions to validate.
+ * @returns The result of the validateUserPermission resource.
+ * @public
+ */
+export function validateUserPermission(extension, permissions) {
+    validateExtension(extension);
+    const validateUserPermissionResource = getResource('validateUserPermission');
+    return validateUserPermissionResource(extension, permissions);
+}
+/**
+ * Triggers the login process in the host application for the given extension.
+ * @param extension - The extension object.
+ * @param config - Optional configuration for login.
+ * @returns The result of the triggerLogin resource.
+ * @public
+ */
+export function triggerLogin(extension, config) {
+    validateExtension(extension);
+    const triggerLoginResource = getResource('triggerLogin');
+    return triggerLoginResource(config);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,85 @@
+{
+  "name": "@cloudscaile-eng/web-ext-utils",
+  "version": "0.0.1",
+  "description": "Utilities for sharing host resources with micro-frontends in web applications",
+  "license": "Apache-2.0",
+  "author": "CloudScaile Engineering",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rimraf dist && tsc && api-extractor run --local || true",
+    "prepublishOnly": "npm run build",
+    "build:lint": "npm run format-check && npm run lint && npm run typecheck",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src",
+    "lint-fix": "eslint src --fix",
+    "format": "prettier --write .",
+    "format-check": "prettier --check .",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "cloudscaile",
+    "micro-frontend",
+    "redux",
+    "axios",
+    "extension"
+  ],
+  "type": "module",
+  "peerDependencies": {
+    "@mui/material": "^7.0.0",
+    "@reduxjs/toolkit": "^2.0.0",
+    "axios": "^1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@mui/material": {
+      "optional": false
+    },
+    "@reduxjs/toolkit": {
+      "optional": false
+    },
+    "axios": {
+      "optional": false
+    }
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.1",
+    "@microsoft/api-extractor": "^7.58.9",
+    "@mui/material": "^7.1.0",
+    "@reduxjs/toolkit": "^2.12.0",
+    "@typescript-eslint/eslint-plugin": "^8.48.1",
+    "@typescript-eslint/parser": "^8.48.1",
+    "axios": "^1.8.2",
+    "eslint": "^9.39.1",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.7.4",
+    "rimraf": "^6.1.2",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.48.1"
+  },
+  "lint-staged": {
+    "*.{ts,tsx}": [
+      "npm run format",
+      "npm run lint"
+    ],
+    "*.{json,md,css,yml,yaml}": [
+      "npm run format"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}