@microsoft/power-apps-native-host 0.2.22

package/lib/commonjs/provider/PowerAppsProvider.js

@@ -0,0 +1,351 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.PowerAppsProvider = PowerAppsProvider;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _reactNativeGestureHandler = require("react-native-gesture-handler");
+var _core = require("@tamagui/core");
+var _portal = require("@tamagui/portal");
+var _v = require("@tamagui/config/v3");
+var _toast = require("@tamagui/toast");
+var _reactQuery = require("@tanstack/react-query");
+var _netinfo = _interopRequireDefault(require("@react-native-community/netinfo"));
+var _AuthContext = require("../auth/AuthContext.js");
+var _PowerAppsHostProvider = require("./PowerAppsHostProvider.js");
+var _PowerPlatformEnvironmentApi = require("../platform/PowerPlatformEnvironmentApi.js");
+var _ThemeProvider = require("../theme/ThemeProvider.js");
+var _ErrorBoundary = require("../ErrorBoundary.js");
+var _expoConstants = _interopRequireDefault(require("expo-constants"));
+var _powerAppsNativeCommon = require("@microsoft/power-apps-native-common");
+var _powerAppsNativeOffline = require("@microsoft/power-apps-native-offline");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+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); }
+/*!
+ * power-apps-native-host — PowerAppsProvider
+ *
+ * A single provider that composes all infrastructure required to run a
+ * Power Apps canvas app inside an Expo shell:
+ *
+ *   GestureHandlerRootView
+ *   └── TamaguiProvider  (defaults to @tamagui/config/v3)
+ *       └── PortalProvider  (required by ToastViewport)
+ *           └── ToastProvider + ToastViewport
+ *               └── QueryClientProvider  (own QueryClient, wired to NetInfo + AppState)
+ *                   └── AuthProvider
+ *                       └── PowerAppsHostProvider  (connected via useAuth)
+ *                           └── children
+ *
+ * Usage:
+ *
+ *   <PowerAppsProvider
+ *     msalConfig={authConfig.msal}
+ *     powerConfig={powerConfig}
+ *     schemaMap={schemaMap}
+ *   >
+ *     <StatusBar style="auto" />
+ *     <Slot />
+ *   </PowerAppsProvider>
+ */
+
+(0, _powerAppsNativeCommon.suppressKnownWarnings)();
+
+// ---- React-Query wiring (runs once at module load) ----
+
+// Wire onlineManager to NetInfo so refetchOnReconnect fires on mobile
+// (the default browser-event-based detection is a no-op in React Native).
+_reactQuery.onlineManager.setEventListener(setOnline => {
+  return _netinfo.default.addEventListener(state => setOnline(!!state.isConnected));
+});
+
+// Wire focusManager to AppState so queries refetch when the app foregrounds.
+_reactQuery.focusManager.setEventListener(handleFocus => {
+  const sub = _reactNative.AppState.addEventListener('change', status => {
+    if (_reactNative.Platform.OS !== 'web') handleFocus(status === 'active');
+  });
+  return () => sub.remove();
+});
+
+// ---- Singletons ----
+
+// The app's tamagui.config.ts (generated by /tamagui-design-system) is always
+// passed as the `tamaguiConfig` prop and owns all $surface* / $accent* tokens.
+// The bare @tamagui/config/v3 preset is only a last-resort fallback for tests
+// and storybook — it will not resolve custom $surface* tokens.
+const defaultTamaguiConfig = (0, _core.createTamagui)(_v.config);
+
+// Whether the offline SDK will actually orchestrate for this app. Mirrors the
+// resolution that @microsoft/power-apps-native-offline's useOfflineIntegration
+// performs (offlineProfile prop → expo manifest `extra.__offlineProfile`;
+// enabled defaults true unless the profile's `appConfig.enabled` is explicitly
+// false), but computed synchronously here because the QueryClient's networkMode
+// must be fixed BEFORE the first query runs. The SDK's own `isEnabled` is only
+// known deep inside the tree (below QueryClientProvider), which is too late to
+// configure the client without a race. Kept deliberately narrow: it only
+// decides networkMode below.
+function isOfflineEnabled(offlineProfile) {
+  // Only honour the prop when it carries a profileId — this mirrors the SDK's
+  // useOfflineIntegration, which ignores a profileId-less prop and falls through
+  // to the manifest. Without this guard a truthy-but-invalid prop (no profileId)
+  // short-circuits to `false` here while the SDK still resolves enabled from the
+  // manifest, leaving networkMode on 'online' (blank offline lists).
+  const propProfile = offlineProfile;
+  let profile = propProfile && propProfile.profileId ? propProfile : undefined;
+  if (!profile) {
+    const fromManifest = _expoConstants.default.expoConfig?.extra?.__offlineProfile;
+    if (fromManifest && typeof fromManifest === 'object' && fromManifest.profileId) {
+      profile = fromManifest;
+    }
+  }
+  if (profile) {
+    // Honour an explicit `appConfig.enabled: false`. This mirrors the SDK's
+    // useOfflineIntegration, whose validateConfig classifies `enabled === false`
+    // as "explicitly-disabled" and stays inert. A host shell's placeholder
+    // profile (e.g. Power Apps Dev Player's offline-profile.json, enabled:false)
+    // must NOT flip networkMode to 'always' for the loaded app — otherwise every
+    // scanned app gets paused queries / blank lists. Any other resolved profile
+    // (enabled true, or omitted → SDK defaults to true) enables offline.
+    const appConfig = profile.appConfig;
+    if (appConfig && appConfig.enabled === false) {
+      return false;
+    }
+    return true;
+  }
+  return false;
+}
+
+// Builds the app's QueryClient. networkMode is gated on whether offline is
+// actually enabled:
+//   • Offline enabled → 'always': the host is offline-first, so reads/writes are
+//     served by the offline SDK from local SQLite regardless of connectivity.
+//     onlineManager is wired to NetInfo (above) for refetchOnReconnect, but that
+//     same wiring makes the default 'online' mode PAUSE every query/mutation while
+//     offline (queryFn never runs → blank lists with WiFi off). 'always' makes
+//     React Query ignore connectivity for both the initial attempt AND retries, so
+//     local-SQLite reads/writes never get paused. ('offlineFirst' would still pause
+//     *retries* offline — wrong for a purely-local SDK where a transient first
+//     attempt error, e.g. SDK-not-ready at cold boot, would leave the query stuck
+//     'paused' until reconnect.)
+//   • Offline disabled → undefined: React Query keeps its default 'online' mode,
+//     i.e. the exact pre-offline behaviour for online-only apps.
+function createQueryClient(offlineEnabled) {
+  const networkMode = offlineEnabled ? 'always' : undefined;
+  return new _reactQuery.QueryClient({
+    defaultOptions: {
+      queries: {
+        staleTime: 60_000,
+        retry: 2,
+        networkMode
+      },
+      mutations: {
+        retry: 0,
+        networkMode
+      }
+    }
+  });
+}
+
+// ---- Types ----
+
+/** Shape of power.config.json consumed by the provider. */
+
+// ---- Inner component ----
+// Separate from PowerAppsProvider only because useAuth() must be called inside
+// AuthProvider. All auth-dependent wiring lives here.
+
+function InnerProviders({
+  msalConfig,
+  powerConfig,
+  schemaMap,
+  renderOAuthWebView,
+  onDisambiguationNeeded,
+  offlineProfile,
+  children
+}) {
+  const {
+    acquireToken,
+    isSignedIn,
+    hasRealAccount
+  } = (0, _AuthContext.useAuth)();
+  const connectionReferences = (0, _react.useMemo)(() => powerConfig.connectionReferences ?? {}, [powerConfig.connectionReferences]);
+
+  // ---- Offline (all logic lives in the SDK) ----
+  // Adapter over the host's fetchInstanceUrl: the offline SDK's contract passes a
+  // 4th `signal?: AbortSignal` arg (which fetchInstanceUrl treats as bearerToken)
+  // and expects a `string | null` return, so drop the extra arg and normalise
+  // `undefined` -> `null`.
+  const resolveInstanceUrlForOffline = (0, _react.useCallback)(async (environmentId, region, acqToken, _signal) => {
+    const url = await (0, _PowerPlatformEnvironmentApi.fetchInstanceUrl)(environmentId, region, acqToken);
+    return url ?? null;
+  }, []);
+
+  // Gate offline engagement on a REAL account (`hasRealAccount`), not the
+  // `isSignedIn` flag — `isSignedIn` is inflated by noAuthMode (login-bypassed /
+  // demo sessions report signed-in but have no account, so `acquireToken` always
+  // returns null). Passing the inflated flag makes the SDK orchestrator engage
+  // and then spin in a perpetual "waiting-for-auth" 3s retry loop (each retry
+  // re-renders the provider subtree). With no obtainable token offline cannot
+  // sync anyway, so we only engage once a usable token exists.
+  const offline = (0, _powerAppsNativeOffline.useOfflineIntegration)({
+    powerConfig,
+    offlineProfile,
+    acquireToken,
+    isSignedIn: hasRealAccount,
+    fetchInstanceUrl: resolveInstanceUrlForOffline
+  });
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)(_PowerAppsHostProvider.PowerAppsHostProvider, {
+    acquireToken: acquireToken,
+    isSignedIn: isSignedIn,
+    appId: powerConfig.appId ?? undefined,
+    environmentId: powerConfig.environmentId ?? '',
+    region: powerConfig.region ?? 'prod',
+    connectionReferences: connectionReferences,
+    schemaMap: schemaMap,
+    databaseReferences: powerConfig.databaseReferences,
+    isvClientId: msalConfig.clientId,
+    renderOAuthWebView: renderOAuthWebView,
+    onDisambiguationNeeded: onDisambiguationNeeded,
+    children: [children, offline.StatusOverlay && /*#__PURE__*/(0, _jsxRuntime.jsx)(offline.StatusOverlay, {})]
+  });
+}
+
+// ---- Public component ----
+
+/**
+ * Top-level provider for Power Apps canvas apps running inside an Expo shell.
+ *
+ * Composes GestureHandlerRootView, TamaguiProvider, ToastProvider,
+ * QueryClientProvider, AuthProvider, and PowerAppsHostProvider into a single
+ * component, eliminating all provider boilerplate from the consuming app's
+ * root layout.
+ */
+function PowerAppsProvider({
+  msalConfig,
+  intuneConfig,
+  powerConfig,
+  schemaMap,
+  tamaguiConfig = defaultTamaguiConfig,
+  // override with app's tamagui.config.ts
+  defaultTheme = 'light',
+  theme,
+  darkTheme,
+  followSystemTheme = true,
+  renderOAuthWebView,
+  onDisambiguationNeeded,
+  appName,
+  logger: loggerProp,
+  offlineProfile,
+  children
+}) {
+  // Capture the logger-prop identity at mount time so the effect dep array
+  // is stable (loggerProp is an object reference; re-running on every render
+  // would reconfigure and leak the previous provider).
+  const loggerPropRef = (0, _react.useRef)(loggerProp);
+
+  // Gate the offline-first networkMode on whether offline is actually enabled
+  // for this app. Keyed on the resolved boolean (not the prop object refs) so the
+  // QueryClient identity stays stable across renders even if the caller passes
+  // fresh offlineProfile literals.
+  const offlineEnabled = (0, _react.useMemo)(() => isOfflineEnabled(offlineProfile), [offlineProfile]);
+  const queryClient = (0, _react.useMemo)(() => createQueryClient(offlineEnabled), [offlineEnabled]);
+
+  // Configure the app logger exactly once per mount inside useEffect so that
+  // side effects (provider construction, async resolveDeviceId) never run
+  // during the render phase. This is safe because AppLogger.ts starts with a
+  // silent no-op Logger, so any telemetry emitted before the first commit is
+  // silently dropped rather than crashing.
+  (0, _react.useEffect)(() => {
+    const lp = loggerPropRef.current;
+    if (lp === null) {
+      // Explicit opt-out — replace with a silent no-op Logger.
+      (0, _powerAppsNativeCommon.configureAppLogger)(new _powerAppsNativeCommon.Logger());
+    } else if (lp !== undefined) {
+      // Caller supplied their own fully-configured logger.
+      (0, _powerAppsNativeCommon.configureAppLogger)(lp);
+    } else {
+      // Default: auto-wire the 1DS JS adapter so telemetry flows out of the
+      // box without any boilerplate in the consuming app.
+      const providerConfig = {
+        clusterCategory: (0, _powerAppsNativeCommon.regionToClusterCategory)(powerConfig.region ?? 'dev'),
+        clientType: appName ?? 'PowerAppsNative',
+        appVersion: _expoConstants.default.expoConfig?.version,
+        minSeverity: __DEV__ ? 'verbose' : 'info',
+        telemetryLocation: (0, _powerAppsNativeCommon.resolveTelemetryLocation)(powerConfig.geoRegion)
+      };
+      // Resolve the stable device ID first so every event — including the
+      // very first — carries the real GUID rather than the 'react-native'
+      // fallback. Events emitted while this resolves are silently dropped
+      // by the no-op Logger that is active until configureAppLogger is called.
+      (0, _powerAppsNativeCommon.resolveDeviceId)().then(deviceId => {
+        const provider = new _powerAppsNativeCommon.OneDsTelemetryProvider({
+          ...providerConfig,
+          deviceId
+        });
+        (0, _powerAppsNativeCommon.configureAppLogger)(new _powerAppsNativeCommon.Logger({
+          providers: [provider]
+        }));
+      }).catch(_err => {
+        // SecureStore unavailable — fall back to a provider without a stable ID.
+        const provider = new _powerAppsNativeCommon.OneDsTelemetryProvider(providerConfig);
+        (0, _powerAppsNativeCommon.configureAppLogger)(new _powerAppsNativeCommon.Logger({
+          providers: [provider]
+        }));
+      });
+    }
+
+    // Flush any queued telemetry when this component unmounts (dev reload /
+    // process exit). Placed inside this effect so the cleanup is paired with
+    // the setup — if the effect re-runs (which it won't here, empty deps),
+    // the previous provider is flushed before the new one is configured.
+    return () => {
+      void (0, _powerAppsNativeCommon.getAppLogger)().flush();
+    };
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []); // intentionally empty — logger is configured once per mount
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_ErrorBoundary.ErrorBoundary, {
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeGestureHandler.GestureHandlerRootView, {
+      style: {
+        flex: 1
+      },
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_ThemeProvider.ThemeProvider, {
+        theme: theme,
+        darkTheme: darkTheme,
+        followSystem: followSystemTheme,
+        children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_core.TamaguiProvider, {
+          config: tamaguiConfig,
+          defaultTheme: defaultTheme,
+          children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_portal.PortalProvider, {
+            shouldAddRootHost: true,
+            children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_toast.ToastProvider, {
+              swipeDirection: "horizontal",
+              duration: 3000,
+              children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactQuery.QueryClientProvider, {
+                client: queryClient,
+                children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_AuthContext.AuthProvider, {
+                  msalConfig: msalConfig,
+                  intuneConfig: intuneConfig,
+                  children: /*#__PURE__*/(0, _jsxRuntime.jsx)(InnerProviders, {
+                    msalConfig: msalConfig,
+                    powerConfig: powerConfig,
+                    schemaMap: schemaMap,
+                    renderOAuthWebView: renderOAuthWebView,
+                    onDisambiguationNeeded: onDisambiguationNeeded,
+                    offlineProfile: offlineProfile,
+                    children: children
+                  })
+                })
+              }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_toast.ToastViewport, {
+                top: 50,
+                left: 0,
+                right: 0
+              })]
+            })
+          })
+        })
+      })
+    })
+  });
+}

