appium-xcuitest-driver 10.14.13 → 10.16.0

package/build/lib/device/afc-client.js

@@ -0,0 +1,422 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AfcClient = void 0;
+const stream_1 = require("stream");
+const promises_1 = require("stream/promises");
+const path_1 = __importDefault(require("path"));
+const lodash_1 = __importDefault(require("lodash"));
+const bluebird_1 = __importDefault(require("bluebird"));
+const support_1 = require("appium/support");
+const appium_ios_device_1 = require("appium-ios-device");
+const remotexpc_utils_1 = require("./remotexpc-utils");
+const logger_1 = require("../logger");
+const real_device_management_1 = require("./real-device-management");
+/**
+ * Unified AFC Client
+ *
+ * Provides a unified interface for file operations on iOS devices,
+ * automatically handling the differences between iOS < 18 (appium-ios-device)
+ * and iOS 18 and above (appium-ios-remotexpc).
+ */
+class AfcClient {
+    service;
+    remoteXPCConnection;
+    constructor(service, remoteXPCConnection) {
+        this.service = service;
+        this.remoteXPCConnection = remoteXPCConnection;
+    }
+    //#region Public Methods
+    /**
+     * Create an AFC client for device
+     *
+     * @param udid - Device UDID
+     * @param useRemoteXPC - Whether to use remotexpc (use isIos18OrNewer(opts) to determine)
+     * @returns AFC client instance
+     */
+    static async createForDevice(udid, useRemoteXPC) {
+        if (useRemoteXPC) {
+            const client = await AfcClient.withRemoteXpcConnection(async () => {
+                const Services = await (0, remotexpc_utils_1.getRemoteXPCServices)();
+                const connectionResult = await Services.createRemoteXPCConnection(udid);
+                const afcService = await Services.startAfcService(udid);
+                return {
+                    service: afcService,
+                    connection: connectionResult.remoteXPC,
+                };
+            });
+            if (client) {
+                return client;
+            }
+        }
+        const afcService = await appium_ios_device_1.services.startAfcService(udid);
+        return new AfcClient(afcService);
+    }
+    /**
+     * Create an AFC client for app container access
+     *
+     * @param udid - Device UDID
+     * @param bundleId - App bundle identifier
+     * @param useRemoteXPC - Whether to use remotexpc (use isIos18OrNewer(opts) to determine)
+     * @param options - Optional configuration for container access
+     * @returns AFC client instance
+     */
+    static async createForApp(udid, bundleId, useRemoteXPC, options) {
+        const { containerType = null, skipDocumentsCheck = false } = options ?? {};
+        const isDocuments = !skipDocumentsCheck && containerType?.toLowerCase() === 'documents';
+        if (useRemoteXPC) {
+            const client = await AfcClient.withRemoteXpcConnection(async () => {
+                const Services = await (0, remotexpc_utils_1.getRemoteXPCServices)();
+                const connectionResult = await Services.createRemoteXPCConnection(udid);
+                const { houseArrestService, remoteXPC: houseArrestRemoteXPC } = await Services.startHouseArrestService(udid);
+                const afcService = isDocuments
+                    ? await houseArrestService.vendDocuments(bundleId)
+                    : await houseArrestService.vendContainer(bundleId);
+                // Use the remoteXPC from house arrest service if available, otherwise use the one from connection
+                const connection = houseArrestRemoteXPC ?? connectionResult.remoteXPC;
+                return {
+                    service: afcService,
+                    connection,
+                };
+            });
+            if (client) {
+                return client;
+            }
+        }
+        const houseArrestService = await appium_ios_device_1.services.startHouseArrestService(udid);
+        const afcService = isDocuments
+            ? await houseArrestService.vendDocuments(bundleId)
+            : await houseArrestService.vendContainer(bundleId);
+        return new AfcClient(afcService);
+    }
+    /**
+     * Check if a path is a directory
+     */
+    async isDirectory(path) {
+        if (this.isRemoteXPC) {
+            return await this.remoteXPCAfcService.isdir(path);
+        }
+        const fileInfo = await this.iosDeviceAfcService.getFileInfo(path);
+        return fileInfo.isDirectory();
+    }
+    /**
+     * List directory contents
+     */
+    async listDirectory(path) {
+        if (this.isRemoteXPC) {
+            return await this.remoteXPCAfcService.listdir(path);
+        }
+        return await this.iosDeviceAfcService.listDirectory(path);
+    }
+    /**
+     * Create a directory
+     */
+    async createDirectory(path) {
+        if (this.isRemoteXPC) {
+            await this.remoteXPCAfcService.mkdir(path);
+        }
+        else {
+            await this.iosDeviceAfcService.createDirectory(path);
+        }
+    }
+    /**
+     * Delete a directory or file
+     */
+    async deleteDirectory(path) {
+        if (this.isRemoteXPC) {
+            await this.remoteXPCAfcService.rm(path, true);
+        }
+        else {
+            await this.iosDeviceAfcService.deleteDirectory(path);
+        }
+    }
+    /**
+     * Get file contents as a buffer
+     */
+    async getFileContents(path) {
+        if (this.isRemoteXPC) {
+            return await this.remoteXPCAfcService.getFileContents(path);
+        }
+        // For ios-device, use stream-based approach
+        const stream = await this.iosDeviceAfcService.createReadStream(path, {
+            autoDestroy: true,
+        });
+        const buffers = [];
+        return new Promise((resolve, reject) => {
+            stream.on('data', (data) => buffers.push(data));
+            stream.on('end', () => resolve(Buffer.concat(buffers)));
+            stream.on('error', reject);
+        });
+    }
+    /**
+     * Set file contents from a buffer
+     */
+    async setFileContents(path, data) {
+        if (this.isRemoteXPC) {
+            await this.remoteXPCAfcService.setFileContents(path, data);
+            return;
+        }
+        // For ios-device, convert buffer to stream and use writeFromStream
+        const bufferStream = stream_1.Readable.from([data]);
+        return await this.writeFromStream(path, bufferStream);
+    }
+    /**
+     * Write file contents from a readable stream
+     */
+    async writeFromStream(path, stream) {
+        if (this.isRemoteXPC) {
+            await this.remoteXPCAfcService.writeFromStream(path, stream);
+            return;
+        }
+        const writeStream = await this.iosDeviceAfcService.createWriteStream(path, {
+            autoDestroy: true,
+        });
+        writeStream.on('finish', () => {
+            if (typeof writeStream.destroy === 'function') {
+                writeStream.destroy();
+            }
+        });
+        return new Promise((resolve, reject) => {
+            writeStream.on('close', resolve);
+            const onError = (e) => {
+                stream.unpipe(writeStream);
+                reject(e);
+            };
+            writeStream.on('error', onError);
+            stream.on('error', onError);
+            stream.pipe(writeStream);
+        });
+    }
+    /**
+     * Pull files/folders from device to local filesystem.
+     * Uses the appropriate mechanism (walkDir for ios-device, pull for remotexpc).
+     *
+     * @param remotePath - Remote path on the device (file or directory)
+     * @param localPath - Local destination path
+     * @param options - Pull options (recursive, overwrite, onEntry)
+     */
+    async pull(remotePath, localPath, options = {}) {
+        if (this.isRemoteXPC) {
+            // RemoteXPC expects 'callback' property, so map onEntry -> callback
+            const remoteXpcOptions = {
+                ...options,
+                callback: options.onEntry,
+            };
+            delete remoteXpcOptions.onEntry;
+            await this.remoteXPCAfcService.pull(remotePath, localPath, remoteXpcOptions);
+        }
+        else {
+            await this.pullWithWalkDir(remotePath, localPath, options);
+        }
+    }
+    /**
+     * Close the AFC service connection and remoteXPC connection if present
+     */
+    async close() {
+        this.service.close();
+        if (this.remoteXPCConnection) {
+            try {
+                await this.remoteXPCConnection.close();
+            }
+            catch { }
+        }
+    }
+    //#endregion
+    //#region Private Methods
+    /**
+     * Check if this client is using RemoteXPC
+     */
+    get isRemoteXPC() {
+        return !!this.remoteXPCConnection;
+    }
+    /**
+     * Helper to safely execute remoteXPC operations with connection cleanup
+     * @param operation - Async operation that returns an AfcClient
+     * @returns AfcClient on success, null on failure
+     */
+    static async withRemoteXpcConnection(operation) {
+        let remoteXPCConnection;
+        let succeeded = false;
+        try {
+            const { service, connection } = await operation();
+            remoteXPCConnection = connection;
+            const client = new AfcClient(service, remoteXPCConnection);
+            succeeded = true;
+            return client;
+        }
+        catch (err) {
+            logger_1.log.error(`Failed to create AFC client via RemoteXPC: ${err.message}, falling back to appium-ios-device`);
+            return null;
+        }
+        finally {
+            // Only close connection if we failed (if succeeded, the client owns it)
+            if (remoteXPCConnection && !succeeded) {
+                try {
+                    await remoteXPCConnection.close();
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+    }
+    /**
+     * Get service as RemoteXPC AFC service
+     */
+    get remoteXPCAfcService() {
+        return this.service;
+    }
+    /**
+     * Get service as iOS Device AFC service
+     */
+    get iosDeviceAfcService() {
+        return this.service;
+    }
+    /**
+     * Create a read stream for a file (internal use only).
+     */
+    async createReadStream(remotePath, options) {
+        if (this.isRemoteXPC) {
+            // Use readToStream which returns a streaming Readable
+            return await this.remoteXPCAfcService.readToStream(remotePath);
+        }
+        return await this.iosDeviceAfcService.createReadStream(remotePath, options);
+    }
+    /**
+     * Internal implementation of pull for ios-device using walkDir.
+     * Walks the remote directory tree and pulls files to local filesystem.
+     */
+    async pullWithWalkDir(remotePath, localPath, options) {
+        const { recursive = false, overwrite = true, onEntry } = options;
+        const isDir = await this.isDirectory(remotePath);
+        if (!isDir) {
+            // Single file pull
+            const localFilePath = (await this.isLocalDirectory(localPath))
+                ? path_1.default.join(localPath, path_1.default.posix.basename(remotePath))
+                : localPath;
+            await this.checkOverwrite(localFilePath, overwrite);
+            await this.pullSingleFile(remotePath, localFilePath);
+            if (onEntry) {
+                await onEntry(remotePath, localFilePath, false);
+            }
+            return;
+        }
+        // Directory pull requires recursive option
+        if (!recursive) {
+            throw new Error(`Cannot pull directory '${remotePath}' without recursive option. Set recursive: true to pull directories.`);
+        }
+        // Determine local root directory
+        const localDstIsDirectory = await this.isLocalDirectory(localPath);
+        const localRootDir = localDstIsDirectory
+            ? path_1.default.join(localPath, path_1.default.posix.basename(remotePath))
+            : localPath;
+        // Create the root directory
+        await (0, support_1.mkdirp)(localRootDir);
+        if (onEntry) {
+            await onEntry(remotePath, localRootDir, true);
+        }
+        const pullPromises = [];
+        // Walk the remote directory and pull files in parallel
+        await this.iosDeviceAfcService.walkDir(remotePath, true, async (entryPath, isDirectory) => {
+            // Calculate relative path from remote root
+            const relativePath = entryPath.startsWith(remotePath + '/')
+                ? entryPath.slice(remotePath.length + 1)
+                : entryPath.slice(remotePath.length);
+            const localEntryPath = path_1.default.join(localRootDir, relativePath);
+            if (isDirectory) {
+                await (0, support_1.mkdirp)(localEntryPath);
+                if (onEntry) {
+                    await onEntry(entryPath, localEntryPath, true);
+                }
+            }
+            else {
+                await this.checkOverwrite(localEntryPath, overwrite);
+                // Ensure parent directory exists
+                const parentDir = path_1.default.dirname(localEntryPath);
+                await (0, support_1.mkdirp)(parentDir);
+                // Start async file pull (non-blocking)
+                const readStream = await this.iosDeviceAfcService.createReadStream(entryPath, {
+                    autoDestroy: true,
+                });
+                const writeStream = support_1.fs.createWriteStream(localEntryPath, { autoClose: true });
+                pullPromises.push(new bluebird_1.default((resolve) => {
+                    writeStream.on('close', async () => {
+                        // Invoke onEntry callback after successful pull
+                        if (onEntry) {
+                            try {
+                                await onEntry(entryPath, localEntryPath, false);
+                            }
+                            catch (err) {
+                                logger_1.log.warn(`onEntry callback failed for '${entryPath}': ${err.message}`);
+                            }
+                        }
+                        resolve();
+                    });
+                    const onStreamingError = (e) => {
+                        readStream.unpipe(writeStream);
+                        logger_1.log.warn(`Cannot pull '${entryPath}' to '${localEntryPath}'. ` +
+                            `The file will be skipped. Original error: ${e.message}`);
+                        resolve();
+                    };
+                    writeStream.on('error', onStreamingError);
+                    readStream.on('error', onStreamingError);
+                }).timeout(real_device_management_1.IO_TIMEOUT_MS));
+                readStream.pipe(writeStream);
+                if (pullPromises.length >= real_device_management_1.MAX_IO_CHUNK_SIZE) {
+                    await bluebird_1.default.any(pullPromises);
+                    for (let i = pullPromises.length - 1; i >= 0; i--) {
+                        if (pullPromises[i].isFulfilled()) {
+                            pullPromises.splice(i, 1);
+                        }
+                    }
+                }
+            }
+        });
+        // Wait for remaining files to be pulled
+        if (!lodash_1.default.isEmpty(pullPromises)) {
+            await bluebird_1.default.all(pullPromises);
+        }
+    }
+    /**
+     * Check if local file exists and should not be overwritten.
+     * Throws an error if the file exists and overwrite is false.
+     *
+     * @param localPath - Local file path to check
+     * @param overwrite - Whether to allow overwriting existing files
+     */
+    async checkOverwrite(localPath, overwrite) {
+        if (!overwrite && await support_1.fs.exists(localPath)) {
+            throw new Error(`Local file already exists: ${localPath}`);
+        }
+    }
+    /**
+     * Pull a single file from device to local filesystem using streams.
+     * This method only works for ios-device.
+     *
+     * @param remotePath - Remote file path
+     * @param localPath - Local destination path
+     */
+    async pullSingleFile(remotePath, localPath) {
+        const readStream = await this.iosDeviceAfcService.createReadStream(remotePath, {
+            autoDestroy: true,
+        });
+        const writeStream = support_1.fs.createWriteStream(localPath, { autoClose: true });
+        await (0, promises_1.pipeline)(readStream, writeStream);
+    }
+    /**
+     * Check if a local path exists and is a directory.
+     */
+    async isLocalDirectory(localPath) {
+        try {
+            const stats = await support_1.fs.stat(localPath);
+            return stats.isDirectory();
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.AfcClient = AfcClient;
+//# sourceMappingURL=afc-client.js.map

package/build/lib/device/afc-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"afc-client.js","sourceRoot":"","sources":["../../../lib/device/afc-client.ts"],"names":[],"mappings":"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"}

package/build/lib/device/certificate-client.d.ts

@@ -0,0 +1,73 @@
+import type { AppiumLogger } from '@appium/types';
+import type { CertificateList } from '../commands/types';
+/**
+ * Options for installing a certificate
+ */
+export interface InstallCertificateOptions {
+    payload: Buffer;
+}
+/**
+ * Unified Certificate Client
+ *
+ * Provides a unified interface for certificate operations on iOS devices,
+ * automatically handling the differences between iOS < 18 (py-ios-device)
+ * and iOS 18 and above (appium-ios-remotexpc MobileConfigService).
+ */
+export declare class CertificateClient {
+    private readonly service;
+    private readonly remoteXPCConnection?;
+    private readonly log;
+    private constructor();
+    /**
+     * Create a certificate client for device
+     *
+     * @param udid - Device UDID
+     * @param log - Appium logger instance
+     * @param useRemoteXPC - Whether to use remotexpc (use isIos18OrNewer(opts) to determine)
+     * @returns Certificate client instance
+     */
+    static create(udid: string, log: AppiumLogger, useRemoteXPC: boolean): Promise<CertificateClient>;
+    /**
+     * Install a certificate profile
+     *
+     * @param options - Installation options containing the certificate payload
+     */
+    installCertificate(options: InstallCertificateOptions): Promise<void>;
+    /**
+     * Remove a certificate profile by name
+     *
+     * @param name - Name of the profile to remove
+     * @returns Status message ('Acknowledged' for RemoteXPC, or pyidevice output)
+     */
+    removeCertificate(name: string): Promise<string>;
+    /**
+     * List installed certificate profiles
+     *
+     * @returns List of installed certificates
+     */
+    listCertificates(): Promise<CertificateList>;
+    /**
+     * Close the certificate service connection and remoteXPC connection if present
+     */
+    close(): Promise<void>;
+    /**
+     * Check if this client is using RemoteXPC
+     */
+    private get isRemoteXPC();
+    /**
+     * Helper to safely execute remoteXPC operations with connection cleanup
+     * @param operation - Async operation that returns service and connection
+     * @param log - Logger instance
+     * @returns CertificateClient on success, null on failure
+     */
+    private static withRemoteXpcConnection;
+    /**
+     * Get service as RemoteXPC MobileConfigService
+     */
+    private get mobileConfigService();
+    /**
+     * Get service as Pyidevice client
+     */
+    private get pyideviceClient();
+}
+//# sourceMappingURL=certificate-client.d.ts.map

package/build/lib/device/certificate-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certificate-client.d.ts","sourceRoot":"","sources":["../../../lib/device/certificate-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,YAAY,EAAC,MAAM,eAAe,CAAC;AAGhD,OAAO,KAAK,EAAC,eAAe,EAAC,MAAM,mBAAmB,CAAC;AAMvD;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;GAMG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA2C;IACnE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAsB;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,OAAO;IAYP;;;;;;;OAOG;WACU,MAAM,CACjB,IAAI,EAAE,MAAM,EACZ,GAAG,EAAE,YAAY,EACjB,YAAY,EAAE,OAAO,GACpB,OAAO,CAAC,iBAAiB,CAAC;IAwB7B;;;;OAIG;IACG,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3E;;;;;OAKG;IACG,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAStD;;;;OAIG;IACG,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC;IAQlD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAe5B;;OAEG;IACH,OAAO,KAAK,WAAW,GAEtB;IAED;;;;;OAKG;mBACkB,uBAAuB;IA6B5C;;OAEG;IACH,OAAO,KAAK,mBAAmB,GAE9B;IAED;;OAEG;IACH,OAAO,KAAK,eAAe,GAE1B;CAGF"}

package/build/lib/device/certificate-client.js

@@ -0,0 +1,163 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CertificateClient = void 0;
+const py_ios_device_client_1 = require("./clients/py-ios-device-client");
+const remotexpc_utils_1 = require("./remotexpc-utils");
+/**
+ * Unified Certificate Client
+ *
+ * Provides a unified interface for certificate operations on iOS devices,
+ * automatically handling the differences between iOS < 18 (py-ios-device)
+ * and iOS 18 and above (appium-ios-remotexpc MobileConfigService).
+ */
+class CertificateClient {
+    service;
+    remoteXPCConnection;
+    log;
+    constructor(service, log, remoteXPCConnection) {
+        this.service = service;
+        this.log = log;
+        this.remoteXPCConnection = remoteXPCConnection;
+    }
+    //#region Public Methods
+    /**
+     * Create a certificate client for device
+     *
+     * @param udid - Device UDID
+     * @param log - Appium logger instance
+     * @param useRemoteXPC - Whether to use remotexpc (use isIos18OrNewer(opts) to determine)
+     * @returns Certificate client instance
+     */
+    static async create(udid, log, useRemoteXPC) {
+        if (useRemoteXPC) {
+            const client = await CertificateClient.withRemoteXpcConnection(async () => {
+                const Services = await (0, remotexpc_utils_1.getRemoteXPCServices)();
+                const { mobileConfigService, remoteXPC } = await Services.startMobileConfigService(udid);
+                return {
+                    service: mobileConfigService,
+                    connection: remoteXPC,
+                };
+            }, log);
+            if (client) {
+                return client;
+            }
+        }
+        // Fallback to py-ios-device
+        const pyideviceClient = new py_ios_device_client_1.Pyidevice({
+            udid,
+            log,
+        });
+        await pyideviceClient.assertExists(true);
+        return new CertificateClient(pyideviceClient, log);
+    }
+    /**
+     * Install a certificate profile
+     *
+     * @param options - Installation options containing the certificate payload
+     */
+    async installCertificate(options) {
+        const { payload } = options;
+        if (this.isRemoteXPC) {
+            await this.mobileConfigService.installProfileFromBuffer(payload);
+        }
+        else {
+            await this.pyideviceClient.installProfile({ payload });
+        }
+    }
+    /**
+     * Remove a certificate profile by name
+     *
+     * @param name - Name of the profile to remove
+     * @returns Status message ('Acknowledged' for RemoteXPC, or pyidevice output)
+     */
+    async removeCertificate(name) {
+        if (this.isRemoteXPC) {
+            await this.mobileConfigService.removeProfile(name);
+            return 'Acknowledged';
+        }
+        else {
+            return await this.pyideviceClient.removeProfile(name);
+        }
+    }
+    /**
+     * List installed certificate profiles
+     *
+     * @returns List of installed certificates
+     */
+    async listCertificates() {
+        if (this.isRemoteXPC) {
+            return await this.mobileConfigService.getProfileList();
+        }
+        else {
+            return await this.pyideviceClient.listProfiles();
+        }
+    }
+    /**
+     * Close the certificate service connection and remoteXPC connection if present
+     */
+    async close() {
+        if (this.remoteXPCConnection) {
+            try {
+                this.log.debug(`Closing remoteXPC connection`);
+                await this.remoteXPCConnection.close();
+            }
+            catch (err) {
+                this.log.debug(`Error closing remoteXPC connection: ${err.message}`);
+            }
+        }
+    }
+    //#endregion
+    //#region Private Methods
+    /**
+     * Check if this client is using RemoteXPC
+     */
+    get isRemoteXPC() {
+        return !!this.remoteXPCConnection;
+    }
+    /**
+     * Helper to safely execute remoteXPC operations with connection cleanup
+     * @param operation - Async operation that returns service and connection
+     * @param log - Logger instance
+     * @returns CertificateClient on success, null on failure
+     */
+    static async withRemoteXpcConnection(operation, log) {
+        let remoteXPCConnection;
+        let succeeded = false;
+        try {
+            const { service, connection } = await operation();
+            remoteXPCConnection = connection;
+            const client = new CertificateClient(service, log, remoteXPCConnection);
+            succeeded = true;
+            return client;
+        }
+        catch (err) {
+            log.error(`Failed to create certificate client via RemoteXPC: ${err.message}, falling back to py-ios-device`);
+            return null;
+        }
+        finally {
+            // Only close connection if we failed (if succeeded, the client owns it)
+            if (remoteXPCConnection && !succeeded) {
+                try {
+                    await remoteXPCConnection.close();
+                }
+                catch {
+                    // Ignore cleanup errors
+                }
+            }
+        }
+    }
+    /**
+     * Get service as RemoteXPC MobileConfigService
+     */
+    get mobileConfigService() {
+        return this.service;
+    }
+    /**
+     * Get service as Pyidevice client
+     */
+    get pyideviceClient() {
+        return this.service;
+    }
+}
+exports.CertificateClient = CertificateClient;
+//# sourceMappingURL=certificate-client.js.map