@equinor/fusion-framework-plugin-context-navigation 0.1.0 → 0.1.2

package/dist/esm/apply-navigation.js

@@ -0,0 +1,102 @@
+import { normalizePathFromURL } from './helpers';
+/**
+ * Apply a context-driven navigation if the adapter produces a different URL.
+ *
+ * This is the single codepath through which all plugin-initiated navigations flow.
+ * It performs four steps in sequence:
+ *
+ * 1. **Encode** — asks the adapter to produce a target URL from the active context.
+ * 2. **Compare** — skips if the target matches the current URL (no-op guard).
+ * 3. **Dispatch** — fires a cancelable `onContextNavigationNavigate` event so
+ *    external listeners can veto or observe the transition.
+ * 4. **Navigate** — performs the actual URL transition and records an own-nav token
+ *    so the URL guard knows to ignore the resulting navigation state change.
+ *
+ * @param payload - The navigation target details (app, adapter, context, URL).
+ * @param deps - Shared plugin dependencies (event bus, navigation provider, config).
+ * @param navOptionsOverride - Optional navigation options that override
+ *   `config.navigationOptions` for this specific call. Used by app-switch
+ *   reconciliation and URL-drift correction, which must always replace the
+ *   current history entry regardless of the user's `replace` setting.
+ * @returns A promise that resolves after the transition is handled in this
+ *   function (applied or skipped). It does not wait for browser-level
+ *   navigation completion.
+ */
+export async function applyNavigation(payload, deps, navOptionsOverride) {
+    const { appKey, appModules, adapter, context, currentURL } = payload;
+    const { event, navigation, config, eventSource, ownNavTokens, log } = deps;
+    // Step 1: Ask the adapter to produce the target URL for the given context.
+    // A null return means the adapter intentionally declines to navigate (e.g.
+    // context type not supported by this adapter's URL scheme).
+    const targetURL = adapter.encode({ context, currentURL });
+    // If the adapter returned null, skip navigation and log the reason.
+    if (!targetURL) {
+        event.dispatchEvent('onContextNavigationSkipped', {
+            detail: { appKey, reason: 'encode-returned-null' },
+            source: eventSource,
+        });
+        log(`Adapter [${adapter.id}] returned null for [${appKey}] — skipping.`);
+        return Promise.resolve();
+    }
+    // Step 2: Compare normalized paths to avoid redundant navigations.
+    // This prevents a replace() call when the URL is already correct, which
+    // would otherwise create a spurious history entry in some browsers.
+    if (normalizePathFromURL(targetURL) === normalizePathFromURL(currentURL)) {
+        event.dispatchEvent('onContextNavigationSkipped', {
+            detail: { appKey, reason: 'url-matches' },
+            source: eventSource,
+        });
+        log(`URL already correct for [${appKey}] — skipping.`);
+        return Promise.resolve();
+    }
+    // Step 3: Dispatch a cancelable event so external code can inspect or veto.
+    const navigateDetail = {
+        appKey,
+        adapterId: adapter.id,
+        targetURL,
+        sourceURL: currentURL,
+        context,
+        appModules,
+    };
+    return event
+        .dispatchEvent('onContextNavigationNavigate', {
+        detail: navigateDetail,
+        source: eventSource,
+        cancelable: true,
+    })
+        .then((ev) => {
+        // If any listener called event.preventDefault(), abort navigation.
+        if (ev.canceled) {
+            event.dispatchEvent('onContextNavigationSkipped', {
+                detail: { appKey, reason: 'canceled' },
+                source: eventSource,
+            });
+            log(`Navigation canceled for [${appKey}].`);
+            return;
+        }
+        // Step 4: Record the token BEFORE navigating so the guard sees it
+        // on the resulting state$ emission and skips re-processing.
+        ownNavTokens.add(normalizePathFromURL(targetURL));
+        navigation.navigate(targetURL, navOptionsOverride ?? config.navigationOptions);
+        // Post-navigation bookkeeping: notify listeners and invoke callback.
+        const navigatedDetail = {
+            appKey,
+            adapterId: adapter.id,
+            targetURL,
+            context,
+            appModules,
+        };
+        event.dispatchEvent('onContextNavigationNavigated', {
+            detail: navigatedDetail,
+            source: eventSource,
+        });
+        config.onTransition?.(navigatedDetail);
+        log(`Navigated [${appKey}]: ${currentURL.pathname}${currentURL.search} → ${targetURL.pathname}${targetURL.search}`);
+    })
+        .catch((err) => {
+        // Swallow dispatch/navigation errors to avoid unhandled rejections.
+        // Logging ensures failures are observable during development.
+        log(`Navigation dispatch failed for [${appKey}]: ${String(err)}`);
+    });
+}
+//# sourceMappingURL=apply-navigation.js.map

