@limrun/ui 0.14.0-rc.5 → 0.14.0

package/src/device-install/demo/index.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="en">
-  <head>
-    <meta charset="UTF-8" />
-    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
-    <title>Real Device Install Demo - @limrun/ui</title>
-  </head>
-  <body>
-    <div id="root"></div>
-    <script type="module" src="./demo.tsx"></script>
-  </body>
-</html>

package/src/device-install/index.ts

@@ -1,50 +0,0 @@
-import {
-  requestUSBAccess as requestCoreUSBAccess,
-  startInstallRelay,
-  startPairingRelay,
-  type RequestUSBAccessOptions as CoreRequestUSBAccessOptions,
-  type StartInstallRelayOptions,
-  type StartPairingRelayOptions,
-} from '../core/device-install/operations';
-import type { DeviceInstallLog } from '../core/device-install/types';
-
-export {
-  closeDeviceRelayTarget,
-  deviceRelayWebSocketUrl,
-  startInstallRelay as startDeviceInstallRelay,
-  startPairingRelay as startDevicePairingRelay,
-  type DeviceRelayTarget,
-  type InstallSource,
-  type StartInstallRelayOptions,
-  type StartPairingRelayOptions,
-} from '../core/device-install/operations';
-export { getPairRecord, normalizeUDID, putPairRecord } from '../core/device-install/storage';
-export type {
-  DeviceHello,
-  DeviceInstallLog,
-  PairRecordPayload,
-  StoredPairRecord,
-} from '../core/device-install/types';
-export { RelayClient } from '../core/device-install/operations';
-
-export type RequestUSBAccessOptions = Partial<CoreRequestUSBAccessOptions>;
-
-export async function requestUSBAccess(options: RequestUSBAccessOptions = {}) {
-  return requestCoreUSBAccess({ log: options.log ?? noopLog });
-}
-
-export async function pairDevice(
-  options: Omit<StartPairingRelayOptions, 'log'> & { log?: DeviceInstallLog },
-) {
-  return startPairingRelay({ ...options, log: options.log ?? noopLog });
-}
-
-export async function startDeviceInstall(
-  options: Omit<StartInstallRelayOptions, 'log'> & { log?: DeviceInstallLog },
-) {
-  return startInstallRelay({ ...options, log: options.log ?? noopLog });
-}
-
-function noopLog() {
-  // Intentionally empty. Consumers can pass a logger for progress messages.
-}

package/src/device-install/react.ts

