Maintenance

Downgrade Guide

Instructions for rolling back to a previous version of CanxJS in case of critical issues.

Warning: Data Compatibility

Downgrading may cause issues if you have run database migrations associated with the newer version.Always backup your database before performing a downgrade.

How to Downgrade

1. Identify Target Version

Check the NPM versions or your package.json history to find the stable version you want to revert to (e.g., 1.5.0).

2. Install Specific Version

Use bun add (or npm install) with the specific version tag:

bash

bun add canxjs@1.5.0

3. Revert Migrations (If applicable)

If the newer version included database schema changes, you should rollback those migrations before switching the code.

bash

bun canx migration:rollback

4. Clear Cache

Clear your node_modules and lock files to ensure a clean slate.

bash

rm -rf node_modules bun.lockb
bun install

Troubleshooting

"Module not found" errors

If you see errors about missing modules after downgrading, it likely means the newer version introduced modules that your code is still trying to import. You will need to remove references to these new features in your application code.

TypeScript Errors

Type definitions might have changed. You may need to restart your TS server in VS Code (Ctrl+Shift+P > TypeScript: Restart TS Server).