Why Node.js needs a virtual file system

(blog.platformatic.dev)

72 points | by voctor 2 hours ago ago

59 comments

  • indutny an hour ago

    Taking the question of whether this would be a useful addition to Node.js core or aside, it must be noted that this 19k LoC PR was mostly generated by Claude Code and manually reviewed by the submitter which in my opinion is against the spirit of the project and directly violates the terms of Developer's Certificate of Origin set in the project's CONTRIBUTING.md

    • digikata 21 minutes ago

      Large PRs could follow the practices that the Linux kernel dev lists follow. Sometimes large subsystem changes could be carried separately for a while by the submitter for testing and maintenance before being accepted in theory, reviewed, and if ready, then merged.

      While the large code changes were maintained, they were often split up into a set of semantically meaningful commits for purposes of review and maintenance.

      With AI blowing up the line counts on PRs, it's a skill set that more developers need to mature. It's good for their own review to take the mass changes, ask themselves how would they want to systematically review it in parts, then split the PR up into meaningful commits: e.g. interfaces, docs, subsets of changed implementations, etc.

      • goalieca 9 minutes ago

        > With AI blowing up the line counts on PRs,

        Well, the process you’re describing is mature and intentionally slows things down. The LLM push has almost the opposite philosophy. Everyone talks about going faster and no one believes it is about higher quality.

    • epolanski an hour ago

      Do as I say, not as I do.

      On a more serious note, I think that this will be thoroughly reviewed before it gets merged and Node has an entire security team that overviews these.

      • indutny 38 minutes ago

        As someone who was a part of the aforementioned security team I'm not sure I'd be interested in reviewing such volume of machine generated code, expecting trap at every corner. The implicit assumption that I observed at many OSS projects I've been involved with is that first time contributions are rarely accepted if they are too large in volume, and "core contributor" designation exists to signal "I put effort into this code, stand by it, and respect everyone's time in reviewing it". The PR in the post violates this social contract.

    • athorax 37 minutes ago

      How exactly does it violate the Developer's Certificate of Origin clause?

      • indutny 31 minutes ago

        The submitted code must adhere to either of (a), (b), (c), and separately a (d) clause of: https://github.com/nodejs/node/blob/main/CONTRIBUTING.md#dev...

        If submitter picks (a) they assert that they wrote the code themselves and have right to submit it under project's license. If (b) the code was taken from another place with clear license terms compatible with the project's license. If (c) contribution was written by someone else who asserted (a) or (b) and is submitted without changes.

        Since LLM generated output is based on public code, but lacks attribution and the license of the original it is not possible to pick (b). (a) and (c) cannot be picked based on the submitter disclaimer in the PR body.

        • charcircuit 15 minutes ago

          It would be considered (a) since the author would own the copyright on the code.

          • crote 3 minutes ago

            Citation needed.

            Whether AI output can fall under copyright at all is still up for debate - with some early rulings indicating that the fact that you prompted the AI does not automatically grant you authorship.

            Even if it does, it hasn't been settled yet what the impact of your AI having been trained on copyrighted material is on its output. You can make a not-completely-unreasonable argument that AI inference output is a derivative work of AI training input.

            Fact is, the matter isn't settled yet, which means any open-source project should assume the worst possible outcome - which in practice means a massive AI-generated PR like this should be treated like a nuke which could go off at any moment.

  • wccrawford 2 hours ago

    I'm not convinced that allowing Node to import "code generated at runtime" is actually a good thing. I think it should have to go through the hoops to get loaded, for security reasons.

    I like the idea of it mocking the file system for tests, but I feel like that should probably be part of the test suite, not Node.

    The example towards the end that stores data in a sqlite provider and then saves it as a JSON file is mind-boggling to me. Especially for a system that's supposed to be about not saving to the disk. Perhaps it's just a bad example, but I'm really trying to figure out how this isn't just adding complexity.

    • Normal_gaussian 30 minutes ago

          node -e "new Function('console.log(\"hi\")')()"
      
      
      or more to the point

          node -e "fetch('https://unpkg.com/cowsay/build/cowsay.umd.js').then((r) => r.text()).then(c => new Function(c + 'console.log(exports.say({ text: \"like this\"}))')())"
      
      that one is particularly bad, because umd messes with the global object - so this works

          node -e "fetch('https://unpkg.com/cowsay/build/cowsay.umd.js').then((r) => r.text()).then(c => new Function(c)()).then(() => console.log(exports.say({ text: 'oh no'})))"
    • TheRealPomax an hour ago

      But then you go "hang on, doesn't ESM exist?" and you realize that argument 4 isn't even true. You can literally do what this argument says you can't, by creating a blob instead of "writing a temp file" and then importing that using the same dynamic import we've had available since <checks his watch> 2020.

  • austin-cheney 2 hours ago

    Most of the 4 justifications mentioned sound like mitigations of otherwise bad design decisions. JavaScript in the browser went down this path for the longest time where new standards were introduced only to solve for stupid people instead of actually introducing new capabilities that were otherwise unachievable.

    I do see some original benefits to a VFS though, bad application decisions aside, but they are exceedingly minor.

    As an aside I think JavaScript would benefit from an in-memory database. This would be more of language enhancement than a Node.js enhancement. Imagine the extended application capabilities of an object/array store native to the language that takes queries using JS logic to return one or more objects/records. No SQL language and no third party databases for stuff that you don't want to keep in offline storage on a disk.

  • PaulHoule 2 hours ago

    Would be nice if node packages could be packed up in ZIP files so to avoid the security/metadata tax for small file access on Windows.

    • MarleTangible 2 hours ago

      The number of files in the node modules folder is crazy, any amount of organization that can tame that chaos is welcomed.

      • koolba an hour ago

        And if you thought malware hiding in a mess of files was bad, just wait till you see it in two layers of container files.

        • PaulHoule 40 minutes ago

          Or worse yet, the performance load of anti-malware software that has to look inside ZIP files.

          Look, most of us realized around 2004 or so that if you had a choice between Norton and the virus you would pick the virus. In the Windows world we standardized around Defender because there is some bound on how much Defender degrades the performance of your machine which was not the case with competitive antivirus software.

          I've done a few projects which involved getting container file formats like ZIP and PDF (e.g. you know it's a graph of resources in which some of those resources are containers that contain more resources, right?) and now that I think of it you ought to be able to virus scan ZIP files quickly and intelligently but the whole problem with the antivirus industry is that nobody ever considers the cost.

    • Dangeranger an hour ago

      There are alternative package managers like Yarn that use zip files as a way to store each Node package.[0]

      [0] https://yarnpkg.com/advanced/pnp-spec#zip-access

      • chrisweekly 6 minutes ago

        Strong recommendation to use PNPM instead of yarn or npm. IME (webdev since 1998) it's the only sane tool for stewardship of an npm dependency graph.

        See https://pnpm.io/motivation

        Also, while popularity isn't necessarily a great indicator of quality, a quick comparison shows that the community has decided on pnpm:

        https://www.npmcharts.com/compare/pnpm,yarn,npm

      • PaulHoule 39 minutes ago

        ... and of course JAR files in Java are just ZIP files with a little extra metadata and the JVM can unpack them in realtime just fine.

    • zadikian 25 minutes ago

      Would accessing deps directly from a zip really be faster?

    • fmorel 2 hours ago

      I remember when Firefox started putting everything into jars for similar reasons.

      https://web.archive.org/web/20161003115800/https://blog.mozi...

    • MBCook an hour ago

      It’s insane to me that node works how it does. Zip files make so much more sense, I really liked that about Yarn.

    • sheept 2 hours ago

      Would it work to run a bundler over your code, so all (static) imports are inlined and tree shaken?

  • mg an hour ago

        You can’t import or require() a module
        that only exists in memory.
    
    You can convert it into a data url and import that, can't you?
    • afavour 31 minutes ago

      What happens to relative imports?

    • doctorpangloss an hour ago

      Yeah but Claude didn't suggest that when it wrote this blog post and did all the work so...

  • mohsen1 36 minutes ago

    Yarn, pnpm, webpack all have solutions for this. Great to see this becoming a standard. I have a project that is severely handicapped due to FS. Running 13k tests takes 40 minutes where a virtual file system that Node would just work with it would cut the run time to 3 minutes. I experimented with some hacks and decided to stay with slow but native FS solution.

    What I really want is a way of swapping FS with VFS in a Node.js program harness. Something like

         node --use-vfs --vfs-cache=BIG_JSON_FILE 
    
    So basically Node never touches the disk and load everything from the memory
    • Normal_gaussian 21 minutes ago

      The way to do this today is to do it outside of node. Using an overlay fs with the overlay being a ramfs. You can even chroot into it if you can't scope the paths you need to be just downstream from some directory. Or, just use docker.

      • mohsen1 12 minutes ago

        making that work cross platform is pure pain

  • Normal_gaussian an hour ago

    yarn pnp is currently broken on Node v25.7+;

    - https://github.com/yarnpkg/berry/issues/7065

    - https://github.com/nodejs/node/issues/62012

    This is because yarn patches fs in order to introduce virtual file path resolution of modules in the yarn cache (which are zips), which is quite brittle and was broken by a seemingly unrelated change in 25.7.

    The discussion in issue 62012 is notable - it was suggested yarn just wait for vfs to land. This is interesting to me in two ways: firstly, the node team seems quite happy for non-trivial amounts of the ecosystem to just be broken, and suggests relying on what I'm assuming will be an experimental API when it does land; secondly, it implies a lot of confidence that this feature will land before LTS.

  • notnullorvoid an hour ago

    I could see something like this being useful if it could be passed to workers to replace any fs access inside the worker.

  • ozlikethewizard an hour ago

    I'm not convinced this needs to be in core Node, but being able to have serverless functions access a file system without providing storage would definitely have some use cases. Had some fun with video processing recently that this would be perfect for.

  • rigorclaw 21 minutes ago

    the multi-tenant sandboxing use case is interesting but mount() being process-global feels like a footgun. has anyone explored per-isolate or per-worker VFS scoping? seems like the kind of thing that would matter a lot for platform companies running untrusted code.

  • westurner an hour ago

    Is node::vfs the new solution for JupyterLite filesystems?

    From https://github.com/jupyterlite/jupyterlite/issues/949#issuec... :

    > Ideally, the virtual filesystem of JupyterLite would be shared with the one from the virtual terminal.

    emscripten-core/emscripten > "New File System Implementation": https://github.com/emscripten-core/emscripten/issues/15041#i... :

    > [ BrowserFS, isomorphic-git/lightningfs, ]

    pyodide/pyodide: "Native file system API" #738: https://github.com/pyodide/pyodide/issues/738 re: [Chrome,] Filesystem API :

    > jupyterlab-git [should work with the same VFS as Jupyter kernels and Terminals]

    pyodide/pyodide: "ENH Add API for mounting native file system" #2987: https://github.com/pyodide/pyodide/pull/2987

  • moralestapia 2 hours ago

    >Let me be honest: a PR that size would normally take months of full-time work. This one happened because I built it with Claude Code.

    The node.js codebase and standard library has a very high standard of quality, hope that doesn't get washed out by sloppy AI-generated code.

    OTOH, Matteo is an excellent engineer and the community owes a lot to him. So I guess the code is solid :).

  • petcat 2 hours ago

    Are people still building new projects on Node.js? I would have thought the ecosystem was moving to deno or bun now

    • dzogchen 2 hours ago

      I don't really understand what the value proposition of Bun and Deno is. And I see huge problems with their governance and long-term sustainability.

      Node.js on the other hand is not owned or controlled by one entity. It is not beholden to the whims of investors or a large corporation. I have contributed to Node.js in the past and I was really impressed by its rock-solid governance model and processes. I think this an under-appreciated feature when evaluating tech options.

      • packetlost 2 hours ago

        Deno has some pretty nice unique features like sandboxing that, afaik, don't exist in other runtimes (yet). It's enough of a draw that it's the recommended runtime for projects like yt-dlp: https://github.com/yt-dlp/yt-dlp/issues/14404

        • worksonmine an hour ago

          Node has sandboxing these days: https://nodejs.org/api/permissions.html

          • dzogchen 14 minutes ago

            No it doesn't, unfortunately.

            > The permission model implements a "seat belt" approach, which prevents trusted code from unintentionally changing files or using resources that access has not explicitly been granted to. It does not provide security guarantees in the presence of malicious code. Malicious code can bypass the permission model and execute arbitrary code without the restrictions imposed by the permission model.

            Deno's permissions model is actually a very nice feature. But it is not very granular so I think you end up just allowing everything a lot of the time. I also think sandboxing is a responsibility of the OS. And lastly, a lot of use cases do not really benefit from it (e.g. server applications).

      • zamadatix an hour ago

        If one gets nothing from them directly, they've at least been a good kick to get several features into Node. It's almost like neovim was to vim, perhaps to a lesser extent.

      • pier25 30 minutes ago

        I agree about the governance and long-term sustainability points but if you don't see any value in Bun or Deno is probably because (no offense) you are not paying attention.

    • jitl 2 hours ago

      loud people on twitter are always switching to the new hotness. i personally can't see myself using bun until its reputation for segfaults goes away after a few more years of stabilizing. deno seems neat and has been around for longer, but its node compatibility story is still evolving; i'm also giving it another year before i try it.

    • zadikian 27 minutes ago

      Yes people are using Node.js, most likely the majority.

    • rrr_oh_man 2 hours ago

      Why?

    • kitsune1 2 hours ago

      The delusion in this comment is insane.

  • pier25 35 minutes ago

    The Node team has lost the plot IMO.

    By far the most critical issue is the over reliance on third party NPM packages for even fundamental needs like connecting to a database.

    • afavour 33 minutes ago

      What would a Node-native database connection layer look like? What other platforms have that?

      Databases are third party tech, I don’t think it’s unreasonable to use a third party NPM module to connect to them.

      • mike_hearn 23 minutes ago

        Most obviously, Java has JDBC. I think .NET has an equivalent. Drivers are needed but they're often first party, coming directly from the DB vendor itself.

        Java also has a JIT compiling JS engine that can be sandboxed and given a VFS:

        https://www.graalvm.org/latest/security-guide/sandboxing/

        N.B. there's a NodeJS compatible mode, but you can't use VFS+sandboxing and NodeJS compatibility together because the NodeJS mode actually uses the real NodeJS codebase, just swapping out V8. For combining it all together you'd want something like https://elide.dev which reimplemented some of the Node APIs on top of the JVM, so it's sandboxable and virtualizable.

        • LunaSea 11 minutes ago

          > Most obviously, Java has JDBC. I think .NET has an equivalent. Drivers are needed but they're often first party, coming directly from the DB vendor itself.

          So it's an external dependency that is not part of Java. It doesn't really matter if the code comes from the vendor or not. Especially for OpenSource databases.

      • pier25 20 minutes ago

        Bun provides native MySQL, SQlite, and Postgres drivers.

        I'm not saying Node should support every db in existence but the ones I listed are critical infrastructure at this point.

        When using Postgres in Node you either rely on the old pg which pulls 13 dependencies[1] or postgres[2] which is much better and has zero deps but mostly depends on a single guy.

        [1] https://npmgraph.js.org/?q=pg

        [2] https://github.com/porsager/postgres

      • ksherlock 25 minutes ago

        Perl has DBI. PHP has PDO.

    • beart 27 minutes ago

      Outside of sqlite, what runtimes natively include database drivers?

      • pier25 19 minutes ago

        Bun, .NET, PHP, Java

        • LunaSea 10 minutes ago

          For Bun you're thinking of simple key / values, hardly a database. They also have a SQLite driver which is still just a package.