proca 2.2.0 → 2.3.1

package/README.md

@@ -74,6 +74,8 @@ you should also use the local proca-api in your [widget generator](https://githu
 * [`proca config user`](#proca-config-user)
 * [`proca contact area count`](#proca-contact-area-count)
 * [`proca contact count`](#proca-contact-count)
+* [`proca contact delete`](#proca-contact-delete)
+* [`proca contact get`](#proca-contact-get)
 * [`proca contact list`](#proca-contact-list)
 * [`proca help [COMMAND]`](#proca-help-command)
 * [`proca org add`](#proca-org-add)
@@ -81,6 +83,7 @@ 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 logo`](#proca-org-logo)
 * [`proca org user get`](#proca-org-user-get)
 * [`proca plugins`](#proca-plugins)
 * [`proca plugins add PLUGIN`](#proca-plugins-add-plugin)
@@ -107,6 +110,7 @@ you should also use the local proca-api in your [widget generator](https://githu
 * [`proca user whoami`](#proca-user-whoami)
 * [`proca widget add`](#proca-widget-add)
 * [`proca widget delete`](#proca-widget-delete)
+* [`proca widget external`](#proca-widget-external)
 * [`proca widget get`](#proca-widget-get)
 * [`proca widget list`](#proca-widget-list)
 * [`proca widget rebuild`](#proca-widget-rebuild)
@@ -337,12 +341,15 @@ EXAMPLES
 ```
 USAGE
   $ proca campaign close [ID_NAME_DXID] --status draft|live|closed|ignored [--json | --csv
-    | --markdown] [--env <value>] [--simplify]
+    | --markdown] [--env <value>] [--simplify] [-n <campaign>] [--start YYYY-MM-DD] [--end YYYY-MM-DD]
 
 FLAGS
-  --env=<value>      [default: default] allow to switch between configurations (server or users)
-  --status=<option>  (required) Status to set
-                     <options: draft|live|closed|ignored>
+  -n, --name=<campaign>   name (technical short name, also called slug)
+      --end=YYYY-MM-DD    end date of the campaign
+      --env=<value>       [default: default] allow to switch between configurations (server or users)
+      --start=YYYY-MM-DD  start date of the campaign
+      --status=<option>   (required) Status to set
+                          <options: draft|live|closed|ignored>
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -354,9 +361,7 @@ ALIASES
   $ proca campaign close
 
 EXAMPLES
-  $ proca campaign close -name <campaign>
-
-  $ proca campaign close -i <campaign_id>
+  $ proca campaign close -name <campaign> --end=2025-01-02 --status=close
 ```
 
 ## `proca campaign copy`
@@ -526,12 +531,15 @@ EXAMPLES
 ```
 USAGE
   $ proca campaign status [ID_NAME_DXID] --status draft|live|closed|ignored [--json | --csv
-    | --markdown] [--env <value>] [--simplify]
+    | --markdown] [--env <value>] [--simplify] [-n <campaign>] [--start YYYY-MM-DD] [--end YYYY-MM-DD]
 
 FLAGS
-  --env=<value>      [default: default] allow to switch between configurations (server or users)
-  --status=<option>  (required) Status to set
-                     <options: draft|live|closed|ignored>
+  -n, --name=<campaign>   name (technical short name, also called slug)
+      --end=YYYY-MM-DD    end date of the campaign
+      --env=<value>       [default: default] allow to switch between configurations (server or users)
+      --start=YYYY-MM-DD  start date of the campaign
+      --status=<option>   (required) Status to set
+                          <options: draft|live|closed|ignored>
 
 OUTPUT FLAGS
   --csv            Format output as csv
@@ -543,9 +551,7 @@ ALIASES
   $ proca campaign close
 
 EXAMPLES
-  $ proca campaign status -name <campaign>
-
-  $ proca campaign status -i <campaign_id>
+  $ proca campaign status -name <campaign> --end=2025-01-02 --status=close
 ```
 
 ## `proca campaign widget archive`
@@ -961,18 +967,58 @@ EXAMPLES
   $ proca contact count --name <name of the campaign>
 ```
 
+## `proca contact delete`
+
+```
+USAGE
+  $ proca contact delete -c from contact get [--json | --csv | --markdown] [--env <value>]
+    [--simplify] [-n <org>]
+
+FLAGS
+  -c, --ref=from contact get  (required) contact reference
+  -n, --name=<org>            name (technical short name, also called slug)
+      --env=<value>           [default: default] allow to switch between configurations (server or users)
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --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
+```
+
+## `proca contact get`
+
+```
+USAGE
+  $ proca contact get -e <supporter@example.org> [--json | --csv | --markdown] [--env
+    <value>] [-n <org>] [--utm | --simplify] [--comment | ]
+
+FLAGS
+  -e, --email=<supporter@example.org>  (required) email of the supporter
+  -n, --name=<org>                     name (technical short name, also called slug)
+      --[no-]comment                   display the comment
+      --env=<value>                    [default: default] allow to switch between configurations (server or users)
+      --[no-]utm                       display the utm tracking parameters
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --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
+```
+
 ## `proca contact list`
 
 ```
 USAGE
-  $ proca contact list -o <organisation name> [--json | --csv | --markdown] [--env
-    <value>] [-c <campaign title>] [-n <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm |
-    --simplify] [--comment | ]
+  $ proca contact list [--json | --csv | --markdown] [--env <value>] [-n <org>] [-c
+    <campaign title>] [-n <value>] [--today | --after 2025-04-09] [--optin] [--testing] [--doi] [--utm | --simplify]
+    [--comment | ]
 
 FLAGS
   -c, --campaign=<campaign title>  name of the campaign, % for wildchar
   -n, --limit=<value>              max number of actions
-  -o, --org=<organisation name>    (required) campaigns of the organisation (coordinator or partner)
+  -n, --name=<org>                 name (technical short name, also called slug)
       --after=2025-04-09           only actions after a date
       --[no-]comment               display the comment
       --doi                        only export the double optin actions
@@ -987,9 +1033,6 @@ OUTPUT FLAGS
   --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
-
-EXAMPLES
-  $ proca contact list %pizza%
 ```
 
 ## `proca help [COMMAND]`
@@ -1126,10 +1169,10 @@ view a org
 ```
 USAGE
   $ proca org get [ID_NAME_DXID] [--json | --csv | --markdown] [--env <value>]
-    [--simplify] [-n <org name>] [--config] [--personaldata] [--processing] [--keys] [--campaigns] [--users]
+    [--simplify] [-n <org>] [--config] [--personaldata] [--processing] [--keys] [--campaigns] [--users]
 
 FLAGS
-  -n, --name=<org name>    name of the org
+  -n, --name=<org>         name (technical short name, also called slug)
   --[no-]campaigns
       --[no-]config        display the config
       --env=<value>        [default: default] allow to switch between configurations (server or users)
@@ -1151,6 +1194,36 @@ EXAMPLES
   $ proca org get <name of the ngo>
 ```
 
+## `proca org logo`
+
+add a logo to the org
+
+```
+USAGE
+  $ proca org logo [ID_NAME_DXID] [--json | --csv | --markdown] [--env <value>]
+    [--simplify] [-n <org>] [--url <value>] [--update]
+
+FLAGS
+  -n, --name=<org>   name (technical short name, also called slug)
+      --env=<value>  [default: default] allow to switch between configurations (server or users)
+      --[no-]update  use that url (and update it)
+      --url=<value>  use that url (and update it)
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --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
+  add a logo to the org
+
+EXAMPLES
+  $ proca org logo <name of the ngo>
+```
+
+_See code: [src/commands/org/logo.ts](https://github.com/fixthestatusquo/proca-cli/blob/v2.3.1/src/commands/org/logo.ts)_
+
 ## `proca org user get`
 
 list all the users
@@ -1654,12 +1727,12 @@ let a user join an organisation with a role
 
 ```
 USAGE
-  $ proca user join -o <org name> [--json | --csv | --markdown] [--env <value>]
-    [--simplify] [--role owner|campaigner|coordinator|translator] [-u <user email>]
+  $ proca user join [ID_NAME_DXID] [--json | --csv | --markdown] [--env <value>]
+    [--simplify] [-n <org>] [--role owner|campaigner|coordinator|translator] [-u <user email>]
 
 FLAGS
-  -o, --org=<org name>     (required) name of the org
-  -u, --user=<user email>  email
+  -n, --name=<org>         name (technical short name, also called slug)
+  -u, --user=<user email>  email, default current user
       --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>
@@ -1863,6 +1936,40 @@ DESCRIPTION
   Delete a widget
 ```
 
+## `proca widget external`
+
+Pull external counter and save it into a widget extra Supporter
+
+```
+USAGE
+  $ proca widget external [ID_NAME_DXID] [--json | --csv | --markdown] [--env <value>]
+    [--simplify] [-i <value> | -n <the_short_name> | -x <value>] [-u <value>] [--path object.sub-object.total] [--total
+    <value>] [--timeout <value>] [--dry-run]
+
+FLAGS
+  -i, --id=<value>
+  -n, --name=<the_short_name>         name (technical short name, also called slug)
+  -u, --url=<value>                   API endpoint URL to pull from
+  -x, --dxid=<value>                  dxid
+      --dry-run                       just fetch, don't update
+      --env=<value>                   [default: default] allow to switch between configurations (server or users)
+      --path=object.sub-object.total  dot notation path to the counter field in the json returned by the url
+      --timeout=<value>               [default: 10000] Request timeout in milliseconds
+      --total=<value>                 number to add to the total
+
+OUTPUT FLAGS
+  --csv            Format output as csv
+  --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
+  Pull external counter and save it into a widget extra Supporter
+
+EXAMPLES
+  $ proca widget external --url https://mitmachen.wwf.de/node/506/polling
+```
+
 ## `proca widget get`
 
 view a widget

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "proca",
   "description": "Access the proca api",
-  "version": "2.2.0",
+  "version": "2.3.1",
   "author": "Xavier",
   "bin": {
     "proca": "proca-cli"
@@ -19,6 +19,7 @@
     "fast-csv": "^5.0.1",
     "graphql": "^16.10.0",
     "merge-anything": "^6.0.6",
+    "object-path": "^0.11.8",
     "prompts": "^2.4.2",
     "typescript": "^5.7.3",
     "urql": "^4.1.0"

package/src/commands/campaign/get.mjs

@@ -74,6 +74,8 @@ export default class CampaignGet extends Command {
       Status: d.status,
       locales: d.config.locales && Object.keys(d.config.locales).join(" "),
       journey: d.config.journey?.join(" → "),
+      from: d.start?.substring(0, 10),
+      to: d.end?.substring(0, 10),
     };
     if (d.mtt) {
       // we have an mtt
@@ -83,8 +85,8 @@ export default class CampaignGet extends Command {
           minute: "2-digit",
           hour12: false,
         });
-      result.from = d.mtt.startAt.substring(0, 10);
-      result.to = d.mtt.endAt.substring(0, 10);
+      result["mtt from"] = d.mtt.startAt.substring(0, 10);
+      result["mttt to"] = d.mtt.endAt.substring(0, 10);
       result.period = `${hhmm(d.mtt.startAt)}↔${hhmm(d.mtt.endAt)}`;
       result["test email"] = d.mtt.testEmail;
       result["mtt template"] = d.mtt.template;

package/src/commands/campaign/status.mjs

@@ -8,8 +8,7 @@ export default class CampaignStatus extends Command {
   static aliases = ["campaign:close"];
 
   static examples = [
-    "<%= config.bin %> <%= command.id %> -name <campaign>",
-    "<%= config.bin %> <%= command.id %> -i <campaign_id>",
+    "<%= config.bin %> <%= command.id %> -name <campaign> --end=2025-01-02 --status=close",
   ];
 
   static isCloseCommand =
@@ -18,46 +17,72 @@ export default class CampaignStatus extends Command {
     this.id?.includes("close");
 
   static flags = {
+    ...this.flagify({ name: "campaign" }),
     status: Flags.string({
-      ...this.flagify({ multiid: true }),
       description: "Status to set",
       required: true,
       default: this.isCloseCommand ? "close" : undefined,
       options: ["draft", "live", "closed", "ignored"],
     }),
+    start: Flags.string({
+      description: "start date of the campaign",
+      helpValue: "YYYY-MM-DD",
+      parse: async (input) => {
+        const date = new Date(input);
+        if (Number.isNaN(date.getTime())) {
+          throw new Error(`Invalid date: ${input}`);
+        }
+        return date;
+      },
+    }),
+    end: Flags.string({
+      description: "end date of the campaign",
+      helpValue: "YYYY-MM-DD",
+      parse: async (input) => {
+        const date = new Date(input);
+        if (Number.isNaN(date.getTime())) {
+          throw new Error(`Invalid date: ${input}`);
+        }
+        return date;
+      },
+    }),
   };
 
   updateStatus = async (props) => {
     const Query = gql`
 mutation (
-$id: Int,
+$id: Int
 $name: String
-$status: String!
+$input: CampaignInput!
 ) {
-  updateCampaign (id:$id, input: { name: $name,status: $status }) {
+  updateCampaign (id:$id, name: $name, input: $input) {
     name
     org {name}
     status
+    start
+    end
     title
   }
-}
-    `;
+}`;
+    const input = {
+      status: props.status.toUpperCase(),
+    };
 
     const result = await mutation(Query, {
       //			org: props.org,
       id: props.id,
       name: props.name,
-      status: props.status.toUpperCase(),
+      input: input,
     });
 
-    console.log("result", result);
     return result.updateCampaign;
   };
 
   async run() {
-    const { args, flags } = await this.parse();
+    const { flags } = await this.parse();
 
     const data = await this.updateStatus(flags);
-    return this.output(data);
+
+    return this.output(data, { single: true });
   }
 }

package/src/commands/contact/delete.mjs

@@ -0,0 +1,43 @@
+import { Args, Flags } from "@oclif/core";
+import { error, stdout, ux } from "@oclif/core/ux";
+import { formatDistanceToNowStrict } from "date-fns";
+import Command from "#src/procaCommand.mjs";
+import {
+  FragmentOrg,
+  FragmentStats,
+  FragmentSummary,
+} from "#src/queries/campaign.mjs";
+import { gql, mutation } from "#src/urql.mjs";
+
+export default class Delete extends Command {
+  static flags = {
+    ...this.flagify({ name: "org", char: "o" }),
+    ref: Flags.string({
+      char: "c",
+      required: true,
+      description: "contact reference",
+      helpValue: "from contact get",
+    }),
+  };
+
+  delete = async (ref, org) => {
+    const DeleteDocument = gql`mutation delete($ref: String!, $org: String!) {
+  deleteContact (contactRef: $ref, orgName: $org) 
+}`;
+
+    const r = await mutation(DeleteDocument, {
+      ref,
+      org,
+    });
+    if (r.errors) {
+      throw new Error(r.errors[0].message || "can't delete");
+    }
+    return r;
+  };
+
+  async run() {
+    const { flags } = await this.parse();
+    const data = await this.delete(flags.ref, flags.name);
+    return this.output(data);
+  }
+}

package/src/commands/contact/get.mjs

@@ -0,0 +1,137 @@
+import { Args, Flags } from "@oclif/core";
+import { error, stdout, ux } from "@oclif/core/ux";
+import { formatDistanceToNowStrict } from "date-fns";
+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 Get extends Command {
+  static flags = {
+    ...this.flagify({ name: "org", char: "o" }),
+    email: Flags.string({
+      char: "e",
+      required: true,
+      description: "email of the supporter",
+      helpValue: "<supporter@example.org>",
+    }),
+    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 (
+        $orgName: String!
+        $email: String!
+      ) {
+        contacts(
+          orgName: $orgName
+          email: $email
+        ) {
+          actionId
+          actionPage {
+            id
+            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, {
+      orgName: flags.name,
+      email: flags.email,
+    });
+    return result.contacts.map((d) => {
+      d.customFields = JSON.parse(d.customFields);
+      if (!d.contact.publicKey) {
+        const ref = d.contact.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 = {
+      contactRef: d.contact.contactRef,
+      firstname: d.contact.firstName,
+      country: d.contact.country,
+      email: d.contact.email,
+      type: d.actionType,
+      date: formatDistanceToNowStrict(d.createdAt),
+      campaign: !this.flags.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 (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;
+    }
+    if (d.customFields?.emailProvider)
+      result.provider = d.customFields.emailProvider;
+    return result;
+  };
+
+  async run() {
+    const { flags } = await this.parse();
+    const data = await this.fetch(flags);
+    return this.output(data, { single: true });
+  }
+}

package/src/commands/contact/list.mjs

@@ -12,18 +12,9 @@ import { gql, query } from "#src/urql.mjs";
 export default class List extends Command {
   actionTypes = new Set();
 
-  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>",
-    }),
+    ...this.flagify({ name: "org", char: "o" }),
     campaign: Flags.string({
       char: "c",
       description: "name of the campaign, % for wildchar",
@@ -138,7 +129,7 @@ export default class List extends Command {
       limit: flags.limit,
       onlyDoubleOptIn: flags.doi,
       onlyOptIn: flags.optin,
-      orgName: flags.org,
+      orgName: flags.name,
       start: flags.start,
     });
     return result.contacts.map((d) => {

package/src/commands/org/get.mjs

@@ -18,13 +18,7 @@ export default class OrgGet extends Command {
 
   static flags = {
     // flag with no value (-f, --force)
-    ...this.flagify({ multiid: false }),
-    name: Flags.string({
-      char: "n",
-      charAliases: ["o"],
-      description: "name of the org",
-      helpValue: "<org name>",
-    }),
+    ...this.flagify({ multiid: false, name: "org", char: "o" }),
     config: Flags.boolean({
       description: "display the config",
       default: false,
@@ -113,8 +107,10 @@ export default class OrgGet extends Command {
   simplify = (d) => {
     const result = {
       id: d.id,
-      Name: d.name,
-      Title: d.title,
+      name: d.name,
+      title: d.title,
+      url: d.config?.url,
+      logo: d.config?.logo,
       "can targets reply?": d.replyEnabled ? true : undefined,
       "confirm actions?": d.supporterConfirm
         ? d.supporterConfirmTemplate
@@ -142,9 +138,7 @@ export default class OrgGet extends Command {
   };
 
   async run() {
-    console.log("starting");
     const { flags } = await this.parse();
-    console.log("flags", this.Flags);
 
     const data = await this.fetch(flags);
     return this.output(data);

package/src/commands/org/logo.js

@@ -0,0 +1,116 @@
+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/org.mjs";
+import { gql, mutation } from "#src/urql.mjs";
+import { getOrg } from "./get.mjs";
+
+export default class OrgLogo extends Command {
+  static description = "add a logo to the org";
+
+  static examples = ["<%= config.bin %> <%= command.id %> <name of the ngo>"];
+
+  static args = this.multiid();
+
+  static flags = {
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: false, name: "org", char: "o" }),
+    url: Flags.string({
+      description: "use that url (and update it)",
+    }),
+    update: Flags.boolean({
+      default: true,
+      allowNo: true,
+      description: "use that url (and update it)",
+    }),
+  };
+
+  toProxyUrl = (pic) => {
+    const url = new URL(pic);
+    if (!url.hostname.endsWith("gstatic.com")) return googleUrl;
+    const sub = url.hostname.split(".")[0];
+    const domain = new URL(url.searchParams.get("url")).hostname;
+    return `https://pic.proca.app/favicon/${sub}/${domain}`;
+  };
+
+  fetchLogoUrl = async (domain) => {
+    const res = await fetch(
+      `https://www.google.com/s2/favicons?sz=128&domain=${domain}`,
+      { redirect: "manual" }, // don't follow — we want the Location header
+    );
+    const location = res.headers.get("location");
+    if (!location) throw new Error(`No redirect for ${domain}`);
+    return this.toProxyUrl(location);
+  };
+  update = async ({ name, config }) => {
+    const input = {};
+
+    input.config = typeof config === "string" ? config : JSON.stringify(config);
+
+    const Document = gql`
+      mutation update(
+        $orgName: String!
+        $input: OrgInput!
+      ) {
+        updateOrg(
+          name: $orgName
+          input: $input
+        ) {
+          id, name, config
+        }
+      }
+    `;
+
+    try {
+      console.log({
+        orgName: name,
+        input,
+      });
+      const r = await mutation(Document, {
+        orgName: name,
+        input,
+      });
+      return { id: r.updateOrg };
+    } catch (e) {
+      const err = e.graphQLErrors?.[0];
+
+      if (err?.extensions?.code === "permission_denied") {
+        this.error(`permission denied to update org ${name}`);
+      }
+      throw new Error(err?.message ?? "failed to update org");
+    }
+  };
+
+  table = (r) => {
+    super.table(r, null, null);
+    if (this.flags.config) {
+      r.config.locales = undefined;
+      this.prettyJson(r.config);
+    }
+  };
+
+  async run() {
+    const { flags } = await this.parse();
+    let logo;
+    let org;
+    if (flags.url) {
+      logo = await this.fetchLogoUrl(flags.url);
+    }
+    try {
+      org = await getOrg(flags);
+    } catch (e) {
+      this.output({ error: "user not a member of org", org: flags.name, logo });
+      return;
+    }
+    if (!logo) logo = await this.fetchLogoUrl(org.config.url);
+    org.config.logo = logo;
+    if (flags.update) {
+      if (!org.config.url) {
+        org.config.url = flags.url;
+      }
+      const r = this.update({ name: flags.name, config: org.config });
+      return this.output(r);
+    }
+    return this.output({ logo, name: flags.name });
+  }
+}

package/src/commands/user/join.mjs

@@ -8,22 +8,19 @@ export default class UserJoinOrg extends Command {
 
   static examples = ["<%= config.bin %> <%= command.id %>"];
 
+  static args = this.multiid();
+
   static flags = {
-    ...super.globalFlags,
+    // flag with no value (-f, --force)
+    ...this.flagify({ multiid: false, name: "org", char: "o" }),
     role: Flags.string({
       description: "permission level in that org",
       default: "campaigner",
       options: ["owner", "campaigner", "coordinator", "translator"],
     }),
-    org: Flags.string({
-      char: "o",
-      required: true,
-      description: "name of the org",
-      helpValue: "<org name>",
-    }),
     user: Flags.string({
       char: "u",
-      description: "email",
+      description: "email, default current user",
       helpValue: "<user email>",
     }),
   };
@@ -58,7 +55,7 @@ mutation ($org: String!, $user: String!, $role: String = "campaigner") {
     `;
     const result = await mutation(Document, {
       user: params.user,
-      org: params.org,
+      org: params.name,
       role: params.role,
     });
     return result.addOrgUser;
@@ -69,10 +66,10 @@ mutation ($org: String!, $user: String!, $role: String = "campaigner") {
   };
 
   async run() {
-    const { args, flags } = await this.parse();
+    const { flags } = await this.parse();
     let data = undefined;
     if (!flags.user) {
-      data = await this.join(flags.org);
+      data = await this.join(flags.name);
     } else {
       data = await this.mutate(flags);
     }

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

@@ -0,0 +1,109 @@
+import { readFile } from "node:fs/promises";
+import { Flags } from "@oclif/core";
+import oPath from "object-path";
+import { updateCounter } from "#src/commands/widget/update/external.mjs";
+import Command from "#src/procaCommand.mjs";
+
+export default class CounterExternal extends Command {
+  static description =
+    "Pull external counter and save it into a widget extra Supporter";
+
+  static examples = [
+    "<%= config.bin %> <%= command.id %> --url https://mitmachen.wwf.de/node/506/polling",
+  ];
+  static args = this.multiid();
+
+  static flags = {
+    ...this.flagify({ multiid: true }),
+    url: Flags.string({
+      char: "u",
+      description: "API endpoint URL to pull from",
+      relationships: [{ type: "some", flags: ["path", "dry-run"] }],
+    }),
+    path: Flags.string({
+      helpValue: "object.sub-object.total",
+      description:
+        "dot notation path to the counter field in the json returned by the url",
+    }),
+    total: Flags.integer({
+      description: "number to add to the total",
+      relationships: [
+        // define complex relationships between flags
+        { type: "none", flags: ["url", "path"] },
+      ],
+    }),
+    timeout: Flags.integer({
+      description: "Request timeout in milliseconds",
+      default: 10000,
+    }),
+    "dry-run": Flags.boolean({
+      description: "just fetch, don't update",
+    }),
+  };
+
+  async fetchCounter({ url, path, timeout, "dry-run": verbose }) {
+    const response = await fetch(url, {
+      timeout,
+      headers: {
+        "User-Agent": "proca",
+      },
+    });
+
+    if (!response.ok) {
+      this.error(`API request failed with status ${response.status}`, {
+        exit: 1,
+      });
+    }
+
+    const data = await response.json();
+    if (verbose) {
+      this.log(JSON.stringify(data, null, 2));
+    }
+    const counter = oPath.get(data, path);
+    if (Number.isNaN(Number.parseFloat(counter)) || !Number.isFinite(counter)) {
+      this.error(`Could not extract value from ${counter} at ${path}`, {
+        exit: 1,
+      });
+    }
+    return Number.parseFloat(counter);
+  }
+
+  async getCounterConfig(id) {
+    const folder = this.procaConfig.folder;
+    const filePath = `${folder}/${id}.json`;
+
+    const data = await readFile(filePath, "utf8");
+    const jsonData = JSON.parse(data);
+    return jsonData.component.counter;
+  }
+
+  async run() {
+    const { flags } = await this.parse(CounterExternal);
+    let counter = undefined;
+    if (!flags.url) {
+      const config = await this.getCounterConfig(flags.id);
+      flags.url = config.url;
+      flags.path = config.path;
+    }
+
+    if (flags.url) {
+      counter = await this.fetchCounter(flags);
+    }
+    if (flags.total) {
+      counter = flags.total;
+    }
+    if (flags["dry-run"]) {
+      return this.output(
+        {
+          counter,
+          url: flags.url,
+          //            response: JSON.stringify(data, null, 2),
+        },
+        { single: true },
+      );
+    }
+
+    const updated = await updateCounter(flags.id, counter);
+    return this.output(updated, { single: true });
+  }
+}

package/src/procaCommand.mjs

@@ -50,16 +50,18 @@ class ProcaCommand extends Command {
     return args;
   }
 
-  static flagify({ multiid = false, name = false } = {}) {
+  static flagify({ multiid = false, name = false, char } = {}) {
     const flags = Object.assign({}, ProcaCommand.baseFlags);
     if (name || multiid) {
       flags.name = Flags.string({
         char: "n",
+        charAliases: char ? ["n", char] : undefined,
         description: "name (technical short name, also called slug)",
         helpValue: typeof name === "string" ? `<${name}>` : "<the_short_name>",
         parse: (input) => ProcaCommand.safeName(input),
       });
     }
+
     if (multiid) {
       flags.id = Flags.string({
         char: "i",
@@ -75,7 +77,7 @@ class ProcaCommand extends Command {
   }
 
   static safeName = (input) => {
-    const pattern = /^[a-zA-Z0-9\-_]+$/;
+    const pattern = /^[a-zA-Z0-9\-_\/]+$/;
     if (!pattern.test(input)) {
       throw new Error(`Invalid characters in: ${input}`);
     }
@@ -157,6 +159,10 @@ class ProcaCommand extends Command {
     }
 
     if (err.networkError) {
+      if (err.response.status === 500) {
+        this.error("500 Internal Server Error", { exit: err.code || 1 });
+        return;
+      }
       this.info("Looks like there’s a problem with your internet connection");
       this.error(err.networkError.cause, { exit: err.code || 1 });
     }
@@ -286,7 +292,7 @@ class ProcaCommand extends Command {
   table(data, transformRow, print = (table) => table.toString()) {
     if (!transformRow) {
       if (this.flags.simplify !== false) {
-        transformRow = (d, cell, idx) => {
+        transformRow = (d, cell) => {
           const r = this.simplify(d);
           if (r === null) return null;
           for (const [key, value] of Object.entries(r)) {
@@ -295,7 +301,7 @@ class ProcaCommand extends Command {
           return true;
         };
       } else {
-        transformRow = (d, cell, idx) => {
+        transformRow = (d, cell) => {
           for (const [key, value] of Object.entries(this.flatten(d))) {
             cell(key, value);
           }
@@ -316,15 +322,18 @@ class ProcaCommand extends Command {
       }, this);
       return this.newRow();
     };
-
     this.log(Table.print(data, transformRow, print));
   }
 
   single = (r) => {
-    this.table(r, null, null);
+    return this.table(r[0], null, null);
   };
 
   async output(data, { single = false } = {}) {
+    if (!Array.isArray(data)) {
+      data = [data];
+      single = true;
+    }
     if (this.format === "json") {
       if (this.flags.simplify)
         return data?.map(this.simplify) || this.simplify(data);

package/src/queries/campaign.mjs

@@ -1,6 +1,6 @@
 import { gql } from "#src/urql.mjs";
 
-export const FragmentSummary = gql`fragment Summary on Campaign {id name title externalId status}`;
+export const FragmentSummary = gql`fragment Summary on Campaign {id name title externalId status start end}`;
 
 export const FragmentMtt = gql`
       fragment Mtt on PrivateCampaign {

package/src/urql.mjs

@@ -51,7 +51,6 @@ export const query = async (query, payload) => {
 export const mutation = async (mutation, payload) => {
   const result = await client.mutation(mutation, payload).toPromise();
   if (result.error) {
-    console.log("error", result.error);
     throw result.error;
   }
   return result.data;