@duffcloudservices/telemetry 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# @duffcloudservices/telemetry
+
+Shared **Azure Application Insights** telemetry for DCS Vue sites. One place owns
+the App Insights config and the `useTelemetry` composable, so every DCS surface
+(marketing `web/`, generated customer sites) gets the same behavior — including
+the fleet-wide **bfcache / Lighthouse unload fix**.
+
+## Why this package exists
+
+The App Insights JavaScript SDK, by default, registers a listener on the
+deprecated **`unload`** event. That:
+
+- makes pages ineligible for the browser **back/forward cache (bfcache)**, and
+- trips the Lighthouse **"avoid `unload` event listeners"** best-practices audit
+  (~19 points — enough to pin flagship sites at Best-Practices 54).
+
+The fix is a single config field — [`disablePageUnloadEvents: ['unload']`][ai-cfg]
+— which tells the SDK to skip the `unload` hook while still flushing telemetry on
+`pagehide` / `visibilitychange` (the supported path). This package bakes that
+into the **default** config so no consumer can forget it.
+
+[ai-cfg]: https://microsoft.github.io/ApplicationInsights-JS/PageUnloadEvents.html
+
+## Install
+
+```bash
+pnpm add @duffcloudservices/telemetry
+# peers you already have on a DCS Vue site:
+pnpm add @microsoft/applicationinsights-web vue
+```
+
+## Usage — composable (SPA / eager)
+
+The connection string, cloud role, environment and app version are supplied by
+the consumer (read your own `import.meta.env` / build defines and pass plain
+values in), keeping this package portable.
+
+```ts
+import { useTelemetry } from '@duffcloudservices/telemetry'
+
+const telemetry = useTelemetry({
+  connectionString: import.meta.env.VITE_APP_INSIGHTS_CONNECTION_STRING,
+  instrumentationKey: import.meta.env.VITE_APP_INSIGHTS_INSTRUMENT_KEY,
+  cloudRole: 'dcs-web',
+  dev: import.meta.env.DEV,
+  environment: import.meta.env.MODE,
+  appVersion: __APP_VERSION__,
+})
+
+telemetry.initialize() // synchronous; no-op (with a loud one-shot warn) when unconfigured
+telemetry.trackCtaClick('hero-cta', '/contact')
+```
+
+`initialize()` is **synchronous** because the SDK is statically imported.
+
+## Usage — config only (lazy / inert loaders)
+
+Sites that lazy-load the SDK themselves (to stay inert when telemetry is
+unconfigured) can import just the config — no SDK is pulled in:
+
+```ts
+import { createTelemetryConfig } from '@duffcloudservices/telemetry/config'
+
+const { ApplicationInsights } = await import('@microsoft/applicationinsights-web')
+const ai = new ApplicationInsights({
+  config: createTelemetryConfig({ connectionString: cs, enableAutoRouteTracking: false }),
+})
+ai.loadAppInsights()
+```
+
+## API
+
+| Export | Description |
+| --- | --- |
+| `useTelemetry(options?)` | Full composable: `initialize`, `trackEvent`, `trackPageView`, `trackCtaClick`, `trackException`, `trackMetric`, `trackDependency`, `flush`, `startTrackPage`, `stopTrackPage`, plus `isEnabled` / `isInitialized` / `initializationError` refs. |
+| `createTelemetryConfig(options?)` | Builds the App Insights config with DCS defaults + the `disablePageUnloadEvents: ['unload']` fix. Pure, no SDK import. |
+| `DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS` | `['unload']` — the disabled-events default. |
+| `DEFAULT_CLOUD_ROLE` | `'dcs-site'`. |
+| types | `TelemetryOptions`, `TelemetryConfigOptions`, `ApplicationInsightsConfig`, `TelemetryEvent`, `TelemetryPageView`, `TelemetryException`, `TelemetryDependency`, `TelemetryMetric`. |
+
+### `TelemetryOptions`
+
+| Option | Default | Notes |
+| --- | --- | --- |
+| `connectionString` / `instrumentationKey` | — | at least one enables telemetry |
+| `cloudRole` | `'dcs-site'` | `ai.cloud.role` + `app_name` property |
+| `appVersion` | `window.__APP_VERSION__` ?? `'unknown'` | stamped on every event |
+| `environment` | `'unknown'` | e.g. `import.meta.env.MODE` |
+| `dev` | `false` | verbose SDK logging when `true` |
+| `enableAutoRouteTracking` | `true` | SDK built-in SPA route tracking |
+| `disablePageUnloadEvents` | `['unload']` | **the fix** — override only if you know why |
+| `overrides` | — | deep `Partial<ApplicationInsightsConfig>`, applied last |
+
+## License
+
+MIT © Duff Cloud Services

package/dist/chunk-MX6WFWG4.js

