@backtest-kit/cli 13.4.0 → 13.5.0

package/README.md

@@ -954,7 +954,27 @@ export default {
 };
 ```
 
-**How it works:** when strategy code calls `require("ccxt")`, the loader checks `IMPORT_ALIAS` first. If a key matches, the mapped value is returned instead of the real module — no monkey-patching of `node_modules` needed.
+Alias config may export an **async factory** instead of a plain mapping. The CLI `await`s it before any strategy code runs, so you can resolve ESM modules dynamically and hand the live bindings to the alias table:
+
+```ts
+// config/alias.config.ts — async factory (default export)
+export default async () => ({
+  // `nanoid` is ESM-only — `require("nanoid")` would throw,
+  // so pull it in with a dynamic import and alias it.
+  nanoid: await import("nanoid"),
+});
+```
+
+```ts
+// config/alias.config.ts — async factory (named `loader` export)
+export const loader = async () => ({
+  "p-limit": await import("p-limit"),
+});
+```
+
+Both export styles are supported — `export default` and `export const loader` — but **never both at once**; if both are present the `default` export wins. The factory must resolve to the same `{ moduleName: replacement }` shape as the object form. The CLI awaits it before loading the first strategy module, so strategy code keeps calling a plain `require("nanoid")` and transparently gets the ESM binding.
+
+When strategy code calls `require("ccxt")`, the loader checks `IMPORT_ALIAS` first. If a key matches, the mapped value is returned instead of the real module — no monkey-patching of `node_modules` needed.
 
 **Important:** It is **not** per-strategy — it applies to all modules loaded in the current process.
 

package/build/index.cjs

@@ -10,7 +10,6 @@ var fs$1 = require('fs/promises');
 var dotenv = require('dotenv');
 var diKit = require('di-kit');
 var url = require('url');
-var ccxt = require('ccxt');
 var util = require('util');
 var child_process = require('child_process');
 var BacktestKitUi = require('@backtest-kit/ui');
@@ -440,7 +439,7 @@ class ResolveService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            this.loaderService.import(absolutePath, moduleRoot);
+            await this.loaderService.import(absolutePath, moduleRoot);
         };
         this.attachJavascript = async (jsPath) => {
             this.loggerService.log("resolveService attachJavascript", {
@@ -458,7 +457,7 @@ class ResolveService {
                 cwd !== moduleRoot && Setup.update();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                 dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
-                this.loaderService.import(absolutePath);
+                await this.loaderService.import(absolutePath);
             }
             _is_launched = true;
             return absolutePath;
@@ -475,7 +474,7 @@ class ResolveService {
             await fs$1.access(absolutePath, fs.constants.F_OK | fs.constants.R_OK);
             dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             {
-                this.loaderService.import(absolutePath);
+                await this.loaderService.import(absolutePath);
             }
             _is_launched = true;
             return absolutePath;
@@ -484,6 +483,7 @@ class ResolveService {
 }
 
 const getExchange = functoolsKit.singleshot(async () => {
+    const ccxt = await import('ccxt');
     const exchange = new ccxt.binance({
         options: {
             defaultType: "spot",
@@ -2748,7 +2748,7 @@ const LOAD_MODULE_MODULE_FN = async (fileName, self) => {
     for (const { filePath, baseDir } of GET_MODULE_VARIANTS_FN(fileName, self)) {
         try {
             if (await self.loaderService.check(filePath, baseDir)) {
-                self.loaderService.import(filePath, baseDir);
+                await self.loaderService.import(filePath, baseDir);
                 return true;
             }
         }
@@ -3123,12 +3123,23 @@ const GET_ALIAS_VARIANTS_FN = (self) => {
     });
     return result;
 };
+const ESM_IMPORT_FN = functoolsKit.trycatch(async (name) => {
+    const alias = await import(name);
+    {
+        overrideModule(name, alias);
+        Object.assign(IMPORT_ALIAS, { [name]: alias });
+    }
+}, {
+    fallback: (error, name) => {
+        console.error(`Import failed for ${name}`, error);
+    }
+});
 const GET_ALIAS_EXPORTS_FN = (self) => {
     for (const { filePath, baseDir } of GET_ALIAS_VARIANTS_FN(self)) {
         if (!fs.existsSync(filePath)) {
             continue;
         }
-        const instance = self.getInstance(baseDir);
+        const instance = self._getInstance(baseDir);
         const alias = instance.import(filePath);
         if (!alias) {
             return null;
@@ -3140,17 +3151,38 @@ const GET_ALIAS_EXPORTS_FN = (self) => {
     }
     return null;
 };
-const INIT_ALIAS_FN = functoolsKit.singleshot((self) => {
+const INIT_ALIAS_FN = functoolsKit.singleshot(async (self) => {
+    {
+        await ESM_IMPORT_FN("ccxt");
+        await ESM_IMPORT_FN("pinets");
+    }
     const alias = GET_ALIAS_EXPORTS_FN(self);
     if (!alias) {
         return;
     }
-    if (!functoolsKit.isObject(alias)) {
+    let moduleMap;
+    try {
+        if (functoolsKit.isObject(alias)) {
+            moduleMap = alias;
+        }
+        else if (typeof alias === "function") {
+            moduleMap = await alias();
+        }
+        else if (typeof alias?.loader === "function") {
+            moduleMap = await alias.loader();
+        }
+    }
+    catch (error) {
+        console.error("Alias loader failed", error);
+        kill(-1);
+        return;
+    }
+    if (!functoolsKit.isObject(moduleMap)) {
         return;
     }
     {
-        Object.entries(alias).forEach(([name, module]) => overrideModule(name, module));
-        Object.assign(IMPORT_ALIAS, alias);
+        Object.entries(moduleMap).forEach(([name, module]) => overrideModule(name, module));
+        Object.assign(IMPORT_ALIAS, moduleMap);
     }
 });
 class LoaderService {
@@ -3158,8 +3190,7 @@ class LoaderService {
         this.babelService = inject(TYPES.babelService);
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
-        this.getInstance = functoolsKit.memoize(([basePath]) => `${basePath}`, (basePath) => {
-            INIT_ALIAS_FN(this);
+        this._getInstance = functoolsKit.memoize(([basePath]) => `${basePath}`, (basePath) => {
             return new ClientLoader({
                 babel: this.babelService,
                 logger: this.loggerService,
@@ -3167,12 +3198,13 @@ class LoaderService {
                 path: basePath,
             });
         });
-        this.import = (filePath, basePath = process.cwd()) => {
+        this.import = async (filePath, basePath = process.cwd()) => {
             this.loggerService.log("loaderService import", {
                 filePath,
                 basePath,
             });
-            const instance = this.getInstance(basePath);
+            const instance = this._getInstance(basePath);
+            await INIT_ALIAS_FN(this);
             return instance.import(filePath);
         };
         this.check = async (filePath, basePath = process.cwd()) => {
@@ -3180,7 +3212,8 @@ class LoaderService {
                 filePath,
                 basePath,
             });
-            const instance = this.getInstance(basePath);
+            const instance = this._getInstance(basePath);
+            await INIT_ALIAS_FN(this);
             return instance.check(filePath);
         };
     }
@@ -3206,7 +3239,7 @@ const LOAD_CONFIG_CONFIG_FN = async (fileName, self) => {
     for (const { filePath, baseDir } of GET_CONFIG_VARIANTS_FN(fileName, self)) {
         try {
             if (await self.loaderService.check(filePath, baseDir)) {
-                return self.loaderService.import(filePath, baseDir);
+                return await self.loaderService.import(filePath, baseDir);
             }
         }
         catch {
@@ -3397,7 +3430,7 @@ const main$h = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"13.4.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"13.5.0"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
@@ -4703,7 +4736,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"13.4.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"13.5.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -4717,7 +4750,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"13.4.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"13.5.0"}\n`);
     process.exit(0);
 };
 main();

