@backtest-kit/pinets 0.0.3 → 0.0.5

package/README.md

@@ -47,22 +47,22 @@ Create a Pine Script file (`strategy.pine`):
 
 ```pine
 //@version=5
-indicator("Signal Strategy")
+indicator("Signal Strategy 100 candles of 1H timeframe")
 
-// Indicators
-rsi = ta.rsi(close, 14)
-atr = ta.atr(14)
-ema_fast = ta.ema(close, 9)
-ema_slow = ta.ema(close, 21)
+// Indicators - faster settings for 1H
+rsi = ta.rsi(close, 10)
+atr = ta.atr(10)
+ema_fast = ta.ema(close, 7)
+ema_slow = ta.ema(close, 16)
 
 // Conditions
-long_cond = ta.crossover(ema_fast, ema_slow) and rsi < 70
-short_cond = ta.crossunder(ema_fast, ema_slow) and rsi > 30
+long_cond = ta.crossover(ema_fast, ema_slow) and rsi < 65
+short_cond = ta.crossunder(ema_fast, ema_slow) and rsi > 35
 
-// Levels
-sl_long = close - atr * 2
+// Levels - tighter SL, wider TP for better RR
+sl_long = close - atr * 1.5
 tp_long = close + atr * 3
-sl_short = close + atr * 2
+sl_short = close + atr * 1.5
 tp_short = close - atr * 3
 
 // Plots for extraction
@@ -70,7 +70,7 @@ plot(close, "Close")
 plot(long_cond ? 1 : short_cond ? -1 : 0, "Signal")
 plot(long_cond ? sl_long : sl_short, "StopLoss")
 plot(long_cond ? tp_long : tp_short, "TakeProfit")
-plot(240, "EstimatedTime")  // 4 hours in minutes
+plot(60, "EstimatedTime")  // 1 hour in minutes
 ```
 
 Use it in your strategy:
