@marinoscar/platform-web 0.0.0-stage → 0.1.0-next.3

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,EAAG,0BAAmC,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+/**
+ * The npm name of this package, which holds React pages, components and hooks of the platform.
+ *
+ * A placeholder export so the build, the pack check and the smoke imports in
+ * CI have something to load end to end. Real slices arrive as subpath
+ * exports (`@marinoscar/platform-web/<slice>`).
+ *
+ * @stability experimental
+ */
+export const PLATFORM_PACKAGE = '@marinoscar/platform-web';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,0BAAmC,CAAC"}

package/dist/telemetry/headless/adapters/TelemetryWebAdapters.d.ts

@@ -0,0 +1,106 @@
+import type { ComponentType, ReactElement, ReactNode } from 'react';
+/**
+ * One enabled AI model, as the telemetry assistant's model picker shows it:
+ * only the fields the picker reads.
+ *
+ * @stability experimental
+ */
+export interface TelemetryAssistantModelOption {
+    /** A stable id for the option (the catalogue row's id). */
+    id: string;
+    /** The provider id, e.g. `openai`. The stored key is `<provider>:<modelId>`. */
+    provider: string;
+    /** The provider's model id. */
+    modelId: string;
+    /** What the picker shows (the catalogue's display name, else the model id). */
+    label: string;
+    /** Whether the model declares tool calling (the assistant needs it). */
+    supportsToolCalling: boolean;
+}
+/**
+ * What {@link TelemetryWebAdapters.useAiEnabled} returns.
+ *
+ * @stability experimental
+ */
+export interface TelemetryAiEnabledState {
+    /** AI is switched on for this deployment. */
+    enabled: boolean;
+    /** The first answer is still in flight. */
+    isLoading: boolean;
+}
+/**
+ * What {@link TelemetryWebAdapters.useAssistantModels} returns.
+ *
+ * @stability experimental
+ */
+export interface TelemetryAssistantModelsState {
+    /** The enabled models, in the catalogue's order. */
+    models: TelemetryAssistantModelOption[];
+    /** The catalogue is still loading. */
+    isLoading: boolean;
+    /** Why the catalogue could not be read, or `null`. */
+    error: string | null;
+}
+/**
+ * The app hooks the telemetry pages call. Each `use*` member is a React hook:
+ * keep the object a module constant so the same hooks run on every render.
+ *
+ * @example
+ * ```ts
+ * // apps/web/src/platform/telemetryAdapters.ts
+ * export const appTelemetryAdapters: TelemetryWebAdapters = {
+ *   useAiEnabled: () => { const { config, isLoading } = useAiConfig(); return { enabled: config.enabled, isLoading }; },
+ *   useAssistantModels: () => ...,
+ *   Spinner: LoadingSpinner,
+ * };
+ * ```
+ *
+ * @extensionPoint option
+ * @stability experimental
+ */
+export interface TelemetryWebAdapters {
+    /** AI switched on for this deployment (the reference app: `useAiConfig().config.enabled`). */
+    useAiEnabled(): TelemetryAiEnabledState;
+    /**
+     * Enabled models for the assistant picker (the reference app:
+     * `useAiModels({ enabled: true, pageSize: 100 })`). Called only for a viewer
+     * holding `ai_config:read`, which the catalogue route requires.
+     */
+    useAssistantModels(): TelemetryAssistantModelsState;
+    /** Optional spinner for loading states; the pages default to an MUI `CircularProgress`. */
+    Spinner?: ComponentType;
+}
+/**
+ * The adapters in force without a provider: AI off, no models, no spinner.
+ *
+ * @stability experimental
+ */
+export declare const DEFAULT_TELEMETRY_WEB_ADAPTERS: TelemetryWebAdapters;
+/**
+ * Hands the app's {@link TelemetryWebAdapters} to every telemetry page below
+ * it. Mount it once, next to the `TelemetryConfigProvider`.
+ *
+ * @param props - `adapters`: the app's adapters (a module constant); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <TelemetryWebAdaptersProvider adapters={appTelemetryAdapters}>{routes}</TelemetryWebAdaptersProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export declare function TelemetryWebAdaptersProvider(props: {
+    adapters: TelemetryWebAdapters;
+    children: ReactNode;
+}): ReactElement;
+/**
+ * The adapters in context, or {@link DEFAULT_TELEMETRY_WEB_ADAPTERS}.
+ *
+ * @returns the app's telemetry adapters.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryWebAdapters(): TelemetryWebAdapters;
+//# sourceMappingURL=TelemetryWebAdapters.d.ts.map

package/dist/telemetry/headless/adapters/TelemetryWebAdapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryWebAdapters.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/adapters/TelemetryWebAdapters.tsx"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEpE;;;;;GAKG;AACH,MAAM,WAAW,6BAA6B;IAC5C,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAC;IACX,gFAAgF;IAChF,QAAQ,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,+EAA+E;IAC/E,KAAK,EAAE,MAAM,CAAC;IACd,wEAAwE;IACxE,mBAAmB,EAAE,OAAO,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,6CAA6C;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,2CAA2C;IAC3C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,6BAA6B;IAC5C,oDAAoD;IACpD,MAAM,EAAE,6BAA6B,EAAE,CAAC;IACxC,sCAAsC;IACtC,SAAS,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,oBAAoB;IACnC,8FAA8F;IAC9F,YAAY,IAAI,uBAAuB,CAAC;IACxC;;;;OAIG;IACH,kBAAkB,IAAI,6BAA6B,CAAC;IACpD,2FAA2F;IAC3F,OAAO,CAAC,EAAE,aAAa,CAAC;CACzB;AAKD;;;;GAIG;AACH,eAAO,MAAM,8BAA8B,EAAE,oBAG3C,CAAC;AAKH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE;IAClD,QAAQ,EAAE,oBAAoB,CAAC;IAC/B,QAAQ,EAAE,SAAS,CAAC;CACrB,GAAG,YAAY,CAIf;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,IAAI,oBAAoB,CAE9D"}

package/dist/telemetry/headless/adapters/TelemetryWebAdapters.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// =============================================================================
+// The telemetry slice's app adapters (issue #704)
+// =============================================================================
+//
+// What the telemetry pages need from the app that the platform host
+// (`@marinoscar/platform-web/core`) does not carry: whether AI is switched on,
+// the AI model catalogue for the assistant's model picker, and the app's
+// spinner. The AI slice is not packaged yet, so the app keeps owning those
+// hooks and hands them in here; copying them into this package would fork
+// the AI slice.
+//
+// Without a provider every adapter answers "off": AI disabled, no models, no
+// app spinner. The telemetry UI then hides the assistant (fail closed).
+// =============================================================================
+import { createContext, useContext } from 'react';
+const AI_OFF = Object.freeze({ enabled: false, isLoading: false });
+const NO_MODELS = Object.freeze({ models: [], isLoading: false, error: null });
+/**
+ * The adapters in force without a provider: AI off, no models, no spinner.
+ *
+ * @stability experimental
+ */
+export const DEFAULT_TELEMETRY_WEB_ADAPTERS = Object.freeze({
+    useAiEnabled: () => AI_OFF,
+    useAssistantModels: () => NO_MODELS,
+});
+const TelemetryWebAdaptersContext = createContext(DEFAULT_TELEMETRY_WEB_ADAPTERS);
+TelemetryWebAdaptersContext.displayName = 'TelemetryWebAdaptersContext';
+/**
+ * Hands the app's {@link TelemetryWebAdapters} to every telemetry page below
+ * it. Mount it once, next to the `TelemetryConfigProvider`.
+ *
+ * @param props - `adapters`: the app's adapters (a module constant); `children`: the routed tree.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <TelemetryWebAdaptersProvider adapters={appTelemetryAdapters}>{routes}</TelemetryWebAdaptersProvider>
+ * ```
+ *
+ * @extensionPoint component
+ * @stability experimental
+ */
+export function TelemetryWebAdaptersProvider(props) {
+    return (_jsx(TelemetryWebAdaptersContext.Provider, { value: props.adapters, children: props.children }));
+}
+/**
+ * The adapters in context, or {@link DEFAULT_TELEMETRY_WEB_ADAPTERS}.
+ *
+ * @returns the app's telemetry adapters.
+ *
+ * @stability experimental
+ */
+export function useTelemetryWebAdapters() {
+    return useContext(TelemetryWebAdaptersContext);
+}
+//# sourceMappingURL=TelemetryWebAdapters.js.map

