@pipedream/taleez 0.0.1 → 0.2.0

package/actions/add-candidate-to-job/add-candidate-to-job.mjs

@@ -0,0 +1,42 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-add-candidate-to-job",
+  name: "Add Candidate to Job",
+  description: "Links an existing candidate to a job offer. [See the documentation](https://api.taleez.com/swagger-ui/index.html#/jobs/addCandidate_1)",
+  version: "0.0.2",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  type: "action",
+  props: {
+    taleez,
+    candidateId: {
+      propDefinition: [
+        taleez,
+        "candidateId",
+      ],
+    },
+    jobId: {
+      propDefinition: [
+        taleez,
+        "jobId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.taleez.linkCandidateToJob({
+      $,
+      jobId: this.jobId,
+      data: {
+        ids: [
+          this.candidateId,
+        ],
+      },
+    });
+    $.export("$summary", `Linked candidate ${this.candidateId} to job ${this.jobId} successfully`);
+    return response;
+  },
+};

package/actions/create-candidate/create-candidate.mjs

@@ -0,0 +1,65 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-create-candidate",
+  name: "Create Candidate",
+  description: "Creates a new candidate in Taleez. [See the documentation](https://api.taleez.com/swagger-ui/index.html#/candidates/create_1)",
+  version: "0.0.2",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: false,
+  },
+  type: "action",
+  props: {
+    taleez,
+    firstName: {
+      type: "string",
+      label: "First Name",
+      description: "First name of the candidate",
+    },
+    lastName: {
+      type: "string",
+      label: "Last Name",
+      description: "Last name of the candidate",
+    },
+    email: {
+      type: "string",
+      label: "Email",
+      description: "Candidate email address. Must be unique in your company",
+    },
+    phone: {
+      type: "string",
+      label: "Phone",
+      description: "Candidate phone (formats : 0611223344, +33611223344, 00336112233). Ignored if not valid.",
+      optional: true,
+    },
+    unitId: {
+      propDefinition: [
+        taleez,
+        "unitId",
+      ],
+    },
+    recruiterId: {
+      propDefinition: [
+        taleez,
+        "recruiterId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.taleez.createCandidate({
+      $,
+      data: {
+        firstName: this.firstName,
+        lastName: this.lastName,
+        mail: this.email,
+        phone: this.phone,
+        unitId: this.unitId,
+        recruiterId: this.recruiterId,
+      },
+    });
+    $.export("$summary", `Created candidate ${this.firstName} ${this.lastName} successfully`);
+    return response;
+  },
+};

package/actions/list-candidate-id-options/list-candidate-id-options.mjs

@@ -0,0 +1,33 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-list-candidate-id-options",
+  name: "List Candidate ID Options",
+  description: "Retrieves available options for the Candidate ID field.",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    taleez,
+    page: {
+      type: "integer",
+      label: "Page",
+      description: "The page of results to retrieve.",
+      min: 0,
+      default: 0,
+    },
+  },
+  async run({ $ }) {
+    const options = await taleez.propDefinitions.candidateId.options.call(this.taleez, {
+      page: this.page,
+    });
+    $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
+      ? ""
+      : "s"}`);
+    return options;
+  },
+};

package/actions/list-job-id-options/list-job-id-options.mjs

@@ -0,0 +1,33 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-list-job-id-options",
+  name: "List Job Listing ID Options",
+  description: "Retrieves available options for the Job Listing ID field.",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    taleez,
+    page: {
+      type: "integer",
+      label: "Page",
+      description: "The page of results to retrieve.",
+      min: 0,
+      default: 0,
+    },
+  },
+  async run({ $ }) {
+    const options = await taleez.propDefinitions.jobId.options.call(this.taleez, {
+      page: this.page,
+    });
+    $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
+      ? ""
+      : "s"}`);
+    return options;
+  },
+};

package/actions/list-jobs/list-jobs.mjs

