NodeJS version

Install the package from npm:

npm install https://github.com/spinalcom/spinal-browsercore-adminconnectorjs.git

You can require the module in the standard way:

const spinalCore = require("spinal-core-connectorjs");

Browser version

Download the SpinalCore browser version from http://resources.spinalcom.com/spinalcore.browser.js

Add it to your HTML file:

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

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

class MyModel extends Model {
	constructor() {
  	  	super();

   	  	this.add_attr({
       		// key: value
       	    // attribute1: "sample",
       	 	// attribute2: 2,
       	 	// attribute3: ["one", "two"],
       	 	// attribute4: {one: 1}
       	 	// ...
    	});
	}
}

spinalCore.extendregister_models([MyModel, Model]);

A Model is a class, which contains a structure of the data we want to synchronize with the hub. There are three required steps to define a class:

1. Create a class and extend the class from the base Model class provided by SpinalCore, and call its super() in a constructor().
2. Add all the attributes of the class we want to synchronize using the add_attr() method.
3. Extend Register the class from the base Model class provided by SpinalCoremodel in the SpinalCore with register_models method, with this method spinalCore can recognize the model.

The value of the attributes should correspond to one of these data types:

• string
• number
• array
• object
• boolean
• any class inherited from Model

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
• New name The path of the object in the hub (used for retrieving it later)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, callbackFailurecallbackError);

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
• Name The path of the object in the hub (the same one used for storing it)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, callbackFailurecallbackError);

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
• Callback function executed once the models have been successfully loaded. The same function is called for each models that the Connector receive, and each one the Callback function receives the object itself as a parameter.
• Callback function executed if there was an error while loading the models (probably there is no model of the chosen class in the hub)

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

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

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 ) } );