trpc-unirate 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 UniRate API
+
+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,126 @@
+# trpc-unirate
+
+[![npm](https://img.shields.io/npm/v/trpc-unirate.svg)](https://www.npmjs.com/package/trpc-unirate)
+[![ci](https://github.com/UniRate-API/trpc-unirate/actions/workflows/ci.yml/badge.svg)](https://github.com/UniRate-API/trpc-unirate/actions/workflows/ci.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+Drop-in [tRPC](https://trpc.io) v11 router for the [UniRate](https://unirateapi.com) currency-exchange API. One import, one factory call, seven Zod-validated procedures — `convert`, `rate`, `rates`, `historical`, `timeSeries`, `currencies`, `vat`.
+
+UniRate offers **free real-time exchange rates** for 170+ currencies plus VAT data; historical rates and time-series are Pro-tier endpoints.
+
+## Install
+
+```bash
+npm install trpc-unirate @trpc/server zod
+```
+
+`@trpc/server` and `zod` are peer dependencies — bring your existing versions. Native `fetch` is required (Node ≥ 18.17).
+
+## Quick start
+
+```ts
+import { initTRPC } from "@trpc/server";
+import { createUniRateRouter } from "trpc-unirate";
+
+const t = initTRPC.create();
+
+export const appRouter = t.router({
+  unirate: createUniRateRouter({ apiKey: process.env.UNIRATE_API_KEY! }),
+});
+
+export type AppRouter = typeof appRouter;
+```
+
+On the client:
+
+```ts
+const eur = await trpc.unirate.convert.query({ from: "USD", to: "EUR", amount: 100 });
+//    ^? number
+
+const rates = await trpc.unirate.rates.query({ base: "USD" });
+//    ^? Record<string, number>
+```
+
+## Procedures
+
+All procedures are queries (`useQuery` on the React client).
+
+| Procedure    | Input (Zod-validated)                                                                | Output                                       |
+|--------------|--------------------------------------------------------------------------------------|----------------------------------------------|
+| `convert`    | `{ from, to, amount? = 1 }`                                                          | `number`                                     |
+| `rate`       | `{ from? = "USD", to? }`                                                             | `number` (when `to` set) \| `Record<string, number>` |
+| `rates`      | `{ base? = "USD" }`                                                                  | `Record<string, number>`                     |
+| `historical` | `{ date: "YYYY-MM-DD", from? = "USD", to?, amount? = 1 }` (Pro)                      | `number` \| `Record<string, number>`         |
+| `timeSeries` | `{ startDate, endDate, base? = "USD", amount? = 1, currencies?: string[] }` (Pro)    | `Record<date, Record<currency, number>>`     |
+| `currencies` | _none_                                                                                | `string[]` (e.g. `["USD","EUR",...]`)        |
+| `vat`        | `{ country? }`                                                                       | `{ total_countries, ... }` or `{ country, vat_data }` |
+
+Currency codes are normalized to uppercase before being sent to the API; Zod enforces 3-letter codes (2-letter for `country`).
+
+## Error mapping
+
+UniRate API errors are mapped to standard `TRPCError` codes, so your client-side `onError` handlers see familiar shapes:
+
+| HTTP | UniRate error class    | `TRPCError.code`         |
+|------|------------------------|--------------------------|
+| 400  | `InvalidRequestError`  | `BAD_REQUEST`            |
+| 401  | `AuthenticationError`  | `UNAUTHORIZED`           |
+| 403  | `ProRequiredError`     | `FORBIDDEN`              |
+| 404  | `InvalidCurrencyError` | `NOT_FOUND`              |
+| 429  | `RateLimitError`       | `TOO_MANY_REQUESTS`      |
+| other / network | `UniRateError` | `INTERNAL_SERVER_ERROR`  |
+
+The underlying error is preserved on `cause`.
+
+## Options
+
+```ts
+createUniRateRouter({
+  apiKey: process.env.UNIRATE_API_KEY!,
+  // Optional:
+  baseUrl: "https://api.unirateapi.com",  // override for self-hosting / tests
+  timeoutMs: 30_000,                       // per-request timeout
+  fetch: globalThis.fetch,                 // inject a custom fetch (proxies, MSW, etc.)
+  userAgent: "myapp/1.0",                  // overrides "unirate-trpc/x.y.z"
+});
+```
+
+For tests, you can pass a pre-built client instead of an API key:
+
+```ts
+import { UniRateClient, createUniRateRouter } from "trpc-unirate";
+
+const client = new UniRateClient({ apiKey: "test", fetch: mockFetch });
+const router = createUniRateRouter({ client });
+const caller = router.createCaller({});
+
+expect(await caller.convert({ from: "USD", to: "EUR", amount: 100 })).toBe(92.5);
+```
+
+## Why a separate router?
+
+`createUniRateRouter()` returns a fully-built tRPC v11 router. Nest it under any key in your own router via the object form (`t.router({ unirate: ... })`). The router uses its own `initTRPC.create()` internally, which means:
+
+- ✅ No coupling to your context, transformer, or middleware.
+- ✅ Zero changes to your existing tRPC setup.
+- ✅ Procedures still appear in your generated client types.
+
+If you need shared context (auth, request-scoped caching, etc.) on the UniRate procedures, build them directly with your own `t.procedure` using the exported `UniRateClient` — the schemas live in `uniRateInputSchemas` for re-use.
+
+## Standalone server example
+
+A minimal runnable example lives in [`examples/server.ts`](examples/server.ts). Start it with:
+
+```bash
+UNIRATE_API_KEY=your-key npx tsx examples/server.ts
+```
+
+## Related
+
+- [`unirate-api`](https://www.npmjs.com/package/unirate-api) — the official Node.js client (used internally as reference; this package re-implements the HTTP surface with zero runtime deps).
+- [`@unirate/mcp`](https://www.npmjs.com/package/@unirate/mcp) — Model Context Protocol server for UniRate (use UniRate from Claude Desktop, Cline, etc.).
+- [`@unirate/astro`](https://www.npmjs.com/package/@unirate/astro), [`@unirate/eleventy`](https://www.npmjs.com/package/@unirate/eleventy) — build-time SSG integrations.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,63 @@
+export declare class UniRateError extends Error {
+    readonly status?: number;
+    readonly body?: unknown;
+    constructor(message: string, status?: number, body?: unknown);
+}
+export declare class AuthenticationError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+export declare class RateLimitError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+export declare class InvalidCurrencyError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+export declare class InvalidRequestError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+export declare class ProRequiredError extends UniRateError {
+    constructor(message?: string, body?: unknown);
+}
+export interface UniRateClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+    fetch?: typeof fetch;
+    timeoutMs?: number;
+    userAgent?: string;
+}
+export interface VATEntry {
+    country_code: string;
+    country_name: string;
+    vat_rate: number;
+}
+export interface VATRatesAll {
+    total_countries: number;
+    date: string;
+    vat_rates: Record<string, VATEntry>;
+}
+export interface VATRateOne {
+    country: string;
+    vat_data: VATEntry;
+}
+export interface HistoricalLimitsResponse {
+    total_currencies: number;
+    data_source: string;
+    currencies: Record<string, {
+        earliest_date: string;
+        latest_date: string;
+        total_days: number;
+        description: string;
+    }>;
+}
+export declare class UniRateClient {
+    #private;
+    constructor(opts: UniRateClientOptions);
+    getRate(from: string, to?: string): Promise<number | Record<string, number>>;
+    convert(to: string, amount: number, from: string): Promise<number>;
+    listCurrencies(): Promise<string[]>;
+    getHistoricalRate(date: string, amount: number, from: string, to?: string): Promise<number | Record<string, number>>;
+    getTimeSeries(startDate: string, endDate: string, amount: number, base: string, currencies?: string[]): Promise<Record<string, Record<string, number>>>;
+    getHistoricalLimits(): Promise<HistoricalLimitsResponse>;
+    getVATRates(country?: string): Promise<VATRatesAll | VATRateOne>;
+}
+//# 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":"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"}

package/dist/client.js

@@ -0,0 +1,226 @@
+// Tiny zero-dependency fetch wrapper around the UniRate REST API.
+//
+// Stays dependency-free so the package adds no runtime weight beyond
+// its peer dependencies (@trpc/server, zod). Native fetch is required
+// (Node 18.17+, the package's declared engines floor).
+//
+// `Accept: application/json` is set on every request because UniRate's
+// /api/currencies endpoint returns an HTML 404 without it — see the
+// workspace 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;
+    }
+}
+export class AuthenticationError extends UniRateError {
+    constructor(message = "Missing or invalid API key", body) {
+        super(message, 401, body);
+        this.name = "AuthenticationError";
+    }
+}
+export class RateLimitError extends UniRateError {
+    constructor(message = "Rate limit exceeded", body) {
+        super(message, 429, body);
+        this.name = "RateLimitError";
+    }
+}
+export class InvalidCurrencyError extends UniRateError {
+    constructor(message = "Currency not found or no data available", body) {
+        super(message, 404, body);
+        this.name = "InvalidCurrencyError";
+    }
+}
+export class InvalidRequestError extends UniRateError {
+    constructor(message = "Invalid request parameters", body) {
+        super(message, 400, body);
+        this.name = "InvalidRequestError";
+    }
+}
+export class ProRequiredError extends UniRateError {
+    constructor(message = "Endpoint requires a Pro subscription", body) {
+        super(message, 403, body);
+        this.name = "ProRequiredError";
+    }
+}
+const DEFAULT_BASE_URL = "https://api.unirateapi.com";
+const DEFAULT_TIMEOUT_MS = 30_000;
+const DEFAULT_USER_AGENT = "unirate-trpc/0.1.0";
+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;
+};
+const toRates = (raw) => {
+    const out = {};
+    for (const [k, v] of Object.entries(raw))
+        out[k] = toNum(v);
+    return out;
+};
+export class UniRateClient {
+    #apiKey;
+    #baseUrl;
+    #fetch;
+    #timeoutMs;
+    #userAgent;
+    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;
+        this.#userAgent = opts.userAgent ?? DEFAULT_USER_AGENT;
+        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",
+                    "User-Agent": this.#userAgent,
+                },
+                signal: ctrl.signal,
+            });
+        }
+        catch (err) {
+            clearTimeout(timer);
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new UniRateError(`Request to ${path} failed: ${msg}`);
+        }
+        clearTimeout(timer);
+        const text = await res.text();
+        let body = null;
+        if (text) {
+            try {
+                body = JSON.parse(text);
+            }
+            catch {
+                if (!res.ok) {
+                    throw new UniRateError(`HTTP ${res.status} from ${path}`, res.status, text);
+                }
+                throw new UniRateError(`Non-JSON response from ${path}`, res.status, text);
+            }
+        }
+        if (!res.ok) {
+            const detail = body && typeof body === "object" && "error" in body && typeof body.error === "string"
+                ? body.error
+                : undefined;
+            switch (res.status) {
+                case 400:
+                    throw new InvalidRequestError(detail ?? "Invalid request parameters", body);
+                case 401:
+                    throw new AuthenticationError(detail ?? "Missing or invalid API key", body);
+                case 403:
+                    throw new ProRequiredError(detail ?? "Endpoint requires a Pro subscription", body);
+                case 404:
+                    throw new InvalidCurrencyError(detail ?? "Currency not found or no data available", body);
+                case 429:
+                    throw new RateLimitError(detail ?? "Rate limit exceeded", body);
+                default:
+                    throw new UniRateError(detail ?? `HTTP ${res.status} from ${path}`, res.status, body);
+            }
+        }
+        return body;
+    }
+    async getRate(from, to) {
+        const params = { from: from.toUpperCase() };
+        if (to)
+            params.to = to.toUpperCase();
+        const raw = await this.#get("/api/rates", params);
+        if (to) {
+            if (raw.rate === undefined)
+                throw new UniRateError("Malformed /api/rates response", undefined, raw);
+            return toNum(raw.rate);
+        }
+        if (!raw.rates)
+            throw new UniRateError("Malformed /api/rates response", undefined, raw);
+        return toRates(raw.rates);
+    }
+    async convert(to, amount, from) {
+        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);
+    }
+    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;
+    }
+    async getHistoricalRate(date, amount, from, to) {
+        const params = {
+            date,
+            amount,
+            from: from.toUpperCase(),
+        };
+        if (to)
+            params.to = to.toUpperCase();
+        const raw = await this.#get("/api/historical/rates", params);
+        if (to) {
+            const v = amount === 1 ? raw.rate : raw.result;
+            if (v === undefined) {
+                throw new UniRateError("Malformed /api/historical/rates response", undefined, raw);
+            }
+            return toNum(v);
+        }
+        const map = amount === 1 ? raw.rates : raw.results;
+        if (!map) {
+            throw new UniRateError("Malformed /api/historical/rates response", undefined, raw);
+        }
+        return toRates(map);
+    }
+    async getTimeSeries(startDate, endDate, amount, base, currencies) {
+        const params = {
+            start_date: startDate,
+            end_date: endDate,
+            amount,
+            base: base.toUpperCase(),
+        };
+        if (currencies && currencies.length > 0) {
+            params.currencies = currencies.map((c) => c.toUpperCase()).join(",");
+        }
+        const raw = await this.#get("/api/historical/timeseries", params);
+        if (!raw.data) {
+            throw new UniRateError("Malformed /api/historical/timeseries response", undefined, raw);
+        }
+        const out = {};
+        for (const [day, rates] of Object.entries(raw.data))
+            out[day] = toRates(rates);
+        return out;
+    }
+    async getHistoricalLimits() {
+        return this.#get("/api/historical/limits", {});
+    }
+    async getVATRates(country) {
+        const params = {};
+        if (country)
+            params.country = country.toUpperCase();
+        return this.#get("/api/vat/rates", params);
+    }
+}
+//# 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,3 @@
+export { createUniRateRouter, uniRateInputSchemas, type CreateUniRateRouterOptions, type UniRateRouter, } from "./router.js";
+export { UniRateClient, UniRateError, AuthenticationError, InvalidCurrencyError, InvalidRequestError, ProRequiredError, RateLimitError, type UniRateClientOptions, type VATEntry, type VATRatesAll, type VATRateOne, type HistoricalLimitsResponse, } from "./client.js";
+//# 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,EACL,mBAAmB,EACnB,mBAAmB,EACnB,KAAK,0BAA0B,EAC/B,KAAK,aAAa,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,QAAQ,EACb,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,wBAAwB,GAC9B,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { createUniRateRouter, uniRateInputSchemas, } from "./router.js";
+export { UniRateClient, UniRateError, AuthenticationError, InvalidCurrencyError, InvalidRequestError, ProRequiredError, RateLimitError, } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,mBAAmB,GAGpB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,aAAa,EACb,YAAY,EACZ,mBAAmB,EACnB,oBAAoB,EACpB,mBAAmB,EACnB,gBAAgB,EAChB,cAAc,GAMf,MAAM,aAAa,CAAC"}

