pinets 0.9.10 → 0.9.12

package/dist/types/PineTS.class.d.ts

@@ -148,6 +148,34 @@ export declare class PineTS {
      * @private
      */
     private _removeLastResult;
+    /**
+     * Snapshot the var/let/const/params Series state for streaming rollback.
+     * Captures the data array length and last value for each variable so we can
+     * restore to this exact state before re-executing the last bar.
+     *
+     * PERF NOTE: This currently snapshots ALL scopes (const, var, let, params).
+     * In practice, only `var` variables need snapshot/restore because:
+     *   - `let` variables are re-initialized every bar via $.init() — they reset naturally
+     *   - `const` variables are set once and never modified
+     *   - `params` are function parameters, not modified across bars
+     * Only `var` variables persist and get modified in-place by $.set() (e.g. n += 1),
+     * which causes drift on streaming re-execution.
+     * If this becomes a bottleneck, narrow to `['var']` only.
+     *
+     * An even lighter alternative: make $.set() on var Series append-only (push
+     * instead of in-place modify). Then the existing pop-based _removeLastResult
+     * would correctly revert var state without any snapshot. This would require
+     * changes to the core Series/set mechanics.
+     *
+     * @private
+     */
+    private _snapshotVarState;
+    /**
+     * Restore var/let/const/params Series state from a snapshot.
+     * Truncates each Series' data array back to the snapshotted length.
+     * @private
+     */
+    private _restoreVarState;
     /**
      * Initialize a new context for running Pine Script code
      * @private

package/dist/types/marketData/FMP/FMPProvider.class.d.ts

@@ -36,6 +36,8 @@ export declare class FMPProvider extends BaseProvider<FMPProviderConfig> {
     private _apiKey;
     private _baseUrl;
     private _profileCache;
+    private _symbolInfoCache;
+    private _mintickCache;
     constructor(config?: FMPProviderConfig);
     configure(config: FMPProviderConfig): void;
     protected getSupportedTimeframes(): Set<string>;
@@ -50,6 +52,13 @@ export declare class FMPProvider extends BaseProvider<FMPProviderConfig> {
      */
     private _fetchIntradayData;
     getSymbolInfo(tickerId: string): Promise<ISymbolInfo>;
+    /**
+     * Estimate mintick from historical OHLC data.
+     * Computes the smallest non-zero |close - open| and |high - low| diff,
+     * then rounds to the nearest power-of-10 bucket.
+     * Returns undefined if no valid diffs found.
+     */
+    private _estimateMintick;
     private _fetchProfile;
     /**
      * Resolve session string and timezone for a ticker by fetching its profile.
@@ -62,8 +71,8 @@ export declare class FMPProvider extends BaseProvider<FMPProviderConfig> {
     private _dateStrToMs;
     /** Convert FMP datetime string "YYYY-MM-DD HH:MM:SS" to ms timestamp. */
     private _dateTimeStrToMs;
-    /** Heuristic: crypto tickers end with USD/USDT/BTC/ETH. */
-    private _isCrypto;
-    /** Heuristic: forex pairs are 6 chars, two 3-letter currency codes. */
+    /** Heuristic: forex pairs are exactly 6 uppercase chars (two 3-letter currency codes). */
     private _isForex;
+    /** Heuristic: crypto tickers end with USD/USDT/BTC/ETH and are not forex pairs. */
+    private _isCrypto;
 }

package/dist/types/namespaces/Time.d.ts

@@ -1,3 +1,17 @@
+/**
+ * Normalize a Pine Script timeframe string to a canonical form.
+ * e.g. "1D" → "D", "60" → "60", "1W" → "W", "" → ""
+ */
+export declare function normalizeTimeframe(tf: string): string;
+/**
+ * Compute the opening timestamp of the higher-timeframe bar that contains the given timestamp.
+ *
+ * For intraday TFs (minutes): floor to the nearest multiple of the TF duration within the day.
+ * For daily: floor to UTC day start (00:00 UTC).
+ * For weekly: floor to Monday 00:00 UTC.
+ * For monthly: floor to 1st of month 00:00 UTC.
+ */
+export declare function alignToTimeframe(timestamp: number, tf: string): number;
 interface DateParts {
     year: number;
     month: number;
@@ -28,7 +42,7 @@ export declare class TimeHelper {
     constructor(context: any, dataField?: string);
     get __value(): any;
     param(source: any, index?: number): any;
-    any(...args: any[]): any;
+    any(...args: any[]): number;
     /**
      * Basic session check: parses "HHMM-HHMM" format and tests if
      * the timestamp falls within the session window.

package/dist/types/namespaces/Timeframe.d.ts

@@ -17,6 +17,14 @@ export declare class Timeframe {
     get isseconds(): boolean;
     get isminutes(): boolean;
     get isintraday(): boolean;
+    /**
+     * Detects changes in the specified timeframe.
+     * Returns true on the first bar of a new HTF period, false otherwise.
+     *
+     * Works by aligning current and previous bar timestamps to the target
+     * timeframe and comparing — if they differ, a new period has started.
+     */
+    change(timeframe: any): boolean;
     from_seconds(seconds: number): string | number;
     in_seconds(timeframe?: string): number;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "pinets",
-    "version": "0.9.10",
+    "version": "0.9.12",
     "description": "Run Pine Script anywhere. PineTS is an open-source transpiler and runtime that brings Pine Script logic to Node.js and the browser with 1:1 syntax compatibility. Reliably write, port, and run indicators or strategies on your own infrastructure.",
     "keywords": [
         "Pine Script",