@limrun/ui 0.9.0-rc.8 → 0.13.3-rc.1

package/src/device-install/react.ts

@@ -1 +1,180 @@
-export { useDeviceInstall } from '../hooks/use-device-install';
+import { useCallback, useEffect, useRef, useState } from 'react';
+import {
+  closeDeviceRelayTarget,
+  getPairRecord,
+  pairDevice,
+  putPairRecord,
+  requestUSBAccess,
+  startDeviceInstall,
+  type DeviceInstallLog,
+  type DeviceRelayTarget,
+  type RelayClient,
+  type StoredPairRecord,
+} from './index';
+
+export type DeviceInstallRelayBusyAction = 'usb' | 'pair' | 'install';
+
+export type UseDeviceInstallRelayOptions = {
+  apiUrl?: string;
+  token?: 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: () => Promise<RelayClient | undefined>;
+  stopRelay: () => void;
+  clearError: () => void;
+};
+
+export function useDeviceInstallRelay({
+  apiUrl,
+  token,
+  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);
+
+  const cleanupDeviceAccess = useCallback(async () => {
+    relayRef.current?.close();
+    relayRef.current = undefined;
+    await closeDeviceRelayTarget(deviceRef.current, log);
+  }, [log]);
+
+  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 });
+      const storedPairRecord = await getPairRecord(target.hello.serialNumber);
+      setDevice(target);
+      setPairRecord(storedPairRecord);
+      log(storedPairRecord ? 'Pair record found' : 'No pair record found', target.hello.serialNumber);
+      return target;
+    } catch (caught) {
+      await closeDeviceRelayTarget(target, log);
+      setDevice(undefined);
+      setPairRecord(undefined);
+      setError(errorMessage(caught));
+      return undefined;
+    } finally {
+      setBusyAction(undefined);
+    }
+  }, [cleanupDeviceAccess, log]);
+
+  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({
+        limbuildApiUrl: apiUrl,
+        token,
+        log,
+        target: device,
+      });
+      const stored = await putPairRecord(result.pairRecord, {
+        productName: device.hello.productName,
+      });
+      result.relay.close();
+      await closeDeviceRelayTarget(device, log);
+      setPairRecord(stored);
+      setPairConfirmationRequired(false);
+      log('Device paired', 'The pair record was stored locally in this browser.');
+      return stored;
+    } catch (caught) {
+      await closeDeviceRelayTarget(device, log);
+      setPairConfirmationRequired(true);
+      setError(errorMessage(caught));
+      return undefined;
+    } finally {
+      setBusyAction(undefined);
+    }
+  }, [apiUrl, cleanupDeviceAccess, device, log, token]);
+
+  const startInstallation = useCallback(async () => {
+    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({
+        limbuildApiUrl: apiUrl,
+        token,
+        log,
+        target: device,
+        pairRecord,
+      });
+      log('Device install started', 'Installation will continue through the connected iPhone.');
+      return relayRef.current;
+    } catch (caught) {
+      await closeDeviceRelayTarget(device, log);
+      setError(errorMessage(caught));
+      return undefined;
+    } finally {
+      setBusyAction(undefined);
+    }
+  }, [apiUrl, cleanupDeviceAccess, device, log, pairRecord, token]);
+
+  const stopRelay = useCallback(() => {
+    void cleanupDeviceAccess();
+    log('Device relay stopped');
+  }, [cleanupDeviceAccess, log]);
+
+  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.
+}
+
+function errorMessage(error: unknown) {
+  return error instanceof Error ? error.message : String(error);
+}

package/src/hooks/index.ts

@@ -1 +1 @@
-export * from './use-device-install';
+export {};

package/src/index.ts

@@ -16,7 +16,4 @@ export {
   normalizeAndroidTree,
   normalizeIosTree,
   AX_UNAVAILABLE_ERROR,
-} from './core/ax-tree';
-
-export { DeviceInstallDialog, DeviceInstallRelay } from './components/device-install';
-export { useDeviceInstall } from './hooks/use-device-install';
+} from './core/ax-tree';

package/vite.config.ts