package/dist/esm/apply-navigation.js.map

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

package/dist/esm/constants/context-query-param-key.js

@@ -0,0 +1,8 @@
+/**
+ * Query-parameter key used to carry the context id in query-routing mode.
+ *
+ * The `$` prefix is a Fusion convention that namespaces framework-managed
+ * parameters, distinguishing them from app-specific query params.
+ */
+export const CONTEXT_QUERY_PARAM_KEY = '$contextId';
+//# sourceMappingURL=context-query-param-key.js.map

package/dist/esm/constants/context-query-param-key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-query-param-key.js","sourceRoot":"","sources":["../../../src/constants/context-query-param-key.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,YAAY,CAAC"}

package/dist/esm/constants/index.js

@@ -0,0 +1,3 @@
+export { CONTEXT_QUERY_PARAM_KEY } from './context-query-param-key';
+export { UUID_PATTERN } from './uuid-pattern';
+//# sourceMappingURL=index.js.map

package/dist/esm/constants/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/constants/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/esm/constants/uuid-pattern.js

@@ -0,0 +1,8 @@
+/**
+ * Regex matching a standard UUID (v4 format, case-insensitive).
+ *
+ * Used to identify whether a path segment is a context id vs. a route name.
+ * Context ids in Fusion are always UUIDs, so this is a reliable discriminator.
+ */
+export const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+//# sourceMappingURL=uuid-pattern.js.map

package/dist/esm/constants/uuid-pattern.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uuid-pattern.js","sourceRoot":"","sources":["../../../src/constants/uuid-pattern.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,iEAAiE,CAAC"}

package/dist/esm/create-context-navigation-plugin.js

