@microsoft/power-apps-native-host 0.2.25 → 0.3.3

package/lib/typescript/commonjs/provider/PowerAppsProvider.d.ts

@@ -28,11 +28,12 @@ import React from 'react';
 import { createTamagui } from '@tamagui/core';
 import type { AuthProviderProps } from '../auth/AuthContext';
 import type { PowerAppsHostProviderProps } from './PowerAppsHostProvider';
-import type { ConnectorSchema } from '../platform/useConnectionRefs';
-import type { DatabaseReference } from '../platform/PowerPlatformEnvironmentApi';
-import type { OnDisambiguationNeeded } from '../connections/types';
+import type { ConnectorSchema } from '../connections/useConnectionRefs';
+import type { DatabaseReference } from '../platform/DataverseDataSources';
+import type { ConnectionReferenceConfig, OnDisambiguationNeeded } from '../connections/types';
 import type { ThemeTokens } from '../theme/tokens';
 import type { ILogger } from '@microsoft/power-apps-native-common';
+import type { ApplicationInsightsTelemetryProviderConfig } from '@microsoft/power-apps-native-common';
 /** Shape of power.config.json consumed by the provider. */
 export interface PowerConfig {
     /**
@@ -53,10 +54,7 @@ export interface PowerConfig {
      * Omit for the default global collector.
      */
     geoRegion?: string;
-    connectionReferences?: Record<string, {
-        id: string;
-        dataSources: string[];
-    }>;
+    connectionReferences?: Record<string, ConnectionReferenceConfig>;
     databaseReferences?: Record<string, DatabaseReference>;
     /**
      * Allow additional keys — the offline SDK reads arbitrary fields from
@@ -67,7 +65,29 @@ export interface PowerConfig {
     [key: string]: unknown;
 }
 type TamaguiConfig = ReturnType<typeof createTamagui>;
+export interface AppInsightsConfig extends Omit<ApplicationInsightsTelemetryProviderConfig, 'deviceId' | 'sessionId'> {
+    /** Explicit opt-in. Application Insights telemetry is disabled unless this is true. */
+    enabled: boolean;
+}
+export interface PowerAppsAppConfig {
+    expo?: {
+        extra?: {
+            appInsightsConfig?: unknown;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
 export interface PowerAppsProviderProps {
+    /**
+     * Contents of the generated app.json.
+     *
+     * Pass this when the app runs inside a host such as Dev Player, where
+     * `Constants.expoConfig` describes the host instead of the loaded app.
+     * The provider falls back to `Constants.expoConfig` when omitted.
+     */
+    appConfig?: PowerAppsAppConfig;
     /** MSAL configuration from auth.config.json (msal section). */
     msalConfig: AuthProviderProps['msalConfig'];
     /** Intune MAM configuration. Defaults to enabled in release builds. */
@@ -106,6 +126,12 @@ export interface PowerAppsProviderProps {
     renderOAuthWebView?: PowerAppsHostProviderProps['renderOAuthWebView'];
     /** See PowerAppsHostProviderProps.onDisambiguationNeeded. */
     onDisambiguationNeeded?: OnDisambiguationNeeded;
+    /** See PowerAppsHostProviderProps.onConnectionConsent. */
+    onConnectionConsent?: PowerAppsHostProviderProps['onConnectionConsent'];
+    /** See PowerAppsHostProviderProps.onResourceConsent. */
+    onResourceConsent?: PowerAppsHostProviderProps['onResourceConsent'];
+    /** See PowerAppsHostProviderProps.onConnectionConsentDeclined. */
+    onConnectionConsentDeclined?: PowerAppsHostProviderProps['onConnectionConsentDeclined'];
     /**
      * App name used as `clientType` in the auto-wired 1DS telemetry provider.
      * Appears in Kusto as the `clientType` column — use a stable
@@ -125,6 +151,25 @@ export interface PowerAppsProviderProps {
      *   logger becomes a no-op regardless of build variant.
      */
     logger?: ILogger | null;
+    /**
+     * Show app and telemetry session details after a three-finger long press.
+     * Available in both development and published native apps. @default true
+     */
+    showSessionDetailsOnLongPress?: boolean;
+    /**
+     * @deprecated Use `showSessionDetailsOnLongPress` instead.
+     */
+    showSessionDetailsOnSwipe?: boolean;
+    /**
+     * Optional customer-owned Application Insights destination.
+     *
+     * Events are sent directly to the selected C1-owned Application Insights
+     * resource and fan out alongside the default Microsoft OneDS provider.
+     * Defaults to `appConfig.expo.extra.appInsightsConfig`, then falls back to
+     * `Constants.expoConfig.extra.appInsightsConfig`.
+     * Ignored when `logger` is provided or `null`.
+     */
+    appInsightsConfig?: AppInsightsConfig;
     /**
      * Offline profile JSON — optional override.
      * Primary source: SDK config plugin embeds offline-profile.json into the app
@@ -142,7 +187,7 @@ export interface PowerAppsProviderProps {
  * component, eliminating all provider boilerplate from the consuming app's
  * root layout.
  */
-export declare function PowerAppsProvider({ msalConfig, intuneConfig, powerConfig, schemaMap, tamaguiConfig, // override with app's tamagui.config.ts
-defaultTheme, theme, darkTheme, followSystemTheme, renderOAuthWebView, onDisambiguationNeeded, appName, logger: loggerProp, offlineProfile, children, }: PowerAppsProviderProps): React.JSX.Element;
+export declare function PowerAppsProvider({ appConfig, msalConfig, intuneConfig, powerConfig, schemaMap, tamaguiConfig, // override with app's tamagui.config.ts
+defaultTheme, theme, darkTheme, followSystemTheme, renderOAuthWebView, onDisambiguationNeeded, onConnectionConsent, onResourceConsent, onConnectionConsentDeclined, appName, logger: loggerProp, showSessionDetailsOnLongPress, showSessionDetailsOnSwipe, appInsightsConfig, offlineProfile, children, }: PowerAppsProviderProps): React.JSX.Element;
 export {};
 //# sourceMappingURL=PowerAppsProvider.d.ts.map

package/lib/typescript/commonjs/provider/SessionDetailsGesture.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+interface SessionDetailsGestureProps {
+    enabled: boolean;
+    appName: string;
+    appId?: string;
+    environmentId?: string;
+    region: string;
+    appVersion?: string;
+    children: React.ReactNode;
+}
+export declare function SessionDetailsGesture({ enabled, appName, appId, environmentId, region, appVersion, children, }: SessionDetailsGestureProps): React.JSX.Element;
+export {};
+//# sourceMappingURL=SessionDetailsGesture.d.ts.map

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

@@ -0,0 +1,15 @@
+/**
+ * Forwards the privacy-safe Offline SDK transport through the host's existing
+ * app logger so offline events carry the same session, device, and user data.
+ *
+ * The host owns exactly one thing here: binding the SDK transport to this
+ * host's logger. Buffering and teardown semantics live in the SDK.
+ *
+ * Setup and teardown are fail-open but not silent. This runs from an effect in
+ * the provider that roots the app, so an unguarded throw would take down the
+ * whole tree — telemetry is never worth an app that will not start. An
+ * unexpected failure is therefore downgraded to a logged diagnostic rather than
+ * swallowed, so broken wiring stays observable.
+ */
+export declare function configureOfflineSdkTelemetry(forwardEvents: boolean): () => void;
+//# sourceMappingURL=OfflineSdkTelemetry.d.ts.map

package/lib/typescript/commonjs/telemetry/OfflineSdkTelemetry.web.d.ts

@@ -0,0 +1,2 @@
+export declare function configureOfflineSdkTelemetry(_forwardEvents: boolean): () => void;
+//# sourceMappingURL=OfflineSdkTelemetry.web.d.ts.map

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

@@ -7,7 +7,9 @@
  * (`getAppLogger` / `configureAppLogger`). This module re-exports those
  * alongside the canonical host operation-name constants.
  */
-export { getAppLogger, configureAppLogger } from '@microsoft/power-apps-native-common';
+import { HttpClient } from '@microsoft/power-apps-native-common/http';
+export { getAppLogger, configureAppLogger, getCustomerTelemetryLogger } from '@microsoft/power-apps-native-common';
+export type { ICustomerTelemetryLogger } from '@microsoft/power-apps-native-common';
 /**
  * Canonical operation names for host package telemetry.
  * Follow the `PowerAppsHost.<Subsystem>.<Action>` convention so events are
@@ -34,15 +36,25 @@ export declare const HostOperationNames: {
     readonly BridgeTokenAcquireFailed: "PowerAppsHost.Bridge.TokenAcquire.Failed";
     /** Top-level React error boundary caught an unhandled JS error. */
     readonly RuntimeUnhandledJsError: "PowerAppsHost.Runtime.UnhandledJsError";
+    /** Power Platform RP HTTP request, including backend correlation IDs. */
+    readonly PlatformHttpRequest: "PowerAppsHost.Platform.HttpRequest";
     /** Resolve Dataverse instanceUrl from Power Platform environment API. */
     readonly PlatformFetchInstanceUrl: "PowerAppsHost.Platform.FetchInstanceUrl";
     /** useConnectionRefs failed to resolve connections (recoverable). Recorded only on failure. */
     readonly PlatformLoadConnectionsFailed: "PowerAppsHost.Platform.LoadConnections.Failed";
     /** Create a new Power Platform connection. */
     readonly PlatformCreateConnection: "PowerAppsHost.Platform.CreateConnection";
+    /** Repair an existing Power Platform connection. */
+    readonly PlatformRepairConnection: "PowerAppsHost.Platform.RepairConnection";
+    /** Poll a connection until it becomes active. */
+    readonly PlatformPollConnectionStatus: "PowerAppsHost.Platform.PollConnectionStatus";
     /** Resolve app connection references for the current launch. */
     readonly PlatformResolveConnectionRefs: "PowerAppsHost.Platform.ResolveConnectionRefs";
     /** Grant this app access to a Power Platform connection ACL. */
     readonly PlatformConnectionAclGrant: "PowerAppsHost.Platform.ConnectionAclGrant";
+    /** Installed Offline SDK predates the SDK-owned routing contract. */
+    readonly OfflineRoutingContractUnsupported: "PowerAppsHost.Offline.RoutingContract.Unsupported";
 };
+export declare const bridgeHttpClient: HttpClient;
+export declare const platformHttpClient: HttpClient;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/auth/AuthContext.d.ts

@@ -46,9 +46,11 @@ export interface AuthProviderProps {
      * Pass explicitly only to override the default (e.g. in tests).
      */
     intuneConfig?: IntuneConfig;
+    /** Token audiences that must be available before the account is considered signed in. */
+    requiredScopes?: string[];
     children: React.ReactNode;
 }
-export declare function AuthProvider({ msalConfig, intuneConfig, children }: AuthProviderProps): React.JSX.Element;
+export declare function AuthProvider({ msalConfig, intuneConfig, requiredScopes, children, }: AuthProviderProps): React.JSX.Element;
 /**
  * Returns the current auth state from the nearest <AuthProvider>.
  * Must be called within the AuthProvider tree.

package/lib/typescript/module/auth/AuthContext.web.d.ts

@@ -13,6 +13,7 @@ export interface AuthState {
 export interface AuthProviderProps {
     msalConfig: MsalAuthConfig;
     intuneConfig?: IntuneConfig;
+    requiredScopes?: string[];
     children: React.ReactNode;
 }
 export declare function AuthProvider({ children }: AuthProviderProps): React.JSX.Element;

package/lib/typescript/module/bridge/bridgeState.d.ts

@@ -0,0 +1,5 @@
+import type { NativeBridgeOptions } from './NativePowerAppsBridge.js';
+export declare function getRequestBodyForMethod(method: string, body: BodyInit | null): BodyInit | null;
+export declare function assertSuccessfulHttpStatus(status: number, method: string): void;
+export declare function updateBridgeOptionsInPlace(current: NativeBridgeOptions, next: NativeBridgeOptions): NativeBridgeOptions;
+//# sourceMappingURL=bridgeState.d.ts.map

package/lib/typescript/module/config/babelConfig.d.ts

@@ -0,0 +1,12 @@
+export interface BabelConfigApi {
+    cache(value: boolean): void;
+}
+export interface PowerAppsBabelConfigOptions {
+    presets?: unknown[];
+    plugins?: unknown[];
+}
+export declare function createPowerAppsBabelConfig(api: BabelConfigApi, options?: PowerAppsBabelConfigOptions): {
+    presets: unknown[];
+    plugins: unknown[];
+};
+//# sourceMappingURL=babelConfig.d.ts.map

package/lib/typescript/module/config/expoConfig.d.ts

@@ -0,0 +1,21 @@
+import type { ConfigContext, ExpoConfig } from 'expo/config';
+export interface PowerAppsExpoConfigSettings {
+    name: string;
+    slug: string;
+    scheme: string;
+    androidPackage: string;
+    iosBundleIdentifier: string;
+    version: string;
+    versionCode: number;
+    iconPath?: string | null;
+    /**
+     * Optional splash image. When omitted, falls back to the `APP_SPLASH_PATH`
+     * environment variable and then to the branding placeholder, so the template
+     * needs no wiring of its own and prebuild always emits replaceable slots.
+     */
+    splashPath?: string | null;
+    isDevClient?: boolean;
+}
+export type CustomizePowerAppsExpoConfig = (config: ExpoConfig) => ExpoConfig;
+export declare function createPowerAppsExpoConfig(baseConfig: ConfigContext['config'], settings: PowerAppsExpoConfigSettings, customize?: CustomizePowerAppsExpoConfig): ExpoConfig;
+//# sourceMappingURL=expoConfig.d.ts.map

package/lib/typescript/module/config/metroConfig.d.ts

@@ -0,0 +1,6 @@
+import { getDefaultConfig } from 'expo/metro-config.js';
+type PowerAppsMetroConfig = ReturnType<typeof getDefaultConfig>;
+type CustomizeMetroConfig = (config: PowerAppsMetroConfig) => PowerAppsMetroConfig;
+export declare function createPowerAppsMetroConfig(projectRoot: string, customize?: CustomizeMetroConfig): PowerAppsMetroConfig;
+export {};
+//# sourceMappingURL=metroConfig.d.ts.map

package/lib/typescript/module/config/metroLogger.d.ts

@@ -0,0 +1,21 @@
+import type { IncomingMessage, ServerResponse } from 'node:http';
+type InstrumentationContext = {
+    phase: string;
+    logPath: string;
+};
+type InstrumentationErrorHandler = (error: Error, context: InstrumentationContext) => void;
+type MetroNext = (error?: Error) => void;
+export type MetroMiddleware = (request: IncomingMessage, response: ServerResponse, next: MetroNext) => unknown;
+export type MetroLoggingOptions = {
+    projectRoot?: string;
+    maxBodyBytes?: number;
+    onError?: InstrumentationErrorHandler;
+};
+export declare function redactMetroLog(value: unknown): string;
+export declare function enablePowerNativeMetroLogging(options?: MetroLoggingOptions): {
+    logDir: string;
+    logPath: string;
+};
+export declare function withPowerNativeMetroLogging(middleware: MetroMiddleware, options?: MetroLoggingOptions): MetroMiddleware;
+export {};
+//# sourceMappingURL=metroLogger.d.ts.map