Skip to content

CHANGELOG.md

Latest commit

 

History

History
463 lines (257 loc) · 43.7 KB

CHANGELOG.md

File metadata and controls

463 lines (257 loc) · 43.7 KB

@salesforce/b2c-cli

1.8.0

Minor Changes

  • #377 cb66b56 - Add storefront-next skill set to b2c setup skills. Install Storefront Next development skills with b2c setup skills storefront-next, or via the plugin marketplace with claude plugin install storefront-next. (Thanks @clavery!)

Patch Changes

  • Updated dependencies [cb66b56]:
    • @salesforce/b2c-tooling-sdk@1.7.0

1.7.1

Patch Changes

  • Updated dependencies [485ef63]:
    • @salesforce/b2c-tooling-sdk@1.6.1

1.7.0

Minor Changes

  • #373 1dc1ee5 - Add support for Commerce Apps (CAP) development skills via b2c setup skills cap-dev. Introduces a skill source registry to support external skill repositories alongside existing release-artifact sources. (Thanks @clavery!)

Patch Changes

  • Updated dependencies [1dc1ee5]:
    • @salesforce/b2c-tooling-sdk@1.6.0

1.6.0

Minor Changes

  • #370 ee735bb - Add cap command topic for Commerce App Package (CAP) management. (Thanks @clavery!)

    New commands:

    • b2c cap validate — validates CAP structure, manifest, and cartridge rules locally
    • b2c cap package — packages a CAP directory into a distributable .zip
    • b2c cap install — installs a CAP on an instance via WebDAV + sfcc-install-commerce-app job
    • b2c cap uninstall — uninstalls a CAP via sfcc-uninstall-commerce-app job

    New SDK exports in @salesforce/b2c-tooling-sdk/operations/cap: validateCap, commerceAppInstall, commerceAppUninstall, commerceAppPackage.

    The VS Code extension gains CAP directory detection (badge decoration) and an "Install Commerce App (CAP)" context menu action.

  • #370 ee735bb - Add cap list, cap tasks, and cap pull commands for managing installed Commerce Apps (Thanks @clavery!)

    • cap list exports and parses commerce_feature_states to show installed features with type, source, status, and version
    • cap tasks displays configuration tasks for an installed app with clickable Business Manager links
    • cap pull downloads and extracts installed app source packages for cartridge deployment or Storefront Next development
    • Standardize all cap commands to use --site-id flag (with --site as alias)
    • cap uninstall no longer requires --domain — looks it up automatically from the feature state
    • cap install now keeps the archive on the instance by default (use --clean-archive to remove)

Patch Changes

  • Updated dependencies [ee735bb, ee735bb]:
    • @salesforce/b2c-tooling-sdk@1.5.0

1.5.0

Minor Changes

  • #366 59dd584 - Add b2c code download command to download cartridge code from a B2C Commerce instance, with support for cartridge filtering, mirror mode, and progress reporting (Thanks @clavery!)

Patch Changes

  • #355 3dedc05 - b2c setup skills now prompts to overwrite already-installed skills in interactive mode instead of silently skipping them with a "use --update to overwrite" message. The existing --update and --force flags still work non-interactively. (Thanks @clavery!)

  • #355 3dedc05 - Refine b2c CLI skills (scapi-schemas, scapi-custom, slas, ecdn, cip, users-roles) to show config-first idiomatic usage. Examples now assume values like tenantId, shortCode, and clientId are resolved from dw.json / SFCC_* env vars, with flags shown only as overrides. This prevents coding agents from prompting users for values that are already configured. (Thanks @clavery!)

  • #365 c4309db - Broaden skills-plugin install support and improve the installation docs. (Thanks @clavery!)

    • Add a Codex plugin marketplace so the three plugins (b2c-cli, b2c, b2c-dx-mcp) can be installed directly from Codex CLI's plugin directory.
    • Add a new b2c-onboarding skill (in the b2c plugin) that walks new developers through CLI verify, dw.json setup, sandbox connect, and first cartridge deploy, then hands off to the topic-specific skill for the user's goal.
    • Add per-plugin READMEs with install instructions for each supported client.
    • Document Copilot CLI + VS Code Copilot install paths and the Codex marketplace install path.
    • Remove the b2c-experimental plugin from the public marketplace.

  • Updated dependencies [59dd584, 3dedc05, c4309db]:

    • @salesforce/b2c-tooling-sdk@1.4.0

1.4.0

