AdonisJS

https://insiders.adonisjs.com/
Admin
AdonisJS is a full-stack TypeScript framework for building web applications with features like...
Tokens:29,968
Snippets:414
Trust Score:10
Update:9 months ago
Show doc for...
Tokens:
Raw
### Dual Rate Limiting with AdonisJS Limiter

Source: https://insiders.adonisjs.com/changelog

Demonstrates how to implement dual rate limiting for login attempts using IP address and email address. The first example shows the traditional approach with two separate limiter instances, while the second example simplifies this using the MultiLimiter.

```typescript
const ipKey = `login_${request.ip()}`
const emailKey = `login_${request.ip()}_${payload.email}`

const ipLimiter = limiter.use({ duration: '1 min', requests: 10 })
const emailLimiter = limiter.use({ duration: '1 min', requests: 5, blockDuration: '20 mins' })

try {
  await User.verifyCredentials(payload.email, payload.password)
  await ipLimiter.delete(ipKey)
  await ipLimiter.delete(emailKey)
} catch (error) {
  await ipLimiter.consume(ipKey)
  await emailLimiter.consume(emailKey)
}
```

```typescript
const ipKey = `login_${request.ip()}`
const emailKey = `login_${request.ip()}_${payload.email}`

const loginLimiter = limiter.multi([
  { duration: '1 min', requests: 10, key: ipKey },
  { duration: '1 min', requests: 5, blockDuration: '20 mins', key: emailKey }
])

/**
 * The penalize method will consume one point if the provided callback
 * throws an exception. Otherwise, it will reset the points
 */
await loginLimiter.penalize(() => {
  return User.verifyCredentials(payload.email, payload.password)
})
```

--------------------------------

### Check Node.js Version

Source: https://insiders.adonisjs.com/changelog

This command verifies the currently installed Node.js version. AdonisJS v7 now requires Node.js 24 or above to leverage newer features and improve performance.

```bash
node -v
# v24.8.0
```

--------------------------------

### Deferring Exception Reporting in AdonisJS (TypeScript)

Source: https://insiders.adonisjs.com/changelog

This TypeScript code demonstrates how to defer exception reporting in AdonisJS using the `defer` helper. This is useful for ensuring request context remains intact during error reporting, especially when using `AsyncLocalStorage`. The example shows how to integrate with a service like Sentry.

```typescript
import defer from '@adonisjs/core/services/defer'

export default class HttpExceptionHandler extends ExceptionHandler {
  async report(error: unknown, ctx: HttpContext) {
    defer(() => Sentry.captureException(error))
  }
}
```

--------------------------------

### Update HTTP Class Macros in AdonisJS

Source: https://insiders.adonisjs.com/changelog

Following the rename of Request to HttpRequest and Response to HttpResponse, existing macros on these classes need to be updated. This example shows how to re-register macros for both the old and new class names to ensure compatibility during the transition.

```typescript
import { Request } from '@adonisjs/core/http'
import { HttpRequest } from '@adonisjs/core/http'

declare module '@adonisjs/core/http' {
  interface Request {
    someMethod(): void
  }

  interface HttpRequest {
    someMethod(): void
  }
}

Request.macro('someMethod', () => {})
HttpRequest.macro('someMethod', () => {})
```

--------------------------------

### Type-Safe URL Builder and Link Component for Inertia.js (React)

Source: https://insiders.adonisjs.com/changelog

Provides a type-safe URL builder and `Link` component for frontend Inertia.js applications, powered by Tuyau. Enables cleaner and safer navigation within the frontend codebase. Imports from `@adonisjs/inertia/react` and `@inertia/react`.

```jsx
import { Link } from '@adonisjs/inertia/react'
import { Link } from '@inertia/react'

<>
  <Link route="new_account.create">Signup</Link>
  <Link route="session.create">Login</Link>
</>
```

```jsx
import { urlFor } from '~/client'

<>
  <Form action={urlFor('new_account.store')} method="POST">
  </Form>
</>
```

--------------------------------

### Update AdonisJS Assembler Hooks Configuration (adonisrc.ts)

Source: https://insiders.adonisjs.com/changelog

This snippet shows how to update the `adonisrc.ts` file to reflect the revamped assembler hooks API. It demonstrates the new structure for `onBuildStarting` and `buildStarting` hooks, which are used to integrate Vite for production builds.

```typescript
{
  hooks: {
    onBuildStarting: [() => import('@adonisjs/vite/build_hook')],
    buildStarting: [() => import('@adonisjs/vite/build_hook')],
  }
}
```
Tokens:
Raw