@equinor/fusion-framework-module-context 8.0.3 → 9.0.0

package/dist/esm/mock/ContextMockConfigurator.js

@@ -0,0 +1,206 @@
+import { EMPTY, from, lastValueFrom, of, throwError } from 'rxjs';
+import { ContextModuleConfigurator } from '../ContextModuleConfigurator';
+/**
+ * A {@link ContextModuleConfigurator} backed by in-memory context items instead
+ * of a real context API, for seeding context in tests.
+ *
+ * @remarks
+ * Two layers cover different needs, both running through the real
+ * `ContextProvider` logic underneath — only the data source is substituted,
+ * never `validateContext`, `resolveContext`, or parent-context propagation:
+ *
+ * - **Friendly layer** — {@link setCurrentContext}, {@link setContexts},
+ *   {@link addContext}, {@link setRelatedContexts} — a small, context-domain
+ *   vocabulary for the common case: seed a known item, get it back.
+ * - **Escape hatch** — {@link setResolver} — a raw id-lookup function for a
+ *   custom id-based resolution strategy or a shape the friendly layer did not
+ *   cover. Only replaces id-based lookup (used by `setCurrentContextById` and
+ *   the initial context); it does not affect related-context resolution by
+ *   item, which always goes through {@link setRelatedContexts} instead.
+ *
+ * Seeding the initial context (via {@link setCurrentContext}) overrides
+ * `resolveInitialContext` directly with the seeded item, so a test never needs
+ * to construct a fake navigation module or parent framework instance to make an
+ * app start up with a known context selected. Resolving a context id from a URL
+ * path on startup is not covered — that needs a fake router, which is separate,
+ * not-yet-built work.
+ *
+ * Seeded ids are never generated for you — every item is looked up and
+ * returned exactly by the id it was seeded with, so a test never sees a
+ * different id than the one it wrote. Use `createContextItemFactory` or
+ * `createContextItems` for fixtures needing ids of their own, rather than a
+ * random generator that would change on every run.
+ *
+ * Related-context resolution defaults to the same seeded pool, filtered to
+ * whichever type(s) the query asked for — related context is the same
+ * context, just a different type, exactly as `ContextProvider.resolveContext`
+ * uses it to resolve an item of an unexpected type into one of the configured
+ * type. Seed items of both types and resolution works with no extra wiring;
+ * {@link setRelatedContexts} overrides that default for one specific item.
+ *
+ * @example Seed and select a known context item
+ * ```ts
+ * enableContextMock(configurator, (mock) => {
+ *   mock.setCurrentContext({ id: 'my-ctx', type: { id: 'ProjectMaster' }, value: {} });
+ * });
+ * ```
+ *
+ * @example Resolve a child-typed item into its parent type
+ * ```ts
+ * enableContextMock(configurator, (mock) => {
+ *   // no explicit wiring needed — relatedContexts filters this same pool by type
+ *   mock.setContexts([project, facility]);
+ * });
+ * ```
+ *
+ * @example Override related contexts for one specific item
+ * ```ts
+ * enableContextMock(configurator, (mock) => {
+ *   mock.addContext(project);
+ *   mock.setRelatedContexts(project.id, [facilityA, facilityB]);
+ * });
+ * ```
+ *
+ * @example Escape hatch for a custom resolution need
+ * ```ts
+ * enableContextMock(configurator, (mock) => {
+ *   mock.setResolver((id) => (id === 'special' ? specialContextItem : undefined));
+ * });
+ * ```
+ */
+export class ContextMockConfigurator extends ContextModuleConfigurator {
+    #contexts = new Map();
+    #related = new Map();
+    #resolver;
+    #pendingCurrentId;
+    /**
+     * Registers the in-memory client up front, so `createConfig` never falls
+     * back to building one from a real `ServicesModule` — a mock needs neither
+     * an API provider nor a network to answer `get`/`query`/`related`.
+     */
+    constructor() {
+        super();
+        this.addConfigBuilder((builder) => {
+            builder.setContextClient({
+                get: (args) => {
+                    const item = this.#resolve(args.id);
+                    // a caller asking for an unseeded id gets a clear error, not a silent miss
+                    return item
+                        ? of(item)
+                        : throwError(() => new Error(`ContextMockConfigurator: no context item resolves for id "${args.id}" — seed it with setCurrentContext/setContexts/addContext, or provide setResolver.`));
+                },
+                query: () => of([...this.#contexts.values()]),
+                related: (args) => {
+                    const override = this.#related.get(args.item.id);
+                    // an explicit override for this exact item always wins
+                    if (override)
+                        return of(override);
+                    const types = args.filter?.type;
+                    // otherwise: related context is the same seeded pool, filtered to the requested type(s)
+                    return of([...this.#contexts.values()].filter((item) => item.id !== args.item.id && (!types || types.includes(item.type.id))));
+                },
+            });
+        });
+    }
+    /**
+     * Seeds a context item and selects it as the context the app resolves on startup.
+     *
+     * @param item - The context item to seed and select.
+     * @returns This configurator, for chaining.
+     */
+    setCurrentContext(item) {
+        this.#contexts.set(item.id, item);
+        this.#pendingCurrentId = item.id;
+        return this;
+    }
+    /**
+     * Seeds multiple context items, making each resolvable by id.
+     *
+     * @remarks
+     * Does not select any of them as current — pair with {@link setCurrentContext}
+     * for that.
+     *
+     * @param items - The context items to seed.
+     * @returns This configurator, for chaining.
+     */
+    setContexts(items) {
+        // seed every item so each is individually resolvable by id
+        for (const item of items)
+            this.#contexts.set(item.id, item);
+        return this;
+    }
+    /**
+     * Seeds a single context item, making it resolvable by id.
+     *
+     * @param item - The context item to seed.
+     * @returns This configurator, for chaining.
+     */
+    addContext(item) {
+        this.#contexts.set(item.id, item);
+        return this;
+    }
+    /**
+     * Overrides related-context resolution for one specific source item.
+     *
+     * @remarks
+     * Without this, `relatedContexts` filters the seeded pool by the requested
+     * type(s) — this is only needed when a test wants a specific item to resolve
+     * something other than that default (e.g. no related items at all).
+     *
+     * @param itemId - The id of the item relations are being overridden for.
+     * @param items - The context items to return from `relatedContexts` for that item.
+     * @returns This configurator, for chaining.
+     */
+    setRelatedContexts(itemId, items) {
+        this.#related.set(itemId, items);
+        return this;
+    }
+    /**
+     * Escape hatch: overrides id-based context resolution directly.
+     *
+     * @remarks
+     * For a custom id-lookup strategy or a shape the friendly seeding methods
+     * above did not cover — reaching for this means they were already tried
+     * and did not fit. Only replaces lookup by id (used by
+     * `setCurrentContextById` and the seeded initial context) — related-context
+     * resolution by item always goes through {@link setRelatedContexts} instead,
+     * regardless of this setting.
+     *
+     * @param fn - Resolves a context item by id, or returns `undefined` if none matches.
+     * @returns This configurator, for chaining.
+     */
+    setResolver(fn) {
+        this.#resolver = fn;
+        return this;
+    }
+    /**
+     * Resolves an id through the escape hatch if one is set, otherwise the seeded map.
+     *
+     * @param id - The context id to resolve.
+     * @returns The matching context item, or `undefined`.
+     */
+    #resolve(id) {
+        // the escape hatch, when set, replaces the seeded map entirely
+        return this.#resolver ? this.#resolver(id) : this.#contexts.get(id);
+    }
+    /**
+     * Defaults `resolveInitialContext` from the seeded/resolved state, once the
+     * real config has been assembled.
+     *
+     * @param config - The context module config assembled by the base configurator.
+     * @param init - Module initializer arguments.
+     * @returns The context module configuration, backed by seeded/resolved data.
+     */
+    async _processConfig(config, init) {
+        // the base default is a plain Observable (`of(...)`), not a thenable — unwrap it explicitly
+        const resolved = await lastValueFrom(from(super._processConfig(config, init)));
+        const id = this.#pendingCurrentId;
+        // The base default resolves from the URL path or a parent framework, and
+        // throws when neither is present — the common case for an isolated mock.
+        // Resolve the seeded item when one was selected, otherwise resolve none.
+        resolved.resolveInitialContext = id ? () => of(this.#resolve(id)) : () => EMPTY;
+        return resolved;
+    }
+}
+export default ContextMockConfigurator;
+//# sourceMappingURL=ContextMockConfigurator.js.map

package/dist/esm/mock/ContextMockConfigurator.js.map

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

package/dist/esm/mock/fixtures/create-context-item-factory.js

@@ -0,0 +1,50 @@
+import { Faker, en } from '@faker-js/faker';
+import { stringToSeed } from './string-to-seed';
+/**
+ * Builds a {@link MockContextItemFactory} producing deterministic, sequential
+ * ids of the form `<prefix>-<n>`, with a realistic `title` filled in by
+ * {@link https://fakerjs.dev/ | faker} (`@faker-js/faker`, a peer dependency —
+ * only required if this factory is imported).
+ *
+ * @remarks
+ * Ids are scoped to the returned factory, not shared globally, so two tests
+ * creating their own factory each start counting from `1` — a random id (e.g.
+ * `crypto.randomUUID()`) would change on every run and break any assertion
+ * that seeds one item and expects to see that same id again. The faker seed
+ * is derived from that same id, so the generated `title` is just as
+ * deterministic. For fixtures spanning several context types (e.g. a
+ * parent/child type hierarchy), use `createContextItems` instead — it
+ * assigns ids per type and wires the type hierarchy for you.
+ *
+ * @param prefix - The id prefix. Defaults to `'ctx'`.
+ * @returns A function creating one {@link ContextItem} fixture per call.
+ *
+ * @example
+ * ```ts
+ * const createContextItem = createContextItemFactory();
+ *
+ * const project = createContextItem(); // id: 'ctx-1', title: a deterministic faker company name
+ * const facility = createContextItem({ title: 'Facility A' }); // id: 'ctx-2', title overridden
+ *
+ * mock.setContexts([project, facility]);
+ * ```
+ */
+export const createContextItemFactory = (prefix = 'ctx') => {
+    const created = [];
+    return (overrides = {}) => {
+        // overrides.id, when supplied, always wins over the sequential generator
+        const id = overrides.id ?? `${prefix}-${created.length + 1}`;
+        const faker = new Faker({ seed: stringToSeed(id), locale: en });
+        const item = {
+            type: { id: 'Mock' },
+            value: {},
+            title: faker.company.name(),
+            ...overrides,
+            id,
+        };
+        created.push(item);
+        return item;
+    };
+};
+export default createContextItemFactory;
+//# sourceMappingURL=create-context-item-factory.js.map

package/dist/esm/mock/fixtures/create-context-item-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context-item-factory.js","sourceRoot":"","sources":["../../../../src/mock/fixtures/create-context-item-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAWhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAM,GAAG,KAAK,EAA0B,EAAE;IACjF,MAAM,OAAO,GAAkB,EAAE,CAAC;IAClC,OAAO,CAAC,SAAS,GAAyB,EAAE,EAAe,EAAE;QAC3D,yEAAyE;QACzE,MAAM,EAAE,GAAG,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;QAChE,MAAM,IAAI,GAAgB;YACxB,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;YACpB,KAAK,EAAE,EAAE;YACT,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;YAC3B,GAAG,SAAS;YACZ,EAAE;SACH,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,wBAAwB,CAAC"}

package/dist/esm/mock/fixtures/create-context-items.js

@@ -0,0 +1,53 @@
+import { Faker, en } from '@faker-js/faker';
+import { stringToSeed } from './string-to-seed';
+/**
+ * Generates a batch of {@link ContextItem} fixtures across one or more
+ * context types, with deterministic ids, a realistic `title` from
+ * {@link https://fakerjs.dev/ | faker} (`@faker-js/faker`, a peer dependency —
+ * only required if this factory is imported), and a consistent type hierarchy.
+ *
+ * @remarks
+ * Ids are `<type>-<n>` (lowercased type, 1-based per type), so results are
+ * stable across runs and readable in test failures. `title` is filled in from
+ * a faker instance seeded by that same id, so it's just as deterministic.
+ * Feeding the result to `ContextMockConfigurator.setContexts` is enough to
+ * make related-context resolution work across types — the mock's
+ * `relatedContexts` filters this same seeded pool by type, so a child-typed
+ * item resolves into a parent of its `parentTypeIds` without any per-item
+ * wiring. That default is a simplification: the real context API resolves
+ * relations per specific instance (a `Contract` belongs to one particular
+ * `ProjectMaster`, not every `ProjectMaster` in the system) — seed only one
+ * instance per type when that distinction doesn't matter to the test, or use
+ * `ContextMockConfigurator.setRelatedContexts` to pin a specific item's
+ * relations when it does.
+ *
+ * @param types - The context types, and how many items to generate for each.
+ * @returns The generated context items, in the order the type seeds were given.
+ *
+ * @example Seed a project type and a child contract type
+ * ```ts
+ * const [project] = createContextItems([{ type: 'ProjectMaster' }]);
+ * const [contract] = createContextItems([
+ *   { type: 'Contract', parentTypeIds: ['ProjectMaster'] },
+ * ]);
+ *
+ * enableContextMock(configurator, (mock) => {
+ *   mock.setContexts([project, contract]);
+ *   // relatedContexts({ item: contract, filter: { type: ['ProjectMaster'] } }) now resolves `project`
+ * });
+ * ```
+ */
+export const createContextItems = (types) => types.flatMap(({ type, count = 1, parentTypeIds, item }) => Array.from({ length: count }, (_, i) => {
+    const index = i + 1;
+    const id = `${type.toLowerCase()}-${index}`;
+    const faker = new Faker({ seed: stringToSeed(id), locale: en });
+    return {
+        value: {},
+        title: faker.company.name(),
+        ...item?.(index),
+        id,
+        type: parentTypeIds ? { id: type, isChildType: true, parentTypeIds } : { id: type },
+    };
+}));
+export default createContextItems;
+//# sourceMappingURL=create-context-items.js.map

package/dist/esm/mock/fixtures/create-context-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-context-items.js","sourceRoot":"","sources":["../../../../src/mock/fixtures/create-context-items.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuBhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,KAAwB,EAAiB,EAAE,CAC5E,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE,CACzD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAe,EAAE;IAClD,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,CAAC;IACpB,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,IAAI,KAAK,EAAE,CAAC;IAC5C,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,EAAE,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC;IAChE,OAAO;QACL,KAAK,EAAE,EAAE;QACT,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE;QAC3B,GAAG,IAAI,EAAE,CAAC,KAAK,CAAC;QAChB,EAAE;QACF,IAAI,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE;KACpF,CAAC;AACJ,CAAC,CAAC,CACH,CAAC;AAEJ,eAAe,kBAAkB,CAAC"}

package/dist/esm/mock/fixtures/index.js

@@ -0,0 +1,22 @@
+/**
+ * Fixture generators for {@link ContextMockConfigurator} test data.
+ *
+ * @remarks
+ * A separate entry point from `@equinor/fusion-framework-module-context/mock`
+ * because these factories use {@link https://fakerjs.dev/ | faker}
+ * (`@faker-js/faker`) for realistic values — an optional peer dependency, only
+ * required if this entry point is imported. `enableContextMock` and
+ * `ContextMockConfigurator` on the main `/mock` entry point never require it.
+ *
+ * @example
+ * ```typescript
+ * import { createContextItems } from '@equinor/fusion-framework-module-context/mock/fixtures';
+ *
+ * const [project] = createContextItems([{ type: 'ProjectMaster' }]);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { createContextItemFactory, } from './create-context-item-factory';
+export { createContextItems, } from './create-context-items';
+//# sourceMappingURL=index.js.map

package/dist/esm/mock/fixtures/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/mock/fixtures/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EACL,wBAAwB,GAEzB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EACL,kBAAkB,GAGnB,MAAM,wBAAwB,CAAC"}

package/dist/esm/mock/fixtures/string-to-seed.js

@@ -0,0 +1,15 @@
+/**
+ * Derives a numeric seed from a string, for a deterministic {@link https://fakerjs.dev/ | faker} instance.
+ *
+ * @remarks
+ * A pure-JS hash (no `node:crypto`) so fixtures stay usable in browser-like test
+ * environments, not just Node. Same id in, same seed out, every run.
+ *
+ * @param value - The string to derive a seed from (typically a generated item id).
+ * @returns A 32-bit unsigned integer seed.
+ */
+export const stringToSeed = (value) => 
+// FNV-1a-style hash: fold each char in, keep the running hash unsigned 32-bit
+[...value].reduce((hash, char) => Math.imul(hash ^ char.charCodeAt(0), 16777619) >>> 0, 2166136261);
+export default stringToSeed;
+//# sourceMappingURL=string-to-seed.js.map

package/dist/esm/mock/fixtures/string-to-seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-to-seed.js","sourceRoot":"","sources":["../../../../src/mock/fixtures/string-to-seed.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAU,EAAE;AACpD,8EAA8E;AAC9E,CAAC,GAAG,KAAK,CAAC,CAAC,MAAM,CACf,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,EACpE,UAAU,CACX,CAAC;AAEJ,eAAe,YAAY,CAAC"}

package/dist/esm/mock/index.js

@@ -0,0 +1,31 @@
+/**
+ * Mock context module for tests: real provider, real configurator, in-memory data.
+ *
+ * @remarks
+ * Substituting the data source is the smallest change that removes the context
+ * API, HTTP mocking, and service-discovery mocking from a test. Everything
+ * above it — validation, resolution, parent-context propagation, initial-context
+ * selection — is the production code path.
+ *
+ * This is one of two ways to mock context data in tests: a small, static,
+ * in-memory pool (this module — no HTTP layer involved at all). The other is
+ * mocking the context API's HTTP responses directly (e.g. with MSW), which
+ * exercises the real `ContextModuleConfigurator`/services/HTTP pipeline —
+ * reach for that instead when the test needs to cover that pipeline itself.
+ * For fixture generators with realistic fake data, see
+ * `@equinor/fusion-framework-module-context/mock/fixtures`.
+ *
+ * @example
+ * ```typescript
+ * import { enableContextMock } from '@equinor/fusion-framework-module-context/mock';
+ *
+ * enableContextMock(configurator, (mock) => {
+ *   mock.setCurrentContext({ id: 'my-ctx', type: { id: 'ProjectMaster' }, value: {} });
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { ContextMockConfigurator, } from './ContextMockConfigurator';
+export { enableContextMock, contextMockModule } from './module';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mock/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,OAAO,EACL,uBAAuB,GAExB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAA4B,MAAM,UAAU,CAAC"}

package/dist/esm/mock/module.js

@@ -0,0 +1,41 @@
+import { module } from '../module';
+import { ContextMockConfigurator } from './ContextMockConfigurator';
+/**
+ * The context module with an in-memory mock configurator instead of a real
+ * context API.
+ *
+ * @remarks
+ * Only `configure` differs from the real module. `initialize` is the production
+ * one, untouched, so a test exercises the real `ContextProvider` startup path,
+ * `validateContext`/`resolveContext`, and parent-context propagation — a
+ * rehearsal of the module, not a stand-in for it.
+ */
+export const contextMockModule = {
+    ...module,
+    configure: () => new ContextMockConfigurator(),
+};
+/**
+ * Enables the context module against in-memory seeded data, so a test needs no
+ * context API, no HTTP mock, and no service-discovery mock.
+ *
+ * @remarks
+ * Registered last, this replaces whichever context module the configurator
+ * already carries, so it works on a `FrameworkConfigurator` that pre-registers
+ * the real one.
+ *
+ * @param configurator - The modules configurator to register on.
+ * @param configure - Optional callback to seed context items or override resolution.
+ *
+ * @example
+ * ```ts
+ * enableContextMock(configurator, (mock) => {
+ *   mock.setCurrentContext({ id: 'my-ctx', type: { id: 'ProjectMaster' }, value: {} });
+ * });
+ * ```
+ */
+export const enableContextMock = (
+// biome-ignore lint/suspicious/noExplicitAny: must be any to support all module types
+configurator, configure) => {
+    configurator.addConfig({ module: contextMockModule, configure });
+};
+//# sourceMappingURL=module.js.map

package/dist/esm/mock/module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.js","sourceRoot":"","sources":["../../../src/mock/module.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAsB,MAAM,WAAW,CAAC;AAEvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkB;IAC9C,GAAG,MAAM;IACT,SAAS,EAAE,GAAG,EAAE,CAAC,IAAI,uBAAuB,EAAE;CAC/C,CAAC;AAOF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;AAC/B,sFAAsF;AACtF,YAA4C,EAC5C,SAA+B,EACzB,EAAE;IACR,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAE5D,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/module.js

@@ -1,5 +1,6 @@
 import { catchError, EMPTY, from, Observable, switchMap, filter, Subscription } from 'rxjs';
-import { ContextModuleConfigurator } from './configurator';
+import { TelemetryLevel, TelemetryScope, } from '@equinor/fusion-framework-module-telemetry';
+import { ContextModuleConfigurator, } from './ContextModuleConfigurator';
 import { ContextProvider } from './ContextProvider';
 /**
  * Module registration key for the context module.
@@ -34,13 +35,17 @@ export const module = {
     configure: () => new ContextModuleConfigurator(),
     initialize: async function (args) {
         // create config from configurator
-        const config = await args.config.createConfig(args);
+        const config = await args.config.createConfigAsync(args);
         // get event module if available
         const event = args.hasModule('event') ? await args.requireInstance('event') : undefined;
+        // get telemetry module if available, for tracking context resolution outcomes
+        const telemetry = args.hasModule('telemetry')
+            ? await args.requireInstance('telemetry')
+            : undefined;
         // get parent context provider if available
         const parentProvider = args.ref?.context;
-        // create context provider
-        const provider = new ContextProvider({ config, event, parentContext: parentProvider });
+        // create context provider; parent context is wired up later via connectParentContext, not the deprecated ctor arg
+        const provider = new ContextProvider({ config, event });
         // create subscription for disposing the provider
         const subscription = new Subscription(() => provider.dispose());
         // setup post initialize to module
@@ -61,18 +66,42 @@ export const module = {
             // add teardown to resolve initial context
             subscriber.add(resolveInitialContext$
                 .pipe(catchError((err) => {
-                console.warn('ContextModule.postInitialize', 'failed to resolve initial context', err);
+                const exception = err instanceof Error ? err : new Error(String(err));
+                // report through telemetry when available, otherwise fall back to console.warn below
+                if (telemetry) {
+                    telemetry.trackException({
+                        name: 'Context::postInitialize.resolveInitialContext',
+                        exception,
+                        level: TelemetryLevel.Warning,
+                        scope: ['context', TelemetryScope.Framework],
+                    });
+                }
+                else {
+                    // no telemetry module registered - fall back to a visible warning so a
+                    // genuine resolution failure isn't silently swallowed
+                    console.warn('Context::postInitialize.resolveInitialContext', exception);
+                }
                 // failed to resolve initial context, complete immediately
                 return EMPTY;
             }))
                 .subscribe({
                 next: (item) => {
-                    console.debug('ContextModule.postInitialize', `initial context was resolved to [${item ? item.id : 'none'}]`, item);
+                    telemetry?.trackEvent({
+                        name: 'Context::postInitialize.initialContextResolved',
+                        level: TelemetryLevel.Debug,
+                        scope: ['context', TelemetryScope.Framework],
+                        properties: { contextId: item ? item.id : 'none' },
+                    });
                 },
                 complete: () => {
                     // connect parent context if available when stream completes
                     if (config.connectParentContext !== false && parentProvider) {
                         provider.connectParentContext(parentProvider);
+                        telemetry?.trackEvent({
+                            name: 'Context::postInitialize.parentContextConnected',
+                            level: TelemetryLevel.Debug,
+                            scope: ['context', TelemetryScope.Framework],
+                        });
                     }
                     subscriber.complete();
                 },

package/dist/esm/module.js.map

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

package/dist/esm/{get-context-selector.js → selectors/get-context-selector.js}

@@ -1,4 +1,4 @@
-import { parseContextItem } from './parse-context-item';
+import { parseContextItem } from '../utils/parse-context-item';
 /**
  * Parse the response from the GetContext API into a context item.
  * @param response The response object containing the context item.
@@ -8,7 +8,4 @@ export const getContextSelector = async (response) => {
     const result = (await response.json());
     return parseContextItem(result);
 };
-// Deliberately re-exported from here to preserve the package's existing selectors entry point
-export { queryContextSelector } from './query-context-selector';
-export { relatedContextSelector } from './related-context-selector';
 //# sourceMappingURL=get-context-selector.js.map

package/dist/esm/selectors/get-context-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-context-selector.js","sourceRoot":"","sources":["../../../src/selectors/get-context-selector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,QAAkB,EAAwB,EAAE;IACnF,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA6B,CAAC;IACnE,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC,CAAC"}

package/dist/esm/selectors/index.js

@@ -0,0 +1,13 @@
+/**
+ * Response selectors that parse raw context API responses into {@link ContextItem}s.
+ *
+ * - {@link getContextSelector} — parses a single-item GetContext response.
+ * - {@link queryContextSelector} — parses a multi-item QueryContext response.
+ * - {@link relatedContextSelector} — parses a multi-item RelatedContext response.
+ *
+ * @packageDocumentation
+ */
+export { getContextSelector } from './get-context-selector';
+export { queryContextSelector } from './query-context-selector';
+export { relatedContextSelector } from './related-context-selector';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/selectors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/esm/{query-context-selector.js → selectors/query-context-selector.js}

@@ -1,4 +1,4 @@
-import { parseContextItem } from './parse-context-item';
+import { parseContextItem } from '../utils/parse-context-item';
 /**
  * Parse the response from the QueryContext API into an array of context items.
  * @param response The response object.

package/dist/esm/selectors/query-context-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-context-selector.js","sourceRoot":"","sources":["../../../src/selectors/query-context-selector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,QAAkB,EAA0B,EAAE;IACvF,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA+B,CAAC;IACrE,8CAA8C;IAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC,CAAC"}

package/dist/esm/{related-context-selector.js → selectors/related-context-selector.js}

@@ -1,4 +1,4 @@
-import { parseContextItem } from './parse-context-item';
+import { parseContextItem } from '../utils/parse-context-item';
 /**
  * Parse the response from the RelatedContext API into an array of context items.
  * @param response The response object containing the related context items.

package/dist/esm/selectors/related-context-selector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"related-context-selector.js","sourceRoot":"","sources":["../../../src/selectors/related-context-selector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,QAAkB,EAA0B,EAAE;IACzF,MAAM,MAAM,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAiC,CAAC;IACvE,8CAA8C;IAC9C,OAAO,MAAM,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AACtC,CAAC,CAAC"}

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

@@ -3,7 +3,7 @@ import { module } from '../module';
  * Enables context configuration for a given modules configurator.
  *
  * @param configurator - The modules configurator instance to which the context module will be added.
- * @param builder - An optional function that receives a context configuration builder. This function can be used to further configure the context module. It can be asynchronous.
+ * @param builder - An optional function that receives the {@link IContextModuleConfigurator}. This function can be used to further configure the context module. It can be asynchronous.
  *
  * @remarks
  * This utility function adds the context module to the provided configurator and optionally applies additional configuration using the provided builder function.

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

@@ -1 +1 @@
-{"version":3,"file":"enable-context.js","sourceRoot":"","sources":["../../../src/utils/enable-context.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;AAC3B,sFAAsF;AACtF,YAA4C,EAC5C,OAEyB,EACnB,EAAE;IACR,YAAY,CAAC,SAAS,CAAC;QACrB,MAAM;QACN,SAAS,EAAE,CAAC,mBAAmB,EAAE,EAAE;YACjC,OAAO,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}
+{"version":3,"file":"enable-context.js","sourceRoot":"","sources":["../../../src/utils/enable-context.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;AAC3B,sFAAsF;AACtF,YAA4C,EAC5C,OAAsC,EAChC,EAAE;IACR,YAAY,CAAC,SAAS,CAAC;QACrB,MAAM;QACN,SAAS,EAAE,CAAC,mBAAmB,EAAE,EAAE;YACjC,OAAO,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAC3D,CAAC;KACF,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/esm/utils/index.js

@@ -5,10 +5,12 @@
  * - {@link resolveInitialContext} — default initial-context resolver (path → parent fallback).
  * - {@link extractContextIdFromPath} — extract a GUID context ID from a URL path.
  * - {@link resolveContextFromPath} — resolve a context item from a URL path.
+ * - {@link parseContextItem} — parse a raw API context entity into a `ContextItem`.
  *
  * @packageDocumentation
  */
 export { enableContext } from './enable-context';
 export { resolveInitialContext } from './resolve-initial-context';
 export { extractContextIdFromPath, resolveContextFromPath } from './resolve-context-from-path';
+export { parseContextItem } from './parse-context-item';
 //# sourceMappingURL=index.js.map