Backend — @consenti/api

The Consenti backend module records consent to a database, serves the REST API, provides an admin dashboard, and runs server-side plugins. It has zero external runtime dependencies — only Node.js 24 built-ins.

Installation

npm install @consenti/api

Quick start

Add it to your existing Node.js server — consenti.router mounts all routes inside your app. No separate process or port needed.

import express from 'express'
import { createConsenti } from '@consenti/api'

const app = express()

const consenti = createConsenti({
  storage: { driver: 'node:sqlite', path: './consenti-data' },  // path is a directory
  auth: {
    mode: 'local',
    adminEmail: '[email protected]',
    adminPassword: process.env.CONSENTI_ADMIN_PASSWORD!,
  },
  dashboard: true,
})

app.use(consenti.router)  // all Consenti routes now live under /consenti
app.listen(3000)

What createConsenti returns

Architecture

Request → Routes → Services → Repositories → StorageAdapter → Database
                ↓
           Plugins (hooks fire at service layer)

• Routes — validate input, call services, return HTTP responses
• Services — business logic (consent validation, versioning, expiry)
• Repositories — translate domain objects to/from the storage adapter
• StorageAdapter — the only layer that knows about the DB engine
• Plugins — lifecycle hooks fired at the service layer

Storage adapters

Sections