@tradejs/node 3.0.0 → 3.1.0

package/dist/runtimeTrades.d.mts

@@ -0,0 +1,31 @@
+import { ClosedPnlRecord, RuntimeTradeRecord, ExchangeEntryRecord, PositionPnlSnapshot } from '@tradejs/types';
+
+type ClosedPnlRecordWithOrderLinkId = ClosedPnlRecord & {
+    direction?: RuntimeTradeRecord['direction'];
+    entryTimestamp?: number;
+    orderLinkId?: string;
+};
+declare const takeExactClosedPnlMatch: ({ exactByOrderLinkId, exactByOrderId, symbolBuckets, orderLinkId, orderId, }: {
+    exactByOrderLinkId: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    exactByOrderId: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    symbolBuckets: Map<string, ClosedPnlRecordWithOrderLinkId[]>;
+    orderLinkId?: string | null;
+    orderId?: string | null;
+}) => ClosedPnlRecordWithOrderLinkId | null;
+declare const takeClosedPnlMatch: ({ exactByOrderLinkId, exactByOrderId, symbolBuckets, trade, }: {
+    exactByOrderLinkId: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    exactByOrderId?: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    symbolBuckets: Map<string, ClosedPnlRecordWithOrderLinkId[]>;
+    trade: RuntimeTradeRecord;
+}) => ClosedPnlRecordWithOrderLinkId | null;
+
+declare const buildExchangeFallbackRuntimeTrades: ({ entryRows, closedPnlRows, openPositions, strategyNames, existingTrades, endTime, }: {
+    entryRows: ExchangeEntryRecord[];
+    closedPnlRows: ClosedPnlRecordWithOrderLinkId[];
+    openPositions: PositionPnlSnapshot[];
+    strategyNames: string[];
+    existingTrades: RuntimeTradeRecord[];
+    endTime: number;
+}) => RuntimeTradeRecord[];
+
+export { type ClosedPnlRecordWithOrderLinkId, buildExchangeFallbackRuntimeTrades, takeClosedPnlMatch, takeExactClosedPnlMatch };

package/dist/runtimeTrades.d.ts

@@ -0,0 +1,31 @@
+import { ClosedPnlRecord, RuntimeTradeRecord, ExchangeEntryRecord, PositionPnlSnapshot } from '@tradejs/types';
+
+type ClosedPnlRecordWithOrderLinkId = ClosedPnlRecord & {
+    direction?: RuntimeTradeRecord['direction'];
+    entryTimestamp?: number;
+    orderLinkId?: string;
+};
+declare const takeExactClosedPnlMatch: ({ exactByOrderLinkId, exactByOrderId, symbolBuckets, orderLinkId, orderId, }: {
+    exactByOrderLinkId: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    exactByOrderId: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    symbolBuckets: Map<string, ClosedPnlRecordWithOrderLinkId[]>;
+    orderLinkId?: string | null;
+    orderId?: string | null;
+}) => ClosedPnlRecordWithOrderLinkId | null;
+declare const takeClosedPnlMatch: ({ exactByOrderLinkId, exactByOrderId, symbolBuckets, trade, }: {
+    exactByOrderLinkId: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    exactByOrderId?: Map<string, ClosedPnlRecordWithOrderLinkId>;
+    symbolBuckets: Map<string, ClosedPnlRecordWithOrderLinkId[]>;
+    trade: RuntimeTradeRecord;
+}) => ClosedPnlRecordWithOrderLinkId | null;
+
+declare const buildExchangeFallbackRuntimeTrades: ({ entryRows, closedPnlRows, openPositions, strategyNames, existingTrades, endTime, }: {
+    entryRows: ExchangeEntryRecord[];
+    closedPnlRows: ClosedPnlRecordWithOrderLinkId[];
+    openPositions: PositionPnlSnapshot[];
+    strategyNames: string[];
+    existingTrades: RuntimeTradeRecord[];
+    endTime: number;
+}) => RuntimeTradeRecord[];
+
+export { type ClosedPnlRecordWithOrderLinkId, buildExchangeFallbackRuntimeTrades, takeClosedPnlMatch, takeExactClosedPnlMatch };

package/dist/runtimeTrades.js

