@naanlang/naan 1.4.4 → 1.5.0

package/frameworks/browser/browser.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2020-2023 by Richard C. Zulch
+ * Copyright (c) 2020-2025 by Richard C. Zulch
  *
  */
 
@@ -33,7 +33,7 @@ closure FileReader(file, progress, local pending, freader, result) {
     freader.addEventListener("error", function(error) {
         pending.signal(list(error))
     })
-    freader.AddEventListener("progress", function(event) {
+    freader.addEventListener("progress", function(event) {
         if event.lengthComputable && event.total
             progress(toint((event.loaded * 100) / event.total))
         else

package/frameworks/browser/sworker.js

@@ -36,7 +36,7 @@
  *
  */
 
-var CurrentCacheName = "Naanlang-1.4.4+1";
+var CurrentCacheName = "Naanlang-1.5.0+1";
 
 
 //
@@ -92,18 +92,18 @@ var terminated;                                 // flag that this service worker
         var pubVersion = event.data.hereIsMyVersion;
         var sourceId = event.source.id;                                     // client id of sender of message
         msgPorts[sourceId] = msgport;
-        console.log("[1.4.4+1] received new msgport for", sourceId, pubID, "-", pubVersion);
-        if (pubVersion != "1.4.4+1") {
+        console.log("[1.5.0+1] received new msgport for", sourceId, pubID, "-", pubVersion);
+        if (pubVersion != "1.5.0+1") {
             if (upgradeMsgPorts) {                                          // if not activated
-                console.log("[1.4.4+1] update pending for", sourceId);
+                console.log("[1.5.0+1] update pending for", sourceId);
                 upgradeMsgPorts[sourceId] = msgport;
             }
             else {
                 msgport.postMessage({                                       // notify new version available
                     id: "upgrade",
-                    version: "1.4.4+1"
+                    version: "1.5.0+1"
                 });
-                console.log("[1.4.4+1] update sent for:", sourceId);
+                console.log("[1.5.0+1] update sent for:", sourceId);
             }
         }
         Reaper();                                                           // clean up obsolete info
@@ -134,10 +134,10 @@ var terminated;                                 // flag that this service worker
         msgport.onmessage = function(msg) {
             msg = msg.data;
             if (msg.id == "skipWaiting") {                                  // try to activate this SW now
-                console.log("[1.4.4+1] attempting skipWaiting");
+                console.log("[1.5.0+1] attempting skipWaiting");
                 self.skipWaiting();
             } else if (msg.id == "terminate") {                             // termiante this SW now
-                console.log("[1.4.4+1] terminated");
+                console.log("[1.5.0+1] terminated");
                 terminate();
             } else if (msg.id == "abortURL") {                              // abort an I/O transaction
                 var href = new URL(msg.url).href;
@@ -150,7 +150,7 @@ var terminated;                                 // flag that this service worker
             } else if (msg.id == "response")                                // response from fetch request
                 processResponse(msg);
             else if (msg.id == "text")                                      // just log some text
-                console.log("[1.4.4+1] msg received:", msg.text);
+                console.log("[1.5.0+1] msg received:", msg.text);
         };
         
         // send text to IDE log
@@ -161,7 +161,7 @@ var terminated;                                 // flag that this service worker
             // don't clutter the log
             msgport.postMessage({
                 id: "text",
-                text: "port received by 1.4.4+1",
+                text: "port received by 1.5.0+1",
             });
             */
         if (--pending === 0)
@@ -178,7 +178,7 @@ var terminated;                                 // flag that this service worker
         includeUncontrolled: true
     }).then(function(clientList) {
         clientList.every(function(client) {
-            console.log("[1.4.4+1] requesting new msgport for", client.id);
+            console.log("[1.5.0+1] requesting new msgport for", client.id);
             ++pending;
             client.postMessage({                                            // tell client(s) we need this fetch source
                 msg: "Naan_need_fetch_port",
@@ -224,12 +224,12 @@ function Reaper() {
             clients[clientList[clidex].id] = clientList[clidex];
         for (var sourceId in msgPorts)
             if (!clients[sourceId]) {
-                console.log("[1.4.4+1] source gone:", sourceId);
+                console.log("[1.5.0+1] source gone:", sourceId);
                 delete msgPorts[sourceId];                                  // no longer a source
             }
         for (var clientId in fetchPorts)
             if (!clients[clientId]) {
-                console.log("[1.4.4+1] client gone:", clientId);
+                console.log("[1.5.0+1] client gone:", clientId);
                 delete fetchPorts[clientId];                                // no longer a client
             }
         for (var fqdex = 0; fqdex < fetchQueue.length; ++fqdex) {
@@ -263,16 +263,16 @@ function ClearCaches() {
             return (Promise.all(
                 cacheNames.map(function(cacheName) {
                     if (cacheName != CurrentCacheName) {
-                        console.log('[1.4.4+1] deleting old cache:', cacheName);
+                        console.log('[1.5.0+1] deleting old cache:', cacheName);
                         return (caches.delete(cacheName));
                     }
                 })
             ));
         }).then(function() {                                                // claim all clients
-            console.log('[1.4.4+1] claiming clients');
+            console.log('[1.5.0+1] claiming clients');
             return (self.clients.claim());
         }).then(function() {
-            console.log('[1.4.4+1] clients claimed');
+            console.log('[1.5.0+1] clients claimed');
             return (Promise.resolve(true));
         });
     return (promise);
@@ -315,7 +315,7 @@ function GetClientResponse(event, urlpath) {
             msgport.postMessage({
                 id: "fetch",
                 seq: seqno,
-                version: "1.4.4+1",
+                version: "1.5.0+1",
                 request: {
                     method: event.request.method,
                     url: event.request.url
@@ -363,7 +363,7 @@ function GetClientResponse(event, urlpath) {
  */
 
 self.addEventListener('install', function(event) {
-    console.log("[1.4.4+1] install");
+    console.log("[1.5.0+1] install");
     self.skipWaiting();
 });
 
@@ -376,20 +376,20 @@ self.addEventListener('install', function(event) {
  */
 
 self.addEventListener('activate', function(event) {
-    console.log("[1.4.4+1] activate");
+    console.log("[1.5.0+1] activate");
     self.clients.matchAll({                                                 // for debugging, list controlled clients           
         includeUncontrolled: true
     }).then(function(clientList) {
         var urls = clientList.map(function(client) {
             return (client.url);
         });
-        console.log('[1.4.4+1] matching clients:', urls.join(', '));
+        console.log('[1.5.0+1] matching clients:', urls.join(', '));
     });
     var promise = ClearCaches().then(function() {
         for (var sourceId in upgradeMsgPorts) {
             upgradeMsgPorts[sourceId].postMessage({                         // notify new version available
                 id: "upgrade",
-                version: "1.4.4+1"
+                version: "1.5.0+1"
             });
         }
         upgradeMsgPorts = false;
@@ -421,7 +421,7 @@ self.addEventListener('fetch', function(event) {
             var promise;
             var url = new URL(request.url);
             var nocache = request.method != "GET"
-                || url.search.length !== 0 && url.searchParams.get("naanver") !== "3a2321ac98091606ee7cf5cc8919f70c"
+                || url.search.length !== 0 && url.searchParams.get("naanver") !== "1df9163d801364d0cae89b149cc24ef5"
                 || request.headers.get('range');
             if (url.pathname.startsWith("/run/")) {
                 nocache = true;
@@ -455,7 +455,7 @@ self.addEventListener('fetch', function(event) {
                             statusText: "Request Cancelled"
                         }));
                     }
-                    console.log("[1.4.4+1] fetch failed", request.url, e);
+                    console.log("[1.5.0+1] fetch failed", request.url, e);
                     return (new Response(undefined, {
                         status: 404,
                         statusText: "Fetch Failed"

package/frameworks/browser/terminals.nlg

@@ -562,7 +562,7 @@ closure TermLocal(track, name, options, local target, nlregex, listener)
             msg.data._guid = target.guid
             js.t.DispatchMessage(msg.data)
         }
-     }
+    }
     
     //
     // target.DebugCmd
@@ -764,14 +764,18 @@ closure WorkerToMain(local nideRunning, track) {
 /*
  * findIDEtarget
  *
- *     Find a target for our IDE that matches the specified name, workerID, and naancont.
+ *     Find a target for our IDE that matches the specified name, workerID, and naancont. Either the
+ * title or the naancont must match. The title will match but not the naancont if the window was
+ * closed/reloaded but we didn't get notified because browsers are annoying that way. Alternatively
+ * the naancont will match but not the title if we have updated the version.
  *
  */
 
-closure findIDEtarget(track, name, workerID, naancont, local target) {
+closure findIDEtarget(track, name, workerID, title, naancont, local target) {
     global()
     for target in track.enumlist()
-        if target.name == name && target.workerID == workerID && (!target.naancont || target.naancont === naancont)
+        if target.name == name && target.workerID == workerID
+            && (target.title == title || !target.naancont || target.naancont === naancont)
             return (target)
     false
 };
@@ -788,8 +792,10 @@ closure findIDEtarget(track, name, workerID, naancont, local target) {
 
 closure termIDE(track, name, workerID, naancont, title, local target, connected) {
     global(js, gWorkers)
-    target = findIDEtarget(track, name, workerID, naancont)
+    target = findIDEtarget(track, name, workerID, title, naancont)
     if target {                                                             // new naancont on existing target
+        if target.naancont && naancont !== target.naancont
+            target.targetClose()
         target.updateController(naancont)
         target.title = title
         track.update(target)
@@ -934,7 +940,7 @@ closure termIDE(track, name, workerID, naancont, title, local target, connected)
     //
     //     Mark the target window as closed.
     //
-    function targetClose(local conn) {
+    target.targetClose = function targetClose(local conn) {
         for conn in connected {
             conn.db.detach(target)
             conn.WriteLn("\x1b[90m\x1b[3m".concat("\ntarget closed", "\x1b[0m"))
@@ -1012,12 +1018,12 @@ closure termInstallVirtualWatcher(track, naancont) {
             target.attention()
         }
         else if msg.op == "VsiteClose" {
-            target = findIDEtarget(track, msg.name, "NaanVsite", msg.naancont)
+            target = findIDEtarget(track, msg.name, "NaanVsite", msg.title, msg.naancont)
             if target
                 target.updateController()
         }
         else if msg.op == "VsiteVisibilityChange" {
-            target = findIDEtarget(track, msg.name, "NaanVsite", msg.naancont)
+            target = findIDEtarget(track, msg.name, "NaanVsite", msg.title, msg.naancont)
             if target
                 target.setCheckStatus(msg.hidden, msg.window)
         }

package/frameworks/client/apiclient.nlg

@@ -2,41 +2,50 @@
  * apiclient.nlg
  * Naanlib/frameworks/client
  *
- *     Access to Nide API with browser HTTP client.
+ *     Access to Nide API with specified HTTP client.
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2017-2024 by Richard C. Zulch
+ * Copyright (c) 2017-2025 by Richard C. Zulch
  *
  */
 
 
 /*
- * NideAPIclient
+ * APIClient
  *
- *     Make an API client object for browsers.
+ *     Make an API client object.
+ *
+ * Options:
+ *  {
+ *      url:            <string>                // hostname or URL of the remote server
+ *      guid:           <string>                // shared secret for access to remote server
+ *      instanceID:     <string>                // optional UUID for our client; can be persisted by caller
+ *  }
  *
  */
 
-closure NideAPIclient(url, guid, apiRequester, local client) {
-    global()
+closure APIClient(options, local client, url, guid) {
+    global(App)
     client = new(object, this)
+    url = options.url
     if !url.match(RegExp("^https?:\/\/", "i"))
         url = "http://${url}"                                               // a protocol is required
     if url.slice(-1) != "/"
         url = url.concat("/")                                               // must end in "/"
     client.url = url
-    client.guid = guid
+    client.guid = options.guid
+    client.instanceID = options.instanceID || UUID()                        // our client's unique ID
     client.notifyAfter = 0
-    client.instanceID = UUID()                                              // our client's unique ID
+    client.requester = clirRequester()
 
     // clientRequest() - append our guid to the headers
 
-    closure clientRequest(url, options) {
-        options = merge(options)
-        if guid
-            options.headers = [list("x-naanlang-api-guid", guid)]
-        apiRequester(url, options)
+    closure clientRequest(url, reqops) {
+        reqops = merge(reqops)
+        if options.guid
+            reqops.headers = [list("x-naanlang-api-guid", options.guid)]
+        client.requester(url, reqops)
     }
 
     //
@@ -57,7 +66,7 @@ closure NideAPIclient(url, guid, apiRequester, local client) {
             timeout: timeoutms
             after: client.notifyAfter
         })
-        `(error, content, extra) = clientRequest(url.concat(query))
+        `(error, content, extra) = clientRequest(url.concat(query), { retrier: false }) // don't retry inside
         if (error || extra.status != 200)
             cbStatus()
         else if (length(content) == 0)
@@ -76,8 +85,12 @@ closure NideAPIclient(url, guid, apiRequester, local client) {
     // get
     //
 
-    client.get = closure get(path, options, local error, content, extra) {
-        `(error, content, extra) = clientRequest(url.concat(path))
+    client.get = closure get(path, options, local requrl, error, content, extra) {
+        if App.cache
+            requrl = url.concat(EncodeQuery(path.concat("?"), { naanver: App.cache }))
+        else
+            requrl = url.concat(path)
+        `(error, content, extra) = clientRequest(requrl)
         if !error && extra.status != 200
             error = Error("readFile failed: ".concat(extra.status), {
                     status: extra.status
@@ -153,12 +166,12 @@ closure NideAPIclient(url, guid, apiRequester, local client) {
 
 function apicInit(local manifest) {
 
-    manifest = `(NideAPIclient, apicInit)
+    manifest = `(APIClient, apicInit)
 
     Naan.module.build(module.id, "apiclient", function(modobj, compobj) {
         Naan.module.require("./client.nlg")
         compobj.manifest = manifest
-        modobj.exports.NideAPIclient = NideAPIclient
+        modobj.exports.APIClient = APIClient
     })
 
 } ();

package/frameworks/client/client.nlg

@@ -6,11 +6,31 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2020-2021 by Richard C. Zulch
+ * Copyright (c) 2020-2025 by Richard C. Zulch
  *
  */
 
 
+/*
+ * clirRequester
+ *
+ *     Return an appropriate HttpsRequestApi client based on our environment.
+ *
+ */
+
+clirRequestApi = false;
+
+function clirRequester() {
+    if !clirRequestApi {
+        if js.w
+            clirRequestApi = require("naanlib:frameworks/browser/https_request.nlg").HttpsApiRequest
+        else
+            clirRequestApi = require("naanlib:frameworks/node/https_request.nlg").HttpsApiRequest
+    }
+    clirRequestApi
+};
+
+
 /*
  * clirInit
  *
@@ -20,7 +40,7 @@
  */
 
 function clirInit(local manifest) {
-    manifest = `(clirInit)
+    manifest = `(clirRequester, clirInit)
 
     Naan.module.build(module.id, "client", function(modobj, compobj) {
         require("../common/").LiveImport()

package/frameworks/client/psm_client.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2019-2024 by Richard C. Zulch
+ * Copyright (c) 2019-2025 by Richard C. Zulch
  *
  */
 
@@ -633,8 +633,17 @@ closure psmcFsConnector(psm, api, local connClassID, connector, watch) {
                 api = connector.apis[creds]
             else {
                 api = connector.apis[creds.urlName]
-                if !api                                                     // get API to remote server
-                    connector.apis[creds.urlName] = api = NideAPIclient(creds.urlName, creds.authSecret)
+                if !api {                                                   // create API to remote server
+                    connector.apis[creds.urlName] = api = APIClient({
+                        url: creds.urlName
+                        guid: creds.authSecret
+                        instanceID: creds.instanceID
+                    })
+                    if creds.instanceID != api.instanceID {                 // update our client instanceID
+                        creds.instanceID = api.instanceID
+                        `(error) = connector.vault.updateResource(resID, creds)
+                    }
+                }
             }
         }
         if error

package/frameworks/node/filesystem.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2017-2022 by Richard C. Zulch
+ * Copyright (c) 2017-2025 by Richard C. Zulch
  *
  */
 
@@ -1041,6 +1041,8 @@ closure Filesystem(rootpath, local files, badCreatePathRegEx) {
         cmdargs.push(options.pattern)
         cmdargs.push(JSpath.resolve(rootpath, localpath))
         execOptions = { cmdargs: cmdargs }
+        if js.g.process.platform == "win32"                                 // to make "-i" work on Windows
+            execOptions.spawnops = { env: merge(js.g.process.env, { LC_ALL: 'en_US.UTF-8' }) }
         result = []
         lineRE = RegExp("([^:]*):([0-9]+):(.*)$")                           // <path>:<line-number>:<matching-text-line>
         if integer(options.maxCount)
@@ -1075,7 +1077,7 @@ closure Filesystem(rootpath, local files, badCreatePathRegEx) {
     // has completed. Options are:
     //  {
     //      cmdargs:            -- array of string arguments to the command (see below)
-    //      execops:            -- optional exec options like cwd
+    //      spawnops:           -- optional spawn options like cwd
     //      errproc:            -- callback for stderr output lines, or false
     //      errLE:              -- string or RegExp for stderr line ending
     //      outproc:            -- optional callback for stdout output lines
@@ -1100,7 +1102,7 @@ closure Filesystem(rootpath, local files, badCreatePathRegEx) {
     //
 
     files.execLines = closure execLines(cmdname, options, callback, 
-        local output, execops, spawn, linerErr, linerOut) {
+        local output, spawnops, spawn, linerErr, linerOut) {
         if !callback
             return (syncAdapter(execLines, cmdname, options))
         if !string(cmdname) || cmdname == ""
@@ -1109,11 +1111,11 @@ closure Filesystem(rootpath, local files, badCreatePathRegEx) {
             output = options.output
         else
             output = {}
-        if options.execops
-            execops = options.execops
+        if options.spawnops
+            spawnops = options.spawnops
         else
-            execops = { }
-        spawn = nodecp.spawn(cmdname, options.cmdargs, execops)
+            spawnops = { }
+        spawn = nodecp.spawn(cmdname, options.cmdargs, spawnops)
 
         // completed
         // execute callback only once

package/frameworks/node/gitter.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2020-2021 by Richard C. Zulch
+ * Copyright (c) 2020-2025 by Richard C. Zulch
  *
  */
 
@@ -56,7 +56,7 @@ closure Gitter(fs, local gitt) {
             asyncResult(callback, false, gitt.roots[repopath])
         execOptions = {
             cmdargs: ["rev-parse", "--show-toplevel"]
-            execops: {
+            spawnops: {
                 cwd: repopath
             }
             outLE: "\x00"                                                   // lines delimited by nulls
@@ -117,7 +117,7 @@ closure Gitter(fs, local gitt) {
         repopath = fs.path.resolve(fs.rootpath, repopath)
         execOptions = {
             cmdargs: ["log", "-z", "--pretty=format:%H|%an|%ae|%aI|%B"]
-            execops: {
+            spawnops: {
                 cwd: repopath
             }
             outLE: "\x00"                                                   // lines delimited by nulls
@@ -168,10 +168,12 @@ closure Gitter(fs, local gitt) {
         if !string(repopath)
             return (asyncResult(callback, Error("invalid path:", repopath)))
         repopath = fs.path.resolve(fs.rootpath, repopath)
-        bridge = bridgePath(repopath)
+		bridge = fs.path.normalize(bridgePath(repopath))                    // ensure it works for our FS
+		if bridge == "."
+		    bridge = ""                                                     // no bridge in this case
         execOptions = {
             cmdargs: ["status", "-z", "--porcelain"]
-            execops: {
+            spawnops: {
                 cwd: repopath
             }
             outLE: "\x00"                                                   // lines delimited by nulls
@@ -219,13 +221,13 @@ closure Gitter(fs, local gitt) {
         repopath = fs.path.resolve(fs.rootpath, repopath)
         execOptions = {
             cmdargs: ["show", options.hash.concat(":", bridgePath(repopath), gitPath(options.pathspec))]
-            execops: {
+            spawnops: {
                 cwd: repopath
             }
         }
         nodecp.execFile("git",
             execOptions.cmdargs,
-            execOptions.execops,
+            execOptions.spawnops,
             function(err, stdout, stderr) {
                 if err
                     callback(Error("git failed", err, stderr))

package/frameworks/node/shell.nlg

@@ -6,7 +6,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2024 by Richard C. Zulch
+ * Copyright (c) 2024-2025 by Richard C. Zulch
  *
  */
 
@@ -68,9 +68,9 @@ closure ShellConnect(options, local shob, error, fs, xparser, shelly) {
             }
         }
         if cwd
-            xlparams.execops = { cwd: cwd }
+            xlparams.spawnops = { cwd: cwd }
         else if options.cwd
-            xlparams.execops = { cwd: options.cwd }
+            xlparams.spawnops = { cwd: options.cwd }
         fs.execLines(cmd, xlparams, function(error, result) {
         	evalactive(list(`assign, `(compress, "$$"), report))            // assign to $$ in active namespace
             pending.signal(list(error, merge(result, report)))
@@ -80,7 +80,7 @@ closure ShellConnect(options, local shob, error, fs, xparser, shelly) {
 
     // shellparser
     // intercept command-line parsing and look for a !shell escape
-    function shellparser(source, grammar, operators, local token) {
+    function shellparser(source, grammar, operators, local token, text) {
         token = source.tokenread()
         if token.atom == `! {
             source.tokenlast(true)                                          // "consume" the ! token

package/frameworks/project/projects.nlg

@@ -296,7 +296,7 @@ closure projConnector(projman, projtype, local connector, watch) {
  *
  * Nide.proj/
  *      nide_cliser.cfg                 - JSON definition of the project (see below)
- *      NaanIDE_version.txt             - [default] substitution file defining 1.4.4+1 etc.
+ *      NaanIDE_version.txt             - [default] substitution file defining 1.5.0+1 etc.
  *      NaanIDE_version_builds.txt      - [default] contains current build number as decimal string
  *      build/                          - [optional] default build output location
  *      NaanIDE.lic                     - [optional] defines Zulch Laboratories, Inc. and other license info
@@ -692,6 +692,7 @@ closure projConfig(projman, where, projID, local procon, fs, configpath) {
             erase: true
             overwrite: true
             follow: true
+            cacheControl: publish.cacheControlFiles
         })
     }
 

package/frameworks/storage/dbt_pouch.nlg

@@ -7,7 +7,7 @@
  *
  * column positioning:                          //                          //                      !
  *
- * Copyright (c) 2017-2024 by Richard C. Zulch
+ * Copyright (c) 2017-2025 by Richard C. Zulch
  *
  */
 
@@ -76,21 +76,31 @@ closure dapoTable(database, rootpath, local table, prefix) {
 
     // add
     //
-    // Add a new record to the table with optional metadata. This will fail if the key already
-    // exists. Returns the new document record.
-
-    table.add = closure add(key, content, metadata, callback, local id, doc) {
+    // Add a new record to the table with options. This will fail if the key already exists. Optional
+    // metadata is stored with the record and cannot be changed without calling update. Metadata keys
+    // cannot begin with underscore ("_").
+    //
+    // The returned document, which can be used with update, has the following keys:
+    //      key         - the key name of the record
+    //      content     - the body content stored under in the record
+    //      _md5        - the MD5 hash of the content
+    //      _length     - the length of the content
+    //      _id         - the PouchDB ID
+    //      _rev        - the PouchDB revision
+    //      <...>       - various metadata keys
+
+    table.add = closure add(key, content, options, callback, local id, doc) {
         if !callback
-            return (syncAdapter(add, key, content, metadata))
+            return (syncAdapter(add, key, content, options))
         id = makeID(key)
         if !string(id)
             return (asyncResult(callback, id))                              // error from makeID
-        if metadata && !dictionary(metadata)
+        if  options.metadata && !dictionary(options.metadata)
             return (asyncResult(callback, Error("invalid arguments")))
         if !database.pouch
             return (asyncResult(callback, Error("database closed")))
-        if metadata {
-            doc = new(metadata)                                             // start with metadata
+        if options.metadata {
+            doc = new(options.metadata)                                     // start with metadata
             doc._rev = undefined }                                          // _rev not allowed in metadata
         else
             doc = { }
@@ -115,12 +125,13 @@ closure dapoTable(database, rootpath, local table, prefix) {
 
     // update
     //
-    // Update a record in the table using the document previously returned by add or get.
-    // This will fail if the record has been modified by someone else in the meantime.
+    // Update a record in the table using the document previously returned by add or get. Specify
+    // options to update those values, otherwise existing/default values are used. This will fail
+    // if the record has been modified by someone else in the meantime.
 
-    table.update = closure update(doc, callback) {
+    table.update = closure update(doc, options, callback) {
         if !callback
-            return (syncAdapter(update, doc))
+            return (syncAdapter(update, doc, options))
         if !doc._id || !doc._id.startsWith(table.prefix) || !doc._rev
             return (asyncResult(callback, Error("invalid argument")))
         if makeID(doc.key) != doc._id
@@ -130,6 +141,8 @@ closure dapoTable(database, rootpath, local table, prefix) {
         doc = new(doc)
         doc._md5 = undefined
         doc._length = undefined
+        if options.metadata
+            doc = merge(doc, options.metadata)
         database.pouch.put(doc, function(error, resp) {
             if error
                 error = Error("update failed", error)