vivekrajr/now-client

A JavaScript wrapper for the Now Instant API

now client

The official JavaScript client for interacting with the now instant API (please note that this API only allows you to send strings, it doesn't support streaming - but binary files can be encoded as base64 strings).

Usage

Firstly, install the package using npm:

npm install --save now-client

Next, load it:

const NowClient = require('now-client')

Then initialize it:

• <token> holds your token, which can obtained here (optional, will read from ~/.now.json if not defined - you can also define it using the NOW_TOKEN environment variable)
• <team> specifies the ID of the team to which the actions should apply (optional)

const now = new NowClient(<token>, <team>)

And finally, you can use its methods to retrieve data:

await now.getDeployments()

API Reference

Kind: global class

• Now
  • new Now([token])
  • .getDeployments([callback]) ⇒ Promise
  • .getDeployment(id, [callback]) ⇒ Promise
  • .createDeployment(body, [callback]) ⇒ Promise
  • .deleteDeployment(id, [callback]) ⇒ Promise
  • .getFiles(id, [callback]) ⇒ Promise
  • .getFile(id, fileId, [callback]) ⇒ Promise
  • .getDomains([callback]) ⇒ Promise
  • .addDomain(domain, [callback]) ⇒ Promise
  • .deleteDomain(name, [callback]) ⇒ Promise
  • .getCertificates([cn], [callback]) ⇒ Promise
  • .createCertificate(cn, [callback]) ⇒ Promise
  • .renewCertificate(cn, [callback]) ⇒ Promise
  • .replaceCertificate(cn, cert, key, [ca], [callback]) ⇒ Promise
  • .deleteCertificate(cn, [callback]) ⇒ Promise
  • .getAliases([id OR callback], [callback]) ⇒ Promise
  • .createAlias(id, alias, [callback]) ⇒ Promise
  • .deleteAlias(id, [callback]) ⇒ Promise
  • .getSecrets([id OR callback], [callback]) ⇒ Promise
  • .createSecret(name, value, [callback]) ⇒ Promise
  • .renameSecret(id, name, [callback]) ⇒ Promise
  • .deleteSecret(id, [callback]) ⇒ Promise

new Now([token])

Initializes the API. Looks for token in ~/.now.json if none is provided.

Param	Type	Description
[token]	String	Your now API token.

now.getDeployments([callback]) ⇒ Promise

Returns an array with all deployments.

Kind: instance method of Now
See: https://zeit.co/api#list-endpoint

Param	Type	Description
[callback]	function	Callback will be called with (err, deployments)

now.getDeployment(id, [callback]) ⇒ Promise

Returns an object with deployment data.

Kind: instance method of Now
See: https://zeit.co/api#get-endpoint

Param	Type	Description
id	String	ID of deployment
[callback]	function	Callback will be called with (err, deployment)

now.createDeployment(body, [callback]) ⇒ Promise

Creates a new deployment and returns its data.

Kind: instance method of Now
See: https://zeit.co/api#instant-endpoint

Param	Type	Description
body	Object	The keys should represent a file path, with their respective values containing the file contents.
[callback]	function	Callback will be called with (err, deployment)

now.deleteDeployment(id, [callback]) ⇒ Promise

Deletes a deployment and returns its data.

Kind: instance method of Now
See: https://zeit.co/api#rm-endpoint

Param	Type	Description
id	String	ID of deployment
[callback]	function	Callback will be called with (err, deployment)

now.getFiles(id, [callback]) ⇒ Promise

Returns an array with the file structure.

Kind: instance method of Now
See: https://zeit.co/api#file-structure-endpoint

Param	Type	Description
id	String	ID of deployment
[callback]	function	Callback will be called with (err, fileStructure)

now.getFile(id, fileId, [callback]) ⇒ Promise

Returns the content of a file either as string or object, depending on the filetype.

Kind: instance method of Now
See: https://zeit.co/api#file--endpoint

Param	Type	Description
id	String	ID of deployment
fileId	String	ID of the file
[callback]	function	Callback will be called with (err, fileContent)

now.getDomains([callback])] ⇒ Promise

Returns an array with all domain names and related aliases.

Kind: instance method of Now See: https://zeit.co/api#get-domains

Param	Type	Description
[callback]	function	Callback will be called with (err, domains)

now.addDomain(domain, [callback])] ⇒ Promise

Adds a new domain and returns its data.

Kind: instance method of Now See: https://zeit.co/api#post.domains

Param	Type	Description
domain	object	An object containing a string name and a boolean isExternalDNS
[callback]	function	Callback will be called with (err)

now.deleteDomain(name, [callback])] ⇒ Promise

Deletes a domain name.

