feat(corellium): CORE-5555 - add corellium getInstance

src/corellium.js

@@ -467,6 +467,36 @@ class Corellium {
       method: 'DELETE'
     })
   }
+
+  /**
+   * Attempts to retrieve Instance by iterating through all projects until the instance is found.
+   *
+   * @param {string} instanceId
+   * @returns {Promise<Instance>}
+   * @example
+   * await corellium.instance('aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa')
+   */
+  async getInstance (instanceId) {
+    let lastError
+    const projects = await this.projects()
+    for (const project of projects) {
+      try {
+        const instance = await project.getInstance(instanceId)
+        if (instance.info.state !== 'on') {
+          throw new Error('The instance is not turned on')
+        }
+        return instance
+      } catch (err) {
+        if (!(err instanceof CorelliumError)) {
+          throw err
+        } else {
+          lastError = err
+        }
+      }
+    }
+
+    throw lastError || new Error(`Could not retrieve instance!  instanceId=${instanceId}`)
+  }
 }
 
 module.exports = {

test/integration-tests.js

@@ -178,6 +178,13 @@ describe('Corellium API', function () {
       assert(roles, 'Roles should not be undefined, even if there have been no roles')
     })
 
+    it('can get instance', async function () {
+      const instance = instanceMap.get(INSTANCE_VERSIONS[0])
+      await instance.waitForState('on')
+      const foundInstance = await corellium.getInstance(instance.id)
+      assert(foundInstance.id === instance.id)
+    })
+
     // Not visible to cloud users with one project:
     it('can add and remove keys', async function () {
       const keyInfo = await project