@twilio-labs/plugin-flex

@twilio-labs/plugin-flex

Twilio CLI plugin to interact with the Flex Plugin Builder

This plugin adds functionality to the Twilio CLI to locally develop, build and deploy Twilio Flex plugins; it uses the Flex Plugin Builder.

• Requirements
• Usage
• Commands

Requirements

Install the Twilio CLI

Via npm or yarn:

$ npm install -g twilio-cli
$ yarn global add twilio-cli

Via homebrew:

$ brew tap twilio/brew && brew install twilio

Usage

$ twilio plugins:install @twilio-labs/plugin-flex

$ twilio --help flex

USAGE
  $ twilio flex
...

Commands

• twilio flex:plugins:build
• twilio flex:plugins:create NAME
• twilio flex:plugins:create-configuration
• twilio flex:plugins:deploy
• twilio flex:plugins:describe:configuration
• twilio flex:plugins:describe:plugin
• twilio flex:plugins:describe:plugin-version
• twilio flex:plugins:describe:release
• twilio flex:plugins:diff ID1 [ID2]
• twilio flex:plugins:list:configurations
• twilio flex:plugins:list:plugin-versions
• twilio flex:plugins:list:plugins
• twilio flex:plugins:list:releases
• twilio flex:plugins:release
• twilio flex:plugins:start
• twilio flex:plugins:test
• twilio flex:plugins:upgrade-plugin

twilio flex:plugins:build

Builds the Flex plugin and creates a JavaScript and sourcemap bundle. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:build

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string

See code: src/commands/flex/plugins/build.ts

twilio flex:plugins:create NAME

Creates a new Twilio Flex Plugin project

USAGE
  $ twilio flex:plugins:create NAME

ARGUMENTS
  NAME  Creates a new Twilio Flex Plugin project

        Arguments:
        name	Name of your plugin. Needs to start with plugin-

OPTIONS
  -a, --accountSid=accountSid  The Account SID for your Flex Project
  -h, --help=help
  -i, --install                Auto-install dependencies
  -r, --runtimeUrl             Auto-install dependencies
  -s, --typescript             Create a TypeScript project
  -t, --template=template      A URL to a template directory
  -v, --version=version
  -y, --yarn                   Use yarn as your dependency manager

DESCRIPTION
  Arguments:
  name	Name of your plugin. Needs to start with plugin-. This command needs to be invoked inside a plugin directory.

See code: src/commands/flex/plugins/create.ts

twilio flex:plugins:create-configuration

Creates a Flex Plugin Configuration. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:create-configuration

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command

  --description=description        (required) [default: The description of this Flex Plugin Configuration] The
                                   description of this Flex Plugin Configuration

  --name=name                      (required) [default: Autogenerated Release 1601413221072] The friendly name of the
                                   Flex Plugin Configuration

  --new                            Creates a new Flex Plugin Configuration, otherwise will append to existing active
                                   Configuration

  --plugin=plugin                  (required) The plugin to install, formatted as pluginName@version. Use additional
                                   --plugin to provide other plugins to install

See code: src/commands/flex/plugins/create-configuration.ts

twilio flex:plugins:deploy

Builds and deploys a new version of the Flex plugin to your Flex application. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:deploy

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --changelog=changelog            (required) The changes (added/removed) made in this plugin version
  --clear-terminal                 Clears the terminal before running the command
  --description=description        The description of this Flex plugin
  --major                          Publishes the version as a major (SemVer)
  --minor                          Publishes the version as a minor (SemVer)
  --patch                          Publishes the version as a patch (SemVer); this is the default
  --public                         Publishes the plugin as a public Twilio Asset; default is private
  --version=version                Publishes the version (SemVer)

See code: src/commands/flex/plugins/deploy.ts

twilio flex:plugins:describe:configuration

Provides details of the Flex Plugin Configuration like status, description and its associated Plugins.

USAGE
  $ twilio flex:plugins:describe:configuration

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string
  --sid=sid                        (required) The Flex Plugin Configuration SID

See code: src/commands/flex/plugins/describe/configuration.ts

twilio flex:plugins:describe:plugin

Provides details of the Flex Plugin like status, description and its Flex Plugin Versions.

USAGE
  $ twilio flex:plugins:describe:plugin

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string
  --name=name                      (required) The name of the Flex Plugin to describe

See code: src/commands/flex/plugins/describe/plugin.ts