package/dist/telemetry/headless/adapters/TelemetryWebAdapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryWebAdapters.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/adapters/TelemetryWebAdapters.tsx"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,kDAAkD;AAClD,gFAAgF;AAChF,EAAE;AACF,oEAAoE;AACpE,+EAA+E;AAC/E,yEAAyE;AACzE,2EAA2E;AAC3E,0EAA0E;AAC1E,gBAAgB;AAChB,EAAE;AACF,6EAA6E;AAC7E,wEAAwE;AACxE,gFAAgF;AAEhF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AA8ElD,MAAM,MAAM,GAA4B,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5F,MAAM,SAAS,GAAkC,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAE9G;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAyB,MAAM,CAAC,MAAM,CAAC;IAChF,YAAY,EAAE,GAAG,EAAE,CAAC,MAAM;IAC1B,kBAAkB,EAAE,GAAG,EAAE,CAAC,SAAS;CACpC,CAAC,CAAC;AAEH,MAAM,2BAA2B,GAAG,aAAa,CAAuB,8BAA8B,CAAC,CAAC;AACxG,2BAA2B,CAAC,WAAW,GAAG,6BAA6B,CAAC;AAExE;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,4BAA4B,CAAC,KAG5C;IACC,OAAO,CACL,KAAC,2BAA2B,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,CAAC,QAAQ,YAAG,KAAK,CAAC,QAAQ,GAAwC,CACrH,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,UAAU,CAAC,2BAA2B,CAAC,CAAC;AACjD,CAAC"}

