xenops

library2.0.25jsnpmunverified

Xenops is a Node.js MVC framework for building REST APIs, real-time applications, and web apps. Version 2.0.25 provides a command-line tool to scaffold applications with integrated routing (Restify), database management (ORM), socket.io support, validation, logging, and a client testing module. Its architecture is service-handler oriented, making it suitable for multi-room chat, virtual classrooms, real-time dashboards, and multiplayer games. The framework is extensible, allowing users to override core functionality. It uses Restify for server and supports static and dynamic views with template management. Globally installable via npm. Release cadence is irregular; no major updates since 2020.

devops

npm install xenops

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · XENOPS

xenops

devopsjavascriptv2.0.25

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 (global CLI)

✓ npm install -g xenops; xenops myapp

✗ npx xenops myapp (npx may not work due to global-only package)

Xenops is primarily a CLI tool; install globally and run `xenops` to scaffold a project.

XenopsServer (from generated app)

✓ const { XenopsServer } = require('./server');

✗ import { XenopsServer } from './server'; (CJS only, no ESM support)

The framework uses CommonJS; no ESM exports. The server is scaffolded inside your project.

Router (from routes)

✓ const Router = require('./routes/routes');

✗ const { Router } = require('./routes/routes'); (Router is exported as default, not named)

The routes.js file exports a Router object directly; destructure only if named export.

Scaffolds a new Xenops application, installs dependencies, and starts the server on port 8888.

npm install -g xenops && xenops myapp && cd myapp && npm install && npm start

Debug

Known issues

deprecatedXenops uses Restify v8; newer versions of Restify have breaking changes.

fix

Pin Restify to v8 in package.json: "restify": "^8.0.0"

affects: >=2.0

gotchaGlobal installation required; npx may not work because package.json bin is not configured properly.

fix

Use `npm install -g xenops` instead of npx.

affects: >=1.0

gotchaDatabase configuration must specify mysql driver explicitly; no other databases supported out-of-the-box.

fix

Set DB_DRIVER=mysql in config; install mysql package manually if not already.

affects: *

deprecatedNo active development; last commit in 2020. Security vulnerabilities may exist in dependencies.

fix

Consider migrating to a maintained framework like Express or Fastify.

affects: >=2.0

Errors

Common errors & fixes

Error: Cannot find module 'mysql'

The mysql driver is not automatically installed when scaffolding a project.

fix

Run `npm install mysql` in the app directory.

xenops is not recognized as an internal or external command

Xenops not installed globally or npm global bin not in PATH.

fix

Run `npm install -g xenops` and ensure npm global bin is in your PATH.

TypeError: Router is not a constructor

Importing Router incorrectly from routes.js. Router is exported as a plain object, not a class.

fix

Use `const Router = require('./routes/routes');` and then call `Router.get(...)` directly.

Error: listen EADDRINUSE :::8888

Port 8888 is already in use by another process.

fix

Change the port in config/config.js or kill the existing process.

Upgrade

Version history

2.0.25latest on npm

Audit

Dependencies

restifyrequiredCore server framework for routing and REST API handling.

socket.iooptionalWeb socket management for real-time features.

mysqloptionalDatabase driver for MySQL ORM integration.

Agent activity

28 hits · last 30 days

node

Resources

githubhttps://github.com/fingent/xenops ↗

packagexenops ↗

homepagehttps://github.com/fingent/xenops ↗