Basecamp usability improvements

components/basecamp/actions/create-campfire-chatbot-message/create-campfire-chatbot-message.mjs

@@ -1,28 +1,14 @@
 import app from "../../basecamp.app.mjs";
+import common from "../../common/common.mjs";
 
 export default {
   key: "basecamp-create-campfire-chatbot-message",
   name: "Create Campfire Chatbot Message",
-  description: "Creates a line in the Campfire for a Basecamp Chatbot. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/chatbots.md#create-a-line)",
+  description: "Creates a message in a Campfire for a Basecamp Chatbot. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/chatbots.md#create-a-line)",
   type: "action",
-  version: "0.0.3",
+  version: "0.0.4",
   props: {
-    app,
-    accountId: {
-      propDefinition: [
-        app,
-        "accountId",
-      ],
-    },
-    projectId: {
-      propDefinition: [
-        app,
-        "projectId",
-        ({ accountId }) => ({
-          accountId,
-        }),
-      ],
-    },
+    ...common.props,
     campfireId: {
       propDefinition: [
         app,
@@ -54,7 +40,7 @@ export default {
     content: {
       type: "string",
       label: "Content",
-      description: "The plain text body for the Campfire line.",
+      description: "The plain text body for the Campfire message.",
     },
   },
   async run({ $ }) {
@@ -84,7 +70,7 @@ export default {
       },
     });
 
-    $.export("$summary", "Successfully posted campfire chatbot message.");
+    $.export("$summary", "Successfully posted campfire chatbot message");
     return message;
   },
 };

components/basecamp/actions/create-campfire-message/create-campfire-message.mjs

@@ -1,28 +1,14 @@
 import app from "../../basecamp.app.mjs";
+import common from "../../common/common.mjs";
 
 export default {
   key: "basecamp-create-campfire-message",
   name: "Create Campfire Message",
-  description: "Creates a line in the Campfire for the selected project. [See the docs here](https://github.com/basecamp/bc3-api/blob/master/sections/campfires.md#create-a-campfire-line)",
+  description: "Creates a message in a selected Campfire. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/campfires.md#create-a-campfire-line)",
   type: "action",
-  version: "0.0.7",
+  version: "0.0.8",
   props: {
-    app,
-    accountId: {
-      propDefinition: [
-        app,
-        "accountId",
-      ],
-    },
-    projectId: {
-      propDefinition: [
-        app,
-        "projectId",
-        ({ accountId }) => ({
-          accountId,
-        }),
-      ],
-    },
+    ...common.props,
     campfireId: {
       propDefinition: [
         app,
@@ -39,7 +25,7 @@ export default {
     content: {
       type: "string",
       label: "Content",
-      description: "The plain text body for the Campfire line.",
+      description: "The plain text body for the Campfire message.",
     },
   },
   async run({ $ }) {
@@ -60,7 +46,7 @@ export default {
       },
     });
 
-    $.export("$summary", `Successfully posted campfire message with ID ${message.id}`);
+    $.export("$summary", `Successfully created campfire message (ID: ${message.id})`);
     return message;
   },
 };

components/basecamp/actions/create-card/create-card.mjs

@@ -1,28 +1,14 @@
 import app from "../../basecamp.app.mjs";
+import common from "../../common/common.mjs";
 
 export default {
   key: "basecamp-create-card",
   name: "Create a Card",
-  description: "Creates a card in the select column. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/card_table_cards.md#create-a-card)",
+  description: "Creates a card in a selected column. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/card_table_cards.md#create-a-card)",
   type: "action",
-  version: "0.1.0",
+  version: "0.1.1",
   props: {
-    app,
-    accountId: {
-      propDefinition: [
-        app,
-        "accountId",
-      ],
-    },
-    projectId: {
-      propDefinition: [
-        app,
-        "projectId",
-        ({ accountId }) => ({
-          accountId,
-        }),
-      ],
-    },
+    ...common.props,
     cardTableId: {
       propDefinition: [
         app,
@@ -51,25 +37,26 @@ export default {
     title: {
       type: "string",
       label: "Title",
-      description: "Title of the card",
+      description: "The title of the new card.",
     },
     content: {
       type: "string",
       label: "Content",
-      description: "Content of the card",
+      description: "The content of the card. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/card_table_cards.md#create-a-card) for information on using HTML tags.",
       optional: true,
     },
     dueOn: {
       type: "string",
-      label: "Due on",
-      description: "Due date (ISO 8601) of the card, e.g.: `2023-12-12`",
+      label: "Due On",
+      description: "The due date of the card, in `YYYY-MM-DD` format.",
       optional: true,
     },
     notify: {
       type: "boolean",
-      label: "Notify",
-      description: "Whether to notify assignees. Defaults to false",
+      label: "Notify Assignees",
+      description: "Whether to notify assignees.",
       optional: true,
+      default: false,
     },
   },
   async run({ $ }) {
@@ -96,7 +83,7 @@ export default {
       },
     });
 
-    $.export("$summary", `Successfully created card with ID ${card.id}`);
+    $.export("$summary", `Successfully created card (ID: ${card.id})`);
     return card;
   },
 };

components/basecamp/actions/create-comment/create-comment.mjs

@@ -1,28 +1,14 @@
 import app from "../../basecamp.app.mjs";
+import common from "../../common/common.mjs";
 
 export default {
   key: "basecamp-create-comment",
   name: "Create a Comment",
-  description: "Publishes a comment to the select recording. [See the docs here](https://github.com/basecamp/bc3-api/blob/master/sections/comments.md#create-a-comment)",
+  description: "Creates a comment in a selected recording. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/comments.md#create-a-comment)",
   type: "action",
-  version: "0.0.7",
+  version: "0.0.8",
   props: {
-    app,
-    accountId: {
-      propDefinition: [
-        app,
-        "accountId",
-      ],
-    },
-    projectId: {
-      propDefinition: [
-        app,
-        "projectId",
-        ({ accountId }) => ({
-          accountId,
-        }),
-      ],
-    },
+    ...common.props,
     recordingType: {
       propDefinition: [
         app,
@@ -47,7 +33,7 @@ export default {
     content: {
       type: "string",
       label: "Content",
-      description: "The body of the comment. See [Rich text guide](https://github.com/basecamp/bc3-api/blob/master/sections/rich_text.md) for what HTML tags are allowed.",
+      description: "The body of the comment. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/comments.md#create-a-comment) for information on using HTML tags.",
     },
   },
   async run({ $ }) {
@@ -68,7 +54,7 @@ export default {
       },
     });
 
-    $.export("$summary", `Successfully posted comment with ID ${comment.id}`);
+    $.export("$summary", `Successfully posted comment (ID: ${comment.id})`);
     return comment;
   },
 };

components/basecamp/actions/create-message/create-message.mjs

@@ -1,28 +1,14 @@
 import app from "../../basecamp.app.mjs";
+import common from "../../common/common.mjs";
 
 export default {
   key: "basecamp-create-message",
   name: "Create Message",
-  description: "Publishes a message in the project and message board selected. [See the docs here](https://github.com/basecamp/bc3-api/blob/master/sections/messages.md#create-a-message)",
+  description: "Creates a message in a selected message board. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/messages.md#create-a-message)",
   type: "action",
-  version: "0.0.7",
+  version: "0.0.8",
   props: {
-    app,
-    accountId: {
-      propDefinition: [
-        app,
-        "accountId",
-      ],
-    },
-    projectId: {
-      propDefinition: [
-        app,
-        "projectId",
-        ({ accountId }) => ({
-          accountId,
-        }),
-      ],
-    },
+    ...common.props,
     messageBoardId: {
       propDefinition: [
         app,
@@ -44,7 +30,7 @@ export default {
     content: {
       type: "string",
       label: "Content",
-      description: "The body of the message. See [Rich text guide](https://github.com/basecamp/bc3-api/blob/master/sections/rich_text.md) for what HTML tags are allowed.",
+      description: "The body of the message. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/messages.md#create-a-message) for information on using HTML tags.",
       optional: true,
     },
     messageTypeId: {
@@ -85,7 +71,7 @@ export default {
       },
     });
 
-    $.export("$summary", `Successfully posted message with ID ${message.id}`);
+    $.export("$summary", `Successfully posted message (ID: ${message.id})`);
     return message;
   },
 };

components/basecamp/actions/create-todo-item/create-todo-item.mjs

@@ -1,28 +1,14 @@
 import app from "../../basecamp.app.mjs";
+import common from "../../common/common.mjs";
 
 export default {
   key: "basecamp-create-todo-item",
-  name: "Create Todo Item",
-  description: "Creates a todo in the project and message board selected. [See the docs here](https://github.com/basecamp/bc3-api/blob/master/sections/todos.md#create-a-to-do)",
+  name: "Create To-do Item",
+  description: "Creates a to-do item in a selected to-do list. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/todos.md#create-a-to-do)",
   type: "action",
-  version: "0.0.7",
+  version: "0.0.8",
   props: {
-    app,
-    accountId: {
-      propDefinition: [
-        app,
-        "accountId",
-      ],
-    },
-    projectId: {
-      propDefinition: [
-        app,
-        "projectId",
-        ({ accountId }) => ({
-          accountId,
-        }),
-      ],
-    },
+    ...common.props,
     todoSetId: {
       propDefinition: [
         app,
@@ -53,13 +39,13 @@ export default {
     },
     content: {
       type: "string",
-      label: "Content",
-      description: "The title of the todo item.",
+      label: "Title (Content)",
+      description: "The title of the to-do item.",
     },
     description: {
       type: "string",
       label: "Description",
-      description: "Containing information about the to-do.  See [Rich text guide](https://github.com/basecamp/bc3-api/blob/master/sections/rich_text.md) for what HTML tags are allowed.",
+      description: "Description of the item. [See the documentation](https://github.com/basecamp/bc3-api/blob/master/sections/todos.md#create-a-to-do) for information on using HTML tags.",
       optional: true,
     },
     assigneeIds: {
@@ -75,19 +61,19 @@ export default {
         }),
       ],
       label: "Assignee",
-      description: "An array of people that will be assigned to this to-do.",
+      description: "One or more people to be assigned to this item.",
       optional: true,
     },
     dueOn: {
       type: "string",
-      label: "Due on",
-      description: "A date when the to-do should be completed. format: `yyyy-mm-dd`.",
+      label: "Due On",
+      description: "The due date when the item should be completed, in `YYYY-MM-DD` format.`",
       optional: true,
     },
     startsOn: {
       type: "string",
-      label: "Starts on",
-      description: "Allows the to-do to run from this date to the due date. format: `yyyy-mm-dd`.",
+      label: "Starts On",
+      description: "The start date, in `YYYY-MM-DD` format. Allows the item to run from this date to the `Due Date`.",
       optional: true,
     },
   },
@@ -117,7 +103,7 @@ export default {
       },
     });
 
-    $.export("$summary", `Successfully created todo with ID ${todo.id}`);
+    $.export("$summary", `Successfully created to-do (ID: ${todo.id})`);
     return todo;
   },
 };