@pod-os/core 0.31.0-rc.ecee84c.0 → 0.31.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pod-os/core",
   "description": "Core module of PodOS",
-  "version": "0.31.0-rc.ecee84c.0",
+  "version": "0.31.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",
@@ -21,8 +21,8 @@
     "node": ">=18.0.0"
   },
   "scripts": {
-    "test": "jest",
-    "test:watch": "jest --watch",
+    "test": "vitest --watch=false",
+    "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "lint": "eslint ./src",
     "build:bundle": "rimraf lib && node esbuild/build-bundle.mjs",
@@ -43,14 +43,12 @@
   "devDependencies": {
     "@babel/preset-env": "^7.29.5",
     "@babel/preset-typescript": "^7.28.5",
-    "@eslint/js": "^9.39.4",
+    "@eslint/js": "^10.0.0",
     "@types/jest": "^30.0.0",
     "@types/jest-when": "^3.5.5",
     "@types/sparqljs": "^3.1.12",
     "esbuild": "^0.28.0",
-    "eslint": "^9.39.4",
-    "jest": "^30.4.0",
-    "jest-when": "^4.0.3",
+    "eslint": "^10.0.0",
     "npm-run-all": "^4.1.5",
     "prettier": "^3.8.3",
     "rimraf": "^6.1.3",
@@ -58,7 +56,9 @@
     "typedoc": "^0.28.19",
     "typedoc-plugin-markdown": "^4.11.0",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.59.2"
+    "typescript-eslint": "^8.59.4",
+    "vitest": "^4.1.8",
+    "vitest-when": "^0.10.0"
   },
   "dependencies": {
     "@solid-data-modules/rdflib-utils": "^0.6.0",
@@ -67,8 +67,8 @@
     "lunr": "^2.3.9",
     "mime": "^4.1.0",
     "neverthrow": "^8.2.0",
-    "rdf-namespaces": "^1.16.0",
-    "rdflib": "2.3.6",
+    "rdf-namespaces": "^1.17.0",
+    "rdflib": "2.4.0",
     "rxjs": "^7.8.2",
     "slugify": "^1.6.9",
     "url": "^0.11.4",

package/types/Store.d.ts

@@ -16,16 +16,19 @@ export declare class Store {
     removals$: Subject<Quad>;
     private readonly internalStore;
     constructor(session: PodOsSession, offlineCache?: OfflineCache, onlineStatus?: OnlineStatus, internalStore?: IndexedFormula);
+    readonly DESCRIBEDBY: import("rdflib/lib/tf-types").NamedNode;
     /**
-     * Fetch data for the given URI to the internalStore
+     * Fetch data for the given URI to the internalStore.
+     * If the response includes a Link header with rel="describedby",
+     * the metadata document will also be fetched automatically.
      * @param uri
      */
-    fetch(uri: string): Promise<Response>;
+    fetch(uri: string): Promise<void>;
     /**
      * Fetch all the given URIs in parallel and put the data to the internalStore
      * @param uris
      */
-    fetchAll(uris: string[]): Promise<PromiseSettledResult<Response>[]>;
+    fetchAll(uris: string[]): Promise<PromiseSettledResult<void>[]>;
     /**
      * Retrieve the thing identified by the given URI from the internalStore
      * @param uri
@@ -38,6 +41,7 @@ export declare class Store {
      * @param value
      */
     addPropertyValue(thing: Thing, property: string, value: string): Promise<void>;
+    private insert;
     /**
      * Adds a new relation (link) from the thing to the given uri using the property
      * @param thing
@@ -45,6 +49,7 @@ export declare class Store {
      * @param uri
      */
     addRelation(thing: Thing, property: string, uri: string): Promise<void>;
+    private determineDocumentToUpdate;
     addNewThing(uri: string, name: string, type: string): Promise<void>;
     executeUpdate(operation: UpdateOperation): Promise<void>;
     flagAuthorizationMetadata(): void;

package/types/Store.spec.d.ts

@@ -1,2 +1,2 @@
-import { AuthenticatedFetch } from "./authentication";
-export declare function thenSparqlUpdateIsSentToUrl(fetchMock: jest.Mock<AuthenticatedFetch>, url: string, query: string): void;
+import { Mock } from "vitest";
+export declare function thenSparqlUpdateIsSentToUrl(fetchMock: Mock, url: string, query: string): void;

package/types/index.d.ts

@@ -48,8 +48,8 @@ export declare class PodOS {
     private readonly profileGateway;
     constructor({ session, offlineCache, onlineStatus, internalStore, }?: PodOsConfiguration);
     private flagAuthorizationMetaDataOnSessionChange;
-    fetch(uri: string): Promise<Response>;
-    fetchAll(uris: string[]): Promise<PromiseSettledResult<Response>[]>;
+    fetch(uri: string): Promise<void>;
+    fetchAll(uris: string[]): Promise<PromiseSettledResult<void>[]>;
     /**
      * @deprecated Use {@link FileFetcher.fetchFile} via {@link PodOS.files} instead
      * @param {string} url - URL identifying the file

package/types/namespaces/index.d.ts

@@ -1,4 +1,8 @@
+import { NamedNode } from "rdflib";
 export declare const rdfs: (ln: string) => import("rdflib/lib/tf-types").NamedNode;
 export declare const pim: (ln: string) => import("rdflib/lib/tf-types").NamedNode;
 export declare const schema: (ln: string) => import("rdflib/lib/tf-types").NamedNode;
 export declare const flow: (ln: string) => import("rdflib/lib/tf-types").NamedNode;
+export declare const iana: (ln: string) => import("rdflib/lib/tf-types").NamedNode;
+export declare const link: (ln: string) => import("rdflib/lib/tf-types").NamedNode;
+export declare const internal: () => NamedNode;

package/types/test-support/expectRequests.d.ts

@@ -0,0 +1,8 @@
+import { Mock } from "vitest";
+/**
+ * Expect that a PATCH request has been performed
+ * @param authenticatedFetch - A mocked fetch function
+ * @param url - The expected URL to PATCH
+ * @param expectedBody - The expected request body
+ */
+export declare function expectPatchRequest(authenticatedFetch: Mock, url: string, expectedBody: string): void;

package/types/test-support/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./expectRequests.js";
+export * from "./mockResponses.js";

package/types/test-support/mockResponses.d.ts

@@ -0,0 +1,24 @@
+import { Mock } from "vitest";
+/**
+ * Mock a turtle document at the given URL
+ * @param fetch - A mocked fetch function
+ * @param url - The URL to mock
+ * @param ttl - The mocked turtle file content
+ * @param additionalHeaders - Additional headers to include in the response
+ */
+export declare function mockTurtleDocument(fetch: Mock, url: string, ttl: string, additionalHeaders?: Record<string, string>): void;
+/**
+ * Mock a LDP container at the given URL
+ * @param fetch - A mocked fetch function
+ * @param url - The URL to mock
+ * @param contains - List of URLs of documents contained in this container
+ * @param moreTurtle - Additional turtle to include into the response
+ * @param additionalHeaders - Additional headers to include in the response
+ */
+export declare function mockLdpContainer(fetch: Mock, url: string, contains?: string[], moreTurtle?: string, additionalHeaders?: Record<string, string>): void;
+/**
+ * Mock a 404 - Not Found response for the given URL
+ * @param fetch - A mocked fetch function
+ * @param url - The URL to mock
+ */
+export declare function mockNotFound(fetch: Mock, url: string): void;

package/types/test-support/mockResponses.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/types/thing/Thing.d.ts

@@ -115,4 +115,6 @@ export declare class Thing {
     container(): {
         uri: string;
     };
+    rdfDocument(): string | undefined;
+    private hasType;
 }

package/types/thing/Thing.rdfDocument.spec.d.ts

@@ -0,0 +1 @@
+export {};