@pipedream/everstox 0.0.1 → 0.1.0

package/actions/get-order/get-order.mjs

@@ -0,0 +1,33 @@
+import everstox from "../../everstox.app.mjs";
+
+export default {
+  key: "everstox-get-order",
+  name: "Get Order",
+  description: "Get an order from Everstox. [See the documentation](https://api.everstox.com/api/v1/ui/#/Order/district_core.api.shops.orders.orders.Orders.get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    everstox,
+    orderId: {
+      propDefinition: [
+        everstox,
+        "orderId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.everstox.getOrder({
+      $,
+      orderId: this.orderId,
+    });
+
+    $.export("$summary", `Successfully retrieved order with ID \`${this.orderId}\`.`);
+
+    return response;
+  },
+};

package/actions/get-return/get-return.mjs

@@ -0,0 +1,31 @@
+import everstox from "../../everstox.app.mjs";
+
+export default {
+  key: "everstox-get-return",
+  name: "Get Return",
+  description: "Get a return from Everstox. [See the documentation](https://api.everstox.com/api/v1/ui/#/Returns%20V2/district_core.api.shops.returns_v2.returns_v2.ReturnsV2.get)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    everstox,
+    returnId: {
+      propDefinition: [
+        everstox,
+        "returnId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const response = await this.everstox.getReturn({
+      $,
+      returnId: this.returnId,
+    });
+    $.export("$summary", `Successfully retrieved return with ID \`${this.returnId}\`.`);
+    return response;
+  },
+};

package/actions/list-returns/list-returns.mjs

@@ -0,0 +1,110 @@
+import everstox from "../../everstox.app.mjs";
+import constants from "../../common/constants.mjs";
+
+export default {
+  key: "everstox-list-returns",
+  name: "List Returns",
+  description: "List returns from Everstox. [See the documentation](https://api.everstox.com/api/v1/ui/#/Returns%20V2/district_core.api.shops.returns_v2.returns_v2.ReturnsV2.index)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    everstox,
+    orderNumber: {
+      propDefinition: [
+        everstox,
+        "orderNumber",
+      ],
+      optional: true,
+    },
+    rmaNumber: {
+      type: "string",
+      label: "RMA Number",
+      description: "Filter by RMA number",
+      optional: true,
+    },
+    updatedDateGte: {
+      type: "string",
+      label: "Updated Date Greater Than or Equal To",
+      description: "Filter returns with updated date greater than or equal to the provided date. Example: `2021-02-23`",
+      optional: true,
+    },
+    updatedDateLte: {
+      type: "string",
+      label: "Updated Date Less Than or Equal To",
+      description: "Filter returns with updated date less than or equal to the provided date. Example: `2021-02-23`",
+      optional: true,
+    },
+    createdDateGte: {
+      type: "string",
+      label: "Created Date Greater Than or Equal To",
+      description: "Filter returns with created date greater than or equal to the provided date. Example: `2021-02-23`",
+      optional: true,
+    },
+    createdDateLte: {
+      type: "string",
+      label: "Created Date Less Than or Equal To",
+      description: "Filter returns with created date less than or equal to the provided date. Example: `2021-02-23`",
+      optional: true,
+    },
+    returnReviewed: {
+      type: "boolean",
+      label: "Return Reviewed",
+      description: "Filter returns by return reviewed status",
+      optional: true,
+    },
+    productSku: {
+      type: "string",
+      label: "Product SKU",
+      description: "Filter returns by product SKU",
+      optional: true,
+    },
+    limit: {
+      type: "integer",
+      label: "Limit",
+      description: "The number of items to return (default 10)",
+      optional: true,
+    },
+    offset: {
+      type: "integer",
+      label: "Offset",
+      description: "The number of items to skip before starting to collect the result set",
+      optional: true,
+    },
+    orderBy: {
+      type: "string",
+      label: "Order By",
+      description: "The field to order by",
+      options: constants.ORDER_BY_OPTIONS,
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.everstox.listReturns({
+      $,
+      params: {
+        order_number: this.orderNumber,
+        stategroup: "all",
+        rma_num: this.rmaNumber,
+        updated_date_gte: this.updatedDateGte,
+        updated_date_lte: this.updatedDateLte,
+        creation_date_gte: this.createdDateGte,
+        creation_date_lte: this.createdDateLte,
+        return_reviewed: this.returnReviewed,
+        product_sku: this.productSku,
+        limit: this.limit,
+        offset: this.offset,
+        order_by: this.orderBy,
+        exact_search: false,
+      },
+    });
+    $.export("$summary", `Successfully retrieved ${response.items.length} return${response.items.length === 1
+      ? ""
+      : "s"}`);
+    return response;
+  },
+};

