Address CodeRabbit review feedback

- Use propDefinition for leadId in create-or-update-lead action for consistency
- Remove PR_STEPS.md file (internal documentation)
- Add JSDoc comments to all API methods in adversus.app.mjs

Author: harshasiddartha

components/adversus/PR_STEPS.md

@@ -38,8 +38,10 @@ export default {
       optional: true,
     },
     leadId: {
-      type: "string",
-      label: "Lead ID",
+      propDefinition: [
+        adversus,
+        "leadId",
+      ],
       description: "The ID of the lead to update (leave empty to create a new lead)",
       optional: true,
     },

components/adversus/actions/create-or-update-lead/create-or-update-lead.mjs

@@ -44,34 +44,64 @@ export default {
         ...opts,
       });
     },
+    /**
+     * Create a new lead in Adversus
+     * @param {Object} opts - Request options including data payload
+     * @returns {Promise} The created lead response
+     */
     async createLead(opts) {
       return this._makeRequest({
         path: "/leads",
         method: "POST",
         ...opts,
       });
     },
+    /**
+     * Update an existing lead in Adversus
+     * @param {string} leadId - The ID of the lead to update
+     * @param {Object} opts - Request options including data payload
+     * @returns {Promise} The updated lead response
+     */
     async updateLead(leadId, opts) {
       return this._makeRequest({
         path: `/leads/${leadId}`,
         method: "PUT",
         ...opts,
       });
     },
+    /**
+     * Add a note to a lead in Adversus
+     * @param {string} leadId - The ID of the lead
+     * @param {Object} opts - Request options including note data
+     * @returns {Promise} The response from adding the note
+     */
     async addNoteToLead(leadId, opts) {
       return this._makeRequest({
         path: `/leads/${leadId}/notes`,
         method: "POST",
         ...opts,
       });
     },
+    /**
+     * Add an activity to a lead in Adversus
+     * @param {string} leadId - The ID of the lead
+     * @param {Object} opts - Request options including activity data
+     * @returns {Promise} The response from adding the activity
+     */
     async addActivityToLead(leadId, opts) {
       return this._makeRequest({
         path: `/leads/${leadId}/activities`,
         method: "POST",
         ...opts,
       });
     },
+    /**
+     * Change the status of a lead in Adversus
+     * @param {string} leadId - The ID of the lead
+     * @param {string} statusId - The ID of the new status
+     * @param {Object} opts - Additional request options
+     * @returns {Promise} The response from changing the status
+     */
     async changeLeadStatus(leadId, statusId, opts = {}) {
       const { data: optsData, ...restOpts } = opts;
       return this._makeRequest({
@@ -84,6 +114,13 @@ export default {
         ...restOpts,
       });
     },
+    /**
+     * Assign a lead to a campaign in Adversus
+     * @param {string} leadId - The ID of the lead
+     * @param {string} campaignId - The ID of the campaign
+     * @param {Object} opts - Additional request options
+     * @returns {Promise} The response from assigning the lead
+     */
     async assignLeadToCampaign(leadId, campaignId, opts = {}) {
       const { data: optsData, ...restOpts } = opts;
       return this._makeRequest({