MISC: Add file metadata (timestamps) (#2199)

src/NetscriptFunctions.ts

@@ -1402,6 +1402,18 @@ export const ns: InternalAPI<NSFull> = {
     const server = ctx.workerScript.getServer();
     return server.getContentFile(path)?.content ?? "";
   },
+  getFileMetadata: (ctx) => (_filename) => {
+    const path = helpers.filePath(ctx, "filename", _filename);
+    if (!hasScriptExtension(path) && !hasTextExtension(path)) {
+      throw new Error(`Invalid path: ${_filename}. It must be a text file or a script.`);
+    }
+    const server = ctx.workerScript.getServer();
+    const contentFile = server.getContentFile(path);
+    if (!contentFile) {
+      throw new Error(`Invalid path: ${_filename}. The file does not exist on ${server.hostname}.`);
+    }
+    return contentFile.metadata.plain();
+  },
   peek: (ctx) => (_portNumber) => {
     const portNumber = helpers.portNumber(ctx, _portNumber);
     return peekPort(portNumber);