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

package/lib/typescript/module/connections/disambiguate.d.ts

@@ -27,6 +27,7 @@ import type { NativeConnectionInstance, NativeConnectionResolution } from './typ
 export declare function disambiguateConnections(connectionReferences: Record<string, {
     id: string;
     dataSources: string[];
+    sharedConnectionId?: string;
 }>, allConnectionsByApiId: Record<string, NativeConnectionInstance[]>): NativeConnectionResolution[];
 /**
  * Extract the connection UUID from a raw connection name returned by the API.
@@ -36,8 +37,9 @@ export declare function disambiguateConnections(connectionReferences: Record<str
  *   "abc12345def6789012345678901234ab"                        (bare UUID, no dashes)
  *   "abc12345-def6-7890-1234-5678901234ab"                   (UUID with dashes)
  *
- * Returns the 32-char hex ID (dashes stripped) or the raw string if no UUID
- * pattern is found.
+ * Returns the terminal resource name exactly as supplied by Power Platform.
+ * Some connectors require dashed GUIDs while others use compact IDs.
  */
 export declare function extractConnectionId(rawName: string): string;
+export declare function connectionIdsEqual(left: string, right: string): boolean;
 //# sourceMappingURL=disambiguate.d.ts.map

package/lib/typescript/module/{platform → connections}/resolveConnections.d.ts

@@ -5,19 +5,18 @@
  * useConnectionRefs:
  *
  *  • resolveViaStaticRefs — per-connector resolution using the static
- *    connectionReferences map from power.config.json.  Used by the Dev Player
- *    and during local development (no appId) or when the launch API is
- *    unavailable.  Handles pre-disambiguation ACL grants so inaccessible
- *    connections are excluded before the user is asked to pick.
+ *    connectionReferences map from power.config.json. Used only by Dev Player
+ *    for unpublished local apps. Handles pre-disambiguation ACL grants so
+ *    inaccessible connections are excluded before the user is asked to pick.
  *
- *  • applyAclGrants — post-resolution ACL grants used by the fast path
+ *  • applyAclGrants — post-resolution user consent used by the fast path
  *    (production APKs via fetchAppLaunchData).
  *
  * Both helpers return / consume the shared AppLaunchResult shape so the
  * hook orchestrator can handle them uniformly.
  */
 import type { AppLaunchResult } from './PowerPlatformConnectionApi.js';
-import type { OnDisambiguationNeeded, OnMissingConnection } from '../connections/types.js';
+import type { ConnectionReferenceConfig, ConnectionRequirement, OnDisambiguationNeeded, OnMissingConnection } from './types.js';
 import type { AppConnectionReference } from '../bridge/NativePowerAppsBridge.js';
 /**
  * Connector schema entry generated by `generate-connector-schemas`.
@@ -28,6 +27,10 @@ export interface ConnectorSchema {
     name: string;
     properties: {
         primaryRuntimeUrl: string;
+        scopes?: {
+            will?: string[];
+            wont?: string[];
+        };
     };
 }
 export interface StaticRefsOptions {
@@ -35,19 +38,16 @@ export interface StaticRefsOptions {
      * Static connectionReferences from power.config.json.
      * Shape: { [refId]: { id: string; dataSources: string[] } }
      */
-    connectionReferences: Record<string, {
-        id: string;
-        dataSources: string[];
-    }>;
+    connectionReferences: Record<string, ConnectionReferenceConfig>;
     /** Connector schema map keyed by data source name. */
     schemaMap: Record<string, ConnectorSchema>;
     environmentId: string;
     region: string;
-    /** Used for ACL grants and the Dataverse instanceUrl fetch. */
+    /** Used for connection consent and the Dataverse instanceUrl fetch. */
     acquireToken: (scopes: string[]) => Promise<string | null>;
     /** Pre-acquired Power Platform API bearer token. */
     token: string;
-    /** ISV client ID — when provided, runs pre-disambiguation ACL grants. */
+    /** ISV client ID — when provided, runs pre-disambiguation user consent. */
     isvClientId?: string;
     onDisambiguationNeeded?: OnDisambiguationNeeded;
     onMissingConnection?: OnMissingConnection;
