update notifier docs
This commit is contained in:
parent
b9a2c92a8b
commit
3fb20537b5
|
@ -7,7 +7,7 @@
|
||||||
},
|
},
|
||||||
"source": {
|
"source": {
|
||||||
"include": ["docs"],
|
"include": ["docs"],
|
||||||
"exclude": ["docs/jsdoc-template", "docs/output", "docs/sync.js"]
|
"exclude": ["docs/jsdoc-template", "docs/output"]
|
||||||
},
|
},
|
||||||
"tags": {
|
"tags": {
|
||||||
"allowUnknownTags": false
|
"allowUnknownTags": false
|
||||||
|
|
72
docs/sync.js
72
docs/sync.js
|
@ -20,21 +20,28 @@
|
||||||
* @memberof Realm
|
* @memberof Realm
|
||||||
*/
|
*/
|
||||||
class Sync {
|
class Sync {
|
||||||
|
/**
|
||||||
|
* Add a sync listener to listen to changes across multiple Realms
|
||||||
|
* @param {string} server_url - the sync server to listen to
|
||||||
|
* @param {SyncUser} admin_user - an admin user obtained by calling `new Realm.Sync.User.adminUser`
|
||||||
|
* @param {string} regex - a regular expression used to determine which cahnged Realms should trigger events -
|
||||||
|
* Use `.*` to match all all Realms
|
||||||
|
* @param {function(change_object)} change_callback - called on when changes are made to any Realm which
|
||||||
|
* match the given regular expression
|
||||||
|
*/
|
||||||
|
static addListener(server_url, admin_user, regex, change_callback) {}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set a global listener function.
|
* Remove a previously registered sync listener
|
||||||
* @param {string} local_path - The path to the directory where realm files are stored [deprecated]
|
* @param {string} regex - the regular expression previously used to register the listener
|
||||||
* @param {string} server_url - The sync server to listen to
|
* @param {function(change_object)} change_callback - the previously registered callback to be removed
|
||||||
* @param {SyncUser} admin_user - An admin user obtained by calling `new Realm.Sync.User.Admin`
|
|
||||||
* @param {function(realm_name)} filter_callback - Return true to recieve changes for the given realm
|
|
||||||
* @param {function(realm_name, realm, change_set)} change_callback - called on any realm changes with
|
|
||||||
* the following arguments:
|
|
||||||
* - `realm_name` - path of the Realm on which changes occurred
|
|
||||||
* - `realm` - a `Realm` object for the changed Realm
|
|
||||||
* - `change_set` - a dictionary of object names to arays of indexes indicating the indexes of objects of each type
|
|
||||||
* which have been added, removed, or modified
|
|
||||||
*/
|
*/
|
||||||
static setGlobalListener(local_path, server_url, admin_user, filter_callback, change_callback) {}
|
static removeListener(regex, change_callback) {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Remove all previously regiestered listeners
|
||||||
|
*/
|
||||||
|
static removeAllListeners() {}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* Set the sync log level.
|
* Set the sync log level.
|
||||||
|
@ -44,6 +51,47 @@ class Sync {
|
||||||
|
|
||||||
}
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Object passed
|
||||||
|
* @memberof Realm.Sync
|
||||||
|
*/
|
||||||
|
class ChangeObject {
|
||||||
|
/**
|
||||||
|
* The path of the changed Realm
|
||||||
|
* @type {string}
|
||||||
|
*/
|
||||||
|
get path() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The changed realm
|
||||||
|
* @type {Realm}
|
||||||
|
*/
|
||||||
|
get realm() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The changed Realm at the old state before the changes were applied
|
||||||
|
* @type {Realm}
|
||||||
|
*/
|
||||||
|
get oldRealm() {}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* The change indexes for all added, removed, and modified objects in the changed Realm.
|
||||||
|
* This object is a hashmap of object types to arrays of indexes for all changed objects:
|
||||||
|
* @example
|
||||||
|
* {
|
||||||
|
* object_type_1: {
|
||||||
|
* insertions: [indexes...],
|
||||||
|
* deletions: [indexes...],
|
||||||
|
* modifications: [indexes...]
|
||||||
|
* },
|
||||||
|
* object_type_2:
|
||||||
|
* ...
|
||||||
|
* }
|
||||||
|
* @type {object}
|
||||||
|
*/
|
||||||
|
get changes() {}
|
||||||
|
}
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* @typedef Realm.Sync~LogLevel
|
* @typedef Realm.Sync~LogLevel
|
||||||
* @type {("error"|"info"|"debug")}
|
* @type {("error"|"info"|"debug")}
|
||||||
|
|
Loading…
Reference in New Issue