vr-migrations

library1.0.38jsnpmunverified

VR Migrations is a database migration and seeding library for Node.js applications, built on Sequelize. It supports PostgreSQL, MySQL, SQLite, and other Sequelize-compatible databases. The package is actively maintained with frequent updates (current stable version 1.0.38, released in 2025). It offers CLI and programmatic migration management, with TypeScript type definitions included. Key differentiators from generic migration tools (like db-migrate) include tight integration with Sequelize models and a VR-themed API (universe, planets for migrations/seeds).

database devops

npm install vr-migrations

package ↗

INSTALL

IMPORT

SIG · VR-MIGRATIONS

vr-migrations

databasejavascriptv1.0.38

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.

migrate

✓ import { migrate } from 'vr-migrations'

✗ const migrate = require('vr-migrations')

ESM-only since v1.0.0; CJS require() will cause error.

seed

✓ import { seed } from 'vr-migrations'

✗ import { seed } from 'vr-migrations/seed'

seed is a named export from main entry, no subpath needed.

Migration

✓ import { Migration } from 'vr-migrations'

✗ import Migration from 'vr-migrations'

Migration is a named export, not default. Default export is the whole library object.

VRMigrator

✓ import { VRMigrator } from 'vr-migrations'

✗ import { VRMigrator as Migrator } from 'vr-migrations'

Class for advanced usage; must be imported with exact name.

Shows how to run migrations and seed using an in-memory SQLite database with the library's provided functions.

import { migrate, seed } from 'vr-migrations'; import { Sequelize } from 'sequelize'; const sequelize = new Sequelize({ dialect: 'sqlite', storage: ':memory:', logging: false }); async function run() { await migrate({ sequelize, migrationsDir: './migrations', tableName: 'migrations' }); await seed({ sequelize, seedsDir: './seeds', tableName: 'seeds' }); await sequelize.close(); } run().catch(console.error);

vr-migrations --version

Debug

Known issues

breakingDefault export removed in v1.0.0 in favor of named exports.

fix

Replace `import VrMigrations from 'vr-migrations'` with `import { migrate, seed } from 'vr-migrations'`.

affects: >=1.0.0

deprecatedFunction `runMigrations` is deprecated since v0.9.0.

fix

Use `migrate` function instead.

affects: >=0.9.0 <1.0.0

gotchaTypeScript types are only available for named exports; default export lacks typings.

fix

Import named symbols to get full type support.

affects: >=1.0.0

gotchaSequelize v6 is required; v7 may break compatibility.

fix

Ensure your project uses Sequelize v6.x.

affects: >=1.0.0

Errors

Common errors & fixes

TypeError: (0 , vr_migrations.migrate) is not a function

CJS require() used on an ESM-only package

fix

Switch to ES modules or use dynamic import: `const { migrate } = await import('vr-migrations')`

Cannot find module 'vr-migrations'

Package not installed or import path misspelled

fix

Run `npm install vr-migrations` and verify the import is correct.

Error: Cannot sequelize connection. Please provide valid sequelize instance.

Missing or invalid sequelize option passed to migrate/seed

fix

Ensure you pass a configured Sequelize instance: `migrate({ sequelize: yourSequelizeInstance })`

Upgrade

Version history

1.0.38latest on npm

Audit

Dependencies

sequelizerequiredCore ORM for database connection and model definitions

umzugrequiredUnderlying migration engine (Sequelize-based)

Agent activity

26 hits · last 30 days

node