jsharmony

library1.40.14jsnpmunverified

jsHarmony is a Rapid Application Development (RAD) platform for Node.js, focused on database application development. It provides an integrated framework for building server-side applications with automatic model generation, built-in authentication, and support for PostgreSQL and MSSQL via separate driver packages. Current stable version is 1.40.14. Release cadence appears irregular. Key differentiators include a model-driven approach with automatic schema generation and a focus on database-first development compared to more general-purpose Node.js frameworks like Express.

web-framework database auth-security

npm install jsharmony

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · JSHARMONY

jsharmony

web-frameworkjavascriptv1.40.14

Install

—

Import

—

Disk

—

Pass rate

0/ 6

Env Coverage0 / 6

glibc

18–22

musl

18–22

Install & Compatibility

Where this runs

tested against v? · npm install

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

node 18–226 runs

build_error

glibc

node 18–226 runs

build_error

Code

Verified usage

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

jsHarmony (default)

✓ const jsHarmony = require('jsharmony');

✗ import jsHarmony from 'jsharmony';

CJS only; no ESM exports.

jsHarmony.Auth.Static

✓ jsHarmony.Auth.Static([...]);

✗ const { Auth } = require('jsharmony');

Auth.Static is accessed as a static property of the jsHarmony constructor, not as a separate import.

jsHarmony (TypeScript)

✓ import jsHarmony = require('jsharmony');

✗ import * as jsHarmony from 'jsharmony';

TypeScript import equals syntax is required for CJS modules.

Minimal setup: configure a PostgreSQL database connection and start the jsHarmony server on HTTP port 3000.

const jsHarmony = require('jsharmony'); const pgsqlDBDriver = require('jsharmony-db-pgsql'); const jsh = new jsHarmony(); jsh.DBConfig['default'] = { host: 'server.domain.com', database: 'DBNAME', user: 'DBUSER', password: 'DBPASS', _driver: new pgsqlDBDriver() }; jsh.Config.server = { http_port: 3000, https_port: 0 }; jsh.Run();

Debug

Known issues

breakingThe 'data' folder must exist in the application root or be configured via jsh.Config.appbasepath.

fix

Create a 'data' folder in the project root or set jsh.Config.appbasepath to an existing directory before calling jsh.Run().

affects: all

gotchaStatic authentication must be configured in the Init callback, not before.

fix

Wrap authentication setup inside jsh.Init(function(){ ... jsh.Run(); });

affects: all

deprecatedThe default HTTP port is set via jsh.Config.server.http_port; HTTPS is optional and requires certificate files.

fix

Set jsh.Config.server.https_port to 0 to disable HTTPS, or provide valid certificate paths.

affects: all

Errors

Common errors & fixes

Error: Cannot find module 'jsharmony-db-pgsql'

PostgreSQL driver not installed or missing from package.json.

fix

Run: npm install jsharmony-db-pgsql --save

TypeError: jsh.DBConfig['default'] is undefined

Database configuration not set before calling jsh.Run().

fix

Assign to jsh.DBConfig['default'] before jsh.Run(), e.g., jsh.DBConfig['default'] = { ... }

Error: ENOENT: no such file or directory, open '.../data/...'

Missing 'data' folder in application root.

fix

Create a 'data' directory in the project root or set jsh.Config.appbasepath to a valid path.

Upgrade

Version history

1.40.14latest on npm

Audit

Dependencies

jsharmony-db-pgsqloptionalPostgreSQL database driver

jsharmony-db-mssqloptionalMSSQL database driver

Agent activity

13 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/apHarmony/jsharmony ↗

packagehttps://www.npmjs.com/package/jsharmony ↗

homepagehttps://jsharmony.com ↗