@microsoft/power-apps-native-host 0.2.22

package/lib/commonjs/connections/types.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ConnectionStatus = void 0;
+/*!
+ * power-apps-native-host — connection disambiguation types
+ *
+ * Defines the native-host-specific types for connection resolution.  The web
+ * host equivalents live in @microsoft/power-apps-host, but the native host
+ * implements a lighter version that does not depend on IConnectionService.
+ */
+/**
+ * Resolved authorization state of a connection instance.
+ *
+ * - `Connected`     — platform status is Connected AND the ISV appid is in the connection ACL.
+ * - `NeedsAclGrant` — platform status is Connected but the ISV appid is missing from the ACL.
+ * - `NotConnected`  — platform status is anything other than Connected.
+ */
+let ConnectionStatus = exports.ConnectionStatus = /*#__PURE__*/function (ConnectionStatus) {
+  ConnectionStatus["Connected"] = "Connected";
+  ConnectionStatus["NeedsAclGrant"] = "NeedsAclGrant";
+  ConnectionStatus["NotConnected"] = "NotConnected";
+  return ConnectionStatus;
+}({});
+/** A single connection instance returned by the Power Platform connectivity API. */
+/**
+ * Result of attempting to match a single connection reference to an instance.
+ *
+ * - `resolved`  — exactly one Connected connection found; `connectionId` is set.
+ * - `missing`   — no connections found for this connector in the user's environment.
+ * - `ambiguous` — multiple Connected connections found; the app must pick one.
+ */
+/**
+ * Disambiguation result for a single connection reference (one apiId, possibly
+ * mapped to multiple data source names in the final connections map).
+ */
+/**
+ * Callback invoked when a connection reference has multiple Connected candidate
+ * connections.  The consuming app should present a native picker UI (e.g. a
+ * bottom sheet) and return the selected connection ID.
+ *
+ * Return `null` to leave the connection unresolved (the SDK will receive an
+ * empty `connectionName` and data operations for that connector will fail).
+ *
+ * @param context.localRefId  — local reference key from power.config.json
+ * @param context.apiId       — connector API identifier
+ * @param context.candidates  — list of Connected connection instances to choose from
+ */
+/**
+ * Callback invoked when the user has no connection for a required connector.
+ *
+ * The consuming app can redirect to the Power Apps maker portal or show an
+ * in-app connection setup flow.  Return `true` to indicate the user has
+ * created a connection and the hook should retry; return `false` to leave the
+ * connection unresolved.
+ */

package/lib/commonjs/connections/useConnectionSetup.js

