@granite-js/micro-frontend 2.1.1 → 2.2.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @granite-js/micro-frontend
 
+## 2.2.0
+
+### Minor Changes
+
+- 2513bd8: Allow hosts to observe committed micro-frontend session mount and unmount transitions through an `onLifecycleEvent` runtime option with session metadata and an active-session snapshot.
+
+### Patch Changes
+
+- @granite-js/utils@2.2.0
+
 ## 2.1.1
 
 ### Patch Changes

package/README.md

@@ -172,6 +172,9 @@ const runtime = createMicroFrontendRuntime({
       return { filePath };
     },
   },
+  onLifecycleEvent(event) {
+    reportMicroFrontendLifecycle(event);
+  },
 });
 
 await runtime.preloadApp('cart');
@@ -211,6 +214,29 @@ The public runtime API is:
 | `evaluateScript(filePath)` | Evaluate an already-local bundle in the retained runtime.       |
 | `onEvent(listener)`        | Subscribe to native open, close, and visibility events.         |
 
+The host can provide `onLifecycleEvent` when creating the runtime for logging
+and other observability integrations. Each event contains `session.id`,
+`session.appName`, and the `activeSessions` snapshot when the callback is
+emitted. The callback has the same lifetime as the runtime.
+
+```ts
+const runtime = createMicroFrontendRuntime({
+  adapter,
+  onLifecycleEvent(event) {
+    reportMicroFrontendLifecycle({
+      ...event,
+      activeSessionCount: event.activeSessions.length,
+    });
+  },
+});
+```
+
+`mounted` is emitted after the session is committed to React state. `unmounted`
+is emitted after the session is removed. When the session was the app's last
+active session, Granite waits for the app's registered dispose callbacks before
+emitting `unmounted`. Callback failures are reported without interrupting the
+session lifecycle.
+
 Remote code can register an idempotent callback for explicit app-level resource
 cleanup:
 

package/dist/module/createMicroFrontendRuntime.js