package/dist/telemetry/headless/context/TelemetryConfigProvider.d.ts

@@ -0,0 +1,43 @@
+/**
+ * The one `GET /api/telemetry/config` fetch for the authenticated shell —
+ * issue #537, epic #528. Mounted beside the app's AI config provider, for the
+ * same reasons: its endpoint is `@Auth()`, and one mount point means one
+ * request shared by the chrome and every routed page. See `telemetryConfig.ts`.
+ */
+import type { ReactElement, ReactNode } from 'react';
+import type { PlatformApiClient } from '../../../core/index.js';
+/**
+ * What {@link TelemetryConfigProvider} takes.
+ *
+ * @stability experimental
+ */
+export interface TelemetryConfigProviderProps {
+    /** The routed tree. */
+    children: ReactNode;
+    /**
+     * The transport to read `GET /telemetry/config` with. Optional below a
+     * `PlatformHostProvider` (its transport is used); required above one, which
+     * is where the app mounts it: the host reads the `telemetry` feature this
+     * provider answers. Keep its identity stable.
+     */
+    api?: PlatformApiClient;
+}
+/**
+ * Fetches `GET /telemetry/config` once for everything below it; every
+ * {@link useTelemetryConfig} and {@link useTelemetryFeatures} below reads that
+ * copy. Mount it once, around the authenticated shell.
+ *
+ * @param props - see {@link TelemetryConfigProviderProps}.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <TelemetryConfigProvider api={appPlatformApi}>
+ *   <AppPlatformHostProvider>{shell}</AppPlatformHostProvider>
+ * </TelemetryConfigProvider>
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function TelemetryConfigProvider({ children, api }: TelemetryConfigProviderProps): ReactElement;
+//# sourceMappingURL=TelemetryConfigProvider.d.ts.map

package/dist/telemetry/headless/context/TelemetryConfigProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryConfigProvider.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/context/TelemetryConfigProvider.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAGhE;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,uBAAuB;IACvB,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,iBAAiB,CAAC;CACzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,uBAAuB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAE,EAAE,4BAA4B,GAAG,YAAY,CAGrG"}

package/dist/telemetry/headless/context/TelemetryConfigProvider.js

@@ -0,0 +1,24 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { TelemetryConfigContext, useTelemetryConfigQuery } from './telemetryConfig.js';
+/**
+ * Fetches `GET /telemetry/config` once for everything below it; every
+ * {@link useTelemetryConfig} and {@link useTelemetryFeatures} below reads that
+ * copy. Mount it once, around the authenticated shell.
+ *
+ * @param props - see {@link TelemetryConfigProviderProps}.
+ * @returns the provider element.
+ *
+ * @example
+ * ```tsx
+ * <TelemetryConfigProvider api={appPlatformApi}>
+ *   <AppPlatformHostProvider>{shell}</AppPlatformHostProvider>
+ * </TelemetryConfigProvider>
+ * ```
+ *
+ * @stability experimental
+ */
+export function TelemetryConfigProvider({ children, api }) {
+    const value = useTelemetryConfigQuery(api === undefined ? {} : { api });
+    return _jsx(TelemetryConfigContext.Provider, { value: value, children: children });
+}
+//# sourceMappingURL=TelemetryConfigProvider.js.map