package/common/constants.mjs

@@ -0,0 +1,12 @@
+const LIMIT = 100;
+
+const ORDER_BY_OPTIONS = [
+  "creation_date",
+  "order_number",
+  "rma_number",
+];
+
+export default {
+  LIMIT,
+  ORDER_BY_OPTIONS,
+};

package/everstox.app.mjs

@@ -1,11 +1,110 @@
+import { axios } from "@pipedream/platform";
+import constants from "./common/constants.mjs";
+const LIMIT = constants.LIMIT;
+
 export default {
   type: "app",
   app: "everstox",
-  propDefinitions: {},
+  propDefinitions: {
+    orderId: {
+      type: "string",
+      label: "Order ID",
+      description: "The ID of the order",
+      async options({ page }) {
+        const { items } = await this.listOrders({
+          params: {
+            limit: LIMIT,
+            offset: page * LIMIT,
+          },
+        });
+        return items?.map(({
+          id, order_number: orderNumber,
+        }) => ({
+          label: `Order Number: ${orderNumber}`,
+          value: id,
+        })) || [];
+      },
+    },
+    orderNumber: {
+      type: "string",
+      label: "Order Number",
+      description: "The number of the order",
+      async options({ page }) {
+        const { items } = await this.listOrders({
+          params: {
+            limit: LIMIT,
+            offset: page * LIMIT,
+          },
+        });
+        return items?.map(({ order_number: orderNumber }) => ({
+          label: `Order ${orderNumber}`,
+          value: orderNumber.replace(/^#/, ""),
+        })) || [];
+      },
+    },
+    returnId: {
+      type: "string",
+      label: "Return ID",
+      description: "The ID of the return",
+      async options({ page }) {
+        const { items } = await this.listReturns({
+          params: {
+            limit: LIMIT,
+            offset: page * LIMIT,
+            stategroup: "all",
+          },
+        });
+        return items?.map(({
+          id, order_number: orderNumber,
+        }) => ({
+          label: `Return for Order Number: ${orderNumber}`,
+          value: id,
+        })) || [];
+      },
+    },
+  },
   methods: {
-    // this.$auth contains connected account data
-    authKeys() {
-      console.log(Object.keys(this.$auth));
+    _baseUrl() {
+      return `${this.$auth.api_url}shops/${this.$auth.shop_id}`;
+    },
+    _makeRequest({
+      $ = this, path, ...opts
+    }) {
+      return axios($, {
+        url: `${this._baseUrl()}${path}`,
+        headers: {
+          "everstox-shop-api-token": `${this.$auth.api_token}`,
+        },
+        ...opts,
+      });
+    },
+    getOrder({
+      orderId, ...opts
+    }) {
+      return this._makeRequest({
+        path: `/orders/${orderId}`,
+        ...opts,
+      });
+    },
+    getReturn({
+      returnId, ...opts
+    }) {
+      return this._makeRequest({
+        path: `/returns/v2/${returnId}`,
+        ...opts,
+      });
+    },
+    listOrders(opts = {}) {
+      return this._makeRequest({
+        path: "/orders",
+        ...opts,
+      });
+    },
+    listReturns(opts = {}) {
+      return this._makeRequest({
+        path: "/returns/v2",
+        ...opts,
+      });
     },
   },
-};
+};

package/package.json

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