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

package/dist/esm/ContextNavigationConfigurator.js

@@ -0,0 +1,178 @@
+import { createPathAdapter } from './adapters/create-path-adapter';
+import { createQueryAdapter } from './adapters/create-query-adapter';
+import { createCustomAdapter } from './adapters/custom-adapter/create-custom-adapter';
+import { resolveContextFromUrl } from './utils/resolve-context-from-url';
+import { appFirstSource } from './sources/app-first-source';
+/**
+ * Resolves the default origin used for URL construction.
+ *
+ * Browser environments use `window.location.origin`. Non-browser environments
+ * fall back to a stable localhost origin so tests and SSR code can still build
+ * deterministic URLs.
+ *
+ * @returns The origin string used by the context-navigation plugin.
+ */
+const resolveDefaultOrigin = () => typeof window === 'undefined' ? 'http://localhost' : window.location.origin;
+/**
+ * Configurator for the context-navigation plugin.
+ *
+ * Provides a fluent builder API for portal developers.
+ * Adapters are registered with priority — the first adapter whose
+ * `canHandle()` returns `true` is used for navigation.
+ *
+ * @example
+ * ```ts
+ * enableContextNavigation(configurator, (builder) => {
+ *   builder.setPortalName('my-portal');
+ *   builder.setDebug(true);
+ *   // Custom adapters registered at higher priority override defaults
+ *   builder.registerAdapter(myHashAdapter);
+ * });
+ * ```
+ */
+export class ContextNavigationConfigurator {
+    #config = {};
+    #adapters = [];
+    /**
+     * Register a navigation adapter or adapter factory.
+     *
+     * - **Object** — a static adapter with `canHandle`, `encode`, `decode`.
+     * - **Function** — a factory called with the resolution context that
+     *   returns a bound adapter or `null` to skip.
+     *
+     * Adapters are evaluated in registration order. The first match wins.
+     *
+     * **Note:** Registering any adapter disables the built-in defaults
+     * (custom, query, path). Register all adapters you need explicitly.
+     *
+     * @param adapter - The adapter instance or factory function to register.
+     * @returns The configurator instance for chaining.
+     */
+    registerAdapter(adapter) {
+        this.#adapters.push(adapter);
+        return this;
+    }
+    /**
+     * Set the portal name used in debug output.
+     * @default 'Portal'
+     *
+     * @param name - The portal name to use in debug output.
+     * @returns The configurator instance for chaining.
+     */
+    setPortalName(name) {
+        this.#config.portalName = name;
+        return this;
+    }
+    /**
+     * Set the origin for constructing absolute URLs.
+     * @default window.location.origin
+     *
+     * @param origin - The origin string to use for URL construction.
+     * @returns The configurator instance for chaining.
+     */
+    setOrigin(origin) {
+        this.#config.origin = origin;
+        return this;
+    }
+    /**
+     * Enable or disable the URL guard.
+     * @default true
+     *
+     * @param enabled - Whether to enable the URL guard.
+     * @returns The configurator instance for chaining.
+     */
+    setUrlGuard(enabled) {
+        this.#config.enableUrlGuard = enabled;
+        return this;
+    }
+    /**
+     * Enable or disable verbose debug logging.
+     * @default false
+     *
+     * @param enabled - Whether to enable debug logging.
+     * @returns The configurator instance for chaining.
+     */
+    setDebug(enabled) {
+        this.#config.debug = enabled;
+        return this;
+    }
+    /**
+     * Set a function that computes the URL to navigate to when context is cleared.
+     *
+     * When set, the reconciler bypasses adapter encoding for null context
+     * and navigates directly to the returned URL. Use in context-portal where
+     * clearing context should return to the portal landing page.
+     *
+     * Accepts either a static string (shorthand) or a function that receives
+     * the current app key and URL for dynamic path construction.
+     *
+     * @param urlOrFn - A static path (e.g. `'/'`) or a function returning one.
+     * @returns The configurator instance for chaining.
+     */
+    setNullContextUrl(urlOrFn) {
+        this.#config.nullContextUrl = typeof urlOrFn === 'string' ? () => urlOrFn : urlOrFn;
+        return this;
+    }
+    /**
+     * Set a side-effect hook called after each successful navigation.
+     * @param fn - The callback function to invoke after navigation.
+     * @returns The configurator instance for chaining.
+     */
+    setOnTransition(fn) {
+        this.#config.onTransition = fn;
+        return this;
+    }
+    /**
+     * Set the options passed to `navigation.navigate()` during URL updates.
+     *
+     * @default { replace: true }
+     * @param options - The navigation options to use for URL updates.
+     * @returns The configurator instance for chaining.
+     * @see INavigationProvider.navigate
+     * @see ContextNavigationConfig.navigationOptions
+     */
+    setNavigationOptions(options) {
+        this.#config.navigationOptions = options;
+        return this;
+    }
+    /**
+     * Set the source factory that drives the reconciler's observable stream.
+     *
+     * @default createAppFirstSource()
+     * @param factory - The source factory to use for the reconciler.
+     * @returns The configurator instance for chaining.
+     * @see ReconcilerSourceFactory
+     * @see appFirstSource
+     * @see contextFirstSource
+     */
+    setSourceFactory(factory) {
+        this.#config.sourceFactory = factory;
+        return this;
+    }
+    /**
+     * Builds the resolved plugin configuration from the registered options.
+     *
+     * @returns The resolved configuration used by the context-navigation plugin.
+     */
+    createConfig() {
+        const origin = this.#config.origin ?? resolveDefaultOrigin();
+        // If user registered adapters, use those exclusively.
+        // Otherwise fall back to built-in defaults (custom → query → path).
+        const adapters = this.#adapters.length > 0
+            ? [...this.#adapters]
+            : [createCustomAdapter(), createQueryAdapter(), createPathAdapter()];
+        return {
+            portalName: this.#config.portalName ?? 'Portal',
+            origin,
+            enableUrlGuard: this.#config.enableUrlGuard ?? true,
+            debug: this.#config.debug ?? false,
+            nullContextUrl: this.#config.nullContextUrl,
+            onTransition: this.#config.onTransition,
+            navigationOptions: this.#config.navigationOptions ?? { replace: true },
+            sourceFactory: this.#config.sourceFactory ?? appFirstSource(),
+            resolveInitialContext: this.#config.resolveInitialContext ?? resolveContextFromUrl(adapters, origin),
+            adapters,
+        };
+    }
+}
+//# sourceMappingURL=ContextNavigationConfigurator.js.map

package/dist/esm/ContextNavigationConfigurator.js.map

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

package/dist/esm/__tests__/active-app-navigation-events.test.js

@@ -0,0 +1,115 @@
+import { BehaviorSubject, Subject } from 'rxjs';
+import { describe, expect, it } from 'vitest';
+import { activeAppNavigationEvents } from '../operators/active-app-navigation-events';
+describe('activeAppNavigationEvents$', () => {
+    it('emits when app, instance, and navigation state are all present', () => {
+        // Test double — only the context property is accessed by the operator under test
+        const appModules = { context: {} };
+        const navigationState$ = new Subject();
+        const currentApp$ = new BehaviorSubject({
+            appKey: 'my-app',
+            instance$: new BehaviorSubject(appModules),
+            manifest$: new BehaviorSubject(null),
+        });
+        // Test double — only current$ is read by the operator under test
+        const app = { current$: currentApp$ };
+        // Test double — only state$ is read by the operator under test
+        const navigation = {
+            state$: navigationState$,
+        };
+        const emissions = [];
+        const sub = activeAppNavigationEvents(app, navigation).subscribe((val) => emissions.push(val));
+        navigationState$.next({});
+        expect(emissions).toHaveLength(1);
+        expect(emissions[0]).toEqual({ appKey: 'my-app', appModules, routingStrategy: undefined });
+        sub.unsubscribe();
+    });
+    it('does not emit when currentApp is null', () => {
+        const navigationState$ = new Subject();
+        const currentApp$ = new BehaviorSubject(null);
+        // Test double — only current$ is read by the operator under test
+        const app = { current$: currentApp$ };
+        // Test double — only state$ is read by the operator under test
+        const navigation = {
+            state$: navigationState$,
+        };
+        const emissions = [];
+        const sub = activeAppNavigationEvents(app, navigation).subscribe((val) => emissions.push(val));
+        navigationState$.next({});
+        expect(emissions).toHaveLength(0);
+        sub.unsubscribe();
+    });
+    it('does not emit when app instance is null', () => {
+        const navigationState$ = new Subject();
+        const currentApp$ = new BehaviorSubject({
+            appKey: 'my-app',
+            instance$: new BehaviorSubject(null),
+            manifest$: new BehaviorSubject(null),
+        });
+        // Test double — only current$ is read by the operator under test
+        const app = { current$: currentApp$ };
+        // Test double — only state$ is read by the operator under test
+        const navigation = {
+            state$: navigationState$,
+        };
+        const emissions = [];
+        const sub = activeAppNavigationEvents(app, navigation).subscribe((val) => emissions.push(val));
+        navigationState$.next({});
+        expect(emissions).toHaveLength(0);
+        sub.unsubscribe();
+    });
+    it('re-emits on each navigation state change', () => {
+        // Test double — only the context property is accessed by the operator under test
+        const appModules = { context: {} };
+        const navigationState$ = new Subject();
+        const currentApp$ = new BehaviorSubject({
+            appKey: 'my-app',
+            instance$: new BehaviorSubject(appModules),
+            manifest$: new BehaviorSubject(null),
+        });
+        // Test double — only current$ is read by the operator under test
+        const app = { current$: currentApp$ };
+        // Test double — only state$ is read by the operator under test
+        const navigation = {
+            state$: navigationState$,
+        };
+        const emissions = [];
+        const sub = activeAppNavigationEvents(app, navigation).subscribe((val) => emissions.push(val));
+        navigationState$.next({});
+        navigationState$.next({});
+        navigationState$.next({});
+        expect(emissions).toHaveLength(3);
+        sub.unsubscribe();
+    });
+    it('switches to new app when current app changes', () => {
+        // Test double — only the context property is accessed by the operator under test
+        const appModulesA = { context: { name: 'A' } };
+        // Test double — only the context property is accessed by the operator under test
+        const appModulesB = { context: { name: 'B' } };
+        const navigationState$ = new Subject();
+        const currentApp$ = new BehaviorSubject({
+            appKey: 'app-a',
+            instance$: new BehaviorSubject(appModulesA),
+            manifest$: new BehaviorSubject(null),
+        });
+        // Test double — only current$ is read by the operator under test
+        const app = { current$: currentApp$ };
+        // Test double — only state$ is read by the operator under test
+        const navigation = {
+            state$: navigationState$,
+        };
+        const emissions = [];
+        const sub = activeAppNavigationEvents(app, navigation).subscribe((val) => emissions.push(val));
+        navigationState$.next({});
+        expect(emissions[0]?.appKey).toBe('app-a');
+        currentApp$.next({
+            appKey: 'app-b',
+            instance$: new BehaviorSubject(appModulesB),
+            manifest$: new BehaviorSubject(null),
+        });
+        navigationState$.next({});
+        expect(emissions[1]?.appKey).toBe('app-b');
+        sub.unsubscribe();
+    });
+});
+//# sourceMappingURL=active-app-navigation-events.test.js.map

package/dist/esm/__tests__/active-app-navigation-events.test.js.map

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

package/dist/esm/__tests__/apply-navigation.test.js

@@ -0,0 +1,152 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { applyNavigation, } from '../apply-navigation';
+function makeContext(id) {
+    // Test double — only id and title are read by the code under test
+    return { id, title: `Context ${id}` };
+}
+function makeAdapter(overrides = {}) {
+    return {
+        id: 'test-adapter',
+        canHandle: () => true,
+        encode: ({ context, currentURL }) => {
+            // Guard — adapter cannot encode without a context item
+            if (!context)
+                return null;
+            return new URL(`/apps/my-app/${context.id}${currentURL.search}`, currentURL.origin);
+        },
+        decode: (url) => {
+            const match = url.pathname.match(/\/apps\/my-app\/([^/]+)/);
+            return match?.[1] ?? null;
+        },
+        ...overrides,
+    };
+}
+function makeDeps(overrides = {}) {
+    // Test doubles — only the methods exercised by applyNavigation are provided
+    return {
+        event: {
+            dispatchEvent: vi.fn(async () => ({ canceled: false })),
+        },
+        navigation: { navigate: vi.fn() },
+        config: {
+            portalName: 'Test',
+            origin: 'https://example.com',
+            adapters: [],
+            enableUrlGuard: false,
+            debug: false,
+            sourceFactory: () => ({ subscribe: vi.fn() }),
+            navigationOptions: { replace: true },
+        },
+        eventSource: { name: 'contextNavigation', version: '0.0.0' },
+        ownNavTokens: new Set(),
+        log: vi.fn(),
+        ...overrides,
+    };
+}
+describe('applyNavigation', () => {
+    const currentURL = new URL('/apps/my-app', 'https://example.com');
+    // Test double — only the context property is accessed by the code under test
+    const appModules = { context: {} };
+    let deps;
+    beforeEach(() => {
+        deps = makeDeps();
+    });
+    it('dispatches encode-returned-null skip when adapter returns null', async () => {
+        const adapter = makeAdapter({ encode: () => null });
+        const payload = {
+            appKey: 'my-app',
+            appModules,
+            adapter,
+            context: makeContext('ctx-1'),
+            currentURL,
+        };
+        await applyNavigation(payload, deps);
+        expect(deps.event.dispatchEvent).toHaveBeenCalledWith('onContextNavigationSkipped', expect.objectContaining({ detail: { appKey: 'my-app', reason: 'encode-returned-null' } }));
+        expect(deps.navigation.navigate).not.toHaveBeenCalled();
+    });
+    it('dispatches url-matches skip when target equals current URL', async () => {
+        const adapter = makeAdapter({
+            encode: ({ currentURL: url }) => new URL(url.pathname, url.origin),
+        });
+        const payload = {
+            appKey: 'my-app',
+            appModules,
+            adapter,
+            context: makeContext('ctx-1'),
+            currentURL,
+        };
+        await applyNavigation(payload, deps);
+        expect(deps.event.dispatchEvent).toHaveBeenCalledWith('onContextNavigationSkipped', expect.objectContaining({ detail: { appKey: 'my-app', reason: 'url-matches' } }));
+    });
+    it('navigates and records own-nav token on success', async () => {
+        const adapter = makeAdapter();
+        const payload = {
+            appKey: 'my-app',
+            appModules,
+            adapter,
+            context: makeContext('ctx-1'),
+            currentURL,
+        };
+        await applyNavigation(payload, deps);
+        expect(deps.navigation.navigate).toHaveBeenCalledWith(expect.objectContaining({ pathname: '/apps/my-app/ctx-1' }), { replace: true });
+        expect(deps.ownNavTokens.has('/apps/my-app/ctx-1')).toBe(true);
+    });
+    it('dispatches canceled skip when navigate event is canceled', async () => {
+        // Test double — simulates dispatch returning canceled=true only for the navigate event
+        deps = makeDeps({
+            event: {
+                dispatchEvent: vi.fn(async (name) => ({
+                    canceled: name === 'onContextNavigationNavigate',
+                })),
+            },
+        });
+        const adapter = makeAdapter();
+        const payload = {
+            appKey: 'my-app',
+            appModules,
+            adapter,
+            context: makeContext('ctx-1'),
+            currentURL,
+        };
+        await applyNavigation(payload, deps);
+        expect(deps.event.dispatchEvent).toHaveBeenCalledWith('onContextNavigationSkipped', expect.objectContaining({ detail: { appKey: 'my-app', reason: 'canceled' } }));
+        expect(deps.navigation.navigate).not.toHaveBeenCalled();
+    });
+    it('logs and does not throw when dispatch rejects', async () => {
+        // Test double — simulates dispatch throwing to verify the .catch() path
+        deps = makeDeps({
+            event: {
+                dispatchEvent: vi.fn(async () => {
+                    throw new Error('dispatch failure');
+                }),
+            },
+        });
+        const adapter = makeAdapter();
+        const payload = {
+            appKey: 'my-app',
+            appModules,
+            adapter,
+            context: makeContext('ctx-1'),
+            currentURL,
+        };
+        // Should not reject — the .catch() handles it.
+        await expect(applyNavigation(payload, deps)).resolves.toBeUndefined();
+        expect(deps.log).toHaveBeenCalledWith(expect.stringContaining('dispatch failure'));
+    });
+    it('calls onTransition callback after navigation', async () => {
+        const onTransition = vi.fn();
+        deps = makeDeps();
+        deps.config = { ...deps.config, onTransition };
+        const adapter = makeAdapter();
+        const payload = {
+            appKey: 'my-app',
+            appModules,
+            adapter,
+            context: makeContext('ctx-1'),
+            currentURL,
+        };
+        await applyNavigation(payload, deps);
+        expect(onTransition).toHaveBeenCalledWith(expect.objectContaining({ appKey: 'my-app', adapterId: 'test-adapter' }));
+    });
+});
+//# sourceMappingURL=apply-navigation.test.js.map

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

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

package/dist/esm/__tests__/enable.test.js

@@ -0,0 +1,91 @@
+import { EMPTY } from 'rxjs';
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+const builderInstances = [];
+const teardownFns = [];
+const createConfigSpy = vi.fn(() => ({
+    debug: false,
+    origin: 'https://example.com',
+    portalName: 'Portal',
+    enableUrlGuard: true,
+    navigationOptions: { replace: true },
+    adapters: [],
+    sourceFactory: vi.fn(() => EMPTY),
+    resolveInitialContext: vi.fn(async () => undefined),
+}));
+/** Mock configurator that captures calls for assertion in tests. */
+class MockContextNavigationConfigurator {
+    /**
+     * Records that debug mode was configured; returns `this` for chaining.
+     *
+     * @param _enabled - Whether debug mode should be enabled.
+     * @returns The configurator instance for chaining.
+     */
+    setDebug(_enabled) {
+        return this;
+    }
+    /** Delegates to the shared spy so tests can assert how config was created. */
+    createConfig() {
+        return createConfigSpy();
+    }
+    /** Registers this instance in the outer `builderInstances` array for test inspection. */
+    constructor() {
+        builderInstances.push(this);
+    }
+}
+vi.mock('../configurator', () => ({
+    ContextNavigationConfigurator: MockContextNavigationConfigurator,
+}));
+vi.mock('../plugin', () => ({
+    createContextNavigationPlugin: vi.fn().mockImplementation(() => {
+        const teardown = vi.fn();
+        teardownFns.push(teardown);
+        return teardown;
+    }),
+}));
+describe('enableContextNavigation', () => {
+    beforeEach(() => {
+        builderInstances.length = 0;
+        createConfigSpy.mockClear();
+    });
+    it('registers a plugin instead of module config', async () => {
+        const registerPlugin = vi.fn();
+        const addConfig = vi.fn();
+        const { enableContextNavigation } = await import('../enable-context-navigation');
+        // Test double — only registerPlugin and addConfig are called by enableContextNavigation
+        enableContextNavigation({
+            registerPlugin,
+            addConfig,
+        });
+        expect(registerPlugin).toHaveBeenCalledOnce();
+        expect(registerPlugin.mock.calls[0]?.[0]?.name).toBe('contextNavigation');
+        expect(addConfig).not.toHaveBeenCalled();
+    });
+    it('creates and disposes the runtime plugin from the registered plugin callback', async () => {
+        const registerPlugin = vi.fn();
+        const builder = vi.fn((configurator) => {
+            configurator.setDebug(true);
+        });
+        const ref = { parent: true };
+        const modules = {
+            app: { id: 'app', current$: EMPTY },
+            navigation: {
+                id: 'navigation',
+                path: { pathname: '/', search: '' },
+                state$: EMPTY,
+            },
+            context: { id: 'context', currentContext$: EMPTY },
+            event: { id: 'event', dispatchEvent: vi.fn() },
+        };
+        const { enableContextNavigation } = await import('../enable-context-navigation');
+        // Test double — only registerPlugin is called by enableContextNavigation
+        enableContextNavigation({
+            registerPlugin,
+        }, builder);
+        const plugin = registerPlugin.mock.calls[0]?.[0];
+        const registration = await plugin({ modules, ref });
+        expect(builder).toHaveBeenCalledOnce();
+        expect(registration).toEqual(expect.any(Function));
+        expect(() => registration()).not.toThrow();
+    });
+});
+//# sourceMappingURL=enable.test.js.map

package/dist/esm/__tests__/enable.test.js.map

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

package/dist/esm/__tests__/guard-handlers.test.js

@@ -0,0 +1,82 @@
+import { describe, expect, it } from 'vitest';
+import { consumeOwnNavToken, isInAppScope } from '../guard-handlers';
+import { stripQueryParams } from '../helpers';
+describe('isInAppScope', () => {
+    it('returns true when pathname equals the app base path', () => {
+        const url = new URL('/apps/my-app', 'https://example.com');
+        expect(isInAppScope(url, 'my-app')).toBe(true);
+    });
+    it('returns true when pathname starts with the app base path followed by /', () => {
+        const url = new URL('/apps/my-app/some/context', 'https://example.com');
+        expect(isInAppScope(url, 'my-app')).toBe(true);
+    });
+    it('returns false when pathname belongs to a different app', () => {
+        const url = new URL('/apps/other-app/page', 'https://example.com');
+        expect(isInAppScope(url, 'my-app')).toBe(false);
+    });
+    it('returns false when pathname is a prefix match but not a path segment boundary', () => {
+        // "/apps/my-appx" should NOT match "/apps/my-app"
+        const url = new URL('/apps/my-appx', 'https://example.com');
+        expect(isInAppScope(url, 'my-app')).toBe(false);
+    });
+    it('returns false for unrelated paths', () => {
+        const url = new URL('/settings/profile', 'https://example.com');
+        expect(isInAppScope(url, 'my-app')).toBe(false);
+    });
+});
+describe('consumeOwnNavToken', () => {
+    it('returns true and removes the token when URL matches a stored token', () => {
+        const tokens = new Set(['/apps/my-app/ctx-1']);
+        const url = new URL('/apps/my-app/ctx-1', 'https://example.com');
+        expect(consumeOwnNavToken(url, tokens)).toBe(true);
+        expect(tokens.has('/apps/my-app/ctx-1')).toBe(false);
+    });
+    it('returns false when URL does not match any stored token', () => {
+        const tokens = new Set(['/apps/my-app/ctx-1']);
+        const url = new URL('/apps/my-app/ctx-2', 'https://example.com');
+        expect(consumeOwnNavToken(url, tokens)).toBe(false);
+        // The existing token should remain untouched.
+        expect(tokens.has('/apps/my-app/ctx-1')).toBe(true);
+    });
+    it('returns false when the token set is empty', () => {
+        const tokens = new Set();
+        const url = new URL('/apps/my-app/ctx-1', 'https://example.com');
+        expect(consumeOwnNavToken(url, tokens)).toBe(false);
+    });
+    it('consumes only the matching token when multiple tokens exist', () => {
+        const tokens = new Set(['/apps/my-app/ctx-1', '/apps/my-app/ctx-2']);
+        const url = new URL('/apps/my-app/ctx-1', 'https://example.com');
+        expect(consumeOwnNavToken(url, tokens)).toBe(true);
+        expect(tokens.has('/apps/my-app/ctx-1')).toBe(false);
+        expect(tokens.has('/apps/my-app/ctx-2')).toBe(true);
+    });
+    it('normalizes trailing slashes when comparing', () => {
+        const tokens = new Set(['/apps/my-app/ctx-1']);
+        const url = new URL('/apps/my-app/ctx-1/', 'https://example.com');
+        expect(consumeOwnNavToken(url, tokens)).toBe(true);
+    });
+});
+describe('stripQueryParams', () => {
+    it('removes all query params', () => {
+        const url = new URL('/apps/my-app?tab=settings&filter=active', 'https://example.com');
+        stripQueryParams(url);
+        expect(url.search).toBe('');
+    });
+    it('removes framework params too', () => {
+        const url = new URL('/apps/my-app?$contextId=abc-123&tab=settings', 'https://example.com');
+        stripQueryParams(url);
+        expect(url.search).toBe('');
+    });
+    it('handles URLs with no query params', () => {
+        const url = new URL('/apps/my-app', 'https://example.com');
+        stripQueryParams(url);
+        expect(url.search).toBe('');
+    });
+    it('preserves pathname', () => {
+        const url = new URL('/apps/my-app/route?tab=settings', 'https://example.com');
+        stripQueryParams(url);
+        expect(url.pathname).toBe('/apps/my-app/route');
+        expect(url.search).toBe('');
+    });
+});
+//# sourceMappingURL=guard-handlers.test.js.map