updating preview release versions

Author: clavery

.github/scripts/create-preview-release.js

@@ -19,21 +19,19 @@ export async function createPreviewRelease({ github, context, version, distDir }
 
 ### Installation
 
-Download both tgz files and install them together:
+Download the tgz file and install:
 
 \`\`\`bash
-npm install ./salesforce-b2c-tooling-sdk-${version}.tgz \\
-            ./salesforce-b2c-cli-${version}.tgz
+npm install ./salesforce-b2c-cli-${version}.tgz
 \`\`\`
 
 Or install globally:
 
 \`\`\`bash
-npm install -g ./salesforce-b2c-tooling-sdk-${version}.tgz \\
-               ./salesforce-b2c-cli-${version}.tgz
+npm install -g ./salesforce-b2c-cli-${version}.tgz
 \`\`\`
 
-> **Note:** Both packages must be installed together since the CLI depends on the SDK.
+> **Note:** The SDK is bundled in the CLI package.
 `;
 
   // Create the release

.github/workflows/preview-release.yml

@@ -58,10 +58,11 @@ jobs:
       - name: Run tests
         run: pnpm -r run test:unit
 
-      - name: Pack all packages
+      - name: Deploy and pack CLI with bundled SDK
         run: |
           mkdir -p dist
-          pnpm pack -r --pack-destination ./dist
+          pnpm --filter @salesforce/b2c-cli deploy --legacy ./dist-deploy
+          cd ./dist-deploy && npm pack --pack-destination ../dist
 
       - name: List packed files
         run: ls -la dist/

README.md

@@ -162,6 +162,40 @@ See the [documentation site](https://salesforcecommercecloud.github.io/b2c-devel
 
 When adding new public APIs, ensure they have comprehensive JSDoc comments as these will appear in the generated documentation.
 
+## Preview Releases
+
+This project is not yet published to npm. Preview releases are available as tgz files on [GitHub Releases](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/releases).
+
+### Installing a Preview Release
+
+1. Download the `salesforce-b2c-cli-<version>.tgz` file from the release
+2. Install with npm:
+
+```bash
+# Install globally
+npm install -g ./salesforce-b2c-cli-0.0.1-preview.1.tgz
+
+# Or install locally in a project
+npm install ./salesforce-b2c-cli-0.0.1-preview.1.tgz
+```
+
+The SDK is bundled in the CLI package, so only one file is needed.
+
+### Creating a Preview Release
+
+Preview releases are created automatically when a tag matching `v*-preview*` is pushed:
+
+```bash
+git tag v0.0.1-preview.1
+git push origin v0.0.1-preview.1
+```
+
+The [preview-release workflow](.github/workflows/preview-release.yml) will:
+1. Update package versions from the tag
+2. Build and test all packages
+3. Create a bundled tarball using `pnpm deploy`
+4. Create a GitHub release with the tarball attached
+
 ## Package Exports
 
 The `@salesforce/b2c-tooling-sdk` package uses the `exports` field in package.json to define its public API surface. Each module is available as a subpath export:

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/b2c-cli-root",
-  "version": "0.0.1",
+  "version": "0.0.1-preview",
   "description": "Salesforce Commerce Cloud B2C Command Line Tools",
   "main": "index.js",
   "scripts": {

packages/b2c-cli/README.md

@@ -11,6 +11,16 @@ A command-line interface for Salesforce Commerce Cloud B2C.
 
 ## Installation
 
+### Preview Release (Pre-npm)
+
+Download the latest tarball from [GitHub Releases](https://github.com/SalesforceCommerceCloud/b2c-developer-tooling/releases) and install:
+
+```sh
+npm install -g ./salesforce-b2c-cli-0.0.1-preview.1.tgz
+```
+
+### From npm (Coming Soon)
+
 ```sh
 npm install -g @salesforce/b2c-cli
 ```

packages/b2c-cli/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/b2c-cli",
   "description": "A Salesforce Commerce Cloud B2C CLI",
-  "version": "0.0.0",
+  "version": "0.0.1-preview",
   "author": "Charles Lavery",
   "bin": {
     "b2c": "./bin/run.js"
@@ -17,12 +17,14 @@
     "@salesforce/b2c-tooling-sdk": "workspace:*",
     "cliui": "^9.0.1"
   },
+  "bundleDependencies": [
+    "@salesforce/b2c-tooling-sdk"
+  ],
   "devDependencies": {
     "@eslint/compat": "^1",
     "@oclif/prettier-config": "^0.2.1",
     "@oclif/test": "^4",
     "@salesforce/dev-config": "^4.3.2",
-    "eslint-plugin-header": "^3.1.1",
     "@types/chai": "^4",
     "@types/mocha": "^10",
     "@types/node": "^18",
@@ -31,6 +33,7 @@
     "eslint": "^9",
     "eslint-config-oclif": "^6",
     "eslint-config-prettier": "^10",
+    "eslint-plugin-header": "^3.1.1",
     "eslint-plugin-prettier": "^5.5.4",
     "mocha": "^10",
     "oclif": "^4",

packages/b2c-dx-mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/b2c-dx-mcp",
-  "version": "0.0.0",
+  "version": "0.0.1-preview",
   "description": "MCP server for B2C Commerce Cloud developer experience tools",
   "author": "Salesforce",
   "license": "MIT",
@@ -91,8 +91,8 @@
     "chai": "^4",
     "eslint": "^9",
     "eslint-config-oclif": "^6",
-    "eslint-plugin-header": "^3.1.1",
     "eslint-config-prettier": "^10",
+    "eslint-plugin-header": "^3.1.1",
     "eslint-plugin-prettier": "^5.5.4",
     "mocha": "^10",
     "oclif": "^4",

packages/b2c-tooling-sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@salesforce/b2c-tooling-sdk",
-  "version": "0.0.0",
+  "version": "0.0.1-preview",
   "description": "Core tooling library for Salesforce Commerce Cloud B2C CLI",
   "author": "Charles Lavery",
   "license": "Apache-2.0",