@@ -0,0 +1,60 @@
+// src/config.ts
+var DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS = ["unload"];
+var DEFAULT_CLOUD_ROLE = "dcs-site";
+var DEFAULT_CORRELATION_HEADER_DOMAINS = [
+  "localhost",
+  "127.0.0.1",
+  "*.duffcloudservices.com"
+];
+var DEFAULT_CORRELATION_HEADER_EXCLUDED_DOMAINS = [
+  "*.googleapis.com",
+  "*.stripe.com",
+  "*.auth0.com",
+  "*.linkedin.com",
+  "*.github.com",
+  "*.microsoft.com",
+  "*.microsoftonline.com"
+];
+function createTelemetryConfig(options = {}) {
+  const {
+    connectionString,
+    instrumentationKey,
+    enableAutoRouteTracking = true,
+    dev = false,
+    disablePageUnloadEvents = [...DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS],
+    overrides
+  } = options;
+  const config = {
+    connectionString,
+    instrumentationKey,
+    // ── BP-54 fleet fix ──────────────────────────────────────────────────
+    // Never register a listener on the deprecated `unload` event. Keeping it
+    // out restores back/forward-cache eligibility and clears the Lighthouse
+    // "avoid unload event listeners" audit (~19 best-practices points). The
+    // SDK still flushes on pagehide/visibilitychange, so telemetry is intact.
+    disablePageUnloadEvents: [...disablePageUnloadEvents],
+    enableAutoRouteTracking,
+    enableCorsCorrelation: true,
+    enableRequestHeaderTracking: true,
+    enableResponseHeaderTracking: true,
+    autoTrackPageVisitTime: true,
+    enableAjaxErrorStatusText: true,
+    enableAjaxPerfTracking: true,
+    disableExceptionTracking: false,
+    disableTelemetry: false,
+    loggingLevelConsole: dev ? 1 : 2,
+    loggingLevelTelemetry: dev ? 1 : 2,
+    samplingPercentage: 100,
+    isCookieUseDisabled: false,
+    distributedTracingMode: 2,
+    correlationHeaderDomains: [...DEFAULT_CORRELATION_HEADER_DOMAINS],
+    correlationHeaderExcludedDomains: [...DEFAULT_CORRELATION_HEADER_EXCLUDED_DOMAINS],
+    ...overrides
+  };
+  config.disablePageUnloadEvents = [...disablePageUnloadEvents];
+  return config;
+}
+
+export { DEFAULT_CLOUD_ROLE, DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS, createTelemetryConfig };
+//# sourceMappingURL=chunk-MX6WFWG4.js.map
+//# sourceMappingURL=chunk-MX6WFWG4.js.map

