@pod-os/core 0.31.0 → 0.32.0-rc.4862e82.0

package/dist/index.js

@@ -15495,6 +15495,16 @@ var require_short_unique_id = __commonJS({
   }
 });
 
+// node_modules/rdflib/lib/tf-types.js
+var require_tf_types = __commonJS({
+  "node_modules/rdflib/lib/tf-types.js"(exports) {
+    "use strict";
+    Object.defineProperty(exports, "__esModule", {
+      value: true
+    });
+  }
+});
+
 // ../node_modules/slugify/slugify.js
 var require_slugify = __commonJS({
   "../node_modules/slugify/slugify.js"(exports, module3) {
@@ -30044,6 +30054,17 @@ var Thing = class {
       values: values2[predicate4]
     }));
   }
+  /**
+   * Observe changes in literal values linked to this thing
+   */
+  observeLiterals() {
+    return this.observeSubjectChanges({
+      observes: () => this.literals(),
+      compare: (prev2, curr) => prev2.length === curr.length && prev2.every(
+        (rel2, i) => rel2.predicate === curr[i].predicate && rel2.values.length === curr[i].values.length && rel2.values.every((val, j) => val === curr[i].values[j])
+      )
+    });
+  }
   /**
    * Returns all the unique links from this thing to other resources. This only includes named nodes and excludes rdf:type relations.
    */
