@tramwayjs/core v3.0.0-beta.0

Tramway is a simple framework core that can be used with Express to speed up and structure apps built in ES2015+. It includes:

1. A dynamic routing system that separates routes from routing logic and is adaptable
2. Restful routes to save time building APIs
3. An adaptive Connection system
4. Models and Entities which are separate but when used together with Connections can speed up workflow.
5. Authentication policies that allow for multiple strategies to be used and interchanged without needing the logic throughout the code. and so much more.

This library provides the common core and it is encouraged to install the compatible pieces you need for your project.

Installation:

1. npm install @tramwayjs/core

Example project

https://gitlab.com/tramwayjs/tramway-example

Documentation

Recommended Folder Structure

• config
• errors
• services

App

The App class encapsulates all the internal configuration and Dependency Injection setup, as well as the new event-driven Kernel communications that can be used to extend Tramway's with dashboards and debugging tools.

Server

The Server class encompasses your routed Controllers into a clean shell that can be built with the @tramwayjs/dependency-injector library.

To use Server in your server.js the declarative way:

import {Server} from '@tramwayjs/core';
...

let server = new Server(router, express, port);
server.use(cors());

server.initialize().start();

To use Server with dependency injection in the services declaration:

import {Server} from '@tramwayjs/core';

export default {
    "server": {
        "class": Server,
        "constructor": [
            {"type": "service", "key": "router"},
            {"type": "parameter", "key": "app"},
            {"type": "parameter", "key": "PORT"},
        ],
        "functions": [
            {
                "function": "use",
                "args": [{"type": "parameter", "key": "cors"}],
            },
        ],
    }
}

In your server.js:

let server = DependencyResolver.getService('server');
server.initialize().start();

app.set

The Server provides an injectable wrapper over the Express app's set method which can be used to managed trusted proxies.

It takes an object with a key and value, where the value is expected to be an array that can be spread as many arguments in the express set method.

Declarative:

let server = new Server(router, express, port);
server.set({key: 'trust proxy', value: true});

To use with dependency injection in the services declaration:

Create src/config/parameters/global/trustedProxy.js

export default {
    key: 'trust proxy',
    value: true,
}

In src/config/parameters/global/index.js

Add a reference to the above config saved in trustedProxy.js

...
import trustedProxy from './trustedProxy';

export default {
    ...
    trustedProxy,
}

In config/services/core.js:

import {Server} from '@tramwayjs/core';

export default {
    "server": {
        "class": Server,
        "constructor": [
            {"type": "service", "key": "router"},
            {"type": "parameter", "key": "app"},
            {"type": "parameter", "key": "PORT"},
            {"type": "parameter", "key": "httpsConfig"},
        ],
        "functions": [
            {
                "function": "use",
                "args": [{"type": "parameter", "key": "cors"}],
            },
            {
                "function": "set",
                "args": [{"type": "parameter", "key": "trustedProxy"}],
            },
        ],
    }
}

Config

Here is where you can put all the parameters for express - like CORS

Services

The services folder is to place any logic that handles specific core tasks. The framework comes with a service itself.

Type Enforcement Service

The type enforcement service makes up for the short-comings of typing in JavaScript and lets your app cleanly enforce types if need be. The utility service comes with a few static methods to let you enforce basic types or custom classes and either throw an Error (default) or override the behavior with a less obstructive way to handle it.

To use the TypeEnforcementService just import it.

import {services} from '@tramwayjs/core`;
let {TypeEnforcementService} = services;

Errors

All errors extend Javascript's Error class and naming repeated ones comes in handy when reading code and writing it quickly. The framework comes with errors which can be accessed and used.

import {errors} from '@tramwayjs/core';
let {WrongTypeError, AbstractMethodError} = errors;