@tradejs/infra 2.0.15 → 2.0.16

package/dist/{chunk-EFCQ7NGN.mjs → chunk-6ZKAUA4Q.mjs}

@@ -507,6 +507,8 @@ var redisKeys = {
   runtimeTrade: (userName, orderId) => `users:${userName}:runtime:trade-records:${orderId}`,
   runtimeTradeBuckets: (userName) => `users:${userName}:runtime:trade-records:days:`,
   runtimeTradeBucket: (userName, dayKey) => `users:${userName}:runtime:trade-records:days:${dayKey}`,
+  runtimeClosedTradeBuckets: (userName) => `users:${userName}:runtime:closed-trade-records:days:`,
+  runtimeClosedTradeBucket: (userName, dayKey) => `users:${userName}:runtime:closed-trade-records:days:${dayKey}`,
   runtimeActiveTrades: (userName) => `users:${userName}:runtime:active-trades:`,
   runtimeActiveTrade: (userName, symbol, scopeId) => scopeId ? `users:${userName}:runtime:active-trades:${scopeId}:${symbol}` : `users:${userName}:runtime:active-trades:${symbol}`,
   aiChatHistory: (userName, symbolKey) => `users:${userName}:ai:chats:${symbolKey}`,

package/dist/redis.d.mts

@@ -75,6 +75,8 @@ declare const redisKeys: {
     runtimeTrade: (userName: string, orderId: string) => string;
     runtimeTradeBuckets: (userName: string) => string;
     runtimeTradeBucket: (userName: string, dayKey: string) => string;
+    runtimeClosedTradeBuckets: (userName: string) => string;
+    runtimeClosedTradeBucket: (userName: string, dayKey: string) => string;
     runtimeActiveTrades: (userName: string) => string;
     runtimeActiveTrade: (userName: string, symbol: string, scopeId?: string) => string;
     aiChatHistory: (userName: string, symbolKey: string) => string;

package/dist/redis.d.ts

@@ -75,6 +75,8 @@ declare const redisKeys: {
     runtimeTrade: (userName: string, orderId: string) => string;
     runtimeTradeBuckets: (userName: string) => string;
     runtimeTradeBucket: (userName: string, dayKey: string) => string;
+    runtimeClosedTradeBuckets: (userName: string) => string;
+    runtimeClosedTradeBucket: (userName: string, dayKey: string) => string;
     runtimeActiveTrades: (userName: string) => string;
     runtimeActiveTrade: (userName: string, symbol: string, scopeId?: string) => string;
     aiChatHistory: (userName: string, symbolKey: string) => string;

package/dist/redis.js

@@ -557,6 +557,8 @@ var redisKeys = {
   runtimeTrade: (userName, orderId) => `users:${userName}:runtime:trade-records:${orderId}`,
   runtimeTradeBuckets: (userName) => `users:${userName}:runtime:trade-records:days:`,
   runtimeTradeBucket: (userName, dayKey) => `users:${userName}:runtime:trade-records:days:${dayKey}`,
+  runtimeClosedTradeBuckets: (userName) => `users:${userName}:runtime:closed-trade-records:days:`,
+  runtimeClosedTradeBucket: (userName, dayKey) => `users:${userName}:runtime:closed-trade-records:days:${dayKey}`,
   runtimeActiveTrades: (userName) => `users:${userName}:runtime:active-trades:`,
   runtimeActiveTrade: (userName, symbol, scopeId) => scopeId ? `users:${userName}:runtime:active-trades:${scopeId}:${symbol}` : `users:${userName}:runtime:active-trades:${symbol}`,
   aiChatHistory: (userName, symbolKey) => `users:${userName}:ai:chats:${symbolKey}`,

package/dist/redis.mjs

@@ -16,7 +16,7 @@ import {
   setData,
   setHashJsonField,
   setHashJsonFields
-} from "./chunk-EFCQ7NGN.mjs";
+} from "./chunk-6ZKAUA4Q.mjs";
 export {
   RedisWriteBlockedError,
   closeRedisConnection,

package/dist/timescale.d.mts

@@ -20,9 +20,25 @@ type CandleRow = {
     takerSellBaseVolume?: number | null;
     takerSellQuoteVolume?: number | null;
 };
+type TimescaleMarketContextSource = 'binance' | 'coinmarketcap' | 'derivatives' | 'hyperliquidWhales';
+type TimescaleMarketContextQueryOptions = {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+declare const configureTimescaleMarketContextSchemaMode: (mode: "ensure" | "verify") => void;
 declare const closeTimescalePool: () => Promise<void>;
 declare const toRows: (provider: string, symbol: string, interval: number, data: KlineChartData) => CandleRow[];
 declare function upsertCandles(rows: CandleRow[]): Promise<void>;
+declare const ensureDerivativesSchema: () => Promise<void>;
+declare const ensureBinanceMarketSchema: () => Promise<void>;
+declare const ensureHyperliquidWhaleSchema: () => Promise<void>;
+/**
+ * CoinMarketCap tables currently share the historical market-context migration
+ * with the Binance tables. Keeping a source-specific entrypoint lets process
+ * composition own schema preparation without exposing that storage detail.
+ */
+declare const ensureCoinMarketCapContextSchema: () => Promise<void>;
+declare const ensureMarketContextSchemas: (sources: Iterable<TimescaleMarketContextSource>) => Promise<void>;
 declare function upsertDerivatives(rows: DerivativesRow[]): Promise<void>;
 declare function getDerivativesRangeForSymbols(symbols: string[], interval: DerivativesInterval, startMs: number, endMs: number): Promise<any[]>;
 declare function getDerivativesDataEdgesForSymbols(symbols: string[], interval: DerivativesInterval): Promise<Map<string, {
@@ -83,6 +99,8 @@ declare function getDerivativesWindow(params: {
     intervals: DerivativesInterval[];
     endMs: number;
     lookbackMs: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<Partial<Record<DerivativesInterval, DerivativesRow[]>>>;
 declare function getDerivativesSummary(hours?: number, limit?: number, symbols?: string[]): Promise<{
     hours: number;
@@ -153,6 +171,8 @@ declare function getLatestMarketTradeFlow(params: {
     interval: MarketFeatureInterval;
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<MarketFeatureAsOf<MarketTradeFlowRow> | null>;
 type HyperliquidWhaleWalletCoverageStatus = 'complete' | 'truncated' | 'failed';
 declare function getHyperliquidWhaleWalletCoverage(params: {
@@ -200,6 +220,8 @@ declare function getHyperliquidWhaleCoverageSeriesRows(params: {
     toMs: number;
     universeFingerprint: string;
     whaleRegistryFingerprint: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<HyperliquidWhaleCoverageSeriesRow[]>;
 type HyperliquidWhaleFlowSeriesRow = {
     ts: Date;
@@ -224,6 +246,8 @@ declare function getHyperliquidWhaleFlowSeriesRows(params: {
     toMs: number;
     universeFingerprint: string;
     whaleRegistryFingerprint: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<HyperliquidWhaleFlowSeriesRow[]>;
 type HyperliquidWhaleFlowAggregate = {
     symbol: string;
@@ -265,6 +289,8 @@ declare function getHyperliquidWhaleFlowAggregate(params: {
     universeFingerprint: string;
     whaleRegistryFingerprint: string;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<HyperliquidWhaleFlowAggregate | null>;
 declare function hasHyperliquidWhaleBackfillCoverage(params: {
     fromMs: number;
@@ -277,11 +303,15 @@ declare function getLatestMarketBreadth(params: {
     interval: MarketFeatureInterval;
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<MarketFeatureAsOf<MarketBreadthRow> | null>;
 declare function getLatestMarketGlobalContext(params: {
     source?: MarketGlobalContextRow['source'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<(MarketFeatureAsOf<MarketGlobalContextRow> & {
     btcDominanceChange24hPct: number | null;
     ethDominanceChange24hPct: number | null;
@@ -314,12 +344,16 @@ declare function getLatestMarketReferenceAssetContexts(params: {
     interval?: MarketReferenceAssetContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<Map<string, MarketFeatureAsOf<MarketReferenceAssetContextRow>>>;
 declare function getLatestMarketCmcExchangeLiquidityContext(params: {
     source?: MarketCmcExchangeLiquidityContextRow['source'];
     interval?: MarketCmcExchangeLiquidityContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<(MarketFeatureAsOf<MarketCmcExchangeLiquidityContextRow> & {
     totalVolumeChange24hPct: number | null;
 }) | null>;
@@ -329,6 +363,8 @@ declare function getLatestMarketCmcIndexContexts(params: {
     interval?: MarketCmcIndexContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<Map<MarketCmcIndexContextRow['indexSlug'], MarketFeatureAsOf<MarketCmcIndexContextRow> & {
     valueChange24hPct: number | null;
 }>>;
@@ -337,6 +373,8 @@ declare function getLatestMarketCmcFearGreedContext(params: {
     interval?: MarketCmcFearGreedContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<(MarketFeatureAsOf<MarketCmcFearGreedContextRow> & {
     valueChange24h: number | null;
     valueChange7d: number | null;
@@ -426,4 +464,4 @@ declare function findContinuityGap(provider: string, symbol: string, interval: n
     diffSeconds: number;
 } | null>;
 
-export { type CandleRow, type DeprecatedMarketContextCleanupItem, type DerivativesMetricCoverageMetric, type HyperliquidWhaleCoverageSeriesRow, type HyperliquidWhaleFlowAggregate, type HyperliquidWhaleFlowSeriesRow, type HyperliquidWhaleWalletCoverageStatus, type MarketFeatureAsOf, applyDerivativesMetricCoverage, cleanupDeprecatedMarketContext, closeTimescalePool, deleteCandles, findContinuityGap, getCandlesRange, getDataEdges, getDataEdgesForSymbols, getDerivativesBackfillCoverage, getDerivativesDataEdgesForSymbols, getDerivativesMetricCoverage, getDerivativesRangeForSymbols, getDerivativesSummary, getDerivativesWindow, getHyperliquidWhaleCoverageSeriesRows, getHyperliquidWhaleFlowAggregate, getHyperliquidWhaleFlowSeriesRows, getHyperliquidWhaleWalletCoverage, getLatestMarketBreadth, getLatestMarketCmcExchangeLiquidityContext, getLatestMarketCmcFearGreedContext, getLatestMarketCmcIndexContexts, getLatestMarketGlobalContext, getLatestMarketReferenceAssetContexts, getLatestMarketTradeFlow, getMarketBreadthCoverage, getMarketCmcExchangeLiquidityContextCoverage, getMarketCmcFearGreedContextCoverage, getMarketCmcIndexContextCoverage, getMarketContextBackfillCoverage, getMarketGlobalContextCoverage, getMarketReferenceAssetContextCoverage, getMarketTradeFlowCoverage, getSpreadRangeForSymbols, getSpreadSummary, hasHyperliquidWhaleBackfillCoverage, rebuildHyperliquidWhaleCoverageRows, rebuildHyperliquidWhaleFlowRows, toRows, upsertCandles, upsertDerivatives, upsertDerivativesBackfillCoverage, upsertHyperliquidWhaleCoverageRows, upsertHyperliquidWhaleFlowRows, upsertHyperliquidWhaleTradeEvents, upsertHyperliquidWhaleWalletCoverage, upsertMarketBreadthRows, upsertMarketCmcExchangeLiquidityContextRows, upsertMarketCmcFearGreedContextRows, upsertMarketCmcIndexContextRows, upsertMarketContextBackfillCoverage, upsertMarketGlobalContextRows, upsertMarketReferenceAssetContextRows, upsertMarketTradeFlowRows, upsertSpreadRows, waitForDbReady };
+export { type CandleRow, type DeprecatedMarketContextCleanupItem, type DerivativesMetricCoverageMetric, type HyperliquidWhaleCoverageSeriesRow, type HyperliquidWhaleFlowAggregate, type HyperliquidWhaleFlowSeriesRow, type HyperliquidWhaleWalletCoverageStatus, type MarketFeatureAsOf, type TimescaleMarketContextQueryOptions, type TimescaleMarketContextSource, applyDerivativesMetricCoverage, cleanupDeprecatedMarketContext, closeTimescalePool, configureTimescaleMarketContextSchemaMode, deleteCandles, ensureBinanceMarketSchema, ensureCoinMarketCapContextSchema, ensureDerivativesSchema, ensureHyperliquidWhaleSchema, ensureMarketContextSchemas, findContinuityGap, getCandlesRange, getDataEdges, getDataEdgesForSymbols, getDerivativesBackfillCoverage, getDerivativesDataEdgesForSymbols, getDerivativesMetricCoverage, getDerivativesRangeForSymbols, getDerivativesSummary, getDerivativesWindow, getHyperliquidWhaleCoverageSeriesRows, getHyperliquidWhaleFlowAggregate, getHyperliquidWhaleFlowSeriesRows, getHyperliquidWhaleWalletCoverage, getLatestMarketBreadth, getLatestMarketCmcExchangeLiquidityContext, getLatestMarketCmcFearGreedContext, getLatestMarketCmcIndexContexts, getLatestMarketGlobalContext, getLatestMarketReferenceAssetContexts, getLatestMarketTradeFlow, getMarketBreadthCoverage, getMarketCmcExchangeLiquidityContextCoverage, getMarketCmcFearGreedContextCoverage, getMarketCmcIndexContextCoverage, getMarketContextBackfillCoverage, getMarketGlobalContextCoverage, getMarketReferenceAssetContextCoverage, getMarketTradeFlowCoverage, getSpreadRangeForSymbols, getSpreadSummary, hasHyperliquidWhaleBackfillCoverage, rebuildHyperliquidWhaleCoverageRows, rebuildHyperliquidWhaleFlowRows, toRows, upsertCandles, upsertDerivatives, upsertDerivativesBackfillCoverage, upsertHyperliquidWhaleCoverageRows, upsertHyperliquidWhaleFlowRows, upsertHyperliquidWhaleTradeEvents, upsertHyperliquidWhaleWalletCoverage, upsertMarketBreadthRows, upsertMarketCmcExchangeLiquidityContextRows, upsertMarketCmcFearGreedContextRows, upsertMarketCmcIndexContextRows, upsertMarketContextBackfillCoverage, upsertMarketGlobalContextRows, upsertMarketReferenceAssetContextRows, upsertMarketTradeFlowRows, upsertSpreadRows, waitForDbReady };

package/dist/timescale.d.ts

@@ -20,9 +20,25 @@ type CandleRow = {
     takerSellBaseVolume?: number | null;
     takerSellQuoteVolume?: number | null;
 };
+type TimescaleMarketContextSource = 'binance' | 'coinmarketcap' | 'derivatives' | 'hyperliquidWhales';
+type TimescaleMarketContextQueryOptions = {
+    signal?: AbortSignal;
+    timeoutMs?: number;
+};
+declare const configureTimescaleMarketContextSchemaMode: (mode: "ensure" | "verify") => void;
 declare const closeTimescalePool: () => Promise<void>;
 declare const toRows: (provider: string, symbol: string, interval: number, data: KlineChartData) => CandleRow[];
 declare function upsertCandles(rows: CandleRow[]): Promise<void>;
+declare const ensureDerivativesSchema: () => Promise<void>;
+declare const ensureBinanceMarketSchema: () => Promise<void>;
+declare const ensureHyperliquidWhaleSchema: () => Promise<void>;
+/**
+ * CoinMarketCap tables currently share the historical market-context migration
+ * with the Binance tables. Keeping a source-specific entrypoint lets process
+ * composition own schema preparation without exposing that storage detail.
+ */
+declare const ensureCoinMarketCapContextSchema: () => Promise<void>;
+declare const ensureMarketContextSchemas: (sources: Iterable<TimescaleMarketContextSource>) => Promise<void>;
 declare function upsertDerivatives(rows: DerivativesRow[]): Promise<void>;
 declare function getDerivativesRangeForSymbols(symbols: string[], interval: DerivativesInterval, startMs: number, endMs: number): Promise<any[]>;
 declare function getDerivativesDataEdgesForSymbols(symbols: string[], interval: DerivativesInterval): Promise<Map<string, {
@@ -83,6 +99,8 @@ declare function getDerivativesWindow(params: {
     intervals: DerivativesInterval[];
     endMs: number;
     lookbackMs: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<Partial<Record<DerivativesInterval, DerivativesRow[]>>>;
 declare function getDerivativesSummary(hours?: number, limit?: number, symbols?: string[]): Promise<{
     hours: number;
@@ -153,6 +171,8 @@ declare function getLatestMarketTradeFlow(params: {
     interval: MarketFeatureInterval;
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<MarketFeatureAsOf<MarketTradeFlowRow> | null>;
 type HyperliquidWhaleWalletCoverageStatus = 'complete' | 'truncated' | 'failed';
 declare function getHyperliquidWhaleWalletCoverage(params: {
@@ -200,6 +220,8 @@ declare function getHyperliquidWhaleCoverageSeriesRows(params: {
     toMs: number;
     universeFingerprint: string;
     whaleRegistryFingerprint: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<HyperliquidWhaleCoverageSeriesRow[]>;
 type HyperliquidWhaleFlowSeriesRow = {
     ts: Date;
@@ -224,6 +246,8 @@ declare function getHyperliquidWhaleFlowSeriesRows(params: {
     toMs: number;
     universeFingerprint: string;
     whaleRegistryFingerprint: string;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<HyperliquidWhaleFlowSeriesRow[]>;
 type HyperliquidWhaleFlowAggregate = {
     symbol: string;
@@ -265,6 +289,8 @@ declare function getHyperliquidWhaleFlowAggregate(params: {
     universeFingerprint: string;
     whaleRegistryFingerprint: string;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<HyperliquidWhaleFlowAggregate | null>;
 declare function hasHyperliquidWhaleBackfillCoverage(params: {
     fromMs: number;
@@ -277,11 +303,15 @@ declare function getLatestMarketBreadth(params: {
     interval: MarketFeatureInterval;
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<MarketFeatureAsOf<MarketBreadthRow> | null>;
 declare function getLatestMarketGlobalContext(params: {
     source?: MarketGlobalContextRow['source'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<(MarketFeatureAsOf<MarketGlobalContextRow> & {
     btcDominanceChange24hPct: number | null;
     ethDominanceChange24hPct: number | null;
@@ -314,12 +344,16 @@ declare function getLatestMarketReferenceAssetContexts(params: {
     interval?: MarketReferenceAssetContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<Map<string, MarketFeatureAsOf<MarketReferenceAssetContextRow>>>;
 declare function getLatestMarketCmcExchangeLiquidityContext(params: {
     source?: MarketCmcExchangeLiquidityContextRow['source'];
     interval?: MarketCmcExchangeLiquidityContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<(MarketFeatureAsOf<MarketCmcExchangeLiquidityContextRow> & {
     totalVolumeChange24hPct: number | null;
 }) | null>;
@@ -329,6 +363,8 @@ declare function getLatestMarketCmcIndexContexts(params: {
     interval?: MarketCmcIndexContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<Map<MarketCmcIndexContextRow['indexSlug'], MarketFeatureAsOf<MarketCmcIndexContextRow> & {
     valueChange24hPct: number | null;
 }>>;
@@ -337,6 +373,8 @@ declare function getLatestMarketCmcFearGreedContext(params: {
     interval?: MarketCmcFearGreedContextRow['interval'];
     atMs: number;
     maxAgeMs?: number;
+    signal?: AbortSignal;
+    timeoutMs?: number;
 }): Promise<(MarketFeatureAsOf<MarketCmcFearGreedContextRow> & {
     valueChange24h: number | null;
     valueChange7d: number | null;
@@ -426,4 +464,4 @@ declare function findContinuityGap(provider: string, symbol: string, interval: n
     diffSeconds: number;
 } | null>;
 
-export { type CandleRow, type DeprecatedMarketContextCleanupItem, type DerivativesMetricCoverageMetric, type HyperliquidWhaleCoverageSeriesRow, type HyperliquidWhaleFlowAggregate, type HyperliquidWhaleFlowSeriesRow, type HyperliquidWhaleWalletCoverageStatus, type MarketFeatureAsOf, applyDerivativesMetricCoverage, cleanupDeprecatedMarketContext, closeTimescalePool, deleteCandles, findContinuityGap, getCandlesRange, getDataEdges, getDataEdgesForSymbols, getDerivativesBackfillCoverage, getDerivativesDataEdgesForSymbols, getDerivativesMetricCoverage, getDerivativesRangeForSymbols, getDerivativesSummary, getDerivativesWindow, getHyperliquidWhaleCoverageSeriesRows, getHyperliquidWhaleFlowAggregate, getHyperliquidWhaleFlowSeriesRows, getHyperliquidWhaleWalletCoverage, getLatestMarketBreadth, getLatestMarketCmcExchangeLiquidityContext, getLatestMarketCmcFearGreedContext, getLatestMarketCmcIndexContexts, getLatestMarketGlobalContext, getLatestMarketReferenceAssetContexts, getLatestMarketTradeFlow, getMarketBreadthCoverage, getMarketCmcExchangeLiquidityContextCoverage, getMarketCmcFearGreedContextCoverage, getMarketCmcIndexContextCoverage, getMarketContextBackfillCoverage, getMarketGlobalContextCoverage, getMarketReferenceAssetContextCoverage, getMarketTradeFlowCoverage, getSpreadRangeForSymbols, getSpreadSummary, hasHyperliquidWhaleBackfillCoverage, rebuildHyperliquidWhaleCoverageRows, rebuildHyperliquidWhaleFlowRows, toRows, upsertCandles, upsertDerivatives, upsertDerivativesBackfillCoverage, upsertHyperliquidWhaleCoverageRows, upsertHyperliquidWhaleFlowRows, upsertHyperliquidWhaleTradeEvents, upsertHyperliquidWhaleWalletCoverage, upsertMarketBreadthRows, upsertMarketCmcExchangeLiquidityContextRows, upsertMarketCmcFearGreedContextRows, upsertMarketCmcIndexContextRows, upsertMarketContextBackfillCoverage, upsertMarketGlobalContextRows, upsertMarketReferenceAssetContextRows, upsertMarketTradeFlowRows, upsertSpreadRows, waitForDbReady };
+export { type CandleRow, type DeprecatedMarketContextCleanupItem, type DerivativesMetricCoverageMetric, type HyperliquidWhaleCoverageSeriesRow, type HyperliquidWhaleFlowAggregate, type HyperliquidWhaleFlowSeriesRow, type HyperliquidWhaleWalletCoverageStatus, type MarketFeatureAsOf, type TimescaleMarketContextQueryOptions, type TimescaleMarketContextSource, applyDerivativesMetricCoverage, cleanupDeprecatedMarketContext, closeTimescalePool, configureTimescaleMarketContextSchemaMode, deleteCandles, ensureBinanceMarketSchema, ensureCoinMarketCapContextSchema, ensureDerivativesSchema, ensureHyperliquidWhaleSchema, ensureMarketContextSchemas, findContinuityGap, getCandlesRange, getDataEdges, getDataEdgesForSymbols, getDerivativesBackfillCoverage, getDerivativesDataEdgesForSymbols, getDerivativesMetricCoverage, getDerivativesRangeForSymbols, getDerivativesSummary, getDerivativesWindow, getHyperliquidWhaleCoverageSeriesRows, getHyperliquidWhaleFlowAggregate, getHyperliquidWhaleFlowSeriesRows, getHyperliquidWhaleWalletCoverage, getLatestMarketBreadth, getLatestMarketCmcExchangeLiquidityContext, getLatestMarketCmcFearGreedContext, getLatestMarketCmcIndexContexts, getLatestMarketGlobalContext, getLatestMarketReferenceAssetContexts, getLatestMarketTradeFlow, getMarketBreadthCoverage, getMarketCmcExchangeLiquidityContextCoverage, getMarketCmcFearGreedContextCoverage, getMarketCmcIndexContextCoverage, getMarketContextBackfillCoverage, getMarketGlobalContextCoverage, getMarketReferenceAssetContextCoverage, getMarketTradeFlowCoverage, getSpreadRangeForSymbols, getSpreadSummary, hasHyperliquidWhaleBackfillCoverage, rebuildHyperliquidWhaleCoverageRows, rebuildHyperliquidWhaleFlowRows, toRows, upsertCandles, upsertDerivatives, upsertDerivativesBackfillCoverage, upsertHyperliquidWhaleCoverageRows, upsertHyperliquidWhaleFlowRows, upsertHyperliquidWhaleTradeEvents, upsertHyperliquidWhaleWalletCoverage, upsertMarketBreadthRows, upsertMarketCmcExchangeLiquidityContextRows, upsertMarketCmcFearGreedContextRows, upsertMarketCmcIndexContextRows, upsertMarketContextBackfillCoverage, upsertMarketGlobalContextRows, upsertMarketReferenceAssetContextRows, upsertMarketTradeFlowRows, upsertSpreadRows, waitForDbReady };

package/dist/timescale.js

@@ -23,7 +23,13 @@ __export(timescale_exports, {
   applyDerivativesMetricCoverage: () => applyDerivativesMetricCoverage,
   cleanupDeprecatedMarketContext: () => cleanupDeprecatedMarketContext,
   closeTimescalePool: () => closeTimescalePool,
+  configureTimescaleMarketContextSchemaMode: () => configureTimescaleMarketContextSchemaMode,
   deleteCandles: () => deleteCandles,
+  ensureBinanceMarketSchema: () => ensureBinanceMarketSchema,
+  ensureCoinMarketCapContextSchema: () => ensureCoinMarketCapContextSchema,
+  ensureDerivativesSchema: () => ensureDerivativesSchema,
+  ensureHyperliquidWhaleSchema: () => ensureHyperliquidWhaleSchema,
+  ensureMarketContextSchemas: () => ensureMarketContextSchemas,
   findContinuityGap: () => findContinuityGap,
   getCandlesRange: () => getCandlesRange,
   getDataEdges: () => getDataEdges,
@@ -114,6 +120,12 @@ var derivativesSchemaReadyPromise = null;
 var spreadSchemaReadyPromise = null;
 var binanceMarketSchemaReadyPromise = null;
 var hyperliquidWhaleSchemaReadyPromise = null;
+var marketContextSchemaMode = "ensure";
+var verifiedMarketContextSchemas = /* @__PURE__ */ new Set();
+var configureTimescaleMarketContextSchemaMode = (mode) => {
+  marketContextSchemaMode = mode;
+  verifiedMarketContextSchemas.clear();
+};
 var closeTimescalePool = async () => {
   const pool = global.__pgPool__;
   if (!pool) {
@@ -130,6 +142,7 @@ var closeTimescalePool = async () => {
   spreadSchemaReadyPromise = null;
   binanceMarketSchemaReadyPromise = null;
   hyperliquidWhaleSchemaReadyPromise = null;
+  verifiedMarketContextSchemas.clear();
   await pool.end();
 };
 var CANDLES_SCHEMA_LOCK_KEY = 61e4;
@@ -138,6 +151,70 @@ var SPREAD_SCHEMA_LOCK_KEY = 610002;
 var BINANCE_MARKET_SCHEMA_LOCK_KEY = 610003;
 var HYPERLIQUID_WHALE_SCHEMA_LOCK_KEY = 610004;
 var PG_SAFE_MAX_BIND_PARAMS = 3e4;
+var resolveMarketContextQueryTimeoutMs = (override) => {
+  if (Number.isFinite(override) && Number(override) > 0) {
+    return Math.floor(Number(override));
+  }
+  const configured = Number(process.env.MARKET_CONTEXT_SQL_TIMEOUT_MS);
+  return Number.isFinite(configured) && configured > 0 ? Math.floor(configured) : 3e4;
+};
+var createMarketContextQueryError = (name, message) => {
+  const error = new Error(message);
+  error.name = name;
+  return error;
+};
+var queryMarketContext = async (text, values, options = {}) => {
+  const pool = getPool();
+  const client = await pool.connect();
+  const timeoutMs = resolveMarketContextQueryTimeoutMs(options.timeoutMs);
+  let released = false;
+  let rejectCancellation;
+  const release = (error) => {
+    if (released) return;
+    released = true;
+    client.release(error);
+  };
+  const cancellation = new Promise((_resolve, reject) => {
+    rejectCancellation = reject;
+  });
+  const cancel = (error) => {
+    release(error);
+    rejectCancellation?.(error);
+  };
+  const onAbort = () => cancel(
+    createMarketContextQueryError(
+      "AbortError",
+      "Timescale market-context query aborted"
+    )
+  );
+  const timer = setTimeout(
+    () => cancel(
+      createMarketContextQueryError(
+        "TimescaleQueryTimeoutError",
+        `Timescale market-context query exceeded ${timeoutMs}ms`
+      )
+    ),
+    timeoutMs
+  );
+  timer.unref?.();
+  options.signal?.addEventListener("abort", onAbort, { once: true });
+  try {
+    if (options.signal?.aborted) {
+      const error = createMarketContextQueryError(
+        "AbortError",
+        "Timescale market-context query aborted"
+      );
+      release(error);
+      throw error;
+    }
+    const query = client.query(text, values);
+    return await Promise.race([query, cancellation]);
+  } finally {
+    clearTimeout(timer);
+    options.signal?.removeEventListener("abort", onAbort);
+    release();
+  }
+};
 var normalizeCandleProvider = (provider) => String(provider || "").trim().toLowerCase();
 var normalizeCandleSymbol = (symbol) => String(symbol || "").trim().toUpperCase();
 var getSafeBulkInsertRows = (columnsCount) => Math.max(1, Math.floor(PG_SAFE_MAX_BIND_PARAMS / columnsCount));
@@ -942,6 +1019,58 @@ var ensureHyperliquidWhaleSchema = async () => {
   });
   await hyperliquidWhaleSchemaReadyPromise;
 };
+var ensureCoinMarketCapContextSchema = async () => ensureBinanceMarketSchema();
+var ensureMarketContextSchema = async (source) => {
+  switch (source) {
+    case "binance":
+      return ensureBinanceMarketSchema();
+    case "coinmarketcap":
+      return ensureCoinMarketCapContextSchema();
+    case "derivatives":
+      return ensureDerivativesSchema();
+    case "hyperliquidWhales":
+      return ensureHyperliquidWhaleSchema();
+  }
+};
+var MARKET_CONTEXT_SCHEMA_TABLES = {
+  binance: ["market_trade_flow", "market_breadth"],
+  coinmarketcap: [
+    "market_global_context",
+    "market_reference_asset_context",
+    "market_cmc_exchange_liquidity_context",
+    "market_cmc_fear_greed_context",
+    "market_cmc_index_context"
+  ],
+  derivatives: ["derivatives_market"],
+  hyperliquidWhales: [
+    "hyperliquid_whale_flow",
+    "hyperliquid_whale_coverage_1m"
+  ]
+};
+var verifyMarketContextSchema = async (source) => {
+  if (verifiedMarketContextSchemas.has(source)) return;
+  const tables = MARKET_CONTEXT_SCHEMA_TABLES[source];
+  const result = await queryMarketContext(
+    `
+      SELECT table_name AS "tableName"
+      FROM unnest($1::text[]) AS requested(table_name)
+      WHERE to_regclass(requested.table_name) IS NULL
+    `,
+    [tables]
+  );
+  if (result.rows.length) {
+    throw new Error(
+      `Timescale ${source} schema is not prepared; missing: ${result.rows.map((row) => row.tableName).filter(Boolean).join(", ")}`
+    );
+  }
+  verifiedMarketContextSchemas.add(source);
+};
+var prepareMarketContextSchemaForRead = async (source) => marketContextSchemaMode === "verify" ? verifyMarketContextSchema(source) : ensureMarketContextSchema(source);
+var ensureMarketContextSchemas = async (sources) => {
+  for (const source of new Set(sources)) {
+    await ensureMarketContextSchema(source);
+  }
+};
 async function upsertDerivatives(rows) {
   if (!rows.length) return;
   await ensureDerivativesSchema();
@@ -1269,9 +1398,8 @@ async function getDerivativesWindow(params) {
   if (!normalizedSymbol || !normalizedIntervals.length) {
     return {};
   }
-  await ensureDerivativesSchema();
+  await prepareMarketContextSchemaForRead("derivatives");
   const startMs = endMs - Math.max(0, lookbackMs);
-  const pool = getPool();
   const sql = `
     SELECT symbol, interval, ts, open_interest, funding_rate, liq_long, liq_short, liq_total, source
     FROM derivatives_market
@@ -1281,12 +1409,11 @@ async function getDerivativesWindow(params) {
       AND ts <= to_timestamp($4/1000.0)
     ORDER BY interval ASC, ts ASC
   `;
-  const res = await pool.query(sql, [
-    normalizedSymbol,
-    normalizedIntervals,
-    startMs,
-    endMs
-  ]);
+  const res = await queryMarketContext(
+    sql,
+    [normalizedSymbol, normalizedIntervals, startMs, endMs],
+    params
+  );
   const rowsByInterval = {};
   for (const row of res.rows) {
     const interval = row.interval;
@@ -2493,9 +2620,8 @@ var toMarketFeatureAge = (rowTs, atMs) => {
   return Number.isFinite(ageMs) ? ageMs : null;
 };
 async function getLatestMarketTradeFlow(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("binance");
+  const res = await queryMarketContext(
     `
       SELECT
         symbol,
@@ -2517,7 +2643,8 @@ async function getLatestMarketTradeFlow(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [params.symbol.toUpperCase(), params.interval, params.atMs]
+    [params.symbol.toUpperCase(), params.interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
@@ -2768,8 +2895,8 @@ async function upsertHyperliquidWhaleCoverageRows(rows) {
   );
 }
 async function getHyperliquidWhaleCoverageSeriesRows(params) {
-  await ensureHyperliquidWhaleSchema();
-  const result = await getPool().query(
+  await prepareMarketContextSchemaForRead("hyperliquidWhales");
+  const result = await queryMarketContext(
     `
       SELECT
         ts,
@@ -2790,7 +2917,8 @@ async function getHyperliquidWhaleCoverageSeriesRows(params) {
       import_types.HYPERLIQUID_WHALE_DATA_MODEL_VERSION,
       params.fromMs,
       params.toMs
-    ]
+    ],
+    params
   );
   return result.rows.map((row) => ({
     ts: new Date(row.ts),
@@ -2800,8 +2928,8 @@ async function getHyperliquidWhaleCoverageSeriesRows(params) {
   }));
 }
 async function getHyperliquidWhaleFlowSeriesRows(params) {
-  await ensureHyperliquidWhaleSchema();
-  const result = await getPool().query(
+  await prepareMarketContextSchemaForRead("hyperliquidWhales");
+  const result = await queryMarketContext(
     `
       SELECT
         ts,
@@ -2834,7 +2962,8 @@ async function getHyperliquidWhaleFlowSeriesRows(params) {
       params.whaleRegistryFingerprint,
       params.fromMs,
       params.toMs
-    ]
+    ],
+    params
   );
   return result.rows.map((row) => ({
     ts: new Date(row.ts),
@@ -2855,10 +2984,10 @@ async function getHyperliquidWhaleFlowSeriesRows(params) {
   }));
 }
 async function getHyperliquidWhaleFlowAggregate(params) {
-  await ensureHyperliquidWhaleSchema();
+  await prepareMarketContextSchemaForRead("hyperliquidWhales");
   const intervalMs = HYPERLIQUID_CONTEXT_INTERVAL_MS[params.interval];
   const expectedBuckets = Math.ceil(intervalMs / 6e4);
-  const res = await getPool().query(
+  const res = await queryMarketContext(
     `
       WITH coverage_rows AS (
         SELECT *
@@ -2973,7 +3102,8 @@ async function getHyperliquidWhaleFlowAggregate(params) {
       params.decisionTimeMs,
       intervalMs,
       import_types.HYPERLIQUID_WHALE_DATA_MODEL_VERSION
-    ]
+    ],
+    params
   );
   const row = res.rows[0];
   if (!row?.as_of_ts || Number(row.coverage_buckets) !== expectedBuckets || Number(row.covered_whales) <= 0) {
@@ -3046,9 +3176,8 @@ async function hasHyperliquidWhaleBackfillCoverage(params) {
   return Number(result.rows[0]?.buckets) === expectedBuckets && Number(result.rows[0]?.complete_buckets) === expectedBuckets;
 }
 async function getLatestMarketBreadth(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("binance");
+  const res = await queryMarketContext(
     `
       SELECT
         universe,
@@ -3087,7 +3216,8 @@ async function getLatestMarketBreadth(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [params.universe, params.interval, params.atMs]
+    [params.universe, params.interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
@@ -3099,10 +3229,9 @@ async function getLatestMarketBreadth(params) {
   };
 }
 async function getLatestMarketGlobalContext(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
+  await prepareMarketContextSchemaForRead("coinmarketcap");
   const source = params.source ?? "coinmarketcap_global";
-  const res = await pool.query(
+  const res = await queryMarketContext(
     `
       SELECT
         source,
@@ -3131,11 +3260,12 @@ async function getLatestMarketGlobalContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, params.atMs]
+    [source, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
-  const previousRes = await pool.query(
+  const previousRes = await queryMarketContext(
     `
       SELECT
         btc_dominance_pct AS "btcDominancePct",
@@ -3148,7 +3278,8 @@ async function getLatestMarketGlobalContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, row.ts]
+    [source, row.ts],
+    params
   );
   const previousDominance = previousRes.rows[0]?.btcDominancePct == null ? null : Number(previousRes.rows[0].btcDominancePct);
   const previousEthDominance = previousRes.rows[0]?.ethDominancePct == null ? null : Number(previousRes.rows[0].ethDominancePct);
@@ -3241,9 +3372,8 @@ async function getLatestMarketReferenceAssetContexts(params) {
   ];
   const rows = /* @__PURE__ */ new Map();
   if (!symbols.length) return rows;
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("coinmarketcap");
+  const res = await queryMarketContext(
     `
       SELECT DISTINCT ON (symbol)
         source,
@@ -3268,7 +3398,8 @@ async function getLatestMarketReferenceAssetContexts(params) {
         END <= to_timestamp($4/1000.0)
       ORDER BY symbol ASC, ts DESC
     `,
-    [source, symbols, interval, params.atMs]
+    [source, symbols, interval, params.atMs],
+    params
   );
   for (const row of res.rows) {
     const ageMs = toMarketFeatureAge(row.ts, params.atMs);
@@ -3281,11 +3412,10 @@ async function getLatestMarketReferenceAssetContexts(params) {
   return rows;
 }
 async function getLatestMarketCmcExchangeLiquidityContext(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
+  await prepareMarketContextSchemaForRead("coinmarketcap");
   const source = params.source ?? "coinmarketcap_exchange_liquidity";
   const interval = params.interval ?? "1d";
-  const res = await pool.query(
+  const res = await queryMarketContext(
     `
       SELECT
         source,
@@ -3308,11 +3438,12 @@ async function getLatestMarketCmcExchangeLiquidityContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, params.atMs]
+    [source, interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
-  const previousRes = await pool.query(
+  const previousRes = await queryMarketContext(
     `
       SELECT total_volume_usd AS "totalVolumeUsd"
       FROM market_cmc_exchange_liquidity_context
@@ -3322,7 +3453,8 @@ async function getLatestMarketCmcExchangeLiquidityContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, row.ts]
+    [source, interval, row.ts],
+    params
   );
   const currentTotal = row.totalVolumeUsd == null ? null : Number(row.totalVolumeUsd);
   const previousTotal = previousRes.rows[0]?.totalVolumeUsd == null ? null : Number(previousRes.rows[0].totalVolumeUsd);
@@ -3346,9 +3478,8 @@ async function getLatestMarketCmcIndexContexts(params) {
   ];
   const rows = /* @__PURE__ */ new Map();
   if (!indexSlugs.length) return rows;
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("coinmarketcap");
+  const res = await queryMarketContext(
     `
       SELECT DISTINCT ON (index_slug)
         source,
@@ -3371,10 +3502,11 @@ async function getLatestMarketCmcIndexContexts(params) {
         END <= to_timestamp($4/1000.0)
       ORDER BY index_slug ASC, ts DESC
     `,
-    [source, indexSlugs, interval, params.atMs]
+    [source, indexSlugs, interval, params.atMs],
+    params
   );
   for (const row of res.rows) {
-    const previousRes = await pool.query(
+    const previousRes = await queryMarketContext(
       `
         SELECT value
         FROM market_cmc_index_context
@@ -3385,7 +3517,8 @@ async function getLatestMarketCmcIndexContexts(params) {
         ORDER BY ts DESC
         LIMIT 1
       `,
-      [source, row.indexSlug, interval, row.ts]
+      [source, row.indexSlug, interval, row.ts],
+      params
     );
     const currentValue = row.value == null ? null : Number(row.value);
     const previousValue = previousRes.rows[0]?.value == null ? null : Number(previousRes.rows[0].value);
@@ -3400,11 +3533,10 @@ async function getLatestMarketCmcIndexContexts(params) {
   return rows;
 }
 async function getLatestMarketCmcFearGreedContext(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
+  await prepareMarketContextSchemaForRead("coinmarketcap");
   const source = params.source ?? "coinmarketcap_fear_greed";
   const interval = params.interval ?? "1d";
-  const res = await pool.query(
+  const res = await queryMarketContext(
     `
       SELECT
         source,
@@ -3424,11 +3556,12 @@ async function getLatestMarketCmcFearGreedContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, params.atMs]
+    [source, interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
-  const previousRes = await pool.query(
+  const previousRes = await queryMarketContext(
     `
       SELECT
         value::int AS value,
@@ -3440,9 +3573,10 @@ async function getLatestMarketCmcFearGreedContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, row.ts]
+    [source, interval, row.ts],
+    params
   );
-  const previous7dRes = await pool.query(
+  const previous7dRes = await queryMarketContext(
     `
       SELECT value::int AS value
       FROM market_cmc_fear_greed_context
@@ -3452,7 +3586,8 @@ async function getLatestMarketCmcFearGreedContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, row.ts]
+    [source, interval, row.ts],
+    params
   );
   const previousValue = previousRes.rows[0]?.value == null ? null : Number(previousRes.rows[0].value);
   const previous7dValue = previous7dRes.rows[0]?.value == null ? null : Number(previous7dRes.rows[0].value);
@@ -3939,7 +4074,13 @@ async function findContinuityGap(provider, symbol, interval) {
   applyDerivativesMetricCoverage,
   cleanupDeprecatedMarketContext,
   closeTimescalePool,
+  configureTimescaleMarketContextSchemaMode,
   deleteCandles,
+  ensureBinanceMarketSchema,
+  ensureCoinMarketCapContextSchema,
+  ensureDerivativesSchema,
+  ensureHyperliquidWhaleSchema,
+  ensureMarketContextSchemas,
   findContinuityGap,
   getCandlesRange,
   getDataEdges,

package/dist/timescale.mjs

@@ -37,6 +37,12 @@ var derivativesSchemaReadyPromise = null;
 var spreadSchemaReadyPromise = null;
 var binanceMarketSchemaReadyPromise = null;
 var hyperliquidWhaleSchemaReadyPromise = null;
+var marketContextSchemaMode = "ensure";
+var verifiedMarketContextSchemas = /* @__PURE__ */ new Set();
+var configureTimescaleMarketContextSchemaMode = (mode) => {
+  marketContextSchemaMode = mode;
+  verifiedMarketContextSchemas.clear();
+};
 var closeTimescalePool = async () => {
   const pool = global.__pgPool__;
   if (!pool) {
@@ -53,6 +59,7 @@ var closeTimescalePool = async () => {
   spreadSchemaReadyPromise = null;
   binanceMarketSchemaReadyPromise = null;
   hyperliquidWhaleSchemaReadyPromise = null;
+  verifiedMarketContextSchemas.clear();
   await pool.end();
 };
 var CANDLES_SCHEMA_LOCK_KEY = 61e4;
@@ -61,6 +68,70 @@ var SPREAD_SCHEMA_LOCK_KEY = 610002;
 var BINANCE_MARKET_SCHEMA_LOCK_KEY = 610003;
 var HYPERLIQUID_WHALE_SCHEMA_LOCK_KEY = 610004;
 var PG_SAFE_MAX_BIND_PARAMS = 3e4;
+var resolveMarketContextQueryTimeoutMs = (override) => {
+  if (Number.isFinite(override) && Number(override) > 0) {
+    return Math.floor(Number(override));
+  }
+  const configured = Number(process.env.MARKET_CONTEXT_SQL_TIMEOUT_MS);
+  return Number.isFinite(configured) && configured > 0 ? Math.floor(configured) : 3e4;
+};
+var createMarketContextQueryError = (name, message) => {
+  const error = new Error(message);
+  error.name = name;
+  return error;
+};
+var queryMarketContext = async (text, values, options = {}) => {
+  const pool = getPool();
+  const client = await pool.connect();
+  const timeoutMs = resolveMarketContextQueryTimeoutMs(options.timeoutMs);
+  let released = false;
+  let rejectCancellation;
+  const release = (error) => {
+    if (released) return;
+    released = true;
+    client.release(error);
+  };
+  const cancellation = new Promise((_resolve, reject) => {
+    rejectCancellation = reject;
+  });
+  const cancel = (error) => {
+    release(error);
+    rejectCancellation?.(error);
+  };
+  const onAbort = () => cancel(
+    createMarketContextQueryError(
+      "AbortError",
+      "Timescale market-context query aborted"
+    )
+  );
+  const timer = setTimeout(
+    () => cancel(
+      createMarketContextQueryError(
+        "TimescaleQueryTimeoutError",
+        `Timescale market-context query exceeded ${timeoutMs}ms`
+      )
+    ),
+    timeoutMs
+  );
+  timer.unref?.();
+  options.signal?.addEventListener("abort", onAbort, { once: true });
+  try {
+    if (options.signal?.aborted) {
+      const error = createMarketContextQueryError(
+        "AbortError",
+        "Timescale market-context query aborted"
+      );
+      release(error);
+      throw error;
+    }
+    const query = client.query(text, values);
+    return await Promise.race([query, cancellation]);
+  } finally {
+    clearTimeout(timer);
+    options.signal?.removeEventListener("abort", onAbort);
+    release();
+  }
+};
 var normalizeCandleProvider = (provider) => String(provider || "").trim().toLowerCase();
 var normalizeCandleSymbol = (symbol) => String(symbol || "").trim().toUpperCase();
 var getSafeBulkInsertRows = (columnsCount) => Math.max(1, Math.floor(PG_SAFE_MAX_BIND_PARAMS / columnsCount));
@@ -865,6 +936,58 @@ var ensureHyperliquidWhaleSchema = async () => {
   });
   await hyperliquidWhaleSchemaReadyPromise;
 };
+var ensureCoinMarketCapContextSchema = async () => ensureBinanceMarketSchema();
+var ensureMarketContextSchema = async (source) => {
+  switch (source) {
+    case "binance":
+      return ensureBinanceMarketSchema();
+    case "coinmarketcap":
+      return ensureCoinMarketCapContextSchema();
+    case "derivatives":
+      return ensureDerivativesSchema();
+    case "hyperliquidWhales":
+      return ensureHyperliquidWhaleSchema();
+  }
+};
+var MARKET_CONTEXT_SCHEMA_TABLES = {
+  binance: ["market_trade_flow", "market_breadth"],
+  coinmarketcap: [
+    "market_global_context",
+    "market_reference_asset_context",
+    "market_cmc_exchange_liquidity_context",
+    "market_cmc_fear_greed_context",
+    "market_cmc_index_context"
+  ],
+  derivatives: ["derivatives_market"],
+  hyperliquidWhales: [
+    "hyperliquid_whale_flow",
+    "hyperliquid_whale_coverage_1m"
+  ]
+};
+var verifyMarketContextSchema = async (source) => {
+  if (verifiedMarketContextSchemas.has(source)) return;
+  const tables = MARKET_CONTEXT_SCHEMA_TABLES[source];
+  const result = await queryMarketContext(
+    `
+      SELECT table_name AS "tableName"
+      FROM unnest($1::text[]) AS requested(table_name)
+      WHERE to_regclass(requested.table_name) IS NULL
+    `,
+    [tables]
+  );
+  if (result.rows.length) {
+    throw new Error(
+      `Timescale ${source} schema is not prepared; missing: ${result.rows.map((row) => row.tableName).filter(Boolean).join(", ")}`
+    );
+  }
+  verifiedMarketContextSchemas.add(source);
+};
+var prepareMarketContextSchemaForRead = async (source) => marketContextSchemaMode === "verify" ? verifyMarketContextSchema(source) : ensureMarketContextSchema(source);
+var ensureMarketContextSchemas = async (sources) => {
+  for (const source of new Set(sources)) {
+    await ensureMarketContextSchema(source);
+  }
+};
 async function upsertDerivatives(rows) {
   if (!rows.length) return;
   await ensureDerivativesSchema();
@@ -1192,9 +1315,8 @@ async function getDerivativesWindow(params) {
   if (!normalizedSymbol || !normalizedIntervals.length) {
     return {};
   }
-  await ensureDerivativesSchema();
+  await prepareMarketContextSchemaForRead("derivatives");
   const startMs = endMs - Math.max(0, lookbackMs);
-  const pool = getPool();
   const sql = `
     SELECT symbol, interval, ts, open_interest, funding_rate, liq_long, liq_short, liq_total, source
     FROM derivatives_market
@@ -1204,12 +1326,11 @@ async function getDerivativesWindow(params) {
       AND ts <= to_timestamp($4/1000.0)
     ORDER BY interval ASC, ts ASC
   `;
-  const res = await pool.query(sql, [
-    normalizedSymbol,
-    normalizedIntervals,
-    startMs,
-    endMs
-  ]);
+  const res = await queryMarketContext(
+    sql,
+    [normalizedSymbol, normalizedIntervals, startMs, endMs],
+    params
+  );
   const rowsByInterval = {};
   for (const row of res.rows) {
     const interval = row.interval;
@@ -2416,9 +2537,8 @@ var toMarketFeatureAge = (rowTs, atMs) => {
   return Number.isFinite(ageMs) ? ageMs : null;
 };
 async function getLatestMarketTradeFlow(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("binance");
+  const res = await queryMarketContext(
     `
       SELECT
         symbol,
@@ -2440,7 +2560,8 @@ async function getLatestMarketTradeFlow(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [params.symbol.toUpperCase(), params.interval, params.atMs]
+    [params.symbol.toUpperCase(), params.interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
@@ -2691,8 +2812,8 @@ async function upsertHyperliquidWhaleCoverageRows(rows) {
   );
 }
 async function getHyperliquidWhaleCoverageSeriesRows(params) {
-  await ensureHyperliquidWhaleSchema();
-  const result = await getPool().query(
+  await prepareMarketContextSchemaForRead("hyperliquidWhales");
+  const result = await queryMarketContext(
     `
       SELECT
         ts,
@@ -2713,7 +2834,8 @@ async function getHyperliquidWhaleCoverageSeriesRows(params) {
       HYPERLIQUID_WHALE_DATA_MODEL_VERSION,
       params.fromMs,
       params.toMs
-    ]
+    ],
+    params
   );
   return result.rows.map((row) => ({
     ts: new Date(row.ts),
@@ -2723,8 +2845,8 @@ async function getHyperliquidWhaleCoverageSeriesRows(params) {
   }));
 }
 async function getHyperliquidWhaleFlowSeriesRows(params) {
-  await ensureHyperliquidWhaleSchema();
-  const result = await getPool().query(
+  await prepareMarketContextSchemaForRead("hyperliquidWhales");
+  const result = await queryMarketContext(
     `
       SELECT
         ts,
@@ -2757,7 +2879,8 @@ async function getHyperliquidWhaleFlowSeriesRows(params) {
       params.whaleRegistryFingerprint,
       params.fromMs,
       params.toMs
-    ]
+    ],
+    params
   );
   return result.rows.map((row) => ({
     ts: new Date(row.ts),
@@ -2778,10 +2901,10 @@ async function getHyperliquidWhaleFlowSeriesRows(params) {
   }));
 }
 async function getHyperliquidWhaleFlowAggregate(params) {
-  await ensureHyperliquidWhaleSchema();
+  await prepareMarketContextSchemaForRead("hyperliquidWhales");
   const intervalMs = HYPERLIQUID_CONTEXT_INTERVAL_MS[params.interval];
   const expectedBuckets = Math.ceil(intervalMs / 6e4);
-  const res = await getPool().query(
+  const res = await queryMarketContext(
     `
       WITH coverage_rows AS (
         SELECT *
@@ -2896,7 +3019,8 @@ async function getHyperliquidWhaleFlowAggregate(params) {
       params.decisionTimeMs,
       intervalMs,
       HYPERLIQUID_WHALE_DATA_MODEL_VERSION
-    ]
+    ],
+    params
   );
   const row = res.rows[0];
   if (!row?.as_of_ts || Number(row.coverage_buckets) !== expectedBuckets || Number(row.covered_whales) <= 0) {
@@ -2969,9 +3093,8 @@ async function hasHyperliquidWhaleBackfillCoverage(params) {
   return Number(result.rows[0]?.buckets) === expectedBuckets && Number(result.rows[0]?.complete_buckets) === expectedBuckets;
 }
 async function getLatestMarketBreadth(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("binance");
+  const res = await queryMarketContext(
     `
       SELECT
         universe,
@@ -3010,7 +3133,8 @@ async function getLatestMarketBreadth(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [params.universe, params.interval, params.atMs]
+    [params.universe, params.interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
@@ -3022,10 +3146,9 @@ async function getLatestMarketBreadth(params) {
   };
 }
 async function getLatestMarketGlobalContext(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
+  await prepareMarketContextSchemaForRead("coinmarketcap");
   const source = params.source ?? "coinmarketcap_global";
-  const res = await pool.query(
+  const res = await queryMarketContext(
     `
       SELECT
         source,
@@ -3054,11 +3177,12 @@ async function getLatestMarketGlobalContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, params.atMs]
+    [source, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
-  const previousRes = await pool.query(
+  const previousRes = await queryMarketContext(
     `
       SELECT
         btc_dominance_pct AS "btcDominancePct",
@@ -3071,7 +3195,8 @@ async function getLatestMarketGlobalContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, row.ts]
+    [source, row.ts],
+    params
   );
   const previousDominance = previousRes.rows[0]?.btcDominancePct == null ? null : Number(previousRes.rows[0].btcDominancePct);
   const previousEthDominance = previousRes.rows[0]?.ethDominancePct == null ? null : Number(previousRes.rows[0].ethDominancePct);
@@ -3164,9 +3289,8 @@ async function getLatestMarketReferenceAssetContexts(params) {
   ];
   const rows = /* @__PURE__ */ new Map();
   if (!symbols.length) return rows;
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("coinmarketcap");
+  const res = await queryMarketContext(
     `
       SELECT DISTINCT ON (symbol)
         source,
@@ -3191,7 +3315,8 @@ async function getLatestMarketReferenceAssetContexts(params) {
         END <= to_timestamp($4/1000.0)
       ORDER BY symbol ASC, ts DESC
     `,
-    [source, symbols, interval, params.atMs]
+    [source, symbols, interval, params.atMs],
+    params
   );
   for (const row of res.rows) {
     const ageMs = toMarketFeatureAge(row.ts, params.atMs);
@@ -3204,11 +3329,10 @@ async function getLatestMarketReferenceAssetContexts(params) {
   return rows;
 }
 async function getLatestMarketCmcExchangeLiquidityContext(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
+  await prepareMarketContextSchemaForRead("coinmarketcap");
   const source = params.source ?? "coinmarketcap_exchange_liquidity";
   const interval = params.interval ?? "1d";
-  const res = await pool.query(
+  const res = await queryMarketContext(
     `
       SELECT
         source,
@@ -3231,11 +3355,12 @@ async function getLatestMarketCmcExchangeLiquidityContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, params.atMs]
+    [source, interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
-  const previousRes = await pool.query(
+  const previousRes = await queryMarketContext(
     `
       SELECT total_volume_usd AS "totalVolumeUsd"
       FROM market_cmc_exchange_liquidity_context
@@ -3245,7 +3370,8 @@ async function getLatestMarketCmcExchangeLiquidityContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, row.ts]
+    [source, interval, row.ts],
+    params
   );
   const currentTotal = row.totalVolumeUsd == null ? null : Number(row.totalVolumeUsd);
   const previousTotal = previousRes.rows[0]?.totalVolumeUsd == null ? null : Number(previousRes.rows[0].totalVolumeUsd);
@@ -3269,9 +3395,8 @@ async function getLatestMarketCmcIndexContexts(params) {
   ];
   const rows = /* @__PURE__ */ new Map();
   if (!indexSlugs.length) return rows;
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
-  const res = await pool.query(
+  await prepareMarketContextSchemaForRead("coinmarketcap");
+  const res = await queryMarketContext(
     `
       SELECT DISTINCT ON (index_slug)
         source,
@@ -3294,10 +3419,11 @@ async function getLatestMarketCmcIndexContexts(params) {
         END <= to_timestamp($4/1000.0)
       ORDER BY index_slug ASC, ts DESC
     `,
-    [source, indexSlugs, interval, params.atMs]
+    [source, indexSlugs, interval, params.atMs],
+    params
   );
   for (const row of res.rows) {
-    const previousRes = await pool.query(
+    const previousRes = await queryMarketContext(
       `
         SELECT value
         FROM market_cmc_index_context
@@ -3308,7 +3434,8 @@ async function getLatestMarketCmcIndexContexts(params) {
         ORDER BY ts DESC
         LIMIT 1
       `,
-      [source, row.indexSlug, interval, row.ts]
+      [source, row.indexSlug, interval, row.ts],
+      params
     );
     const currentValue = row.value == null ? null : Number(row.value);
     const previousValue = previousRes.rows[0]?.value == null ? null : Number(previousRes.rows[0].value);
@@ -3323,11 +3450,10 @@ async function getLatestMarketCmcIndexContexts(params) {
   return rows;
 }
 async function getLatestMarketCmcFearGreedContext(params) {
-  await ensureBinanceMarketSchema();
-  const pool = getPool();
+  await prepareMarketContextSchemaForRead("coinmarketcap");
   const source = params.source ?? "coinmarketcap_fear_greed";
   const interval = params.interval ?? "1d";
-  const res = await pool.query(
+  const res = await queryMarketContext(
     `
       SELECT
         source,
@@ -3347,11 +3473,12 @@ async function getLatestMarketCmcFearGreedContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, params.atMs]
+    [source, interval, params.atMs],
+    params
   );
   const row = res.rows[0];
   if (!row) return null;
-  const previousRes = await pool.query(
+  const previousRes = await queryMarketContext(
     `
       SELECT
         value::int AS value,
@@ -3363,9 +3490,10 @@ async function getLatestMarketCmcFearGreedContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, row.ts]
+    [source, interval, row.ts],
+    params
   );
-  const previous7dRes = await pool.query(
+  const previous7dRes = await queryMarketContext(
     `
       SELECT value::int AS value
       FROM market_cmc_fear_greed_context
@@ -3375,7 +3503,8 @@ async function getLatestMarketCmcFearGreedContext(params) {
       ORDER BY ts DESC
       LIMIT 1
     `,
-    [source, interval, row.ts]
+    [source, interval, row.ts],
+    params
   );
   const previousValue = previousRes.rows[0]?.value == null ? null : Number(previousRes.rows[0].value);
   const previous7dValue = previous7dRes.rows[0]?.value == null ? null : Number(previous7dRes.rows[0].value);
@@ -3861,7 +3990,13 @@ export {
   applyDerivativesMetricCoverage,
   cleanupDeprecatedMarketContext,
   closeTimescalePool,
+  configureTimescaleMarketContextSchemaMode,
   deleteCandles,
+  ensureBinanceMarketSchema,
+  ensureCoinMarketCapContextSchema,
+  ensureDerivativesSchema,
+  ensureHyperliquidWhaleSchema,
+  ensureMarketContextSchemas,
   findContinuityGap,
   getCandlesRange,
   getDataEdges,

package/dist/tradingAccounts.js

@@ -351,6 +351,8 @@ var redisKeys = {
   runtimeTrade: (userName, orderId) => `users:${userName}:runtime:trade-records:${orderId}`,
   runtimeTradeBuckets: (userName) => `users:${userName}:runtime:trade-records:days:`,
   runtimeTradeBucket: (userName, dayKey) => `users:${userName}:runtime:trade-records:days:${dayKey}`,
+  runtimeClosedTradeBuckets: (userName) => `users:${userName}:runtime:closed-trade-records:days:`,
+  runtimeClosedTradeBucket: (userName, dayKey) => `users:${userName}:runtime:closed-trade-records:days:${dayKey}`,
   runtimeActiveTrades: (userName) => `users:${userName}:runtime:active-trades:`,
   runtimeActiveTrade: (userName, symbol, scopeId) => scopeId ? `users:${userName}:runtime:active-trades:${scopeId}:${symbol}` : `users:${userName}:runtime:active-trades:${symbol}`,
   aiChatHistory: (userName, symbolKey) => `users:${userName}:ai:chats:${symbolKey}`,

package/dist/tradingAccounts.mjs

@@ -4,7 +4,7 @@ import {
   getKeys,
   redisKeys,
   setData
-} from "./chunk-EFCQ7NGN.mjs";
+} from "./chunk-6ZKAUA4Q.mjs";
 
 // src/tradingAccounts.ts
 var normalizeId = (value, label) => {

package/dist/userSettings.js

@@ -583,6 +583,8 @@ var redisKeys = {
   runtimeTrade: (userName, orderId) => `users:${userName}:runtime:trade-records:${orderId}`,
   runtimeTradeBuckets: (userName) => `users:${userName}:runtime:trade-records:days:`,
   runtimeTradeBucket: (userName, dayKey) => `users:${userName}:runtime:trade-records:days:${dayKey}`,
+  runtimeClosedTradeBuckets: (userName) => `users:${userName}:runtime:closed-trade-records:days:`,
+  runtimeClosedTradeBucket: (userName, dayKey) => `users:${userName}:runtime:closed-trade-records:days:${dayKey}`,
   runtimeActiveTrades: (userName) => `users:${userName}:runtime:active-trades:`,
   runtimeActiveTrade: (userName, symbol, scopeId) => scopeId ? `users:${userName}:runtime:active-trades:${scopeId}:${symbol}` : `users:${userName}:runtime:active-trades:${symbol}`,
   aiChatHistory: (userName, symbolKey) => `users:${userName}:ai:chats:${symbolKey}`,

package/dist/userSettings.mjs

@@ -2,7 +2,7 @@ import {
   getData,
   redisKeys,
   setData
-} from "./chunk-EFCQ7NGN.mjs";
+} from "./chunk-6ZKAUA4Q.mjs";
 import {
   DEFAULT_AI_RESPONSE_LANGUAGE,
   normalizeAiResponseLanguage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/infra",
-  "version": "2.0.15",
+  "version": "2.0.16",
   "description": "MIT-licensed server infrastructure adapters for TradeJS: Redis, Timescale, ML, logging, and IO.",
   "keywords": [
     "tradejs",
@@ -93,7 +93,7 @@
   "dependencies": {
     "@grpc/grpc-js": "^1.14.4",
     "@grpc/proto-loader": "^0.8.1",
-    "@tradejs/types": "^2.0.15",
+    "@tradejs/types": "^2.0.16",
     "chalk": "4.1.2",
     "ioredis": "5.11.1",
     "pg": "8.22.0",