@@ -0,0 +1,236 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.useConnectionSetup = useConnectionSetup;
+var _react = require("react");
+var _PowerPlatformConnectionApi = require("../platform/PowerPlatformConnectionApi.js");
+var _PowerPlatformEnvironmentApi = require("../platform/PowerPlatformEnvironmentApi.js");
+var _disambiguate = require("../connections/disambiguate.js");
+var _logger = require("../logger.js");
+var _index = require("../telemetry/index.js");
+/*!
+ * power-apps-native-host — useConnectionSetup
+ *
+ * A hook that drives the "create missing connection" flow for a single connector.
+ *
+ * Usage pattern (in the ConnectionSetupScreen):
+ *
+ *   const setup = useConnectionSetup({
+ *     connectorId: 'shared_office365users',
+ *     environmentId,
+ *     region,
+ *     acquireToken,
+ *     onConnected: (connectionId) => { ... mark resolved, advance to next ... }
+ *   });
+ *
+ *   // Render setup.consentUrl in a WebView when setup.phase === 'oauth'
+ *   // Call setup.startCreate() to trigger connection creation
+ *   // Call setup.checkNow() to re-poll after WebView finishes
+ */
+
+// ---------------------------------------------------------------------------
+// Phase machine
+// ---------------------------------------------------------------------------
+
+/**
+ * The current phase of the connection setup flow for one connector.
+ *
+ * idle        — not yet started.
+ * creating    — POST in progress (showing a spinner).
+ * oauth       — connection created; OAuth consent URL is ready (show WebView).
+ * confirming  — WebView dismissed; polling for Connected status.
+ * connected   — connection is Connected; ready to proceed.
+ * error       — unrecoverable error; `errorMessage` is set.
+ */
+
+// ---------------------------------------------------------------------------
+// Hook
+// ---------------------------------------------------------------------------
+
+function useConnectionSetup({
+  connectorId,
+  environmentId,
+  region = 'prod',
+  acquireToken,
+  onConnected,
+  isvClientId,
+  oauthRedirectUrl,
+  polling
+}) {
+  const [phase, setPhase] = (0, _react.useState)('idle');
+  const [consentUrl, setConsentUrl] = (0, _react.useState)(null);
+  const [errorMessage, setErrorMessage] = (0, _react.useState)(null);
+
+  // Track the connection name across re-renders without triggering re-renders.
+  const connectionNameRef = (0, _react.useRef)(null);
+  // Prevent concurrent startCreate / checkNow calls.
+  const inFlightRef = (0, _react.useRef)(false);
+  const handleConnected = (0, _react.useCallback)(async instance => {
+    setPhase('connected');
+    setConsentUrl(null);
+
+    // The RP auto-writes the user as Owner when a connection is created.
+    // However, APIM also checks that the requesting appid is present in the
+    // ACE's AppIds list. For third-party ISV tokens this is never populated
+    // automatically — we must explicitly add the ISV's client ID to the
+    // connection ACL so that APIM accepts tokens bearing that appid at runtime.
+    if (isvClientId) {
+      const paToken = await acquireToken([_PowerPlatformConnectionApi.SERVICE_POWERAPPS_SCOPE]);
+      const userOid = paToken ? (0, _PowerPlatformConnectionApi.parseJwtOid)(paToken) : null;
+      if (!paToken || !userOid) {
+        setPhase('error');
+        setErrorMessage('Connection was created, but access could not be granted to this app. Please try again.');
+        (0, _logger.debugWarn)('[useConnectionSetup] could not grant connection ACL: missing Power Apps token or user OID');
+        (0, _index.getAppLogger)().trackErrorEvent(_index.HostOperationNames.PlatformConnectionAclGrant, {
+          phase: 'setupConnectionAcl',
+          reason: !paToken ? 'missingPowerAppsToken' : 'missingUserOid'
+        });
+        return;
+      }
+      const aclGranted = await (0, _PowerPlatformConnectionApi.addAadAppToConnectionAcl)(connectorId, instance.id, environmentId, isvClientId, userOid, paToken);
+      if (!aclGranted) {
+        setPhase('error');
+        setErrorMessage('Connection was created, but access could not be granted to this app. Please try again.');
+        (0, _index.getAppLogger)().trackErrorEvent(_index.HostOperationNames.PlatformConnectionAclGrant, {
+          phase: 'setupConnectionAcl',
+          reason: 'aclGrantRejected'
+        });
+        return;
+      }
+    }
+    onConnected?.(instance);
+  }, [onConnected, acquireToken, connectorId, environmentId, isvClientId]);
+  const startCreate = (0, _react.useCallback)(async () => {
+    if (inFlightRef.current) return;
+    inFlightRef.current = true;
+    setPhase('creating');
+    setErrorMessage(null);
+    setConsentUrl(null);
+    connectionNameRef.current = null;
+    try {
+      const token = await acquireToken([(0, _PowerPlatformEnvironmentApi.powerPlatformScope)(region)]);
+      if (!token) {
+        setPhase('error');
+        setErrorMessage('Failed to acquire authentication token');
+        return;
+      }
+      const result = await (0, _PowerPlatformConnectionApi.createConnection)(connectorId, environmentId, region, token, undefined, oauthRedirectUrl);
+      if (result.status === 'error') {
+        setPhase('error');
+        setErrorMessage(result.message);
+        return;
+      }
+      connectionNameRef.current = result.connectionName;
+      if (result.status === 'connected') {
+        // Connection is already Connected — poll once to get the full instance.
+        const instance = await (0, _PowerPlatformConnectionApi.pollConnectionStatus)(connectorId, result.connectionName, environmentId, region, acquireToken, {
+          timeoutMs: 10_000,
+          ...polling
+        });
+        if (instance) {
+          handleConnected(instance);
+        } else {
+          // Already created but not Connected yet — treat as oauth phase without a URL.
+          setPhase('oauth');
+        }
+        return;
+      }
+
+      // status === 'pending': show the OAuth URL in a WebView.
+      setConsentUrl(result.consentLink);
+      setPhase('oauth');
+
+      // Start background polling immediately — the user may finish OAuth quickly.
+      const instance = await (0, _PowerPlatformConnectionApi.pollConnectionStatus)(connectorId, result.connectionName, environmentId, region, acquireToken, polling);
+
+      // If the phase changed while we were polling (e.g., user dismissed WebView
+      // and checkNow already resolved it), don't override.
+      if (instance && phase !== 'connected') {
+        handleConnected(instance);
+      } else if (!instance && phase !== 'connected') {
+        setPhase('error');
+        setErrorMessage('Connection setup timed out. Please try again.');
+      }
+    } finally {
+      inFlightRef.current = false;
+    }
+  }, [connectorId, environmentId, region, acquireToken, polling, handleConnected, phase]);
+  const checkNow = (0, _react.useCallback)(async () => {
+    const name = connectionNameRef.current;
+    if (!name || inFlightRef.current) return;
+    if (phase !== 'oauth' && phase !== 'confirming') return;
+    inFlightRef.current = true;
+    setPhase('confirming');
+    try {
+      const instance = await (0, _PowerPlatformConnectionApi.pollConnectionStatus)(connectorId, name, environmentId, region, acquireToken, {
+        intervalMs: 1000,
+        timeoutMs: 30_000,
+        ...polling
+      });
+      if (instance) {
+        handleConnected(instance);
+      } else {
+        // Not yet connected — go back to oauth so the user can retry.
+        setPhase('oauth');
+        setErrorMessage('Connection is not yet active. Complete the sign-in and try again.');
+      }
+    } finally {
+      inFlightRef.current = false;
+    }
+  }, [phase, environmentId, region, acquireToken, polling, handleConnected]);
+  const reset = (0, _react.useCallback)(() => {
+    inFlightRef.current = false;
+    connectionNameRef.current = null;
+    setPhase('idle');
+    setConsentUrl(null);
+    setErrorMessage(null);
+  }, []);
+
+  /**
+   * Call after the in-app browser session closes.
+   *
+   * If a CommitTokenCode `code` is provided (from the redirect URL `?code=`
+   * param), POST it to `confirmConsentCode` first so APIM can activate the
+   * connection. Then poll until Connected regardless of whether the confirm
+   * call succeeded (the connection may already be Connected server-side).
+   */
+  const completeConsent = (0, _react.useCallback)(async code => {
+    const name = connectionNameRef.current;
+    if (!name || inFlightRef.current) return;
+    inFlightRef.current = true;
+    setPhase('confirming');
+    try {
+      if (code) {
+        const token = await acquireToken([(0, _PowerPlatformEnvironmentApi.powerPlatformScope)(region)]);
+        if (token) {
+          const connectionId = (0, _disambiguate.extractConnectionId)(name);
+          await (0, _PowerPlatformConnectionApi.confirmConsentCode)(connectorId, connectionId, environmentId, region, token, code);
+        }
+      }
+      const instance = await (0, _PowerPlatformConnectionApi.pollConnectionStatus)(connectorId, name, environmentId, region, acquireToken, {
+        intervalMs: 1000,
+        timeoutMs: 30_000,
+        ...polling
+      });
+      if (instance) {
+        handleConnected(instance);
+      } else {
+        setPhase('oauth');
+        setErrorMessage('Connection is not yet active. Complete the sign-in and try again.');
+      }
+    } finally {
+      inFlightRef.current = false;
+    }
+  }, [connectorId, environmentId, region, acquireToken, polling, handleConnected]);
+  return {
+    phase,
+    consentUrl,
+    errorMessage,
+    startCreate,
+    checkNow,
+    completeConsent,
+    reset
+  };
+}

