proca 1.7.8 → 1.8.2

package/README.md

@@ -60,6 +60,8 @@ you should also use the local proca-api in your [widget generator](https://githu
 * [`proca campaign list [TITLE]`](#proca-campaign-list-title)
 * [`proca campaign mtt`](#proca-campaign-mtt)
 * [`proca campaign status`](#proca-campaign-status)
+* [`proca campaign widget get`](#proca-campaign-widget-get)
+* [`proca campaign widget rebuild`](#proca-campaign-widget-rebuild)
 * [`proca config add [ENV] [HUMAN] [JSON] [CSV] [MARKDOWN] [SIMPLIFY]`](#proca-config-add-env-human-json-csv-markdown-simplify)
 * [`proca config folder`](#proca-config-folder)
 * [`proca config init [ENV] [HUMAN] [JSON] [CSV] [MARKDOWN] [SIMPLIFY]`](#proca-config-init-env-human-json-csv-markdown-simplify)
@@ -75,14 +77,16 @@ you should also use the local proca-api in your [widget generator](https://githu
 * [`proca org delete`](#proca-org-delete)
 * [`proca org email`](#proca-org-email)
 * [`proca org get`](#proca-org-get)
+* [`proca org user get`](#proca-org-user-get)
 * [`proca plugins`](#proca-plugins)
-* [`proca plugins:install PLUGIN...`](#proca-pluginsinstall-plugin)
+* [`proca plugins add PLUGIN`](#proca-plugins-add-plugin)
 * [`proca plugins:inspect PLUGIN...`](#proca-pluginsinspect-plugin)
-* [`proca plugins:install PLUGIN...`](#proca-pluginsinstall-plugin)
-* [`proca plugins:link PLUGIN`](#proca-pluginslink-plugin)
-* [`proca plugins:uninstall PLUGIN...`](#proca-pluginsuninstall-plugin)
-* [`proca plugins:uninstall PLUGIN...`](#proca-pluginsuninstall-plugin)
-* [`proca plugins:uninstall PLUGIN...`](#proca-pluginsuninstall-plugin)
+* [`proca plugins install PLUGIN`](#proca-plugins-install-plugin)
+* [`proca plugins link PATH`](#proca-plugins-link-path)
+* [`proca plugins remove [PLUGIN]`](#proca-plugins-remove-plugin)
+* [`proca plugins reset`](#proca-plugins-reset)
+* [`proca plugins uninstall [PLUGIN]`](#proca-plugins-uninstall-plugin)
+* [`proca plugins unlink [PLUGIN]`](#proca-plugins-unlink-plugin)
 * [`proca plugins update`](#proca-plugins-update)
 * [`proca service add`](#proca-service-add)
 * [`proca service list`](#proca-service-list)
@@ -101,15 +105,16 @@ you should also use the local proca-api in your [widget generator](https://githu
 * [`proca widget delete`](#proca-widget-delete)
 * [`proca widget get`](#proca-widget-get)
 * [`proca widget list`](#proca-widget-list)
+* [`proca widget rebuild`](#proca-widget-rebuild)
 
 ## `proca action add`
 
 ```
 USAGE
-  $ proca action add -i <value> --firstname <value> --email <value> [--json | --human |
-    --csv | --markdown] [--env <value>] [--simplify] [-x <value>] [-n <the_short_name>] [--testing] [--optin]
-    [--action_type <value>] [--lastname <value>] [--street <value>] [--locality <value>] [--region <value>] [--country
-    <value>] [--utm <value>] [--target <value>] [--subject <value>] [--body <value>]
+  $ proca action add [ID_NAME_DXID...] -i <value> --firstname <value> --email <value>
+    [--json | --human | --csv | --markdown] [--env <value>] [--simplify] [-x <value>] [-n <the_short_name>] [--testing]
+    [--optin] [--action_type <value>] [--lastname <value>] [--street <value>] [--locality <value>] [--region <value>]
+    [--country <value>] [--utm <value>] [--target <value>] [--subject <value>] [--body <value>]
 
 FLAGS
   -i, --id=<value>             (required) widget's id
@@ -181,8 +186,8 @@ counter of actions
 
 ```
 USAGE
-  $ proca action count [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
+  $ proca action count [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
 
 FLAGS
   -i, --id=<value>
@@ -215,7 +220,7 @@ USAGE
     [--testing] [--doi] [--utm | --simplify] [--comment | ]
 
 ARGUMENTS
-  [TITLE]  name of the campaign, % for wildchar
+  TITLE  name of the campaign, % for wildchar
 
 FLAGS
   -c, --campaign=<campaign name>  name of the campaign, % for wildchar
@@ -311,7 +316,7 @@ USAGE
     | --markdown] [--env <value>] [--simplify]
 
 ARGUMENTS
-  [TITLE]  title of the campaign
+  TITLE  title of the campaign
 
 FLAGS
   -n, --name=<campaign name>  (required) name of the campaign
@@ -333,12 +338,12 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca campaign close --status draft|live|closed|ignored [--json | --human | --csv |
-    --markdown] [--env <value>] [--simplify]
+  $ proca campaign close [ID_NAME_DXID] --status draft|live|closed|ignored [--json |
+    --human | --csv | --markdown] [--env <value>] [--simplify]
 
 FLAGS
   --env=<value>      [default: default] allow to switch between configurations (server or users)
-  --status=<option>  (required) [env: [object Object]] Status to set
+  --status=<option>  (required) Status to set
                      <options: draft|live|closed|ignored>
 
 OUTPUT FLAGS
@@ -391,8 +396,8 @@ view a campaign
 
 ```
 USAGE
-  $ proca campaign get [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--config] [--stats] [--locale <value>]
+  $ proca campaign get [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--config] [--stats] [--locale <value>]
 
 FLAGS
   -i, --id=<value>
@@ -427,7 +432,7 @@ USAGE
     [--simplify] [-o <organisation name>] [-t <campaign title>] [--stats]
 
 ARGUMENTS
-  [TITLE]  name of the campaign, % for wildchar
+  TITLE  name of the campaign, % for wildchar
 
 FLAGS
   -o, --org=<organisation name>  campaigns of the organisation (coordinator or partner)
@@ -455,9 +460,9 @@ set the mail to target (mtt) params
 
 ```
 USAGE
-  $ proca campaign mtt [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--from <value>] [--to <value>] [--template <value>]
-    [--period <value>] [--email <value>] [--cc <value>] [--sender] [--drip]
+  $ proca campaign mtt [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--from <value>] [--to <value>] [--template
+    <value>] [--period <value>] [--email <value>] [--cc <value>] [--sender] [--drip]
 
 FLAGS
   -i, --id=<value>
@@ -491,12 +496,12 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca campaign status --status draft|live|closed|ignored [--json | --human | --csv |
-    --markdown] [--env <value>] [--simplify]
+  $ proca campaign status [ID_NAME_DXID] --status draft|live|closed|ignored [--json |
+    --human | --csv | --markdown] [--env <value>] [--simplify]
 
 FLAGS
   --env=<value>      [default: default] allow to switch between configurations (server or users)
-  --status=<option>  (required) [env: [object Object]] Status to set
+  --status=<option>  (required) Status to set
                      <options: draft|live|closed|ignored>
 
 OUTPUT FLAGS
@@ -515,6 +520,61 @@ EXAMPLES
   $ proca campaign status -i <campaign_id>
 ```
 
+## `proca campaign widget get`
+
+List widgets in a campaign
+
+```
+USAGE
+  $ proca campaign widget get [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
+
+FLAGS
+  -i, --id=<value>
+  -n, --name=<the_short_name>  name
+  -x, --dxid=<value>           dxid
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --markdown       Format output as markdown table
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+DESCRIPTION
+  List widgets in a campaign
+```
+
+## `proca campaign widget rebuild`
+
+(re)build all the widgets of a campaign
+
+```
+USAGE
+  $ proca campaign widget rebuild [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
+
+FLAGS
+  -i, --id=<value>
+  -n, --name=<the_short_name>  name
+  -x, --dxid=<value>           dxid
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --markdown       Format output as markdown table
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+DESCRIPTION
+  (re)build all the widgets of a campaign
+
+EXAMPLES
+  $ proca-cli campaign widget rebuild climate-action
+```
+
 ## `proca config add [ENV] [HUMAN] [JSON] [CSV] [MARKDOWN] [SIMPLIFY]`
 
 create setting to access to a server
@@ -526,12 +586,12 @@ USAGE
     you@example.org] [--folder /var/www/proca/config.example]
 
 ARGUMENTS
-  [ENV]       [default: default] allow to switch between configurations (server or users)
-  [HUMAN]     [default: true] Format output to be read on screen by a human [default]
-  [JSON]      Format output as json
-  [CSV]       Format output as csv
-  [MARKDOWN]  Format output as markdown table
-  [SIMPLIFY]  flatten and filter to output only the most important attributes, mostly relevant for json
+  ENV       [default: default] allow to switch between configurations (server or users)
+  HUMAN     [default: true] Format output to be read on screen by a human [default]
+  JSON      Format output as json
+  CSV       Format output as csv
+  MARKDOWN  Format output as markdown table
+  SIMPLIFY  flatten and filter to output only the most important attributes, mostly relevant for json
 
 FLAGS
   --email=you@example.org                 user email on proca server
@@ -594,12 +654,12 @@ USAGE
     you@example.org] [--folder /var/www/proca/config.example]
 
 ARGUMENTS
-  [ENV]       [default: default] allow to switch between configurations (server or users)
-  [HUMAN]     [default: true] Format output to be read on screen by a human [default]
-  [JSON]      Format output as json
-  [CSV]       Format output as csv
-  [MARKDOWN]  Format output as markdown table
-  [SIMPLIFY]  flatten and filter to output only the most important attributes, mostly relevant for json
+  ENV       [default: default] allow to switch between configurations (server or users)
+  HUMAN     [default: true] Format output to be read on screen by a human [default]
+  JSON      Format output as json
+  CSV       Format output as csv
+  MARKDOWN  Format output as markdown table
+  SIMPLIFY  flatten and filter to output only the most important attributes, mostly relevant for json
 
 FLAGS
   --email=you@example.org                 user email on proca server
@@ -659,8 +719,8 @@ USAGE
     <value>] [--simplify] [--environment <value>] [--url <url>] [--token <API-token>]
 
 ARGUMENTS
-  [KEY]    variable name
-  [VALUE]  value
+  KEY    variable name
+  VALUE  value
 
 FLAGS
   --env=<value>          [default: default] allow to switch between configurations (server or users)
@@ -698,12 +758,12 @@ USAGE
     you@example.org] [--folder /var/www/proca/config.example]
 
 ARGUMENTS
-  [ENV]       [default: default] allow to switch between configurations (server or users)
-  [HUMAN]     [default: true] Format output to be read on screen by a human [default]
-  [JSON]      Format output as json
-  [CSV]       Format output as csv
-  [MARKDOWN]  Format output as markdown table
-  [SIMPLIFY]  flatten and filter to output only the most important attributes, mostly relevant for json
+  ENV       [default: default] allow to switch between configurations (server or users)
+  HUMAN     [default: true] Format output to be read on screen by a human [default]
+  JSON      Format output as json
+  CSV       Format output as csv
+  MARKDOWN  Format output as markdown table
+  SIMPLIFY  flatten and filter to output only the most important attributes, mostly relevant for json
 
 FLAGS
   --email=you@example.org                 user email on proca server
@@ -766,8 +826,8 @@ counter of supporters
 
 ```
 USAGE
-  $ proca contact count [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
+  $ proca contact count [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
 
 FLAGS
   -i, --id=<value>
@@ -800,7 +860,7 @@ USAGE
     [--doi] [--utm | --simplify] [--comment | ]
 
 ARGUMENTS
-  [TITLE]  name of the campaign, % for wildchar
+  TITLE  name of the campaign, % for wildchar
 
 FLAGS
   -c, --campaign=<campaign title>  name of the campaign, % for wildchar
@@ -835,7 +895,7 @@ USAGE
   $ proca help [COMMAND...] [-n]
 
 ARGUMENTS
-  [COMMAND...]  Command to show help for.
+  COMMAND...  Command to show help for.
 
 FLAGS
   -n, --nested-commands  Include all nested commands in the output.
@@ -901,8 +961,8 @@ DESCRIPTION
 
 ```
 USAGE
-  $ proca org delete [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <org name> | -x <value>]
+  $ proca org delete [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <org name> | -x <value>]
 
 FLAGS
   -i, --id=<value>
@@ -927,8 +987,9 @@ Set service, usually email backend for an org
 
 ```
 USAGE
-  $ proca org email --org <value> --mailer mailjet ses stripe test_stripe system
-    preview webhook supabase smtp [--json | --human | --csv | --markdown] [--env <value>] [--simplify] [--from <value>]
+  $ proca org email [ID_NAME_DXID] --org <value> --mailer mailjet ses stripe
+    test_stripe system preview webhook supabase smtp [--json | --human | --csv | --markdown] [--env <value>]
+    [--simplify] [--from <value>]
 
 FLAGS
   --env=<value>                                                                 [default: default] allow to switch
@@ -957,8 +1018,8 @@ view a org
 
 ```
 USAGE
-  $ proca org get [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-n <org name>] [--config] [--personaldata] [--processing] [--keys] [--campaigns] [--users]
+  $ proca org get [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-n <org name>] [--config] [--personaldata] [--processing] [--keys] [--campaigns] [--users]
 
 FLAGS
   -n, --name=<org name>    name of the org
@@ -984,6 +1045,36 @@ EXAMPLES
   $ proca org get <name of the ngo>
 ```
 
+## `proca org user get`
+
+list all the users
+
+```
+USAGE
+  $ proca org user get -o <value> [--json | --human | --csv | --markdown] [--env <value>]
+    [--simplify]
+
+FLAGS
+  -o, --org=<value>  (required) organisation
+      --env=<value>  [default: default] allow to switch between configurations (server or users)
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --markdown       Format output as markdown table
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+DESCRIPTION
+  list all the users
+
+ALIASES
+  $ proca org user get
+
+EXAMPLES
+  $ proca org user get %pizza%
+```
+
 ## `proca plugins`
 
 List installed plugins.
@@ -1005,44 +1096,53 @@ EXAMPLES
   $ proca plugins
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.0/src/commands/plugins/index.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/index.ts)_
 
-## `proca plugins:install PLUGIN...`
+## `proca plugins add PLUGIN`
 
-Installs a plugin into the CLI.
+Installs a plugin into proca.
 
 ```
 USAGE
-  $ proca plugins add plugins:install PLUGIN...
+  $ proca plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
 
 ARGUMENTS
   PLUGIN...  Plugin to install.
 
 FLAGS
-  -f, --force    Run yarn install with force flag.
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
   -h, --help     Show CLI help.
-  -v, --verbose
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  Installs a plugin into the CLI.
-  Can be installed from npm or a git url.
+  Installs a plugin into proca.
 
-  Installation of a user-installed plugin will override a core plugin.
+  Uses npm to install plugins.
 
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
-  the CLI without the need to patch and update the whole CLI.
+  Installation of a user-installed plugin will override a core plugin.
 
+  Use the PROCA_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the PROCA_NPM_REGISTRY environment variable to set the npm registry.
 
 ALIASES
   $ proca plugins add
 
 EXAMPLES
-  $ proca plugins:install myplugin 
+  Install a plugin from npm registry.
+
+    $ proca plugins add myplugin
 
-  $ proca plugins:install https://github.com/someuser/someplugin
+  Install a plugin from a github url.
 
-  $ proca plugins:install someuser/someplugin
+    $ proca plugins add https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ proca plugins add someuser/someplugin
 ```
 
 ## `proca plugins:inspect PLUGIN...`
@@ -1067,68 +1167,79 @@ DESCRIPTION
   Displays installation properties of a plugin.
 
 EXAMPLES
-  $ proca plugins:inspect myplugin
+  $ proca plugins inspect myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.0/src/commands/plugins/inspect.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/inspect.ts)_
 
-## `proca plugins:install PLUGIN...`
+## `proca plugins install PLUGIN`
 
-Installs a plugin into the CLI.
+Installs a plugin into proca.
 
 ```
 USAGE
-  $ proca plugins install PLUGIN...
+  $ proca plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
 
 ARGUMENTS
   PLUGIN...  Plugin to install.
 
 FLAGS
-  -f, --force    Run yarn install with force flag.
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
   -h, --help     Show CLI help.
-  -v, --verbose
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
 
 DESCRIPTION
-  Installs a plugin into the CLI.
-  Can be installed from npm or a git url.
+  Installs a plugin into proca.
 
-  Installation of a user-installed plugin will override a core plugin.
+  Uses npm to install plugins.
 
-  e.g. If you have a core plugin that has a 'hello' command, installing a user-installed plugin with a 'hello' command
-  will override the core plugin implementation. This is useful if a user needs to update core plugin functionality in
-  the CLI without the need to patch and update the whole CLI.
+  Installation of a user-installed plugin will override a core plugin.
 
+  Use the PROCA_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the PROCA_NPM_REGISTRY environment variable to set the npm registry.
 
 ALIASES
   $ proca plugins add
 
 EXAMPLES
-  $ proca plugins:install myplugin 
+  Install a plugin from npm registry.
 
-  $ proca plugins:install https://github.com/someuser/someplugin
+    $ proca plugins install myplugin
 
-  $ proca plugins:install someuser/someplugin
+  Install a plugin from a github url.
+
+    $ proca plugins install https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ proca plugins install someuser/someplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.0/src/commands/plugins/install.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/install.ts)_
 
-## `proca plugins:link PLUGIN`
+## `proca plugins link PATH`
 
 Links a plugin into the CLI for development.
 
 ```
 USAGE
-  $ proca plugins link PLUGIN
+  $ proca plugins link PATH [-h] [--install] [-v]
 
 ARGUMENTS
   PATH  [default: .] path to plugin
 
 FLAGS
-  -h, --help     Show CLI help.
+  -h, --help          Show CLI help.
   -v, --verbose
+      --[no-]install  Install dependencies after linking the plugin.
 
 DESCRIPTION
   Links a plugin into the CLI for development.
+
   Installation of a linked plugin will override a user-installed or core plugin.
 
   e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
@@ -1136,21 +1247,21 @@ DESCRIPTION
 
 
 EXAMPLES
-  $ proca plugins:link myplugin
+  $ proca plugins link myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.0/src/commands/plugins/link.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/link.ts)_
 
-## `proca plugins:uninstall PLUGIN...`
+## `proca plugins remove [PLUGIN]`
 
 Removes a plugin from the CLI.
 
 ```
 USAGE
-  $ proca plugins remove plugins:uninstall PLUGIN...
+  $ proca plugins remove [PLUGIN...] [-h] [-v]
 
 ARGUMENTS
-  [PLUGIN]  plugin to uninstall
+  PLUGIN...  plugin to uninstall
 
 FLAGS
   -h, --help     Show CLI help.
@@ -1162,18 +1273,36 @@ DESCRIPTION
 ALIASES
   $ proca plugins unlink
   $ proca plugins remove
+
+EXAMPLES
+  $ proca plugins remove myplugin
 ```
 
-## `proca plugins:uninstall PLUGIN...`
+## `proca plugins reset`
+
+Remove all user-installed and linked plugins.
+
+```
+USAGE
+  $ proca plugins reset [--hard] [--reinstall]
+
+FLAGS
+  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
+  --reinstall  Reinstall all plugins after uninstalling.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/reset.ts)_
+
+## `proca plugins uninstall [PLUGIN]`
 
 Removes a plugin from the CLI.
 
 ```
 USAGE
-  $ proca plugins uninstall PLUGIN...
+  $ proca plugins uninstall [PLUGIN...] [-h] [-v]
 
 ARGUMENTS
-  [PLUGIN]  plugin to uninstall
+  PLUGIN...  plugin to uninstall
 
 FLAGS
   -h, --help     Show CLI help.
@@ -1185,20 +1314,23 @@ DESCRIPTION
 ALIASES
   $ proca plugins unlink
   $ proca plugins remove
+
+EXAMPLES
+  $ proca plugins uninstall myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.0/src/commands/plugins/uninstall.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/uninstall.ts)_
 
-## `proca plugins:uninstall PLUGIN...`
+## `proca plugins unlink [PLUGIN]`
 
 Removes a plugin from the CLI.
 
 ```
 USAGE
-  $ proca plugins unlink plugins:uninstall PLUGIN...
+  $ proca plugins unlink [PLUGIN...] [-h] [-v]
 
 ARGUMENTS
-  [PLUGIN]  plugin to uninstall
+  PLUGIN...  plugin to uninstall
 
 FLAGS
   -h, --help     Show CLI help.
@@ -1210,6 +1342,9 @@ DESCRIPTION
 ALIASES
   $ proca plugins unlink
   $ proca plugins remove
+
+EXAMPLES
+  $ proca plugins unlink myplugin
 ```
 
 ## `proca plugins update`
@@ -1228,7 +1363,7 @@ DESCRIPTION
   Update installed plugins.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v3.1.0/src/commands/plugins/update.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/update.ts)_
 
 ## `proca service add`
 
@@ -1496,6 +1631,9 @@ OUTPUT FLAGS
 DESCRIPTION
   list all the users
 
+ALIASES
+  $ proca org user get
+
 EXAMPLES
   $ proca user list %pizza%
 ```
@@ -1540,7 +1678,7 @@ USAGE
     [--simplify] [--password <value>] [--url <value>]
 
 ARGUMENTS
-  [USER]  Username (email)
+  USER  Username (email)
 
 FLAGS
   --env=<value>       [default: default] allow to switch between configurations (server or users)
@@ -1617,8 +1755,8 @@ Delete a widget
 
 ```
 USAGE
-  $ proca widget delete [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
+  $ proca widget delete [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
 
 FLAGS
   -i, --id=<value>
@@ -1643,8 +1781,8 @@ view a widget
 
 ```
 USAGE
-  $ proca widget get [--json | --human | --csv | --markdown] [--env <value>]
-    [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--config]
+  $ proca widget get [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--config]
 
 FLAGS
   -i, --id=<value>
@@ -1662,9 +1800,6 @@ OUTPUT FLAGS
 
 DESCRIPTION
   view a widget
-
-EXAMPLES
-  $ proca widget get <path of the widget>
 ```
 
 ## `proca widget list`
@@ -1695,4 +1830,39 @@ DESCRIPTION
 EXAMPLES
   $ proca widget list -o <organisation>
 ```
+
+## `proca widget rebuild`
+
+(re)build a widget
+
+```
+USAGE
+  $ proca widget rebuild [ID_NAME_DXID] [--json | --human | --csv | --markdown] [--env
+    <value>] [--simplify] [-i <value> | -n <the_short_name> | -x <value>]
+
+FLAGS
+  -i, --id=<value>
+  -n, --name=<the_short_name>  name
+  -x, --dxid=<value>           dxid
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --markdown       Format output as markdown table
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+DESCRIPTION
+  (re)build a widget
+
+EXAMPLES
+  $ proca widget rebuild 42
+
+  $ proca widget rebuild climate-action/my-org/en
+
+  SEE ALSO:
+
+  $ proca campaign widget rebuild   Rebuild all the widgets of a campaign
+```
 <!-- commandsstop -->

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "proca",
   "description": "Access the proca api",
-  "version": "1.7.8",
+  "version": "1.8.2",
   "author": "Xavier",
   "bin": {
     "proca": "proca-cli"
@@ -18,9 +18,10 @@
     "easy-table": "^1.2.0",
     "fast-csv": "^5.0.1",
     "graphql": "^16.10.0",
+    "merge-anything": "^6.0.6",
+    "prompts": "^2.4.2",
     "typescript": "^5.7.3",
-    "urql": "^4.1.0",
-    "prompts": "^2.4.2"
+    "urql": "^4.1.0"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.3",

package/src/commands/campaign/widget/get.mjs

@@ -0,0 +1,19 @@
+import Command from "#src/procaCommand.mjs";
+import WidgetList from "../../widget/list.mjs";
+
+export default class CampaignWidgetList extends Command {
+  static description = "List widgets in a campaign";
+  static args = this.multiid();
+
+  static flags = {
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: true }),
+  };
+
+  async run() {
+    const { flags } = await this.parse();
+
+    // Delegate to widget list, but with campaign pre-filled
+    await WidgetList.run(["--campaign", flags.name], this.config);
+  }
+}

package/src/commands/campaign/widget/index.mjs

@@ -0,0 +1,17 @@
+import { Command } from "@oclif/core";
+
+export default class CampaignWidget extends Command {
+  static description = "commands for multiple widgets in a campaign";
+  static aliases = ["campaign:widget"];
+  static hidden = true; // Hide from command list, only show as topic
+
+  static id = "campaign:widget";
+
+  async run() {
+    const { Help } = await import("@oclif/core");
+    const help = new Help(this.config, { all: true });
+    const formatted = help.formatCommand(this);
+    this.log(formatted);
+    //    this.error("Please specify a subcommand, run with --help to list them");
+  }
+}

package/src/commands/campaign/widget/rebuild.mjs

@@ -0,0 +1,50 @@
+import WidgetList from "#src/commands/widget/list.mjs";
+import WidgetRebuild from "#src/commands/widget/rebuild.mjs";
+import Command from "#src/procaCommand.mjs";
+
+export default class CampaignWidgetRebuild extends Command {
+  static description = "(re)build all the widgets of a campaign";
+
+  static examples = ["$ proca-cli campaign widget rebuild climate-action"];
+
+  static args = this.multiid();
+
+  static flags = {
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: true }),
+    //    dryRun: Flags.boolean({
+    //      description: 'Show what would be rebuilt without actually doing it',
+    //    }),
+  };
+
+  simplify = (d) => {
+    d.location = undefined;
+    d.config = undefined;
+    d.org = d.org.name;
+    return d;
+  };
+
+  table = (r) => {
+    super.table(r, null, null);
+  };
+
+  rebuild = async (props) => {
+    const wapi = new WidgetList();
+    const rebuildapi = new WidgetRebuild();
+    wapi.flags.config = true; //we need to fetch each widget config
+    const widgets = await wapi.fetchCampaign(props.name); //list all widgets
+    const result = [];
+    for (const widget of widgets) {
+      // do not process all widgets in parallel but in sequence
+      const r = await rebuildapi.rebuild({ widget });
+      result.push(r);
+    }
+    return result;
+  };
+
+  async run() {
+    const { flags } = await this.parse();
+    const r = await this.rebuild(flags);
+    return this.output(r);
+  }
+}

package/src/commands/contact/count.mjs

@@ -3,21 +3,21 @@ import Command from "#src/procaCommand.mjs";
 import { gql, query } from "#src/urql.mjs";
 
 export default class CounterGet extends Command {
-	static description = "counter of supporters";
+  static description = "counter of supporters";
 
-	static examples = [
-		"<%= config.bin %> <%= command.id %> --id <id of the campaign>",
-		"<%= config.bin %> <%= command.id %> --name <name of the campaign>",
-	];
+  static examples = [
+    "<%= config.bin %> <%= command.id %> --id <id of the campaign>",
+    "<%= config.bin %> <%= command.id %> --name <name of the campaign>",
+  ];
 
-	static args = this.multiid();
-	static flags = {
-		// flag with no value (-f, --force)
-		...this.flagify({ multiid: true }),
-	};
+  static args = this.multiid();
+  static flags = {
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: true }),
+  };
 
-	fetch = async (params) => {
-		const GetCounterDocument = gql`
+  fetch = async (params) => {
+    const GetCounterDocument = gql`
       query GetCounter($name: String, $id: Int) {
         campaign(name: $name, id: $id) {
           stats {
@@ -26,17 +26,17 @@ export default class CounterGet extends Command {
         }
       }
     `;
-		const result = await query(GetCounterDocument, params);
-		return result.campaign.stats;
-	};
+    const result = await query(GetCounterDocument, params);
+    return result.campaign.stats;
+  };
 
-	table = (r) => {
-		super.table(r, null, null);
-	};
+  table = (r) => {
+    super.table(r, null, null);
+  };
 
-	async run() {
-		const { args, flags } = await this.parse();
-		const data = await this.fetch(flags);
-		return this.output(data);
-	}
+  async run() {
+    const { args, flags } = await this.parse();
+    const data = await this.fetch(flags);
+    return this.output(data);
+  }
 }

package/src/commands/org/get.mjs

@@ -101,9 +101,7 @@ export default class OrgGet extends Command {
       withPersonalData: params.personaldata,
       $withProcessing: params.processing,
     });
-    if (result.org.config) {
-      result.org.config = JSON.parse(result.org.config);
-    }
+    result.org.config = JSON.parse(result.org.config);
     return result.org;
   };
 
@@ -131,7 +129,6 @@ export default class OrgGet extends Command {
   };
 
   table = (r) => {
-    r.config = JSON.parse(r.config);
     super.table(r, null, null);
     if (this.flags.config) {
       r.config.locales = undefined;

package/src/commands/user/list.mjs

@@ -1,5 +1,4 @@
-import { Args, Flags } from "@oclif/core";
-import { error, stdout, ux } from "@oclif/core/ux";
+import { Flags } from "@oclif/core";
 import Command from "#src/procaCommand.mjs";
 import { gql, query } from "#src/urql.mjs";
 
@@ -9,6 +8,7 @@ export default class UserList extends Command {
   static description = "list all the users";
 
   static examples = ["<%= config.bin %> <%= command.id %> %pizza%"];
+  static aliases = ["org:user:get"];
 
   static flags = {
     // flag with no value (-f, --force)

package/src/commands/widget/get.mjs

@@ -1,29 +1,25 @@
-import { Args, Flags } from "@oclif/core";
-import { error, stdout, ux } from "@oclif/core/ux";
+import { Flags } from "@oclif/core";
 import Command from "#src/procaCommand.mjs";
 import { FragmentSummary } from "#src/queries/widget.mjs";
 import { gql, query } from "#src/urql.mjs";
 
 export default class WidgetGet extends Command {
-	static description = "view a widget";
+  static description = "view a widget";
 
-	static examples = [
-		"<%= config.bin %> <%= command.id %> <path of the widget>",
-	];
-	static args = this.multiid();
+  static args = this.multiid();
 
-	static flags = {
-		// flag with no value (-f, --force)
-		...this.flagify({ multiid: true }),
-		config: Flags.boolean({
-			description: "display the config",
-			default: true,
-			allowNo: true,
-		}),
-	};
+  static flags = {
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: true }),
+    config: Flags.boolean({
+      description: "display the config",
+      default: true,
+      allowNo: true,
+    }),
+  };
 
-	fetch = async (params) => {
-		const GetWidgetDocument = gql`
+  fetch = async (params) => {
+    const GetWidgetDocument = gql`
       query GetWidget($name: String, $id: Int, $config: Boolean = true) {
         actionPage(name: $name, id: $id) {
           ...Summary
@@ -39,21 +35,21 @@ export default class WidgetGet extends Command {
       }
       ${FragmentSummary}
     `;
-		const result = await query(GetWidgetDocument, params);
-		return result.actionPage;
-	};
+    const result = await query(GetWidgetDocument, params);
+    result.actionPage.config = JSON.parse(result.actionPage.config);
+    return result.actionPage;
+  };
 
-	table = (r) => {
-		super.table(r, null, null);
-		if (this.flags.config) {
-			r.config = JSON.parse(r.config);
-			this.prettyJson(r.config);
-		}
-	};
+  table = (r) => {
+    super.table(r, null, null);
+    if (this.flags.config) {
+      this.prettyJson(r.config);
+    }
+  };
 
-	async run() {
-		const { args, flags } = await this.parse();
-		const data = await this.fetch(flags);
-		return this.output(data);
-	}
+  async run() {
+    const { args, flags } = await this.parse();
+    const data = await this.fetch(flags);
+    return this.output(data);
+  }
 }

package/src/commands/widget/list.mjs

@@ -1,38 +1,40 @@
-import { Args, Flags } from "@oclif/core";
+import { Args, Flags, Help } from "@oclif/core";
 import { error, stdout, ux } from "@oclif/core/ux";
 import Command from "#src/procaCommand.mjs";
 import { FragmentSummary, FragmentSummaryOrg } from "#src/queries/widget.mjs";
 import { gql, query } from "#src/urql.mjs";
 
 export default class WidgetList extends Command {
-	static description = "list all the widgets of an org or campaign";
+  static description = "list all the widgets of an org or campaign";
 
-	static examples = ["<%= config.bin %> <%= command.id %> -o <organisation>"];
+  static examples = ["<%= config.bin %> <%= command.id %> -o <organisation>"];
 
-	static flags = {
-		// flag with no value (-f, --force)
-		...super.globalFlags,
-		org: Flags.string({
-			char: "o",
-			exactlyOne: ["campaign", "org"],
-			description: "widgets of the organisation (coordinator or partner)",
-			helpValue: "<organisation name>",
-			//      required: true,
-		}),
-		campaign: Flags.string({
-			char: "c",
-			description: "widgets of the campaign (coordinator or partner)",
-			helpValue: "<campaign name>",
-			//      required: true,
-		}),
-		config: Flags.boolean({
-			description: "get the config",
-			default: false,
-			allowNo: true,
-		}),
-	};
-	fetchCampaign = async (name) => {
-		const Document = gql`
+  //  static aliases = ["campaign:widget:get", "org:widget:get"]; let's rewrite them for better aliasing
+
+  static flags = {
+    // flag with no value (-f, --force)
+    ...super.globalFlags,
+    org: Flags.string({
+      char: "o",
+      //      exactlyOne: ["campaign", "org"], actually, we can filter on both
+      description: "widgets of the organisation (coordinator or partner)",
+      helpValue: "<organisation name>",
+      //      required: true,
+    }),
+    campaign: Flags.string({
+      char: "c",
+      description: "widgets of the campaign (coordinator or partner)",
+      helpValue: "<campaign name>",
+      //      required: true,
+    }),
+    config: Flags.boolean({
+      description: "get the config",
+      default: false,
+      allowNo: true,
+    }),
+  };
+  fetchCampaign = async (name) => {
+    const Document = gql`
 query SearchWidgets($campaign: String!, $withConfig: Boolean!) {
   campaign (name:$campaign) { ...on PrivateCampaign {
     actionPages {
@@ -47,15 +49,20 @@ query SearchWidgets($campaign: String!, $withConfig: Boolean!) {
   }
 ${FragmentSummary}
 }`;
-		const result = await query(Document, {
-			campaign: name,
-			withConfig: this.flags.config,
-		});
-		return result.campaign.actionPages;
-	};
+    const result = await query(Document, {
+      campaign: name,
+      withConfig: this.flags.config,
+    });
+    if (this.flags.org) {
+      return result.campaign.actionPages.filter(
+        (d) => d.org.name === this.flags.org,
+      );
+    }
+    return result.campaign.actionPages;
+  };
 
-	fetchOrg = async (name) => {
-		const Document = gql`
+  fetchOrg = async (name) => {
+    const Document = gql`
 query SearchWidgets($org: String!, $withConfig: Boolean!) {
   org (name:$org) {
     actionPages {
@@ -70,53 +77,57 @@ query SearchWidgets($org: String!, $withConfig: Boolean!) {
   }
 ${FragmentSummaryOrg}
 }`;
-		const result = await query(Document, {
-			org: name,
-			withConfig: this.flags.config,
-		});
-		return result.org.actionPages;
-	};
+    const result = await query(Document, {
+      org: name,
+      withConfig: this.flags.config,
+    });
+    return result.org.actionPages;
+  };
 
-	simplify = (d) => {
-		const result = {
-			id: d.id,
-			name: d.name,
-			locale: d.locale,
-			status: d.status.toLowerCase(),
-			location: d.location?.startsWith("https://widget.proca.app")
-				? undefined
-				: d.location || undefined,
-			//			live: d.live,
+  simplify = (d) => {
+    const result = {
+      id: d.id,
+      name: d.name,
+      locale: d.locale,
+      status: d.status.toLowerCase(),
+      location: d.location?.startsWith("https://widget.proca.app")
+        ? undefined
+        : d.location || undefined,
+      //			live: d.live,
 
-			//      thankYouTemplate: d.thankYouTemplate || undefined,
-			//      thankYouTemplateRef: d.thankYouTemplateRef || undefined,
-			// supporterConfirmTemplate: d.supporterConfirmTemplate || undefined,
-		};
-		if (d.extraSupporters > 0) {
-			result.extra = d.extraSupporters;
-		}
-		//		if (d.journey) result.journey = d.journey.join(" → ");
-		if (d.org) {
-			result.org = d.org.name;
-			result.org_id = d.org.id;
-		}
-		if (d.campaign) {
-			result.campaign = d.campaign.name;
-		}
-		if (this.flags.config) {
-		}
-		return result;
-	};
+      //      thankYouTemplate: d.thankYouTemplate || undefined,
+      //      thankYouTemplateRef: d.thankYouTemplateRef || undefined,
+      // supporterConfirmTemplate: d.supporterConfirmTemplate || undefined,
+    };
+    if (d.extraSupporters > 0) {
+      result.extra = d.extraSupporters;
+    }
+    //		if (d.journey) result.journey = d.journey.join(" → ");
+    if (d.org) {
+      result.org = d.org.name;
+      result.org_id = d.org.id;
+    }
+    if (d.campaign) {
+      result.campaign = d.campaign.name;
+    }
+    if (this.flags.config) {
+    }
+    return result;
+  };
 
-	table = (r) => {
-		super.table(r, null, (table) => table.sort(["id|des"]).toString());
-	};
+  table = (r) => {
+    super.table(r, null, (table) => table.sort(["id|des"]).toString());
+  };
 
-	async run() {
-		const { flags, args } = await this.parse(WidgetList);
-		let data = [];
-		if (flags.org) data = await this.fetchOrg(flags.org);
-		if (flags.campaign) data = await this.fetchCampaign(flags.campaign);
-		return this.output(data);
-	}
+  async run() {
+    const { flags, args } = await this.parse(WidgetList);
+    let data = [];
+    if (!flags.org && !flags.campaign) {
+      const help = new Help(this.config);
+      this.error("Must specify --org or --campaign or --help for more");
+    }
+    if (flags.org) data = await this.fetchOrg(flags.org);
+    if (flags.campaign) data = await this.fetchCampaign(flags.campaign);
+    return this.output(data);
+  }
 }

package/src/commands/widget/rebuild.mjs

@@ -0,0 +1,64 @@
+import { Flags } from "@oclif/core";
+import { mergeAndConcat as merge } from "merge-anything";
+import WidgetGet from "#src/commands/widget/get.mjs";
+import Command from "#src/procaCommand.mjs";
+import { gql, mutation } from "#src/urql.mjs";
+
+export default class WidgetRebuild extends Command {
+  static description = "(re)build a widget";
+
+  static examples = [
+    "<%= config.bin %> widget rebuild 42",
+    "<%= config.bin %> widget rebuild climate-action/my-org/en",
+    "SEE ALSO:",
+    "<%= config.bin %> campaign widget rebuild   Rebuild all the widgets of a campaign",
+  ];
+
+  static args = this.multiid();
+
+  static flags = {
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: true }),
+  };
+
+  rebuild = async ({ widget, timestamp = new Date().toISOString() }) => {
+    //
+    const data = merge(widget, { config: { layout: { update: timestamp } } });
+
+    const PushWidgetDocument = gql`
+mutation updateActionPage($id: Int!, $config: Json!) {
+  updateActionPage(id: $id, input: {config:$config}) {
+    id, name, locale, config
+    ...on PrivateActionPage {
+      status
+      location
+      org {name}
+    }
+  }
+}
+    `;
+    const r = await mutation(PushWidgetDocument, {
+      id: data.id,
+      config: JSON.stringify(data.config),
+    });
+    if (r.errors) {
+      console.log(r);
+      console.log("check your config $npx proca config user");
+      throw new Error(r.errors[0].message || "can't update on the server");
+    }
+    r.updateActionPage.update = data.config.layout.update;
+    return r.updateActionPage;
+  };
+
+  table = (r) => {
+    super.table(r, null, null);
+  };
+
+  async run() {
+    const { flags } = await this.parse();
+    const wapi = new WidgetGet();
+    const widget = await wapi.fetch(flags);
+    const r = await this.rebuild({ widget });
+    return this.output(r);
+  }
+}