Adonis Middleware (Official)

1.0.14 verified Sat Apr 25 auth: no javascript maintenance

Official collection of middleware for AdonisJS (Adonis Framework), including BodyParser, CORS, Flash, and Shield. Current version 1.0.14, last updated in 2016. This package is part of the legacy AdonisJS 4.x ecosystem and provides HTTP middleware providers for common web security and request parsing tasks. Unlike third-party middleware packages, these are the officially maintained set, tightly integrated with the framework's provider system. Release cadence is low; package is in maintenance mode as AdonisJS moved to a new architecture in v5. Key differentiator: official, framework-specific middleware providers that register automatically via AdonisJS IoC container.

Common errors

error Error: Cannot find module 'adonis-middleware' ↓

cause Package not installed or wrong import path

fix

npm install adonis-middleware --save

error TypeError: AppMiddlewareProvider is not a constructor ↓

cause Incorrect import style (default vs named)

fix

Use import AppMiddlewareProvider from 'adonis-middleware/providers/AppMiddlewareProvider'

error Error: ENOENT: no such file or directory, open '.../node_modules/adonis-middleware/providers/AppMiddlewareProvider.js' ↓

cause Provider path missing due to version mismatch

fix

Reinstall package: npm install adonis-middleware@1.0.14

Warnings

deprecated This package is for AdonisJS 4.x only and is not compatible with AdonisJS 5+ ↓

fix Use the built-in middleware or AdonisJS v5 official packages

breaking Provider registration path changed in v1.0.0: use 'adonis-middleware/providers/AppMiddlewareProvider' ↓

fix Update provider path in bootstrap/app.js

gotcha The package does not export default; all exports are named ↓

fix Use destructuring: import { Cors } from 'adonis-middleware'

Install

npm install adonis-middleware

yarn add adonis-middleware

pnpm add adonis-middleware

Imports

AppMiddlewareProvider
wrong
```
const AppMiddlewareProvider = require('adonis-middleware')
```
correct
```
import AppMiddlewareProvider from 'adonis-middleware/providers/AppMiddlewareProvider'
```
ESM-style import from specific path; CommonJS users should use require('adonis-middleware/providers/AppMiddlewareProvider')

BodyParser

wrong

import BodyParser from 'adonis-middleware'

correct

import { BodyParser } from 'adonis-middleware'

Named export, not default; use destructuring

Cors

wrong

const Cors = require('adonis-middleware').Cors

correct

import { Cors } from 'adonis-middleware'

Works in CJS, but destructuring works too; preferred pattern for clarity

Quickstart

// bootstrap/app.js
const providers = [
  'adonis-middleware/providers/AppMiddlewareProvider'
]

// Start the server
const { Ioc } = require('adonis-fold')
const app = new (require('adonis-framework/src/App'))()
app.registerProviders(providers)