Suborbital Compute JavaScript SDK

This SDK provides an easy way to interact with the Suborbital Compute API from JavaScript or TypeScript.

Installation

Install via yarn:

yarn add @suborbital/compute

or npm:

npm install @suborbital/compute

Usage

Start by instantiating the client with your environment token:

import { Suborbital } from "@suborbital/compute";

const suborbital = new Suborbital(process.env.SCC_ENV_TOKEN);

The URIs for each of the APIs can be configured, if different than the defaults:

import { Suborbital } from "@suborbital/compute";

const config = {
  adminUri: "https://acme.co:8081",
  execUri: "https://acme.co:8080",
  builderUri: "https://acme.co/builder",
};

const suborbital = new Suborbital(process.env.SCC_ENV_TOKEN, config);

A configuration for a locally-deployed Suborbital Compute Network is also available:

import { Suborbital, localUriConfig } from "@suborbital/compute";

const suborbital = new Suborbital(process.env.SCC_ENV_TOKEN, localUriConfig);

Then access endpoints on their respective sub-clients:

async function runFunction() {
  const result = await suborbital.exec.run({
    environment: "com.acmeco",
    userId: "1234",
    namespace: "default",
    fnName: "foo",
    version: "v1.0.0",
  });

  console.log("Function output:", result);
}