@pod-os/core 0.18.1-rc.d8b7ee4.0 → 0.18.1-rc.f02795a.0

package/dist/{chunk-3LTXZPFZ.js → chunk-S4UXBIES.js}

@@ -14259,16 +14259,13 @@ function listToCollection(kb, obj) {
   }
   return kb.rdfFactory.collection(obj.map((o) => jsonldObjectToTerm(kb, o)));
 }
-function jsonldParser(str, kb, base, callback) {
+async function jsonldParser(str, kb, base) {
   const baseString = base && Object.prototype.hasOwnProperty.call(base, "termType") ? base.value : base;
-  return import("./jsonld-X74JI4TL.js").then((jsonld) => {
-    return jsonld.flatten(JSON.parse(str), null, {
-      base: baseString
-    });
-  }).then((flattened) => flattened.reduce((store, flatResource) => {
-    kb = processResource(kb, base, flatResource);
-    return kb;
-  }, kb)).then(callback).catch(callback);
+  const jsonld = await import("./jsonld-X74JI4TL.js");
+  const flattened = await jsonld.default.flatten(JSON.parse(str), null, {
+    base: baseString
+  });
+  return flattened.reduce((store, flatResource) => processResource(store, base, flatResource), kb);
 }
 function nodeType(kb, obj) {
   if (obj["@id"].startsWith("_:")) {
@@ -18665,7 +18662,7 @@ function parse2(str, kb, base) {
       sparqlUpdateParser(str, kb, base);
       executeCallback();
     } else if (contentType === JSONLDContentType) {
-      jsonldParser(str, kb, base, executeCallback);
+      jsonldParser(str, kb, base).then(executeCallback).catch(executeErrorCallback);
     } else if (contentType === NQuadsContentType || contentType === NQuadsAltContentType) {
       var n3Parser = new N3Parser({
         factory: extended_term_factory_default
@@ -20925,7 +20922,8 @@ var IndexedFormula = class _IndexedFormula extends Formula {
     _defineProperty(this, "_universalVariables", void 0);
     _defineProperty(this, "_existentialVariables", void 0);
     _defineProperty(this, "rdfArrayRemove", void 0);
-    _defineProperty(this, "dataCallbacks", void 0);
+    _defineProperty(this, "dataCallbacks", []);
+    _defineProperty(this, "dataRemovalCallbacks", []);
     this.propertyActions = {};
     this.classActions = {};
     this.redirections = [];
@@ -20948,6 +20946,9 @@ var IndexedFormula = class _IndexedFormula extends Formula {
     if (opts.dataCallback) {
       this.dataCallbacks = [opts.dataCallback];
     }
+    if (opts.dataRemovalCallback) {
+      this.dataRemovalCallbacks = [opts.dataRemovalCallback];
+    }
     this.initPropertyActions(this.features);
   }
   /**
@@ -20973,11 +20974,11 @@ var IndexedFormula = class _IndexedFormula extends Formula {
    * @param cb
    */
   addDataCallback(cb) {
-    if (!this.dataCallbacks) {
-      this.dataCallbacks = [];
-    }
     this.dataCallbacks.push(cb);
   }
+  addDataRemovalCallback(cb) {
+    this.dataRemovalCallbacks.push(cb);
+  }
   /**
    * Apply a set of statements to be deleted and to be inserted
    *
@@ -21155,10 +21156,8 @@ var IndexedFormula = class _IndexedFormula extends Formula {
       ix[h].push(st2);
     }
     this.statements.push(st2);
-    if (this.dataCallbacks) {
-      for (const callback of this.dataCallbacks) {
-        callback(st2);
-      }
+    for (const callback of this.dataCallbacks) {
+      callback(st2);
     }
     return st2;
   }
@@ -21554,6 +21553,9 @@ var IndexedFormula = class _IndexedFormula extends Formula {
       }
     }
     this.rdfArrayRemove(this.statements, st2);
+    for (const callback of this.dataRemovalCallbacks) {
+      callback(st2);
+    }
     return this;
   }
   /**
@@ -21832,7 +21834,9 @@ var XHTMLHandler = class extends Handler {
     return "XHTMLHandler";
   }
   static register(fetcher2) {
-    fetcher2.mediatypes[XHTMLContentType] = {};
+    fetcher2.mediatypes[XHTMLContentType] = {
+      "q": 0.8
+    };
   }
   parse(fetcher2, responseText, options) {
     let relation, reverse;
@@ -21934,7 +21938,7 @@ var HTMLHandler = class extends Handler {
   }
   static register(fetcher2) {
     fetcher2.mediatypes["text/html"] = {
-      "q": 0.9
+      "q": 0.8
     };
   }
   parse(fetcher2, responseText, options) {
@@ -21973,21 +21977,19 @@ var JsonLdHandler = class extends Handler {
       "q": 0.9
     };
   }
-  parse(fetcher2, responseText, options, response) {
+  async parse(fetcher2, responseText, options, response) {
     const kb = fetcher2.store;
-    return new Promise((resolve, reject) => {
-      try {
-        jsonldParser(responseText, kb, options.original.value, () => {
-          resolve(fetcher2.doneFetch(options, response));
-        });
-      } catch (err) {
-        const msg = "Error trying to parse " + options.resource + " as JSON-LD:\n" + err;
-        resolve(fetcher2.failFetch(options, msg, "parse_error", response));
-      }
-    });
+    try {
+      await jsonldParser(responseText, kb, options.original.value);
+      fetcher2.store.add(options.original, ns2.rdf("type"), ns2.link("RDFDocument"), fetcher2.appNode);
+      return fetcher2.doneFetch(options, response);
+    } catch (err) {
+      const msg = "Error trying to parse " + options.resource + " as JSON-LD:\n" + err;
+      return fetcher2.failFetch(options, msg, "parse_error", response);
+    }
   }
 };
-JsonLdHandler.pattern = /application\/ld\+json/;
+JsonLdHandler.pattern = /application\/(ld\+json|activity\+json)/;
 var TextHandler = class extends Handler {
   static toString() {
     return "TextHandler";
@@ -22018,12 +22020,8 @@ var N3Handler = class extends Handler {
     return "N3Handler";
   }
   static register(fetcher2) {
-    fetcher2.mediatypes["text/n3"] = {
-      "q": "1.0"
-    };
-    fetcher2.mediatypes["text/turtle"] = {
-      "q": 1
-    };
+    fetcher2.mediatypes["text/n3"] = {};
+    fetcher2.mediatypes["text/turtle"] = {};
   }
   parse(fetcher2, responseText, options, response) {
     let kb = fetcher2.store;
@@ -22297,7 +22295,7 @@ var Fetcher = class _Fetcher {
     options.baseURI = options.baseURI || uri;
     options.original = kb.rdfFactory.namedNode(options.baseURI);
     options.req = kb.bnode();
-    options.headers = options.headers || new import_cross_fetch.Headers();
+    options.headers = options.headers || {};
     if (options.contentType) {
       options.headers["content-type"] = options.contentType;
     }

package/dist/{dist-4BQLT63G.js → dist-O5YU2L4C.js}

@@ -5,7 +5,7 @@ import {
   namedNode,
   require_short_unique_id,
   st
-} from "./chunk-3LTXZPFZ.js";
+} from "./chunk-S4UXBIES.js";
 import {
   __toESM
 } from "./chunk-U67V476Y.js";

package/dist/index.js

@@ -13,7 +13,7 @@ import {
   serialize,
   st,
   termValue
-} from "./chunk-3LTXZPFZ.js";
+} from "./chunk-S4UXBIES.js";
 import {
   __commonJS,
   __export,
@@ -2752,7 +2752,7 @@ var FileFetcher = class {
 
 // src/modules/contacts.ts
 async function loadContactsModule(store) {
-  const module2 = await import("./dist-4BQLT63G.js");
+  const module2 = await import("./dist-O5YU2L4C.js");
   return store.loadModule(module2);
 }
 
@@ -2821,6 +2821,12 @@ var Thing = class {
     this.store = store;
     this.editable = editable;
   }
+  /**
+   * Returns a human-readable label for this thing. Tries to match common RDF terms
+   * used for labels, such as `rdfs:label`, `schema:name` and others.
+   *
+   * If no such term is present, it will derive a label from the URI.
+   */
   label() {
     const value7 = this.anyValue(
       "http://www.w3.org/2006/vcard/ns#fn",
@@ -2840,6 +2846,9 @@ var Thing = class {
     }
     return labelFromUri(this.uri);
   }
+  /**
+   * Returns all the literal values that are linked to this thing
+   */
   literals() {
     const statements = this.store.statementsMatching(namedNode(this.uri));
     const values2 = statements.filter((it) => isLiteral(it.object)).reduce(accumulateValues, {});
@@ -2849,6 +2858,9 @@ var Thing = class {
       values: values2[predicate4]
     }));
   }
+  /**
+   * Returns all the links from this thing to other resources
+   */
   relations(predicate4) {
     const statements = this.store.statementsMatching(
       namedNode(this.uri),
@@ -2861,6 +2873,9 @@ var Thing = class {
       uris: values2[predicate5]
     }));
   }
+  /**
+   * Returns all the links from other resources to this thing
+   */
   reverseRelations(predicate4) {
     const statements = this.store.statementsMatching(
       void 0,
@@ -2874,6 +2889,10 @@ var Thing = class {
       uris: values2[predicate5]
     }));
   }
+  /**
+   * Returns any value linked from this thing via one of the given predicates
+   * @param predicateUris
+   */
   anyValue(...predicateUris) {
     let value7;
     predicateUris.some((it) => {
@@ -2882,6 +2901,10 @@ var Thing = class {
     });
     return value7;
   }
+  /**
+   * Returns a literal value that describes this thing. Tries to match common RDF terms
+   * used for descriptions, like `dct:description`, `schema:description` or `rdfs:comment`
+   */
   description() {
     return this.anyValue(
       "http://purl.org/dc/terms/description",
@@ -2895,6 +2918,13 @@ var Thing = class {
       "http://www.w3.org/2006/vcard/ns#note"
     );
   }
+  /**
+   * Returns the url of a picture or logo associated with this thing
+   * Tries to match common RDF terms used for pictures like `schema:image`,
+   * `vcard:photo` or `foaf:img`
+   *
+   * @return {Object} An object containing the `url` of the picture
+   */
   picture() {
     const directUrl = this.anyValue(
       "http://schema.org/image",
@@ -2936,6 +2966,9 @@ var Thing = class {
       url: url7
     } : null;
   }
+  /**
+   * Retrieves a list of RDF types for this thing.
+   */
   types() {
     const uriMap = this.store.findTypeURIs(namedNode(this.uri));
     return Object.keys(uriMap).map((uri6) => ({
@@ -2943,6 +2976,11 @@ var Thing = class {
       label: labelForType(uri6)
     }));
   }
+  /**
+   * Call this method to switch to a more specific subclass of Thing.
+   *
+   * @param SpecificThing - a subclass of Thing to assume
+   */
   assume(SpecificThing) {
     return new SpecificThing(this.uri, this.store, this.editable);
   }
@@ -3175,7 +3213,7 @@ var SearchGateway = class {
   }
   /**
    * Fetch the private label index for the given profile and build a search index from it
-   * @param webId
+   * @param profile
    */
   async buildSearchIndex(profile2) {
     const labelIndexUris = profile2.getPrivateLabelIndexes();
@@ -24836,7 +24874,7 @@ var PodOS = class {
   }
   /**
    * Fetch the private label index for the given profile and build a search index from it
-   * @param webId
+   * @param profile
    */
   async buildSearchIndex(profile2) {
     return this.searchGateway.buildSearchIndex(profile2);
@@ -24883,7 +24921,9 @@ export {
   RdfDocument,
   SearchGateway,
   SearchIndex,
+  Store,
   Thing,
+  UriService,
   WebIdProfile,
   labelFromUri,
   listKnownTerms

package/lib/index.js

@@ -12948,7 +12948,8 @@ var PodOS = (() => {
           _defineProperty(this, "_universalVariables", void 0);
           _defineProperty(this, "_existentialVariables", void 0);
           _defineProperty(this, "rdfArrayRemove", void 0);
-          _defineProperty(this, "dataCallbacks", void 0);
+          _defineProperty(this, "dataCallbacks", []);
+          _defineProperty(this, "dataRemovalCallbacks", []);
           this.propertyActions = {};
           this.classActions = {};
           this.redirections = [];
@@ -12971,6 +12972,9 @@ var PodOS = (() => {
           if (opts.dataCallback) {
             this.dataCallbacks = [opts.dataCallback];
           }
+          if (opts.dataRemovalCallback) {
+            this.dataRemovalCallbacks = [opts.dataRemovalCallback];
+          }
           this.initPropertyActions(this.features);
         }
         /**
@@ -12996,11 +13000,11 @@ var PodOS = (() => {
          * @param cb
          */
         addDataCallback(cb) {
-          if (!this.dataCallbacks) {
-            this.dataCallbacks = [];
-          }
           this.dataCallbacks.push(cb);
         }
+        addDataRemovalCallback(cb) {
+          this.dataRemovalCallbacks.push(cb);
+        }
         /**
          * Apply a set of statements to be deleted and to be inserted
          *
@@ -13178,10 +13182,8 @@ var PodOS = (() => {
             ix[h].push(st2);
           }
           this.statements.push(st2);
-          if (this.dataCallbacks) {
-            for (const callback of this.dataCallbacks) {
-              callback(st2);
-            }
+          for (const callback of this.dataCallbacks) {
+            callback(st2);
           }
           return st2;
         }
@@ -13577,6 +13579,9 @@ var PodOS = (() => {
             }
           }
           this.rdfArrayRemove(this.statements, st2);
+          for (const callback of this.dataRemovalCallbacks) {
+            callback(st2);
+          }
           return this;
         }
         /**
@@ -23676,16 +23681,13 @@ var PodOS = (() => {
     }
     return kb.rdfFactory.collection(obj.map((o) => jsonldObjectToTerm(kb, o)));
   }
-  function jsonldParser(str, kb, base2, callback) {
+  async function jsonldParser(str, kb, base2) {
     const baseString = base2 && Object.prototype.hasOwnProperty.call(base2, "termType") ? base2.value : base2;
-    return Promise.resolve().then(() => __toESM(require_jsonld())).then((jsonld) => {
-      return jsonld.flatten(JSON.parse(str), null, {
-        base: baseString
-      });
-    }).then((flattened) => flattened.reduce((store, flatResource) => {
-      kb = processResource(kb, base2, flatResource);
-      return kb;
-    }, kb)).then(callback).catch(callback);
+    const jsonld = await Promise.resolve().then(() => __toESM(require_jsonld()));
+    const flattened = await jsonld.default.flatten(JSON.parse(str), null, {
+      base: baseString
+    });
+    return flattened.reduce((store, flatResource) => processResource(store, base2, flatResource), kb);
   }
   function nodeType(kb, obj) {
     if (obj["@id"].startsWith("_:")) {
@@ -28577,7 +28579,7 @@ var PodOS = (() => {
         sparqlUpdateParser(str, kb, base2);
         executeCallback();
       } else if (contentType4 === JSONLDContentType) {
-        jsonldParser(str, kb, base2, executeCallback);
+        jsonldParser(str, kb, base2).then(executeCallback).catch(executeErrorCallback);
       } else if (contentType4 === NQuadsContentType || contentType4 === NQuadsAltContentType) {
         var n3Parser = new N3Parser({
           factory: extended_term_factory_default
@@ -29327,7 +29329,9 @@ var PodOS = (() => {
           return "XHTMLHandler";
         }
         static register(fetcher2) {
-          fetcher2.mediatypes[XHTMLContentType] = {};
+          fetcher2.mediatypes[XHTMLContentType] = {
+            "q": 0.8
+          };
         }
         parse(fetcher2, responseText, options) {
           let relation4, reverse;
@@ -29429,7 +29433,7 @@ var PodOS = (() => {
         }
         static register(fetcher2) {
           fetcher2.mediatypes["text/html"] = {
-            "q": 0.9
+            "q": 0.8
           };
         }
         parse(fetcher2, responseText, options) {
@@ -29468,21 +29472,19 @@ var PodOS = (() => {
             "q": 0.9
           };
         }
-        parse(fetcher2, responseText, options, response6) {
+        async parse(fetcher2, responseText, options, response6) {
           const kb = fetcher2.store;
-          return new Promise((resolve, reject) => {
-            try {
-              jsonldParser(responseText, kb, options.original.value, () => {
-                resolve(fetcher2.doneFetch(options, response6));
-              });
-            } catch (err) {
-              const msg = "Error trying to parse " + options.resource + " as JSON-LD:\n" + err;
-              resolve(fetcher2.failFetch(options, msg, "parse_error", response6));
-            }
-          });
+          try {
+            await jsonldParser(responseText, kb, options.original.value);
+            fetcher2.store.add(options.original, ns2.rdf("type"), ns2.link("RDFDocument"), fetcher2.appNode);
+            return fetcher2.doneFetch(options, response6);
+          } catch (err) {
+            const msg = "Error trying to parse " + options.resource + " as JSON-LD:\n" + err;
+            return fetcher2.failFetch(options, msg, "parse_error", response6);
+          }
         }
       };
-      JsonLdHandler.pattern = /application\/ld\+json/;
+      JsonLdHandler.pattern = /application\/(ld\+json|activity\+json)/;
       TextHandler = class extends Handler {
         static toString() {
           return "TextHandler";
@@ -29513,12 +29515,8 @@ var PodOS = (() => {
           return "N3Handler";
         }
         static register(fetcher2) {
-          fetcher2.mediatypes["text/n3"] = {
-            "q": "1.0"
-          };
-          fetcher2.mediatypes["text/turtle"] = {
-            "q": 1
-          };
+          fetcher2.mediatypes["text/n3"] = {};
+          fetcher2.mediatypes["text/turtle"] = {};
         }
         parse(fetcher2, responseText, options, response6) {
           let kb = fetcher2.store;
@@ -29776,7 +29774,7 @@ var PodOS = (() => {
           options.baseURI = options.baseURI || uri6;
           options.original = kb.rdfFactory.namedNode(options.baseURI);
           options.req = kb.bnode();
-          options.headers = options.headers || new import_cross_fetch.Headers();
+          options.headers = options.headers || {};
           if (options.contentType) {
             options.headers["content-type"] = options.contentType;
           }
@@ -34756,7 +34754,9 @@ _:patch
     RdfDocument: () => RdfDocument,
     SearchGateway: () => SearchGateway,
     SearchIndex: () => SearchIndex,
+    Store: () => Store,
     Thing: () => Thing,
+    UriService: () => UriService,
     WebIdProfile: () => WebIdProfile,
     labelFromUri: () => labelFromUri,
     listKnownTerms: () => listKnownTerms
@@ -35789,6 +35789,12 @@ _:patch
       this.store = store;
       this.editable = editable;
     }
+    /**
+     * Returns a human-readable label for this thing. Tries to match common RDF terms
+     * used for labels, such as `rdfs:label`, `schema:name` and others.
+     *
+     * If no such term is present, it will derive a label from the URI.
+     */
     label() {
       const value7 = this.anyValue(
         "http://www.w3.org/2006/vcard/ns#fn",
@@ -35808,6 +35814,9 @@ _:patch
       }
       return labelFromUri(this.uri);
     }
+    /**
+     * Returns all the literal values that are linked to this thing
+     */
     literals() {
       const statements = this.store.statementsMatching(namedNode(this.uri));
       const values2 = statements.filter((it) => isLiteral(it.object)).reduce(accumulateValues, {});
@@ -35817,6 +35826,9 @@ _:patch
         values: values2[predicate4]
       }));
     }
+    /**
+     * Returns all the links from this thing to other resources
+     */
     relations(predicate4) {
       const statements = this.store.statementsMatching(
         namedNode(this.uri),
@@ -35829,6 +35841,9 @@ _:patch
         uris: values2[predicate5]
       }));
     }
+    /**
+     * Returns all the links from other resources to this thing
+     */
     reverseRelations(predicate4) {
       const statements = this.store.statementsMatching(
         void 0,
@@ -35842,6 +35857,10 @@ _:patch
         uris: values2[predicate5]
       }));
     }
+    /**
+     * Returns any value linked from this thing via one of the given predicates
+     * @param predicateUris
+     */
     anyValue(...predicateUris) {
       let value7;
       predicateUris.some((it) => {
@@ -35850,6 +35869,10 @@ _:patch
       });
       return value7;
     }
+    /**
+     * Returns a literal value that describes this thing. Tries to match common RDF terms
+     * used for descriptions, like `dct:description`, `schema:description` or `rdfs:comment`
+     */
     description() {
       return this.anyValue(
         "http://purl.org/dc/terms/description",
@@ -35863,6 +35886,13 @@ _:patch
         "http://www.w3.org/2006/vcard/ns#note"
       );
     }
+    /**
+     * Returns the url of a picture or logo associated with this thing
+     * Tries to match common RDF terms used for pictures like `schema:image`,
+     * `vcard:photo` or `foaf:img`
+     *
+     * @return {Object} An object containing the `url` of the picture
+     */
     picture() {
       const directUrl = this.anyValue(
         "http://schema.org/image",
@@ -35904,6 +35934,9 @@ _:patch
         url: url7
       } : null;
     }
+    /**
+     * Retrieves a list of RDF types for this thing.
+     */
     types() {
       const uriMap = this.store.findTypeURIs(namedNode(this.uri));
       return Object.keys(uriMap).map((uri6) => ({
@@ -35911,6 +35944,11 @@ _:patch
         label: labelForType(uri6)
       }));
     }
+    /**
+     * Call this method to switch to a more specific subclass of Thing.
+     *
+     * @param SpecificThing - a subclass of Thing to assume
+     */
     assume(SpecificThing) {
       return new SpecificThing(this.uri, this.store, this.editable);
     }
@@ -36153,7 +36191,7 @@ _:patch
     }
     /**
      * Fetch the private label index for the given profile and build a search index from it
-     * @param webId
+     * @param profile
      */
     async buildSearchIndex(profile2) {
       const labelIndexUris = profile2.getPrivateLabelIndexes();
@@ -57819,7 +57857,7 @@ _:patch
     }
     /**
      * Fetch the private label index for the given profile and build a search index from it
-     * @param webId
+     * @param profile
      */
     async buildSearchIndex(profile2) {
       return this.searchGateway.buildSearchIndex(profile2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pod-os/core",
-  "version": "0.18.1-rc.d8b7ee4.0",
+  "version": "0.18.1-rc.f02795a.0",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",
   "files": [
@@ -53,7 +53,7 @@
     "buffer": "^6.0.3",
     "lunr": "^2.3.9",
     "rdf-namespaces": "^1.16.0",
-    "rdflib": "^2.2.37",
+    "rdflib": "2.3.0",
     "rxjs": "^7.8.2",
     "slugify": "^1.6.6",
     "url": "^0.11.4"

package/types/Store.d.ts

@@ -39,7 +39,6 @@ export declare class Store {
     flagAuthorizationMetadata(): void;
     loadModule<T>(module: PodOsModule<T>): T;
 }
-interface PodOsModule<T> {
+export interface PodOsModule<T> {
     readonly default: new (config: ModuleConfig) => T;
 }
-export {};

package/types/index.d.ts

@@ -19,6 +19,8 @@ export * from "./profile";
 export * from "./search";
 export * from "./offline-cache";
 export * from "./terms";
+export * from "./Store";
+export * from "./uri";
 export interface PodOsConfiguration {
     offlineCache?: OfflineCache;
     onlineStatus?: OnlineStatus;
@@ -52,7 +54,7 @@ export declare class PodOS {
     fetchProfile(webId: string): Promise<WebIdProfile>;
     /**
      * Fetch the private label index for the given profile and build a search index from it
-     * @param webId
+     * @param profile
      */
     buildSearchIndex(profile: WebIdProfile): Promise<import("./search").SearchIndex>;
     logout(): Promise<void>;

package/types/offline-cache/index.d.ts

@@ -1,3 +1,3 @@
-export { OfflineCapableFetcher } from "./OfflineCapableFetcher";
+export { OfflineCapableFetcher, OfflineCapableFetcherOptions, } from "./OfflineCapableFetcher";
 export { OfflineCache, CachedRdfDocument, NoOfflineCache, } from "./OfflineCache";
 export { OnlineStatus, AssumeAlwaysOnline } from "./OnlineStatus";

package/types/search/SearchGateway.d.ts

@@ -8,7 +8,7 @@ export declare class SearchGateway {
     constructor(store: Store);
     /**
      * Fetch the private label index for the given profile and build a search index from it
-     * @param webId
+     * @param profile
      */
     buildSearchIndex(profile: WebIdProfile): Promise<SearchIndex>;
     addToLabelIndex(thing: Thing, labelIndex: LabelIndex): Promise<void>;

package/types/thing/Thing.d.ts

@@ -25,16 +25,54 @@ export declare class Thing {
      * Whether the Thing can be edited according to its access control settings
      */
     editable?: boolean);
+    /**
+     * Returns a human-readable label for this thing. Tries to match common RDF terms
+     * used for labels, such as `rdfs:label`, `schema:name` and others.
+     *
+     * If no such term is present, it will derive a label from the URI.
+     */
     label(): string;
+    /**
+     * Returns all the literal values that are linked to this thing
+     */
     literals(): Literal[];
+    /**
+     * Returns all the links from this thing to other resources
+     */
     relations(predicate?: string): Relation[];
+    /**
+     * Returns all the links from other resources to this thing
+     */
     reverseRelations(predicate?: string): Relation[];
+    /**
+     * Returns any value linked from this thing via one of the given predicates
+     * @param predicateUris
+     */
     anyValue(...predicateUris: string[]): undefined;
+    /**
+     * Returns a literal value that describes this thing. Tries to match common RDF terms
+     * used for descriptions, like `dct:description`, `schema:description` or `rdfs:comment`
+     */
     description(): undefined;
+    /**
+     * Returns the url of a picture or logo associated with this thing
+     * Tries to match common RDF terms used for pictures like `schema:image`,
+     * `vcard:photo` or `foaf:img`
+     *
+     * @return {Object} An object containing the `url` of the picture
+     */
     picture(): {
         url: string;
     } | null;
     private findActivityStreamsPicture;
+    /**
+     * Retrieves a list of RDF types for this thing.
+     */
     types(): RdfType[];
+    /**
+     * Call this method to switch to a more specific subclass of Thing.
+     *
+     * @param SpecificThing - a subclass of Thing to assume
+     */
     assume<T>(SpecificThing: new (uri: string, store: IndexedFormula, editable: boolean) => T): T;
 }

package/types/uri/index.d.ts

@@ -0,0 +1 @@
+export { UriService } from "./UriService";