Skip to content

dbarbato-sf/commerce-sdk

 
 

Repository files navigation

Salesforce Commerce Node.js SDK

CircleCI

What is This?

A monorepo containing packages that generate the Salesforce Commerce SDK. Read more about the SDK here.

Visit the Commerce Cloud Developer Center to learn more about Salesforce Commerce. The developer center has API documentation, getting started guides, community forums, and more.

Packages

Note: This repository formerly contained @commerce-apps/exchange-connector. That package has been deprecated, and its functionality has been moved to @commerce-apps/raml-toolkit.

commerce-sdk

The generator package is responsible for generating the SDK from RAML files. Since the SDK is generated it is not a part of any repository. Read more about the SDK here and how the generator works here.

@commerce-apps/core

The Core package represents the core functions that call the APIs and interact with Salesforce Commerce. It is used by the SDK. Read more about the core package here.

Setup

All of these commands can be run from either the repo root or the package root.

# To setup
npm install

# To build
npm run build

Running Tests

Note: Instructions in the Setup section are prerequisites for this section

To run tests in all the packages, execute

npm test

To print the detailed test results and errors on the console, execute

npm run test:debug

To run tests in the core package only, execute

npm run test:core

To run tests in the generator package only, execute

npm run test:generator

These commands will fail if a minimum of 80% coverage is not maintained per source file. Certain files may show 0% coverage in the report when the file does not include testable statements (i.e. files that only contain an interface). These files will not trigger a failure. The coverage is generated using nyc. The configuration is stored within the package.json of each package.

Issues

First, check the open issues and Commerce Cloud Developer Center for any open issues related to the issue that you are experiencing. If not already raised please file a new issue here with all the necessary details. If you require an urgent resolution to your issue please ask your AM/CSM to file a support ticket with Salesforce Commerce.

Contributing

If you would like to contribute please take a look at our contributors' guide.

Additional Documentation

Using VSCODE
Code Generation
API Documentation

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 72.8%
  • JavaScript 22.6%
  • Handlebars 4.6%