merge master

Author: lovasoa

src/api.js

@@ -1457,17 +1457,12 @@ Module["onRuntimeInitialized"] = function onRuntimeInitialized() {
      * // This won't trigger any callback
      * db.run("INSERT INTO users VALUES (2, 'Bob', 1)");
      *
-     * @param {function|null} callback -
-     * Callback to be executed whenever a row changes.
-     * Set to `null` to unregister the callback.
-     * @param {string} callback.operation -
-     * 'insert', 'update', or 'delete'
-     * @param {string} callback.database -
-     * database where the change occurred
-     * @param {string} callback.table -
-     * table where the change occurred
-     * @param {number} callback.rowId -
-     * rowid of the changed row
+     * @param {Database~UpdateHookCallback|null} callback
+     * - Callback to be executed when a row changes. Takes the type of change,
+     *   the name of the database, the name of the table, and the row id of the
+     *   changed row.
+     * - Set to `null` to unregister.
+     * @returns {Database} The database object. Useful for method chaining
      */
     Database.prototype["updateHook"] = function updateHook(callback) {
         if (this.updateHookFunctionPtr) {
@@ -1479,7 +1474,7 @@ Module["onRuntimeInitialized"] = function onRuntimeInitialized() {
 
         if (!callback) {
             // no new callback to register
-            return;
+            return this;
         }
 
         // void(*)(void *,int ,char const *,char const *,sqlite3_int64)
@@ -1526,8 +1521,21 @@ Module["onRuntimeInitialized"] = function onRuntimeInitialized() {
             this.updateHookFunctionPtr,
             0 // passed as the first arg to wrappedCallback
         );
+        return this;
     };
 
+    /**
+     * @callback Database~UpdateHookCallback
+     * @param {'insert'|'update'|'delete'} operation
+     * - The type of change that occurred
+     * @param {string} database
+     * - The name of the database where the change occurred
+     * @param {string} table
+     * - The name of the database's table where the change occurred
+     * @param {number} rowId
+     * - The [rowid](https://www.sqlite.org/rowidtable.html) of the changed row
+     */
+
     // export Database to Module
     Module.Database = Database;
 };