package/dist/telemetry/headless/context/TelemetryConfigProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryConfigProvider.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/context/TelemetryConfigProvider.tsx"],"names":[],"mappings":";AASA,OAAO,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAmBvF;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,UAAU,uBAAuB,CAAC,EAAE,QAAQ,EAAE,GAAG,EAAgC;IACrF,MAAM,KAAK,GAAG,uBAAuB,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACxE,OAAO,KAAC,sBAAsB,CAAC,QAAQ,IAAC,KAAK,EAAE,KAAK,YAAG,QAAQ,GAAmC,CAAC;AACrG,CAAC"}

package/dist/telemetry/headless/context/telemetryConfig.d.ts

@@ -0,0 +1,68 @@
+import type { PlatformApiClient } from '../../../core/index.js';
+import type { TelemetryPublicConfig } from '../services/telemetry.js';
+/**
+ * The answer assumed before the API has given one, and after it failed to.
+ *
+ * @stability experimental
+ */
+export declare const TELEMETRY_CONFIG_DISABLED: TelemetryPublicConfig;
+/**
+ * What {@link useTelemetryConfig} returns.
+ *
+ * @stability experimental
+ */
+export interface UseTelemetryConfigReturn {
+    /** The answer; {@link TELEMETRY_CONFIG_DISABLED} until the first one arrives, and after the first fetch failed. */
+    config: TelemetryPublicConfig;
+    /** The first answer is in flight. */
+    isLoading: boolean;
+    /** Why the last fetch failed, or `null`. */
+    error: string | null;
+    /** Fetch again (the Telemetry settings page calls it after a save). */
+    refresh: () => Promise<void>;
+}
+/**
+ * The shell-wide answer; `null` means "no provider above this component".
+ *
+ * @stability experimental
+ */
+export declare const TelemetryConfigContext: import("react").Context<UseTelemetryConfigReturn | null>;
+/**
+ * Whether the `telemetry` settings feature is on for this answer.
+ *
+ * @stability experimental
+ */
+export declare function isTelemetryOn(config: TelemetryPublicConfig): boolean;
+/**
+ * The fetching implementation; `skip` makes it an inert stub.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryConfigQuery(options?: {
+    skip?: boolean;
+    api?: PlatformApiClient;
+}): UseTelemetryConfigReturn;
+/**
+ * The telemetry configuration — the shell's shared copy when there is one.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryConfig(): UseTelemetryConfigReturn;
+/**
+ * The `telemetry` entry of a settings hub's feature map.
+ *
+ * @stability experimental
+ */
+export interface TelemetryFeatureFlags {
+    /** A telemetry store is deployed AND collection is switched on. */
+    telemetry: boolean;
+}
+/**
+ * The `telemetry` entry of the registries' feature map — read from the shell's
+ * provider ONLY, never fetched (the navigation chrome renders in many isolated
+ * tests; without a provider it answers "off" with no request).
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryFeatures(): TelemetryFeatureFlags;
+//# sourceMappingURL=telemetryConfig.d.ts.map

package/dist/telemetry/headless/context/telemetryConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetryConfig.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/context/telemetryConfig.ts"],"names":[],"mappings":"AAqBA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AAGtE;;;;GAIG;AACH,eAAO,MAAM,yBAAyB,EAAE,qBAItC,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACvC,mHAAmH;IACnH,MAAM,EAAE,qBAAqB,CAAC;IAC9B,qCAAqC;IACrC,SAAS,EAAE,OAAO,CAAC;IACnB,4CAA4C;IAC5C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,uEAAuE;IACvE,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,0DAAuD,CAAC;AAE3F;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAEpE;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,GAAG,CAAC,EAAE,iBAAiB,CAAA;CAAO,GAAG,wBAAwB,CA2C3H;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,wBAAwB,CAI7D;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,mEAAmE;IACnE,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,IAAI,qBAAqB,CAG5D"}

package/dist/telemetry/headless/context/telemetryConfig.js

@@ -0,0 +1,119 @@
+/**
+ * Whether telemetry exists in this deployment, as every authenticated user may
+ * know it (`GET /api/telemetry/config`) — issue #537, epic #528.
+ *
+ * A deliberate mirror of `useAiConfig.ts`, for the same two reasons:
+ *
+ * 1. FAIL CLOSED. `config` is never `null`: until the first answer arrives,
+ *    and whenever the first fetch fails, it is {@link TELEMETRY_CONFIG_DISABLED},
+ *    so no telemetry surface is offered on a guess.
+ *
+ * 2. ONE FETCH PER SHELL. `TelemetryConfigProvider`
+ *    (`contexts/TelemetryConfigContext.tsx`) fetches once around the
+ *    authenticated shell; `useTelemetryConfig()` reads that when present and
+ *    falls back to fetching for itself when rendered in isolation.
+ *
+ * The `telemetry` feature is ON when `available && enabled`: a store is
+ * deployed AND collection is switched on. `refresh()` is what the Telemetry
+ * settings page calls after a save.
+ */
+import { createContext, useCallback, useContext, useEffect, useMemo, useRef, useState } from 'react';
+import { isPlatformApiError, useOptionalPlatformHost } from '../../../core/index.js';
+import { createTelemetryClient } from '../services/client.js';
+import { useIsMounted } from '../../internal/useIsMounted.js';
+/**
+ * The answer assumed before the API has given one, and after it failed to.
+ *
+ * @stability experimental
+ */
+export const TELEMETRY_CONFIG_DISABLED = Object.freeze({
+    available: false,
+    enabled: false,
+    assistantEnabled: false,
+});
+/**
+ * The shell-wide answer; `null` means "no provider above this component".
+ *
+ * @stability experimental
+ */
+export const TelemetryConfigContext = createContext(null);
+/**
+ * Whether the `telemetry` settings feature is on for this answer.
+ *
+ * @stability experimental
+ */
+export function isTelemetryOn(config) {
+    return config.available === true && config.enabled === true;
+}
+/**
+ * The fetching implementation; `skip` makes it an inert stub.
+ *
+ * @stability experimental
+ */
+export function useTelemetryConfigQuery(options = {}) {
+    const { skip = false } = options;
+    // The provider is mounted around the platform host (the host reads the
+    // feature this answers), so it may take the transport as a prop; anywhere
+    // else the host's transport is used.
+    const hostApi = useOptionalPlatformHost()?.api;
+    const api = options.api ?? hostApi;
+    const client = useMemo(() => (api ? createTelemetryClient(api) : null), [api]);
+    const [config, setConfig] = useState(TELEMETRY_CONFIG_DISABLED);
+    const [isLoading, setIsLoading] = useState(!skip);
+    const [error, setError] = useState(null);
+    const loaded = useRef(false);
+    const isMounted = useIsMounted();
+    const fetchConfig = useCallback(async () => {
+        try {
+            if (!loaded.current && isMounted())
+                setIsLoading(true);
+            setError(null);
+            if (client === null) {
+                throw new Error('No platform host transport to read the telemetry configuration with');
+            }
+            const data = await client.getTelemetryConfig();
+            loaded.current = true;
+            if (isMounted())
+                setConfig(data);
+        }
+        catch (err) {
+            if (isMounted()) {
+                if (!loaded.current)
+                    setConfig(TELEMETRY_CONFIG_DISABLED);
+                setError(isPlatformApiError(err) ? err.message : 'Failed to load telemetry configuration');
+            }
+        }
+        finally {
+            if (isMounted())
+                setIsLoading(false);
+        }
+    }, [isMounted, client]);
+    useEffect(() => {
+        if (skip)
+            return;
+        void fetchConfig();
+    }, [fetchConfig, skip]);
+    return useMemo(() => ({ config, isLoading: skip ? false : isLoading, error, refresh: fetchConfig }), [config, isLoading, error, fetchConfig, skip]);
+}
+/**
+ * The telemetry configuration — the shell's shared copy when there is one.
+ *
+ * @stability experimental
+ */
+export function useTelemetryConfig() {
+    const shared = useContext(TelemetryConfigContext);
+    const own = useTelemetryConfigQuery({ skip: shared !== null });
+    return shared ?? own;
+}
+/**
+ * The `telemetry` entry of the registries' feature map — read from the shell's
+ * provider ONLY, never fetched (the navigation chrome renders in many isolated
+ * tests; without a provider it answers "off" with no request).
+ *
+ * @stability experimental
+ */
+export function useTelemetryFeatures() {
+    const shared = useContext(TelemetryConfigContext);
+    return { telemetry: shared ? isTelemetryOn(shared.config) : false };
+}
+//# sourceMappingURL=telemetryConfig.js.map

