@corellium/corellium-cli 1.2.7 → 1.2.8

package/coverage/cobertura-coverage.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" ?>
 <!DOCTYPE coverage SYSTEM "http://cobertura.sourceforge.net/xml/coverage-04.dtd">
-<coverage lines-valid="0" lines-covered="0" line-rate="NaN" branches-valid="0" branches-covered="0" branch-rate="NaN" timestamp="1715716510523" complexity="0" version="0.1">
+<coverage lines-valid="0" lines-covered="0" line-rate="NaN" branches-valid="0" branches-covered="0" branch-rate="NaN" timestamp="1715897730108" complexity="0" version="0.1">
   <sources>
     <source>/builds/middleware/corellium-cli</source>
   </sources>

package/coverage/lcov-report/index.html

@@ -86,7 +86,7 @@
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2024-05-14T19:55:10.530Z
+                at 2024-05-16T22:15:30.115Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@corellium/corellium-cli",
-  "version": "1.2.7",
+  "version": "1.2.8",
   "description": "Corellium CLI Tool",
   "scripts": {
     "corellium": "node index.js",
@@ -27,7 +27,7 @@
   ],
   "dependencies": {
     "@corellium/client-api": "^0.1.0",
-    "@corellium/corellium-api": "^1.7.3",
+    "@corellium/corellium-api": "^1.7.7",
     "axios": "^0.27.2",
     "chalk": "^4.1.2",
     "cli-progress": "^3.12.0",

package/src/clients/Agent.js

@@ -6,8 +6,15 @@ const { progressBar } = require('../progress')
 const { getCorelliumApi } = require('../corellium-api')
 
 /**
- * @typedef {object} AppsResult
- * @property {Array<{object}>} apps
+ * @typedef {object} App
+ * @property {Array<any>} tags
+ * @property {boolean} running
+ * @property {string} [icon]
+ * @property {number} diskUsage
+ * @property {number} date
+ * @property {string} applicationType
+ * @property {string} name
+ * @property {string} bundleID
  */
 
 /**
@@ -30,14 +37,19 @@ class AgentCLI extends Client {
 
   /**
    * List apps on device
-   * @returns {Promise<Array<{apps: Array<{object}>}>>}
+   * @returns {Promise<Array<App>>}
    */
-  listApps = async (options) => {
+  listApps = async (options = { loadIcons: false }) => {
     const { loadIcons } = options
     const response = (await this._fetch('GET', `${this.agentBasePath()}/app/apps?loadIcons=${loadIcons ? 1 : 0}`, {}))
     return response ? response.apps : []
   }
 
+  /**
+   * Install an app on device
+   * @param {string} app - path to app
+   * @returns {Promise<void>}
+   */
   installApp = async (app) => {
     // get app info
     const filePath = resolve(app)
@@ -47,6 +59,7 @@ class AgentCLI extends Client {
     const corellium = await getCorelliumApi()
     const instance = await corellium.getInstance(this.instance)
     const agent = await instance.agent()
+    await agent.ready()
 
     // configure upload bar for user
     const uploadBar = progressBar()
@@ -64,6 +77,23 @@ class AgentCLI extends Client {
     // cleanup
     await agent.disconnect()
   };
+
+  /**
+   * Open an application on a device
+   * @param {string} bundleId - Application Bundle ID
+   * @returns {Promise<void>}
+   */
+  openApp = async (bundleId) => {
+    // get agent
+    const corellium = await getCorelliumApi()
+    const instance = await corellium.getInstance(this.instance)
+    const agent = await instance.agent()
+    await agent.ready()
+    await agent.openApp(bundleId)
+
+    // cleanup
+    await agent.disconnect()
+  }
 }
 
 module.exports = AgentCLI

package/src/commands/instances/apps/index.js

@@ -3,35 +3,42 @@ const { displayTable } = require('../../../table')
 const { validateNonEmpty } = require('../../../utils')
 const { handleError } = require('../../../error')
 const InstallCommand = require('./install')
+const OpenCommand = require('./open')
 
 async function builder (yargs) {
   yargs.option('verbose', {
     alias: 'v',
     type: 'boolean',
     describe: 'Console will receive verbose error output'
-  }).option('project', {
-    type: 'input',
-    describe: 'Project ID',
-    demandOption: true,
-    string: true,
-    validateNonEmpty
-  }).option('instance', {
-    type: 'input',
-    describe: 'Instance ID',
-    demandOption: true,
-    string: true,
-    validateNonEmpty
-  }).option('load-icons', {
-    type: 'input',
-    describe: 'Toggle loading of icons',
-    demandOption: false,
-    boolean: true
-  }).option('format', {
-    type: 'input',
-    describe: 'Output format (default is json) e.g. table',
-    string: true,
-    choices: ['table', 'json', 'csv']
-  }).command(InstallCommand)
+  })
+    .option('project', {
+      type: 'input',
+      describe: 'Project ID',
+      demandOption: true,
+      string: true,
+      validateNonEmpty
+    })
+    .option('instance', {
+      type: 'input',
+      describe: 'Instance ID',
+      demandOption: true,
+      string: true,
+      validateNonEmpty
+    })
+    .option('load-icons', {
+      type: 'input',
+      describe: 'Toggle loading of icons',
+      demandOption: false,
+      boolean: true
+    })
+    .option('format', {
+      type: 'input',
+      describe: 'Output format (default is json) e.g. table',
+      string: true,
+      choices: ['table', 'json', 'csv']
+    })
+    .command(InstallCommand)
+    .command(OpenCommand)
 }
 
 async function handler (argv) {

package/src/commands/instances/apps/open.js

@@ -0,0 +1,37 @@
+const AgentCLI = require('../../../clients/Agent')
+const { validateNonEmpty } = require('../../../utils')
+const { handleError } = require('../../../error')
+const log = require('../../../logging')
+
+async function builder (yargs) {
+  yargs.option('bundle', {
+    alias: 'b',
+    type: 'string',
+    demandOption: true,
+    describe: 'application bundle id',
+    validateNonEmpty
+  })
+}
+
+async function handler (argv) {
+  try {
+    const { bundle: bundleId } = argv
+    const agent = new AgentCLI(argv)
+    log.info('Opening app...')
+    const apps = await agent.listApps()
+    if (!apps.filter(app => app.bundleID === bundleId).length) {
+      throw new Error('App not installed.')
+    }
+    await agent.openApp(bundleId)
+    log.info('App opened.')
+  } catch (err) {
+    handleError(err, 'Open app failed', argv.verbose)
+  }
+}
+
+module.exports = {
+  builder,
+  handler,
+  command: 'open',
+  describe: 'Open app on device instance'
+}