package/lib/commonjs/controls/FilePicker.js

@@ -0,0 +1,183 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.FilePicker = FilePicker;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var DocumentPicker = _interopRequireWildcard(require("expo-document-picker"));
+var Sharing = _interopRequireWildcard(require("expo-sharing"));
+var _expoFileSystem = require("expo-file-system");
+var _vectorIcons = require("@expo/vector-icons");
+var _ThemeProvider = require("../theme/ThemeProvider.js");
+var _dataverseUtils = require("../utils/dataverseUtils.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); }
+/**
+ * A unified file component for view and edit scenarios.
+ *
+ * - Pass `onDownload` alone for a read-only row that opens the share sheet on tap.
+ * - Pass `onChange` alone for a pick-only button (e.g. in an edit form).
+ * - Pass both to show the existing file name (tappable to download) alongside a
+ *   replace button — useful when the edit screen should also allow previewing.
+ */
+function FilePicker({
+  label,
+  fileName,
+  onDownload,
+  shareTitle,
+  onChange,
+  acceptedTypes = ['*/*'],
+  pickButtonLabel = 'Select File',
+  replaceButtonLabel = 'Replace',
+  readingLabel = 'Reading file...',
+  containerStyle,
+  labelStyle,
+  fileRowStyle,
+  fileNameStyle,
+  buttonStyle,
+  buttonTextStyle,
+  accentColor
+}) {
+  const theme = (0, _ThemeProvider.useThemeTokens)();
+  const accent = accentColor ?? theme.accentBase;
+  const [downloading, setDownloading] = (0, _react.useState)(false);
+  const [pickedName, setPickedName] = (0, _react.useState)(null);
+  const [reading, setReading] = (0, _react.useState)(false);
+  const bg = theme.surface0;
+  const labelColor = theme.text2;
+  const displayName = pickedName ?? fileName;
+  const download = async () => {
+    if (!onDownload) return;
+    setDownloading(true);
+    try {
+      const bytes = await onDownload();
+      const destFile = new _expoFileSystem.File(_expoFileSystem.Paths.cache, displayName ?? 'download');
+      destFile.write(bytes);
+      await Sharing.shareAsync(destFile.uri, {
+        dialogTitle: shareTitle ?? displayName ?? 'File'
+      });
+    } catch (e) {
+      _reactNative.Alert.alert('Download Failed', e instanceof Error ? e.message : String(e));
+    } finally {
+      setDownloading(false);
+    }
+  };
+  const pick = async () => {
+    if (!onChange) return;
+    const result = await DocumentPicker.getDocumentAsync({
+      type: acceptedTypes,
+      copyToCacheDirectory: true
+    });
+    if (!result.canceled && result.assets.length > 0) {
+      const picked = result.assets[0];
+      setPickedName(picked.name);
+      setReading(true);
+      try {
+        const bytes = await (0, _dataverseUtils.readFileAsUint8Array)(picked.uri);
+        const mimeType = picked.mimeType ?? 'application/octet-stream';
+        onChange({
+          uri: picked.uri,
+          name: picked.name,
+          mimeType,
+          file: (0, _dataverseUtils.createDataverseUploadFile)(picked.name, mimeType, bytes),
+          bytes
+        });
+      } finally {
+        setReading(false);
+      }
+    }
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.View, {
+    style: [styles.container, containerStyle],
+    children: [label ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+      style: [styles.label, {
+        color: labelColor
+      }, labelStyle],
+      children: label
+    }) : null, displayName ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
+      style: [styles.fileRow, fileRowStyle],
+      onPress: onDownload ? download : undefined,
+      activeOpacity: onDownload ? 0.7 : 1,
+      disabled: downloading,
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_vectorIcons.Feather, {
+        name: "file-text",
+        size: 16,
+        color: accent
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: [styles.fileName, {
+          color: accent
+        }, fileNameStyle],
+        numberOfLines: 1,
+        children: displayName
+      }), onDownload && (downloading ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ActivityIndicator, {
+        size: "small",
+        color: accent
+      }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_vectorIcons.Feather, {
+        name: "download",
+        size: 16,
+        color: accent
+      }))]
+    }) : null, onChange ? /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactNative.TouchableOpacity, {
+      style: [styles.button, {
+        borderColor: accent,
+        backgroundColor: bg
+      }, buttonStyle],
+      onPress: pick,
+      activeOpacity: 0.7,
+      disabled: reading,
+      children: [reading ? /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.ActivityIndicator, {
+        size: "small",
+        color: accent
+      }) : /*#__PURE__*/(0, _jsxRuntime.jsx)(_vectorIcons.Feather, {
+        name: displayName ? 'refresh-cw' : 'file-plus',
+        size: 16,
+        color: accent
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNative.Text, {
+        style: [styles.buttonText, {
+          color: accent
+        }, buttonTextStyle],
+        children: reading ? readingLabel : displayName ? replaceButtonLabel : pickButtonLabel
+      })]
+    }) : null]
+  });
+}
+const styles = _reactNative.StyleSheet.create({
+  container: {
+    marginBottom: 16
+  },
+  label: {
+    fontSize: 12,
+    fontWeight: '600',
+    marginBottom: 4
+  },
+  fileRow: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 8,
+    paddingVertical: 4
+  },
+  fileName: {
+    flex: 1,
+    fontSize: 14,
+    fontWeight: '600'
+  },
+  button: {
+    flexDirection: 'row',
+    alignItems: 'center',
+    gap: 8,
+    paddingHorizontal: 16,
+    paddingVertical: 10,
+    borderWidth: 1,
+    borderRadius: 8,
+    alignSelf: 'flex-start',
+    maxWidth: '100%',
+    marginTop: 4
+  },
+  buttonText: {
+    fontSize: 14,
+    fontWeight: '600',
+    flexShrink: 1
+  }
+});