Registry / security / verdaccio-sqlite-gitlab

verdaccio-sqlite-gitlab

library1.0.14jsnpmunverified

Verdaccio authentication plugin combining SQLite storage with GitLab OAuth integration. Current stable version is 1.0.14. It allows npm registry authentication via GitLab credentials, storing user data in SQLite. Key differentiator is self-contained local auth without external dependencies beyond GitLab for identity. Released under MIT license. Supports Verdaccio 4.x and 5.x.

security

npm install verdaccio-sqlite-gitlab

package ↗

INSTALL

IMPORT

SIG · VERDACCIO-SQLITE-G

verdaccio-sqlite-gitlab

securityjavascriptv1.0.14

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

default

✓ import plugin from 'verdaccio-sqlite-gitlab';

✗ const plugin = require('verdaccio-sqlite-gitlab');

ESM-only; CommonJS require will fail.

Config

✓ import { Config } from 'verdaccio-sqlite-gitlab';

Export for TypeScript type usage; type import may be needed.

SqliteGitlabAuth

✓ import { SqliteGitlabAuth } from 'verdaccio-sqlite-gitlab';

✗ import SqliteGitlabAuth from 'verdaccio-sqlite-gitlab';

Named export, not default export.

Shows installation and minimal configuration for the plugin in Verdaccio's config file, including environment variable usage for GitLab credentials.

// Install: npm install verdaccio-sqlite-gitlab // In verdaccio config.yaml: // auth: // sqlite-gitlab: // gitlab_url: 'https://gitlab.com' // client_id: process.env.GITLAB_CLIENT_ID ?? '' // client_secret: process.env.GITLAB_CLIENT_SECRET ?? '' // sqlite_db: './data/auth.db' import plugin from 'verdaccio-sqlite-gitlab'; // The plugin is loaded automatically by Verdaccioconfig. // No manual instantiation needed.

Debug

Known issues

breakingRequires ESM; CommonJS require() will throw an error.

fix

Use ESM import syntax or set "type": "module" in package.json.

affects: >=1.0.0

gotchaSQLite database path must be writable; if not set, defaults to current working directory.

fix

Specify an absolute path for 'sqlite_db' in config.

affects: >=1.0.0

deprecatedVerdaccio 5 support is experimental; may break with future updates.

fix

Pin Verdaccio to 4.x or test with 5.x carefully.

affects: 1.0.0 - 1.0.14

gotchaNo built-in token refresh; tokens expire as per GitLab configuration.

fix

Monitor token expiry and re-authenticate via GitLab OAuth flow.

affects: >=1.0.0

Errors

Common errors & fixes

Error: Cannot find module 'verdaccio-sqlite-gitlab'

Plugin not installed or installed globally but used locally.

fix

Install in the same directory as Verdaccio: npm install verdaccio-sqlite-gitlab

TypeError: Cannot read properties of null (reading 'client_id')

Missing or undefined environment variables GITLAB_CLIENT_ID or GITLAB_CLIENT_SECRET.

fix

Set GITLAB_CLIENT_ID and GITLAB_CLIENT_SECRET environment variables.

SQLITE_ERROR: table users already exists

Conflicting database schema from previous version of plugin or manual migration.

fix

Delete the SQLite database file and restart Verdaccio.

Upgrade

Version history

1.0.14latest on npm

Audit

Dependencies

verdacciorequiredPeer dependency; verified as an authentication plugin for Verdaccio.

Agent activity

21 hits · last 30 days

node

Resources

packageverdaccio-sqlite-gitlab ↗