@backtest-kit/ui 6.15.0 → 7.0.0

package/README.md

@@ -12,7 +12,9 @@
 
 Interactive dashboard for backtest-kit with signal visualization, candle charts, risk analysis, and notification management. Built with React 18, Material-UI, and Lightweight Charts.
 
-📚 **[Backtest Kit Docs](https://backtest-kit.github.io/documents/example_02_first_backtest.html)** | 🌟 **[GitHub](https://github.com/tripolskypetr/backtest-kit)**
+📚 **[Backtest Kit Docs](https://backtest-kit.github.io/documents/article_07_ai_news_trading_signals.html)** | 🌟 **[GitHub](https://github.com/tripolskypetr/backtest-kit)**
+
+> **New to backtest-kit?** The fastest way to get a real, production-ready setup is to clone the [reference implementation](https://github.com/tripolskypetr/backtest-kit/tree/master/example) — a fully working news-sentiment AI trading system with LLM forecasting, multi-timeframe data, and a documented February 2026 backtest. Start there instead of from scratch.
 
 ## ✨ Features
 

package/build/index.cjs

@@ -111,7 +111,6 @@ const INTERVAL_MINUTES = {
     "6h": 360,
     "8h": 480,
     "1d": 1440,
-    "1w": 10080,
 };
 const STEP_TICKS = {
     "1m": 960,
@@ -125,7 +124,6 @@ const STEP_TICKS = {
     "6h": 960,
     "8h": 960,
     "1d": 960,
-    "1w": 960,
 };
 class ExchangeService {
     constructor() {
@@ -170,6 +168,18 @@ class ExchangeService {
                 exchangeName: dto.exchangeName,
             });
         };
+        this.getRawCandles = async (dto) => {
+            this.loggerService.log("exchangeService getRawCandles", {
+                dto,
+            });
+            const [exchange = null] = await backtestKit.listExchangeSchema();
+            if (exchange === null) {
+                throw new Error("exchangeService getRawCandles no exchange registered");
+            }
+            return await backtestKit.Exchange.getRawCandles(dto.symbol, dto.interval, {
+                exchangeName: exchange.exchangeName,
+            }, dto.limit, dto.sDate, dto.eDate);
+        };
     }
 }
 
@@ -503,6 +513,8 @@ class StatusMockService {
                 positionLevels,
                 positionEntries,
                 positionPartials,
+                _peak: status._peak,
+                _fall: status._fall,
             };
         };
     }
@@ -797,6 +809,10 @@ class NotificationViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.notificationMockService.findByFilter(filterData, limit, offset);
             }
+            if (!backtestKit.Notification.enable.hasValue()) {
+                console.warn("@backtest-kit/ui notificationViewService findByFilter notifications not enabled");
+                return [];
+            }
             const iter = functoolsKit.pickDocuments(limit, offset);
             const filterList = CREATE_FILTER_LIST_FN$1(filterData);
             for (const notification of await this.getList()) {
@@ -818,6 +834,10 @@ class NotificationViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.notificationMockService.getList();
             }
+            if (!backtestKit.Notification.enable.hasValue()) {
+                console.warn("@backtest-kit/ui notificationViewService getList notifications not enabled");
+                return [];
+            }
             const notificationList = [];
             for (const notification of await backtestKit.Notification.getData(false)) {
                 notificationList.push(notification);
@@ -847,16 +867,13 @@ class NotificationViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.notificationMockService.getOne(id);
             }
+            if (!backtestKit.Notification.enable.hasValue()) {
+                console.warn("@backtest-kit/ui notificationViewService getOne notifications not enabled");
+                return null;
+            }
             const notificationList = await this.getList();
             return notificationList.find((item) => item.id === id) ?? null;
         };
-        this.init = functoolsKit.singleshot(async () => {
-            this.loggerService.log("notificationViewService init");
-            if (CC_ENABLE_MOCK) {
-                return;
-            }
-            backtestKit.Notification.enable();
-        });
     }
 }
 
@@ -871,6 +888,10 @@ class StorageViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.storageMockService.findSignalById(signalId);
             }