package/dist/chunk-MX6WFWG4.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"names":[],"mappings":";AASO,IAAM,kCAAA,GAAwD,CAAC,QAAQ;AAGvE,IAAM,kBAAA,GAAqB;AAGlC,IAAM,kCAAA,GAAwD;AAAA,EAC5D,WAAA;AAAA,EACA,WAAA;AAAA,EACA;AACF,CAAA;AAGA,IAAM,2CAAA,GAAiE;AAAA,EACrE,kBAAA;AAAA,EACA,cAAA;AAAA,EACA,aAAA;AAAA,EACA,gBAAA;AAAA,EACA,cAAA;AAAA,EACA,iBAAA;AAAA,EACA;AACF,CAAA;AAeO,SAAS,qBAAA,CACd,OAAA,GAAkC,EAAC,EACR;AAC3B,EAAA,MAAM;AAAA,IACJ,gBAAA;AAAA,IACA,kBAAA;AAAA,IACA,uBAAA,GAA0B,IAAA;AAAA,IAC1B,GAAA,GAAM,KAAA;AAAA,IACN,uBAAA,GAA0B,CAAC,GAAG,kCAAkC,CAAA;AAAA,IAChE;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,MAAA,GAAoC;AAAA,IACxC,gBAAA;AAAA,IACA,kBAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,uBAAA,EAAyB,CAAC,GAAG,uBAAuB,CAAA;AAAA,IACpD,uBAAA;AAAA,IACA,qBAAA,EAAuB,IAAA;AAAA,IACvB,2BAAA,EAA6B,IAAA;AAAA,IAC7B,4BAAA,EAA8B,IAAA;AAAA,IAC9B,sBAAA,EAAwB,IAAA;AAAA,IACxB,yBAAA,EAA2B,IAAA;AAAA,IAC3B,sBAAA,EAAwB,IAAA;AAAA,IACxB,wBAAA,EAA0B,KAAA;AAAA,IAC1B,gBAAA,EAAkB,KAAA;AAAA,IAClB,mBAAA,EAAqB,MAAM,CAAA,GAAI,CAAA;AAAA,IAC/B,qBAAA,EAAuB,MAAM,CAAA,GAAI,CAAA;AAAA,IACjC,kBAAA,EAAoB,GAAA;AAAA,IACpB,mBAAA,EAAqB,KAAA;AAAA,IACrB,sBAAA,EAAwB,CAAA;AAAA,IACxB,wBAAA,EAA0B,CAAC,GAAG,kCAAkC,CAAA;AAAA,IAChE,gCAAA,EAAkC,CAAC,GAAG,2CAA2C,CAAA;AAAA,IACjF,GAAG;AAAA,GACL;AAOA,EAAA,MAAA,CAAO,uBAAA,GAA0B,CAAC,GAAG,uBAAuB,CAAA;AAE5D,EAAA,OAAO,MAAA;AACT","file":"chunk-MX6WFWG4.js","sourcesContent":["import type { ApplicationInsightsConfig, TelemetryConfigOptions } from './types'\n\n/**\n * The page-unload events the DCS default config tells the App Insights web SDK\n * to leave un-hooked. Only the deprecated `unload` event is disabled — the SDK\n * still hooks `pagehide` / `visibilitychange` (the supported flush path), so no\n * telemetry is lost, back/forward-cache eligibility is restored, and the\n * Lighthouse \"avoid `unload` event listeners\" audit passes.\n */\nexport const DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS: readonly string[] = ['unload']\n\n/** Cloud-role default when a consumer does not name itself. */\nexport const DEFAULT_CLOUD_ROLE = 'dcs-site'\n\n/** Correlation is added to first-party requests to these domains. */\nconst DEFAULT_CORRELATION_HEADER_DOMAINS: readonly string[] = [\n  'localhost',\n  '127.0.0.1',\n  '*.duffcloudservices.com',\n]\n\n/** Correlation headers are never attached to these third-party domains. */\nconst DEFAULT_CORRELATION_HEADER_EXCLUDED_DOMAINS: readonly string[] = [\n  '*.googleapis.com',\n  '*.stripe.com',\n  '*.auth0.com',\n  '*.linkedin.com',\n  '*.github.com',\n  '*.microsoft.com',\n  '*.microsoftonline.com',\n]\n\n/**\n * Build the App Insights web SDK config with DCS's shared defaults.\n *\n * The DEFAULT always includes {@link DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS}\n * (`disablePageUnloadEvents: ['unload']`) — the fleet-wide bfcache / Lighthouse\n * best-practices fix. Callers only need to supply their connection string; every\n * field is overridable via the typed options (and the escape-hatch `overrides`).\n *\n * This function performs no SDK import and reads no `import.meta.env` — it is\n * pure, so it is safe to call from lazy/inert telemetry loaders (the SDK is only\n * pulled in when the composable, or the consumer, actually constructs\n * `ApplicationInsights`).\n */\nexport function createTelemetryConfig(\n  options: TelemetryConfigOptions = {},\n): ApplicationInsightsConfig {\n  const {\n    connectionString,\n    instrumentationKey,\n    enableAutoRouteTracking = true,\n    dev = false,\n    disablePageUnloadEvents = [...DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS],\n    overrides,\n  } = options\n\n  const config: ApplicationInsightsConfig = {\n    connectionString,\n    instrumentationKey,\n    // ── BP-54 fleet fix ──────────────────────────────────────────────────\n    // Never register a listener on the deprecated `unload` event. Keeping it\n    // out restores back/forward-cache eligibility and clears the Lighthouse\n    // \"avoid unload event listeners\" audit (~19 best-practices points). The\n    // SDK still flushes on pagehide/visibilitychange, so telemetry is intact.\n    disablePageUnloadEvents: [...disablePageUnloadEvents],\n    enableAutoRouteTracking,\n    enableCorsCorrelation: true,\n    enableRequestHeaderTracking: true,\n    enableResponseHeaderTracking: true,\n    autoTrackPageVisitTime: true,\n    enableAjaxErrorStatusText: true,\n    enableAjaxPerfTracking: true,\n    disableExceptionTracking: false,\n    disableTelemetry: false,\n    loggingLevelConsole: dev ? 1 : 2,\n    loggingLevelTelemetry: dev ? 1 : 2,\n    samplingPercentage: 100,\n    isCookieUseDisabled: false,\n    distributedTracingMode: 2,\n    correlationHeaderDomains: [...DEFAULT_CORRELATION_HEADER_DOMAINS],\n    correlationHeaderExcludedDomains: [...DEFAULT_CORRELATION_HEADER_EXCLUDED_DOMAINS],\n    ...overrides,\n  }\n\n  // Re-assert the unload fix AFTER the overrides spread so a caller that passes\n  // `overrides` can never accidentally re-enable the deprecated `unload` listener\n  // and regress the fleet-wide BP-54 / bfcache fix. A caller that genuinely needs\n  // a different unload policy sets `disablePageUnloadEvents` via the dedicated\n  // option (applied above), not through `overrides`.\n  config.disablePageUnloadEvents = [...disablePageUnloadEvents]\n\n  return config\n}\n"]}

package/dist/config-BPmCpvmt.d.ts

