@integration-app/react

Releasing Package

To release a new version of a package (@integration-app/sdk, @integration-app/ui, @integration-app/react), do the following:

• Go to the package and type npm version -- patch (or npm version -- minor or npm version -- major) to bump the version.
• Create a PR with the changes.
• Merge the PR.
• Run a Github Action to publish a package.

Rollup config

Check out the rollup.config.mjs file for the full config.

It's pretty self-explanatory, but here's some additional info:

Externals

We set {external: [/node_modules/]} because we don't want to bundle any of our dependencies. If we need to bundle some dependencies and some not, we can use rollup-plugin-peer-deps-external plugin instead of this.

To prevent Rollup from bundling the @integration-app/sdk package during local development, we specify it as an external dependency since Rollup does not match locally placed packages with the /node_modules/ rule.

DTS

DTS files are generated by tsc and placed in dist/dts folder. After that plugin rollup-plugin-dts is used to generate *.d.ts files for each bundle.

Package.json exports

{
  "exports": {
    "types": "./dist/index.d.ts",       // TypeScript typings for NodeNext modules
    "require": "./dist/index.js",       // used for require() in Node 12+
    "import": "./dist/index.module.mjs" // ESM bundle
  },
  "types": "./dist/index.d.ts",         // TypeScript typings
  "main": "./dist/index.js",            // CommonJS bundle
  "module": "./dist/index.module.mjs",  // ESM bundle
  "unpkg": "./dist/index.umd.js",       // UMD bundle
}

Local and publish build workflow

For a local development, we use locally placed @integration-app/sdk package.

And for publishing, we use @integration-app/sdk@latest package.

To make it work, we use dev and build commands.

dev workflow

• Delete dist folders
• Install local @integration-app/sdk pointed to sdk folder
• Remove react and react-dom packages from node_modules folder
  • We should do it to allow out package work in console, engine and other local projects
• Run rollup in watch mode to build a package

build workflow

• Delete dist folders
• Install @integration-app/sdk@latest package
• Run rollup to build a package

Because GitHub Actions use build command, we could be sure that package uses the latest @integration-app/sdk package.