@@ -0,0 +1,321 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/runtimeTrades.ts
+var runtimeTrades_exports = {};
+__export(runtimeTrades_exports, {
+  buildExchangeFallbackRuntimeTrades: () => buildExchangeFallbackRuntimeTrades,
+  takeClosedPnlMatch: () => takeClosedPnlMatch,
+  takeExactClosedPnlMatch: () => takeExactClosedPnlMatch
+});
+module.exports = __toCommonJS(runtimeTrades_exports);
+var import_runtimeTrades = require("@tradejs/core/runtimeTrades");
+
+// src/runtimeTradeReconciliation.ts
+var toNonEmptyString = (value) => typeof value === "string" && value.trim() ? value.trim() : null;
+var removeFromExactMaps = (exactByOrderLinkId, exactByOrderId, row) => {
+  for (const [key, value] of exactByOrderLinkId) {
+    if (value === row) exactByOrderLinkId.delete(key);
+  }
+  for (const [key, value] of exactByOrderId) {
+    if (value === row) exactByOrderId.delete(key);
+  }
+};
+var removeFromSymbolBuckets = (buckets, row) => {
+  const rows = buckets.get(row.symbol);
+  const index = rows?.findIndex((candidate) => candidate === row) ?? -1;
+  if (index >= 0) rows?.splice(index, 1);
+};
+var takeExactClosedPnlMatch = ({
+  exactByOrderLinkId,
+  exactByOrderId,
+  symbolBuckets,
+  orderLinkId,
+  orderId
+}) => {
+  const keys = [
+    [exactByOrderLinkId, orderLinkId],
+    [exactByOrderId, orderId]
+  ];
+  for (const [bucket, key] of keys) {
+    const normalizedKey = toNonEmptyString(key);
+    if (!normalizedKey) continue;
+    const match = bucket.get(normalizedKey);
+    if (!match) continue;
+    removeFromExactMaps(exactByOrderLinkId, exactByOrderId, match);
+    removeFromSymbolBuckets(symbolBuckets, match);
+    return match;
+  }
+  return null;
+};
+var takeClosedPnlMatch = ({
+  exactByOrderLinkId,
+  exactByOrderId = /* @__PURE__ */ new Map(),
+  symbolBuckets,
+  trade
+}) => {
+  const exactMatch = takeExactClosedPnlMatch({
+    exactByOrderLinkId,
+    exactByOrderId,
+    symbolBuckets,
+    orderLinkId: trade.orderId,
+    orderId: trade.orderId
+  });
+  if (exactMatch) return exactMatch;
+  const rows = symbolBuckets.get(trade.symbol);
+  if (!rows?.length) return null;
+  const minimumClosedAt = trade.entryTimestamp - 5 * 6e4;
+  const matchIndex = rows.reduce((bestIndex, row2, index) => {
+    if (!Number.isFinite(row2.closedAt) || row2.closedAt < minimumClosedAt || row2.direction && row2.direction !== trade.direction) {
+      return bestIndex;
+    }
+    if (bestIndex < 0) return index;
+    return row2.closedAt < rows[bestIndex].closedAt ? index : bestIndex;
+  }, -1);
+  if (matchIndex < 0) return null;
+  const [row] = rows.splice(matchIndex, 1);
+  if (row) removeFromExactMaps(exactByOrderLinkId, exactByOrderId, row);
+  return row ?? null;
+};
+
+// src/runtimeTrades.ts
+var toNonEmptyString2 = (value) => typeof value === "string" && value.trim() ? value.trim() : null;
+var roundValue = (value, digits = 2) => {
+  if (!Number.isFinite(value)) return 0;
+  const factor = 10 ** digits;
+  return Math.round(value * factor) / factor;
+};
+var removeExactMatches = (exactByOrderLinkId, exactByOrderId, row) => {
+  if (row.orderLinkId) exactByOrderLinkId.delete(row.orderLinkId);
+  if (row.orderId) exactByOrderId.delete(row.orderId);
+};
+var takeClosedPnlMatchForEntry = ({
+  exactByOrderLinkId,
+  exactByOrderId,
+  symbolBuckets,
+  entry
+}) => {
+  const exactMatch = takeExactClosedPnlMatch({
+    exactByOrderLinkId,
+    exactByOrderId,
+    symbolBuckets,
+    orderLinkId: entry.orderLinkId,
+    orderId: entry.orderId
+  });
+  if (exactMatch) return exactMatch;
+  const rows = symbolBuckets.get(entry.symbol);
+  if (!rows?.length) return null;
+  const minimumClosedAt = entry.entryTimestamp - 5 * 6e4;
+  const matchIndex = rows.reduce((bestIndex, row, index) => {
+    if (!Number.isFinite(row.closedAt) || row.closedAt < minimumClosedAt || row.direction && row.direction !== entry.direction) {
+      return bestIndex;
+    }
+    if (bestIndex < 0) return index;
+    return row.closedAt < rows[bestIndex].closedAt ? index : bestIndex;
+  }, -1);
+  if (matchIndex < 0) return null;
+  const [match] = rows.splice(matchIndex, 1);
+  if (match) removeExactMatches(exactByOrderLinkId, exactByOrderId, match);
+  return match ?? null;
+};
+var aggregateExchangeEntriesByOrder = (entryRows) => {
+  const grouped = /* @__PURE__ */ new Map();
+  entryRows.forEach((entry, index) => {
+    const orderLinkId = toNonEmptyString2(entry.orderLinkId);
+    const orderId = toNonEmptyString2(entry.orderId);
+    const key = orderLinkId || orderId || `${entry.symbol}:${entry.direction}:${entry.entryTimestamp}:${index}`;
+    const existing = grouped.get(key);
+    const hasPrice = Number.isFinite(entry.qty) && typeof entry.entryPrice === "number" && Number.isFinite(entry.entryPrice);
+    if (!existing) {
+      grouped.set(key, {
+        ...entry,
+        qty: Number.isFinite(entry.qty) ? entry.qty : 0,
+        pricingQty: hasPrice ? entry.qty : 0,
+        pricingNotional: hasPrice ? entry.qty * (entry.entryPrice ?? 0) : 0
+      });
+      return;
+    }
+    existing.qty += Number.isFinite(entry.qty) ? entry.qty : 0;
+    existing.entryTimestamp = Math.min(
+      existing.entryTimestamp,
+      entry.entryTimestamp
+    );
+    if (hasPrice) {
+      existing.pricingQty += entry.qty;
+      existing.pricingNotional += entry.qty * (entry.entryPrice ?? 0);
+    }
+  });
+  return [...grouped.values()].map(({ pricingQty, pricingNotional, ...entry }) => ({
+    ...entry,
+    qty: roundValue(entry.qty, 8),
+    entryPrice: pricingQty > 0 ? roundValue(pricingNotional / pricingQty, 8) : null
+  })).sort((left, right) => left.entryTimestamp - right.entryTimestamp);
+};
+var resolveStrategy = ({
+  orderLinkId,
+  orderId,
+  strategyNameByOrderId,
+  strategyNames
+}) => (orderLinkId ? strategyNameByOrderId.get(orderLinkId) : null) ?? (orderId ? strategyNameByOrderId.get(orderId) : null) ?? (0, import_runtimeTrades.resolveStrategyNameByOrderLinkId)({ orderLinkId, strategyNames });
+var buildRiskLevels = (position) => {
+  const takeProfitPrice = position?.takeProfitPrice;
+  const stopLossPrice = position?.stopLossPrice;
+  if ((typeof takeProfitPrice !== "number" || !Number.isFinite(takeProfitPrice)) && (typeof stopLossPrice !== "number" || !Number.isFinite(stopLossPrice))) {
+    return null;
+  }
+  return {
+    ...typeof takeProfitPrice === "number" && Number.isFinite(takeProfitPrice) ? { takeProfitPrice } : {},
+    ...typeof stopLossPrice === "number" && Number.isFinite(stopLossPrice) ? { stopLossPrice } : {}
+  };
+};
+var buildExchangeFallbackRuntimeTrades = ({
+  entryRows,
+  closedPnlRows,
+  openPositions,
+  strategyNames,
+  existingTrades,
+  endTime
+}) => {
+  if (!entryRows.length && !closedPnlRows.length) return [];
+  const strategyNameByOrderId = new Map(
+    existingTrades.filter(
+      (trade) => Boolean(trade.orderId?.trim() && trade.strategy?.trim())
+    ).map((trade) => [trade.orderId, trade.strategy])
+  );
+  const strategyNamesPool = [
+    .../* @__PURE__ */ new Set([
+      ...strategyNames,
+      ...existingTrades.map(({ strategy }) => strategy)
+    ])
+  ];
+  const openPositionBySymbol = new Map(
+    openPositions.map((position) => [position.symbol, position])
+  );
+  const existingOrderIds = new Set(
+    existingTrades.map(({ orderId }) => toNonEmptyString2(orderId)).filter((value) => value != null)
+  );
+  const exactByOrderLinkId = new Map(
+    closedPnlRows.filter((row) => Boolean(row.orderLinkId)).map((row) => [row.orderLinkId, row])
+  );
+  const exactByOrderId = new Map(
+    closedPnlRows.filter((row) => Boolean(row.orderId)).map((row) => [row.orderId, row])
+  );
+  const symbolBuckets = /* @__PURE__ */ new Map();
+  for (const row of closedPnlRows) {
+    const bucket = symbolBuckets.get(row.symbol) ?? [];
+    bucket.push(row);
+    symbolBuckets.set(row.symbol, bucket);
+  }
+  const fallbackTrades = aggregateExchangeEntriesByOrder(entryRows).map((entry) => {
+    const orderLinkId = toNonEmptyString2(entry.orderLinkId);
+    const orderId = toNonEmptyString2(entry.orderId);
+    const runtimeOrderId = orderLinkId ?? orderId;
+    if (!runtimeOrderId || existingOrderIds.has(runtimeOrderId)) return null;
+    const strategy = resolveStrategy({
+      orderLinkId,
+      orderId,
+      strategyNameByOrderId,
+      strategyNames: strategyNamesPool
+    });
+    if (!strategy) return null;
+    const closed = takeClosedPnlMatchForEntry({
+      exactByOrderLinkId,
+      exactByOrderId,
+      symbolBuckets,
+      entry
+    });
+    const position = openPositionBySymbol.get(entry.symbol);
+    const isActive = !closed && position?.direction === entry.direction && Number.isFinite(position.currentPrice) && Number.isFinite(position.unrealizedPnl);
+    const entryPrice = typeof entry.entryPrice === "number" && Number.isFinite(entry.entryPrice) ? entry.entryPrice : typeof closed?.entryPrice === "number" && Number.isFinite(closed.entryPrice) ? closed.entryPrice : null;
+    if (entryPrice == null) return null;
+    return {
+      orderId: runtimeOrderId,
+      strategy,
+      symbol: entry.symbol,
+      direction: entry.direction,
+      qty: entry.qty,
+      entryPrice,
+      actualEntryPrice: closed?.entryPrice ?? entry.entryPrice ?? null,
+      entryTimestamp: entry.entryTimestamp,
+      status: isActive ? "active" : "closed",
+      currentPrice: isActive ? position?.currentPrice ?? null : closed?.exitPrice ?? null,
+      currentPnl: isActive ? position?.unrealizedPnl ?? null : closed?.closedPnl ?? null,
+      closedPnl: isActive ? null : closed?.closedPnl ?? null,
+      exitPrice: isActive ? null : closed?.exitPrice ?? null,
+      actualExitPrice: isActive ? null : closed?.exitPrice ?? null,
+      exitTimestamp: isActive ? null : closed?.closedAt ?? null,
+      aiAnalysis: isActive ? buildRiskLevels(position) : null,
+      openFee: closed?.openFee ?? entry.openFee ?? null,
+      closeFee: closed?.closeFee ?? entry.closeFee ?? null,
+      fundingFee: closed?.fundingFee ?? entry.fundingFee ?? null,
+      totalFee: closed?.totalFee ?? entry.totalFee ?? null,
+      lastSyncedAt: endTime
+    };
+  }).filter((trade) => trade != null);
+  const usedOrderIds = /* @__PURE__ */ new Set([
+    ...existingOrderIds,
+    ...fallbackTrades.map(({ orderId }) => orderId)
+  ]);
+  const remainingClosedTrades = [...symbolBuckets.values()].flat().map((row) => {
+    const orderLinkId = toNonEmptyString2(row.orderLinkId);
+    const orderId = toNonEmptyString2(row.orderId);
+    const runtimeOrderId = orderLinkId ?? orderId;
+    if (!runtimeOrderId || usedOrderIds.has(runtimeOrderId)) return null;
+    const strategy = resolveStrategy({
+      orderLinkId,
+      orderId,
+      strategyNameByOrderId,
+      strategyNames: strategyNamesPool
+    });
+    if (!strategy || row.entryPrice == null || !Number.isFinite(row.entryPrice) || !row.direction) {
+      return null;
+    }
+    return {
+      orderId: runtimeOrderId,
+      strategy,
+      symbol: row.symbol,
+      direction: row.direction,
+      qty: row.qty,
+      entryPrice: row.entryPrice,
+      actualEntryPrice: row.entryPrice,
+      entryTimestamp: typeof row.entryTimestamp === "number" && Number.isFinite(row.entryTimestamp) ? row.entryTimestamp : row.closedAt,
+      status: "closed",
+      currentPrice: row.exitPrice,
+      currentPnl: row.closedPnl,
+      closedPnl: row.closedPnl,
+      exitPrice: row.exitPrice,
+      actualExitPrice: row.exitPrice,
+      exitTimestamp: row.closedAt,
+      openFee: row.openFee ?? null,
+      closeFee: row.closeFee ?? null,
+      fundingFee: row.fundingFee ?? null,
+      totalFee: row.totalFee ?? null,
+      lastSyncedAt: endTime
+    };
+  }).filter((trade) => trade != null);
+  return [...fallbackTrades, ...remainingClosedTrades].sort(
+    (left, right) => left.entryTimestamp - right.entryTimestamp
+  );
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  buildExchangeFallbackRuntimeTrades,
+  takeClosedPnlMatch,
+  takeExactClosedPnlMatch
+});

