@travetto/generator-app v2.0.0-alpha.2

Yeoman Generator

Yeoman app generator for the Travetto framework

Install: @travetto/generator-app

npm install @travetto/generator-app

A simple yeoman generator for scaffolding a reference project. To get started, you need to make sure:

Install: Setting up yeoman and the generator

$ npm i -g yo #Ensure yeoman is installed globally
$ npm i -g @travetto/generator-app #Ensure this yeoman generator is installed
$ git config --global.username <Username> #Set your git username

Once installed you can invoke the scaffolding by running

Terminal: Running Generator

$ yo @travetto/app

The generator will ask about enabling the following features:

Restful Architecture

The RESTful API provides the necessary integration for exposing restful apis. When selecting the rest feature, you will need to specify which backend you want to include with your application, the default being express. Currently you can select from:

• express
• koa
• fastify

The code will establish some basic routes, specifically, GET / as the root endpoint. This will return the contents of your package.json as an identification operation.

Additional Rest Features

In addition to the core functionality, the rest feature has some useful sub-features. Specifically:

OpenAPI Specification support for the restful api. This will automatically expose a openapi.yml endpoint, and provide the necessary plumbing to support client generation.

Logging support for better formatting, debug like support, and colorized output. This is generally useful for server logs, especially during development.

Authentication

Authentication is also supported on the Restful endpoints by selecting Rest Auth during setup. This will support basic authentication running out of local memory, with user REST Sessions.

Testing

Testing can also be configured out of the box to provide simple test cases for the data model.

Data Modelling and Storage

The Data Modeling Core allows for modeling of application data, and provides mechanisms for storage and retrieval. When setting up your application, you will need to select which database backend you want to use:

• elasticsearch
• mongodb
• SQL

A default model is constructed, a Todo class:

Code: Todo Model

import { Model, ModelCore } from '@travetto/model';

@Model()
export class Todo implements ModelCore {
  id?: string;
  text: string;
  completed?: boolean;
}

Basic tests are also included for the model to verify that database interaction and functionality is working properly.

Rest + Model

In the case both rest and model features are enabled, the code will produce a controller that exposes the Todo model via restful patterns.

Code: Todo controller

import { AppError } from '@travetto/base';
import { Controller, Get, Put, Post, Delete, Path } from '@travetto/rest';
import { Inject } from '@travetto/di';
import { ModelService, ModelQuery } from '@travetto/model';
import { SchemaBody, SchemaQuery, Schema } from '@travetto/schema';

import { Todo } from '../model/todo';

@Schema()
class Query {
  q: any = {};
}

/**
 * Controller for managing all aspects of the Todo lifecycle
 */
@Controller('/todo')
export class TodoController {

  @Inject()
  source: ModelService;

  /**
   * Get all Todos
   */
  @Get('/')
  async getAll(@SchemaQuery() query: Query): Promise<Todo[]> {
    query.q = query.q || {};
    return this.source.getAllByQuery(Todo, { where: query.q });
  }

  /**
   * Get Todo by id
   */
  @Get('/:id')
  async getOne(@Path() id: string): Promise<Todo> {
    const q: ModelQuery<Todo> = { where: { id } };
    return this.source.getByQuery(Todo, q);
  }

  /**
   * Create a Todo
   */
  @Post('/')
  async save(@SchemaBody() todo: Todo): Promise<Todo> {
    return this.source.save(Todo, todo);
  }

  /**
   * Update a Todo
   */
  @Put('/:id')
  async update(@SchemaBody() todo: Todo): Promise<Todo> {
    return this.source.update(Todo, todo);
  }

  /**
   * Delete a Todo
   */
  @Delete('/:id')
  async remove(@Path() id: string): Promise<void> {
    const q: ModelQuery<Todo> = { where: { id } };
    if (await this.source.deleteByQuery(Todo, q) !== 1) {
      throw new AppError('Not found by id', 'notfound');
    }
  }
}

Running

Once finished the application will reflect the modules chosen, and will be ready for execution, if you have configured a runnable application. Currently, this requires the rest feature to be selected.

Terminal: Starting the App

npm start