For updates on other components of the Flex platform, see the
Twilio Changelog
and select the
Flex
product.
(warning)
Warning
Beginning September 10, 2024, you must use Node v18 or later with all supported versions of the Flex Plugins CLI. If you are using an older version of Node.js, please upgrade.
Fixed an issue that occurred when using the Flex Plugins CLI in
yarn
workspaces.
7.0.4
Release date August 30, 2024
Fixed
Fixed an issue that caused the Flex Plugins CLI v6.4.2 to be installed instead of the latest version if the installation script doesn't specify a version.
7.0.3
No updates.
7.0.2
Release date August 16, 2024
Fixed
Fixed a Node version compatibility issue that occurred due to a Cheerio package dependency. The Flex Plugins CLI now works correctly with supported Node versions earlier than v18.17.
7.0.1
Release date July 24, 2024
Fixed
Upgraded the Paste versions of the plugin template to fix conflict warnings.
Fixed the "Failed to load remote plugins" issue that occurred when using the
--include-remote
flag.
7.0.0
Release date June 10, 2024
Summary
The Flex Plugins CLI can now help validate your plugins against the latest Flex UI version to ensure compatibility. For details about the latest features being built on the CLI, see our Flex Plugins CLI documentation.
Updated the
twilio:flex:plugins:deploy
command to implicitly validate the plugin. For details, see
Deploy
in the
Plugins CLI reference
.
Integrated telemetry for all the commands.
Fixed security vulnerabilities by upgrading Webpack Dev Server to v4.
Enhanced the CLI version update notifier feature and added deprecation notification so that you can always be on the stable version of the CLI.
Removed unused dependencies in
@twilio/flex-plugin-scripts
package.
Breaking changes
Because the
twilio:flex:plugins:deploy
command now validates plugins as part of the deployment process, version 7.0.0 and later can disrupt automated deployments, such CI/CD pipelines. When the Deploy command runs, if the validation process finds any errors, the deployment process stops to ask for input. To prevent this issue, use the
--bypass-validation
option on your Deploy command to skip plugin validation for automated deployments. For details, see
Deploy
in the
Plugins CLI reference
.
As of August 16, 2024, Node v16 is no longer supported. Plugins must be compatible with Node v18 or later.
This update supercedes the original release note published on June 10, 2024, which indicated that Node v14 is no longer supported and that plugins must be compatible with Node v16.x or later.
Upgrading to 7.x
Upgrade using CLI
Install the Twilio CLI and the Flex Plugins extension as described in the Flex Plugins CLI overview. Then, go to the plugin directory and run the following command:
$ twilio flex:plugins:upgrade-plugin --install
This script automatically upgrades your plugin to the latest version.
Upgrade manually
To manually upgrade to version 7.x, modify your package.json:
1
{
2
"scripts": {
3
"postinstall":"flex-plugin pre-script-check"
4
},
5
"dependencies": {
6
"flex-plugin-scripts":"^7.0.0",
7
"react":"17.0.2",
8
"react-dom":"17.0.2"
9
},
10
"devDependencies": {
11
"@twilio/flex-ui":"^2"
12
}
13
}
6.4.2
Release date August 16, 2024
Fixed
Fixed a Node version compatibility issue that occurred due to a Cheerio package dependency. The Flex Plugins CLI now works correctly with supported Node versions earlier than v18.17.
6.4.1
Release date May 15, 2024
Fixed
Added support for making cache setup optional for the HTTP client instance.
Removed caching for the HTTP client instance used in
flex-plugins-api-client
to fix the CORS issue observed for some of the Flex Plugins APIs in the browser due to an unrecognized cache header.
6.4.0
Release date May 10, 2024
Fixed
Security updates.
6.3.3
Release date April 4, 2024
Fixed
Fixed an issue with loading remote plugins in localhost that began when Flex started using partitioned cookies to the store the Flex JWE token.
6.3.1
Release date February 8, 2024
Fixed
The
ECONREFUSED
error that was observed in Node versions 17 and higher is fixed.
6.3.0
Release date February 6, 2024
Fixed
The
terser-webpack-plugin
issue observed when plugin is built is fixed.
The issue with the creation of
source-map
file is addressed.
One critical and four high vulnerabilities in packages have been addressed.
Upgrades
The Twilio Serverless build API always uses the latest Node runtime version.
Webpack is reverted to the latest stable v4 (4.47.0), as many of the dependencies that plugins use are not compatible with webpack v5 yet. Following are some of the issues identified with webpack v5:
source-map
may not be loaded, depending on the operating system and Node version of the user.
The
twilio:flex:plugins:start
script errors appear (for example,
message.split is not a function
) depending on the operating system and Node version of the user.
Node core modules are not auto-polyfilled in webpack v5 for the browser.
Many third-party libraries, such as webpack plugins, babel plugins, eslint plugins, typescript plugins, and CRA dependencies, are not compatible with webpack v5 yet.
Added support for Node v20.
6.2.3 (deprecated)
Release date October 23, 2023
Upgrades
Added support for serverless node18 runtime.
6.2.2 (deprecated)
Release date Oct 17, 2023
Fixed
Fixed the
global is not defined
error in the browser environment by providing a polyfill in webpack configuration.
6.2.1 (deprecated)
Release date October 10, 2023
Fixed
Fixed a bug that caused plugin local build failure when referencing SCSS/SASS files inside any component.
6.2.0 (deprecated)
Release date September 28, 2023
Upgrades
Upgraded the Flex plugin webpack to use the
webpack 5
package.
Security upgrades
Addressed security vulnerabilities in the following packages by upgrading their versions:
latest-version@7.0.0
cheerio@^1.0.0-rc.12
6.1.2 (deprecated)
Release date May 17, 2023
Highlights
Flex Plugin Builder scaffolds a new plugin that is compatible with Flex UI 2.x when you create a plugin using the create command. The switch to create a new Flex UI 1.x-compatible plugin is
--flexui1
.
6.1.1 (deprecated)
Release date April 28, 2023
Security upgrades
Upgraded the versions of the following packages to address security vulnerabilities:
@twilio/cli-core@7.6.1
qs@6.10.3
resolve-url-loader@4.0.0
6.1.0 (deprecated)
Release date April 19, 2023
Added
Flex Plugin Builder now supports Node v16 and Node v18.
Note: If you encounter the error
ERR_OSSL_EVP_UNSUPPORTED
, which happens due to incompatibility between the newer version of OpenSSL and Node v18, run the following command:
For MacOS & Linux:
exportNODE_OPTIONS=--openssl-legacy-provider
For Windows:
setNODE_OPTIONS=--openssl-legacy-provider
Fixed
Fixed a bug in the archival process of plugin and plugin-version.
6.0.4 (deprecated)
Release date January 10, 2023
Fixed
Modified the markdown formatter syntax for italic that is used by the logger.
6.0.3 (deprecated)
Release date November 2, 2022
Fixed
Fixed an issue with using the plugin builder from behind a HTTP proxy.
6.0.2 (deprecated)
Release date October 19, 2022
Fixed
Fixed address compatibility with @oclif/core v1.19.0.
6.0.1 (deprecated)
Release date October 13, 2022
Refer to
Flex Plugins CLI docs
to stay up-to-date with the latest features being built on the CLI.
The Plugin Flex package now uses Twilio CLI 5.0, which has upgraded the
oclif
package version from v1 to v2.
Install the Twilio CLI and the Flex Plugins extension as described in the Flex Plugins CLI docs. Then, go to the plugin directory and run the following command:
$twilio flex:plugins:upgrade-plugin--install
This script automatically upgrades your plugin to the latest version.
Upgrade manually
To manually upgrade to version 6.x, modify your package.json:
1
{
2
"scripts": {
3
"postinstall":"flex-plugin pre-script-check"
4
},
5
"dependencies": {
6
"flex-plugin-scripts":"^6.0.1",
7
"react":"16.5.2",
8
"react-dom":"16.5.2"
9
},
10
"devDependencies": {
11
"@twilio/flex-ui":"^1"
12
}
13
}
Breaking changes
Version 6 removes support for:
Twilio CLI v4 and below. Make sure to upgrade to the latest version of Twilio CLI (v5) to use Flex Plugins CLI 6.x.
Node 12. Version 6.x only supports Node 14.x. You must install and use Node 14.x (preferably the LTS version) to run Flex Plugins CLI commands. This means that your plugins also have to be compatible with Node version 14.x.