@m4l/testing 0.0.23 → 1.0.1

package/types/libs/observability/mf/src/diagnosticPolicies/host.d.ts

@@ -0,0 +1,139 @@
+/**
+ * Host-owned diagnostic policy inventory.
+ */
+export declare const hostDiagnosticPolicyCatalog: {
+    readonly diagnosticSmoke: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/dev/smoke.ts"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-06-05";
+        readonly id: "gclickHostDiagnosticSmoke";
+        readonly key: "gclick_host.observability.diagnostic-smoke";
+        readonly notes: readonly ["This family is primarily exercised through the browser smoke helper and support overrides."];
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Provide one deterministic browser-log smoke signal before support investigates a live issue.";
+        readonly summary: "Manual host smoke proof for browser diagnostic-log delivery.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "gclick_host.observability.diagnostic-smoke";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly realtimeConnectionRecovery: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/host/realtime.ts"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-06-05";
+        readonly id: "gclickHostRealtimeConnectionRecovery";
+        readonly key: "gclick_host.realtime.connection-recovery";
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Capture host websocket transport recovery evidence without waiting for a broader outage investigation.";
+        readonly summary: "Host realtime reconnect recovery breadcrumbs.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "gclick_host.realtime.connection-recovery";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly realtimeTransportLifecycle: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/host/realtime.ts", "apps/gclick/gclick_host/src/layouts/PlatformLayout/helpers/createAtmosphereHostRealtimeRuntime.ts", "packages/realtime-runtime/src/transport/atmosphere/web/SourceDataAtmosphereWeb.ts"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-08-20";
+        readonly id: "gclickHostRealtimeTransportLifecycle";
+        readonly key: "gclick_host.realtime.transport-lifecycle";
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Capture host Atmosphere lifecycle breadcrumbs during temporary support investigations of reconnect storms and browser sleep recovery.";
+        readonly summary: "Host Atmosphere transport lifecycle breadcrumbs.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "gclick_host.realtime.transport-lifecycle";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly remoteDiagnosticProviderHealth: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/diagnostic/diagnosticFeatureFlags.ts"];
+        readonly controlPlane: "always-on";
+        readonly createdAt: "2026-06-08";
+        readonly id: "gclickHostRemoteDiagnosticProviderHealth";
+        readonly key: "gclick_host.feature-flags.remote-diagnostic-provider-health";
+        readonly notes: readonly ["This family is intentionally always-on because provider outages are recoverable anomalies, not optional debug breadcrumbs."];
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Report the first failure in a remote diagnostic-provider outage streak even when no support capture is active.";
+        readonly summary: "Host remote diagnostic-provider outage anomaly.";
+    };
+    readonly tracesRelayDisabled: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/otlp/client.ts", "apps/gclick/gclick_host/src/observability/otlp/relayDiagnostics.ts", "libs/observability/web/src/browserOtlp.ts"];
+        readonly controlPlane: "always-on";
+        readonly createdAt: "2026-06-16";
+        readonly id: "gclickHostTracesRelayDisabled";
+        readonly key: "gclick_host.observability.traces-relay-disabled";
+        readonly notes: readonly ["This family is intentionally always-on because once the browser traces relay disables itself, trace traffic becomes silent and support needs one surviving breadcrumb in Grafana logs."];
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Report the first permanent browser traces-relay shutdown together with the failure metadata that caused the relay to stop exporting.";
+        readonly summary: "Host browser traces-relay shutdown anomaly.";
+    };
+    readonly runtimeBoundaryCrash: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/host/runtimeErrors.ts", "packages/layouts/src/components/MFHostApp/MFHostAppErrorBoundary.tsx", "packages/layouts/src/components/MFRuntimeErrorWrapper/MFRuntimeErrorWrapper.tsx", "apps/gclick/gclick_host/src/components/HostShellErrorBoundary/HostShellErrorBoundary.tsx"];
+        readonly controlPlane: "always-on";
+        readonly createdAt: "2026-06-14";
+        readonly id: "gclickHostRuntimeBoundaryCrash";
+        readonly key: "gclick_host.runtime-errors.boundary-crash";
+        readonly notes: readonly ["This family is intentionally always-on because React boundary crashes are rare fatal degradations that should remain countable in Grafana logs, not only in traces.", "Host-loaded MF wrapper boundaries reuse this family with `runtime.boundary_scope=wrapper` and a stable `runtime.wrapper_id` so support can group contained subtree crashes without a separate policy."];
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Report contained host-shell and host-loaded MF boundary crashes as structured always-on diagnostic logs for dashboarding and alerting.";
+        readonly summary: "Host boundary crash anomaly for host shell and host-loaded MFs.";
+    };
+    readonly refreshDebug: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/gclick_host/src/observability/diagnostic/diagnosticFeatureFlags.ts"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-06-11";
+        readonly id: "gclickHostRefreshDebug";
+        readonly key: "gclick_host.feature-flags.refresh-debug";
+        readonly notes: readonly ["Use this family when support needs to understand why the browser refreshed, queued, or applied one remote diagnostic payload."];
+        readonly owner: {
+            readonly app: "gclick_host";
+            readonly runtime: "web";
+            readonly surface: "host";
+        };
+        readonly purpose: "Expose host-owned GrowthBook refresh breadcrumbs such as bootstrap, context, focus, visibility, poll, and queued refreshes.";
+        readonly summary: "Host remote diagnostic-provider refresh debug breadcrumbs.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "gclick_host.feature-flags.refresh-debug";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+};

