bass-migrations

library0.0.6jsnpmunverified

A Node.js library for managing database migrations (up/down) using the BASS (Base Application Storage System) database. Current stable version is 0.0.6, with no established release cadence. This library is specifically tied to BASS and is not a general-purpose migration tool like Knex or Sequelize. It allows migration state tracking and supports both up and down migrations via BASS connections.

database

npm install bass-migrations

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · BASS-MIGRATIONS

bass-migrations

databasejavascriptv0.0.6

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.

bass

✓ import { createMigration } from 'bass-migrations'

✗ const createMigration = require('bass-migrations')

ESM only; no default export. The library exports named functions including createMigration.

createMigration

✓ import { createMigration } from 'bass-migrations'

✗ import createMigration from 'bass-migrations'

createMigration is a named export, not default import.

runMigration

✓ import { runMigration } from 'bass-migrations'

✗ const { runMigration } = require('bass-migrations')

Use ESM import; CommonJS require works only if the package supports it (check package.json).

Basic usage: create a migration instance with a BASS connection and run all pending migrations.

import { createMigration } from 'bass-migrations'; const migration = await createMigration({ bass: bassInstance, migrationsDir: './migrations', tableName: 'migrations', }); await migration.up(); // run all pending migrations

Debug

Known issues

breakingVersion 0.0.6 changed the API: createMigration now returns a Promise instead of a Migration instance.

fix

Await createMigration call: const migration = await createMigration(...)

affects: >=0.0.6

deprecatedThe 'bass' parameter is deprecated; use 'connection' instead.

fix

Change { bass: ... } to { connection: ... }

affects: >=0.0.5

gotchaMigrations must use CommonJS (module.exports = { up, down }) even if the codebase is ESM.

fix

Write migration files with module.exports = { up: async (bass) => { ... }, down: async (bass) => { ... } }

affects: >=0.0.0

Errors

Common errors & fixes

TypeError: createMigration is not a function

Importing incorrectly (default import instead of named).

fix

Use named import: import { createMigration } from 'bass-migrations'

Error: Cannot find module 'bass-migrations'

Package not installed or missing from node_modules.

fix

Run: npm install bass-migrations

TypeError: migration.up is not a function

Forgetting to await createMigration; migration is a Promise.

fix

Use const migration = await createMigration(...)

Upgrade

Version history

0.0.6latest on npm

Audit

Dependencies

No dependency data recorded yet.

Agent activity

12 hits · last 30 days

node

OpenAI (training)

Resources

githubgit://github.com/congajs/bass-migrations ↗

packagebass-migrations ↗

homepagehttps://github.com/congajs/bass-migrations ↗