@@ -88,7 +88,7 @@ addStrategy({
 
     return await getSignal(source, {
       symbol,
-      timeframe: '5m',
+      timeframe: '1h',
       limit: 100,
     });
   }
@@ -131,28 +131,29 @@ const signal = await getSignal(source, {
 For advanced use cases, extract any Pine `plot()` with custom mapping:
 
 ```typescript
-import { File, run } from '@backtest-kit/pinets';
+import { File, run, extract } from '@backtest-kit/pinets';
 
 const source = File.fromPath('indicators.pine');
 
-const data = await run(source, {
+const plots = await run(source, {
   symbol: 'ETHUSDT',
   timeframe: '1h',
   limit: 200,
-  mapping: {
-    // Simple: plot name -> number
-    rsi: 'RSI',
-    macd: 'MACD',
-
-    // Advanced: with transform and lookback
-    prevRsi: {
-      plot: 'RSI',
-      barsBack: 1,  // Previous bar value
-    },
-    trendStrength: {
-      plot: 'ADX',
-      transform: (v) => v > 25 ? 'strong' : 'weak',
-    },
+});
+
+const data = extract(plots, {
+  // Simple: plot name -> number
+  rsi: 'RSI',
+  macd: 'MACD',
+
+  // Advanced: with transform and lookback
+  prevRsi: {
+    plot: 'RSI',
+    barsBack: 1,  // Previous bar value
+  },
+  trendStrength: {
+    plot: 'ADX',
+    transform: (v) => v > 25 ? 'strong' : 'weak',
   },
 });
 

package/build/index.cjs

@@ -501,7 +501,7 @@ function extractRowAtIndex(plots, keys, index) {
 }
 function isRowWarmedUp(row, keys) {
     for (const key of keys) {
-        if (!row[key]) {
+        if (isUnsafe(row[key])) {
             return false;
         }
     }
@@ -536,12 +536,12 @@ class PineMarkdownService {
             });
             const keys = Object.keys(plots);
             if (keys.length === 0) {
-                return;
+                return [];
             }
             const firstPlot = plots[keys[0]];
             const dataLength = firstPlot?.data?.length ?? 0;
             if (dataLength === 0) {
-                return;
+                return [];
             }
             const rows = [];
             let warmupComplete = false;
@@ -655,7 +655,7 @@ function usePine(ctor) {
     pine.pineConnectionService.usePine(ctor);
 }
 
-const METHOD_NAME_RUN$1 = "run.run";
+const METHOD_NAME_RUN$2 = "run.run";
 const GET_SOURCE_FN$1 = async (source) => {
     if (File.isFile(source)) {
         const code = await pine.pineCacheService.readFile(source.path, source.baseDir);
@@ -666,16 +666,23 @@ const GET_SOURCE_FN$1 = async (source) => {
     }
     throw new Error("Source must be a File or Code instance");
 };
-async function run(source, { symbol, timeframe, mapping, limit }) {
-    pine.loggerService.info(METHOD_NAME_RUN$1, {
+async function run(source, { symbol, timeframe, limit }) {
+    pine.loggerService.info(METHOD_NAME_RUN$2, {
         source,
         symbol,
         timeframe,
-        mapping,
         limit,
     });
     const script = await GET_SOURCE_FN$1(source);
     const { plots } = await pine.pineJobService.run(script, symbol, timeframe, limit);
+    return plots;
+}
+
+const METHOD_NAME_RUN$1 = "extract.extract";
+async function extract(plots, mapping) {
+    pine.loggerService.info(METHOD_NAME_RUN$1, {
+        mapping,
+    });
     return pine.pineDataService.extract(plots, mapping);
 }
 
@@ -683,28 +690,6 @@ function setLogger(logger) {
     pine.loggerService.setLogger(logger);
 }
 
-const METHOD_NAME_RUN = "strategy.getSignal";
-const DEFAULT_ESTIMATED_TIME = 240;
-const GET_SOURCE_FN = async (source) => {
-    if (File.isFile(source)) {
-        const code = await pine.pineCacheService.readFile(source.path, source.baseDir);
-        return Code.fromString(code);
-    }
-    if (Code.isCode(source)) {
-        return source;
-    }
-    throw new Error("Source must be a File or Code instance");
-};
-const SIGNAL_SCHEMA = {
-    position: "Signal",
-    priceOpen: "Close",
-    priceTakeProfit: "TakeProfit",
-    priceStopLoss: "StopLoss",
-    minuteEstimatedTime: {
-        plot: "EstimatedTime",
-        transform: (v) => v || DEFAULT_ESTIMATED_TIME,
-    },
-};
 function toSignalDto(data) {
     if (data.position === 1) {
         return {
@@ -728,6 +713,29 @@ function toSignalDto(data) {
     }
     return null;
 }
+
+const METHOD_NAME_RUN = "strategy.getSignal";
+const DEFAULT_ESTIMATED_TIME = 240;
+const GET_SOURCE_FN = async (source) => {
+    if (File.isFile(source)) {
+        const code = await pine.pineCacheService.readFile(source.path, source.baseDir);
+        return Code.fromString(code);
+    }
+    if (Code.isCode(source)) {
+        return source;
+    }
+    throw new Error("Source must be a File or Code instance");
+};
+const SIGNAL_SCHEMA = {
+    position: "Signal",
+    priceOpen: "Close",
+    priceTakeProfit: "TakeProfit",
+    priceStopLoss: "StopLoss",
+    minuteEstimatedTime: {
+        plot: "EstimatedTime",
+        transform: (v) => v || DEFAULT_ESTIMATED_TIME,
+    },
+};
 async function getSignal(source, { symbol, timeframe, limit }) {
     pine.loggerService.info(METHOD_NAME_RUN, {
         source,
@@ -741,7 +749,7 @@ async function getSignal(source, { symbol, timeframe, limit }) {
 }
 
 const DUMP_SIGNAL_METHOD_NAME = "dump.dumpSignal";
-async function dumpPineData(signalId, plots, taName, outputDir = "./dump/ta") {
+async function dumpPlotData(signalId, plots, taName, outputDir = "./dump/ta") {
     pine.loggerService.log(DUMP_SIGNAL_METHOD_NAME, {
         signalId,
         plotCount: Object.keys(plots).length,
@@ -753,9 +761,11 @@ async function dumpPineData(signalId, plots, taName, outputDir = "./dump/ta") {
 exports.AXIS_SYMBOL = AXIS_SYMBOL;
 exports.Code = Code;
 exports.File = File;
-exports.dumpPineData = dumpPineData;
+exports.dumpPlotData = dumpPlotData;
+exports.extract = extract;
 exports.getSignal = getSignal;
 exports.lib = pine;
 exports.run = run;
 exports.setLogger = setLogger;
+exports.toSignalDto = toSignalDto;
 exports.usePine = usePine;

package/build/index.mjs

@@ -498,7 +498,7 @@ function extractRowAtIndex(plots, keys, index) {
 }
 function isRowWarmedUp(row, keys) {
     for (const key of keys) {
-        if (!row[key]) {
+        if (isUnsafe(row[key])) {
             return false;
         }
     }
@@ -533,12 +533,12 @@ class PineMarkdownService {
             });
             const keys = Object.keys(plots);
             if (keys.length === 0) {
-                return;
+                return [];
             }
             const firstPlot = plots[keys[0]];
             const dataLength = firstPlot?.data?.length ?? 0;
             if (dataLength === 0) {
-                return;
+                return [];
             }
             const rows = [];
             let warmupComplete = false;
@@ -652,7 +652,7 @@ function usePine(ctor) {
     pine.pineConnectionService.usePine(ctor);
 }
 
-const METHOD_NAME_RUN$1 = "run.run";
+const METHOD_NAME_RUN$2 = "run.run";
 const GET_SOURCE_FN$1 = async (source) => {
     if (File.isFile(source)) {
         const code = await pine.pineCacheService.readFile(source.path, source.baseDir);
@@ -663,16 +663,23 @@ const GET_SOURCE_FN$1 = async (source) => {
     }
     throw new Error("Source must be a File or Code instance");
 };
-async function run(source, { symbol, timeframe, mapping, limit }) {
-    pine.loggerService.info(METHOD_NAME_RUN$1, {
+async function run(source, { symbol, timeframe, limit }) {
+    pine.loggerService.info(METHOD_NAME_RUN$2, {
         source,
         symbol,
         timeframe,
-        mapping,
         limit,
     });
     const script = await GET_SOURCE_FN$1(source);
     const { plots } = await pine.pineJobService.run(script, symbol, timeframe, limit);
+    return plots;
+}
+
+const METHOD_NAME_RUN$1 = "extract.extract";
+async function extract(plots, mapping) {
+    pine.loggerService.info(METHOD_NAME_RUN$1, {
+        mapping,
+    });
     return pine.pineDataService.extract(plots, mapping);
 }
 
@@ -680,28 +687,6 @@ function setLogger(logger) {
     pine.loggerService.setLogger(logger);
 }
 
-const METHOD_NAME_RUN = "strategy.getSignal";
-const DEFAULT_ESTIMATED_TIME = 240;
-const GET_SOURCE_FN = async (source) => {
-    if (File.isFile(source)) {
-        const code = await pine.pineCacheService.readFile(source.path, source.baseDir);
-        return Code.fromString(code);
-    }
-    if (Code.isCode(source)) {
-        return source;
-    }
-    throw new Error("Source must be a File or Code instance");
-};
-const SIGNAL_SCHEMA = {
-    position: "Signal",
-    priceOpen: "Close",
-    priceTakeProfit: "TakeProfit",
-    priceStopLoss: "StopLoss",
-    minuteEstimatedTime: {
-        plot: "EstimatedTime",
-        transform: (v) => v || DEFAULT_ESTIMATED_TIME,
-    },
-};
 function toSignalDto(data) {
     if (data.position === 1) {
         return {
@@ -725,6 +710,29 @@ function toSignalDto(data) {
     }
     return null;
 }
+
+const METHOD_NAME_RUN = "strategy.getSignal";
+const DEFAULT_ESTIMATED_TIME = 240;
+const GET_SOURCE_FN = async (source) => {
+    if (File.isFile(source)) {
+        const code = await pine.pineCacheService.readFile(source.path, source.baseDir);
+        return Code.fromString(code);
+    }
+    if (Code.isCode(source)) {
+        return source;
+    }
+    throw new Error("Source must be a File or Code instance");
+};
+const SIGNAL_SCHEMA = {
+    position: "Signal",
+    priceOpen: "Close",
+    priceTakeProfit: "TakeProfit",
+    priceStopLoss: "StopLoss",
+    minuteEstimatedTime: {
+        plot: "EstimatedTime",
+        transform: (v) => v || DEFAULT_ESTIMATED_TIME,
+    },
+};
 async function getSignal(source, { symbol, timeframe, limit }) {
     pine.loggerService.info(METHOD_NAME_RUN, {
         source,
@@ -738,7 +746,7 @@ async function getSignal(source, { symbol, timeframe, limit }) {
 }
 
 const DUMP_SIGNAL_METHOD_NAME = "dump.dumpSignal";
-async function dumpPineData(signalId, plots, taName, outputDir = "./dump/ta") {
+async function dumpPlotData(signalId, plots, taName, outputDir = "./dump/ta") {
     pine.loggerService.log(DUMP_SIGNAL_METHOD_NAME, {
         signalId,
         plotCount: Object.keys(plots).length,
@@ -747,4 +755,4 @@ async function dumpPineData(signalId, plots, taName, outputDir = "./dump/ta") {
     return await pine.pineMarkdownService.dump(signalId, plots, taName, outputDir);
 }
 
-export { AXIS_SYMBOL, Code, File, dumpPineData, getSignal, pine as lib, run, setLogger, usePine };
+export { AXIS_SYMBOL, Code, File, dumpPlotData, extract, getSignal, pine as lib, run, setLogger, toSignalDto, usePine };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backtest-kit/pinets",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Run TradingView Pine Script strategies in Node.js self hosted environment. Execute existing Pine Script indicators and generate trading signals with 1:1 syntax compatibility via PineTS runtime.",
   "author": {
     "name": "Petr Tripolsky",

package/types.d.ts

@@ -42,6 +42,13 @@ interface IPine {
 
 declare function usePine<T = TPineCtor>(ctor: T): void;
 
+interface IRunParams {
+    symbol: string;
+    timeframe: CandleInterval;
+    limit: number;
+}
+declare function run(source: File | Code, { symbol, timeframe, limit }: IRunParams): Promise<PlotModel>;
+
 type PlotExtractConfig<T = number> = {
     plot: string;
     barsBack?: number;
@@ -58,13 +65,7 @@ declare class PineDataService {
     extract<M extends PlotMapping>(plots: PlotModel, mapping: M): ExtractedData<M>;
 }
 
-interface IRunParams<M extends PlotMapping> {
-    symbol: string;
-    timeframe: CandleInterval;
-    limit: number;
-    mapping: M;
-}
-declare function run<M extends PlotMapping>(source: File | Code, { symbol, timeframe, mapping, limit }: IRunParams<M>): Promise<ExtractedData<M>>;
+declare function extract<M extends PlotMapping>(plots: PlotModel, mapping: M): Promise<ExtractedData<M>>;
 
 interface ILogger {
     log(topic: string, ...args: any[]): void;
@@ -83,7 +84,19 @@ interface IParams {
 declare function getSignal(source: File | Code, { symbol, timeframe, limit }: IParams): Promise<ISignalDto | null>;
 
 type ResultId$1 = string | number;
-declare function dumpPineData(signalId: ResultId$1, plots: PlotModel, taName: string, outputDir?: string): Promise<void>;
+declare function dumpPlotData(signalId: ResultId$1, plots: PlotModel, taName: string, outputDir?: string): Promise<void>;
+
+interface SignalData {
+    position: number;
+    priceOpen: number;
+    priceTakeProfit: number;
+    priceStopLoss: number;
+    minuteEstimatedTime: number;
+}
+interface Signal extends ISignalDto {
+    id: string;
+}
+declare function toSignalDto(data: SignalData): Signal | null;
 
 interface CandleModel {
     openTime: number;
@@ -171,4 +184,4 @@ declare const pine: {
     loggerService: LoggerService;
 };
 
-export { AXIS_SYMBOL, type CandleModel, Code, File, type ILogger, type IPine, type IProvider, type PlotExtractConfig, type PlotMapping, type PlotModel, type PlotRecord, type SymbolInfoModel, type TPineCtor, dumpPineData, getSignal, pine as lib, run, setLogger, usePine };
+export { AXIS_SYMBOL, type CandleModel, Code, File, type ILogger, type IPine, type IProvider, type PlotExtractConfig, type PlotMapping, type PlotModel, type PlotRecord, type SymbolInfoModel, type TPineCtor, dumpPlotData, extract, getSignal, pine as lib, run, setLogger, toSignalDto, usePine };