proca 1.1.4 → 1.2.0

package/README.md

@@ -18,7 +18,7 @@ $ npm install -g proca
 $ proca COMMAND
 running command...
 $ proca (--version)
-proca/1.1.4 linux-x64 node-v22.14.0
+proca/1.2.0 linux-x64 node-v20.12.2
 $ proca --help [COMMAND]
 USAGE
   $ proca COMMAND
@@ -40,13 +40,8 @@ USAGE
 -  campaign  Handle campaigns
 - org
 -  config    create setting to access the server authentication
-
-### TODO TOPICS
-
 - widget
-- actions
-- service
-- target
+- supporters (counter)
 
 # Commands
 <!-- commands -->
@@ -61,7 +56,9 @@ USAGE
 * [`proca config get`](#proca-config-get)
 * [`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 user`](#proca-config-user)
+* [`proca contact list [TITLE]`](#proca-contact-list-title)
 * [`proca help [COMMAND]`](#proca-help-command)
 * [`proca org add`](#proca-org-add)
 * [`proca org crm`](#proca-org-crm)
@@ -78,11 +75,11 @@ USAGE
 * [`proca plugins uninstall [PLUGIN]`](#proca-plugins-uninstall-plugin)
 * [`proca plugins unlink [PLUGIN]`](#proca-plugins-unlink-plugin)
 * [`proca plugins update`](#proca-plugins-update)
-* [`proca supporter count`](#proca-supporter-count)
 * [`proca user get`](#proca-user-get)
 * [`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)
 
@@ -92,7 +89,7 @@ counter of actions
 
 ```
 USAGE
-  $ proca action count [ID_NAME_DXID] [--simplify [--json | --human | --csv]] [-i <value>
+  $ proca action count [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
     | -n <the_short_name> | -x <value>]
 
 FLAGS
@@ -101,10 +98,10 @@ FLAGS
   -x, --dxid=<value>           dxid
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   counter of actions
@@ -119,8 +116,9 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca action list [TITLE] -o <organisation name> [--simplify [--json | --human |
-    --csv]] [-c <campaign title>] [--limit <value>] [--optin] [--testing] [--doi] [--utm]
+  $ 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 | ]
 
 ARGUMENTS
   TITLE  name of the campaign, % for wildchar
@@ -128,17 +126,20 @@ ARGUMENTS
 FLAGS
   -c, --campaign=<campaign title>  name of the campaign, % for wildchar
   -o, --org=<organisation name>    (required) campaigns of the organisation (coordinator or partner)
+      --after=2025-04-09           only actions after a date
+      --[no-]comment               display the comment
       --doi                        only export the double optin actions
       --limit=<value>              max number of actions
       --optin                      only export the optin actions
       --testing                    also export the test actions
+      --today                      only actions today
       --[no-]utm                   display the utm tracking parameters
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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 list %pizza%
@@ -148,7 +149,7 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca action replay -o <organisation name> [--simplify [--json | --human | --csv]] [-c
+  $ proca action replay -o <organisation name> [--json | --human | --csv] [--simplify] [-c
     <campaign title>]
 
 FLAGS
@@ -156,10 +157,10 @@ FLAGS
   -o, --org=<organisation name>    (required) campaigns of the organisation (coordinator or partner)
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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 replay %pizza%
@@ -169,8 +170,8 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca campaign add [TITLE] -n <campaign name> -o <org name> [--simplify [--json |
-    --human | --csv]]
+  $ proca campaign add [TITLE] -n <campaign name> -o <org name> [--json | --human |
+    --csv] [--simplify]
 
 ARGUMENTS
   TITLE  title of the campaign
@@ -180,10 +181,10 @@ FLAGS
   -o, --org=<org name>        (required) name of the coordinator
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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 add -n <new_campaign> the full name of the campaign
@@ -195,7 +196,7 @@ delete a campaign
 
 ```
 USAGE
-  $ proca campaign delete [--simplify [--json | --human | --csv]] [-i <organisation name>]
+  $ proca campaign delete [--json | --human | --csv] [--simplify] [-i <organisation name>]
     [-n <campaign name>]
 
 FLAGS
@@ -203,10 +204,10 @@ FLAGS
   -n, --name=<campaign name>    name of the campaign
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   delete a campaign
@@ -221,7 +222,7 @@ view a campaign
 
 ```
 USAGE
-  $ proca campaign get [ID_NAME_DXID] [--simplify [--json | --human | --csv]] [-i <value>
+  $ proca campaign get [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
     | -n <the_short_name> | -x <value>] [--config] [--stats] [--locale <value>]
 
 FLAGS
@@ -233,10 +234,10 @@ FLAGS
       --[no-]stats             display the stats
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   view a campaign
@@ -251,7 +252,7 @@ list all the campaigns
 
 ```
 USAGE
-  $ proca campaign list [TITLE] [--simplify [--json | --human | --csv]] [-o <organisation
+  $ proca campaign list [TITLE] [--json | --human | --csv] [--simplify] [-o <organisation
     name>] [-t <campaign title>] [--stats]
 
 ARGUMENTS
@@ -263,10 +264,10 @@ FLAGS
       --[no-]stats               display the stats
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   list all the campaigns
@@ -281,8 +282,8 @@ create setting to access the server authentication
 
 ```
 USAGE
-  $ proca config add [ENVIRONMENT] --token <API-token> [--simplify [--json | --human |
-    --csv]] [--force] [--url <url>] [--n8n <n8n api>] [--supabase <url>] [--supabase-anon-key <value>]
+  $ 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>]
 
 ARGUMENTS
@@ -298,10 +299,10 @@ FLAGS
   --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
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
@@ -319,13 +320,13 @@ get the server config
 
 ```
 USAGE
-  $ proca config get [--simplify [--json | --human | --csv]]
+  $ proca config get [--json | --human | --csv] [--simplify]
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   get the server config
@@ -337,7 +338,7 @@ update the setting used to authenticate to the servers and services
 
 ```
 USAGE
-  $ proca config set [KEY] [VALUE] [--simplify [--json | --human | --csv]]
+  $ proca config set [KEY] [VALUE] [--json | --human | --csv] [--simplify]
     [--environment <value>] [--url <url>] [--token <API-token>]
 
 ARGUMENTS
@@ -350,10 +351,10 @@ FLAGS
   --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
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   update the setting used to authenticate to the servers and services
@@ -373,8 +374,8 @@ create setting to access the server authentication
 
 ```
 USAGE
-  $ proca config setup [ENVIRONMENT] --token <API-token> [--simplify [--json | --human |
-    --csv]] [--force] [--url <url>] [--n8n <n8n api>] [--supabase <url>] [--supabase-anon-key <value>]
+  $ 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>]
 
 ARGUMENTS
@@ -390,10 +391,10 @@ FLAGS
   --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
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
@@ -405,19 +406,40 @@ 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 [--simplify [--json | --human | --csv]]
+  $ proca config user [--json | --human | --csv] [--simplify]
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   fetch the information about the current user (based on the token)
@@ -426,6 +448,39 @@ EXAMPLES
   $ proca config user
 ```
 
+## `proca contact list [TITLE]`
+
+```
+USAGE
+  $ proca contact list [TITLE] -o <organisation name> [--json | --human | --csv] [-c
+    <campaign title>] [--limit <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm |
+    --simplify] [--comment | ]
+
+ARGUMENTS
+  TITLE  name of the campaign, % for wildchar
+
+FLAGS
+  -c, --campaign=<campaign title>  name of the campaign, % for wildchar
+  -o, --org=<organisation name>    (required) campaigns of the organisation (coordinator or partner)
+      --after=2025-04-09           only actions after a date
+      --[no-]comment               display the comment
+      --doi                        only export the double optin actions
+      --limit=<value>              max number of actions
+      --optin                      only export the optin actions
+      --testing                    also export the test actions
+      --today                      only actions today
+      --[no-]utm                   display the utm tracking parameters
+
+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 contact list %pizza%
+```
+
 ## `proca help [COMMAND]`
 
 Display help for proca.
@@ -450,7 +505,7 @@ _See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.2
 
 ```
 USAGE
-  $ proca org add [--simplify [--json | --human | --csv]] [--twitter <screen name>]
+  $ proca org add [--json | --human | --csv] [--simplify] [--twitter <screen name>]
     [-n <org name>]
 
 FLAGS
@@ -458,10 +513,10 @@ FLAGS
       --twitter=<screen name>  twitter account
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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 org add --twitter <twitter of the organisation>
@@ -473,7 +528,7 @@ view a org crm synchroniser
 
 ```
 USAGE
-  $ proca org crm -n <org name> [--simplify [--json | --human | --csv]]
+  $ proca org crm -n <org name> [--json | --human | --csv] [--simplify]
     [--synchronize]
 
 FLAGS
@@ -481,10 +536,10 @@ FLAGS
       --[no-]synchronize  enable or disable the synchronisation queue
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   view a org crm synchroniser
@@ -494,7 +549,7 @@ DESCRIPTION
 
 ```
 USAGE
-  $ proca org delete [ID_NAME_DXID] [--simplify [--json | --human | --csv]] [-i <value>
+  $ proca org delete [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
     | -n <org name> | -x <value>]
 
 FLAGS
@@ -503,10 +558,10 @@ FLAGS
   -x, --dxid=<value>     dxid
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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 org delete  <organisation_name>
@@ -518,7 +573,7 @@ view a org
 
 ```
 USAGE
-  $ proca org get [ID_NAME_DXID] [--simplify [--json | --human | --csv]] [-n <org
+  $ proca org get [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-n <org
     name>] [--config] [--keys] [--campaigns] [--widgets] [--users]
 
 FLAGS
@@ -530,10 +585,10 @@ FLAGS
   --[no-]widgets
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   view a org
@@ -548,7 +603,7 @@ let a user join an organisation with a role
 
 ```
 USAGE
-  $ proca org join -o <org name> [--simplify [--json | --human | --csv]] [--user
+  $ proca org join -o <org name> [--json | --human | --csv] [--simplify] [--user
     <value>] [--role owner|campaigner|coordinator|translator]
 
 FLAGS
@@ -558,10 +613,10 @@ FLAGS
       --user=<value>    user email
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   let a user join an organisation with a role
@@ -860,46 +915,13 @@ DESCRIPTION
 
 _See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.4.25/src/commands/plugins/update.ts)_
 
-## `proca supporter count`
-
-counter of supporters
-
-```
-USAGE
-  $ proca supporter count [ID_NAME_DXID] [--simplify [--json | --human | --csv]] [-i <value>
-    | -n <the_short_name> | -x <value>] [--org] [--area] [--number --without <value>]
-
-FLAGS
-  -i, --id=<value>
-  -n, --name=<the_short_name>  name
-  -x, --dxid=<value>           dxid
-      --area                   segment by area
-      --number                 just return the number to add to the partner's counter
-      --org                    segment by partner
-      --without=<value>        total to add to the partner's counter
-
-OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
-
-DESCRIPTION
-  counter of supporters
-
-EXAMPLES
-  $ proca supporter count --id <id of the campaign>
-
-  $ proca supporter count --name <name of the campaign>
-```
-
 ## `proca user get`
 
 fetch the information about a user
 
 ```
 USAGE
-  $ proca user get [--simplify [--json | --human | --csv]] [--email <value>] [-o <org
+  $ proca user get [--json | --human | --csv] [--simplify] [--email <value>] [-o <org
     name>] [-i <value>]
 
 FLAGS
@@ -908,10 +930,10 @@ FLAGS
       --email=<value>   user email
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   fetch the information about a user
@@ -926,18 +948,18 @@ leave a org
 
 ```
 USAGE
-  $ proca user leave --email <user email> -o <org name> [--simplify [--json | --human |
-    --csv]]
+  $ proca user leave --email <user email> -o <org name> [--json | --human | --csv]
+    [--simplify]
 
 FLAGS
   -o, --org=<org name>      (required) name of the org
       --email=<user email>  (required) email
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   leave a org
@@ -952,16 +974,16 @@ list all the users
 
 ```
 USAGE
-  $ proca user list -o <value> [--simplify [--json | --human | --csv]]
+  $ proca user list -o <value> [--json | --human | --csv] [--simplify]
 
 FLAGS
   -o, --org=<value>  (required) organisation
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   list all the users
@@ -974,7 +996,7 @@ EXAMPLES
 
 ```
 USAGE
-  $ proca widget add -c <campaign name> [--simplify [--json | --human | --csv]] [-o
+  $ proca widget add -c <campaign name> [--json | --human | --csv] [--simplify] [-o
     <en>] [-l <en>] [-n by default  <campaign>/<org>/<lang>]
 
 FLAGS
@@ -984,10 +1006,40 @@ FLAGS
   -o, --org=<en>                                  organisation
 
 OUTPUT FLAGS
-  --csv       Format output as csv
-  --human     Format output to be read on screen by a human [default]
-  --json      Format output as json
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
+```
+
+## `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`
@@ -996,7 +1048,7 @@ view a widget
 
 ```
 USAGE
-  $ proca widget get [ID_NAME_DXID] [--simplify [--json | --human | --csv]] [-i <value>
+  $ proca widget get [ID_NAME_DXID] [--json | --human | --csv] [--simplify] [-i <value>
     | -n <the_short_name> | -x <value>] [--config]
 
 FLAGS
@@ -1006,10 +1058,10 @@ FLAGS
       --[no-]config            display the 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
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   view a widget
@@ -1024,7 +1076,7 @@ list all the widgets of an org or campaign
 
 ```
 USAGE
-  $ proca widget list [--simplify [--json | --human | --csv]] [-o <organisation name>]
+  $ proca widget list [--json | --human | --csv] [--simplify] [-o <organisation name>]
     [-c <campaign name>] [--config]
 
 FLAGS
@@ -1033,10 +1085,10 @@ FLAGS
       --[no-]config               get the 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
-  --simplify  flatten and filter to output only the most important attributes, mostly relevant for json
+  --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
   list all the widgets of an org or campaign

package/package.json

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

package/src/commands/action/list.mjs

@@ -8,7 +8,7 @@ import {
 } from "#src/queries/campaign.mjs";
 import { gql, query } from "#src/urql.mjs";
 
-export default class CampaignList extends Command {
+export default class List extends Command {
 	actionTypes = new Set();
 
 	static args = {
@@ -36,6 +36,16 @@ export default class CampaignList extends Command {
 			description: "max number of actions",
 			parse: (input) => Number.parseInt(input, 10),
 		}),
+		after: Flags.string({
+			description: "only actions after a date",
+			helpValue: "2025-04-09",
+			parse: (input) => new Date(input).toISOString(),
+		}),
+		today: Flags.boolean({
+			description: "only actions today",
+			exclusive: ["after"],
+			parse: (input) => `${new Date().toISOString().split("T")[0]}T00:00:00Z`,
+		}),
 		optin: Flags.boolean({
 			description: "only export the optin actions",
 			default: false,
@@ -52,6 +62,13 @@ export default class CampaignList extends Command {
 			description: "display the utm tracking parameters",
 			default: true,
 			allowNo: true,
+			exclusive: ["simplify"],
+		}),
+		comment: Flags.boolean({
+			description: "display the comment",
+			default: true,
+			allowNo: true,
+			exclusive: ["simplify"],
 		}),
 	};
 
@@ -68,7 +85,7 @@ export default class CampaignList extends Command {
         $orgName: String!
         $start: Int
       ) {
-        exportActions(
+        actions (
           after: $after
           campaignId: $campaignId
           campaignName: $campaignName
@@ -114,8 +131,7 @@ export default class CampaignList extends Command {
         }
       }
     `;
-
-		const variables = {
+		const result = await query(Document, {
 			after: flags.after,
 			//  "campaignId": 42,
 			campaignName: flags.campaign,
@@ -125,11 +141,8 @@ export default class CampaignList extends Command {
 			onlyOptIn: flags.optin,
 			orgName: flags.org,
 			start: flags.start,
-		};
-		console.log("fetching actions", variables);
-		const result = await query(Document, variables);
-		console.log("result", result);
-		return result.exportActions.map((d) => {
+		});
+		return result.actions.map((d) => {
 			d.customFields = JSON.parse(d.customFields);
 			if (!d.contact.publicKey) {
 				const ref = d.contactRef;
@@ -151,14 +164,15 @@ export default class CampaignList extends Command {
 			firstname: d.contact.firstName,
 			country: d.contact.country,
 			email: d.contact.email,
-			widget: d.actionPage.name,
 			type: d.actionType,
 			date: d.createdAt,
 			campaign: d.campaign.name,
 			widget_id: d.actionPage.id,
+			widget: d.actionPage.name,
 			//            customFields
 		};
-		if (d.customFields?.comment) result.comment = d.customFields.comment;
+		if (this.flags.comment && d.customFields?.comment)
+			result.comment = d.customFields.comment;
 		if (d.customFields?.emailProvider)
 			result.provider = d.customFields.emailProvider;
 		if (this.flags.utm && d.tracking) {
@@ -181,9 +195,10 @@ export default class CampaignList extends Command {
 
 	async run() {
 		const { args, flags } = await this.parse();
+		if (flags.today) flags.after = flags.today;
 		let data = [];
 
 		data = await this.fetch(flags);
-		//return this.output(data);
+		return this.output(data);
 	}
 }

package/src/commands/config/token.mjs

@@ -0,0 +1,34 @@
+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/contact/list.mjs

@@ -0,0 +1,204 @@
+import { Args, Flags } from "@oclif/core";
+import { error, stdout, ux } from "@oclif/core/ux";
+import Command from "#src/procaCommand.mjs";
+import {
+	FragmentOrg,
+	FragmentStats,
+	FragmentSummary,
+} from "#src/queries/campaign.mjs";
+import { gql, query } from "#src/urql.mjs";
+
+export default class List extends Command {
+	actionTypes = new Set();
+
+	static args = {
+		title: Args.string({ description: "name of the campaign, % for wildchar" }),
+	};
+
+	static examples = ["<%= config.bin %> <%= command.id %> %pizza%"];
+
+	static flags = {
+		// flag with no value (-f, --force)
+		...super.globalFlags,
+		org: Flags.string({
+			char: "o",
+			description: "campaigns of the organisation (coordinator or partner)",
+			required: true,
+			//			exactlyOne: ["org", "title"],
+			helpValue: "<organisation name>",
+		}),
+		campaign: Flags.string({
+			char: "c",
+			description: "name of the campaign, % for wildchar",
+			helpValue: "<campaign title>",
+		}),
+		limit: Flags.string({
+			description: "max number of actions",
+			parse: (input) => Number.parseInt(input, 10),
+		}),
+		after: Flags.string({
+			description: "only actions after a date",
+			helpValue: "2025-04-09",
+			parse: (input) => new Date(input).toISOString(),
+		}),
+		today: Flags.boolean({
+			description: "only actions today",
+			exclusive: ["after"],
+			parse: (input) => `${new Date().toISOString().split("T")[0]}T00:00:00Z`,
+		}),
+		optin: Flags.boolean({
+			description: "only export the optin actions",
+			default: false,
+		}),
+		testing: Flags.boolean({
+			description: "also export the test actions",
+			default: false,
+		}),
+		doi: Flags.boolean({
+			description: "only export the double optin actions",
+			default: false,
+		}),
+		utm: Flags.boolean({
+			description: "display the utm tracking parameters",
+			default: true,
+			allowNo: true,
+			exclusive: ["simplify"],
+		}),
+		comment: Flags.boolean({
+			description: "display the comment",
+			default: true,
+			allowNo: true,
+			exclusive: ["simplify"],
+		}),
+	};
+
+	fetch = async (flags) => {
+		const Document = gql`
+      query (
+        $after: DateTime
+        $campaignId: Int
+        $campaignName: String
+        $includeTesting: Boolean
+        $limit: Int
+        $onlyDoubleOptIn: Boolean
+        $onlyOptIn: Boolean
+        $orgName: String!
+        $start: Int
+      ) {
+        contacts(
+          after: $after
+          campaignId: $campaignId
+          campaignName: $campaignName
+          includeTesting: $includeTesting
+          limit: $limit
+          onlyDoubleOptIn: $onlyDoubleOptIn
+          onlyOptIn: $onlyOptIn
+          orgName: $orgName
+          start: $start
+        ) {
+          actionId
+          actionPage {
+            locale
+            name
+          }
+          actionType
+          campaign {
+            name
+          }
+          contact {
+            contactRef
+            payload
+            nonce
+            publicKey {
+              public
+            }
+          }
+          createdAt
+          customFields
+          privacy {
+            emailStatus
+            emailStatusChanged
+            givenAt
+            optIn
+            withConsent
+          }
+          tracking {
+            campaign
+            content
+            medium
+            source
+          }
+        }
+      }
+    `;
+		const result = await query(Document, {
+			after: flags.after,
+			//  "campaignId": 42,
+			campaignName: flags.campaign,
+			includeTesting: flags.testing,
+			limit: flags.limit,
+			onlyDoubleOptIn: flags.doi,
+			onlyOptIn: flags.optin,
+			orgName: flags.org,
+			start: flags.start,
+		});
+		return result.contacts.map((d) => {
+			d.customFields = JSON.parse(d.customFields);
+			if (!d.contact.publicKey) {
+				const ref = d.contactRef;
+				d.contact = JSON.parse(d.contact.payload);
+				d.contact.contactRef = ref;
+			} else {
+				this.error(
+					`encrypted contact we need the private key for ${d.contact.publicKey.public}`,
+				);
+			}
+			return d;
+		});
+		//		return result.exportActions;
+	};
+
+	simplify = (d) => {
+		const result = {
+			id: d.actionId,
+			firstname: d.contact.firstName,
+			country: d.contact.country,
+			email: d.contact.email,
+			type: d.actionType,
+			date: d.createdAt,
+			campaign: d.campaign.name,
+			widget_id: d.actionPage.id,
+			widget: d.actionPage.name,
+			//            customFields
+		};
+		if (this.flags.comment && d.customFields?.comment)
+			result.comment = d.customFields.comment;
+		if (d.customFields?.emailProvider)
+			result.provider = d.customFields.emailProvider;
+		if (this.flags.utm && d.tracking) {
+			result.utm_medium =
+				d.tracking.medium === "unknown" ? undefined : d.tracking.medium;
+			result.utm_source =
+				d.tracking.source === "unknown" ? undefined : d.tracking.source;
+			result.utm_campaign =
+				d.tracking.campaign === "unknown" ? undefined : d.tracking.campaign;
+			if (d.tracking.content)
+				result.utm_content =
+					d.tracking.content === "unknown" ? undefined : d.tracking.content;
+		}
+		return result;
+	};
+
+	_table = (r) => {
+		super.table(r, null, (table) => table.sort(["id|des"]).toString());
+	};
+
+	async run() {
+		const { args, flags } = await this.parse();
+		if (flags.today) flags.after = flags.today;
+		let data = [];
+
+		data = await this.fetch(flags);
+		return this.output(data);
+	}
+}

package/src/commands/widget/cache.mjs

@@ -0,0 +1,29 @@
+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);
+	}
+}
+

package/src/procaCommand.mjs

@@ -31,7 +31,7 @@ class ProcaCommand extends Command {
 			helpGroup: "OUTPUT",
 			description:
 				"flatten and filter to output only the most important attributes, mostly relevant for json",
-			dependsOn: ["json"],
+			allowNo: true,
 		}),
 	};
 
@@ -112,6 +112,19 @@ class ProcaCommand extends Command {
 		}
 	}
 
+	flatten = (obj, prefix = "", result = {}) => {
+		Object.entries(obj).forEach(([k, v]) => {
+			const newKey = Object.hasOwn(result, k) && prefix ? `${prefix}-${k}` : k;
+
+			if (v?.constructor === Object) {
+				this.flatten(v, newKey, result);
+			} else {
+				result[newKey] = v;
+			}
+		});
+		return result;
+	};
+
 	simplify = (d) => {
 		const r = {};
 		for (const [key, value] of Object.entries(d)) {
@@ -159,10 +172,13 @@ class ProcaCommand extends Command {
 	async csv(data) {
 		return new Promise((resolve, reject) => {
 			let d = null;
+			const format = this.flags.simplify
+				? this.simplify
+				: (d) => this.flatten(d, "");
 			if (Array.isArray(data)) {
-				d = data.map(this.simplify);
+				d = data.map(format);
 			} else {
-				d = [this.simplify(data)];
+				d = [format(data)];
 			}
 			const stream = fastcsv
 				.write(d, { headers: true })
@@ -178,11 +194,19 @@ class ProcaCommand extends Command {
 
 	table(data, transformRow, print = (table) => table.toString()) {
 		if (!transformRow) {
-			transformRow = (d, cell) => {
-				for (const [key, value] of Object.entries(this.simplify(d))) {
-					cell(key, value);
-				}
-			};
+			if (this.flags.simplify !== false) {
+				transformRow = (d, cell) => {
+					for (const [key, value] of Object.entries(this.simplify(d))) {
+						cell(key, value);
+					}
+				};
+			} else {
+				transformRow = (d, cell) => {
+					for (const [key, value] of Object.entries(this.flatten(d))) {
+						cell(key, value);
+					}
+				};
+			}
 		}
 		const theme = this.config.theme;
 		Table.prototype.pushDelimeter = function (cols) {

package/src/commands/supporter/count.mjs

@@ -1,96 +0,0 @@
-import { Args, Flags } from "@oclif/core";
-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 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 }),
-		org: Flags.boolean({
-			description: "segment by partner",
-			default: false,
-		}),
-		area: Flags.boolean({
-			description: "segment by area",
-			default: false,
-		}),
-		without: Flags.string({
-			description: "total to add to the partner's counter",
-		}),
-		number: Flags.boolean({
-			description: "just return the number to add to the partner's counter",
-			dependsOn: ["without"],
-		}),
-	};
-
-	fetchExcluding = async (params) => {
-		const GetCounterDocument = gql`
-query GetCounter($name: String, $id: Int, $without: String!) {
-  campaign(name: $name, id: $id) {
-    stats {
-      supporterCount
-      supporterCountByOthers (orgName: $without) 
-    }
-  }
-}`;
-
-		const result = await query(GetCounterDocument, params);
-		return result.campaign.stats;
-	};
-
-	fetch = async (params) => {
-		const GetCounterDocument = gql`
-query GetCounter($name: String, $id: Int, $org: Boolean = false, $area: Boolean = false) {
-  campaign(name: $name, id: $id) {
-    stats {
-      supporterCount
-      supporterCountByOrg @include(if: $org) { org { name } count }
-      supporterCountByArea @include(if: $area) { area count }
-    }
-  }
-}`;
-
-		const result = await query(GetCounterDocument, params);
-		return result.campaign.stats;
-	};
-
-	simplify = (d) => {
-		const result = { total: d.supporterCount };
-		d.supporterCountByOrg
-			?.sort((a, b) => b.count - a.count)
-			.forEach((org) => {
-				result[org.org.name] = org.count;
-			});
-		d.supporterCountByArea
-			?.sort((a, b) => b.count - a.count)
-			.forEach((area) => {
-				result[area.area] = area.count;
-			});
-		if (d.supporterCountByOthers) {
-			result[`without ${this.flags.without}`] = d.supporterCountByOthers;
-		}
-		return result;
-	};
-	table = (r) => {
-		super.table(r, null, null);
-	};
-
-	async run() {
-		const { args, flags } = await this.parse();
-		if (flags.without) {
-			const data = await this.fetchExcluding(flags);
-			if (flags.number) return console.log(data.supporterCountByOthers);
-			return this.output(data);
-		}
-		const data = await this.fetch(flags);
-		return this.output(data);
-	}
-}