@@ -0,0 +1,124 @@
+import { Subscription, startWith, pairwise, map } from 'rxjs';
+import { getCurrentURL, resolveAdapter } from './helpers';
+import { activeAppNavigationEvents } from './operators/active-app-navigation-events';
+import { consumeOwnNavToken, handlePushModeGuard, handleReplaceModeGuard, isInAppScope, } from './guard-handlers';
+import { reconcile } from './reconcile';
+import { version } from './version';
+/** Event source token forwarded to all dispatched events. */
+const eventSource = { name: 'contextNavigation', version };
+// ── Plugin factory ────────────────────────────────────────────────────
+/**
+ * Creates the context-navigation plugin runtime.
+ *
+ * Sets up two subscriptions:
+ *
+ * **Reconciler** — watches the portal context and app switches via the configured
+ * source factory. On each emission it encodes the active context into the app URL
+ * using the first matching adapter.
+ *
+ * **URL guard** — watches browser navigation state and detects when the URL no
+ * longer reflects the active context. Behavior depends on `navigationOptions.replace`:
+ *
+ * - `replace: true` (default) — each context change replaces the current history entry,
+ *   so there is no meaningful back/forward stack within the context history. If the URL
+ *   diverges from the active context (e.g. an external redirect stripped the context
+ *   segment), the guard re-asserts the active context into the URL.
+ *
+ * - `replace: false` (push mode) — each context change pushes a new history entry, so
+ *   back/forward navigations legitimately land on URLs with different context IDs. The
+ *   guard detects this and drives context from the URL instead of overwriting it,
+ *   keeping the browser history and context state in sync.
+ *
+ * @param args - Initialized module providers and resolved plugin config.
+ * @returns A teardown function compatible with {@link FrameworkPluginTeardown}.
+ */
+export function createContextNavigationPlugin(args) {
+    const { app, navigation, context, event, config } = args;
+    // Aggregate subscription — all plugin-owned subscriptions are collected here
+    // so the teardown function can unsubscribe from everything in one call.
+    const subscriptions = new Subscription();
+    // Token set used to distinguish plugin-initiated navigations from user-initiated ones.
+    // The guard reads and consumes tokens; the reconciler and applyNavigation write them.
+    const ownNavTokens = new Set();
+    // Conditional debug logger scoped to this plugin instance.
+    const log = (msg) => {
+        // Only log debug messages if debug mode is enabled in config.
+        if (config.debug) {
+            console.debug(`[${config.portalName}] ContextNavigation: ${msg}`);
+        }
+    };
+    // Dependency bag shared across reconcile, applyNavigation, and guard handlers.
+    // Avoids passing individual arguments and keeps function signatures stable.
+    const deps = { event, navigation, config, eventSource, ownNavTokens, log };
+    // ── Reconciler subscription ─────────────────────────────────────
+    // The source$ observable is created by the configured sourceFactory.
+    // It emits whenever the active context or app changes (implementation-specific).
+    // Each emission triggers reconcile(), which resolves an adapter and navigates.
+    const source$ = config.sourceFactory({ app, context, navigation });
+    // Emit [null, firstEntry] on first emission, then [prevEntry, currEntry] thereafter.
+    // Map pairs to object with entry and isAppSwitch flag for reconciler.
+    subscriptions.add(source$
+        .pipe(startWith(null), pairwise(), map(([prev, entry]) => ({
+        entry: entry,
+        isAppSwitch: prev != null && prev.appKey !== entry.appKey,
+    })))
+        .subscribe(({ entry, isAppSwitch }) => {
+        reconcile(entry, deps, { isAppSwitch });
+    }));
+    // ── URL guard subscription (optional) ───────────────────────────
+    // When enabled, the guard monitors every browser navigation event to detect
+    // URL/context drift. It fires after the reconciler has already handled
+    // context changes, so its role is corrective, not primary.
+    if (config.enableUrlGuard) {
+        // Guard needs the context provider to drive context from URL in push mode.
+        const guardDeps = { ...deps, context };
+        subscriptions.add(
+        // activeAppNavigationEvents$ emits the current app key and modules
+        // on every navigation state change, filtering out null/unresolved states.
+        activeAppNavigationEvents(app, navigation).subscribe(({ appModules, appKey, routingStrategy }) => {
+            const appContext = appModules.context;
+            // No active context means nothing to guard — bail early.
+            if (!appContext?.currentContext) {
+                return;
+            }
+            const currentURL = getCurrentURL(navigation, config.origin);
+            // Scope check: only guard URLs that belong to this app's path namespace.
+            // Navigations to other apps or external paths are not our responsibility.
+            if (!isInAppScope(currentURL, appKey)) {
+                return;
+            }
+            // Own-navigation check: if this URL was navigated to by the plugin itself,
+            // consume the token and skip — prevents infinite reconcile/guard loops.
+            if (consumeOwnNavToken(currentURL, ownNavTokens)) {
+                return;
+            }
+            // Resolve the adapter for this app/URL combination.
+            // If no adapter matches, the URL format is unknown — we can't guard it.
+            const adapter = resolveAdapter({ appKey, appContext, routingStrategy, currentURL }, config.adapters);
+            // No matching adapter means we can't decode the URL — bail out.
+            if (!adapter) {
+                return;
+            }
+            const activeContext = appContext.currentContext;
+            const urlContextId = adapter.decode(currentURL);
+            // If the URL already encodes the active context, state is in sync — done.
+            if (urlContextId === activeContext.id) {
+                return;
+            }
+            // Decision branch: push mode vs replace mode determines how we reconcile drift.
+            if (urlContextId !== null && config.navigationOptions?.replace === false) {
+                // Push mode: URL has a different context ID, meaning the user navigated
+                // via browser back/forward. Drive context FROM the URL to stay in sync.
+                handlePushModeGuard(urlContextId, { appKey, appModules, routingStrategy }, currentURL, guardDeps);
+                return;
+            }
+            // Replace mode (default): URL diverged from active context (external redirect,
+            // stripped segment, etc.). Re-assert the active context INTO the URL.
+            handleReplaceModeGuard({ appKey, appModules, routingStrategy }, currentURL, guardDeps);
+        }));
+    }
+    // Return a teardown function that unsubscribes from all plugin subscriptions.
+    // Called by the framework when the plugin is disposed (app unmount or hot-reload).
+    return () => subscriptions.unsubscribe();
+}
+//# sourceMappingURL=create-context-navigation-plugin.js.map