@@ -0,0 +1,79 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-list-jobs",
+  name: "List Jobs",
+  description: "Retrieves a list of jobs in your company. [See the documentation](https://api.taleez.com/swagger-ui/index.html#/jobs/list_3)",
+  version: "0.0.2",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    taleez,
+    unitId: {
+      propDefinition: [
+        taleez,
+        "unitId",
+      ],
+    },
+    status: {
+      propDefinition: [
+        taleez,
+        "status",
+      ],
+    },
+    contract: {
+      propDefinition: [
+        taleez,
+        "contract",
+      ],
+    },
+    city: {
+      propDefinition: [
+        taleez,
+        "city",
+      ],
+    },
+    companyLabel: {
+      propDefinition: [
+        taleez,
+        "companyLabel",
+      ],
+    },
+    tag: {
+      propDefinition: [
+        taleez,
+        "tag",
+      ],
+    },
+    maxResults: {
+      type: "integer",
+      label: "Max Results",
+      description: "The maximum number of jobs to retrieve. Default: `100`",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const { list: jobs } = await this.taleez.listJobs({
+      $,
+      params: {
+        unitId: this.unitId,
+        status: this.status,
+        contract: this.contract,
+        city: this.city,
+        companyLabel: this.companyLabel,
+        tag: this.tag,
+        pageSize: this.maxResults,
+        withDetails: true,
+        withProps: true,
+      },
+    });
+    $.export("$summary", `Successfully retrieved ${jobs?.length} job${jobs?.length === 1
+      ? ""
+      : "s"}`);
+    return jobs;
+  },
+};

package/actions/list-recruiter-id-options/list-recruiter-id-options.mjs

@@ -0,0 +1,33 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-list-recruiter-id-options",
+  name: "List Recruiter ID Options",
+  description: "Retrieves available options for the Recruiter ID field.",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    taleez,
+    page: {
+      type: "integer",
+      label: "Page",
+      description: "The page of results to retrieve.",
+      min: 0,
+      default: 0,
+    },
+  },
+  async run({ $ }) {
+    const options = await taleez.propDefinitions.recruiterId.options.call(this.taleez, {
+      page: this.page,
+    });
+    $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
+      ? ""
+      : "s"}`);
+    return options;
+  },
+};

package/actions/list-unit-id-options/list-unit-id-options.mjs

@@ -0,0 +1,33 @@
+import taleez from "../../taleez.app.mjs";
+
+export default {
+  key: "taleez-list-unit-id-options",
+  name: "List Unit ID Options",
+  description: "Retrieves available options for the Unit ID field.",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    taleez,
+    page: {
+      type: "integer",
+      label: "Page",
+      description: "The page of results to retrieve.",
+      min: 0,
+      default: 0,
+    },
+  },
+  async run({ $ }) {
+    const options = await taleez.propDefinitions.unitId.options.call(this.taleez, {
+      page: this.page,
+    });
+    $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
+      ? ""
+      : "s"}`);
+    return options;
+  },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/taleez",
-  "version": "0.0.1",
+  "version": "0.2.0",
   "description": "Pipedream Taleez Components",
   "main": "taleez.app.mjs",
   "keywords": [
@@ -11,5 +11,8 @@
   "author": "Pipedream <support@pipedream.com> (https://pipedream.com/)",
   "publishConfig": {
     "access": "public"
+  },
+  "dependencies": {
+    "@pipedream/platform": "^3.1.1"
   }
 }

package/sources/common/base.mjs

@@ -0,0 +1,72 @@
+import taleez from "../../taleez.app.mjs";
+import { DEFAULT_POLLING_SOURCE_TIMER_INTERVAL } from "@pipedream/platform";
+
+export default {
+  props: {
+    taleez,
+    db: "$.service.db",
+    timer: {
+      type: "$.interface.timer",
+      default: {
+        intervalSeconds: DEFAULT_POLLING_SOURCE_TIMER_INTERVAL,
+      },
+    },
+  },
+  methods: {
+    _getLastTs() {
+      return this.db.get("lastTs") || 0;
+    },
+    _setLastTs(lastTs) {
+      this.db.set("lastTs", lastTs);
+    },
+    emitEvent(item) {
+      const meta = this.generateMeta(item);
+      this.$emit(item, meta);
+    },
+    async processEvent(max) {
+      const lastTs = this._getLastTs();
+      let maxTs = lastTs;
+      const tsField = this.getTsField();
+
+      const results = this.taleez.paginate({
+        fn: this.getResourceFn(),
+        args: this.getArgs(),
+        max,
+      });
+
+      for await (const item of results) {
+        if (tsField) {
+          const ts = item[tsField];
+          if (ts > lastTs) {
+            this.emitEvent(item);
+            maxTs = Math.max(ts, maxTs);
+          }
+        } else {
+          this.emitEvent(item);
+        }
+      }
+
+      this._setLastTs(maxTs);
+    },
+    getArgs() {
+      return {};
+    },
+    getTsField() {
+      return undefined;
+    },
+    getResourceFn() {
+      throw new Error("getResourceFn is not implemented");
+    },
+    generateMeta() {
+      throw new Error("generateMeta is not implemented");
+    },
+  },
+  hooks: {
+    async deploy() {
+      await this.processEvent(25);
+    },
+  },
+  async run() {
+    await this.processEvent();
+  },
+};