package/dist/router.d.ts

@@ -0,0 +1,119 @@
+import { z } from "zod";
+import { UniRateClient, type UniRateClientOptions } from "./client.js";
+export interface CreateUniRateRouterOptions extends Partial<UniRateClientOptions> {
+    /** Required unless `client` is supplied. */
+    apiKey?: string;
+    /** Inject a pre-built client (for tests, or to share with the rest of your app). */
+    client?: UniRateClient;
+}
+export declare const uniRateInputSchemas: {
+    convert: z.ZodObject<{
+        from: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        to: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        amount: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    rate: z.ZodObject<{
+        from: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        to: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strip>;
+    rates: z.ZodObject<{
+        base: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strip>;
+    historical: z.ZodObject<{
+        date: z.ZodString;
+        from: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        to: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        amount: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>;
+    timeSeries: z.ZodObject<{
+        startDate: z.ZodString;
+        endDate: z.ZodString;
+        base: z.ZodDefault<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+        amount: z.ZodDefault<z.ZodNumber>;
+        currencies: z.ZodOptional<z.ZodArray<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>>;
+    }, z.core.$strip>;
+    vat: z.ZodObject<{
+        country: z.ZodOptional<z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>>;
+    }, z.core.$strip>;
+};
+/**
+ * Build a tRPC v11 router exposing the UniRate API.
+ *
+ * Creates its own `initTRPC.create()` instance and returns a fully-built
+ * router with seven query procedures: `convert`, `rate`, `rates`,
+ * `historical`, `timeSeries`, `currencies`, `vat`. Nest the result under
+ * any key in your own router via the object form:
+ *
+ *   t.router({ unirate: createUniRateRouter({ apiKey }) })
+ *
+ * Errors from the UniRate API are mapped to typed `TRPCError` codes
+ * (`UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `BAD_REQUEST`,
+ * `TOO_MANY_REQUESTS`, `INTERNAL_SERVER_ERROR`) so client-side
+ * `useQuery({ onError })` handlers see standard tRPC error shapes.
+ */
+export declare const createUniRateRouter: (opts: CreateUniRateRouterOptions) => import("@trpc/server").TRPCBuiltRouter<{
+    ctx: object;
+    meta: object;
+    errorShape: import("@trpc/server").TRPCDefaultErrorShape;
+    transformer: false;
+}, import("@trpc/server").TRPCDecorateCreateRouterOptions<{
+    convert: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            from: string;
+            to: string;
+            amount?: number | undefined;
+        };
+        output: number;
+        meta: object;
+    }>;
+    rate: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            from?: string | undefined;
+            to?: string | undefined;
+        };
+        output: number | Record<string, number>;
+        meta: object;
+    }>;
+    rates: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            base?: string | undefined;
+        };
+        output: Record<string, number>;
+        meta: object;
+    }>;
+    historical: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            date: string;
+            from?: string | undefined;
+            to?: string | undefined;
+            amount?: number | undefined;
+        };
+        output: number | Record<string, number>;
+        meta: object;
+    }>;
+    timeSeries: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            startDate: string;
+            endDate: string;
+            base?: string | undefined;
+            amount?: number | undefined;
+            currencies?: string[] | undefined;
+        };
+        output: Record<string, Record<string, number>>;
+        meta: object;
+    }>;
+    currencies: import("@trpc/server").TRPCQueryProcedure<{
+        input: void;
+        output: string[];
+        meta: object;
+    }>;
+    vat: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            country?: string | undefined;
+        };
+        output: import("./client.js").VATRatesAll | import("./client.js").VATRateOne;
+        meta: object;
+    }>;
+}>>;
+export type UniRateRouter = ReturnType<typeof createUniRateRouter>;
+//# sourceMappingURL=router.d.ts.map