Kind: instance method of Now See: https://zeit.co/api#delete-domains

Param	Type	Description
name	String	Domain name
[callback]	function	Callback will be called with (err)

now.getDomainRecords(domain, [callback])] ⇒ Promise

Returns an array with all DNS records configured for a domain name.

Kind: instance method of Now See: https://zeit.co/api#get-domain-records

Param	Type	Description
name	String	Domain name
[callback]	function	Callback will be called with (err, domains)

now.addDomainRecord(domain, recordData, [callback])] ⇒ Promise

Adds a new DNS record for a domain.

Kind: instance method of Now See: https://zeit.co/api#post-domain-records

Param	Type	Description
domain	String	Domain name
recordData	object	An object containing a description of the new record according to the documentation.
[callback]	function	Callback will be called with (err)

now.deleteDomainRecord(name, recordId, [callback])] ⇒ Promise

Deletes a DNS record associated with a domain.

Kind: instance method of Now See: https://zeit.co/api#delete-domain-records

Param	Type	Description
domain	String	Domain name
recordId	String	Record ID
[callback]	function	Callback will be called with (err)

now.getCertificates([cn], [callback])] ⇒ Promise

Returns an array of all certificates.

Kind: instance method of Now See: https://zeit.co/api#get-certs

Param	Type	Description
[cn]	String	Common Name
[callback]	function	Callback will be called with (err, certs)

now.createCertificate(cn, [callback])] ⇒ Promise

Creates a new certificate for a domain registered to the user.

Kind: instance method of Now See: https://zeit.co/api#post-certs

Param	Type	Description
cn	String	Common Name
[callback]	function	Callback will be called with (err)

now.renewCertificate(cn, [callback])] ⇒ Promise

Renews an existing certificate.

Kind: instance method of Now See: https://zeit.co/api#post-certs

Param	Type	Description
cn	String	Common Name
[callback]	function	Callback will be called with (err)

now.replaceCertificate(cn, cert, key, [ca], [callback])] ⇒ Promise

Replace an existing certificate.

Kind: instance method of Now See: https://zeit.co/api#put-certs

Param	Type	Description
cn	String	Common Name
cert	String	X.509 certificate
key	String	Private key for the certificate
ca	String	CA certificate chain
[callback]	function	Callback will be called with (err, created)

now.deleteCertificate(cn, [callback])] ⇒ Promise

Deletes a certificate.

Kind: instance method of Now See: https://zeit.co/api#delete-certs

Param	Type	Description
cn	String	Common Name
[callback]	function	Callback will be called with (err)

now.getAliases([id OR callback], [callback]) ⇒ Promise

Returns an array with all aliases.

Kind: instance method of Now
See: https://zeit.co/api#user-aliases

Param	Type	Description
[id OR callback]	String | function	ID of deployment or callback
[callback]	function	Callback will be called with (err, aliases)

now.createAlias(id, alias, [callback]) ⇒ Promise

Creates an alias for the given deployment.

Kind: instance method of Now
See: https://zeit.co/api#create-alias

Param	Type	Description
id	String	ID of deployment
alias	String	Hostname or custom url for the alias
[callback]	function	Callback will be called with (err, data)

now.deleteAlias(id, [callback]) ⇒ Promise

Deletes an alias and returns a status.

Kind: instance method of Now
See: https://zeit.co/api#delete-user-aliases

Param	Type	Description
id	String	ID of alias
[callback]	function	Callback will be called with (err, status)

now.getSecrets([id OR callback], [callback]) ⇒ Promise

Returns an array with all secrets.

Kind: instance method of Now
See: https://zeit.co/api#get-now-secrets

Param	Type	Description
[id OR callback]	String | function	ID of deployment or callback
[callback]	function	Callback will be called with (err, secrets)

now.createSecret(name, value, [callback]) ⇒ Promise

Creates a secret and returns its ID.

Kind: instance method of Now
See: https://zeit.co/api#post-now-secrets

Param	Type	Description
name	String	name for the secret
value	String	value for the secret
[callback]	function	Callback will be called with (err, data)

now.renameSecret(id, name, [callback]) ⇒ Promise

Changes the name of the given secret and returns its ID and name.

Kind: instance method of Now
See: https://zeit.co/api#patch-now-secrets

Param	Type	Description
id	String	id or name of the secret
name	String	new name for the secret
[callback]	function	Callback will be called with (err, data)

now.deleteSecret(id, [callback]) ⇒ Promise

Deletes a secret and returns its ID.

Kind: instance method of Now
See: https://zeit.co/api#delete-now-secrets

Param	Type	Description
id	String	ID or name of the secret
[callback]	function	Callback will be called with (err, status)