@commercengine/storefront-sdk 0.4.8 → 0.5.0

package/README.md

@@ -407,6 +407,57 @@ The SDK implements CommerceEngine API best practices automatically:
 - ✅ **Timeout handling** with configurable limits
 - ✅ **Memory leak prevention** with proper cleanup
 
+## Contributing
+
+### Version Management with Changeset
+
+This project uses [Changeset](https://github.com/changesets/changesets) for version management and publishing. Here's how to contribute:
+
+#### Creating Changes
+
+When you make changes to the SDK, create a changeset to document them:
+
+```bash
+pnpm changeset
+```
+
+This will prompt you to:
+- Select the type of change (patch/minor/major)
+- Write a summary of what changed
+- Create a markdown file in the `.changeset/` folder
+
+#### Version Types
+
+- **Patch** (0.0.x): Bug fixes, documentation updates, internal refactoring
+- **Minor** (0.x.0): New features, new API endpoints, backwards-compatible changes  
+- **Major** (x.0.0): Breaking changes, API modifications that affect existing code
+
+#### Release Process
+
+1. **During Development**: Create changesets for your changes
+   ```bash
+   pnpm changeset
+   ```
+
+2. **Before Release**: Consume changesets and update versions
+   ```bash
+   pnpm version
+   ```
+   This updates `package.json`, generates/updates `CHANGELOG.md`, and removes consumed changesets.
+
+3. **Publishing**: Build and publish to npm
+   ```bash
+   pnpm release
+   ```
+
+#### Available Scripts
+
+- `pnpm changeset` - Create a new changeset
+- `pnpm version` - Consume changesets and bump version  
+- `pnpm release` - Build and publish to npm
+
+The changeset workflow ensures proper semantic versioning, comprehensive changelogs, and coordinated releases.
+
 ## License
 
-This project is licensed under the MIT License.
+All Rights Reserved

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@commercengine/storefront-sdk",
-  "version": "0.4.8",
+  "version": "0.5.0",
   "description": "TypeScript SDK for the Storefront API",
   "type": "module",
   "main": "dist/index.js",
@@ -26,6 +26,7 @@
   "author": "Commerce Engine",
   "license": "All rights reserved",
   "devDependencies": {
+    "@changesets/cli": "^2.29.6",
     "@types/node": "^24.3.0",
     "openapi-typescript": "^7.9.1",
     "rimraf": "^6.0.1",
@@ -43,6 +44,9 @@
     "build": "tsup",
     "generate-types": "openapi-typescript https://openapi.commercengine.io/ce-storefront.json --output src/types/storefront.d.ts",
     "generate-typed-exports": "python3 src/types/generate-typed-exports.py --input src/types/storefront.d.ts --output src/types/storefront-api-types.ts",
-    "clean": "rimraf dist"
+    "clean": "rimraf dist",
+    "changeset": "changeset",
+    "version": "changeset version && pnpm install --lockfile-only",
+    "release": "pnpm run build && changeset publish"
   }
 }