Skip to content

Versatile Node.js framework for a modern REST API.

License

Notifications You must be signed in to change notification settings

MarkKhramko/nodester

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

nodester

NPM version License

nodester is a Node.js framework designed to solve the problem of a complex data querying over HTTP.

The main reason of nodester's existence is the nodester Query Language (NQL) →, an extension of standard REST API syntax, it lets you craft complex queries with hierarchical associations.

Building an application which allows users to build their own REST queries raises huge security concerns. That's why nodester was not developped as a middleware. It's a framework equipped with a set of technologies enabling you to fully customize the request-response flow down to the specific user and a database column. Check out core concepts documentation → for more info.

Installation

Install with NPM

npm install -S nodester

Table of Contents

Usage

const nodester = require('nodester');
const db = require('#db');

const app = new nodester();
app.set.database(db);

// Optional beforeStart hook:
app.beforeStart(async () => {
  // Do any asynchronous initializations
  // before app.listen
  // ...
});

// Start the http server:
app.listen(8080, function() {
  console.log('listening on port', app.port);
});

// Gracefully shut down:
process.once('SIGTERM', () => {
  app.stop(() => {
    const pid = process.pid;
    console.info('Process', pid, 'terminated\n');
    process.exit(0);
  });
});

Documentation

Core concepts

Core concepts documentation →

Queries & querying - nodester Query Language (NQL)

The true strength of nodester lies in its query language. Serving as an extension of standard REST API syntax, it brings many aspects of SQL into REST requests, providing developers with a simple yet powerful tool for expressive and efficient data querying.

Read more about it in the documentation: NQL documentaion →

Database

Nodester is built upon a powerful Sequelize.
Supported drivers:

  • MySQL
  • PostgreSQL

How to setup a database →

Application

Application documentation →

Comments

We (contributors) use JSDoc to describe the actual code.

Philosophy

The Philosophy of nodester is to provide a developer with a tool that can build an app (or feature) in hours and scale it with ease for years.

Goal

The goal of nodester is to be a robust and flexible framework that makes development in iteratations easy, while laying the foundation for seamless scalability in the future.

License

MIT

Copyright

Copyright 2021-present Mark Khramko

About

Versatile Node.js framework for a modern REST API.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published