@openora/core 0.4.1-canary.116 → 0.4.1-canary.119

package/dist/fx/exchange-rate/__tests__/exchange-rate-reader.service.int.test.js

@@ -0,0 +1,221 @@
+import { describe, it, expect, beforeAll, afterAll, beforeEach, vi } from 'vitest';
+import { and, eq, sql } from 'drizzle-orm';
+import { createTestDb } from '@openora/core/testing';
+import { migrate } from '../migrate.js';
+import { exchangeRateQuote } from '../schema/index.js';
+import { ExchangeRateReaderService, } from '../adapters/exchange-rate-reader.service.js';
+import { mock } from '../../../testing/mock.js';
+let db;
+beforeAll(async () => {
+    db = await createTestDb([migrate]);
+});
+afterAll(async () => {
+    await db.drop();
+});
+beforeEach(async () => {
+    await db.drizzle.db.execute(sql `TRUNCATE ${exchangeRateQuote} RESTART IDENTITY CASCADE`);
+});
+/** An ISO timestamp `ageMs` in the past. The reader ages a quote off its provider stamp. */
+function agedIso(ageMs) {
+    return new Date(Date.now() - ageMs).toISOString();
+}
+async function seedQuote(base, quote, rate, opts = {}) {
+    await db.drizzle.db.insert(exchangeRateQuote).values({
+        baseCurrency: base,
+        quoteCurrency: quote,
+        rate,
+        providerAsOf: new Date(opts.asOf ?? agedIso(opts.ageMs ?? 0)),
+        updatedAt: new Date(),
+    });
+}
+async function getRow(base, quote) {
+    const [row] = await db.drizzle.db
+        .select()
+        .from(exchangeRateQuote)
+        .where(and(eq(exchangeRateQuote.baseCurrency, base), eq(exchangeRateQuote.quoteCurrency, quote)));
+    return row ?? null;
+}
+function delayedProvider(rate, delayMs, asOf) {
+    const getRate = vi.fn(() => new Promise((resolve) => {
+        setTimeout(() => resolve({ rate, asOf: asOf ?? new Date().toISOString() }), delayMs);
+    }));
+    return mock({ getRate });
+}
+function baseDeps(over = {}) {
+    return {
+        drizzle: db.drizzle,
+        pivot: 'USD',
+        freshTtlMs: 200,
+        hardMaxAgeMs: 800,
+        providerTimeoutMs: 150,
+        ...over,
+    };
+}
+async function wait(ms) {
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+const SOFT_STALE_AGE_MS = 400;
+const HARD_STALE_AGE_MS = 1_000;
+const PROVIDER_DELAY_PAST_TIMEOUT_MS = 500;
+describe('ExchangeRateReaderService.getRate - identity and cross-pair derivation', () => {
+    it('returns the identity quote for the same currency on both sides without touching the table', async () => {
+        const reader = new ExchangeRateReaderService(baseDeps());
+        const quote = await reader.getRate('EUR', 'EUR');
+        expect(quote).not.toBeNull();
+        expect(quote?.rate).toBe('1.000000000000000000');
+    });
+    it('returns null when nothing is stored for either leg (no provider bound)', async () => {
+        const reader = new ExchangeRateReaderService(baseDeps());
+        expect(await reader.getRate('EUR', 'GBP')).toBeNull();
+    });
+    it('derives a cross rate as from/pivot ÷ to/pivot from fresh stored legs, with no provider call', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000');
+        await seedQuote('GBP', 'USD', '1.250000000000000000');
+        const fiatProvider = delayedProvider('9.000000000000000000', 0);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const quote = await reader.getRate('EUR', 'GBP');
+        expect(quote?.rate).toBe('0.880000000000000000');
+        expect(fiatProvider.getRate).not.toHaveBeenCalled();
+    });
+    it('resolves a currency against the pivot directly using the pivot leg shortcut', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000');
+        const reader = new ExchangeRateReaderService(baseDeps());
+        const quote = await reader.getRate('EUR', 'USD');
+        expect(quote?.rate).toBe('1.100000000000000000');
+    });
+    it('convert() scales an amount by the derived rate', async () => {
+        await seedQuote('EUR', 'USD', '2.000000000000000000');
+        const reader = new ExchangeRateReaderService(baseDeps());
+        expect(await reader.convert('10', 'EUR', 'USD')).toBe('20.000000000000000000');
+    });
+    it('convert() returns null when no rate is available', async () => {
+        const reader = new ExchangeRateReaderService(baseDeps());
+        expect(await reader.convert('10', 'EUR', 'GBP')).toBeNull();
+    });
+});
+describe('ExchangeRateReaderService.getRate - age bands', () => {
+    it('fresh: serves the stored quote with no provider call', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: 10 });
+        const fiatProvider = delayedProvider('9.000000000000000000', 0);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const quote = await reader.getRate('EUR', 'USD');
+        expect(quote?.rate).toBe('1.100000000000000000');
+        expect(fiatProvider.getRate).not.toHaveBeenCalled();
+    });
+    it('soft-stale: returns the cached value immediately and refreshes in the background', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: SOFT_STALE_AGE_MS });
+        const fiatProvider = delayedProvider('1.500000000000000000', 30);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const start = Date.now();
+        const quote = await reader.getRate('EUR', 'USD');
+        const elapsed = Date.now() - start;
+        expect(quote?.rate).toBe('1.100000000000000000');
+        expect(elapsed).toBeLessThan(30);
+        await wait(80);
+        expect(fiatProvider.getRate).toHaveBeenCalledTimes(1);
+        const row = await getRow('EUR', 'USD');
+        expect(row?.rate).toBe('1.500000000000000000');
+    });
+    it('soft-stale: a background refresh timeout is completely invisible to the caller', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: SOFT_STALE_AGE_MS });
+        const fiatProvider = delayedProvider('9.000000000000000000', PROVIDER_DELAY_PAST_TIMEOUT_MS);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const quote = await reader.getRate('EUR', 'USD');
+        expect(quote?.rate).toBe('1.100000000000000000');
+        await wait(200);
+        const row = await getRow('EUR', 'USD');
+        expect(row?.rate).toBe('1.100000000000000000');
+    });
+    it('hard-stale: fetches synchronously, persists, and returns the fresh quote', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: HARD_STALE_AGE_MS });
+        const providerAsOf = agedIso(0);
+        const fiatProvider = delayedProvider('1.300000000000000000', 5, providerAsOf);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const quote = await reader.getRate('EUR', 'USD');
+        expect(quote).toEqual({ rate: '1.300000000000000000', asOf: providerAsOf });
+        expect(fiatProvider.getRate).toHaveBeenCalledTimes(1);
+        const row = await getRow('EUR', 'USD');
+        expect(row?.rate).toBe('1.300000000000000000');
+    });
+    it('hard-stale with no row at all: fetches synchronously and persists a first row', async () => {
+        const fiatProvider = delayedProvider('1.400000000000000000', 5);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const quote = await reader.getRate('EUR', 'USD');
+        expect(quote?.rate).toBe('1.400000000000000000');
+        expect((await getRow('EUR', 'USD'))?.rate).toBe('1.400000000000000000');
+    });
+    it('hard-stale + provider failure (throw) returns null and fails closed, without touching a stored row', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: HARD_STALE_AGE_MS });
+        const fiatProvider = mock({
+            getRate: vi.fn(async () => {
+                throw new Error('vendor unreachable');
+            }),
+        });
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        expect(await reader.getRate('EUR', 'USD')).toBeNull();
+        expect((await getRow('EUR', 'USD'))?.rate).toBe('1.100000000000000000');
+    });
+    it('hard-stale + provider returning null returns null and fails closed', async () => {
+        const fiatProvider = mock({ getRate: vi.fn(async () => null) });
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        expect(await reader.getRate('EUR', 'USD')).toBeNull();
+    });
+    it('hard-stale + no provider bound for the rail returns null and fails closed', async () => {
+        const reader = new ExchangeRateReaderService(baseDeps());
+        expect(await reader.getRate('EUR', 'USD')).toBeNull();
+    });
+    it('hard-stale: a provider call exceeding providerTimeoutMs returns null promptly (does not hang)', async () => {
+        const fiatProvider = delayedProvider('9.000000000000000000', 5_000);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider, providerTimeoutMs: 30 }));
+        const start = Date.now();
+        const quote = await reader.getRate('EUR', 'USD');
+        const elapsed = Date.now() - start;
+        expect(quote).toBeNull();
+        expect(elapsed).toBeLessThan(500);
+    });
+});
+describe('ExchangeRateReaderService.getRate - single-flight', () => {
+    it('collapses concurrent hard-stale callers for the same leg into one provider call', async () => {
+        const providerAsOf = agedIso(0);
+        const fiatProvider = delayedProvider('1.200000000000000000', 40, providerAsOf);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const [a, b, c] = await Promise.all([
+            reader.getRate('EUR', 'USD'),
+            reader.getRate('EUR', 'USD'),
+            reader.getRate('EUR', 'USD'),
+        ]);
+        expect(a).toEqual({ rate: '1.200000000000000000', asOf: providerAsOf });
+        expect(b).toEqual(a);
+        expect(c).toEqual(a);
+        expect(fiatProvider.getRate).toHaveBeenCalledTimes(1);
+    });
+    it('a settled in-flight call is removed from the single-flight map so a later call fetches again', async () => {
+        const fiatProvider = delayedProvider('1.200000000000000000', 5);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider, freshTtlMs: 0, hardMaxAgeMs: 50 }));
+        await reader.getRate('EUR', 'USD');
+        await wait(80);
+        await reader.getRate('EUR', 'USD');
+        expect(fiatProvider.getRate).toHaveBeenCalledTimes(2);
+    });
+});
+describe('ExchangeRateReaderService.getRate - cross-pair freshness', () => {
+    it('a derived pair is only as fresh as its staler leg', async () => {
+        const stalerAsOf = agedIso(SOFT_STALE_AGE_MS);
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: 10 });
+        await seedQuote('GBP', 'USD', '1.250000000000000000', { asOf: stalerAsOf });
+        const fiatProvider = delayedProvider('1.300000000000000000', 30);
+        const reader = new ExchangeRateReaderService(baseDeps({ fiatProvider }));
+        const quote = await reader.getRate('EUR', 'GBP');
+        expect(quote?.rate).toBe('0.880000000000000000');
+        expect(quote?.asOf).toBe(stalerAsOf);
+        // The staler leg refreshes in the background. Let that write land before the next
+        // test truncates, or it lands after the truncate and leaves a fresh GBP/USD row.
+        await vi.waitFor(async () => expect((await getRow('GBP', 'USD'))?.rate).toBe('1.300000000000000000'));
+    });
+    it('returns null when one leg is hard-stale and its fetch fails, even if the other leg is fresh', async () => {
+        await seedQuote('EUR', 'USD', '1.100000000000000000', { ageMs: 10 });
+        const reader = new ExchangeRateReaderService(baseDeps());
+        expect(await reader.getRate('EUR', 'GBP')).toBeNull();
+    });
+});
+//# sourceMappingURL=exchange-rate-reader.service.int.test.js.map

