rdflib 2.2.31 → 2.2.32-2f2a2f3c

package/esm/update-manager.js

@@ -9,9 +9,9 @@ function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o =
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
 /* @file Update Manager Class
 **
-** 2007-07-15 originall sparl update module by Joe Presbrey <presbrey@mit.edu>
+** 2007-07-15 original SPARQL Update module by Joe Presbrey <presbrey@mit.edu>
 ** 2010-08-08 TimBL folded in Kenny's WEBDAV
-** 2010-12-07 TimBL addred local file write code
+** 2010-12-07 TimBL added local file write code
 */
 import IndexedFormula from './store';
 import { docpart, join as uriJoin } from './uri';
@@ -28,10 +28,6 @@ import { termValue } from './utils/termValue';
 * and also looking out for concurrent updates from other agents
 */
 var UpdateManager = /*#__PURE__*/function () {
-  /** Index of objects for coordinating incoming and outgoing patches */
-
-  /** Object of namespaces */
-
   /**
    * @param  store - The quadstore to store data and metadata. Created if not passed.
   */
@@ -40,7 +36,9 @@ var UpdateManager = /*#__PURE__*/function () {
     _defineProperty(this, "store", void 0);
     _defineProperty(this, "ifps", void 0);
     _defineProperty(this, "fps", void 0);
+    /** Index of objects for coordinating incoming and outgoing patches */
     _defineProperty(this, "patchControl", void 0);
+    /** Object of namespaces */
     _defineProperty(this, "ns", void 0);
     store = store || new IndexedFormula();
     if (store.updater) {
@@ -79,16 +77,19 @@ var UpdateManager = /*#__PURE__*/function () {
     }
 
     /** Remove from the store HTTP authorization metadata
-    * The editble function below relies on copies we have in the store
-    * of the results of previous HTTP transactions. Howver, when
+    * The editable function below relies on copies we have in the store
+    * of the results of previous HTTP transactions. However, when
     * the user logs in, then that data misrepresents what would happen
     * if the user tried again.
     */
   }, {
     key: "flagAuthorizationMetadata",
-    value: function flagAuthorizationMetadata() {
-      var kb = this.store;
-      var meta = kb.fetcher.appNode;
+    value: function flagAuthorizationMetadata(kb) {
+      var _kb$fetcher;
+      if (!kb) {
+        kb = this.store;
+      }
+      var meta = (_kb$fetcher = kb.fetcher) === null || _kb$fetcher === void 0 ? void 0 : _kb$fetcher.appNode;
       var requests = kb.statementsMatching(undefined, this.ns.link('requestedURI'), undefined, meta).map(function (st) {
         return st.subject;
       });
@@ -100,7 +101,7 @@ var UpdateManager = /*#__PURE__*/function () {
           var _response = kb.any(request, this.ns.link('response'), null, meta);
           if (_response !== undefined) {
             // ts
-            this.store.add(_response, this.ns.link('outOfDate'), true, meta); // @@ Boolean is fine - fix types
+            kb.add(_response, this.ns.link('outOfDate'), true, meta); // @@ Boolean is fine - fix types
           }
         }
       } catch (err) {
@@ -118,30 +119,40 @@ var UpdateManager = /*#__PURE__*/function () {
      * and local write access is determined by those headers.
      * This async version not only looks at past HTTP requests, it also makes new ones if necessary.
      *
-     * @returns The method string SPARQL or DAV or
+     * @returns The method string N3PATCH or SPARQL or DAV or
      *   LOCALFILE or false if known, undefined if not known.
      */
   }, {
     key: "checkEditable",
     value: function () {
       var _checkEditable = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime.mark(function _callee(uri, kb) {
+        var _kb$fetcher2;
         var initial, final;
         return _regeneratorRuntime.wrap(function _callee$(_context) {
           while (1) switch (_context.prev = _context.next) {
             case 0:
+              if (uri) {
+                _context.next = 2;
+                break;
+              }
+              return _context.abrupt("return", false);
+            case 2:
+              if (!kb) {
+                kb = this.store;
+              }
               initial = this.editable(uri, kb);
               if (!(initial !== undefined)) {
-                _context.next = 3;
+                _context.next = 6;
                 break;
               }
               return _context.abrupt("return", initial);
-            case 3:
-              _context.next = 5;
-              return this.store.fetcher.load(uri);
-            case 5:
+            case 6:
+              _context.next = 8;
+              return (_kb$fetcher2 = kb.fetcher) === null || _kb$fetcher2 === void 0 ? void 0 : _kb$fetcher2.load(uri);
+            case 8:
               final = this.editable(uri, kb); // console.log(`Loaded ${uri} just to check editable, result: ${final}.`)
               return _context.abrupt("return", final);
-            case 7:
+            case 10:
             case "end":
               return _context.stop();
           }
@@ -166,6 +177,7 @@ var UpdateManager = /*#__PURE__*/function () {
   }, {
     key: "editable",
     value: function editable(uri, kb) {
+      var _kb$fetcher3;
       if (!uri) {
         return false; // Eg subject is bnode, no known doc to write to
       }
@@ -175,13 +187,13 @@ var UpdateManager = /*#__PURE__*/function () {
       }
       uri = termValue(uri);
       if (!this.isHttpUri(uri)) {
-        if (this.store.holds(this.store.rdfFactory.namedNode(uri), this.store.rdfFactory.namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'), this.store.rdfFactory.namedNode('http://www.w3.org/2007/ont/link#MachineEditableDocument'))) {
+        if (kb.holds(kb.rdfFactory.namedNode(uri), kb.rdfFactory.namedNode('http://www.w3.org/1999/02/22-rdf-syntax-ns#type'), kb.rdfFactory.namedNode('http://www.w3.org/2007/ont/link#MachineEditableDocument'))) {
           return 'LOCALFILE';
         }
       }
       var request;
       var definitive = false;
-      var meta = this.store.fetcher.appNode;
+      var meta = (_kb$fetcher3 = kb.fetcher) === null || _kb$fetcher3 === void 0 ? void 0 : _kb$fetcher3.appNode;
       // const kb = s
 
       // @ts-ignore passes a string to kb.each, which expects a term. Should this work?
@@ -219,6 +231,7 @@ var UpdateManager = /*#__PURE__*/function () {
             if (acceptPatch.length) {
               for (var i = 0; i < acceptPatch.length; i++) {
                 method = acceptPatch[i].value.trim();
+                if (method.indexOf('text/n3') >= 0) return 'N3PATCH';
                 if (method.indexOf('application/sparql-update') >= 0) return 'SPARQL';
                 if (method.indexOf('application/sparql-update-single-match') >= 0) return 'SPARQL';
               }
@@ -266,7 +279,8 @@ var UpdateManager = /*#__PURE__*/function () {
   }, {
     key: "anonymize",
     value: function anonymize(obj) {
-      return obj.toNT().substr(0, 2) === '_:' && this.mentioned(obj) ? '?' + obj.toNT().substr(2) : obj.toNT();
+      var anonymized = obj.toNT().substr(0, 2) === '_:' && this.mentioned(obj) ? '?' + obj.toNT().substr(2) : obj.toNT();
+      return anonymized;
     }
   }, {
     key: "anonymizeNT",
@@ -464,7 +478,7 @@ var UpdateManager = /*#__PURE__*/function () {
         // console.log('UpdateManager: sending update to <' + uri + '>')
 
         options.noMeta = true;
-        options.contentType = 'application/sparql-update';
+        options.contentType = options.contentType || 'application/sparql-update';
         options.body = query;
         return _this.store.fetcher.webOperation('PATCH', uri, options);
       }).then(function (response) {
@@ -482,7 +496,7 @@ var UpdateManager = /*#__PURE__*/function () {
       });
     }
 
-    // ARE THESE THEE FUNCTIONS USED? DEPROCATE?
+    // ARE THESE THREE FUNCTIONS USED? DEPRECATE?
 
     /** return a statemnet updating function
      *
@@ -792,7 +806,93 @@ var UpdateManager = /*#__PURE__*/function () {
     }
 
     /**
-     * This high-level function updates the local store iff the web is changed successfully.
+     * @private
+     * 
+     * This helper function constructs SPARQL Update query from resolved arguments.
+     * 
+     * @param ds: deletions array.
+     * @param is: insertions array.
+     * @param bnodes_context: Additional context to uniquely identify any blank nodes.
+     */
+  }, {
+    key: "constructSparqlUpdateQuery",
+    value: function constructSparqlUpdateQuery(ds, is, bnodes_context) {
+      var whereClause = this.contextWhere(bnodes_context);
+      var query = '';
+      if (whereClause.length) {
+        // Is there a WHERE clause?
+        if (ds.length) {
+          query += 'DELETE { ';
+          for (var i = 0; i < ds.length; i++) {
+            query += this.anonymizeNT(ds[i]) + '\n';
+          }
+          query += ' }\n';
+        }
+        if (is.length) {
+          query += 'INSERT { ';
+          for (var _i5 = 0; _i5 < is.length; _i5++) {
+            query += this.anonymizeNT(is[_i5]) + '\n';
+          }
+          query += ' }\n';
+        }
+        query += whereClause;
+      } else {
+        // no where clause
+        if (ds.length) {
+          query += 'DELETE DATA { ';
+          for (var _i6 = 0; _i6 < ds.length; _i6++) {
+            query += this.anonymizeNT(ds[_i6]) + '\n';
+          }
+          query += ' } \n';
+        }
+        if (is.length) {
+          if (ds.length) query += ' ; ';
+          query += 'INSERT DATA { ';
+          for (var _i7 = 0; _i7 < is.length; _i7++) {
+            query += this.nTriples(is[_i7]) + '\n';
+          }
+          query += ' }\n';
+        }
+      }
+      return query;
+    }
+
+    /**
+     * @private
+     * 
+     * This helper function constructs n3-patch query from resolved arguments.
+     * 
+     * @param ds: deletions array.
+     * @param is: insertions array.
+     * @param bnodes_context: Additional context to uniquely identify any blanknodes.
+     */
+  }, {
+    key: "constructN3PatchQuery",
+    value: function constructN3PatchQuery(ds, is, bnodes_context) {
+      var _this3 = this;
+      var query = "\n@prefix solid: <http://www.w3.org/ns/solid/terms#>.\n@prefix ex: <http://www.example.org/terms#>.\n\n_:patch\n";
+      // If bnode context is non trivial, express it as ?conditions formula.
+      if (bnodes_context && bnodes_context.length > 0) {
+        query += "\n      solid:where {\n        ".concat(bnodes_context.map(function (x) {
+          return _this3.anonymizeNT(x);
+        }).join('\n        '), "\n      };");
+      }
+      if (ds.length > 0) {
+        query += "\n      solid:deletes {\n        ".concat(ds.map(function (x) {
+          return _this3.anonymizeNT(x);
+        }).join('\n        '), "\n      };");
+      }
+      if (is.length > 0) {
+        query += "\n      solid:inserts {\n        ".concat(is.map(function (x) {
+          return _this3.anonymizeNT(x);
+        }).join('\n        '), "\n      };");
+      }
+      query += "   a solid:InsertDeletePatch .\n";
+      return query;
+    }
+
+    /**
+     * This high-level function updates the local store if the web is changed successfully.
      * Deletions, insertions may be undefined or single statements or lists or formulae (may contain bnodes which can be indirectly identified by a where clause).
      * The `why` property of each statement must be the same and give the web document to be updated.
      * @param deletions - Statement or statements to be deleted.
@@ -804,7 +904,7 @@ var UpdateManager = /*#__PURE__*/function () {
   }, {
     key: "update",
     value: function update(deletions, insertions, callback, secondTry) {
-      var _this3 = this;
+      var _this4 = this;
       var options = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
       if (!callback) {
         var thisUpdater = this;
@@ -872,64 +972,31 @@ var UpdateManager = /*#__PURE__*/function () {
         if (protocol === undefined) {
           // Not enough metadata
           if (secondTry) {
-            throw new Error('Update: Loaded ' + doc + "but stil can't figure out what editing protcol it supports.");
+            throw new Error('Update: Loaded ' + doc + "but still can't figure out what editing protocol it supports.");
           }
           // console.log(`Update: have not loaded ${doc} before: loading now...`);
           this.store.fetcher.load(doc).then(function (response) {
-            _this3.update(deletions, insertions, callback, true, options);
+            _this4.update(deletions, insertions, callback, true, options);
           }, function (err) {
             if (err.response.status === 404) {
               // nonexistent files are fine
-              _this3.update(deletions, insertions, callback, true, options);
+              _this4.update(deletions, insertions, callback, true, options);
             } else {
               throw new Error("Update: Can't get updatability status ".concat(doc, " before patching: ").concat(err));
             }
           });
           return;
-        } else if (protocol.indexOf('SPARQL') >= 0) {
+        } else if (protocol.indexOf('SPARQL') >= 0 || protocol.indexOf('N3PATCH') >= 0) {
+          var isSparql = protocol.indexOf('SPARQL') >= 0;
           var bnodes = [];
           // change ReadOnly type to Mutable type
 
           if (ds.length) bnodes = this.statementArrayBnodes(ds);
           if (is.length) bnodes = bnodes.concat(this.statementArrayBnodes(is));
           var context = this.bnodeContext(bnodes, doc);
-          var whereClause = this.contextWhere(context);
-          var query = '';
-          if (whereClause.length) {
-            // Is there a WHERE clause?
-            if (ds.length) {
-              query += 'DELETE { ';
-              for (var i = 0; i < ds.length; i++) {
-                query += this.anonymizeNT(ds[i]) + '\n';
-              }
-              query += ' }\n';
-            }
-            if (is.length) {
-              query += 'INSERT { ';
-              for (var _i5 = 0; _i5 < is.length; _i5++) {
-                query += this.anonymizeNT(is[_i5]) + '\n';
-              }
-              query += ' }\n';
-            }
-            query += whereClause;
-          } else {
-            // no where clause
-            if (ds.length) {
-              query += 'DELETE DATA { ';
-              for (var _i6 = 0; _i6 < ds.length; _i6++) {
-                query += this.anonymizeNT(ds[_i6]) + '\n';
-              }
-              query += ' } \n';
-            }
-            if (is.length) {
-              if (ds.length) query += ' ; ';
-              query += 'INSERT DATA { ';
-              for (var _i7 = 0; _i7 < is.length; _i7++) {
-                query += this.nTriples(is[_i7]) + '\n';
-              }
-              query += ' }\n';
-            }
-          }
+          var query = isSparql ? this.constructSparqlUpdateQuery(ds, is, context) : this.constructN3PatchQuery(ds, is, context);
+          options.contentType = isSparql ? 'application/sparql-update' : 'text/n3';
+
           // Track pending upstream patches until they have finished their callbackFunction
           control.pendingUpstream = control.pendingUpstream ? control.pendingUpstream + 1 : 1;
           if ('upstreamCount' in control) {
@@ -950,8 +1017,8 @@ var UpdateManager = /*#__PURE__*/function () {
                 success = false;
                 body = 'Remote Ok BUT error deleting ' + ds.length + ' from store!!! ' + e;
               } // Add in any case -- help recover from weirdness??
-              for (var _i8 = 0; _i8 < is.length; _i8++) {
-                kb.add(is[_i8].subject, is[_i8].predicate, is[_i8].object, doc);
+              for (var i = 0; i < is.length; i++) {
+                kb.add(is[i].subject, is[i].predicate, is[i].object, doc);
               }
             }
             callback(uri, success, body, response);
@@ -1005,8 +1072,8 @@ var UpdateManager = /*#__PURE__*/function () {
       for (var i = 0; i < ds.length; i++) {
         Util.RDFArrayRemove(newSts, ds[i]);
       }
-      for (var _i9 = 0; _i9 < is.length; _i9++) {
-        newSts.push(is[_i9]);
+      for (var _i8 = 0; _i8 < is.length; _i8++) {
+        newSts.push(is[_i8]);
       }
       var documentString = this.serialize(doc.value, newSts, contentType);
 
@@ -1023,11 +1090,11 @@ var UpdateManager = /*#__PURE__*/function () {
         if (!response.ok) {
           throw new Error(response.error);
         }
-        for (var _i10 = 0; _i10 < ds.length; _i10++) {
-          kb.remove(ds[_i10]);
+        for (var _i9 = 0; _i9 < ds.length; _i9++) {
+          kb.remove(ds[_i9]);
         }
-        for (var _i11 = 0; _i11 < is.length; _i11++) {
-          kb.add(is[_i11].subject, is[_i11].predicate, is[_i11].object, doc);
+        for (var _i10 = 0; _i10 < is.length; _i10++) {
+          kb.add(is[_i10].subject, is[_i10].predicate, is[_i10].object, doc);
         }
         callbackFunction(doc.value, response.ok, response.responseText, response);
       }).catch(function (err) {
@@ -1057,8 +1124,8 @@ var UpdateManager = /*#__PURE__*/function () {
       for (var i = 0; i < ds.length; i++) {
         Util.RDFArrayRemove(newSts, ds[i]);
       }
-      for (var _i12 = 0; _i12 < is.length; _i12++) {
-        newSts.push(is[_i12]);
+      for (var _i11 = 0; _i11 < is.length; _i11++) {
+        newSts.push(is[_i11]);
       }
       // serialize to the appropriate format
       var dot = doc.value.lastIndexOf('.');
@@ -1074,11 +1141,11 @@ var UpdateManager = /*#__PURE__*/function () {
       options.contentType = contentType;
       kb.fetcher.webOperation('PUT', doc.value, options).then(function (response) {
         if (!response.ok) return callbackFunction(doc.value, false, response.error);
-        for (var _i13 = 0; _i13 < ds.length; _i13++) {
-          kb.remove(ds[_i13]);
+        for (var _i12 = 0; _i12 < ds.length; _i12++) {
+          kb.remove(ds[_i12]);
         }
-        for (var _i14 = 0; _i14 < is.length; _i14++) {
-          kb.add(is[_i14].subject, is[_i14].predicate, is[_i14].object, doc);
+        for (var _i13 = 0; _i13 < is.length; _i13++) {
+          kb.add(is[_i13].subject, is[_i13].predicate, is[_i13].object, doc);
         }
         callbackFunction(doc.value, true, ''); // success!
       });
@@ -1126,11 +1193,11 @@ var UpdateManager = /*#__PURE__*/function () {
   }, {
     key: "put",
     value: function put(doc, data, contentType, callback) {
-      var _this4 = this;
+      var _this5 = this;
       var kb = this.store;
       var documentString;
       return Promise.resolve().then(function () {
-        documentString = _this4.serialize(doc.value, data, contentType);
+        documentString = _this5.serialize(doc.value, data, contentType);
         return kb.fetcher.webOperation('PUT', doc.value, {
           contentType: contentType,
           body: documentString

package/esm/utils.js

@@ -2,7 +2,6 @@ import log from './log';
 import { docpart } from './uri';
 import { string_startswith } from './utils-js';
 /** RDF/JS spec Typeguards */
-
 /**
  * Loads ontologies of the data we load (this is the callback from the kb to
  * the fetcher).

package/esm/variable.js

@@ -21,10 +21,6 @@ import * as Uri from './uri';
 var Variable = /*#__PURE__*/function (_Node) {
   _inherits(Variable, _Node);
   var _super = _createSuper(Variable);
-  /** The base string for a variable's name */
-
-  /** The unique identifier of this variable */
-
   /**
    * Initializes this variable
    * @param name The variable's name
@@ -35,9 +31,11 @@ var Variable = /*#__PURE__*/function (_Node) {
     _classCallCheck(this, Variable);
     _this = _super.call(this, name);
     _defineProperty(_assertThisInitialized(_this), "termType", VariableTermType);
+    /** The base string for a variable's name */
     _defineProperty(_assertThisInitialized(_this), "base", 'varid:');
     _defineProperty(_assertThisInitialized(_this), "classOrder", ClassOrder.Variable);
     _defineProperty(_assertThisInitialized(_this), "isVar", 1);
+    /** The unique identifier of this variable */
     _defineProperty(_assertThisInitialized(_this), "uri", void 0);
     _this.base = 'varid:';
     _this.uri = Uri.join(name, _this.base);

package/lib/blank-node.js

@@ -34,7 +34,13 @@ var BlankNode = /*#__PURE__*/function (_Node) {
     _this = _super.call(this, BlankNode.getId(id));
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "termType", _types.BlankNodeTermType);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "classOrder", _classOrder.default.BlankNode);
+    /** Whether this is a blank node */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "isBlank", 1);
+    /**
+     * This type of node is a variable.
+     *
+     * Note that the existence of this property already indicates that it is a variable.
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "isVar", 1);
     return _this;
   }
@@ -92,12 +98,7 @@ var BlankNode = /*#__PURE__*/function (_Node) {
     }
   }], [{
     key: "getId",
-    value:
-    /**
-     * The next unique identifier for blank nodes
-     */
-
-    function getId(id) {
+    value: function getId(id) {
       if (id) {
         if (typeof id !== 'string') {
           throw new Error('Bad id argument to new blank node: ' + id);
@@ -115,5 +116,8 @@ var BlankNode = /*#__PURE__*/function (_Node) {
   return BlankNode;
 }(_nodeInternal.default);
 exports.default = BlankNode;
+/**
+ * The next unique identifier for blank nodes
+ */
 (0, _defineProperty2.default)(BlankNode, "nextId", 0);
 (0, _defineProperty2.default)(BlankNode, "NTAnonymousNodePrefix", '_:');

package/lib/collection.js

@@ -51,10 +51,6 @@ function fromValue(value) {
 var Collection = /*#__PURE__*/function (_Node) {
   (0, _inherits2.default)(Collection, _Node);
   var _super = _createSuper(Collection);
-  /**
-   * The nodes in this collection
-   */
-
   function Collection(initial) {
     var _this;
     (0, _classCallCheck2.default)(this, Collection);
@@ -63,6 +59,9 @@ var Collection = /*#__PURE__*/function (_Node) {
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "classOrder", _classOrder.default.Collection);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "closed", false);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "compareTerm", _blankNode.default.prototype.compareTerm);
+    /**
+     * The nodes in this collection
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "elements", []);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "isVar", 0);
     if (initial && initial.length > 0) {

package/lib/factories/factory-types.js

@@ -5,15 +5,7 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.Feature = void 0;
 /** A set of features that may be supported by a Data Factory */
-var Feature;
-/**
- * Defines a DataFactory as used in rdflib, based on the RDF/JS: Data model specification,
- * but with additional extensions
- *
- * bnIndex is optional but useful.
- */
-exports.Feature = Feature;
-(function (Feature) {
+var Feature = /*#__PURE__*/function (Feature) {
   Feature["collections"] = "COLLECTIONS";
   Feature["defaultGraphType"] = "DEFAULT_GRAPH_TYPE";
   Feature["equalsMethod"] = "EQUALS_METHOD";
@@ -21,4 +13,12 @@ exports.Feature = Feature;
   Feature["identity"] = "IDENTITY";
   Feature["reversibleId"] = "REVERSIBLE_ID";
   Feature["variableType"] = "VARIABLE_TYPE";
-})(Feature || (exports.Feature = Feature = {}));
+  return Feature;
+}({});
+/**
+ * Defines a DataFactory as used in rdflib, based on the RDF/JS: Data model specification,
+ * but with additional extensions
+ *
+ * bnIndex is optional but useful.
+ */
+exports.Feature = Feature;