@microsoft/power-apps-native-common 0.2.2 → 0.3.2

package/lib/NOTICE.txt

@@ -30,6 +30,32 @@ SOFTWARE.
 
 ========================================================================
 
+@microsoft/applicationinsights-channel-js 3.4.3
+--
+The MIT License (MIT)
+
+Copyright (c) Microsoft Corporation
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+========================================================================
+
 @microsoft/applicationinsights-core-js 3.4.3
 --
 The MIT License (MIT)

package/lib/commonjs/index.js

@@ -57,10 +57,10 @@ Object.defineProperty(exports, "configureAppLogger", {
     return _AppLogger.configureAppLogger;
   }
 });
-Object.defineProperty(exports, "configureCustomerTelemetryLogger", {
+Object.defineProperty(exports, "configureCustomEventsLogger", {
   enumerable: true,
   get: function () {
-    return _CustomerTelemetryLogger.configureCustomerTelemetryLogger;
+    return _CustomEventsLogger.configureCustomEventsLogger;
   }
 });
 Object.defineProperty(exports, "getAppLogger", {
@@ -69,10 +69,10 @@ Object.defineProperty(exports, "getAppLogger", {
     return _AppLogger.getAppLogger;
   }
 });
-Object.defineProperty(exports, "getCustomerTelemetryLogger", {
+Object.defineProperty(exports, "getCustomEventsLogger", {
   enumerable: true,
   get: function () {
-    return _CustomerTelemetryLogger.getCustomerTelemetryLogger;
+    return _CustomEventsLogger.getCustomEventsLogger;
   }
 });
 Object.defineProperty(exports, "getHttpCorrelationProperties", {
@@ -87,6 +87,12 @@ Object.defineProperty(exports, "regionToClusterCategory", {
     return _ClusterCategory.regionToClusterCategory;
   }
 });
+Object.defineProperty(exports, "resetDeviceId", {
+  enumerable: true,
+  get: function () {
+    return _DeviceIdUtils.resetDeviceId;
+  }
+});
 Object.defineProperty(exports, "resolveDeviceId", {
   enumerable: true,
   get: function () {
@@ -99,6 +105,12 @@ Object.defineProperty(exports, "resolveTelemetryLocation", {
     return _resolveTelemetryLocation.resolveTelemetryLocation;
   }
 });
+Object.defineProperty(exports, "resolveTelemetryLocationFromDataverseRegion", {
+  enumerable: true,
+  get: function () {
+    return _resolveTelemetryLocation.resolveTelemetryLocationFromDataverseRegion;
+  }
+});
 Object.defineProperty(exports, "sanitizeErrorString", {
   enumerable: true,
   get: function () {
@@ -129,6 +141,18 @@ Object.defineProperty(exports, "suppressKnownWarnings", {
     return _suppressKnownWarnings.suppressKnownWarnings;
   }
 });
+Object.defineProperty(exports, "tryResolveTelemetryLocationFromDataverseRegion", {
+  enumerable: true,
+  get: function () {
+    return _resolveTelemetryLocation.tryResolveTelemetryLocationFromDataverseRegion;
+  }
+});
+Object.defineProperty(exports, "tryResolveTelemetryLocationFromEnvironment", {
+  enumerable: true,
+  get: function () {
+    return _resolveTelemetryLocation.tryResolveTelemetryLocationFromEnvironment;
+  }
+});
 var _ConsoleAdapter = require("./telemetry/ConsoleAdapter.js");
 var _Logger = require("./telemetry/Logger.js");
 var _OneDsTelemetryProvider = require("./telemetry/OneDsTelemetryProvider.js");
@@ -140,6 +164,6 @@ var _suppressKnownWarnings = require("./telemetry/suppressKnownWarnings.js");
 var _HttpClient = require("./http/HttpClient.js");
 var _DeviceIdUtils = require("./utils/DeviceIdUtils.js");
 var _AppLogger = require("./telemetry/AppLogger.js");
-var _CustomerTelemetryLogger = require("./telemetry/CustomerTelemetryLogger.js");
+var _CustomEventsLogger = require("./telemetry/CustomEventsLogger.js");
 var _TelemetryTypes = require("./telemetry/TelemetryTypes.js");
 var _ClusterCategory = require("./types/ClusterCategory.js");

package/lib/commonjs/telemetry/AnonymousTelemetry.js

@@ -0,0 +1,25 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.buildAnonymousTelemetryData = buildAnonymousTelemetryData;
+function buildAnonymousTelemetryData(event, appName, clusterCategory) {
+  const operationName = typeof event.properties.operationName === 'string' ? event.properties.operationName : undefined;
+  return {
+    app_Name: appName,
+    clusterCategory,
+    event_Name: event.eventName,
+    severity: event.severity,
+    timestamp: event.timestamp,
+    ...(event.duration !== undefined ? {
+      duration: event.duration
+    } : {}),
+    ...(operationName ? {
+      operation_Name: operationName
+    } : {}),
+    customDimensions: JSON.stringify(operationName ? {
+      operationName
+    } : {})
+  };
+}

package/lib/commonjs/telemetry/CustomEventsLogger.js

@@ -0,0 +1,56 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.configureCustomEventsLogger = configureCustomEventsLogger;
+exports.getCustomEventsLogger = getCustomEventsLogger;
+var _Logger = require("./Logger.js");
+var _stringifyError = require("./stringifyError.js");
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+
+class CustomEventsLogger {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  trackEvent(name, properties) {
+    this.logger.trackActivityEvent(name, this.withCustomEventsSource(properties));
+  }
+  trackError(name, error, properties) {
+    this.logger.trackErrorEvent(name, this.withCustomEventsSource({
+      ...properties,
+      error: error === undefined ? undefined : (0, _stringifyError.stringifyError)(error)
+    }));
+  }
+  trackScenario(name, properties) {
+    return this.logger.trackScenario(name, this.withCustomEventsSource(properties));
+  }
+  flush() {
+    return this.logger.flush();
+  }
+  withCustomEventsSource(properties) {
+    return {
+      ...properties,
+      telemetry_source: 'custom'
+    };
+  }
+}
+let customEventsLogger = new CustomEventsLogger(new _Logger.Logger());
+
+/**
+ * Configures the custom-events singleton. Hosting infrastructure owns
+ * this function; application code should use getCustomEventsLogger().
+ */
+function configureCustomEventsLogger(logger) {
+  customEventsLogger = new CustomEventsLogger(logger);
+}
+
+/**
+ * Returns the app's custom-events logger. It is a safe no-op until the
+ * host configures an Application Insights provider.
+ */
+function getCustomEventsLogger() {
+  return customEventsLogger;
+}

package/lib/commonjs/telemetry/OneDsTelemetryProvider.js

@@ -8,6 +8,7 @@ var _applicationinsightsCoreJs = require("@microsoft/applicationinsights-core-js
 var _dsPostJs = require("@microsoft/1ds-post-js");
 var _GuidUtils = require("../utils/GuidUtils.js");
 var _PlatformInfoUtils = require("../utils/PlatformInfoUtils.js");
+var _AnonymousTelemetry = require("./AnonymousTelemetry.js");
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
@@ -97,11 +98,14 @@ class OneDsTelemetryProvider {
   defaultProperties = {};
   constructor(config) {
     this._sessionId = (0, _GuidUtils.generateGuid)();
+    this.anonymous = config.anonymous ?? false;
+    this.telemetryLocation = config.telemetryLocation ?? 'global';
     this.appName = resolveAppName(config.clusterCategory);
     this.appVersion = config.appVersion ?? '';
     this.clientType = config.clientType;
     this.clusterCategory = config.clusterCategory;
     this.deviceId = config.deviceId ?? 'react-native';
+    this.includeUserIdentity = config.includeUserIdentity ?? false;
     this.minSeverity = config.minSeverity ?? 'info';
     const {
       osName,
@@ -128,15 +132,15 @@ class OneDsTelemetryProvider {
     if (config.commonProperties) {
       Object.assign(this.defaultProperties, config.commonProperties);
     }
-    const postChannel = new _dsPostJs.PostChannel();
+    this.postChannel = new _dsPostJs.PostChannel();
     const instrumentationKey = config.instrumentationKey ?? resolveInstrumentationKey(config.clusterCategory);
-    const collectorUrl = resolveCollectorUrl(config.clusterCategory, config.telemetryLocation);
+    const collectorUrl = resolveCollectorUrl(config.clusterCategory, this.telemetryLocation);
     const coreConfig = {
       instrumentationKey,
-      channels: [[postChannel]]
+      channels: [[this.postChannel]]
     };
     coreConfig.extensionConfig = {
-      [postChannel.identifier]: {
+      [this.postChannel.identifier]: {
         // Override endpoint explicitly — PostChannel reads overrideEndpointUrl
         // from its own extensionConfig, not from coreConfig.endpointUrl.
         overrideEndpointUrl: collectorUrl,
@@ -168,6 +172,7 @@ class OneDsTelemetryProvider {
       const ext = envelope.ext = envelope.ext ?? {};
       const utc = ext['utc'] = ext['utc'] ?? {};
       utc['eventFlags'] = (utc['eventFlags'] || 0) | 0x100000;
+      if (this.anonymous) return;
       const app = ext['app'] = ext['app'] ?? {};
       app['sesId'] = this._sessionId;
       if (this.appVersion) app['ver'] = this.appVersion; // → AppInfo_Version
@@ -193,6 +198,15 @@ class OneDsTelemetryProvider {
     this.core.addTelemetryInitializer(initializer);
   }
   track(event) {
+    if (this.anonymous) {
+      this.core.track({
+        name: 'event',
+        time: event.timestamp,
+        baseType: 'custom',
+        data: (0, _AnonymousTelemetry.buildAnonymousTelemetryData)(event, this.appName, this.clusterCategory)
+      });
+      return;
+    }
     const allProperties = {
       ...this.defaultProperties,
       ...event.properties
@@ -218,7 +232,7 @@ class OneDsTelemetryProvider {
     };
 
     // User identity promoted to top-level columns directly
-    if (this.userIdentity) {
+    if (this.includeUserIdentity && this.userIdentity) {
       data.objectId = this.userIdentity.objectId;
       data.tenantId = this.userIdentity.tenantId;
     }
@@ -246,6 +260,34 @@ class OneDsTelemetryProvider {
     };
     this.core.track(item);
   }
+  async resolveTelemetryLocation(telemetryLocation) {
+    if (!this.anonymous && telemetryLocation === this.telemetryLocation) return;
+    const previousResolution = this.locationResolution ?? Promise.resolve();
+    const currentResolution = previousResolution.catch(() => undefined).then(() => this.applyTelemetryLocation(telemetryLocation));
+    this.locationResolution = currentResolution;
+    try {
+      await currentResolution;
+    } finally {
+      if (this.locationResolution === currentResolution) {
+        this.locationResolution = undefined;
+      }
+    }
+  }
+  async applyTelemetryLocation(telemetryLocation) {
+    if (!this.anonymous && telemetryLocation === this.telemetryLocation) return;
+    if (telemetryLocation !== this.telemetryLocation) {
+      await this.flush();
+      this.core.updateCfg({
+        extensionConfig: {
+          [this.postChannel.identifier]: {
+            overrideEndpointUrl: resolveCollectorUrl(this.clusterCategory, telemetryLocation)
+          }
+        }
+      });
+      this.telemetryLocation = telemetryLocation;
+    }
+    this.anonymous = false;
+  }
   flush() {
     return new Promise(resolve => {
       this.core.flush(true, () => {

package/lib/commonjs/telemetry/TelemetrySanitizer.js

@@ -56,6 +56,13 @@ const SAS_KEY_SIG_RE = /(?:dsas_secret|sig)=[^#)\(<>\r\n\s'",\\_&]{8}[^#)\(<>\r\
  */
 const SYMM_KEY_256_RE = /[a-z0-9/+]{43}=/gi;
 
+/** Bearer credentials and compact JWTs embedded in otherwise arbitrary text. */
+const BEARER_CREDENTIAL_RE = /\bbearer\s+[a-z0-9._~+\/-]+=*/gi;
+const JWT_RE = /\beyJ[a-z0-9_-]+\.[a-z0-9_-]+\.[a-z0-9_-]+\b/gi;
+
+/** Query strings and fragments on absolute URLs commonly carry user context. */
+const URL_QUERY_OR_FRAGMENT_RE = /(https?:\/\/[^\s?#'"<>]+)[?#][^\s'"<>]*/gi;
+
 /**
  * Property key patterns that must never appear as telemetry values.
  * Checked case-insensitively against the full key name.
@@ -67,7 +74,7 @@ const SENSITIVE_KEY_RE = /password|secret|token|credential|auth(?:orization)?|be
  * Safe to use on error messages, URL paths, and arbitrary text.
  */
 function sanitizeErrorString(raw) {
-  return raw.replace(EMAIL_RE, '<upn>').replace(PRIVATE_IPV4_RE, (_, port) => port ? `<private-ip>${port}` : '<private-ip>').replace(GOOGLE_API_KEY_RE, '<credential>').replace(SAS_KEY_SIG_RE, '<credential>').replace(SYMM_KEY_256_RE, '<credential>');
+  return raw.replace(URL_QUERY_OR_FRAGMENT_RE, '$1').replace(EMAIL_RE, '<upn>').replace(PRIVATE_IPV4_RE, (_, port) => port ? `<private-ip>${port}` : '<private-ip>').replace(GOOGLE_API_KEY_RE, '<credential>').replace(SAS_KEY_SIG_RE, '<credential>').replace(SYMM_KEY_256_RE, '<credential>').replace(BEARER_CREDENTIAL_RE, 'Bearer <credential>').replace(JWT_RE, '<credential>');
 }
 
 /**
@@ -86,15 +93,29 @@ function sanitizeUrl(url) {
  *   - Non-string primitives passed through unchanged
  */
 function sanitizeProperties(props) {
+  return sanitizeRecord(props, new WeakSet(), 0);
+}
+const MAX_SANITIZE_DEPTH = 5;
+function sanitizeRecord(props, seen, depth) {
+  if (seen.has(props) || depth > MAX_SANITIZE_DEPTH) return {};
+  seen.add(props);
   const result = {};
   for (const [key, value] of Object.entries(props)) {
     if (SENSITIVE_KEY_RE.test(key)) {
       result[key] = '<redacted>';
-    } else if (typeof value === 'string') {
-      result[key] = sanitizeErrorString(value);
     } else {
-      result[key] = value;
+      result[key] = sanitizeValue(value, seen, depth + 1);
     }
   }
   return result;
+}
+function sanitizeValue(value, seen, depth) {
+  if (typeof value === 'string') return sanitizeErrorString(value);
+  if (value === null || typeof value !== 'object') return value;
+  if (depth > MAX_SANITIZE_DEPTH || seen.has(value)) return '<redacted>';
+  if (Array.isArray(value)) {
+    seen.add(value);
+    return value.map(item => sanitizeValue(item, seen, depth + 1));
+  }
+  return sanitizeRecord(value, seen, depth);
 }

package/lib/commonjs/telemetry/resolveTelemetryLocation.js

@@ -4,6 +4,9 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.resolveTelemetryLocation = resolveTelemetryLocation;
+exports.resolveTelemetryLocationFromDataverseRegion = resolveTelemetryLocationFromDataverseRegion;
+exports.tryResolveTelemetryLocationFromDataverseRegion = tryResolveTelemetryLocationFromDataverseRegion;
+exports.tryResolveTelemetryLocationFromEnvironment = tryResolveTelemetryLocationFromEnvironment;
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
@@ -15,13 +18,23 @@ exports.resolveTelemetryLocation = resolveTelemetryLocation;
  * Source: `metadata.properties.location` in the BAP Get Environments API response.
  */
 const EU_BAP_LOCATIONS = new Set(['europe', 'france', 'germany', 'italy', 'poland', 'norway', 'sweden', 'switzerland', 'unitedkingdom']);
+const NON_EU_BAP_LOCATIONS = new Set(['asia', 'australia', 'brazil', 'canada', 'india', 'japan', 'korea', 'southafrica', 'southamerica', 'unitedarabemirates', 'unitedstates']);
+const EU_DATAVERSE_REGIONS = new Set(['che', 'emea', 'eur', 'fra', 'gbr', 'ger', 'ita', 'nor', 'pol', 'swe']);
+const NON_EU_DATAVERSE_REGIONS = new Set(['apac', 'aus', 'can', 'ind', 'jpn', 'kor', 'latam', 'nam', 'na', 'oce', 'sam', 'sgp', 'uae', 'usa']);
+function resolveKnownLocation(input, euValues, nonEuValues) {
+  const value = input?.trim().toLowerCase();
+  if (value && euValues.has(value)) return 'eu';
+  if (value && nonEuValues.has(value)) return 'global';
+  return undefined;
+}
 
 /**
  * Resolve the 1DS telemetry collector location from a Power Platform BAP
  * environment `location` string (`environment.properties.location`).
  * Returns `'eu'` when the location maps to the EU data boundary, routing
  * telemetry to `eu-mobile.events.data.microsoft.com` instead of the global
- * US collector.
+ * US collector. Missing or blank locations fail closed to the EU collector so
+ * telemetry emitted before the environment is known does not leave the EUDB.
  *
  * Mirrors the CLI's detection in `CliLogger.ts`:
  * ```
@@ -35,8 +48,21 @@ const EU_BAP_LOCATIONS = new Set(['europe', 'france', 'germany', 'italy', 'polan
  * resolveTelemetryLocation('unitedkingdom') // → 'eu'
  * resolveTelemetryLocation('italy')         // → 'eu'
  * resolveTelemetryLocation('unitedstates')  // → 'global'
+ * resolveTelemetryLocation()                // → 'eu'
  */
 function resolveTelemetryLocation(input) {
-  if (!input) return 'global';
-  return EU_BAP_LOCATIONS.has(input.trim().toLowerCase()) ? 'eu' : 'global';
+  return resolveKnownLocation(input, EU_BAP_LOCATIONS, NON_EU_BAP_LOCATIONS) ?? 'eu';
+}
+
+/** Resolve a Dataverse Global Discovery `Instance.Region` code. */
+function resolveTelemetryLocationFromDataverseRegion(input) {
+  return tryResolveTelemetryLocationFromDataverseRegion(input) ?? 'eu';
+}
+function tryResolveTelemetryLocationFromDataverseRegion(input) {
+  return resolveKnownLocation(input, EU_DATAVERSE_REGIONS, NON_EU_DATAVERSE_REGIONS);
+}
+
+/** Resolve launch metadata, falling back from BAP location to cluster geography. */
+function tryResolveTelemetryLocationFromEnvironment(location, clusterGeoShortName) {
+  return resolveKnownLocation(location, EU_BAP_LOCATIONS, NON_EU_BAP_LOCATIONS) ?? tryResolveTelemetryLocationFromDataverseRegion(clusterGeoShortName);
 }

package/lib/commonjs/telemetry/stringifyError.js

@@ -4,28 +4,20 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.stringifyError = stringifyError;
-var _TelemetrySanitizer = require("./TelemetrySanitizer.js");
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  */
 
 /**
- * Converts an unknown thrown value to a string suitable for telemetry.
- * PII (email addresses, private IPv4 addresses) is redacted before the
- * string is returned.
+ * Classifies an unknown thrown value without exporting its message, stack, or
+ * serialized contents. Error prose is not a safe telemetry contract because
+ * upstream services may include customer data or credentials in it.
  */
 function stringifyError(error) {
-  let raw;
   if (error instanceof Error) {
-    raw = `${error.name}: ${error.message}${error.stack ? `\n${error.stack}` : ''}`;
-  } else if (typeof error === 'string') {
-    raw = error;
-  } else {
-    try {
-      raw = JSON.stringify(error);
-    } catch {
-      raw = String(error);
-    }
+    return error.name || error.constructor.name || 'Error';
   }
-  return (0, _TelemetrySanitizer.sanitizeErrorString)(raw);
+  if (typeof error === 'string') return 'StringError';
+  if (error && typeof error === 'object') return error.constructor?.name || 'ObjectError';
+  return `${typeof error}Error`;
 }

package/lib/commonjs/utils/DeviceIdUtils.js

@@ -3,10 +3,9 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+exports.resetDeviceId = resetDeviceId;
 exports.resolveDeviceId = resolveDeviceId;
-var Application = _interopRequireWildcard(require("expo-application"));
 var SecureStore = _interopRequireWildcard(require("expo-secure-store"));
-var _reactNative = require("react-native");
 var _GuidUtils = require("./GuidUtils.js");
 function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
 /*!
@@ -18,18 +17,9 @@ function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r
 const DEVICE_ID_FALLBACK_KEY = 'microsoft.power-apps-native-common.device_id';
 
 /**
- * Returns a stable device identifier, preferring platform-native IDs that
- * survive app reinstalls:
- *
- * - **iOS**: `getIosIdForVendorAsync()` (IDFV) — stable while ≥1 app from the
- *   same vendor bundle prefix is installed. Resets only when ALL vendor apps
- *   are removed.
- * - **Android**: `getAndroidId()` (SSAID) — scoped to the app signing key on
- *   Android 8+; survives reinstalls as long as the signing key is unchanged.
- *
- * If the platform API returns null (rare edge cases: first boot, some emulators)
- * the function falls back to a UUID persisted in `expo-secure-store`, which on
- * iOS survives reinstalls via the Keychain and on Android is per-install only.
+ * Returns a random app-scoped telemetry identifier. It does not use IDFV,
+ * SSAID, or another platform device identifier, and can be rotated with
+ * `resetDeviceId()` for deletion and opt-out workflows.
  *
  * Pass the resolved value to `OneDsTelemetryProviderConfig.deviceId` at startup.
  *
@@ -42,20 +32,6 @@ const DEVICE_ID_FALLBACK_KEY = 'microsoft.power-apps-native-common.device_id';
  * ```
  */
 async function resolveDeviceId() {
-  if (_reactNative.Platform.OS === 'ios') {
-    const idfv = await Application.getIosIdForVendorAsync();
-    if (idfv) {
-      return idfv;
-    }
-  } else if (_reactNative.Platform.OS === 'android') {
-    const androidId = Application.getAndroidId();
-    if (androidId) {
-      return androidId;
-    }
-  }
-
-  // Fallback: stable UUID in SecureStore (iOS: survives reinstall via Keychain;
-  // Android: per-install only, but only reached when SSAID is unavailable).
   const existing = await SecureStore.getItemAsync(DEVICE_ID_FALLBACK_KEY);
   if (existing) {
     return existing;
@@ -63,4 +39,9 @@ async function resolveDeviceId() {
   const id = (0, _GuidUtils.generateGuid)();
   await SecureStore.setItemAsync(DEVICE_ID_FALLBACK_KEY, id);
   return id;
+}
+
+/** Deletes the app-scoped telemetry identifier so the next resolution rotates it. */
+async function resetDeviceId() {
+  await SecureStore.deleteItemAsync(DEVICE_ID_FALLBACK_KEY);
 }

package/lib/module/index.js

@@ -9,13 +9,13 @@ export { ConsoleAdapter } from "./telemetry/ConsoleAdapter.js";
 export { Logger } from "./telemetry/Logger.js";
 export { OneDsTelemetryProvider } from "./telemetry/OneDsTelemetryProvider.js";
 export { ApplicationInsightsTelemetryProvider } from "./telemetry/ApplicationInsightsTelemetryProvider.js";
-export { resolveTelemetryLocation } from "./telemetry/resolveTelemetryLocation.js";
+export { resolveTelemetryLocation, resolveTelemetryLocationFromDataverseRegion, tryResolveTelemetryLocationFromDataverseRegion, tryResolveTelemetryLocationFromEnvironment } from "./telemetry/resolveTelemetryLocation.js";
 export { stringifyError } from "./telemetry/stringifyError.js";
 export { sanitizeErrorString, sanitizeUrl, sanitizeProperties } from "./telemetry/TelemetrySanitizer.js";
 export { suppressKnownWarnings } from "./telemetry/suppressKnownWarnings.js";
 export { HttpClient, getHttpCorrelationProperties } from "./http/HttpClient.js";
-export { resolveDeviceId } from "./utils/DeviceIdUtils.js";
+export { resetDeviceId, resolveDeviceId } from "./utils/DeviceIdUtils.js";
 export { configureAppLogger, getAppLogger } from "./telemetry/AppLogger.js";
-export { configureCustomerTelemetryLogger, getCustomerTelemetryLogger } from "./telemetry/CustomerTelemetryLogger.js";
+export { configureCustomEventsLogger, getCustomEventsLogger } from "./telemetry/CustomEventsLogger.js";
 export { ScenarioResults, TelemetryEventNames } from "./telemetry/TelemetryTypes.js";
 export { Regions, regionToClusterCategory } from "./types/ClusterCategory.js";

package/lib/module/telemetry/AnonymousTelemetry.js

@@ -0,0 +1,21 @@
+"use strict";
+
+export function buildAnonymousTelemetryData(event, appName, clusterCategory) {
+  const operationName = typeof event.properties.operationName === 'string' ? event.properties.operationName : undefined;
+  return {
+    app_Name: appName,
+    clusterCategory,
+    event_Name: event.eventName,
+    severity: event.severity,
+    timestamp: event.timestamp,
+    ...(event.duration !== undefined ? {
+      duration: event.duration
+    } : {}),
+    ...(operationName ? {
+      operation_Name: operationName
+    } : {}),
+    customDimensions: JSON.stringify(operationName ? {
+      operationName
+    } : {})
+  };
+}

package/lib/module/telemetry/CustomEventsLogger.js

@@ -0,0 +1,51 @@
+"use strict";
+
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+
+import { Logger } from "./Logger.js";
+import { stringifyError } from "./stringifyError.js";
+class CustomEventsLogger {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  trackEvent(name, properties) {
+    this.logger.trackActivityEvent(name, this.withCustomEventsSource(properties));
+  }
+  trackError(name, error, properties) {
+    this.logger.trackErrorEvent(name, this.withCustomEventsSource({
+      ...properties,
+      error: error === undefined ? undefined : stringifyError(error)
+    }));
+  }
+  trackScenario(name, properties) {
+    return this.logger.trackScenario(name, this.withCustomEventsSource(properties));
+  }
+  flush() {
+    return this.logger.flush();
+  }
+  withCustomEventsSource(properties) {
+    return {
+      ...properties,
+      telemetry_source: 'custom'
+    };
+  }
+}
+let customEventsLogger = new CustomEventsLogger(new Logger());
+
+/**
+ * Configures the custom-events singleton. Hosting infrastructure owns
+ * this function; application code should use getCustomEventsLogger().
+ */
+export function configureCustomEventsLogger(logger) {
+  customEventsLogger = new CustomEventsLogger(logger);
+}
+
+/**
+ * Returns the app's custom-events logger. It is a safe no-op until the
+ * host configures an Application Insights provider.
+ */
+export function getCustomEventsLogger() {
+  return customEventsLogger;
+}