package/dist/esm/create-context-navigation-plugin.js.map

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

package/dist/esm/enable-context-navigation.js

@@ -0,0 +1,40 @@
+import { createPlugin } from '@equinor/fusion-framework-module/configurator';
+import { ContextNavigationConfigurator } from './ContextNavigationConfigurator';
+import { createContextNavigationPlugin } from './create-context-navigation-plugin';
+/**
+ * Registers the event-driven context-to-URL reconciler plugin for a portal.
+ *
+ * @example
+ * ```ts
+ * // Minimal — all defaults (built-in adapters: custom > query > path)
+ * enableContextNavigation(configurator);
+ *
+ * // With custom adapter
+ * enableContextNavigation(configurator, (builder) => {
+ *   builder.setPortalName('my-portal');
+ *   builder.setDebug(true);
+ *   builder.registerAdapter(myHashAdapter);
+ * });
+ * ```
+ */
+export const enableContextNavigation = (
+// biome-ignore lint/suspicious/noExplicitAny: must be any to support all module types
+configurator, builder) => {
+    configurator.registerPlugin(createPlugin('contextNavigation', async (modules) => {
+        const contextNavigationConfigurator = new ContextNavigationConfigurator();
+        await builder?.(contextNavigationConfigurator);
+        const config = contextNavigationConfigurator.createConfig();
+        await config.resolveInitialContext?.({
+            context: modules.context,
+            navigation: modules.navigation,
+        });
+        return createContextNavigationPlugin({
+            app: modules.app,
+            navigation: modules.navigation,
+            context: modules.context,
+            event: modules.event,
+            config,
+        });
+    }));
+};
+//# sourceMappingURL=enable-context-navigation.js.map

package/dist/esm/enable-context-navigation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enable-context-navigation.js","sourceRoot":"","sources":["../../src/enable-context-navigation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAK7E,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,EAAE,6BAA6B,EAAE,MAAM,oCAAoC,CAAC;AAQnF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;AACrC,sFAAsF;AACtF,YAA4C,EAC5C,OAAkC,EAC5B,EAAE;IACR,YAAY,CAAC,cAAc,CACzB,YAAY,CAAC,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;QAClD,MAAM,6BAA6B,GAAG,IAAI,6BAA6B,EAAE,CAAC;QAE1E,MAAM,OAAO,EAAE,CAAC,6BAA6B,CAAC,CAAC;QAE/C,MAAM,MAAM,GAAG,6BAA6B,CAAC,YAAY,EAAE,CAAC;QAE5D,MAAM,MAAM,CAAC,qBAAqB,EAAE,CAAC;YACnC,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,UAAU,EAAE,OAAO,CAAC,UAAU;SAC/B,CAAC,CAAC;QAEH,OAAO,6BAA6B,CAAC;YACnC,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,UAAU,EAAE,OAAO,CAAC,UAAU;YAC9B,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CACH,CAAC;AACJ,CAAC,CAAC"}