twilio flex:plugins:describe:plugin-version

Provides details of the Flex Plugin Version like changelog, status and the url of the plugin package.

USAGE
  $ twilio flex:plugins:describe:plugin-version

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string
  --name=name                      (required) The Flex Plugin name of the Plugin Version to describe
  --version=version                (required) The Flex Plugin Version to describe

See code: src/commands/flex/plugins/describe/plugin-version.ts

twilio flex:plugins:describe:release

Provides details of the Flex Plugin Release like the underlying Plugin Configuration and Plugins.

USAGE
  $ twilio flex:plugins:describe:release

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --active
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string
  --sid=sid                        The Flex Plugin Release SID to describe

See code: src/commands/flex/plugins/describe/release.ts

twilio flex:plugins:diff ID1 [ID2]

Finds the diff between two Flex Plugin Configurations.

USAGE
  $ twilio flex:plugins:diff ID1 [ID2]

ARGUMENTS
  ID1  The first Flex Plugin Configuration SID
  ID2  The second Flex Plugin Configuration SID

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command

See code: src/commands/flex/plugins/diff.ts

twilio flex:plugins:list:configurations

Lists the Flex Plugin Configuration on the account.

USAGE
  $ twilio flex:plugins:list:configurations

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string

See code: src/commands/flex/plugins/list/configurations.ts

twilio flex:plugins:list:plugin-versions

Lists the Flex Plugin Versions on the account.

USAGE
  $ twilio flex:plugins:list:plugin-versions

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string
  --name=name                      (required) The plugin name to list its versions

See code: src/commands/flex/plugins/list/plugin-versions.ts

twilio flex:plugins:list:plugins

Lists the Flex Plugins on the account.

USAGE
  $ twilio flex:plugins:list:plugins

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string

See code: src/commands/flex/plugins/list/plugins.ts

twilio flex:plugins:list:releases

Lists the Flex Releases on the account.

USAGE
  $ twilio flex:plugins:list:releases

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --json                           Outputs the result of the command as json string

See code: src/commands/flex/plugins/list/releases.ts

twilio flex:plugins:release

Creates a Flex Plugin Release. Enables the plugins (passed as params or via the Flex Configuration) on your Flex application.

USAGE
  $ twilio flex:plugins:release

OPTIONS
  -l=(debug|info|warn|error|none)        [default: info] Level of logging messages.
  -p, --profile=profile                  Shorthand identifier for your profile.
  --clear-terminal                       Clears the terminal before running the command

  --configuration-sid=configuration-sid  The Flex Plugin Configuration SID to release; other options are not required
                                         when using this option

  --description=description              [default: The description of this Flex Plugin Configuration] The description of
                                         this Flex Plugin Configuration

  --name=name                            [default: Autogenerated Release 1601413221072] The friendly name of the Flex
                                         Plugin Configuration

  --new                                  Creates a new Flex Plugin Configuration, otherwise will append to existing
                                         active Configuration

  --plugin=plugin                        The plugin to install, formatted as pluginName@version. Use additional --plugin
                                         to provide other plugins to install

See code: src/commands/flex/plugins/release.ts

twilio flex:plugins:start

Starts a dev-server to build the Flex plugin locally.

USAGE
  $ twilio flex:plugins:start

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command
  --name=name                      The name of the plugin(s) you would like to run

See code: src/commands/flex/plugins/start.ts

twilio flex:plugins:test

Runs the test suite. This command needs to be invoked inside a plugin directory.

USAGE
  $ twilio flex:plugins:test

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --clear-terminal                 Clears the terminal before running the command

See code: src/commands/flex/plugins/test.ts

twilio flex:plugins:upgrade-plugin

Upgrades your plugin to use the latest version of the Plugin CLI.

USAGE
  $ twilio flex:plugins:upgrade-plugin

OPTIONS
  -l=(debug|info|warn|error|none)  [default: info] Level of logging messages.
  -p, --profile=profile            Shorthand identifier for your profile.
  --beta                           If set, will upgrade to the latest beta version
  --clear-terminal                 Clears the terminal before running the command
  --install                        If set, will install the dependencies
  --remove-legacy-plugin           Deletes legacy plugin bundle hosted on Twilio Assets (deployed via plugin builder v3)
  --yes                            If set, will answer yes to all prompts

See code: src/commands/flex/plugins/upgrade-plugin.ts