@@ -11,6 +11,10 @@ export default defineConfig({
     lib: {
       entry: {
         index: resolve(__dirname, 'src/index.ts'),
+        'app-store-relay/index': resolve(__dirname, 'src/app-store-relay/index.ts'),
+        'app-store-relay/react': resolve(__dirname, 'src/app-store-relay/react.ts'),
+        'device-build/index': resolve(__dirname, 'src/device-build/index.ts'),
+        'device-build/react': resolve(__dirname, 'src/device-build/react.ts'),
         'device-install/index': resolve(__dirname, 'src/device-install/index.ts'),
         'device-install/react': resolve(__dirname, 'src/device-install/react.ts'),
       },

package/dist/components/device-install/device-install-dialog.d.ts

@@ -1,5 +0,0 @@
-import { UseDeviceInstallOptions } from '../../hooks/use-device-install';
-export type DeviceInstallDialogProps = UseDeviceInstallOptions & {
-    disabled?: boolean;
-};
-export declare function DeviceInstallDialog({ disabled, ...hookOptions }: DeviceInstallDialogProps): import("react/jsx-runtime").JSX.Element;

package/dist/device-install-dialog-DGn2ZdBB.js

@@ -1,2 +0,0 @@
-"use strict";require('./device-install-dialog.css');const e=require("react/jsx-runtime"),d=require("react"),w=require("./use-device-install-ByUSmeYz.js");function S(l){var t,a,n="";if(typeof l=="string"||typeof l=="number")n+=l;else if(typeof l=="object")if(Array.isArray(l)){var c=l.length;for(t=0;t<c;t++)l[t]&&(a=S(l[t]))&&(n&&(n+=" "),n+=a)}else for(a in l)l[a]&&(n&&(n+=" "),n+=a);return n}function u(){for(var l,t,a=0,n="",c=arguments.length;a<c;a++)(l=arguments[a])&&(t=S(l))&&(n&&(n+=" "),n+=t);return n}const P=[{id:"signing",title:"Prepare signing",description:"Choose Apple ID login or upload certificates for a registered developer device."},{id:"build",title:"Build for device",description:"Start the signed iPhone build before connecting over USB."},{id:"connect",title:"Connect and pair",description:"After the build succeeds, connect the iPhone with WebUSB and pair this browser."},{id:"install",title:"Start installation",description:"Relay the last successful device build to the paired iPhone."}];function I({disabled:l,...t}){const[a,n]=d.useState(!1),[c,h]=d.useState("signing"),[o,b]=d.useState(),[g,y]=d.useState(""),[m,A]=d.useState(""),[x,C]=d.useState(""),j=d.useId(),i=w.useDeviceInstall(t);d.useEffect(()=>{h(i.currentStep)},[i.currentStep]);const f=(r,p)=>{i.setSigningFiles({[r]:p.currentTarget.files?.[0]})};return e.jsxs("div",{className:"lr-device-install",children:[e.jsx("button",{type:"button",className:"lr-device-install__trigger",disabled:l||!t.apiUrl,onClick:()=>n(!0),children:"Install to iPhone"}),a&&e.jsx("div",{className:"lr-device-install__backdrop",role:"presentation",children:e.jsxs("section",{"aria-labelledby":j,"aria-modal":"true",className:"lr-device-install__dialog",role:"dialog",children:[e.jsxs("header",{className:"lr-device-install__header",children:[e.jsxs("div",{children:[e.jsx("h2",{id:j,children:"Install to a real iPhone"}),e.jsx("p",{children:"Prepare signing, build for the registered device, connect and pair, then install from this browser."})]}),e.jsx("button",{type:"button",className:"lr-device-install__icon-button",onClick:()=>n(!1),children:"Close"})]}),i.error&&e.jsx("div",{className:"lr-device-install__error",children:i.error}),e.jsx("div",{className:"lr-device-install__steps",children:P.map((r,p)=>e.jsxs(T,{index:p+1,step:r,active:i.currentStep===r.id,open:c===r.id,status:i.stepStatuses[r.id],onToggle:()=>h(r.id),children:[r.id==="signing"&&e.jsxs("div",{className:"lr-device-install__step-body",children:[e.jsxs("div",{className:"lr-device-install__choice-grid",children:[e.jsxs("button",{type:"button",className:u("lr-device-install__choice",o==="apple-id"&&"lr-device-install__choice--active"),onClick:()=>b("apple-id"),children:[e.jsx("strong",{children:"Apple ID login"}),e.jsx("span",{children:"Sign in, choose team, bundle ID, and registered devices, then generate signing assets."})]}),e.jsxs("button",{type:"button",className:u("lr-device-install__choice",o==="upload"&&"lr-device-install__choice--active"),onClick:()=>b("upload"),children:[e.jsx("strong",{children:"Upload certificates"}),e.jsx("span",{children:"Use an existing .p12 certificate and provisioning profile."})]})]}),o==="apple-id"&&e.jsxs("div",{className:"lr-device-install__section-panel",children:[e.jsxs("div",{className:"lr-device-install__grid",children:[e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Apple ID"}),e.jsx("input",{type:"email",autoComplete:"username",placeholder:"name@example.com",value:g,onChange:s=>y(s.currentTarget.value)})]}),e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Apple ID password"}),e.jsx("input",{type:"password",autoComplete:"current-password",placeholder:"Password stays in this browser",value:m,onChange:s=>A(s.currentTarget.value)})]}),!i.hasReusableAppleCertificate&&e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Generated .p12 password"}),e.jsx("input",{type:"password",placeholder:"Used when exporting Apple certificate",onChange:s=>i.setSigningFiles({certificatePassword:s.currentTarget.value})})]})]}),e.jsxs("div",{className:"lr-device-install__actions",children:[e.jsx("button",{type:"button",className:"lr-device-install__secondary",disabled:l||!t.apiUrl||!g||!m||i.busyAction==="signing",onClick:()=>void i.startAppleIDLogin({accountName:g,password:m}),children:i.appleSigningStatus==="authenticating"?"Signing in...":"Sign in with Apple ID"}),e.jsxs("span",{className:"lr-device-install__hint",children:["Apple password is used only by browser-side SRP. Status: ",i.appleSigningStatus]})]}),i.appleSigningStatus==="two-factor-required"&&e.jsxs("div",{className:"lr-device-install__grid",children:[e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Two-factor code"}),e.jsx("input",{type:"text",inputMode:"numeric",autoComplete:"one-time-code",value:x,onChange:s=>C(s.currentTarget.value)})]}),e.jsx("button",{type:"button",className:"lr-device-install__secondary",disabled:!x||i.busyAction==="signing",onClick:()=>void i.submitAppleTwoFactorCode(x),children:"Submit Apple ID code"})]}),i.appleTeams.length>0&&e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Apple Developer team"}),e.jsx("select",{value:i.selectedAppleTeamID??"",onChange:s=>i.setSelectedAppleTeamID(s.currentTarget.value||void 0),children:i.appleTeams.map((s,_)=>{const v=s.teamId??(s.providerId===void 0?void 0:String(s.providerId))??s.publicProviderId??"";return e.jsxs("option",{value:v,children:[s.name??"Apple Developer Team"," ",v?`(${v})`:""]},`${v}-${_}`)})})]}),i.appleDevices.length>0&&e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Apple Developer devices"}),e.jsx("select",{multiple:!0,value:i.selectedAppleDeviceIDs,onChange:s=>i.setSelectedAppleDeviceIDs(Array.from(s.currentTarget.selectedOptions).map(_=>_.value)),children:i.appleDevices.map(s=>e.jsxs("option",{value:s.deviceId??"",children:[s.name??s.model??"Apple device"," ",s.deviceNumber??""]},s.deviceId??s.deviceNumber))})]}),i.applePortalSummary&&e.jsxs("p",{className:"lr-device-install__hint",children:["Found ",i.applePortalSummary.certificateCount," certificates and"," ",i.applePortalSummary.profileCount," provisioning profiles."]}),i.hasReusableAppleCertificate&&e.jsx("p",{className:"lr-device-install__hint",children:"Reusing the certificate and private key stored in this browser."}),e.jsx("button",{type:"button",className:"lr-device-install__primary",disabled:l||!i.canPrepareAppleSigningAssets,onClick:()=>void i.prepareAppleSigningAssets(),children:i.appleSigningStatus==="preparing-assets"?"Preparing signing assets...":"Generate certificate and profile"})]}),o==="upload"&&e.jsxs("div",{className:"lr-device-install__section-panel",children:[e.jsxs("div",{className:"lr-device-install__grid",children:[e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Certificate (.p12)"}),e.jsx("input",{type:"file",accept:".p12,application/x-pkcs12",onChange:s=>f("certificateFile",s)})]}),e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Provisioning profile"}),e.jsx("input",{type:"file",accept:".mobileprovision",onChange:s=>f("provisioningProfileFile",s)})]}),e.jsxs("label",{className:"lr-device-install__field",children:[e.jsx("span",{children:"Uploaded .p12 password"}),e.jsx("input",{type:"password",placeholder:"Export password",onChange:s=>i.setSigningFiles({certificatePassword:s.currentTarget.value})})]})]}),e.jsx("p",{className:"lr-device-install__hint",children:"The provisioning profile will be checked against the connected iPhone before installation."})]}),i.hasSigningAssets&&e.jsx("p",{children:"Signing assets are stored in this browser for the selected bundle and device."})]}),r.id==="connect"&&e.jsxs("div",{className:"lr-device-install__step-body",children:[e.jsx("p",{children:"WebUSB works in Chromium browsers on secure origins. Once the build succeeds, connect the iPhone over USB, approve the browser permission prompt, then pair this browser."}),e.jsxs("div",{className:"lr-device-install__actions",children:[e.jsx("button",{type:"button",className:"lr-device-install__primary",disabled:l||!i.canRequestUSBAccess,onClick:()=>void i.requestUSBAccess(),children:i.busyAction==="usb"?"Selecting iPhone...":"Allow USB access"}),e.jsx("button",{type:"button",className:"lr-device-install__secondary",disabled:l||!i.canPairBrowser,onClick:()=>void i.pairBrowser(),children:i.busyAction==="pair"?"Pairing...":i.pairConfirmationRequired?"Confirm pair record":"Pair browser"})]}),i.device&&e.jsx("div",{className:"lr-device-install__device",children:`${i.device.productName??"iPhone"} ${i.device.serialNumber??""}`.trim()}),i.pairConfirmationRequired&&e.jsxs("p",{children:["Unlock the iPhone and tap ",e.jsx("strong",{children:"Trust"})," in the system dialog, then confirm the pair record."]}),e.jsx("p",{children:i.hasPairRecord?"Pair record is stored locally. Continue to installation.":"Pair this browser once before installing."})]}),r.id==="build"&&e.jsxs("div",{className:"lr-device-install__step-body",children:[e.jsxs("div",{className:"lr-device-install__checklist",children:[e.jsx(N,{label:"Signing assets",ready:i.hasSigningInputs}),e.jsx(N,{label:"Device build",ready:i.buildStatus==="succeeded"?!0:void 0,pendingText:"Not started"})]}),e.jsx("button",{type:"button",className:"lr-device-install__primary",disabled:l||!i.canBuild,onClick:()=>void i.startDeviceBuild(),children:i.busyAction==="build"?"Starting build...":"Start device build"}),e.jsxs("details",{className:"lr-device-install__build-logs",open:i.buildLogPanelOpen,onToggle:s=>i.setBuildLogPanelOpen(s.currentTarget.open),children:[e.jsxs("summary",{children:["Build logs (",i.buildStatus,")"]}),e.jsx("pre",{children:i.buildLogs.length>0?i.buildLogs.filter(s=>s.type!=="meta").map(s=>s.data).join(`
-`):"Build logs will appear here while the device build is running."})]})]}),r.id==="install"&&e.jsxs("div",{className:"lr-device-install__step-body",children:[e.jsx("button",{type:"button",className:"lr-device-install__primary",disabled:l||!i.canInstall,onClick:()=>void i.startInstallation(),children:i.busyAction==="install"?"Installing...":"Install last build"}),e.jsx("button",{type:"button",className:"lr-device-install__secondary",onClick:i.stopRelay,children:"Stop relay"})]})]},r.id))}),e.jsxs("footer",{className:"lr-device-install__logs",children:[e.jsx("h3",{children:"Progress"}),e.jsx("ol",{children:i.logs.map((r,p)=>e.jsx("li",{children:r},`${p}-${r.slice(0,24)}`))})]})]})})]})}function T({index:l,step:t,active:a,open:n,status:c,onToggle:h,children:o}){return e.jsxs("article",{className:u("lr-device-install__step",a&&"lr-device-install__step--active"),children:[e.jsxs("button",{type:"button",className:"lr-device-install__step-header","aria-expanded":n,onClick:h,children:[e.jsx("div",{className:"lr-device-install__step-number",children:l}),e.jsxs("div",{children:[e.jsx("h3",{children:t.title}),e.jsx("p",{children:t.description})]}),e.jsx("span",{className:u("lr-device-install__status",`lr-device-install__status--${c}`),children:c==="complete"?"✓ Completed":c})]}),n&&o]})}function N({label:l,ready:t,pendingText:a="Not ready"}){const n=t===void 0?a:t?"Ready":"Needs attention";return e.jsxs("div",{className:"lr-device-install__check-row",children:[e.jsx("span",{children:l}),e.jsx("strong",{children:n})]})}exports.DeviceInstallDialog=I;exports.clsx=u;