@@ -1,195 +0,0 @@
-import { useCallback, useEffect, useRef, useState } from 'react';
-import {
-  closeDeviceRelayTarget,
-  getPairRecord,
-  pairDevice,
-  putPairRecord,
-  requestUSBAccess,
-  startDeviceInstall,
-  type DeviceInstallLog,
-  type DeviceRelayTarget,
-  type InstallSource,
-  type RelayClient,
-  type StoredPairRecord,
-} from './index';
-import { errorMessage } from '../core/errors';
-
-export type DeviceInstallRelayBusyAction = 'usb' | 'pair' | 'install';
-
-export type UseDeviceInstallRelayOptions = {
-  apiUrl?: string;
-  token?: string;
-  organizationId?: string;
-  log?: DeviceInstallLog;
-};
-
-export type UseDeviceInstallRelayResult = {
-  device?: DeviceRelayTarget;
-  pairRecord?: StoredPairRecord;
-  busyAction?: DeviceInstallRelayBusyAction;
-  error?: string;
-  pairConfirmationRequired: boolean;
-  hasPairRecord: boolean;
-  canPair: boolean;
-  canInstall: boolean;
-  requestUSBAccess: () => Promise<DeviceRelayTarget | undefined>;
-  pairBrowser: () => Promise<StoredPairRecord | undefined>;
-  startInstallation: (installSource: InstallSource) => Promise<RelayClient | undefined>;
-  stopRelay: () => void;
-  clearError: () => void;
-};
-
-export function useDeviceInstallRelay({
-  apiUrl,
-  token,
-  organizationId,
-  log = noopLog,
-}: UseDeviceInstallRelayOptions): UseDeviceInstallRelayResult {
-  const [device, setDevice] = useState<DeviceRelayTarget | undefined>();
-  const [pairRecord, setPairRecord] = useState<StoredPairRecord | undefined>();
-  const [busyAction, setBusyAction] = useState<DeviceInstallRelayBusyAction | undefined>();
-  const [error, setError] = useState<string | undefined>();
-  const [pairConfirmationRequired, setPairConfirmationRequired] = useState(false);
-  const relayRef = useRef<RelayClient | undefined>(undefined);
-  const deviceRef = useRef<DeviceRelayTarget | undefined>(undefined);
-  // Keep the logger in a ref so callbacks below don't change identity when the
-  // consumer passes an unmemoized `log`. Otherwise every render would recreate
-  // cleanupDeviceAccess, re-run the unmount effect, and close the USB device
-  // mid-claim (surfacing as "Unable to claim interface" / "operation in progress").
-  const logRef = useRef(log);
-  logRef.current = log;
-
-  const cleanupDeviceAccess = useCallback(async () => {
-    relayRef.current?.close();
-    relayRef.current = undefined;
-    await closeDeviceRelayTarget(deviceRef.current, logRef.current);
-  }, []);
-
-  useEffect(() => {
-    deviceRef.current = device;
-  }, [device]);
-
-  useEffect(() => {
-    return () => {
-      void cleanupDeviceAccess();
-    };
-  }, [cleanupDeviceAccess]);
-
-  const selectUSBDevice = useCallback(async () => {
-    setBusyAction('usb');
-    setError(undefined);
-    setPairConfirmationRequired(false);
-    let target: DeviceRelayTarget | undefined;
-    try {
-      await cleanupDeviceAccess();
-      target = await requestUSBAccess({ log: logRef.current });
-      const storedPairRecord = await getPairRecord(target.hello.serialNumber);
-      setDevice(target);
-      setPairRecord(storedPairRecord);
-      logRef.current(
-        storedPairRecord ? 'Pair record found' : 'No pair record found',
-        target.hello.serialNumber,
-      );
-      return target;
-    } catch (caught) {
-      await closeDeviceRelayTarget(target, logRef.current);
-      setDevice(undefined);
-      setPairRecord(undefined);
-      setError(errorMessage(caught));
-      return undefined;
-    } finally {
-      setBusyAction(undefined);
-    }
-  }, [cleanupDeviceAccess]);
-
-  const pairBrowser = useCallback(async () => {
-    if (!apiUrl || !device) {
-      throw new Error('Select a USB device before pairing.');
-    }
-    setBusyAction('pair');
-    setError(undefined);
-    setPairConfirmationRequired(false);
-    try {
-      await cleanupDeviceAccess();
-      const result = await pairDevice({
-        registryApiUrl: apiUrl,
-        token,
-        organizationId,
-        log: logRef.current,
-        target: device,
-      });
-      const stored = await putPairRecord(result.pairRecord, {
-        productName: device.hello.productName,
-      });
-      result.relay.close();
-      await closeDeviceRelayTarget(device, logRef.current);
-      setPairRecord(stored);
-      setPairConfirmationRequired(false);
-      logRef.current('Device paired', 'The pair record was stored locally in this browser.');
-      return stored;
-    } catch (caught) {
-      await closeDeviceRelayTarget(device, logRef.current);
-      setPairConfirmationRequired(true);
-      setError(errorMessage(caught));
-      return undefined;
-    } finally {
-      setBusyAction(undefined);
-    }
-  }, [apiUrl, cleanupDeviceAccess, device, organizationId, token]);
-
-  const startInstallation = useCallback(
-    async (installSource: InstallSource) => {
-      if (!apiUrl || !device || !pairRecord) {
-        throw new Error('Select and pair a USB device before starting installation.');
-      }
-      setBusyAction('install');
-      setError(undefined);
-      try {
-        await cleanupDeviceAccess();
-        relayRef.current = await startDeviceInstall({
-          registryApiUrl: apiUrl,
-          token,
-          organizationId,
-          log: logRef.current,
-          target: device,
-          pairRecord,
-          installSource,
-        });
-        logRef.current('Device install started', 'Installation will continue through the connected iPhone.');
-        return relayRef.current;
-      } catch (caught) {
-        await closeDeviceRelayTarget(device, logRef.current);
-        setError(errorMessage(caught));
-        return undefined;
-      } finally {
-        setBusyAction(undefined);
-      }
-    },
-    [apiUrl, cleanupDeviceAccess, device, organizationId, pairRecord, token],
-  );
-
-  const stopRelay = useCallback(() => {
-    void cleanupDeviceAccess();
-    logRef.current('Device relay stopped');
-  }, [cleanupDeviceAccess]);
-
-  return {
-    device,
-    pairRecord,
-    busyAction,
-    error,
-    pairConfirmationRequired,
-    hasPairRecord: !!pairRecord,
-    canPair: !!apiUrl && !busyAction && !!device,
-    canInstall: !!apiUrl && !busyAction && !!device && !!pairRecord,
-    requestUSBAccess: selectUSBDevice,
-    pairBrowser,
-    startInstallation,
-    stopRelay,
-    clearError: () => setError(undefined),
-  };
-}
-
-function noopLog() {
-  // Intentionally empty. Consumers can pass a logger for progress messages.
-}