package/dist/runtimeTrades.mjs

@@ -0,0 +1,11 @@
+import {
+  buildExchangeFallbackRuntimeTrades,
+  takeClosedPnlMatch,
+  takeExactClosedPnlMatch
+} from "./chunk-FB5NUEOQ.mjs";
+import "./chunk-Y6FXYEAI.mjs";
+export {
+  buildExchangeFallbackRuntimeTrades,
+  takeClosedPnlMatch,
+  takeExactClosedPnlMatch
+};

package/dist/strategies.d.mts

@@ -1,6 +1,6 @@
 export * from '@tradejs/core/strategies';
-export { DEFAULT_AI_MODEL, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep } from './ai.mjs';
-export { ensureIndicatorPluginsLoaded, ensureStrategyPluginsLoaded, getAvailableStrategyNames, getRegisteredManifests, getRegisteredStrategies, getStrategyCreator, getStrategyManifest, isKnownStrategy, registerStrategyEntries, resetStrategyRegistryCache, strategies } from './registry.mjs';
+export { AiChatMessage, DEFAULT_AI_MODEL, InvokeAiChatOptions, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, invokeAiChat, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep } from './ai.mjs';
+export { ensureIndicatorPluginsLoaded, ensureStrategyPluginsLoaded, getAvailableStrategyNames, getRegisteredManifests, getRegisteredStrategies, getStrategyCreator, getStrategyDefaults, getStrategyManifest, isKnownStrategy, registerStrategyEntries, resetStrategyRegistryCache, strategies } from './registry.mjs';
 import { StrategyConfig, CreateStrategyCore, StrategyManifest, StrategyCreator, RuntimeStrategyConfigSnapshot, Signal, Direction, StrategyRuntimeMlOptions, StrategyRuntimeAiOptions, Connector, Tp, MarketFeatureInterval, StrategyEntrySignalContext } from '@tradejs/types';
 import { TradejsConfigOnBarHook, TradejsConfigBeforeSignalsHook } from '@tradejs/core/config';
 

