@pipedream/everstox 0.1.0 → 0.3.0

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

@@ -4,7 +4,7 @@ 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",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

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

@@ -4,7 +4,7 @@ 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",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

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

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

package/actions/list-order-number-options/list-order-number-options.mjs

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

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

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

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

@@ -5,7 +5,7 @@ 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",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/actions/list-warehouse-ids-options/list-warehouse-ids-options.mjs

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

package/actions/search-orders/search-orders.mjs

@@ -0,0 +1,145 @@
+import constants from "../../common/constants.mjs";
+import everstox from "../../everstox.app.mjs";
+
+export default {
+  key: "everstox-search-orders",
+  name: "Search Orders by Order Number",
+  description: "Search orders from Everstox. [See the documentation](https://api.everstox.com/api/v1/ui/#/Order/district_core.api.shops.orders.orders.Orders.index)",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    everstox,
+    warehouseIds: {
+      propDefinition: [
+        everstox,
+        "warehouseIds",
+      ],
+      optional: true,
+    },
+    fields: {
+      propDefinition: [
+        everstox,
+        "fields",
+      ],
+      type: "string[]",
+      label: "Fields",
+      description: "Fields to filter for",
+      optional: true,
+    },
+    orderNumber: {
+      propDefinition: [
+        everstox,
+        "orderNumber",
+      ],
+      description: "Filter for order number",
+      optional: true,
+    },
+    hoursLateLte: {
+      type: "integer",
+      label: "Hours Late Less Than or Equal to",
+      description: "Filter for orders late for the amount of hours less or equal than the provided value",
+      optional: true,
+    },
+    hoursLateGte: {
+      type: "integer",
+      label: "Hours Late Greater Than or Equal to",
+      description: "Filter for orders late for the amount of hours greater or equal than the provided value",
+      optional: true,
+    },
+    search: {
+      type: "string",
+      label: "Search",
+      description: "Multi-attribute-search filters either for Customer Email or Billing Address or Order Number. Returns set of orders where at least one of those attributes match the search term",
+      optional: true,
+    },
+    fulfillmentState: {
+      type: "string",
+      label: "Fulfillment State",
+      description: "Fulfillment State to filter for order where the corresponding fulfillment is in the given state",
+      options: constants.FULFILLMENT_STATE_OPTIONS,
+      optional: true,
+    },
+    fulfillmentStategroup: {
+      type: "string",
+      label: "Fulfillment Stategroup",
+      description: "Fulfillment Stategroup to filter for order where the corresponding fulfillment is in the given stategroup",
+      options: constants.FULFILLMENT_STATEGROUP_OPTIONS,
+      optional: true,
+    },
+    stategroup: {
+      type: "string",
+      label: "Stategroup",
+      description: "Stategroup to filter for, e.g. open includes states like new, in_progress etc",
+      options: constants.STATEGROUP_OPTIONS,
+      optional: true,
+    },
+    cancellationState: {
+      type: "string",
+      label: "Cancellation State",
+      description: "Cancellation State to filter for order with min 1 cancellation in that state",
+      options: constants.CANCELLATION_STATE_OPTIONS,
+      optional: true,
+    },
+    shipmentDateGte: {
+      type: "string",
+      label: "Shipment Date Greater Than or Equal",
+      description: "Find orders whose shipment date is greater than or equal to the provided value",
+      optional: true,
+    },
+    updatedDateGte: {
+      type: "string",
+      label: "Updated Date Greater Than or Equal",
+      description: "Find orders whose updated date is greater than or equal to the provided value",
+      optional: true,
+    },
+    createdDateGte: {
+      type: "string",
+      label: "Created Date Greater Than or Equal",
+      description: "Find orders whose creation date is greater than or equal to the provided value",
+      optional: true,
+    },
+    createdDateLte: {
+      type: "string",
+      label: "Created Date Less Than or Equal",
+      description: "Find orders whose created date is less than or equal to the provided value",
+      optional: true,
+    },
+    shipmentsForwardedToShop: {
+      type: "boolean",
+      label: "Shipments Forwarded to Shop",
+      description: "Boolean returning orders with shipments forwarded to shop",
+      optional: true,
+    },
+  },
+  async run({ $ }) {
+    const response = await this.everstox.listOrders({
+      $,
+      params: {
+        warehouse_ids: this.warehouseIds,
+        fields: this.fields,
+        order_number: this.orderNumber,
+        hours_late_lte: this.hoursLateLte,
+        hours_late_gte: this.hoursLateGte,
+        search: this.search,
+        fulfillment_state: this.fulfillmentState,
+        fulfillment_stategroup: this.fulfillmentStategroup,
+        stategroup: this.stategroup,
+        cancellation_state: this.cancellationState,
+        shipment_date_gte: this.shipmentDateGte,
+        updated_date_gte: this.updatedDateGte,
+        created_date_gte: this.createdDateGte,
+        created_date_lte: this.createdDateLte,
+        shipments_forwarded_to_shop: this.shipmentsForwardedToShop,
+      },
+    });
+    $.export("$summary", `Successfully retrieved ${response.items.length} return${response.items.length === 1
+      ? ""
+      : "s"}`);
+    return response;
+  },
+};

package/common/constants.mjs

@@ -6,7 +6,47 @@ const ORDER_BY_OPTIONS = [
   "rma_number",
 ];
 
+const FULFILLMENT_STATE_OPTIONS = [
+  "new",
+  "created",
+  "warehouse_confirmation_pending",
+  "accepted_by_connector",
+  "accepted_by_warehouse",
+  "rejected_by_warehouse",
+  "in_fulfillment",
+  "partially_shipped",
+  "shipped",
+  "cancelled",
+];
+
+const FULFILLMENT_STATEGROUP_OPTIONS = [
+  "open",
+  "canceled",
+  "completed",
+  "all",
+];
+
+const STATEGROUP_OPTIONS = [
+  "open",
+  "closed",
+  "requires_attention",
+  "all",
+];
+
+const CANCELLATION_STATE_OPTIONS = [
+  "new",
+  "rejected",
+  "connector_confirmation_pending",
+  "accepted_by_connector",
+  "warehouse_cancellation_pending",
+  "completed",
+];
+
 export default {
   LIMIT,
   ORDER_BY_OPTIONS,
+  FULFILLMENT_STATE_OPTIONS,
+  FULFILLMENT_STATEGROUP_OPTIONS,
+  STATEGROUP_OPTIONS,
+  CANCELLATION_STATE_OPTIONS,
 };

package/everstox.app.mjs

@@ -6,6 +6,25 @@ export default {
   type: "app",
   app: "everstox",
   propDefinitions: {
+    warehouseIds: {
+      type: "string[]",
+      label: "Warehouse IDs",
+      description: "Warehouse IDs",
+      async options({ page }) {
+        const { items } = await this.listWarehouses({
+          params: {
+            limit: LIMIT,
+            offset: page * LIMIT,
+          },
+        });
+        return items?.map(({
+          id, name,
+        }) => ({
+          label: name,
+          value: id,
+        })) || [];
+      },
+    },
     orderId: {
       type: "string",
       label: "Order ID",
@@ -106,5 +125,11 @@ export default {
         ...opts,
       });
     },
+    listWarehouses(opts = {}) {
+      return this._makeRequest({
+        path: "/warehouses",
+        ...opts,
+      });
+    },
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/everstox",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "Pipedream Everstox Components",
   "main": "everstox.app.mjs",
   "keywords": [