@kehto/shell 0.24.1 → 0.24.2

package/README.md

@@ -214,6 +214,16 @@ payload.
 - `originRegistry` — origin-to-windowId map used by proxies and bridge broadcasts
 - `PendingUpdate` — type for pending aggregate-hash change prompts
 
+Environment snapshots belong to one source registration. To retire a window,
+call `bridge.runtime.destroyWindow(windowId)`,
+`bridge.runtime.sessionRegistry.unregister(windowId)`, and
+`originRegistry.unregister(windowId)`. When registering a replacement under the
+same window ID, provide its snapshot with `originRegistry.setEnvironment()` or
+let the bridge call `resolveShellEnvironment()` for current host defaults. A
+retired registration's cached domains and service names are discarded even when
+the runtime session was already removed. This applies before any domain dispatch,
+including requests sent before the optional `shell.ready` exchange.
+
 ### Manifest cache
 - `manifestCache` — browser-specific manifest cache singleton
 - `ManifestCacheEntry` — manifest cache entry type

package/dist/index.js

@@ -1126,10 +1126,10 @@ function registerNip5dSessionIfNeeded({
   if (existing && previousRegistration === sourceRegistrationId) {
     return;
   }
+  state.environments.delete(windowId);
   if (existing && previousRegistration !== void 0) {
     runtime.destroyWindow(windowId);
     runtime.sessionRegistry.unregister(windowId);
-    state.environments.delete(windowId);
   }
   if (existing && previousRegistration === void 0) {
     state.sessionRegistration.set(windowId, sourceRegistrationId);