proca 1.2.2 → 1.4.0

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g proca
 $ proca COMMAND
 running command...
 $ proca (--version)
-proca/1.2.2 linux-x64 node-v20.12.2
+proca/1.4.0 linux-x64 node-v20.12.2
 $ proca --help [COMMAND]
 USAGE
   $ proca COMMAND
@@ -45,18 +45,20 @@ USAGE
 
 # Commands
 <!-- commands -->
+* [`proca action add`](#proca-action-add)
 * [`proca action count`](#proca-action-count)
 * [`proca action list [TITLE]`](#proca-action-list-title)
 * [`proca action replay`](#proca-action-replay)
 * [`proca campaign add [TITLE]`](#proca-campaign-add-title)
+* [`proca campaign close [TITLE]`](#proca-campaign-close-title)
 * [`proca campaign delete`](#proca-campaign-delete)
 * [`proca campaign get`](#proca-campaign-get)
 * [`proca campaign list [TITLE]`](#proca-campaign-list-title)
-* [`proca config add [ENVIRONMENT]`](#proca-config-add-environment)
-* [`proca config get`](#proca-config-get)
+* [`proca config add [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY]`](#proca-config-add-env-human-json-csv-simplify)
+* [`proca config init [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY]`](#proca-config-init-env-human-json-csv-simplify)
+* [`proca config server`](#proca-config-server)
 * [`proca config set [KEY] [VALUE]`](#proca-config-set-key-value)
-* [`proca config setup [ENVIRONMENT]`](#proca-config-setup-environment)
-* [`proca config token`](#proca-config-token)
+* [`proca config setup [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY]`](#proca-config-setup-env-human-json-csv-simplify)
 * [`proca config user`](#proca-config-user)
 * [`proca contact count`](#proca-contact-count)
 * [`proca contact list [TITLE]`](#proca-contact-list-title)
@@ -80,23 +82,61 @@ USAGE
 * [`proca user leave`](#proca-user-leave)
 * [`proca user list`](#proca-user-list)
 * [`proca widget add`](#proca-widget-add)
-* [`proca widget cache`](#proca-widget-cache)
 * [`proca widget get`](#proca-widget-get)
 * [`proca widget list`](#proca-widget-list)
 
+## `proca action add`
+
+```
+USAGE
+  $ proca action add [ID_NAME_DXID...] -i <value> --firstname <value> --email <value>
+    [--json | --human | --csv] [--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>]
+
+FLAGS
+  -i, --id=<value>             (required) widget's id
+  -n, --name=<the_short_name>  name
+  -x, --dxid=<value>           dxid
+      --action_type=<value>    [default: register]
+      --country=<value>        2-letter country iso code
+      --email=<value>          (required) email
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
+      --firstname=<value>      (required) supporter's firstname
+  --lastname=<value>
+  --locality=<value>
+  --optin
+  --region=<value>
+  --street=<value>
+  --testing
+      --utm=<value>            utm=campaign.source.medium
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+EXAMPLES
+  $ proca action add -i <widget_id> --firstname=John --email=john@example.org
+
+  $ proca action add -i <widget_id> --firstname=John --email=john@example.org --country=FR custom1=A custom2=B
+```
+
 ## `proca action count`
 
 counter of actions
 
 ```
 USAGE
-  $ proca action count [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
-    | -n <the_short_name> | -x <value>]
+  $ proca action count [ID_NAME_DXID] [--json | --human | --csv] [--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
@@ -117,9 +157,9 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca action list [TITLE] -o <organisation name> [--json | --human | --csv] [-c
-    <campaign title>] [--limit <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm |
-    --simplify] [--comment | ]
+  $ proca action list [TITLE] -o <organisation name> [--json | --human | --csv] [--env
+    <value>] [-c <campaign title>] [--limit <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm
+    | --simplify] [--comment | ]
 
 ARGUMENTS
   TITLE  name of the campaign, % for wildchar
@@ -130,6 +170,7 @@ FLAGS
       --after=2025-04-09           only actions after a date
       --[no-]comment               display the comment
       --doi                        only export the double optin actions
+      --env=<value>                [default: default] allow to switch between configurations (server or users)
       --limit=<value>              max number of actions
       --optin                      only export the optin actions
       --testing                    also export the test actions
@@ -150,12 +191,13 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca action replay -o <organisation name> [--json | --human | --csv] [--simplify] [-c
-    <campaign title>]
+  $ proca action replay -o <organisation name> [--json | --human | --csv] [--env <value>]
+    [--simplify] [-c <campaign title>]
 
 FLAGS
   -c, --campaign=<campaign title>  name of the campaign, % for wildchar
   -o, --org=<organisation name>    (required) campaigns of the organisation (coordinator or partner)
+      --env=<value>                [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -172,7 +214,7 @@ EXAMPLES
 ```
 USAGE
   $ proca campaign add [TITLE] -n <campaign name> -o <org name> [--json | --human |
-    --csv] [--simplify]
+    --csv] [--env <value>] [--simplify]
 
 ARGUMENTS
   TITLE  title of the campaign
@@ -180,6 +222,7 @@ ARGUMENTS
 FLAGS
   -n, --name=<campaign name>  (required) name of the campaign
   -o, --org=<org name>        (required) name of the coordinator
+      --env=<value>           [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -191,18 +234,46 @@ EXAMPLES
   $ proca campaign add -n <new_campaign> the full name of the campaign
 ```
 
+## `proca campaign close [TITLE]`
+
+```
+USAGE
+  $ proca campaign close [TITLE] -n <campaign name> -o <org name> --status
+    closed|ignored|live [--json | --human | --csv] [--env <value>] [--simplify]
+
+ARGUMENTS
+  TITLE  title of the campaign
+
+FLAGS
+  -n, --name=<campaign name>  (required) name of the campaign
+  -o, --org=<org name>        (required) name of the coordinator
+      --env=<value>           [default: default] allow to switch between configurations (server or users)
+      --status=<option>       (required) [default: closed] status
+                              <options: closed|ignored|live>
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+EXAMPLES
+  $ proca campaign close -name <campaign>
+```
+
 ## `proca campaign delete`
 
 delete a campaign
 
 ```
 USAGE
-  $ proca campaign delete [--json | --human | --csv] [--simplify] [-i <organisation name>]
-    [-n <campaign name>]
+  $ proca campaign delete [--json | --human | --csv] [--env <value>] [--simplify] [-i
+    <organisation name>] [-n <campaign name>]
 
 FLAGS
   -i, --id=<organisation name>  id of the campaign
   -n, --name=<campaign name>    name of the campaign
+      --env=<value>             [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -223,14 +294,15 @@ view a campaign
 
 ```
 USAGE
-  $ proca campaign get [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
-    | -n <the_short_name> | -x <value>] [--config] [--stats] [--locale <value>]
+  $ proca campaign get [ID_NAME_DXID] [--json | --human | --csv] [--env <value>]
+    [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--config] [--stats] [--locale <value>]
 
 FLAGS
   -i, --id=<value>
   -n, --name=<the_short_name>  name
   -x, --dxid=<value>           dxid
       --[no-]config            display the config
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
       --locale=<value>         display a locale
       --[no-]stats             display the stats
 
@@ -253,8 +325,8 @@ list all the campaigns
 
 ```
 USAGE
-  $ proca campaign list [TITLE] [--json | --human | --csv] [--simplify] [-o <organisation
-    name>] [-t <campaign title>] [--stats]
+  $ proca campaign list [TITLE] [--json | --human | --csv] [--env <value>] [--simplify]
+    [-o <organisation name>] [-t <campaign title>] [--stats]
 
 ARGUMENTS
   TITLE  name of the campaign, % for wildchar
@@ -262,6 +334,7 @@ ARGUMENTS
 FLAGS
   -o, --org=<organisation name>  campaigns of the organisation (coordinator or partner)
   -t, --title=<campaign title>   name of the campaign, % for wildchar
+      --env=<value>              [default: default] allow to switch between configurations (server or users)
       --[no-]stats               display the stats
 
 OUTPUT FLAGS
@@ -277,27 +350,27 @@ EXAMPLES
   $ proca campaign list %pizza%
 ```
 
-## `proca config add [ENVIRONMENT]`
+## `proca config add [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY]`
 
 create setting to access the server authentication
 
 ```
 USAGE
-  $ proca config add [ENVIRONMENT] --token <API-token> [--json | --human | --csv]
-    [--simplify] [--force] [--url <url>] [--n8n <n8n api>] [--supabase <url>] [--supabase-anon-key <value>]
-    [--supabase-secrey-key <value>]
+  $ proca config add [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY] --token <API-token> [--json
+    | --human | --csv] [--env <value>] [--simplify] [--force] [--url <url>]
 
 ARGUMENTS
-  ENVIRONMENT  [default: default] environment
+  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
+  SIMPLIFY  flatten and filter to output only the most important attributes, mostly relevant for json
 
 FLAGS
-  --force                        write over an existing configuration
-  --n8n=<n8n api>                api access on the n8n server
-  --supabase=<url>               url of the supabase
-  --supabase-anon-key=<value>    anonymous key
-  --supabase-secrey-key=<value>  secret service key
-  --token=<API-token>            (required) user token on proca server
-  --url=<url>                    [default: https://api.proca.app/api] url of the proca server api
+  --env=<value>        [default: default] allow to switch between configurations (server or users)
+  --force              write over an existing configuration
+  --token=<API-token>  (required) user token on proca server
+  --url=<url>          [default: https://api.proca.app/api] url of the proca server api
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -310,18 +383,61 @@ DESCRIPTION
 
 ALIASES
   $ proca config setup
+  $ proca config init
 
 EXAMPLES
   $ proca config add --user=xavier@example.org --token=API-12345789
 ```
 
-## `proca config get`
+## `proca config init [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY]`
+
+create setting to access the server authentication
+
+```
+USAGE
+  $ proca config init [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY] --token <API-token> [--json
+    | --human | --csv] [--env <value>] [--simplify] [--force] [--url <url>]
+
+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
+  SIMPLIFY  flatten and filter to output only the most important attributes, mostly relevant for json
+
+FLAGS
+  --env=<value>        [default: default] allow to switch between configurations (server or users)
+  --force              write over an existing configuration
+  --token=<API-token>  (required) user token on proca server
+  --url=<url>          [default: https://api.proca.app/api] url of the proca server api
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --human          Format output to be read on screen by a human [default]
+  --json           Format output as json
+  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+
+DESCRIPTION
+  create setting to access the server authentication
+
+ALIASES
+  $ proca config setup
+  $ proca config init
+
+EXAMPLES
+  $ proca config init --user=xavier@example.org --token=API-12345789
+```
+
+## `proca config server`
 
 get the server config
 
 ```
 USAGE
-  $ proca config get [--json | --human | --csv] [--simplify]
+  $ proca config server [--json | --human | --csv] [--env <value>] [--simplify]
+
+FLAGS
+  --env=<value>  [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -339,14 +455,15 @@ update the setting used to authenticate to the servers and services
 
 ```
 USAGE
-  $ proca config set [KEY] [VALUE] [--json | --human | --csv] [--simplify]
-    [--environment <value>] [--url <url>] [--token <API-token>]
+  $ proca config set [KEY] [VALUE] [--json | --human | --csv] [--env <value>]
+    [--simplify] [--environment <value>] [--url <url>] [--token <API-token>]
 
 ARGUMENTS
   KEY    variable name
   VALUE  value
 
 FLAGS
+  --env=<value>          [default: default] allow to switch between configurations (server or users)
   --environment=<value>  [default: default] environment
   --token=<API-token>    user token on proca server
   --url=<url>            [default: https://api.proca.app/api] url of the proca server api
@@ -369,27 +486,27 @@ EXAMPLES
   $ proca config set VAR1 VALUE
 ```
 
-## `proca config setup [ENVIRONMENT]`
+## `proca config setup [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY]`
 
 create setting to access the server authentication
 
 ```
 USAGE
-  $ proca config setup [ENVIRONMENT] --token <API-token> [--json | --human | --csv]
-    [--simplify] [--force] [--url <url>] [--n8n <n8n api>] [--supabase <url>] [--supabase-anon-key <value>]
-    [--supabase-secrey-key <value>]
+  $ proca config setup [ENV] [HUMAN] [JSON] [CSV] [SIMPLIFY] --token <API-token> [--json
+    | --human | --csv] [--env <value>] [--simplify] [--force] [--url <url>]
 
 ARGUMENTS
-  ENVIRONMENT  [default: default] environment
+  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
+  SIMPLIFY  flatten and filter to output only the most important attributes, mostly relevant for json
 
 FLAGS
-  --force                        write over an existing configuration
-  --n8n=<n8n api>                api access on the n8n server
-  --supabase=<url>               url of the supabase
-  --supabase-anon-key=<value>    anonymous key
-  --supabase-secrey-key=<value>  secret service key
-  --token=<API-token>            (required) user token on proca server
-  --url=<url>                    [default: https://api.proca.app/api] url of the proca server api
+  --env=<value>        [default: default] allow to switch between configurations (server or users)
+  --force              write over an existing configuration
+  --token=<API-token>  (required) user token on proca server
+  --url=<url>          [default: https://api.proca.app/api] url of the proca server api
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -402,39 +519,22 @@ DESCRIPTION
 
 ALIASES
   $ proca config setup
+  $ proca config init
 
 EXAMPLES
   $ proca config setup --user=xavier@example.org --token=API-12345789
 ```
 
-## `proca config token`
-
-convert between token and sql value
-
-```
-USAGE
-  $ proca config token [--json | --human | --csv] [--simplify] [--token API-xxx]
-
-FLAGS
-  --token=API-xxx  the token in your config
-
-OUTPUT FLAGS
-  --csv            Format output as csv
-  --human          Format output to be read on screen by a human [default]
-  --json           Format output as json
-  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
-
-DESCRIPTION
-  convert between token and sql value
-```
-
 ## `proca config user`
 
 fetch the information about the current user (based on the token)
 
 ```
 USAGE
-  $ proca config user [--json | --human | --csv] [--simplify]
+  $ proca config user [--json | --human | --csv] [--env <value>] [--simplify]
+
+FLAGS
+  --env=<value>  [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -455,13 +555,14 @@ counter of supporters
 
 ```
 USAGE
-  $ proca contact count [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
-    | -n <the_short_name> | -x <value>]
+  $ proca contact count [ID_NAME_DXID] [--json | --human | --csv] [--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
@@ -482,9 +583,9 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca contact list [TITLE] -o <organisation name> [--json | --human | --csv] [-c
-    <campaign title>] [-n <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm | --simplify]
-    [--comment | ]
+  $ proca contact list [TITLE] -o <organisation name> [--json | --human | --csv] [--env
+    <value>] [-c <campaign title>] [-n <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm |
+    --simplify] [--comment | ]
 
 ARGUMENTS
   TITLE  name of the campaign, % for wildchar
@@ -496,6 +597,7 @@ FLAGS
       --after=2025-04-09           only actions after a date
       --[no-]comment               display the comment
       --doi                        only export the double optin actions
+      --env=<value>                [default: default] allow to switch between configurations (server or users)
       --optin                      only export the optin actions
       --testing                    also export the test actions
       --today                      only actions today
@@ -535,11 +637,12 @@ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.2
 
 ```
 USAGE
-  $ proca org add [--json | --human | --csv] [--simplify] [--twitter <screen name>]
-    [-n <org name>]
+  $ proca org add [--json | --human | --csv] [--env <value>] [--simplify] [--twitter
+    <screen name>] [-n <org name>]
 
 FLAGS
   -n, --name=<org name>        name of the org
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
       --twitter=<screen name>  twitter account
 
 OUTPUT FLAGS
@@ -558,11 +661,12 @@ view a org crm synchroniser
 
 ```
 USAGE
-  $ proca org crm -n <org name> [--json | --human | --csv] [--simplify]
-    [--synchronize]
+  $ proca org crm -n <org name> [--json | --human | --csv] [--env <value>]
+    [--simplify] [--synchronize]
 
 FLAGS
   -n, --name=<org name>   (required) name of the org
+      --env=<value>       [default: default] allow to switch between configurations (server or users)
       --[no-]synchronize  enable or disable the synchronisation queue
 
 OUTPUT FLAGS
@@ -579,13 +683,14 @@ DESCRIPTION
 
 ```
 USAGE
-  $ proca org delete [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
-    | -n <org name> | -x <value>]
+  $ proca org delete [ID_NAME_DXID] [--json | --human | --csv] [--env <value>]
+    [--simplify] [-i <value> | -n <org name> | -x <value>]
 
 FLAGS
   -i, --id=<value>
   -n, --name=<org name>  name of the org
   -x, --dxid=<value>     dxid
+      --env=<value>      [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -603,13 +708,14 @@ view a org
 
 ```
 USAGE
-  $ proca org get [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-n <org
-    name>] [--config] [--keys] [--campaigns] [--widgets] [--users]
+  $ proca org get [ID_NAME_DXID] [--json | --human | --csv] [--env <value>]
+    [--simplify] [-n <org name>] [--config] [--keys] [--campaigns] [--widgets] [--users]
 
 FLAGS
   -n, --name=<org name>  name of the org
   --[no-]campaigns
       --[no-]config      display the config
+      --env=<value>      [default: default] allow to switch between configurations (server or users)
   --[no-]keys
   --[no-]users
   --[no-]widgets
@@ -633,11 +739,12 @@ let a user join an organisation with a role
 
 ```
 USAGE
-  $ proca org join -o <org name> [--json | --human | --csv] [--simplify] [--user
-    <value>] [--role owner|campaigner|coordinator|translator]
+  $ proca org join -o <org name> [--json | --human | --csv] [--env <value>]
+    [--simplify] [--user <value>] [--role owner|campaigner|coordinator|translator]
 
 FLAGS
   -o, --org=<org name>  (required) name of the org
+      --env=<value>     [default: default] allow to switch between configurations (server or users)
       --role=<option>   [default: campaigner] permission level in that org
                         <options: owner|campaigner|coordinator|translator>
       --user=<value>    user email
@@ -951,13 +1058,14 @@ fetch the information about a user
 
 ```
 USAGE
-  $ proca user get [--json | --human | --csv] [--simplify] [--email <value>] [-o <org
-    name>] [-i <value>]
+  $ proca user get [--json | --human | --csv] [--env <value>] [--simplify] [--email
+    <value>] [-o <org name>] [-i <value>]
 
 FLAGS
   -i, --id=<value>      id of the user
   -o, --org=<org name>  name of the org
       --email=<value>   user email
+      --env=<value>     [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -979,11 +1087,12 @@ leave a org
 ```
 USAGE
   $ proca user leave --email <user email> -o <org name> [--json | --human | --csv]
-    [--simplify]
+    [--env <value>] [--simplify]
 
 FLAGS
   -o, --org=<org name>      (required) name of the org
       --email=<user email>  (required) email
+      --env=<value>         [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -1004,10 +1113,12 @@ list all the users
 
 ```
 USAGE
-  $ proca user list -o <value> [--json | --human | --csv] [--simplify]
+  $ proca user list -o <value> [--json | --human | --csv] [--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
@@ -1026,14 +1137,16 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca widget add -c <campaign name> [--json | --human | --csv] [--simplify] [-o
-    <en>] [-l <en>] [-n by default  <campaign>/<org>/<lang>]
+  $ proca widget add -c <campaign name> [--json | --human | --csv] [--env <value>]
+    [--simplify] [-o <en>] [-l <en>] [-n by default  <campaign>/<org>/<lang>]
 
 FLAGS
   -c, --campaign=<campaign name>                  (required) name of the campaign
   -l, --lang=<en>                                 [default: en] language
   -n, --name=by default  <campaign>/<org>/<lang>  url slug
   -o, --org=<en>                                  organisation
+      --env=<value>                               [default: default] allow to switch between configurations (server or
+                                                  users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -1042,50 +1155,21 @@ OUTPUT FLAGS
   --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
 ```
 
-## `proca widget cache`
-
-clear the cdn cache of a widget
-
-```
-USAGE
-  $ proca widget cache [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
-    | -n <the_short_name> | -x <value>] [--url <value>]
-
-FLAGS
-  -i, --id=<value>
-  -n, --name=<the_short_name>  name
-  -x, --dxid=<value>           dxid
-      --url=<value>            url of the widget on the CDN
-
-OUTPUT FLAGS
-  --csv            Format output as csv
-  --human          Format output to be read on screen by a human [default]
-  --json           Format output as json
-  --[no-]simplify  flatten and filter to output only the most important attributes, mostly relevant for json
-
-DESCRIPTION
-  clear the cdn cache of a widget
-
-EXAMPLES
-  $ proca widget cache --url https://cdn.proca.app/d/[campaign]/[org]/[locale]
-
-  $ proca widget cache --name [campaign]/[org]/[locale]
-```
-
 ## `proca widget get`
 
 view a widget
 
 ```
 USAGE
-  $ proca widget get [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
-    | -n <the_short_name> | -x <value>] [--config]
+  $ proca widget get [ID_NAME_DXID] [--json | --human | --csv] [--env <value>]
+    [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [--config]
 
 FLAGS
   -i, --id=<value>
   -n, --name=<the_short_name>  name
   -x, --dxid=<value>           dxid
       --[no-]config            display the config
+      --env=<value>            [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -1106,13 +1190,14 @@ list all the widgets of an org or campaign
 
 ```
 USAGE
-  $ proca widget list [--json | --human | --csv] [--simplify] [-o <organisation name>]
-    [-c <campaign name>] [--config]
+  $ proca widget list [--json | --human | --csv] [--env <value>] [--simplify] [-o
+    <organisation name>] [-c <campaign name>] [--config]
 
 FLAGS
   -c, --campaign=<campaign name>  widgets of the campaign (coordinator or partner)
   -o, --org=<organisation name>   widgets of the organisation (coordinator or partner)
       --[no-]config               get the config
+      --env=<value>               [default: default] allow to switch between configurations (server or users)
 
 OUTPUT FLAGS
   --csv            Format output as csv

package/package.json

@@ -1,7 +1,7 @@
 {
 	"name": "proca",
 	"description": "Access the proca api",
-	"version": "1.2.2",
+	"version": "1.4.0",
 	"author": "Xavier",
 	"bin": {
 		"proca": "proca-cli"

package/src/commands/action/add.mjs

@@ -0,0 +1,169 @@
+import { Args, Flags } from "@oclif/core";
+import { error, stdout, ux } from "@oclif/core/ux";
+import OrgGet from "#src/commands/org/get.mjs";
+import Command from "#src/procaCommand.mjs";
+import { gql, mutation } from "#src/urql.mjs";
+import { getTwitter } from "#src/util/twitter.mjs";
+
+export default class ActionAdd extends Command {
+	static examples = [
+		"<%= config.bin %> <%= command.id %> -i <widget_id> --firstname=John --email=john@example.org",
+		"<%= config.bin %> <%= command.id %> -i <widget_id> --firstname=John --email=john@example.org --country=FR custom1=A custom2=B",
+	];
+
+	static args = this.multiid();
+	static strict = false; //THIS DOES NOT WORK
+
+	static flags = {
+		...this.flagify({ multiid: true }),
+		id: Flags.integer({
+			char: "i",
+			description: "widget's id",
+			required: true,
+		}),
+		testing: Flags.boolean({ default: true }),
+		optin: Flags.boolean({ default: false }),
+		action_type: Flags.string({
+			default: "register",
+		}),
+		firstname: Flags.string({
+			description: "supporter's firstname",
+			required: true,
+		}),
+		lastname: Flags.string(),
+		street: Flags.string(),
+		locality: Flags.string(),
+		region: Flags.string(),
+		country: Flags.string({
+			description: "2-letter country iso code",
+			parse: async (input) => {
+				if (input && !/^[A-Za-z]{2}$/.test(input)) {
+					throw new Error("Country code must be exactly 2 letters");
+				}
+				return input?.toUpperCase(); // optional: normalize to uppercase
+			},
+		}),
+		utm: Flags.string({
+			description: "utm=campaign.source.medium",
+		}),
+		email: Flags.string({
+			description: "email",
+			required: true,
+		}),
+	};
+
+	create = async (flags) => {
+		const values = {
+			action: {
+				actionType: flags.action_type,
+				customFields: flags.customFields,
+				/*    "mtt": {
+      "body": "body",
+      "files": [
+        "files"
+      ],
+      "subject": "subject",
+      "targets": [
+        "targets"
+      ]
+    },
+*/
+				testing: flags.testing,
+			},
+			actionPageId: flags.id,
+			contact: {
+				address: {
+					country: flags.country,
+					locality: flags.locality,
+					postcode: flags.postcode,
+					region: flags.region,
+					street: flags.street,
+					//      "streetNumber": "streetNumber"
+				},
+				email: flags.email,
+				firstName: flags.firstname,
+				lastName: flags.lastname,
+				phone: flags.phone,
+			},
+			privacy: {
+				//    "leadOptIn": true,
+				optIn: flags.optin,
+			},
+			tracking: {
+				...flags.tracking,
+				location: "proca-cli/action/add",
+			},
+		};
+
+		const query = gql`
+ mutation (
+  $action: ActionInput!
+  $actionPageId: Int!
+  $contact: ContactInput!
+  $contactRef: ID
+  $privacy: ConsentInput!
+  $tracking: TrackingInput
+) {
+  addActionContact(
+    action: $action
+    actionPageId: $actionPageId
+    contact: $contact
+    contactRef: $contactRef
+    privacy: $privacy
+    tracking: $tracking
+  ) {
+    contactRef
+    firstName
+  }
+}`;
+
+		const result = await mutation(query, values);
+
+		console.log("result", result);
+		return result;
+	};
+
+	parseUnknownFlags = (argv) => {
+		const knownFlags = Object.entries(ActionAdd.flags).flatMap(([key, def]) => {
+			const chars = def.char ? [def.char] : [];
+			return [key, ...chars];
+		});
+		/* doesn't work static=false has no effect    const unknownFlags = Object.fromEntries(
+      argv
+        .filter(arg =>
+          (/^--?\w+=/.test(arg)) // --key=val or -x=val
+        )
+        .map(arg => {
+          const keyval = arg.replace(/^-+/, '').split('=')
+          return [keyval[0], keyval[1]]
+        })
+        .filter(([key]) => !knownFlags.includes(key))
+    )
+*/
+
+		// Extract key=val style positional args (e.g. foo=bar)
+		const kvArgs = Object.fromEntries(
+			argv
+				.filter((arg) => !arg.startsWith("-") && arg.includes("="))
+				.map((arg) => arg.split("=")),
+		);
+
+		if (!Object.keys(kvArgs).length) return undefined;
+
+		return kvArgs;
+	};
+	async run() {
+		const { args, flags } = await this.parse(ActionAdd, {
+			context: { strict: false /* this does not work*/ },
+		});
+
+		const customFields = this.parseUnknownFlags(this.argv);
+		if (customFields) flags.customFields = JSON.stringify(customFields);
+		if (flags.utm) {
+			const [campaign, source, medium] = flags.utm.split(".");
+			flags.tracking = { source, medium, campaign };
+		} else flags.tracking = {};
+		const data = await this.create(flags);
+		return this.output(data);
+	}
+}

package/src/commands/campaign/close.mjs

@@ -0,0 +1,81 @@
+import { Args, Flags } from "@oclif/core";
+import { error, stdout, ux } from "@oclif/core/ux";
+import OrgGet from "#src/commands/org/get.mjs";
+import Command from "#src/procaCommand.mjs";
+import { gql, mutation } from "#src/urql.mjs";
+import { getTwitter } from "#src/util/twitter.mjs";
+
+export default class CampaignClose extends Command {
+	static args = {
+		title: Args.string({
+			description: "title of the campaign",
+			multiple: true,
+		}),
+	};
+	//  static strict = false;
+
+	static examples = ["<%= config.bin %> <%= command.id %> -name <campaign>"];
+
+	static flags = {
+		// flag with no value (-f, --force)
+		...super.globalFlags,
+		name: Flags.string({
+			char: "n",
+			description: "name of the campaign",
+			helpValue: "<campaign name>",
+			required: true,
+		}),
+		org: Flags.string({
+			char: "o",
+			description: "name of the coordinator",
+			helpValue: "<org name>",
+			required: true,
+		}),
+		status: Flags.string({
+			description: "status",
+			required: true,
+			options: ["closed", "ignored", "live"],
+			default: "closed",
+		}),
+	};
+
+	updateStatus = async (props) => {
+		const org = await this.getOrg(props.org);
+
+		const Query = gql`
+mutation ($org: String!
+$name: String!
+$status: String!
+) {
+  upsertCampaign (input: { name: $name, status: $status }, orgName: $org) {
+    name
+    title
+    status
+    config
+  }
+}
+    `;
+		const result = await mutation(Query, {
+			org: props.org,
+			name: props.name,
+			status: props.status.toUpperCase(),
+		});
+
+		console.log("result", result);
+		return result;
+	};
+
+	async getOrg(orgName) {
+		const { config } = this;
+		const orgGet = new OrgGet({}, this.config);
+		const org = await orgGet.fetch({ name: orgName });
+		return org;
+	}
+
+	async run() {
+		const { args, flags } = await this.parse();
+
+		const data = await this.updateStatus(flags);
+		return this.output(data);
+	}
+}

package/src/commands/config/add.mjs

@@ -5,14 +5,11 @@ import Command from "#src/procaCommand.mjs";
 
 export default class CampaignList extends Command {
 	static enableJsonFlag = true;
-	static aliases = ["config:setup"];
+	static aliases = ["config:setup", "config:init"];
 	static deprecateAliases = true;
 
 	static args = {
-		environment: Args.string({
-			description: "environment",
-			default: "default",
-		}),
+		...this.flagify({ multiid: false }),
 	};
 
 	static description = "create setting to access the server authentication";
@@ -39,24 +36,14 @@ export default class CampaignList extends Command {
 			helpValue: "<API-token>",
 			required: true,
 		}),
-		n8n: Flags.string({
-			description: "api access on the n8n server",
-			helpValue: "<n8n api>",
-		}),
-		supabase: Flags.string({
-			description: "url of the supabase",
-			helpValue: "<url>",
-		}),
-		"supabase-anon-key": Flags.string({
-			description: "anonymous key",
-		}),
-		"supabase-secrey-key": Flags.string({
-			description: "secret service key",
-		}),
+		//		n8n: Flags.string({			description: "api access on the n8n server",			helpValue: "<n8n api>",		}),
+		//		supabase: Flags.string({description: "url of the supabase",helpValue: "<url>"}),
+		//		"supabase-anon-key": Flags.string({			description: "anonymous key",		}),
+		//		"supabase-secrey-key": Flags.string({			description: "secret service key",		}),
 	};
 
 	format = (obj) => {
-		const content = ["# generated by proca-api"];
+		const content = ["# generated by proca-cli"];
 		for (const [key, value] of Object.entries(obj)) {
 			if (value) {
 				content.push(`${key}='${value.replace(/'/g, "''")}'`);
@@ -83,12 +70,11 @@ export default class CampaignList extends Command {
 
 	async run() {
 		const { args, flags } = await this.parse();
-		const file = getFilename(this.config.configDir);
-
+		const file = getFilename(this.config.configDir, flags.env);
 		const userConfig = getConfig(file);
 		if (userConfig && !this.flags.force) {
 			this.error("config file exists already", {
-				code: "CONFIG_ERR",
+				code: "CONFIG_EXISTS",
 				_ref: "README.md#",
 				suggestions: [
 					`edit ${file}`,

package/src/commands/config/{get.mjs → server.mjs}

@@ -26,8 +26,8 @@ query {
 
 	async run() {
 		//		const { args, flags } = await this.parse();
-
 		const data = await this.fetch();
+		data.url = this.procaConfig.url;
 		return this.output(data);
 	}
 }

package/src/hooks/init.mjs

@@ -3,8 +3,29 @@ import { config as dotenv } from "dotenv";
 import { getFilename, load } from "#src/config.mjs";
 import CustomHelp from "./help.mjs";
 
+const getEnv = () => {
+	const rawArgs = process.argv.slice(2);
+	let envValue = undefined;
+	// Manually check for --environment or -e
+	rawArgs.findIndex((arg, envIndex) => {
+		if (arg === "--env") {
+			// || arg === '-e') {
+			envValue = rawArgs[envIndex + 1]; // Next arg is the value
+			return true;
+		}
+		if (arg.startsWith("--env=")) {
+			envValue = arg.split("=")[1];
+			return true;
+		}
+	});
+
+	//      console.log(`Environment set to: ${envValue}`);
+
+	return envValue;
+};
+
 const hook = async (opts) => {
-	const config = load(opts.config.configDir);
+	const config = load(opts.config.configDir, getEnv());
 	if (config) {
 		opts.config.procaConfig = config;
 	} else {

package/src/procaCommand.mjs

@@ -13,6 +13,10 @@ class ProcaCommand extends Command {
 	flags = {};
 
 	static baseFlags = {
+		env: Flags.string({
+			default: "default",
+			description: "allow to switch between configurations (server or users)",
+		}),
 		human: Flags.boolean({
 			helpGroup: "OUTPUT", // Optional, groups it under a specific help section if desired
 			description: "Format output to be read on screen by a human [default]",
@@ -103,8 +107,9 @@ class ProcaCommand extends Command {
 		createClient(this.procaConfig);
 	}
 
-	async catch(err) {
+	async _catch(err) {
 		// Check if the error was caused by a missing flag or wrong argument format
+		console.log("aaa", err);
 		try {
 			this.error(err.toString());
 		} catch (e) {
@@ -164,6 +169,7 @@ class ProcaCommand extends Command {
 	warn(...msg) {
 		this.tlog("warn", ...msg);
 	}
+
 	error(msg, options = {}) {
 		const colouredMessage = ux.colorize(this.config.theme.error, msg);
 		super.error(colouredMessage, options);

package/src/commands/config/token.mjs

@@ -1,34 +0,0 @@
-import crypto from "node:crypto";
-import { Args, Flags } from "@oclif/core";
-import { error, stdout, ux } from "@oclif/core/ux";
-import Command from "#src/procaCommand.mjs";
-
-export default class UserList extends Command {
-	static description = "convert between token and sql value";
-
-	static flags = {
-		token: Flags.string({
-			exactlyOne: ["token"],
-			description: "the token in your config",
-			helpValue: "API-xxx",
-		}),
-	};
-
-	async run() {
-		const { args, flags } = await this.parse();
-		if (flags.token) {
-			const token = flags.token
-				.replace("API-", "")
-				.replace(/-/g, "+")
-				.replace(/_/g, "/");
-			const decoded = Buffer.from(token, "base64").toString("utf-8");
-			const hexa = crypto.createHash("sha256").update(decoded).digest("hex");
-			console.log(token, decoded, hexa);
-
-			return this.output({ hexa: `\\x${hexa}` });
-		}
-		const data = flags;
-
-		return this.output(data);
-	}
-}

package/src/commands/widget/cache.mjs

@@ -1,29 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-import { error, stdout, ux } from "@oclif/core/ux";
-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 = "clear the cdn cache of a widget";
-
-	static examples = [
-		"<%= config.bin %> <%= command.id %> --url https://cdn.proca.app/d/[campaign]/[org]/[locale]",
-		"<%= config.bin %> <%= command.id %> --name [campaign]/[org]/[locale]",
-	];
-	static args = this.multiid();
-
-	static flags = {
-		// flag with no value (-f, --force)
-		...this.flagify({ multiid: true }),
-		url: Flags.string ({
-			description: "url of the widget on the CDN",
-		}),
-	};
-
-	async run() {
-		const { args, flags } = await this.parse();
-console.log(flags);
-	}
-}
-