vite-plugin-unirate 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Unirate Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,128 @@
+# vite-plugin-unirate
+
+Vite plugin for [UniRate](https://unirateapi.com) that gives you two ways to use live currency data without ever shipping your API key to the browser:
+
+1. **`virtual:unirate`** — a build-time virtual module. The plugin fetches rates and the supported-currency list once during the build and bakes them into your bundle as frozen, tree-shakeable constants. No runtime fetch, no client-side key.
+2. **Dev-server proxy** — `configureServer` mounts `/__unirate/rate|convert|currencies|vat`. Those routes call UniRate **server-side**, so the API key stays on your machine while you develop against live rates.
+
+- Zero runtime dependencies (uses native `fetch`).
+- `vite` is a peer dependency (`>=5.0.0`).
+- Full typed error mapping (400/401/403/404/429/503).
+
+## Install
+
+```sh
+npm install vite-plugin-unirate
+```
+
+You'll need a free UniRate API key — grab one at <https://unirateapi.com>.
+
+## Configure
+
+```ts
+// vite.config.ts
+import { defineConfig } from "vite";
+import unirate from "vite-plugin-unirate";
+
+export default defineConfig({
+  plugins: [
+    unirate({
+      apiKey: process.env.UNIRATE_API_KEY,
+      baseCurrency: "USD",
+      currencies: ["EUR", "GBP", "JPY", "CAD", "AUD"],
+    }),
+  ],
+});
+```
+
+If `apiKey` is omitted the plugin reads `UNIRATE_API_KEY` from the environment.
+
+### Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | `process.env.UNIRATE_API_KEY` | UniRate API key. Used server-side only. |
+| `baseCurrency` | `string` | `"USD"` | Base currency the build-time snapshot is keyed against. |
+| `currencies` | `string[]` | _all UniRate currencies_ | Optional allowlist to shrink the baked snapshot. |
+| `baseUrl` | `string` | `"https://api.unirateapi.com"` | API host. Override for self-hosted or testing. |
+
+## 1. Build-time virtual module
+
+```ts
+import { rates, currencies, base, fetchedAt } from "virtual:unirate";
+
+console.log(`1 ${base} = ${rates.EUR} EUR`); // baked at build time
+```
+
+Everything resolves to constants in the final bundle — there is no network call at runtime and the API key never leaves the build.
+
+### Typing the virtual module
+
+Add the ambient reference once (e.g. in your `src/env.d.ts` next to `/// <reference types="vite/client" />`):
+
+```ts
+/// <reference types="vite-plugin-unirate/virtual" />
+```
+
+Now the import is fully typed:
+
+```ts
+import snapshot from "virtual:unirate";
+// snapshot: { base: string; rates: Record<string, number>; currencies: string[]; fetchedAt: string }
+```
+
+## 2. Dev-server proxy
+
+While `vite dev` is running, four routes call UniRate on the server:
+
+| Route | Upstream | Response |
+|---|---|---|
+| `GET /__unirate/rate?from=USD&to=EUR` | `/api/rates` | `{ "rates": { "USD": 1, "EUR": 0.925 } }` |
+| `GET /__unirate/convert?from=USD&to=EUR&amount=100` | `/api/convert` | `{ "result": 92.5 }` |
+| `GET /__unirate/currencies` | `/api/currencies` | `{ "currencies": ["USD", "EUR", ...] }` |
+| `GET /__unirate/vat?country=DE` | `/api/vat/rates` | `{ "vat_data": { ... } }` (omit `country` for all) |
+
+```ts
+const res = await fetch("/__unirate/convert?from=USD&to=EUR&amount=100");
+const { result } = await res.json();
+```
+
+Because the key lives in the Vite process, nothing sensitive ships to the browser. For production, either rely on the build-time `virtual:unirate` snapshot or run the same proxy behind your own backend.
+
+## Error handling
+
+Upstream UniRate errors are mapped to typed errors and re-surfaced with the correct status. On the dev-server proxy the HTTP status is preserved and the body is `{ "error": "<message>" }`.
+
+| Status | Error type | Meaning |
+|---|---|---|
+| 400 | `InvalidDateError` | Invalid request parameters |
+| 401 | `AuthenticationError` | Missing or invalid API key |
+| 403 | `APIError` | Endpoint requires a Pro subscription |
+| 404 | `InvalidCurrencyError` | Currency not found or no data available |
+| 429 | `RateLimitError` | Rate limit exceeded |
+| 503 | `APIError` | Service unavailable |
+
+All inherit from `UniRateError`. Network/transport failures surface as the base `UniRateError` (and become a `502` on the proxy).
+
+```ts
+import { UniRateClient, AuthenticationError } from "vite-plugin-unirate";
+
+const client = new UniRateClient({ apiKey: process.env.UNIRATE_API_KEY! });
+try {
+  await client.getRates("USD", ["EUR"]);
+} catch (err) {
+  if (err instanceof AuthenticationError) { /* fix the key */ }
+}
+```
+
+## Rate limits
+
+The free tier is rate-limited; a `429` maps to `RateLimitError`. Historical and time-series endpoints are Pro-gated (`403`) and are intentionally not exposed by this plugin.
+
+## Related clients
+
+Part of the UniRate client family — see [github.com/UniRate-API](https://github.com/UniRate-API) for the Astro, Eleventy, Next, Nuxt, SvelteKit, Vue, and framework-agnostic Node/Python/Go/Rust/etc. clients.
+
+## License
+
+MIT © 2026 Unirate Team

package/dist/cjs/client.cjs

@@ -0,0 +1,228 @@
+"use strict";
+// Tiny, dependency-free fetch wrapper around the UniRate REST API.
+//
+// The plugin runs this on the server side only — during the build (to bake the
+// `virtual:unirate` snapshot) and inside the dev-server proxy — so the API key
+// never reaches the client bundle. Native `fetch` is available in Node 18+
+// (required by Vite 5).
+//
+// Free-tier endpoints used here:
+//   GET /api/rates       — current rates for one base
+//   GET /api/convert     — single amount conversion
+//   GET /api/currencies  — supported ISO codes
+//   GET /api/vat/rates   — VAT rates (all countries or one)
+//
+// `Accept: application/json` is set on every request because /api/currencies
+// (and friends) return an HTML 404 without it (see workspace CLAUDE.md
+// "Key gotchas" #2).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UniRateClient = exports.APIError = exports.RateLimitError = exports.InvalidCurrencyError = exports.AuthenticationError = exports.InvalidDateError = exports.UniRateError = void 0;
+exports.mapError = mapError;
+/** Base error every typed UniRate error inherits from. */
+class UniRateError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "UniRateError";
+        this.status = status;
+        this.body = body;
+        // Restore prototype chain for instanceof across the down-leveled build.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.UniRateError = UniRateError;
+/** 400 — malformed request parameters (also the historical `date` case). */
+class InvalidDateError extends UniRateError {
+    constructor(message = "Invalid request parameters", body) {
+        super(message, 400, body);
+        this.name = "InvalidDateError";
+    }
+}
+exports.InvalidDateError = InvalidDateError;
+/** 401 — missing or invalid API key. */
+class AuthenticationError extends UniRateError {
+    constructor(message = "Missing or invalid API key", body) {
+        super(message, 401, body);
+        this.name = "AuthenticationError";
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+/** 404 — currency (or country) not found / no data available. */
+class InvalidCurrencyError extends UniRateError {
+    constructor(message = "Currency not found or no data available", body) {
+        super(message, 404, body);
+        this.name = "InvalidCurrencyError";
+    }
+}
+exports.InvalidCurrencyError = InvalidCurrencyError;
+/** 429 — rate limit exceeded. */
+class RateLimitError extends UniRateError {
+    constructor(message = "Rate limit exceeded", body) {
+        super(message, 429, body);
+        this.name = "RateLimitError";
+    }
+}
+exports.RateLimitError = RateLimitError;
+/**
+ * Generic API error carrying the HTTP status. Used for 403 (Pro-gated
+ * endpoint on the free tier), 503 (service unavailable), and any other
+ * unexpected non-2xx status.
+ */
+class APIError extends UniRateError {
+    constructor(message, status, body) {
+        super(message, status, body);
+        this.name = "APIError";
+    }
+}
+exports.APIError = APIError;
+const DEFAULT_BASE_URL = "https://api.unirateapi.com";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const toNum = (v) => {
+    const n = typeof v === "string" ? Number.parseFloat(v) : v;
+    if (!Number.isFinite(n))
+        throw new UniRateError(`Non-numeric value: ${String(v)}`);
+    return n;
+};
+/**
+ * Map an HTTP status + parsed body to the correct typed error.
+ * Exported so the dev-server proxy can reuse the exact same mapping.
+ */
+function mapError(status, body, path) {
+    const apiMsg = body && typeof body === "object" && "error" in body && typeof body.error === "string"
+        ? body.error
+        : undefined;
+    switch (status) {
+        case 400:
+            return new InvalidDateError(apiMsg ?? "Invalid request parameters", body);
+        case 401:
+            return new AuthenticationError(apiMsg ?? "Missing or invalid API key", body);
+        case 403:
+            return new APIError(apiMsg ?? "Endpoint requires a Pro subscription", 403, body);
+        case 404:
+            return new InvalidCurrencyError(apiMsg ?? "Currency not found or no data available", body);
+        case 429:
+            return new RateLimitError(apiMsg ?? "Rate limit exceeded", body);
+        case 503:
+            return new APIError(apiMsg ?? "Service unavailable", 503, body);
+        default:
+            return new APIError(apiMsg ?? `HTTP ${status} from ${path}`, status, body);
+    }
+}
+class UniRateClient {
+    #apiKey;
+    #baseUrl;
+    #fetch;
+    #timeoutMs;
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new UniRateError("apiKey is required");
+        this.#apiKey = opts.apiKey;
+        this.#baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.#fetch = opts.fetch ?? globalThis.fetch;
+        this.#timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (typeof this.#fetch !== "function") {
+            throw new UniRateError("global fetch is unavailable; pass `fetch` explicitly");
+        }
+    }
+    async #get(path, params) {
+        const url = new URL(this.#baseUrl + path);
+        url.searchParams.set("api_key", this.#apiKey);
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.#timeoutMs);
+        let res;
+        try {
+            res = await this.#fetch(url.toString(), {
+                headers: { Accept: "application/json" },
+                signal: ctrl.signal,
+            });
+        }
+        catch (err) {
+            // Network / transport / abort failure — wrap in the base error.
+            throw new UniRateError(`Network error contacting ${path}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : null;
+        }
+        catch {
+            // The HTML-404 case (missing Accept header) also lands here defensively.
+            if (!res.ok)
+                throw mapError(res.status, text, path);
+            throw new UniRateError(`Non-JSON response from ${path}`, res.status, text);
+        }
+        if (!res.ok)
+            throw mapError(res.status, body, path);
+        return body;
+    }
+    /**
+     * Current rates for `from`. With no `to`, returns every rate for the base.
+     * With a single-element `to`, tolerates the `{ rate }` shorthand shape.
+     */
+    async getRates(from, to) {
+        const params = { from: from.toUpperCase() };
+        if (to && to.length > 0)
+            params.to = to.map((c) => c.toUpperCase()).join(",");
+        const raw = await this.#get("/api/rates", params);
+        const rates = {};
+        if (raw.rates) {
+            for (const [code, val] of Object.entries(raw.rates))
+                rates[code] = toNum(val);
+        }
+        else if (raw.rate !== undefined && to && to.length === 1) {
+            rates[to[0].toUpperCase()] = toNum(raw.rate);
+        }
+        else {
+            throw new UniRateError("Malformed /api/rates response", undefined, raw);
+        }
+        rates[from.toUpperCase()] = 1;
+        return rates;
+    }
+    /** Convert `amount` from one currency to another. */
+    async convert(amount, from, to) {
+        const raw = await this.#get("/api/convert", {
+            from: from.toUpperCase(),
+            to: to.toUpperCase(),
+            amount,
+        });
+        if (raw.result === undefined)
+            throw new UniRateError("Malformed /api/convert response", undefined, raw);
+        return toNum(raw.result);
+    }
+    /** Supported ISO currency codes. */
+    async listCurrencies() {
+        const raw = await this.#get("/api/currencies", {});
+        if (!Array.isArray(raw.currencies)) {
+            throw new UniRateError("Malformed /api/currencies response", undefined, raw);
+        }
+        return raw.currencies;
+    }
+    /** VAT rates for all countries, keyed by ISO-3166 alpha-2 code. */
+    async getVatRates() {
+        const raw = await this.#get("/api/vat/rates", {});
+        if (!raw.vat_rates || typeof raw.vat_rates !== "object") {
+            throw new UniRateError("Malformed /api/vat/rates response", undefined, raw);
+        }
+        return raw.vat_rates;
+    }
+    /** VAT rate for a single country. */
+    async getVatRate(country) {
+        const raw = await this.#get("/api/vat/rates", {
+            country: country.toUpperCase(),
+        });
+        if (!raw.vat_data || typeof raw.vat_data !== "object") {
+            throw new UniRateError("Malformed /api/vat/rates response", undefined, raw);
+        }
+        return raw.vat_data;
+    }
+}
+exports.UniRateClient = UniRateClient;
+//# sourceMappingURL=client.cjs.map

package/dist/cjs/client.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/cjs/index.cjs

@@ -0,0 +1,25 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapError = exports.RateLimitError = exports.InvalidDateError = exports.InvalidCurrencyError = exports.AuthenticationError = exports.APIError = exports.UniRateError = exports.UniRateClient = exports.PROXY_BASE = exports.RESOLVED_ID = exports.VIRTUAL_ID = exports.renderVirtualModule = exports.createProxyHandler = exports.buildSnapshot = exports.uniratePlugin = exports.default = void 0;
+var plugin_js_1 = require("./plugin.cjs");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return __importDefault(plugin_js_1).default; } });
+Object.defineProperty(exports, "uniratePlugin", { enumerable: true, get: function () { return __importDefault(plugin_js_1).default; } });
+Object.defineProperty(exports, "buildSnapshot", { enumerable: true, get: function () { return plugin_js_1.buildSnapshot; } });
+Object.defineProperty(exports, "createProxyHandler", { enumerable: true, get: function () { return plugin_js_1.createProxyHandler; } });
+Object.defineProperty(exports, "renderVirtualModule", { enumerable: true, get: function () { return plugin_js_1.renderVirtualModule; } });
+Object.defineProperty(exports, "VIRTUAL_ID", { enumerable: true, get: function () { return plugin_js_1.VIRTUAL_ID; } });
+Object.defineProperty(exports, "RESOLVED_ID", { enumerable: true, get: function () { return plugin_js_1.RESOLVED_ID; } });
+Object.defineProperty(exports, "PROXY_BASE", { enumerable: true, get: function () { return plugin_js_1.PROXY_BASE; } });
+var client_js_1 = require("./client.cjs");
+Object.defineProperty(exports, "UniRateClient", { enumerable: true, get: function () { return client_js_1.UniRateClient; } });
+Object.defineProperty(exports, "UniRateError", { enumerable: true, get: function () { return client_js_1.UniRateError; } });
+Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return client_js_1.APIError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return client_js_1.AuthenticationError; } });
+Object.defineProperty(exports, "InvalidCurrencyError", { enumerable: true, get: function () { return client_js_1.InvalidCurrencyError; } });
+Object.defineProperty(exports, "InvalidDateError", { enumerable: true, get: function () { return client_js_1.InvalidDateError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return client_js_1.RateLimitError; } });
+Object.defineProperty(exports, "mapError", { enumerable: true, get: function () { return client_js_1.mapError; } });
+//# sourceMappingURL=index.cjs.map

package/dist/cjs/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";;;;;;AAAA,yCASqB;AARnB,qHAAA,OAAO,OAAA;AACP,2HAAA,OAAO,OAAiB;AACxB,0GAAA,aAAa,OAAA;AACb,+GAAA,kBAAkB,OAAA;AAClB,gHAAA,mBAAmB,OAAA;AACnB,uGAAA,UAAU,OAAA;AACV,wGAAA,WAAW,OAAA;AACX,uGAAA,UAAU,OAAA;AAIZ,yCASqB;AARnB,0GAAA,aAAa,OAAA;AACb,yGAAA,YAAY,OAAA;AACZ,qGAAA,QAAQ,OAAA;AACR,gHAAA,mBAAmB,OAAA;AACnB,iHAAA,oBAAoB,OAAA;AACpB,6GAAA,gBAAgB,OAAA;AAChB,2GAAA,cAAc,OAAA;AACd,qGAAA,QAAQ,OAAA"}

package/dist/cjs/plugin.cjs

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROXY_BASE = exports.RESOLVED_ID = exports.VIRTUAL_ID = void 0;
+exports.renderVirtualModule = renderVirtualModule;
+exports.buildSnapshot = buildSnapshot;
+exports.createProxyHandler = createProxyHandler;
+exports.default = uniratePlugin;
+const client_js_1 = require("./client.cjs");
+exports.VIRTUAL_ID = "virtual:unirate";
+exports.RESOLVED_ID = "\0" + exports.VIRTUAL_ID;
+/** Dev-server proxy mount path. Routes: /rate /convert /currencies /vat. */
+exports.PROXY_BASE = "/__unirate";
+const DEFAULT_BASE_CURRENCY = "USD";
+function resolveApiKey(options) {
+    const key = options.apiKey ?? process.env.UNIRATE_API_KEY;
+    if (!key) {
+        throw new client_js_1.UniRateError("vite-plugin-unirate: no API key. Pass `apiKey` or set UNIRATE_API_KEY.");
+    }
+    return key;
+}
+/** Serialize a snapshot into a typed ESM module source string. */
+function renderVirtualModule(snapshot) {
+    const payload = JSON.stringify(snapshot);
+    return [
+        `const snapshot = Object.freeze(${payload});`,
+        `export default snapshot;`,
+        `export const base = snapshot.base;`,
+        `export const rates = snapshot.rates;`,
+        `export const currencies = snapshot.currencies;`,
+        `export const fetchedAt = snapshot.fetchedAt;`,
+        ``,
+    ].join("\n");
+}
+/**
+ * Fetch the build-time snapshot: all rates for the base currency plus the
+ * supported-currency list. `currencies` narrows the baked rate map.
+ */
+async function buildSnapshot(options) {
+    const apiKey = resolveApiKey(options);
+    const base = (options.baseCurrency ?? DEFAULT_BASE_CURRENCY).toUpperCase();
+    const client = new client_js_1.UniRateClient({
+        apiKey,
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+    const wanted = options.currencies?.map((c) => c.toUpperCase());
+    const rates = await client.getRates(base, wanted);
+    const currencies = await client.listCurrencies();
+    return {
+        base,
+        rates,
+        currencies,
+        fetchedAt: new Date().toISOString(),
+    };
+}
+/** Read the JSON body of the response and translate our errors to HTTP. */
+function sendJson(res, status, payload) {
+    const text = JSON.stringify(payload);
+    res.statusCode = status;
+    res.setHeader("Content-Type", "application/json");
+    res.end(text);
+}
+function errorStatus(err) {
+    if (err instanceof client_js_1.UniRateError && typeof err.status === "number")
+        return err.status;
+    return 502;
+}
+/**
+ * Build the dev-server request handler for the `/__unirate/*` proxy routes.
+ * Exported so tests can drive it without a real Vite server.
+ */
+function createProxyHandler(options) {
+    const client = new client_js_1.UniRateClient({
+        apiKey: resolveApiKey(options),
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+    return async function unirateProxy(req, res, next) {
+        const rawUrl = req.url ?? "";
+        if (!rawUrl.startsWith(exports.PROXY_BASE + "/")) {
+            next();
+            return;
+        }
+        // Parse against a dummy origin so query params are accessible.
+        let url;
+        try {
+            url = new URL(rawUrl, "http://localhost");
+        }
+        catch {
+            sendJson(res, 400, { error: "Bad request URL" });
+            return;
+        }
+        const route = url.pathname.slice(exports.PROXY_BASE.length + 1);
+        const q = url.searchParams;
+        try {
+            switch (route) {
+                case "rate": {
+                    const from = q.get("from") ?? DEFAULT_BASE_CURRENCY;
+                    const to = q.get("to");
+                    const rates = await client.getRates(from, to ? [to] : undefined);
+                    sendJson(res, 200, { rates });
+                    return;
+                }
+                case "convert": {
+                    const from = q.get("from") ?? DEFAULT_BASE_CURRENCY;
+                    const to = q.get("to");
+                    const amountRaw = q.get("amount") ?? "1";
+                    if (!to) {
+                        sendJson(res, 400, { error: "`to` is required" });
+                        return;
+                    }
+                    const amount = Number.parseFloat(amountRaw);
+                    if (!Number.isFinite(amount)) {
+                        sendJson(res, 400, { error: "`amount` must be numeric" });
+                        return;
+                    }
+                    const result = await client.convert(amount, from, to);
+                    sendJson(res, 200, { result });
+                    return;
+                }
+                case "currencies": {
+                    const currencies = await client.listCurrencies();
+                    sendJson(res, 200, { currencies });
+                    return;
+                }
+                case "vat": {
+                    const country = q.get("country");
+                    if (country) {
+                        const vat = await client.getVatRate(country);
+                        sendJson(res, 200, { vat_data: vat });
+                    }
+                    else {
+                        const vat = await client.getVatRates();
+                        sendJson(res, 200, { vat_rates: vat });
+                    }
+                    return;
+                }
+                default:
+                    sendJson(res, 404, { error: `Unknown UniRate proxy route: ${route}` });
+                    return;
+            }
+        }
+        catch (err) {
+            const status = errorStatus(err);
+            const message = err instanceof Error ? err.message : String(err);
+            sendJson(res, status, { error: message });
+            return;
+        }
+    };
+}
+/**
+ * Vite plugin for UniRate.
+ *
+ * 1. `virtual:unirate` — a build-time virtual module that fetches rates +
+ *    currencies once and exposes them as a typed, tree-shakeable ESM export.
+ * 2. `/__unirate/{rate,convert,currencies,vat}` — a dev-server proxy that
+ *    calls UniRate server-side so the API key never enters the client bundle.
+ */
+function uniratePlugin(options = {}) {
+    let snapshotPromise;
+    return {
+        name: "vite-plugin-unirate",
+        resolveId(id) {
+            return id === exports.VIRTUAL_ID ? exports.RESOLVED_ID : null;
+        },
+        async load(id) {
+            if (id !== exports.RESOLVED_ID)
+                return null;
+            // Fetch once and memoize across the build.
+            snapshotPromise ??= buildSnapshot(options);
+            const snapshot = await snapshotPromise;
+            return renderVirtualModule(snapshot);
+        },
+        configureServer(server) {
+            const handler = createProxyHandler(options);
+            server.middlewares.use(handler);
+        },
+    };
+}
+//# sourceMappingURL=plugin.cjs.map

package/dist/cjs/plugin.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"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"}

package/dist/esm/client.d.ts

@@ -0,0 +1,64 @@
+/** Base error every typed UniRate error inherits from. */
+export declare class UniRateError extends Error {
+    readonly status?: number;
+    readonly body?: unknown;
+    constructor(message: string, status?: number, body?: unknown);
+}
+/** 400 — malformed request parameters (also the historical `date` case). */
+export declare class InvalidDateError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+/** 401 — missing or invalid API key. */
+export declare class AuthenticationError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+/** 404 — currency (or country) not found / no data available. */
+export declare class InvalidCurrencyError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+/** 429 — rate limit exceeded. */
+export declare class RateLimitError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+/**
+ * Generic API error carrying the HTTP status. Used for 403 (Pro-gated
+ * endpoint on the free tier), 503 (service unavailable), and any other
+ * unexpected non-2xx status.
+ */
+export declare class APIError extends UniRateError {
+    constructor(message: string, status: number, body?: unknown);
+}
+export interface UniRateClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+export interface VatRate {
+    country_code: string;
+    country_name: string;
+    vat_rate: number;
+}
+/**
+ * Map an HTTP status + parsed body to the correct typed error.
+ * Exported so the dev-server proxy can reuse the exact same mapping.
+ */
+export declare function mapError(status: number, body: unknown, path: string): UniRateError;
+export declare class UniRateClient {
+    #private;
+    constructor(opts: UniRateClientOptions);
+    /**
+     * Current rates for `from`. With no `to`, returns every rate for the base.
+     * With a single-element `to`, tolerates the `{ rate }` shorthand shape.
+     */
+    getRates(from: string, to?: string[]): Promise<Record<string, number>>;
+    /** Convert `amount` from one currency to another. */
+    convert(amount: number, from: string, to: string): Promise<number>;
+    /** Supported ISO currency codes. */
+    listCurrencies(): Promise<string[]>;
+    /** VAT rates for all countries, keyed by ISO-3166 alpha-2 code. */
+    getVatRates(): Promise<Record<string, VatRate>>;
+    /** VAT rate for a single country. */
+    getVatRate(country: string): Promise<VatRate>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/esm/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAiBA,0DAA0D;AAC1D,qBAAa,YAAa,SAAQ,KAAK;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;gBACZ,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAQ7D;AAED,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,YAAY;gBACpC,OAAO,SAA+B,EAAE,IAAI,CAAC,EAAE,OAAO;CAInE;AAED,wCAAwC;AACxC,qBAAa,mBAAoB,SAAQ,YAAY;gBACvC,OAAO,SAA+B,EAAE,IAAI,CAAC,EAAE,OAAO;CAInE;AAED,iEAAiE;AACjE,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,OAAO,SAA4C,EAAE,IAAI,CAAC,EAAE,OAAO;CAIhF;AAED,iCAAiC;AACjC,qBAAa,cAAe,SAAQ,YAAY;gBAClC,OAAO,SAAwB,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5D;AAED;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,YAAY;gBAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO;CAI5D;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAWD;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,YAAY,CAqBlF;AAED,qBAAa,aAAa;;gBAMZ,IAAI,EAAE,oBAAoB;IA+CtC;;;OAGG;IACG,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAmB5E,qDAAqD;IAC/C,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAUxE,oCAAoC;IAC9B,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAQzC,mEAAmE;IAC7D,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAQrD,qCAAqC;IAC/B,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CASpD"}

package/dist/esm/client.js

@@ -0,0 +1,217 @@
+// Tiny, dependency-free fetch wrapper around the UniRate REST API.
+//
+// The plugin runs this on the server side only — during the build (to bake the
+// `virtual:unirate` snapshot) and inside the dev-server proxy — so the API key
+// never reaches the client bundle. Native `fetch` is available in Node 18+
+// (required by Vite 5).
+//
+// Free-tier endpoints used here:
+//   GET /api/rates       — current rates for one base
+//   GET /api/convert     — single amount conversion
+//   GET /api/currencies  — supported ISO codes
+//   GET /api/vat/rates   — VAT rates (all countries or one)
+//
+// `Accept: application/json` is set on every request because /api/currencies
+// (and friends) return an HTML 404 without it (see workspace CLAUDE.md
+// "Key gotchas" #2).
+/** Base error every typed UniRate error inherits from. */
+export class UniRateError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "UniRateError";
+        this.status = status;
+        this.body = body;
+        // Restore prototype chain for instanceof across the down-leveled build.
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+/** 400 — malformed request parameters (also the historical `date` case). */
+export class InvalidDateError extends UniRateError {
+    constructor(message = "Invalid request parameters", body) {
+        super(message, 400, body);
+        this.name = "InvalidDateError";
+    }
+}
+/** 401 — missing or invalid API key. */
+export class AuthenticationError extends UniRateError {
+    constructor(message = "Missing or invalid API key", body) {
+        super(message, 401, body);
+        this.name = "AuthenticationError";
+    }
+}
+/** 404 — currency (or country) not found / no data available. */
+export class InvalidCurrencyError extends UniRateError {
+    constructor(message = "Currency not found or no data available", body) {
+        super(message, 404, body);
+        this.name = "InvalidCurrencyError";
+    }
+}
+/** 429 — rate limit exceeded. */
+export class RateLimitError extends UniRateError {
+    constructor(message = "Rate limit exceeded", body) {
+        super(message, 429, body);
+        this.name = "RateLimitError";
+    }
+}
+/**
+ * Generic API error carrying the HTTP status. Used for 403 (Pro-gated
+ * endpoint on the free tier), 503 (service unavailable), and any other
+ * unexpected non-2xx status.
+ */
+export class APIError extends UniRateError {
+    constructor(message, status, body) {
+        super(message, status, body);
+        this.name = "APIError";
+    }
+}
+const DEFAULT_BASE_URL = "https://api.unirateapi.com";
+const DEFAULT_TIMEOUT_MS = 15_000;
+const toNum = (v) => {
+    const n = typeof v === "string" ? Number.parseFloat(v) : v;
+    if (!Number.isFinite(n))
+        throw new UniRateError(`Non-numeric value: ${String(v)}`);
+    return n;
+};
+/**
+ * Map an HTTP status + parsed body to the correct typed error.
+ * Exported so the dev-server proxy can reuse the exact same mapping.
+ */
+export function mapError(status, body, path) {
+    const apiMsg = body && typeof body === "object" && "error" in body && typeof body.error === "string"
+        ? body.error
+        : undefined;
+    switch (status) {
+        case 400:
+            return new InvalidDateError(apiMsg ?? "Invalid request parameters", body);
+        case 401:
+            return new AuthenticationError(apiMsg ?? "Missing or invalid API key", body);
+        case 403:
+            return new APIError(apiMsg ?? "Endpoint requires a Pro subscription", 403, body);
+        case 404:
+            return new InvalidCurrencyError(apiMsg ?? "Currency not found or no data available", body);
+        case 429:
+            return new RateLimitError(apiMsg ?? "Rate limit exceeded", body);
+        case 503:
+            return new APIError(apiMsg ?? "Service unavailable", 503, body);
+        default:
+            return new APIError(apiMsg ?? `HTTP ${status} from ${path}`, status, body);
+    }
+}
+export class UniRateClient {
+    #apiKey;
+    #baseUrl;
+    #fetch;
+    #timeoutMs;
+    constructor(opts) {
+        if (!opts.apiKey)
+            throw new UniRateError("apiKey is required");
+        this.#apiKey = opts.apiKey;
+        this.#baseUrl = (opts.baseUrl ?? DEFAULT_BASE_URL).replace(/\/+$/, "");
+        this.#fetch = opts.fetch ?? globalThis.fetch;
+        this.#timeoutMs = opts.timeoutMs ?? DEFAULT_TIMEOUT_MS;
+        if (typeof this.#fetch !== "function") {
+            throw new UniRateError("global fetch is unavailable; pass `fetch` explicitly");
+        }
+    }
+    async #get(path, params) {
+        const url = new URL(this.#baseUrl + path);
+        url.searchParams.set("api_key", this.#apiKey);
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+        const ctrl = new AbortController();
+        const timer = setTimeout(() => ctrl.abort(), this.#timeoutMs);
+        let res;
+        try {
+            res = await this.#fetch(url.toString(), {
+                headers: { Accept: "application/json" },
+                signal: ctrl.signal,
+            });
+        }
+        catch (err) {
+            // Network / transport / abort failure — wrap in the base error.
+            throw new UniRateError(`Network error contacting ${path}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        const text = await res.text();
+        let body;
+        try {
+            body = text ? JSON.parse(text) : null;
+        }
+        catch {
+            // The HTML-404 case (missing Accept header) also lands here defensively.
+            if (!res.ok)
+                throw mapError(res.status, text, path);
+            throw new UniRateError(`Non-JSON response from ${path}`, res.status, text);
+        }
+        if (!res.ok)
+            throw mapError(res.status, body, path);
+        return body;
+    }
+    /**
+     * Current rates for `from`. With no `to`, returns every rate for the base.
+     * With a single-element `to`, tolerates the `{ rate }` shorthand shape.
+     */
+    async getRates(from, to) {
+        const params = { from: from.toUpperCase() };
+        if (to && to.length > 0)
+            params.to = to.map((c) => c.toUpperCase()).join(",");
+        const raw = await this.#get("/api/rates", params);
+        const rates = {};
+        if (raw.rates) {
+            for (const [code, val] of Object.entries(raw.rates))
+                rates[code] = toNum(val);
+        }
+        else if (raw.rate !== undefined && to && to.length === 1) {
+            rates[to[0].toUpperCase()] = toNum(raw.rate);
+        }
+        else {
+            throw new UniRateError("Malformed /api/rates response", undefined, raw);
+        }
+        rates[from.toUpperCase()] = 1;
+        return rates;
+    }
+    /** Convert `amount` from one currency to another. */
+    async convert(amount, from, to) {
+        const raw = await this.#get("/api/convert", {
+            from: from.toUpperCase(),
+            to: to.toUpperCase(),
+            amount,
+        });
+        if (raw.result === undefined)
+            throw new UniRateError("Malformed /api/convert response", undefined, raw);
+        return toNum(raw.result);
+    }
+    /** Supported ISO currency codes. */
+    async listCurrencies() {
+        const raw = await this.#get("/api/currencies", {});
+        if (!Array.isArray(raw.currencies)) {
+            throw new UniRateError("Malformed /api/currencies response", undefined, raw);
+        }
+        return raw.currencies;
+    }
+    /** VAT rates for all countries, keyed by ISO-3166 alpha-2 code. */
+    async getVatRates() {
+        const raw = await this.#get("/api/vat/rates", {});
+        if (!raw.vat_rates || typeof raw.vat_rates !== "object") {
+            throw new UniRateError("Malformed /api/vat/rates response", undefined, raw);
+        }
+        return raw.vat_rates;
+    }
+    /** VAT rate for a single country. */
+    async getVatRate(country) {
+        const raw = await this.#get("/api/vat/rates", {
+            country: country.toUpperCase(),
+        });
+        if (!raw.vat_data || typeof raw.vat_data !== "object") {
+            throw new UniRateError("Malformed /api/vat/rates response", undefined, raw);
+        }
+        return raw.vat_data;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export { default, default as uniratePlugin, buildSnapshot, createProxyHandler, renderVirtualModule, VIRTUAL_ID, RESOLVED_ID, PROXY_BASE, } from "./plugin.js";
+export type { UniRatePluginOptions, UniRateSnapshot } from "./plugin.js";
+export { UniRateClient, UniRateError, APIError, AuthenticationError, InvalidCurrencyError, InvalidDateError, RateLimitError, mapError, } from "./client.js";
+export type { UniRateClientOptions, VatRate } from "./client.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,aAAa,EACxB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,3 @@
+export { default, default as uniratePlugin, buildSnapshot, createProxyHandler, renderVirtualModule, VIRTUAL_ID, RESOLVED_ID, PROXY_BASE, } from "./plugin.js";
+export { UniRateClient, UniRateError, APIError, AuthenticationError, InvalidCurrencyError, InvalidDateError, RateLimitError, mapError, } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,OAAO,EACP,OAAO,IAAI,aAAa,EACxB,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,WAAW,EACX,UAAU,GACX,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,QAAQ,EACR,mBAAmB,EACnB,oBAAoB,EACpB,gBAAgB,EAChB,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC"}

package/dist/esm/plugin.d.ts

@@ -0,0 +1,46 @@
+import type { Plugin, Connect } from "vite";
+export declare const VIRTUAL_ID = "virtual:unirate";
+export declare const RESOLVED_ID: string;
+/** Dev-server proxy mount path. Routes: /rate /convert /currencies /vat. */
+export declare const PROXY_BASE = "/__unirate";
+export interface UniRatePluginOptions {
+    /** UniRate API key. Falls back to `process.env.UNIRATE_API_KEY`. */
+    apiKey?: string;
+    /** Base currency for the build-time snapshot. Default `"USD"`. */
+    baseCurrency?: string;
+    /** Optional allowlist to shrink the baked snapshot. Default: all currencies. */
+    currencies?: string[];
+    /** API host. Override for self-hosted / testing. */
+    baseUrl?: string;
+    /** Injectable fetch — used by tests, defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+/** Shape emitted by the `virtual:unirate` module. */
+export interface UniRateSnapshot {
+    base: string;
+    rates: Record<string, number>;
+    currencies: string[];
+    fetchedAt: string;
+}
+/** Serialize a snapshot into a typed ESM module source string. */
+export declare function renderVirtualModule(snapshot: UniRateSnapshot): string;
+/**
+ * Fetch the build-time snapshot: all rates for the base currency plus the
+ * supported-currency list. `currencies` narrows the baked rate map.
+ */
+export declare function buildSnapshot(options: UniRatePluginOptions): Promise<UniRateSnapshot>;
+/**
+ * Build the dev-server request handler for the `/__unirate/*` proxy routes.
+ * Exported so tests can drive it without a real Vite server.
+ */
+export declare function createProxyHandler(options: UniRatePluginOptions): Connect.NextHandleFunction;
+/**
+ * Vite plugin for UniRate.
+ *
+ * 1. `virtual:unirate` — a build-time virtual module that fetches rates +
+ *    currencies once and exposes them as a typed, tree-shakeable ESM export.
+ * 2. `/__unirate/{rate,convert,currencies,vat}` — a dev-server proxy that
+ *    calls UniRate server-side so the API key never enters the client bundle.
+ */
+export default function uniratePlugin(options?: UniRatePluginOptions): Plugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/esm/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAiB,OAAO,EAAE,MAAM,MAAM,CAAC;AAG3D,eAAO,MAAM,UAAU,oBAAoB,CAAC;AAC5C,eAAO,MAAM,WAAW,QAAoB,CAAC;AAE7C,4EAA4E;AAC5E,eAAO,MAAM,UAAU,eAAe,CAAC;AAIvC,MAAM,WAAW,oBAAoB;IACnC,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,qDAAqD;AACrD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,kEAAkE;AAClE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,MAAM,CAWrE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmB3F;AAeD;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,kBAAkB,CA6E5F;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,OAAO,UAAU,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,MAAM,CAuBhF"}

package/dist/esm/plugin.js

@@ -0,0 +1,173 @@
+import { UniRateClient, UniRateError } from "./client.js";
+export const VIRTUAL_ID = "virtual:unirate";
+export const RESOLVED_ID = "\0" + VIRTUAL_ID;
+/** Dev-server proxy mount path. Routes: /rate /convert /currencies /vat. */
+export const PROXY_BASE = "/__unirate";
+const DEFAULT_BASE_CURRENCY = "USD";
+function resolveApiKey(options) {
+    const key = options.apiKey ?? process.env.UNIRATE_API_KEY;
+    if (!key) {
+        throw new UniRateError("vite-plugin-unirate: no API key. Pass `apiKey` or set UNIRATE_API_KEY.");
+    }
+    return key;
+}
+/** Serialize a snapshot into a typed ESM module source string. */
+export function renderVirtualModule(snapshot) {
+    const payload = JSON.stringify(snapshot);
+    return [
+        `const snapshot = Object.freeze(${payload});`,
+        `export default snapshot;`,
+        `export const base = snapshot.base;`,
+        `export const rates = snapshot.rates;`,
+        `export const currencies = snapshot.currencies;`,
+        `export const fetchedAt = snapshot.fetchedAt;`,
+        ``,
+    ].join("\n");
+}
+/**
+ * Fetch the build-time snapshot: all rates for the base currency plus the
+ * supported-currency list. `currencies` narrows the baked rate map.
+ */
+export async function buildSnapshot(options) {
+    const apiKey = resolveApiKey(options);
+    const base = (options.baseCurrency ?? DEFAULT_BASE_CURRENCY).toUpperCase();
+    const client = new UniRateClient({
+        apiKey,
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+    const wanted = options.currencies?.map((c) => c.toUpperCase());
+    const rates = await client.getRates(base, wanted);
+    const currencies = await client.listCurrencies();
+    return {
+        base,
+        rates,
+        currencies,
+        fetchedAt: new Date().toISOString(),
+    };
+}
+/** Read the JSON body of the response and translate our errors to HTTP. */
+function sendJson(res, status, payload) {
+    const text = JSON.stringify(payload);
+    res.statusCode = status;
+    res.setHeader("Content-Type", "application/json");
+    res.end(text);
+}
+function errorStatus(err) {
+    if (err instanceof UniRateError && typeof err.status === "number")
+        return err.status;
+    return 502;
+}
+/**
+ * Build the dev-server request handler for the `/__unirate/*` proxy routes.
+ * Exported so tests can drive it without a real Vite server.
+ */
+export function createProxyHandler(options) {
+    const client = new UniRateClient({
+        apiKey: resolveApiKey(options),
+        baseUrl: options.baseUrl,
+        fetch: options.fetch,
+    });
+    return async function unirateProxy(req, res, next) {
+        const rawUrl = req.url ?? "";
+        if (!rawUrl.startsWith(PROXY_BASE + "/")) {
+            next();
+            return;
+        }
+        // Parse against a dummy origin so query params are accessible.
+        let url;
+        try {
+            url = new URL(rawUrl, "http://localhost");
+        }
+        catch {
+            sendJson(res, 400, { error: "Bad request URL" });
+            return;
+        }
+        const route = url.pathname.slice(PROXY_BASE.length + 1);
+        const q = url.searchParams;
+        try {
+            switch (route) {
+                case "rate": {
+                    const from = q.get("from") ?? DEFAULT_BASE_CURRENCY;
+                    const to = q.get("to");
+                    const rates = await client.getRates(from, to ? [to] : undefined);
+                    sendJson(res, 200, { rates });
+                    return;
+                }
+                case "convert": {
+                    const from = q.get("from") ?? DEFAULT_BASE_CURRENCY;
+                    const to = q.get("to");
+                    const amountRaw = q.get("amount") ?? "1";
+                    if (!to) {
+                        sendJson(res, 400, { error: "`to` is required" });
+                        return;
+                    }
+                    const amount = Number.parseFloat(amountRaw);
+                    if (!Number.isFinite(amount)) {
+                        sendJson(res, 400, { error: "`amount` must be numeric" });
+                        return;
+                    }
+                    const result = await client.convert(amount, from, to);
+                    sendJson(res, 200, { result });
+                    return;
+                }
+                case "currencies": {
+                    const currencies = await client.listCurrencies();
+                    sendJson(res, 200, { currencies });
+                    return;
+                }
+                case "vat": {
+                    const country = q.get("country");
+                    if (country) {
+                        const vat = await client.getVatRate(country);
+                        sendJson(res, 200, { vat_data: vat });
+                    }
+                    else {
+                        const vat = await client.getVatRates();
+                        sendJson(res, 200, { vat_rates: vat });
+                    }
+                    return;
+                }
+                default:
+                    sendJson(res, 404, { error: `Unknown UniRate proxy route: ${route}` });
+                    return;
+            }
+        }
+        catch (err) {
+            const status = errorStatus(err);
+            const message = err instanceof Error ? err.message : String(err);
+            sendJson(res, status, { error: message });
+            return;
+        }
+    };
+}
+/**
+ * Vite plugin for UniRate.
+ *
+ * 1. `virtual:unirate` — a build-time virtual module that fetches rates +
+ *    currencies once and exposes them as a typed, tree-shakeable ESM export.
+ * 2. `/__unirate/{rate,convert,currencies,vat}` — a dev-server proxy that
+ *    calls UniRate server-side so the API key never enters the client bundle.
+ */
+export default function uniratePlugin(options = {}) {
+    let snapshotPromise;
+    return {
+        name: "vite-plugin-unirate",
+        resolveId(id) {
+            return id === VIRTUAL_ID ? RESOLVED_ID : null;
+        },
+        async load(id) {
+            if (id !== RESOLVED_ID)
+                return null;
+            // Fetch once and memoize across the build.
+            snapshotPromise ??= buildSnapshot(options);
+            const snapshot = await snapshotPromise;
+            return renderVirtualModule(snapshot);
+        },
+        configureServer(server) {
+            const handler = createProxyHandler(options);
+            server.middlewares.use(handler);
+        },
+    };
+}
+//# sourceMappingURL=plugin.js.map

package/dist/esm/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../../src/plugin.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,75 @@
+{
+  "name": "vite-plugin-unirate",
+  "version": "0.1.0",
+  "description": "Vite plugin for UniRate — a build-time `virtual:unirate` module with baked currency rates/currencies, plus a dev-server proxy that keeps your API key server-side.",
+  "type": "module",
+  "license": "MIT",
+  "author": "Unirate Team",
+  "homepage": "https://github.com/UniRate-API/vite-plugin-unirate#readme",
+  "bugs": "https://github.com/UniRate-API/vite-plugin-unirate/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/UniRate-API/vite-plugin-unirate.git"
+  },
+  "keywords": [
+    "vite",
+    "vite-plugin",
+    "unirate",
+    "currency",
+    "exchange-rates",
+    "forex",
+    "money",
+    "fx",
+    "fintech"
+  ],
+  "files": [
+    "dist",
+    "virtual.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/cjs/index.cjs",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/esm/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.cjs"
+    },
+    "./client": {
+      "types": "./dist/esm/client.d.ts",
+      "import": "./dist/esm/client.js",
+      "require": "./dist/cjs/client.cjs"
+    },
+    "./virtual": {
+      "types": "./virtual.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs",
+    "build:esm": "tsc -p tsconfig.build.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json && node ./scripts/finalize-cjs.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "vite": ">=5.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0",
+    "vite": "^7.1.5",
+    "vitest": "^4.1.7"
+  },
+  "engines": {
+    "node": ">=20.19.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/virtual.d.ts

@@ -0,0 +1,20 @@
+// Ambient declaration for the `virtual:unirate` module baked at build time by
+// vite-plugin-unirate. Reference it from your app's env.d.ts / a *.d.ts file:
+//
+//   /// <reference types="vite-plugin-unirate/virtual" />
+//
+// Then `import { rates, currencies } from "virtual:unirate"` is fully typed.
+declare module "virtual:unirate" {
+  export interface UniRateSnapshot {
+    base: string;
+    rates: Record<string, number>;
+    currencies: string[];
+    fetchedAt: string;
+  }
+  const snapshot: UniRateSnapshot;
+  export default snapshot;
+  export const base: string;
+  export const rates: Record<string, number>;
+  export const currencies: string[];
+  export const fetchedAt: string;
+}