package/dist/esm/events.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=events.js.map

package/dist/esm/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../../src/events.ts"],"names":[],"mappings":""}

package/dist/esm/guard-handlers/consume-own-nav-token.js

@@ -0,0 +1,29 @@
+import { normalizePathFromURL } from '../helpers';
+/**
+ * Consume an own-navigation token if the current URL matches one previously
+ * navigated to by the plugin itself.
+ *
+ * Intent: prevent infinite loops between the reconciler and the guard.
+ * When the reconciler calls `applyNavigation`, it records the target path as a
+ * token. The next `navigation.state$` emission triggers the guard, which would
+ * otherwise see a "new" URL and try to reconcile again. By checking and consuming
+ * the token here, the guard knows this URL change was self-initiated and bails.
+ *
+ * Each token is consumed (deleted from the set) exactly once. This ensures that
+ * a subsequent user-initiated back/forward navigation to the same path IS
+ * processed by the guard, since the token will no longer be present.
+ *
+ * @param currentURL - The current browser URL to check against known tokens.
+ * @param ownNavTokens - The set of normalized paths the plugin has navigated to.
+ * @returns `true` if this navigation was plugin-initiated (caller should bail).
+ */
+export function consumeOwnNavToken(currentURL, ownNavTokens) {
+    const normalized = normalizePathFromURL(currentURL);
+    // Token present — this navigation was plugin-initiated; consume it and signal the caller to bail.
+    if (ownNavTokens.has(normalized)) {
+        ownNavTokens.delete(normalized);
+        return true;
+    }
+    return false;
+}
+//# sourceMappingURL=consume-own-nav-token.js.map

package/dist/esm/guard-handlers/consume-own-nav-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consume-own-nav-token.js","sourceRoot":"","sources":["../../../src/guard-handlers/consume-own-nav-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAGlD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAAe,EAAE,YAAiC;IACnF,MAAM,UAAU,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAEpD,kGAAkG;IAClG,IAAI,YAAY,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;QACjC,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/esm/guard-handlers/guard-tick-deps.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guard-tick-deps.js.map

package/dist/esm/guard-handlers/guard-tick-deps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-tick-deps.js","sourceRoot":"","sources":["../../../src/guard-handlers/guard-tick-deps.ts"],"names":[],"mappings":""}

package/dist/esm/guard-handlers/guard-tick-payload.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=guard-tick-payload.js.map

package/dist/esm/guard-handlers/guard-tick-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guard-tick-payload.js","sourceRoot":"","sources":["../../../src/guard-handlers/guard-tick-payload.ts"],"names":[],"mappings":""}

package/dist/esm/guard-handlers/handle-push-mode-guard.js

@@ -0,0 +1,44 @@
+import { applyNavigation } from '../apply-navigation';
+import { resolveAdapter } from '../helpers';
+/**
+ * Handle a URL guard tick in **push mode** (`navigationOptions.replace: false`).
+ *
+ * Intent: keep browser history and context state bidirectionally in sync.
+ *
+ * In push mode, each context change pushes a new history entry, so back/forward
+ * navigations legitimately land on URLs with different context IDs. When the guard
+ * detects a URL containing a context ID that differs from the active context, it
+ * interprets this as the user having navigated through history and drives context
+ * FROM the URL (rather than overwriting the URL).
+ *
+ * If the URL's context ID can't be resolved (stale bookmark, deleted context),
+ * the function falls back to re-asserting the active context into the URL so the
+ * address bar isn't left pointing at a broken resource.
+ *
+ * @param urlContextId - The context ID decoded from the current URL by the adapter.
+ * @param payload - The active app key and resolved modules.
+ * @param currentURL - The current browser URL.
+ * @param deps - Shared plugin dependencies including the context provider.
+ */
+export function handlePushModeGuard(urlContextId, payload, currentURL, deps) {
+    const { appKey, appModules, routingStrategy } = payload;
+    const { context, log } = deps;
+    // Resolve the active context and adapter — both are required to fall back.
+    const activeContext = appModules.context.currentContext;
+    // No active context to fall back to — nothing to do.
+    if (!activeContext) {
+        return;
+    }
+    const adapter = resolveAdapter({ appKey, appContext: appModules.context, routingStrategy, currentURL }, deps.config.adapters);
+    // No adapter matched — plugin is not responsible for this app's URL shape.
+    if (!adapter) {
+        return;
+    }
+    log(`URL guard: URL has context [${urlContextId}] for [${appKey}] — setting context from URL`);
+    // Attempt to set context from the URL-decoded ID.
+    // On failure (e.g. context deleted), fall back to re-encoding the active context.
+    context.setCurrentContextByIdAsync(urlContextId).catch(() => {
+        applyNavigation({ appKey, appModules, adapter, context: activeContext, currentURL }, deps);
+    });
+}
+//# sourceMappingURL=handle-push-mode-guard.js.map

