@unirate/astro 0.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UniRate
+
+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,101 @@
+# @unirate/astro
+
+Astro integration for [UniRate](https://unirateapi.com) — fetches a currency exchange rate snapshot at build time, exposes it as a Vite virtual module, and ships `<Currency />` and `<Rate />` components plus runtime conversion helpers.
+
+- Build-time snapshot: rates resolve to constants in your static HTML; no client-side API key, no runtime fetch.
+- Zero runtime dependencies (uses native `fetch`).
+- Cross-pair conversion derived from a single base, so the snapshot stays small.
+- Astro 4 + 5 compatible. Works with `static` and `server` output.
+
+## Install
+
+```sh
+npm install @unirate/astro
+```
+
+You'll need a free UniRate API key — grab one at <https://unirateapi.com>.
+
+## Configure
+
+```js
+// astro.config.mjs
+import { defineConfig } from "astro/config";
+import unirate from "@unirate/astro";
+
+export default defineConfig({
+  integrations: [
+    unirate({
+      apiKey: process.env.UNIRATE_API_KEY,
+      baseCurrency: "USD",
+      currencies: ["EUR", "GBP", "JPY", "CAD", "AUD"],
+    }),
+  ],
+});
+```
+
+If `apiKey` is omitted the integration reads `UNIRATE_API_KEY` from the environment.
+
+### Options
+
+| Option | Type | Default | Description |
+|---|---|---|---|
+| `apiKey` | `string` | `process.env.UNIRATE_API_KEY` | UniRate API key. |
+| `baseCurrency` | `string` | `"USD"` | Base the build-time snapshot is keyed against. |
+| `currencies` | `string[]` | _all UniRate currencies_ | Optional allowlist to shrink the bundled snapshot. |
+| `apiBaseUrl` | `string` | `"https://api.unirateapi.com"` | API host. Override for self-hosted or testing. |
+| `failOnFetchError` | `boolean` | `true` | Fail the build if the snapshot fetch fails. Set to `false` to ship an empty snapshot and let components fall back gracefully. |
+
+## Use the components
+
+```astro
+---
+import Currency from "@unirate/astro/components/Currency.astro";
+import Rate from "@unirate/astro/components/Rate.astro";
+---
+<p>Subtotal: <Currency amount={100} from="USD" to="EUR" /></p>
+<p>Today's USD/EUR rate: <Rate from="USD" to="EUR" /></p>
+<p>Cross-pair (derived): <Rate from="EUR" to="GBP" precision={6} /></p>
+```
+
+`<Currency />` supports the same options as `Intl.NumberFormat`'s currency style:
+
+```astro
+<Currency amount={1234.5} from="USD" to="JPY" minimumFractionDigits={0} />
+<Currency amount={100} from="USD" to="EUR" currencyDisplay="code" />
+<Currency amount={100} from="USD" to="EUR" as="text" />
+```
+
+Pass `as="text"` to render the bare string with no wrapping `<span>` — useful inside `<title>` or table cells.
+
+## Use the helpers directly
+
+```astro
+---
+import { convertCurrency, getRate, formatCurrency, fetchedAt } from "@unirate/astro/runtime";
+
+const eur = convertCurrency(100, "USD", "EUR");
+const rate = getRate("USD", "EUR");
+---
+<p>{formatCurrency(eur, "EUR")}</p>
+<p>Rate: {rate.toFixed(4)}</p>
+<footer>Rates as of {fetchedAt}</footer>
+```
+
+The runtime entry also exports the raw `snapshot`, `base`, `rates`, and `fetchedAt` for advanced use cases (e.g. building your own table of all rates).
+
+## How the build works
+
+`astro:config:setup` fetches `/api/rates?from=<baseCurrency>[&to=...]` once, then registers a Vite plugin that resolves `virtual:unirate` to the snapshot as a frozen ES module. Components and helpers read from that virtual module, so by the time Astro renders pages every rate is already a constant in the bundle.
+
+`astro:config:done` calls `injectTypes` to write the `virtual:unirate` ambient declaration into your `.astro/integrations/@unirate/astro/` dir — your tsconfig picks it up automatically with no extra setup.
+
+Cross-pair rates are derived at render time: `rate(from → to) = rate(base → to) / rate(base → from)`. This means a snapshot keyed against USD can convert EUR → GBP without an extra fetch.
+
+## Static vs. server output
+
+- **Static (`output: "static"`, default).** Rates are baked into the rendered HTML. No client-side requests; no API key in the browser bundle.
+- **Server (`output: "server"`).** Rates are still fetched once at build/start and frozen for the life of the process. Restart the server to refresh.
+
+## License
+
+MIT

package/components/Currency.astro

@@ -0,0 +1,50 @@
+---
+import { convertCurrency, formatCurrency } from "@unirate/astro/runtime";
+import type { FormatOptions } from "@unirate/astro/runtime";
+
+export interface Props extends FormatOptions {
+  amount: number;
+  from: string;
+  to: string;
+  /**
+   * When true (default), wraps the output in `<span data-unirate>`. Set
+   * `as="text"` to render the bare string with no element — useful inside
+   * `<title>` or table cells where extra DOM is awkward.
+   */
+  as?: "span" | "text";
+  class?: string;
+}
+
+const {
+  amount,
+  from,
+  to,
+  as = "span",
+  class: className,
+  locale,
+  minimumFractionDigits,
+  maximumFractionDigits,
+  currencyDisplay,
+} = Astro.props;
+
+let rendered: string;
+try {
+  const converted = convertCurrency(amount, from, to);
+  rendered = formatCurrency(converted, to, {
+    locale,
+    minimumFractionDigits,
+    maximumFractionDigits,
+    currencyDisplay,
+  });
+} catch {
+  rendered = formatCurrency(amount, from, {
+    locale,
+    minimumFractionDigits,
+    maximumFractionDigits,
+    currencyDisplay,
+  });
+}
+---
+{as === "text" ? rendered : (
+  <span data-unirate="currency" data-from={from.toUpperCase()} data-to={to.toUpperCase()} class={className}>{rendered}</span>
+)}

package/components/Rate.astro

@@ -0,0 +1,24 @@
+---
+import { getRate } from "@unirate/astro/runtime";
+
+export interface Props {
+  from: string;
+  to: string;
+  /** Decimal places to render. Defaults to 4. */
+  precision?: number;
+  as?: "span" | "text";
+  class?: string;
+}
+
+const { from, to, precision = 4, as = "span", class: className } = Astro.props;
+
+let rendered: string;
+try {
+  rendered = getRate(from, to).toFixed(precision);
+} catch {
+  rendered = "—";
+}
+---
+{as === "text" ? rendered : (
+  <span data-unirate="rate" data-from={from.toUpperCase()} data-to={to.toUpperCase()} class={className}>{rendered}</span>
+)}

package/dist/client.d.ts

@@ -0,0 +1,24 @@
+export declare class UniRateError extends Error {
+    readonly status?: number;
+    readonly body?: unknown;
+    constructor(message: string, status?: number, body?: unknown);
+}
+export interface UniRateClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+}
+export interface RatesResponse {
+    rates: Record<string, number>;
+    base: string;
+    fetchedAt: string;
+}
+export declare class UniRateClient {
+    #private;
+    constructor(opts: UniRateClientOptions);
+    getRates(from: string, to?: string[]): Promise<RatesResponse>;
+    convert(amount: number, from: string, to: string): Promise<number>;
+    listCurrencies(): Promise<string[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAaA,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;CAM7D;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,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAWD,qBAAa,aAAa;;gBAMZ,IAAI,EAAE,oBAAoB;IA4ChC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAmB7D,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlE,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAO1C"}

package/dist/client.js

@@ -0,0 +1,114 @@
+// Tiny fetch wrapper around the UniRate REST API. Stays dependency-free so
+// the integration adds no runtime weight to Astro builds; native fetch is
+// available in Node 18+ (required by Astro 4) and at the edge.
+//
+// Only the free-tier endpoints used by the integration are exposed:
+//   GET /api/rates       — current rates for one base
+//   GET /api/convert     — single amount conversion
+//   GET /api/currencies  — supported ISO codes
+//
+// `Accept: application/json` is set on every request because
+// /api/currencies returns HTML 404 without it (see project CLAUDE.md
+// "Key gotchas" #2).
+export class UniRateError extends Error {
+    status;
+    body;
+    constructor(message, status, body) {
+        super(message);
+        this.name = "UniRateError";
+        this.status = status;
+        this.body = body;
+    }
+}
+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 rate value: ${String(v)}`);
+    return n;
+};
+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);
+        try {
+            const res = await this.#fetch(url.toString(), {
+                headers: { Accept: "application/json" },
+                signal: ctrl.signal,
+            });
+            const text = await res.text();
+            let body;
+            try {
+                body = text ? JSON.parse(text) : null;
+            }
+            catch {
+                throw new UniRateError(`Non-JSON response from ${path}`, res.status, text);
+            }
+            if (!res.ok) {
+                const msg = (body && typeof body === "object" && "error" in body && typeof body.error === "string"
+                    ? body.error
+                    : `HTTP ${res.status} from ${path}`);
+                throw new UniRateError(msg, res.status, body);
+            }
+            return body;
+        }
+        finally {
+            clearTimeout(timer);
+        }
+    }
+    async getRates(from, to) {
+        const params = { from };
+        if (to && to.length > 0)
+            params.to = to.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]] = toNum(raw.rate);
+        }
+        else {
+            throw new UniRateError("Malformed /api/rates response", undefined, raw);
+        }
+        rates[from] = 1;
+        return { rates, base: from, fetchedAt: new Date().toISOString() };
+    }
+    async convert(amount, from, to) {
+        const raw = await this.#get("/api/convert", { from, to, amount });
+        if (raw.result === undefined)
+            throw new UniRateError("Malformed /api/convert response", undefined, raw);
+        return toNum(raw.result);
+    }
+    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;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+import type { AstroIntegration } from "astro";
+import type { UniRateIntegrationOptions } from "./types.js";
+export type { UniRateIntegrationOptions, RateSnapshot } from "./types.js";
+/**
+ * Astro integration that fetches a UniRate snapshot at `astro:config:setup`
+ * and exposes it to the build via a `virtual:unirate` Vite module. Pair
+ * with the bundled `<Currency />` and `<Rate />` components, or import
+ * `getRate` / `convertCurrency` from `@unirate/astro/runtime`.
+ */
+export default function unirate(options?: UniRateIntegrationOptions): AstroIntegration;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAG9C,OAAO,KAAK,EAAgB,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE1E,YAAY,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAK1E;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,OAAO,GAAE,yBAA8B,GAAG,gBAAgB,CA2DzF"}

package/dist/index.js

@@ -0,0 +1,69 @@
+import { fetchSnapshot, EMPTY_SNAPSHOT } from "./snapshot.js";
+import { unirateVitePlugin } from "./vite-plugin.js";
+const DEFAULT_BASE = "USD";
+const DEFAULT_API = "https://api.unirateapi.com";
+/**
+ * Astro integration that fetches a UniRate snapshot at `astro:config:setup`
+ * and exposes it to the build via a `virtual:unirate` Vite module. Pair
+ * with the bundled `<Currency />` and `<Rate />` components, or import
+ * `getRate` / `convertCurrency` from `@unirate/astro/runtime`.
+ */
+export default function unirate(options = {}) {
+    const apiKey = options.apiKey ?? process.env.UNIRATE_API_KEY;
+    const baseCurrency = (options.baseCurrency ?? DEFAULT_BASE).toUpperCase();
+    const apiBaseUrl = options.apiBaseUrl ?? DEFAULT_API;
+    const failOnFetchError = options.failOnFetchError ?? true;
+    const currencies = options.currencies?.map((c) => c.toUpperCase());
+    const virtualTypes = [
+        'declare module "virtual:unirate" {',
+        "  interface RateSnapshot {",
+        "    base: string;",
+        "    rates: Record<string, number>;",
+        "    fetchedAt: string | null;",
+        "  }",
+        "  const snapshot: RateSnapshot;",
+        "  export default snapshot;",
+        "  export const base: string;",
+        "  export const rates: Record<string, number>;",
+        "  export const fetchedAt: string | null;",
+        "}",
+        "",
+    ].join("\n");
+    return {
+        name: "@unirate/astro",
+        hooks: {
+            "astro:config:done": ({ injectTypes }) => {
+                injectTypes({ filename: "types.d.ts", content: virtualTypes });
+            },
+            "astro:config:setup": async ({ updateConfig, logger }) => {
+                let snapshot;
+                if (!apiKey) {
+                    const msg = "No UniRate API key provided. Pass `apiKey` to the integration or set UNIRATE_API_KEY.";
+                    if (failOnFetchError)
+                        throw new Error(msg);
+                    logger.warn(msg + " Shipping empty rate snapshot.");
+                    snapshot = EMPTY_SNAPSHOT(baseCurrency);
+                }
+                else {
+                    try {
+                        snapshot = await fetchSnapshot({ apiKey, baseCurrency, apiBaseUrl, currencies });
+                        logger.info(`Fetched ${Object.keys(snapshot.rates).length} ${baseCurrency} rates from UniRate.`);
+                    }
+                    catch (err) {
+                        const msg = `UniRate snapshot fetch failed: ${err.message}`;
+                        if (failOnFetchError)
+                            throw new Error(msg);
+                        logger.warn(msg + " Shipping empty rate snapshot.");
+                        snapshot = EMPTY_SNAPSHOT(baseCurrency);
+                    }
+                }
+                updateConfig({
+                    vite: {
+                        plugins: [unirateVitePlugin(snapshot)],
+                    },
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAKrD,MAAM,YAAY,GAAG,KAAK,CAAC;AAC3B,MAAM,WAAW,GAAG,4BAA4B,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,CAAC,OAAO,UAAU,OAAO,CAAC,UAAqC,EAAE;IACrE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;IAC7D,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,YAAY,IAAI,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1E,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,WAAW,CAAC;IACrD,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,CAAC;IAC1D,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG;QACnB,oCAAoC;QACpC,4BAA4B;QAC5B,mBAAmB;QACnB,oCAAoC;QACpC,+BAA+B;QAC/B,KAAK;QACL,iCAAiC;QACjC,4BAA4B;QAC5B,8BAA8B;QAC9B,+CAA+C;QAC/C,0CAA0C;QAC1C,GAAG;QACH,EAAE;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEb,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,KAAK,EAAE;YACL,mBAAmB,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE;gBACvC,WAAW,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC,CAAC;YACjE,CAAC;YACD,oBAAoB,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;gBACvD,IAAI,QAAsB,CAAC;gBAC3B,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,MAAM,GAAG,GACP,uFAAuF,CAAC;oBAC1F,IAAI,gBAAgB;wBAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;oBAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,gCAAgC,CAAC,CAAC;oBACpD,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;gBAC1C,CAAC;qBAAM,CAAC;oBACN,IAAI,CAAC;wBACH,QAAQ,GAAG,MAAM,aAAa,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC;wBACjF,MAAM,CAAC,IAAI,CACT,WAAW,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,YAAY,sBAAsB,CACpF,CAAC;oBACJ,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,MAAM,GAAG,GAAG,kCAAmC,GAAa,CAAC,OAAO,EAAE,CAAC;wBACvE,IAAI,gBAAgB;4BAAE,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC;wBAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,gCAAgC,CAAC,CAAC;wBACpD,QAAQ,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;oBAC1C,CAAC;gBACH,CAAC;gBAED,YAAY,CAAC;oBACX,IAAI,EAAE;wBACJ,OAAO,EAAE,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;qBACvC;iBACF,CAAC,CAAC;YACL,CAAC;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,35 @@
+import type { RateSnapshot } from "../types.js";
+import snapshot from "virtual:unirate";
+export { snapshot };
+export declare const base: string;
+export declare const rates: Record<string, number>;
+export declare const fetchedAt: string | null;
+export declare class UnknownCurrencyError extends Error {
+    readonly currency: string;
+    constructor(currency: string);
+}
+/**
+ * Derive a `from → to` rate from a snapshot keyed against a single base.
+ * The math: rate(from→to) = rate(base→to) / rate(base→from).
+ * Throws if either code isn't present in the snapshot.
+ */
+export declare function getRate(from: string, to: string, snap?: RateSnapshot): number;
+export declare function convertCurrency(amount: number, from: string, to: string, snap?: RateSnapshot): number;
+export interface FormatOptions {
+    /**
+     * BCP-47 locale for `Intl.NumberFormat`. Defaults to "en-US".
+     * Pass `null` to skip Intl and emit a plain `<amount> <code>` string.
+     */
+    locale?: string | null;
+    /** Minimum decimal places. Defaults to 2. */
+    minimumFractionDigits?: number;
+    /** Maximum decimal places. Defaults to `minimumFractionDigits`. */
+    maximumFractionDigits?: number;
+    /**
+     * Intl currency display style. Defaults to "symbol".
+     * Set to "code" to render e.g. `EUR 92.50`.
+     */
+    currencyDisplay?: "symbol" | "narrowSymbol" | "code" | "name";
+}
+export declare function formatCurrency(amount: number, currency: string, opts?: FormatOptions): string;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,eAAO,MAAM,IAAI,EAAE,MAAsB,CAAC;AAC1C,eAAO,MAAM,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAkB,CAAC;AAC5D,eAAO,MAAM,SAAS,EAAE,MAAM,GAAG,IAAyB,CAAC;AAE3D,qBAAa,oBAAqB,SAAQ,KAAK;IAC7C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,QAAQ,EAAE,MAAM;CAK7B;AAED;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,YAAuB,GAAG,MAAM,CASvF;AAED,wBAAgB,eAAe,CAC7B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,IAAI,GAAE,YAAuB,GAC5B,MAAM,CAER;AAED,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEvB,6CAA6C;IAC7C,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B,mEAAmE;IACnE,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;OAGG;IACH,eAAe,CAAC,EAAE,QAAQ,GAAG,cAAc,GAAG,MAAM,GAAG,MAAM,CAAC;CAC/D;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,aAAkB,GAAG,MAAM,CAqBjG"}

package/dist/runtime/index.js

@@ -0,0 +1,58 @@
+import snapshot from "virtual:unirate";
+export { snapshot };
+export const base = snapshot.base;
+export const rates = snapshot.rates;
+export const fetchedAt = snapshot.fetchedAt;
+export class UnknownCurrencyError extends Error {
+    currency;
+    constructor(currency) {
+        super(`Unknown currency in snapshot: ${currency}`);
+        this.name = "UnknownCurrencyError";
+        this.currency = currency;
+    }
+}
+/**
+ * Derive a `from → to` rate from a snapshot keyed against a single base.
+ * The math: rate(from→to) = rate(base→to) / rate(base→from).
+ * Throws if either code isn't present in the snapshot.
+ */
+export function getRate(from, to, snap = snapshot) {
+    const f = from.toUpperCase();
+    const t = to.toUpperCase();
+    if (f === t)
+        return 1;
+    const rf = snap.rates[f];
+    const rt = snap.rates[t];
+    if (rf === undefined)
+        throw new UnknownCurrencyError(f);
+    if (rt === undefined)
+        throw new UnknownCurrencyError(t);
+    return rt / rf;
+}
+export function convertCurrency(amount, from, to, snap = snapshot) {
+    return amount * getRate(from, to, snap);
+}
+export function formatCurrency(amount, currency, opts = {}) {
+    const code = currency.toUpperCase();
+    const min = opts.minimumFractionDigits ?? 2;
+    const max = opts.maximumFractionDigits ?? min;
+    if (opts.locale === null) {
+        return `${amount.toFixed(max)} ${code}`;
+    }
+    try {
+        return new Intl.NumberFormat(opts.locale ?? "en-US", {
+            style: "currency",
+            currency: code,
+            currencyDisplay: opts.currencyDisplay ?? "symbol",
+            minimumFractionDigits: min,
+            maximumFractionDigits: max,
+        }).format(amount);
+    }
+    catch {
+        // Intl throws on malformed args (bad locale tag, etc.) — unknown ISO
+        // codes do NOT throw; Intl prefixes them as literal codes. Fall back
+        // to `<amount> <code>` so the build never breaks.
+        return `${amount.toFixed(max)} ${code}`;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,QAAQ,MAAM,iBAAiB,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,CAAC;AACpB,MAAM,CAAC,MAAM,IAAI,GAAW,QAAQ,CAAC,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,KAAK,GAA2B,QAAQ,CAAC,KAAK,CAAC;AAC5D,MAAM,CAAC,MAAM,SAAS,GAAkB,QAAQ,CAAC,SAAS,CAAC;AAE3D,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IACpC,QAAQ,CAAS;IAC1B,YAAY,QAAgB;QAC1B,KAAK,CAAC,iCAAiC,QAAQ,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;QACnC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,EAAU,EAAE,OAAqB,QAAQ;IAC7E,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAC7B,MAAM,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;IAC3B,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACtB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxD,IAAI,EAAE,KAAK,SAAS;QAAE,MAAM,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACxD,OAAO,EAAE,GAAG,EAAE,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,IAAY,EACZ,EAAU,EACV,OAAqB,QAAQ;IAE7B,OAAO,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC;AAsBD,MAAM,UAAU,cAAc,CAAC,MAAc,EAAE,QAAgB,EAAE,OAAsB,EAAE;IACvF,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,IAAI,CAAC,CAAC;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,qBAAqB,IAAI,GAAG,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC1C,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,EAAE;YACnD,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,IAAI;YACd,eAAe,EAAE,IAAI,CAAC,eAAe,IAAI,QAAQ;YACjD,qBAAqB,EAAE,GAAG;YAC1B,qBAAqB,EAAE,GAAG;SAC3B,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,qEAAqE;QACrE,qEAAqE;QACrE,kDAAkD;QAClD,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/snapshot.d.ts

@@ -0,0 +1,5 @@
+import type { RateSnapshot, UniRateIntegrationOptions } from "./types.js";
+declare const EMPTY_SNAPSHOT: (base: string) => RateSnapshot;
+export declare function fetchSnapshot(opts: Required<Pick<UniRateIntegrationOptions, "apiKey" | "baseCurrency" | "apiBaseUrl">> & Pick<UniRateIntegrationOptions, "currencies">, fetchImpl?: typeof fetch): Promise<RateSnapshot>;
+export { EMPTY_SNAPSHOT };
+//# sourceMappingURL=snapshot.d.ts.map

package/dist/snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAE1E,QAAA,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,YAIrC,CAAC;AAEH,wBAAsB,aAAa,CACjC,IAAI,EAAE,QAAQ,CAAC,IAAI,CAAC,yBAAyB,EAAE,QAAQ,GAAG,cAAc,GAAG,YAAY,CAAC,CAAC,GACvF,IAAI,CAAC,yBAAyB,EAAE,YAAY,CAAC,EAC/C,SAAS,GAAE,OAAO,KAAwB,GACzC,OAAO,CAAC,YAAY,CAAC,CAQvB;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/snapshot.js

@@ -0,0 +1,17 @@
+import { UniRateClient } from "./client.js";
+const EMPTY_SNAPSHOT = (base) => ({
+    base,
+    rates: { [base]: 1 },
+    fetchedAt: null,
+});
+export async function fetchSnapshot(opts, fetchImpl = globalThis.fetch) {
+    const client = new UniRateClient({
+        apiKey: opts.apiKey,
+        baseUrl: opts.apiBaseUrl,
+        fetch: fetchImpl,
+    });
+    const { rates, fetchedAt } = await client.getRates(opts.baseCurrency, opts.currencies);
+    return { base: opts.baseCurrency, rates, fetchedAt };
+}
+export { EMPTY_SNAPSHOT };
+//# sourceMappingURL=snapshot.js.map

package/dist/snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.js","sourceRoot":"","sources":["../src/snapshot.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,MAAM,cAAc,GAAG,CAAC,IAAY,EAAgB,EAAE,CAAC,CAAC;IACtD,IAAI;IACJ,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE;IACpB,SAAS,EAAE,IAAI;CAChB,CAAC,CAAC;AAEH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,IAC+C,EAC/C,YAA0B,UAAU,CAAC,KAAK;IAE1C,MAAM,MAAM,GAAG,IAAI,aAAa,CAAC;QAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,OAAO,EAAE,IAAI,CAAC,UAAU;QACxB,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;IACH,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACvF,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;AACvD,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,41 @@
+export interface UniRateIntegrationOptions {
+    /** UniRate API key. Required. Read from `UNIRATE_API_KEY` env var if omitted. */
+    apiKey?: string;
+    /**
+     * Base currency the rate snapshot is keyed against. All build-time rates
+     * are stored as `base → other`. Cross-pair conversions are derived at
+     * runtime, so picking a single base keeps the snapshot small.
+     */
+    baseCurrency?: string;
+    /**
+     * Quote currencies to pre-fetch at build time. If omitted, all currencies
+     * UniRate supports are fetched (one /api/rates call, no `to` param).
+     * Pass an explicit list to shrink the bundled snapshot for static sites
+     * that only care about a handful of pairs.
+     */
+    currencies?: string[];
+    /**
+     * Override the API host. Useful for the test mock and self-hosted setups.
+     * Defaults to `https://api.unirateapi.com`.
+     */
+    apiBaseUrl?: string;
+    /**
+     * If `true`, build errors when the snapshot fetch fails (default).
+     * If `false`, the integration logs a warning and ships an empty snapshot
+     * — components fall back to displaying the source amount unchanged so
+     * the site still builds.
+     */
+    failOnFetchError?: boolean;
+    /**
+     * If set, also include the snapshot's fetch timestamp in the virtual
+     * module so consumers can render a "rates as of …" footer.
+     * Defaults to `true`.
+     */
+    includeFetchedAt?: boolean;
+}
+export interface RateSnapshot {
+    base: string;
+    rates: Record<string, number>;
+    fetchedAt: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,yBAAyB;IACxC,iFAAiF;IACjF,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAEtB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAE3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;CAC1B"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/vite-plugin.d.ts

@@ -0,0 +1,19 @@
+import type { RateSnapshot } from "./types.js";
+declare const VIRTUAL_ID = "virtual:unirate";
+declare const RESOLVED_ID: string;
+export interface VitePluginShape {
+    name: string;
+    resolveId(id: string): string | null;
+    load(id: string): string | null;
+}
+/**
+ * Vite plugin that exposes the build-time UniRate snapshot as
+ * `import { snapshot, base, rates, fetchedAt } from "virtual:unirate"`.
+ *
+ * Returned as a plain object rather than imported from `vite` so unit tests
+ * can drive it without spinning a full Vite server. Astro accepts any value
+ * matching Vite's Plugin shape via `updateConfig({ vite: { plugins: [...] } })`.
+ */
+export declare function unirateVitePlugin(snapshot: RateSnapshot): VitePluginShape;
+export { VIRTUAL_ID, RESOLVED_ID };
+//# sourceMappingURL=vite-plugin.d.ts.map

package/dist/vite-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.d.ts","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,QAAA,MAAM,UAAU,oBAAoB,CAAC;AACrC,QAAA,MAAM,WAAW,QAAoB,CAAC;AAEtC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IACrC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CACjC;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,eAAe,CAmBzE;AAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/dist/vite-plugin.js

@@ -0,0 +1,33 @@
+const VIRTUAL_ID = "virtual:unirate";
+const RESOLVED_ID = "\0" + VIRTUAL_ID;
+/**
+ * Vite plugin that exposes the build-time UniRate snapshot as
+ * `import { snapshot, base, rates, fetchedAt } from "virtual:unirate"`.
+ *
+ * Returned as a plain object rather than imported from `vite` so unit tests
+ * can drive it without spinning a full Vite server. Astro accepts any value
+ * matching Vite's Plugin shape via `updateConfig({ vite: { plugins: [...] } })`.
+ */
+export function unirateVitePlugin(snapshot) {
+    const payload = JSON.stringify(snapshot);
+    return {
+        name: "unirate:virtual-snapshot",
+        resolveId(id) {
+            return id === VIRTUAL_ID ? RESOLVED_ID : null;
+        },
+        load(id) {
+            if (id !== RESOLVED_ID)
+                return null;
+            return [
+                `const snapshot = Object.freeze(${payload});`,
+                `export default snapshot;`,
+                `export const snapshot_ = snapshot;`,
+                `export const base = snapshot.base;`,
+                `export const rates = snapshot.rates;`,
+                `export const fetchedAt = snapshot.fetchedAt;`,
+            ].join("\n");
+        },
+    };
+}
+export { VIRTUAL_ID, RESOLVED_ID };
+//# sourceMappingURL=vite-plugin.js.map

package/dist/vite-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin.js","sourceRoot":"","sources":["../src/vite-plugin.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,iBAAiB,CAAC;AACrC,MAAM,WAAW,GAAG,IAAI,GAAG,UAAU,CAAC;AAQtC;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,QAAsB;IACtD,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IACzC,OAAO;QACL,IAAI,EAAE,0BAA0B;QAChC,SAAS,CAAC,EAAU;YAClB,OAAO,EAAE,KAAK,UAAU,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,EAAU;YACb,IAAI,EAAE,KAAK,WAAW;gBAAE,OAAO,IAAI,CAAC;YACpC,OAAO;gBACL,kCAAkC,OAAO,IAAI;gBAC7C,0BAA0B;gBAC1B,oCAAoC;gBACpC,oCAAoC;gBACpC,sCAAsC;gBACtC,8CAA8C;aAC/C,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@unirate/astro",
+  "version": "0.1.2",
+  "description": "Astro integration for UniRate — build-time currency exchange rate snapshots, <Currency /> and <Rate /> components, and runtime conversion helpers.",
+  "type": "module",
+  "license": "MIT",
+  "author": "UniRate (https://unirateapi.com)",
+  "homepage": "https://github.com/UniRate-API/astro-unirate#readme",
+  "bugs": "https://github.com/UniRate-API/astro-unirate/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/UniRate-API/astro-unirate.git"
+  },
+  "keywords": [
+    "astro",
+    "astro-integration",
+    "astro-component",
+    "withastro",
+    "unirate",
+    "currency",
+    "exchange-rates",
+    "forex",
+    "money",
+    "fx"
+  ],
+  "files": [
+    "dist",
+    "components",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./runtime": {
+      "types": "./dist/runtime/index.d.ts",
+      "import": "./dist/runtime/index.js"
+    },
+    "./components/Currency.astro": "./components/Currency.astro",
+    "./components/Rate.astro": "./components/Rate.astro",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node ./scripts/copy-components.mjs",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "astro": ">=4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "astro": "^5.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}