Storage

Omphalos allows for persistent storage, which is saved on the server in a per-bundle way. This is an open ended system that allows for any number of variables to be saved and persisted across sessions as well as shared between panels, graphics and extensions.

The API has a storage object that supports the following operations:

• setting the value
• getting the value
• deleting the variable
• notification of changes

The storage systems allows any value to be persisted, with the only restriction that it be JSON-encodable.

reserved names

Storage keys that start with __sys are reserved by Omphalos for system values; you should not use them in your own variables.

Skepsis

The above API allows for simple, granular access to variables. When a variable is used frequently in the code, a better option is often to use a Skepsis instead.

This is a simple object that wraps a particular variable; it’s .value property is always the most recent value, changing the value of this property automatically sends an update to peers.

If the value of the Skepsis is an object or array, the .update() method can be used to force an update, such as when there was a change to the inner object (a property change or adding a new element to an array).