package/src/play-publish/README.md

@@ -1,66 +0,0 @@
-# @limrun/ui/play-publish
-
-Headless building blocks for publishing an AAB asset from the Limrun
-registry to Google Play, with a browser-owned Google sign-in. No UI ships
-here; embedders render their own buttons and dialogs around the hook,
-same as `device-install`.
-
-The Google access token is minted in the browser via Google Identity
-Services (token model, no client secret) and sent to the registry once
-per publish. Limrun never stores it.
-
-## Requirements
-
-- A Google OAuth **Web application** client ID whose authorized
-  JavaScript origins include your app's origin.
-- The signed-in Google account needs release permission for the target
-  app in Play Console, and the app listing must already exist.
-- The asset must be an AAB signed with the app's Play upload key.
-
-## React
-
-```tsx
-import { usePlaystorePublish } from '@limrun/ui/play-publish/react';
-
-const play = usePlaystorePublish({
-  registryApiUrl: 'https://registry.limrun.com',
-  token: limrunToken,
-  organizationId: organizationTid,
-  googleClientId: GOOGLE_OAUTH_CLIENT_ID,
-});
-
-// On dialog open, warm the sign-in script so the click stays popup-safe.
-// Optionally await the returned promise (true = ready) to gate the button:
-play.preloadGoogle();
-
-// Button handlers:
-await play.signInWithGoogle();
-await play.publish({ assetName: 'app-release.aab', packageName: 'com.example.app' });
-
-// Render from state: play.status, play.versionCode, play.error, play.errorCode
-```
-
-`errorCode` carries the registry's machine-readable error code; the
-canonical value list lives on `PlaystorePublishError`'s doc comment and
-grows additively.
-
-Google access tokens expire after about an hour. A `permissionDenied`
-error long after sign-in usually means the token expired; offer "Sign in
-with Google" again rather than pointing users at Play Console
-permissions.
-
-## Without React
-
-```ts
-import { requestGoogleAccessToken, publishToPlaystore } from '@limrun/ui/play-publish';
-
-const accessToken = await requestGoogleAccessToken({ clientId: GOOGLE_OAUTH_CLIENT_ID });
-const { versionCode } = await publishToPlaystore({
-  registryApiUrl,
-  token,
-  organizationId,
-  accessToken,
-  assetName: 'app-release.aab',
-  packageName: 'com.example.app',
-});
-```