+            if (!backtestKit.Storage.enable.hasValue()) {
+                console.warn("@backtest-kit/ui storageViewService findSignalById storage not enabled");
+                return null;
+            }
             return await backtestKit.Storage.findSignalById(signalId);
         };
         this.listSignalLive = async () => {
@@ -878,6 +899,10 @@ class StorageViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.storageMockService.listSignalLive();
             }
+            if (!backtestKit.Storage.enable.hasValue()) {
+                console.warn("@backtest-kit/ui storageViewService listSignalLive storage not enabled");
+                return [];
+            }
             const signalList = await backtestKit.Storage.listSignalLive();
             signalList.sort((a, b) => {
                 const aHasTime = "createdAt" in a;
@@ -899,6 +924,10 @@ class StorageViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.storageMockService.listSignalBacktest();
             }
+            if (!backtestKit.Storage.enable.hasValue()) {
+                console.warn("@backtest-kit/ui storageViewService listSignalBacktest storage not enabled");
+                return [];
+            }
             const signalList = await backtestKit.Storage.listSignalBacktest();
             signalList.sort((a, b) => {
                 const aHasTime = "createdAt" in a;
@@ -915,13 +944,6 @@ class StorageViewService {
             });
             return signalList;
         };
-        this.init = functoolsKit.singleshot(async () => {
-            this.loggerService.log("storageViewService init");
-            if (CC_ENABLE_MOCK) {
-                return;
-            }
-            backtestKit.Storage.enable();
-        });
     }
 }
 
@@ -1170,6 +1192,8 @@ class StatusViewService {
                 positionEntries,
                 positionLevels,
                 positionPartials,
+                _peak: pendingSignal._peak,
+                _fall: pendingSignal._fall,
             };
         };
         this.getStatusInfo = async () => {
@@ -1952,6 +1976,40 @@ router$a.post("/api/v1/mock/candles_point", async (req, res) => {
         });
     }
 });
+router$a.post("/api/v1/mock/candles_range", async (req, res) => {
+    try {
+        const request = await micro.json(req);
+        const { symbol, interval, limit, sDate, eDate, requestId, serviceName } = request;
+        const data = await ioc.exchangeService.getRawCandles({
+            symbol,
+            interval,
+            limit,
+            sDate,
+            eDate,
+        });
+        const result = {
+            data,
+            status: "ok",
+            error: "",
+            requestId,
+            serviceName,
+        };
+        ioc.loggerService.log("/api/v1/mock/candles_range ok", {
+            request,
+            result: omit(result, "data"),
+        });
+        return await micro.send(res, 200, result);
+    }
+    catch (error) {
+        ioc.loggerService.log("/api/v1/mock/candles_range error", {
+            error: functoolsKit.errorData(error),
+        });
+        return await micro.send(res, 200, {
+            status: "error",
+            error: functoolsKit.getErrorMessage(error),
+        });
+    }
+});
 // NotificationMockService endpoints
 router$a.post("/api/v1/mock/notification_list", async (req, res) => {
     try {
@@ -2533,6 +2591,40 @@ router$9.post("/api/v1/view/candles_point", async (req, res) => {
         });
     }
 });