@@ -30063,18 +30084,59 @@ var Thing = class {
    * Observe changes in links from this thing to other resources
    */
   observeRelations(predicate4) {
+    return this.observeSubjectChanges({
+      observes: () => this.relations(predicate4),
+      compare: (prev2, curr) => prev2.length === curr.length && prev2.every(
+        (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
+      )
+    });
+  }
+  /**
+   * Generic observable creator that watches the store for changes
+   * that have this thing as a subject
+   * @param args.observedValue Function that returns the current value to observe
+   * @param args.compare Function that compares previous and current values for distinctUntilChanged
+   */
+  observeSubjectChanges(args) {
+    const { observes, compare } = args;
+    return this.observeChanges({
+      filterFn: (quad3) => quad3.subject.value === this.uri,
+      observes,
+      compare
+    });
+  }
+  /**
+   * Generic observable creator that watches the store for changes
+   * that have this thing as an object
+   * @param args.observedValue Function that returns the current value to observe
+   * @param args.compare Function that compares previous and current values for distinctUntilChanged
+   */
+  observeObjectChanges(args) {
+    const { observes, compare } = args;
+    return this.observeChanges({
+      filterFn: (quad3) => quad3.object.value === this.uri,
+      observes,
+      compare
+    });
+  }
+  /**
+   * Generic observable creator that watches the store for changes
+   * that match the given filter function before comparing values of this thing for possible changes.
+   * The observable only emits a new value if relevant quads are added or removed, and in consequence
+   * the observed value changes according to the compare function
+   *
+   * @param args.filterFn Filter for relevant quads
+   * @param args.observedValue Function that returns the value to observe
+   * @param args.compare Function that compares previous and current values
+   */
+  observeChanges(args) {
+    const { observes, compare, filterFn } = args;
     return merge(this.store.additions$, this.store.removals$).pipe(
-      // Note: we assume that cost of filtering by the optional predicate is not worthwhile
-      filter((quad3) => quad3.subject.value === this.uri),
+      filter(filterFn),
       debounceTime(250),
-      map(() => this.relations(predicate4)),
-      startWith(this.relations(predicate4)),
-      // Note: label is constructed from predicate and is therefore irrelevant to the comparison
-      distinctUntilChanged(
-        (prev2, curr) => prev2.length === curr.length && prev2.every(
-          (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
-        )
-      )
+      map(observes),
+      startWith(observes()),
+      distinctUntilChanged(compare)
     );
   }
   /**
@@ -30097,19 +30159,12 @@ var Thing = class {
    * Observe changes in links from other resources to this thing
    */
   observeReverseRelations(predicate4) {
-    return merge(this.store.additions$, this.store.removals$).pipe(
-      // Note: we assume that cost of filtering by the optional predicate is not worthwhile
-      filter((quad3) => quad3.object.value === this.uri),
-      debounceTime(250),
-      map(() => this.reverseRelations(predicate4)),
-      startWith(this.reverseRelations(predicate4)),
-      // Note: label is constructed from predicate and is therefore irrelevant to the comparison
-      distinctUntilChanged(
-        (prev2, curr) => prev2.length === curr.length && prev2.every(
-          (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
-        )
+    return this.observeObjectChanges({
+      observes: () => this.reverseRelations(predicate4),
+      compare: (prev2, curr) => prev2.length === curr.length && prev2.every(
+        (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
       )
-    );
+    });
   }
   /**
    * Returns any value linked from this thing via one of the given predicates
@@ -30839,6 +30894,7 @@ var AssumeAlwaysOnline = class {
 };
 
 // src/Store.ts
+var import_tf_types = __toESM(require_tf_types(), 1);
 var Store = class {
   constructor(session4, offlineCache = new NoOfflineCache(), onlineStatus = new AssumeAlwaysOnline(), internalStore = graph()) {
     this.DESCRIBEDBY = iana("describedby");
@@ -53265,6 +53321,7 @@ var PodOS = class {
     return proposeAppsFor(thing);
   }
 };
+var export_Quad = import_tf_types.Quad;
 export {
   AnonymousSession,
   AssumeAlwaysOnline,
@@ -53281,6 +53338,7 @@ export {
   PictureGateway,
   PodOS,
   ProfileGateway,
+  export_Quad as Quad,
   RdfDocument,
   SearchGateway,
   SearchIndex,

package/lib/index.js

@@ -23899,6 +23899,16 @@ var PodOS = (() => {
     }
   });
 
+  // node_modules/rdflib/lib/tf-types.js
+  var require_tf_types = __commonJS({
+    "node_modules/rdflib/lib/tf-types.js"(exports) {
+      "use strict";
+      Object.defineProperty(exports, "__esModule", {
+        value: true
+      });
+    }
+  });
+
   // ../node_modules/slugify/slugify.js
   var require_slugify = __commonJS({
     "../node_modules/slugify/slugify.js"(exports, module3) {
@@ -23967,6 +23977,7 @@ var PodOS = (() => {
     PictureGateway: () => PictureGateway,
     PodOS: () => PodOS,
     ProfileGateway: () => ProfileGateway,
+    Quad: () => import_tf_types.Quad,
     RdfDocument: () => RdfDocument,
     SearchGateway: () => SearchGateway,
     SearchIndex: () => SearchIndex,
@@ -38481,6 +38492,17 @@ _:patch
         values: values2[predicate4]
       }));
     }
+    /**
+     * Observe changes in literal values linked to this thing
+     */
+    observeLiterals() {
+      return this.observeSubjectChanges({
+        observes: () => this.literals(),
+        compare: (prev2, curr) => prev2.length === curr.length && prev2.every(
+          (rel2, i) => rel2.predicate === curr[i].predicate && rel2.values.length === curr[i].values.length && rel2.values.every((val, j) => val === curr[i].values[j])
+        )
+      });
+    }
     /**
      * Returns all the unique links from this thing to other resources. This only includes named nodes and excludes rdf:type relations.
      */
@@ -38500,18 +38522,59 @@ _:patch
      * Observe changes in links from this thing to other resources
      */
     observeRelations(predicate4) {
+      return this.observeSubjectChanges({
+        observes: () => this.relations(predicate4),
+        compare: (prev2, curr) => prev2.length === curr.length && prev2.every(
+          (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
+        )
+      });
+    }
+    /**
+     * Generic observable creator that watches the store for changes
+     * that have this thing as a subject
+     * @param args.observedValue Function that returns the current value to observe
+     * @param args.compare Function that compares previous and current values for distinctUntilChanged
+     */
+    observeSubjectChanges(args) {
+      const { observes, compare } = args;
+      return this.observeChanges({
+        filterFn: (quad3) => quad3.subject.value === this.uri,
+        observes,
+        compare
+      });
+    }
+    /**
+     * Generic observable creator that watches the store for changes
+     * that have this thing as an object
+     * @param args.observedValue Function that returns the current value to observe
+     * @param args.compare Function that compares previous and current values for distinctUntilChanged
+     */
+    observeObjectChanges(args) {
+      const { observes, compare } = args;
+      return this.observeChanges({
+        filterFn: (quad3) => quad3.object.value === this.uri,
+        observes,
+        compare
+      });
+    }
+    /**
+     * Generic observable creator that watches the store for changes
+     * that match the given filter function before comparing values of this thing for possible changes.
+     * The observable only emits a new value if relevant quads are added or removed, and in consequence
+     * the observed value changes according to the compare function
+     *
+     * @param args.filterFn Filter for relevant quads
+     * @param args.observedValue Function that returns the value to observe
+     * @param args.compare Function that compares previous and current values
+     */
+    observeChanges(args) {
+      const { observes, compare, filterFn } = args;
       return merge(this.store.additions$, this.store.removals$).pipe(
-        // Note: we assume that cost of filtering by the optional predicate is not worthwhile
-        filter((quad3) => quad3.subject.value === this.uri),
+        filter(filterFn),
         debounceTime(250),
-        map(() => this.relations(predicate4)),
-        startWith(this.relations(predicate4)),
-        // Note: label is constructed from predicate and is therefore irrelevant to the comparison
-        distinctUntilChanged(
-          (prev2, curr) => prev2.length === curr.length && prev2.every(
-            (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
-          )
-        )
+        map(observes),
+        startWith(observes()),
+        distinctUntilChanged(compare)
       );
     }
     /**
@@ -38534,19 +38597,12 @@ _:patch
      * Observe changes in links from other resources to this thing
      */
     observeReverseRelations(predicate4) {
-      return merge(this.store.additions$, this.store.removals$).pipe(
-        // Note: we assume that cost of filtering by the optional predicate is not worthwhile
-        filter((quad3) => quad3.object.value === this.uri),
-        debounceTime(250),
-        map(() => this.reverseRelations(predicate4)),
-        startWith(this.reverseRelations(predicate4)),
-        // Note: label is constructed from predicate and is therefore irrelevant to the comparison
-        distinctUntilChanged(
-          (prev2, curr) => prev2.length === curr.length && prev2.every(
-            (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
-          )
+      return this.observeObjectChanges({
+        observes: () => this.reverseRelations(predicate4),
+        compare: (prev2, curr) => prev2.length === curr.length && prev2.every(
+          (rel2, i) => rel2.predicate === curr[i].predicate && rel2.uris.length === curr[i].uris.length
         )
-      );
+      });
     }
     /**
      * Returns any value linked from this thing via one of the given predicates
@@ -39276,6 +39332,7 @@ _:patch
   };
 
   // src/Store.ts
+  var import_tf_types = __toESM(require_tf_types(), 1);
   var Store = class {
     constructor(session4, offlineCache = new NoOfflineCache(), onlineStatus = new AssumeAlwaysOnline(), internalStore = graph()) {
       this.DESCRIBEDBY = iana("describedby");

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pod-os/core",
   "description": "Core module of PodOS",
-  "version": "0.31.0",
+  "version": "0.32.0-rc.4862e82.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",

package/types/Store.d.ts

@@ -5,6 +5,7 @@ import { ModuleConfig, PreferencesQuery, ProfileQuery, UpdateOperation } from "@
 import { OfflineCache, OnlineStatus } from "./offline-cache";
 import { Observable, Subject } from "rxjs";
 import { BlankNode, Quad, Quad_Graph, Quad_Object, Quad_Predicate, Quad_Subject, Term } from "rdflib/lib/tf-types";
+export { Quad } from "rdflib/lib/tf-types";
 /**
  * The Store contains all data that is known locally.
  * It can be used to fetch additional data from the web and also update data and sync it back to editable resources.

package/types/thing/Thing.d.ts

@@ -41,6 +41,10 @@ export declare class Thing {
      * Returns all the literal values that are linked to this thing
      */
     literals(): Literal[];
+    /**
+     * Observe changes in literal values linked to this thing
+     */
+    observeLiterals(): Observable<Literal[]>;
     /**
      * Returns all the unique links from this thing to other resources. This only includes named nodes and excludes rdf:type relations.
      */
@@ -49,6 +53,31 @@ export declare class Thing {
      * Observe changes in links from this thing to other resources
      */
     observeRelations(predicate?: string): Observable<Relation[]>;
+    /**
+     * Generic observable creator that watches the store for changes
+     * that have this thing as a subject
+     * @param args.observedValue Function that returns the current value to observe
+     * @param args.compare Function that compares previous and current values for distinctUntilChanged
+     */
+    private observeSubjectChanges;
+    /**
+     * Generic observable creator that watches the store for changes
+     * that have this thing as an object
+     * @param args.observedValue Function that returns the current value to observe
+     * @param args.compare Function that compares previous and current values for distinctUntilChanged
+     */
+    private observeObjectChanges;
+    /**
+     * Generic observable creator that watches the store for changes
+     * that match the given filter function before comparing values of this thing for possible changes.
+     * The observable only emits a new value if relevant quads are added or removed, and in consequence
+     * the observed value changes according to the compare function
+     *
+     * @param args.filterFn Filter for relevant quads
+     * @param args.observedValue Function that returns the value to observe
+     * @param args.compare Function that compares previous and current values
+     */
+    private observeChanges;
     /**
      * Returns all the unique links from other resources to this thing
      */