{"id":26642,"library":"webledger-auth-plugin","title":"Webledger Auth Plugin","description":"An authentication plugin for AdonisJS 5 that integrates with the Webledger auth service. Current version is 2.0.7, with no active release cadence. It provides a simple login plugin that extends the AdonisJS authentication system. Differentiates by being purpose-built for the Webledger ecosystem, offering easy configuration via `node ace configure`. Requires AdonisJS core 5.7.6 or higher.","status":"active","version":"2.0.7","language":"javascript","source_language":"en","source_url":"https://github.com/divamtech/webledger-auth-plugin","tags":["javascript","adonisjs","adonis","typescript"],"install":[{"cmd":"npm install webledger-auth-plugin","lang":"bash","label":"npm"},{"cmd":"yarn add webledger-auth-plugin","lang":"bash","label":"yarn"},{"cmd":"pnpm add webledger-auth-plugin","lang":"bash","label":"pnpm"}],"dependencies":[{"reason":"Peer dependency required for AdonisJS framework core functionality.","package":"@adonisjs/core","optional":false}],"imports":[{"note":"Default export, not named.","wrong":"import { WebledgerAuthPlugin } from 'webledger-auth-plugin'","symbol":"WebledgerAuthPlugin","correct":"import WebledgerAuthPlugin from 'webledger-auth-plugin'"},{"note":"Config file is exported from a separate path 'webledger-auth-plugin/config'.","wrong":"import { webledgerAuthConfig } from 'webledger-auth-plugin'","symbol":"webledgerAuthConfig","correct":"import webledgerAuthConfig from 'webledger-auth-plugin/config'"},{"note":"Routes are exported from 'webledger-auth-plugin/routes' as default.","wrong":"import { Routes } from 'webledger-auth-plugin'","symbol":"webledgerAuthRoutes","correct":"import webledgerAuthRoutes from 'webledger-auth-plugin/routes'"}],"quickstart":{"code":"import WebledgerAuthPlugin from 'webledger-auth-plugin';\n// In your start/app.js:\nconst providers = [\n  WebledgerAuthPlugin\n];\n// Then configure via node ace configure webledger-auth-plugin\n// Add config to config/auth.js:\nconst webledgerConfig = {\n  secret: process.env.WEBLEDGER_SECRET ?? '',\n  service: 'webledger'\n};","lang":"typescript","description":"Shows how to import and configure the plugin in AdonisJS 5."},"warnings":[{"fix":"Ensure your project uses @adonisjs/core ^5.7.6.","message":"Plugin requires AdonisJS 5.x only; not compatible with AdonisJS 4 or 6.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Run `node ace configure webledger-auth-plugin` in your project root.","message":"The plugin must be configured using `node ace configure` before use; manual configuration may cause errors.","severity":"gotcha","affected_versions":"all versions"},{"fix":"Set WEBLEDGER_SECRET in your .env file.","message":"Missing environment variable WEBLEDGER_SECRET can cause authentication failures.","severity":"gotcha","affected_versions":"all versions"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run `npm install webledger-auth-plugin` or `npm link webledger-auth-plugin`.","cause":"Plugin not installed or not linked correctly.","error":"Cannot find module 'webledger-auth-plugin'"},{"fix":"Ensure @adonisjs/ace is installed and run `node ace configure` from the project root.","cause":"AdonisJS ace is not available or incorrect version.","error":"Cannot find ace command 'configure'"},{"fix":"Use import path `webledger-auth-plugin/config` without extension.","cause":"The config file is not found because it's not exported correctly.","error":"Failed to load webledger-auth-plugin/config"}],"ecosystem":"npm","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}