@ducatjs/money 0.0.0-stage → 0.1.0

package/dist/exact.js.map

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

package/dist/fetch.d.ts

@@ -0,0 +1,58 @@
+import type { RateTable } from './provider.js';
+/**
+ * The part of the platform AbortSignal used here. Declared structurally so the library needs no DOM
+ * or Node types; any real AbortSignal fits.
+ */
+export interface AbortSignalLike {
+    readonly aborted: boolean;
+    readonly reason?: unknown;
+    addEventListener(type: 'abort', listener: () => void, options?: {
+        once?: boolean;
+    }): void;
+    removeEventListener(type: 'abort', listener: () => void): void;
+}
+/** The subset of the platform fetch used here (Node 24+, Deno, Bun, browsers, workers). */
+export type Fetch = (url: string, init?: {
+    signal?: AbortSignalLike;
+    headers?: Record<string, string>;
+}) => Promise<{
+    ok: boolean;
+    status: number;
+    text(): Promise<string>;
+}>;
+/** The ECB's eurofxref files: the latest day, the last 90 days, and the full history since 1999. */
+export declare const ECB_URLS: {
+    readonly daily: "https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml";
+    readonly '90d': "https://www.ecb.europa.eu/stats/eurofxref/eurofxref-hist-90d.xml";
+    readonly all: "https://www.ecb.europa.eu/stats/eurofxref/eurofxref-hist.xml";
+};
+/** Options for fetching ECB reference rates. */
+export interface FetchEcbOptions {
+    /** 'daily' (default): the latest day; '90d': the last 90 days; 'all': since 1999 (several MB). */
+    readonly history?: keyof typeof ECB_URLS;
+    /** An AbortSignal to cancel the request; it is combined with the timeout. */
+    readonly signal?: AbortSignalLike;
+    /**
+     * Milliseconds before the request is aborted (default 30 000; 0 for no timeout). It needs the
+     * platform's AbortSignal.timeout, which Node 24, Deno, Bun and current browsers all have.
+     */
+    readonly timeout?: number;
+    /** A fetch to use instead of the global one (for proxies, retries or tests). */
+    readonly fetch?: Fetch;
+}
+/** Thrown when the HTTP request completes without a 2xx status. */
+export declare class FetchRatesError extends Error {
+    readonly status: number;
+    readonly url: string;
+    constructor(url: string, status: number);
+}
+/**
+ * Fetches the ECB euro reference rates and parses them with parseEcbXml: EUR-based tables,
+ * newest first. The ECB publishes once per TARGET working day at about 16:00 CET and states
+ * that its rates are for information purposes only.
+ *
+ *     const [latest] = await fetchEcb(); // the RateTable for the last published day
+ *     const hist = snapshotsFrom(await fetchEcb({ history: '90d' }));
+ */
+export declare function fetchEcb(options?: FetchEcbOptions): Promise<RateTable[]>;
+//# sourceMappingURL=fetch.d.ts.map

package/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAE/C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,EAAE,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC1F,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CAChE;AAED,2FAA2F;AAC3F,MAAM,MAAM,KAAK,GAAG,CAClB,GAAG,EAAE,MAAM,EACX,IAAI,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,eAAe,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,KAClE,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAUvE,oGAAoG;AACpG,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX,gDAAgD;AAChD,MAAM,WAAW,eAAe;IAC9B,kGAAkG;IAClG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,OAAO,QAAQ,CAAC;IACzC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gFAAgF;IAChF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;CACxB;AAED,mEAAmE;AACnE,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;gBACT,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAMxC;AAED;;;;;;;GAOG;AACH,wBAAsB,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CA6B9E"}

package/dist/fetch.js