Minor Changes

  • #308 d5c9125 - Add b2c mrt env var push command. Reads a local .env file, computes a diff against the current remote MRT environment variables, and pushes new or changed variables in a single batch request (with per-variable fallback). Supports --file, --exclude-prefix, and --yes flags. (Thanks @vmarta!)

Patch Changes

  • 52d7a6d - Fix inaccurate flags and commands in CLI skill documentation for job, ecdn, am, and users-roles skills (Thanks @clavery!)

  • 1b0b4ce - Add --wait / --no-wait flag to b2c job import command. Import waits for completion by default (preserving existing behavior); use --no-wait to return immediately after the job starts. Also adds --poll-interval flag for controlling poll frequency. (Thanks @clavery!)

  • Updated dependencies [1b0b4ce]:

    • @salesforce/b2c-tooling-sdk@1.3.2

1.3.2

Patch Changes

  • Updated dependencies [30de66b]:
    • @salesforce/b2c-tooling-sdk@1.3.1

1.3.1

Patch Changes

  • 7333370 - Improved skill trigger descriptions across all 37 B2C skills for better Claude Code skill invocation. Expanded eval sets from 5 to 10 queries per skill with realistic, organic test prompts. (Thanks @clavery!)

1.3.0

Minor Changes

  • #337 c04bbcb - Add Agentforce Vibes (--ide agentforce-vibes) as a supported IDE target for setup skills, installing to .a4drules/skills/. Add --directory flag for custom installation paths. Change manual default directory to .agents/skills/. (Thanks @clavery!)

Patch Changes

  • Updated dependencies [c04bbcb]:
    • @salesforce/b2c-tooling-sdk@1.3.0

1.2.0

Minor Changes

  • 464b9db - Add B2C Commerce script debugger with SDAPI 2.0 DAP adapter (Thanks @clavery!)

Patch Changes

  • Updated dependencies [464b9db, e6c6226]:
    • @salesforce/b2c-tooling-sdk@1.2.0

1.1.0

Minor Changes

  • #315 6771d7a - Add ODS sandbox management enhancements, including sandbox storage and settings commands, multi-realm usage reporting, and dedicated realm configuration support. (Thanks @charithaT07!)

    Keep sandbox realm workflows under b2c sandbox realm / b2c ods realm by removing top-level b2c realm aliases.

  • #318 6880a84 - Added per-instance safety configuration with rule-based actions (allow/block/confirm) and interactive confirmation mode. Safety can now be configured in dw.json with granular rules for HTTP paths, job IDs, and CLI commands. (Thanks @clavery!)

Patch Changes

  • Updated dependencies [6880a84]:
    • @salesforce/b2c-tooling-sdk@1.1.0

1.0.1

Patch Changes

  • e597e61 - Add --activate flag to code deploy for activating a code version after deploy without the toggle behavior of --reload. Both --activate and --reload now error on failure instead of silently continuing. (Thanks @clavery!)

  • Updated dependencies [e597e61]:

    • @salesforce/b2c-tooling-sdk@1.0.1

1.0.0

Major Changes

Minor Changes

  • #305 7ad490a - Add --wait flag to mrt bundle deploy to poll until deployment completes, and align all SDK wait functions (waitForJob, waitForEnv) to a consistent pattern with structured onPoll callbacks, seconds-based options, and injectable sleep for testing. (Thanks @clavery!)

Patch Changes

  • Updated dependencies [7ad490a, c24e920]:
    • @salesforce/b2c-tooling-sdk@1.0.0

0.11.0

Minor Changes

  • #293 b5d07fd - Add Business Manager role management commands (bm roles) for instance-level access role CRUD, user assignment, and permissions via OCAPI Data API (Thanks @clavery!)

  • #286 5a6ab56 - Add mrt save-credentials command to save MRT API credentials to the ~/.mobify file (Thanks @clavery!)

  • #295 b7f78ca - Add site cartridge path management commands (sites cartridges list|add|remove|set) with --bm flag for Business Manager support and automatic fallback to site archive import when OCAPI permissions are unavailable (Thanks @clavery!)

Patch Changes

0.10.1

Patch Changes

  • Updated dependencies [f7229b4]:
    • @salesforce/b2c-tooling-sdk@0.12.0

0.10.0

Minor Changes

  • #278 8c31081 - Add content validate command to validate Page Designer metadefinition JSON files against bundled schemas. Supports auto-detection of schema types from file paths and content, or explicit --type flag. Includes glob pattern support for validating multiple files. (Thanks @clavery!)

