Skip to main content

Custom libraries

To continue to tailor your users' experience to your product, you can create a custom library with extensions and utilities designed specifically for your product. For example, your users will import library extensions from @acmeco/acmeco instead of @suborbital/suborbital, and you'll be able to export library extensions such as acmeco.getUsers versus the plain suborbital.httpGet.

We want to help! Creating custom templates and libraries are an important aspect of SE2, so send us an email and we'll help you make the most out of these abilities.

Setup​

We provide a base library for you to modify and publish to the language-specific package manager, which can then be included as a project dependency in a custom extension template.

If you haven't already, create a fork of the templates git repository. Once the repo has been forked into your company or personal account, you can begin editing the libraries in the library directory.

info

Custom libraries are currently only officially supported for AssemblyScript, with more coming soon.

The AssemblyScript library is located in library/assemblyscript. As your custom library will need to be published, you will need to give it a custom name. In library/assemblyscript/package.json, replace all instances of acmeco with your desired name. Add your custom library as a dependency in templates/assemblyscript/package.json.tmpl so your users' extensions can use it:

"dependencies": {
  "@assemblyscript/loader": "^0.19",
  "@acmeco/acmeco": "^0.1.0" // your library here
}

You can modify library/assemblyscript/assembly/index.ts to expose new utility extensions and/or remove existing ones. To learn more about the available APIs, check out the Runnable API docs.

Once this is done, publish your library to npm:

cd library/assemblyscript
npm publish --access public

Configuring SE2​

Since your custom library is listed as a dependency of the template project, it will be installed when your users' extensions are built for the first time.

In your SE2 installation, you will need to configure the SE2_TEMPLATES_REPO environment variable.

  • For a local deployment, edit docker-compose.yml to add SE2_TEMPLATES_REPO: to the builder with the value set to your fork (e.g. acmeco/templates)

  • For a cloud deployment, edit suborbital/se2-controlplane.yaml, and add the following to the builder container's environment:

    - name: SE2_TEMPLATES_REPO
      value: "{your fork}"

Apply the change by running:

kubectl apply -f .suborbital/