@pod-os/core 0.23.0 → 0.23.1-rc.11e4e07.0

package/lib/index.js

@@ -32272,13 +32272,13 @@ _:patch
   });
 
   // ../node_modules/@solid-data-modules/rdflib-utils/dist/namespaces/index.js
-  var rdf3, solid, pim, ldp;
+  var rdf3, solid, pim2, ldp;
   var init_namespaces2 = __esm({
     "../node_modules/@solid-data-modules/rdflib-utils/dist/namespaces/index.js"() {
       init_esm();
       rdf3 = Namespace("http://www.w3.org/1999/02/22-rdf-syntax-ns#");
       solid = Namespace("http://www.w3.org/ns/solid/terms#");
-      pim = Namespace("http://www.w3.org/ns/pim/space#");
+      pim2 = Namespace("http://www.w3.org/ns/pim/space#");
       ldp = Namespace("http://www.w3.org/ns/ldp#");
     }
   });
@@ -32331,7 +32331,7 @@ _:patch
          * Look up the preferences file. Returns null if none is found or if the predicated does not link to a proper named node
          */
         queryPreferencesFile() {
-          const predicate4 = pim("preferencesFile");
+          const predicate4 = pim2("preferencesFile");
           return this.queryNamedNode(predicate4);
         }
         queryNamedNode(predicate4) {
@@ -34743,9 +34743,11 @@ _:patch
   __export(index_exports, {
     AnonymousSession: () => AnonymousSession,
     AssumeAlwaysOnline: () => AssumeAlwaysOnline,
+    AttachmentGateway: () => AttachmentGateway,
     BinaryFile: () => BinaryFile,
     BrokenFile: () => BrokenFile,
     FileFetcher: () => FileFetcher,
+    FileGateway: () => FileGateway,
     HttpStatus: () => HttpStatus,
     LabelIndex: () => LabelIndex,
     LdpContainer: () => LdpContainer,
@@ -34759,9 +34761,9 @@ _:patch
     SearchIndex: () => SearchIndex,
     Store: () => Store,
     Thing: () => Thing,
+    TypeIndex: () => TypeIndex2,
     UriService: () => UriService,
     WebIdProfile: () => WebIdProfile,
-    createPictureLinkOperation: () => createPictureLinkOperation,
     httpProblem: () => httpProblem,
     labelFromUri: () => labelFromUri,
     listKnownTerms: () => listKnownTerms,
@@ -37459,18 +37461,19 @@ _:patch
     }
   };
 
-  // src/modules/contacts.ts
-  async function loadContactsModule(store) {
-    const module3 = await Promise.resolve().then(() => (init_dist2(), dist_exports));
-    return store.loadModule(module3);
-  }
-
   // src/ldp-container/LdpContainer.ts
   init_esm();
 
   // src/thing/Thing.ts
   init_esm();
 
+  // src/namespaces/index.ts
+  init_esm();
+  var rdfs = Namespace("http://www.w3.org/2000/01/rdf-schema#");
+  var pim = Namespace("http://www.w3.org/ns/pim/space#");
+  var schema = Namespace("https://schema.org/");
+  var flow = Namespace("http://www.w3.org/2005/01/wf/flow#");
+
   // src/thing/accumulateSubjects.ts
   var accumulateSubjects = (accumulator, current3) => {
     const existing = accumulator[current3.predicate.uri];
@@ -37694,6 +37697,19 @@ _:patch
         label: labelForType(uri6)
       }));
     }