+router$9.post("/api/v1/view/candles_range", async (req, res) => {
+    try {
+        const request = await micro.json(req);
+        const { symbol, interval, limit, sDate, eDate, requestId, serviceName } = request;
+        const data = await ioc.exchangeService.getRawCandles({
+            symbol,
+            interval,
+            limit,
+            sDate,
+            eDate,
+        });
+        const result = {
+            data,
+            status: "ok",
+            error: "",
+            requestId,
+            serviceName,
+        };
+        ioc.loggerService.log("/api/v1/view/candles_range ok", {
+            request,
+            result: omit(result, "data"),
+        });
+        return await micro.send(res, 200, result);
+    }
+    catch (error) {
+        ioc.loggerService.log("/api/v1/view/candles_range error", {
+            error: functoolsKit.errorData(error),
+        });
+        return await micro.send(res, 200, {
+            status: "error",
+            error: functoolsKit.getErrorMessage(error),
+        });
+    }
+});
 router$9.post("/api/v1/view/candles_live", async (req, res) => {
     try {
         const request = await micro.json(req);

package/build/index.mjs

@@ -6,7 +6,7 @@ import finalhandler from 'finalhandler';
 import serveHandler from 'serve-handler';
 import os from 'os';
 import { createActivator } from 'di-kit';
-import { alignToInterval, Exchange, Backtest, Live, listExchangeSchema, Notification, Storage, Log, lib, Heat, Strategy, Breakeven, Risk, Partial, HighestProfit, MaxDrawdown, Schedule, Performance, Sync, Walker, StorageLive, StorageBacktest } from 'backtest-kit';
+import { alignToInterval, Exchange, listExchangeSchema, Backtest, Live, Notification, Storage, Log, lib, Heat, Strategy, Breakeven, Risk, Partial, HighestProfit, MaxDrawdown, Schedule, Performance, Sync, Walker, StorageLive, StorageBacktest } from 'backtest-kit';
 import fs, { readdir, readFile } from 'fs/promises';
 import path, { join, dirname } from 'path';
 import mime from 'mime-types';
@@ -108,7 +108,6 @@ const INTERVAL_MINUTES = {
     "6h": 360,
     "8h": 480,
     "1d": 1440,
-    "1w": 10080,
 };
 const STEP_TICKS = {
     "1m": 960,
@@ -122,7 +121,6 @@ const STEP_TICKS = {
     "6h": 960,
     "8h": 960,
     "1d": 960,
-    "1w": 960,
 };
 class ExchangeService {
     constructor() {
@@ -167,6 +165,18 @@ class ExchangeService {
                 exchangeName: dto.exchangeName,
             });
         };
+        this.getRawCandles = async (dto) => {
+            this.loggerService.log("exchangeService getRawCandles", {
+                dto,
+            });
+            const [exchange = null] = await listExchangeSchema();
+            if (exchange === null) {
+                throw new Error("exchangeService getRawCandles no exchange registered");
+            }
+            return await Exchange.getRawCandles(dto.symbol, dto.interval, {
+                exchangeName: exchange.exchangeName,
+            }, dto.limit, dto.sDate, dto.eDate);
+        };
     }
 }
 
@@ -500,6 +510,8 @@ class StatusMockService {
                 positionLevels,
                 positionEntries,
                 positionPartials,
+                _peak: status._peak,
+                _fall: status._fall,
             };
         };
     }
@@ -794,6 +806,10 @@ class NotificationViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.notificationMockService.findByFilter(filterData, limit, offset);
             }
+            if (!Notification.enable.hasValue()) {
+                console.warn("@backtest-kit/ui notificationViewService findByFilter notifications not enabled");
+                return [];
+            }
             const iter = pickDocuments(limit, offset);
             const filterList = CREATE_FILTER_LIST_FN$1(filterData);
             for (const notification of await this.getList()) {
@@ -815,6 +831,10 @@ class NotificationViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.notificationMockService.getList();
             }
+            if (!Notification.enable.hasValue()) {
+                console.warn("@backtest-kit/ui notificationViewService getList notifications not enabled");
+                return [];
+            }
             const notificationList = [];
             for (const notification of await Notification.getData(false)) {
                 notificationList.push(notification);
@@ -844,16 +864,13 @@ class NotificationViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.notificationMockService.getOne(id);
             }
+            if (!Notification.enable.hasValue()) {
+                console.warn("@backtest-kit/ui notificationViewService getOne notifications not enabled");
+                return null;
+            }
             const notificationList = await this.getList();
             return notificationList.find((item) => item.id === id) ?? null;
         };
-        this.init = singleshot(async () => {
-            this.loggerService.log("notificationViewService init");
-            if (CC_ENABLE_MOCK) {
-                return;
-            }
-            Notification.enable();
-        });
     }
 }
 
@@ -868,6 +885,10 @@ class StorageViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.storageMockService.findSignalById(signalId);
             }