package/dist/telemetry/headless/context/telemetryConfig.js.map

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

package/dist/telemetry/headless/guards/RequireTelemetryEnabled.d.ts

@@ -0,0 +1,35 @@
+import type { ReactElement, ReactNode } from 'react';
+/**
+ * What {@link RequireTelemetryEnabled} takes.
+ *
+ * @stability experimental
+ */
+export interface RequireTelemetryEnabledProps {
+    /** The guarded route element. */
+    children: ReactNode;
+    /** Rendered when telemetry is off. Defaults to a replace-redirect to `/`. */
+    fallback?: ReactNode;
+    /**
+     * Rendered while the first answer is in flight. Defaults to the app's
+     * spinner adapter (`TelemetryWebAdapters.Spinner`), else nothing.
+     */
+    loading?: ReactNode;
+}
+/**
+ * Renders `children` only while the `telemetry` feature is on (a store is
+ * deployed AND collection is switched on).
+ *
+ * @param props - see {@link RequireTelemetryEnabledProps}.
+ * @returns the children, the loading element or the fallback.
+ *
+ * @example
+ * ```tsx
+ * <RequirePermission permission="telemetry:query">
+ *   <RequireTelemetryEnabled><TelemetryExplorerPage /></RequireTelemetryEnabled>
+ * </RequirePermission>
+ * ```
+ *
+ * @stability experimental
+ */
+export declare function RequireTelemetryEnabled({ children, fallback, loading, }: RequireTelemetryEnabledProps): ReactElement;
+//# sourceMappingURL=RequireTelemetryEnabled.d.ts.map

