PCC-1523 Add collaborator and visibility management commands.

packages/cli/src/cli/commands/sites/collaborators.ts

@@ -0,0 +1,31 @@
+import ora from "ora";
+import AddOnApiHelper from "../../../lib/addonApiHelper";
+import { errorHandler } from "../../exceptions";
+
+type listCollaboratorsSchemaParams = { siteId: string };
+export const listCollaborators = errorHandler<listCollaboratorsSchemaParams>(
+  async ({ siteId }: listCollaboratorsSchemaParams) => {
+    const spinner = ora("Retrieving Collaborators...").start();
+    const result = await AddOnApiHelper.listCollaborators(siteId);
+    spinner.succeed();
+    console.log(JSON.stringify(result, null, 4));
+  },
+);
+
+type removeCollaboratorschemaParams = { siteId: string; email: string };
+export const removeCollaborator = errorHandler<removeCollaboratorschemaParams>(
+  async ({ siteId, email }: removeCollaboratorschemaParams) => {
+    const spinner = ora("Removing Collaborator...").start();
+    await AddOnApiHelper.removeCollaborator(siteId, email);
+    spinner.succeed();
+  },
+);
+
+type addCollaboratorschemaParams = { siteId: string; email: string };
+export const addCollaborator = errorHandler<addCollaboratorschemaParams>(
+  async ({ siteId, email }: addCollaboratorschemaParams) => {
+    const spinner = ora("Adding Collaborator...").start();
+    await AddOnApiHelper.addCollaborator(siteId, email);
+    spinner.succeed();
+  },
+);

packages/cli/src/cli/commands/sites/site.ts

@@ -133,6 +133,14 @@
       type: "string",
     },
   },
+  {
+    id: "visibility",
+    command: {
+      name: "visibility <visibility>",
+      description: "Set the collection's visibility (either 'private' or 'workspace')",
+      type: "string",
+    },
+  },
 ] as const;
 
 export const SITE_EXAMPLES = [

packages/cli/src/cli/index.ts

@@ -20,6 +20,11 @@ import {
   listAdminsSchema,
   removeAdminSchema,
 } from "./commands/sites/admins";
+import {
+  addCollaborator,
+  listCollaborators,
+  removeCollaborator,
+} from "./commands/sites/collaborators";
 import {
   getComponentSchema,
   printLiveComponentSchema,
@@ -599,6 +604,101 @@ yargs(hideBin(process.argv))
               );
           },
         )
+        .command(
+          "publishing <cmd> [options]",
+          "Manage publishing permissions.",
+          (yargs) => {
+            yargs
+              .strictCommands()
+              .demandCommand()
+              .command(
+                "config [options]",
+                "Update the collection's visibility.",
+                (yargs) => {
+                  yargs
+                    .strictCommands()
+                    .option("siteId", {
+                      describe: "The id of the collection to modify.",
+                      demandOption: true,
+                      type: "string",
+                    })
+                    .option("mode", {
+                      describe:
+                        "The visibility of this collection (either 'private' or 'workspace').",
+                      demandOption: true,
+                      type: "string",
+                    });
+                },
+                async (args) =>
+                  await updateSiteConfig({
+                    id: args.siteId as string,
+                    visibility: args.mode as string,
+                  }),
+              )
+              .command(
+                "list-user [options]",
+                "Print the users added as collaborators to this collection.",
+                (yargs) => {
+                  yargs.strictCommands().option("siteId", {
+                    describe: "The id of the collection to modify.",
+                    demandOption: true,
+                    type: "string",
+                  });
+                },
+                async (args) =>
+                  await listCollaborators({
+                    siteId: args.siteId as string,
+                  }),
+              )
+              .command(
+                "add-user [options]",
+                "Update the collection's visibility.",
+                (yargs) => {
+                  yargs
+                    .strictCommands()
+                    .option("siteId", {
+                      describe: "The id of the collection to modify.",
+                      demandOption: true,
+                      type: "string",
+                    })
+                    .option("user", {
+                      describe: "The email of the user to add.",
+                      demandOption: true,
+                      type: "string",
+                    });
+                },
+                async (args) =>
+                  await addCollaborator({
+                    siteId: args.siteId as string,
+                    email: args.user as string,
+                  }),
+              )
+              .command(
+                "remove-user [options]",
+                "Update the collection's visibility.",
+                (yargs) => {
+                  yargs
+                    .strictCommands()
+                    .option("siteId", {
+                      describe: "The id of the collection to modify.",
+                      demandOption: true,
+                      type: "string",
+                    })
+                    .option("user", {
+                      describe: "The email of the user to remove.",
+                      demandOption: true,
+                      type: "string",
+                    });
+                },
+                async (args) =>
+                  await removeCollaborator({
+                    siteId: args.siteId as string,
+                    email: args.user as string,
+                  }),
+              );
+          },
+          async (args) => await createSite(args.url as string),
+        )
         .example(formatExamples(SITE_EXAMPLES));
     },
     async () => {

packages/cli/src/lib/addonApiHelper.ts

@@ -449,6 +449,53 @@
     });
   }
 
+  static async listCollaborators(id: string): Promise<void> {
+    const idToken = await this.getIdToken();
+
+    return (
+      await axios.get(
+        `${(await getApiConfig()).SITE_ENDPOINT}/${id}/collaborators`,
+        {
+          headers: {
+            Authorization: `Bearer ${idToken}`,
+          },
+        },
+      )
+    ).data;
+  }
+
+  static async addCollaborator(id: string, email: string): Promise<void> {
+    const idToken = await this.getIdToken();
+
+    await axios.patch(
+      `${(await getApiConfig()).SITE_ENDPOINT}/${id}/collaborators`,
+      {
+        email,
+      },
+      {
+        headers: {
+          Authorization: `Bearer ${idToken}`,
+        },
+      },
+    );
+  }
+
+  static async removeCollaborator(id: string, email: string): Promise<void> {
+    const idToken = await this.getIdToken();
+
+    await axios.delete(
+      `${(await getApiConfig()).SITE_ENDPOINT}/${id}/collaborators`,
+      {
+        headers: {
+          Authorization: `Bearer ${idToken}`,
+        },
+        data: {
+          email,
+        },
+      },
+    );
+  }
+
   static async updateSiteConfig(
     id: string,
     {