package/dist/fx/exchange-rate/__tests__/exchange-rate-reader.service.int.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-reader.service.int.test.js","sourceRoot":"","sources":["../../../../src/fx/exchange-rate/__tests__/exchange-rate-reader.service.int.test.ts"],"names":[],"mappings":"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"}

package/dist/fx/exchange-rate/__tests__/select-provider.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=select-provider.test.d.ts.map

package/dist/fx/exchange-rate/__tests__/select-provider.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-provider.test.d.ts","sourceRoot":"","sources":["../../../../src/fx/exchange-rate/__tests__/select-provider.test.ts"],"names":[],"mappings":""}

package/dist/fx/exchange-rate/__tests__/select-provider.test.js

@@ -0,0 +1,26 @@
+import { describe, it, expect } from 'vitest';
+import { mock } from '../../../testing/mock.js';
+import { selectProvider } from '../adapters/exchange-rate-reader.service.js';
+const cryptoProvider = mock({});
+const fiatProvider = mock({});
+describe('selectProvider', () => {
+    it('routes a crypto currency to the crypto provider via railFor', () => {
+        expect(selectProvider('BTC', cryptoProvider, fiatProvider)).toBe(cryptoProvider);
+    });
+    it('routes a fiat currency to the fiat provider via railFor', () => {
+        expect(selectProvider('EUR', cryptoProvider, fiatProvider)).toBe(fiatProvider);
+    });
+    it('returns undefined when the rail has no provider bound', () => {
+        expect(selectProvider('BTC', undefined, fiatProvider)).toBeUndefined();
+        expect(selectProvider('EUR', cryptoProvider, undefined)).toBeUndefined();
+    });
+    it('returns undefined when neither provider is bound', () => {
+        expect(selectProvider('BTC', undefined, undefined)).toBeUndefined();
+        expect(selectProvider('EUR', undefined, undefined)).toBeUndefined();
+    });
+    it('respects a custom crypto-currency override list, same as railFor', () => {
+        expect(selectProvider('SOL', cryptoProvider, fiatProvider, ['SOL'])).toBe(cryptoProvider);
+        expect(selectProvider('BTC', cryptoProvider, fiatProvider, ['SOL'])).toBe(fiatProvider);
+    });
+});
+//# sourceMappingURL=select-provider.test.js.map

