@gravitee/gamma-lib-observability 1.5.0 → 1.6.0

package/INTEGRATION.md

@@ -11,6 +11,8 @@ This guide walks through integrating the observability library into a Gamma modu
 - [Prerequisites](#prerequisites)
 - [Installation](#installation)
 - [Quick Start](#quick-start)
+- [Host Wiring Checklist](#host-wiring-checklist)
+- [Authenticated HTTP (`http` prop)](#authenticated-http-http-prop)
 - [Feature: Dashboards](#feature-dashboards)
 - [Feature: Logs](#feature-logs)
 - [Feature: Widget Embedding](#feature-widget-embedding)
@@ -162,6 +164,59 @@ That's it — you now have a working dashboards section. The library handles dat
 
 ---
 
+## Host Wiring Checklist
+
+The lib is a **contributor**: it ships routes, nav and route metadata; the host owns the shell. Use this as a quick reference of everything the host must wire — most of it is derivable from data the lib already exposes, so prefer the provided helpers over hand-rolled parsing.
+
+- [ ] **CSS** — import `@gravitee/gamma-lib-observability/styles` in the exposed entry (see [CSS](#css)).
+- [ ] **Query client** — wrap the app in a single `QueryClientProvider` (shared singleton under Module Federation).
+- [ ] **Authenticated HTTP** — pass the `http` prop (or an `HttpProvider`) once so every internal source is authenticated (see [Authenticated HTTP](#authenticated-http-http-prop)).
+- [ ] **Mount routes** — `<Route path="observe/*" element={<observability.Routes … />} />`.
+- [ ] **Register navigation** — add `observability.navGroup` to your sidenav groups.
+- [ ] **Active nav key** — resolve it with `observability.resolveRouteKey(pathname)` (see [Active nav key detection](#active-nav-key-detection)).
+- [ ] **Breadcrumbs** — build them from `observability.breadcrumbSegments(activeNavKey)` (see [Breadcrumbs](#breadcrumbs)).
+- [ ] **Merge route keys / routes** — spread `observability.routeKeys` / `observability.routes` into the module's own (see [Merging route keys and routes](#merging-route-keys-and-routes)).
+- [ ] **Module Federation timing** — mount data-bound routes only after the SDK environment id has landed (see [Module Federation timing](#module-federation-timing)).
+- [ ] **Capabilities (optional)** — wrap with `CapabilityProvider` for RBAC.
+
+---
+
+## Authenticated HTTP (`http` prop)
+
+Every request the lib makes — metrics, filter definitions, filter values, filter label resolution, logs (and traces when shipped) — must be authenticated. Configure this **once** via the `http` prop on `<observability.Routes>` instead of patching each data source individually:
+
+```tsx
+<observability.Routes
+  baseUrl={baseUrl}
+  http={{
+    // Send cookies (e.g. the Gravitee session) on every request.
+    credentials: 'include',
+    // Function form is re-evaluated per request, so short-lived tokens
+    // (rolling XSRF) stay fresh.
+    headers: () => ({
+      'X-Requested-With': 'XMLHttpRequest',
+      'X-Xsrf-Token': readXsrfTokenFromCookie(),
+    }),
+  }}
+/>
+```
+
+| Option        | Purpose                                                                                                    |
+| ------------- | ---------------------------------------------------------------------------------------------------------- |
+| `fetch`       | Custom fetch implementation — useful when the host already has an authenticated client                     |
+| `headers`     | Static `HeadersInit` or a factory called per-request (re-evaluated for every call, ideal for rolling XSRF) |
+| `credentials` | Forwarded to `fetch` — `'include'` when the host relies on cookies                                         |
+
+The `http` config is applied to **every** internally-built source. Resolution order:
+
+1. `http` prop on `<observability.Routes>` (explicit, wins)
+2. Nearest `HttpProvider` ancestor
+3. Bare `fetch` (no auth) — only when neither of the above is provided
+
+> Per-source option bags (`createHttpDataSource(baseUrl, options)`, `createHttpLogsSource(baseUrl, options)`) still exist for advanced overrides (see [Advanced Topics](#advanced-topics)), but the `http` prop is the recommended centralized pattern — supply it once and you are done.
+
+---
+
 ## Feature: Dashboards
 
 ### Dashboard templates
@@ -251,6 +306,42 @@ dashboards: {
 - `contextFilters` — merged into every `fetchTimeSeries`, `fetchFacets`, `fetchMeasures` call
 - `scopeFilterField` — restricts which filter providers appear in the FilterBar (only those whose `scopes` include the active values)
 
+### Cross-section links (Dashboards → Logs)
+
+Dashboards can render **optional** toolbar links for cross-section navigation — typically a _"See associated logs"_ link that jumps to the Logs screen **carrying the active dashboard filters over**. Declare them via `externalLinks` on the dashboards feature, and build the target URL with the `buildLogsDeepLink` helper:
+
+```ts
+import { buildLogsDeepLink } from '@gravitee/gamma-lib-observability';
+
+dashboards: {
+  enabled: true,
+  templates: myTemplates,
+  externalLinks: [
+    {
+      label: 'See associated logs',
+      // `href` can be a static string or a function receiving the dashboard's
+      // current filters. Use `buildLogsDeepLink` to encode them into the logs URL.
+      href: (filters) =>
+        buildLogsDeepLink({
+          basePath: '/observe',
+          timeRange: { type: 'relative', period: '1h' },
+          filters,
+        }),
+    },
+  ],
+}
+```
+
+Each link renders in the dashboard toolbar as `Label →`. The `href` callback is re-evaluated on every render with the **live** filters, so the target URL always reflects the current filter state.
+
+`buildLogsDeepLink({ basePath, timeRange, filters? })` returns a deep link to the logs screen:
+
+- builds `<basePath>/logs` (trailing slashes on `basePath` are normalized);
+- encodes `filters` + `timeRange` into the `q` / `v` URL-state params — the **same codec** the routes use — so the Logs screen opens pre-filtered;
+- returns the bare path (no query) when the state matches defaults.
+
+> The `href(filters)` callback receives the active **filters** but not the time range (links are declared statically in config). Pass a sensible default `timeRange` to `buildLogsDeepLink` (it is required); the Logs screen lets the user adjust it afterwards.
+
 ### Full `DashboardFeatureConfig`
 
 ```ts
@@ -259,6 +350,12 @@ interface DashboardFeatureConfig {
   templates: DashboardTemplate[];
   contextFilters?: FilterCondition[];
   scopeFilterField?: string;
+  externalLinks?: ExternalDashboardLink[];
+}
+
+interface ExternalDashboardLink {
+  label: string;
+  href: string | ((filters: readonly FilterCondition[]) => string);
 }
 ```
 
@@ -527,47 +624,89 @@ defineObservabilityFeatures({
 
 ### Active nav key detection
 
-Register observability route keys in your `getActiveNavKey` function so the sidebar highlights correctly:
+The lib is the only place that knows how it structures its composite route keys (`observe/dashboards`, `observe/logs`), so let it reparse them. Call `observability.resolveRouteKey(pathname)` in your `getActiveNavKey` function instead of hand-writing the `observe/*` branch:
 
 ```ts
 import { observability } from './config/observability';
 
 function getActiveNavKey(pathname: string): string | undefined {
-  for (const key of observability.routeKeys) {
-    if (pathname.startsWith(`/${key}`)) return key;
-  }
+  // Handles host-prefixed paths (e.g. /environments/:hrid/aim/observe/logs),
+  // falls back to the first enabled feature for a bare `observe` path, and
+  // returns null for non-observability paths.
+  const observabilityKey = observability.resolveRouteKey(pathname);
+  if (observabilityKey !== null) return observabilityKey;
+
   // ...other module routes...
 }
 ```
 
-`routeKeys` is an array like `['observe/dashboards', 'observe/logs']`.
+`resolveRouteKey`:
+
+- locates the `basePath` segment (`observe` by default) anywhere in the pathname, so host route prefixes are handled automatically;
+- matches the next segment against the lib's own `routeKeys`;
+- falls back to the first enabled feature (`routeKeys[0]`) for a bare base path or an unknown sub-segment — no `?? 'dashboards'` edge case to maintain;
+- returns `null` when the pathname is not an observability path.
+
+> **`basePath` must be a single URL segment** (e.g. `observe`, `monitoring`) — it is matched against one path segment. A multi-segment value like `obs/v2` will not resolve.
+
+> `routeKeys` is still exposed (an array like `['observe/dashboards', 'observe/logs']`) for cases where you need the raw list — e.g. [merging route keys and routes](#merging-route-keys-and-routes).
 
 ### Breadcrumbs
 
-The library does **not** own the breadcrumb UI — your module is responsible for rendering it. However, the routes follow a **3-level depth** convention that modules must implement:
+The library does **not** render breadcrumbs — your module owns the breadcrumb UI (it composes `buildLinearBreadcrumbs` from graphene-core and `buildModuleNavPath` from gamma-modules-sdk). But the lib **does** know its own 2-level structure (group + feature), so it returns the breadcrumb **data** for you via `observability.breadcrumbSegments(activeNavKey)`. You map that data onto your renderer.
 
+```ts
+type BreadcrumbSegment = { label: string; routeKey?: string };
 ```
-Module Name → Observability Feature → Page Title
+
+```tsx
+import { observability } from './config/observability';
+
+const activeNavKey = observability.resolveRouteKey(pathname);
+
+// Lib-owned group + feature segments (data only, never JSX):
+const segments = activeNavKey ? observability.breadcrumbSegments(activeNavKey) : null;
+
+// Host maps segments onto its own breadcrumb primitives, then appends the
+// 3rd level (dashboard name / log detail) from route params + template/data:
+const breadcrumbs = buildLinearBreadcrumbs([
+  ...(segments ?? []).map((s) => ({
+    label: s.label,
+    href: s.routeKey ? buildModuleNavPath(s.routeKey) : undefined,
+  })),
+  ...(detailTitle ? [{ label: detailTitle }] : []),
+]);
 ```
 
-Examples:
+`breadcrumbSegments`:
 
-| Path                               | Breadcrumb                        |
-| ---------------------------------- | --------------------------------- |
-| `/observe/dashboards`              | `AIM → Dashboards`                |
-| `/observe/dashboards/api-overview` | `AIM → Dashboards → API Overview` |
-| `/observe/logs`                    | `AIM → Logs`                      |
-| `/observe/logs/abc-123`            | `AIM → Logs → Log Detail`         |
+- returns `null` when `activeNavKey` is not an observability key (the host renders its default breadcrumbs);
+- group segment uses `navGroup.label`, with `routeKey` pointing to the **first enabled feature** (the group entry point) — so it auto-adapts when features are added/removed instead of hardcoding `observe/dashboards`;
+- feature segment uses `routes[key].label`.
 
-Use `observability.routes` to build breadcrumb labels dynamically:
+Examples (group label = `Observability`, dashboards enabled first):
+
+| Call                                       | Result                                                                                  |
+| ------------------------------------------ | --------------------------------------------------------------------------------------- |
+| `breadcrumbSegments('observe/dashboards')` | `[{ label: 'Observability', routeKey: 'observe/dashboards' }, { label: 'Dashboards' }]` |
+| `breadcrumbSegments('observe/logs')`       | `[{ label: 'Observability', routeKey: 'observe/dashboards' }, { label: 'Logs' }]`       |
+| `breadcrumbSegments('llm-router')`         | `null`                                                                                  |
+
+The routes still follow a **3-level depth** convention — `Module Name → Observability Feature → Page Title`. The lib returns the first two levels; the host appends the third (dashboard name, log detail) from the route params and its template/data.
+
+### Merging route keys and routes
+
+When your module maintains a single canonical list of route keys and a routes map, spread the lib's contributions into them instead of re-declaring `observe/*` entries by hand:
 
 ```ts
-const { routes } = observability;
-// routes['observe/dashboards'] → { path: 'observe/dashboards', label: 'Dashboards' }
-// routes['observe/logs']       → { path: 'observe/logs',       label: 'Logs' }
+import { observability } from './config/observability';
+import { moduleKeys, moduleRoutes } from './routing';
+
+export const ROUTE_KEYS = [...moduleKeys, ...observability.routeKeys] as const;
+export const ROUTES = { ...moduleRoutes, ...observability.routes };
 ```
 
-For the third level (dashboard name, log detail), read the page title from the route params and your template/data.
+This keeps the lib as the single source of truth for its own keys/labels — enabling or disabling a feature automatically updates both lists, with zero duplication in the host.
 
 ---
 
@@ -603,6 +742,35 @@ const capabilities: DashboardCapabilities = {
 
 ## Advanced Topics
 
+### Module Federation timing
+
+When the module runs **federated** inside a host, the gamma-modules-sdk environment is populated **asynchronously** — the real environment id (and therefore the resolved `baseUrl`) is not available on the very first render. If you mount the data-bound observability routes before that id lands, the lib fires analytics queries against the wrong (placeholder) environment; those requests are then cancelled once the real id arrives, producing console noise and a flash of empty/incorrect data.
+
+Guard the mount on the SDK environment being ready, with a fallback for standalone dev where there is no host to wait for:
+
+```tsx
+import { useModuleEnvironment } from '@gravitee/gamma-modules-sdk';
+
+function ObservabilitySection() {
+  const { environmentId, isReady } = useModuleEnvironment();
+
+  // Standalone dev has no host env to wait for — mount immediately.
+  const awaitingHostEnv = import.meta.env.PROD && !isReady;
+  if (awaitingHostEnv) {
+    return null; // or a lightweight skeleton
+  }
+
+  const baseUrl = buildObservabilityBaseUrl(environmentId);
+  return <observability.Routes baseUrl={baseUrl} http={httpConfig} /* … */ />;
+}
+```
+
+Key points:
+
+- Wait for the SDK environment to be ready **before** mounting `<observability.Routes>` (or any data-bound route), so the first query uses the correct `baseUrl`.
+- Keep a standalone-dev fallback (`import.meta.env.PROD` guard, or a config flag) so running the module on its own does not block on a host that will never appear.
+- The exact hook/selector depends on your module SDK version — the pattern is "resolve env id → derive baseUrl → mount", not the specific API surface.
+
 ### baseUrl resolution
 
 Build the observability `baseUrl` from your module's bootstrap config:
@@ -887,6 +1055,25 @@ export const observability = defineObservabilityFeatures({
   },
   nav: { label: 'Observability' },
 });
+
+// Single source of truth for route keys/routes — spread the lib's contributions.
+export const ROUTE_KEYS = [...moduleKeys, ...observability.routeKeys] as const;
+export const ROUTES = { ...moduleRoutes, ...observability.routes };
+```
+
+```ts
+// src/config/navigation.ts — active nav key + breadcrumbs via the lib helpers
+import { observability } from './config/observability';
+
+export function getActiveNavKey(pathname: string): string | undefined {
+  return observability.resolveRouteKey(pathname) ?? resolveModuleNavKey(pathname);
+}
+
+export function getBreadcrumbSegments(pathname: string) {
+  const activeNavKey = observability.resolveRouteKey(pathname);
+  // Returns null for non-observability paths → host renders its defaults.
+  return activeNavKey ? observability.breadcrumbSegments(activeNavKey) : null;
+}
 ```
 
 ```tsx
@@ -898,6 +1085,8 @@ import { observability } from './config/observability';
 import { connectionLogsDataSource, logColumns } from './config/logs';
 
 function AppRoutes() {
+  // Resolve baseUrl from the SDK env; wait for it before mounting when federated
+  // (see "Module Federation timing").
   const baseUrl = useObservabilityBaseUrl();
 
   return (
@@ -911,6 +1100,14 @@ function AppRoutes() {
               element={
                 <observability.Routes
                   baseUrl={baseUrl}
+                  // Centralized auth — applied to metrics, filters, and logs sources.
+                  http={{
+                    credentials: 'include',
+                    headers: () => ({
+                      'X-Requested-With': 'XMLHttpRequest',
+                      'X-Xsrf-Token': readXsrfTokenFromCookie(),
+                    }),
+                  }}
                   logsDataSource={connectionLogsDataSource}
                   logsColumns={logColumns}
                   logsOnRowClick={(entry) => navigate(`/observe/logs/${(entry as ConnectionLog).requestId}`)}

package/USAGE_GUIDE.md

@@ -624,12 +624,64 @@ const observability = defineObservabilityFeatures({
 });
 
 // Returns:
-// observability.Routes       — React component to mount under your module's routes
-// observability.navGroup     — Navigation group descriptor for your sidenav
-// observability.routeKeys    — Array of route keys for breadcrumb integration
-// observability.routes       — Record of { path, label } for each enabled feature
+// observability.Routes              — React component to mount under your module's routes
+// observability.navGroup            — Navigation group descriptor for your sidenav
+// observability.routeKeys           — Array of route keys for breadcrumb integration
+// observability.routes              — Record of { path, label } for each enabled feature
+// observability.resolveRouteKey     — (pathname) => composite route key | null
+// observability.breadcrumbSegments  — (activeNavKey) => BreadcrumbSegment[] | null
 ```
 
+### `ObservabilityFeatures` API reference
+
+| Member               | Type                                                    | Description                                                                             |
+| -------------------- | ------------------------------------------------------- | --------------------------------------------------------------------------------------- |
+| `Routes`             | `(props: ObservabilityRoutesProps) => ReactNode`        | Route tree to mount under `observe/*`.                                                  |
+| `navGroup`           | `NavGroup`                                              | `{ label, items }` descriptor for the sidenav. Only enabled features appear in `items`. |
+| `routeKeys`          | `readonly string[]`                                     | Composite keys for enabled features, e.g. `['observe/dashboards', 'observe/logs']`.     |
+| `routes`             | `Record<string, { path; label }>`                       | Per-feature `{ path, label }` keyed by composite route key.                             |
+| `resolveRouteKey`    | `(pathname: string) => string \| null`                  | Reparses a host pathname into the matching composite route key. See below.              |
+| `breadcrumbSegments` | `(activeNavKey: string) => BreadcrumbSegment[] \| null` | Builds group + feature breadcrumb data for an active key. See below.                    |
+
+#### `resolveRouteKey(pathname)`
+
+Resolves a (possibly host-prefixed) pathname to the matching composite route key.
+
+```ts
+observability.resolveRouteKey('/observe/dashboards'); // → 'observe/dashboards'
+observability.resolveRouteKey('/environments/DEFAULT/aim/observe/logs'); // → 'observe/logs'
+observability.resolveRouteKey('/observe'); // → 'observe/dashboards' (first enabled feature)
+observability.resolveRouteKey('/llm-router'); // → null
+```
+
+- Locates the `basePath` segment (`observe` by default) anywhere in the pathname, so host route prefixes are handled automatically.
+- Matches the following segment against the lib's own `routeKeys`.
+- Falls back to the first enabled feature (`routeKeys[0]`) for a bare base path or an unknown sub-segment.
+- Returns `null` when the pathname is not an observability path (or no features are enabled).
+
+> `basePath` must be a single URL segment (e.g. `observe`, `monitoring`); a multi-segment value such as `obs/v2` will not resolve.
+
+#### `breadcrumbSegments(activeNavKey)`
+
+Returns breadcrumb **data** (the lib never returns JSX) for an active composite route key.
+
+```ts
+type BreadcrumbSegment = { label: string; routeKey?: string };
+
+observability.breadcrumbSegments('observe/dashboards');
+// → [{ label: 'Observability', routeKey: 'observe/dashboards' }, { label: 'Dashboards' }]
+
+observability.breadcrumbSegments('observe/logs');
+// → [{ label: 'Observability', routeKey: 'observe/dashboards' }, { label: 'Logs' }]
+
+observability.breadcrumbSegments('llm-router'); // → null
+```
+
+- The group segment uses `navGroup.label` and points its `routeKey` at the **first enabled feature** (the entry point) — it auto-adapts when features are added/removed.
+- The feature segment uses `routes[key].label`.
+- Returns `null` when `activeNavKey` is not an observability key.
+- The host maps the segments onto its own breadcrumb renderer (e.g. `buildLinearBreadcrumbs` + `buildModuleNavPath`) and appends any 3rd-level title (dashboard name, log detail) itself.
+
 ### Mounting Routes
 
 ```tsx
@@ -682,7 +734,7 @@ const { navGroup } = observability;
 // navGroup.items  → [{ key: 'observe/dashboards', title: 'Dashboards', icon: LayoutDashboardIcon }]
 ```
 
-Breadcrumbs are handled by the calling module — the library does not own the layout shell.
+Breadcrumbs are rendered by the calling module — the library does not own the layout shell — but the lib supplies the breadcrumb **data** (group + feature) via `observability.breadcrumbSegments(activeNavKey)`. See the [`ObservabilityFeatures` API reference](#observabilityfeatures-api-reference) above.
 
 ---
 
@@ -717,6 +769,33 @@ logs: {
 - `contextFilters` are automatically merged into every `fetchLogs` call by the query hooks.
 - `scopeFilterField` restricts which filter providers appear in the `FilterBar` (only those whose `scopes` overlap with the active context values).
 
+### Deep-linking to the logs screen (`buildLogsDeepLink`)
+
+Use `buildLogsDeepLink` to build a URL that opens the Logs screen pre-filtered — typically from a dashboard's `externalLinks` cross-section link (see `DashboardFeatureConfig.externalLinks` in [`INTEGRATION.md`](./INTEGRATION.md#cross-section-links-dashboards--logs)).
+
+```tsx
+import { buildLogsDeepLink, type BuildLogsDeepLinkParams } from '@gravitee/gamma-lib-observability';
+
+const href = buildLogsDeepLink({
+  basePath: '/observe',
+  timeRange: { type: 'relative', period: '1h' },
+  filters: [{ field: 'STATUS', label: 'Status', operator: 'in', value: ['500'] }],
+});
+// → '/observe/logs?q=...&v=1'
+```
+
+| Param       | Type                           | Description                                                    |
+| ----------- | ------------------------------ | -------------------------------------------------------------- |
+| `basePath`  | `string`                       | Mount base (e.g. `/observe`). Trailing slashes are normalized. |
+| `timeRange` | `TimeRange`                    | Time range encoded into the URL state.                         |
+| `filters`   | `FilterCondition[]` (optional) | Filters encoded into the URL state. Defaults to `[]`.          |
+
+Behavior:
+
+- targets `<basePath>/logs`;
+- encodes `filters` + `timeRange` into the `q` / `v` params via the same codec as `encodeObservabilityState`, so the Logs screen restores them on load;
+- returns the bare path (no query string) when the state matches defaults.
+
 ### Custom logs page (escape hatch)
 
 For full control over the logs page layout, pass a pre-composed `logsPage` ReactNode instead of `logsDataSource`/`logsColumns`. You must wrap your page with `LogsDataSourceProvider`:

package/dist/index.d.ts

@@ -23,7 +23,7 @@ export { buildDefaultLogDetailConfig, connectionLogPreset, defineLogDetail, LogD
 export type { BuildDefaultLogDetailConfigOptions, ConnectionLogDetailData, ConnectionLogPresetOptions, DeliveryAttempt, DefineLogDetailInput, DefineLogDetailMultiInput, DefineLogDetailSingleInput, LogDetailCodeBlockProps, LogDetailConfig, LogDetailConfigMulti, LogDetailConfigSingle, LogDetailContextChartConfig, LogDetailContextChartProps, LogDetailDrawerProps, LogDetailDrawerShellProps, LogDetailEmptyFieldProps, LogDetailFieldDefinition, LogDetailHeaderComponentProps, LogDetailHeaderProps, LogDetailHeadersTableProps, LogDetailHelpers, LogDetailJsonTreeProps, LogDetailKeyValueGridProps, LogDetailMetricDefinition, LogDetailMetricsProps, LogDetailPageProps, LogDetailPresetResolution, LogDetailSectionDefinition, LogDetailSectionProps, LogDetailSectionsProps, LogDetailVariant, MessageEntry, MessageLogDetailData, MessageLogPresetOptions, WebhookLogDetailData, WebhookLogPresetOptions, } from './logs/detail';
 export { defineObservabilityFeatures } from './routing';
 export { ContextFiltersProvider, useContextFilters } from './routing';
-export type { ContextFiltersProviderProps, DashboardFeatureConfig, ExternalDashboardLink, FeatureKey, LogsFeatureConfig, NavGroup, NavItem, ObservabilityFeatures, ObservabilityFeaturesConfig, ObservabilityRoutesProps, } from './routing';
+export type { BreadcrumbSegment, ContextFiltersProviderProps, DashboardFeatureConfig, ExternalDashboardLink, FeatureKey, LogsFeatureConfig, NavGroup, NavItem, ObservabilityFeatures, ObservabilityFeaturesConfig, ObservabilityRoutesProps, } from './routing';
 export { createHttpDataSource, type HttpDataSourceOptions } from './data-sources';
 export { createHttpFilterSource, type FilterSource } from './data-sources';
 export { createHttpLogsSource, type HttpLogsSourceOptions } from './data-sources';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -5176,11 +5176,28 @@ function Ss(e) {
 			config: e
 		});
 	}
+	function s(e) {
+		let n = e.split("/").filter(Boolean), r = n.indexOf(t);
+		if (r === -1) return null;
+		let a = n[r + 1], o = a ? `${t}/${a}` : null;
+		return o !== null && i.includes(o) ? o : i[0] ?? null;
+	}
+	function c(e) {
+		let t = a[e];
+		if (t === void 0) return null;
+		let n = i[0];
+		return [{
+			label: r.label,
+			routeKey: n
+		}, { label: t.label }];
+	}
 	return {
 		navGroup: r,
 		routeKeys: i,
 		routes: a,
-		Routes: o
+		Routes: o,
+		resolveRouteKey: s,
+		breadcrumbSegments: c
 	};
 }
 function Cs(e) {

package/dist/routing/define-observability-features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-observability-features.d.ts","sourceRoot":"","sources":["../../src/routing/define-observability-features.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAIV,qBAAqB,EACrB,2BAA2B,EAE5B,MAAM,SAAS,CAAC;AAajB,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,GAAG,qBAAqB,CAatG"}
+{"version":3,"file":"define-observability-features.d.ts","sourceRoot":"","sources":["../../src/routing/define-observability-features.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAKV,qBAAqB,EACrB,2BAA2B,EAE5B,MAAM,SAAS,CAAC;AAajB,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,2BAA2B,GAAG,qBAAqB,CAwCtG"}

package/dist/routing/index.d.ts

@@ -1,5 +1,5 @@
 export { defineObservabilityFeatures } from './define-observability-features';
 export { ContextFiltersProvider, useContextFilters } from './ContextFiltersProvider';
 export type { ContextFiltersProviderProps } from './ContextFiltersProvider';
-export type { DashboardFeatureConfig, ExternalDashboardLink, FeatureKey, LogsFeatureConfig, NavGroup, NavItem, ObservabilityFeatures, ObservabilityFeaturesConfig, ObservabilityRoutesProps, } from './types';
+export type { BreadcrumbSegment, DashboardFeatureConfig, ExternalDashboardLink, FeatureKey, LogsFeatureConfig, NavGroup, NavItem, ObservabilityFeatures, ObservabilityFeaturesConfig, ObservabilityRoutesProps, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/dist/routing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrF,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EACV,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/routing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,iCAAiC,CAAC;AAC9E,OAAO,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AACrF,YAAY,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAC5E,YAAY,EACV,iBAAiB,EACjB,sBAAsB,EACtB,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,QAAQ,EACR,OAAO,EACP,qBAAqB,EACrB,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,SAAS,CAAC"}

package/dist/routing/types.d.ts

@@ -97,6 +97,16 @@ export interface NavGroup {
     label: string;
     items: NavItem[];
 }
+/**
+ * A single breadcrumb entry returned by {@link ObservabilityFeatures.breadcrumbSegments}.
+ * The lib returns data only — the host maps it onto its own breadcrumb renderer
+ * (e.g. `buildLinearBreadcrumbs` from graphene-core).
+ */
+export interface BreadcrumbSegment {
+    label: string;
+    /** Composite route key to link to. Omitted for the (non-clickable) leaf segment. */
+    routeKey?: string;
+}
 export interface ObservabilityFeatures {
     navGroup: NavGroup;
     routeKeys: readonly string[];
@@ -105,5 +115,19 @@ export interface ObservabilityFeatures {
         label: string;
     }>;
     Routes: (props: ObservabilityRoutesProps) => ReactNode;
+    /**
+     * Resolves a host pathname to the matching composite route key
+     * (e.g. `observe/dashboards`). Handles host-prefixed paths by locating the
+     * base path segment, falls back to the first enabled feature for a bare base
+     * path, and returns `null` when the pathname is not an observability path.
+     */
+    resolveRouteKey: (pathname: string) => string | null;
+    /**
+     * Builds breadcrumb data (group + feature) for an active composite route key.
+     * The group segment's entry point is derived from the first enabled feature,
+     * so it auto-adapts when features are added or removed. Returns `null` when
+     * `activeNavKey` is not an observability key.
+     */
+    breadcrumbSegments: (activeNavKey: string) => BreadcrumbSegment[] | null;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/routing/types.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravitee/gamma-lib-observability",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Shared observability library for Gamma modules — dashboards, logs, tracing UI components and integration with business rules.",
   "type": "module",
   "packageManager": "yarn@4.14.1",