Patch Changes

  • Updated dependencies [8c31081, e4b5094]:
    • @salesforce/b2c-tooling-sdk@0.11.0

0.9.0

Minor Changes

  • #167 caa568e - Introduces stateful authentication: auth login (browser/implicit), auth logout, auth client (client_credentials/password), auth client renew, and auth client token. Sessions are stored as a JSON file in the CLI data directory; when a valid session exists, all OAuth commands use it automatically without requiring credentials on every invocation. (Thanks @amit-kumar8-sf!)

    Note: Sessions are not shared with sfcc-ci. Re-authenticate with b2c auth login or b2c auth client after upgrading. Existing stateless auth (env vars, dw.json) is unaffected.

Patch Changes

  • b30e427 - Add --path flag to b2c docs schema to print the filesystem path to a schema file instead of its content, enabling use with tools like xmllint for XML validation. (Thanks @clavery!)

  • #272 e919e50 - Added sfcc-ci migration guide with command mappings and CI/CD migration instructions. Added backward-compatible sfcc-ci command aliases (client:auth, code:deploy, code:list, code:activate, job:run, etc.) and environment variable aliases (SFCC_OAUTH_CLIENT_ID, SFCC_OAUTH_CLIENT_SECRET, SFCC_LOGIN_URL). (Thanks @clavery!)

  • Updated dependencies [b30e427, e919e50, caa568e]:

    • @salesforce/b2c-tooling-sdk@0.10.0

0.8.0

Minor Changes

  • #268 0c4e288 - Add job log command to retrieve and display job execution logs. Supports fetching logs for a specific execution or automatically finding the most recent (or most recent failed) execution with a log file. (Thanks @clavery!)

0.7.4

Patch Changes

  • 4cf7249 - Add cartridges config option to specify which cartridges to deploy/watch. Supports comma or colon-separated strings, or arrays in dw.json. Also accepts cartridgesPath as an alias. The -c flag still takes precedence when provided. (Thanks @clavery!)

  • #264 9996eba - Fix multiple issues with the hook scaffold (#247): (Thanks @clavery!)

  • Updated dependencies [16bd9d6, 4cf7249, 9996eba, d50bf6b]:

    • @salesforce/b2c-tooling-sdk@0.9.0

0.7.3

Patch Changes

  • Updated dependencies [760a6cb]:
    • @salesforce/b2c-tooling-sdk@0.8.3

0.7.2

Patch Changes

  • d4423bb - Add MRT environment variable support to EnvSource (MRT_API_KEY, MRT_PROJECT, MRT_ENVIRONMENT, MRT_CLOUD_ORIGIN and their SFCC_MRT_* variants). The setup inspect command now shows values from SFCC_* environment variables as a config source. (Thanks @clavery!)

  • Updated dependencies [d4423bb, 69a98dc]:

    • @salesforce/b2c-tooling-sdk@0.8.2

0.7.1

Patch Changes

  • #249 e790dfa - Add --wait flag to sandbox clone create command to poll until the clone completes, matching the behavior of sandbox create --wait. Also fixes the status check hint to display the correct command name instead of a raw template string. (Thanks @clavery!)

  • Updated dependencies [e790dfa]:

    • @salesforce/b2c-tooling-sdk@0.8.1

0.7.0

Minor Changes

  • d7b2eba - Added sandbox update command to update sandbox TTL, auto-scheduling, tags, and notification emails via the PATCH API (Thanks @clavery!)

Patch Changes

  • Updated dependencies [b26ebeb]:
    • @salesforce/b2c-tooling-sdk@0.8.0

0.6.0

Minor Changes

  • #232 732d4ad - Add slas token command to retrieve SLAS shopper access tokens for API testing. Supports public (PKCE) and private (client_credentials) client flows, guest and registered customer authentication, and auto-discovery of public SLAS clients. (Thanks @clavery!)

Patch Changes

0.5.6

Patch Changes

  • d6b8c57 - Fix GitHub Actions for external repository usage by replacing relative ./actions/setup and ./actions/run references with fully qualified SalesforceCommerceCloud/b2c-developer-tooling/actions/setup@v1 and SalesforceCommerceCloud/b2c-developer-tooling/actions/run@v1 in all composite actions. (Thanks @clavery!)

  • Updated dependencies [8faf831]:

    • @salesforce/b2c-tooling-sdk@0.6.0

0.5.5