package/dist/telemetry/headless/guards/RequireTelemetryEnabled.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequireTelemetryEnabled.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/guards/RequireTelemetryEnabled.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMrD;;;;GAIG;AACH,MAAM,WAAW,4BAA4B;IAC3C,iCAAiC;IACjC,QAAQ,EAAE,SAAS,CAAC;IACpB,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,uBAAuB,CAAC,EACtC,QAAQ,EACR,QAAsC,EACtC,OAAO,GACR,EAAE,4BAA4B,GAAG,YAAY,CAO7C"}

package/dist/telemetry/headless/guards/RequireTelemetryEnabled.js

@@ -0,0 +1,44 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * Route guard: render `children` only while telemetry is available AND switched
+ * on in this deployment — issue #537, epic #528. Modelled on the app's
+ * `RequireAiEnabled`.
+ *
+ * The FEATURE half of a telemetry route's gate; the app's permission gate is
+ * the permission half, and the app nests this inside it. The Telemetry
+ * settings page does NOT use it: that page is where telemetry is switched on.
+ *
+ * While the first answer is in flight this renders the loading element rather
+ * than the fallback, so a deep link is not bounced home on the provisional
+ * "off".
+ */
+import { createElement } from 'react';
+import { Navigate } from 'react-router-dom';
+import { useTelemetryWebAdapters } from '../adapters/TelemetryWebAdapters.js';
+import { isTelemetryOn, useTelemetryConfig } from '../context/telemetryConfig.js';
+/**
+ * Renders `children` only while the `telemetry` feature is on (a store is
+ * deployed AND collection is switched on).
+ *
+ * @param props - see {@link RequireTelemetryEnabledProps}.
+ * @returns the children, the loading element or the fallback.
+ *
+ * @example
+ * ```tsx
+ * <RequirePermission permission="telemetry:query">
+ *   <RequireTelemetryEnabled><TelemetryExplorerPage /></RequireTelemetryEnabled>
+ * </RequirePermission>
+ * ```
+ *
+ * @stability experimental
+ */
+export function RequireTelemetryEnabled({ children, fallback = _jsx(Navigate, { to: "/", replace: true }), loading, }) {
+    const { config, isLoading } = useTelemetryConfig();
+    const { Spinner } = useTelemetryWebAdapters();
+    if (isLoading)
+        return _jsx(_Fragment, { children: loading ?? (Spinner ? createElement(Spinner) : null) });
+    if (!isTelemetryOn(config))
+        return _jsx(_Fragment, { children: fallback });
+    return _jsx(_Fragment, { children: children });
+}
+//# sourceMappingURL=RequireTelemetryEnabled.js.map

