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

package/dist/core/device-install/storage/browser-storage.d.ts

@@ -1,18 +1,19 @@
-import { ProvisioningProfileInfo, PutSigningAssetsInput, StoredPairRecord, StoredSigningAssets, PairRecordPayload } from '../types';
+import { DeviceInstallSigningMode, ProvisioningProfileInfo, PutSigningAssetsInput, StoredPairRecord, StoredSigningAssets, PairRecordPayload } from '../types';
 export declare function normalizeUDID(udid?: string): string;
 export declare function normalizeBundleID(bundleID?: string): string;
 export declare function getPairRecord(udid?: string): Promise<StoredPairRecord | undefined>;
 export declare function putPairRecord(record: PairRecordPayload, metadata?: {
     productName?: string;
 }): Promise<StoredPairRecord>;
-export declare function getSigningAssets({ deviceUDID, bundleID, }: {
+export declare function getSigningAssets({ deviceUDID, bundleID, signingMode, }: {
     deviceUDID?: string;
     bundleID?: string;
+    signingMode?: DeviceInstallSigningMode;
 }): Promise<StoredSigningAssets | undefined>;
-export declare function getLatestSigningAssets(): Promise<StoredSigningAssets>;
-export declare function getLatestSigningAssetsWithCertificate(teamID?: string): Promise<StoredSigningAssets>;
+export declare function getLatestSigningAssets(signingMode?: DeviceInstallSigningMode): Promise<StoredSigningAssets>;
+export declare function getLatestSigningAssetsWithCertificate(teamID?: string, signingMode?: DeviceInstallSigningMode): Promise<StoredSigningAssets>;
 export declare function putSigningAssets(input: PutSigningAssetsInput): Promise<StoredSigningAssets>;
-export declare function findSigningAssetsForBundle(bundleID?: string): Promise<StoredSigningAssets[]>;
+export declare function findSigningAssetsForBundle(bundleID?: string, signingMode?: DeviceInstallSigningMode): Promise<StoredSigningAssets[]>;
 export declare function profileContainsDevice(profile: ProvisioningProfileInfo, deviceUDID?: string): boolean;
 export declare function profileMatchesBundleID(profile: ProvisioningProfileInfo, bundleID?: string): boolean;
 export declare function parseProvisioningProfile(file: File): Promise<{
@@ -22,6 +23,7 @@ export declare function parseProvisioningProfile(file: File): Promise<{
     applicationIdentifier: string | undefined;
     bundleID: string | undefined;
     provisionedDevices: string[];
+    getTaskAllow: boolean | undefined;
     expirationDate: string | undefined;
 }>;
 export declare function parseProvisioningProfileBase64(base64: string): {
@@ -31,6 +33,7 @@ export declare function parseProvisioningProfileBase64(base64: string): {
     applicationIdentifier: string | undefined;
     bundleID: string | undefined;
     provisionedDevices: string[];
+    getTaskAllow: boolean | undefined;
     expirationDate: string | undefined;
 };
 export declare function parseProvisioningProfileBytes(bytes: Uint8Array): {
@@ -40,5 +43,6 @@ export declare function parseProvisioningProfileBytes(bytes: Uint8Array): {
     applicationIdentifier: string | undefined;
     bundleID: string | undefined;
     provisionedDevices: string[];
+    getTaskAllow: boolean | undefined;
     expirationDate: string | undefined;
 };

package/dist/core/device-install/types.d.ts

@@ -1,4 +1,5 @@
 export type DeviceInstallLog = (message: string, detail?: string) => void;
+export type DeviceInstallSigningMode = 'development' | 'adhoc';
 export type DeviceInstallStep = 'signing' | 'connect' | 'build' | 'install';
 export type DeviceInstallStepStatus = 'idle' | 'active' | 'complete' | 'error';
 export type DeviceInstallBusyAction = 'signing' | 'usb' | 'pair' | 'build' | 'install';
@@ -29,17 +30,19 @@ export type ProvisioningProfileInfo = {
     applicationIdentifier?: string;
     bundleID?: string;
     provisionedDevices: string[];
+    getTaskAllow?: boolean;
     expirationDate?: string;
 };
 export type StoredSigningAssets = {
     id: string;
     deviceUDID?: string;
     teamID?: string;
+    signingMode?: DeviceInstallSigningMode;
     bundleID: string;
     certificateID?: string;
     certificateP12Base64: string;
     certificateFileName?: string;
-    certificatePassword: string;
+    certificatePassword?: string;
     provisioningProfileBase64: string;
     profileFileName?: string;
     profile: ProvisioningProfileInfo;

package/dist/device-build/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("../limbuild-client-C_CMNLYV.js");require("../index-CMeQfhYy.js");const c=require("../provisioning-D2ZZQeyX.js"),i=require("../browser-storage-C1jQLXat.js");async function v({certificateFile:t,provisioningProfileFile:e,certificatePassword:n,bundleId:s,deviceUDID:r,teamId:d,signingMode:f="development",certificateId:p}){const[u,A,o]=await Promise.all([l(t),l(e),i.parseProvisioningProfile(e)]);return g({profile:o,bundleId:s,deviceUDID:r,signingMode:f}),i.putSigningAssets({bundleID:s??o.bundleID??o.applicationIdentifier??e.name,deviceUDID:r,teamID:d??o.teamID,signingMode:f,certificateID:p,certificateP12Base64:u,certificateFileName:t.name,certificatePassword:n||void 0,provisioningProfileBase64:A,profileFileName:e.name,profile:o})}function S(t,e={}){g({profile:t.profile,bundleId:e.bundleId,deviceUDID:e.deviceUDID,signingMode:e.signingMode??t.signingMode})}function g({profile:t,bundleId:e,deviceUDID:n,signingMode:s}){if(e&&!i.profileMatchesBundleID(t,e))throw new Error(`Provisioning profile does not match bundle ID ${e}.`);if(n&&!i.profileContainsDevice(t,n))throw new Error("Provisioning profile does not include the selected iPhone.");if(s==="adhoc"&&t.getTaskAllow)throw new Error("Ad Hoc mode requires an Ad Hoc provisioning profile, not a development profile.")}async function l(t){const e=await t.arrayBuffer();let n="";const s=new Uint8Array(e);for(const r of s)n+=String.fromCharCode(r);return btoa(n)}exports.fetchLimbuildInfo=a.fetchLimbuildInfo;exports.getIOSOTAInstall=a.getIOSOTAInstall;exports.startSignedDeviceBuild=a.startSignedDeviceBuild;exports.watchBuildLogEvents=a.watchBuildLogEvents;exports.getReusableAppleSigningAssets=c.getReusableAppleSigningAssets;exports.putAppleGeneratedSigningAssets=c.putAppleGeneratedSigningAssets;exports.getLatestSigningAssets=i.getLatestSigningAssets;exports.getLatestSigningAssetsWithCertificate=i.getLatestSigningAssetsWithCertificate;exports.getSigningAssets=i.getSigningAssets;exports.parseProvisioningProfile=i.parseProvisioningProfile;exports.parseProvisioningProfileBase64=i.parseProvisioningProfileBase64;exports.parseProvisioningProfileBytes=i.parseProvisioningProfileBytes;exports.profileContainsDevice=i.profileContainsDevice;exports.profileMatchesBundleID=i.profileMatchesBundleID;exports.putSigningAssets=i.putSigningAssets;exports.fileToBase64=l;exports.importSigningAssetsFromFiles=v;exports.validateProvisioningProfileForInstall=g;exports.validateSigningAssetsForInstall=S;

package/dist/device-build/index.d.ts

@@ -0,0 +1,4 @@
+export { fetchLimbuildInfo, getIOSOTAInstall, startSignedDeviceBuild, watchBuildLogEvents, type BuildLogEventsOptions, type GetIOSOTAInstallOptions, type IOSOTAInstall, type LimbuildInfo, type StartSignedDeviceBuildOptions, } from '../core/device-install/operations/limbuild-client';
+export { getLatestSigningAssets, getLatestSigningAssetsWithCertificate, getReusableAppleSigningAssets, getSigningAssets, parseProvisioningProfile, parseProvisioningProfileBase64, parseProvisioningProfileBytes, profileContainsDevice, profileMatchesBundleID, putAppleGeneratedSigningAssets, putSigningAssets, type AppleSigningAssetCacheInput, type PutAppleGeneratedSigningAssetsInput, } from '../core/device-install';
+export { fileToBase64, importSigningAssetsFromFiles, validateProvisioningProfileForInstall, validateSigningAssetsForInstall, type ImportSigningAssetsFromFilesInput, type ValidateSigningAssetsOptions, } from './signing';
+export type { BuildLogLine, DeviceInstallBuildStatus, DeviceInstallSigningMode, ProvisioningProfileInfo, PutSigningAssetsInput, StoredSigningAssets, } from '../core/device-install/types';

package/dist/device-build/index.js

@@ -0,0 +1,84 @@
+import { f as b, g as B, s as D, w as y } from "../limbuild-client-CFJhYsRx.mjs";
+import "../index-BXg7HdIs.mjs";
+import { o as C, p as E } from "../provisioning-CdseoMJQ.mjs";
+import { p as d, a as m, b as u, c as A } from "../browser-storage-BJ__DGJ6.mjs";
+import { g as M, d as T, e as F, f as H, h as N } from "../browser-storage-BJ__DGJ6.mjs";
+async function w({
+  certificateFile: i,
+  provisioningProfileFile: e,
+  certificatePassword: t,
+  bundleId: n,
+  deviceUDID: o,
+  teamId: l,
+  signingMode: r = "development",
+  certificateId: g
+}) {
+  const [c, p, s] = await Promise.all([
+    a(i),
+    a(e),
+    d(e)
+  ]);
+  return f({ profile: s, bundleId: n, deviceUDID: o, signingMode: r }), m({
+    bundleID: n ?? s.bundleID ?? s.applicationIdentifier ?? e.name,
+    deviceUDID: o,
+    teamID: l ?? s.teamID,
+    signingMode: r,
+    certificateID: g,
+    certificateP12Base64: c,
+    certificateFileName: i.name,
+    certificatePassword: t || void 0,
+    provisioningProfileBase64: p,
+    profileFileName: e.name,
+    profile: s
+  });
+}
+function I(i, e = {}) {
+  f({
+    profile: i.profile,
+    bundleId: e.bundleId,
+    deviceUDID: e.deviceUDID,
+    signingMode: e.signingMode ?? i.signingMode
+  });
+}
+function f({
+  profile: i,
+  bundleId: e,
+  deviceUDID: t,
+  signingMode: n
+}) {
+  if (e && !u(i, e))
+    throw new Error(`Provisioning profile does not match bundle ID ${e}.`);
+  if (t && !A(i, t))
+    throw new Error("Provisioning profile does not include the selected iPhone.");
+  if (n === "adhoc" && i.getTaskAllow)
+    throw new Error("Ad Hoc mode requires an Ad Hoc provisioning profile, not a development profile.");
+}
+async function a(i) {
+  const e = await i.arrayBuffer();
+  let t = "";
+  const n = new Uint8Array(e);
+  for (const o of n)
+    t += String.fromCharCode(o);
+  return btoa(t);
+}
+export {
+  b as fetchLimbuildInfo,
+  a as fileToBase64,
+  B as getIOSOTAInstall,
+  M as getLatestSigningAssets,
+  T as getLatestSigningAssetsWithCertificate,
+  C as getReusableAppleSigningAssets,
+  F as getSigningAssets,
+  w as importSigningAssetsFromFiles,
+  d as parseProvisioningProfile,
+  H as parseProvisioningProfileBase64,
+  N as parseProvisioningProfileBytes,
+  A as profileContainsDevice,
+  u as profileMatchesBundleID,
+  E as putAppleGeneratedSigningAssets,
+  m as putSigningAssets,
+  D as startSignedDeviceBuild,
+  f as validateProvisioningProfileForInstall,
+  I as validateSigningAssetsForInstall,
+  y as watchBuildLogEvents
+};

package/dist/device-build/react.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("react"),f=require("../limbuild-client-C_CMNLYV.js");require("../index-CMeQfhYy.js");function P({apiUrl:e,token:o,signingAssets:g,loadOTAInstall:I=!1}){const[b,n]=t.useState("idle"),[w,d]=t.useState([]),[B,a]=t.useState(),[h,l]=t.useState(),[x,c]=t.useState(),i=t.useRef(void 0);t.useEffect(()=>()=>{i.current?.(),i.current=void 0},[]);const E=t.useCallback(()=>{i.current?.(),i.current=void 0,n("idle"),d([]),a(void 0),l(void 0),c(void 0)},[]),m=t.useCallback(async(q={})=>{if(!e)throw new Error("apiUrl is required to start a device build.");const u=q.signingAssets??g;if(!u)throw new Error("Signing assets are required to start a device build.");i.current?.(),n("queued"),d([]),a(void 0),l(void 0),c(void 0);try{const r=await f.startSignedDeviceBuild({limbuildApiUrl:e,token:o,certificateP12Base64:u.certificateP12Base64,certificatePassword:u.certificatePassword,provisioningProfileBase64:u.provisioningProfileBase64});if(!r.execId)throw new Error("Build request did not return an exec ID.");return a(r.execId),i.current=f.watchBuildLogEvents({limbuildApiUrl:e,token:o,execId:r.execId,onLine:s=>d(v=>[...v,s]),onStatus:s=>{n(s),s==="succeeded"&&I&&f.getIOSOTAInstall({limbuildApiUrl:e,token:o,execId:r.execId}).then(l).catch(v=>c(S(v)))},onError:s=>c(s.message)}),r.execId}catch(r){n("failed"),c(S(r));return}},[e,I,g,o]);return{status:b,logs:w,execId:B,otaInstall:h,error:x,startBuild:m,reset:E}}function S(e){return e instanceof Error?e.message:String(e)}exports.useDeviceBuild=P;

package/dist/device-build/react.d.ts

@@ -0,0 +1,20 @@
+import { BuildLogLine, DeviceInstallBuildStatus, IOSOTAInstall, StoredSigningAssets } from './index';
+export type UseDeviceBuildOptions = {
+    apiUrl?: string;
+    token?: string;
+    signingAssets?: StoredSigningAssets;
+    loadOTAInstall?: boolean;
+};
+export type StartDeviceBuildInput = {
+    signingAssets?: StoredSigningAssets;
+};
+export type UseDeviceBuildResult = {
+    status: DeviceInstallBuildStatus;
+    logs: BuildLogLine[];
+    execId?: string;
+    otaInstall?: IOSOTAInstall;
+    error?: string;
+    startBuild: (input?: StartDeviceBuildInput) => Promise<string | undefined>;
+    reset: () => void;
+};
+export declare function useDeviceBuild({ apiUrl, token, signingAssets, loadOTAInstall, }: UseDeviceBuildOptions): UseDeviceBuildResult;

package/dist/device-build/react.js

@@ -0,0 +1,66 @@
+import { useState as c, useRef as P, useEffect as A, useCallback as I } from "react";
+import { s as q, w as D, g as L } from "../limbuild-client-CFJhYsRx.mjs";
+import "../index-BXg7HdIs.mjs";
+function C({
+  apiUrl: e,
+  token: o,
+  signingAssets: v,
+  loadOTAInstall: g = !1
+}) {
+  const [m, n] = c("idle"), [x, a] = c([]), [h, u] = c(), [B, l] = c(), [E, s] = c(), r = P(void 0);
+  A(() => () => {
+    r.current?.(), r.current = void 0;
+  }, []);
+  const p = I(() => {
+    r.current?.(), r.current = void 0, n("idle"), a([]), u(void 0), l(void 0), s(void 0);
+  }, []), S = I(
+    async (b = {}) => {
+      if (!e)
+        throw new Error("apiUrl is required to start a device build.");
+      const d = b.signingAssets ?? v;
+      if (!d)
+        throw new Error("Signing assets are required to start a device build.");
+      r.current?.(), n("queued"), a([]), u(void 0), l(void 0), s(void 0);
+      try {
+        const t = await q({
+          limbuildApiUrl: e,
+          token: o,
+          certificateP12Base64: d.certificateP12Base64,
+          certificatePassword: d.certificatePassword,
+          provisioningProfileBase64: d.provisioningProfileBase64
+        });
+        if (!t.execId)
+          throw new Error("Build request did not return an exec ID.");
+        return u(t.execId), r.current = D({
+          limbuildApiUrl: e,
+          token: o,
+          execId: t.execId,
+          onLine: (i) => a((f) => [...f, i]),
+          onStatus: (i) => {
+            n(i), i === "succeeded" && g && L({ limbuildApiUrl: e, token: o, execId: t.execId }).then(l).catch((f) => s(w(f)));
+          },
+          onError: (i) => s(i.message)
+        }), t.execId;
+      } catch (t) {
+        n("failed"), s(w(t));
+        return;
+      }
+    },
+    [e, g, v, o]
+  );
+  return {
+    status: m,
+    logs: x,
+    execId: h,
+    otaInstall: B,
+    error: E,
+    startBuild: S,
+    reset: p
+  };
+}
+function w(e) {
+  return e instanceof Error ? e.message : String(e);
+}
+export {
+  C as useDeviceBuild
+};

package/dist/device-build/signing.d.ts

@@ -0,0 +1,20 @@
+import { DeviceInstallSigningMode, StoredSigningAssets } from '../core/device-install/types';
+export type ImportSigningAssetsFromFilesInput = {
+    certificateFile: File;
+    provisioningProfileFile: File;
+    certificatePassword?: string;
+    bundleId?: string;
+    deviceUDID?: string;
+    teamId?: string;
+    signingMode?: DeviceInstallSigningMode;
+    certificateId?: string;
+};
+export type ValidateSigningAssetsOptions = {
+    bundleId?: string;
+    deviceUDID?: string;
+    signingMode?: DeviceInstallSigningMode;
+};
+export declare function importSigningAssetsFromFiles({ certificateFile, provisioningProfileFile, certificatePassword, bundleId, deviceUDID, teamId, signingMode, certificateId, }: ImportSigningAssetsFromFilesInput): Promise<StoredSigningAssets>;
+export declare function validateSigningAssetsForInstall(assets: StoredSigningAssets, options?: ValidateSigningAssetsOptions): void;
+export declare function validateProvisioningProfileForInstall({ profile, bundleId, deviceUDID, signingMode, }: Pick<StoredSigningAssets, 'profile'> & ValidateSigningAssetsOptions): void;
+export declare function fileToBase64(file: File): Promise<string>;

package/dist/device-install/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("../use-device-install-ByUSmeYz.js"),t=require("../device-install-dialog-DGn2ZdBB.js");exports.AppleGsaSrpClient=e.AppleGsaSrpClient;exports.RELAY_HEADER_BYTES=e.RELAY_HEADER_BYTES;exports.RELAY_PROTOCOL_VERSION=e.RELAY_PROTOCOL_VERSION;exports.RelayClient=e.RelayClient;exports.RelayMessageType=e.RelayMessageType;exports.claimUsbmux=e.claimUsbmux;exports.closeDeviceRelayTarget=e.closeDeviceRelayTarget;exports.closeUsbmuxSession=e.closeUsbmuxSession;exports.createAppleRelaySession=e.createAppleRelaySession;exports.createBundleIDRequest=e.createBundleIDRequest;exports.createDevelopmentProfileRequest=e.createDevelopmentProfileRequest;exports.createUsbmuxSession=e.createUsbmuxSession;exports.decodeFrame=e.decodeFrame;exports.decodeJson=e.decodeJson;exports.deleteAppleRelaySession=e.deleteAppleRelaySession;exports.deviceRelayWebSocketUrl=e.deviceRelayWebSocketUrl;exports.downloadCertificateRequest=e.downloadCertificateRequest;exports.downloadProfileRequest=e.downloadProfileRequest;exports.encodeFrame=e.encodeFrame;exports.encodeJson=e.encodeJson;exports.exportAppleCertificateP12=e.exportAppleCertificateP12;exports.fetchAppleAccountSession=e.fetchAppleAccountSession;exports.fetchLimbuildInfo=e.fetchLimbuildInfo;exports.findBundleIDRequest=e.findBundleIDRequest;exports.findDevelopmentCertificatesRequest=e.findDevelopmentCertificatesRequest;exports.findDevelopmentProfilesRequest=e.findDevelopmentProfilesRequest;exports.findDeviceRequest=e.findDeviceRequest;exports.findSigningAssetsForBundle=e.findSigningAssetsForBundle;exports.findUsbmuxCandidates=e.findUsbmuxCandidates;exports.generateAppleSigningKeyAndCSR=e.generateAppleSigningKeyAndCSR;exports.getBulkEndpoints=e.getBulkEndpoints;exports.getLatestSigningAssets=e.getLatestSigningAssets;exports.getLatestSigningAssetsWithCertificate=e.getLatestSigningAssetsWithCertificate;exports.getPairRecord=e.getPairRecord;exports.getReusableAppleSigningAssets=e.getReusableAppleSigningAssets;exports.getSigningAssets=e.getSigningAssets;exports.listTeamsRequest=e.listTeamsRequest;exports.normalizeBundleID=e.normalizeBundleID;exports.normalizeUDID=e.normalizeUDID;exports.openStream=e.openStream;exports.parseProvisioningProfile=e.parseProvisioningProfile;exports.parseProvisioningProfileBase64=e.parseProvisioningProfileBase64;exports.parseProvisioningProfileBytes=e.parseProvisioningProfileBytes;exports.profileContainsDevice=e.profileContainsDevice;exports.profileMatchesBundleID=e.profileMatchesBundleID;exports.proxyPhoneTwoFactorCode=e.proxyPhoneTwoFactorCode;exports.proxyProvisioningRequest=e.proxyProvisioningRequest;exports.proxySrpComplete=e.proxySrpComplete;exports.proxySrpInit=e.proxySrpInit;exports.proxyTwoFactorCode=e.proxyTwoFactorCode;exports.putAppleGeneratedSigningAssets=e.putAppleGeneratedSigningAssets;exports.putPairRecord=e.putPairRecord;exports.putSigningAssets=e.putSigningAssets;exports.receiveStreamData=e.receiveStreamData;exports.registerDeviceRequest=e.registerDeviceRequest;exports.requestAppleDevice=e.requestAppleDevice;exports.requestUSBAccess=e.requestUSBAccess;exports.selectDeveloperPortalTeam=e.selectDeveloperPortalTeam;exports.sendStreamData=e.sendStreamData;exports.startBrowserOwnedAppleIDLogin=e.startBrowserOwnedAppleIDLogin;exports.startInstallRelay=e.startInstallRelay;exports.startPairingRelay=e.startPairingRelay;exports.startSignedDeviceBuild=e.startSignedDeviceBuild;exports.storedSigningAssetsReusable=e.storedSigningAssetsReusable;exports.submitDevelopmentCSRRequest=e.submitDevelopmentCSRRequest;exports.teamIDCandidates=e.teamIDCandidates;exports.transferIn=e.transferIn;exports.transferOutWithZlp=e.transferOutWithZlp;exports.triggerPhoneTwoFactor=e.triggerPhoneTwoFactor;exports.triggerTrustedDeviceTwoFactor=e.triggerTrustedDeviceTwoFactor;exports.useDeviceInstall=e.useDeviceInstall;exports.watchBuildLogEvents=e.watchBuildLogEvents;exports.DeviceInstallDialog=t.DeviceInstallDialog;exports.DeviceInstallRelay=t.DeviceInstallDialog;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const g=require("../browser-storage-C1jQLXat.js"),R=1,u=16,s={DeviceHello:1,OpenStream:2,OpenResult:3,StreamData:4,StreamClose:5,InstallProgress:6,Error:7,Ping:8,Pong:9,StartPairing:10,StartInstall:11,PairRecordReady:12};function L(e){const t=new Uint8Array(u+e.payload.byteLength),n=new DataView(t.buffer);return n.setUint8(0,R),n.setUint8(1,e.type),n.setUint8(2,0),n.setUint8(3,0),n.setUint32(4,e.requestId),n.setUint32(8,e.streamId),n.setUint32(12,e.payload.byteLength),t.set(e.payload,u),t}function T(e){if(e.byteLength<u)throw new Error(`Relay frame too short: ${e.byteLength}`);const t=new DataView(e.buffer,e.byteOffset,e.byteLength),n=t.getUint8(0);if(n!==R)throw new Error(`Unsupported relay protocol version ${n}`);const r=t.getUint32(12);if(e.byteLength!==u+r)throw new Error(`Relay frame length mismatch: got ${e.byteLength}, expected ${u+r}`);return{type:t.getUint8(1),requestId:t.getUint32(4),streamId:t.getUint32(8),payload:e.slice(u)}}function c(e){return new TextEncoder().encode(JSON.stringify(e))}function w(e){return JSON.parse(new TextDecoder().decode(e))}async function W(){if(!navigator.usb)throw new Error("WebUSB is not available in this browser.");return navigator.usb.requestDevice({filters:[{vendorId:1452}]})}function B(e){const t=[],n=e.configuration?.configurationValue,r=e.configurations.find(a=>a.configurationValue===n);r&&t.push(...U(r));for(const a of e.configurations)a.configurationValue!==n&&t.push(...U(a));return t}function U(e){const t=[];for(const n of e.interfaces)for(const r of n.alternates)r.interfaceClass===255&&r.interfaceSubclass===254&&r.interfaceProtocol===2&&t.push({configurationValue:e.configurationValue,interfaceNumber:n.interfaceNumber,alternateSetting:r.alternateSetting,endpoints:r.endpoints});return t}async function F(e,t){e.opened||await e.open(),(!e.configuration||e.configuration.configurationValue!==t.configurationValue)&&await e.selectConfiguration(t.configurationValue),await e.claimInterface(t.interfaceNumber),t.alternateSetting!==0&&await e.selectAlternateInterface(t.interfaceNumber,t.alternateSetting)}function _(e){const t=e.endpoints.find(r=>r.direction==="out"&&r.type==="bulk"),n=e.endpoints.find(r=>r.direction==="in"&&r.type==="bulk");if(!t||!n)throw new Error("Could not find usbmux bulk endpoints.");return{outEndpoint:t,inEndpoint:n}}async function k(e,t,n){const r=await e.transferOut(t.endpointNumber,n);if(r.status!=="ok")throw new Error(`USB transferOut failed: ${r.status}`);n.byteLength%t.packetSize===0&&await e.transferOut(t.endpointNumber,new Uint8Array)}async function M(e,t,n=16384){const r=await e.transferIn(t.endpointNumber,n);if(r.status!=="ok"||!r.data)throw new Error(`USB transferIn failed: ${r.status}`);return new Uint8Array(r.data.buffer,r.data.byteOffset,r.data.byteLength)}const I=0,j=2,P=6,H=4277009102,y=2,J=4,d=16,z=49152;async function G(e,t){const{inEndpoint:n,outEndpoint:r}=_(t),a=new Uint8Array(12),i=new DataView(a.buffer);i.setUint32(0,2),i.setUint32(4,0),i.setUint32(8,0),await k(e,r,D(I,a));const o=await O(e,n,1),l=new DataView(o.payload.buffer,o.payload.byteOffset).getUint32(0),p={device:e,candidate:t,inEndpoint:n,outEndpoint:r,muxVersion:l,txSeq:0,rxSeq:65535,nextSport:z,streams:new Map,writeChain:Promise.resolve(),closed:!1};return l>=2&&await x(p,j,new Uint8Array([7])),Z(p),p}async function Y(e,t){if(e.closed)throw new Error("usbmux session is closed.");let n,r;const a={session:e,sport:e.nextSport++,dport:t,seq:0,ack:0,queue:[],waiters:[],opened:new Promise((i,o)=>{n=i,r=o}),resolveOpened:n,rejectOpened:r};return e.streams.set(h(t,a.sport),a),await f(a,y,new Uint8Array),await a.opened,a}async function Q(e,t){if(e.session.closed)throw new Error("usbmux session is closed.");await f(e,d,t),e.seq+=t.byteLength}async function K(e){if(e.queue.length>0)return e.queue.shift();if(e.error)throw e.error;return new Promise(t=>{e.waiters.push(t)})}function E(e){e.closed=!0;for(const t of e.streams.values())for(t.error=new Error("usbmux session closed"),t.rejectOpened(t.error);t.waiters.length>0;)t.waiters.shift()(new Uint8Array);e.streams.clear()}async function f(e,t,n){const r=new Uint8Array(20+n.byteLength),a=new DataView(r.buffer);a.setUint16(0,e.sport),a.setUint16(2,e.dport),a.setUint32(4,e.seq),a.setUint32(8,e.ack),a.setUint8(12,80),a.setUint8(13,t),a.setUint16(14,512),r.set(n,20),await x(e.session,P,r)}async function x(e,t,n){if(e.closed)throw new Error("usbmux session is closed.");return e.writeChain=e.writeChain.then(async()=>{if(e.closed)return;const r=e.muxVersion>=2?X(t,n,e.txSeq++,e.rxSeq):D(t,n);await k(e.device,e.outEndpoint,r)}),e.writeChain}async function Z(e){try{for(;;){if(e.closed)return;const t=await O(e.device,e.inEndpoint,e.muxVersion);if(e.closed)return;if(t.rxSeq!==void 0&&(e.rxSeq=t.rxSeq),t.protocol!==P)continue;const n=te(t.payload),r=e.streams.get(h(n.sport,n.dport));if(r){if(n.flags&J){for(r.error=new Error(`Device reset stream ${r.dport}`),r.rejectOpened(r.error);r.waiters.length>0;)r.waiters.shift()(new Uint8Array);e.streams.delete(h(r.dport,r.sport));continue}if((n.flags&(y|d))===(y|d)){r.seq+=1,r.ack=n.seq+1,await f(r,d,new Uint8Array),r.resolveOpened();continue}n.payload.byteLength!==0&&(r.ack=n.seq+n.payload.byteLength,await f(r,d,new Uint8Array),r.waiters.length>0?r.waiters.shift()(n.payload):r.queue.push(n.payload))}}}catch{e.closed||E(e)}}async function O(e,t,n){for(;;){const r=await M(e,t),a=ee(r,n);if(!(n===1&&a.protocol!==I))return a}}function D(e,t){const n=new Uint8Array(8+t.byteLength),r=new DataView(n.buffer);return r.setUint32(0,e),r.setUint32(4,n.byteLength),n.set(t,8),n}function X(e,t,n,r){const a=new Uint8Array(16+t.byteLength),i=new DataView(a.buffer);return i.setUint32(0,e),i.setUint32(4,a.byteLength),i.setUint32(8,H),i.setUint16(12,n),i.setUint16(14,r),a.set(t,16),a}function ee(e,t){const n=new DataView(e.buffer,e.byteOffset,e.byteLength),r=n.getUint32(0),a=n.getUint32(4),i=t>=2?16:8;return{protocol:r,length:a,rxSeq:t>=2?n.getUint16(14):void 0,payload:e.slice(i,a)}}function te(e){const t=new DataView(e.buffer,e.byteOffset,e.byteLength),n=(t.getUint8(12)>>4)*4;return{sport:t.getUint16(0),dport:t.getUint16(2),seq:t.getUint32(4),ack:t.getUint32(8),flags:t.getUint8(13),payload:e.slice(n)}}function h(e,t){return`${e}:${t}`}class q{constructor(t,n,r,a){this.webSocketUrl=t,this.session=n,this.deviceHello=r,this.log=a}socket;streams=new Map;frameQueue=Promise.resolve();closed=!1;pairRecordWaiter;async connect(){const t=new WebSocket(this.webSocketUrl);t.binaryType="arraybuffer",this.socket=t,t.onclose=()=>{this.closed=!0,this.log("Relay socket closed"),this.pairRecordWaiter&&(this.pairRecordWaiter.reject(new Error("Relay socket closed")),this.pairRecordWaiter=void 0)},await new Promise((n,r)=>{t.onopen=()=>n(),t.onerror=()=>r(new Error("WebSocket connection failed"))}),t.onmessage=n=>{const r=n.data instanceof ArrayBuffer?new Uint8Array(n.data):new Uint8Array;this.enqueueFrame(r)},await this.send({type:s.DeviceHello,requestId:0,streamId:0,payload:c(this.deviceHello)}),this.log("Connected WebSocket relay")}async startPairing(){const t=new Promise((n,r)=>{this.pairRecordWaiter={resolve:n,reject:r}});return await this.send({type:s.StartPairing,requestId:0,streamId:0,payload:c({})}),this.log("Pairing requested"),t}async startInstall(t){await this.send({type:s.StartInstall,requestId:0,streamId:0,payload:c(t)}),this.log("Installation requested")}close(){this.closed=!0,this.socket?.close()}enqueueFrame(t){this.frameQueue=this.frameQueue.then(()=>this.handleFrame(T(t))).catch(n=>{this.log("Relay frame handling failed",n instanceof Error?n.message:String(n))})}async handleFrame(t){switch(t.type){case s.OpenStream:await this.handleOpenStream(t.requestId,t.streamId,w(t.payload).port);break;case s.StreamData:{const n=this.streams.get(t.streamId);if(!n)throw new Error(`Unknown stream ${t.streamId}`);await Q(n,t.payload);break}case s.StreamClose:this.streams.delete(t.streamId);break;case s.InstallProgress:this.log(re(w(t.payload).message));break;case s.Error:this.handleError(t.payload);break;case s.PairRecordReady:this.handlePairRecordReady(w(t.payload));break;case s.Ping:await this.send({type:s.Pong,requestId:t.requestId,streamId:0,payload:new Uint8Array});break}}handleError(t){const n=ne(t);this.log("Server error",n),this.pairRecordWaiter&&(this.pairRecordWaiter.reject(new Error(n)),this.pairRecordWaiter=void 0)}handlePairRecordReady(t){this.log("Pair record received",t.udid),this.pairRecordWaiter?.resolve(t),this.pairRecordWaiter=void 0}async handleOpenStream(t,n,r){try{const a=await Y(this.session,r);this.streams.set(n,a),await this.send({type:s.OpenResult,requestId:t,streamId:n,payload:c({ok:!0})}),this.log(`Opened device stream ${n} to port ${r}`),this.pumpDeviceToServer(n,a)}catch(a){this.log(`Open device stream ${n} failed`,a instanceof Error?a.message:String(a)),await this.send({type:s.OpenResult,requestId:t,streamId:n,payload:c({ok:!1,error:a instanceof Error?a.message:String(a)})})}}async pumpDeviceToServer(t,n){try{for(;;){const r=await K(n);if(this.closed)return;await this.send({type:s.StreamData,requestId:0,streamId:t,payload:r})}}catch(r){this.log(`Device stream ${t} closed`,r instanceof Error?r.message:String(r)),await this.send({type:s.StreamClose,requestId:0,streamId:t,payload:c({reason:r instanceof Error?r.message:String(r)})})}}async send(t){if(!this.closed){if(!this.socket||this.socket.readyState!==WebSocket.OPEN){this.closed=!0;return}this.socket.send(L(t))}}}function ne(e){const t=new TextDecoder().decode(e);try{const n=JSON.parse(t);return v(n.error??t)}catch{return v(t)}}function v(e){return e.replace(/libimobiledevice/g,"").trim()}function re(e){const t="install status: ";if(!e.startsWith(t))return e;const n=e.slice(t.length),a=new DOMParser().parseFromString(n,"application/xml").querySelector("plist > dict");if(!a)return e;const i=ae(a),o=i.Status??"Unknown";return`Install progress: ${i.PercentComplete?`${i.PercentComplete}% `:""}${o}`}function ae(e){const t={},n=Array.from(e.children);for(let r=0;r<n.length;r+=2){const a=n[r],i=n[r+1];!a||a.tagName!=="key"||!i||(t[a.textContent??""]=i.textContent??"")}return t}async function ie({log:e}){e("Selecting USB device");const t=await W(),n=se(t);return e("Selected USB device",`${t.manufacturerName??""} ${t.productName??""} ${t.serialNumber??""}`.trim()),n}async function N({limbuildApiUrl:e,token:t,log:n,target:r}){const a=b(e,t);let i;try{i=await V(a,r,n);const o=await i.startPairing();return{relay:i,pairRecord:o,target:r}}catch(o){throw i?.close(),o}}async function A({limbuildApiUrl:e,token:t,log:n,target:r,pairRecord:a}){const i=b(e,t);let o;try{return o=await V(i,r,n),await o.startInstall(a),o}catch(l){throw o?.close(),l}}async function C(e,t){if(e){if(e.session&&(E(e.session),e.session=void 0),e.claimedInterfaceNumber!==void 0)try{await e.device.releaseInterface(e.claimedInterfaceNumber),t?.("Released usbmux interface")}catch(n){t?.("USB interface release failed",m(n))}finally{e.claimedInterfaceNumber=void 0}if(e.device.opened)try{await e.device.close(),t?.("Closed USB device")}catch(n){t?.("USB device close failed",m(n))}}}async function V(e,t,n){await oe(t,n);const r=new q(e,t.session,t.hello,n);return await r.connect(),r}async function oe(e,t){if(!e.session)try{e.candidate=await ce(e,t),e.session=await G(e.device,e.candidate),t("Created usbmux session")}catch(n){throw await C(e,t),n}}function se(e){return{device:e,candidate:ue(e),hello:{serialNumber:e.serialNumber,productName:e.productName,manufacturerName:e.manufacturerName,productId:e.productId,vendorId:e.vendorId}}}async function ce(e,t){const n=$(e.device);if(n.length===0)throw new Error("No Apple usbmux interface found.");let r;for(const a of n)for(const i of[1,2])try{return e.device.opened||await e.device.open(),t("Claiming usbmux interface",`configuration ${a.configurationValue}, interface ${a.interfaceNumber}, alternate ${a.alternateSetting}, attempt ${i}`),await F(e.device,a),e.claimedInterfaceNumber=a.interfaceNumber,t("Claimed usbmux interface",`configuration ${a.configurationValue}, interface ${a.interfaceNumber}`),a}catch(o){r=o,t("USB interface claim failed",`configuration ${a.configurationValue}, interface ${a.interfaceNumber}: ${m(o)}`),await le(e),await de(250)}throw r instanceof Error?r:new Error("Unable to claim any Apple usbmux interface.")}function ue(e){const t=$(e)[0];if(!t)throw new Error("No Apple usbmux interface found.");return t}function $(e){const t=B(e),n=e.configuration?.configurationValue;return[...t.filter(r=>r.configurationValue===n),...t.filter(r=>r.configurationValue!==n)]}function b(e,t){const n=new URL(e);return n.protocol=n.protocol==="https:"?"wss:":"ws:",n.pathname=`${n.pathname.replace(/\/$/,"")}/device/ws`,t&&n.searchParams.set("token",t),n.toString()}function m(e){return e instanceof Error?e.message:String(e)}async function le(e){if(e.claimedInterfaceNumber!==void 0){try{await e.device.releaseInterface(e.claimedInterfaceNumber)}catch{}e.claimedInterfaceNumber=void 0}if(e.device.opened)try{await e.device.close()}catch{}}function de(e){return new Promise(t=>setTimeout(t,e))}async function fe(e={}){return ie({log:e.log??S})}async function pe(e){return N({...e,log:e.log??S})}async function we(e){return A({...e,log:e.log??S})}function S(){}exports.getPairRecord=g.getPairRecord;exports.normalizeUDID=g.normalizeUDID;exports.putPairRecord=g.putPairRecord;exports.RelayClient=q;exports.closeDeviceRelayTarget=C;exports.deviceRelayWebSocketUrl=b;exports.pairDevice=pe;exports.requestUSBAccess=fe;exports.startDeviceInstall=we;exports.startDeviceInstallRelay=A;exports.startDevicePairingRelay=N;

package/dist/device-install/index.d.ts

@@ -1,3 +1,18 @@
-export * from '../core/device-install';
-export { DeviceInstallDialog, DeviceInstallRelay } from '../components/device-install';
-export { useDeviceInstall } from '../hooks/use-device-install';
+import { RequestUSBAccessOptions as CoreRequestUSBAccessOptions, StartInstallRelayOptions, StartPairingRelayOptions } from '../core/device-install/operations';
+import { DeviceInstallLog } from '../core/device-install/types';
+export { closeDeviceRelayTarget, deviceRelayWebSocketUrl, startInstallRelay as startDeviceInstallRelay, startPairingRelay as startDevicePairingRelay, type DeviceRelayTarget, 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 declare function requestUSBAccess(options?: RequestUSBAccessOptions): Promise<import('.').DeviceRelayTarget>;
+export declare function pairDevice(options: Omit<StartPairingRelayOptions, 'log'> & {
+    log?: DeviceInstallLog;
+}): Promise<{
+    relay: import('.').RelayClient;
+    pairRecord: import('.').PairRecordPayload;
+    target: import('.').DeviceRelayTarget;
+}>;
+export declare function startDeviceInstall(options: Omit<StartInstallRelayOptions, 'log'> & {
+    log?: DeviceInstallLog;
+}): Promise<import('.').RelayClient>;