@microsoft/power-apps-native-host 0.3.0 → 0.4.0

package/lib/typescript/commonjs/connections/resolveConnections.d.ts

@@ -39,6 +39,8 @@ export interface StaticRefsOptions {
      * Shape: { [refId]: { id: string; dataSources: string[] } }
      */
     connectionReferences: Record<string, ConnectionReferenceConfig>;
+    /** Whether power.config.json contains Dataverse database references. */
+    hasDataverse: boolean;
     /** Connector schema map keyed by data source name. */
     schemaMap: Record<string, ConnectorSchema>;
     environmentId: string;
@@ -67,7 +69,7 @@ export interface StaticRefsOptions {
  *     `true`.
  *  5. Build and return an `AppLaunchResult`-shaped object.
  */
-export declare function resolveViaStaticRefs({ connectionReferences, schemaMap, environmentId, region, acquireToken, token, isvClientId, onDisambiguationNeeded, onMissingConnection, }: StaticRefsOptions): Promise<AppLaunchResult>;
+export declare function resolveViaStaticRefs({ connectionReferences, hasDataverse, schemaMap, environmentId, region, acquireToken, token, isvClientId, onDisambiguationNeeded, onMissingConnection, }: StaticRefsOptions): Promise<AppLaunchResult>;
 /**
  * Run idempotent post-resolution delegated consent grants for the calling app.
  *

package/lib/typescript/commonjs/connections/useConnectionRefs.d.ts

@@ -59,6 +59,8 @@ export interface UseConnectionRefsOptions {
      * Shape: { [refId]: { id: string; dataSources: string[] } }
      */
     connectionReferences: Record<string, ConnectionReferenceConfig>;
+    /** Whether power.config.json contains Dataverse database references. */
+    hasDataverse: boolean;
     /**
      * Connector schema map keyed by data source name.
       * Used only in Dev Player for unpublished local apps.
@@ -131,5 +133,5 @@ export type ConnectionResolutionErrorKind = 'app-access-denied' | 'generic';
  * Both paths disambiguate candidates, pre-warm Dataverse authentication, and
  * return a fully populated bridge configuration.
  */
-export declare function useConnectionRefs({ isSignedIn, acquireToken, appId, environmentId, region, connectionReferences, schemaMap, onDisambiguationNeeded, onMissingConnection, isvClientId, }: UseConnectionRefsOptions): UseConnectionRefsResult;
+export declare function useConnectionRefs({ isSignedIn, acquireToken, appId, environmentId, region, connectionReferences, hasDataverse, schemaMap, onDisambiguationNeeded, onMissingConnection, isvClientId, }: UseConnectionRefsOptions): UseConnectionRefsResult;
 //# sourceMappingURL=useConnectionRefs.d.ts.map

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

@@ -3,6 +3,7 @@
  * React Native host integration for @microsoft/power-apps
  *
  */
+import '@microsoft/power-apps-native-assets';
 export { NativePowerAppsBridge } from './bridge/NativePowerAppsBridge';
 export { PowerPagesBridge, setupPowerPagesHost } from './bridge/PowerPagesBridge';
 export type { PowerPagesBridgeOptions } from './bridge/PowerPagesBridge';
@@ -17,7 +18,7 @@ export type { AuthConfig, MsalAuthConfig, IntuneConfig } from '@microsoft/power-
 export { PowerAppsHostProvider } from './provider/PowerAppsHostProvider';
 export type { PowerAppsHostProviderProps } from './provider/PowerAppsHostProvider';
 export { PowerAppsProvider } from './provider/PowerAppsProvider';
-export type { AppInsightsConfig, PowerAppsProviderProps, PowerConfig } from './provider/PowerAppsProvider';
+export type { AppInsightsConfig, PowerAppsAppConfig, PowerAppsProviderProps, PowerConfig, } from './provider/PowerAppsProvider';
 export { buildEnvironmentEndpoint, POWER_PLATFORM_API_SCOPE } from './platform/PowerPlatformEnvironmentApi';
 export { fetchInstanceUrl } from './platform/DataverseGlobalDiscoveryApi';
 export { buildCdsDataSources } from './platform/DataverseDataSources';
@@ -46,7 +47,7 @@ export { ImagePicker } from './controls/ImagePicker';
 export type { ImagePickerProps, PickedImageInfo } from './controls/ImagePicker';
 export { isDevPlayer } from './utils/isDevPlayer';
 export { base64ToDataverseUploadFile, base64ToUint8Array, createDataverseUploadFile, } from './utils/dataverseUtils';
-export { getAppLogger, configureAppLogger, getCustomerTelemetryLogger, HostOperationNames, } from './telemetry';
-export type { ICustomerTelemetryLogger, ILogger, } from '@microsoft/power-apps-native-common';
+export { getAppLogger, configureAppLogger, getCustomEventsLogger, HostOperationNames, } from './telemetry';
+export type { ICustomEventsLogger, ILogger, } from '@microsoft/power-apps-native-common';
 export { ErrorBoundary } from './ErrorBoundary';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/commonjs/platform/DataverseDataSources.d.ts

@@ -18,6 +18,7 @@ export interface DatabaseReferenceDataSource {
 export interface DatabaseReference {
     dataSources?: Record<string, DatabaseReferenceDataSource>;
 }
+export declare function hasDataverseDatabaseReferences<T>(databaseReferences?: Record<string, T>): boolean;
 export declare function buildCdsDataSources(databaseReferences: Record<string, DatabaseReference>, dataverseOrgUrl: string): Array<{
     runtimeUrl: string;
     entitySetName: string;

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

@@ -69,7 +69,25 @@ export interface AppInsightsConfig extends Omit<ApplicationInsightsTelemetryProv
     /** 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. */
@@ -134,16 +152,21 @@ export interface PowerAppsProviderProps {
      */
     logger?: ILogger | null;
     /**
-     * Show app and telemetry session details after a three-finger downward swipe.
+     * 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
+     * Events are sent directly to the selected customer-owned Application Insights
      * resource and fan out alongside the default Microsoft OneDS provider.
-     * Defaults to `expo.extra.appInsightsConfig` from app.json.
+     * Defaults to `appConfig.expo.extra.appInsightsConfig`, then falls back to
+     * `Constants.expoConfig.extra.appInsightsConfig`.
      * Ignored when `logger` is provided or `null`.
      */
     appInsightsConfig?: AppInsightsConfig;
@@ -164,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, onConnectionConsent, onResourceConsent, onConnectionConsentDeclined, appName, logger: loggerProp, showSessionDetailsOnSwipe, appInsightsConfig, 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/telemetry/index.d.ts

@@ -8,8 +8,8 @@
  * alongside the canonical host operation-name constants.
  */
 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';
+export { getAppLogger, configureAppLogger, getCustomEventsLogger } from '@microsoft/power-apps-native-common';
+export type { ICustomEventsLogger } from '@microsoft/power-apps-native-common';
 /**
  * Canonical operation names for host package telemetry.
  * Follow the `PowerAppsHost.<Subsystem>.<Action>` convention so events are

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