@typedefs/goa v0.1.5
@goa/koa
This is the source code for the @goa/koa
repository that actually compiles this source code. Please navigate there for the documentation.
@goa/koa
is the Koa web-sever compiled and optimised with Google Closure Compiler so that it has only 1 dependency (mime-db
, for easy access to upgrades). The types are written as JSDoc and don't require installing typings. The aim of this project is to demonstrate how to modernise the old-school NPM package making, including starting to use import/export statements without Babel, restoring to pure JSDoc without TypeScript, and compiling the code into the single executable using the compiler, and testing the code with Zoroaster testing framework which is twice as fast and weighs 500KB against 50MB compared with Jest (as used in the original repository).
yarn add @goa/koa
Table Of Contents
Goa
Goa is the same application, as Koa. It has the same interface for the app object, as well as context, request and response API.
import Goa from '@goa/goa'
const app = new Goa()
app.use((ctx) => {
ctx.body = 'hello world'
})
hello world
Types
The types detailed information can be found here. This is a detailed breakdown of type annotations that was used for compilation, therefore it's rather raw because it's meant for generates externs and typedefs for JSDoc. The Koa documentation can be found on its page.
Packages
The Koa dependencies as packages had to be rewritten in ES6. Some of them were created as separate packages, and some were included in the source code (repository) in the modules
directory.
Dependency | Type |
---|---|
cache-content-type | module |
content-disposition | module |
delegates | module |
ee-first | module |
error-inject | module |
escape-html | module |
fresh | module |
http-assert | module |
http-errors | module |
koa-compose | module |
koa-is-json | module |
on-finished | module |
only | module |
parseurl | module |
statuses | module |
The external modules were created with tests also written to ensure their source and compiled versions work as expected.
Dependency | Dep | Description |
---|---|---|
@goa/accepts | dev | Higher-Level Content Negotiation. |
@goa/content-type | dev | Create and parse HTTP Content-Type header according to RFC 7231. |
@goa/cookies | dev | Signed And Unsigned Cookies Based On Keygrip. |
@goa/is-generator-function | dev | Checks If The Function Is An ES6 Generator. |
@goa/mime-types | dev | The Ultimate Javascript Content-Type Utility. |
@goa/negotiator | dev | HTTP Content Negotiation. |
@goa/type-is | dev | Infer The Content-Type Of A Request. |
@goa/vary | dev | Manipulate The HTTP Vary header. |
@idio/debug | dev | Log Debugging Information. |
mime-db | prod | Installed Via @goa/mime-types. |
Tests
The tests were updated for context testing and include all original Koa tests.
Copyright
The Koa web server by its authors.