Synchronous-server NPM

Synchronous-Server

License

Overview

The synchronous-server package is a Node.js module that uses Rust crates to allow the Node.js server to run synchronously. The purpose of this package is to provide a synchronously running server-side implementation of Node.js for your specific needs, for example, safe modification of the same file by multiple clients when there are asynchronous operations between read and write.

Requirements

To use the synchronous-server package, you need to ensure the following:

Node.js is installed on your system
Rust is installed on your system

Installation

Make sure to have Rust and Cargo installed on your system, as this package relies on Rust crates for its functionality. The fastest way to install Rust is to use Rustup https://rustup.rs/

Install the synchronous-server package using npm:

npm install synchronous-server

Usage

After installing the package, you can use it in your Node.js application as follows:

const path = require("path");
const { startServer } = require("synchronous-server");

// Create an abs path to worker.js file
const workerPath = path.resolve(__dirname, "worker.js");

startServer(4001, workerPath);

Create file worker.js as follows:

const { request, response } = require("synchronous-server");

// Wrap to async to use await
(async () => {
  // Get request
  const req = request();
  console.log(`method: ${req.method}, url: ${req.url}`);
  // An asynchronous operation will be performed synchronously
  const res = await new Promise((resolve) => {
    setTimeout(() => {
      resolve({ hello: "world", body: req.body });
    }, 0);
  });
  // Send response
  response(res);
})();