@pod-os/core 0.30.0-rc.fcadbb6.0 → 0.30.0

package/dist/index.js

@@ -13785,8 +13785,8 @@ function __generator(thisArg, body) {
   var _ = { label: 0, sent: function() {
     if (t[0] & 1) throw t[1];
     return t[1];
-  }, trys: [], ops: [] }, f, y, t, g;
-  return g = { next: verb2(0), "throw": verb2(1), "return": verb2(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+  }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+  return g.next = verb2(0), g["throw"] = verb2(1), g["return"] = verb2(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
     return this;
   }), g;
   function verb2(n2) {
@@ -13893,16 +13893,24 @@ function __await(v2) {
 function __asyncGenerator(thisArg, _arguments, generator3) {
   if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
   var g = generator3.apply(thisArg, _arguments || []), i, q = [];
-  return i = {}, verb2("next"), verb2("throw"), verb2("return"), i[Symbol.asyncIterator] = function() {
+  return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb2("next"), verb2("throw"), verb2("return", awaitReturn), i[Symbol.asyncIterator] = function() {
     return this;
   }, i;
-  function verb2(n2) {
-    if (g[n2]) i[n2] = function(v2) {
-      return new Promise(function(a, b) {
-        q.push([n2, v2, a, b]) > 1 || resume(n2, v2);
-      });
+  function awaitReturn(f) {
+    return function(v2) {
+      return Promise.resolve(v2).then(f, reject);
     };
   }
+  function verb2(n2, f) {
+    if (g[n2]) {
+      i[n2] = function(v2) {
+        return new Promise(function(a, b) {
+          q.push([n2, v2, a, b]) > 1 || resume(n2, v2);
+        });
+      };
+      if (f) i[n2] = f(i[n2]);
+    }
+  }
   function resume(n2, v2) {
     try {
       step4(g[n2](v2));
@@ -15529,6 +15537,23 @@ function debounceTime(dueTime, scheduler) {
   });
 }
 
+// ../node_modules/rxjs/dist/esm5/internal/operators/take.js
+function take(count2) {
+  return count2 <= 0 ? function() {
+    return EMPTY;
+  } : operate(function(source8, subscriber3) {
+    var seen = 0;
+    source8.subscribe(createOperatorSubscriber(subscriber3, function(value7) {
+      if (++seen <= count2) {
+        subscriber3.next(value7);
+        if (count2 <= seen) {
+          subscriber3.complete();
+        }
+      }
+    }));
+  });
+}
+
 // ../node_modules/rxjs/dist/esm5/internal/operators/distinctUntilChanged.js
 function distinctUntilChanged(comparator2, keySelector) {
   if (keySelector === void 0) {
@@ -15564,6 +15589,32 @@ function startWith() {
   });
 }
 
+// ../node_modules/rxjs/dist/esm5/internal/operators/switchMap.js
+function switchMap(project, resultSelector) {
+  return operate(function(source8, subscriber3) {
+    var innerSubscriber = null;
+    var index2 = 0;
+    var isComplete = false;
+    var checkComplete = function() {
+      return isComplete && !innerSubscriber && subscriber3.complete();
+    };
+    source8.subscribe(createOperatorSubscriber(subscriber3, function(value7) {
+      innerSubscriber === null || innerSubscriber === void 0 ? void 0 : innerSubscriber.unsubscribe();
+      var innerIndex = 0;
+      var outerIndex = index2++;
+      innerFrom(project(value7, outerIndex)).subscribe(innerSubscriber = createOperatorSubscriber(subscriber3, function(innerValue) {
+        return subscriber3.next(resultSelector ? resultSelector(value7, innerValue, outerIndex, innerIndex++) : innerValue);
+      }, function() {
+        innerSubscriber = null;
+        checkComplete();
+      }));
+    }, function() {
+      isComplete = true;
+      checkComplete();
+    }));
+  });
+}
+
 // ../node_modules/rxjs/dist/esm5/internal/operators/tap.js
 function tap(observerOrNext, error4, complete2) {
   var tapObserver = isFunction(observerOrNext) || error4 || complete2 ? { next: observerOrNext, error: error4, complete: complete2 } : observerOrNext;
@@ -28116,6 +28167,30 @@ function getFilename(url7) {
 }
 
 // src/thing/Thing.ts
+var LABEL_PREDICATES = [
+  "http://www.w3.org/2006/vcard/ns#fn",
+  "http://xmlns.com/foaf/0.1/name",
+  "http://xmlns.com/foaf/0.1/nick",
+  "https://schema.org/name",
+  "http://schema.org/name",
+  "http://purl.org/dc/terms/title",
+  "http://purl.org/dc/elements/1.1/title",
+  "http://www.w3.org/2000/01/rdf-schema#label",
+  "https://www.w3.org/ns/activitystreams#name",
+  "http://schema.org/caption",
+  "https://schema.org/caption"
+];
+var DESCRIPTION_PREDICATES = [
+  "http://purl.org/dc/terms/description",
+  "http://purl.org/dc/elements/1.1/description",
+  "http://schema.org/description",
+  "https://schema.org/description",
+  "https://schema.org/text",
+  "http://www.w3.org/2000/01/rdf-schema#comment",
+  "https://www.w3.org/ns/activitystreams#summary",
+  "https://www.w3.org/ns/activitystreams#content",
+  "http://www.w3.org/2006/vcard/ns#note"
+];
 var Thing = class {
   constructor(uri6, store, editable = false) {
     this.uri = uri6;
@@ -28129,24 +28204,20 @@ var Thing = class {
    * 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",
-      "http://xmlns.com/foaf/0.1/name",
-      "http://xmlns.com/foaf/0.1/nick",
-      "https://schema.org/name",
-      "http://schema.org/name",
-      "http://purl.org/dc/terms/title",
-      "http://purl.org/dc/elements/1.1/title",
-      "http://www.w3.org/2000/01/rdf-schema#label",
-      "https://www.w3.org/ns/activitystreams#name",
-      "http://schema.org/caption",
-      "https://schema.org/caption"
-    );
+    const value7 = this.anyValue(...LABEL_PREDICATES);
     if (value7) {
       return value7;
     }
     return labelFromUri(this.uri);
   }
+  /**
+   * Observe changes in human-readable label for this thing. See `label`.
+   */
+  observeLabel() {
+    return this.observeAnyValue(...LABEL_PREDICATES).pipe(
+      map((value7) => value7 ?? labelFromUri(this.uri))
+    );
+  }
   /**
    * Returns all the literal values that are linked to this thing
    */
@@ -28238,22 +28309,56 @@ var Thing = class {
     });
     return value7;
   }
+  /**
+   * Observe changes in a value linked from this thing via one of the given predicates
+   *
+   * Note that return value may differ from that from `anyValue` when more than one value is present.
+   *
+   * @param predicateUris
+   */
+  observeAnyValue(...predicateUris) {
+    const currentValue = this.anyValue(...predicateUris);
+    const relevantChanges$ = (observable2) => observable2.pipe(
+      filter(
+        (quad3) => quad3.subject.value === this.uri && predicateUris.includes(quad3.predicate.value)
+      )
+    );
+    const removalOrInitial$ = relevantChanges$(this.store.removals$).pipe(
+      map(() => ({ type: "removal" })),
+      currentValue === void 0 ? startWith({ type: "removal" }) : identity
+    );
+    const addition$ = removalOrInitial$.pipe(
+      switchMap(
+        () => relevantChanges$(this.store.additions$).pipe(
+          take(1),
+          map((quad3) => ({
+            type: "addition",
+            value: quad3.object.value
+          }))
+        )
+      )
+    );
+    return merge(removalOrInitial$, addition$).pipe(
+      debounceTime(250),
+      map(
+        (event4) => event4.type === "addition" ? event4.value : this.anyValue(...predicateUris)
+        // determine a new value after a removal
+      ),
+      startWith(currentValue)
+    );
+  }
   /**
    * 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",
-      "http://purl.org/dc/elements/1.1/description",
-      "http://schema.org/description",
-      "https://schema.org/description",
-      "https://schema.org/text",
-      "http://www.w3.org/2000/01/rdf-schema#comment",
-      "https://www.w3.org/ns/activitystreams#summary",
-      "https://www.w3.org/ns/activitystreams#content",
-      "http://www.w3.org/2006/vcard/ns#note"
-    );
+    return this.anyValue(...DESCRIPTION_PREDICATES);
+  }
+  /**
+   * Observe changes in literal values that describe this thing. See `description`
+   */
+  observeDescription() {
+    return this.observeAnyValue(...DESCRIPTION_PREDICATES);
   }
   /**
    * Returns the url of a picture or logo associated with this thing

package/lib/index.js

@@ -22222,8 +22222,8 @@ var PodOS = (() => {
     var _ = { label: 0, sent: function() {
       if (t[0] & 1) throw t[1];
       return t[1];
-    }, trys: [], ops: [] }, f, y, t, g;
-    return g = { next: verb2(0), "throw": verb2(1), "return": verb2(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() {
+    }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb2(0), g["throw"] = verb2(1), g["return"] = verb2(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() {
       return this;
     }), g;
     function verb2(n2) {
@@ -22330,16 +22330,24 @@ var PodOS = (() => {
   function __asyncGenerator(thisArg, _arguments, generator3) {
     if (!Symbol.asyncIterator) throw new TypeError("Symbol.asyncIterator is not defined.");
     var g = generator3.apply(thisArg, _arguments || []), i, q = [];
-    return i = {}, verb2("next"), verb2("throw"), verb2("return"), i[Symbol.asyncIterator] = function() {
+    return i = Object.create((typeof AsyncIterator === "function" ? AsyncIterator : Object).prototype), verb2("next"), verb2("throw"), verb2("return", awaitReturn), i[Symbol.asyncIterator] = function() {
       return this;
     }, i;
-    function verb2(n2) {
-      if (g[n2]) i[n2] = function(v2) {
-        return new Promise(function(a, b) {
-          q.push([n2, v2, a, b]) > 1 || resume(n2, v2);
-        });
+    function awaitReturn(f) {
+      return function(v2) {
+        return Promise.resolve(v2).then(f, reject);
       };
     }
+    function verb2(n2, f) {
+      if (g[n2]) {
+        i[n2] = function(v2) {
+          return new Promise(function(a, b) {
+            q.push([n2, v2, a, b]) > 1 || resume(n2, v2);
+          });
+        };
+        if (f) i[n2] = f(i[n2]);
+      }
+    }
     function resume(n2, v2) {
       try {
         step4(g[n2](v2));
@@ -23966,6 +23974,23 @@ var PodOS = (() => {
     });
   }
 
+  // ../node_modules/rxjs/dist/esm5/internal/operators/take.js
+  function take(count2) {
+    return count2 <= 0 ? function() {
+      return EMPTY;
+    } : operate(function(source8, subscriber3) {
+      var seen = 0;
+      source8.subscribe(createOperatorSubscriber(subscriber3, function(value7) {
+        if (++seen <= count2) {
+          subscriber3.next(value7);
+          if (count2 <= seen) {
+            subscriber3.complete();
+          }
+        }
+      }));
+    });
+  }
+
   // ../node_modules/rxjs/dist/esm5/internal/operators/distinctUntilChanged.js
   function distinctUntilChanged(comparator2, keySelector) {
     if (keySelector === void 0) {
@@ -24001,6 +24026,32 @@ var PodOS = (() => {
     });
   }
 
+  // ../node_modules/rxjs/dist/esm5/internal/operators/switchMap.js
+  function switchMap(project, resultSelector) {
+    return operate(function(source8, subscriber3) {
+      var innerSubscriber = null;
+      var index2 = 0;
+      var isComplete = false;
+      var checkComplete = function() {
+        return isComplete && !innerSubscriber && subscriber3.complete();
+      };
+      source8.subscribe(createOperatorSubscriber(subscriber3, function(value7) {
+        innerSubscriber === null || innerSubscriber === void 0 ? void 0 : innerSubscriber.unsubscribe();
+        var innerIndex = 0;
+        var outerIndex = index2++;
+        innerFrom(project(value7, outerIndex)).subscribe(innerSubscriber = createOperatorSubscriber(subscriber3, function(innerValue) {
+          return subscriber3.next(resultSelector ? resultSelector(value7, innerValue, outerIndex, innerIndex++) : innerValue);
+        }, function() {
+          innerSubscriber = null;
+          checkComplete();
+        }));
+      }, function() {
+        isComplete = true;
+        checkComplete();
+      }));
+    });
+  }
+
   // ../node_modules/rxjs/dist/esm5/internal/operators/tap.js
   function tap(observerOrNext, error4, complete2) {
     var tapObserver = isFunction(observerOrNext) || error4 || complete2 ? { next: observerOrNext, error: error4, complete: complete2 } : observerOrNext;
@@ -36553,6 +36604,30 @@ _:patch
   }
 
   // src/thing/Thing.ts
+  var LABEL_PREDICATES = [
+    "http://www.w3.org/2006/vcard/ns#fn",
+    "http://xmlns.com/foaf/0.1/name",
+    "http://xmlns.com/foaf/0.1/nick",
+    "https://schema.org/name",
+    "http://schema.org/name",
+    "http://purl.org/dc/terms/title",
+    "http://purl.org/dc/elements/1.1/title",
+    "http://www.w3.org/2000/01/rdf-schema#label",
+    "https://www.w3.org/ns/activitystreams#name",
+    "http://schema.org/caption",
+    "https://schema.org/caption"
+  ];
+  var DESCRIPTION_PREDICATES = [
+    "http://purl.org/dc/terms/description",
+    "http://purl.org/dc/elements/1.1/description",
+    "http://schema.org/description",
+    "https://schema.org/description",
+    "https://schema.org/text",
+    "http://www.w3.org/2000/01/rdf-schema#comment",
+    "https://www.w3.org/ns/activitystreams#summary",
+    "https://www.w3.org/ns/activitystreams#content",
+    "http://www.w3.org/2006/vcard/ns#note"
+  ];
   var Thing = class {
     constructor(uri6, store, editable = false) {
       this.uri = uri6;
@@ -36566,24 +36641,20 @@ _:patch
      * 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",
-        "http://xmlns.com/foaf/0.1/name",
-        "http://xmlns.com/foaf/0.1/nick",
-        "https://schema.org/name",
-        "http://schema.org/name",
-        "http://purl.org/dc/terms/title",
-        "http://purl.org/dc/elements/1.1/title",
-        "http://www.w3.org/2000/01/rdf-schema#label",
-        "https://www.w3.org/ns/activitystreams#name",
-        "http://schema.org/caption",
-        "https://schema.org/caption"
-      );
+      const value7 = this.anyValue(...LABEL_PREDICATES);
       if (value7) {
         return value7;
       }
       return labelFromUri(this.uri);
     }
+    /**
+     * Observe changes in human-readable label for this thing. See `label`.
+     */
+    observeLabel() {
+      return this.observeAnyValue(...LABEL_PREDICATES).pipe(
+        map((value7) => value7 ?? labelFromUri(this.uri))
+      );
+    }
     /**
      * Returns all the literal values that are linked to this thing
      */
@@ -36675,22 +36746,56 @@ _:patch
       });
       return value7;
     }
+    /**
+     * Observe changes in a value linked from this thing via one of the given predicates
+     *
+     * Note that return value may differ from that from `anyValue` when more than one value is present.
+     *
+     * @param predicateUris
+     */
+    observeAnyValue(...predicateUris) {
+      const currentValue = this.anyValue(...predicateUris);
+      const relevantChanges$ = (observable2) => observable2.pipe(
+        filter(
+          (quad3) => quad3.subject.value === this.uri && predicateUris.includes(quad3.predicate.value)
+        )
+      );
+      const removalOrInitial$ = relevantChanges$(this.store.removals$).pipe(
+        map(() => ({ type: "removal" })),
+        currentValue === void 0 ? startWith({ type: "removal" }) : identity
+      );
+      const addition$ = removalOrInitial$.pipe(
+        switchMap(
+          () => relevantChanges$(this.store.additions$).pipe(
+            take(1),
+            map((quad3) => ({
+              type: "addition",
+              value: quad3.object.value
+            }))
+          )
+        )
+      );
+      return merge(removalOrInitial$, addition$).pipe(
+        debounceTime(250),
+        map(
+          (event4) => event4.type === "addition" ? event4.value : this.anyValue(...predicateUris)
+          // determine a new value after a removal
+        ),
+        startWith(currentValue)
+      );
+    }
     /**
      * 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",
-        "http://purl.org/dc/elements/1.1/description",
-        "http://schema.org/description",
-        "https://schema.org/description",
-        "https://schema.org/text",
-        "http://www.w3.org/2000/01/rdf-schema#comment",
-        "https://www.w3.org/ns/activitystreams#summary",
-        "https://www.w3.org/ns/activitystreams#content",
-        "http://www.w3.org/2006/vcard/ns#note"
-      );
+      return this.anyValue(...DESCRIPTION_PREDICATES);
+    }
+    /**
+     * Observe changes in literal values that describe this thing. See `description`
+     */
+    observeDescription() {
+      return this.observeAnyValue(...DESCRIPTION_PREDICATES);
     }
     /**
      * Returns the url of a picture or logo associated with this thing

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pod-os/core",
   "description": "Core module of PodOS",
-  "version": "0.30.0-rc.fcadbb6.0",
+  "version": "0.30.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",
@@ -49,8 +49,8 @@
     "@types/sparqljs": "^3.1.12",
     "esbuild": "^0.28.0",
     "eslint": "^9.39.4",
-    "jest": "^30.3.0",
-    "jest-when": "^3.7.0",
+    "jest": "^30.4.0",
+    "jest-when": "^4.0.3",
     "npm-run-all": "^4.1.5",
     "prettier": "^3.8.3",
     "rimraf": "^6.1.3",

package/types/thing/Thing.d.ts

@@ -33,6 +33,10 @@ export declare class Thing {
      * If no such term is present, it will derive a label from the URI.
      */
     label(): string;
+    /**
+     * Observe changes in human-readable label for this thing. See `label`.
+     */
+    observeLabel(): Observable<string>;
     /**
      * Returns all the literal values that are linked to this thing
      */
@@ -58,11 +62,23 @@ export declare class Thing {
      * @param predicateUris
      */
     anyValue(...predicateUris: string[]): undefined;
+    /**
+     * Observe changes in a value linked from this thing via one of the given predicates
+     *
+     * Note that return value may differ from that from `anyValue` when more than one value is present.
+     *
+     * @param predicateUris
+     */
+    observeAnyValue(...predicateUris: string[]): Observable<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;
+    /**
+     * Observe changes in literal values that describe this thing. See `description`
+     */
+    observeDescription(): Observable<string | 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`,