@@ -0,0 +1,79 @@
+// Network fetchers for published reference rates, using the platform fetch. Opt-in: nothing else in
+// the library imports this module, so core and @ducatjs/money/convert never touch the
+// network. You decide when to call it and how to cache.
+import { parseEcbXml } from './ecb.js';
+const DEFAULT_TIMEOUT_MS = 30_000;
+/** The ECB's eurofxref files: the latest day, the last 90 days, and the full history since 1999. */
+export const ECB_URLS = {
+    daily: 'https://www.ecb.europa.eu/stats/eurofxref/eurofxref-daily.xml',
+    '90d': 'https://www.ecb.europa.eu/stats/eurofxref/eurofxref-hist-90d.xml',
+    all: 'https://www.ecb.europa.eu/stats/eurofxref/eurofxref-hist.xml',
+};
+/** Thrown when the HTTP request completes without a 2xx status. */
+export class FetchRatesError extends Error {
+    status;
+    url;
+    constructor(url, status) {
+        super(`GET ${url} failed with HTTP ${status}`);
+        this.name = 'FetchRatesError';
+        this.status = status;
+        this.url = url;
+    }
+}
+/**
+ * Fetches the ECB euro reference rates and parses them with parseEcbXml: EUR-based tables,
+ * newest first. The ECB publishes once per TARGET working day at about 16:00 CET and states
+ * that its rates are for information purposes only.
+ *
+ *     const [latest] = await fetchEcb(); // the RateTable for the last published day
+ *     const hist = snapshotsFrom(await fetchEcb({ history: '90d' }));
+ */
+export async function fetchEcb(options) {
+    const url = ECB_URLS[options?.history ?? 'daily'];
+    const fetchFunction = options?.fetch ?? globalThis.fetch;
+    if (fetchFunction === undefined) {
+        throw new TypeError('No fetch available: pass options.fetch');
+    }
+    const init = {
+        headers: { accept: 'application/xml' },
+    };
+    const signal = requestSignal(options?.signal, options?.timeout ?? DEFAULT_TIMEOUT_MS);
+    if (signal !== undefined) {
+        init.signal = signal;
+    }
+    const response = await fetchFunction(url, init);
+    if (!response.ok) {
+        throw new FetchRatesError(url, response.status);
+    }
+    const body = await response.text();
+    try {
+        return parseEcbXml(body);
+    }
+    catch (error) {
+        // An error page or a captive portal is the usual cause, so say where the bad file came from.
+        if (error instanceof SyntaxError) {
+            throw new SyntaxError(`${error.message} (from ${url})`, { cause: error });
+        }
+        throw error;
+    }
+}
+/** The caller's signal, a timeout signal, or both combined. */
+function requestSignal(signal, timeout) {
+    if (!Number.isFinite(timeout) || timeout < 0) {
+        throw new RangeError(`timeout must be a non-negative number of milliseconds, got ${timeout}`);
+    }
+    const statics = globalThis.AbortSignal;
+    if (timeout === 0 || statics?.timeout === undefined) {
+        return signal;
+    }
+    const timeoutSignal = statics.timeout(timeout);
+    if (signal === undefined) {
+        return timeoutSignal;
+    }
+    if (statics.any === undefined) {
+        // Without AbortSignal.any the caller's signal wins: it is the one they can control.
+        return signal;
+    }
+    return statics.any([signal, timeoutSignal]);
+}
+//# sourceMappingURL=fetch.js.map

package/dist/fetch.js.map

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

package/dist/fixed.d.ts

