Yeoman generator for tray.io Node.JS connectors
This Yeoman generator allows you to quickly create a skeleton Node.JS project for tray.io connectors.
Installation
To install this generator for use with Yeoman, use the following command in your terminal:
npm install -g generator-trayio-nodejs-connector
Make sure you have yeoman installed:
npm install -g yo
Creating A Connector Project
Once you have setup Yeoman and installed this generator using NPM, you can now get started with creating a new skeleton project.
First you must create a new directory for your connector. Please only use lowercase letters and dashes.
mkdir my-custom-connector
cd my-custom-connector
Then run the generator using yo, following the instructions to create your skeleton project.
yo trayio-nodejs-connector
If you want to create workflow trigger connector, you will be prompted to Include an HTTP trigger?. If you say yes, a trigger connector will be created and the associated init operation handler and http request handlers.
Running / Testing Your Connector
To run the connector, you'll need to run:
NODE_ENV=development node main.js
Deploying
Once a PR is merged into master, you will need to go into GitHub Actions UI and trigger the NPM Publish workflow manually providing the input of major, minor or patch depending on what version bump you want to publish - this will automatically build, tag, and publish the new version.
Once the pipeline is done, a github tag will appear with the new version number. You will need to merge in the automatically generated pull request which bumps the package version. You can then use this tag to create a Github release with some release notes.