package/dist/router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"router.d.ts","sourceRoot":"","sources":["../src/router.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,aAAa,EAEb,KAAK,oBAAoB,EAC1B,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,0BAA2B,SAAQ,OAAO,CAAC,oBAAoB,CAAC;IAC/E,4CAA4C;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,oFAAoF;IACpF,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAqDD,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAAS,CAAC;AAyC1C;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCnE,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/router.js

@@ -0,0 +1,135 @@
+// Drop-in tRPC router factory that wraps the UniRate REST API.
+//
+// Usage in a consumer app:
+//
+//   import { initTRPC } from "@trpc/server";
+//   import { createUniRateRouter } from "@unirate/trpc";
+//
+//   const t = initTRPC.create();
+//   export const appRouter = t.router({
+//     unirate: createUniRateRouter({ apiKey: process.env.UNIRATE_API_KEY! }),
+//   });
+//
+// The returned object is a fully-built tRPC v11 router. It can be nested
+// under any key in your own router via the object form above.
+import { TRPCError, initTRPC } from "@trpc/server";
+import { z } from "zod";
+import { AuthenticationError, InvalidCurrencyError, InvalidRequestError, ProRequiredError, RateLimitError, UniRateClient, UniRateError, } from "./client.js";
+const currency = z
+    .string()
+    .trim()
+    .length(3, "currency code must be 3 letters")
+    .transform((s) => s.toUpperCase());
+const isoDate = z
+    .string()
+    .regex(/^\d{4}-\d{2}-\d{2}$/, "expected YYYY-MM-DD");
+const positiveAmount = z
+    .number()
+    .finite("amount must be finite")
+    .positive("amount must be positive");
+const inputs = {
+    convert: z.object({
+        from: currency,
+        to: currency,
+        amount: positiveAmount.default(1),
+    }),
+    rate: z.object({
+        from: currency.default("USD"),
+        to: currency.optional(),
+    }),
+    rates: z.object({
+        base: currency.default("USD"),
+    }),
+    historical: z.object({
+        date: isoDate,
+        from: currency.default("USD"),
+        to: currency.optional(),
+        amount: positiveAmount.default(1),
+    }),
+    timeSeries: z.object({
+        startDate: isoDate,
+        endDate: isoDate,
+        base: currency.default("USD"),
+        amount: positiveAmount.default(1),
+        currencies: z.array(currency).max(50).optional(),
+    }),
+    vat: z.object({
+        country: z
+            .string()
+            .trim()
+            .length(2, "country code must be 2 letters")
+            .transform((s) => s.toUpperCase())
+            .optional(),
+    }),
+};
+export const uniRateInputSchemas = inputs;
+const wrap = async (fn) => {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (err instanceof TRPCError)
+            throw err;
+        if (err instanceof AuthenticationError) {
+            throw new TRPCError({ code: "UNAUTHORIZED", message: err.message, cause: err });
+        }
+        if (err instanceof ProRequiredError) {
+            throw new TRPCError({ code: "FORBIDDEN", message: err.message, cause: err });
+        }
+        if (err instanceof InvalidCurrencyError) {
+            throw new TRPCError({ code: "NOT_FOUND", message: err.message, cause: err });
+        }
+        if (err instanceof InvalidRequestError) {
+            throw new TRPCError({ code: "BAD_REQUEST", message: err.message, cause: err });
+        }
+        if (err instanceof RateLimitError) {
+            throw new TRPCError({ code: "TOO_MANY_REQUESTS", message: err.message, cause: err });
+        }
+        if (err instanceof UniRateError) {
+            throw new TRPCError({
+                code: "INTERNAL_SERVER_ERROR",
+                message: err.message,
+                cause: err,
+            });
+        }
+        throw err;
+    }
+};
+const resolveClient = (opts) => {
+    if (opts.client)
+        return opts.client;
+    if (!opts.apiKey) {
+        throw new UniRateError("createUniRateRouter requires `apiKey` or `client`");
+    }
+    return new UniRateClient({ ...opts, apiKey: opts.apiKey });
+};
+/**
+ * Build a tRPC v11 router exposing the UniRate API.
+ *
+ * Creates its own `initTRPC.create()` instance and returns a fully-built
+ * router with seven query procedures: `convert`, `rate`, `rates`,
+ * `historical`, `timeSeries`, `currencies`, `vat`. Nest the result under
+ * any key in your own router via the object form:
+ *
+ *   t.router({ unirate: createUniRateRouter({ apiKey }) })
+ *
+ * Errors from the UniRate API are mapped to typed `TRPCError` codes
+ * (`UNAUTHORIZED`, `FORBIDDEN`, `NOT_FOUND`, `BAD_REQUEST`,
+ * `TOO_MANY_REQUESTS`, `INTERNAL_SERVER_ERROR`) so client-side
+ * `useQuery({ onError })` handlers see standard tRPC error shapes.
+ */
+export const createUniRateRouter = (opts) => {
+    const client = resolveClient(opts);
+    const t = initTRPC.create();
+    const proc = t.procedure;
+    return t.router({
+        convert: proc.input(inputs.convert).query(({ input }) => wrap(() => client.convert(input.to, input.amount, input.from))),
+        rate: proc.input(inputs.rate).query(({ input }) => wrap(() => client.getRate(input.from, input.to))),
+        rates: proc.input(inputs.rates).query(({ input }) => wrap(() => client.getRate(input.base))),
+        historical: proc.input(inputs.historical).query(({ input }) => wrap(() => client.getHistoricalRate(input.date, input.amount, input.from, input.to))),
+        timeSeries: proc.input(inputs.timeSeries).query(({ input }) => wrap(() => client.getTimeSeries(input.startDate, input.endDate, input.amount, input.base, input.currencies))),
+        currencies: proc.query(() => wrap(() => client.listCurrencies())),
+        vat: proc.input(inputs.vat).query(({ input }) => wrap(() => client.getVATRates(input.country))),
+    });
+};
+//# sourceMappingURL=router.js.map

package/dist/router.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "trpc-unirate",
+  "version": "0.1.0",
+  "description": "Pre-built tRPC router for the UniRate currency-exchange API. Drop-in createUniRateRouter() with Zod-validated procedures for convert, rates, historical, time-series, currencies, and VAT.",
+  "type": "module",
+  "license": "MIT",
+  "author": "UniRate (https://unirateapi.com)",
+  "homepage": "https://github.com/UniRate-API/trpc-unirate#readme",
+  "bugs": "https://github.com/UniRate-API/trpc-unirate/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/UniRate-API/trpc-unirate.git"
+  },
+  "keywords": [
+    "trpc",
+    "trpc-router",
+    "unirate",
+    "currency",
+    "exchange-rates",
+    "forex",
+    "money",
+    "fx",
+    "zod",
+    "fintech"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "main": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "import": "./dist/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "@trpc/server": "^11.0.0",
+    "zod": "^3.22.0 || ^4.0.0"
+  },
+  "devDependencies": {
+    "@trpc/server": "^11.0.0",
+    "@types/node": "^20.11.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0",
+    "zod": "^4.0.0"
+  },
+  "engines": {
+    "node": ">=18.17.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}