cloudflare-virtual-fs-do

The Cloudflare Virtual FS in Durable Object repository presents an innovative solution for creating a virtual file system using Durable Objects and SQLite. The project's goal is to emulate a file system where all standard file system (fs) calls can be executed swiftly and efficiently through a Durable Object (DO). This is achieved by taking advantage of the asynchronous nature of SQLite and RPC capabilities.

Key Features

• Emulates a File System: The implementation aims to provide an API that closely resembles the familiar file system interface, making it easy for developers to integrate.
• Fast Operations: Thanks to the asynchronous design, operations are expected to be rapid, enhancing the overall performance of applications utilizing this system.
• Dynamic DO Naming: The project allows for the creation of DO stubs as part of the API, where the Durable Object's name corresponds to the first folder name, facilitating organized access.

Implementation Details

To get started, run the main program and visit localhost:3000 to see the initial version in action. Developers can integrate it into their projects by simply copying fs.ts into their Cloudflare worker.

Enhancements

An update to the repository includes an alternate implementation in blocks.ts, which leverages blocks to handle larger files. This approach is designed to accommodate virtually infinite file sizes, with initial tests demonstrating functionality for files up to 400kb, such as images.

Potential Future Developments

While the project is in its early stages and has not undergone extensive testing, it serves as a foundation for those interested in building a reliable virtual file system powered by Durable Objects and SQLite. Future updates may expand its capabilities and stability.