frankfurter-js 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tin Sever
+
+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,187 @@
+# frankfurter-js
+
+A lightweight, production-ready TypeScript SDK for the [Frankfurter currency API](https://github.com/lineofflight/frankfurter).
+
+It stays close to the HTTP API, uses `fetch`, ships type declarations, and works in modern Node.js and browsers.
+
+## Install
+
+```bash
+npm install frankfurter-js
+```
+
+## Quick Start
+
+```ts
+import { FrankfurterClient } from "frankfurter-js";
+
+const client = new FrankfurterClient();
+
+const latest = await client.latest({
+  base: "USD",
+  quotes: ["EUR", "GBP"]
+});
+```
+
+The default base URL is `https://api.frankfurter.dev`. The client targets the OpenAPI server path at `/v2` internally.
+
+## API
+
+### Create a client
+
+```ts
+import { FrankfurterClient, createFrankfurterClient } from "frankfurter-js";
+
+const client = new FrankfurterClient({
+  timeout: 5_000
+});
+
+const clientFromFactory = createFrankfurterClient();
+```
+
+### `rates(query?, requestOptions?)`
+
+Thin mapping to `GET /rates`.
+
+```ts
+const rates = await client.rates({
+  date: "2025-01-10",
+  base: "EUR",
+  quotes: ["USD", "CHF"],
+  providers: ["ECB"],
+});
+```
+
+### `latest(options?, requestOptions?)`
+
+Convenience method for the latest rates.
+
+```ts
+const latest = await client.latest({
+  base: "USD",
+  quotes: ["EUR", "GBP"]
+});
+```
+
+### `historical(date, options?, requestOptions?)`
+
+Convenience method for a specific date.
+
+```ts
+const historical = await client.historical("2025-01-10", {
+  base: "EUR",
+  quotes: "USD"
+});
+```
+
+### `range(from, to?, options?, requestOptions?)`
+
+Convenience method for date ranges.
+
+```ts
+const ranged = await client.range("2025-01-01", "2025-01-31", {
+  base: "EUR",
+  quotes: ["USD", "CHF"],
+  group: "month"
+});
+```
+
+### `currencies(query?, requestOptions?)`
+
+Maps to `GET /currencies`.
+
+```ts
+const currencies = await client.currencies();
+const allCurrencies = await client.currencies({ scope: "all" });
+```
+
+### `providers(requestOptions?)`
+
+Maps to `GET /providers`.
+
+```ts
+const providers = await client.providers();
+```
+
+## Self-Hosted Base URL
+
+```ts
+import { FrankfurterClient } from "frankfurter-js";
+
+const client = new FrankfurterClient({
+  baseUrl: "https://rates.example.com"
+});
+```
+
+## Custom Fetch
+
+```ts
+import { FrankfurterClient } from "frankfurter-js";
+
+const client = new FrankfurterClient({
+  fetch: window.fetch.bind(window)
+});
+```
+
+## Request Timeout and AbortSignal
+
+```ts
+const client = new FrankfurterClient({
+  timeout: 5_000
+});
+
+const controller = new AbortController();
+
+const rates = await client.latest(
+  { base: "EUR", quotes: ["USD"] },
+  { signal: controller.signal }
+);
+```
+
+## Error Handling
+
+Non-2xx responses throw `FrankfurterError`.
+
+```ts
+import { FrankfurterClient, FrankfurterError } from "frankfurter-js";
+
+const client = new FrankfurterClient();
+
+try {
+  await client.historical("invalid-date");
+} catch (error) {
+  if (error instanceof FrankfurterError) {
+    console.error(error.status);
+    console.error(error.statusText);
+    console.error(error.url);
+    console.error(error.body);
+  }
+}
+```
+
+## TypeScript
+
+```ts
+import type { Currency, Provider, Rate } from "frankfurter-js";
+import { FrankfurterClient } from "frankfurter-js";
+
+const client = new FrankfurterClient();
+
+const rates: Rate[] = await client.latest({ base: "EUR", quotes: ["USD"] });
+const currencies: Currency[] = await client.currencies();
+const providers: Provider[] = await client.providers();
+```
+
+## Notes
+
+- `quotes` and `providers` accept either a comma-separated string or a string array.
+- Query serialization follows the OpenAPI contract and sends comma-separated values for list params.
+- The SDK intentionally does not add retries, caching, or response reshaping.
+
+## Development
+
+```bash
+npm install
+npm run build
+npm test
+```

package/dist/index.cjs

@@ -0,0 +1,186 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/errors.ts
+var FrankfurterError = class extends Error {
+	constructor(options) {
+		super(`Frankfurter API request failed with ${options.status} ${options.statusText}`);
+		this.name = "FrankfurterError";
+		this.status = options.status;
+		this.statusText = options.statusText;
+		this.url = options.url;
+		this.body = options.body;
+		this.headers = options.headers;
+	}
+};
+//#endregion
+//#region src/http.ts
+const DEFAULT_BASE_URL = "https://api.frankfurter.dev";
+const DEFAULT_API_PREFIX = "/v2";
+function resolveClientOptions(options = {}) {
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	if (!fetchImpl) throw new Error("A fetch implementation is required. Pass one in the client options.");
+	return {
+		baseUrl: normalizeBaseUrl(options.baseUrl ?? DEFAULT_BASE_URL),
+		fetch: fetchImpl,
+		timeout: options.timeout,
+		headers: options.headers
+	};
+}
+function normalizeBaseUrl(baseUrl) {
+	const normalized = baseUrl.replace(/\/+$/, "");
+	const url = new URL(normalized);
+	if (url.pathname === DEFAULT_API_PREFIX || url.pathname.endsWith(`${DEFAULT_API_PREFIX}`)) return url.toString().replace(/\/+$/, "");
+	url.pathname = `${url.pathname.replace(/\/+$/, "")}${DEFAULT_API_PREFIX}`;
+	return url.toString().replace(/\/+$/, "");
+}
+function createUrl(baseUrl, path, query) {
+	const url = new URL(path, `${baseUrl}/`);
+	if (query && Array.from(query.keys()).length > 0) url.search = query.toString();
+	return url.toString();
+}
+async function parseResponseBody(response) {
+	if (response.status === 204) return;
+	if ((response.headers.get("content-type") ?? "").includes("application/json")) return response.json();
+	const text = await response.text();
+	return text.length > 0 ? text : void 0;
+}
+async function requestJson(options, url, requestOptions = {}) {
+	const controller = createTimeoutController(options.timeout, requestOptions.signal);
+	const headers = mergeHeaders(options.headers, requestOptions.headers);
+	const init = {
+		method: "GET",
+		signal: controller.signal
+	};
+	if (headers) init.headers = headers;
+	try {
+		const response = await options.fetch(url, init);
+		const body = await parseResponseBody(response);
+		if (!response.ok) throw new FrankfurterError({
+			status: response.status,
+			statusText: response.statusText,
+			url,
+			body,
+			headers: response.headers
+		});
+		return body;
+	} finally {
+		controller.cleanup();
+	}
+}
+function mergeHeaders(defaultHeaders, requestHeaders) {
+	if (!defaultHeaders && !requestHeaders) return;
+	const headers = new Headers(defaultHeaders);
+	new Headers(requestHeaders).forEach((value, key) => {
+		headers.set(key, value);
+	});
+	return headers;
+}
+function createTimeoutController(timeout, signal) {
+	const controller = new AbortController();
+	let timeoutId;
+	const abort = () => controller.abort(signal?.reason);
+	if (signal) if (signal.aborted) controller.abort(signal.reason);
+	else signal.addEventListener("abort", abort, { once: true });
+	if (typeof timeout === "number" && timeout > 0 && !controller.signal.aborted) timeoutId = setTimeout(() => {
+		controller.abort(/* @__PURE__ */ new Error(`Request timed out after ${timeout}ms`));
+	}, timeout);
+	return {
+		signal: controller.signal,
+		cleanup() {
+			if (timeoutId) clearTimeout(timeoutId);
+			if (signal) signal.removeEventListener("abort", abort);
+		}
+	};
+}
+//#endregion
+//#region src/query.ts
+function buildRatesQuery(query = {}) {
+	const searchParams = new URLSearchParams();
+	append(searchParams, "date", query.date);
+	append(searchParams, "from", query.from);
+	append(searchParams, "to", query.to);
+	append(searchParams, "base", query.base);
+	appendList(searchParams, "quotes", query.quotes);
+	appendList(searchParams, "providers", query.providers);
+	append(searchParams, "group", query.group);
+	return searchParams;
+}
+function buildCurrenciesQuery(query = {}) {
+	const searchParams = new URLSearchParams();
+	append(searchParams, "scope", query.scope);
+	return searchParams;
+}
+function append(searchParams, key, value) {
+	if (typeof value === "string" && value.length > 0) searchParams.set(key, value);
+}
+function appendList(searchParams, key, value) {
+	if (!value) return;
+	if (Array.isArray(value)) {
+		if (value.length > 0) searchParams.set(key, value.join(","));
+		return;
+	}
+	const stringValue = value;
+	if (stringValue.length > 0) searchParams.set(key, stringValue);
+}
+//#endregion
+//#region src/client.ts
+/**
+* Thin API client for the Frankfurter currency API.
+*/
+var FrankfurterClient = class {
+	constructor(options = {}) {
+		this.options = resolveClientOptions(options);
+	}
+	/**
+	* Fetch exchange rates using the raw `/rates` query shape from the API.
+	*/
+	async rates(query = {}, requestOptions = {}) {
+		const url = createUrl(this.options.baseUrl, "rates", buildRatesQuery(query));
+		return requestJson(this.options, url, requestOptions);
+	}
+	/**
+	* Fetch the latest exchange rates.
+	*/
+	async latest(options = {}, requestOptions = {}) {
+		return this.rates(options, requestOptions);
+	}
+	/**
+	* Fetch exchange rates for a specific date.
+	*/
+	async historical(date, options = {}, requestOptions = {}) {
+		return this.rates({
+			...options,
+			date
+		}, requestOptions);
+	}
+	/**
+	* Fetch exchange rates across a date range.
+	*/
+	async range(from, to, options = {}, requestOptions = {}) {
+		return this.rates({
+			...options,
+			from,
+			...to ? { to } : {}
+		}, requestOptions);
+	}
+	/**
+	* Fetch available currencies.
+	*/
+	async currencies(query = {}, requestOptions = {}) {
+		const url = createUrl(this.options.baseUrl, "currencies", buildCurrenciesQuery(query));
+		return requestJson(this.options, url, requestOptions);
+	}
+	/**
+	* Fetch available data providers.
+	*/
+	async providers(requestOptions = {}) {
+		const url = createUrl(this.options.baseUrl, "providers");
+		return requestJson(this.options, url, requestOptions);
+	}
+};
+function createFrankfurterClient(options = {}) {
+	return new FrankfurterClient(options);
+}
+//#endregion
+exports.FrankfurterClient = FrankfurterClient;
+exports.FrankfurterError = FrankfurterError;
+exports.createFrankfurterClient = createFrankfurterClient;

package/dist/index.d.cts

@@ -0,0 +1,126 @@
+//#region src/types.d.ts
+type DateString = string;
+type CurrencyCode = string;
+type ProviderKey = string;
+interface Rate {
+  date: DateString;
+  base: CurrencyCode;
+  quote: CurrencyCode;
+  rate: number;
+}
+interface Currency {
+  iso_code: CurrencyCode;
+  iso_numeric?: string | null;
+  name: string;
+  symbol?: string | null;
+  start_date?: DateString | null;
+  end_date?: DateString | null;
+}
+interface Provider {
+  key: ProviderKey;
+  name: string;
+  base: CurrencyCode;
+  start_date?: DateString | null;
+  end_date?: DateString | null;
+  currencies: CurrencyCode[];
+}
+interface ErrorResponseBody {
+  message?: string;
+  [key: string]: unknown;
+}
+type Listable<T> = T | readonly T[];
+type GroupBy = "week" | "month";
+type CurrencyScope = "all";
+interface RatesQuery {
+  date?: DateString;
+  from?: DateString;
+  to?: DateString;
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+  group?: GroupBy;
+}
+interface LatestRatesOptions {
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+}
+interface HistoricalRatesOptions {
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+}
+interface RangeRatesOptions {
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+  group?: GroupBy;
+}
+interface CurrenciesQuery {
+  scope?: CurrencyScope;
+}
+interface RequestOptions {
+  signal?: AbortSignal;
+  headers?: HeadersInit;
+}
+interface FrankfurterClientOptions {
+  baseUrl?: string;
+  fetch?: typeof fetch;
+  timeout?: number;
+  headers?: HeadersInit;
+}
+//#endregion
+//#region src/client.d.ts
+/**
+ * Thin API client for the Frankfurter currency API.
+ */
+declare class FrankfurterClient {
+  private readonly options;
+  constructor(options?: FrankfurterClientOptions);
+  /**
+   * Fetch exchange rates using the raw `/rates` query shape from the API.
+   */
+  rates(query?: RatesQuery, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch the latest exchange rates.
+   */
+  latest(options?: LatestRatesOptions, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch exchange rates for a specific date.
+   */
+  historical(date: string, options?: HistoricalRatesOptions, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch exchange rates across a date range.
+   */
+  range(from: string, to?: string, options?: RangeRatesOptions, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch available currencies.
+   */
+  currencies(query?: CurrenciesQuery, requestOptions?: RequestOptions): Promise<Currency[]>;
+  /**
+   * Fetch available data providers.
+   */
+  providers(requestOptions?: RequestOptions): Promise<Provider[]>;
+}
+declare function createFrankfurterClient(options?: FrankfurterClientOptions): FrankfurterClient;
+//#endregion
+//#region src/errors.d.ts
+interface FrankfurterErrorOptions {
+  status: number;
+  statusText: string;
+  url: string;
+  body: unknown | undefined;
+  headers: Headers | undefined;
+}
+declare class FrankfurterError extends Error {
+  readonly name = "FrankfurterError";
+  readonly status: number;
+  readonly statusText: string;
+  readonly url: string;
+  readonly body: unknown | undefined;
+  readonly headers: Headers | undefined;
+  constructor(options: FrankfurterErrorOptions);
+}
+//#endregion
+export { type CurrenciesQuery, type Currency, type CurrencyCode, type CurrencyScope, type DateString, type ErrorResponseBody, FrankfurterClient, type FrankfurterClientOptions, FrankfurterError, type GroupBy, type HistoricalRatesOptions, type LatestRatesOptions, type Listable, type Provider, type ProviderKey, type RangeRatesOptions, type Rate, type RatesQuery, type RequestOptions, createFrankfurterClient };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

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

package/dist/index.d.mts

@@ -0,0 +1,126 @@
+//#region src/types.d.ts
+type DateString = string;
+type CurrencyCode = string;
+type ProviderKey = string;
+interface Rate {
+  date: DateString;
+  base: CurrencyCode;
+  quote: CurrencyCode;
+  rate: number;
+}
+interface Currency {
+  iso_code: CurrencyCode;
+  iso_numeric?: string | null;
+  name: string;
+  symbol?: string | null;
+  start_date?: DateString | null;
+  end_date?: DateString | null;
+}
+interface Provider {
+  key: ProviderKey;
+  name: string;
+  base: CurrencyCode;
+  start_date?: DateString | null;
+  end_date?: DateString | null;
+  currencies: CurrencyCode[];
+}
+interface ErrorResponseBody {
+  message?: string;
+  [key: string]: unknown;
+}
+type Listable<T> = T | readonly T[];
+type GroupBy = "week" | "month";
+type CurrencyScope = "all";
+interface RatesQuery {
+  date?: DateString;
+  from?: DateString;
+  to?: DateString;
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+  group?: GroupBy;
+}
+interface LatestRatesOptions {
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+}
+interface HistoricalRatesOptions {
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+}
+interface RangeRatesOptions {
+  base?: CurrencyCode;
+  quotes?: Listable<CurrencyCode>;
+  providers?: Listable<ProviderKey>;
+  group?: GroupBy;
+}
+interface CurrenciesQuery {
+  scope?: CurrencyScope;
+}
+interface RequestOptions {
+  signal?: AbortSignal;
+  headers?: HeadersInit;
+}
+interface FrankfurterClientOptions {
+  baseUrl?: string;
+  fetch?: typeof fetch;
+  timeout?: number;
+  headers?: HeadersInit;
+}
+//#endregion
+//#region src/client.d.ts
+/**
+ * Thin API client for the Frankfurter currency API.
+ */
+declare class FrankfurterClient {
+  private readonly options;
+  constructor(options?: FrankfurterClientOptions);
+  /**
+   * Fetch exchange rates using the raw `/rates` query shape from the API.
+   */
+  rates(query?: RatesQuery, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch the latest exchange rates.
+   */
+  latest(options?: LatestRatesOptions, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch exchange rates for a specific date.
+   */
+  historical(date: string, options?: HistoricalRatesOptions, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch exchange rates across a date range.
+   */
+  range(from: string, to?: string, options?: RangeRatesOptions, requestOptions?: RequestOptions): Promise<Rate[]>;
+  /**
+   * Fetch available currencies.
+   */
+  currencies(query?: CurrenciesQuery, requestOptions?: RequestOptions): Promise<Currency[]>;
+  /**
+   * Fetch available data providers.
+   */
+  providers(requestOptions?: RequestOptions): Promise<Provider[]>;
+}
+declare function createFrankfurterClient(options?: FrankfurterClientOptions): FrankfurterClient;
+//#endregion
+//#region src/errors.d.ts
+interface FrankfurterErrorOptions {
+  status: number;
+  statusText: string;
+  url: string;
+  body: unknown | undefined;
+  headers: Headers | undefined;
+}
+declare class FrankfurterError extends Error {
+  readonly name = "FrankfurterError";
+  readonly status: number;
+  readonly statusText: string;
+  readonly url: string;
+  readonly body: unknown | undefined;
+  readonly headers: Headers | undefined;
+  constructor(options: FrankfurterErrorOptions);
+}
+//#endregion
+export { type CurrenciesQuery, type Currency, type CurrencyCode, type CurrencyScope, type DateString, type ErrorResponseBody, FrankfurterClient, type FrankfurterClientOptions, FrankfurterError, type GroupBy, type HistoricalRatesOptions, type LatestRatesOptions, type Listable, type Provider, type ProviderKey, type RangeRatesOptions, type Rate, type RatesQuery, type RequestOptions, createFrankfurterClient };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

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

package/dist/index.mjs

@@ -0,0 +1,185 @@
+//#region src/errors.ts
+var FrankfurterError = class extends Error {
+	constructor(options) {
+		super(`Frankfurter API request failed with ${options.status} ${options.statusText}`);
+		this.name = "FrankfurterError";
+		this.status = options.status;
+		this.statusText = options.statusText;
+		this.url = options.url;
+		this.body = options.body;
+		this.headers = options.headers;
+	}
+};
+//#endregion
+//#region src/http.ts
+const DEFAULT_BASE_URL = "https://api.frankfurter.dev";
+const DEFAULT_API_PREFIX = "/v2";
+function resolveClientOptions(options = {}) {
+	const fetchImpl = options.fetch ?? globalThis.fetch;
+	if (!fetchImpl) throw new Error("A fetch implementation is required. Pass one in the client options.");
+	return {
+		baseUrl: normalizeBaseUrl(options.baseUrl ?? DEFAULT_BASE_URL),
+		fetch: fetchImpl,
+		timeout: options.timeout,
+		headers: options.headers
+	};
+}
+function normalizeBaseUrl(baseUrl) {
+	const normalized = baseUrl.replace(/\/+$/, "");
+	const url = new URL(normalized);
+	if (url.pathname === DEFAULT_API_PREFIX || url.pathname.endsWith(`${DEFAULT_API_PREFIX}`)) return url.toString().replace(/\/+$/, "");
+	url.pathname = `${url.pathname.replace(/\/+$/, "")}${DEFAULT_API_PREFIX}`;
+	return url.toString().replace(/\/+$/, "");
+}
+function createUrl(baseUrl, path, query) {
+	const url = new URL(path, `${baseUrl}/`);
+	if (query && Array.from(query.keys()).length > 0) url.search = query.toString();
+	return url.toString();
+}
+async function parseResponseBody(response) {
+	if (response.status === 204) return;
+	if ((response.headers.get("content-type") ?? "").includes("application/json")) return response.json();
+	const text = await response.text();
+	return text.length > 0 ? text : void 0;
+}
+async function requestJson(options, url, requestOptions = {}) {
+	const controller = createTimeoutController(options.timeout, requestOptions.signal);
+	const headers = mergeHeaders(options.headers, requestOptions.headers);
+	const init = {
+		method: "GET",
+		signal: controller.signal
+	};
+	if (headers) init.headers = headers;
+	try {
+		const response = await options.fetch(url, init);
+		const body = await parseResponseBody(response);
+		if (!response.ok) throw new FrankfurterError({
+			status: response.status,
+			statusText: response.statusText,
+			url,
+			body,
+			headers: response.headers
+		});
+		return body;
+	} finally {
+		controller.cleanup();
+	}
+}
+function mergeHeaders(defaultHeaders, requestHeaders) {
+	if (!defaultHeaders && !requestHeaders) return;
+	const headers = new Headers(defaultHeaders);
+	new Headers(requestHeaders).forEach((value, key) => {
+		headers.set(key, value);
+	});
+	return headers;
+}
+function createTimeoutController(timeout, signal) {
+	const controller = new AbortController();
+	let timeoutId;
+	const abort = () => controller.abort(signal?.reason);
+	if (signal) if (signal.aborted) controller.abort(signal.reason);
+	else signal.addEventListener("abort", abort, { once: true });
+	if (typeof timeout === "number" && timeout > 0 && !controller.signal.aborted) timeoutId = setTimeout(() => {
+		controller.abort(/* @__PURE__ */ new Error(`Request timed out after ${timeout}ms`));
+	}, timeout);
+	return {
+		signal: controller.signal,
+		cleanup() {
+			if (timeoutId) clearTimeout(timeoutId);
+			if (signal) signal.removeEventListener("abort", abort);
+		}
+	};
+}
+//#endregion
+//#region src/query.ts
+function buildRatesQuery(query = {}) {
+	const searchParams = new URLSearchParams();
+	append(searchParams, "date", query.date);
+	append(searchParams, "from", query.from);
+	append(searchParams, "to", query.to);
+	append(searchParams, "base", query.base);
+	appendList(searchParams, "quotes", query.quotes);
+	appendList(searchParams, "providers", query.providers);
+	append(searchParams, "group", query.group);
+	return searchParams;
+}
+function buildCurrenciesQuery(query = {}) {
+	const searchParams = new URLSearchParams();
+	append(searchParams, "scope", query.scope);
+	return searchParams;
+}
+function append(searchParams, key, value) {
+	if (typeof value === "string" && value.length > 0) searchParams.set(key, value);
+}
+function appendList(searchParams, key, value) {
+	if (!value) return;
+	if (Array.isArray(value)) {
+		if (value.length > 0) searchParams.set(key, value.join(","));
+		return;
+	}
+	const stringValue = value;
+	if (stringValue.length > 0) searchParams.set(key, stringValue);
+}
+//#endregion
+//#region src/client.ts
+/**
+* Thin API client for the Frankfurter currency API.
+*/
+var FrankfurterClient = class {
+	constructor(options = {}) {
+		this.options = resolveClientOptions(options);
+	}
+	/**
+	* Fetch exchange rates using the raw `/rates` query shape from the API.
+	*/
+	async rates(query = {}, requestOptions = {}) {
+		const url = createUrl(this.options.baseUrl, "rates", buildRatesQuery(query));
+		return requestJson(this.options, url, requestOptions);
+	}
+	/**
+	* Fetch the latest exchange rates.
+	*/
+	async latest(options = {}, requestOptions = {}) {
+		return this.rates(options, requestOptions);
+	}
+	/**
+	* Fetch exchange rates for a specific date.
+	*/
+	async historical(date, options = {}, requestOptions = {}) {
+		return this.rates({
+			...options,
+			date
+		}, requestOptions);
+	}
+	/**
+	* Fetch exchange rates across a date range.
+	*/
+	async range(from, to, options = {}, requestOptions = {}) {
+		return this.rates({
+			...options,
+			from,
+			...to ? { to } : {}
+		}, requestOptions);
+	}
+	/**
+	* Fetch available currencies.
+	*/
+	async currencies(query = {}, requestOptions = {}) {
+		const url = createUrl(this.options.baseUrl, "currencies", buildCurrenciesQuery(query));
+		return requestJson(this.options, url, requestOptions);
+	}
+	/**
+	* Fetch available data providers.
+	*/
+	async providers(requestOptions = {}) {
+		const url = createUrl(this.options.baseUrl, "providers");
+		return requestJson(this.options, url, requestOptions);
+	}
+};
+function createFrankfurterClient(options = {}) {
+	return new FrankfurterClient(options);
+}
+//#endregion
+export { FrankfurterClient, FrankfurterError, createFrankfurterClient };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/errors.ts","../src/http.ts","../src/query.ts","../src/client.ts"],"sourcesContent":["export interface FrankfurterErrorOptions {\n  status: number;\n  statusText: string;\n  url: string;\n  body: unknown | undefined;\n  headers: Headers | undefined;\n}\n\nexport class FrankfurterError extends Error {\n  readonly name = \"FrankfurterError\";\n  readonly status: number;\n  readonly statusText: string;\n  readonly url: string;\n  readonly body: unknown | undefined;\n  readonly headers: Headers | undefined;\n\n  constructor(options: FrankfurterErrorOptions) {\n    super(`Frankfurter API request failed with ${options.status} ${options.statusText}`);\n    this.status = options.status;\n    this.statusText = options.statusText;\n    this.url = options.url;\n    this.body = options.body;\n    this.headers = options.headers;\n  }\n}\n","import { FrankfurterError } from \"./errors.js\";\nimport type { FrankfurterClientOptions, RequestOptions } from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.frankfurter.dev\";\nconst DEFAULT_API_PREFIX = \"/v2\";\n\nexport interface ResolvedClientOptions {\n  baseUrl: string;\n  fetch: typeof fetch;\n  timeout: number | undefined;\n  headers: HeadersInit | undefined;\n}\n\nexport function resolveClientOptions(options: FrankfurterClientOptions = {}): ResolvedClientOptions {\n  const fetchImpl = options.fetch ?? globalThis.fetch;\n\n  if (!fetchImpl) {\n    throw new Error(\"A fetch implementation is required. Pass one in the client options.\");\n  }\n\n  return {\n    baseUrl: normalizeBaseUrl(options.baseUrl ?? DEFAULT_BASE_URL),\n    fetch: fetchImpl,\n    timeout: options.timeout,\n    headers: options.headers\n  };\n}\n\nexport function normalizeBaseUrl(baseUrl: string): string {\n  const normalized = baseUrl.replace(/\\/+$/, \"\");\n  const url = new URL(normalized);\n\n  if (url.pathname === DEFAULT_API_PREFIX || url.pathname.endsWith(`${DEFAULT_API_PREFIX}`)) {\n    return url.toString().replace(/\\/+$/, \"\");\n  }\n\n  url.pathname = `${url.pathname.replace(/\\/+$/, \"\")}${DEFAULT_API_PREFIX}`;\n  return url.toString().replace(/\\/+$/, \"\");\n}\n\nexport function createUrl(baseUrl: string, path: string, query?: URLSearchParams): string {\n  const url = new URL(path, `${baseUrl}/`);\n\n  if (query && Array.from(query.keys()).length > 0) {\n    url.search = query.toString();\n  }\n\n  return url.toString();\n}\n\nexport async function parseResponseBody(response: Response): Promise<unknown> {\n  if (response.status === 204) {\n    return undefined;\n  }\n\n  const contentType = response.headers.get(\"content-type\") ?? \"\";\n\n  if (contentType.includes(\"application/json\")) {\n    return response.json();\n  }\n\n  const text = await response.text();\n  return text.length > 0 ? text : undefined;\n}\n\nexport async function requestJson<T>(\n  options: ResolvedClientOptions,\n  url: string,\n  requestOptions: RequestOptions = {}\n): Promise<T> {\n  const controller = createTimeoutController(options.timeout, requestOptions.signal);\n  const headers = mergeHeaders(options.headers, requestOptions.headers);\n  const init: RequestInit = {\n    method: \"GET\",\n    signal: controller.signal\n  };\n\n  if (headers) {\n    init.headers = headers;\n  }\n\n  try {\n    const response = await options.fetch(url, init);\n\n    const body = await parseResponseBody(response);\n\n    if (!response.ok) {\n      throw new FrankfurterError({\n        status: response.status,\n        statusText: response.statusText,\n        url,\n        body,\n        headers: response.headers\n      });\n    }\n\n    return body as T;\n  } finally {\n    controller.cleanup();\n  }\n}\n\nfunction mergeHeaders(defaultHeaders?: HeadersInit, requestHeaders?: HeadersInit): Headers | undefined {\n  if (!defaultHeaders && !requestHeaders) {\n    return undefined;\n  }\n\n  const headers = new Headers(defaultHeaders);\n  new Headers(requestHeaders).forEach((value, key) => {\n    headers.set(key, value);\n  });\n\n  return headers;\n}\n\nfunction createTimeoutController(timeout: number | undefined, signal?: AbortSignal) {\n  const controller = new AbortController();\n  let timeoutId: ReturnType<typeof setTimeout> | undefined;\n  const abort = () => controller.abort(signal?.reason);\n\n  if (signal) {\n    if (signal.aborted) {\n      controller.abort(signal.reason);\n    } else {\n      signal.addEventListener(\"abort\", abort, { once: true });\n    }\n  }\n\n  if (typeof timeout === \"number\" && timeout > 0 && !controller.signal.aborted) {\n    timeoutId = setTimeout(() => {\n      controller.abort(new Error(`Request timed out after ${timeout}ms`));\n    }, timeout);\n  }\n\n  return {\n    signal: controller.signal,\n    cleanup() {\n      if (timeoutId) {\n        clearTimeout(timeoutId);\n      }\n\n      if (signal) {\n        signal.removeEventListener(\"abort\", abort);\n      }\n    }\n  };\n}\n","import type { CurrenciesQuery, Listable, RatesQuery } from \"./types.js\";\n\nexport function buildRatesQuery(query: RatesQuery = {}): URLSearchParams {\n  const searchParams = new URLSearchParams();\n\n  append(searchParams, \"date\", query.date);\n  append(searchParams, \"from\", query.from);\n  append(searchParams, \"to\", query.to);\n  append(searchParams, \"base\", query.base);\n  appendList(searchParams, \"quotes\", query.quotes);\n  appendList(searchParams, \"providers\", query.providers);\n  append(searchParams, \"group\", query.group);\n\n  return searchParams;\n}\n\nexport function buildCurrenciesQuery(query: CurrenciesQuery = {}): URLSearchParams {\n  const searchParams = new URLSearchParams();\n  append(searchParams, \"scope\", query.scope);\n  return searchParams;\n}\n\nfunction append(searchParams: URLSearchParams, key: string, value: string | undefined) {\n  if (typeof value === \"string\" && value.length > 0) {\n    searchParams.set(key, value);\n  }\n}\n\nfunction appendList(searchParams: URLSearchParams, key: string, value: Listable<string> | undefined) {\n  if (!value) {\n    return;\n  }\n\n  if (Array.isArray(value)) {\n    if (value.length > 0) {\n      searchParams.set(key, value.join(\",\"));\n    }\n    return;\n  }\n\n  const stringValue = value as string;\n\n  if (stringValue.length > 0) {\n    searchParams.set(key, stringValue);\n  }\n}\n","import { createUrl, requestJson, resolveClientOptions } from \"./http.js\";\nimport { buildCurrenciesQuery, buildRatesQuery } from \"./query.js\";\nimport type {\n  CurrenciesQuery,\n  Currency,\n  FrankfurterClientOptions,\n  HistoricalRatesOptions,\n  LatestRatesOptions,\n  Provider,\n  RangeRatesOptions,\n  Rate,\n  RatesQuery,\n  RequestOptions\n} from \"./types.js\";\n\n/**\n * Thin API client for the Frankfurter currency API.\n */\nexport class FrankfurterClient {\n  private readonly options;\n\n  constructor(options: FrankfurterClientOptions = {}) {\n    this.options = resolveClientOptions(options);\n  }\n\n  /**\n   * Fetch exchange rates using the raw `/rates` query shape from the API.\n   */\n  async rates(query: RatesQuery = {}, requestOptions: RequestOptions = {}): Promise<Rate[]> {\n    const url = createUrl(this.options.baseUrl, \"rates\", buildRatesQuery(query));\n    return requestJson<Rate[]>(this.options, url, requestOptions);\n  }\n\n  /**\n   * Fetch the latest exchange rates.\n   */\n  async latest(options: LatestRatesOptions = {}, requestOptions: RequestOptions = {}): Promise<Rate[]> {\n    return this.rates(options, requestOptions);\n  }\n\n  /**\n   * Fetch exchange rates for a specific date.\n   */\n  async historical(\n    date: string,\n    options: HistoricalRatesOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<Rate[]> {\n    return this.rates({ ...options, date }, requestOptions);\n  }\n\n  /**\n   * Fetch exchange rates across a date range.\n   */\n  async range(\n    from: string,\n    to?: string,\n    options: RangeRatesOptions = {},\n    requestOptions: RequestOptions = {}\n  ): Promise<Rate[]> {\n    return this.rates(\n      {\n        ...options,\n        from,\n        ...(to ? { to } : {})\n      },\n      requestOptions\n    );\n  }\n\n  /**\n   * Fetch available currencies.\n   */\n  async currencies(query: CurrenciesQuery = {}, requestOptions: RequestOptions = {}): Promise<Currency[]> {\n    const url = createUrl(this.options.baseUrl, \"currencies\", buildCurrenciesQuery(query));\n    return requestJson<Currency[]>(this.options, url, requestOptions);\n  }\n\n  /**\n   * Fetch available data providers.\n   */\n  async providers(requestOptions: RequestOptions = {}): Promise<Provider[]> {\n    const url = createUrl(this.options.baseUrl, \"providers\");\n    return requestJson<Provider[]>(this.options, url, requestOptions);\n  }\n}\n\nexport function createFrankfurterClient(options: FrankfurterClientOptions = {}): FrankfurterClient {\n  return new FrankfurterClient(options);\n}\n"],"mappings":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "frankfurter-js",
+  "version": "0.1.0",
+  "description": "A lightweight TypeScript SDK for the Frankfurter currency API.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs",
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsdown src/index.ts --format esm,cjs --dts",
+    "dev": "tsdown src/index.ts --format esm,cjs --dts --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "frankfurter",
+    "currency",
+    "exchange-rates",
+    "forex",
+    "sdk",
+    "typescript"
+  ],
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "tsdown": "^0.21.4",
+    "typescript": "^5.9.3",
+    "vitest": "^4.1.0"
+  }
+}