package/lib/commonjs/telemetry/index.js

@@ -0,0 +1,70 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.HostOperationNames = void 0;
+Object.defineProperty(exports, "configureAppLogger", {
+  enumerable: true,
+  get: function () {
+    return _powerAppsNativeCommon.configureAppLogger;
+  }
+});
+Object.defineProperty(exports, "getAppLogger", {
+  enumerable: true,
+  get: function () {
+    return _powerAppsNativeCommon.getAppLogger;
+  }
+});
+var _powerAppsNativeCommon = require("@microsoft/power-apps-native-common");
+/*!
+ * Copyright (C) Microsoft Corporation. All rights reserved.
+ *
+ * power-apps-native-host — package telemetry
+ *
+ * The shared logger singleton lives in `@microsoft/power-apps-native-common`
+ * (`getAppLogger` / `configureAppLogger`). This module re-exports those
+ * alongside the canonical host operation-name constants.
+ */
+
+/**
+ * Canonical operation names for host package telemetry.
+ * Follow the `PowerAppsHost.<Subsystem>.<Action>` convention so events are
+ * filterable in Kusto by prefix.
+ */
+const HostOperationNames = exports.HostOperationNames = {
+  // ── Auth ─────────────────────────────────────────────────────────────────
+  /** MSAL PublicClientApplication.init() + initial account resolution. */
+  AuthInit: 'PowerAppsHost.Auth.Init',
+  /** Interactive sign-in (acquireToken interactive). */
+  AuthSignIn: 'PowerAppsHost.Auth.SignIn',
+  /** Sign-out (token cache clear + broker logout). */
+  AuthSignOut: 'PowerAppsHost.Auth.SignOut',
+  /** Silent token acquisition. Recorded only on failure. */
+  AuthAcquireTokenSilentFailed: 'PowerAppsHost.Auth.AcquireTokenSilent.Failed',
+  /** Intune MAM enrollment after sign-in. */
+  AuthIntuneEnroll: 'PowerAppsHost.Auth.Intune.Enroll',
+  /** Intune MAM unenrollment during sign-out. */
+  AuthIntuneUnenroll: 'PowerAppsHost.Auth.Intune.Unenroll',
+  // ── Bridge / HTTP ─────────────────────────────────────────────────────────
+  /** SDK-originated HTTP request relayed through NativePowerAppsBridge. */
+  BridgeHttpRequest: 'PowerAppsHost.Bridge.HttpRequest',
+  /** Plugin call forwarded through NativePowerAppsBridge (verbose; also used for unhandled). */
+  BridgeUnhandledPlugin: 'PowerAppsHost.Bridge.PluginCall',
+  /** Connector/Dataverse token acquisition for the bridge. Recorded only on failure. */
+  BridgeTokenAcquireFailed: 'PowerAppsHost.Bridge.TokenAcquire.Failed',
+  // ── Runtime ───────────────────────────────────────────────────────────────
+  /** Top-level React error boundary caught an unhandled JS error. */
+  RuntimeUnhandledJsError: 'PowerAppsHost.Runtime.UnhandledJsError',
+  // ── Platform APIs ─────────────────────────────────────────────────────────
+  /** Resolve Dataverse instanceUrl from Power Platform environment API. */
+  PlatformFetchInstanceUrl: 'PowerAppsHost.Platform.FetchInstanceUrl',
+  /** useConnectionRefs failed to resolve connections (recoverable). Recorded only on failure. */
+  PlatformLoadConnectionsFailed: 'PowerAppsHost.Platform.LoadConnections.Failed',
+  /** Create a new Power Platform connection. */
+  PlatformCreateConnection: 'PowerAppsHost.Platform.CreateConnection',
+  /** Resolve app connection references for the current launch. */
+  PlatformResolveConnectionRefs: 'PowerAppsHost.Platform.ResolveConnectionRefs',
+  /** Grant this app access to a Power Platform connection ACL. */
+  PlatformConnectionAclGrant: 'PowerAppsHost.Platform.ConnectionAclGrant'
+};

