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

package/lib/commonjs/target/PowerAppsTargetBootstrap.js

@@ -0,0 +1,534 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PowerAppsTargetBootstrap = PowerAppsTargetBootstrap;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var SecureStore = _interopRequireWildcard(require("expo-secure-store"));
+var _AuthContext = require("../auth/AuthContext");
+var _DataverseGlobalDiscoveryApi = require("../platform/DataverseGlobalDiscoveryApi.js");
+var _CanvasAppResolution = require("../platform/CanvasAppResolution.js");
+var _CanvasAppResolutionApi = require("../platform/CanvasAppResolutionApi.js");
+var _GlobalDiscovery = require("../platform/GlobalDiscovery.js");
+var _PowerPlatformEnvironmentApi = require("../platform/PowerPlatformEnvironmentApi.js");
+var _errors = require("./errors.js");
+var _tenantMode = require("../config/tenantMode.js");
+var _PowerAppsExperience = require("./PowerAppsExperience.js");
+var _DefaultPowerAppsExperience = require("./DefaultPowerAppsExperience.js");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireWildcard(e, t) { if ("function" == typeof WeakMap) var r = new WeakMap(), n = new WeakMap(); return (_interopRequireWildcard = function (e, t) { if (!t && e && e.__esModule) return e; var o, i, f = { __proto__: null, default: e }; if (null === e || "object" != typeof e && "function" != typeof e) return f; if (o = t ? n : r) { if (o.has(e)) return o.get(e); o.set(e, f); } for (const t in e) "default" !== t && {}.hasOwnProperty.call(e, t) && ((i = (o = Object.defineProperty) && Object.getOwnPropertyDescriptor(e, t)) && (i.get || i.set) ? o(f, t, i) : f[t] = e[t]); return f; })(e, t); }
+const TARGET_STORAGE_KEY = 'microsoft.power-apps-native-host.selected-target.v1';
+const EMPTY_ENVIRONMENT_STABILITY_MS = 500;
+function LoadingScreen({
+  message
+}) {
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: {
+      flex: 1,
+      alignItems: 'center',
+      justifyContent: 'center',
+      gap: 12,
+      padding: 24
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ActivityIndicator, {
+      size: "large"
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: {
+        color: '#605E5C'
+      },
+      children: message
+    })]
+  });
+}
+function toEnvironmentSummary(target) {
+  return {
+    id: target.id,
+    label: target.label
+  };
+}
+function toExperienceError(error) {
+  return {
+    code: error.code,
+    message: error.userMessage,
+    retryable: error.retryable
+  };
+}
+function TargetRuntime({
+  target,
+  generation,
+  msalConfig,
+  isCurrent,
+  children,
+  onBack,
+  experienceComponent
+}) {
+  const auth = (0, _AuthContext.useAuth)();
+  const [state, setState] = (0, _react.useState)('authenticating');
+  const [resolvedTarget, setResolvedTarget] = (0, _react.useState)();
+  const [error, setError] = (0, _react.useState)();
+  const [retry, setRetry] = (0, _react.useState)(0);
+  (0, _react.useEffect)(() => {
+    if (!auth.isAuthReady || !auth.account) return;
+    let active = true;
+    setState('resolving');
+    setError(undefined);
+    void (async () => {
+      try {
+        const dataverseApiUrl = target.dataverseApiUrl;
+        const resolved = await (0, _CanvasAppResolutionApi.resolveCanvasApp)(target, dataverseApiUrl, auth.acquireToken, {
+          value: generation,
+          isCurrent
+        });
+        if (!active || !isCurrent(generation)) return;
+        setResolvedTarget(resolved);
+        setState('ready');
+      } catch (cause) {
+        if (!active || !isCurrent(generation)) return;
+        setError(cause instanceof _errors.TargetRuntimeError ? cause : new _errors.TargetRuntimeError('service-unavailable', 'discovery', true, 'The selected environment could not be loaded. Try again.', target.id, cause));
+        setState('error');
+      }
+    })();
+    return () => {
+      active = false;
+    };
+  }, [auth.account, auth.acquireToken, auth.isAuthReady, generation, isCurrent, retry, target]);
+  if (auth.isLoading || !auth.isAuthReady) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'connecting',
+        environment: toEnvironmentSummary(target)
+      },
+      appDisplayName: target.appDisplayName,
+      component: experienceComponent,
+      fallback: /*#__PURE__*/(0, _jsxRuntime.jsx)(LoadingScreen, {
+        message: "Connecting to the selected environment..."
+      })
+    });
+  }
+  if (!auth.account) {
+    const fallback = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: {
+        flex: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: 16,
+        padding: 24
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: auth.error?.message ?? 'Sign in to access the selected environment.'
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: () => {
+          void auth.signIn();
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: {
+            color: '#0F6CBD',
+            fontWeight: '600'
+          },
+          children: "Sign in"
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: onBack,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          children: "Choose another environment"
+        })
+      })]
+    });
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'signIn',
+        error: auth.error?.message,
+        signIn: auth.signIn,
+        goBack: onBack
+      },
+      appDisplayName: target.appDisplayName,
+      component: experienceComponent,
+      fallback: fallback
+    });
+  }
+  if (state === 'error' && error) {
+    const retryResolution = () => setRetry(value => value + 1);
+    const fallback = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: {
+        flex: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: 16,
+        padding: 24
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: {
+          fontWeight: '700'
+        },
+        children: "Unable to open environment"
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: error.userMessage
+      }), error.retryable ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: retryResolution,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: {
+            color: '#0F6CBD',
+            fontWeight: '600'
+          },
+          children: "Try again"
+        })
+      }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: onBack,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: {
+            color: '#0F6CBD'
+          },
+          children: "Choose another environment"
+        })
+      })]
+    });
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'error',
+        error: toExperienceError(error),
+        retry: error.retryable ? retryResolution : undefined,
+        goBack: onBack
+      },
+      appDisplayName: target.appDisplayName,
+      component: experienceComponent,
+      fallback: fallback
+    });
+  }
+  if (!resolvedTarget) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'resolvingApp',
+        environment: toEnvironmentSummary(target)
+      },
+      appDisplayName: target.appDisplayName,
+      component: experienceComponent,
+      fallback: /*#__PURE__*/(0, _jsxRuntime.jsx)(LoadingScreen, {
+        message: "Loading app details..."
+      })
+    });
+  }
+  const broker = {
+    tenantId: target.tenantId,
+    generation,
+    acquireGlobalDiscoveryToken: async () => requireToken(await auth.acquireToken([(0, _GlobalDiscovery.globalDiscoveryScope)(target.region)])),
+    acquireDataverseToken: async apiUrl => {
+      if (!(0, _CanvasAppResolution.areDataverseOriginAliases)(apiUrl, resolvedTarget.dataverseApiUrl)) {
+        throw new Error('Dataverse token audience does not match the selected environment');
+      }
+      return requireToken(await auth.acquireToken([`${(0, _CanvasAppResolution.canonicalizeDataverseOrigin)(apiUrl)}/.default`]));
+    },
+    acquirePowerPlatformToken: async region => {
+      if (region.toLowerCase() !== target.region.toLowerCase()) throw new Error('Power Platform region does not match the selected environment');
+      return requireToken(await auth.acquireToken([(0, _PowerPlatformEnvironmentApi.powerPlatformScope)(target.region)]));
+    },
+    acquireConnectionUserConsentToken: async region => {
+      if (region.toLowerCase() !== target.region.toLowerCase()) throw new Error('Power Platform region does not match the selected environment');
+      return requireToken(await auth.acquireToken([(0, _PowerPlatformEnvironmentApi.connectionUserConsentScope)(target.region)]));
+    },
+    acquireApiHubToken: async () => requireToken(await auth.acquireToken(['https://apihub.azure.com/.default']))
+  };
+  const runtime = children(resolvedTarget, {
+    clientId: msalConfig.clientId,
+    accountIdentifier: auth.account.identifier,
+    accountTenantId: auth.account.tenantId,
+    generation,
+    tokenBroker: broker,
+    signOut: auth.signOut
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+    experience: {
+      status: 'ready',
+      environment: toEnvironmentSummary(resolvedTarget)
+    },
+    appDisplayName: target.appDisplayName,
+    component: experienceComponent,
+    fallback: runtime,
+    children: runtime
+  });
+}
+function requireToken(token) {
+  if (!token) throw new Error('Authentication token is unavailable');
+  return token;
+}
+function EnvironmentSelector({
+  appDisplayName,
+  appName,
+  tenantPolicy,
+  onSelect,
+  experienceComponent
+}) {
+  const auth = (0, _AuthContext.useAuth)();
+  const [environments, setEnvironments] = (0, _react.useState)();
+  const [emptyResultReady, setEmptyResultReady] = (0, _react.useState)(false);
+  const [error, setError] = (0, _react.useState)();
+  const [retry, setRetry] = (0, _react.useState)(0);
+  (0, _react.useEffect)(() => {
+    if (!auth.account) return;
+    const accountIdentifier = auth.account.identifier;
+    let active = true;
+    let emptyResultTimer;
+    setEnvironments(undefined);
+    setEmptyResultReady(false);
+    setError(undefined);
+    if (!(0, _tenantMode.isTenantAllowed)(auth.account.tenantId, tenantPolicy)) {
+      setError(new _errors.TargetRuntimeError('tenant-mismatch', 'authentication', false, 'Your organization is not approved to use this app.'));
+      return () => {
+        active = false;
+      };
+    }
+    void (0, _DataverseGlobalDiscoveryApi.fetchAccessibleEnvironments)(auth.account.tenantId, appDisplayName, appName, auth.acquireToken).then(async discovered => {
+      if (!active) return;
+      const storedId = await SecureStore.getItemAsync(TARGET_STORAGE_KEY).catch(() => null);
+      if (!active) return;
+      const restored = discovered.find(environment => environment.id === storedId);
+      if (restored) onSelect(restored, accountIdentifier);else {
+        if (storedId) void SecureStore.deleteItemAsync(TARGET_STORAGE_KEY);
+        setEnvironments(discovered);
+        if (discovered.length === 0) {
+          emptyResultTimer = setTimeout(() => {
+            if (active) setEmptyResultReady(true);
+          }, EMPTY_ENVIRONMENT_STABILITY_MS);
+        }
+      }
+    }).catch(cause => {
+      if (!active) return;
+      setError(cause instanceof _errors.TargetRuntimeError ? cause : new _errors.TargetRuntimeError('discovery-failed', 'discovery', true, 'Your environments could not be loaded. Try again.', undefined, cause));
+    });
+    return () => {
+      active = false;
+      if (emptyResultTimer) clearTimeout(emptyResultTimer);
+    };
+  }, [appDisplayName, appName, auth.account, auth.acquireToken, onSelect, retry, tenantPolicy]);
+  if (auth.isLoading || !auth.isAuthReady) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'preparing'
+      },
+      appDisplayName: appDisplayName,
+      component: experienceComponent,
+      fallback: /*#__PURE__*/(0, _jsxRuntime.jsx)(LoadingScreen, {
+        message: "Preparing your environments..."
+      })
+    });
+  }
+  if (!auth.account) {
+    const fallback = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: {
+        flex: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: 16,
+        padding: 24
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: auth.error?.message ?? 'Sign in with your work or school account.'
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: () => {
+          void auth.signIn();
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: {
+            color: '#0F6CBD',
+            fontWeight: '600'
+          },
+          children: "Sign in"
+        })
+      })]
+    });
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'signIn',
+        error: auth.error?.message,
+        signIn: auth.signIn
+      },
+      appDisplayName: appDisplayName,
+      component: experienceComponent,
+      fallback: fallback
+    });
+  }
+  if (error) {
+    const retryDiscovery = () => setRetry(value => value + 1);
+    const fallback = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+      style: {
+        flex: 1,
+        alignItems: 'center',
+        justifyContent: 'center',
+        gap: 16,
+        padding: 24
+      },
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: {
+          fontWeight: '700'
+        },
+        children: "Unable to load environments"
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: error.userMessage
+      }), error.retryable ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: retryDiscovery,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          style: {
+            color: '#0F6CBD'
+          },
+          children: "Try again"
+        })
+      }) : null, /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+        accessibilityRole: "button",
+        onPress: () => {
+          void auth.signOut();
+        },
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+          children: "Sign in with another account"
+        })
+      })]
+    });
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'error',
+        error: toExperienceError(error),
+        retry: error.retryable ? retryDiscovery : undefined,
+        signOut: auth.signOut
+      },
+      appDisplayName: appDisplayName,
+      component: experienceComponent,
+      fallback: fallback
+    });
+  }
+  if (!environments || environments.length === 0 && !emptyResultReady) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'discovering'
+      },
+      appDisplayName: appDisplayName,
+      component: experienceComponent,
+      fallback: /*#__PURE__*/(0, _jsxRuntime.jsx)(LoadingScreen, {
+        message: "Finding your environments..."
+      })
+    });
+  }
+  const fallback = /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: {
+      flex: 1,
+      justifyContent: 'center',
+      gap: 12,
+      padding: 24
+    },
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: {
+        fontSize: 20,
+        fontWeight: '700'
+      },
+      children: "Choose an environment"
+    }), environments.length === 0 ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      children: "No accessible Dataverse environments were found."
+    }) : environments.map(target => /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+      accessibilityRole: "button",
+      onPress: () => onSelect(target, auth.account.identifier),
+      style: {
+        paddingVertical: 12
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: {
+          color: '#0F6CBD',
+          fontWeight: '600'
+        },
+        children: target.label
+      })
+    }, target.id)), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Pressable, {
+      accessibilityRole: "button",
+      onPress: () => {
+        void auth.signOut();
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        children: "Sign out"
+      })
+    })]
+  });
+  if (environments.length === 0) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+      experience: {
+        status: 'empty',
+        retry: () => setRetry(value => value + 1),
+        signOut: auth.signOut
+      },
+      appDisplayName: appDisplayName,
+      component: experienceComponent,
+      fallback: fallback
+    });
+  }
+  const selectEnvironment = environmentId => {
+    const target = environments.find(environment => environment.id === environmentId);
+    if (target) onSelect(target, auth.account.identifier);
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_PowerAppsExperience.PowerAppsExperienceBoundary, {
+    experience: {
+      status: 'selectEnvironment',
+      environments: environments.map(toEnvironmentSummary),
+      selectEnvironment,
+      signOut: auth.signOut
+    },
+    appDisplayName: appDisplayName,
+    component: experienceComponent,
+    fallback: fallback
+  });
+}
+function PowerAppsTargetBootstrap({
+  msalConfig,
+  appDisplayName,
+  appName,
+  tenantPolicy,
+  experienceComponent,
+  children
+}) {
+  const ExperienceComponent = experienceComponent ?? _DefaultPowerAppsExperience.DefaultPowerAppsExperience;
+  const [selected, setSelected] = (0, _react.useState)();
+  const [bootstrapAccountIdentifier, setBootstrapAccountIdentifier] = (0, _react.useState)();
+  const generationRef = (0, _react.useRef)(0);
+  const [generation, setGeneration] = (0, _react.useState)(0);
+  const isCurrentGeneration = (0, _react.useCallback)(value => generationRef.current === value, []);
+  const select = (0, _react.useCallback)((target, accountIdentifier) => {
+    generationRef.current += 1;
+    setGeneration(generationRef.current);
+    setSelected(target);
+    setBootstrapAccountIdentifier(accountIdentifier);
+    if (target) void SecureStore.setItemAsync(TARGET_STORAGE_KEY, target.id);else void SecureStore.deleteItemAsync(TARGET_STORAGE_KEY);
+  }, []);
+  if (!selected) {
+    return /*#__PURE__*/(0, _jsxRuntime.jsx)(_AuthContext.AuthProvider, {
+      msalConfig: msalConfig,
+      authorityTenant: _tenantMode.MULTI_TENANT_AUTHORITY,
+      requiredScopes: [(0, _GlobalDiscovery.globalDiscoveryScope)('prod')],
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(EnvironmentSelector, {
+        appDisplayName: appDisplayName,
+        appName: appName,
+        tenantPolicy: tenantPolicy,
+        onSelect: select,
+        experienceComponent: ExperienceComponent
+      })
+    }, `bootstrap:${generation}`);
+  }
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_AuthContext.AuthProvider, {
+    msalConfig: msalConfig,
+    authorityTenant: selected.tenantId,
+    expectedTenantId: selected.tenantId,
+    preferredAccountIdentifier: bootstrapAccountIdentifier,
+    autoAuthorizeMissingScopes: true,
+    requiredScopes: [`${selected.dataverseApiUrl}/user_impersonation`, (0, _PowerPlatformEnvironmentApi.powerPlatformScope)(selected.region), 'https://apihub.azure.com/.default'],
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(TargetRuntime, {
+      target: selected,
+      generation: generation,
+      msalConfig: msalConfig,
+      isCurrent: isCurrentGeneration,
+      onBack: () => select(undefined),
+      experienceComponent: ExperienceComponent,
+      children: children
+    })
+  }, `${selected.id}:${generation}`);
+}

