Skip to main content

Alosaur 🦖

Alosaur - deno web framework 🦖.

  • Area - these are the modules of your application.
  • Controller - are responsible for controlling the flow of the application execution.
  • Middlware - provide a convenient mechanism for filtering HTTP requests entering your application.
  • Decorators - for query, cookie, parametrs, routes and etc.
  • Dependency Injection - for all controllers by default from microsoft/TSyringe (more about alosaur injection)

Documentation


Simple example:

Controller:

import { 
  Controller,
  Content,
  Get,
  Area,
  App,
} from 'https://deno.land/x/alosaur/src/mod.ts'

@Controller('/home')
export class HomeController {
  @Get('/text')
  text() {
    return Content("Hello world");
  }
  @Get('/json')
  json() {
    return Content({"text":"test"});
  }
}

// Declare module
@Area({
  controllers: [HomeController]
})
export class HomeArea {
}

// Create alosaur application
const app = new App({
  areas: [HomeArea]
});

app.listen();

tsconfig.app.json:

{
  "compilerOptions": {
    "experimentalDecorators": true,
    "emitDecoratorMetadata": true
  }
}

And run

deno run -A --config ./src/tsconfig.app.json app.ts


TODO

  • Add render views: dejs (waiting this PR: dejs#20)
  • Add return value JSON
  • Add decorators:
    • @Area
    • @QueryParam
    • @Param param from url: /:id
    • @Body
    • @Cookie
    • @Req
    • @Res
    • @Middleware with regex route
    • @EnableCors for actions with custom policy: (example)
    • @Cache Cache to actions {duration: number} number in ms
  • Add middleware
  • Add static middleware (example: app.useStatic)
  • Add CORS middleware
  • Add DI
  • Add std exceptions
  • Add CI with minimal tests. (see this comment)
  • Add websockets
  • Add validators example class-validator
  • Add microservice connector with wasm
  • Add benchmarks
  • Add docs and more examples ;)

Plugins & modules

  • Add angular template parser
  • Add CLI with schematics (alosaur/cli)
  • Add validator decorators
  • Add porting TypeORM to deno

Examples

  • Add basic example
  • Add di example
  • Add static serve example
  • Add dejs view render example
  • Add example with sql drivers (postgres)
  • Add example with wasm
  • Add basic example in Docker container