covenix

Appearance

covenix / ToExpressOptions

Interface: ToExpressOptions ​

Defined in: src/express.ts:18

Options for toExpress / serve. Each step can be opted out (false) or customized; the build order is fixed (see toExpress): configure → body parsers → routes → docs → after → error handler.

Extended by ​

Properties ​

after? ​

optional after?: (app) => void

Defined in: src/express.ts:55

Runs after routes but before the error handler — e.g. a SPA fallback (app.get('{*path}', …)) that must sit after the API routes.

Parameters ​

app ​

Express

Returns ​

void

app? ​

optional app?: Express

Defined in: src/express.ts:23

An existing Express app to build onto. Defaults to a fresh express(). Use this to layer covenix onto an app you've already partly configured.

configure? ​

optional configure?: (app) => void

Defined in: src/express.ts:50

Runs before routes (and before the body parsers) — the place for pre-route middleware: CORS, helmet, logging, static files, header-based auth. Note: fires before body parsing, so middleware needing a parsed body must add its own parser here.

Parameters ​

app ​

Express

Returns ​

void

docs? ​

optional docs?: boolean | ServeDocsOptions & object

Defined in: src/express.ts:38

Serve the docs UI via Covenix.serveDocs. true (default) mounts at /docs; an object customizes path and the UI options; false skips it.

errorHandler? ​

optional errorHandler?: boolean | RequestHandler<ParamsDictionary, any, any, ParsedQs, Record<string, any>>

Defined in: src/express.ts:43

Install an error handler last. true (default) uses covenixErrorHandler; a function installs your own; false skips it.

json? ​

optional json?: boolean | OptionsJson

Defined in: src/express.ts:28

Mount express.json(). true (default) uses defaults; an object passes body-parser options (e.g. { limit: '1mb' }); false skips it.

urlencoded? ​

optional urlencoded?: boolean | OptionsUrlencoded

Defined in: src/express.ts:33

Mount express.urlencoded(). false (default) skips it; true uses { extended: true }; an object passes body-parser options.