@@ -0,0 +1,123 @@
+import { IConfiguration, IConfig } from '@microsoft/applicationinsights-web';
+
+/**
+ * The concrete config shape accepted by the App Insights web SDK's
+ * `ApplicationInsights` constructor (`{ config }`). The SDK types the field as
+ * `IConfiguration & IConfig`; `disablePageUnloadEvents` lives on `IConfiguration`.
+ */
+type ApplicationInsightsConfig = IConfiguration & IConfig;
+interface TelemetryEvent {
+    name: string;
+    properties?: Record<string, string>;
+    measurements?: Record<string, number>;
+}
+interface TelemetryPageView {
+    name?: string;
+    uri?: string;
+    properties?: Record<string, string>;
+    measurements?: Record<string, number>;
+}
+interface TelemetryException {
+    exception: Error;
+    properties?: Record<string, string>;
+    measurements?: Record<string, number>;
+}
+interface TelemetryDependency {
+    name: string;
+    data: string;
+    duration: number;
+    success: boolean;
+    resultCode?: number;
+    properties?: Record<string, string>;
+    measurements?: Record<string, number>;
+}
+interface TelemetryMetric {
+    name: string;
+    average: number;
+    sampleCount?: number;
+    min?: number;
+    max?: number;
+    properties?: Record<string, string>;
+}
+/**
+ * Options that shape the App Insights *config object* — everything
+ * {@link createTelemetryConfig} needs. All fields are per-consumer variance;
+ * the package supplies the shared DCS defaults (including the unload fix).
+ */
+interface TelemetryConfigOptions {
+    /** App Insights connection string (preferred). Sourced from the consumer's env. */
+    connectionString?: string;
+    /** Legacy instrumentation key, if a connection string is not available. */
+    instrumentationKey?: string;
+    /** Enable the SDK's built-in SPA route tracking. Default `true`. */
+    enableAutoRouteTracking?: boolean;
+    /**
+     * Dev mode — routes internal SDK logs more verbosely to the console
+     * (`loggingLevel* = 1` vs `2`). The consumer passes `import.meta.env.DEV`.
+     * Default `false`.
+     */
+    dev?: boolean;
+    /**
+     * Page-unload events the SDK must NOT hook. Defaults to `['unload']`.
+     *
+     * This is the fleet-wide "BP-54" fix: the App Insights web SDK otherwise
+     * registers a listener on the deprecated `unload` event, which (a) blocks
+     * back/forward-cache eligibility and (b) trips the Lighthouse
+     * "avoid `unload` event listeners" best-practices audit (~19 points).
+     * The SDK keeps flushing telemetry on `pagehide` / `visibilitychange`
+     * (the supported path), so nothing is lost. See the SDK's own
+     * `IConfiguration.disablePageUnloadEvents` docs.
+     */
+    disablePageUnloadEvents?: string[];
+    /**
+     * Deep overrides spread over the DCS defaults *last*, so a consumer can
+     * change any App Insights config field (correlation domains, sampling, …).
+     */
+    overrides?: Partial<ApplicationInsightsConfig>;
+}
+/**
+ * Options for the {@link useTelemetry} composable — the config options plus the
+ * per-app enrichment values that the SDK config itself does not carry.
+ */
+interface TelemetryOptions extends TelemetryConfigOptions {
+    /** `ai.cloud.role` for this app, e.g. `'dcs-web'`. Default `'dcs-site'`. */
+    cloudRole?: string;
+    /**
+     * App version stamped onto every event (`app_version` property +
+     * `ai.application.ver` tag). The consumer passes its build-time version
+     * define; falls back to `window.__APP_VERSION__` then `'unknown'`.
+     */
+    appVersion?: string;
+    /**
+     * Environment label added as the `environment` property, e.g. the consumer's
+     * `import.meta.env.MODE`. Falls back to `'unknown'`.
+     */
+    environment?: string;
+}
+
+/**
+ * The page-unload events the DCS default config tells the App Insights web SDK
+ * to leave un-hooked. Only the deprecated `unload` event is disabled — the SDK
+ * still hooks `pagehide` / `visibilitychange` (the supported flush path), so no
+ * telemetry is lost, back/forward-cache eligibility is restored, and the
+ * Lighthouse "avoid `unload` event listeners" audit passes.
+ */
+declare const DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS: readonly string[];
+/** Cloud-role default when a consumer does not name itself. */
+declare const DEFAULT_CLOUD_ROLE = "dcs-site";
+/**
+ * Build the App Insights web SDK config with DCS's shared defaults.
+ *
+ * The DEFAULT always includes {@link DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS}
+ * (`disablePageUnloadEvents: ['unload']`) — the fleet-wide bfcache / Lighthouse
+ * best-practices fix. Callers only need to supply their connection string; every
+ * field is overridable via the typed options (and the escape-hatch `overrides`).
+ *
+ * This function performs no SDK import and reads no `import.meta.env` — it is
+ * pure, so it is safe to call from lazy/inert telemetry loaders (the SDK is only
+ * pulled in when the composable, or the consumer, actually constructs
+ * `ApplicationInsights`).
+ */
+declare function createTelemetryConfig(options?: TelemetryConfigOptions): ApplicationInsightsConfig;
+
+export { type ApplicationInsightsConfig as A, DEFAULT_CLOUD_ROLE as D, type TelemetryOptions as T, type TelemetryDependency as a, type TelemetryEvent as b, type TelemetryException as c, type TelemetryMetric as d, type TelemetryPageView as e, createTelemetryConfig as f, DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS as g, type TelemetryConfigOptions as h };

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+export { D as DEFAULT_CLOUD_ROLE, g as DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS, f as createTelemetryConfig } from './config-BPmCpvmt.js';
+import '@microsoft/applicationinsights-web';

package/dist/config.js

