@meistrari/auth-nuxt

A Nuxt module for authentication, organization management, and API key capabilities.

Auth Types

This SDK supports two authentication models:

• Application Authentication (recommended): Use this for product applications that need end-user authentication and authorization scoped to a specific application. See Application Authentication Guide.
• First-Party Authentication: Use this only for trusted first-party tools that interact directly with the Auth API in an administrative way, such as the Auth Dashboard and Backoffice. See First-Party Authentication Guide.

Installation

bun add @meistrari/auth-nuxt

Quick Start

export default defineNuxtConfig({
  modules: ['@meistrari/auth-nuxt'],
  telaAuth: {
    apiUrl: 'https://auth.tela.com',
    application: {
      enabled: true,
      dashboardUrl: 'https://accounts.tela.com',
      applicationId: 'app_123',
      redirectUri: 'https://your-app.com/auth/callback',
    },
  },
})

Application auth auto-imports useTelaApplicationAuth(), registers <TelaRole>, installs role directives, and adds SDK routes under /auth/* plus /api/auth/api-key/**. useTelaApiKey() is also available; in application mode it targets the local API key proxy for app-scoped user API keys.

First-party auth auto-imports useTelaSession(), useTelaOrganization(), and useTelaApiKey().

API Reference

See it on Pantry