[ACTIONS] Returnless - new components (#19377)

Author: jcortes

components/returnless/actions/create-return-order/create-return-order.mjs

@@ -6,7 +6,7 @@ export default {
   key: "returnless-create-return-order",
   name: "Create Return Order",
   description: "Create a return order. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/1fce50b07484b-creates-a-return-order-from-a-return-order-intent)",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/returnless/actions/list-return-orders/list-return-orders.mjs

@@ -4,7 +4,7 @@ export default {
   key: "returnless-list-return-orders",
   name: "List Return Orders",
   description: "Retrieve a list of return orders. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/0640e3c064cdc-list-all-return-orders)",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
@@ -25,13 +25,13 @@ export default {
     createdAfter: {
       type: "string",
       label: "Created After",
-      description: "Only return return-orders that were created after the given date",
+      description: "Only return return-orders that were created after the given date. Example: `2025-01-01T00:00:00+00:00`",
       optional: true,
     },
     createdBefore: {
       type: "string",
       label: "Created Before",
-      description: "Only return return-orders that were created before the given date",
+      description: "Only return return-orders that were created before the given date. Example: `2025-01-10T00:00:00+00:00`",
       optional: true,
     },
     maxResults: {

components/returnless/actions/list-return-statuses/list-return-statuses.mjs

@@ -0,0 +1,25 @@
+import app from "../../returnless.app.mjs";
+
+export default {
+  key: "returnless-list-return-statuses",
+  name: "List Return Statuses",
+  description: "List all return statuses. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/6129c8f41f66f-list-all-return-statuses)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const response = await this.app.listReturnStatuses({
+      $,
+    });
+
+    $.export("$summary", `Successfully retrieved ${response?.data?.length} return status(es)`);
+    return response?.data;
+  },
+};

components/returnless/actions/list-sales-order-items/list-sales-order-items.mjs

@@ -4,7 +4,7 @@ export default {
   key: "returnless-list-sales-order-items",
   name: "List Sales Order Items",
   description: "Retrieve all items from a specific sales order with cursor-based pagination support. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/6b3c26dad0434-list-all-items-of-a-sales-order)",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/returnless/actions/list-sales-orders/list-sales-orders.mjs

@@ -4,7 +4,7 @@ export default {
   key: "returnless-list-sales-orders",
   name: "List Sales Orders",
   description: "Retrieve a list of sales orders sorted by creation date, with the most recent sales orders appearing first. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/ce6a0e3d66378-list-all-sales-orders)",
-  version: "0.0.2",
+  version: "0.0.3",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,

components/returnless/actions/list-shipments-of-return-order/list-shipments-of-return-order.mjs

@@ -0,0 +1,41 @@
+import app from "../../returnless.app.mjs";
+
+export default {
+  key: "returnless-list-shipments-of-return-order",
+  name: "List Shipments of Return Order",
+  description: "List all shipments of a return order. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/1e0748fdd876f-list-all-shipments-of-a-return-order)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    app,
+    returnOrderId: {
+      propDefinition: [
+        app,
+        "returnOrderId",
+      ],
+    },
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const resources = await this.app.getPaginatedResources({
+      fn: this.app.listReturnOrderShipments,
+      args: {
+        returnOrderId: this.returnOrderId,
+      },
+      max: this.maxResults,
+    });
+
+    $.export("$summary", `Successfully retrieved ${resources.length} shipment(s) for return order ${this.returnOrderId}`);
+    return resources;
+  },
+};

components/returnless/actions/list-shipments/list-shipments.mjs

@@ -0,0 +1,32 @@
+import app from "../../returnless.app.mjs";
+
+export default {
+  key: "returnless-list-shipments",
+  name: "List Shipments",
+  description: "List all shipments. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/7daf3fa2c9bf9-list-all-shipments)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    app,
+    maxResults: {
+      propDefinition: [
+        app,
+        "maxResults",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const resources = await this.app.getPaginatedResources({
+      fn: this.app.listShipments,
+      max: this.maxResults,
+    });
+
+    $.export("$summary", `Successfully retrieved ${resources.length} shipment(s)`);
+    return resources;
+  },
+};

components/returnless/actions/list-statuses-of-shipment/list-statuses-of-shipment.mjs

@@ -0,0 +1,32 @@
+import app from "../../returnless.app.mjs";
+
+export default {
+  key: "returnless-list-statuses-of-shipment",
+  name: "List Statuses of Shipment",
+  description: "List all statuses of a shipment. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/e274dab430bb7-list-all-statuses-of-a-shipment)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    app,
+    shipmentId: {
+      propDefinition: [
+        app,
+        "shipmentId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const { data } = await this.app.listShipmentStatuses({
+      $,
+      shipmentId: this.shipmentId,
+    });
+
+    $.export("$summary", `Successfully retrieved ${data.length} status(es) for shipment ${this.shipmentId}`);
+    return data;
+  },
+};

components/returnless/actions/retrieve-return-address/retrieve-return-address.mjs

@@ -0,0 +1,32 @@
+import app from "../../returnless.app.mjs";
+
+export default {
+  key: "returnless-retrieve-return-address",
+  name: "Retrieve Return Address",
+  description: "Retrieve a return address. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/b702161eed54f-retrieve-a-return-address)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    app,
+    returnAddressId: {
+      propDefinition: [
+        app,
+        "returnAddressId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const { data } = await this.app.getReturnAddress({
+      $,
+      returnAddressId: this.returnAddressId,
+    });
+
+    $.export("$summary", `Successfully retrieved return address ${this.returnAddressId}`);
+    return data;
+  },
+};

components/returnless/actions/retrieve-return-order/retrieve-return-order.mjs

@@ -0,0 +1,32 @@
+import app from "../../returnless.app.mjs";
+
+export default {
+  key: "returnless-retrieve-return-order",
+  name: "Retrieve Return Order",
+  description: "Retrieve a return order. [See the documentation](https://docs.returnless.com/docs/api-rest-reference/f670282943eae-retrieve-a-return-order)",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  type: "action",
+  props: {
+    app,
+    returnOrderId: {
+      propDefinition: [
+        app,
+        "returnOrderId",
+      ],
+    },
+  },
+  async run({ $ }) {
+    const { data } = await this.app.getReturnOrder({
+      $,
+      returnOrderId: this.returnOrderId,
+    });
+
+    $.export("$summary", `Successfully retrieved return order ${this.returnOrderId}`);
+    return data;
+  },
+};