@microsoft/power-apps-native-common 0.1.8 → 0.2.0

package/lib/NOTICE.txt

@@ -4,7 +4,7 @@ This repository incorporates material as listed below or described in the code.
 
 ========================================================================
 
-@microsoft/1ds-core-js 4.3.11
+@microsoft/1ds-post-js 4.4.1
 --
 The MIT License (MIT)
 
@@ -30,7 +30,7 @@ SOFTWARE.
 
 ========================================================================
 
-@microsoft/1ds-post-js 4.3.11
+@microsoft/applicationinsights-core-js 3.4.3
 --
 The MIT License (MIT)
 
@@ -56,7 +56,7 @@ SOFTWARE.
 
 ========================================================================
 
-@microsoft/applicationinsights-core-js 3.4.1
+@microsoft/applicationinsights-react-native 4.4.1
 --
 The MIT License (MIT)
 
@@ -108,13 +108,39 @@ SOFTWARE.
 
 ========================================================================
 
+@microsoft/applicationinsights-web 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/dynamicproto-js 2.0.5
 --
 Copyright Microsoft Application Insights Team; licensed under MIT (https://spdx.org/licenses/MIT.html)
 
 ========================================================================
 
-@nevware21/ts-async 0.6.1
+@nevware21/ts-async 0.5.5
 --
 MIT License
 
@@ -140,7 +166,7 @@ SOFTWARE.
 
 ========================================================================
 
-@nevware21/ts-utils 0.15.0
+@nevware21/ts-utils 0.16.0
 --
 MIT License
 

package/lib/commonjs/http/HttpClient.js

@@ -0,0 +1,83 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HttpClient = void 0;
+exports.getHttpCorrelationProperties = getHttpCorrelationProperties;
+var _AppLogger = require("../telemetry/AppLogger.js");
+var _TelemetrySanitizer = require("../telemetry/TelemetrySanitizer.js");
+const CORRELATION_HEADERS = [['x-ms-request-id', 'xMsRequestId'], ['x-ms-service-request-id', 'xMsServiceRequestId'], ['request-id', 'requestId'], ['x-ms-client-request-id', 'xMsClientRequestId'], ['x-ms-correlation-request-id', 'xMsCorrelationRequestId'], ['x-ms-activity-id', 'xMsActivityId']];
+const OPAQUE_CORRELATION_ID = /^(?:[0-9a-f]{16,64}|[0-9a-f]{8}-[0-9a-f-]{27,})(?:[:/.-][0-9a-f]+)*$/i;
+const TELEMETRY_URL_BASE = 'https://telemetry.invalid';
+function getTelemetryPath(url) {
+  try {
+    const pathname = new URL(url, TELEMETRY_URL_BASE).pathname;
+    let decodedPathname = pathname;
+    try {
+      decodedPathname = decodeURIComponent(pathname);
+    } catch {
+      // Keep the encoded pathname when it contains malformed escape sequences.
+    }
+    return (0, _TelemetrySanitizer.sanitizeErrorString)(decodedPathname).slice(0, 200);
+  } catch {
+    return '<invalid-url>';
+  }
+}
+function isDevelopment() {
+  return globalThis.__DEV__ === true;
+}
+async function logFailedResponse(operationName, method, path, response, shouldLogToConsole) {
+  if (!shouldLogToConsole()) return;
+  try {
+    const body = await response.clone().text();
+    console.warn(`[${operationName}] HTTP ${response.status} for ${method} ${path} | res: ${body.slice(0, 1000)}`);
+  } catch (error) {
+    console.warn(`[${operationName}] HTTP ${response.status} for ${method} ${path} | failed to read response body:`, error);
+  }
+}
+function getHttpCorrelationProperties(headers) {
+  const properties = {};
+  for (const [headerName, propertyName] of CORRELATION_HEADERS) {
+    const value = headers.get(headerName);
+    if (value && value.length <= 256 && OPAQUE_CORRELATION_ID.test(value)) {
+      properties[propertyName] = value;
+    }
+  }
+  return properties;
+}
+class HttpClient {
+  constructor(operationName, shouldLogToConsole = isDevelopment) {
+    this.operationName = operationName;
+    this.shouldLogToConsole = shouldLogToConsole;
+  }
+  async request(url, init) {
+    const method = init?.method ?? 'GET';
+    const path = getTelemetryPath(url);
+    const scenario = (0, _AppLogger.getAppLogger)().trackScenario(this.operationName, {
+      httpMethod: method,
+      url: path
+    });
+    try {
+      const response = await globalThis.fetch(url, init);
+      const properties = {
+        httpStatus: response.status,
+        ...getHttpCorrelationProperties(response.headers)
+      };
+      if (response.ok) scenario.complete(properties);else {
+        scenario.completeWithError(properties);
+        await logFailedResponse(this.operationName, method, path, response, this.shouldLogToConsole);
+      }
+      return response;
+    } catch (error) {
+      scenario.fail(undefined, {
+        errorName: error instanceof Error ? error.constructor.name : typeof error
+      });
+      if (this.shouldLogToConsole()) {
+        console.warn(`[${this.operationName}] fetch THREW for ${method} ${path}:`, error);
+      }
+      throw error;
+    }
+  }
+}
+exports.HttpClient = HttpClient;

package/lib/commonjs/http/index.js

@@ -0,0 +1,18 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+Object.defineProperty(exports, "HttpClient", {
+  enumerable: true,
+  get: function () {
+    return _HttpClient.HttpClient;
+  }
+});
+Object.defineProperty(exports, "getHttpCorrelationProperties", {
+  enumerable: true,
+  get: function () {
+    return _HttpClient.getHttpCorrelationProperties;
+  }
+});
+var _HttpClient = require("./HttpClient.js");

package/lib/commonjs/index.js

@@ -3,12 +3,24 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
+Object.defineProperty(exports, "ApplicationInsightsTelemetryProvider", {
+  enumerable: true,
+  get: function () {
+    return _ApplicationInsightsTelemetryProvider.ApplicationInsightsTelemetryProvider;
+  }
+});
 Object.defineProperty(exports, "ConsoleAdapter", {
   enumerable: true,
   get: function () {
     return _ConsoleAdapter.ConsoleAdapter;
   }
 });
+Object.defineProperty(exports, "HttpClient", {
+  enumerable: true,
+  get: function () {
+    return _HttpClient.HttpClient;
+  }
+});
 Object.defineProperty(exports, "Logger", {
   enumerable: true,
   get: function () {
@@ -45,12 +57,30 @@ Object.defineProperty(exports, "configureAppLogger", {
     return _AppLogger.configureAppLogger;
   }
 });
+Object.defineProperty(exports, "configureCustomerTelemetryLogger", {
+  enumerable: true,
+  get: function () {
+    return _CustomerTelemetryLogger.configureCustomerTelemetryLogger;
+  }
+});
 Object.defineProperty(exports, "getAppLogger", {
   enumerable: true,
   get: function () {
     return _AppLogger.getAppLogger;
   }
 });
+Object.defineProperty(exports, "getCustomerTelemetryLogger", {
+  enumerable: true,
+  get: function () {
+    return _CustomerTelemetryLogger.getCustomerTelemetryLogger;
+  }
+});
+Object.defineProperty(exports, "getHttpCorrelationProperties", {
+  enumerable: true,
+  get: function () {
+    return _HttpClient.getHttpCorrelationProperties;
+  }
+});
 Object.defineProperty(exports, "regionToClusterCategory", {
   enumerable: true,
   get: function () {
@@ -102,11 +132,14 @@ Object.defineProperty(exports, "suppressKnownWarnings", {
 var _ConsoleAdapter = require("./telemetry/ConsoleAdapter.js");
 var _Logger = require("./telemetry/Logger.js");
 var _OneDsTelemetryProvider = require("./telemetry/OneDsTelemetryProvider.js");
+var _ApplicationInsightsTelemetryProvider = require("./telemetry/ApplicationInsightsTelemetryProvider.js");
 var _resolveTelemetryLocation = require("./telemetry/resolveTelemetryLocation.js");
 var _stringifyError = require("./telemetry/stringifyError.js");
 var _TelemetrySanitizer = require("./telemetry/TelemetrySanitizer.js");
 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 _TelemetryTypes = require("./telemetry/TelemetryTypes.js");
 var _ClusterCategory = require("./types/ClusterCategory.js");

package/lib/commonjs/telemetry/AppLogger.js

@@ -5,7 +5,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.configureAppLogger = configureAppLogger;
 exports.getAppLogger = getAppLogger;
-var _Logger = require("./Logger.js");
 /*!
  * Copyright (C) Microsoft Corporation. All rights reserved.
  *
@@ -29,7 +28,21 @@ var _Logger = require("./Logger.js");
  *   configureAppLogger(new Logger({ providers: [myProvider] }));
  */
 
-let _logger = new _Logger.Logger(); // no-op until configured
+const noopLogger = {
+  trackActivityEvent: () => {},
+  trackVerboseEvent: () => {},
+  trackErrorEvent: () => {},
+  trackScenario: () => ({
+    complete: () => {},
+    completeWithError: () => {},
+    fail: () => {}
+  }),
+  setDefaultProperty: () => {},
+  identifyUser: () => {},
+  sessionId: undefined,
+  flush: async () => {}
+};
+let _logger = noopLogger;
 
 /**
  * Replace the shared app logger with a configured instance.

package/lib/commonjs/telemetry/ApplicationInsightsTelemetryProvider.js

@@ -0,0 +1,128 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ApplicationInsightsTelemetryProvider = void 0;
+var _applicationinsightsWeb = require("@microsoft/applicationinsights-web");
+var _manual = require("@microsoft/applicationinsights-react-native/manual");
+var _reactNative = require("react-native");
+var _PlatformInfoUtils = require("../utils/PlatformInfoUtils.js");
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+
+/**
+ * Application Insights adapter for customer-owned mobile-app telemetry.
+ *
+ * The Microsoft React Native manual-device plugin avoids a dependency on
+ * react-native-device-info, which is important for apps loaded by the fixed
+ * Power Apps Dev Player binary.
+ */
+class ApplicationInsightsTelemetryProvider {
+  defaultProperties = {};
+  constructor(config) {
+    const connectionString = config.connectionString.trim();
+    if (!connectionString) {
+      throw new Error('Application Insights connection string is required.');
+    }
+    if (!config.appId.trim()) {
+      throw new Error('Application Insights appId is required.');
+    }
+    this.appId = config.appId.trim();
+    this.appVersion = config.appVersion?.trim() || undefined;
+    this.environment = config.environment?.trim() || undefined;
+    this.includeUserId = config.includeUserId ?? false;
+    this.minSeverity = config.minSeverity ?? 'info';
+    this._sessionId = config.sessionId;
+    const platform = (0, _PlatformInfoUtils.resolvePlatformInfo)();
+    const extensions = [];
+    if (_reactNative.Platform.OS === 'ios' || _reactNative.Platform.OS === 'android') {
+      const reactNativePlugin = new _manual.ReactNativeManualDevicePlugin();
+      reactNativePlugin.setDeviceInfoModule({
+        getModel: () => platform.deviceModel || 'unknown',
+        getDeviceType: () => platform.deviceType || 'unknown',
+        getUniqueId: () => config.deviceId
+      });
+      extensions.push(reactNativePlugin);
+    }
+    this.client = new _applicationinsightsWeb.ApplicationInsights({
+      config: {
+        connectionString,
+        extensions,
+        disableCookiesUsage: true,
+        disableAjaxTracking: true,
+        disableFetchTracking: true,
+        disableExceptionTracking: true,
+        enableAutoRouteTracking: false
+      }
+    });
+    this.client.loadAppInsights();
+  }
+  track(event) {
+    const properties = {
+      ...this.defaultProperties,
+      ...event.properties,
+      app_id: this.appId,
+      session_id: this._sessionId,
+      event_name: event.eventName,
+      sequence_number: event.sequenceNumber,
+      severity: event.severity,
+      timestamp: event.timestamp
+    };
+    if (this.appVersion) properties.app_version = this.appVersion;
+    if (this.environment) properties.deployment_environment = this.environment;
+    if (this.tenantId) properties.tenant_id = this.tenantId;
+    const operationName = String(event.properties.operationName ?? event.eventName);
+    switch (event.severity) {
+      case 'error':
+        this.client.trackException({
+          exception: new Error(String(event.properties.error ?? operationName)),
+          severityLevel: _applicationinsightsWeb.SeverityLevel.Error
+        }, properties);
+        break;
+      case 'warning':
+        this.client.trackTrace({
+          message: operationName,
+          severityLevel: _applicationinsightsWeb.SeverityLevel.Warning
+        }, properties);
+        break;
+      case 'verbose':
+        this.client.trackTrace({
+          message: operationName,
+          severityLevel: _applicationinsightsWeb.SeverityLevel.Verbose
+        }, properties);
+        break;
+      default:
+        this.client.trackEvent({
+          name: operationName
+        }, properties);
+        break;
+    }
+  }
+  async flush() {
+    const result = this.client.flush(true);
+    if (result && typeof result.then === 'function') {
+      await result;
+    }
+  }
+  async teardown() {
+    await this.flush();
+  }
+  get sessionId() {
+    return this._sessionId;
+  }
+  set sessionId(value) {
+    this._sessionId = value;
+  }
+  identifyUser(identity) {
+    this.tenantId = identity.tenantId;
+    if (this.includeUserId) {
+      this.client.setAuthenticatedUserContext(identity.objectId, identity.tenantId, false);
+    }
+  }
+  setDefaultProperty(name, value) {
+    this.defaultProperties[name] = value;
+  }
+}
+exports.ApplicationInsightsTelemetryProvider = ApplicationInsightsTelemetryProvider;

package/lib/commonjs/telemetry/CustomerTelemetryLogger.js

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

package/lib/module/http/HttpClient.js

@@ -0,0 +1,77 @@
+"use strict";
+
+import { getAppLogger } from "../telemetry/AppLogger.js";
+import { sanitizeErrorString } from "../telemetry/TelemetrySanitizer.js";
+const CORRELATION_HEADERS = [['x-ms-request-id', 'xMsRequestId'], ['x-ms-service-request-id', 'xMsServiceRequestId'], ['request-id', 'requestId'], ['x-ms-client-request-id', 'xMsClientRequestId'], ['x-ms-correlation-request-id', 'xMsCorrelationRequestId'], ['x-ms-activity-id', 'xMsActivityId']];
+const OPAQUE_CORRELATION_ID = /^(?:[0-9a-f]{16,64}|[0-9a-f]{8}-[0-9a-f-]{27,})(?:[:/.-][0-9a-f]+)*$/i;
+const TELEMETRY_URL_BASE = 'https://telemetry.invalid';
+function getTelemetryPath(url) {
+  try {
+    const pathname = new URL(url, TELEMETRY_URL_BASE).pathname;
+    let decodedPathname = pathname;
+    try {
+      decodedPathname = decodeURIComponent(pathname);
+    } catch {
+      // Keep the encoded pathname when it contains malformed escape sequences.
+    }
+    return sanitizeErrorString(decodedPathname).slice(0, 200);
+  } catch {
+    return '<invalid-url>';
+  }
+}
+function isDevelopment() {
+  return globalThis.__DEV__ === true;
+}
+async function logFailedResponse(operationName, method, path, response, shouldLogToConsole) {
+  if (!shouldLogToConsole()) return;
+  try {
+    const body = await response.clone().text();
+    console.warn(`[${operationName}] HTTP ${response.status} for ${method} ${path} | res: ${body.slice(0, 1000)}`);
+  } catch (error) {
+    console.warn(`[${operationName}] HTTP ${response.status} for ${method} ${path} | failed to read response body:`, error);
+  }
+}
+export function getHttpCorrelationProperties(headers) {
+  const properties = {};
+  for (const [headerName, propertyName] of CORRELATION_HEADERS) {
+    const value = headers.get(headerName);
+    if (value && value.length <= 256 && OPAQUE_CORRELATION_ID.test(value)) {
+      properties[propertyName] = value;
+    }
+  }
+  return properties;
+}
+export class HttpClient {
+  constructor(operationName, shouldLogToConsole = isDevelopment) {
+    this.operationName = operationName;
+    this.shouldLogToConsole = shouldLogToConsole;
+  }
+  async request(url, init) {
+    const method = init?.method ?? 'GET';
+    const path = getTelemetryPath(url);
+    const scenario = getAppLogger().trackScenario(this.operationName, {
+      httpMethod: method,
+      url: path
+    });
+    try {
+      const response = await globalThis.fetch(url, init);
+      const properties = {
+        httpStatus: response.status,
+        ...getHttpCorrelationProperties(response.headers)
+      };
+      if (response.ok) scenario.complete(properties);else {
+        scenario.completeWithError(properties);
+        await logFailedResponse(this.operationName, method, path, response, this.shouldLogToConsole);
+      }
+      return response;
+    } catch (error) {
+      scenario.fail(undefined, {
+        errorName: error instanceof Error ? error.constructor.name : typeof error
+      });
+      if (this.shouldLogToConsole()) {
+        console.warn(`[${this.operationName}] fetch THREW for ${method} ${path}:`, error);
+      }
+      throw error;
+    }
+  }
+}

package/lib/module/http/index.js

@@ -0,0 +1,3 @@
+"use strict";
+
+export { HttpClient, getHttpCorrelationProperties } from "./HttpClient.js";

package/lib/module/index.js

@@ -8,11 +8,14 @@
 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 { 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 { configureAppLogger, getAppLogger } from "./telemetry/AppLogger.js";
+export { configureCustomerTelemetryLogger, getCustomerTelemetryLogger } from "./telemetry/CustomerTelemetryLogger.js";
 export { ScenarioResults, TelemetryEventNames } from "./telemetry/TelemetryTypes.js";
 export { Regions, regionToClusterCategory } from "./types/ClusterCategory.js";

package/lib/module/telemetry/AppLogger.js

@@ -23,8 +23,21 @@
  *   configureAppLogger(new Logger({ providers: [myProvider] }));
  */
 
-import { Logger } from "./Logger.js";
-let _logger = new Logger(); // no-op until configured
+const noopLogger = {
+  trackActivityEvent: () => {},
+  trackVerboseEvent: () => {},
+  trackErrorEvent: () => {},
+  trackScenario: () => ({
+    complete: () => {},
+    completeWithError: () => {},
+    fail: () => {}
+  }),
+  setDefaultProperty: () => {},
+  identifyUser: () => {},
+  sessionId: undefined,
+  flush: async () => {}
+};
+let _logger = noopLogger;
 
 /**
  * Replace the shared app logger with a configured instance.

package/lib/module/telemetry/ApplicationInsightsTelemetryProvider.js

@@ -0,0 +1,123 @@
+"use strict";
+
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+
+import { ApplicationInsights, SeverityLevel } from '@microsoft/applicationinsights-web';
+import { ReactNativeManualDevicePlugin } from '@microsoft/applicationinsights-react-native/manual';
+import { Platform } from 'react-native';
+import { resolvePlatformInfo } from "../utils/PlatformInfoUtils.js";
+/**
+ * Application Insights adapter for customer-owned mobile-app telemetry.
+ *
+ * The Microsoft React Native manual-device plugin avoids a dependency on
+ * react-native-device-info, which is important for apps loaded by the fixed
+ * Power Apps Dev Player binary.
+ */
+export class ApplicationInsightsTelemetryProvider {
+  defaultProperties = {};
+  constructor(config) {
+    const connectionString = config.connectionString.trim();
+    if (!connectionString) {
+      throw new Error('Application Insights connection string is required.');
+    }
+    if (!config.appId.trim()) {
+      throw new Error('Application Insights appId is required.');
+    }
+    this.appId = config.appId.trim();
+    this.appVersion = config.appVersion?.trim() || undefined;
+    this.environment = config.environment?.trim() || undefined;
+    this.includeUserId = config.includeUserId ?? false;
+    this.minSeverity = config.minSeverity ?? 'info';
+    this._sessionId = config.sessionId;
+    const platform = resolvePlatformInfo();
+    const extensions = [];
+    if (Platform.OS === 'ios' || Platform.OS === 'android') {
+      const reactNativePlugin = new ReactNativeManualDevicePlugin();
+      reactNativePlugin.setDeviceInfoModule({
+        getModel: () => platform.deviceModel || 'unknown',
+        getDeviceType: () => platform.deviceType || 'unknown',
+        getUniqueId: () => config.deviceId
+      });
+      extensions.push(reactNativePlugin);
+    }
+    this.client = new ApplicationInsights({
+      config: {
+        connectionString,
+        extensions,
+        disableCookiesUsage: true,
+        disableAjaxTracking: true,
+        disableFetchTracking: true,
+        disableExceptionTracking: true,
+        enableAutoRouteTracking: false
+      }
+    });
+    this.client.loadAppInsights();
+  }
+  track(event) {
+    const properties = {
+      ...this.defaultProperties,
+      ...event.properties,
+      app_id: this.appId,
+      session_id: this._sessionId,
+      event_name: event.eventName,
+      sequence_number: event.sequenceNumber,
+      severity: event.severity,
+      timestamp: event.timestamp
+    };
+    if (this.appVersion) properties.app_version = this.appVersion;
+    if (this.environment) properties.deployment_environment = this.environment;
+    if (this.tenantId) properties.tenant_id = this.tenantId;
+    const operationName = String(event.properties.operationName ?? event.eventName);
+    switch (event.severity) {
+      case 'error':
+        this.client.trackException({
+          exception: new Error(String(event.properties.error ?? operationName)),
+          severityLevel: SeverityLevel.Error
+        }, properties);
+        break;
+      case 'warning':
+        this.client.trackTrace({
+          message: operationName,
+          severityLevel: SeverityLevel.Warning
+        }, properties);
+        break;
+      case 'verbose':
+        this.client.trackTrace({
+          message: operationName,
+          severityLevel: SeverityLevel.Verbose
+        }, properties);
+        break;
+      default:
+        this.client.trackEvent({
+          name: operationName
+        }, properties);
+        break;
+    }
+  }
+  async flush() {
+    const result = this.client.flush(true);
+    if (result && typeof result.then === 'function') {
+      await result;
+    }
+  }
+  async teardown() {
+    await this.flush();
+  }
+  get sessionId() {
+    return this._sessionId;
+  }
+  set sessionId(value) {
+    this._sessionId = value;
+  }
+  identifyUser(identity) {
+    this.tenantId = identity.tenantId;
+    if (this.includeUserId) {
+      this.client.setAuthenticatedUserContext(identity.objectId, identity.tenantId, false);
+    }
+  }
+  setDefaultProperty(name, value) {
+    this.defaultProperties[name] = value;
+  }
+}

package/lib/module/telemetry/CustomerTelemetryLogger.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 CustomerTelemetryLogger {
+  constructor(logger) {
+    this.logger = logger;
+  }
+  trackEvent(name, properties) {
+    this.logger.trackActivityEvent(name, this.withCustomerSource(properties));
+  }
+  trackError(name, error, properties) {
+    this.logger.trackErrorEvent(name, this.withCustomerSource({
+      ...properties,
+      error: error === undefined ? undefined : stringifyError(error)
+    }));
+  }
+  trackScenario(name, properties) {
+    return this.logger.trackScenario(name, this.withCustomerSource(properties));
+  }
+  flush() {
+    return this.logger.flush();
+  }
+  withCustomerSource(properties) {
+    return {
+      ...properties,
+      telemetry_source: 'customer'
+    };
+  }
+}
+let customerTelemetryLogger = new CustomerTelemetryLogger(new Logger());
+
+/**
+ * Configures the customer telemetry singleton. Hosting infrastructure owns
+ * this function; application code should use getCustomerTelemetryLogger().
+ */
+export function configureCustomerTelemetryLogger(logger) {
+  customerTelemetryLogger = new CustomerTelemetryLogger(logger);
+}
+
+/**
+ * Returns the customer-owned telemetry logger. It is a safe no-op until the
+ * host configures an Application Insights provider.
+ */
+export function getCustomerTelemetryLogger() {
+  return customerTelemetryLogger;
+}

package/lib/typescript/commonjs/http/HttpClient.d.ts

@@ -0,0 +1,8 @@
+export declare function getHttpCorrelationProperties(headers: Pick<Headers, 'get'>): Record<string, string>;
+export declare class HttpClient {
+    private readonly operationName;
+    private readonly shouldLogToConsole;
+    constructor(operationName: string, shouldLogToConsole?: () => boolean);
+    request(url: string, init?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/lib/typescript/commonjs/http/index.d.ts

@@ -0,0 +1,2 @@
+export { HttpClient, getHttpCorrelationProperties } from './HttpClient';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/index.d.ts

@@ -6,13 +6,17 @@ export { ConsoleAdapter } from './telemetry/ConsoleAdapter';
 export type { ILogger, ScenarioTracker } from './telemetry/ILogger';
 export { Logger } from './telemetry/Logger';
 export { OneDsTelemetryProvider } from './telemetry/OneDsTelemetryProvider';
+export { ApplicationInsightsTelemetryProvider } from './telemetry/ApplicationInsightsTelemetryProvider';
 export { resolveTelemetryLocation } from './telemetry/resolveTelemetryLocation';
 export { stringifyError } from './telemetry/stringifyError';
 export { sanitizeErrorString, sanitizeUrl, sanitizeProperties } from './telemetry/TelemetrySanitizer';
 export { suppressKnownWarnings } from './telemetry/suppressKnownWarnings';
+export { HttpClient, getHttpCorrelationProperties } from './http/HttpClient';
 export { resolveDeviceId } from './utils/DeviceIdUtils';
 export { configureAppLogger, getAppLogger } from './telemetry/AppLogger';
-export type { ITelemetryProvider, LoggerConfig, OneDsTelemetryProviderConfig, PropertyColumnMap, TelemetryEnvelope, TelemetryEvent, TelemetryLocation, TelemetrySeverity, UserIdentity, } from './telemetry/TelemetryTypes';
+export { configureCustomerTelemetryLogger, getCustomerTelemetryLogger, } from './telemetry/CustomerTelemetryLogger';
+export type { ICustomerTelemetryLogger } from './telemetry/CustomerTelemetryLogger';
+export type { ITelemetryProvider, LoggerConfig, OneDsTelemetryProviderConfig, ApplicationInsightsTelemetryProviderConfig, PropertyColumnMap, TelemetryEnvelope, TelemetryEvent, TelemetryLocation, TelemetrySeverity, UserIdentity, } from './telemetry/TelemetryTypes';
 export { ScenarioResults, TelemetryEventNames } from './telemetry/TelemetryTypes';
 export type { ClusterCategory, Region } from './types/ClusterCategory';
 export { Regions, regionToClusterCategory } from './types/ClusterCategory';

package/lib/typescript/commonjs/telemetry/ApplicationInsightsTelemetryProvider.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ApplicationInsightsTelemetryProviderConfig, ITelemetryProvider, TelemetryEvent, UserIdentity } from './TelemetryTypes';
+/**
+ * Application Insights adapter for customer-owned mobile-app telemetry.
+ *
+ * The Microsoft React Native manual-device plugin avoids a dependency on
+ * react-native-device-info, which is important for apps loaded by the fixed
+ * Power Apps Dev Player binary.
+ */
+export declare class ApplicationInsightsTelemetryProvider implements ITelemetryProvider {
+    readonly minSeverity: import("./TelemetryTypes").TelemetrySeverity;
+    private readonly client;
+    private readonly appId;
+    private readonly appVersion?;
+    private readonly environment?;
+    private readonly includeUserId;
+    private readonly defaultProperties;
+    private _sessionId;
+    private tenantId?;
+    constructor(config: ApplicationInsightsTelemetryProviderConfig);
+    track(event: TelemetryEvent): void;
+    flush(): Promise<void>;
+    teardown(): Promise<void>;
+    get sessionId(): string;
+    set sessionId(value: string);
+    identifyUser(identity: UserIdentity): void;
+    setDefaultProperty(name: string, value: string): void;
+}
+//# sourceMappingURL=ApplicationInsightsTelemetryProvider.d.ts.map

package/lib/typescript/commonjs/telemetry/CustomerTelemetryLogger.d.ts

@@ -0,0 +1,21 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ILogger, ScenarioTracker } from './ILogger';
+export interface ICustomerTelemetryLogger {
+    trackEvent(name: string, properties?: Record<string, unknown>): void;
+    trackError(name: string, error?: unknown, properties?: Record<string, unknown>): void;
+    trackScenario(name: string, properties?: Record<string, unknown>): ScenarioTracker;
+    flush(): Promise<void>;
+}
+/**
+ * Configures the customer telemetry singleton. Hosting infrastructure owns
+ * this function; application code should use getCustomerTelemetryLogger().
+ */
+export declare function configureCustomerTelemetryLogger(logger: ILogger): void;
+/**
+ * Returns the customer-owned telemetry logger. It is a safe no-op until the
+ * host configures an Application Insights provider.
+ */
+export declare function getCustomerTelemetryLogger(): ICustomerTelemetryLogger;
+//# sourceMappingURL=CustomerTelemetryLogger.d.ts.map

package/lib/typescript/commonjs/telemetry/TelemetryTypes.d.ts

@@ -85,4 +85,25 @@ export interface OneDsTelemetryProviderConfig {
     propertyColumnMap?: PropertyColumnMap;
     channelConfig?: Record<string, unknown>;
 }
+export interface ApplicationInsightsTelemetryProviderConfig {
+    /** Connection string for the C1-owned workspace-based Application Insights resource. */
+    connectionString: string;
+    /** Stable generated-app identifier added to every telemetry item. */
+    appId: string;
+    /** App version added to every telemetry item. */
+    appVersion?: string;
+    /** Deployment environment such as `development`, `test`, or `production`. */
+    environment?: string;
+    /** Minimum severity to export. Default: `info`. */
+    minSeverity?: TelemetrySeverity;
+    /** Stable device identifier supplied by the host. */
+    deviceId: string;
+    /** Shared logger session identifier supplied by the host. */
+    sessionId: string;
+    /**
+     * Include the signed-in user's object ID in authenticated-user context.
+     * Default is false because customer application telemetry should be anonymous.
+     */
+    includeUserId?: boolean;
+}
 //# sourceMappingURL=TelemetryTypes.d.ts.map

package/lib/typescript/module/http/HttpClient.d.ts

@@ -0,0 +1,8 @@
+export declare function getHttpCorrelationProperties(headers: Pick<Headers, 'get'>): Record<string, string>;
+export declare class HttpClient {
+    private readonly operationName;
+    private readonly shouldLogToConsole;
+    constructor(operationName: string, shouldLogToConsole?: () => boolean);
+    request(url: string, init?: RequestInit): Promise<Response>;
+}
+//# sourceMappingURL=HttpClient.d.ts.map

package/lib/typescript/module/http/index.d.ts

@@ -0,0 +1,2 @@
+export { HttpClient, getHttpCorrelationProperties } from './HttpClient.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/index.d.ts

@@ -6,13 +6,17 @@ export { ConsoleAdapter } from './telemetry/ConsoleAdapter.js';
 export type { ILogger, ScenarioTracker } from './telemetry/ILogger.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 { 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 { configureAppLogger, getAppLogger } from './telemetry/AppLogger.js';
-export type { ITelemetryProvider, LoggerConfig, OneDsTelemetryProviderConfig, PropertyColumnMap, TelemetryEnvelope, TelemetryEvent, TelemetryLocation, TelemetrySeverity, UserIdentity, } from './telemetry/TelemetryTypes.js';
+export { configureCustomerTelemetryLogger, getCustomerTelemetryLogger, } from './telemetry/CustomerTelemetryLogger.js';
+export type { ICustomerTelemetryLogger } from './telemetry/CustomerTelemetryLogger.js';
+export type { ITelemetryProvider, LoggerConfig, OneDsTelemetryProviderConfig, ApplicationInsightsTelemetryProviderConfig, PropertyColumnMap, TelemetryEnvelope, TelemetryEvent, TelemetryLocation, TelemetrySeverity, UserIdentity, } from './telemetry/TelemetryTypes.js';
 export { ScenarioResults, TelemetryEventNames } from './telemetry/TelemetryTypes.js';
 export type { ClusterCategory, Region } from './types/ClusterCategory.js';
 export { Regions, regionToClusterCategory } from './types/ClusterCategory.js';

package/lib/typescript/module/telemetry/ApplicationInsightsTelemetryProvider.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ApplicationInsightsTelemetryProviderConfig, ITelemetryProvider, TelemetryEvent, UserIdentity } from './TelemetryTypes.js';
+/**
+ * Application Insights adapter for customer-owned mobile-app telemetry.
+ *
+ * The Microsoft React Native manual-device plugin avoids a dependency on
+ * react-native-device-info, which is important for apps loaded by the fixed
+ * Power Apps Dev Player binary.
+ */
+export declare class ApplicationInsightsTelemetryProvider implements ITelemetryProvider {
+    readonly minSeverity: import("./TelemetryTypes.js").TelemetrySeverity;
+    private readonly client;
+    private readonly appId;
+    private readonly appVersion?;
+    private readonly environment?;
+    private readonly includeUserId;
+    private readonly defaultProperties;
+    private _sessionId;
+    private tenantId?;
+    constructor(config: ApplicationInsightsTelemetryProviderConfig);
+    track(event: TelemetryEvent): void;
+    flush(): Promise<void>;
+    teardown(): Promise<void>;
+    get sessionId(): string;
+    set sessionId(value: string);
+    identifyUser(identity: UserIdentity): void;
+    setDefaultProperty(name: string, value: string): void;
+}
+//# sourceMappingURL=ApplicationInsightsTelemetryProvider.d.ts.map

package/lib/typescript/module/telemetry/CustomerTelemetryLogger.d.ts

@@ -0,0 +1,21 @@
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ */
+import type { ILogger, ScenarioTracker } from './ILogger.js';
+export interface ICustomerTelemetryLogger {
+    trackEvent(name: string, properties?: Record<string, unknown>): void;
+    trackError(name: string, error?: unknown, properties?: Record<string, unknown>): void;
+    trackScenario(name: string, properties?: Record<string, unknown>): ScenarioTracker;
+    flush(): Promise<void>;
+}
+/**
+ * Configures the customer telemetry singleton. Hosting infrastructure owns
+ * this function; application code should use getCustomerTelemetryLogger().
+ */
+export declare function configureCustomerTelemetryLogger(logger: ILogger): void;
+/**
+ * Returns the customer-owned telemetry logger. It is a safe no-op until the
+ * host configures an Application Insights provider.
+ */
+export declare function getCustomerTelemetryLogger(): ICustomerTelemetryLogger;
+//# sourceMappingURL=CustomerTelemetryLogger.d.ts.map

package/lib/typescript/module/telemetry/TelemetryTypes.d.ts

@@ -85,4 +85,25 @@ export interface OneDsTelemetryProviderConfig {
     propertyColumnMap?: PropertyColumnMap;
     channelConfig?: Record<string, unknown>;
 }
+export interface ApplicationInsightsTelemetryProviderConfig {
+    /** Connection string for the C1-owned workspace-based Application Insights resource. */
+    connectionString: string;
+    /** Stable generated-app identifier added to every telemetry item. */
+    appId: string;
+    /** App version added to every telemetry item. */
+    appVersion?: string;
+    /** Deployment environment such as `development`, `test`, or `production`. */
+    environment?: string;
+    /** Minimum severity to export. Default: `info`. */
+    minSeverity?: TelemetrySeverity;
+    /** Stable device identifier supplied by the host. */
+    deviceId: string;
+    /** Shared logger session identifier supplied by the host. */
+    sessionId: string;
+    /**
+     * Include the signed-in user's object ID in authenticated-user context.
+     * Default is false because customer application telemetry should be anonymous.
+     */
+    includeUserId?: boolean;
+}
 //# sourceMappingURL=TelemetryTypes.d.ts.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@microsoft/power-apps-native-common",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "Shared utilities and types for Power Apps native packages",
   "author": "Microsoft Corporation",
   "license": "SEE LICENSE IN LICENSE",
@@ -21,6 +21,16 @@
         "default": "./lib/commonjs/index.js"
       }
     },
+    "./http": {
+      "import": {
+        "types": "./lib/typescript/module/http/index.d.ts",
+        "default": "./lib/module/http/index.js"
+      },
+      "require": {
+        "types": "./lib/typescript/commonjs/http/index.d.ts",
+        "default": "./lib/commonjs/http/index.js"
+      }
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -30,6 +40,7 @@
   "scripts": {
     "prepack": "bob build && node ../../scripts/notices.js",
     "build": "bob build && node ../../scripts/notices.js",
+    "test": "node --test test/*.test.js",
     "type-check": "tsc --noEmit"
   },
   "peerDependencies": {
@@ -43,6 +54,8 @@
   "dependencies": {
     "@microsoft/1ds-post-js": "4.4.1",
     "@microsoft/applicationinsights-core-js": "3.4.1",
+    "@microsoft/applicationinsights-react-native": "4.4.1",
+    "@microsoft/applicationinsights-web": "3.4.3",
     "uuid": "^11.1.1"
   },
   "devDependencies": {