+    /**
+     * Returns all attachments linked to this thing
+     */
+    attachments() {
+      const statements = this.store.statementsMatching(
+        namedNode(this.uri),
+        flow("attachment")
+      );
+      return statements.filter((it) => isNamedNode(it.object)).map((statement2) => ({
+        uri: statement2.object.value,
+        label: labelFromUri(statement2.object.value)
+      }));
+    }
     /**
      * Call this method to switch to a more specific subclass of Thing.
      *
@@ -37736,17 +37752,16 @@ _:patch
     }
   };
 
-  // src/picture/createPictureLinkOperation.ts
+  // src/files/createFileLinkOperation.ts
   init_esm();
-  var SCHEMA_IMAGE = "http://schema.org/image";
-  function createPictureLinkOperation(thing, file2) {
+  function createFileLinkOperation(thing, predicateUri, file2) {
     return {
       deletions: [],
       filesToCreate: [],
       insertions: [
         st(
           namedNode(thing.uri),
-          namedNode(SCHEMA_IMAGE),
+          namedNode(predicateUri),
           namedNode(file2.url),
           namedNode(thing.uri).doc()
         )
@@ -37754,32 +37769,33 @@ _:patch
     };
   }
 
-  // src/picture/PictureGateway.ts
-  var PictureGateway = class {
+  // src/files/FileGateway.ts
+  var FileGateway = class {
     constructor(store, fileFetcher) {
       this.store = store;
       this.fileFetcher = fileFetcher;
     }
     /**
-     * Uploads a picture file and associates it with a thing.
+     * Uploads a file and associates it with a thing.
      * The container is automatically derived from the thing's URI.
      * Uses schema:image as the predicate.
      *
-     * @param thing - The thing to add the picture to
-     * @param pictureFile - The picture file to upload
-     * @returns Result with the uploaded picture metadata (url, name, contentType) or error
+     * @param thing - The thing to add the file to
+     * @param predicateUri - The URI of the predicate to use
+     * @param fileToUpload - The file to upload
+     * @returns Result with the uploaded metadata (url, name, contentType) or error
      */
-    uploadAndAddPicture(thing, pictureFile) {
+    uploadAndLinkFile(thing, predicateUri, fileToUpload) {
       const container2 = this.getContainerFromThing(thing);
-      return this.fileFetcher.createNewFile(container2, pictureFile).andThen((file2) => this.linkPictureToThing(thing, file2));
+      return this.fileFetcher.createNewFile(container2, fileToUpload).andThen((file2) => this.linkFileToThing(thing, predicateUri, file2));
     }
-    linkPictureToThing(thing, file2) {
-      const operation3 = createPictureLinkOperation(thing, file2);
+    linkFileToThing(thing, predicateUri, file2) {
+      const operation3 = createFileLinkOperation(thing, predicateUri, file2);
       return ResultAsync.fromPromise(
         this.store.executeUpdate(operation3).then(() => file2),
         () => ({
           type: "network",
-          title: "Failed to link picture to thing"
+          title: "Failed to link file to thing"
         })
       );
     }
@@ -37788,6 +37804,217 @@ _:patch
     }
   };
 
