migratorosaurus

library2.0.0jsnpmunverified

A zero-config database migration tool for Node.js using PostgreSQL. Version 2.0.0 supports writing both up and down migrations in a single .sql file, CLI migration scaffolding, and customizable migration table names. It is lightweight, TypeScript-native, and relies on the pg library for database connectivity. Release cadence: low frequency, stable.

database

npm install migratorosaurus

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · MIGRATOROSAURUS

migratorosaurus

databasejavascriptv2.0.0

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.

migratorosaurus

✓ import { migratorosaurus } from 'migratorosaurus'

✗ const migratorosaurus = require('migratorosaurus')

Named export; default export is not available. ESM import preferred in TypeScript/ESM projects.

migratorosaurus

✓ const { migratorosaurus } = require('migratorosaurus')

✗ const migratorosaurus = require('migratorosaurus').default

CommonJS destructure is supported.

migratorosaurus

✓ import type { MigratorosaurusConfig } from 'migratorosaurus'

Type import for configuration object, available since v2.

Run all pending migrations from the 'migrations' folder on a PostgreSQL database, logging results to console.

import { migratorosaurus } from 'migratorosaurus'; migratorosaurus('postgresql://localhost:5432/mydb', { directory: 'migrations', table: 'migration_history', log: console.log, });

Debug

Known issues

breakingPackage is ESM-only starting from v2

fix

Use import syntax or set "type": "module" in package.json. For CommonJS, use dynamic import.

affects: >=2.0.0

deprecatedSupport for default import removed in v2

fix

Switch to named import { migratorosaurus }.

affects: >=2.0.0

gotchaMigration files must follow pattern <index>-<name>.sql

fix

Ensure filenames start with a numeric index, e.g., 001-create-table.sql.

affects: *

gotchapg dependency is required but not installed automatically

fix

Install pg separately: npm install pg.

affects: *

Errors

Common errors & fixes

migratorosaurus is not a function

Wrong import method: default import instead of named import

fix

Use import { migratorosaurus } from 'migratorosaurus' or const { migratorosaurus } = require('migratorosaurus')

Cannot find module 'pg'

Missing peer dependency pg

fix

Install pg: npm install pg

No migration files found in directory

Incorrect directory path or missing .sql files

fix

Verify directory option points to a folder with numbered migration .sql files

Upgrade

Version history

2.0.0latest on npm

Audit

Dependencies

pgrequiredPostgreSQL client required for database connection

Agent activity

6 hits · last 30 days

node

Resources

githubhttps://github.com/gabts/migratorosaurus ↗

packagemigratorosaurus ↗

homepagehttps://github.com/gabts/migratorosaurus#readme ↗