sfdx-generator

A node wrapper for Salesforce DX

Usage no npm install needed!

<script type="module">
  import sfdxGenerator from 'https://cdn.skypack.dev/sfdx-generator';
</script>

README

SFDX javascript wrapper.

styled with prettier Greenkeeper badge Travis Coveralls Dev Dependencies

A typescript tool that generates SFDX wrappers

Usage

 const sfdxGenerator = require('../compiled/sfdx-generator.js');
 const path = require('path');
 const root = path.resolve(__dirname, './..');
 
 // Using sfdx from dev dependencies instead of global;
 const sfdxPath = path.resolve(root, './node_modules/.bin/sfdx.cmd');
 
 const generator = new sfdxGenerator.Generator({
   SFDXPath: 'sfdx',
   outputDirectory: path.resolve(root, './generated'),
   templateDirectory: path.resolve(root, './templatesExample'),
   fileExtension: '.ts'
 });

 // Generate files using sfdx output.
 generator.generate().then(() => {
   console.log('Generating done');
 });

Documentation

Read our doc here: https://coveo.github.io/sfdx-generator/

dev scripts

  • npm start: Runs npm run build in watch mode.
  • npm run build: Generage bundles and typings, create docs.
  • npm run lint: Lints code.
  • npm run commit: Commit using conventional commit style (husky will tell you to use it if you haven't :wink:).
  • npm run generate: Generate wrapper classes using the SFDX executable in path.

Git Hooks

There is already set a precommit hook for formatting your code with Prettier :nail_care:

By default, there are 2 disabled git hooks. They're set up when you run the npm run semantic-release-prepare script. They make sure:

This makes more sense in combination with automatic releases.

Credits

Made with :heart: