@vnb/mfe-events 0.0.1-rc.1

package/dist/bus.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @xxxx/mfe-events — Type-safe Event Bus
+ *
+ * Provides compile-time type checking for event names and payloads.
+ * Wraps Transport with generic type constraints.
+ */
+import type { Transport } from './transport';
+export declare class Bus<T extends Record<string, any>> {
+    private transport;
+    constructor(transport: Transport);
+    /**
+     * Emit an event with type-safe payload
+     */
+    emit<K extends keyof T>(event: K, data: T[K]): void;
+    /**
+     * Subscribe to an event with type-safe handler
+     * Returns unsubscribe function
+     */
+    on<K extends keyof T>(event: K, handler: (data: T[K]) => void, options?: {
+        priority?: number;
+        once?: boolean;
+    }): () => void;
+    /**
+     * Subscribe to an event once
+     * Returns unsubscribe function
+     */
+    once<K extends keyof T>(event: K, handler: (data: T[K]) => void): () => void;
+}
+//# sourceMappingURL=bus.d.ts.map

package/dist/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../src/bus.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,qBAAa,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAChC,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAExC;;OAEG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAInD;;;OAGG;IACH,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAClB,KAAK,EAAE,CAAC,EACR,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,EAC7B,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAC9C,MAAM,IAAI;IAOb;;;OAGG;IACH,IAAI,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,GAAG,MAAM,IAAI;CAO7E"}

package/dist/constants.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @xxxx/mfe-events — Event Constants
+ *
+ * Three scopes:
+ * - EvtShl: Shell internal (no window, memory only)
+ * - EvtMfe: Cross-app (Shell + Remote Apps)
+ * - EvtApp: Remote App internal (framework-specific)
+ *
+ * Naming convention: {scope}:{domain}-{action}
+ * - State/notification events: must have -{action} suffix
+ * - Event markers (error, shell-ready, raw): no suffix
+ */
+export declare const EvtShl: {
+    readonly TabOverflow: "shl:tab-overflow";
+    readonly TabClose: "shl:tab-close";
+    readonly RouteReuse: "shl:route-reuse";
+    readonly AuthSync: "shl:auth-sync";
+    readonly StateSync: "shl:state-sync";
+    readonly AppMounted: "shl:app-mounted";
+    readonly AppUnmounted: "shl:app-unmounted";
+};
+export declare const EvtMfe: {
+    readonly ThemeUpdate: "mfe:theme-update";
+    readonly LocaleUpdate: "mfe:locale-update";
+    readonly BreakpointUpdate: "mfe:breakpoint-update";
+    readonly StateUpdate: "mfe:state-update";
+    readonly ShellReady: "mfe:shell-ready";
+    readonly Error: "mfe:error";
+    readonly Raw: "mfe:raw";
+    readonly Custom: "mfe:raw";
+    readonly AuthLogin: "mfe:auth-login";
+    readonly AuthLogout: "mfe:auth-logout";
+    readonly AuthTokenUpdate: "mfe:auth-token-update";
+    readonly AuthTokenClear: "mfe:auth-token-clear";
+    readonly AuthPermissionUpdate: "mfe:auth-permission-update";
+    readonly AuthExpired: "mfe:auth-expired";
+    readonly RouteNavigate: "mfe:route-navigate";
+    readonly RouteRefresh: "mfe:route-refresh";
+    readonly RouteChange: "mfe:route-change";
+    readonly LifecycleAppClose: "mfe:lifecycle-app-close";
+    readonly LifecycleAppReady: "mfe:lifecycle-app-ready";
+    readonly LifecycleAppUnmount: "mfe:lifecycle-app-unmount";
+    readonly NotifyShow: "mfe:notify-show";
+    readonly NotifyClose: "mfe:notify-close";
+    readonly NotifyCloseAll: "mfe:notify-close-all";
+};
+export declare function EvtApp(appId: string, name: string): `app:${string}-${string}`;
+//# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,eAAO,MAAM,MAAM;;;;;;;;CAQT,CAAC;AAKX,eAAO,MAAM,MAAM;;;;;;;;;;;;;;;;;;;;;;;;CAiCT,CAAC;AAKX,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,MAAM,IAAI,MAAM,EAAE,CAE7E"}

package/dist/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @xxxx/mfe-events — Micro Frontend Event Plugin
+ *
+ * Unified event communication for Module Federation / Native Federation / iframe architectures.
+ *
+ * Features:
+ * - Three scopes: EvtShl (Shell internal), EvtMfe (cross-app), EvtApp (Remote App internal)
+ * - Type-safe event bus with compile-time checking
+ * - Automatic Transport adaptation (CustomEvent for MF, postMessage for iframe)
+ * - Plugin API for Remote App registration and communication
+ * - Notification API with fallback support
+ *
+ * Usage:
+ * ```typescript
+ * import mfeEventPlugin, { mfeBus, shlBus } from '@xxxx/mfe-events'
+ * import { EvtMfe, EvtShl, EvtApp } from '@xxxx/mfe-events'
+ * ```
+ */
+export { MemoryTransport, WindowTransport, PostMessageTransport, IframeProxyTransport } from './transport';
+export type { Transport } from './transport';
+export { Bus } from './bus';
+export { EvtShl, EvtMfe, EvtApp } from './constants';
+export type { PayloadShl, PayloadMfe, PayloadApp, NotificationType, NotificationConfig, AppType, AppMeta, PluginOptions, } from './types';
+export { mfeEventPlugin } from './plugin';
+export type { default as MfeEventPlugin } from './plugin';
+export { mfeEventPlugin as default } from './plugin';
+import { Bus } from './bus';
+import type { PayloadShl, PayloadMfe } from './types';
+/**
+ * Shell internal bus — isolated, does not touch window
+ * Use for Shell-internal state synchronization
+ */
+export declare const shlBus: Bus<PayloadShl>;
+export declare const mfeBus: Bus<PayloadMfe>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAC3G,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAG5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAGrD,YAAY,EACV,UAAU,EACV,UAAU,EACV,UAAU,EACV,gBAAgB,EAChB,kBAAkB,EAClB,OAAO,EACP,OAAO,EACP,aAAa,GACd,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,cAAc,IAAI,OAAO,EAAE,MAAM,UAAU,CAAC;AAOrD,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,MAAM,iBAA6C,CAAC;AAwBjE,eAAO,MAAM,MAAM,iBAAiB,CAAC"}