@small-tech/auto-encrypt/lib/acme-requests/CertificateRequest.js

Automatically provisions and renews Let’s Encrypt TLS certificates on Node.js https servers (including Kitten, Polka, Express.js, etc.)

////////////////////////////////////////////////////////////////////////////////
//
// CertificateRequest
//
// Requests download of the TLS certificate for a validated order.
//
// See RFC 8555 § 7.4.2 (Downloading the Certificate).
// The certificate type is application/pem-certificate-chain (RFC 8555 § 9.1).
//
// Copyright © 2020 Aral Balkan, Small Technology Foundation.
// License: AGPLv3 or later.
//
////////////////////////////////////////////////////////////////////////////////

import AcmeRequest from '../AcmeRequest.js'
import Throws from '../util/Throws.js'

const throws = new Throws()

export default class CertificateRequest extends AcmeRequest {
  async execute (certificateUrl = throws.ifMissing()) {
    // This is a POST-as-GET request so it doesn’t have a payload.
    // See RFC 8555 § 6.3 (GET and POST-as-GET requests).
    const noPayload = ""

    // Note: a 201 (Created) is returned if the account is new, a 200 (Success) is returned
    // ===== if an existing account is found. (RFC 8555 § 7.3 & 7.3.1).
    const response = await super.execute(
      /* command =                 */ '', // see URL, below.
      /* payload =                 */ noPayload,
      /* useKid =                  */ true,
      /* successCodes =            */ [200],
      /* url =                     */ certificateUrl,
      /* parseResponseBodyAsJSON = */ false
    )

    return response
  }
}