Skip to content

Commit a14ccbb

Browse files
authored
Merge pull request #468 from twilio/changelog-update
Changelog update
2 parents 4e9208f + dcb3374 commit a14ccbb

File tree

2 files changed

+33
-32
lines changed

2 files changed

+33
-32
lines changed

changelog/v4.md

Lines changed: 9 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
1-
## 4.x - Beta
1+
## 4.0.0 (May 17th, 2021)
22

3-
Create Flex Plugin 4.x uses the [Twilio Flex Plugins API](https://www.twilio.com/docs/flex/plugins/api) to manage your Flex Plugins, create versions, and define which plugins the Flex UI will load during initialization via an API.
3+
Refer to [Twilio Flex Docs](https://www.twilio.com/docs/flex/developer/plugins/cli) to be up-to-date with the latest features being built on the CLI.
4+
5+
Create Flex Plugin 4.0.0 uses the [Twilio Flex Plugins API](https://www.twilio.com/docs/flex/plugins/api) to manage your Flex Plugins, create versions, and define which plugins the Flex UI will load during initialization via an API.
46

57
It completely removes the dependency on `react-scripts` and instead uses native Webpack to build and serve your plugins locally.
68

@@ -22,6 +24,8 @@ $ twilio flex:plugins:upgrade-plugin --install
2224

2325
This script should automatically upgrade your plugin to the latest version.
2426

27+
## Manual Upgrade
28+
2529
To manually upgrade to version 4.x, modify your `package.json`:
2630

2731
```json
@@ -30,7 +34,7 @@ To manually upgrade to version 4.x, modify your `package.json`:
3034
"postinstall": "flex-plugin pre-script-check"
3135
},
3236
"dependencies": {
33-
"flex-plugin-scripts": "^4.2.7-beta.0",
37+
"flex-plugin-scripts": "^4.0.0",
3438
"react": "16.5.2",
3539
"react-dom": "16.5.2"
3640
},
@@ -39,9 +43,6 @@ To manually upgrade to version 4.x, modify your `package.json`:
3943
}
4044
}
4145
```
42-
43-
Please use `npm view flex-plugin-scripts dist-tags.beta` to find the current latest beta version and use that instead of `4.2.7-beta.0` as show above.
44-
4546
If you are currently using `craco.config.js`, please refer to the next section [Breaking Changes](#breaking-changes) on migrating it.
4647

4748
You may also need to update your `public/appConfig.js` and update the `pluginService`:
@@ -78,7 +79,7 @@ module.exports = (config, { isProd, isDev, isTest }) => {
7879

7980
Upgrading from v1/v2 will, unfortunately, include a period of downtime. Your contact-center will either have the same plugin running twice or the plugin missing from it (this period will only be at most 1 minute long). Therefore, it is recommended to do this migration when you don't expect high usage of your contact center.
8081

81-
First, upgrade the plugin locally using `$ twilio flex:plugins:upgrade --beta` from the guide above.
82+
First, upgrade the plugin locally using `$ twilio flex:plugins:upgrade` from the guide above.
8283

8384
Next, decide if you prefer to have the plugin show twice or not at all. You'll need to deploy/release using the CLI and delete the plugin from [Twilio Console Assets](https://www.twilio.com/console/assets). Unfortunately, these two steps must be done manually.
8485

@@ -88,7 +89,7 @@ It is recommended that you `deploy` (using `twilio flex:plugins:deploy`) your pl
8889

8990
Upgrading from v3 is simple and has no downtime.
9091

91-
1. Upgrade the plugin locally using `$ twilio flex:plugins:upgrade --beta` from the guide above.
92+
1. Upgrade the plugin locally using `$ twilio flex:plugins:upgrade` from the guide above.
9293
2. Deploy and register the plugin using `$ twilio flex:plugins:deploy` and `$ twilio flex:plugins:release`
9394
3. Remove the v0.0.0 plugin from v3 using `$ twilio flex:plugins:upgrade --cleanup`
9495

packages/plugin-flex/README.md

Lines changed: 24 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -80,7 +80,7 @@ OPTIONS
8080
--sid=sid (required) The Flex Plugin Configuration SID to archive.
8181
```
8282

83-
_See code: [dist/commands/flex/plugins/archive/configuration.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/archive/configuration.js)_
83+
_See code: [dist/commands/flex/plugins/archive/configuration.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/archive/configuration.js)_
8484

8585
## `twilio flex:plugins:archive:plugin`
8686

@@ -97,7 +97,7 @@ OPTIONS
9797
--name=name (required) The name of the Flex Plugin to archive.
9898
```
9999

100-
_See code: [dist/commands/flex/plugins/archive/plugin.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/archive/plugin.js)_
100+
_See code: [dist/commands/flex/plugins/archive/plugin.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/archive/plugin.js)_
101101

102102
## `twilio flex:plugins:archive:plugin-version`
103103

@@ -115,7 +115,7 @@ OPTIONS
115115
--version=version (required) The Flex Plugin Version to archive.
116116
```
117117

118-
_See code: [dist/commands/flex/plugins/archive/plugin-version.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/archive/plugin-version.js)_
118+
_See code: [dist/commands/flex/plugins/archive/plugin-version.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/archive/plugin-version.js)_
119119

120120
## `twilio flex:plugins:build`
121121

@@ -131,11 +131,11 @@ OPTIONS
131131
--clear-terminal Clears the terminal before running the command.
132132
```
133133

134-
_See code: [dist/commands/flex/plugins/build.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/build.js)_
134+
_See code: [dist/commands/flex/plugins/build.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/build.js)_
135135

136136
## `twilio flex:plugins:create NAME`
137137

138-
Creates a new Twilio Flex Plugin project
138+
Creates a new Twilio Flex Plugin project
139139

140140
```
141141
USAGE
@@ -158,11 +158,11 @@ OPTIONS
158158
-y, --yarn Use yarn as your dependency manager
159159
160160
DESCRIPTION
161-
Arguments:
161+
Arguments:
162162
name Name of your plugin. This command needs to be invoked inside a plugin directory.
163163
```
164164

165-
_See code: [dist/commands/flex/plugins/create.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/create.js)_
165+
_See code: [dist/commands/flex/plugins/create.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/create.js)_
166166

167167
## `twilio flex:plugins:create-configuration`
168168

@@ -187,7 +187,7 @@ OPTIONS
187187
as a shortcut for enabling the latest version of the plugin. Use additional
188188
--enable-plugin to provide other plugins to enable.
189189
190-
--name=name (required) [default: Autogenerated Release 1620852163145] The friendly name of the
190+
--name=name (required) [default: Autogenerated Release 1621275337196] The friendly name of the
191191
Flex Plugin Configuration.
192192
193193
--new Creates a new Flex Plugin Configuration, otherwise will append to existing active
@@ -196,7 +196,7 @@ OPTIONS
196196
--plugin=plugin Alias for --enable-plugin.
197197
```
198198

199-
_See code: [dist/commands/flex/plugins/create-configuration.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/create-configuration.js)_
199+
_See code: [dist/commands/flex/plugins/create-configuration.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/create-configuration.js)_
200200

201201
## `twilio flex:plugins:deploy`
202202

@@ -219,7 +219,7 @@ OPTIONS
219219
--version=version Publishes the version (SemVer).
220220
```
221221

222-
_See code: [dist/commands/flex/plugins/deploy.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/deploy.js)_
222+
_See code: [dist/commands/flex/plugins/deploy.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/deploy.js)_
223223

224224
## `twilio flex:plugins:describe:configuration`
225225

@@ -237,7 +237,7 @@ OPTIONS
237237
--sid=sid (required) The Flex Plugin Configuration SID.
238238
```
239239

240-
_See code: [dist/commands/flex/plugins/describe/configuration.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/describe/configuration.js)_
240+
_See code: [dist/commands/flex/plugins/describe/configuration.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/describe/configuration.js)_
241241

242242
## `twilio flex:plugins:describe:plugin`
243243

@@ -255,7 +255,7 @@ OPTIONS
255255
--name=name (required) The name of the Flex Plugin to describe.
256256
```
257257

258-
_See code: [dist/commands/flex/plugins/describe/plugin.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/describe/plugin.js)_
258+
_See code: [dist/commands/flex/plugins/describe/plugin.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/describe/plugin.js)_
259259

260260
## `twilio flex:plugins:describe:plugin-version`
261261

@@ -274,7 +274,7 @@ OPTIONS
274274
--version=version (required) The Flex Plugin Version to describe.
275275
```
276276

277-
_See code: [dist/commands/flex/plugins/describe/plugin-version.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/describe/plugin-version.js)_
277+
_See code: [dist/commands/flex/plugins/describe/plugin-version.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/describe/plugin-version.js)_
278278

279279
## `twilio flex:plugins:describe:release`
280280

@@ -293,7 +293,7 @@ OPTIONS
293293
--sid=sid The Flex Plugin Release SID to describe.
294294
```
295295

296-
_See code: [dist/commands/flex/plugins/describe/release.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/describe/release.js)_
296+
_See code: [dist/commands/flex/plugins/describe/release.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/describe/release.js)_
297297

298298
## `twilio flex:plugins:diff ID1 [ID2]`
299299

@@ -313,7 +313,7 @@ OPTIONS
313313
--clear-terminal Clears the terminal before running the command.
314314
```
315315

316-
_See code: [dist/commands/flex/plugins/diff.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/diff.js)_
316+
_See code: [dist/commands/flex/plugins/diff.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/diff.js)_
317317

318318
## `twilio flex:plugins:list:configurations`
319319

@@ -330,7 +330,7 @@ OPTIONS
330330
--json Outputs the result of the command as json string.
331331
```
332332

333-
_See code: [dist/commands/flex/plugins/list/configurations.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/list/configurations.js)_
333+
_See code: [dist/commands/flex/plugins/list/configurations.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/list/configurations.js)_
334334

335335
## `twilio flex:plugins:list:plugin-versions`
336336

@@ -348,7 +348,7 @@ OPTIONS
348348
--name=name (required) The plugin name to list its versions.
349349
```
350350

351-
_See code: [dist/commands/flex/plugins/list/plugin-versions.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/list/plugin-versions.js)_
351+
_See code: [dist/commands/flex/plugins/list/plugin-versions.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/list/plugin-versions.js)_
352352

353353
## `twilio flex:plugins:list:plugins`
354354

@@ -365,7 +365,7 @@ OPTIONS
365365
--json Outputs the result of the command as json string.
366366
```
367367

368-
_See code: [dist/commands/flex/plugins/list/plugins.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/list/plugins.js)_
368+
_See code: [dist/commands/flex/plugins/list/plugins.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/list/plugins.js)_
369369

370370
## `twilio flex:plugins:list:releases`
371371

@@ -382,7 +382,7 @@ OPTIONS
382382
--json Outputs the result of the command as json string.
383383
```
384384

385-
_See code: [dist/commands/flex/plugins/list/releases.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/list/releases.js)_
385+
_See code: [dist/commands/flex/plugins/list/releases.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/list/releases.js)_
386386

387387
## `twilio flex:plugins:release`
388388

@@ -410,7 +410,7 @@ OPTIONS
410410
pluginName@latest as a shortcut for enabling the latest version of the plugin.
411411
Use additional --enable-plugin to provide other plugins to enable.
412412
413-
--name=name [default: Autogenerated Release 1620852163145] The friendly name of the Flex
413+
--name=name [default: Autogenerated Release 1621275337196] The friendly name of the Flex
414414
Plugin Configuration.
415415
416416
--new Creates a new Flex Plugin Configuration, otherwise will append to existing
@@ -419,7 +419,7 @@ OPTIONS
419419
--plugin=plugin Alias for --enable-plugin.
420420
```
421421

422-
_See code: [dist/commands/flex/plugins/release.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/release.js)_
422+
_See code: [dist/commands/flex/plugins/release.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/release.js)_
423423

424424
## `twilio flex:plugins:start`
425425

@@ -440,7 +440,7 @@ OPTIONS
440440
remote plugins using "--name 'plugin-name@remote'".
441441
```
442442

443-
_See code: [dist/commands/flex/plugins/start.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/start.js)_
443+
_See code: [dist/commands/flex/plugins/start.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/start.js)_
444444

445445
## `twilio flex:plugins:test`
446446

@@ -456,7 +456,7 @@ OPTIONS
456456
--clear-terminal Clears the terminal before running the command.
457457
```
458458

459-
_See code: [dist/commands/flex/plugins/test.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/test.js)_
459+
_See code: [dist/commands/flex/plugins/test.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/test.js)_
460460

461461
## `twilio flex:plugins:upgrade-plugin`
462462

@@ -483,5 +483,5 @@ OPTIONS
483483
--yes If set, will answer yes to all prompts.
484484
```
485485

486-
_See code: [dist/commands/flex/plugins/upgrade-plugin.js](https://github.com/twilio/flex-plugin-builder/blob/v4.9.1-beta.0/dist/commands/flex/plugins/upgrade-plugin.js)_
486+
_See code: [dist/commands/flex/plugins/upgrade-plugin.js](https://github.com/twilio/flex-plugin-builder/blob/v4.0.0/dist/commands/flex/plugins/upgrade-plugin.js)_
487487
<!-- commandsstop -->

0 commit comments

Comments
 (0)