[20836] feat(ashby): Add search-candidates, get-candidate actions (#20841)

* feat(ashby): Add search-candidates & get-candidate actions

* chore(ashby): Bump minor version

* chore(ashby): patch-bump all components due to ashby.app.mjs changes

Author: ashwins01

components/ashby/actions/create-application/create-application.mjs

@@ -4,7 +4,7 @@ export default {
   key: "ashby-create-application",
   name: "Create Application",
   description: "Considers a candidate for a job (e.g., when sourcing a candidate for a job posting). [See the documentation](https://developers.ashbyhq.com/reference/applicationcreate)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     readOnlyHint: false,

components/ashby/actions/create-candidate/create-candidate.mjs

@@ -4,7 +4,7 @@ export default {
   key: "ashby-create-candidate",
   name: "Create Candidate",
   description: "Creates a new candidate in Ashby. [See the documentation](https://developers.ashbyhq.com/reference/candidatecreate)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/ashby/actions/create-interview-schedule/create-interview-schedule.mjs

@@ -5,7 +5,7 @@ export default {
   key: "ashby-create-interview-schedule",
   name: "Create Interview Schedule",
   description: "Creates a scheduled interview. [See the documentation](https://developers.ashbyhq.com/reference/interviewschedulecreate)",
-  version: "0.0.1",
+  version: "0.0.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/ashby/actions/create-offer/create-offer.mjs

@@ -5,7 +5,7 @@ export default {
   key: "ashby-create-offer",
   name: "Create Offer",
   description: "Creates a new offer. [See the documentation](https://developers.ashbyhq.com/reference/offercreate)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/ashby/actions/get-candidate/get-candidate.mjs

@@ -0,0 +1,40 @@
+import app from "../../ashby.app.mjs";
+
+export default {
+  key: "ashby-get-candidate",
+  name: "Get Candidate",
+  description: "Retrieves the details of a specific candidate by ID. [See the documentation](https://developers.ashbyhq.com/reference/candidateinfo)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    candidateId: {
+      propDefinition: [
+        app,
+        "candidateId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      candidateId,
+    } = this;
+
+    const response = await app.getCandidate({
+      $,
+      data: {
+        id: candidateId,
+      },
+    });
+
+    $.export("$summary", `Successfully retrieved candidate \`${candidateId}\``);
+
+    return response;
+  },
+};

components/ashby/actions/list-applications/list-applications.mjs

@@ -4,7 +4,7 @@ export default {
   key: "ashby-list-applications",
   name: "List Applications",
   description: "Retrieves a list of applications within an organization. [See the documentation](https://developers.ashbyhq.com/reference/applicationlist)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/ashby/actions/search-candidates/search-candidates.mjs

@@ -0,0 +1,55 @@
+import { ConfigurationError } from "@pipedream/platform";
+import app from "../../ashby.app.mjs";
+
+export default {
+  key: "ashby-search-candidates",
+  name: "Search Candidates",
+  description: "Search candidates by email and/or name. Limited to 100 results. [See the documentation](https://developers.ashbyhq.com/reference/candidatesearch)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    app,
+    email: {
+      propDefinition: [
+        app,
+        "email",
+      ],
+      description: "The candidate's email address to search by",
+    },
+    name: {
+      type: "string",
+      label: "Name",
+      description: "The candidate's name to search by",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const {
+      app,
+      email,
+      name,
+    } = this;
+
+    if (!email && !name) {
+      throw new ConfigurationError("Please provide at least one of `Email` or `Name` to search by.");
+    }
+
+    const response = await app.searchCandidates({
+      $,
+      data: {
+        email,
+        name,
+      },
+    });
+
+    const count = response?.results?.length ?? 0;
+    $.export("$summary", `Successfully retrieved \`${count}\` candidate(s)`);
+
+    return response;
+  },
+};

components/ashby/actions/start-offer-process/start-offer-process.mjs

@@ -4,7 +4,7 @@ export default {
   key: "ashby-start-offer-process",
   name: "Start Offer Process",
   description: "Starts an offer process for a candidate. [See the documentation](https://developers.ashbyhq.com/reference/offerprocessstart)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/ashby/actions/start-offer/start-offer.mjs

@@ -4,7 +4,7 @@ export default {
   key: "ashby-start-offer",
   name: "Start Offer",
   description: "Starts an offer and returns an offer form instance that can be filled out and submitted. [See the documentation](https://developers.ashbyhq.com/reference/offerstart)",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

components/ashby/ashby.app.mjs

@@ -352,6 +352,18 @@ export default {
         ...args,
       });
     },
+    searchCandidates(args = {}) {
+      return this.post({
+        path: "/candidate.search",
+        ...args,
+      });
+    },
+    getCandidate(args = {}) {
+      return this.post({
+        path: "/candidate.info",
+        ...args,
+      });
+    },
     async paginate({
       max = 600, fn, fnArgs, keyField = "results",
     } = {}) {