appium-ios-remotexpc 2.2.4 → 2.3.0

package/build/src/services/ios/zipconduit/plists.d.ts

@@ -0,0 +1,46 @@
+import type { PlistDictionary } from '../../../lib/types.js';
+export declare const SIGNING_ERROR = "ApplicationVerificationFailed";
+export interface ZipConduitMetadata {
+    StandardDirectoryPerms: number;
+    StandardFilePerms: number;
+    RecordCount: number;
+    TotalUncompressedBytes: number;
+    Version: number;
+}
+export interface InitTransferRequest {
+    InstallOptionsDictionary: {
+        DisableDeltaTransfer: number;
+        InstallDeltaTypeKey: string;
+        IsUserInitiated: number;
+        PackageType: string;
+        PreferWifi: number;
+    };
+    InstallTransferredDirectory: number;
+    MediaSubdir: string;
+    UserInitiatedTransfer: number;
+}
+export interface ZipConduitProgressUpdate {
+    percent: number;
+    status: string;
+}
+/**
+ * Build the InitTransfer plist payload for zip_conduit.
+ * @param fileName Local IPA path used to derive the PublicStaging destination.
+ */
+export declare function createInitTransfer(fileName: string): InitTransferRequest;
+/**
+ * Build ZipMetadata plist values embedded in the streamed archive.
+ * @param numFiles Number of entries in the source IPA.
+ * @param totalBytes Sum of uncompressed sizes for all IPA entries.
+ */
+export declare function createMetaInfPlist(numFiles: number, totalBytes: number): ZipConduitMetadata;
+/**
+ * Parse a zip_conduit progress plist into completion state and percentage.
+ * @param progressUpdate Progress plist received from the device.
+ */
+export declare function evaluateProgress(progressUpdate: PlistDictionary): {
+    done: boolean;
+    percent: number;
+    status: string;
+};
+//# sourceMappingURL=plists.d.ts.map

package/build/src/services/ios/zipconduit/plists.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plists.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/zipconduit/plists.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAG7D,eAAO,MAAM,aAAa,kCAAkC,CAAC;AAE7D,MAAM,WAAW,kBAAkB;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,wBAAwB,EAAE;QACxB,oBAAoB,EAAE,MAAM,CAAC;QAC7B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,2BAA2B,EAAE,MAAM,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAcxE;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,kBAAkB,CAQpB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,cAAc,EAAE,eAAe,GAAG;IACjE,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB,CAyCA"}

package/build/src/services/ios/zipconduit/plists.js

@@ -0,0 +1,87 @@
+import path from 'node:path';
+import { STD_DIR_PERM, STD_FILE_PERM } from './constants.js';
+export const SIGNING_ERROR = 'ApplicationVerificationFailed';
+/**
+ * Build the InitTransfer plist payload for zip_conduit.
+ * @param fileName Local IPA path used to derive the PublicStaging destination.
+ */
+export function createInitTransfer(fileName) {
+    const base = path.basename(fileName);
+    return {
+        InstallTransferredDirectory: 1,
+        UserInitiatedTransfer: 0,
+        MediaSubdir: `PublicStaging/${base}`,
+        InstallOptionsDictionary: {
+            InstallDeltaTypeKey: 'InstallDeltaTypeSparseIPAFiles',
+            DisableDeltaTransfer: 1,
+            IsUserInitiated: 1,
+            PreferWifi: 1,
+            PackageType: 'Customer',
+        },
+    };
+}
+/**
+ * Build ZipMetadata plist values embedded in the streamed archive.
+ * @param numFiles Number of entries in the source IPA.
+ * @param totalBytes Sum of uncompressed sizes for all IPA entries.
+ */
+export function createMetaInfPlist(numFiles, totalBytes) {
+    return {
+        RecordCount: 2 + numFiles,
+        StandardDirectoryPerms: STD_DIR_PERM,
+        StandardFilePerms: STD_FILE_PERM,
+        TotalUncompressedBytes: totalBytes,
+        Version: 2,
+    };
+}
+/**
+ * Parse a zip_conduit progress plist into completion state and percentage.
+ * @param progressUpdate Progress plist received from the device.
+ */
+export function evaluateProgress(progressUpdate) {
+    const topStatus = asString(progressUpdate.Status);
+    if (topStatus === 'DataComplete') {
+        return { done: true, percent: 100, status: topStatus };
+    }
+    // The device can report a failure as a top-level Error (e.g. ExtractionFailed)
+    // with no InstallProgressDict; surface the real reason instead of a generic
+    // "missing InstallProgressDict".
+    const topError = asString(progressUpdate.Error);
+    if (topError) {
+        const topDescription = asString(progressUpdate.ErrorDescription) ?? '';
+        throw new Error(`Failed installing: '${topError}'${topDescription ? ` errorDescription:'${topDescription}'` : ''}`);
+    }
+    const installProgressDict = progressUpdate.InstallProgressDict;
+    if (!installProgressDict || typeof installProgressDict !== 'object') {
+        throw new Error(`Invalid progress update, missing InstallProgressDict: ${JSON.stringify(progressUpdate)}`);
+    }
+    const progress = installProgressDict;
+    const errorMessage = asString(progress.Error);
+    if (errorMessage) {
+        const description = asString(progress.ErrorDescription) ?? '';
+        if (errorMessage === SIGNING_ERROR) {
+            throw new Error(`App is not properly signed for this device. original error: '${errorMessage}' errorDescription:'${description}'`);
+        }
+        throw new Error(`Failed installing: '${errorMessage}' errorDescription:'${description}'`);
+    }
+    const percent = asNumber(progress.PercentComplete) ?? 0;
+    const status = asString(progress.Status) ?? '';
+    return { done: false, percent, status };
+}
+function asNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value)) {
+        return value;
+    }
+    if (typeof value === 'bigint') {
+        return Number(value);
+    }
+    if (typeof value === 'string' && value.trim() !== '') {
+        const parsed = Number(value);
+        return Number.isFinite(parsed) ? parsed : undefined;
+    }
+    return undefined;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : undefined;
+}
+//# sourceMappingURL=plists.js.map