package/dist/strategies.d.ts

@@ -1,6 +1,6 @@
 export * from '@tradejs/core/strategies';
-export { DEFAULT_AI_MODEL, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep } from './ai.js';
-export { ensureIndicatorPluginsLoaded, ensureStrategyPluginsLoaded, getAvailableStrategyNames, getRegisteredManifests, getRegisteredStrategies, getStrategyCreator, getStrategyManifest, isKnownStrategy, registerStrategyEntries, resetStrategyRegistryCache, strategies } from './registry.js';
+export { AiChatMessage, DEFAULT_AI_MODEL, InvokeAiChatOptions, MAX_AI_SERIES_POINTS, askAI, buildAiHumanPrompt, buildAiPayload, buildAiPrompts, buildAiSystemPrompt, buildCompactAiIndicatorsSnapshot, getDeterministicAiGateContext, getOpenRouterModelKwargs, invokeAiChat, resetAiRuntimeCache, runAiPrompt, runAiPromptLocal, trimSeriesDeep } from './ai.js';
+export { ensureIndicatorPluginsLoaded, ensureStrategyPluginsLoaded, getAvailableStrategyNames, getRegisteredManifests, getRegisteredStrategies, getStrategyCreator, getStrategyDefaults, getStrategyManifest, isKnownStrategy, registerStrategyEntries, resetStrategyRegistryCache, strategies } from './registry.js';
 import { StrategyConfig, CreateStrategyCore, StrategyManifest, StrategyCreator, RuntimeStrategyConfigSnapshot, Signal, Direction, StrategyRuntimeMlOptions, StrategyRuntimeAiOptions, Connector, Tp, MarketFeatureInterval, StrategyEntrySignalContext } from '@tradejs/types';
 import { TradejsConfigOnBarHook, TradejsConfigBeforeSignalsHook } from '@tradejs/core/config';