@tradejs/app 1.0.9 → 1.0.11

package/README.md

@@ -2,11 +2,24 @@
 
 Publishable Next.js UI package for the TradeJS open-source framework, with backtests, charts, and signal flows.
 
-Typical external usage:
+Recommended external usage:
 
 ```bash
-npm i @tradejs/app
+npx create-tradejs
+```
+
+The generator starts local infrastructure and opens the install page. Choose
+the local `root` password there; TradeJS then opens the dashboard with a
+**Create backtest** action. For manual installation into an existing project:
+
+```bash
+npm install @tradejs/app @tradejs/core @tradejs/node @tradejs/types @tradejs/base @tradejs/cli
 npx tradejs-app dev
 ```
 
-The launcher reads env and `tradejs.config.ts` from the caller project directory via `PROJECT_CWD`.
+Use matching versions for all `@tradejs/*` packages. The installable launcher
+requires `@tradejs/app@1.0.10` or newer.
+
+The launcher reads env and `tradejs.config.ts` from the caller project directory
+via `PROJECT_CWD`. When it runs from `node_modules`, it creates a generated
+`.tradejs/app` working copy and runs Next.js there.

package/bin/tradejs-app.mjs

@@ -1,7 +1,8 @@
 #!/usr/bin/env node
 
-import { spawn } from 'child_process';
+import { spawn, spawnSync } from 'child_process';
 import { createRequire } from 'module';
+import fs from 'fs';
 import net from 'net';
 import path from 'path';
 import { fileURLToPath } from 'url';