package/dist/telemetry/headless/guards/RequireTelemetryEnabled.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RequireTelemetryEnabled.js","sourceRoot":"","sources":["../../../../src/telemetry/headless/guards/RequireTelemetryEnabled.tsx"],"names":[],"mappings":";AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,qCAAqC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAmBlF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,uBAAuB,CAAC,EACtC,QAAQ,EACR,QAAQ,GAAG,KAAC,QAAQ,IAAC,EAAE,EAAC,GAAG,EAAC,OAAO,SAAG,EACtC,OAAO,GACsB;IAC7B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,kBAAkB,EAAE,CAAC;IACnD,MAAM,EAAE,OAAO,EAAE,GAAG,uBAAuB,EAAE,CAAC;IAE9C,IAAI,SAAS;QAAE,OAAO,4BAAG,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAI,CAAC;IAClF,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,4BAAG,QAAQ,GAAI,CAAC;IACnD,OAAO,4BAAG,QAAQ,GAAI,CAAC;AACzB,CAAC"}

package/dist/telemetry/headless/hooks/useTelemetryAdmin.d.ts

@@ -0,0 +1,40 @@
+import { type TelemetryAdminConfig, type TelemetrySettingsUpdate, type TelemetryStatus } from '../services/telemetry.js';
+/**
+ * What {@link useTelemetryAdmin} returns.
+ *
+ * @stability experimental
+ */
+export interface UseTelemetryAdminReturn {
+    /** The stored settings and their provenance, or `null` before the first load. */
+    config: TelemetryAdminConfig | null;
+    /** The latest diagnosis, or `null` before the first load. */
+    status: TelemetryStatus | null;
+    /** A (re)load is in flight. */
+    isLoading: boolean;
+    /** Why the config could not be loaded, or `null`. */
+    loadError: string | null;
+    /** Why the status could not be loaded, or `null`. */
+    statusError: string | null;
+    /** A save is in flight. */
+    isSaving: boolean;
+    /** Why the last save failed (other than a 409), or `null`. */
+    saveError: string | null;
+    /** True after a save was refused with 409 — someone else saved first. */
+    conflict: boolean;
+    /** Load the config and the status again. */
+    reload: () => Promise<void>;
+    /** Load the status again. */
+    refreshStatus: () => Promise<void>;
+    /** Resolves `true` on success. */
+    save: (settings: TelemetrySettingsUpdate) => Promise<boolean>;
+}
+/**
+ * The Telemetry settings page's data: `GET /admin/telemetry/config` and `GET /admin/telemetry/status` together, and a save with `If-Match: <version>` (a 409 sets `conflict`). Reads the platform host's transport.
+ *
+ * @returns the config, the status and the save action.
+ * @throws Error outside a `PlatformHostProvider`.
+ *
+ * @stability experimental
+ */
+export declare function useTelemetryAdmin(): UseTelemetryAdminReturn;
+//# sourceMappingURL=useTelemetryAdmin.d.ts.map

package/dist/telemetry/headless/hooks/useTelemetryAdmin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTelemetryAdmin.d.ts","sourceRoot":"","sources":["../../../../src/telemetry/headless/hooks/useTelemetryAdmin.ts"],"names":[],"mappings":"AAUA,OAAO,EACL,KAAK,oBAAoB,EACzB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACrB,MAAM,0BAA0B,CAAC;AAIlC;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,iFAAiF;IACjF,MAAM,EAAE,oBAAoB,GAAG,IAAI,CAAC;IACpC,6DAA6D;IAC7D,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;IAC/B,+BAA+B;IAC/B,SAAS,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,qDAAqD;IACrD,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,2BAA2B;IAC3B,QAAQ,EAAE,OAAO,CAAC;IAClB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,yEAAyE;IACzE,QAAQ,EAAE,OAAO,CAAC;IAClB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,6BAA6B;IAC7B,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,kCAAkC;IAClC,IAAI,EAAE,CAAC,QAAQ,EAAE,uBAAuB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/D;AAMD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,IAAI,uBAAuB,CAkF3D"}