package/dist/fx/exchange-rate/__tests__/select-provider.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-provider.test.js","sourceRoot":"","sources":["../../../../src/fx/exchange-rate/__tests__/select-provider.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAC;AAE7E,MAAM,cAAc,GAAG,IAAI,CAAuB,EAAE,CAAC,CAAC;AACtD,MAAM,YAAY,GAAG,IAAI,CAAuB,EAAE,CAAC,CAAC;AAEpD,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,6DAA6D,EAAE,GAAG,EAAE;QACrE,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yDAAyD,EAAE,GAAG,EAAE;QACjE,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,uDAAuD,EAAE,GAAG,EAAE;QAC/D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACvE,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IAC3E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,GAAG,EAAE;QAC1D,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;QACpE,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,aAAa,EAAE,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kEAAkE,EAAE,GAAG,EAAE;QAC1E,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;QAC1F,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/fx/exchange-rate/adapters/exchange-rate-reader.service.d.ts

@@ -0,0 +1,59 @@
+import { DrizzleService } from '@openora/core/server';
+import type { ExchangeRateProvider, ExchangeRateQuote, ExchangeRateReader } from '@openora/core/contracts';
+export declare function selectProvider(currency: string, cryptoProvider: ExchangeRateProvider | undefined, fiatProvider: ExchangeRateProvider | undefined, cryptoCurrencies?: readonly string[]): ExchangeRateProvider | undefined;
+export type ExchangeRateReaderServiceDeps = {
+    drizzle: DrizzleService;
+    pivot: string;
+    cryptoProvider?: ExchangeRateProvider;
+    fiatProvider?: ExchangeRateProvider;
+    cryptoCurrencies?: readonly string[];
+    freshTtlMs: number;
+    hardMaxAgeMs: number;
+    providerTimeoutMs: number;
+};
+/**
+ * Read-through cache in front of the two exchange-rate provider ports. A player
+ * request MAY reach a vendor: a hard-stale or missing quote is fetched
+ * synchronously (with a short timeout, failing closed to `null` on error) before
+ * answering. Three age bands off the quote's own provider timestamp
+ * (`exchange_rate_quote.providerAsOf`), never off the local write time - re-persisting
+ * an old quote must not make it look fresh:
+ *   - fresh (age < freshTtlMs): return the stored value, no provider call.
+ *   - soft-stale (freshTtlMs <= age < hardMaxAgeMs): return the stored value
+ *     immediately, kick a single-flight background refresh that is invisible to
+ *     the caller (its failure is logged, never thrown).
+ *   - hard-stale (age >= hardMaxAgeMs) or no row at all: fetch synchronously
+ *     through the same single-flight path; on success persist and return; on
+ *     failure return `null`.
+ * Concurrent callers for the same (currency, pivot) leg share one in-flight
+ * provider call.
+ */
+export declare class ExchangeRateReaderService implements ExchangeRateReader {
+    private readonly drizzle;
+    private readonly pivot;
+    private readonly cryptoProvider?;
+    private readonly fiatProvider?;
+    private readonly cryptoCurrencies?;
+    private readonly freshTtlMs;
+    private readonly hardMaxAgeMs;
+    private readonly providerTimeoutMs;
+    private readonly inFlight;
+    private readonly failedUntil;
+    constructor(deps: ExchangeRateReaderServiceDeps);
+    getRate(from: string, to: string): Promise<ExchangeRateQuote | null>;
+    convert(amount: string, from: string, to: string): Promise<string | null>;
+    private resolveLeg;
+    /** Records a cooldown, evicting expired entries first so the map cannot grow without bound. */
+    private rememberFailure;
+    private readRow;
+    private fetchLeg;
+    private fetchFromProvider;
+    /**
+     * A rate is money arithmetic: a zero, negative, absurd or unparseable one would silently
+     * convert a wager to nothing and walk it past an RG limit, and a timestamp we cannot trust
+     * would age wrong. Refuse before persisting, so the bad value never enters the cache.
+     */
+    private assertUsableQuote;
+    private persist;
+}
+//# sourceMappingURL=exchange-rate-reader.service.d.ts.map