@@ -11,7 +12,7 @@ const require = createRequire(import.meta.url);
 const { loadEnvConfig } = nextEnv;
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-const appDir = path.resolve(__dirname, '..');
+const packageDir = path.resolve(__dirname, '..');
 const LOCAL_DEV_HOSTNAMES = new Set([
   'localhost',
   '127.0.0.1',
@@ -31,6 +32,93 @@ process.env.PROJECT_CWD = projectCwd;
 const dev = command === 'dev';
 loadEnvConfig(projectCwd, dev, console);
 
+function isInsideNodeModules(dir) {
+  return dir.split(path.sep).includes('node_modules');
+}
+
+function copyPackageEntry(entryName, targetDir) {
+  const sourcePath = path.join(packageDir, entryName);
+  if (!fs.existsSync(sourcePath)) {
+    return;
+  }
+
+  const targetPath = path.join(targetDir, entryName);
+  fs.rmSync(targetPath, { recursive: true, force: true });
+  fs.cpSync(sourcePath, targetPath, {
+    recursive: true,
+    force: true,
+    errorOnExist: false,
+  });
+}
+
+function ensureLinkedNodeModules(targetDir) {
+  const sourceNodeModules = path.join(packageDir, 'node_modules');
+  const targetNodeModules = path.join(targetDir, 'node_modules');
+
+  if (!fs.existsSync(sourceNodeModules)) {
+    if (
+      fs.existsSync(targetNodeModules) &&
+      fs.lstatSync(targetNodeModules).isSymbolicLink()
+    ) {
+      fs.rmSync(targetNodeModules, { recursive: true, force: true });
+    }
+    return;
+  }
+
+  if (fs.existsSync(targetNodeModules)) {
+    const current = fs.lstatSync(targetNodeModules);
+    if (current.isSymbolicLink()) {
+      const currentTarget = fs.realpathSync(targetNodeModules);
+      if (currentTarget === fs.realpathSync(sourceNodeModules)) {
+        return;
+      }
+    }
+
+    fs.rmSync(targetNodeModules, { recursive: true, force: true });
+  }
+
+  fs.symlinkSync(
+    sourceNodeModules,
+    targetNodeModules,
+    process.platform === 'win32' ? 'junction' : 'dir',
+  );
+}
+
+function ensureGeneratedGitignore() {
+  const tradejsDir = path.join(projectCwd, '.tradejs');
+  const gitignorePath = path.join(tradejsDir, '.gitignore');
+  if (!fs.existsSync(gitignorePath)) {
+    fs.mkdirSync(tradejsDir, { recursive: true });
+    fs.writeFileSync(gitignorePath, 'app\n', 'utf8');
+  }
+}
+
+function resolveAppDir() {
+  if (!isInsideNodeModules(packageDir)) {
+    return packageDir;
+  }
+
+  const targetDir = path.join(projectCwd, '.tradejs', 'app');
+  fs.mkdirSync(targetDir, { recursive: true });
+  ensureGeneratedGitignore();
+
+  for (const entryName of [
+    'README.md',
+    'bin',
+    'next-env.d.ts',
+    'next.config.mjs',
+    'package.json',
+    'public',
+    'src',
+    'tsconfig.json',
+  ]) {
+    copyPackageEntry(entryName, targetDir);
+  }
+
+  ensureLinkedNodeModules(targetDir);
+  return targetDir;
+}
+
 function parsePort(value) {
   const parsed = Number.parseInt(String(value || '').trim(), 10);
   return Number.isInteger(parsed) && parsed > 0 ? parsed : null;
@@ -73,6 +161,53 @@ async function findAvailablePort(startPort, attempts = 20) {
   return null;
 }
 
+function getListeningProcess(port) {
+  if (process.platform === 'win32') {
+    return null;
+  }
+
+  const lsof = spawnSync('lsof', [
+    '-nP',
+    `-iTCP:${port}`,
+    '-sTCP:LISTEN',
+    '-Fp',
+  ]);
+  const output = String(lsof.stdout || '');
+  const pid = output
+    .split('\n')
+    .find((line) => line.startsWith('p'))
+    ?.slice(1);
+
+  if (!pid) {
+    return null;
+  }
+
+  const ps = spawnSync('ps', ['-p', pid, '-o', 'command=']);
+  const cwdInfo = spawnSync('lsof', ['-a', '-p', pid, '-d', 'cwd', '-Fn']);
+  const cwd = String(cwdInfo.stdout || '')
+    .split('\n')
+    .find((line) => line.startsWith('n'))
+    ?.slice(1);
+
+  return {
+    pid,
+    command: String(ps.stdout || '').trim(),
+    cwd: cwd || null,
+  };
+}
+
+function isAppDevProcess(processInfo, appDir) {
+  if (!processInfo?.command) {
+    return false;
+  }
+
+  if (processInfo.cwd === appDir || processInfo.cwd === packageDir) {
+    return true;
+  }
+
+  return processInfo.command.includes('next-server');
+}
+
 function syncLocalUrlEnv(name, fromPort, toPort) {
   const rawValue = String(process.env[name] || '').trim();
   if (!rawValue) {
@@ -95,6 +230,7 @@ function syncLocalUrlEnv(name, fromPort, toPort) {
 }
 
 async function main() {
+  const appDir = resolveAppDir();
   const nextBin = require.resolve('next/dist/bin/next');
   const args = [nextBin, command, ...rawArgs];
   const explicitPort = parsePort(readArgValue(rawArgs, ['-p', '--port']));
@@ -121,6 +257,14 @@ async function main() {
     args.push('-p', String(resolvedPort));
 
     if (resolvedPort !== requestedPort) {
+      const existingProcess = getListeningProcess(requestedPort);
+      if (isAppDevProcess(existingProcess, appDir)) {
+        console.error(
+          `[tradejs-app] another app dev server is already listening on port ${requestedPort} (PID ${existingProcess.pid}). Stop it before starting a new app server, or pass an explicit --port/PORT for a separate project.`,
+        );
+        process.exit(1);
+      }
+
       syncLocalUrlEnv('APP_URL', requestedPort, resolvedPort);
       syncLocalUrlEnv('NEXTAUTH_URL', requestedPort, resolvedPort);
       console.warn(

package/next.config.mjs

@@ -13,20 +13,6 @@ const nextConfig = {
     externalDir: true,
     optimizePackageImports: ['@chakra-ui/react'],
   },
-  async redirects() {
-    return [
-      {
-        source: '/routes/dashboard/:symbol/:interval',
-        destination: '/routes/dashboard/bybit/:symbol/:interval',
-        permanent: false,
-      },
-      {
-        source: '/api/kline/:symbol/:interval',
-        destination: '/api/kline/bybit/:symbol/:interval',
-        permanent: false,
-      },
-    ];
-  },
 };
 
 export default nextConfig;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tradejs/app",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Installable Next.js UI for the TradeJS open-source framework: dashboards, backtests, charts, and runtime data.",
   "keywords": [
     "tradejs",
@@ -29,44 +29,60 @@
   "publishConfig": {
     "access": "public"
   },
+  "imports": {
+    "#app/*": "./src/app/*",
+    "#actions/*": "./src/app/actions/*",
+    "#store": "./src/app/store/index.ts",
+    "#shared/*": "./src/app/components/Shared/*",
+    "#ui": "./src/app/components/UI/index.ts",
+    "#components/*": "./src/app/components/*"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/tradejs-dev/tradejs.git",
+    "url": "https://github.com/TradeJS-Dev/TradeJS",
     "directory": "apps/app"
   },
   "bugs": {
     "url": "https://github.com/tradejs-dev/tradejs/issues"
   },
   "dependencies": {
-    "@chakra-ui/charts": "^3.24.0",
-    "@chakra-ui/react": "^3.24.2",
+    "@chakra-ui/charts": "3.24.0",
+    "@chakra-ui/react": "3.24.2",
     "@emotion/react": "^11.14.0",
     "@langchain/core": "^1.1.42",
     "@langchain/openai": "^1.4.5",
-    "@tradejs/connectors": "^1.0.9",
-    "@tradejs/core": "^1.0.9",
-    "@tradejs/indicators": "^1.0.9",
-    "@tradejs/infra": "^1.0.9",
-    "@tradejs/node": "^1.0.9",
-    "@tradejs/types": "^1.0.9",
+    "@tradejs/connectors": "^1.0.11",
+    "@tradejs/core": "^1.0.11",
+    "@tradejs/indicators": "^1.0.11",
+    "@tradejs/infra": "^1.0.11",
+    "@tradejs/node": "^1.0.11",
+    "@tradejs/types": "^1.0.11",
+    "@types/bcryptjs": "2.4.6",
+    "@types/lodash": "4.14.202",
+    "@types/node": "24.13.3",
+    "@types/react": "19.2.17",
+    "@types/react-dom": "19.2.3",
+    "@types/react-window": "1.8.8",
     "bcryptjs": "^2.4.3",
     "date-fns": "^3.3.1",
+    "fast-technical-indicators": "^1.1.4",
     "idb-keyval": "^6.2.2",
     "klinecharts": "10.0.0-alpha9",
     "lodash": "^4.18.1",
-    "next": "^16.2.3",
-    "next-auth": "^5.0.0-beta.26",
+    "next": "16.2.4",
+    "next-auth": "5.0.0-beta.30",
     "next-themes": "^0.4.6",
-    "react": "^19.2.3",
-    "react-dom": "^19.2.3",
-    "react-icons": "^5.5.0",
-    "react-is": "^19.2.0",
+    "react": "19.2.3",
+    "react-dom": "19.2.3",
+    "react-icons": "5.5.0",
+    "react-is": "19.2.4",
     "react-virtualized-auto-sizer": "^1.0.26",
     "react-window": "^1.8.11",
-    "recharts": "^3.1.1",
-    "shiki": "^3.9.2",
+    "recharts": "3.1.1",
+    "shiki": "3.9.2",
     "technicalindicators": "^3.1.0",
-    "zustand": "^5.0.7"
+    "typescript": "5.9.3",
+    "zustand": "5.0.7"
   },
   "scripts": {
     "dev": "node ./bin/tradejs-app.mjs dev",

package/src/app/actions/backtest.ts

@@ -1,5 +1,10 @@
 import { API } from '@tradejs/core/api';
 import { Item, OrderLogData, TestResult } from '@tradejs/types';
+import type {
+  BacktestConfigSummary,
+  BacktestJobRecord,
+  BacktestJobRequest,
+} from '#app/lib/backtestJobs';
 
 const API_BASE = '/api/backtest';
 
@@ -53,3 +58,52 @@ export const deleteBacktest = async (
 
   return data.deleted === true;
 };
+
+export const getBacktestRunConfigs = async (): Promise<
+  BacktestConfigSummary[]
+> => {
+  const data = await API.get<{ configs?: BacktestConfigSummary[] }>(
+    `${API_BASE}/configs`,
+  );
+
+  return data.configs ?? [];
+};
+
+export const getBacktestRuns = async (): Promise<BacktestJobRecord[]> => {
+  const data = await API.get<{ jobs?: BacktestJobRecord[] }>(
+    `${API_BASE}/runs`,
+  );
+
+  return data.jobs ?? [];
+};
+
+export const startBacktestRun = async (
+  request: Partial<BacktestJobRequest>,
+): Promise<BacktestJobRecord> => {
+  const data = await API.post<{ job: BacktestJobRecord }>(
+    `${API_BASE}/runs`,
+    request,
+  );
+
+  return data.job;
+};
+
+export const controlBacktestRun = async (
+  jobId: string,
+  action: 'pause' | 'stop' | 'resume' | 'cancel' | 'heartbeat',
+): Promise<BacktestJobRecord> => {
+  const data = await API.post<{ job: BacktestJobRecord }>(
+    `${API_BASE}/runs/${encodeURIComponent(jobId)}`,
+    { action },
+  );
+
+  return data.job;
+};
+
+export const deleteBacktestRun = async (jobId: string): Promise<boolean> => {
+  const data = await API.delete<{ deleted?: boolean }>(
+    `${API_BASE}/runs/${encodeURIComponent(jobId)}`,
+  );
+
+  return data.deleted === true;
+};

package/src/app/actions/kline.ts

@@ -1,16 +1,21 @@
 import { API } from '@tradejs/core/api';
-import { KlineChartData, KlineRequest, Provider } from '@tradejs/types';
-
-const API_PATH = '/api/kline';
+import {
+  KlineChartData,
+  KlineRequest,
+  MarketUniverse,
+  Provider,
+} from '@tradejs/types';
+import { buildKlinePath } from '#app/lib/marketRoutes';
 
 export const kline = async ({
   provider = 'bybit',
+  universe = 'crypto',
   symbol,
   interval,
   ...options
-}: KlineRequest & { provider?: Provider }) => {
+}: KlineRequest & { provider?: Provider; universe?: MarketUniverse }) => {
   const data = await API.post<{ data?: KlineChartData }>(
-    `${API_PATH}/${provider}/${symbol}/${interval}`,
+    buildKlinePath({ provider, universe, symbol, interval }),
     options,
   );
 

package/src/app/actions/scanner.ts

@@ -1,10 +1,15 @@
 import { API } from '@tradejs/core/api';
-import { Items } from '@tradejs/types';
+import { Items, MarketUniverse } from '@tradejs/types';
 
 const API_PATH = '/api/scanner';
 
-export const scan = async (provider = 'bybit'): Promise<Items> => {
-  const data = await API.get<{ tickers?: Items }>(`${API_PATH}/${provider}`);
+export const scan = async (
+  provider = 'bybit',
+  universe: MarketUniverse = 'crypto',
+): Promise<Items> => {
+  const data = await API.get<{ tickers?: Items }>(
+    `${API_PATH}/${provider}/${universe}`,
+  );
 
   return data.tickers ?? [];
 };

package/src/app/actions/strategies.ts

@@ -0,0 +1,39 @@
+import { API } from '@tradejs/core/api';
+import type { StrategyChartsSnapshotResponse } from '@tradejs/types';
+import type { RuntimeStrategiesResponse } from '#app/lib/runtimeStrategies';
+
+const API_PATH = '/api/strategies/runtime';
+const REPLAY_API_PATH = '/api/strategies/replay';
+const AI_API_PATH = '/api/strategies/ai';
+
+export const getRuntimeStrategies = async ({
+  provider = 'bybit',
+  hours = 168,
+}: {
+  provider?: string;
+  hours?: number;
+} = {}) =>
+  API.get<RuntimeStrategiesResponse>(
+    `${API_PATH}?provider=${encodeURIComponent(provider)}&hours=${encodeURIComponent(String(hours))}`,
+  );
+
+export const getReplayStrategies = async () =>
+  API.get<StrategyChartsSnapshotResponse>(REPLAY_API_PATH);
+
+export const getAiStrategies = async () =>
+  API.get<StrategyChartsSnapshotResponse>(AI_API_PATH);
+
+export const deleteStrategyCard = async (
+  mode: 'replay' | 'ai',
+  cardId: string | undefined,
+): Promise<boolean> => {
+  if (!cardId) {
+    return false;
+  }
+
+  const data = await API.delete<{ deleted?: boolean }>(
+    `/api/strategies/${encodeURIComponent(mode)}/${encodeURIComponent(cardId)}`,
+  );
+
+  return data.deleted === true;
+};

package/src/app/api/ai/route.ts

@@ -5,10 +5,10 @@ import {
   HumanMessage,
   SystemMessage,
 } from '@langchain/core/messages';
+import { TTL_1M } from '@tradejs/core/constants';
 import { toJson } from '@tradejs/core/data';
 import { getAiResponseLanguagePromptName } from '@tradejs/infra/aiLanguages';
 import { DEFAULT_AI_MODEL, getOpenRouterModelKwargs } from '@tradejs/node/ai';
-import { getConnectorCreatorByProvider } from '@tradejs/node/connectors';
 import {
   AIChatHistory,
   AIChatMessage,
@@ -18,7 +18,8 @@ import {
 import { getData, redisKeys, setData } from '@tradejs/infra/redis';
 import { logger } from '@tradejs/infra/logger';
 import { getUserSettings } from '@tradejs/infra/userSettings';
-import { getCurrentUserName } from '@app/lib/currentUser';
+import { resolveConnectorCreatorByProvider } from '#app/lib/connectorCreator';
+import { getCurrentUserName } from '#app/lib/currentUser';
 
 export const dynamic = 'force-dynamic';
 
@@ -58,7 +59,7 @@ const appendMessagesToHistory = async (
 ): Promise<void> => {
   const history = await getHistory(userName, symbol);
   await setData(getHistoryKey(userName, symbol), [...history, ...messages], {
-    expire: 0,
+    expire: TTL_1M,
   });
 };
 
@@ -177,7 +178,7 @@ export const POST = async (request: NextRequest) => {
 
     await appendMessagesToHistory(userName, filters.symbol, [message]);
 
-    const connectorCreator = await getConnectorCreatorByProvider(
+    const connectorCreator = await resolveConnectorCreatorByProvider(
       'bybit',
       projectRoot,
     );

package/src/app/api/auth/[...nextauth]/route.ts

@@ -1,4 +1,4 @@
-import { handlers } from '@app/auth';
+import { handlers } from '#app/auth';
 
 export const runtime = 'nodejs';
 

package/src/app/api/backtest/configs/route.ts

@@ -0,0 +1,25 @@
+import { NextResponse } from 'next/server';
+import { logger } from '@tradejs/infra/logger';
+import { getCurrentUserName } from '#app/lib/currentUser';
+import { listBacktestConfigs } from '#app/lib/backtestJobs';
+
+export const dynamic = 'force-dynamic';
+export const runtime = 'nodejs';
+
+export const GET = async () => {
+  try {
+    const userName = await getCurrentUserName();
+    if (!userName) {
+      return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+
+    const configs = await listBacktestConfigs(userName);
+    return NextResponse.json({ configs });
+  } catch (error) {
+    logger.log('error', 'Backtest configs error: %o', error);
+    return NextResponse.json(
+      { error: 'Internal Server Error' },
+      { status: 500 },
+    );
+  }
+};

package/src/app/api/backtest/files/route.ts

@@ -1,9 +1,10 @@
 import { NextResponse } from 'next/server';
 import { Item, TestStat } from '@tradejs/types';
 import { parseTestName } from '@tradejs/core/backtest';
+import { TTL_1M } from '@tradejs/core/constants';
 import { getData, getKeys, redisKeys, setData } from '@tradejs/infra/redis';
 import { logger } from '@tradejs/infra/logger';
-import { auth } from '@app/auth';
+import { auth } from '#app/auth';
 
 export const dynamic = 'force-dynamic';
 
@@ -58,7 +59,9 @@ export const GET = async () => {
       });
     }
 
-    await setData(redisKeys.testSummaries(userName), result, { expire: 0 });
+    await setData(redisKeys.testSummaries(userName), result, {
+      expire: TTL_1M,
+    });
 
     return NextResponse.json({ items: result });
   } catch (error) {

package/src/app/api/backtest/order-log/[strategy]/[name]/route.ts

@@ -2,9 +2,13 @@
 
 import { NextResponse } from 'next/server';
 import { OrderLogData } from '@tradejs/types';
+import {
+  parseBacktestArtifactRef,
+  readPersistedBacktestOrderLog,
+} from '@tradejs/infra/backtestArtifacts';
 import { getData, redisKeys } from '@tradejs/infra/redis';
 import { logger } from '@tradejs/infra/logger';
-import { auth } from '@app/auth';
+import { auth } from '#app/auth';
 
 interface Params {
   strategy: string;
@@ -32,9 +36,29 @@ export const GET = async (
       return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
     }
 
-    const orderLog: OrderLogData = await getData(
+    const storedOrderLog = await getData(
       redisKeys.testOrders(userName, strategy, name),
     );
+    const orderLogRef = parseBacktestArtifactRef(storedOrderLog);
+    if (!orderLogRef) {
+      return NextResponse.json(
+        { error: 'Backtest order log not found' },
+        { status: 404 },
+      );
+    }
+
+    const orderLog: OrderLogData | null = await readPersistedBacktestOrderLog({
+      userName,
+      strategyName: strategy,
+      testName: name,
+      ref: orderLogRef,
+    });
+    if (!orderLog) {
+      return NextResponse.json(
+        { error: 'Backtest order log not found' },
+        { status: 404 },
+      );
+    }
 
     return NextResponse.json({ orderLog });
   } catch (error) {

package/src/app/api/backtest/result/[strategy]/[name]/route.ts

@@ -3,9 +3,13 @@
 import { NextResponse } from 'next/server';
 import { OrderLogData, Test, TestResult, TestStat } from '@tradejs/types';
 import { compactOrderLog, getTimeline } from '@tradejs/core/backtest';
+import {
+  parseBacktestArtifactRef,
+  readPersistedBacktestOrderLog,
+} from '@tradejs/infra/backtestArtifacts';
 import { getData, redisKeys } from '@tradejs/infra/redis';
 import { logger } from '@tradejs/infra/logger';
-import { auth } from '@app/auth';
+import { auth } from '#app/auth';
 
 interface Params {
   strategy: string;
@@ -33,7 +37,7 @@ export const GET = async (
       return NextResponse.json({ error: 'Unauthorized' }, { status: 401 });
     }
 
-    const orderLog: OrderLogData = await getData(
+    const storedOrderLog = await getData(
       redisKeys.testOrders(userName, strategy, name),
     );
     const test: Test = await getData(
@@ -43,6 +47,27 @@ export const GET = async (
       redisKeys.testStat(userName, strategy, name),
     );
 
+    const orderLogRef = parseBacktestArtifactRef(storedOrderLog);
+    if (!orderLogRef) {
+      return NextResponse.json(
+        { error: 'Backtest order log not found' },
+        { status: 404 },
+      );
+    }
+
+    const orderLog: OrderLogData | null = await readPersistedBacktestOrderLog({
+      userName,
+      strategyName: strategy,
+      testName: name,
+      ref: orderLogRef,
+    });
+    if (!orderLog) {
+      return NextResponse.json(
+        { error: 'Backtest order log not found' },
+        { status: 404 },
+      );
+    }
+
     // TODO: Validate test/test.options payload and return 404/422 instead of falling into 500 on malformed cache data.
     const timeline = getTimeline(test.options.start, test.options.end);