js

dbsp JavaScript runtime

js/ contains the dbsp CLI, a small JavaScript scripting environment for building and testing DBSP circuits from the command line.

The maintained documentation lives under doc/. This README is only a short module-level guide.

Build And Run

From this module:

make build

This builds bin/dbsp.

Run one of the bundled examples:

./bin/dbsp examples/join_project.js
./bin/dbsp -v examples/observer-demo.js

Script arguments

The CLI forwards positional arguments after the script path into JavaScript as process.argv.

./bin/dbsp examples/gwapi/index.js test gwclass

In JS, this is visible as:

• process.argv[0]: dbsp binary path
• process.argv[1]: script path
• process.argv[2...]: user script arguments

Vendored JS modules

The runtime supports loading vendored JavaScript modules from:

• js/stdlib/vendor

The minimist package is vendored and available via:

const minimist = require("minimist");

An alias is also provided:

const minimist = require("@dbsp/minimist");