package/sources/new-candidate-created/new-candidate-created.mjs

@@ -0,0 +1,34 @@
+import common from "../common/base.mjs";
+
+export default {
+  ...common,
+  key: "taleez-new-candidate-created",
+  name: "New Candidate Created",
+  description: "Emit new event when a candidate is added in Taleez. [See the documentation](https://api.taleez.com/swagger-ui/index.html#/candidates/list_4)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  methods: {
+    ...common.methods,
+    getResourceFn() {
+      return this.taleez.listCandidates;
+    },
+    getArgs() {
+      return {
+        params: {
+          withProps: true,
+        },
+      };
+    },
+    getTsField() {
+      return "dateCreation";
+    },
+    generateMeta(candidate) {
+      return {
+        id: candidate.id,
+        summary: `New Candidate: ${candidate.firstName} ${candidate.lastName}`,
+        ts: candidate.dateCreation,
+      };
+    },
+  },
+};

package/sources/new-job-listed/new-job-listed.mjs

@@ -0,0 +1,77 @@
+import common from "../common/base.mjs";
+
+export default {
+  ...common,
+  key: "taleez-new-job-listed",
+  name: "New Job Listing Created",
+  description: "Emit new event when a job listing is created in Taleez. [See the documentation](https://api.taleez.com/swagger-ui/index.html#/jobs/list_3)",
+  version: "0.0.1",
+  type: "source",
+  dedupe: "unique",
+  props: {
+    ...common.props,
+    unitId: {
+      propDefinition: [
+        common.props.taleez,
+        "unitId",
+      ],
+    },
+    status: {
+      propDefinition: [
+        common.props.taleez,
+        "status",
+      ],
+    },
+    contract: {
+      propDefinition: [
+        common.props.taleez,
+        "contract",
+      ],
+    },
+    city: {
+      propDefinition: [
+        common.props.taleez,
+        "city",
+      ],
+    },
+    companyLabel: {
+      propDefinition: [
+        common.props.taleez,
+        "companyLabel",
+      ],
+    },
+    tag: {
+      propDefinition: [
+        common.props.taleez,
+        "tag",
+      ],
+    },
+  },
+  methods: {
+    ...common.methods,
+    getResourceFn() {
+      return this.taleez.listJobs;
+    },
+    getArgs() {
+      return {
+        params: {
+          unitId: this.unitId,
+          status: this.status,
+          contract: this.contract,
+          city: this.city,
+          companyLabel: this.companyLabel,
+          tag: this.tag,
+          withDetails: true,
+          withProps: true,
+        },
+      };
+    },
+    generateMeta(job) {
+      return {
+        id: job.id,
+        summary: `New Job: ${job.label}`,
+        ts: job.dateCreation,
+      };
+    },
+  },
+};

package/taleez.app.mjs