package/build/index.mjs

@@ -9,7 +9,6 @@ import fs$1, { access, readFile, mkdir, writeFile, rm, readdir, copyFile } from
 import dotenv from 'dotenv';
 import { createActivator } from 'di-kit';
 import { fileURLToPath } from 'url';
-import ccxt from 'ccxt';
 import { parseArgs } from 'util';
 import { exec, spawn } from 'child_process';
 import * as BacktestKitUi from '@backtest-kit/ui';
@@ -415,7 +414,7 @@ class ResolveService {
                 const cwd = process.cwd();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             }
-            this.loaderService.import(absolutePath, moduleRoot);
+            await this.loaderService.import(absolutePath, moduleRoot);
         };
         this.attachJavascript = async (jsPath) => {
             this.loggerService.log("resolveService attachJavascript", {
@@ -433,7 +432,7 @@ class ResolveService {
                 cwd !== moduleRoot && Setup.update();
                 dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
                 dotenv.config({ path: path.join(moduleRoot, '.env'), override: true, quiet: true });
-                this.loaderService.import(absolutePath);
+                await this.loaderService.import(absolutePath);
             }
             _is_launched = true;
             return absolutePath;
@@ -450,7 +449,7 @@ class ResolveService {
             await access(absolutePath, constants.F_OK | constants.R_OK);
             dotenv.config({ path: path.join(cwd, '.env'), override: true, quiet: true });
             {
-                this.loaderService.import(absolutePath);
+                await this.loaderService.import(absolutePath);
             }
             _is_launched = true;
             return absolutePath;
@@ -459,6 +458,7 @@ class ResolveService {
 }
 
 const getExchange = singleshot(async () => {
+    const ccxt = await import('ccxt');
     const exchange = new ccxt.binance({
         options: {
             defaultType: "spot",
@@ -2723,7 +2723,7 @@ const LOAD_MODULE_MODULE_FN = async (fileName, self) => {
     for (const { filePath, baseDir } of GET_MODULE_VARIANTS_FN(fileName, self)) {
         try {
             if (await self.loaderService.check(filePath, baseDir)) {
-                self.loaderService.import(filePath, baseDir);
+                await self.loaderService.import(filePath, baseDir);
                 return true;
             }
         }
@@ -3094,12 +3094,23 @@ const GET_ALIAS_VARIANTS_FN = (self) => {
     });
     return result;
 };
+const ESM_IMPORT_FN = trycatch(async (name) => {
+    const alias = await import(name);
+    {
+        overrideModule(name, alias);
+        Object.assign(IMPORT_ALIAS, { [name]: alias });
+    }
+}, {
+    fallback: (error, name) => {
+        console.error(`Import failed for ${name}`, error);
+    }
+});
 const GET_ALIAS_EXPORTS_FN = (self) => {
     for (const { filePath, baseDir } of GET_ALIAS_VARIANTS_FN(self)) {
         if (!fs.existsSync(filePath)) {
             continue;
         }
-        const instance = self.getInstance(baseDir);
+        const instance = self._getInstance(baseDir);
         const alias = instance.import(filePath);
         if (!alias) {
             return null;
@@ -3111,17 +3122,38 @@ const GET_ALIAS_EXPORTS_FN = (self) => {
     }
     return null;
 };
-const INIT_ALIAS_FN = singleshot((self) => {
+const INIT_ALIAS_FN = singleshot(async (self) => {
+    {
+        await ESM_IMPORT_FN("ccxt");
+        await ESM_IMPORT_FN("pinets");
+    }
     const alias = GET_ALIAS_EXPORTS_FN(self);
     if (!alias) {
         return;
     }
-    if (!isObject(alias)) {
+    let moduleMap;
+    try {
+        if (isObject(alias)) {
+            moduleMap = alias;
+        }
+        else if (typeof alias === "function") {
+            moduleMap = await alias();
+        }
+        else if (typeof alias?.loader === "function") {
+            moduleMap = await alias.loader();
+        }
+    }
+    catch (error) {
+        console.error("Alias loader failed", error);
+        kill(-1);
+        return;
+    }
+    if (!isObject(moduleMap)) {
         return;
     }
     {
-        Object.entries(alias).forEach(([name, module]) => overrideModule(name, module));
-        Object.assign(IMPORT_ALIAS, alias);
+        Object.entries(moduleMap).forEach(([name, module]) => overrideModule(name, module));
+        Object.assign(IMPORT_ALIAS, moduleMap);
     }
 });
 class LoaderService {
@@ -3129,8 +3161,7 @@ class LoaderService {
         this.babelService = inject(TYPES.babelService);
         this.loggerService = inject(TYPES.loggerService);
         this.resolveService = inject(TYPES.resolveService);
-        this.getInstance = memoize(([basePath]) => `${basePath}`, (basePath) => {
-            INIT_ALIAS_FN(this);
+        this._getInstance = memoize(([basePath]) => `${basePath}`, (basePath) => {
             return new ClientLoader({
                 babel: this.babelService,
                 logger: this.loggerService,
@@ -3138,12 +3169,13 @@ class LoaderService {
                 path: basePath,
             });
         });
-        this.import = (filePath, basePath = process.cwd()) => {
+        this.import = async (filePath, basePath = process.cwd()) => {
             this.loggerService.log("loaderService import", {
                 filePath,
                 basePath,
             });
-            const instance = this.getInstance(basePath);
+            const instance = this._getInstance(basePath);
+            await INIT_ALIAS_FN(this);
             return instance.import(filePath);
         };
         this.check = async (filePath, basePath = process.cwd()) => {
@@ -3151,7 +3183,8 @@ class LoaderService {
                 filePath,
                 basePath,
             });
-            const instance = this.getInstance(basePath);
+            const instance = this._getInstance(basePath);
+            await INIT_ALIAS_FN(this);
             return instance.check(filePath);
         };
     }
@@ -3177,7 +3210,7 @@ const LOAD_CONFIG_CONFIG_FN = async (fileName, self) => {
     for (const { filePath, baseDir } of GET_CONFIG_VARIANTS_FN(fileName, self)) {
         try {
             if (await self.loaderService.check(filePath, baseDir)) {
-                return self.loaderService.import(filePath, baseDir);
+                return await self.loaderService.import(filePath, baseDir);
             }
         }
         catch {
@@ -3368,7 +3401,7 @@ const main$h = async () => {
     if (MODES.some((mode) => values[mode])) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"13.4.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"13.5.0"}\n`);
     process.stdout.write("\n");
     process.stdout.write(`Run with --help to see available commands.\n`);
     process.stdout.write("\n");
@@ -4674,7 +4707,7 @@ const main$1 = async () => {
     if (!values.help) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"13.4.0"}\n\n`);
+    process.stdout.write(`@backtest-kit/cli ${"13.5.0"}\n\n`);
     process.stdout.write(HELP_TEXT);
     process.exit(0);
 };
@@ -4688,7 +4721,7 @@ const main = async () => {
     if (!values.version) {
         return;
     }
-    process.stdout.write(`@backtest-kit/cli ${"13.4.0"}\n`);
+    process.stdout.write(`@backtest-kit/cli ${"13.5.0"}\n`);
     process.exit(0);
 };
 main();

package/docker/package.json

@@ -15,17 +15,17 @@
     "@types/node": "25.6.0"
   },
   "dependencies": {
-    "@backtest-kit/cli": "13.4.0",
-    "@backtest-kit/graph": "13.4.0",
-    "@backtest-kit/pinets": "13.4.0",
-    "@backtest-kit/signals": "13.4.0",
-    "@backtest-kit/ui": "13.4.0",
+    "@backtest-kit/cli": "13.5.0",
+    "@backtest-kit/graph": "13.5.0",
+    "@backtest-kit/pinets": "13.5.0",
+    "@backtest-kit/signals": "13.5.0",
+    "@backtest-kit/ui": "13.5.0",
     "@tavily/core": "0.7.2",
     "@tensorflow/tfjs": "4.22.0",
     "@tensorflow/tfjs-backend-wasm": "4.22.0",
     "@tensorflow/tfjs-core": "4.22.0",
     "agent-swarm-kit": "2.7.0",
-    "backtest-kit": "13.4.0",
+    "backtest-kit": "13.5.0",
     "dayjs": "1.11.20",
     "functools-kit": "2.3.0",
     "garch": "1.2.3",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/cli",
-  "version": "13.4.0",
+  "version": "13.5.0",
   "description": "Zero-boilerplate CLI runner for backtest-kit strategies. Run backtests, paper trading, and live bots with candle cache warming, web dashboard, and Telegram notifications — no setup code required.",
   "author": {
     "name": "Petr Tripolsky",
@@ -63,11 +63,11 @@
   "devDependencies": {
     "@babel/plugin-transform-modules-umd": "7.27.1",
     "@babel/standalone": "7.29.1",
-    "@backtest-kit/graph": "13.4.0",
-    "@backtest-kit/ollama": "13.4.0",
-    "@backtest-kit/pinets": "13.4.0",
-    "@backtest-kit/signals": "13.4.0",
-    "@backtest-kit/ui": "13.4.0",
+    "@backtest-kit/graph": "13.5.0",
+    "@backtest-kit/ollama": "13.5.0",
+    "@backtest-kit/pinets": "13.5.0",
+    "@backtest-kit/signals": "13.5.0",
+    "@backtest-kit/ui": "13.5.0",
     "@rollup/plugin-replace": "6.0.3",
     "@rollup/plugin-typescript": "11.1.6",
     "@types/image-size": "0.7.0",
@@ -75,7 +75,7 @@
     "@types/mustache": "4.2.6",
     "@types/node": "22.9.0",
     "@types/stack-trace": "0.0.33",
-    "backtest-kit": "13.4.0",
+    "backtest-kit": "13.5.0",
     "glob": "11.0.1",
     "markdown-it": "14.1.1",
     "rimraf": "6.0.1",
@@ -85,22 +85,25 @@
     "ts-morph": "27.0.2",
     "tslib": "2.7.0",
     "typedoc": "0.27.9",
+    "pinets": "0.9.22",
+    "ccxt": "4.5.39",
     "worker-testbed": "2.0.0"
   },
   "peerDependencies": {
     "@babel/plugin-transform-modules-umd": "^7.27.1",
     "@babel/standalone": "^7.29.1",
-    "@backtest-kit/graph": "^13.4.0",
-    "@backtest-kit/ollama": "^13.4.0",
-    "@backtest-kit/pinets": "^13.4.0",
-    "@backtest-kit/signals": "^13.4.0",
-    "@backtest-kit/ui": "^13.4.0",
-    "backtest-kit": "^13.4.0",
+    "@backtest-kit/graph": "^13.5.0",
+    "@backtest-kit/ollama": "^13.5.0",
+    "@backtest-kit/pinets": "^13.5.0",
+    "@backtest-kit/signals": "^13.5.0",
+    "@backtest-kit/ui": "^13.5.0",
+    "pinets": "^0.9.22",
+    "ccxt": "^4.5.39",
+    "backtest-kit": "^13.5.0",
     "markdown-it": "^14.1.1",
     "typescript": "^5.0.0"
   },
   "dependencies": {
-    "ccxt": "4.5.39",
     "di-kit": "1.1.1",
     "di-scoped": "1.0.21",
     "dotenv": "17.3.1",

package/template/project/package.mustache

@@ -13,12 +13,12 @@
   "license": "ISC",
   "type": "commonjs",
   "dependencies": {
-    "@backtest-kit/cli": "^13.4.0",
-    "@backtest-kit/graph": "^13.4.0",
-    "@backtest-kit/pinets": "^13.4.0",
-    "@backtest-kit/ui": "^13.4.0",
+    "@backtest-kit/cli": "^13.5.0",
+    "@backtest-kit/graph": "^13.5.0",
+    "@backtest-kit/pinets": "^13.5.0",
+    "@backtest-kit/ui": "^13.5.0",
     "agent-swarm-kit": "^2.7.0",
-    "backtest-kit": "^13.4.0",
+    "backtest-kit": "^13.5.0",
     "functools-kit": "^2.3.0",
     "garch": "^1.2.3",
     "get-moment-stamp": "^2.0.0",

package/types.d.ts

@@ -206,8 +206,8 @@ declare class LoaderService {
     readonly babelService: BabelService;
     readonly loggerService: LoggerService;
     readonly resolveService: ResolveService;
-    getInstance: ((basePath: string) => ClientLoader) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, ClientLoader>;
-    import: (filePath: string, basePath?: string) => any;
+    _getInstance: ((basePath: string) => ClientLoader) & functools_kit.IClearableMemoize<string> & functools_kit.IControlMemoize<string, ClientLoader>;
+    import: (filePath: string, basePath?: string) => Promise<any>;
     check: (filePath: string, basePath?: string) => Promise<boolean>;
 }