1.0.4 • Published 4 years ago

nativescript-cblite v1.0.4

Weekly downloads
-
License
Apache-2.0
Repository
-
Last release
4 years ago

NativeScript CB-Lite

A plugin for Couchbase Lite on NativeScript supporting LiteServ internal REST operations.

Status

Android version working but yet in CBL 1.4.4. iOS still pending some code. For a complete and updated plugin check: https://github.com/triniwiz/nativescript-couchbase-plugin

Installation

tns plugin add nativescript-cblite

Usage

First you need to import the main class

import { CBLite } from 'nativescript-cblite';

In case you'll use the REST api, the following command will initialize it and provide the base url:

const url = Utils.startCBLListener();

Then you need to instantiate the CBLite class

const cblite = new CBLite('databaseName');

Creating a local document

cblite.createDocument({name: 'John Doe', age: 99}, 'myDocumentId');

Reading a local document

// It will return a JSON object or false if the document does not exist
cblite.getDocument('myDocumentId');

Updating local document

cblite.updateDocument('myDocumentId', {newData: 'My new data string'});

Replicating your documents with a SyncGateway server

First you need to import the proper classes

import { CBLite, Replicator } from 'nativescript-cblite';

Then you need to instantiate those classes

const cblite = new CBLite('databaseName');
const pushReplicator: Replicator = cblite.createPushReplication('myRemoteUrl');
const pullReplicator: Replicator = cblite.createPullReplication('myRemoteUrl');

Setting up the replication

pushReplicator.setContinuous(true);
pushReplicator.setAuthenticator('username', 'password');
pushReplicator.start();

pullReplicator.setContinuous(true);
pullReplicator.setAuthenticator('username', 'password');
pullReplicator.start();

API Reference

Class CBLite

Method nameParametersReturn type
getDocumentdocumentIdObject
listAllDocuments-string[]
listAllReplications-string[]
addDatabaseChangeListenercallbackvoid
createDocumentdata, documentIdstring
updateDocumentdocumentId, datavoid
deleteDocumentdocumentIdboolean
createPullReplicationremoteUrlReplicator
createPushReplicationremoteUrlReplicator

Class Replicator

Method nameParametersReturn type
start-void
stop-void
isRunning-boolean
addReplicationChangeListenerchangeListenerCallbackvoid
setAuthenticatorusername, passwordvoid
setContinuouscontinuousvoid
setDocumentIdsdocIdsvoid
setCookiename, value, path, expirationDate, secure, httpOnlyvoid
deleteCookienamevoid

More documentation incoming soon

License

Apache License Version 2.0, January 2004