package/dist/esm/guard-handlers/handle-push-mode-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-push-mode-guard.js","sourceRoot":"","sources":["../../../src/guard-handlers/handle-push-mode-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CACjC,YAAoB,EACpB,OAAyB,EACzB,UAAe,EACf,IAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAE9B,2EAA2E;IAC3E,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC;IAExD,qDAAqD;IACrD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAC5B,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,EACvE,IAAI,CAAC,MAAM,CAAC,QAAQ,CACrB,CAAC;IAEF,2EAA2E;IAC3E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,GAAG,CAAC,+BAA+B,YAAY,UAAU,MAAM,8BAA8B,CAAC,CAAC;IAE/F,kDAAkD;IAClD,kFAAkF;IAClF,OAAO,CAAC,0BAA0B,CAAC,YAAY,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAC1D,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7F,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/guard-handlers/handle-replace-mode-guard.js

@@ -0,0 +1,40 @@
+import { applyNavigation } from '../apply-navigation';
+import { resolveAdapter } from '../helpers';
+/**
+ * Handle a URL guard tick in **replace mode** (`navigationOptions.replace: true`, the default).
+ *
+ * Intent: correct URL drift caused by external interference.
+ *
+ * In replace mode, context changes replace the current history entry, so there is
+ * no meaningful back/forward stack within the context history. A URL mismatch
+ * therefore means something external mutated the URL (a redirect, a router
+ * guard stripping segments, etc.). The fix is to re-assert the active context
+ * back into the URL, restoring the canonical app path.
+ *
+ * @param payload - The active app key and resolved modules.
+ * @param currentURL - The current browser URL that diverged from the active context.
+ * @param deps - Shared plugin dependencies.
+ */
+export function handleReplaceModeGuard(payload, currentURL, deps) {
+    const { appKey, appModules, routingStrategy } = payload;
+    const { log } = deps;
+    // Resolve the active context and adapter for re-encoding.
+    const activeContext = appModules.context.currentContext;
+    // No active context to re-encode — nothing to correct.
+    if (!activeContext) {
+        return;
+    }
+    const adapter = resolveAdapter({ appKey, appContext: appModules.context, routingStrategy, currentURL }, deps.config.adapters);
+    // No adapter matched — plugin is not responsible for this app's URL shape.
+    if (!adapter) {
+        return;
+    }
+    log(`URL guard: context missing from URL, re-applying for [${appKey}]`);
+    // Always replace when correcting URL drift. The URL has no context segment
+    // (e.g. a bare app route the portal pushed), so we fix it in-place. Using
+    // push here would create an extra history entry that traps Back navigation.
+    applyNavigation({ appKey, appModules, adapter, context: activeContext, currentURL }, deps, {
+        replace: true,
+    });
+}
+//# sourceMappingURL=handle-replace-mode-guard.js.map

