wulfy-orm

library0.1.7jsnpmunverified

A lightweight TypeScript ORM for Node.js, currently at version 0.1.7 with an active pre-release development cadence. It supports PostgreSQL via a separate driver package (wulfy-postgres-driver) and provides basic CRUD operations, lazy loading, and common data types. Key differentiators: minimalistic API, TypeScript-first, and driver-based architecture allowing future database support. Currently in early development with limited associations (OneToMany, ManyToOne) and no migrations or table sync yet.

database

npm install wulfy-orm

package ↗

INSTALL

IMPORT

SIG · WULFY-ORM

wulfy-orm

databasejavascriptv0.1.7

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.

WulfyORM

✓ import WulfyORM from 'wulfy-orm'

✗ const WulfyORM = require('wulfy-orm')

The package is ESM-only and requires a default import. TypeScript types are included.

PostgresDriver

✓ import PostgresDriver from 'wulfy-postgres-driver'

✗ import { PostgresDriver } from 'wulfy-postgres-driver'

PostgresDriver is a default export from the driver package, not a named export.

init

✓ WulfyORM.init(new PostgresDriver(...))

✗ init(new PostgresDriver(...))

init is a static method on the default export WulfyORM, not a standalone function. Must be called after import.

Shows how to initialize Wulfy ORM with PostgreSQL, define a model, and perform basic CRUD operations.

import WulfyORM from 'wulfy-orm'; import PostgresDriver from 'wulfy-postgres-driver'; // Initialize with PostgreSQL connection string WulfyORM.init(new PostgresDriver('postgres://user:password@localhost:5432/mydb')); // Define a model const User = WulfyORM.model('User', { name: WulfyORM.string(), age: WulfyORM.number().unsigned().integer() }); // Insert a record const newUser = await User.create({ name: 'Alice', age: 30 }); // Find records const users = await User.where('age', '>', 18).all(); // Update await User.where('name', '=', 'Alice').update({ age: 31 }); // Delete await User.where('id', '=', newUser.id).delete();

Debug

Known issues

breakingThe package is in early development (v0.x) and the API may change without notice between minor versions.

fix

Pin to a specific version and review changelog before upgrading.

affects: <1.0.0

gotchaWulfy ORM requires a separate driver package (e.g., wulfy-postgres-driver) to connect to a database. The core package does not include any driver.

fix

Install the appropriate driver: npm i wulfy-postgres-driver for PostgreSQL.

affects: >=0.0.0

deprecatedAssociations like ManyToMany and OneToOne are listed as planned but not yet implemented. Using them will result in errors.

fix

Only use OneToMany and ManyToOne associations. For ManyToMany or OneToOne, wait for future releases.

affects: 0.1.x

gotchaThe package uses ESM imports only. CommonJS require() will fail.

fix

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

affects: >=0.1.0

Errors

Common errors & fixes

Cannot find module 'wulfy-postgres-driver'

The driver package is not installed or not in node_modules.

fix

Run npm install wulfy-postgres-driver

Property 'init' does not exist on type 'typeof import("wulfy-orm")'

Incorrect import style (named import instead of default).

fix

Use import WulfyORM from 'wulfy-orm' (default import)

WulfyORM.init is not a function

init() called before importing the package or on wrong reference.

fix

Ensure you have imported the default export correctly: import WulfyORM from 'wulfy-orm'

Upgrade

Version history

0.1.7latest on npm

Audit

Dependencies

wulfy-postgres-driveroptionalRequired driver for PostgreSQL database connectivity

Agent activity

25 hits · last 30 days

node