package/dist/fx/exchange-rate/adapters/exchange-rate-reader.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exchange-rate-reader.service.d.ts","sourceRoot":"","sources":["../../../../src/fx/exchange-rate/adapters/exchange-rate-reader.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAA2C,MAAM,sBAAsB,CAAC;AAC/F,OAAO,KAAK,EACV,oBAAoB,EACpB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAcjC,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,oBAAoB,GAAG,SAAS,EAChD,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,GACnC,oBAAoB,GAAG,SAAS,CAElC;AAoBD,MAAM,MAAM,6BAA6B,GAAG;IAC1C,OAAO,EAAE,cAAc,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IACpC,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;CAC3B,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,yBAA0B,YAAW,kBAAkB;IAClE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;IACzC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAuB;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAoB;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiD;IAC1E,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;gBAE7C,IAAI,EAAE,6BAA6B;IAWzC,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAoBpE,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;YAQjE,UAAU;IA4CxB,+FAA+F;IAC/F,OAAO,CAAC,eAAe;YAiBT,OAAO;IAgBrB,OAAO,CAAC,QAAQ;YAgBF,iBAAiB;IAyB/B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;YAmBX,OAAO;CAUtB"}

package/dist/fx/exchange-rate/adapters/exchange-rate-reader.service.js

@@ -0,0 +1,212 @@
+import { moneyDivide, moneyScaleBy, createLogger } from '@openora/core/server';
+import { railFor } from '@openora/core/contracts';
+import { and, eq } from 'drizzle-orm';
+import { exchangeRateQuote } from '../schema/index.js';
+const logger = createLogger('exchange-rate-reader');
+/** Tolerated forward clock skew between the provider's `asOf` and this process. */
+const MAX_PROVIDER_CLOCK_SKEW_MS = 60_000;
+/** Upper bound on a plausible pivot-denominated rate; anything beyond is a provider defect. */
+const MAX_PLAUSIBLE_RATE = 1e12;
+/** Hard cap on the failure-cooldown map, so an unbounded code space cannot grow it. */
+const MAX_FAILURE_ENTRIES = 512;
+export function selectProvider(currency, cryptoProvider, fiatProvider, cryptoCurrencies) {
+    return railFor(currency, cryptoCurrencies) === 'crypto' ? cryptoProvider : fiatProvider;
+}
+function withTimeout(promise, timeoutMs, label) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error(`exchange rate provider timed out fetching ${label}`));
+        }, timeoutMs);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (err) => {
+            clearTimeout(timer);
+            reject(err instanceof Error ? err : new Error(String(err)));
+        });
+    });
+}
+/**
+ * Read-through cache in front of the two exchange-rate provider ports. A player
+ * request MAY reach a vendor: a hard-stale or missing quote is fetched
+ * synchronously (with a short timeout, failing closed to `null` on error) before
+ * answering. Three age bands off the quote's own provider timestamp
+ * (`exchange_rate_quote.providerAsOf`), never off the local write time - re-persisting
+ * an old quote must not make it look fresh:
+ *   - fresh (age < freshTtlMs): return the stored value, no provider call.
+ *   - soft-stale (freshTtlMs <= age < hardMaxAgeMs): return the stored value
+ *     immediately, kick a single-flight background refresh that is invisible to
+ *     the caller (its failure is logged, never thrown).
+ *   - hard-stale (age >= hardMaxAgeMs) or no row at all: fetch synchronously
+ *     through the same single-flight path; on success persist and return; on
+ *     failure return `null`.
+ * Concurrent callers for the same (currency, pivot) leg share one in-flight
+ * provider call.
+ */
+export class ExchangeRateReaderService {
+    drizzle;
+    pivot;
+    cryptoProvider;
+    fiatProvider;
+    cryptoCurrencies;
+    freshTtlMs;
+    hardMaxAgeMs;
+    providerTimeoutMs;
+    inFlight = new Map();
+    failedUntil = new Map();
+    constructor(deps) {
+        this.drizzle = deps.drizzle;
+        this.pivot = deps.pivot.toUpperCase();
+        this.cryptoProvider = deps.cryptoProvider;
+        this.fiatProvider = deps.fiatProvider;
+        this.cryptoCurrencies = deps.cryptoCurrencies;
+        this.freshTtlMs = deps.freshTtlMs;
+        this.hardMaxAgeMs = deps.hardMaxAgeMs;
+        this.providerTimeoutMs = deps.providerTimeoutMs;
+    }
+    async getRate(from, to) {
+        const fromCode = from.toUpperCase();
+        const toCode = to.toUpperCase();
+        if (fromCode === toCode) {
+            return { rate: '1.000000000000000000', asOf: new Date().toISOString() };
+        }
+        const [fromLeg, toLeg] = await Promise.all([
+            this.resolveLeg(fromCode),
+            this.resolveLeg(toCode),
+        ]);
+        if (!fromLeg || !toLeg) {
+            return null;
+        }
+        const rate = moneyDivide(fromLeg.rate, toLeg.rate);
+        const asOf = fromLeg.asOf < toLeg.asOf ? fromLeg.asOf : toLeg.asOf;
+        return { rate, asOf };
+    }
+    async convert(amount, from, to) {
+        const quote = await this.getRate(from, to);
+        if (!quote) {
+            return null;
+        }
+        return moneyScaleBy(amount, quote.rate);
+    }
+    async resolveLeg(currency) {
+        if (currency === this.pivot) {
+            return { rate: '1.000000000000000000', asOf: new Date().toISOString() };
+        }
+        const row = await this.readRow(currency);
+        // A clock ahead of ours only ever makes a quote look newer, never older, so clamp at 0.
+        const ageMs = row
+            ? Math.max(0, Date.now() - row.providerAsOf.getTime())
+            : Number.POSITIVE_INFINITY;
+        if (row && ageMs < this.freshTtlMs) {
+            return { rate: row.rate, asOf: row.providerAsOf.toISOString() };
+        }
+        if (row && ageMs < this.hardMaxAgeMs) {
+            void this.fetchLeg(currency).catch((err) => {
+                logger.warn({ err, currency, pivot: this.pivot }, 'background exchange rate refresh failed');
+            });
+            return { rate: row.rate, asOf: row.providerAsOf.toISOString() };
+        }
+        const cooldownUntil = this.failedUntil.get(currency);
+        if (cooldownUntil !== undefined && Date.now() < cooldownUntil) {
+            return null;
+        }
+        try {
+            const quote = await this.fetchLeg(currency);
+            this.failedUntil.delete(currency);
+            return quote;
+        }
+        catch (err) {
+            this.rememberFailure(currency);
+            logger.error({ err, currency, pivot: this.pivot, hadRow: row !== null }, 'exchange rate hard-stale and unavailable; failing closed');
+            return null;
+        }
+    }
+    /** Records a cooldown, evicting expired entries first so the map cannot grow without bound. */
+    rememberFailure(currency) {
+        const now = Date.now();
+        for (const [key, until] of this.failedUntil) {
+            if (until <= now) {
+                this.failedUntil.delete(key);
+            }
+        }
+        while (this.failedUntil.size >= MAX_FAILURE_ENTRIES) {
+            const [oldest] = this.failedUntil.keys();
+            if (oldest === undefined) {
+                break;
+            }
+            this.failedUntil.delete(oldest);
+        }
+        this.failedUntil.set(currency, now + this.providerTimeoutMs);
+    }
+    async readRow(currency) {
+        const [row] = await this.drizzle.db
+            .select({
+            rate: exchangeRateQuote.rate,
+            providerAsOf: exchangeRateQuote.providerAsOf,
+        })
+            .from(exchangeRateQuote)
+            .where(and(eq(exchangeRateQuote.baseCurrency, currency), eq(exchangeRateQuote.quoteCurrency, this.pivot)));
+        return row ?? null;
+    }
+    fetchLeg(currency) {
+        const key = `${currency}:${this.pivot}`;
+        const existing = this.inFlight.get(key);
+        if (existing) {
+            return existing;
+        }
+        const attempt = this.fetchFromProvider(currency).finally(() => {
+            if (this.inFlight.get(key) === attempt) {
+                this.inFlight.delete(key);
+            }
+        });
+        this.inFlight.set(key, attempt);
+        return attempt;
+    }
+    async fetchFromProvider(currency) {
+        const provider = selectProvider(currency, this.cryptoProvider, this.fiatProvider, this.cryptoCurrencies);
+        if (!provider) {
+            throw new Error(`no exchange rate provider bound for ${currency}/${this.pivot}`);
+        }
+        const quote = await withTimeout(provider.getRate(currency, this.pivot), this.providerTimeoutMs, `${currency}/${this.pivot}`);
+        if (!quote) {
+            throw new Error(`exchange rate provider returned no quote for ${currency}/${this.pivot}`);
+        }
+        this.assertUsableQuote(currency, quote);
+        await this.persist(currency, quote);
+        return quote;
+    }
+    /**
+     * A rate is money arithmetic: a zero, negative, absurd or unparseable one would silently
+     * convert a wager to nothing and walk it past an RG limit, and a timestamp we cannot trust
+     * would age wrong. Refuse before persisting, so the bad value never enters the cache.
+     */
+    assertUsableQuote(currency, quote) {
+        const pair = `${currency}/${this.pivot}`;
+        const rate = Number(quote.rate);
+        if (!Number.isFinite(rate) || rate <= 0 || rate > MAX_PLAUSIBLE_RATE) {
+            throw new Error(`exchange rate provider returned an out-of-range rate for ${pair}`);
+        }
+        const asOf = new Date(quote.asOf).getTime();
+        if (Number.isNaN(asOf)) {
+            throw new Error(`exchange rate provider returned an unparseable timestamp for ${pair}`);
+        }
+        const now = Date.now();
+        if (asOf > now + MAX_PROVIDER_CLOCK_SKEW_MS) {
+            throw new Error(`exchange rate provider returned a future timestamp for ${pair}`);
+        }
+        if (now - asOf >= this.hardMaxAgeMs) {
+            throw new Error(`exchange rate provider returned an already hard-stale quote for ${pair}`);
+        }
+    }
+    async persist(base, value) {
+        const providerAsOf = new Date(value.asOf);
+        await this.drizzle.db
+            .insert(exchangeRateQuote)
+            .values({ baseCurrency: base, quoteCurrency: this.pivot, rate: value.rate, providerAsOf })
+            .onConflictDoUpdate({
+            target: [exchangeRateQuote.baseCurrency, exchangeRateQuote.quoteCurrency],
+            set: { rate: value.rate, providerAsOf, updatedAt: new Date() },
+        });
+    }
+}
+//# sourceMappingURL=exchange-rate-reader.service.js.map

