rdflib 2.2.30 → 2.2.31-4e4dc84d

package/esm/update-manager.js

@@ -1,7 +1,9 @@
 import _typeof from "@babel/runtime/helpers/typeof";
+import _asyncToGenerator from "@babel/runtime/helpers/asyncToGenerator";
 import _classCallCheck from "@babel/runtime/helpers/classCallCheck";
 import _createClass from "@babel/runtime/helpers/createClass";
 import _defineProperty from "@babel/runtime/helpers/defineProperty";
+import _regeneratorRuntime from "@babel/runtime/regenerator";
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 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; }
@@ -26,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.
   */
@@ -38,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) {
@@ -76,13 +76,100 @@ var UpdateManager = /*#__PURE__*/function () {
       return uri.slice(0, 4) === 'http';
     }
 
+    /** 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 user logs in, then that data misrepresents what would happen
+    * if the user tried again.
+    */
+  }, {
+    key: "flagAuthorizationMetadata",
+    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;
+      });
+      var _iterator = _createForOfIteratorHelper(requests),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var request = _step.value;
+          var _response = kb.any(request, this.ns.link('response'), null, meta);
+          if (_response !== undefined) {
+            // ts
+            kb.add(_response, this.ns.link('outOfDate'), true, meta); // @@ Boolean is fine - fix types
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
+    }
+
     /**
      * Tests whether a file is editable.
      * If the file has a specific annotation that it is machine written,
      * for safety, it is editable (this doesn't actually check for write access)
      * If the file has wac-allow and accept patch headers, those are respected.
      * and local write access is determined by those headers.
-     * This version only looks at past HTTP requests, does not make new ones.
+     * 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
+     *   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 = 6;
+                break;
+              }
+              return _context.abrupt("return", initial);
+            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 10:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function checkEditable(_x, _x2) {
+        return _checkEditable.apply(this, arguments);
+      }
+      return checkEditable;
+    }()
+    /**
+     * Tests whether a file is editable.
+     * If the file has a specific annotation that it is machine written,
+     * for safety, it is editable (this doesn't actually check for write access)
+     * If the file has wac-allow and accept patch headers, those are respected.
+     * and local write access is determined by those headers.
+     * This synchronous version only looks at past HTTP requests, does not make new ones.
      *
      * @returns The method string SPARQL or DAV or
      *   LOCALFILE or false if known, undefined if not known.
@@ -90,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
       }
@@ -99,27 +187,34 @@ var UpdateManager = /*#__PURE__*/function () {
       }
       uri = termValue(uri);
       if (!this.isHttpUri(uri)) {
-        if (kb.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 = (_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?
-      var requests = kb.each(undefined, this.ns.link('requestedURI'), docpart(uri));
+      var requests = kb.each(undefined, this.ns.link('requestedURI'), docpart(uri), meta);
       var method;
       for (var r = 0; r < requests.length; r++) {
         request = requests[r];
         if (request !== undefined) {
-          var response = kb.any(request, this.ns.link('response'));
-          if (request !== undefined) {
-            var wacAllow = kb.anyValue(response, this.ns.httph('wac-allow'));
+          var _response2 = kb.any(request, this.ns.link('response'), null, meta);
+          if (_response2 !== undefined) {
+            // ts
+
+            var outOfDate = kb.anyJS(_response2, this.ns.link('outOfDate'), null, meta);
+            if (outOfDate) continue;
+            var wacAllow = kb.anyValue(_response2, this.ns.httph('wac-allow'));
             if (wacAllow) {
-              var _iterator = _createForOfIteratorHelper(wacAllow.split(',')),
-                _step;
+              var _iterator2 = _createForOfIteratorHelper(wacAllow.split(',')),
+                _step2;
               try {
-                for (_iterator.s(); !(_step = _iterator.n()).done;) {
-                  var bit = _step.value;
+                for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+                  var bit = _step2.value;
                   var lr = bit.split('=');
                   if (lr[0].includes('user') && !lr[1].includes('write') && !lr[1].includes('append')) {
                     // console.log('    editable? excluded by WAC-Allow: ', wacAllow)
@@ -127,12 +222,12 @@ var UpdateManager = /*#__PURE__*/function () {
                   }
                 }
               } catch (err) {
-                _iterator.e(err);
+                _iterator2.e(err);
               } finally {
-                _iterator.f();
+                _iterator2.f();
               }
             }
-            var acceptPatch = kb.each(response, this.ns.httph('accept-patch'));
+            var acceptPatch = kb.each(_response2, this.ns.httph('accept-patch'));
             if (acceptPatch.length) {
               for (var i = 0; i < acceptPatch.length; i++) {
                 method = acceptPatch[i].value.trim();
@@ -140,7 +235,7 @@ var UpdateManager = /*#__PURE__*/function () {
                 if (method.indexOf('application/sparql-update-single-match') >= 0) return 'SPARQL';
               }
             }
-            var authorVia = kb.each(response, this.ns.httph('ms-author-via'));
+            var authorVia = kb.each(_response2, this.ns.httph('ms-author-via'));
             if (authorVia.length) {
               for (var _i = 0; _i < authorVia.length; _i++) {
                 method = authorVia[_i].value.trim();
@@ -155,7 +250,7 @@ var UpdateManager = /*#__PURE__*/function () {
             if (!this.isHttpUri(uri)) {
               if (!wacAllow) return false;else return 'LOCALFILE';
             }
-            var status = kb.each(response, this.ns.http('status'));
+            var status = kb.each(_response2, this.ns.http('status'));
             if (status.length) {
               for (var _i2 = 0; _i2 < status.length; _i2++) {
                 // @ts-ignore since statuses should be TFTerms, this should always be false

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;

package/lib/fetcher.d.ts

@@ -181,7 +181,7 @@ export default class Fetcher implements CallbackifyInterface {
     _fetch: Fetch;
     mediatypes: MediatypesMap;
     /** Denoting this session */
-    appNode: BlankNode;
+    appNode: NamedNode;
     /**
      * this.requested[uri] states:
      * undefined     no record of web access or records reset

package/lib/fetcher.js

@@ -32,8 +32,34 @@ var _termValue = require("./utils/termValue");
 var _jsonldparser = _interopRequireDefault(require("./jsonldparser"));
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { default: obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj.default = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
+function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
+function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
+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; }
 function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = (0, _getPrototypeOf2.default)(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = (0, _getPrototypeOf2.default)(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return (0, _possibleConstructorReturn2.default)(this, result); }; }
-function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } } /* global $SolidTestEnvironment */ /**
+                                                                                                                                                                                                                                                                                                                                                                              *
+                                                                                                                                                                                                                                                                                                                                                                              * Project: rdflib.js
+                                                                                                                                                                                                                                                                                                                                                                              *
+                                                                                                                                                                                                                                                                                                                                                                              * @file: fetcher.js
+                                                                                                                                                                                                                                                                                                                                                                              *
+                                                                                                                                                                                                                                                                                                                                                                              * Description: contains functions for requesting/fetching/retracting
+                                                                                                                                                                                                                                                                                                                                                                              *  This implements quite a lot of the web architecture.
+                                                                                                                                                                                                                                                                                                                                                                              * A fetcher is bound to a specific quad store, into which
+                                                                                                                                                                                                                                                                                                                                                                              * it loads stuff and into which it writes its metadata
+                                                                                                                                                                                                                                                                                                                                                                              * @@ The metadata could be optionally a separate graph
+                                                                                                                                                                                                                                                                                                                                                                              *
+                                                                                                                                                                                                                                                                                                                                                                              * - implements semantics of HTTP headers, Internet Content Types
+                                                                                                                                                                                                                                                                                                                                                                              * - selects parsers for rdf/xml, n3, rdfa, grddl
+                                                                                                                                                                                                                                                                                                                                                                              *
+                                                                                                                                                                                                                                                                                                                                                                              * TO do:
+                                                                                                                                                                                                                                                                                                                                                                              * - Implement a runtime registry for parsers and serializers
+                                                                                                                                                                                                                                                                                                                                                                              * -
+                                                                                                                                                                                                                                                                                                                                                                              */ /**
+                                                                                                                                                                                                                                                                                                                                                                                  * Things to test: callbacks on request, refresh, retract
+                                                                                                                                                                                                                                                                                                                                                                                  *   loading from HTTP, HTTPS, FTP, FILE, others?
+                                                                                                                                                                                                                                                                                                                                                                                  * To do:
+                                                                                                                                                                                                                                                                                                                                                                                  * Firing up a mail client for mid:  (message:) URLs
+                                                                                                                                                                                                                                                                                                                                                                                  */
 var Parsable = {
   'text/n3': true,
   'text/turtle': true,
@@ -73,14 +99,19 @@ var getNS = function getNS(factory) {
   };
 };
 var ns = getNS();
-var Handler = /*#__PURE__*/(0, _createClass2.default)(
-// TODO: Document, type
 
-// TODO: Document, type
+/** An extended interface of Response, since RDFlib.js adds some properties. */
 
-function Handler(response, dom) {
+/** tell typescript that a 'panes' child may exist on Window */
+
+/** All valid inputs for initFetchOptions */
+
+/** Initiated by initFetchOptions, which runs on load */
+var Handler = /*#__PURE__*/(0, _createClass2.default)(function Handler(response, dom) {
   (0, _classCallCheck2.default)(this, Handler);
+  // TODO: Document, type
   (0, _defineProperty2.default)(this, "response", void 0);
+  // TODO: Document, type
   (0, _defineProperty2.default)(this, "dom", void 0);
   this.response = response;
   // The type assertion operator here might need to be removed.
@@ -516,6 +547,10 @@ function isXMLNS(responseText) {
   var match = responseText.match(/[^(<html)]*<html\s+[^<]*xmlns=['"]http:\/\/www.w3.org\/1999\/xhtml["'][^<]*>/);
   return !!match;
 }
+
+// Not sure about the shapes of this. Response? FetchError?
+
+/** Differs from normal Fetch, has an extended Response type */
 /** Fetcher
  *
  * The Fetcher object is a helper object for a quadstore
@@ -525,34 +560,6 @@ function isXMLNS(responseText) {
   * and put back the data to the web.
  */
 var Fetcher = /*#__PURE__*/function () {
-  /** Denoting this session */
-
-  /**
-   * this.requested[uri] states:
-   * undefined     no record of web access or records reset
-   * true          has been requested, fetch in progress
-   * 'done'        received, Ok
-   * 401           Not logged in
-   * 403           HTTP status unauthorized
-   * 404           Resource does not exist. Can be created etc.
-   * 'redirected'  In attempt to counter CORS problems retried.
-   * 'parse_error' Parse error
-   * 'unsupported_protocol'  URI is not a protocol Fetcher can deal with
-   * other strings mean various other errors.
-   */
-
-  /** List of timeouts associated with a requested URL */
-
-  /** Redirected from *key uri* to *value uri* */
-
-  /** fetchCallbacks[uri].push(callback) */
-
-  /** Keep track of explicit 404s -> we can overwrite etc */
-
-  // TODO: Document this
-
-  /** Methods added by calling Util.callbackify in the constructor*/
-
   function Fetcher(store) {
     var _this = this;
     var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
@@ -561,16 +568,35 @@ var Fetcher = /*#__PURE__*/function () {
     (0, _defineProperty2.default)(this, "timeout", void 0);
     (0, _defineProperty2.default)(this, "_fetch", void 0);
     (0, _defineProperty2.default)(this, "mediatypes", void 0);
+    /** Denoting this session */
     (0, _defineProperty2.default)(this, "appNode", void 0);
+    /**
+     * this.requested[uri] states:
+     * undefined     no record of web access or records reset
+     * true          has been requested, fetch in progress
+     * 'done'        received, Ok
+     * 401           Not logged in
+     * 403           HTTP status unauthorized
+     * 404           Resource does not exist. Can be created etc.
+     * 'redirected'  In attempt to counter CORS problems retried.
+     * 'parse_error' Parse error
+     * 'unsupported_protocol'  URI is not a protocol Fetcher can deal with
+     * other strings mean various other errors.
+     */
     (0, _defineProperty2.default)(this, "requested", void 0);
+    /** List of timeouts associated with a requested URL */
     (0, _defineProperty2.default)(this, "timeouts", void 0);
+    /** Redirected from *key uri* to *value uri* */
     (0, _defineProperty2.default)(this, "redirectedTo", void 0);
     (0, _defineProperty2.default)(this, "fetchQueue", void 0);
+    /** fetchCallbacks[uri].push(callback) */
     (0, _defineProperty2.default)(this, "fetchCallbacks", void 0);
+    /** Keep track of explicit 404s -> we can overwrite etc */
     (0, _defineProperty2.default)(this, "nonexistent", void 0);
     (0, _defineProperty2.default)(this, "lookedUp", void 0);
     (0, _defineProperty2.default)(this, "handlers", void 0);
     (0, _defineProperty2.default)(this, "ns", void 0);
+    /** Methods added by calling Util.callbackify in the constructor*/
     (0, _defineProperty2.default)(this, "fireCallbacks", void 0);
     this.store = store || new _store.default();
     this.ns = getNS(this.store.rdfFactory);
@@ -581,7 +607,9 @@ var Fetcher = /*#__PURE__*/function () {
     if (!this._fetch) {
       throw new Error('No _fetch function available for Fetcher');
     }
-    this.appNode = this.store.rdfFactory.blankNode();
+    // This is the name of the graph we store all the HTTP metadata in
+    this.appNode = this.store.sym('chrome://TheCurrentSession');
+    // this.appNode = this.store.rdfFactory.blankNode() // Needs to have a URI in tests
     this.store.fetcher = this; // Bi-linked
     this.requested = {};
     this.timeouts = {};
@@ -669,6 +697,31 @@ var Fetcher = /*#__PURE__*/function () {
       var docuri = (0, _termValue.termValue)(uriIn);
       docuri = docuri.split('#')[0];
       options = this.initFetchOptions(docuri, options);
+      // if metadata flaged clear cache and removeDocument
+      var meta = this.appNode;
+      var kb = this.store;
+      var requests = kb.statementsMatching(undefined, this.ns.link('requestedURI'), kb.sym(docuri), meta).map(function (st) {
+        return st.subject;
+      });
+      var _iterator = _createForOfIteratorHelper(requests),
+        _step;
+      try {
+        for (_iterator.s(); !(_step = _iterator.n()).done;) {
+          var request = _step.value;
+          var _response = kb.any(request, this.ns.link('response'), null, meta);
+          if (_response !== undefined) {
+            // ts
+            var quad = kb.statementsMatching(_response, this.ns.link('outOfDate'), true, meta);
+            kb.remove(quad);
+            options.force = true;
+            options.clearPreviousData = true;
+          }
+        }
+      } catch (err) {
+        _iterator.e(err);
+      } finally {
+        _iterator.f();
+      }
       var initialisedOptions = this.initFetchOptions(docuri, options);
       return this.pendingFetchPromise(docuri, initialisedOptions.baseURI, initialisedOptions);
     }
@@ -1371,10 +1424,10 @@ var Fetcher = /*#__PURE__*/function () {
       for (var r = 0; r < requests.length; r++) {
         var request = requests[r];
         if (request !== undefined) {
-          var _response = kb.any(request, this.ns.link('response'));
-          if (_response !== undefined && kb.anyValue(_response, this.ns.http('status')) && kb.anyValue(_response, this.ns.http('status')).startsWith('2')) {
+          var _response2 = kb.any(request, this.ns.link('response'));
+          if (_response2 !== undefined && kb.anyValue(_response2, this.ns.http('status')) && kb.anyValue(_response2, this.ns.http('status')).startsWith('2')) {
             // Only look at success returns - not 401 error messagess etc
-            var results = kb.each(_response, this.ns.httph(header.toLowerCase()));
+            var results = kb.each(_response2, this.ns.httph(header.toLowerCase()));
             if (results.length) {
               return results.map(function (v) {
                 return v.value;
@@ -1413,17 +1466,19 @@ var Fetcher = /*#__PURE__*/function () {
       var _this10 = this;
       var kb = this.store;
       var responseNode = kb.bnode();
-      kb.add(options.req, this.ns.link('response'), responseNode, responseNode);
-      kb.add(responseNode, this.ns.http('status'), kb.rdfFactory.literal(response.status), responseNode);
-      kb.add(responseNode, this.ns.http('statusText'), kb.rdfFactory.literal(response.statusText), responseNode);
+      kb.add(options.req, this.ns.link('response'), responseNode, this.appNode);
+      kb.add(responseNode, this.ns.http('status'), kb.rdfFactory.literal(response.status), this.appNode);
+      kb.add(responseNode, this.ns.http('statusText'), kb.rdfFactory.literal(response.statusText), this.appNode);
 
       // Save the response headers
       response.headers.forEach(function (value, header) {
-        kb.add(responseNode, _this10.ns.httph(header), _this10.store.rdfFactory.literal(value), responseNode);
+        kb.add(responseNode, _this10.ns.httph(header), _this10.store.rdfFactory.literal(value), _this10.appNode);
         if (header === 'content-type') {
-          kb.add(options.resource, _this10.ns.rdf('type'), kb.rdfFactory.namedNode(Util.mediaTypeClass(value).value), responseNode);
+          kb.add(options.resource, _this10.ns.rdf('type'), kb.rdfFactory.namedNode(Util.mediaTypeClass(value).value), _this10.appNode // responseNode
+          );
         }
       });
+
       return responseNode;
     }
   }, {
@@ -1935,6 +1990,7 @@ var Fetcher = /*#__PURE__*/function () {
 exports.default = Fetcher;
 (0, _defineProperty2.default)(Fetcher, "HANDLERS", void 0);
 (0, _defineProperty2.default)(Fetcher, "CONTENT_TYPE_BY_EXT", void 0);
+// TODO: Document this
 (0, _defineProperty2.default)(Fetcher, "crossSiteProxyTemplate", void 0);
 Fetcher.HANDLERS = defaultHandlers;
 Fetcher.CONTENT_TYPE_BY_EXT = CONTENT_TYPE_BY_EXT;

package/lib/formula.js

@@ -35,19 +35,6 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Re
 var Formula = /*#__PURE__*/function (_Node) {
   (0, _inherits2.default)(Formula, _Node);
   var _super = _createSuper(Formula);
-  /**
-   * The accompanying fetcher instance.
-   *
-   * Is set by the fetcher when initialized.
-   */
-
-  /**
-   * A namespace for the specified namespace's URI
-   * @param nsuri The URI for the namespace
-   */
-
-  /** The factory used to generate statements and terms */
-
   /**
    * Initializes this formula
    * @constructor
@@ -73,9 +60,19 @@ var Formula = /*#__PURE__*/function (_Node) {
     _this.optional = optional;
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "termType", _types.GraphTermType);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "classOrder", _classOrder.default.Graph);
+    /**
+     * The accompanying fetcher instance.
+     *
+     * Is set by the fetcher when initialized.
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "fetcher", void 0);
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "isVar", 0);
+    /**
+     * A namespace for the specified namespace's URI
+     * @param nsuri The URI for the namespace
+     */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "ns", _namespace.default);
+    /** The factory used to generate statements and terms */
     (0, _defineProperty2.default)((0, _assertThisInitialized2.default)(_this), "rdfFactory", void 0);
     _this.rdfFactory = opts && opts.rdfFactory || _canonicalDataFactory.default;
     // Enable default factory methods on this while preserving factory context.

package/lib/index.d.ts

@@ -30,7 +30,7 @@ import Variable from './variable';
 import DataFactory from './factories/rdflib-data-factory';
 declare const fetcher: (store: Store, options: any) => Fetcher, graph: (features?: any, opts?: any) => Store, lit: (val: string, lang?: string | undefined, dt?: import("./tf-types").NamedNode | undefined) => Literal, st: (subject: import("./tf-types").Quad_Subject, predicate: import("./tf-types").Quad_Predicate, object: import("./tf-types").Quad_Object, graph?: import("./tf-types").Quad_Graph | undefined) => Statement<import("./types").SubjectType, import("./types").PredicateType, import("./types").ObjectType, import("./types").GraphType>, namedNode: (value: string) => NamedNode, variable: (value: string) => Variable, blankNode: (value?: string | undefined) => BlankNode, defaultGraph: () => import("./default-graph").default, literal: (value: string, languageOrDatatype?: string | import("./tf-types").NamedNode | undefined) => Literal, quad: (subject: import("./tf-types").Term, predicate: import("./tf-types").Term, object: import("./tf-types").Term, graph?: import("./tf-types").Term | undefined) => Statement<import("./types").SubjectType, import("./types").PredicateType, import("./types").ObjectType, import("./types").GraphType>, triple: (subject: import("./tf-types").Term, predicate: import("./tf-types").Term, object: import("./tf-types").Term, graph?: import("./tf-types").Term | undefined) => import("./tf-types").Quad<any, any, any, any>;
 declare const fromNT: (str: any) => any;
-declare const term: <T extends import("./types").FromValueReturns<any>>(value: import("./types").ValueType) => T;
+declare const term: <T extends import("./types").FromValueReturns>(value: import("./types").ValueType) => T;
 declare const NextId: number;
 export * from './utils/terms';
 export type { AutoInitOptions, ExtendedResponse, FetchError } from './fetcher';