package/dist/esm/guard-handlers/handle-replace-mode-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle-replace-mode-guard.js","sourceRoot":"","sources":["../../../src/guard-handlers/handle-replace-mode-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,sBAAsB,CACpC,OAAyB,EACzB,UAAe,EACf,IAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;IAErB,0DAA0D;IAC1D,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,cAAc,CAAC;IAExD,uDAAuD;IACvD,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;IACT,CAAC;IAED,MAAM,OAAO,GAAG,cAAc,CAC5B,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,EACvE,IAAI,CAAC,MAAM,CAAC,QAAQ,CACrB,CAAC;IAEF,2EAA2E;IAC3E,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO;IACT,CAAC;IAED,GAAG,CAAC,yDAAyD,MAAM,GAAG,CAAC,CAAC;IACxE,2EAA2E;IAC3E,0EAA0E;IAC1E,4EAA4E;IAC5E,eAAe,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE;QACzF,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/guard-handlers/index.js

@@ -0,0 +1,5 @@
+export { isInAppScope } from './is-in-app-scope';
+export { consumeOwnNavToken } from './consume-own-nav-token';
+export { handlePushModeGuard } from './handle-push-mode-guard';
+export { handleReplaceModeGuard } from './handle-replace-mode-guard';
+//# sourceMappingURL=index.js.map

package/dist/esm/guard-handlers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/guard-handlers/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/esm/guard-handlers/is-in-app-scope.js

@@ -0,0 +1,19 @@
+/**
+ * Determine whether the current URL falls within the active app's path namespace.
+ *
+ * The plugin must only guard URLs that belong to its own app. Navigations to
+ * other apps or external paths should be ignored entirely — they are another
+ * app instance's responsibility.
+ *
+ * Convention: all app URLs live under `/apps/{appKey}` or `/apps/{appKey}/...`.
+ *
+ * @param currentURL - The current browser URL to check.
+ * @param appKey - The app key used to derive the expected base path.
+ * @returns `true` if the URL belongs to this app's scope.
+ */
+export function isInAppScope(currentURL, appKey) {
+    const appBase = `/apps/${appKey}`;
+    // Exact match (app root) or path-segment-prefixed (app sub-route).
+    return currentURL.pathname === appBase || currentURL.pathname.startsWith(`${appBase}/`);
+}
+//# sourceMappingURL=is-in-app-scope.js.map

package/dist/esm/guard-handlers/is-in-app-scope.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-in-app-scope.js","sourceRoot":"","sources":["../../../src/guard-handlers/is-in-app-scope.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,UAAe,EAAE,MAAc;IAC1D,MAAM,OAAO,GAAG,SAAS,MAAM,EAAE,CAAC;IAClC,mEAAmE;IACnE,OAAO,UAAU,CAAC,QAAQ,KAAK,OAAO,IAAI,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,OAAO,GAAG,CAAC,CAAC;AAC1F,CAAC"}

package/dist/esm/helpers/get-current-url.js

@@ -0,0 +1,11 @@
+/**
+ * Construct the current browser URL from the navigation provider's state.
+ *
+ * @param navigation - The navigation provider (for reading pathname and search).
+ * @param origin - The origin used to construct an absolute URL.
+ * @returns An absolute URL representing the current browser location.
+ */
+export function getCurrentURL(navigation, origin) {
+    return new URL(`${navigation.path.pathname}${navigation.path.search ?? ''}`, origin);
+}
+//# sourceMappingURL=get-current-url.js.map

package/dist/esm/helpers/get-current-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-current-url.js","sourceRoot":"","sources":["../../../src/helpers/get-current-url.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,UAA+B,EAAE,MAAc;IAC3E,OAAO,IAAI,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;AACvF,CAAC"}

package/dist/esm/helpers/index.js

@@ -0,0 +1,6 @@
+export { normalizePathFromURL } from './normalize-path-from-url';
+export { normalizePath } from './normalize-path';
+export { getCurrentURL } from './get-current-url';
+export { resolveAdapter } from './resolve-adapter';
+export { stripQueryParams } from './strip-query-params';
+//# sourceMappingURL=index.js.map

