@sfxcode/nuxt-mongocamp-server

Nuxt Mongocamp Module

Nuxt module wrapping a generated OpenAPI client for MongoCamp, with composables for browser-session auth and server-side API-key/bearer auth.

Setup

pnpm add @sfxcode/nuxt-mongocamp-server

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@sfxcode/nuxt-mongocamp-server'],
  mongocamp: {
    url: process.env.MONGOCAMP_URL,
    apiKey: process.env.MONGOCAMP_API_KEY, // optional, used by server composables
    refreshToken: true,
    tokenRefreshInterval: 60000,
  },
})

Module options

A missing url throws during nuxi dev/nuxi build/nuxi generate (not during nuxi prepare, so IDE/type-stub generation still works without a configured backend).

Client composables (src/runtime/composables)

Server composables (src/runtime/server/composables)

// server/api/mongocamp/users.ts
export default defineEventHandler((event) => {
  const { adminApi } = useMongocampApi(event)
  return adminApi.listUsers()
})

Development

Setup

Install node:

Latest node LTS version required (24) Use node manager like nvm to install.

Install pnpm: https://pnpm.io/installation

Install dependencies:

pnpm install

Environment

Create .env file in playground with your MongoCamp Parameter for client authentication and API access.

MONGOCAMP_URL=
MONGOCAMP_ADMIN_USER=
MONGOCAMP_ADMIN_PASSWORD=
NITRO_MONGOCAMP_API_KEY=

Run

• Run pnpm dev:prepare to generate type stubs.
• Use pnpm dev to start playground in development mode.