@@ -59,7 +59,7 @@ export interface StaticRefsOptions {
  *  1. Build an apiId → schema lookup.
  *  2. In parallel: fetch the Dataverse instanceUrl and all connection instances
  *     for every connector.
- *  3. If `isvClientId` is set, run pre-disambiguation ACL grants — connections
+ *  3. If `isvClientId` is set, run pre-disambiguation user consent — connections
  *     where the grant fails are marked `NeedsAclGrant` and excluded from
  *     resolution, prompting the user to create a new connection.
  *  4. Disambiguate: resolve single matches, invoke callbacks for ambiguous /
@@ -69,18 +69,18 @@ export interface StaticRefsOptions {
  */
 export declare function resolveViaStaticRefs({ connectionReferences, schemaMap, environmentId, region, acquireToken, token, isvClientId, onDisambiguationNeeded, onMissingConnection, }: StaticRefsOptions): Promise<AppLaunchResult>;
 /**
- * Run idempotent post-resolution ACL grants on behalf of the ISV app.
+ * Run idempotent post-resolution delegated consent grants for the calling app.
  *
  * Used by the fast path (production APKs via `fetchAppLaunchData`) where the
- * launch API has already resolved the user's connections — grants are applied
- * after the fact so APIM accepts tokens issued to the ISV's AAD app.
+ * launch API has already resolved the user's connections. Grants are applied
+ * only to user-selected connections; fixed shared connections are already
+ * authorized by their owner and must not receive delegated user consent.
  *
  * For the slow path the grants run before disambiguation inside
  * `resolveViaStaticRefs`, where they can still influence which connections
  * are considered available.
  *
- * Failures are swallowed — a failed grant will surface as a 403 at runtime
- * when the connector is called.
+ * Returns the connection names whose ACL grants failed so callers can fail closed.
  */
-export declare function applyAclGrants(connectionRefs: Record<string, AppConnectionReference>, environmentId: string, isvClientId: string, acquireToken: (scopes: string[]) => Promise<string | null>): Promise<void>;
+export declare function applyAclGrants(connectionRefs: Record<string, AppConnectionReference>, connectionRequirements: ConnectionRequirement[], environmentId: string, region: string, acquireToken: (scopes: string[]) => Promise<string | null>): Promise<Set<string>>;
 //# sourceMappingURL=resolveConnections.d.ts.map

package/lib/typescript/module/connections/types.d.ts

@@ -17,18 +17,146 @@ export declare enum ConnectionStatus {
     NeedsAclGrant = "NeedsAclGrant",
     NotConnected = "NotConnected"
 }
+export interface ConnectionReferenceConfig {
+    id: string;
+    dataSources: string[];
+    displayName?: string;
+    iconUri?: string;
+    appActions?: string[];
+    sharedConnectionId?: string;
+    gatewayObjectIdHint?: string;
+    authenticationType?: string;
+    parameterSetName?: string;
+    workflowDetails?: {
+        workflowEntityId?: string;
+        workflowDisplayName?: string;
+        workflowName?: string;
+    };
+    dataSets?: Record<string, unknown>;
+    dependencies?: Record<string, unknown>;
+    dependents?: string[];
+    nestedActions?: Array<{
+        actionName?: string;
+        apiName?: string;
+        flowConnectionRef?: string;
+    }>;
+    parameterHintsV2?: Record<string, {
+        value?: unknown;
+    }>;
+    [key: string]: unknown;
+}
+export interface ConnectionRequirement {
+    localRefId: string;
+    apiId: string;
+    connectorId: string;
+    dataSources: string[];
+    displayName?: string;
+    iconUri?: string;
+    appActions?: string[];
+    sharedConnectionId?: string;
+    gatewayObjectIdHint?: string;
+    authenticationType?: string;
+    parameterSetName?: string;
+    apiScopes: {
+        will: string[];
+        wont: string[];
+    };
+    isFlowDependent: boolean;
+}
+export type ConnectionParameterType = 'string' | 'securestring' | 'boolean' | 'integer' | 'clientcertificate';
+export interface ConnectionParameterDefinition {
+    name: string;
+    displayName: string;
+    type: ConnectionParameterType;
+    required: boolean;
+    hidden: boolean;
+    capabilities?: string[];
+    allowedValues?: Array<{
+        value: string;
+        displayName: string;
+    }>;
+    defaultValue?: string | boolean | number;
+}
+export interface ConnectionParameterSet {
+    /** Undefined for a connector's single, non-parameter-set authentication definition. */
+    name?: string;
+    displayName: string;
+    parameters: ConnectionParameterDefinition[];
+    requiresApiConsent: boolean;
+    gatewayParameterName?: string;
+}
+export type ConnectionParameterValue = string | boolean | number | {
+    pfx: string;
+    password: string;
+} | {
+    gatewayObjectId: string;
+};
+export interface ConnectionInput {
+    parameterSetName?: string;
+    gatewayObjectId?: string;
+    gatewayParameterName?: string;
+    parameters: Record<string, ConnectionParameterValue>;
+}
+export interface ConnectionConsentDetails {
+    localRefId: string;
+    connectorId: string;
+    displayName: string;
+    description: string;
+    appActions: string[];
+}
+export interface ResourceConsentRequirement {
+    resourceId: string;
+    displayName: string;
+}
+export interface ConnectionUsageInput {
+    localRefId: string;
+    apiId: string;
+    connectionId: string;
+    dataSources: string[];
+    appActions: string[];
+    apiScopes: {
+        will: string[];
+        wont: string[];
+    };
+}
+export declare function normalizeApiId(apiId: string): string;
+export declare function getConnectorId(apiId: string): string;
+export declare function getConnectionDatasetName(reference: {
+    dataSets?: Record<string, unknown>;
+}): string;
+export declare function getFlowConnectionName(reference: ConnectionReferenceConfig): string;
+export declare function getFlowDataSourceNames(reference: ConnectionReferenceConfig): string[];
+export declare function buildConnectionRequirements(connectionReferences: Record<string, ConnectionReferenceConfig>, scopesByApiId?: Record<string, {
+    will: string[];
+    wont: string[];
+}>): ConnectionRequirement[];
+export declare function isCompositeConnectionApiId(apiId: string): boolean;
+export declare function findConnectionDataSourceConflicts(requirements: ConnectionRequirement[]): string[];
+export declare function hasCompleteStaticConnectionConfig(connectionReferences: Record<string, ConnectionReferenceConfig>, schemaMap: Record<string, {
+    name: string;
+    properties: {
+        primaryRuntimeUrl: string;
+    };
+}>): boolean;
+export declare function buildConnectionResolutionKey(appId: string | undefined, environmentId: string, connectionReferences: Record<string, ConnectionReferenceConfig>): string;
 /** A single connection instance returned by the Power Platform connectivity API. */
 export interface NativeConnectionInstance {
-    /** Extracted connection UUID (hex, no dashes). */
+    /** Terminal connection resource name exactly as returned by Power Platform. */
     id: string;
     /** Full resource name from the API (connector-prefixed, e.g. "shared_office365users/abc123"). */
     name: string;
     /** Connector API identifier (e.g. "/providers/Microsoft.PowerApps/apis/shared_office365users"). */
     apiId: string;
+    /** Object ID of the connection owner when returned by the connectivity API. */
+    ownerId?: string;
     /** Resolved authorization status of this connection. */
     status: ConnectionStatus;
     /** Optional human-readable display name from the API. */
     displayName?: string;
+    accountName?: string;
+    parameterSetName?: string;
+    isAuthenticated?: boolean;
+    statusErrorCode?: string;
 }
 /**
  * Result of attempting to match a single connection reference to an instance.

package/lib/typescript/module/{platform → connections}/useConnectionRefs.d.ts

@@ -30,9 +30,12 @@
  *     },
  *   });
  */
-import { type OnDisambiguationNeeded, type OnMissingConnection } from '../connections/types.js';
+import type { DatabaseReference } from '../platform/DataverseDataSources.js';
+import type { OnDisambiguationNeeded, OnMissingConnection } from '../connections/types.js';
 import type { ConnectorSchema } from './resolveConnections.js';
 import type { AppConnectionReference } from '../bridge/NativePowerAppsBridge.js';
+import type { ConnectionRequirement, ResourceConsentRequirement } from './types.js';
+import type { ConnectionReferenceConfig } from './types.js';
 export type { ConnectorSchema } from './resolveConnections.js';
 export interface UseConnectionRefsOptions {
     isSignedIn: boolean;
@@ -46,23 +49,19 @@ export interface UseConnectionRefsOptions {
     region?: string;
     /**
      * PowerApps app GUID (from power.config.json `appId`).
-     * When provided (and not running inside the Dev Player), connection
-     * references are fetched at runtime from the PowerApps RP
-     * `/apps/{appId}/launch` endpoint and take precedence over the static
-     * `connectionReferences` object below.
-     * Leave undefined during local development to use the static fallback.
+      * Outside Dev Player, app and connection metadata is fetched exclusively
+      * from the PowerApps RP `/apps/{appId}/launch` endpoint.
      */
     appId?: string;
     /**
      * The connectionReferences map from power.config.json.
+      * Used only in Dev Player for unpublished local apps.
      * Shape: { [refId]: { id: string; dataSources: string[] } }
      */
-    connectionReferences: Record<string, {
-        id: string;
-        dataSources: string[];
-    }>;
+    connectionReferences: Record<string, ConnectionReferenceConfig>;
     /**
      * Connector schema map keyed by data source name.
+      * Used only in Dev Player for unpublished local apps.
      * Generated automatically by generate-connector-schemas.
      * Shape: { [dataSourceName]: ConnectorSchema }
      */
@@ -80,10 +79,11 @@ export interface UseConnectionRefsOptions {
      */
     onMissingConnection?: OnMissingConnection;
     /**
-     * The ISV's AAD application (client) ID.  When provided, each resolved
-     * `Connected` connection is checked via `addAadAppToConnectionAcl`.
+    * The ISV's AAD application (client) ID. When provided, each user-selected
+    * `Connected` connection is granted through delegated user consent. Fixed
+    * shared connections skip this grant in published apps.
      * Connections where the grant fails are marked `NeedsAclGrant` and treated
-     * as missing so the setup screen can guide the user to create a new one.
+    * as missing so the setup screen can guide the user to create a new one.
      */
     isvClientId?: string;
 }
@@ -91,12 +91,25 @@ export interface UseConnectionRefsResult {
     connectionRefs: Record<string, AppConnectionReference>;
     isReady: boolean;
     error: string | null;
+    errorKind: ConnectionResolutionErrorKind | null;
     /**
      * API IDs of connectors for which no connection was found (or the user did
      * not resolve during disambiguation).  Useful for surfacing a "Set up
      * connections" prompt in the app UI.
      */
     missingConnectors: string[];
+    /** Unresolved requirements keyed by the app's local connection-reference ID. */
+    missingConnectionReferences: ConnectionRequirement[];
+    /** Every connection reference required by the app. */
+    connectionRequirements: ConnectionRequirement[];
+    /** Non-connector protected resources returned by app launch metadata. */
+    resourceConsents: ResourceConsentRequirement[];
+    /** Blocking connection configuration errors. */
+    configurationErrors: string[];
+    /** Whether selected connection references still need durable app usage consent. */
+    requiresConnectionConsent: boolean;
+    /** Identity of the app/environment/config represented by this result. */
+    resolvedConfigKey: string | null;
     /**
      * The Dataverse org URL for this environment (e.g. "https://org12345.crm.dynamics.com").
      * Fetched from the Power Platform environment metadata independently of whether a
@@ -104,23 +117,19 @@ export interface UseConnectionRefsResult {
      * Empty string until isReady is true or if the environment has no linked Dataverse database.
      */
     dataverseOrgUrl: string;
+    /** Database references resolved from the RP launch response. */
+    databaseReferences: Record<string, DatabaseReference>;
 }
+export type ConnectionResolutionErrorKind = 'app-access-denied' | 'generic';
 /**
  * Resolves Power Platform connection references for the current user, with
  * disambiguation support for environments where multiple connections exist for
  * the same connector.
  *
- * On sign-in this hook:
- *  1. If `appId` is set (production template), fetches connection references
- *     from the PowerApps RP `/apps/{appId}/launch` endpoint and uses those
- *     in place of the static `connectionReferences` from power.config.json.
- *  2. Acquires a Power Platform API token.
- *  3. In parallel: fetches the Dataverse instanceUrl and ALL connections for
- *     each configured connector.
- *  4. Runs disambiguation: resolves single matches, invokes `onDisambiguationNeeded`
- *     for multiple matches, and invokes `onMissingConnection` for absent ones.
- *  5. Pre-warms the Dataverse token in the MSAL cache.
- *  6. Sets isReady=true with the fully-populated connections map.
+ * Outside Dev Player, the published app launch endpoint is authoritative.
+ * Dev Player resolves unpublished local references through per-connector APIs.
+ * 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;
 //# sourceMappingURL=useConnectionRefs.d.ts.map

package/lib/typescript/module/connections/useConnectionSetup.d.ts

@@ -17,7 +17,7 @@
  *   // Call setup.startCreate() to trigger connection creation
  *   // Call setup.checkNow() to re-poll after WebView finishes
  */
-import type { NativeConnectionInstance } from '../connections/types.js';
+import type { ConnectionInput, NativeConnectionInstance } from './types.js';
 /**
  * The current phase of the connection setup flow for one connector.
  *
@@ -43,12 +43,12 @@ export interface UseConnectionSetupOptions {
     onConnected?: (instance: NativeConnectionInstance) => void;
     /**
      * The ISV/wrap-app AAD client ID (from auth.config.json `msal.clientId`).
-     * After connection creation, `addAadAppToConnectionAcl` is called to append
-     * the ISV's client ID to the connection ACE's AppIds list. This is required
-     * so that APIM accepts tokens bearing this appid at runtime (otherwise APIM
-     * returns 403 "missing connection ACL" for all third-party app tokens).
+      * After connection creation, delegated user consent adds the calling app ID
+      * to the most specific applicable connection ACL.
      */
-    isvClientId?: string;
+    isvClientId: string;
+    /** Fixed shared connection resource ID. */
+    sharedConnectionId?: string;
     /**
      * Redirect URL passed to the getConsentLink API call.
      * Defaults to the standard native-client redirect accepted by Power Platform.
@@ -71,7 +71,11 @@ export interface UseConnectionSetupResult {
      * Start the connection creation flow.
      * Transitions: idle/error → creating → (oauth | connected | error).
      */
-    startCreate: () => Promise<void>;
+    startCreate: (input?: ConnectionInput) => Promise<void>;
+    /** Update and re-consent an existing unauthenticated connection. */
+    startRepair: (instance: NativeConnectionInstance, input?: ConnectionInput, requiresApiConsent?: boolean) => Promise<void>;
+    /** Verify third-party ACL access before accepting an existing connection. */
+    useExisting: (instance: NativeConnectionInstance) => Promise<void>;
     /**
      * Call after the OAuth WebView is dismissed (or anytime during 'oauth' phase)
      * to immediately poll the connection status instead of waiting for the next
@@ -92,5 +96,5 @@ export interface UseConnectionSetupResult {
     /** Reset the flow back to idle (e.g., for a retry). */
     reset: () => void;
 }
-export declare function useConnectionSetup({ connectorId, environmentId, region, acquireToken, onConnected, isvClientId, oauthRedirectUrl, polling, }: UseConnectionSetupOptions): UseConnectionSetupResult;
+export declare function useConnectionSetup({ connectorId, environmentId, region, acquireToken, onConnected, sharedConnectionId, oauthRedirectUrl, polling, }: UseConnectionSetupOptions): UseConnectionSetupResult;
 //# sourceMappingURL=useConnectionSetup.d.ts.map

package/lib/typescript/module/controls/FilePicker.d.ts

@@ -11,6 +11,12 @@ export interface PickedFileInfo {
 }
 export interface FilePickerProps {
     label?: string;
+    /** Optional test ID for the outer container. */
+    testID?: string;
+    /** Optional test ID for the selected file row. */
+    fileRowTestID?: string;
+    /** Optional test ID for the pick/replace button. */
+    pickButtonTestID?: string;
     /**
      * The file name to display.
      * - In view mode: the name of the existing Dataverse file.
@@ -61,5 +67,5 @@ export interface FilePickerProps {
  * - Pass both to show the existing file name (tappable to download) alongside a
  *   replace button — useful when the edit screen should also allow previewing.
  */
-export declare function FilePicker({ label, fileName, onDownload, shareTitle, onChange, acceptedTypes, pickButtonLabel, replaceButtonLabel, readingLabel, containerStyle, labelStyle, fileRowStyle, fileNameStyle, buttonStyle, buttonTextStyle, accentColor, }: FilePickerProps): React.JSX.Element;
+export declare function FilePicker({ label, testID, fileRowTestID, pickButtonTestID, fileName, onDownload, shareTitle, onChange, acceptedTypes, pickButtonLabel, replaceButtonLabel, readingLabel, containerStyle, labelStyle, fileRowStyle, fileNameStyle, buttonStyle, buttonTextStyle, accentColor, }: FilePickerProps): React.JSX.Element;
 //# sourceMappingURL=FilePicker.d.ts.map

package/lib/typescript/module/controls/ImagePicker.d.ts

@@ -13,6 +13,14 @@ export interface PickedImageInfo {
 }
 export interface ImagePickerProps {
     label?: string;
+    /** Optional test ID for the outer container. */
+    testID?: string;
+    /** Optional test ID for the camera button. */
+    cameraButtonTestID?: string;
+    /** Optional test ID for the image-library button. */
+    selectButtonTestID?: string;
+    /** Optional test ID for the selected image preview. */
+    previewTestID?: string;
     /**
      * Base64 string from Dataverse (the `cr_assetimage` thumbnail).
      * The component builds the preview data URI internally.
@@ -72,5 +80,5 @@ export interface ImagePickerProps {
  * - On pick, the image is returned as base64 for legacy callers and as a
  *   File-compatible object for generated Dataverse upload methods.
  */
-export declare function ImagePicker({ label, initialBase64, onChange, containerStyle, labelStyle, buttonRowStyle, buttonStyle, buttonTextStyle, previewStyle, accentColor, onImageChange, imageFileName, quality, allowsEditing, aspect, cropShape, exif, legacy, cameraButtonLabel, selectButtonLabel, changeButtonLabel, readingLabel, }: ImagePickerProps): React.JSX.Element;
+export declare function ImagePicker({ label, testID, cameraButtonTestID, selectButtonTestID, previewTestID, initialBase64, onChange, containerStyle, labelStyle, buttonRowStyle, buttonStyle, buttonTextStyle, previewStyle, accentColor, onImageChange, imageFileName, quality, allowsEditing, aspect, cropShape, exif, legacy, cameraButtonLabel, selectButtonLabel, changeButtonLabel, readingLabel, }: ImagePickerProps): React.JSX.Element;
 //# sourceMappingURL=ImagePicker.d.ts.map

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

@@ -9,6 +9,7 @@ export type { PowerPagesBridgeOptions } from './bridge/PowerPagesBridge.js';
 export type { NativeBridgeOptions, CdsDataSourceConfig, AppConnection, AppConnectionReference } from './bridge/NativePowerAppsBridge.js';
 export { buildConnectionReferences } from './bridge/NativePowerAppsBridge.js';
 export { setupNativeHost } from './bridge/setupNativeHost.js';
+export { updateBridgeOptionsInPlace } from './bridge/bridgeState.js';
 export { AuthProvider, useAuth } from './auth/AuthContext';
 export type { AuthState, AuthProviderProps } from './auth/AuthContext';
 export { completePowerAppsAuthSession } from './auth/completePowerAppsAuthSession.js';
@@ -16,15 +17,21 @@ export type { AuthConfig, MsalAuthConfig, IntuneConfig } from '@microsoft/power-
 export { PowerAppsHostProvider } from './provider/PowerAppsHostProvider';
 export type { PowerAppsHostProviderProps } from './provider/PowerAppsHostProvider';
 export { PowerAppsProvider } from './provider/PowerAppsProvider.js';
-export type { PowerAppsProviderProps, PowerConfig } from './provider/PowerAppsProvider.js';
-export { fetchInstanceUrl, buildCdsDataSources, buildEnvironmentEndpoint, POWER_PLATFORM_API_SCOPE } from './platform/PowerPlatformEnvironmentApi.js';
-export type { LinkedEnvironmentMetadata, DatabaseReference, DatabaseReferenceDataSource } from './platform/PowerPlatformEnvironmentApi.js';
-export { useConnectionRefs } from './platform/useConnectionRefs.js';
-export type { UseConnectionRefsOptions, UseConnectionRefsResult, ConnectorSchema } from './platform/useConnectionRefs.js';
-export { fetchConnectorMetadata, fetchConnectionsForConnector, createConnection, pollConnectionStatus, confirmConsentCode, fetchAppLaunchData, } from './platform/PowerPlatformConnectionApi.js';
-export type { ConnectorMetadata, CreateConnectionResult, AppLaunchResult, } from './platform/PowerPlatformConnectionApi.js';
+export type { AppInsightsConfig, PowerAppsProviderProps, PowerConfig } from './provider/PowerAppsProvider.js';
+export { buildEnvironmentEndpoint, POWER_PLATFORM_API_SCOPE } from './platform/PowerPlatformEnvironmentApi.js';
+export { fetchInstanceUrl } from './platform/DataverseGlobalDiscoveryApi.js';
+export { buildCdsDataSources } from './platform/DataverseDataSources.js';
+export type { LinkedEnvironmentMetadata, DatabaseReference, DatabaseReferenceDataSource } from './platform/DataverseDataSources.js';
+export { useConnectionRefs } from './connections/useConnectionRefs.js';
+export type { UseConnectionRefsOptions, UseConnectionRefsResult, ConnectorSchema } from './connections/useConnectionRefs.js';
+export { fetchConnectorMetadata, fetchConnectionsForConnector, deleteConnection, createConnection, pollConnectionStatus, confirmConsentCode, repairConnection, fetchAppLaunchData, fetchAppConnectionUsages, postConnectionUsage, reportScopeConsents, } from './connections/PowerPlatformConnectionApi.js';
+export type { ConnectorMetadata, CreateConnectionResult, AppLaunchResult, RegisteredConnectionUsage, } from './connections/PowerPlatformConnectionApi.js';
 export { disambiguateConnections, extractConnectionId } from './connections/disambiguate.js';
-export type { NativeConnectionInstance, NativeConnectionResolution, NativeDisambiguationResult, OnDisambiguationNeeded, OnMissingConnection, } from './connections/types.js';
+export { shouldPersistConnectionUsages, shouldShowConnectionReview, } from './connections/connectionState.js';
+export { buildConnectionRequirements, buildConnectionResolutionKey, findConnectionDataSourceConflicts, hasCompleteStaticConnectionConfig, isCompositeConnectionApiId, getConnectorId, normalizeApiId, } from './connections/types.js';
+export { buildConnectionUserConsentUrl, buildConsentLinkDefinition, buildConnectionParameterSets, buildConnectionUsageRequest, buildConnectionUsageUrl, buildScopeConsentRequest, buildScopeConsentUrl, hasOAuthParameter, parseConnectionParameters, serializeConnectionParameters, } from './connections/connectionMetadata.js';
+export type { ConsentLinkDefinition, RawConnectionParameter, RawConnectionParameterSet, SerializedConnectionParameters, } from './connections/connectionMetadata.js';
+export type { ConnectionConsentDetails, ConnectionInput, ConnectionParameterDefinition, ConnectionParameterSet, ConnectionParameterType, ConnectionParameterValue, ConnectionReferenceConfig, ConnectionRequirement, ConnectionUsageInput, ResourceConsentRequirement, NativeConnectionInstance, NativeConnectionResolution, NativeDisambiguationResult, OnDisambiguationNeeded, OnMissingConnection, } from './connections/types.js';
 export { useConnectionSetup } from './connections/useConnectionSetup.js';
 export type { ConnectionSetupPhase, UseConnectionSetupOptions, UseConnectionSetupResult, } from './connections/useConnectionSetup.js';
 export { ConnectionSetupScreen } from './connections/ConnectionSetupScreen.js';
@@ -39,7 +46,7 @@ export { ImagePicker } from './controls/ImagePicker.js';
 export type { ImagePickerProps, PickedImageInfo } from './controls/ImagePicker.js';
 export { isDevPlayer } from './utils/isDevPlayer.js';
 export { base64ToDataverseUploadFile, base64ToUint8Array, createDataverseUploadFile, } from './utils/dataverseUtils.js';
-export { getAppLogger, configureAppLogger, HostOperationNames } from './telemetry/index.js';
-export type { ILogger } from '@microsoft/power-apps-native-common';
+export { getAppLogger, configureAppLogger, getCustomerTelemetryLogger, HostOperationNames, } from './telemetry/index.js';
+export type { ICustomerTelemetryLogger, ILogger, } from '@microsoft/power-apps-native-common';
 export { ErrorBoundary } from './ErrorBoundary.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1,11 +1,11 @@
 /**
  * Conditional debug logger for power-apps-native-host.
  *
- * Debug logs (debugLog / debugWarn) are only emitted when the JS bundle
- * is running inside the Power Apps Dev Player (detected via
- * `Constants.expoConfig.extra.isDevPlayer`).  They are silenced in release
- * APKs generated from the template so the production log stream stays clean.
+ * Debug logs (debugLog / debugWarn) are emitted in development bundles or when
+ * running inside Power Apps Dev Player. They remain silent in wrapped release
+ * apps so the production log stream stays clean.
  */
+export declare function isDebugLoggingEnabled(): boolean;
 export declare function debugLog(...args: unknown[]): void;
 export declare function debugWarn(...args: unknown[]): void;
 //# sourceMappingURL=logger.d.ts.map

package/lib/typescript/module/offline/createOfflineHostActivationCallbacks.d.ts

@@ -0,0 +1,12 @@
+import { QueryClient } from '@tanstack/react-query';
+export declare function createHostQueryClient(): QueryClient;
+export declare function createOfflineHostActivationCallbacks(queryClient: QueryClient): {
+    prepareForOfflineActivation: () => Promise<void>;
+    completeOfflineActivation: () => Promise<void>;
+    rollbackOfflineActivation: () => Promise<void>;
+};
+export declare function resolveSdkMountDecision(value: unknown): {
+    shouldMountChildren: boolean;
+    contractSupported: boolean;
+};
+//# sourceMappingURL=createOfflineHostActivationCallbacks.d.ts.map

package/lib/typescript/module/offline/useOfflineIntegrationWithStartupGate.d.ts

@@ -0,0 +1,15 @@
+import { useOfflineIntegration } from './useOfflineIntegration';
+type Options = {
+    powerConfig: Parameters<typeof useOfflineIntegration>[0]['powerConfig'];
+    offlineProfile?: Record<string, unknown>;
+    acquireToken: (scopes: string[]) => Promise<string | null>;
+    hasRealAccount: boolean;
+    isAuthReady: boolean;
+};
+export declare function useOfflineIntegrationWithStartupGate({ powerConfig, offlineProfile, acquireToken, hasRealAccount, isAuthReady, }: Options): {
+    isEnabled: boolean;
+    StatusOverlay: import("react").ComponentType<Record<string, never>> | null;
+    shouldMountChildren: boolean;
+};
+export {};
+//# sourceMappingURL=useOfflineIntegrationWithStartupGate.d.ts.map

package/lib/typescript/module/offline/useOfflineIntegrationWithStartupGate.web.d.ts

@@ -0,0 +1,6 @@
+export declare function useOfflineIntegrationWithStartupGate(_options: unknown): {
+    isEnabled: false;
+    StatusOverlay: null;
+    shouldMountChildren: true;
+};
+//# sourceMappingURL=useOfflineIntegrationWithStartupGate.web.d.ts.map

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

@@ -0,0 +1,27 @@
+export interface LinkedEnvironmentMetadata {
+    resourceId?: string;
+    friendlyName?: string;
+    uniqueName?: string;
+    domainName?: string;
+    version?: string;
+    instanceUrl?: string;
+    instanceApiUrl?: string;
+    baseLanguage?: number;
+    instanceState?: string;
+    createdTime?: string;
+    platformSku?: string;
+}
+export interface DatabaseReferenceDataSource {
+    entitySetName?: string;
+    logicalName?: string;
+}
+export interface DatabaseReference {
+    dataSources?: Record<string, DatabaseReferenceDataSource>;
+}
+export declare function buildCdsDataSources(databaseReferences: Record<string, DatabaseReference>, dataverseOrgUrl: string): Array<{
+    runtimeUrl: string;
+    entitySetName: string;
+    logicalName: string;
+    version: string;
+}>;
+//# sourceMappingURL=DataverseDataSources.d.ts.map

package/lib/typescript/module/platform/DataverseGlobalDiscoveryApi.d.ts

@@ -0,0 +1,3 @@
+/** Fetch the Dataverse instance URL from the Dataverse Global Discovery Service. */
+export declare function fetchInstanceUrl(environmentId: string, region: string, acquireToken: (scopes: string[]) => Promise<string | null>, _bearerToken?: string): Promise<string | undefined>;
+//# sourceMappingURL=DataverseGlobalDiscoveryApi.d.ts.map

package/lib/typescript/module/platform/GlobalDiscovery.d.ts

@@ -0,0 +1,4 @@
+export declare function globalDiscoveryEndpoint(region: string): string;
+export declare function globalDiscoveryScope(region: string): string;
+export declare function buildGlobalDiscoveryUrl(environmentId: string, region: string): string;
+//# sourceMappingURL=GlobalDiscovery.d.ts.map