package/dist/esm/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/esm/helpers/normalize-path-from-url.js

@@ -0,0 +1,14 @@
+import { normalizePath } from './normalize-path';
+/**
+ * Normalize a URL to its path + search representation for comparison.
+ *
+ * Strips trailing slashes from the pathname so that `/apps/foo/` and
+ * `/apps/foo` compare as equal.
+ *
+ * @param url - The URL to normalize.
+ * @returns A string of the form `pathname + search` with trailing slash removed.
+ */
+export function normalizePathFromURL(url) {
+    return `${normalizePath(url.pathname)}${url.search}`;
+}
+//# sourceMappingURL=normalize-path-from-url.js.map

package/dist/esm/helpers/normalize-path-from-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-path-from-url.js","sourceRoot":"","sources":["../../../src/helpers/normalize-path-from-url.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB,CAAC,GAAQ;IAC3C,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;AACvD,CAAC"}

package/dist/esm/helpers/normalize-path.js

@@ -0,0 +1,30 @@
+/**
+ * Normalizes a path string to ensure it is in a consistent format for comparison and processing.
+ *
+ * This function performs the following normalizations:
+ * - Ensures the path starts with a leading slash.
+ * - Removes any trailing slashes, except for the root path ("/").
+ * - Converts empty paths to the root path ("/").
+ * - Fixing multiple consecutive slashes to a single slash.
+ *
+ * @param path - The path string to normalize.
+ * @returns The normalized path string.
+ */
+export function normalizePath(path) {
+    // Replace multiple consecutive slashes with a single slash
+    path = path.replace(/\/+/g, '/');
+    // Ensure the path starts with a leading slash
+    if (!path.startsWith('/')) {
+        path = `/${path}`;
+    }
+    // Remove trailing slashes, except for the root path
+    if (path.length > 1 && path.endsWith('/')) {
+        path = path.slice(0, -1);
+    }
+    // Convert empty paths to the root path
+    if (path === '') {
+        return '/';
+    }
+    return path;
+}
+//# sourceMappingURL=normalize-path.js.map

package/dist/esm/helpers/normalize-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize-path.js","sourceRoot":"","sources":["../../../src/helpers/normalize-path.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,2DAA2D;IAC3D,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAEjC,8CAA8C;IAC9C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;IACpB,CAAC;IAED,oDAAoD;IACpD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,uCAAuC;IACvC,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,OAAO,GAAG,CAAC;IACb,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/esm/helpers/resolve-adapter.js

@@ -0,0 +1,23 @@
+/**
+ * Iterate registered adapters and return the first one that can handle
+ * the given resolution context.
+ *
+ * - **Object adapters** are tested via `canHandle(ctx)`.
+ * - **Factory adapters** are invoked with `ctx`; a non-null return means match.
+ *
+ * @param ctx - The adapter resolution context (app key, app context, current URL).
+ * @param adapters - The registered adapters in evaluation order.
+ * @returns The first matching adapter, or `null` if none matched.
+ */
+export function resolveAdapter(ctx, adapters) {
+    // Iterate through adapters in order until one can handle the given context
+    for (const entry of adapters) {
+        const adapter = typeof entry === 'function' ? entry(ctx) : entry.canHandle(ctx) ? entry : null;
+        // Return the first adapter that can handle this context
+        if (adapter) {
+            return adapter;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=resolve-adapter.js.map

package/dist/esm/helpers/resolve-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-adapter.js","sourceRoot":"","sources":["../../../src/helpers/resolve-adapter.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAC5B,GAA6B,EAC7B,QAAkD;IAElD,2EAA2E;IAC3E,KAAK,MAAM,KAAK,IAAI,QAAQ,EAAE,CAAC;QAC7B,MAAM,OAAO,GAAG,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAC/F,wDAAwD;QACxD,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,OAAO,CAAC;QACjB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}