@@ -1,11 +1,225 @@
+import { axios } from "@pipedream/platform";
+
 export default {
   type: "app",
   app: "taleez",
-  propDefinitions: {},
+  propDefinitions: {
+    jobId: {
+      type: "string",
+      label: "Job Listing ID",
+      description: "The ID of the job listing",
+      async options({ page }) {
+        const { list } = await this.listJobs({
+          params: {
+            page,
+          },
+        });
+        return list?.map(({
+          id: value, label,
+        }) => ({
+          label,
+          value,
+        }));
+      },
+    },
+    candidateId: {
+      type: "string",
+      label: "Candidate ID",
+      description: "The ID of the candidate to link",
+      async options({ page }) {
+        const { list } = await this.listCandidates({
+          params: {
+            page,
+          },
+        });
+        return list?.map(({
+          id: value, firstName, lastName,
+        }) => ({
+          label: `${firstName} ${lastName}`,
+          value,
+        }));
+      },
+    },
+    unitId: {
+      type: "string",
+      label: "Unit ID",
+      description: "Filter by unit ID",
+      optional: true,
+      async options({ page }) {
+        const { list } = await this.listUnits({
+          params: {
+            page,
+          },
+        });
+        return list?.map(({
+          id: value, publicName: label,
+        }) => ({
+          label,
+          value,
+        }));
+      },
+    },
+    recruiterId: {
+      type: "string",
+      label: "Recruiter ID",
+      description: "The ID of the recruiter adding this candidate",
+      optional: true,
+      async options({ page }) {
+        const { list } = await this.listRecruiters({
+          params: {
+            page,
+          },
+        });
+        return list?.map(({
+          id: value, firstName, lastName,
+        }) => ({
+          label: `${firstName} ${lastName}`,
+          value,
+        }));
+      },
+    },
+    status: {
+      type: "string",
+      label: "Status",
+      description: "Filter by job status",
+      options: [
+        "DRAFT",
+        "PUBLISHED",
+        "DONE",
+        "SUSPENDED",
+      ],
+      optional: true,
+    },
+    contract: {
+      type: "string",
+      label: "Contract",
+      description: "Filter by job contract",
+      options: [
+        "CDI",
+        "CDD",
+        "INTERIM",
+        "FREELANCE",
+        "INTERNSHIP",
+        "APPRENTICESHIP",
+        "STUDENT",
+        "VIE",
+        "FRANCHISE",
+        "STATUTE",
+        "VACATAIRE",
+        "LIBERAL",
+        "CDI_CHANTIER",
+        "INTERMITTENT",
+        "SEASON",
+        "OTHER",
+        "VOLUNTEER",
+        "PERMANENT",
+        "FIXEDTERM",
+      ],
+      optional: true,
+    },
+    city: {
+      type: "string",
+      label: "City",
+      description: "Filter by job city",
+      optional: true,
+    },
+    companyLabel: {
+      type: "string",
+      label: "Company Label",
+      description: "Filter by company label",
+      optional: true,
+    },
+    tag: {
+      type: "string",
+      label: "Tag",
+      description: "Filter by job tag",
+      optional: true,
+    },
+  },
   methods: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _baseUrl() {
+      return "https://api.taleez.com/0";
+    },
+    _makeRequest({
+      $ = this,
+      path,
+      ...otherOpts
+    }) {
+      return axios($, {
+        ...otherOpts,
+        url: `${this._baseUrl()}${path}`,
+        headers: {
+          "x-taleez-api-secret": this.$auth.secret_key,
+        },
+      });
+    },
+    listJobs(opts = {}) {
+      return this._makeRequest({
+        path: "/jobs",
+        ...opts,
+      });
+    },
+    listCandidates(opts = {}) {
+      return this._makeRequest({
+        path: "/candidates",
+        ...opts,
+      });
+    },
+    listUnits(opts = {}) {
+      return this._makeRequest({
+        path: "/units",
+        ...opts,
+      });
+    },
+    listRecruiters(opts = {}) {
+      return this._makeRequest({
+        path: "/recruiters",
+        ...opts,
+      });
+    },
+    createCandidate(opts = {}) {
+      return this._makeRequest({
+        method: "POST",
+        path: "/candidates",
+        ...opts,
+      });
+    },
+    linkCandidateToJob({
+      jobId, ...opts
+    }) {
+      return this._makeRequest({
+        method: "POST",
+        path: `/jobs/${jobId}/candidates`,
+        ...opts,
+      });
+    },
+    async *paginate({
+      fn, args = {}, max,
+    }) {
+      let hasMorePages = true;
+      let page = 0;
+      let count = 0;
+
+      while (hasMorePages) {
+        const {
+          list, hasMore,
+        } = await fn({
+          ...args,
+          params: {
+            ...args?.params,
+            page,
+            pageSize: 1000,
+          },
+        });
+        for (const item of list) {
+          yield item;
+          if (max && ++count >= max) {
+            return;
+          }
+        }
+        hasMorePages = hasMore;
+        page++;
+      }
     },
   },
-};
+};