@@ -0,0 +1,3 @@
+export { DEFAULT_CLOUD_ROLE, DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS, createTelemetryConfig } from './chunk-MX6WFWG4.js';
+//# sourceMappingURL=config.js.map
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"config.js"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import * as vue from 'vue';
+import { T as TelemetryOptions, a as TelemetryDependency, b as TelemetryEvent, c as TelemetryException, d as TelemetryMetric, e as TelemetryPageView } from './config-BPmCpvmt.js';
+export { A as ApplicationInsightsConfig, D as DEFAULT_CLOUD_ROLE, g as DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS, h as TelemetryConfigOptions, f as createTelemetryConfig } from './config-BPmCpvmt.js';
+import '@microsoft/applicationinsights-web';
+
+/**
+ * Azure Application Insights composable for DCS Vue apps.
+ *
+ * The connection string, cloud role, environment and app version are supplied
+ * by the consumer (they read their own `import.meta.env` / build defines and
+ * pass plain values in) so this package stays portable and build-tool agnostic.
+ * The shared App Insights config — including the `disablePageUnloadEvents:
+ * ['unload']` bfcache/Lighthouse fix — comes from {@link createTelemetryConfig}.
+ */
+declare function useTelemetry(options?: TelemetryOptions): {
+    isEnabled: vue.ComputedRef<boolean>;
+    isInitialized: vue.Ref<boolean, boolean>;
+    initializationError: vue.Ref<string | null, string | null>;
+    initialize: () => boolean;
+    flush: () => void;
+    startTrackPage: (name?: string) => void;
+    stopTrackPage: (name?: string, url?: string, properties?: Record<string, string>, measurements?: Record<string, number>) => void;
+    trackDependency: (dependency: TelemetryDependency) => void;
+    trackEvent: (event: TelemetryEvent) => void;
+    trackException: (exception: TelemetryException) => void;
+    trackMetric: (metric: TelemetryMetric) => void;
+    trackPageView: (pageView?: TelemetryPageView) => void;
+    trackCtaClick: (label: string, page?: string) => void;
+};
+/** The full public API returned by {@link useTelemetry}. */
+type TelemetryApi = ReturnType<typeof useTelemetry>;
+
+export { type TelemetryApi, TelemetryDependency, TelemetryEvent, TelemetryException, TelemetryMetric, TelemetryOptions, TelemetryPageView, useTelemetry };

package/dist/index.js