+  // src/modules/contacts.ts
+  async function loadContactsModule(store) {
+    const module3 = await Promise.resolve().then(() => (init_dist2(), dist_exports));
+    return store.loadModule(module3);
+  }
+
+  // src/attachments/AttachmentGateway.ts
+  var AttachmentGateway = class {
+    constructor(fileGateway) {
+      this.fileGateway = fileGateway;
+    }
+    /**
+     * Uploads an attachment file and associates it with a thing.
+     * The container is automatically derived from the thing's URI.
+     * Uses flow:attachment as the predicate.
+     *
+     * @param thing - The thing to add the attachment to
+     * @param attachmentFile - The attachment file to upload
+     * @returns Result with the uploaded attachment metadata (url, name, contentType) or error
+     */
+    uploadAndAddAttachment(thing, attachmentFile) {
+      return this.fileGateway.uploadAndLinkFile(
+        thing,
+        "http://www.w3.org/2005/01/wf/flow#attachment",
+        attachmentFile
+      );
+    }
+  };
+
+  // src/picture/PictureGateway.ts
+  var PictureGateway = class {
+    constructor(attachmentGateway) {
+      this.attachmentGateway = attachmentGateway;
+    }
+    /**
+     * Uploads a picture file and associates it with a thing.
+     * The container is automatically derived from the thing's URI.
+     * Uses schema:image as the predicate.
+     *
+     * @param thing - The thing to add the picture to
+     * @param pictureFile - The picture file to upload
+     * @returns Result with the uploaded picture metadata (url, name, contentType) or error
+     */
+    uploadAndAddPicture(thing, pictureFile) {
+      return this.attachmentGateway.uploadAndLinkFile(
+        thing,
+        "http://schema.org/image",
+        pictureFile
+      );
+    }
+  };
+
+  // src/profile/WebIdProfile.ts
+  init_esm();
+
+  // node_modules/@solid-data-modules/rdflib-utils/dist/web-operations/executeUpdate.js
+  async function executeUpdate2(fetcher2, updater, operation3) {
+    await updater.updateMany(operation3.deletions, operation3.insertions);
+    operation3.filesToCreate.map((file2) => {
+      createEmptyTurtleFile2(fetcher2, file2.url);
+    });
+  }
+  function createEmptyTurtleFile2(fetcher2, url7) {
+    return fetcher2.webOperation("PUT", url7, {
+      contentType: "text/turtle"
+    });
+  }
+
+  // node_modules/@solid-data-modules/rdflib-utils/dist/queries/PreferencesQuery.js
+  init_esm();
+
+  // node_modules/@solid-data-modules/rdflib-utils/dist/namespaces/index.js
+  init_esm();
+  var rdf4 = Namespace("http://www.w3.org/1999/02/22-rdf-syntax-ns#");
+  var solid2 = Namespace("http://www.w3.org/ns/solid/terms#");
+  var pim3 = Namespace("http://www.w3.org/ns/pim/space#");
+  var ldp2 = Namespace("http://www.w3.org/ns/ldp#");
+
+  // node_modules/@solid-data-modules/rdflib-utils/dist/queries/PreferencesQuery.js
+  var PreferencesQuery2 = class {
+    constructor(store, webIdNode, preferencesDoc) {
+      this.store = store;
+      this.webIdNode = webIdNode;
+      this.preferencesDoc = preferencesDoc;
+    }
+    /**
+     * Look up the private type index. Returns null if none is found or if the predicated does not link to a proper named node
+     */
+    queryPrivateTypeIndex() {
+      const node3 = this.store.any(this.webIdNode, solid2("privateTypeIndex"), null, this.preferencesDoc);
+      if (isNamedNode(node3)) {
+        return node3;
+      }
+      return null;
+    }
+  };
+
+  // node_modules/@solid-data-modules/rdflib-utils/dist/queries/ProfileQuery.js
+  init_esm();
+  var ProfileQuery2 = class {
+    constructor(webIdNode, store) {
+      this.webIdNode = webIdNode;
+      this.store = store;
+    }
+    /**
+     * Look up the public type index. Returns null if none is found or if the predicated does not link to a proper named node
+     */
+    queryPublicTypeIndex() {
+      const predicate4 = solid2("publicTypeIndex");
+      return this.queryNamedNode(predicate4);
+    }
+    /**
+     * Look up the preferences file. Returns null if none is found or if the predicated does not link to a proper named node
+     */
+    queryPreferencesFile() {
+      const predicate4 = pim3("preferencesFile");
+      return this.queryNamedNode(predicate4);
+    }
+    queryNamedNode(predicate4) {
+      const node3 = this.store.any(this.webIdNode, predicate4, null, this.webIdNode.doc());
+      if (isNamedNode(node3)) {
+        return node3;
+      }
+      return null;
+    }
+  };
+
+  // node_modules/@solid-data-modules/rdflib-utils/dist/identifier/generate-id.js
+  var import_short_unique_id2 = __toESM(require_short_unique_id(), 1);
+  var uid2 = new import_short_unique_id2.default({ length: 10 });
+
+  // src/profile/WebIdProfile.ts
+  var WebIdProfile = class extends Thing {
+    constructor(webId, store, editable = false) {
+      super(webId, store, editable);
+      this.webId = webId;
+      this.store = store;
+      this.editable = editable;
+      this.profileQuery = new ProfileQuery2(namedNode(this.webId), this.store);
+    }
+    /**
+     * Returns the URI of the preferences document
+     */
+    getPreferencesFile() {
+      return this.profileQuery.queryPreferencesFile()?.value;
+    }
+    /**
+     * Returns the URI of the public type index document
+     */
+    getPublicTypeIndex() {
+      return this.profileQuery.queryPublicTypeIndex()?.value;
+    }
+    /**
+     * Returns the URI of the private type index document
+     */
+    getPrivateTypeIndex() {
+      const preferences = this.profileQuery.queryPreferencesFile();
+      if (!preferences) return void 0;
+      const query4 = new PreferencesQuery2(
+        this.store,
+        namedNode(this.webId),
+        preferences
+      );
+      return query4.queryPrivateTypeIndex()?.value;
+    }
+    /**
+     * Returns the URIs of the private label indexes
+     */
+    getPrivateLabelIndexes() {
+      const profileNodes = this.store.each(
+        namedNode(this.webId),
+        namedNode("http://www.w3.org/ns/solid/terms#privateLabelIndex"),
+        void 0,
+        namedNode(this.webId).doc()
+      );
+      const preferences = this.getPreferencesFile();
+      if (preferences) {
+        const preferencesNodes = this.store.each(
+          namedNode(this.webId),
+          namedNode("http://www.w3.org/ns/solid/terms#privateLabelIndex"),
+          void 0,
+          namedNode(preferences)
+        );
+        return [...profileNodes, ...preferencesNodes].map((it) => it.value);
+      } else {
+        return profileNodes.map((it) => it.value);
+      }
+    }
+  };
+
+  // src/profile/ProfileGateway.ts
+  var ProfileGateway = class {
+    constructor(store) {
+      this.store = store;
+    }
+    async fetchProfile(webId) {
+      await this.store.fetch(webId);
+      const profile2 = this.store.get(webId).assume(WebIdProfile);
+      const preferences = profile2.getPreferencesFile();
+      if (preferences) {
+        await this.store.fetch(preferences);
+      }
+      const publicTypeIndex2 = profile2.getPublicTypeIndex();
+      const privateTypeIndex2 = profile2.getPrivateTypeIndex();
+      await this.store.fetchAll(
+        [privateTypeIndex2, publicTypeIndex2].filter((it) => it !== void 0)
+      );
+      return profile2;
+    }
+  };
+
   // src/search/SearchIndex.ts
   var import_lunr = __toESM(require_lunr(), 1);
   var SearchIndex = class {
@@ -37871,12 +38098,6 @@ _:patch
     }
   };
 