package/dist/fx/exchange-rate/adapters/exchange-rate-reader.service.js.map

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

package/dist/fx/exchange-rate/contract/index.d.ts

@@ -0,0 +1,44 @@
+import * as z from 'zod';
+export declare const ExchangeRateQuoteSchema: z.ZodObject<{
+    rate: z.ZodString;
+    asOf: z.ZodISODateTime;
+}, z.core.$strip>;
+export type ExchangeRateQuoteDto = z.infer<typeof ExchangeRateQuoteSchema>;
+export declare const GetExchangeRateInputSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+}, z.core.$strip>;
+export type GetExchangeRateInput = z.infer<typeof GetExchangeRateInputSchema>;
+export declare const GetExchangeRatesInputSchema: z.ZodObject<{
+    to: z.ZodString;
+    from: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type GetExchangeRatesInput = z.infer<typeof GetExchangeRatesInputSchema>;
+export declare const ExchangeRateBatchEntrySchema: z.ZodObject<{
+    from: z.ZodString;
+    quote: z.ZodNullable<z.ZodObject<{
+        rate: z.ZodString;
+        asOf: z.ZodISODateTime;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ExchangeRateBatchEntry = z.infer<typeof ExchangeRateBatchEntrySchema>;
+export declare const exchangeRateContract: {
+    getRate: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        from: z.ZodString;
+        to: z.ZodString;
+    }, z.core.$strip>, z.ZodNullable<z.ZodObject<{
+        rate: z.ZodString;
+        asOf: z.ZodISODateTime;
+    }, z.core.$strip>>, Record<never, never>, Record<never, never>>;
+    getRates: import("@orpc/contract").ContractProcedureBuilderWithInputOutput<z.ZodObject<{
+        to: z.ZodString;
+        from: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        from: z.ZodString;
+        quote: z.ZodNullable<z.ZodObject<{
+            rate: z.ZodString;
+            asOf: z.ZodISODateTime;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>, Record<never, never>, Record<never, never>>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/fx/exchange-rate/contract/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/fx/exchange-rate/contract/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAQzB,eAAO,MAAM,uBAAuB;;;iBAGlC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE3E,eAAO,MAAM,0BAA0B;;;iBAGrC,CAAC;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC;AAE9E,eAAO,MAAM,2BAA2B;;;iBAGtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAEhF,eAAO,MAAM,4BAA4B;;;;;;iBAGvC,CAAC;AACH,MAAM,MAAM,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,4BAA4B,CAAC,CAAC;AAElF,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAUhC,CAAC"}