PUBLISH.md

Publishing @stemsplit/sdk

This package is published to npm as @stemsplit/sdk via GitHub Actions. Never publish directly from your local machine.

Release process

1. Bump the version in package.json (follow semver).

2. Update CHANGELOG.md with the new version and release notes.

3. Commit the version bump:

   git add package.json CHANGELOG.md
   git commit -m "chore: release v<version>"

4. Tag the release:

   git tag v<version>
   git push origin main --tags

5. GitHub Actions (.github/workflows/publish.yml) detects the v* tag, runs npm run build, and publishes with provenance to the @stemsplit npm scope.

npm org setup (one-time)

• The @stemsplit npm org must exist and the NPM_TOKEN secret must be added to the repo's GitHub Actions secrets with publish access to @stemsplit/sdk.

Verifying a release

npm info @stemsplit/sdk versions
npx -y @stemsplit/sdk@<version> --version  # if a binary were shipped

Package mapping

GitHub repo	npm package
StemSplit/node-stemsplit	@stemsplit/sdk