The JavaScript Runtime

Lil’bots provides a built in JavaScript runtime for bots based on Deno. If you have ever worked with Node.js, Deno should feel very familiar. This document will cover the basics of building bots in JavaScript.

​

The script.mjs file & the main function

The entrypoint to your bot is the script.mjs file, as specified under the “main” property in the botspec.json file. When your bot is executed it will look for an exported main function in that file and call it.

The main function can be asyncrounous (to let you use await inside) and recieves the three following arguments:

• inputs (object) - the inputs passed to your bot by the user.
• params (object) - the parameters configured by the the user for your bot.
• accounts (array) - an array containing all the requested account credentials for your bot to use.

A basic main function will look like this:

export async function main(inputs, params, accounts) {
    // Your code here...
}

​

Installing dependencies and packages

You may use external packages when building your bots - all you need to do is simply to import these packages, and the lil’bots runtime will automatically install them for you. There are a few sources of packages you may install:

• deno.land (recommended) - fetching modules from denoland is the fastest way to get modules into your bot. Many NPM modules have a version hosted on denoland - so you may want to check there first whenever you need a module. Imports from denoland look like:

import OpenAI from "https://deno.land/x/[email protected]/mod.ts";

• esm.sh - many NPM modules are also stored on the esm.sh CDN for fast downloads. You may install any ESM module like so:

import Module from "https://esm.sh/PKG@SEMVER[/PATH]";

• NPM Modules - you can also use any NPM module in your code. Just import it with an NPM prefix:

import { emojify } from "npm:node-emoji";

You can also specify a specific version by using the @version tag:

import { emojify } from "npm:node-emoji@2";