package/types/libs/observability/mf/src/diagnosticPolicies/index.d.ts

@@ -0,0 +1,6 @@
+export { diagnosticPolicyCatalogByKey, diagnosticPolicyCatalogEntries, } from './catalog';
+export type { DiagnosticPolicyCatalogControlPlane, DiagnosticPolicyCatalogDate, DiagnosticPolicyCatalogEntry, DiagnosticPolicyCatalogOwner, DiagnosticPolicyCatalogRemoteLayer, DiagnosticPolicyCatalogRemoteProvider, DiagnosticPolicyCatalogRemoteRule, DiagnosticPolicyCatalogSurface, } from './contracts';
+export { diagnosticPolicyWebFeatureKey, diagnosticPolicyWebLayers, } from './contracts';
+export { hostDiagnosticPolicyCatalog } from './host';
+export { operativeMyGpsDevicesDiagnosticPolicyCatalog } from './operativeMyGpsDevices';
+export { sharedReportsListDiagnosticPolicyCatalog } from './sharedReportsList';

package/types/libs/observability/mf/src/diagnosticPolicies/operativeMyGpsDevices.d.ts

@@ -0,0 +1,104 @@
+/**
+ * `operative_my_gps_devices` diagnostic policy inventory.
+ */
+export declare const operativeMyGpsDevicesDiagnosticPolicyCatalog: {
+    readonly deviceSelectionMissingPosition: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/operative/operative_my_gps_devices/src/components/App/subcomponents/ModuleMap/subcomponents/MapContent/subcomponents/DevicesPanel/subcomponents/DevicesPanelBody/subcomponents/DeviceCard/DeviceCard.tsx"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-06-05";
+        readonly id: "operativeMyGpsDevicesDeviceSelectionMissingPosition";
+        readonly key: "operative_my_gps_devices.device-selection.missing-position";
+        readonly owner: {
+            readonly app: "operative_my_gps_devices";
+            readonly moduleId: "operative_my_gps_devices";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Capture the user-visible branch where one selected device has no finite GNSS position and the map must skip focus safely.";
+        readonly summary: "MF selection branch for devices without finite GNSS position.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "operative_my_gps_devices.device-selection.missing-position";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly motionCapture: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/operative/operative_my_gps_devices/src/components/App/subcomponents/ModuleMap/subcomponents/MapContent/subcomponents/DeviceMarker/helpers/motionCapture.ts", "apps/gclick/mfs/operative/operative_my_gps_devices/src/components/app_entries/ByIsolation/observability/smoke.ts"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-06-06";
+        readonly id: "operativeMyGpsDevicesMotionCapture";
+        readonly key: "operative_my_gps_devices.motion.capture";
+        readonly notes: readonly ["The closing session summary is treated as the final record of a policy-authorized capture session, not as a separate always-on anomaly lane."];
+        readonly owner: {
+            readonly app: "operative_my_gps_devices";
+            readonly moduleId: "operative_my_gps_devices";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Capture selected-device realtime ingress, motion-segment, and camera-follow evidence for support investigations.";
+        readonly summary: "MF targeted motion-capture diagnostic family.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "operative_my_gps_devices.motion.capture";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly realtimeTransportLifecycle: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/operative/operative_my_gps_devices/src/components/app_entries/ByIsolation/helpers/createIsolationHostRuntime.ts", "apps/gclick/mfs/operative/operative_my_gps_devices/src/components/app_entries/ByIsolation/observability/realtime.ts", "packages/realtime-runtime/src/transport/atmosphere/web/SourceDataAtmosphereWeb.ts"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-08-20";
+        readonly id: "operativeMyGpsDevicesRealtimeTransportLifecycle";
+        readonly key: "operative_my_gps_devices.realtime.transport-lifecycle";
+        readonly owner: {
+            readonly app: "operative_my_gps_devices";
+            readonly moduleId: "operative_my_gps_devices";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Capture isolation Atmosphere lifecycle breadcrumbs during temporary support investigations of reconnect storms and browser sleep recovery.";
+        readonly summary: "My GPS Devices isolation Atmosphere transport lifecycle breadcrumbs.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "operative_my_gps_devices.realtime.transport-lifecycle";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly recoverableLeafletRuntime: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/operative/operative_my_gps_devices/src/components/App/subcomponents/ModuleMap/subcomponents/MapContent/subcomponents/DeviceMarker/helpers/reportLeafletRuntimeError.ts"];
+        readonly controlPlane: "always-on";
+        readonly createdAt: "2026-06-05";
+        readonly id: "operativeMyGpsDevicesRecoverableLeafletRuntime";
+        readonly key: "operative_my_gps_devices.recoverable.leaflet-runtime";
+        readonly owner: {
+            readonly app: "operative_my_gps_devices";
+            readonly moduleId: "operative_my_gps_devices";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Expose recovered Leaflet runtime anomalies that should never stay silent even without one active support capture.";
+        readonly summary: "MF always-on recovered Leaflet runtime anomaly.";
+    };
+    readonly remoteDiagnosticProviderHealth: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/operative/operative_my_gps_devices/src/components/app_entries/ByIsolation/observability/diagnosticFeatureFlags.ts"];
+        readonly controlPlane: "always-on";
+        readonly createdAt: "2026-06-08";
+        readonly id: "operativeMyGpsDevicesRemoteDiagnosticProviderHealth";
+        readonly key: "operative_my_gps_devices.feature-flags.remote-diagnostic-provider-health";
+        readonly owner: {
+            readonly app: "operative_my_gps_devices";
+            readonly moduleId: "operative_my_gps_devices";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Report isolation remote diagnostic-provider outages even when the active session has no support policy enabled.";
+        readonly summary: "MF isolation remote diagnostic-provider outage anomaly.";
+    };
+};

package/types/libs/observability/mf/src/diagnosticPolicies/sharedReportsList.d.ts

@@ -0,0 +1,44 @@
+/**
+ * `shared_reports_list` diagnostic policy inventory.
+ */
+export declare const sharedReportsListDiagnosticPolicyCatalog: {
+    readonly reportsDebug: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/shared/shared_reports_list/src/components/App/context/ReportContext"];
+        readonly controlPlane: "remote-policy";
+        readonly createdAt: "2026-08-22";
+        readonly id: "sharedReportsListReportsDebug";
+        readonly key: "shared_reports_list.feature-flags.reports-debug";
+        readonly notes: readonly ["Fallback product gate hosted in observability only because a dedicated product feature-flag library was not approved.", "This policy must not be used to emit diagnostic logs; shared_reports_list reads only isEnabled(key).", "Migrate to a product feature-flag library when that boundary becomes available."];
+        readonly owner: {
+            readonly app: "shared_reports_list";
+            readonly moduleId: "shared_reports_list";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Allow support-enabled sessions to remove the reports/types test-worker exclusion filter.";
+        readonly summary: "Fallback product gate for the shared reports test report type.";
+        readonly remoteRule: {
+            readonly featureKey: "gclick-frontend-diagnostic-policies";
+            readonly payloadKey: "shared_reports_list.feature-flags.reports-debug";
+            readonly provider: "growthbook";
+            readonly supportedLayers: readonly ["moduleDefault", "accountOverride"];
+        };
+    };
+    readonly remoteDiagnosticProviderHealth: {
+        readonly active: true;
+        readonly codePaths: readonly ["apps/gclick/mfs/shared/shared_reports_list/src/components/appEntries/ByIsolation/observability/diagnosticFeatureFlags.ts"];
+        readonly controlPlane: "always-on";
+        readonly createdAt: "2026-08-24";
+        readonly id: "sharedReportsListRemoteDiagnosticProviderHealth";
+        readonly key: "shared_reports_list.feature-flags.remote-diagnostic-provider-health";
+        readonly owner: {
+            readonly app: "shared_reports_list";
+            readonly moduleId: "shared_reports_list";
+            readonly runtime: "web";
+            readonly surface: "mf";
+        };
+        readonly purpose: "Report isolation remote diagnostic-provider outages even when report debug is disabled.";
+        readonly summary: "MF isolation remote diagnostic-provider outage anomaly.";
+    };
+};

package/types/libs/observability/mf/src/diagnosticPolicyKeys.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Shared host-owned diagnostic policy keys derived from the catalog inventory.
+ */
+export declare const hostDiagnosticPolicyKeys: {
+    readonly diagnosticSmoke: "gclick_host.observability.diagnostic-smoke";
+    readonly realtimeConnectionRecovery: "gclick_host.realtime.connection-recovery";
+    readonly realtimeTransportLifecycle: "gclick_host.realtime.transport-lifecycle";
+    readonly remoteDiagnosticProviderHealth: "gclick_host.feature-flags.remote-diagnostic-provider-health";
+    readonly tracesRelayDisabled: "gclick_host.observability.traces-relay-disabled";
+    readonly runtimeBoundaryCrash: "gclick_host.runtime-errors.boundary-crash";
+    readonly refreshDebug: "gclick_host.feature-flags.refresh-debug";
+};
+/**
+ * Shared `operative_my_gps_devices` diagnostic policy keys derived from the catalog inventory.
+ */
+export declare const operativeMyGpsDevicesDiagnosticPolicyKeys: {
+    readonly deviceSelectionMissingPosition: "operative_my_gps_devices.device-selection.missing-position";
+    readonly motionCapture: "operative_my_gps_devices.motion.capture";
+    readonly realtimeTransportLifecycle: "operative_my_gps_devices.realtime.transport-lifecycle";
+    readonly recoverableLeafletRuntime: "operative_my_gps_devices.recoverable.leaflet-runtime";
+    readonly remoteDiagnosticProviderHealth: "operative_my_gps_devices.feature-flags.remote-diagnostic-provider-health";
+};
+/**
+ * Shared `shared_reports_list` diagnostic policy keys derived from the catalog inventory.
+ */
+export declare const sharedReportsListDiagnosticPolicyKeys: {
+    readonly reportsDebug: "shared_reports_list.feature-flags.reports-debug";
+    readonly remoteDiagnosticProviderHealth: "shared_reports_list.feature-flags.remote-diagnostic-provider-health";
+};
+type ValueOf<RecordType extends Record<string, string>> = RecordType[keyof RecordType];
+export type HostDiagnosticPolicyKey = ValueOf<typeof hostDiagnosticPolicyKeys>;
+export type OperativeMyGpsDevicesDiagnosticPolicyKey = ValueOf<typeof operativeMyGpsDevicesDiagnosticPolicyKeys>;
+export type SharedReportsListDiagnosticPolicyKey = ValueOf<typeof sharedReportsListDiagnosticPolicyKeys>;
+export {};

package/types/libs/observability/mf/src/index.d.ts

@@ -0,0 +1,14 @@
+export type { MobileTelemetryContext, MobileTelemetryEvent, MobileTelemetrySurface, ModuleLoadFailureReason, ModuleLoadSource, ModuleUnmountReason, TelemetryContext, TelemetryEvent, TelemetryEventFor, TelemetryRuntimeKind, TelemetrySurface, WebTelemetryContext, WebTelemetryEvent, WebTelemetrySurface, } from './telemetry';
+export { telemetryAttributeKeys } from './telemetry';
+export { browserRuntimeHandles, browserRuntimeHandleCatalog, browserRuntimeHandleCatalogByKey, browserRuntimeHandleCatalogEntries, browserRuntimeHandleCarriers, browserRuntimeHandleCleanupModes, browserRuntimeHandleKinds, browserRuntimeHandleLifecycles, browserRuntimeHandleNamingStatuses, browserRuntimeHandleStabilities, gclickGoogleMapsLoaderStateHandle, gclickRealtimeDummyPlaybackDriverHandle, gpsDevicesClusterPolicyDebugHandle, gpsDevicesDevicePanelHydrationDriverHandle, gpsDevicesDocumentVisibilityDriverHandle, gpsDevicesHiddenTabDummyPlaybackShimHandle, gpsDevicesHiddenTabVisibilityShimHandle, gpsDevicesNonSelectedViewportGateZoomSettleHandle, gpsDevicesSparseRotationStationaryWaitHandle, gpsDevicesViewportTraceEnabledHandle, gpsDevicesViewportTraceHandle, hostAlarmSmokeToolsHandle, layoutsMfRuntimeErrorsHandle, observabilitySmokeToolsHandle, realtimePerformanceDebugHandle, realtimeTransportDebugHandle, realtimeRuntimeRegistryHandle, } from './browserRuntimeHandles';
+export { browserRuntimeHandleCatalog as browserRuntimeHandlesCatalog, } from './browserRuntimeHandles';
+export { dispatchMFRuntimeBoundarySmokeCrashRequest, mfRuntimeBoundarySmokeCrashEventType, } from './runtimeSmoke';
+export { hostDiagnosticPolicyKeys, operativeMyGpsDevicesDiagnosticPolicyKeys, sharedReportsListDiagnosticPolicyKeys, } from './diagnosticPolicyKeys';
+export { diagnosticPolicyCatalogByKey, diagnosticPolicyCatalogEntries, diagnosticPolicyWebFeatureKey, diagnosticPolicyWebLayers, hostDiagnosticPolicyCatalog, operativeMyGpsDevicesDiagnosticPolicyCatalog, sharedReportsListDiagnosticPolicyCatalog, } from './diagnosticPolicies';
+export { hostDiagnosticPolicyCatalog as hostDiagnosticPolicies, operativeMyGpsDevicesDiagnosticPolicyCatalog as operativeMyGpsDevicesDiagnosticPolicies, sharedReportsListDiagnosticPolicyCatalog as sharedReportsListDiagnosticPolicies, } from './diagnosticPolicies';
+export { noopMFObservabilityService } from './diagnosticLogging';
+export type { DiagnosticLogActivationMode, DiagnosticAttributeValue, DiagnosticLogKind, DiagnosticLogLevel, DiagnosticLogRecord, DiagnosticPolicy, DiagnosticPolicyScope, DiagnosticPolicySource, DiagnosticPolicyTarget, DiagnosticPolicyTargetId, DiagnosticPolicyTransport, MFObservabilityService, ObservabilityService, } from './diagnosticLogging';
+export type { HostDiagnosticPolicyKey, OperativeMyGpsDevicesDiagnosticPolicyKey, SharedReportsListDiagnosticPolicyKey, } from './diagnosticPolicyKeys';
+export type { BrowserRuntimeHandleCarrier, BrowserRuntimeHandleCleanup, BrowserRuntimeHandleDefinition, BrowserRuntimeGlobalThisHandleDefinition, BrowserRuntimeHandleId, BrowserRuntimeHandleKind, BrowserRuntimeHandleKey, BrowserRuntimeHandleLifecycle, BrowserRuntimeHandleNamingStatus, BrowserRuntimeSymbolHandleDefinition, BrowserRuntimeHandleStability, BrowserRuntimeWindowHandleDefinition, } from './browserRuntimeHandles';
+export type { MFRuntimeBoundarySmokeCrashDetail, } from './runtimeSmoke';
+export type { DiagnosticPolicyCatalogControlPlane, DiagnosticPolicyCatalogDate, DiagnosticPolicyCatalogEntry, DiagnosticPolicyCatalogOwner, DiagnosticPolicyCatalogRemoteLayer, DiagnosticPolicyCatalogRemoteProvider, DiagnosticPolicyCatalogRemoteRule, DiagnosticPolicyCatalogSurface, } from './diagnosticPolicies';

package/types/libs/observability/mf/src/runtimeSmoke.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Shared browser event used to request one intentional MF boundary crash from
+ * a host-loaded microfrontend during preview or local diagnostics.
+ */
+export declare const mfRuntimeBoundarySmokeCrashEventType: "m4l.observability.smoke.mf-runtime-boundary-crash-requested";
+export interface MFRuntimeBoundarySmokeCrashDetail {
+    message?: string;
+    moduleId?: string;
+}
+/**
+ * Dispatch one intentional MF boundary crash request into the current browser window.
+ */
+export declare function dispatchMFRuntimeBoundarySmokeCrashRequest(detail?: MFRuntimeBoundarySmokeCrashDetail): void;

package/types/libs/observability/mf/src/telemetry.d.ts

@@ -0,0 +1,2 @@
+export type { MobileTelemetryContext, MobileTelemetryEvent, MobileTelemetrySurface, ModuleLoadFailureReason, ModuleLoadSource, ModuleUnmountReason, TelemetryContext, TelemetryEvent, TelemetryEventFor, TelemetryRuntimeKind, TelemetrySurface, WebTelemetryContext, WebTelemetryEvent, WebTelemetrySurface, } from '@m4l/observability/shared';
+export { telemetryAttributeKeys } from '@m4l/observability/shared';

package/types/libs/observability/shared/src/diagnosticLogging.d.ts

@@ -0,0 +1,97 @@
+import type { TelemetryContext } from './telemetry';
+/**
+ * Supported destinations for diagnostic records.
+ */
+export type DiagnosticPolicyTransport = 'internal' | 'otlp';
+/**
+ * Supported structured diagnostic record families.
+ */
+export type DiagnosticLogKind = 'audit' | 'diagnostic' | 'feature-flag' | 'integration' | 'recoverable-error';
+/**
+ * Supported diagnostic severities.
+ */
+export type DiagnosticLogLevel = 'debug' | 'info' | 'warn' | 'error';
+/**
+ * Supported activation modes for structured diagnostic records.
+ */
+export type DiagnosticLogActivationMode = 'always' | 'policy';
+/**
+ * Supported policy sources ordered by host-owned precedence tiers.
+ */
+export type DiagnosticPolicySource = 'account-override' | 'dev-override' | 'kill-switch' | 'module-default' | 'security-block' | 'support-override';
+/**
+ * Low-cardinality primitive attribute values allowed in diagnostic records.
+ */
+export type DiagnosticAttributeValue = boolean | number | string;
+/**
+ * Scope metadata attached to one resolved diagnostic policy.
+ */
+export interface DiagnosticPolicyScope {
+    accountId?: number;
+    moduleId?: string;
+    sessionId?: string;
+    userId?: string;
+}
+/**
+ * One resource-oriented capture target carried by a diagnostic policy.
+ *
+ * Keep the shape domain-agnostic so each app can decide whether one target
+ * applies to `device`, `vehicle`, `route`, or another resource family it
+ * understands locally.
+ */
+export type DiagnosticPolicyTargetId = number | string;
+export interface DiagnosticPolicyTarget {
+    ids: DiagnosticPolicyTargetId[];
+    resourceType: string;
+}
+/**
+ * Shared diagnostic policy contract resolved by the owning runtime.
+ */
+export interface DiagnosticPolicy {
+    categories?: string[];
+    enabled: boolean;
+    expiresAt?: string;
+    level?: DiagnosticLogLevel;
+    sampleRate?: number;
+    scope?: DiagnosticPolicyScope;
+    source?: DiagnosticPolicySource;
+    targets?: DiagnosticPolicyTarget[];
+    transport?: DiagnosticPolicyTransport;
+}
+/**
+ * Structured diagnostic record emitted by one application runtime.
+ */
+export interface DiagnosticLogRecord {
+    activationMode?: DiagnosticLogActivationMode;
+    attributes?: Record<string, DiagnosticAttributeValue>;
+    code: string;
+    context: TelemetryContext;
+    detail?: Record<string, unknown>;
+    kind: DiagnosticLogKind;
+    level: DiagnosticLogLevel;
+    message: string;
+    occurredAtMs?: number;
+    policyKey: string;
+}
+/**
+ * Runtime-facing observability service injected into application trees.
+ */
+export interface ObservabilityService {
+    getPolicyRevision?: () => number;
+    getPolicy: (policyKey: string) => DiagnosticPolicy | undefined;
+    isEnabled: (policyKey: string) => boolean;
+    log: (record: DiagnosticLogRecord) => void;
+    subscribePolicyChanges?: (listener: () => void) => () => void;
+}
+/**
+ * Backward-compatible service alias for existing MF consumers.
+ */
+export type MFObservabilityService = ObservabilityService;
+/**
+ * Keep one silent fallback service so missing wiring never breaks feature code.
+ */
+export declare const noopObservabilityService: ObservabilityService;
+/**
+ * Backward-compatible noop alias for existing MF consumers.
+ */
+export declare const noopMFObservabilityService: ObservabilityService;

package/types/libs/observability/shared/src/index.d.ts

@@ -0,0 +1,6 @@
+export type { DiagnosticAttributeValue, DiagnosticLogActivationMode, DiagnosticLogKind, DiagnosticLogLevel, DiagnosticLogRecord, DiagnosticPolicy, DiagnosticPolicyScope, DiagnosticPolicySource, DiagnosticPolicyTarget, DiagnosticPolicyTargetId, DiagnosticPolicyTransport, MFObservabilityService, ObservabilityService, } from './diagnosticLogging';
+export { noopMFObservabilityService, noopObservabilityService } from './diagnosticLogging';
+export type { MobileTelemetryContext, MobileTelemetryEvent, MobileTelemetrySurface, ModuleLoadFailureReason, ModuleLoadSource, ModuleUnmountReason, TelemetryContext, TelemetryEvent, TelemetryEventFor, TelemetryRuntimeKind, TelemetrySurface, WebTelemetryContext, WebTelemetryEvent, WebTelemetrySurface, } from './telemetry';
+export { telemetryAttributeKeys } from './telemetry';
+export type { SharedGlobalThisHandleDefinition } from './runtimeHandles';
+export { gclickRealtimeDummyPlaybackDriverHandle, realtimeRuntimeRegistryHandle, } from './runtimeHandles';

package/types/libs/observability/shared/src/runtimeHandles.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Neutral `globalThis` handle definition safe for web and React Native callers.
+ */
+export interface SharedGlobalThisHandleDefinition<TProperty extends `__${string}` = `__${string}`> {
+    id: string;
+    key: `globalThis.${TProperty}`;
+    property: TProperty;
+    purpose: string;
+}
+/**
+ * Shared realtime runtime registry handle used by multiplatform runtime packages.
+ */
+export declare const realtimeRuntimeRegistryHandle: Readonly<{
+    readonly id: "realtime.runtime-registry";
+    readonly key: "globalThis.__M4L_REALTIME_RUNTIMES__";
+    readonly property: "__M4L_REALTIME_RUNTIMES__";
+    readonly purpose: "Store the shared realtime runtime registry for the current JavaScript runtime.";
+}>;
+/**
+ * Shared dummy playback driver handle used by deterministic realtime tests.
+ */
+export declare const gclickRealtimeDummyPlaybackDriverHandle: Readonly<{
+    readonly id: "gclick-realtime.dummy-playback-driver";
+    readonly key: "globalThis.__M4L_TEST_DUMMY_PLAYBACK_DRIVER__";
+    readonly property: "__M4L_TEST_DUMMY_PLAYBACK_DRIVER__";
+    readonly purpose: "Expose the dummy realtime playback driver for deterministic probes and tests.";
+}>;