package/lib/commonjs/target/errors.js

@@ -0,0 +1,24 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.TargetRuntimeError = void 0;
+class TargetRuntimeError extends Error {
+  name = 'TargetRuntimeError';
+  constructor(code, stage, retryable, userMessage, targetId, cause) {
+    super(userMessage);
+    this.code = code;
+    this.stage = stage;
+    this.retryable = retryable;
+    this.userMessage = userMessage;
+    this.targetId = targetId;
+    Object.defineProperty(this, 'cause', {
+      value: cause,
+      enumerable: false,
+      configurable: false,
+      writable: false
+    });
+  }
+}
+exports.TargetRuntimeError = TargetRuntimeError;

package/lib/commonjs/target/types.js

@@ -0,0 +1 @@
+"use strict";

package/lib/commonjs/telemetry/index.js

@@ -16,10 +16,10 @@ Object.defineProperty(exports, "getAppLogger", {
     return _powerAppsNativeCommon.getAppLogger;
   }
 });
-Object.defineProperty(exports, "getCustomerTelemetryLogger", {
+Object.defineProperty(exports, "getCustomEventsLogger", {
   enumerable: true,
   get: function () {
-    return _powerAppsNativeCommon.getCustomerTelemetryLogger;
+    return _powerAppsNativeCommon.getCustomEventsLogger;
   }
 });
 exports.platformHttpClient = void 0;