package/build/src/services/ios/zipconduit/plists.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plists.js","sourceRoot":"","sources":["../../../../../src/services/ios/zipconduit/plists.ts"],"names":[],"mappings":"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"}

package/build/src/services/ios/zipconduit/stream-zip.d.ts

@@ -0,0 +1,105 @@
+/**
+ * @license node-stream-zip | (c) 2020 Antelle | https://github.com/antelle/node-stream-zip/blob/master/LICENSE
+ * Portions copyright https://github.com/cthackers/adm-zip | https://raw.githubusercontent.com/cthackers/adm-zip/master/LICENSE
+ *
+ * Vendored from node-stream-zip@1.15.0, trimmed to the archive-reading paths
+ * used by ZipConduit (central-directory listing + streaming entry reads).
+ * Removed unused features: extract-to-disk, synchronous entry data, setFs,
+ * and the async helpers entriesCount/comment/entry/entryData/extract.
+ */
+import { EventEmitter } from 'node:events';
+import stream from 'node:stream';
+export interface StreamZipConfig {
+    file?: string;
+    fd?: number;
+    chunkSize?: number;
+    storeEntries?: boolean;
+    skipEntryNameValidation?: boolean;
+    nameEncoding?: string;
+    /**
+     * When true, skip local header reads for STORED entries (IPAs use STORE).
+     * Deflated entries always read the local header for a correct data offset.
+     */
+    skipLocalHeaderRead?: boolean;
+    /** When false, skip CRC32 verification while streaming (faster; default verifies). */
+    verifyEntryCrc?: boolean;
+}
+export type StreamZipEntry = ZipEntry;
+declare class CentralDirectoryHeader {
+    volumeEntries: number;
+    totalEntries: number;
+    size: number;
+    offset: number;
+    commentLength: number;
+    headerOffset: number;
+    read(data: Buffer): void;
+}
+/** ZIP central-directory entry (also returned from {@link StreamZip.entries}). */
+export declare class ZipEntry {
+    verMade: number;
+    version: number;
+    flags: number;
+    method: number;
+    time: number;
+    crc: number;
+    compressedSize: number;
+    size: number;
+    fnameLen: number;
+    extraLen: number;
+    comLen: number;
+    diskStart: number;
+    inattr: number;
+    attr: number;
+    offset: number;
+    headerOffset: number;
+    name: string;
+    isDirectory: boolean;
+    comment: string | null;
+    readHeader(data: Buffer, offset: number): void;
+    readDataHeader(data: Buffer): void;
+    read(data: Buffer, offset: number, textDecoder: TextDecoder | null): void;
+    validateName(): void;
+    readExtra(data: Buffer, offset: number): void;
+    parseZip64Extra(data: Buffer, offset: number, length: number): void;
+    get encrypted(): boolean;
+    get isFile(): boolean;
+}
+/** Streaming ZIP reader with promise-based entry access. */
+export declare class StreamZip extends EventEmitter {
+    private readonly config;
+    entriesCount: number;
+    comment: string | null;
+    centralDirectory: CentralDirectoryHeader;
+    private fd;
+    private fileSize;
+    private chunkSize;
+    private closed;
+    private signatureOp;
+    private entriesOp;
+    private readonly entryMap;
+    private readonly textDecoder;
+    private readonly readyPromise;
+    constructor(config: StreamZipConfig);
+    /** Resolves when the central directory has been parsed. */
+    waitUntilReady(): Promise<void>;
+    entries(): Promise<Record<string, ZipEntry>>;
+    stream(entry: ZipEntry | string): Promise<stream.Readable>;
+    openEntry(entry: ZipEntry | string): Promise<ZipEntry>;
+    close(): Promise<void>;
+    emit(event: string | symbol, ...args: unknown[]): boolean;
+    private resolveFileEntry;
+    private open;
+    private readFile;
+    private readUntilFoundCallback;
+    private readCentralDirectory;
+    private readCentralDirectoryComplete;
+    private readZip64CentralDirectoryLocator;
+    private readZip64CentralDirectoryLocatorComplete;
+    private readZip64CentralDirectoryComplete;
+    private readEntries;
+    private readEntriesCallback;
+    private dataOffset;
+    private canVerifyCrc;
+}
+export {};
+//# sourceMappingURL=stream-zip.d.ts.map

package/build/src/services/ios/zipconduit/stream-zip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream-zip.d.ts","sourceRoot":"","sources":["../../../../../src/services/ios/zipconduit/stream-zip.ts"],"names":[],"mappings":"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"}