@pipedream/unirateapi 0.2.0 → 0.3.0

package/actions/convert-currency/convert-currency.mjs

@@ -3,13 +3,13 @@ import app from "../../unirateapi.app.mjs";
 export default {
   key: "unirateapi-convert-currency",
   name: "Convert Currency",
-  version: "0.0.1",
+  version: "0.0.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
-  description: "Convert an amount from one currency to another at the latest rate. [See the documentation](https://unirateapi.com/docs).",
+  description: "Convert an amount from one currency to another at the latest rate. [See the documentation](https://unirateapi.com/apidocs).",
   type: "action",
   props: {
     app,

package/actions/get-exchange-rates/get-exchange-rates.mjs

@@ -3,13 +3,13 @@ import app from "../../unirateapi.app.mjs";
 export default {
   key: "unirateapi-get-exchange-rates",
   name: "Get Exchange Rates",
-  version: "0.0.1",
+  version: "0.0.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
-  description: "Get the latest exchange rate(s) for a base currency. Returns a single rate when a target is provided, or all rates keyed by currency code when omitted. [See the documentation](https://unirateapi.com/docs).",
+  description: "Get the latest exchange rate(s) for a base currency. Returns a single rate when a target is provided, or all rates keyed by currency code when omitted. [See the documentation](https://unirateapi.com/apidocs).",
   type: "action",
   props: {
     app,

package/actions/get-vat-rates/get-vat-rates.mjs

@@ -0,0 +1,56 @@
+import app from "../../unirateapi.app.mjs";
+
+export default {
+  key: "unirateapi-get-vat-rates",
+  name: "Get VAT Rates",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  description: "Get VAT rates for a single country, or for all supported countries when no country is provided. Country codes follow the EU VAT convention rather than ISO 3166-1 alpha-2 — Greece is `EL` (not `GR`) and the United Kingdom is `UK` (not `GB`). Coverage is limited to EU member states plus `UK` and `XI` (Northern Ireland), so non-EU codes such as `US` are not supported. Use **List Country Code Options** to discover valid codes. [See the documentation](https://unirateapi.com/apidocs).",
+  type: "action",
+  props: {
+    app,
+    country: {
+      propDefinition: [
+        app,
+        "countryCode",
+      ],
+      description: "An EU VAT country code (e.g. `DE`, `FR`, `UK`). If omitted, VAT rates for all supported countries are returned.",
+    },
+  },
+  async run({ $ }) {
+    const {
+      app, country,
+    } = this;
+
+    const trimmed = String(country ?? "").trim();
+    const countryCode = trimmed
+      ? trimmed.toUpperCase()
+      : undefined;
+
+    const response = await app.getVatRates({
+      $,
+      country: countryCode,
+    });
+
+    if (countryCode) {
+      const rate = response?.vat_data?.vat_rate;
+      $.export(
+        "$summary",
+        `Fetched VAT rate for ${countryCode}${rate === undefined
+          ? ""
+          : `: ${rate}%`}`,
+      );
+    } else {
+      const total = response?.total_countries
+        ?? Object.keys(response?.vat_rates ?? {}).length;
+      $.export("$summary", `Fetched VAT rates for ${total} countr${total === 1
+        ? "y"
+        : "ies"}`);
+    }
+    return response;
+  },
+};

package/actions/list-country-code-options/list-country-code-options.mjs

@@ -0,0 +1,34 @@
+import unirateapi from "../../unirateapi.app.mjs";
+
+export default {
+  key: "unirateapi-list-country-code-options",
+  name: "List Country Code Options",
+  description: "Retrieves the valid options for the Country Code field used by **Get VAT Rates**. Returns one entry per supported country as `{ label, value }`, where `value` is the code to pass as Country Code. These follow the EU VAT convention rather than ISO 3166-1 alpha-2 — Greece is `EL` (not `GR`) and the United Kingdom is `UK` (not `GB`) — so call this first rather than assuming an ISO code. [See the documentation](https://unirateapi.com/apidocs).",
+  version: "0.0.1",
+  type: "action",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  props: {
+    unirateapi,
+  },
+  async run({ $ }) {
+    const { vat_rates: vatRates = {} } = await this.unirateapi.getVatRates({
+      $,
+    });
+
+    const options = Object.values(vatRates).map(({
+      country_code: value, country_name: label,
+    }) => ({
+      label: label || value,
+      value,
+    }));
+
+    $.export("$summary", `Successfully retrieved ${options.length} option${options.length === 1
+      ? ""
+      : "s"}`);
+    return options;
+  },
+};

package/actions/list-currencies/list-currencies.mjs

@@ -0,0 +1,30 @@
+import app from "../../unirateapi.app.mjs";
+
+export default {
+  key: "unirateapi-list-currencies",
+  name: "List Currencies",
+  version: "0.0.1",
+  annotations: {
+    destructiveHint: false,
+    openWorldHint: true,
+    readOnlyHint: true,
+  },
+  description: "List every currency code supported by UniRate for exchange rate and conversion operations. Use this to discover valid values before calling **Convert Currency** or **Get Exchange Rates**, or to check whether a currency code you already have is supported. Takes no parameters and returns the full set in a single response as `{ currencies, count }` — codes only, without currency names or rates. These are currency codes (e.g. `USD`, `EUR`, `GBP`) and are unrelated to the EU VAT country codes used by **Get VAT Rates**. [See the documentation](https://unirateapi.com/apidocs).",
+  type: "action",
+  props: {
+    app,
+  },
+  async run({ $ }) {
+    const { app } = this;
+
+    const response = await app.listCurrencies({
+      $,
+    });
+
+    const count = response?.currencies?.length ?? 0;
+    $.export("$summary", `Retrieved ${count} supported currenc${count === 1
+      ? "y"
+      : "ies"}`);
+    return response;
+  },
+};

package/actions/list-currency-code-options/list-currency-code-options.mjs

@@ -4,7 +4,7 @@ export default {
   key: "unirateapi-list-currency-code-options",
   name: "List Currency Code Options",
   description: "Retrieves available options for the Currency Code field.",
-  version: "0.0.1",
+  version: "0.0.2",
   type: "action",
   annotations: {
     destructiveHint: false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pipedream/unirateapi",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Pipedream UniRateAPI Components",
   "main": "unirateapi.app.mjs",
   "keywords": [

package/sources/new-rate-update/new-rate-update.mjs

@@ -4,13 +4,13 @@ import app from "../../unirateapi.app.mjs";
 export default {
   key: "unirateapi-new-rate-update",
   name: "New Rate Update",
-  version: "0.0.1",
+  version: "0.0.2",
   annotations: {
     destructiveHint: false,
     openWorldHint: true,
     readOnlyHint: true,
   },
-  description: "Emit new event when the exchange rate between two currencies changes. [See the documentation](https://unirateapi.com/docs).",
+  description: "Emit new event when the exchange rate between two currencies changes. [See the documentation](https://unirateapi.com/apidocs).",
   type: "source",
   dedupe: "unique",
   props: {

package/unirateapi.app.mjs

@@ -16,6 +16,12 @@ export default {
         }));
       },
     },
+    countryCode: {
+      type: "string",
+      label: "Country Code",
+      description: "An EU VAT country code (e.g. `DE`, `FR`, `UK`). These follow the EU VAT convention rather than ISO 3166-1 alpha-2 — Greece is `EL` (not `GR`) and the United Kingdom is `UK` (not `GB`).",
+      optional: true,
+    },
   },
   methods: {
     _apiUrl() {
@@ -53,9 +59,7 @@ export default {
         path: "rates",
         params: {
           from,
-          ...(to && {
-            to,
-          }),
+          to,
         },
         ...args,
       });
@@ -73,5 +77,16 @@ export default {
         ...args,
       });
     },
+    getVatRates({
+      country, ...args
+    } = {}) {
+      return this._makeRequest({
+        path: "vat/rates",
+        params: {
+          country,
+        },
+        ...args,
+      });
+    },
   },
 };