package/src/play-publish/index.ts

@@ -1,12 +0,0 @@
-export {
-  ANDROID_PUBLISHER_SCOPE,
-  loadGoogleIdentityServices,
-  requestGoogleAccessToken,
-  type RequestGoogleAccessTokenInput,
-} from '../core/play-publish/google';
-export {
-  publishToPlaystore,
-  PlaystorePublishError,
-  type PlaystorePublishInput,
-  type PlaystorePublishResult,
-} from '../core/play-publish/publish';

package/src/play-publish/react.ts

@@ -1,208 +0,0 @@
-import { useCallback, useMemo, useRef, useState } from 'react';
-import { errorMessage } from '../core/errors';
-import {
-  loadGoogleIdentityServices,
-  PlaystorePublishError,
-  publishToPlaystore,
-  requestGoogleAccessToken,
-  type PlaystorePublishInput,
-  type PlaystorePublishResult,
-} from './index';
-
-export type UsePlaystorePublishOptions = Partial<
-  Pick<PlaystorePublishInput, 'registryApiUrl' | 'token' | 'organizationId'>
-> & {
-  /** Google OAuth Web application client ID used for sign-in. */
-  googleClientId?: string;
-};
-
-export type PlaystorePublishStatus = 'idle' | 'signing-in' | 'ready' | 'publishing' | 'published' | 'error';
-
-export type PlaystorePublishRequest = Omit<
-  PlaystorePublishInput,
-  'registryApiUrl' | 'token' | 'organizationId' | 'accessToken'
->;
-
-export type UsePlaystorePublishResult = {
-  status: PlaystorePublishStatus;
-  isSignedIn: boolean;
-  versionCode?: number;
-  error?: string;
-  /** Registry error code driving per-cause UX, e.g. versionCodeExists. */
-  errorCode?: string;
-  /**
-   * Warm up the Google sign-in script (e.g. on dialog open) so
-   * signInWithGoogle stays synchronous with the click. Resolves true once
-   * the script is ready; await it to gate the sign-in button, or ignore
-   * the result and rely on the blocked-popup error plus retry.
-   */
-  preloadGoogle: () => Promise<boolean>;
-  signInWithGoogle: () => Promise<boolean>;
-  publish: (request: PlaystorePublishRequest) => Promise<PlaystorePublishResult | undefined>;
-  /**
-   * Clears the outcome state (keeps the Google session). Does not cancel an
-   * in-flight sign-in or publish: their completion is ignored status-wise
-   * and new calls stay refused until the in-flight one settles.
-   */
-  reset: () => void;
-};
-
-export function usePlaystorePublish({
-  registryApiUrl,
-  token,
-  organizationId,
-  googleClientId,
-}: UsePlaystorePublishOptions): UsePlaystorePublishResult {
-  const [status, setStatus] = useState<PlaystorePublishStatus>('idle');
-  // isSignedIn derives from token possession so the two can never diverge,
-  // even when a reset() during the popup makes the flow's status stale.
-  const [accessToken, setAccessToken] = useState<string | undefined>();
-  const [versionCode, setVersionCode] = useState<number | undefined>();
-  const [error, setError] = useState<string | undefined>();
-  const [errorCode, setErrorCode] = useState<string | undefined>();
-  // The token lives in a ref so publish() right after signInWithGoogle()
-  // in one handler sees it before React re-renders.
-  const accessTokenRef = useRef<string | undefined>(undefined);
-  // reset() bumps the generation so an abandoned in-flight call cannot
-  // overwrite the state it settles into.
-  const generationRef = useRef(0);
-  const busyRef = useRef(false);
-
-  const preloadGoogle = useCallback(
-    () =>
-      loadGoogleIdentityServices().then(
-        () => true,
-        () => false,
-      ),
-    [],
-  );
-
-  // Guard failures replace the whole outcome, like the main paths do: a
-  // stale errorCode or versionCode must not render beside the new error.
-  const failGuard = useCallback((message: string) => {
-    setError(message);
-    setErrorCode(undefined);
-    setVersionCode(undefined);
-    setStatus('error');
-  }, []);
-
-  const signInWithGoogle = useCallback(async () => {
-    if (busyRef.current) {
-      return false;
-    }
-    if (!googleClientId) {
-      failGuard('Google OAuth client ID is not configured.');
-      return false;
-    }
-    busyRef.current = true;
-    const generation = generationRef.current;
-    setStatus('signing-in');
-    setError(undefined);
-    setErrorCode(undefined);
-    try {
-      const nextToken = await requestGoogleAccessToken({ clientId: googleClientId });
-      accessTokenRef.current = nextToken;
-      setAccessToken(nextToken);
-      if (generation === generationRef.current) {
-        setStatus('ready');
-      } else {
-        // A reset() during the popup ran before the token landed and left
-        // idle; upgrade it so status agrees with isSignedIn. Anything but
-        // idle belongs to a newer flow and must not be stomped.
-        setStatus((current) => (current === 'idle' ? 'ready' : current));
-      }
-      return true;
-    } catch (caught) {
-      if (generation === generationRef.current) {
-        setError(errorMessage(caught));
-        setStatus('error');
-      }
-      return false;
-    } finally {
-      busyRef.current = false;
-    }
-  }, [googleClientId]);
-
-  const publish = useCallback(
-    async (request: PlaystorePublishRequest) => {
-      if (busyRef.current) {
-        return undefined;
-      }
-      if (!registryApiUrl) {
-        failGuard('Registry URL is not configured.');
-        return undefined;
-      }
-      const googleToken = accessTokenRef.current;
-      if (!googleToken) {
-        failGuard('Sign in with Google before publishing.');
-        return undefined;
-      }
-      busyRef.current = true;
-      const generation = generationRef.current;
-      setStatus('publishing');
-      setError(undefined);
-      setErrorCode(undefined);
-      // A stale code from an earlier publish must not render as this
-      // attempt's success next to an error state.
-      setVersionCode(undefined);
-      try {
-        // Fields picked explicitly: spreading a wider-typed request object
-        // could smuggle same-named credential fields or excess properties
-        // into the request body.
-        const result = await publishToPlaystore({
-          registryApiUrl,
-          token,
-          organizationId,
-          accessToken: googleToken,
-          packageName: request.packageName,
-          assetId: request.assetId,
-          assetName: request.assetName,
-          track: request.track,
-          releaseStatus: request.releaseStatus,
-        });
-        if (generation === generationRef.current) {
-          setVersionCode(result.versionCode);
-          setStatus('published');
-        }
-        return result;
-      } catch (caught) {
-        if (generation === generationRef.current) {
-          setError(errorMessage(caught));
-          if (caught instanceof PlaystorePublishError) {
-            setErrorCode(caught.code);
-          }
-          setStatus('error');
-        }
-        return undefined;
-      } finally {
-        busyRef.current = false;
-      }
-    },
-    [registryApiUrl, token, organizationId],
-  );
-
-  const reset = useCallback(() => {
-    generationRef.current += 1;
-    setVersionCode(undefined);
-    setError(undefined);
-    setErrorCode(undefined);
-    setStatus(accessTokenRef.current ? 'ready' : 'idle');
-  }, []);
-
-  // Memoized so the result works as a prop or dependency without
-  // re-rendering consumers on unrelated parent renders.
-  return useMemo(
-    () => ({
-      status,
-      isSignedIn: accessToken !== undefined,
-      versionCode,
-      error,
-      errorCode,
-      preloadGoogle,
-      signInWithGoogle,
-      publish,
-      reset,
-    }),
-    [status, accessToken, versionCode, error, errorCode, preloadGoogle, signInWithGoogle, publish, reset],
-  );
-}