refactor: 🎨 adds marketplace in collection and adds missing functions [cs-38336]

Author: nadeem-cs

lib/app/index.js

@@ -1,10 +1,11 @@
 import cloneDeep from 'lodash/cloneDeep'
 import error from '../core/contentstackError'
-import { create, deleteEntity, fetch, fetchAll, update } from '../entity'
+import { create, deleteEntity, fetch, update } from '../entity'
 import { Authorization } from './authorization'
 import { Hosting } from './hosting'
-import { Installation } from './installation'
+import { Installation, InstallationCollection } from './installation'
 import { Oauth } from './oauth'
+import ContentstackCollection from '../contentstackCollection'
 
 export function App (http, data) {
   http.defaults.versioningStrategy = undefined
@@ -26,25 +27,25 @@ export function App (http, data) {
       this.urlPath = `/manifests/${this.uid}`
 
       /**
-       * @description The update manifest call is used to update the app details such as name, description, icon, and so on.
-       * @memberof App
-       * @func update
-       * @returns {Promise<App>}
-       *
-       * @example
-       * import * as contentstack from '@contentstack/management'
-       * const client = contentstack.client({ authtoken: 'TOKEN'})
-       * const updateApp = {
-       *  name: 'APP_NAME',
-       *  description: 'APP_DESCRIPTION',
-       *  target_type: 'stack'/'organization',
-       * }
-       * const app = client.organization('organization_uid').app('manifest_uid')
-       * app = Object.assign(app, updateApp)
-       * app.update()
-       * .then((app) => console.log(app))
-       *
-       */
+         * @description The update manifest call is used to update the app details such as name, description, icon, and so on.
+         * @memberof App
+         * @func update
+         * @returns {Promise<App>}
+         *
+         * @example
+         * import * as contentstack from '@contentstack/management'
+         * const client = contentstack.client({ authtoken: 'TOKEN'})
+         * const updateApp = {
+         *  name: 'APP_NAME',
+         *  description: 'APP_DESCRIPTION',
+         *  target_type: 'stack'/'organization',
+         * }
+         * const app = client.organization('organization_uid').app('manifest_uid')
+         * app = Object.assign(app, updateApp)
+         * app.update()
+         * .then((app) => console.log(app))
+         *
+         */
       this.update = update(http, undefined, this.params)
 
       /**
@@ -142,26 +143,34 @@ export function App (http, data) {
       }
 
       /**
-       * @description The Installation will allow you to fetch, update and delete of the app installation.
+       * @description The upgrade call is used to upgrade the installation of an app
        * @memberof App
-       * @func installation
-       * @param {String} uid Installation uid
-       * @returns Installation
-       *
-       * @example
-       * import * as contentstack from '@contentstack/management'
-       * const client = contentstack.client({ authtoken: 'TOKEN'})
-       * client.organization('organization_uid').app('manifest_uid').installation().findAll()
-       * .then((installations) => console.log(installations))
+       * @func upgrade
+       * @param {String} param.targetType - The target on which app needs to be installed, stack or ogranization.
+       * @param {String} param.targetUid - The uid of the target, on which the app will be installed
+       * @returns Promise<Installation>
        *
        * @example
        * import * as contentstack from '@contentstack/management'
        * const client = contentstack.client({ authtoken: 'TOKEN'})
-       * client.organization('organization_uid').app('manifest_uid').installation('installation_uid').fetch()
+       * client.organization('organization_uid').app('manifest_uid').install({ targetUid: 'STACK_API_KEY', targetType: 'stack' })
        * .then((installation) => console.log(installation))
        */
-      this.installation = (uid = null) => {
-        return new Installation(http, uid ? { data: { uid } } : { app_uid: this.uid }, this.params)
+      this.upgrade = async ({ targetUid, targetType }) => {
+        try {
+          const headers = {
+            headers: { ...cloneDeep(this.params) }
+          } || {}
+
+          const response = await http.put(`${this.urlPath}/reinstall`, { target_type: targetType, target_uid: targetUid }, headers)
+          if (response.data) {
+            return new Installation(http, response.data, this.params) || {}
+          } else {
+            throw error(response)
+          }
+        } catch (err) {
+          throw error(err)
+        }
       }
       /**
         * @description  The GET app requests of an app call is used to retrieve all requests of an app.
@@ -266,9 +275,20 @@ export function App (http, data) {
        * .then((collection) => console.log(collection))
        *
        */
-      this.listInstallations = () => {
-        this.urlPath = `manifests/${data.app_uid}/installations`
-        return fetchAll(http, InstallationCollection, this.params)
+      this.listInstallations = async () => {
+        try {
+          const headers = {
+            headers: { ...cloneDeep(this.params), ...cloneDeep(this.headers) }
+          }
+          const response = await http.get(`manifests/${this.uid}/installations`, headers)
+          if (response.data) {
+            return new ContentstackCollection(response, http, this.stackHeaders, InstallationCollection)
+          } else {
+            throw error(response)
+          }
+        } catch (err) {
+          throw error(err)
+        }
       }
     } else {
       /**
@@ -301,69 +321,7 @@ export function App (http, data) {
        *
        */
       this.create = create({ http, params: this.params })
-
-      /**
-       * @description The get all manifest call is used to fetch all the apps in your Contentstack organization.
-       * @memberof App
-       * @func findAll
-       * @returns {Promise<ContentstackCollection<App>>}
-       *
-       * @example
-       * import * as contentstack from '@contentstack/management'
-       * const client = contentstack.client({ authtoken: 'TOKEN'})
-       *
-       * client.organization('organization_uid').app().findAll()
-       * .then((collection) => console.log(collection))
-       *
-       */
-      this.findAll = fetchAll(http, AppCollection, this.params)
-
-      /**
-       * @description To get the apps list of authorized apps for the particular organization
-       * @memberof Organization
-       * @func authorizedApps
-       * @param {number} skip - Offset for skipping content in the response.
-       * @param {number} limit - Limit on api response to provide content in list.
-       * @example
-       * import * as contentstack from '@contentstack/management'
-       * const client = contentstack.client()
-       *
-       * client.organization('organization_uid').authorizedApps({ skip: 10 })
-       * .then((roles) => console.log(roles))
-       *
-       */
-      this.findAllAuthorized = async (param = {}) => {
-        const headers = {
-          headers: { ...cloneDeep(this.params) }
-        }
-
-        headers.params = { ...param }
-        try {
-          const response = await http.get(`/authorized-apps`, headers)
-          if (response.data) {
-            return response.data
-          } else {
-            return error(response)
-          }
-        } catch (err) {
-          return error(err)
-        }
-      }
     }
   }
   return this
 }
-
-export function AppCollection (http, data) {
-  const obj = cloneDeep(data.data) || []
-  return obj.map((appData) => {
-    return new App(http, { data: appData })
-  })
-}
-
-function InstallationCollection (http, data) {
-  const obj = cloneDeep(data.data) || []
-  return obj.map((installationData) => {
-    return new Installation(http, { data: installationData })
-  })
-}