@@ -9,6 +9,7 @@ export function createMicroFrontendRuntime(options) {
   return createMicroFrontendRuntimeWithDependencies({
     adapter: options.adapter,
     nativeRuntime: NativeGraniteMicroFrontendRuntime,
+    onLifecycleEvent: options.onLifecycleEvent,
     onPreloadError: options.onPreloadError ?? (() => undefined),
     parseEvent: parseNativeRuntimeEvent,
     registry: microFrontendModuleRegistry,

package/dist/module/createMicroFrontendRuntime.js.map

@@ -1 +1 @@
-{"version":3,"names":["removePendingHostComponentRoutes","createMicroFrontendRuntimeWithDependencies","parseNativeRuntimeEvent","microFrontendModuleRegistry","NativeGraniteMicroFrontendRuntime","createMicroFrontendRuntime","options","adapter","nativeRuntime","onPreloadError","undefined","parseEvent","registry"],"sourceRoot":"../../src","sources":["createMicroFrontendRuntime.ts"],"mappings":";;AAAA,SAASA,gCAAgC,QAAQ,qCAAkC;AACnF,SAASC,0CAA0C,QAAQ,yCAAsC;AACjG,SAASC,uBAAuB,QAAQ,sCAAmC;AAC3E,SAASC,2BAA2B,QAAQ,uBAAoB;AAChE,OAAOC,iCAAiC,MAAM,8CAA2C;AAQzF,OAAO,SAASC,0BAA0BA,CAACC,OAA0C,EAA2B;EAC9G,OAAOL,0CAA0C,CAAC;IAChDM,OAAO,EAAED,OAAO,CAACC,OAAO;IACxBC,aAAa,EAAEJ,iCAAiC;IAChDK,cAAc,EAAEH,OAAO,CAACG,cAAc,KAAK,MAAMC,SAAS,CAAC;IAC3DC,UAAU,EAAET,uBAAuB;IACnCU,QAAQ,EAAET,2BAA2B;IACrCH;EACF,CAAC,CAAC;AACJ","ignoreList":[]}
+{"version":3,"names":["removePendingHostComponentRoutes","createMicroFrontendRuntimeWithDependencies","parseNativeRuntimeEvent","microFrontendModuleRegistry","NativeGraniteMicroFrontendRuntime","createMicroFrontendRuntime","options","adapter","nativeRuntime","onLifecycleEvent","onPreloadError","undefined","parseEvent","registry"],"sourceRoot":"../../src","sources":["createMicroFrontendRuntime.ts"],"mappings":";;AAAA,SAASA,gCAAgC,QAAQ,qCAAkC;AACnF,SAASC,0CAA0C,QAAQ,yCAAsC;AACjG,SAASC,uBAAuB,QAAQ,sCAAmC;AAC3E,SAASC,2BAA2B,QAAQ,uBAAoB;AAChE,OAAOC,iCAAiC,MAAM,8CAA2C;AASzF,OAAO,SAASC,0BAA0BA,CAACC,OAA0C,EAA2B;EAC9G,OAAOL,0CAA0C,CAAC;IAChDM,OAAO,EAAED,OAAO,CAACC,OAAO;IACxBC,aAAa,EAAEJ,iCAAiC;IAChDK,gBAAgB,EAAEH,OAAO,CAACG,gBAAgB;IAC1CC,cAAc,EAAEJ,OAAO,CAACI,cAAc,KAAK,MAAMC,SAAS,CAAC;IAC3DC,UAAU,EAAEV,uBAAuB;IACnCW,QAAQ,EAAEV,2BAA2B;IACrCH;EACF,CAAC,CAAC;AACJ","ignoreList":[]}

package/dist/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["createMicroFrontendRuntime","createRoute","PendingHostComponent","usePendingHostComponentController","useIsPendingHostComponentHidden","useResolvedPendingHostComponent","createPendingHostComponentRoutePrefix","normalizeRoutePath","hidePendingHostComponent","installPendingHostComponentBridge","registerPendingHostComponentRoute","resetPendingHostComponent","resolvePendingHostComponent","MicroFrontendSessionProvider","MissingMicroFrontendSessionError","useMicroFrontendSession","useMicroFrontendSessions","default","Portal","AppContainerNotFoundError","ExposedModuleNotFoundError","InvalidAppNameError","InvalidAppRequestError","InvalidNativeRuntimeEventError"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,0BAA0B,QAAQ,iCAA8B;AAEzE,SAASC,WAAW,QAAQ,kBAAe;AAG3C,SACEC,oBAAoB,EACpBC,iCAAiC,EACjCC,+BAA+B,EAC/BC,+BAA+B,QAC1B,gCAA6B;AASpC,SACEC,qCAAqC,EACrCC,kBAAkB,QACb,wBAAqB;AAC5B,SACEC,wBAAwB,EACxBC,iCAAiC,EACjCC,iCAAiC,EACjCC,yBAAyB,EACzBC,2BAA2B,QACtB,qCAAkC;AACzC,SACEC,4BAA4B,EAC5BC,gCAAgC,EAChCC,uBAAuB,QAClB,0CAAuC;AAE9C,SAASC,wBAAwB,QAAQ,uCAAoC;AAG7E,SAASC,OAAO,IAAIC,MAAM,QAAQ,mCAAmC;AAYrE,SACEC,yBAAyB,EACzBC,0BAA0B,EAC1BC,mBAAmB,EACnBC,sBAAsB,EACtBC,8BAA8B,QACzB,qBAAkB","ignoreList":[]}
+{"version":3,"names":["createMicroFrontendRuntime","createRoute","PendingHostComponent","usePendingHostComponentController","useIsPendingHostComponentHidden","useResolvedPendingHostComponent","createPendingHostComponentRoutePrefix","normalizeRoutePath","hidePendingHostComponent","installPendingHostComponentBridge","registerPendingHostComponentRoute","resetPendingHostComponent","resolvePendingHostComponent","MicroFrontendSessionProvider","MissingMicroFrontendSessionError","useMicroFrontendSession","useMicroFrontendSessions","default","Portal","AppContainerNotFoundError","ExposedModuleNotFoundError","InvalidAppNameError","InvalidAppRequestError","InvalidNativeRuntimeEventError"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,0BAA0B,QAAQ,iCAA8B;AAEzE,SAASC,WAAW,QAAQ,kBAAe;AAG3C,SACEC,oBAAoB,EACpBC,iCAAiC,EACjCC,+BAA+B,EAC/BC,+BAA+B,QAC1B,gCAA6B;AASpC,SACEC,qCAAqC,EACrCC,kBAAkB,QACb,wBAAqB;AAC5B,SACEC,wBAAwB,EACxBC,iCAAiC,EACjCC,iCAAiC,EACjCC,yBAAyB,EACzBC,2BAA2B,QACtB,qCAAkC;AACzC,SACEC,4BAA4B,EAC5BC,gCAAgC,EAChCC,uBAAuB,QAClB,0CAAuC;AAE9C,SAASC,wBAAwB,QAAQ,uCAAoC;AAG7E,SAASC,OAAO,IAAIC,MAAM,QAAQ,mCAAmC;AAerE,SACEC,yBAAyB,EACzBC,0BAA0B,EAC1BC,mBAAmB,EACnBC,sBAAsB,EACtBC,8BAA8B,QACzB,qBAAkB","ignoreList":[]}

package/dist/module/runtime/createMicroFrontendRuntime.js

@@ -2,6 +2,7 @@
 
 import { AppContainerNotFoundError, InvalidAppNameError } from "./errors.js";
 import { getMicroFrontendGlobalContext } from "./globalContext.js";
+import { setMicroFrontendLifecycleCallback } from "./lifecycle.js";
 import { installNativeComponentRegistryCompatibility } from "./nativeComponentRegistryCompatibility.js";
 import { parseAppRequest } from "./parseAppRequest.js";
 export function createMicroFrontendRuntimeWithDependencies(dependencies) {
@@ -47,7 +48,7 @@ export function createMicroFrontendRuntimeWithDependencies(dependencies) {
       throw error;
     }
   }
-  return {
+  const runtime = {
     evaluateScript,
     preloadApp,
     async importApp(request) {
@@ -80,5 +81,7 @@ export function createMicroFrontendRuntimeWithDependencies(dependencies) {
       return subscription;
     }
   };
+  setMicroFrontendLifecycleCallback(runtime, dependencies.onLifecycleEvent);
+  return runtime;
 }
 //# sourceMappingURL=createMicroFrontendRuntime.js.map

package/dist/module/runtime/createMicroFrontendRuntime.js.map

@@ -1 +1 @@
-{"version":3,"names":["AppContainerNotFoundError","InvalidAppNameError","getMicroFrontendGlobalContext","installNativeComponentRegistryCompatibility","parseAppRequest","createMicroFrontendRuntimeWithDependencies","dependencies","appEvaluations","Map","resetFailedEvaluation","appName","delete","registry","removeContainer","removePendingHostComponentRoutes","preloadApp","length","Promise","reject","existingEvaluation","get","evaluation","evaluateApp","set","evaluateScript","filePath","nativeRuntime","adapter","loadBundle","hasContainer","error","importApp","request","importModule","onEvent","listener","subscription","event","parsedEvent","parseEvent","name","params","catch","onPreloadError","exhaustiveEvent","startEventDelivery"],"sourceRoot":"../../../src","sources":["runtime/createMicroFrontendRuntime.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["AppContainerNotFoundError","InvalidAppNameError","getMicroFrontendGlobalContext","setMicroFrontendLifecycleCallback","installNativeComponentRegistryCompatibility","parseAppRequest","createMicroFrontendRuntimeWithDependencies","dependencies","appEvaluations","Map","resetFailedEvaluation","appName","delete","registry","removeContainer","removePendingHostComponentRoutes","preloadApp","length","Promise","reject","existingEvaluation","get","evaluation","evaluateApp","set","evaluateScript","filePath","nativeRuntime","adapter","loadBundle","hasContainer","error","runtime","importApp","request","importModule","onEvent","listener","subscription","event","parsedEvent","parseEvent","name","params","catch","onPreloadError","exhaustiveEvent","startEventDelivery","onLifecycleEvent"],"sourceRoot":"../../../src","sources":["runtime/createMicroFrontendRuntime.ts"],"mappings":"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","ignoreList":[]}

package/dist/module/runtime/lifecycle.js

@@ -0,0 +1,22 @@
+"use strict";
+
+const lifecycleCallbackByRuntime = new WeakMap();
+export function setMicroFrontendLifecycleCallback(runtime, callback) {
+  if (callback == null) {
+    lifecycleCallbackByRuntime.delete(runtime);
+    return;
+  }
+  lifecycleCallbackByRuntime.set(runtime, callback);
+}
+export function emitMicroFrontendLifecycleEvent(runtime, event) {
+  const callback = lifecycleCallbackByRuntime.get(runtime);
+  if (callback == null) {
+    return;
+  }
+  try {
+    callback(event);
+  } catch (error) {
+    console.error('Failed to run a micro-frontend lifecycle callback', error);
+  }
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/module/runtime/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["lifecycleCallbackByRuntime","WeakMap","setMicroFrontendLifecycleCallback","runtime","callback","delete","set","emitMicroFrontendLifecycleEvent","event","get","error","console"],"sourceRoot":"../../../src","sources":["runtime/lifecycle.ts"],"mappings":";;AAEA,MAAMA,0BAA0B,GAAG,IAAIC,OAAO,CAAuD,CAAC;AAEtG,OAAO,SAASC,iCAAiCA,CAC/CC,OAAe,EACfC,QAAoE,EAC9D;EACN,IAAIA,QAAQ,IAAI,IAAI,EAAE;IACpBJ,0BAA0B,CAACK,MAAM,CAACF,OAAO,CAAC;IAC1C;EACF;EAEAH,0BAA0B,CAACM,GAAG,CAACH,OAAO,EAAEC,QAAQ,CAAC;AACnD;AAEA,OAAO,SAASG,+BAA+BA,CAACJ,OAAe,EAAEK,KAAkC,EAAQ;EACzG,MAAMJ,QAAQ,GAAGJ,0BAA0B,CAACS,GAAG,CAACN,OAAO,CAAC;EACxD,IAAIC,QAAQ,IAAI,IAAI,EAAE;IACpB;EACF;EAEA,IAAI;IACFA,QAAQ,CAACI,KAAK,CAAC;EACjB,CAAC,CAAC,OAAOE,KAAK,EAAE;IACdC,OAAO,CAACD,KAAK,CAAC,mDAAmD,EAAEA,KAAK,CAAC;EAC3E;AACF","ignoreList":[]}

package/dist/module/session/useMicroFrontendSessions.js

@@ -2,6 +2,7 @@
 
 import { useEffect, useLayoutEffect, useReducer, useRef } from 'react';
 import { installPendingHostComponentBridge, resetPendingHostComponent } from "../host/pendingHostComponentStore.js";
+import { emitMicroFrontendLifecycleEvent } from "../runtime/lifecycle.js";
 import { disposeAppResources } from "../runtime/registry.js";
 const INITIAL_SESSIONS = [];
 function reduceMicroFrontendSessions(sessions, event) {
@@ -43,17 +44,32 @@ export function useMicroFrontendSessions(runtime) {
     const activeAppNames = new Set(sessions.map(({
       appName
     }) => appName));
-    const inactiveAppNames = new Set(previousSessions.filter(({
+    const mountedSessions = sessions.filter(({
       sessionId
-    }) => !activeSessionIds.has(sessionId)).map(({
+    }) => !previousSessions.some(previousSession => previousSession.sessionId === sessionId));
+    const inactiveSessions = previousSessions.filter(({
+      sessionId
+    }) => !activeSessionIds.has(sessionId));
+    const inactiveAppNames = new Set(inactiveSessions.map(({
       appName
     }) => appName).filter(appName => !activeAppNames.has(appName)));
-    inactiveAppNames.forEach(appName => {
-      void disposeAppResources(appName).catch(error => {
-        console.error(`Failed to dispose micro-frontend app resources for '${appName}'`, error);
+    mountedSessions.forEach(session => {
+      emitMicroFrontendLifecycleEvent(runtime, createLifecycleEvent('mounted', session, sessions));
+    });
+    const appDisposals = new Map(Array.from(inactiveAppNames, appName => [appName, disposeAppResources(appName).catch(error => {
+      console.error(`Failed to dispose micro-frontend app resources for '${appName}'`, error);
+    })]));
+    inactiveSessions.forEach(session => {
+      const appDisposal = appDisposals.get(session.appName);
+      if (appDisposal == null) {
+        emitMicroFrontendLifecycleEvent(runtime, createLifecycleEvent('unmounted', session, sessions));
+        return;
+      }
+      void appDisposal.then(() => {
+        emitMicroFrontendLifecycleEvent(runtime, createLifecycleEvent('unmounted', session, previousSessionsRef.current));
       });
     });
-  }, [sessions]);
+  }, [runtime, sessions]);
   useLayoutEffect(() => {
     installPendingHostComponentBridge();
     const subscription = runtime.onEvent(event => {
@@ -66,4 +82,17 @@ export function useMicroFrontendSessions(runtime) {
   }, [runtime]);
   return sessions;
 }
+function createLifecycleEvent(phase, session, activeSessions) {
+  return {
+    phase,
+    session: toLifecycleSession(session),
+    activeSessions: activeSessions.map(toLifecycleSession)
+  };
+}
+function toLifecycleSession(session) {
+  return {
+    appName: session.appName,
+    id: session.sessionId
+  };
+}
 //# sourceMappingURL=useMicroFrontendSessions.js.map

package/dist/module/session/useMicroFrontendSessions.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useLayoutEffect","useReducer","useRef","installPendingHostComponentBridge","resetPendingHostComponent","disposeAppResources","INITIAL_SESSIONS","reduceMicroFrontendSessions","sessions","event","name","some","sessionId","params","appName","scheme","isVisible","filter","map","session","exhaustiveEvent","useMicroFrontendSessions","runtime","dispatch","previousSessionsRef","previousSessions","current","activeSessionIds","Set","activeAppNames","inactiveAppNames","has","forEach","catch","error","console","subscription","onEvent","remove"],"sourceRoot":"../../../src","sources":["session/useMicroFrontendSessions.ts"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["useEffect","useLayoutEffect","useReducer","useRef","installPendingHostComponentBridge","resetPendingHostComponent","emitMicroFrontendLifecycleEvent","disposeAppResources","INITIAL_SESSIONS","reduceMicroFrontendSessions","sessions","event","name","some","sessionId","params","appName","scheme","isVisible","filter","map","session","exhaustiveEvent","useMicroFrontendSessions","runtime","dispatch","previousSessionsRef","previousSessions","current","activeSessionIds","Set","activeAppNames","mountedSessions","previousSession","inactiveSessions","has","inactiveAppNames","forEach","createLifecycleEvent","appDisposals","Map","Array","from","catch","error","console","appDisposal","get","then","subscription","onEvent","remove","phase","activeSessions","toLifecycleSession","id"],"sourceRoot":"../../../src","sources":["session/useMicroFrontendSessions.ts"],"mappings":"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","ignoreList":[]}

package/dist/typescript/createMicroFrontendRuntime.d.ts

@@ -1,6 +1,7 @@
-import type { MicroFrontendAdapter, MicroFrontendRuntimeApi } from './types';
+import type { MicroFrontendAdapter, MicroFrontendLifecycleCallback, MicroFrontendRuntimeApi } from './types';
 export interface CreateMicroFrontendRuntimeOptions {
     readonly adapter: MicroFrontendAdapter;
+    readonly onLifecycleEvent?: MicroFrontendLifecycleCallback;
     readonly onPreloadError?: (error: unknown) => void;
 }
 export declare function createMicroFrontendRuntime(options: CreateMicroFrontendRuntimeOptions): MicroFrontendRuntimeApi;

package/dist/typescript/index.d.ts

@@ -13,5 +13,5 @@ export { useMicroFrontendSessions } from './session/useMicroFrontendSessions';
 export type { MicroFrontendSessionState } from './session/useMicroFrontendSessions';
 export type { AppDisposeCallback, MicroFrontendRuntimeContext } from './runtime/registry';
 export { default as Portal } from './specs/PortalViewNativeComponent';
-export type { AppRequest, MicroFrontendAppProps, MicroFrontendAdapter, MicroFrontendBundle, MicroFrontendBundleRequest, MicroFrontendRuntimeApi, MicroFrontendRuntimeEvent, MicroFrontendRuntimeEventSubscription, MicroFrontendSessionEvent, } from './types';
+export type { AppRequest, MicroFrontendAppProps, MicroFrontendAdapter, MicroFrontendBundle, MicroFrontendBundleRequest, MicroFrontendLifecycleCallback, MicroFrontendLifecycleEvent, MicroFrontendLifecycleSession, MicroFrontendRuntimeApi, MicroFrontendRuntimeEvent, MicroFrontendRuntimeEventSubscription, MicroFrontendSessionEvent, } from './types';
 export { AppContainerNotFoundError, ExposedModuleNotFoundError, InvalidAppNameError, InvalidAppRequestError, InvalidNativeRuntimeEventError, } from './runtime/errors';

package/dist/typescript/runtime/createMicroFrontendRuntime.d.ts

@@ -1,4 +1,4 @@
-import type { AppRequest, MicroFrontendAdapter, MicroFrontendRuntimeApi, MicroFrontendRuntimeEvent, MicroFrontendRuntimeEventSubscription } from '../types';
+import type { AppRequest, MicroFrontendAdapter, MicroFrontendLifecycleEvent, MicroFrontendRuntimeApi, MicroFrontendRuntimeEvent, MicroFrontendRuntimeEventSubscription } from '../types';
 export interface NativeMicroFrontendRuntimeEvent {
     readonly name: string;
     readonly params: {
@@ -24,6 +24,7 @@ export interface CreateMicroFrontendRuntimeDependencies {
     readonly adapter: MicroFrontendAdapter;
     readonly nativeRuntime: NativeMicroFrontendRuntime;
     readonly onPreloadError: (error: unknown) => void;
+    readonly onLifecycleEvent?: (event: MicroFrontendLifecycleEvent) => void;
     readonly registry: MicroFrontendModuleRegistry;
     readonly removePendingHostComponentRoutes: (appName: string) => void;
     readonly parseEvent: (event: NativeMicroFrontendRuntimeEvent) => MicroFrontendRuntimeEvent;

package/dist/typescript/runtime/lifecycle.d.ts

@@ -0,0 +1,3 @@
+import type { MicroFrontendLifecycleEvent } from '../types';
+export declare function setMicroFrontendLifecycleCallback(runtime: object, callback: ((event: MicroFrontendLifecycleEvent) => void) | undefined): void;
+export declare function emitMicroFrontendLifecycleEvent(runtime: object, event: MicroFrontendLifecycleEvent): void;

package/dist/typescript/types.d.ts

@@ -41,6 +41,17 @@ export type MicroFrontendSessionEvent = Exclude<MicroFrontendRuntimeEvent, {
 export interface MicroFrontendRuntimeEventSubscription {
     readonly remove: () => void;
 }
+export interface MicroFrontendLifecycleSession {
+    readonly appName: string;
+    readonly id: string;
+}
+export interface MicroFrontendLifecycleEvent {
+    readonly phase: 'mounted' | 'unmounted';
+    readonly session: MicroFrontendLifecycleSession;
+    /** Active sessions across every app when the callback is emitted. */
+    readonly activeSessions: readonly MicroFrontendLifecycleSession[];
+}
+export type MicroFrontendLifecycleCallback = (event: MicroFrontendLifecycleEvent) => void;
 export interface MicroFrontendRuntimeApi {
     readonly evaluateScript: (filePath: string) => Promise<void>;
     readonly preloadApp: (appName: string) => Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@granite-js/micro-frontend",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Micro-frontend build, runtime, session, and Portal contracts for Granite brownfield applications",
   "main": "./dist/module/index.js",
   "types": "./dist/typescript/index.d.ts",
@@ -56,7 +56,7 @@
   },
   "dependencies": {
     "@babel/core": "7.28.5",
-    "@granite-js/utils": "2.1.1",
+    "@granite-js/utils": "2.2.0",
     "@standard-schema/spec": "^1.0.0"
   },
   "peerDependencies": {
@@ -72,8 +72,8 @@
   },
   "devDependencies": {
     "@babel/types": "7.28.5",
-    "@granite-js/plugin-core": "2.1.1",
-    "@granite-js/react-native": "2.1.1",
+    "@granite-js/plugin-core": "2.2.0",
+    "@granite-js/react-native": "2.2.0",
     "@types/babel__core": "^7.20.5",
     "@types/node": "24.10.12",
     "@types/react": "19.2.0",

package/src/createMicroFrontendRuntime.ts

@@ -3,10 +3,11 @@ import { createMicroFrontendRuntimeWithDependencies } from './runtime/createMicr
 import { parseNativeRuntimeEvent } from './runtime/parseNativeRuntimeEvent';
 import { microFrontendModuleRegistry } from './runtime/registry';
 import NativeGraniteMicroFrontendRuntime from './specs/NativeGraniteMicroFrontendRuntime';
-import type { MicroFrontendAdapter, MicroFrontendRuntimeApi } from './types';
+import type { MicroFrontendAdapter, MicroFrontendLifecycleCallback, MicroFrontendRuntimeApi } from './types';
 
 export interface CreateMicroFrontendRuntimeOptions {
   readonly adapter: MicroFrontendAdapter;
+  readonly onLifecycleEvent?: MicroFrontendLifecycleCallback;
   readonly onPreloadError?: (error: unknown) => void;
 }
 
@@ -14,6 +15,7 @@ export function createMicroFrontendRuntime(options: CreateMicroFrontendRuntimeOp
   return createMicroFrontendRuntimeWithDependencies({
     adapter: options.adapter,
     nativeRuntime: NativeGraniteMicroFrontendRuntime,
+    onLifecycleEvent: options.onLifecycleEvent,
     onPreloadError: options.onPreloadError ?? (() => undefined),
     parseEvent: parseNativeRuntimeEvent,
     registry: microFrontendModuleRegistry,

package/src/index.ts

@@ -44,6 +44,9 @@ export type {
   MicroFrontendAdapter,
   MicroFrontendBundle,
   MicroFrontendBundleRequest,
+  MicroFrontendLifecycleCallback,
+  MicroFrontendLifecycleEvent,
+  MicroFrontendLifecycleSession,
   MicroFrontendRuntimeApi,
   MicroFrontendRuntimeEvent,
   MicroFrontendRuntimeEventSubscription,

package/src/runtime/createMicroFrontendRuntime.ts

@@ -1,12 +1,14 @@
 import type {
   AppRequest,
   MicroFrontendAdapter,
+  MicroFrontendLifecycleEvent,
   MicroFrontendRuntimeApi,
   MicroFrontendRuntimeEvent,
   MicroFrontendRuntimeEventSubscription,
 } from '../types';
 import { AppContainerNotFoundError, InvalidAppNameError } from './errors';
 import { getMicroFrontendGlobalContext } from './globalContext';
+import { setMicroFrontendLifecycleCallback } from './lifecycle';
 import { installNativeComponentRegistryCompatibility } from './nativeComponentRegistryCompatibility';
 import { parseAppRequest } from './parseAppRequest';
 
@@ -38,6 +40,7 @@ export interface CreateMicroFrontendRuntimeDependencies {
   readonly adapter: MicroFrontendAdapter;
   readonly nativeRuntime: NativeMicroFrontendRuntime;
   readonly onPreloadError: (error: unknown) => void;
+  readonly onLifecycleEvent?: (event: MicroFrontendLifecycleEvent) => void;
   readonly registry: MicroFrontendModuleRegistry;
   readonly removePendingHostComponentRoutes: (appName: string) => void;
   readonly parseEvent: (event: NativeMicroFrontendRuntimeEvent) => MicroFrontendRuntimeEvent;
@@ -90,7 +93,7 @@ export function createMicroFrontendRuntimeWithDependencies(
     }
   }
 
-  return {
+  const runtime: MicroFrontendRuntimeApi = {
     evaluateScript,
     preloadApp,
     async importApp<TModule>(request: AppRequest): Promise<TModule> {
@@ -120,4 +123,8 @@ export function createMicroFrontendRuntimeWithDependencies(
       return subscription;
     },
   };
+
+  setMicroFrontendLifecycleCallback(runtime, dependencies.onLifecycleEvent);
+
+  return runtime;
 }

package/src/runtime/lifecycle.ts

@@ -0,0 +1,28 @@
+import type { MicroFrontendLifecycleEvent } from '../types';
+
+const lifecycleCallbackByRuntime = new WeakMap<object, (event: MicroFrontendLifecycleEvent) => void>();
+
+export function setMicroFrontendLifecycleCallback(
+  runtime: object,
+  callback: ((event: MicroFrontendLifecycleEvent) => void) | undefined
+): void {
+  if (callback == null) {
+    lifecycleCallbackByRuntime.delete(runtime);
+    return;
+  }
+
+  lifecycleCallbackByRuntime.set(runtime, callback);
+}
+
+export function emitMicroFrontendLifecycleEvent(runtime: object, event: MicroFrontendLifecycleEvent): void {
+  const callback = lifecycleCallbackByRuntime.get(runtime);
+  if (callback == null) {
+    return;
+  }
+
+  try {
+    callback(event);
+  } catch (error) {
+    console.error('Failed to run a micro-frontend lifecycle callback', error);
+  }
+}

package/src/session/useMicroFrontendSessions.ts

@@ -1,7 +1,13 @@
 import { useEffect, useLayoutEffect, useReducer, useRef } from 'react';
 import { installPendingHostComponentBridge, resetPendingHostComponent } from '../host/pendingHostComponentStore';
+import { emitMicroFrontendLifecycleEvent } from '../runtime/lifecycle';
 import { disposeAppResources } from '../runtime/registry';
-import type { MicroFrontendRuntimeApi, MicroFrontendSessionEvent } from '../types';
+import type {
+  MicroFrontendLifecycleEvent,
+  MicroFrontendLifecycleSession,
+  MicroFrontendRuntimeApi,
+  MicroFrontendSessionEvent,
+} from '../types';
 
 export interface MicroFrontendSessionState {
   readonly appName: string;
@@ -53,19 +59,46 @@ export function useMicroFrontendSessions(
     previousSessionsRef.current = sessions;
     const activeSessionIds = new Set(sessions.map(({ sessionId }) => sessionId));
     const activeAppNames = new Set(sessions.map(({ appName }) => appName));
+    const mountedSessions = sessions.filter(
+      ({ sessionId }) => !previousSessions.some((previousSession) => previousSession.sessionId === sessionId)
+    );
+    const inactiveSessions = previousSessions.filter(({ sessionId }) => !activeSessionIds.has(sessionId));
     const inactiveAppNames = new Set(
-      previousSessions
-        .filter(({ sessionId }) => !activeSessionIds.has(sessionId))
-        .map(({ appName }) => appName)
-        .filter((appName) => !activeAppNames.has(appName))
+      inactiveSessions.map(({ appName }) => appName).filter((appName) => !activeAppNames.has(appName))
+    );
+
+    mountedSessions.forEach((session) => {
+      emitMicroFrontendLifecycleEvent(runtime, createLifecycleEvent('mounted', session, sessions));
+    });
+
+    const appDisposals = new Map<string, Promise<void>>(
+      Array.from(
+        inactiveAppNames,
+        (appName) =>
+          [
+            appName,
+            disposeAppResources(appName).catch((error) => {
+              console.error(`Failed to dispose micro-frontend app resources for '${appName}'`, error);
+            }),
+          ] as const
+      )
     );
 
-    inactiveAppNames.forEach((appName) => {
-      void disposeAppResources(appName).catch((error) => {
-        console.error(`Failed to dispose micro-frontend app resources for '${appName}'`, error);
+    inactiveSessions.forEach((session) => {
+      const appDisposal = appDisposals.get(session.appName);
+      if (appDisposal == null) {
+        emitMicroFrontendLifecycleEvent(runtime, createLifecycleEvent('unmounted', session, sessions));
+        return;
+      }
+
+      void appDisposal.then(() => {
+        emitMicroFrontendLifecycleEvent(
+          runtime,
+          createLifecycleEvent('unmounted', session, previousSessionsRef.current)
+        );
       });
     });
-  }, [sessions]);
+  }, [runtime, sessions]);
 
   useLayoutEffect(() => {
     installPendingHostComponentBridge();
@@ -81,3 +114,22 @@ export function useMicroFrontendSessions(
 
   return sessions;
 }
+
+function createLifecycleEvent(
+  phase: MicroFrontendLifecycleEvent['phase'],
+  session: MicroFrontendSessionState,
+  activeSessions: readonly MicroFrontendSessionState[]
+): MicroFrontendLifecycleEvent {
+  return {
+    phase,
+    session: toLifecycleSession(session),
+    activeSessions: activeSessions.map(toLifecycleSession),
+  };
+}
+
+function toLifecycleSession(session: MicroFrontendSessionState): MicroFrontendLifecycleSession {
+  return {
+    appName: session.appName,
+    id: session.sessionId,
+  };
+}

package/src/types.ts

@@ -47,6 +47,20 @@ export interface MicroFrontendRuntimeEventSubscription {
   readonly remove: () => void;
 }
 
+export interface MicroFrontendLifecycleSession {
+  readonly appName: string;
+  readonly id: string;
+}
+
+export interface MicroFrontendLifecycleEvent {
+  readonly phase: 'mounted' | 'unmounted';
+  readonly session: MicroFrontendLifecycleSession;
+  /** Active sessions across every app when the callback is emitted. */
+  readonly activeSessions: readonly MicroFrontendLifecycleSession[];
+}
+
+export type MicroFrontendLifecycleCallback = (event: MicroFrontendLifecycleEvent) => void;
+
 export interface MicroFrontendRuntimeApi {
   readonly evaluateScript: (filePath: string) => Promise<void>;
   readonly preloadApp: (appName: string) => Promise<void>;