Platform SDK (deprecated)

Note: This package is deprecated in favor of @serverless/platform-client. It accepts only bug fixes

Functional SDK for the Serverless Platfrom.

Project Status

Contents

• Installation
• Functions
  • login
  • refreshToken
  • createAccessKey
  • archiveService
  • getServiceUrl
  • listTenants
  • createDeployment
  • updateDeployment
  • getApp
  • createApp

installation

npm i -s @serverless/platform-sdk

Functions

login

Opens a browser for the user to login, along with a running server awaiting auth data once the user logs in.

Parameters

None

Returns

Promise resolving to the following object:

• username - string - dashboard username
• accessToken - string - Auth0 access token
• idToken - string - Auth0 idToken
• refreshToken - string - Auth0 refreshToken
• expiresAt - string - epoch time at which the idToken expires

Example

1const { login } = require('@serverless/platform-sdk')
2
3const { username, accessToken, idToken, expiresAt } = await login()

---

refreshToken

Refreshes Auth0 idToken

Parameters

refresh token string

Returns

Promise resolving to the following object:

• id_token - string - new Auth0 id token
• access_token - string - new Auth0 access token
• expires_in - string - number of seconds until token expiration

Example

1const { refreshToken } = require('@serverless/platform-sdk')
2
3const { id_token, access_token, expires_in } = await refreshToken('some-refresh-token')

---

createAccessKey

Creates a platform access key for the authenticated user.

Parameters

Object

• username - string - dashboard username
• tenant - string - dashboard tenant
• idToken - string - Auth0 idToken
• title - string - title of the access key

Returns

Promise resolving to an accessKey string, that is the access key.

Example

1const { createAccessKey } = require('@serverless/platform-sdk')
2
3const data = {
4  username: 'eahefnawy',
5  tenant: 'eahefnawy',
6  idToken: 'abc',
7  title: 'Framework'
8}
9
10const accessKey = await createAccessKey(data)

---

archiveService

Archives a service in the platform.

Parameters

Object

• tenant - string - dashboard tenant
• accessKey - string - dashboard access key
• app - string - service app
• name - string - service name
• provider - string - provider name
• region - string - region name

Returns

None

Example

1const { archiveService } = require('@serverless/platform-sdk')
2
3const data = {
4  tenant: 'eahefnawy',
5  accessKey: 'abc',
6  app: 'my-app',
7  name: 'my-service',
8  provider: 'aws',
9  region: 'us-east-1'
10}
11
12await archiveService(data)

---

getServiceUrl

Constructs a service url based on passed-in data.

Parameters

Object

• tenant - string - dashboard tenant
• app - string - service app
• name - string - service name

Returns

The service url string.

Example

1const { getServiceUrl } = require('@serverless/platform-sdk')
2
3const data = {
4  tenant: 'eahefnawy',
5  app: 'my-app',
6  name: 'my-service'
7}
8
9const serviceUrl = getServiceUrl(data)

---

listTenants

Lists the tenants for a given username

Parameters

Object

• username - string - dashboard username
• idToken - string - auth0 user id token

Returns

Array of objects, each represents a single tenant data model.

Example

1const { listTenants } = require('@serverless/platform-sdk')
2
3const data = {
4  username: 'eahefnawy',
5  idToken: 'abc'
6}
7
8const tenants = await listTenants(data)

---

createDeploymnet

Creates a platform deployment

Parameters

Object

• tenant - string - dashboard tenant name
• app - string - app name
• serviceName - string - service name
• accessKey - string - dashboard access key
• files - object - files which should be stored in the Platforms deployment record

Returns

Object - Deployment model

Example

1const { createDeployment } = require('@serverless/platform-sdk')
2
3const data = {
4  tenant: 'eahefnawy',
5  app: 'my-app',
6  serviceName: 'my-service',
7  accessKey: 'abc',
8  files: {
9    'serverless-state.json': {
10      //...snip...
11    }
12  }
13}
14
15const { id } = await createDeployment(data)

---

updateDeployment

Updates a platform deployment

Parameters

Object

• tenant - string - dashboard tenant name
• app - string - app name
• serviceName - string - service name
• deploymentId - string - id of the previously created deployment
• status - string - status of the deployment to update
• accessKey - string - dashboard access key
• computedData - object - computed data the Platform needs to generate the state items

Returns

Object - Deployment model

Example

1const { updateDeployment } = require('@serverless/platform-sdk')
2
3const data = {
4  tenant: 'eahefnawy',
5  app: 'my-app',
6  serviceName: 'my-service',
7  deploymentId: 'abc',
8  status: 'failed',
9  accessKey: 'abc',
10  computedData: {
11    // ...snip...
12  }
13}
14
15const { id } = await updateDeployment(data)

---

getApp

Gets a platform app

Parameters

Object

• tenant - string - dashboard tenant name
• app - string - app name
• token - string - Auth0 id token

Returns

Object - App model

Example

1const { getApp } = require('@serverless/platform-sdk')
2
3const data = {
4  tenant: 'eahefnawy',
5  app: 'my-app',
6  token: 'abc'
7}
8
9const app = await getApp(data)

---

createApp

Creates a platform app

Parameters

Object

• tenant - string - dashboard tenant name
• app - string - app name
• token - string - Auth0 id token

Returns

Object - App model

Example

1const { createApp } = require('@serverless/platform-sdk')
2
3const data = {
4  tenant: 'eahefnawy',
5  app: 'my-app',
6  token: 'abc'
7}
8
9const app = await createApp(data)