@pod-os/core 0.19.1-rc.c8e652b.0 → 0.19.1-rc.ca6f577.0

package/dist/index.js

@@ -2736,6 +2736,11 @@ var FileFetcher = class {
   constructor(session4) {
     this.session = session4;
   }
+  /**
+   * Fetch the contents of the given file
+   * @param {string} url - URL identifying the file
+   * @returns {Promise<SolidFile>} An object representing the fetched file
+   */
   async fetchFile(url7) {
     const response6 = await this.session.authenticatedFetch(url7);
     if (response6.ok) {
@@ -2748,6 +2753,21 @@ var FileFetcher = class {
       );
     }
   }
+  /**
+   * Updates the contents of a file (overrides old content with the given one)
+   * @param file - The file to update
+   * @param newContent - The content to put into the file, overriding all existing
+   * @returns {Promise<Response>} The HTTP response
+   */
+  async putFile(file2, newContent) {
+    return await this.session.authenticatedFetch(file2.url, {
+      method: "PUT",
+      headers: {
+        "Content-Type": file2.blob()?.type ?? "text/plain"
+      },
+      body: newContent
+    });
+  }
 };
 
 // src/modules/contacts.ts
@@ -24838,8 +24858,20 @@ var PodOS = class {
   fetchAll(uris) {
     return this.store.fetchAll(uris);
   }
+  /**
+   * @deprecated Use {@link FileFetcher.fetchFile} via {@link PodOS.files} instead
+   * @param {string} url - URL identifying the file
+   * @returns {Promise<SolidFile>} An object representing the fetched file
+   */
   fetchFile(url7) {
-    return this.fileFetcher.fetchFile(url7);
+    return this.files().fetchFile(url7);
+  }
+  /**
+   * Provides access to file operations such as fetching and updating files in the pod
+   * @returns {FileFetcher} An instance of FileFetcher that handles file operations
+   */
+  files() {
+    return this.fileFetcher;
   }
   addPropertyValue(thing, property4, value7) {
     return this.store.addPropertyValue(thing, property4, value7);
@@ -24912,6 +24944,7 @@ export {
   AssumeAlwaysOnline,
   BinaryFile,
   BrokenFile,
+  FileFetcher,
   HttpStatus,
   LabelIndex,
   LdpContainer,

package/lib/index.js

@@ -34745,6 +34745,7 @@ _:patch
     AssumeAlwaysOnline: () => AssumeAlwaysOnline,
     BinaryFile: () => BinaryFile,
     BrokenFile: () => BrokenFile,
+    FileFetcher: () => FileFetcher,
     HttpStatus: () => HttpStatus,
     LabelIndex: () => LabelIndex,
     LdpContainer: () => LdpContainer,
@@ -35697,6 +35698,11 @@ _:patch
     constructor(session4) {
       this.session = session4;
     }
+    /**
+     * Fetch the contents of the given file
+     * @param {string} url - URL identifying the file
+     * @returns {Promise<SolidFile>} An object representing the fetched file
+     */
     async fetchFile(url7) {
       const response6 = await this.session.authenticatedFetch(url7);
       if (response6.ok) {
@@ -35709,6 +35715,21 @@ _:patch
         );
       }
     }
+    /**
+     * Updates the contents of a file (overrides old content with the given one)
+     * @param file - The file to update
+     * @param newContent - The content to put into the file, overriding all existing
+     * @returns {Promise<Response>} The HTTP response
+     */
+    async putFile(file2, newContent) {
+      return await this.session.authenticatedFetch(file2.url, {
+        method: "PUT",
+        headers: {
+          "Content-Type": file2.blob()?.type ?? "text/plain"
+        },
+        body: newContent
+      });
+    }
   };
 
   // src/modules/contacts.ts
@@ -57821,8 +57842,20 @@ _:patch
     fetchAll(uris) {
       return this.store.fetchAll(uris);
     }
+    /**
+     * @deprecated Use {@link FileFetcher.fetchFile} via {@link PodOS.files} instead
+     * @param {string} url - URL identifying the file
+     * @returns {Promise<SolidFile>} An object representing the fetched file
+     */
     fetchFile(url7) {
-      return this.fileFetcher.fetchFile(url7);
+      return this.files().fetchFile(url7);
+    }
+    /**
+     * Provides access to file operations such as fetching and updating files in the pod
+     * @returns {FileFetcher} An instance of FileFetcher that handles file operations
+     */
+    files() {
+      return this.fileFetcher;
     }
     addPropertyValue(thing, property4, value7) {
       return this.store.addPropertyValue(thing, property4, value7);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pod-os/core",
-  "version": "0.19.1-rc.c8e652b.0",
+  "version": "0.19.1-rc.ca6f577.0",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",
   "files": [
@@ -29,25 +29,25 @@
   "devDependencies": {
     "@babel/preset-env": "^7.28.3",
     "@babel/preset-typescript": "^7.27.1",
-    "@eslint/js": "^9.34.0",
+    "@eslint/js": "^9.37.0",
     "@types/jest": "^30.0.0",
     "@types/jest-when": "^3.5.5",
     "@types/sparqljs": "^3.1.12",
-    "esbuild": "^0.25.9",
-    "eslint": "^9.34.0",
-    "jest": "^30.1.2",
+    "esbuild": "^0.25.10",
+    "eslint": "^9.37.0",
+    "jest": "^30.2.0",
     "jest-when": "^3.7.0",
     "npm-run-all": "^4.1.5",
     "prettier": "^3.6.2",
     "rimraf": "^6.0.1",
     "sparqljs": "^3.7.3",
-    "typedoc": "^0.28.12",
-    "typedoc-plugin-markdown": "^4.8.1",
-    "typescript": "5.9.2",
-    "typescript-eslint": "^8.41.0"
+    "typedoc": "^0.28.13",
+    "typedoc-plugin-markdown": "^4.9.0",
+    "typescript": "5.9.3",
+    "typescript-eslint": "^8.46.0"
   },
   "dependencies": {
-    "@solid-data-modules/contacts-rdflib": "^0.7.0",
+    "@solid-data-modules/contacts-rdflib": "^0.7.1",
     "@solid-data-modules/rdflib-utils": "^0.6.0",
     "@types/lunr": "^2.3.7",
     "buffer": "^6.0.3",

package/types/files/FileFetcher.d.ts

@@ -3,5 +3,17 @@ import { SolidFile } from "./SolidFile";
 export declare class FileFetcher {
     private session;
     constructor(session: PodOsSession);
+    /**
+     * Fetch the contents of the given file
+     * @param {string} url - URL identifying the file
+     * @returns {Promise<SolidFile>} An object representing the fetched file
+     */
     fetchFile(url: string): Promise<SolidFile>;
+    /**
+     * Updates the contents of a file (overrides old content with the given one)
+     * @param file - The file to update
+     * @param newContent - The content to put into the file, overriding all existing
+     * @returns {Promise<Response>} The HTTP response
+     */
+    putFile(file: SolidFile, newContent: string): Promise<Response>;
 }

package/types/files/index.d.ts

@@ -2,3 +2,4 @@ export * from "./SolidFile";
 export * from "./BinaryFile";
 export * from "./BrokenFile";
 export * from "./HttpStatus";
+export * from "./FileFetcher";

package/types/index.d.ts

@@ -2,6 +2,7 @@ import { ContactsModule } from "@solid-data-modules/contacts-rdflib";
 import { BehaviorSubject } from "rxjs";
 import { SessionInfo, PodOsSession } from "./authentication";
 import { SolidFile } from "./files";
+import { FileFetcher } from "./files/FileFetcher";
 import { WebIdProfile } from "./profile";
 import { LabelIndex } from "./search";
 import { Store } from "./Store";
@@ -38,7 +39,17 @@ export declare class PodOS {
     private flagAuthorizationMetaDataOnSessionChange;
     fetch(uri: string): Promise<Response>;
     fetchAll(uris: string[]): Promise<PromiseSettledResult<Response>[]>;
+    /**
+     * @deprecated Use {@link FileFetcher.fetchFile} via {@link PodOS.files} instead
+     * @param {string} url - URL identifying the file
+     * @returns {Promise<SolidFile>} An object representing the fetched file
+     */
     fetchFile(url: string): Promise<SolidFile>;
+    /**
+     * Provides access to file operations such as fetching and updating files in the pod
+     * @returns {FileFetcher} An instance of FileFetcher that handles file operations
+     */
+    files(): FileFetcher;
     addPropertyValue(thing: Thing, property: string, value: string): Promise<void>;
     listKnownTerms(): Term[];
     addNewThing(uri: string, name: string, type: string): Promise<void>;