const conn = spinalCore.connect("http://

644:password@127.0.0.1:8888/__myApp__");

This method establishes a connection with the hub. It returns an object containing the connection information, which will be used in the other API methods that communicate with the hub.

The string parameter has the following format:

protocol://userid:password@host:port/path

Explanation:

• protocol: the communication protocol used to communicate with the hub; currently only supporting "http"
• userid: a user id that has access to the data; beware that the user has the needed rights to manage the data (read more about it here)
• password: the password of the user
• host: address of the hub
• port: port number where the hub is running
• path {optinal}: location in the filesystem of the files that we want to store/load

<script type="text/javascript" src="/path/to/spinalcore.browser.js"></script>

Most of the API is exposed in a global object named spinalCore.

const models = require('../path-to-model/models.js');
let myObj = new models.MyModel();
spinalCore.store(conn, myObj, "myObj", callbackSucces, callbackFailure);

A model object is created as an instance of a Model class, and then saved in the hub with the store() method. All the changes made in it will be automatically submited to the hub. The parameters accepted are:

• Connection instance, obtained from the connect() method
• Model object
• The path of the object in your virtual fileSystem
• Callback function executed once the model has been successfully stored
• Callback function executed if there was an error while storing the model (probably another model exists)

spinalCore.load(conn, "myObj", callbackSuccess, callbackError);

Once an object has been saved in the hub, this command is used for fetching it and keeping synchronized with its changes. The parameters accepted are:

• Connection instance, obtained from the connect() method
• The path of the object in your virtual fileSystem
• Callback function executed once the model has been successfully loaded; as a parameter it receives the object itself
• Callback function executed if there was an error while loading the model (probably it doesn't exists)

spinalCore.load_type(conn, "className", callbackSuccess, callbackError);

Once some objects have been saved in the hub, this command is used for fetching all the models of a specific class and keeping synchronized with their changes. The parameters accepted are:

• Connection instance, obtained from the connect() method
• Name of the class
• The same function is called for each models that the Connector receive, and the Callback function receives the object itself as a parameter.
• Callback function executed if there was an error while loading the models

class MyProcess extends Process {
	constructor() {
  	  	super(model);
	}

	onchange() {
       	// code to execute whenever the model changes
    };
}

A Process is a class prepared to interact with models. It can listen for changes in one or more models and reacts to them. There are three steps to define a process:

1. Create a function and call its super(), passing its context and a model or array of models as arguments
2. Optionally, you can override the onchange() method that will be executed whenever the given models change

In SpinalCoreJs, the management of users is done with a set of function of the SpinalUserManager object:

1. get_user_id
2. new_account
3. change_password
4. delete_account
5. get_admin_id
6. change_password_by_admin
7. delete_account_by_admin
8. change_account_rights_by_admin

Anchor
get_user_id get_user_id

get_user_id(options, user_name, password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_name: String containing the username.
3. password: String containing the password of the user.
4. success_callback: function callback with the response when the function succeed.
5. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.get_user_id('http://127.0.0.1:8888', 'test@spinalhub', 'password',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
new_account new_account

new_account(options, user_name, password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_name: String containing the username.
3. password: String containing the password of the user.
4. success_callback: function callback with the response when the function succeed.
5. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.new_account('http://127.0.0.1:8888', 'test@spinalhub', 'password',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
change_password change_password

change_password(options, user_id, password, new_password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_id: Contain the user id.
3. password: String containing the password of the user.
4. new_password: String containing the new_password of the user.
5. success_callback: function callback with the response when the function succeed.
6. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.change_password('http://127.0.0.1:8888', 777777, 'password', 'new_password',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
delete_account delete_account

delete_account(options, user_id, password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_id: Contain the user id.
3. password: String containing the password of the user.
4. success_callback: function callback with the response when the function succeed.
5. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.delete_account('http://127.0.0.1:8888', 777777, 'password',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
get_admin_id get_admin_id

get_admin_id(options, admin_name, password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. admin_name: String containing the admin username.
3. password: String containing the password of the admin user.
4. success_callback: function callback with the response when the function succeed.
5. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.get_admin_id('http://127.0.0.1:8888', 'admin name', 'password',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
change_password_by_admin change_password_by_admin

change_password_by_admin(options, user_name, new_password, admin_id, admin_password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_name: String containing the username.
3. new_password: String containing the new password of the user.
4. admin_id: Contain the id of a admin (default: 644 or 168)
5. admin_password: String containing the password of the admin.
6. success_callback: function callback with the response when the function succeed.
7. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.change_password_by_admin('http://127.0.0.1:8888', 777777, 'new_password', 644,'4YCSeYUzsDG8XSrjqXgkDPrdmJ3fQqHs',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
delete_account_by_admin delete_account_by_admin

delete_account_by_admin(options, user_name, admin_id, admin_password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_name: String containing the username.
3. admin_id: Contain the id of a admin (default: 644 or 168)
4. admin_password: String containing the password of the admin.
5. success_callback: function callback with the response when the function succeed.
6. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.delete_account_by_admin('http://127.0.0.1:8888', 777777, 644,'4YCSeYUzsDG8XSrjqXgkDPrdmJ3fQqHs',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );

Anchor
change_account_rights_by_admin change_account_rights_by_admin

change_account_rights_by_admin(options, user_name, right, admin_id, admin_password, success_callback, error_callback = null)

1. options: String the parameter to connect to the SpinalHub, example "http://127.0.0.1:8888"
2. user_name: String containing the username.
3. right: Contain the right (0 = Read/Write // 1 = Read).
4. admin_id: Contain the id of a admin (default: 644 or 168)
5. admin_password: String containing the password of the admin.
6. success_callback: function callback with the response when the function succeed.
7. error_callback (optionnal): function callback with the response or status error when the function fail.

SpinalUserManager.change_account_rights_by_admin('http://127.0.0.1:8888', 'test@spinalhub', 0, '644','4YCSeYUzsDG8XSrjqXgkDPrdmJ3fQqHs',
        function(response) { console.log( 'success : ' + response ) },
        function(response) { console.log( 'error : ' + response ) } );