Bosca / Scripts

Script Library

Versioned and governed

A script isn't a loose file on a server. It's a first-class record with a stable key, a version, and permissions — organized, controlled, and optionally kept in Git, like the rest of your code.

A first-class record

More than a blob of source

Each script carries a stable key you reference it by, a type that decides how it runs, a source, a version, and flags for whether it's enabled and whether it's public. Its input and output can even be described up front.

  • A stable key names the script; the source can change beneath it.
  • Enabled and public flags control whether and how it can run.
  • Optional input and output schemas describe what it takes and returns.
script · welcome-email
typeTRIGGER
version7
enabledtrue
publicfalse

Versioning

Every edit counts

Change a script's source and its version bumps. That version is what the compile cache keys on, so an edit quietly invalidates the old compiled copy and the next run picks up the new one — no stale bytecode lingering around.

  • The version increments on each change to the source.
  • A new version invalidates the previous compiled result.
  • The next run compiles fresh, then caches again.
versions
v7current · cached
v6superseded
v5superseded

Sourced from Git

Keep scripts in version control

A script can live in a repo. Attach it to a file in a script project, and a push updates its source automatically — the repo becomes the source of truth, and the next push overwrites whatever's in the platform.

  • Attach a script to a file in a Git script project.
  • A push syncs the file's contents into the script.
  • The repo wins — a push overwrites the in-platform source.
git · ops-scripts
scripts/welcome.bosca.kts
source synced from Git

Permissions

Who can see, edit, and run

Scripts use the same group-based permissions as everything else on the platform, so access to a powerful script is as controlled as access to the data it touches.

View

See the script and its source.

Edit

Change the source and settings.

Execute

Run it, or call its endpoint.

Manage

Grant access and control the script.

Keep exploring

More on Scripts