package/lib/commonjs/theme/ThemeProvider.js

@@ -0,0 +1,80 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.ThemeProvider = ThemeProvider;
+Object.defineProperty(exports, "darkTheme", {
+  enumerable: true,
+  get: function () {
+    return _tokens.darkTheme;
+  }
+});
+Object.defineProperty(exports, "lightTheme", {
+  enumerable: true,
+  get: function () {
+    return _tokens.lightTheme;
+  }
+});
+exports.useThemeControl = useThemeControl;
+exports.useThemeTokens = useThemeTokens;
+var _react = _interopRequireWildcard(require("react"));
+var _reactNative = require("react-native");
+var _tokens = require("./tokens.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); }
+/**
+ * ThemeProvider — distributes {@link ThemeTokens} through the component tree.
+ *
+ * `PowerAppsProvider` mounts this automatically. Use directly only when
+ * composing providers manually.
+ */
+
+// ── Contexts ─────────────────────────────────────────────────────────────────
+const ThemeContext = /*#__PURE__*/(0, _react.createContext)(_tokens.lightTheme);
+const ThemeControlContext = /*#__PURE__*/(0, _react.createContext)({
+  setTheme: () => {},
+  resetTheme: () => {}
+});
+
+// ── Provider ─────────────────────────────────────────────────────────────────
+
+function ThemeProvider({
+  theme = _tokens.lightTheme,
+  darkTheme = _tokens.darkTheme,
+  followSystem = true,
+  children
+}) {
+  const colorScheme = (0, _reactNative.useColorScheme)();
+  const [override, setOverride] = (0, _react.useState)(null);
+  const resolved = (0, _react.useMemo)(() => {
+    if (override !== null) return override;
+    return followSystem && colorScheme === 'dark' ? darkTheme : theme;
+  }, [theme, darkTheme, followSystem, colorScheme, override]);
+  const control = (0, _react.useMemo)(() => ({
+    setTheme: tokens => setOverride(tokens),
+    resetTheme: () => setOverride(null)
+  }), []);
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(ThemeControlContext.Provider, {
+    value: control,
+    children: /*#__PURE__*/(0, _jsxRuntime.jsx)(ThemeContext.Provider, {
+      value: resolved,
+      children: children
+    })
+  });
+}
+
+// ── Hooks ─────────────────────────────────────────────────────────────────────
+
+/** Returns current {@link ThemeTokens} from the nearest ThemeProvider. */
+function useThemeTokens() {
+  return (0, _react.useContext)(ThemeContext);
+}
+
+/**
+ * Returns `{ setTheme, resetTheme }` for imperative theme overrides.
+ * Stable reference — does not re-render consumers on theme change.
+ */
+function useThemeControl() {
+  return (0, _react.useContext)(ThemeControlContext);
+}

package/lib/commonjs/theme/tokens.js

@@ -0,0 +1,50 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.lightTheme = exports.darkTheme = void 0;
+/**
+ * Theme token schema and built-in palettes for power-apps-native-host.
+ *
+ * Pass a custom {@link ThemeTokens} object to `PowerAppsProvider` to override
+ * the default Microsoft blue palette.
+ */
+
+// ── Built-in themes ──────────────────────────────────────────────────────────
+
+/** Microsoft blue light palette (default). */
+const lightTheme = exports.lightTheme = {
+  surface0: '#ffffff',
+  surface1: '#f7f7f8',
+  surface2: '#efeff1',
+  surface3: '#e3e3e7',
+  surface4: '#d0d0d6',
+  text0: '#111113',
+  text1: '#2e2e33',
+  text2: '#696969',
+  text3: '#9e9e9e',
+  accentDeep: '#004578',
+  accentBase: '#0078d4',
+  accentSoft: '#deecf9',
+  accentOnAccent: '#ffffff',
+  isDark: false
+};
+
+/** Microsoft blue dark palette (default). */
+const darkTheme = exports.darkTheme = {
+  surface0: '#111113',
+  surface1: '#1c1c1f',
+  surface2: '#28282c',
+  surface3: '#333338',
+  surface4: '#404047',
+  text0: '#ededef',
+  text1: '#c8c8cc',
+  text2: '#9898a0',
+  text3: '#6b6b75',
+  accentDeep: '#82c7ff',
+  accentBase: '#2899f5',
+  accentSoft: '#0a2238',
+  accentOnAccent: '#ffffff',
+  isDark: true
+};

package/lib/commonjs/utils/dataverseUtils.js

@@ -0,0 +1,98 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.base64ToDataUri = base64ToDataUri;
+exports.base64ToDataverseUploadFile = base64ToDataverseUploadFile;
+exports.base64ToUint8Array = base64ToUint8Array;
+exports.createDataverseUploadFile = createDataverseUploadFile;
+exports.detectImageMime = detectImageMime;
+exports.readFileAsUint8Array = readFileAsUint8Array;
+var _legacy = require("expo-file-system/legacy");
+/**
+ * Utilities for reading local file:// URIs and converting them into the binary
+ * format expected by the Dataverse upload endpoint via NativePowerAppsBridge.
+ *
+ * Background:
+ *  - `fetch('file://')` fails silently on Android.
+ *  - `fetch('data:...')` throws "Network request failed" on Android.
+ *  - `new Blob([Uint8Array])` crashes Hermes ("ArrayBufferView not supported").
+ *  - NativePowerAppsBridge accepts `Uint8Array` and extracts `.buffer` as the
+ *    fetch body, which React Native sends as raw bytes correctly.
+ *
+ * Solution: read via `readAsStringAsync` (base64) → `atob` → `Uint8Array`.
+ */
+
+/**
+ * Read a local `file://` URI and return its contents as a `Uint8Array`.
+ * Safe on both Android and iOS.
+ */
+async function readFileAsUint8Array(uri) {
+  const base64 = await (0, _legacy.readAsStringAsync)(uri, {
+    encoding: _legacy.EncodingType.Base64
+  });
+  return base64ToUint8Array(base64);
+}
+
+/**
+ * Detect the image MIME type from the first bytes of a base64-encoded string.
+ * Returns 'image/jpeg' as a safe default.
+ */
+function detectImageMime(base64) {
+  const normalized = normalizeBase64(base64);
+  if (normalized.startsWith('iVBOR')) return 'image/png';
+  if (normalized.startsWith('R0lG')) return 'image/gif';
+  if (normalized.startsWith('Qk')) return 'image/bmp';
+  if (normalized.startsWith('UklGR')) return 'image/webp';
+  return 'image/jpeg';
+}
+function normalizeBase64(base64) {
+  return base64.includes('base64,') ? base64.slice(base64.indexOf('base64,') + 'base64,'.length) : base64;
+}
+
+/** Convert a base64 string into bytes suitable for Dataverse binary upload APIs. */
+function base64ToUint8Array(base64) {
+  const normalized = normalizeBase64(base64);
+  const binaryString = atob(normalized);
+  const uint8 = new Uint8Array(binaryString.length);
+  for (let i = 0; i < binaryString.length; i++) {
+    uint8[i] = binaryString.charCodeAt(i);
+  }
+  return uint8;
+}
+function uint8ArrayToArrayBuffer(bytes) {
+  const copy = new Uint8Array(bytes.byteLength);
+  copy.set(bytes);
+  return copy.buffer;
+}
+
+/**
+ * Create a lightweight File-compatible object for generated Dataverse upload methods.
+ * React Native does not consistently provide a browser File implementation, but the
+ * generated services only require `name` and `arrayBuffer()`.
+ */
+function createDataverseUploadFile(name, mimeType, bytes) {
+  return {
+    name,
+    type: mimeType,
+    size: bytes.byteLength,
+    arrayBuffer: async () => uint8ArrayToArrayBuffer(bytes)
+  };
+}
+
+/** Create a File-compatible image object from Dataverse-style base64 image content. */
+function base64ToDataverseUploadFile(base64, name = 'image') {
+  const bytes = base64ToUint8Array(base64);
+  const mimeType = detectImageMime(base64);
+  const extension = mimeType.slice('image/'.length).replace('jpeg', 'jpg');
+  return createDataverseUploadFile(name.includes('.') ? name : `${name}.${extension}`, mimeType, bytes);
+}
+
+/**
+ * Build a `data:<mime>;base64,<data>` URI from a raw base64 string returned
+ * by Dataverse for an image column.
+ */
+function base64ToDataUri(base64) {
+  return `data:${detectImageMime(base64)};base64,${base64}`;
+}

package/lib/commonjs/utils/isDevPlayer.js

@@ -0,0 +1,27 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.isDevPlayer = void 0;
+var _reactNative = require("react-native");
+var _expoConstants = _interopRequireDefault(require("expo-constants"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * True when the JS bundle is running inside the Power Apps Dev Player shell.
+ *
+ * Two signals are combined to cover both execution paths:
+ *
+ * 1. `Constants.expoConfig.extra.isDevPlayer` — set in apps/dev-player/app.config.js.
+ *    Fires when the dev-player's **own** JS bundle is active (e.g. the launcher screen).
+ *
+ * 2. `NativeModules.PowerAppsDevLauncher` — the dev-player's Expo native module,
+ *    registered in the dev-player APK/IPA regardless of which JS bundle is loaded.
+ *    Fires when a template bundle is loaded via QR-code/URL into the dev-player shell,
+ *    because expo-constants then reflects the template's manifest (no isDevPlayer flag)
+ *    but the native module is still present in the host binary.
+ *
+ * Neither signal fires in a standalone release APK generated from the template, so
+ * `isDevPlayer` is false there and all debug logging is silenced.
+ */
+const isDevPlayer = exports.isDevPlayer = _expoConstants.default.expoConfig?.extra?.isDevPlayer === true || !!_reactNative.NativeModules.PowerAppsDevLauncher;