RELEASE.md

Release Process

Prerequisites

• Clean working directory (git status shows only intended changes)

Steps

1. Update version

   cd wa-sqlite
   # Edit package.json version directly or use pnpm
   pnpm version patch  # or minor/major/prepatch/preminor/premajor

2. Rebuild with Nix

   # From repository root
   nix run .#build-wa-sqlite

3. Test the build

   # From repository root
   node -e "import('./wa-sqlite/dist/wa-sqlite.node.mjs').then(m => console.log('✓ Build works'))"

4. Update CHANGELOG.md

   • Add entry for new version with date
   • Document changes

5. Commit wa-sqlite submodule changes

   cd wa-sqlite
   git add .
   git commit -m "Release vX.Y.Z"
   cd ..

6. Commit parent repo changes

   git add wa-sqlite nix/wa-sqlite-livestore.nix CHANGELOG.md
   git commit -m "Release wa-sqlite vX.Y.Z"

7. Publish to npm

   cd wa-sqlite
   pnpm publish --access public
   cd ..

8. Push both repos

   cd wa-sqlite
   git push origin HEAD:main
   cd ..
   git push origin main