@@ -0,0 +1,253 @@
+import { DEFAULT_CLOUD_ROLE, createTelemetryConfig } from './chunk-MX6WFWG4.js';
+export { DEFAULT_CLOUD_ROLE, DEFAULT_DISABLE_PAGE_UNLOAD_EVENTS, createTelemetryConfig } from './chunk-MX6WFWG4.js';
+import { ApplicationInsights } from '@microsoft/applicationinsights-web';
+import { ref, computed } from 'vue';
+
+var appInsights = null;
+var isInitialized = ref(false);
+var initializationError = ref(null);
+var warnedDisabled = false;
+var warnedNotInitialized = false;
+function resolveAppVersion(explicit) {
+  if (explicit) return explicit;
+  const w = typeof window !== "undefined" ? window : void 0;
+  return w?.__APP_VERSION__ ?? "unknown";
+}
+function useTelemetry(options = {}) {
+  const cloudRole = options.cloudRole ?? DEFAULT_CLOUD_ROLE;
+  const environment = options.environment ?? "unknown";
+  const isEnabled = computed(() => {
+    return !!(options.connectionString || options.instrumentationKey);
+  });
+  function buildSharedProperties() {
+    const appVersion = resolveAppVersion(options.appVersion);
+    const referrerHost = typeof document !== "undefined" && document.referrer ? (() => {
+      try {
+        return new URL(document.referrer).hostname;
+      } catch {
+        return "unknown";
+      }
+    })() : "direct";
+    return {
+      app_version: appVersion,
+      app_name: cloudRole,
+      app_host: typeof window !== "undefined" ? window.location.hostname : "",
+      page_path: typeof window !== "undefined" ? window.location.pathname : "",
+      referrer_host: referrerHost
+    };
+  }
+  function buildEventProperties(additional) {
+    return {
+      timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+      environment,
+      ...buildSharedProperties(),
+      ...additional
+    };
+  }
+  function enrichTelemetryEnvelope(envelope) {
+    if (!envelope.data) {
+      envelope.data = {};
+    }
+    envelope.data.baseData = envelope.data.baseData || {};
+    envelope.data.baseData.properties = envelope.data.baseData.properties || {};
+    Object.assign(envelope.data.baseData.properties, buildSharedProperties());
+    const appVersion = resolveAppVersion(options.appVersion);
+    envelope.tags = envelope.tags || {};
+    envelope.tags["ai.application.ver"] = appVersion;
+    envelope.tags["ai.cloud.role"] = cloudRole;
+    envelope.tags["ai.cloud.roleInstance"] = typeof window !== "undefined" ? window.location.hostname : "";
+  }
+  const initialize = () => {
+    try {
+      if (isInitialized.value && appInsights) {
+        return true;
+      }
+      if (!isEnabled.value) {
+        if (!warnedDisabled) {
+          warnedDisabled = true;
+          console.warn(
+            "[telemetry] Application Insights DISABLED: no connection string or instrumentation key was provided at build time. All telemetry calls will silently no-op."
+          );
+        }
+        return false;
+      }
+      appInsights = new ApplicationInsights({
+        config: createTelemetryConfig({
+          connectionString: options.connectionString,
+          instrumentationKey: options.instrumentationKey,
+          enableAutoRouteTracking: options.enableAutoRouteTracking,
+          dev: options.dev,
+          disablePageUnloadEvents: options.disablePageUnloadEvents,
+          overrides: options.overrides
+        })
+      });
+      appInsights.loadAppInsights();
+      appInsights.addTelemetryInitializer((envelope) => {
+        try {
+          enrichTelemetryEnvelope(envelope);
+        } catch (error) {
+          console.warn("Failed to add web telemetry context:", error);
+        }
+        return true;
+      });
+      isInitialized.value = true;
+      initializationError.value = null;
+      console.log("Application Insights initialized successfully");
+      return true;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : "Unknown initialization error";
+      initializationError.value = errorMessage;
+      console.error("Failed to initialize Application Insights:", error);
+      return false;
+    }
+  };
+  const trackEvent = (event) => {
+    if (!appInsights || !isInitialized.value) {
+      if (!warnedNotInitialized) {
+        warnedNotInitialized = true;
+        console.warn(
+          `[telemetry] Application Insights not initialized \u2014 dropping event "${event.name}" (and silencing further "not initialized" warnings for this session).`
+        );
+      }
+      return;
+    }
+    try {
+      appInsights.trackEvent({
+        name: event.name,
+        properties: buildEventProperties(event.properties),
+        measurements: event.measurements
+      });
+    } catch (error) {
+      console.error("Failed to track event:", error);
+    }
+  };
+  const trackPageView = (pageView) => {
+    if (!appInsights || !isInitialized.value) {
+      console.warn("Application Insights not initialized, skipping page view tracking");
+      return;
+    }
+    try {
+      const referrer = typeof document !== "undefined" ? document.referrer ?? "" : "";
+      appInsights.trackPageView({
+        name: pageView?.name || (typeof document !== "undefined" ? document.title : void 0),
+        uri: pageView?.uri || (typeof window !== "undefined" ? window.location.href : void 0),
+        properties: buildEventProperties({
+          referrer,
+          ...pageView?.properties
+        }),
+        measurements: pageView?.measurements
+      });
+    } catch (error) {
+      console.error("Failed to track page view:", error);
+    }
+  };
+  const trackCtaClick = (label, page) => {
+    trackEvent({
+      name: "cta_click",
+      properties: {
+        label,
+        page: page ?? (typeof window !== "undefined" ? window.location.pathname : "")
+      }
+    });
+  };
+  const trackException = (exception) => {
+    if (!appInsights || !isInitialized.value) {
+      console.warn("Application Insights not initialized, skipping exception tracking");
+      return;
+    }
+    try {
+      appInsights.trackException({
+        exception: exception.exception,
+        properties: buildEventProperties({
+          url: typeof window !== "undefined" ? window.location.href : "",
+          userAgent: typeof navigator !== "undefined" ? navigator.userAgent : "",
+          ...exception.properties
+        }),
+        measurements: exception.measurements
+      });
+    } catch (error) {
+      console.error("Failed to track exception:", error);
+    }
+  };
+  const trackDependency = (dependency) => {
+    if (!appInsights || !isInitialized.value) {
+      console.warn("Application Insights not initialized, skipping dependency tracking");
+      return;
+    }
+    try {
+      appInsights.trackDependencyData({
+        id: `dep-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,
+        name: dependency.name,
+        data: dependency.data,
+        duration: dependency.duration,
+        success: dependency.success,
+        responseCode: dependency.resultCode || 0,
+        properties: buildEventProperties(dependency.properties),
+        measurements: dependency.measurements
+      });
+    } catch (error) {
+      console.error("Failed to track dependency:", error);
+    }
+  };
+  const trackMetric = (metric) => {
+    if (!appInsights || !isInitialized.value) {
+      console.warn("Application Insights not initialized, skipping metric tracking");
+      return;
+    }
+    try {
+      appInsights.trackMetric({
+        name: metric.name,
+        average: metric.average,
+        sampleCount: metric.sampleCount,
+        min: metric.min,
+        max: metric.max,
+        properties: buildEventProperties(metric.properties)
+      });
+    } catch (error) {
+      console.error("Failed to track metric:", error);
+    }
+  };
+  const flush = () => {
+    if (!appInsights || !isInitialized.value) return;
+    try {
+      appInsights.flush();
+    } catch (error) {
+      console.error("Failed to flush telemetry:", error);
+    }
+  };
+  const startTrackPage = (name) => {
+    if (!appInsights || !isInitialized.value) return;
+    try {
+      appInsights.startTrackPage(name);
+    } catch (error) {
+      console.error("Failed to start track page:", error);
+    }
+  };
+  const stopTrackPage = (name, url, properties, measurements) => {
+    if (!appInsights || !isInitialized.value) return;
+    try {
+      appInsights.stopTrackPage(name, url, buildEventProperties(properties), measurements);
+    } catch (error) {
+      console.error("Failed to stop track page:", error);
+    }
+  };
+  return {
+    isEnabled,
+    isInitialized,
+    initializationError,
+    initialize,
+    flush,
+    startTrackPage,
+    stopTrackPage,
+    trackDependency,
+    trackEvent,
+    trackException,
+    trackMetric,
+    trackPageView,
+    trackCtaClick
+  };
+}
+
+export { useTelemetry };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/composable.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { ApplicationInsights } from '@microsoft/applicationinsights-web'\nimport { computed, ref } from 'vue'\n\nimport { DEFAULT_CLOUD_ROLE, createTelemetryConfig } from './config'\nimport type {\n  TelemetryDependency,\n  TelemetryEvent,\n  TelemetryException,\n  TelemetryMetric,\n  TelemetryOptions,\n  TelemetryPageView,\n} from './types'\n\ninterface TelemetryEnvelope {\n  data?: {\n    baseData?: {\n      properties?: Record<string, string>\n    }\n  }\n  tags?: Record<string, string>\n}\n\n// Module-level singleton state: one App Insights instance per app bundle,\n// shared across every `useTelemetry()` call (matches the original per-app\n// composable). The reactive refs let views observe init state.\nlet appInsights: ApplicationInsights | null = null\nconst isInitialized = ref(false)\nconst initializationError = ref<string | null>(null)\n\n// One-shot guards so we surface \"App Insights is not configured\" loudly in\n// DevTools the FIRST time the app tries to use it, but don't spam the console\n// for every subsequent trackEvent / trackPageView call. See web/ site-audit F2\n// — `customEvents = 0` for 7d was a missing connection string silently\n// no-op'ing every telemetry call; the loud warning makes that mode visible.\nlet warnedDisabled = false\nlet warnedNotInitialized = false\n\nfunction resolveAppVersion(explicit?: string): string {\n  if (explicit) return explicit\n  const w =\n    typeof window !== 'undefined'\n      ? (window as Window & { __APP_VERSION__?: string })\n      : undefined\n  return w?.__APP_VERSION__ ?? 'unknown'\n}\n\n/**\n * Azure Application Insights composable for DCS Vue apps.\n *\n * The connection string, cloud role, environment and app version are supplied\n * by the consumer (they read their own `import.meta.env` / build defines and\n * pass plain values in) so this package stays portable and build-tool agnostic.\n * The shared App Insights config — including the `disablePageUnloadEvents:\n * ['unload']` bfcache/Lighthouse fix — comes from {@link createTelemetryConfig}.\n */\nexport function useTelemetry(options: TelemetryOptions = {}) {\n  const cloudRole = options.cloudRole ?? DEFAULT_CLOUD_ROLE\n  const environment = options.environment ?? 'unknown'\n\n  const isEnabled = computed(() => {\n    return !!(options.connectionString || options.instrumentationKey)\n  })\n\n  function buildSharedProperties(): Record<string, string> {\n    const appVersion = resolveAppVersion(options.appVersion)\n    const referrerHost =\n      typeof document !== 'undefined' && document.referrer\n        ? (() => {\n            try {\n              return new URL(document.referrer).hostname\n            } catch {\n              return 'unknown'\n            }\n          })()\n        : 'direct'\n\n    return {\n      app_version: appVersion,\n      app_name: cloudRole,\n      app_host: typeof window !== 'undefined' ? window.location.hostname : '',\n      page_path: typeof window !== 'undefined' ? window.location.pathname : '',\n      referrer_host: referrerHost,\n    }\n  }\n\n  function buildEventProperties(\n    additional?: Record<string, string>,\n  ): Record<string, string> {\n    return {\n      timestamp: new Date().toISOString(),\n      environment,\n      ...buildSharedProperties(),\n      ...additional,\n    }\n  }\n\n  function enrichTelemetryEnvelope(envelope: TelemetryEnvelope) {\n    if (!envelope.data) {\n      envelope.data = {}\n    }\n\n    envelope.data.baseData = envelope.data.baseData || {}\n    envelope.data.baseData.properties = envelope.data.baseData.properties || {}\n    Object.assign(envelope.data.baseData.properties, buildSharedProperties())\n\n    const appVersion = resolveAppVersion(options.appVersion)\n    envelope.tags = envelope.tags || {}\n    envelope.tags['ai.application.ver'] = appVersion\n    envelope.tags['ai.cloud.role'] = cloudRole\n    envelope.tags['ai.cloud.roleInstance'] =\n      typeof window !== 'undefined' ? window.location.hostname : ''\n  }\n\n  const initialize = (): boolean => {\n    try {\n      if (isInitialized.value && appInsights) {\n        return true\n      }\n\n      if (!isEnabled.value) {\n        if (!warnedDisabled) {\n          warnedDisabled = true\n          // Loud, one-shot warning so this is obvious in DevTools. If you see\n          // this in production, the build pipeline is not injecting the App\n          // Insights connection string — every track* call below silently\n          // no-ops. See web/ site-audit F2.\n          console.warn(\n            '[telemetry] Application Insights DISABLED: no connection string ' +\n              'or instrumentation key was provided at build time. ' +\n              'All telemetry calls will silently no-op.',\n          )\n        }\n        return false\n      }\n\n      appInsights = new ApplicationInsights({\n        config: createTelemetryConfig({\n          connectionString: options.connectionString,\n          instrumentationKey: options.instrumentationKey,\n          enableAutoRouteTracking: options.enableAutoRouteTracking,\n          dev: options.dev,\n          disablePageUnloadEvents: options.disablePageUnloadEvents,\n          overrides: options.overrides,\n        }),\n      })\n\n      appInsights.loadAppInsights()\n      appInsights.addTelemetryInitializer((envelope) => {\n        try {\n          enrichTelemetryEnvelope(envelope as TelemetryEnvelope)\n        } catch (error) {\n          console.warn('Failed to add web telemetry context:', error)\n        }\n\n        return true\n      })\n\n      isInitialized.value = true\n      initializationError.value = null\n      console.log('Application Insights initialized successfully')\n      return true\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : 'Unknown initialization error'\n      initializationError.value = errorMessage\n      console.error('Failed to initialize Application Insights:', error)\n      return false\n    }\n  }\n\n  const trackEvent = (event: TelemetryEvent) => {\n    if (!appInsights || !isInitialized.value) {\n      if (!warnedNotInitialized) {\n        warnedNotInitialized = true\n        console.warn(\n          `[telemetry] Application Insights not initialized — dropping event \"${event.name}\" ` +\n            '(and silencing further \"not initialized\" warnings for this session).',\n        )\n      }\n      return\n    }\n\n    try {\n      appInsights.trackEvent({\n        name: event.name,\n        properties: buildEventProperties(event.properties),\n        measurements: event.measurements,\n      })\n    } catch (error) {\n      console.error('Failed to track event:', error)\n    }\n  }\n\n  const trackPageView = (pageView?: TelemetryPageView) => {\n    if (!appInsights || !isInitialized.value) {\n      console.warn('Application Insights not initialized, skipping page view tracking')\n      return\n    }\n\n    try {\n      // Attach the full document.referrer (not just hostname) so we can\n      // attribute traffic sources in App Insights pageViews.\n      const referrer =\n        typeof document !== 'undefined' ? (document.referrer ?? '') : ''\n      appInsights.trackPageView({\n        name:\n          pageView?.name ||\n          (typeof document !== 'undefined' ? document.title : undefined),\n        uri:\n          pageView?.uri ||\n          (typeof window !== 'undefined' ? window.location.href : undefined),\n        properties: buildEventProperties({\n          referrer,\n          ...pageView?.properties,\n        }),\n        measurements: pageView?.measurements,\n      })\n    } catch (error) {\n      console.error('Failed to track page view:', error)\n    }\n  }\n\n  /**\n   * Convenience helper for primary CTA conversion measurement. Fires a\n   * `cta_click` custom event so conversion rate per landing page can be\n   * computed in App Insights / KQL.\n   */\n  const trackCtaClick = (label: string, page?: string) => {\n    trackEvent({\n      name: 'cta_click',\n      properties: {\n        label,\n        page:\n          page ??\n          (typeof window !== 'undefined' ? window.location.pathname : ''),\n      },\n    })\n  }\n\n  const trackException = (exception: TelemetryException) => {\n    if (!appInsights || !isInitialized.value) {\n      console.warn('Application Insights not initialized, skipping exception tracking')\n      return\n    }\n\n    try {\n      appInsights.trackException({\n        exception: exception.exception,\n        properties: buildEventProperties({\n          url: typeof window !== 'undefined' ? window.location.href : '',\n          userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : '',\n          ...exception.properties,\n        }),\n        measurements: exception.measurements,\n      })\n    } catch (error) {\n      console.error('Failed to track exception:', error)\n    }\n  }\n\n  const trackDependency = (dependency: TelemetryDependency) => {\n    if (!appInsights || !isInitialized.value) {\n      console.warn('Application Insights not initialized, skipping dependency tracking')\n      return\n    }\n\n    try {\n      appInsights.trackDependencyData({\n        id: `dep-${Date.now()}-${Math.random().toString(36).slice(2, 11)}`,\n        name: dependency.name,\n        data: dependency.data,\n        duration: dependency.duration,\n        success: dependency.success,\n        responseCode: dependency.resultCode || 0,\n        properties: buildEventProperties(dependency.properties),\n        measurements: dependency.measurements,\n      })\n    } catch (error) {\n      console.error('Failed to track dependency:', error)\n    }\n  }\n\n  const trackMetric = (metric: TelemetryMetric) => {\n    if (!appInsights || !isInitialized.value) {\n      console.warn('Application Insights not initialized, skipping metric tracking')\n      return\n    }\n\n    try {\n      appInsights.trackMetric({\n        name: metric.name,\n        average: metric.average,\n        sampleCount: metric.sampleCount,\n        min: metric.min,\n        max: metric.max,\n        properties: buildEventProperties(metric.properties),\n      })\n    } catch (error) {\n      console.error('Failed to track metric:', error)\n    }\n  }\n\n  const flush = () => {\n    if (!appInsights || !isInitialized.value) return\n\n    try {\n      appInsights.flush()\n    } catch (error) {\n      console.error('Failed to flush telemetry:', error)\n    }\n  }\n\n  const startTrackPage = (name?: string) => {\n    if (!appInsights || !isInitialized.value) return\n\n    try {\n      appInsights.startTrackPage(name)\n    } catch (error) {\n      console.error('Failed to start track page:', error)\n    }\n  }\n\n  const stopTrackPage = (\n    name?: string,\n    url?: string,\n    properties?: Record<string, string>,\n    measurements?: Record<string, number>,\n  ) => {\n    if (!appInsights || !isInitialized.value) return\n\n    try {\n      appInsights.stopTrackPage(name, url, buildEventProperties(properties), measurements)\n    } catch (error) {\n      console.error('Failed to stop track page:', error)\n    }\n  }\n\n  return {\n    isEnabled,\n    isInitialized,\n    initializationError,\n    initialize,\n    flush,\n    startTrackPage,\n    stopTrackPage,\n    trackDependency,\n    trackEvent,\n    trackException,\n    trackMetric,\n    trackPageView,\n    trackCtaClick,\n  }\n}\n\n/** The full public API returned by {@link useTelemetry}. */\nexport type TelemetryApi = ReturnType<typeof useTelemetry>\n"]}