π Get real-time stocks from TradingView
TypeScript backtestingbacktesting-trading-strategiesbitcoinchartscryptocryptocurrencyethereumrealtime-stocksstocksstocks-apistocks-pricestradingtradingviewtradingview-apitradingview-indicatortradingview-replaytradingview-scraper
Ship account and post-heartbeat liveness diagnostics for beta.5 (#338)
Mathieu Colmonb79311597ad3
diff --git a/docs/v4-backlog-triage.md b/docs/v4-backlog-triage.mdindex e2569ae..a245f0a 100644--- a/docs/v4-backlog-triage.md+++ b/docs/v4-backlog-triage.md@@ -150,3 +150,12 @@ resolved by a successful HTTP scan. Watchlists and paid/private cases remain opeBeta.4 adds read-only `getWatchlists` and scanner-ranked `getHotlist` (#87).Authenticated discovery returned two empty lists; populated entries are fixture-tested.Exact TradingView UI hotlist parity is not claimed. See [watchlists](watchlists.md).++## Account and endurance follow-up++Beta.5 ships opt-in account/endurance diagnostics and documents six successful+private USER-script runs. Deep Backtesting reached the server but returned+`request_error` / `not_allowed` with the available account. This is a concrete+prerequisite blocker, not implemented Premium support. Original private-script,+CME/GUI and 12-hour issue fixtures remain necessary; no historical issue is closed+from the broader smoke results. See [reliability evidence](v4-reliability.md).diff --git a/docs/v4-reliability.md b/docs/v4-reliability.mdindex ea8331b..b6c1306 100644--- a/docs/v4-reliability.md+++ b/docs/v4-reliability.md@@ -34,3 +34,61 @@ V4 now starts the account lookup at `/chart/` and follows `Location` only on HTT- Basic daily Replay and strategy reports are documented in [v4-coverage.md](v4-coverage.md); this is not proof of Deep Backtesting or universal intraday entitlement.- Private/invite-only script cases, subscribed futures parity, owned layouts and long-running Pine failures need matching assets and targeted reproductions. See [backlog triage](v4-backlog-triage.md).- Live CI is non-blocking. Review its actual test results, not just the overall workflow conclusion, before release.++## Account-scoped diagnostics (beta.5)++From a source checkout, set `SESSION` and `SIGNATURE` securely and run+`npm run probe:account`. The read-only probe authenticates, lists saved scripts,+then evaluates at most ten scripts sequentially on 100 daily BTCUSDT bars. Use+`--max-scripts=N` and `--timeout-ms=N` after `--` to change these bounds.+It prints only counts, index-based outcomes, script namespace categories and the+account token's plan claim. It does not print script IDs, names, source, values,+account identifiers or credentials. A plan claim is informational, not proof of+exchange or Deep Backtesting entitlement. Failures exit nonzero; an empty saved+script list is not considered successful private-script coverage.++The package now includes both diagnostics, so installed consumers can run:++```sh+node node_modules/@mathieuc/tradingview/scripts/probe-account.mjs+node node_modules/@mathieuc/tradingview/scripts/endurance.mjs --minutes=7 --cycle-seconds=600 --require-post-threshold-updates+```++The second command requires candle **and** quote callbacks after more than 30+heartbeats on the same connection. `--heartbeat-threshold=N` changes the threshold.+Counters reset per connection for threshold eligibility; ten short connections do+not constitute one long connection. Initial snapshots alone cannot satisfy this+mode. Any recorded error or interruption also makes the probe fail. Without the+flag, a completed run remains a transport/lifecycle check, not a liveness guarantee.+Run strict mode on an open market; a closed venue cannot supply the required proof.++### Verified private scripts and outstanding paid-account prerequisite++On 3 October 2026, all six saved `USER;` scripts accessible to the available account+completed: two studies and four strategies, each returning 100 candles and 200+study rows. Three strategies returned 208, 4 and 69 trades respectively; the fourth+returned a report with zero trades. These are account-specific fixtures, not a+reproduction of the private strategy in #89 or the table payload in #251.++A bounded request to `history-data` using the protocol in PR #204 reached the server+and returned `request_error` / `not_allowed`. No Deep Backtesting success is claimed.+An eligible account and current successful protocol capture are required before+shipping that API. No subscription was purchased and no account content was modified.+The original scripts/fixtures for #188 (long-running Pine depth error), #24 (Renko+GUI parity) and #311 (subscribed CME sessions) remain unavailable for exact reproduction.++### Unbroken-socket checks, 3 October 2026++- **BTCUSDT, six minutes, one connection:** 35 heartbeats, 85 candle callbacks,+ 89 quote callbacks; after heartbeat 30 on that same connection, 13 candle and+ 12 quote callbacks. Zero errors/failures; strict mode exited successfully.+- **OANDA:EURUSD HeikinAshi, seven minutes, one connection:** 41 heartbeats,+ one initial candle callback and one initial quote callback, zero errors/failures.+ The forex market was closed: this proves heartbeat continuity only and does not+ resolve #236's reported price-stream freeze on an open market.+- Negative controls: a short initial-snapshot-only run fails strict mode, and an+ interrupted run exits nonzero after cleanup. Account diagnostics also fail cleanly+ without credentials; a bounded one-script run was separately verified on Bun.++Neither run is a 12-hour Pine reproduction. The full authenticated live suite on+beta.4 passed all 22 tests; beta.5 changes diagnostic tooling/documentation only.diff --git a/package-lock.json b/package-lock.jsonindex d076d61..d2df6c4 100644--- a/package-lock.json+++ b/package-lock.json@@ -1,12 +1,12 @@{"name": "@mathieuc/tradingview",- "version": "4.0.0-beta.4",+ "version": "4.0.0-beta.5","lockfileVersion": 3,"requires": true,"packages": {"": {"name": "@mathieuc/tradingview",- "version": "4.0.0-beta.4",+ "version": "4.0.0-beta.5","license": "ISC","dependencies": {"ws": "^8.18.0"diff --git a/package.json b/package.jsonindex a3c1bfc..3244365 100644--- a/package.json+++ b/package.json@@ -1,6 +1,6 @@{"name": "@mathieuc/tradingview",- "version": "4.0.0-beta.4",+ "version": "4.0.0-beta.5","description": "TradingView market data for JavaScript and TypeScript: candles, quotes, indicators and strategies, with a simple data API and full low-level access.","type": "module","main": "./dist/index.js",@@ -21,7 +21,9 @@"files": ["dist","README.md",- "docs"+ "docs",+ "scripts/endurance.mjs",+ "scripts/probe-account.mjs"],"sideEffects": false,"scripts": {@@ -36,7 +38,8 @@"check": "npm run typecheck && npm run lint && npm test && npm run build && npm run smoke","prepack": "npm run build","probe:endurance": "npm run build && node scripts/endurance.mjs",- "probe:parity": "npm run build && node scripts/parity.mjs"+ "probe:parity": "npm run build && node scripts/parity.mjs",+ "probe:account": "npm run build && node scripts/probe-account.mjs"},"repository": {"type": "git",diff --git a/scripts/endurance.mjs b/scripts/endurance.mjsindex 31dd538..ba370e7 100644--- a/scripts/endurance.mjs+++ b/scripts/endurance.mjs@@ -12,11 +12,13 @@ const argument = (name, fallback) => {const textArgument = (name, fallback) => process.argv.find((value) => value.startsWith(`--${name}=`))?.split('=')[1] ?? fallback;const minutes = argument('minutes', 120);const cycleSeconds = argument('cycle-seconds', 600);+const heartbeatThreshold = argument('heartbeat-threshold', 30);+const requirePostThresholdUpdates = process.argv.includes('--require-post-threshold-updates');const symbol = textArgument('symbol', 'BINANCE:BTCUSDT');const timeframe = textArgument('timeframe', '1');const chartType = textArgument('chart-type', undefined);const deadline = Date.now() + minutes * 60_000;-const metrics = { cycles: 0, starts: 0, failures: 0, candleUpdates: 0, quoteUpdates: 0, heartbeats: 0, errors: [] };+const metrics = { cycles: 0, starts: 0, failures: 0, candleUpdates: 0, quoteUpdates: 0, heartbeats: 0, postThresholdCandleUpdates: 0, postThresholdQuoteUpdates: 0, errors: [] };let interrupted = false;for (const signal of ['SIGINT', 'SIGTERM']) process.once(signal, () => { interrupted = true; });@@ -35,22 +37,29 @@ function waitForCycle(ms, watchers) {}const status = setInterval(() => report('status', { ...metrics, errors: metrics.errors.slice(-3) }), 60_000);-report('start', { minutes, cycleSeconds, symbol, timeframe, chartType });+report('start', { minutes, cycleSeconds, symbol, timeframe, chartType, heartbeatThreshold, requirePostThresholdUpdates });try {while (!interrupted && Date.now() < deadline) {metrics.cycles += 1;const client = new TradingViewClient();- client.on('heartbeat', () => { metrics.heartbeats += 1; });+ let cycleHeartbeats = 0;+ client.on('heartbeat', () => { metrics.heartbeats += 1; cycleHeartbeats += 1; });client.on('error', (error) => metrics.errors.push(error.code));let candles;let quotes;try {candles = await watchCandles({ symbol, timeframe, chartType, count: 5, client }, {- onData: () => { metrics.candleUpdates += 1; },+ onData: () => {+ metrics.candleUpdates += 1;+ if (cycleHeartbeats > heartbeatThreshold) metrics.postThresholdCandleUpdates += 1;+ },onError: (error) => metrics.errors.push(error.code),});quotes = await watchQuotes({ symbols: [symbol], fields: 'price', client }, {- onData: () => { metrics.quoteUpdates += 1; },+ onData: () => {+ metrics.quoteUpdates += 1;+ if (cycleHeartbeats > heartbeatThreshold) metrics.postThresholdQuoteUpdates += 1;+ },onError: (error) => metrics.errors.push(error.code),});if (candles.latest.length !== 5 || typeof quotes.latest[symbol]?.lp !== 'number') {@@ -77,4 +86,8 @@ try {clearInterval(status);report('summary', { ...metrics, errors: metrics.errors.slice(-10), interrupted });}-if (metrics.failures || metrics.starts === 0 || metrics.quoteUpdates === 0 || metrics.candleUpdates === 0) process.exitCode = 1;+if (interrupted || metrics.failures || metrics.errors.length || metrics.starts === 0+ || metrics.quoteUpdates === 0 || metrics.candleUpdates === 0+ || (requirePostThresholdUpdates && (!metrics.postThresholdCandleUpdates || !metrics.postThresholdQuoteUpdates))) {+ process.exitCode = 1;+}diff --git a/scripts/probe-account.mjs b/scripts/probe-account.mjsnew file mode 100644index 0000000..18da57e--- /dev/null+++ b/scripts/probe-account.mjs@@ -0,0 +1,55 @@+/** Opt-in read-only diagnostics. Never print account tokens, script IDs or names. */+import { Buffer } from 'node:buffer';+import { getUser, getPrivateIndicators, getIndicatorData } from '../dist/index.js';++const positiveArgument = (name, fallback) => {+ const raw = process.argv.find((value) => value.startsWith(`--${name}=`))?.slice(name.length + 3);+ const value = raw === undefined ? fallback : Number(raw);+ if (!Number.isSafeInteger(value) || value < 1) throw new Error('Invalid probe argument');+ return value;+};++async function main() {+ const maxScripts = positiveArgument('max-scripts', 10);+ const timeoutMs = positiveArgument('timeout-ms', 30_000);+ if (!process.env.SESSION) throw new Error('SESSION is required');+ const credentials = { session: process.env.SESSION, signature: process.env.SIGNATURE };+ const options = { signal: AbortSignal.timeout(timeoutMs) };+ const user = await getUser(credentials, options);+ let planClaim = null;+ try {+ const claims = JSON.parse(Buffer.from(user.authToken.split('.')[1], 'base64url').toString());+ if (typeof claims.plan === 'string') planClaim = claims.plan;+ } catch { /* The account token is not guaranteed to remain a JWT. */ }+ console.log(JSON.stringify({ event: 'account', authenticated: true, planClaim }));+ const scripts = await getPrivateIndicators(credentials, { signal: AbortSignal.timeout(timeoutMs) });+ let failures = 0;+ const selected = scripts.slice(0, maxScripts);+ console.log(JSON.stringify({ event: 'selection', available: scripts.length, selected: selected.length }));+ for (const [index, script] of selected.entries()) {+ const classification = script.id.startsWith('USER;') ? 'user' : script.id.startsWith('PUB;') ? 'published' : 'other';+ try {+ const result = await getIndicatorData({+ symbol: 'BINANCE:BTCUSDT', timeframe: '1D', count: 100,+ indicator: script.id, credentials, timeoutMs, signal: AbortSignal.timeout(timeoutMs),+ });+ console.log(JSON.stringify({+ event: 'script', index, classification, ok: true,+ candles: result.candles.length, values: result.values.length,+ trades: result.strategyReport.trades?.length ?? 0,+ reportPresent: Object.keys(result.strategyReport.performance ?? {}).length > 0,+ }));+ } catch (error) {+ failures += 1;+ console.log(JSON.stringify({ event: 'script', index, classification, ok: false, code: error?.code ?? 'ERROR' }));+ }+ }+ console.log(JSON.stringify({ event: 'summary', checked: selected.length, failures, remaining: scripts.length - selected.length }));+ if (failures || selected.length === 0) process.exitCode = 1;+}++main().catch((error) => {+ // Do not log message/details: upstream failures may carry private script payloads.+ console.error(JSON.stringify({ event: 'failure', code: error?.code ?? 'CONFIG_OR_NETWORK_ERROR' }));+ process.exitCode = 1;+});