@pod-os/core 0.18.1-rc.54389d8.0 → 0.18.1-rc.5f8057b.0

package/dist/index.js

@@ -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);
   }

package/lib/index.js

@@ -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);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pod-os/core",
-  "version": "0.18.1-rc.54389d8.0",
+  "version": "0.18.1-rc.5f8057b.0",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",
   "files": [

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;
 }