-  // src/namespaces/index.ts
-  init_esm();
-  var rdfs = Namespace("http://www.w3.org/2000/01/rdf-schema#");
-  var pim2 = Namespace("http://www.w3.org/ns/pim/space#");
-  var schema = Namespace("https://schema.org/");
-
   // src/search/LabelIndex.ts
   var LabelIndex = class extends RdfDocument {
     constructor(uri6, store, editable = false) {
@@ -37909,84 +38130,6 @@ _:patch
 
   // src/search/createDefaultLabelIndex.ts
   init_esm();
-
-  // node_modules/@solid-data-modules/rdflib-utils/dist/web-operations/executeUpdate.js
-  async function executeUpdate2(fetcher2, updater, operation3) {
-    await updater.updateMany(operation3.deletions, operation3.insertions);
-    operation3.filesToCreate.map((file2) => {
-      createEmptyTurtleFile2(fetcher2, file2.url);
-    });
-  }
-  function createEmptyTurtleFile2(fetcher2, url7) {
-    return fetcher2.webOperation("PUT", url7, {
-      contentType: "text/turtle"
-    });
-  }
-
-  // node_modules/@solid-data-modules/rdflib-utils/dist/queries/PreferencesQuery.js
-  init_esm();
-
-  // node_modules/@solid-data-modules/rdflib-utils/dist/namespaces/index.js
-  init_esm();
-  var rdf4 = Namespace("http://www.w3.org/1999/02/22-rdf-syntax-ns#");
-  var solid2 = Namespace("http://www.w3.org/ns/solid/terms#");
-  var pim3 = Namespace("http://www.w3.org/ns/pim/space#");
-  var ldp2 = Namespace("http://www.w3.org/ns/ldp#");
-
-  // node_modules/@solid-data-modules/rdflib-utils/dist/queries/PreferencesQuery.js
-  var PreferencesQuery2 = class {
-    constructor(store, webIdNode, preferencesDoc) {
-      this.store = store;
-      this.webIdNode = webIdNode;
-      this.preferencesDoc = preferencesDoc;
-    }
-    /**
-     * Look up the private type index. Returns null if none is found or if the predicated does not link to a proper named node
-     */
-    queryPrivateTypeIndex() {
-      const node3 = this.store.any(this.webIdNode, solid2("privateTypeIndex"), null, this.preferencesDoc);
-      if (isNamedNode(node3)) {
-        return node3;
-      }
-      return null;
-    }
-  };
-
-  // node_modules/@solid-data-modules/rdflib-utils/dist/queries/ProfileQuery.js
-  init_esm();
-  var ProfileQuery2 = class {
-    constructor(webIdNode, store) {
-      this.webIdNode = webIdNode;
-      this.store = store;
-    }
-    /**
-     * Look up the public type index. Returns null if none is found or if the predicated does not link to a proper named node
-     */
-    queryPublicTypeIndex() {
-      const predicate4 = solid2("publicTypeIndex");
-      return this.queryNamedNode(predicate4);
-    }
-    /**
-     * Look up the preferences file. Returns null if none is found or if the predicated does not link to a proper named node
-     */
-    queryPreferencesFile() {
-      const predicate4 = pim3("preferencesFile");
-      return this.queryNamedNode(predicate4);
-    }
-    queryNamedNode(predicate4) {
-      const node3 = this.store.any(this.webIdNode, predicate4, null, this.webIdNode.doc());
-      if (isNamedNode(node3)) {
-        return node3;
-      }
-      return null;
-    }
-  };
-
-  // node_modules/@solid-data-modules/rdflib-utils/dist/identifier/generate-id.js
-  var import_short_unique_id2 = __toESM(require_short_unique_id(), 1);
-  var uid2 = new import_short_unique_id2.default({ length: 10 });
-
-  // src/search/createDefaultLabelIndex.ts
   function createDefaultLabelIndex(profile2) {
     const webId = namedNode(profile2.webId);
     const preferencesFile2 = profile2.getPreferencesFile();
@@ -59604,87 +59747,6 @@ _:patch
     }
   };
 
-  // src/profile/WebIdProfile.ts
-  init_esm();
-  var WebIdProfile = class extends Thing {
-    constructor(webId, store, editable = false) {
-      super(webId, store, editable);
-      this.webId = webId;
-      this.store = store;
-      this.editable = editable;
-      this.profileQuery = new ProfileQuery2(namedNode(this.webId), this.store);
-    }
-    /**
-     * Returns the URI of the preferences document
-     */
-    getPreferencesFile() {
-      return this.profileQuery.queryPreferencesFile()?.value;
-    }
-    /**
-     * Returns the URI of the public type index document
-     */
-    getPublicTypeIndex() {
-      return this.profileQuery.queryPublicTypeIndex()?.value;
-    }
-    /**
-     * Returns the URI of the private type index document
-     */
-    getPrivateTypeIndex() {
-      const preferences = this.profileQuery.queryPreferencesFile();
-      if (!preferences) return void 0;
-      const query4 = new PreferencesQuery2(
-        this.store,
-        namedNode(this.webId),
-        preferences
-      );
-      return query4.queryPrivateTypeIndex()?.value;
-    }
-    /**
-     * Returns the URIs of the private label indexes
-     */
-    getPrivateLabelIndexes() {
-      const profileNodes = this.store.each(
-        namedNode(this.webId),
-        namedNode("http://www.w3.org/ns/solid/terms#privateLabelIndex"),
-        void 0,
-        namedNode(this.webId).doc()
-      );
-      const preferences = this.getPreferencesFile();
-      if (preferences) {
-        const preferencesNodes = this.store.each(
-          namedNode(this.webId),
-          namedNode("http://www.w3.org/ns/solid/terms#privateLabelIndex"),
-          void 0,
-          namedNode(preferences)
-        );
-        return [...profileNodes, ...preferencesNodes].map((it) => it.value);
-      } else {
-        return profileNodes.map((it) => it.value);
-      }
-    }
-  };
-
-  // src/profile/ProfileGateway.ts
-  var ProfileGateway = class {
-    constructor(store) {
-      this.store = store;
-    }
-    async fetchProfile(webId) {
-      await this.store.fetch(webId);
-      const profile2 = this.store.get(webId).assume(WebIdProfile);
-      const preferences = profile2.getPreferencesFile();
-      if (preferences) {
-        await this.store.fetch(preferences);
-      }
-      const publicTypeIndex2 = profile2.getPublicTypeIndex();
-      const privateTypeIndex2 = profile2.getPrivateTypeIndex();
-      await this.store.fetchAll(
-        [privateTypeIndex2, publicTypeIndex2].filter((it) => it !== void 0)
-      );
-      return profile2;
-    }
-  };
-
   // src/authentication/index.ts
   var AnonymousSession = class {
     constructor() {
@@ -59707,6 +59769,53 @@ _:patch
     }
   };
 
+  // src/type-index/TypeIndex.ts
+  init_esm();
+  var TypeIndex2 = class extends Thing {
+    constructor(uri6, store, editable = false) {
+      super(uri6, store, editable);
+      this.uri = uri6;
+      this.store = store;
+      this.editable = editable;
+    }
+    listAll() {
+      const forClassStatements = this.store.statementsMatching(
+        null,
+        solid2("forClass"),
+        null,
+        namedNode(this.uri)
+      );
+      return forClassStatements.map((statement2) => {
+        const subject8 = statement2.subject;
+        const instanceContainerStatements = this.store.statementsMatching(
+          subject8,
+          solid2("instanceContainer"),
+          null,
+          namedNode(this.uri)
+        );
+        const instanceStatements = this.store.statementsMatching(
+          subject8,
+          solid2("instance"),
+          null,
+          namedNode(this.uri)
+        );
+        const instances2 = instanceStatements.map((it) => ({
+          type: "instance",
+          uri: it.object.value
+        }));
+        const instanceContainers = instanceContainerStatements.map((it) => ({
+          type: "container",
+          uri: it.object.value
+        }));
+        return {
+          targets: [...instanceContainers, ...instances2],
+          forClass: statement2.object.value,
+          label: labelForType(statement2.object.value)
+        };
+      });
+    }
+  };
+
   // src/index.ts
   var PodOS = class {
     constructor({
@@ -59725,7 +59834,9 @@ _:patch
       );
       this.searchGateway = new SearchGateway(this.store);
       this.fileFetcher = new FileFetcher(this.session);
-      this.pictureGateway = new PictureGateway(this.store, this.fileFetcher);
+      this.fileGateway = new FileGateway(this.store, this.fileFetcher);
+      this.attachmentGateway = new AttachmentGateway(this.fileGateway);
+      this.pictureGateway = new PictureGateway(this.fileGateway);
       this.flagAuthorizationMetaDataOnSessionChange();
       this.uriService = new UriService(this.store);
       this.profileGateway = new ProfileGateway(this.store);
@@ -59835,6 +59946,13 @@ _:patch
     uploadAndAddPicture(thing, pictureFile) {
       return this.pictureGateway.uploadAndAddPicture(thing, pictureFile);
     }
+    /**
+     * Provides access to attachment operations such as uploading and linking attachments to things
+     * @returns {AttachmentGateway} An instance of AttachmentGateway that handles attachment operations
+     */
+    attachments() {
+      return this.attachmentGateway;
+    }
   };
   return __toCommonJS(index_exports);
 })();

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@pod-os/core",
   "description": "Core module of PodOS",