+            if (!Storage.enable.hasValue()) {
+                console.warn("@backtest-kit/ui storageViewService findSignalById storage not enabled");
+                return null;
+            }
             return await Storage.findSignalById(signalId);
         };
         this.listSignalLive = async () => {
@@ -875,6 +896,10 @@ class StorageViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.storageMockService.listSignalLive();
             }
+            if (!Storage.enable.hasValue()) {
+                console.warn("@backtest-kit/ui storageViewService listSignalLive storage not enabled");
+                return [];
+            }
             const signalList = await Storage.listSignalLive();
             signalList.sort((a, b) => {
                 const aHasTime = "createdAt" in a;
@@ -896,6 +921,10 @@ class StorageViewService {
             if (CC_ENABLE_MOCK) {
                 return await this.storageMockService.listSignalBacktest();
             }
+            if (!Storage.enable.hasValue()) {
+                console.warn("@backtest-kit/ui storageViewService listSignalBacktest storage not enabled");
+                return [];
+            }
             const signalList = await Storage.listSignalBacktest();
             signalList.sort((a, b) => {
                 const aHasTime = "createdAt" in a;
@@ -912,13 +941,6 @@ class StorageViewService {
             });
             return signalList;
         };
-        this.init = singleshot(async () => {
-            this.loggerService.log("storageViewService init");
-            if (CC_ENABLE_MOCK) {
-                return;
-            }
-            Storage.enable();
-        });
     }
 }
 
@@ -1167,6 +1189,8 @@ class StatusViewService {
                 positionEntries,
                 positionLevels,
                 positionPartials,
+                _peak: pendingSignal._peak,
+                _fall: pendingSignal._fall,
             };
         };
         this.getStatusInfo = async () => {
@@ -1949,6 +1973,40 @@ router$a.post("/api/v1/mock/candles_point", async (req, res) => {
         });
     }
 });
+router$a.post("/api/v1/mock/candles_range", async (req, res) => {
+    try {
+        const request = await micro.json(req);
+        const { symbol, interval, limit, sDate, eDate, requestId, serviceName } = request;
+        const data = await ioc.exchangeService.getRawCandles({
+            symbol,
+            interval,
+            limit,
+            sDate,
+            eDate,
+        });
+        const result = {
+            data,
+            status: "ok",
+            error: "",
+            requestId,
+            serviceName,
+        };
+        ioc.loggerService.log("/api/v1/mock/candles_range ok", {
+            request,
+            result: omit(result, "data"),
+        });
+        return await micro.send(res, 200, result);
+    }
+    catch (error) {
+        ioc.loggerService.log("/api/v1/mock/candles_range error", {
+            error: errorData(error),
+        });
+        return await micro.send(res, 200, {
+            status: "error",
+            error: getErrorMessage(error),
+        });
+    }
+});
 // NotificationMockService endpoints
 router$a.post("/api/v1/mock/notification_list", async (req, res) => {
     try {
@@ -2530,6 +2588,40 @@ router$9.post("/api/v1/view/candles_point", async (req, res) => {
         });
     }
 });
+router$9.post("/api/v1/view/candles_range", async (req, res) => {
+    try {
+        const request = await micro.json(req);
+        const { symbol, interval, limit, sDate, eDate, requestId, serviceName } = request;
+        const data = await ioc.exchangeService.getRawCandles({
+            symbol,
+            interval,
+            limit,
+            sDate,
+            eDate,
+        });
+        const result = {
+            data,
+            status: "ok",
+            error: "",
+            requestId,
+            serviceName,
+        };
+        ioc.loggerService.log("/api/v1/view/candles_range ok", {
+            request,
+            result: omit(result, "data"),
+        });
+        return await micro.send(res, 200, result);
+    }
+    catch (error) {
+        ioc.loggerService.log("/api/v1/view/candles_range error", {
+            error: errorData(error),
+        });
+        return await micro.send(res, 200, {
+            status: "error",
+            error: getErrorMessage(error),
+        });
+    }
+});
 router$9.post("/api/v1/view/candles_live", async (req, res) => {
     try {
         const request = await micro.json(req);