# barista-core
For those getting started with Barista, see BaristaLabs/barista-cli
===
Overview
This is a continuation of the patterns defined in the (closed-source) Barista implementation built on .NET and SharePoint technologies.
In a nutshell, Barista acts as SaaS to build application-level services.
Once you've wrapped your head around that, another description might be that Barista aims to allow end-users to execute scripts in a sandbox while exposing business-level functionality that does not have access to system-level resources. These scripts are executed via a service.
By exposing this functionality to CMS and other controlled environments (SharePoint, etc) this allows end-users to develop business functionality that would previously require customizations to the CMS software (E.g. Farm-Level Deployments). Customizations to the CMS software are expensive in terms of time to develop, deploy and the potential of breaking changes when the CMS software is updated. In tighly-controlled environments, approval processes increase the latency between development and availability.
Barista scripts can be deployed and managed similarly to content within a CMS and allows for a layer of abstraction between the scripts and the platform.
The .NET implementation of Barista uses a JavaScript engine, Jurassic, that JIT compiles JS to .NET IL. While JS/ECMAScript has moved forward, Jurassic has not. Other libraries exist for .NET which allow scripts to be interpered or compiled and executed in a similar fashion (JINT/JavaScript.Net/NiL.JS...) however each suffers in its own way, either in performance, lack of full compatability, level of maintence required and so forth. While contributions back to Jurassic, contributions to another library, or a completely custom JS engine built in .NET can be developed, the LOE to do so is extremely high. With Node/V8, there exists a platform that is actively being developed and maintained and incorporaes the latest in ECMAScript standards and focuses on performance and efficency.
The challenge here is that Node takes a nice, sandboxed JavaScript environment in V8 (and now Chakra) and rips it wide open -- giving scripts the ability to access system resources (FS, processes, etc). The node implementation of Barista closes this sandbox back up to Barista scripts and exposes only functionality that manipulates resources in (end) user-land.
Some goals:
- Reimplement Barista using Node to allow for the latest in JS/ECMAScript standards to be used and to provide high levels of peformance while providing multi-platform support (now, not later).
- Barista executes each script in a seperate node process for isolation and fault-tolerance.
- Scripts are time and memory limited so they do not execute indefinitely or use all available system resources.
- Barista module system (similar nee identical to NPM) that allows modules to be installed and extend an otherwise basic level of functionality.
- Available modules (either custom or built-in) do not perform system level actions or grant access to system-level resources.
- Modules are available that perform actions familar to .NET developers and the .NET Implementation of Barista (EPPlus, SharePoint...)
- Modules even though installed, must be whitelisted on a case-by-case basis.
- Scripts can be interactively debugged remotely as an end-user.
Future Goals:
- Allow for remote sandbox processes to allow Barista to run in a clustered approach.
- Multi-tenancy to allow Barista to run as a PaaS on AWS/Azure.
Structure
| Repository | Description |
|---|---|
| barista-core | This repository contains the core barista capabilities that standup and manage sandbox instances, translate http requests to/from barista instances and translate the response back out, module system and so forth. |
| barista-fiddle | Contains a native-web IDE in which Barista scripts can be interactively developed; providing autocomplete, debugging, and other functionality common to development environments. |
| barista-scriptbox | Provides an implementation of a service in which scripts can be persisted. |
| barista-server | Acts as a headless-server for Barista; core, fiddle, scriptbox... |
| barista-cli | Barista command line tool to interact with barista, start and monitor services, etc. |
| barista-coldpress | Hosts Barista within an Electron process. |
Modules
TODO...