-  "version": "0.23.0",
+  "version": "0.23.1-rc.11e4e07.0",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./types/index.d.ts",

package/types/attachments/AttachmentGateway.d.ts

@@ -0,0 +1,23 @@
+import { ResultAsync } from "neverthrow";
+import { Thing } from "../thing";
+import { FileGateway, NewFile } from "../files";
+import { HttpProblem, NetworkProblem } from "../problems";
+/**
+ * Gateway for attachment-related operations on Solid Pods and the store.
+ */
+export declare class AttachmentGateway {
+    private readonly fileGateway;
+    constructor(fileGateway: FileGateway);
+    /**
+     * Uploads an attachment file and associates it with a thing.
+     * The container is automatically derived from the thing's URI.
+     * Uses flow:attachment as the predicate.
+     *
+     * @param thing - The thing to add the attachment to
+     * @param attachmentFile - The attachment file to upload
+     * @returns Result with the uploaded attachment metadata (url, name, contentType) or error
+     */
+    uploadAndAddAttachment(thing: Thing, attachmentFile: File): ResultAsync<UploadedAttachment, HttpProblem | NetworkProblem>;
+}
+type UploadedAttachment = NewFile;
+export {};

package/types/attachments/index.d.ts

@@ -0,0 +1 @@
+export * from "./AttachmentGateway";

package/types/files/FileFetcher.d.ts

@@ -3,6 +3,9 @@ import { SolidFile } from "./SolidFile";
 import { LdpContainer } from "../ldp-container";
 import { HttpProblem, NetworkProblem } from "../problems";
 import { ResultAsync } from "neverthrow";
+/**
+ * Handles HTTP operations for files, like fetching and updating file contents.
+ */
 export declare class FileFetcher {
     private session;
     constructor(session: PodOsSession);