Patch Changes

  • beaf275 - MRT environment variables now use non-prefixed names (MRT_API_KEY, MRT_PROJECT, MRT_ENVIRONMENT, MRT_CLOUD_ORIGIN) as primary. The SFCC_-prefixed versions continue to work as fallbacks. (Thanks @clavery!)

  • Updated dependencies [beaf275]:

    • @salesforce/b2c-tooling-sdk@0.5.5

0.5.4

Patch Changes

  • Updated dependencies [f9ebb56]:
    • @salesforce/b2c-tooling-sdk@0.5.4

0.5.3

Patch Changes

  • #206 eff87af - Add globalConfigSourceRegistry for automatic plugin config source inclusion in resolveConfig(), matching the existing middleware registry pattern. Plugin config sources are now picked up automatically by all SDK consumers without manual plumbing. Also improves test isolation by preventing locally installed plugins from affecting test runs. (Thanks @clavery!)

  • Updated dependencies [eff87af]:

    • @salesforce/b2c-tooling-sdk@0.5.3

0.5.2

Patch Changes

  • Updated dependencies [a9db7da, dc7a25a]:
    • @salesforce/b2c-tooling-sdk@0.5.2

0.5.1

Patch Changes

  • #199 eb3f5d0 - Rename --working-directory flag to --project-directory. The old flag name --working-directory is still accepted as an alias. Primary env var is now SFCC_PROJECT_DIRECTORY; SFCC_WORKING_DIRECTORY continues to work as a deprecated fallback. (Thanks @clavery!)

  • Updated dependencies [eb3f5d0]:

    • @salesforce/b2c-tooling-sdk@0.5.1

0.5.0

Minor Changes

  • #155 55c81c3 - Add a new cip command topic for Commerce Intelligence platform (CCAC - Commerce Cloud Analytics) with cip query for raw SQL and curated cip report <report-name> subcommands for analytics workflows, including CIP host override support and tenant-based CIP instance targeting. (Thanks @clavery!)

  • #163 87321c0 - Add GitHub Actions for CI/CD automation: setup, run, code-deploy, mrt-deploy, job-run, and webdav-upload actions with starter workflow templates (Thanks @clavery!)

  • #151 f12984e - Add b2c setup ide prophet to generate a Prophet-compatible dw.js script from resolved CLI configuration (including plugin-resolved values), plus new IDE integration docs and setup command reference. (Thanks @clavery!)

Patch Changes

0.4.1

Patch Changes

  • #143 ca9dcf0 - Fix AM role ID mapping between API internal/external formats and improve user display output. Role grant/revoke now correctly handle mixed formats (role IDs in roles array, enum names in roleTenantFilter). User display shows role descriptions, resolves org names, and detects auth errors with actionable --user-auth suggestions. Commands accepting org IDs now also accept friendly org names. (Thanks @clavery!)

  • Updated dependencies [ca9dcf0]:

    • @salesforce/b2c-tooling-sdk@0.4.1

0.4.0

Minor Changes

  • #117 59fe546 - Add content export and content list commands for exporting Page Designer pages with components and static assets from content libraries. Supports filtering by page ID (exact or regex), folder classification, offline mode, and dry-run preview. (Thanks @clavery!)

  • 44b67f0 - Embed a default public client ID for implicit OAuth flows. Account Manager, Sandbox, and SLAS commands now work without requiring a pre-configured client ID — the CLI will automatically use a built-in public client for browser-based authentication. (Thanks @clavery!)

  • #98 91593f2 - Add setup instance commands for managing B2C Commerce instance configurations (create, list, remove, set-active). (Thanks @clavery!)

  • #125 0d29262 - Add mrt tail-logs command to stream real-time application logs from Managed Runtime environments. Supports level filtering, regex search with match highlighting, and JSON output. (Thanks @clavery!)

  • #113 0a6b8c8 - Rename ods topic to sandbox (with ods alias for backward compatibility). Add --permissions-client-id, --ocapi-settings, --webdav-settings, --start-scheduler, and --stop-scheduler flags to sandbox create. (Thanks @clavery!)

  • #102 8592727 - Add scaffolding framework for generating B2C Commerce components from templates. Includes 7 built-in scaffolds (cartridge, controller, hook, service, custom-api, job-step, page-designer-component) and support for custom project/user scaffolds. SDK provides programmatic API for IDE integrations and MCP servers. (Thanks @clavery!)

  • #120 908be47 - Add --user-auth flag for simplified browser-based authentication. AM commands now use standard auth method order; enhanced error messages provide role-specific guidance for Account Manager operations. (Thanks @clavery!)