@@ -0,0 +1,121 @@
+import { type Factor } from './decimal.js';
+import { type CurrencyInput, type Money } from './money.js';
+import { type RoundingMode } from './rounding.js';
+declare const INTERNAL: unique symbol;
+/** What `fixed()` accepts: a decimal string, a number, a bigint or a Fixed. */
+export type FixedInput = string | number | bigint | Fixed;
+/** Options for `fixed()`. */
+export interface FixedOptions {
+    /** Decimal places to keep (default: as many as the input has; 0 for integers). */
+    readonly scale?: number;
+    /** How to round input with more decimals than `scale` (default 'unnecessary': throw). */
+    readonly rounding?: RoundingMode;
+}
+/** Options for multiply and divide. */
+export interface ArithmeticOptions {
+    /** The result's scale (default: the scale of the value being multiplied or divided). */
+    readonly scale?: number;
+}
+/** The integer-and-scale form of a Fixed: `value / 10^scale`. */
+export interface ScaledInteger {
+    readonly value: number | bigint;
+    readonly scale: number;
+}
+/**
+ * An exact fixed-point decimal: `value / 10^scale`. Immutable. Create one with `fixed()` or
+ * `fromScaled()`. Mixed scales work as for Money: add, subtract and compare align to the larger
+ * scale exactly, and multiply and divide keep this value's scale.
+ */
+export declare class Fixed {
+    /** The scaled integer: a number while it is a safe integer, a bigint beyond. */
+    readonly value: number | bigint;
+    /** Decimal places. */
+    readonly scale: number;
+    /** @internal use fixed() or fromScaled() */
+    constructor(token: typeof INTERNAL, value: number | bigint, scale: number);
+    /** this + other, exactly, at the larger of the two scales. */
+    add(other: FixedInput): Fixed;
+    /** this − other, exactly, at the larger of the two scales. */
+    subtract(other: FixedInput): Fixed;
+    /**
+     * this × factor, rounded once to this value's scale or `options.scale` (default 'halfExpand').
+     * The factor is exact: an integer, a decimal string ('1.075'), a bigint, a `ratio()` or another
+     * Fixed. Give `scale` rather than calling toScale afterwards, which would round twice.
+     */
+    multiply(factor: Factor | Fixed, rounding?: RoundingMode, options?: ArithmeticOptions): Fixed;
+    /**
+     * this ÷ divisor, rounded once to this value's scale or `options.scale` (default 'halfExpand'):
+     * `fixed('9.990').divide('1.2', 'halfEven', { scale: 2 })` is 8.32.
+     */
+    divide(divisor: Factor | Fixed, rounding?: RoundingMode, options?: ArithmeticOptions): Fixed;
+    /** −this */
+    negate(): Fixed;
+    /** |this| */
+    abs(): Fixed;
+    /**
+     * Rounds to `scale` decimal places (default 0, an integer): `fixed('2.5').round('halfEven')` is
+     * 2. Money's round() defaults to the currency's exponent; a Fixed has none, so the default is 0.
+     */
+    round(rounding: RoundingMode, scale?: number): Fixed;
+    /**
+     * Changes the scale: increasing it is always exact, decreasing it rounds (default 'halfExpand').
+     */
+    toScale(scale: number, rounding?: RoundingMode): Fixed;
+    /** −1, 0 or 1, exactly, across scales and number/bigint. */
+    compare(other: FixedInput): -1 | 0 | 1;
+    /** The same value, at any scale: 1.0 equals 1.00. */
+    equals(other: FixedInput): boolean;
+    /** this < other */
+    lessThan(other: FixedInput): boolean;
+    /** this ≤ other */
+    lessThanOrEqual(other: FixedInput): boolean;
+    /** this > other */
+    greaterThan(other: FixedInput): boolean;
+    /** this ≥ other */
+    greaterThanOrEqual(other: FixedInput): boolean;
+    /** this = 0 */
+    isZero(): boolean;
+    /** this > 0 */
+    isPositive(): boolean;
+    /** this < 0 */
+    isNegative(): boolean;
+    /** −1, 0 or 1 */
+    sign(): -1 | 0 | 1;
+    /** The plain decimal string, with every decimal place of the scale: '12.340'. */
+    toString(): string;
+    /** The decimal string, as toString(), so JSON round-trips exactly through `fixed()`. */
+    toJSON(): string;
+    /** `{ value, scale }`, the exact integer form: value / 10^scale. */
+    toScaled(): ScaledInteger;
+    /**
+     * Money in `currency`, at its exponent. Throws RoundingError when that would drop digits, unless
+     * `rounding` is given: `fixed('1.005').toMoney('EUR', 'halfEven')` is 1.00 EUR.
+     */
+    toMoney<C extends CurrencyInput>(currency: C, rounding?: RoundingMode): Money<C>;
+    /** Blocks `a + b`, `a > b` and `+a`: arithmetic and comparison go through the methods. */
+    [Symbol.toPrimitive](hint: string): string;
+}
+/**
+ * Creates an exact fixed-point decimal.
+ *
+ *     fixed('12.340')                 // 12.340: a string keeps its scale (3)
+ *     fixed('1.005', { scale: 2, rounding: 'halfEven' })   // 1.00
+ *     fixed(12)                       // 12, scale 0
+ *     fixed(0.25)                     // 0.25: read at its shortest decimal form
+ *     fixed(10n ** 30n)
+ *
+ * Numbers are taken at their shortest decimal form, and only when that has at most 15 significant
+ * digits, which a double always holds faithfully. So `fixed(0.1 + 0.2)` throws rather than becoming
+ * 0.30000000000000004; pass the decimal as a string, or give `scale` and `rounding`. Input with
+ * more decimals than `scale` throws unless `rounding` is given, and `rounding` needs a `scale`.
+ * Scales run from 0 to 1000.
+ */
+export declare function fixed(value: FixedInput, options?: FixedOptions): Fixed;
+/** The Fixed `value / 10^scale`: `fromScaled(12345, 3)` is 12.345. `value` must be an integer. */
+export declare function fromScaled(value: number | bigint, scale: number): Fixed;
+/** Whether `value` is a Fixed. */
+export declare function isFixed(value: unknown): value is Fixed;
+/** The exact Fixed of a Money amount, at the money's scale: `money('12.34', 'EUR')` → 12.34. */
+export declare function moneyToFixed(money: Money): Fixed;
+export {};
+//# sourceMappingURL=fixed.d.ts.map

package/dist/fixed.d.ts.map

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