Patch Changes

  • e116ce4 - Add update notifications that warn users when a newer version of the CLI is available (Thanks @clavery!)

  • #63 1a3117c - Account Manager (AM) topic with users, roles, and orgs subtopics. Use b2c am users, b2c am roles, and b2c am orgs for user, role, and organization management. (Thanks @amit-kumar8-sf!)

  • f879d99 - Rename setup config to setup inspect to better reflect its read-only purpose. setup config continues to work as an alias. (Thanks @clavery!)

  • #138 631ec23 - slas client list now returns an empty list instead of erroring when the SLAS tenant doesn't exist yet. (Thanks @clavery!)

  • Updated dependencies [1a3117c, 7a3015f, 59fe546, 44b67f0, 91593f2, 0d29262, 33dbd2f, 33dbd2f, 8592727, 908be47]:

    • @salesforce/b2c-tooling-sdk@0.4.0

0.3.0

Minor Changes

  • d772003 Thanks @clavery! - consistent command doc structure; better auth page; online links in examples for all topics/cmds

  • #83 ddee52e Thanks @clavery! - Add support for realm-instance format in ODS commands. You can now use zzzv-123 or zzzv_123 instead of full UUIDs for ods get, ods start, ods stop, ods restart, and ods delete commands.

  • #77 6859880 Thanks @clavery! - Add log tailing, listing, and retrieval commands for viewing B2C Commerce instance logs. See b2c logs topic.

  • #94 c34103b Thanks @clavery! - Add two-factor client certificate (mTLS) support for WebDAV operations

Patch Changes

  • d772003 Thanks @clavery! - bugfix code deploy to not require oauth unless needed

  • d772003 Thanks @clavery! - mrt bundle commands now relay warnings from the bundle such as out of date node versions

  • Updated dependencies [ddee52e, 6859880, 6b89ed6, c34103b]:

    • @salesforce/b2c-tooling-sdk@0.3.0

0.2.1

Patch Changes

  • 4e90f16 Thanks @clavery! - dw.json format bug fix

  • Updated dependencies [4e90f16]:

    • @salesforce/b2c-tooling-sdk@0.2.1

0.2.0

Minor Changes

  • #62 269de20 Thanks @clavery! - Add setup config command to display resolved configuration with source tracking.

    Shows all configuration values organized by category (Instance, Authentication, SCAPI, MRT) and indicates which source file or environment variable provided each value. Sensitive values are masked by default; use --unmask to reveal them.

  • #59 253c1e9 Thanks @clavery! - Reorganizes MRT commands by scope: project-level commands under mrt project, environment-level under mrt env, and deployment commands under mrt bundle. The mrt bundle download command now downloads files by default instead of just printing the URL.

  • #59 253c1e9 Thanks @clavery! - Adds complete MRT CLI coverage organized by scope: mrt project (CRUD, members, notifications), mrt env (CRUD, variables, redirects, access-control, cache invalidation, B2C connections), mrt bundle (deploy, list, history, download), mrt org (list, B2C instances), and mrt user (profile, API key, email preferences).

  • #59 253c1e9 Thanks @clavery! - Replaces mrt push with mrt bundle deploy. The new command supports both pushing local builds and deploying existing bundles by ID.

  • e0d652a Thanks @clavery! - Add b2c setup skills command for installing agent skills to AI-powered IDEs (Claude Code, Cursor, Windsurf, VS Code/Copilot, Codex, OpenCode)

  • 11a6887 Thanks @clavery! - Add b2c ecdn commands for managing eCDN zones, certificates, WAF, caching, security settings, and related configurations.

Patch Changes

  • 97f4b68 Thanks @clavery! - code deploy archive deletion is not a hard error

  • #64 c35f3a7 Thanks @clavery! - Fix HTML response bodies appearing in ERROR log lines. When API requests fail with non-JSON responses (like HTML error pages), error messages now show the HTTP status code (e.g., "HTTP 521 Web Server Is Down") instead of serializing the entire response body.

    Added getApiErrorMessage(error, response) utility that extracts clean error messages from ODS, OCAPI, and SCAPI error patterns with HTTP status fallback.

  • Updated dependencies [c35f3a7, 253c1e9, e0d652a, 11a6887, a14c741]:

    • @salesforce/b2c-tooling-sdk@0.2.0

0.1.0

Minor Changes

Patch Changes

  • Updated dependencies [bf0b8bb]:
    • @salesforce/b2c-tooling-sdk@0.1.0