📈 Get real-time stocks from TradingView
TypeScript backtestingbacktesting-trading-strategiesbitcoinchartscryptocryptocurrencyethereumrealtime-stocksstocksstocks-apistocks-pricestradingtradingviewtradingview-apitradingview-indicatortradingview-replaytradingview-scraper
Start agent-friendly market data API and onboarding (#324)
Mathieu Colmonc38a5a0d09ba
diff --git a/.eslintrc.js b/.eslintrc.jsindex 7a38c63..c08bbfe 100644--- a/.eslintrc.js+++ b/.eslintrc.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewmodule.exports = {env: {commonjs: true,@@ -12,6 +14,22 @@ module.exports = {ecmaVersion: 12,requireConfigFile: false,},+ overrides: [{+ files: ['*.ts'],+ parser: '@typescript-eslint/parser',+ parserOptions: { ecmaVersion: 2022, sourceType: 'module' },+ plugins: ['@typescript-eslint'],+ rules: {+ 'no-unused-vars': 'off',+ '@typescript-eslint/no-unused-vars': 'error',+ 'no-use-before-define': 'off',+ 'no-undef': 'off',+ 'no-void': 'off',+ },+ }, {+ files: ['tests/*.ts'],+ rules: { 'max-classes-per-file': 'off' },+ }],rules: {'no-console': 'off','import/no-extraneous-dependencies': [diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.ymlindex 42df086..44d89d7 100644--- a/.github/workflows/tests.yml+++ b/.github/workflows/tests.yml@@ -1,3 +1,5 @@+# Project: https://github.com/Mathieu2301/TradingView-API+# Package: https://www.npmjs.com/package/@mathieuc/tradingviewname: Testson:@@ -34,3 +36,17 @@ jobs:env:SESSION: ${{ secrets.TW_SESSION }}SIGNATURE: ${{ secrets.TW_SIGNATURE }}++ Agent-API:+ runs-on: ubuntu-latest+ steps:+ - uses: actions/checkout@v4+ - uses: actions/setup-node@v4+ with:+ node-version: 20.x+ cache: 'npm'+ - run: npm ci+ - run: npm run build:agent+ - run: npm run lint:agent+ - run: npm test -- --run tests/agent.test.ts+ - run: npm pack --dry-rundiff --git a/.gitignore b/.gitignoreindex 713d500..a884d38 100644--- a/.gitignore+++ b/.gitignore@@ -1,2 +1,3 @@node_modules/.env+dist/diff --git a/README.md b/README.mdindex 6661000..19de8d9 100644--- a/README.md+++ b/README.md@@ -1,76 +1,94 @@-# TradingView API [](https://GitHub.com/Mathieu2301/TradingView-API/stargazers/)+# TradingView-API-[](https://github.com/Mathieu2301/TradingView-API/actions/workflows/tests.yml)-[](https://www.codefactor.io/repository/github/mathieu2301/tradingview-api/overview/main)-[](https://GitHub.com/Mathieu2301/TradingView-API/commit/)-[](https://npmjs.com/@mathieuc/tradingview)-[](https://npmjs.com/@mathieuc/tradingview)-[](https://npmjs.com/package/@mathieuc/tradingview)+<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>-Get realtime market prices and indicator values from Tradingview !+**Language:** English · [Français](docs/README.fr.md) · [Español](docs/README.es.md) · [Português](docs/README.pt.md)-## 🟢 Need help with your project?+[](https://github.com/Mathieu2301/TradingView-API/actions/workflows/tests.yml) [](https://www.npmjs.com/package/@mathieuc/tradingview) [](https://github.com/Mathieu2301/TradingView-API)-🚀 Click [here](https://forms.gle/qPp5RKo8L55C5oJE7) for personalized assistance on your project.+**Market data and indicators for builders.** Start with one chart, then grow into real-time workers, research tools, and agent-assisted workflows. This is an independent community project, not an official TradingView API.-## 🔵 Telegram group+> **Need help, found a bug, or want a feature? [Open an issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).** Questions and early ideas are welcome. You do not need a perfect reproduction before asking.-👉 To get help, exchange tips, find collaborators, developers, missions, etc...+## Choose your path-Join the Telegram group of the TradingView-API Community: [t.me/tradingview_api](https://t.me/tradingview_api)+| If you want to… | Start here |+| --- | --- |+| Use the stable npm library today | [Install](#stable-library) and browse [examples](examples) |+| Let an AI agent build with you | [Agent guide](docs/agent-api.md) — works with Claude Code, Codex, OpenClaw and similar tools |+| Avoid local setup | [Molted](https://molted.cloud/) hosts an agent workspace; ask it to work from this repository |+| Contribute or request something | [Open an issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose) |-## Features+Molted is optional. The library remains open source and usable locally. The new agent API below is **a development preview**, not yet included in the current npm release.-- [x] Premium features-- [x] Automatically backtest many strategies and try many settings in a very little time-- [x] Get drawings you made on your chart-- [x] Works with invite-only indicators-- [x] Unlimited simultaneous indicators-- [x] Realtime-- [x] Get TradingView's technical analysis-- [x] Replay mode + Fake Replay mode (for free plan)-- [x] Get values from a specific date range-- [ ] TradingView socket server emulation-- [ ] Interract with public chats-- [ ] Get Screener top values-- [ ] Get Hotlists-- [ ] Get Calendar-- IF YOU WANT A FEATURE, ASK ME !+## Stable library-## Possibilities+```bash+npm install @mathieuc/tradingview+```++```js+const TradingView = require('@mathieuc/tradingview');+const client = new TradingView.Client();+const chart = new client.Session.Chart();++chart.onError((...error) => console.error('Chart error:', ...error));+chart.onUpdate(() => {+ const latest = chart.periods[0];+ if (latest) console.log(latest.close);+});+chart.setMarket('BINANCE:BTCUSDT', { timeframe: 'D' });++// When your application is finished:+// chart.delete();+// await client.end();+```-- Trading bot-- Discord alerts-- Hard backtest-- Machine Learning based indicator-- Free replay mode for all timeframes+The existing `Client`, chart and quote sessions, Pine indicators, replay features and [examples](examples) remain available during the migration.-___+## Agent-friendly API — development preview-## Installation+The first TypeScript slice adds two simple patterns on top of the existing transport:-Stable version:+```ts+import { fetchCandles, watchCandles } from '@mathieuc/tradingview/agent';-```ruby-npm i @mathieuc/tradingview+// One-shot: data arrives through a single await; the connection closes automatically.+const candles = await fetchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', limit: 100 });+console.log(candles.at(-1)?.close);++// Worker: keeps receiving fresh snapshots until stopped.+const worker = await watchCandles(+ { symbol: 'BINANCE:BTCUSDT', timeframe: '1' },+ { onData: (snapshot) => console.log(snapshot[snapshot.length - 1]?.close),+ onError: console.error },+);+// ...later:+await worker.stop();```-Last version:+Snapshots are oldest-first, with conventional `high`/`low` fields. The first usable snapshot has a timeout (15 seconds by default), and `AbortSignal` is supported. Keep credentials in your own environment; do not put them in prompts or issues.++**Preview setup from source** (Node 18+ or Bun):-```ruby-npm i github:Mathieu2301/TradingView-API+```bash+git clone https://github.com/Mathieu2301/TradingView-API.git+cd TradingView-API+npm ci+npm run build:agent```-## Examples+From that checkout, import `./agent.js` . The stable npm package does **not** have this subpath yet; it will be released after review and validation. See the [full agent API guide](docs/agent-api.md) for error handling, lifecycle and provider adapters.-You can find all the examples and snippets in `./examples` folder.+## What is next?-## Before opening an issue+This repository is being modernized incrementally in TypeScript/Bun while keeping current users working. The first slice is data access; strategy research, backtesting, CLI/MCP and hosted workflows are **planned, not shipped**. Tell us which workflow would save you time in an [issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).-Please look at examples and previously resolved issues before opening a new one. I can't help everyone (especially for questions that are not library related but JavaScript related). Thank you for your understanding.-___+## Project links-## Problems+- [GitHub repository](https://github.com/Mathieu2301/TradingView-API)+- [npm package](https://www.npmjs.com/package/@mathieuc/tradingview)+- [Examples](examples)+- [Report a bug or ask for a feature](https://github.com/Mathieu2301/TradingView-API/issues/new/choose)- If you have errors in console or unwanted behavior,- please create an issue [here](https://github.com/Mathieu2301/Tradingview-API/issues).+TradingView is a trademark of its respective owner. This project is not affiliated with or endorsed by TradingView. Check your data provider's terms and applicable market-data permissions for your use case.diff --git a/agent.d.ts b/agent.d.tsnew file mode 100644index 0000000..6b32931--- /dev/null+++ b/agent.d.ts@@ -0,0 +1,3 @@+/** https://github.com/Mathieu2301/TradingView-API+ * https://www.npmjs.com/package/@mathieuc/tradingview */+export * from './dist/agent';diff --git a/agent.js b/agent.jsnew file mode 100644index 0000000..129c101--- /dev/null+++ b/agent.js@@ -0,0 +1,3 @@+// https://github.com/Mathieu2301/TradingView-API+// https://www.npmjs.com/package/@mathieuc/tradingview+module.exports = require('./dist/agent.js');diff --git a/agent.ts b/agent.tsnew file mode 100644index 0000000..94b047a--- /dev/null+++ b/agent.ts@@ -0,0 +1,228 @@+/**+ * Agent-friendly market data API.+ * https://github.com/Mathieu2301/TradingView-API+ * https://www.npmjs.com/package/@mathieuc/tradingview+ */++export interface Candle {+ /** Unix timestamp in seconds. */+ time: number;+ open: number;+ high: number;+ low: number;+ close: number;+ volume: number;+}++export interface CandleQuery {+ /** Exchange-qualified symbol, for example BINANCE:BTCUSDT. */+ symbol: string;+ /** TradingView resolution, for example 1, 60, D or W. */+ timeframe?: string;+ /** Requested number of historical candles; the source may return fewer. */+ limit?: number;+ /** Maximum wait for the first usable snapshot. Default: 15 seconds. */+ timeoutMs?: number;+ signal?: AbortSignal;+}++export interface CandleWorker {+ /** Most recent immutable snapshot, oldest candle first. */+ readonly latest: readonly Candle[];+ /** Idempotently release the chart session and connection. */+ stop(): Promise<void>;+}++export interface CandleHandlers {+ onData(candles: readonly Candle[]): void;+ onError?(error: Error): void;+}++/** Adapter contract for future sources; no TradingView dependency in callers. */+export interface MarketDataProvider {+ watchCandles(query: CandleQuery, handlers: CandleHandlers): Promise<CandleWorker>;+}++interface LegacyBar {+ time: number;+ open: number;+ max: number;+ min: number;+ close: number;+ volume: number;+}++interface LegacyChart {+ readonly periods: ReadonlyArray<LegacyBar>;+ setMarket(symbol: string, options: { timeframe?: string; range?: number }): void;+ onSymbolLoaded(callback: () => void): void;+ onUpdate(callback: () => void): void;+ onError(callback: (...messages: unknown[]) => void): void;+ delete(): void;+}++interface LegacyClient {+ Session: { Chart: new () => LegacyChart };+ onDisconnected(callback: () => void): void;+ onError(callback: (...messages: unknown[]) => void): void;+ end(): Promise<void>;+}++export interface TradingViewProviderOptions {+ /** Passed to the historical Client; credentials stay in the caller's environment. */+ clientOptions?: { token?: string; signature?: string; server?: 'data' | 'prodata' | 'widgetdata' };+ /** Useful for custom transports and isolated tests. */+ clientFactory?: (options: TradingViewProviderOptions['clientOptions']) => LegacyClient;+}++function asError(messages: unknown[]): Error {+ return new Error(messages.map((value) => (value instanceof Error ? value.message : String(value))).join(' '));+}++function validate(query: CandleQuery): void {+ if (!query.symbol?.trim()) throw new TypeError('symbol is required');+ if (query.limit !== undefined && (!Number.isInteger(query.limit) || query.limit < 1)) {+ throw new RangeError('limit must be a positive integer');+ }+ if (query.timeoutMs !== undefined && (!Number.isFinite(query.timeoutMs) || query.timeoutMs < 1)) {+ throw new RangeError('timeoutMs must be positive');+ }+}++/** TradingView transport, isolated from the provider-neutral agent API. */+export class TradingViewProvider implements MarketDataProvider {+ private readonly options: TradingViewProviderOptions;++ constructor(options: TradingViewProviderOptions = {}) {+ this.options = options;+ }++ async watchCandles(query: CandleQuery, handlers: CandleHandlers): Promise<CandleWorker> {+ validate(query);+ if (typeof handlers?.onData !== 'function') throw new TypeError('onData must be a function');+ if (query.signal?.aborted) throw query.signal.reason ?? new Error('Aborted');++ // The old entry point remains untouched for existing users.+ const createClient = this.options.clientFactory ?? ((options) => {+ // Resolve from dist/ after compilation; the legacy entry stays at package root.+ // eslint-disable-next-line global-require, import/no-unresolved, import/extensions+ const { Client } = require('../main.js') as {+ Client: new (clientOptions?: TradingViewProviderOptions['clientOptions']) => LegacyClient;+ };+ return new Client(options);+ });+ const client = createClient(this.options.clientOptions);+ let chart: LegacyChart;+ try {+ chart = new client.Session.Chart();+ } catch (error) {+ await client.end();+ throw error;+ }++ let active = true;+ let settled = false;+ let symbolLoaded = false;+ let latest: readonly Candle[] = [];+ let timer: ReturnType<typeof setTimeout> | undefined;+ let stopPromise: Promise<void> | undefined;+ let resolveReady!: (worker: CandleWorker) => void;+ let rejectReady!: (error: Error) => void;++ const stop = (): Promise<void> => {+ if (stopPromise) return stopPromise;+ active = false;+ if (timer) clearTimeout(timer);+ query.signal?.removeEventListener('abort', onAbort);+ stopPromise = (async () => {+ try { chart.delete(); } finally { await client.end(); }+ })();+ return stopPromise;+ };++ const worker: CandleWorker = {+ get latest() { return latest; },+ stop,+ };++ const fail = (error: Error): void => {+ if (!active) return;+ const beforeReady = !settled;+ settled = true;+ const closing = stop();+ if (beforeReady) {+ void closing.then(() => rejectReady(error), () => rejectReady(error));+ } else {+ try { handlers.onError?.(error); } catch { /* User callback must not prevent cleanup. */ }+ void closing.catch((cleanupError) => {+ try { handlers.onError?.(asError([cleanupError])); } catch { /* Already closing. */ }+ });+ }+ };++ const onAbort = (): void => fail(asError([query.signal?.reason ?? 'Aborted']));+ const emit = (): void => {+ if (!active || !symbolLoaded || chart.periods.length === 0) return;+ latest = Object.freeze(chart.periods.map((bar) => Object.freeze({+ time: bar.time,+ open: bar.open,+ high: bar.max,+ low: bar.min,+ close: bar.close,+ volume: bar.volume,+ })).sort((a, b) => a.time - b.time));+ try { handlers.onData(latest); } catch (error) {+ try { handlers.onError?.(asError([error])); } catch { /* Isolate user callbacks. */ }+ }+ if (!settled) {+ settled = true;+ if (timer) clearTimeout(timer);+ resolveReady(worker);+ }+ };++ const ready = new Promise<CandleWorker>((resolve, reject) => {+ resolveReady = resolve;+ rejectReady = reject;+ });++ chart.onSymbolLoaded(() => { symbolLoaded = true; emit(); });+ chart.onUpdate(emit);+ chart.onError((...messages) => fail(asError(messages)));+ client.onError((...messages) => fail(asError(messages)));+ client.onDisconnected(() => fail(new Error('Market data connection disconnected')));+ query.signal?.addEventListener('abort', onAbort, { once: true });+ timer = setTimeout(() => fail(new Error(`Timed out waiting for ${query.symbol} candles`)), query.timeoutMs ?? 15_000);+ try {+ chart.setMarket(query.symbol, { timeframe: query.timeframe ?? 'D', range: query.limit ?? 100 });+ } catch (error) {+ fail(asError([error]));+ }+ return ready;+ }+}++/** One-shot fetch; always closes its worker after the first usable snapshot. */+export async function fetchCandles(+ query: CandleQuery,+ provider: MarketDataProvider = new TradingViewProvider(),+): Promise<readonly Candle[]> {+ let snapshot: readonly Candle[] = [];+ const worker = await provider.watchCandles(query, {+ onData: (candles) => { snapshot = candles; },+ });+ try {+ return snapshot;+ } finally {+ await worker.stop();+ }+}++/** Start a real-time worker; call worker.stop() when finished. */+export function watchCandles(+ query: CandleQuery,+ handlers: CandleHandlers,+ provider: MarketDataProvider = new TradingViewProvider(),+): Promise<CandleWorker> {+ return provider.watchCandles(query, handlers);+}diff --git a/docs/DOCS.md b/docs/DOCS.mdindex 838390a..1abb87c 100644--- a/docs/DOCS.md+++ b/docs/DOCS.md@@ -1,3 +1,5 @@# Documentation### All the project is now JSDoc-ed :)++[Repository](https://github.com/Mathieu2301/TradingView-API) · [npm](https://www.npmjs.com/package/@mathieuc/tradingview)diff --git a/docs/README.es.md b/docs/README.es.mdnew file mode 100644index 0000000..b408909--- /dev/null+++ b/docs/README.es.md@@ -0,0 +1,52 @@+# TradingView-API++<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>++**Idioma:** [English](../README.md) · [Français](README.fr.md) · Español · [Português](README.pt.md)++**Datos de mercado e indicadores para construir tus herramientas.** Empieza con un gráfico y evoluciona hacia actualizaciones en tiempo real y flujos asistidos por agentes de IA. Proyecto comunitario independiente y no oficial.++> **¿Tienes un problema, una pregunta o una idea? [Abre un issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).** No necesitas una reproducción perfecta para preguntar.++## Elige cómo empezar++- **Biblioteca estable:** `npm install @mathieuc/tradingview` y consulta los [ejemplos](../examples).+- **Con Claude Code, Codex, OpenClaw u otro agente:** comparte la [guÃa para agentes](agent-api.md) y este repositorio.+- **Sin instalación local:** [Molted](https://molted.cloud/) ofrece un espacio de trabajo con agente alojado que puede trabajar desde este repositorio. Es opcional.++La nueva API para agentes es una **versión preliminar de desarrollo**: todavÃa no está publicada en npm.++## API actual++```js+const TradingView = require('@mathieuc/tradingview');+const client = new TradingView.Client();+const chart = new client.Session.Chart();+chart.onError((...error) => console.error(error));+chart.onUpdate(() => console.log(chart.periods[0]?.close));+chart.setMarket('BINANCE:BTCUSDT', { timeframe: 'D' });+// Al terminar: chart.delete(); await client.end();+```++La API histórica, los indicadores y los ejemplos siguen disponibles durante la migración.++## API para agentes — versión preliminar++```ts+import { fetchCandles, watchCandles } from '@mathieuc/tradingview/agent';++const candles = await fetchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', limit: 100 });+const worker = await watchCandles(+ { symbol: 'BINANCE:BTCUSDT', timeframe: '1' },+ { onData: (snapshot) => console.log(snapshot[snapshot.length - 1]), onError: console.error },+);+await worker.stop();+```++Para probarla **desde el código fuente** (Node 18+ o Bun): `git clone https://github.com/Mathieu2301/TradingView-API.git`, luego `npm ci && npm run build:agent`, e importa `./agent.js` . La ruta de importación de npm anterior solo funcionará tras publicar la próxima versión. Más detalles en la [guÃa para agentes](agent-api.md).++La modernización TypeScript/Bun es gradual. Investigación de estrategias, backtesting, CLI/MCP y flujos alojados están **previstos, no disponibles aún**. [Cuéntanos qué necesitas](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).++[Repositorio GitHub](https://github.com/Mathieu2301/TradingView-API) · [Paquete npm](https://www.npmjs.com/package/@mathieuc/tradingview) · [Issues](https://github.com/Mathieu2301/TradingView-API/issues/new/choose)++TradingView es una marca de su propietario. Este proyecto no está afiliado ni respaldado por TradingView. Comprueba los términos y permisos de datos de tu proveedor.diff --git a/docs/README.fr.md b/docs/README.fr.mdnew file mode 100644index 0000000..5ac2be3--- /dev/null+++ b/docs/README.fr.md@@ -0,0 +1,52 @@+# TradingView-API++<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>++**Langue :** [English](../README.md) · Français · [Español](README.es.md) · [Português](README.pt.md)++**Des données de marché et des indicateurs pour construire vos outils.** Commencez avec un graphique, puis passez aux mises à jour temps réel et aux workflows assistés par agent IA. Projet communautaire indépendant, non officiel.++> **Un problème, une question ou une idée ? [Ouvrez une issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).** Pas besoin d'avoir déjà une reproduction parfaite.++## Choisissez votre parcours++- **Librairie stable aujourd'hui :** `npm install @mathieuc/tradingview` puis consultez les [exemples](../examples).+- **Avec Claude Code, Codex, OpenClaw ou un autre agent :** donnez-lui le [guide agentique](agent-api.md) et ce dépôt.+- **Sans installation locale :** [Molted](https://molted.cloud/) propose un espace d'agent hébergé pouvant travailler à partir de ce dépôt. Ce choix est facultatif.++La nouvelle API agentique est **en préversion de développement** : elle n'est pas encore publiée sur npm.++## API actuelle++```js+const TradingView = require('@mathieuc/tradingview');+const client = new TradingView.Client();+const chart = new client.Session.Chart();+chart.onError((...error) => console.error(error));+chart.onUpdate(() => console.log(chart.periods[0]?.close));+chart.setMarket('BINANCE:BTCUSDT', { timeframe: 'D' });+// À la fin : chart.delete(); await client.end();+```++L'API historique, les indicateurs et les exemples restent disponibles pendant la migration.++## API pour agents — préversion++```ts+import { fetchCandles, watchCandles } from '@mathieuc/tradingview/agent';++const candles = await fetchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', limit: 100 });+const worker = await watchCandles(+ { symbol: 'BINANCE:BTCUSDT', timeframe: '1' },+ { onData: (snapshot) => console.log(snapshot[snapshot.length - 1]), onError: console.error },+);+await worker.stop();+```++Pour l'essayer **depuis le code source** (Node 18+ ou Bun) : `git clone https://github.com/Mathieu2301/TradingView-API.git`, puis `npm ci && npm run build:agent`, et importez `./agent.js` . Le sous-chemin npm ci-dessus ne sera disponible qu'après publication de la prochaine version. Détails : [guide agentique](agent-api.md).++La modernisation TypeScript/Bun est progressive. Recherche de stratégies, backtests, CLI/MCP et workflows hébergés sont **prévus, pas encore livrés**. [Dites-nous ce dont vous avez besoin](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).++[Dépôt GitHub](https://github.com/Mathieu2301/TradingView-API) · [Package npm](https://www.npmjs.com/package/@mathieuc/tradingview) · [Issues](https://github.com/Mathieu2301/TradingView-API/issues/new/choose)++TradingView est une marque de son propriétaire. Ce projet n'est ni affilié ni approuvé par TradingView. Vérifiez les conditions d'utilisation et droits sur les données de votre fournisseur.diff --git a/docs/README.pt.md b/docs/README.pt.mdnew file mode 100644index 0000000..b508f42--- /dev/null+++ b/docs/README.pt.md@@ -0,0 +1,52 @@+# TradingView-API++<a href="https://trendshift.io/repositories/26416?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-26416" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/26416" alt="Mathieu2301/TradingView-API | #1 Repo Of The Day on Trendshift" width="250" height="55"/></a>++**Idioma:** [English](../README.md) · [Français](README.fr.md) · [Español](README.es.md) · Português++**Dados de mercado e indicadores para criar suas ferramentas.** Comece com um gráfico e avance para atualizações em tempo real e fluxos assistidos por agentes de IA. Projeto comunitário independente e não oficial.++> **Encontrou um problema, tem uma dúvida ou uma ideia? [Abra uma issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).** Não é preciso ter uma reprodução perfeita para perguntar.++## Escolha por onde começar++- **Biblioteca estável:** `npm install @mathieuc/tradingview` e veja os [exemplos](../examples).+- **Com Claude Code, Codex, OpenClaw ou outro agente:** compartilhe o [guia para agentes](agent-api.md) e este repositório.+- **Sem instalação local:** [Molted](https://molted.cloud/) oferece um espaço de trabalho com agente hospedado que pode trabalhar a partir deste repositório. É opcional.++A nova API para agentes está em **prévia de desenvolvimento**: ainda não foi publicada no npm.++## API atual++```js+const TradingView = require('@mathieuc/tradingview');+const client = new TradingView.Client();+const chart = new client.Session.Chart();+chart.onError((...error) => console.error(error));+chart.onUpdate(() => console.log(chart.periods[0]?.close));+chart.setMarket('BINANCE:BTCUSDT', { timeframe: 'D' });+// Ao terminar: chart.delete(); await client.end();+```++A API histórica, os indicadores e os exemplos continuam disponÃveis durante a migração.++## API para agentes — prévia++```ts+import { fetchCandles, watchCandles } from '@mathieuc/tradingview/agent';++const candles = await fetchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', limit: 100 });+const worker = await watchCandles(+ { symbol: 'BINANCE:BTCUSDT', timeframe: '1' },+ { onData: (snapshot) => console.log(snapshot[snapshot.length - 1]), onError: console.error },+);+await worker.stop();+```++Para testar **a partir do código-fonte** (Node 18+ ou Bun): `git clone https://github.com/Mathieu2301/TradingView-API.git`, depois `npm ci && npm run build:agent`, e importe `./agent.js` . O caminho npm acima só estará disponÃvel após a próxima publicação. Mais detalhes no [guia para agentes](agent-api.md).++A modernização TypeScript/Bun é gradual. Pesquisa de estratégias, backtests, CLI/MCP e fluxos hospedados estão **planejados, ainda não disponÃveis**. [Conte o que você precisa](https://github.com/Mathieu2301/TradingView-API/issues/new/choose).++[Repositório GitHub](https://github.com/Mathieu2301/TradingView-API) · [Pacote npm](https://www.npmjs.com/package/@mathieuc/tradingview) · [Issues](https://github.com/Mathieu2301/TradingView-API/issues/new/choose)++TradingView é uma marca de seu proprietário. Este projeto não é afiliado nem endossado pela TradingView. Verifique os termos e direitos sobre os dados do seu provedor.diff --git a/docs/agent-api.md b/docs/agent-api.mdnew file mode 100644index 0000000..5e91e6b--- /dev/null+++ b/docs/agent-api.md@@ -0,0 +1,55 @@+# Agent API guide++[Repository](https://github.com/Mathieu2301/TradingView-API) · [npm package](https://www.npmjs.com/package/@mathieuc/tradingview) · [Open an issue](https://github.com/Mathieu2301/TradingView-API/issues/new/choose)++This is a **development preview**. Build it from source with `npm ci && npm run build:agent`; the current npm release does not include `@mathieuc/tradingview/agent` yet. The historic `require('@mathieuc/tradingview')` API is unchanged.++## One-shot++```ts+import { fetchCandles } from './agent.js';++const controller = new AbortController();+const candles = await fetchCandles({+ symbol: 'BINANCE:BTCUSDT',+ timeframe: 'D',+ limit: 100,+ timeoutMs: 15_000,+ signal: controller.signal,+});+```++`fetchCandles` returns a chronological array of `{time, open, high, low, close, volume}`. `time` is a Unix timestamp in seconds. It closes the underlying chart session and connection even after a failed first fetch.++## Realtime worker++```ts+import { watchCandles } from './agent.js';++const worker = await watchCandles(+ { symbol: 'BINANCE:BTCUSDT', timeframe: '1' },+ {+ onData(snapshot) {+ console.log(snapshot[snapshot.length - 1]);+ },+ onError(error) {+ console.error(error);+ },+ },+);++try {+ // Keep doing work; each update brings a fresh full snapshot.+ console.log(worker.latest);+} finally {+ await worker.stop(); // Safe to call more than once.+}+```++`watchCandles` resolves after the first nonempty snapshot, then continues delivering snapshots. It rejects on initial timeout, chart/client error or disconnect. After startup, errors go to `onError`; the worker closes itself on transport failure. Abort with `signal` or call `stop()` to release resources.++## Providers++`MarketDataProvider` is a small adapter contract. `TradingViewProvider` is the first implementation. Applications can inject another provider into `fetchCandles(query, provider)` or `watchCandles(query, handlers, provider)` without changing their callers. The same interface makes isolated agent tests possible without network traffic.++Use only accounts and data sources for which you have the necessary permissions. Never paste session cookies or API keys into issues, source files, or agent instructions.diff --git a/examples/AllPrivateIndicators.js b/examples/AllPrivateIndicators.jsindex 8a63b44..5122e5f 100644--- a/examples/AllPrivateIndicators.js+++ b/examples/AllPrivateIndicators.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/BuiltInIndicator.js b/examples/BuiltInIndicator.jsindex 1dd6804..d805881 100644--- a/examples/BuiltInIndicator.js+++ b/examples/BuiltInIndicator.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/CustomChartType.js b/examples/CustomChartType.jsindex 3119bfe..62cf4c3 100644--- a/examples/CustomChartType.js+++ b/examples/CustomChartType.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/CustomTimeframe.js b/examples/CustomTimeframe.jsindex 395da8b..1571784 100644--- a/examples/CustomTimeframe.js+++ b/examples/CustomTimeframe.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/Errors.js b/examples/Errors.jsindex 4ecd104..1770e66 100644--- a/examples/Errors.js+++ b/examples/Errors.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/FakeReplayMode.js b/examples/FakeReplayMode.jsindex 3961ffb..09730cb 100644--- a/examples/FakeReplayMode.js+++ b/examples/FakeReplayMode.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst { Client } = require('../main');/**diff --git a/examples/FromToData.js b/examples/FromToData.jsindex b818aa9..9d2b406 100644--- a/examples/FromToData.js+++ b/examples/FromToData.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/GetDrawings.js b/examples/GetDrawings.jsindex c12c9e1..40457d3 100644--- a/examples/GetDrawings.js+++ b/examples/GetDrawings.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/GraphicIndicator.js b/examples/GraphicIndicator.jsindex 95ef865..88a609b 100644--- a/examples/GraphicIndicator.js+++ b/examples/GraphicIndicator.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/MultipleSyncFetch.js b/examples/MultipleSyncFetch.jsindex a1dbf89..a6ee5a0 100644--- a/examples/MultipleSyncFetch.js+++ b/examples/MultipleSyncFetch.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/PinePermManage.js b/examples/PinePermManage.jsindex 5ec5640..9ac3320 100644--- a/examples/PinePermManage.js+++ b/examples/PinePermManage.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst { PinePermManager } = require('../main');/**diff --git a/examples/ReplayMode.js b/examples/ReplayMode.jsindex 236f542..853f768 100644--- a/examples/ReplayMode.js+++ b/examples/ReplayMode.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/Search.js b/examples/Search.jsindex e40c9bf..724d2dd 100644--- a/examples/Search.js+++ b/examples/Search.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/SimpleChart.js b/examples/SimpleChart.jsindex 877029d..7ca8c67 100644--- a/examples/SimpleChart.js+++ b/examples/SimpleChart.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/examples/UserLogin.js b/examples/UserLogin.jsindex 1aeb43a..cf7a0bd 100644--- a/examples/UserLogin.js+++ b/examples/UserLogin.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TradingView = require('../main');/**diff --git a/llms.txt b/llms.txtnew file mode 100644index 0000000..059fe8d--- /dev/null+++ b/llms.txt@@ -0,0 +1,12 @@+# TradingView-API+# https://github.com/Mathieu2301/TradingView-API+# https://www.npmjs.com/package/@mathieuc/tradingview++Independent community library for market data and indicators. Not an official TradingView API.+Stable npm entry point: require('@mathieuc/tradingview').+Development-preview agent API: agent.ts / agent.js, built with npm run build:agent.+One-shot: fetchCandles({ symbol, timeframe?, limit?, timeoutMs?, signal? }).+Realtime: await watchCandles(query, { onData, onError? }); await worker.stop().+Full guide: docs/agent-api.md. Human guide: README.md. Examples: examples/.+MCP, CLI, backtesting and hosted trading API are not shipped. Do not claim otherwise.+Questions and bugs: https://github.com/Mathieu2301/TradingView-API/issues/new/choosediff --git a/main.js b/main.jsindex 721ab7a..c1b7a9a 100644--- a/main.js+++ b/main.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst miscRequests = require('./src/miscRequests');const Client = require('./src/client');const BuiltInIndicator = require('./src/classes/BuiltInIndicator');diff --git a/package-lock.json b/package-lock.jsonindex e75f9dd..f298d5d 100644--- a/package-lock.json+++ b/package-lock.json@@ -16,10 +16,14 @@"devDependencies": {"@babel/eslint-parser": "^7.15.7","@mathieuc/console": "^1.0.1",+ "@types/node": "^20.19.43",+ "@typescript-eslint/eslint-plugin": "^5.62.0",+ "@typescript-eslint/parser": "^5.62.0","dotenv": "^16.3.1","eslint": "^7.25.0","eslint-config-airbnb-base": "^14.2.1","eslint-plugin-import": "^2.22.1",+ "typescript": "^5.9.3","vitest": "^0.31.4"},"engines": {@@ -893,6 +897,48 @@"node": ">=12"}},+ "node_modules/@eslint-community/eslint-utils": {+ "version": "4.10.1",+ "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.10.1.tgz",+ "integrity": "sha512-cuadcxVFE8sDK6iWJbs8Sn0av2Nrh2QSGQhVlBW9AaAHqHwjWsZHT8LJ4hFGPh7ASBV2deFdM7H/DPjulmh8rg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "eslint-visitor-keys": "^3.4.3"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "url": "https://opencollective.com/eslint"+ },+ "peerDependencies": {+ "eslint": "^6.0.0 || ^7.0.0 || >=8.0.0"+ }+ },+ "node_modules/@eslint-community/eslint-utils/node_modules/eslint-visitor-keys": {+ "version": "3.4.3",+ "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",+ "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",+ "dev": true,+ "license": "Apache-2.0",+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "url": "https://opencollective.com/eslint"+ }+ },+ "node_modules/@eslint-community/regexpp": {+ "version": "4.12.2",+ "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz",+ "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": "^12.0.0 || ^14.0.0 || >=16.0.0"+ }+ },"node_modules/@eslint/eslintrc": {"version": "0.4.3","resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-0.4.3.tgz",@@ -981,6 +1027,44 @@"integrity": "sha512-5bSZojJFnxW5rJvipePACJUkIpQBbpQNyImIutEaERO6xkTuMGH3JrW6lxfPddY9vHIbNr+lBjPsCo9Zg3I/eQ==","dev": true},+ "node_modules/@nodelib/fs.scandir": {+ "version": "2.1.5",+ "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",+ "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@nodelib/fs.stat": "2.0.5",+ "run-parallel": "^1.1.9"+ },+ "engines": {+ "node": ">= 8"+ }+ },+ "node_modules/@nodelib/fs.stat": {+ "version": "2.0.5",+ "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",+ "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 8"+ }+ },+ "node_modules/@nodelib/fs.walk": {+ "version": "1.2.8",+ "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",+ "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@nodelib/fs.scandir": "2.1.5",+ "fastq": "^1.6.0"+ },+ "engines": {+ "node": ">= 8"+ }+ },"node_modules/@types/chai": {"version": "4.3.5","resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.5.tgz",@@ -996,14 +1080,247 @@"@types/chai": "*"}},+ "node_modules/@types/json-schema": {+ "version": "7.0.15",+ "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",+ "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",+ "dev": true,+ "license": "MIT"+ },"node_modules/@types/node": {- "version": "22.5.4",- "resolved": "https://registry.npmjs.org/@types/node/-/node-22.5.4.tgz",- "integrity": "sha512-FDuKUJQm/ju9fT/SeX/6+gBzoPzlVCzfzmGkwKvRHQVxi4BntVbyIwf6a4Xn62mrvndLiml6z/UBXIdEVjQLXg==",+ "version": "20.19.43",+ "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.43.tgz",+ "integrity": "sha512-6oYBAi5ikg4Pl+kGsoYtawUMBT2zZMCvPNF7pVLnHZfd1zf38DRiWn/gT01RYCdUqkv7Fhr+C9ot4/tb+2sVvA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "undici-types": "~6.21.0"+ }+ },+ "node_modules/@types/semver": {+ "version": "7.8.0",+ "resolved": "https://registry.npmjs.org/@types/semver/-/semver-7.8.0.tgz",+ "integrity": "sha512-1mAINjtQCXXeLkJ9ehXkwOcBpqtLxiVtKhpUf83DdRNdQKV0iXZpaHYqRr7nj+wvxuJzoAmAwXI+sCNMv1CzLQ==",+ "dev": true,+ "license": "MIT"+ },+ "node_modules/@typescript-eslint/eslint-plugin": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-5.62.0.tgz",+ "integrity": "sha512-TiZzBSJja/LbhNPvk6yc0JrX9XqhQ0hdh6M2svYfsHGejaKFIAGd9MQ+ERIMzLGlN/kZoYIgdxFV0PuljTKXag==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@eslint-community/regexpp": "^4.4.0",+ "@typescript-eslint/scope-manager": "5.62.0",+ "@typescript-eslint/type-utils": "5.62.0",+ "@typescript-eslint/utils": "5.62.0",+ "debug": "^4.3.4",+ "graphemer": "^1.4.0",+ "ignore": "^5.2.0",+ "natural-compare-lite": "^1.4.0",+ "semver": "^7.3.7",+ "tsutils": "^3.21.0"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ },+ "peerDependencies": {+ "@typescript-eslint/parser": "^5.0.0",+ "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0"+ },+ "peerDependenciesMeta": {+ "typescript": {+ "optional": true+ }+ }+ },+ "node_modules/@typescript-eslint/eslint-plugin/node_modules/ignore": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",+ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 4"+ }+ },+ "node_modules/@typescript-eslint/parser": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-5.62.0.tgz",+ "integrity": "sha512-VlJEV0fOQ7BExOsHYAGrgbEiZoi8D+Bl2+f6V2RrXerRSylnp+ZBHmPvaIa8cz0Ajx7WO7Z5RqfgYg7ED1nRhA==",+ "dev": true,+ "license": "BSD-2-Clause",+ "dependencies": {+ "@typescript-eslint/scope-manager": "5.62.0",+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/typescript-estree": "5.62.0",+ "debug": "^4.3.4"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ },+ "peerDependencies": {+ "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0"+ },+ "peerDependenciesMeta": {+ "typescript": {+ "optional": true+ }+ }+ },+ "node_modules/@typescript-eslint/scope-manager": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-5.62.0.tgz",+ "integrity": "sha512-VXuvVvZeQCQb5Zgf4HAxc04q5j+WrNAtNh9OwCsCgpKqESMTu3tF/jhZ3xG6T4NZwWl65Bg8KuS2uEvhSfLl0w==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/visitor-keys": "5.62.0"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ }+ },+ "node_modules/@typescript-eslint/type-utils": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-5.62.0.tgz",+ "integrity": "sha512-xsSQreu+VnfbqQpW5vnCJdq1Z3Q0U31qiWmRhr98ONQmcp/yhiPJFPq8MXiJVLiksmOKSjIldZzkebzHuCGzew==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@typescript-eslint/typescript-estree": "5.62.0",+ "@typescript-eslint/utils": "5.62.0",+ "debug": "^4.3.4",+ "tsutils": "^3.21.0"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ },+ "peerDependencies": {+ "eslint": "*"+ },+ "peerDependenciesMeta": {+ "typescript": {+ "optional": true+ }+ }+ },+ "node_modules/@typescript-eslint/types": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-5.62.0.tgz",+ "integrity": "sha512-87NVngcbVXUahrRTqIK27gD2t5Cu1yuCXxbLcFtCzZGlfyVWWh8mLHkoxzjsB6DDNnvdL+fW8MiwPEJyGJQDgQ==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ }+ },+ "node_modules/@typescript-eslint/typescript-estree": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-5.62.0.tgz",+ "integrity": "sha512-CmcQ6uY7b9y694lKdRB8FEel7JbU/40iSAPomu++SjLMntB+2Leay2LO6i8VnJk58MtE9/nQSFIH6jpyRWyYzA==",+ "dev": true,+ "license": "BSD-2-Clause",+ "dependencies": {+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/visitor-keys": "5.62.0",+ "debug": "^4.3.4",+ "globby": "^11.1.0",+ "is-glob": "^4.0.3",+ "semver": "^7.3.7",+ "tsutils": "^3.21.0"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ },+ "peerDependenciesMeta": {+ "typescript": {+ "optional": true+ }+ }+ },+ "node_modules/@typescript-eslint/utils": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-5.62.0.tgz",+ "integrity": "sha512-n8oxjeb5aIbPFEtmQxQYOLI0i9n5ySBEY/ZEHHZqKQSFnxio1rv6dthascc9dLuwrL0RC5mPCxB7vnAVGAYWAQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@eslint-community/eslint-utils": "^4.2.0",+ "@types/json-schema": "^7.0.9",+ "@types/semver": "^7.3.12",+ "@typescript-eslint/scope-manager": "5.62.0",+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/typescript-estree": "5.62.0",+ "eslint-scope": "^5.1.1",+ "semver": "^7.3.7"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ },+ "peerDependencies": {+ "eslint": "^6.0.0 || ^7.0.0 || ^8.0.0"+ }+ },+ "node_modules/@typescript-eslint/visitor-keys": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-5.62.0.tgz",+ "integrity": "sha512-07ny+LHRzQXepkGg6w0mFY41fVUNBrL2Roj/++7V1txKugfjm/Ci/qSND03r2RhlJhJYMcTn9AhhSSqQp0Ysyw==","dev": true,"license": "MIT","dependencies": {- "undici-types": "~6.19.2"+ "@typescript-eslint/types": "5.62.0",+ "eslint-visitor-keys": "^3.3.0"+ },+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "type": "opencollective",+ "url": "https://opencollective.com/typescript-eslint"+ }+ },+ "node_modules/@typescript-eslint/visitor-keys/node_modules/eslint-visitor-keys": {+ "version": "3.4.3",+ "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",+ "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",+ "dev": true,+ "license": "Apache-2.0",+ "engines": {+ "node": "^12.22.0 || ^14.17.0 || >=16.0.0"+ },+ "funding": {+ "url": "https://opencollective.com/eslint"}},"node_modules/@vitest/expect": {@@ -1219,6 +1536,16 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/array-union": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",+ "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=8"+ }+ },"node_modules/array.prototype.flat": {"version": "1.2.4","resolved": "https://registry.npmjs.org/array.prototype.flat/-/array.prototype.flat-1.2.4.tgz",@@ -1295,6 +1622,19 @@"concat-map": "0.0.1"}},+ "node_modules/braces": {+ "version": "3.0.3",+ "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",+ "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "fill-range": "^7.1.1"+ },+ "engines": {+ "node": ">=8"+ }+ },"node_modules/browserslist": {"version": "4.17.2","resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.17.2.tgz",@@ -1590,6 +1930,29 @@"node": ">=0.4.0"}},+ "node_modules/dir-glob": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",+ "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "path-type": "^4.0.0"+ },+ "engines": {+ "node": ">=8"+ }+ },+ "node_modules/dir-glob/node_modules/path-type": {+ "version": "4.0.0",+ "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",+ "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=8"+ }+ },"node_modules/doctrine": {"version": "3.0.0","resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz",@@ -2146,6 +2509,23 @@"integrity": "sha512-VxPP4NqbUjj6MaAOafWeUn2cXWLcCtljklUtZf0Ind4XQ+QPtmA0b18zZy0jIQx+ExRVCR/ZQpBmik5lXshNsw==","dev": true},+ "node_modules/fast-glob": {+ "version": "3.3.3",+ "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",+ "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "@nodelib/fs.stat": "^2.0.2",+ "@nodelib/fs.walk": "^1.2.3",+ "glob-parent": "^5.1.2",+ "merge2": "^1.3.0",+ "micromatch": "^4.0.8"+ },+ "engines": {+ "node": ">=8.6.0"+ }+ },"node_modules/fast-json-stable-stringify": {"version": "2.1.0","resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",@@ -2175,6 +2555,16 @@],"license": "BSD-3-Clause"},+ "node_modules/fastq": {+ "version": "1.20.3",+ "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz",+ "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==",+ "dev": true,+ "license": "ISC",+ "dependencies": {+ "reusify": "^1.0.4"+ }+ },"node_modules/file-entry-cache": {"version": "6.0.1","resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz",@@ -2187,6 +2577,19 @@"node": "^10.12.0 || >=12.0.0"}},+ "node_modules/fill-range": {+ "version": "7.1.1",+ "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",+ "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "to-regex-range": "^5.0.1"+ },+ "engines": {+ "node": ">=8"+ }+ },"node_modules/find-up": {"version": "2.1.0","resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz",@@ -2394,6 +2797,37 @@"url": "https://github.com/sponsors/sindresorhus"}},+ "node_modules/globby": {+ "version": "11.1.0",+ "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz",+ "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "array-union": "^2.1.0",+ "dir-glob": "^3.0.1",+ "fast-glob": "^3.2.9",+ "ignore": "^5.2.0",+ "merge2": "^1.4.1",+ "slash": "^3.0.0"+ },+ "engines": {+ "node": ">=10"+ },+ "funding": {+ "url": "https://github.com/sponsors/sindresorhus"+ }+ },+ "node_modules/globby/node_modules/ignore": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",+ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 4"+ }+ },"node_modules/gopd": {"version": "1.2.0","resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",@@ -2412,6 +2846,13 @@"integrity": "sha512-nTnJ528pbqxYanhpDYsi4Rd8MAeaBA67+RZ10CM1m3bTAVFEDcd5AuA4a6W5YkGZ1iNXHzZz8T6TBKLeBuNriQ==","dev": true},+ "node_modules/graphemer": {+ "version": "1.4.0",+ "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",+ "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==",+ "dev": true,+ "license": "MIT"+ },"node_modules/has": {"version": "1.0.3","resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz",@@ -2626,10 +3067,11 @@}},"node_modules/is-glob": {- "version": "4.0.1",- "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.1.tgz",- "integrity": "sha512-5G0tKtBTFImOqDnLB2hG6Bp2qcKEFduo4tZu9MT/H6NQv/ghhy30o55ufafxJ/LdH79LLs2Kfrn85TLKyA7BUg==",+ "version": "4.0.3",+ "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",+ "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==","dev": true,+ "license": "MIT","dependencies": {"is-extglob": "^2.1.1"},@@ -2649,6 +3091,16 @@"url": "https://github.com/sponsors/ljharb"}},+ "node_modules/is-number": {+ "version": "7.0.0",+ "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",+ "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=0.12.0"+ }+ },"node_modules/is-number-object": {"version": "1.0.5","resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.0.5.tgz",@@ -2925,6 +3377,30 @@"node": ">=8"}},+ "node_modules/merge2": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",+ "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">= 8"+ }+ },+ "node_modules/micromatch": {+ "version": "4.0.8",+ "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",+ "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "braces": "^3.0.3",+ "picomatch": "^2.3.1"+ },+ "engines": {+ "node": ">=8.6"+ }+ },"node_modules/mime-db": {"version": "1.52.0","resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",@@ -3029,6 +3505,13 @@"integrity": "sha1-Sr6/7tdUHywnrPspvbvRXI1bpPc=","dev": true},+ "node_modules/natural-compare-lite": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/natural-compare-lite/-/natural-compare-lite-1.4.1.tgz",+ "integrity": "sha512-8Mz06azhPqiDlxhUaUTjBhNAbib/1MoPr89kgmuV6Ir8ICT2/Q/XSYg6VfL3fq2x8MpSQX8sqyI/NeZ5GsGyXA==",+ "dev": true,+ "license": "MIT"+ },"node_modules/node-releases": {"version": "1.1.77","resolved": "https://registry.npmjs.org/node-releases/-/node-releases-1.1.77.tgz",@@ -3283,6 +3766,19 @@"dev": true,"license": "ISC"},+ "node_modules/picomatch": {+ "version": "2.3.2",+ "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",+ "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=8.6"+ },+ "funding": {+ "url": "https://github.com/sponsors/jonschlinkert"+ }+ },"node_modules/pify": {"version": "3.0.0","resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz",@@ -3420,6 +3916,27 @@"node": ">=6"}},+ "node_modules/queue-microtask": {+ "version": "1.2.3",+ "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",+ "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/feross"+ },+ {+ "type": "patreon",+ "url": "https://www.patreon.com/feross"+ },+ {+ "type": "consulting",+ "url": "https://feross.org/support"+ }+ ],+ "license": "MIT"+ },"node_modules/react-is": {"version": "17.0.2","resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",@@ -3510,6 +4027,17 @@"node": ">=4"}},+ "node_modules/reusify": {+ "version": "1.1.0",+ "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",+ "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "iojs": ">=1.0.0",+ "node": ">=0.10.0"+ }+ },"node_modules/rimraf": {"version": "3.0.2","resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",@@ -3542,6 +4070,30 @@"fsevents": "~2.3.2"}},+ "node_modules/run-parallel": {+ "version": "1.2.0",+ "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",+ "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",+ "dev": true,+ "funding": [+ {+ "type": "github",+ "url": "https://github.com/sponsors/feross"+ },+ {+ "type": "patreon",+ "url": "https://www.patreon.com/feross"+ },+ {+ "type": "consulting",+ "url": "https://feross.org/support"+ }+ ],+ "license": "MIT",+ "dependencies": {+ "queue-microtask": "^1.2.2"+ }+ },"node_modules/safe-buffer": {"version": "5.1.2","resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",@@ -3595,6 +4147,16 @@"integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==","dev": true},+ "node_modules/slash": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",+ "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",+ "dev": true,+ "license": "MIT",+ "engines": {+ "node": ">=8"+ }+ },"node_modules/slice-ansi": {"version": "4.0.0","resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-4.0.0.tgz",@@ -3879,6 +4441,19 @@"node": ">=14.0.0"}},+ "node_modules/to-regex-range": {+ "version": "5.0.1",+ "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",+ "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "is-number": "^7.0.0"+ },+ "engines": {+ "node": ">=8.0"+ }+ },"node_modules/tsconfig-paths": {"version": "3.10.1","resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.10.1.tgz",@@ -3890,6 +4465,29 @@"strip-bom": "^3.0.0"}},+ "node_modules/tslib": {+ "version": "1.14.1",+ "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",+ "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",+ "dev": true,+ "license": "0BSD"+ },+ "node_modules/tsutils": {+ "version": "3.21.0",+ "resolved": "https://registry.npmjs.org/tsutils/-/tsutils-3.21.0.tgz",+ "integrity": "sha512-mHKK3iUXL+3UF6xL5k0PEhKRUBKPBCv/+RkEOpjRWxxx27KKRBmmA60A9pgOUvMi8GKhRMPEmjBRPzs2W7O1OA==",+ "dev": true,+ "license": "MIT",+ "dependencies": {+ "tslib": "^1.8.1"+ },+ "engines": {+ "node": ">= 6"+ },+ "peerDependencies": {+ "typescript": ">=2.8.0 || >= 3.2.0-dev || >= 3.3.0-dev || >= 3.4.0-dev || >= 3.5.0-dev || >= 3.6.0-dev || >= 3.6.0-beta || >= 3.7.0-dev || >= 3.7.0-beta"+ }+ },"node_modules/type-check": {"version": "0.4.0","resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",@@ -3924,6 +4522,20 @@"url": "https://github.com/sponsors/sindresorhus"}},+ "node_modules/typescript": {+ "version": "5.9.3",+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",+ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",+ "dev": true,+ "license": "Apache-2.0",+ "bin": {+ "tsc": "bin/tsc",+ "tsserver": "bin/tsserver"+ },+ "engines": {+ "node": ">=14.17"+ }+ },"node_modules/ufo": {"version": "1.5.4","resolved": "https://registry.npmjs.org/ufo/-/ufo-1.5.4.tgz",@@ -3947,9 +4559,9 @@}},"node_modules/undici-types": {- "version": "6.19.8",- "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",- "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",+ "version": "6.21.0",+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",+ "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==","dev": true,"license": "MIT"},@@ -4809,6 +5421,29 @@"dev": true,"optional": true},+ "@eslint-community/eslint-utils": {+ "version": "4.10.1",+ "resolved": "https://registry.npmjs.org/@eslint-community/eslint-utils/-/eslint-utils-4.10.1.tgz",+ "integrity": "sha512-cuadcxVFE8sDK6iWJbs8Sn0av2Nrh2QSGQhVlBW9AaAHqHwjWsZHT8LJ4hFGPh7ASBV2deFdM7H/DPjulmh8rg==",+ "dev": true,+ "requires": {+ "eslint-visitor-keys": "^3.4.3"+ },+ "dependencies": {+ "eslint-visitor-keys": {+ "version": "3.4.3",+ "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",+ "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",+ "dev": true+ }+ }+ },+ "@eslint-community/regexpp": {+ "version": "4.12.2",+ "resolved": "https://registry.npmjs.org/@eslint-community/regexpp/-/regexpp-4.12.2.tgz",+ "integrity": "sha512-EriSTlt5OC9/7SXkRSCAhfSxxoSUgBm33OH+IkwbdpgoqsSsUg7y3uh+IICI/Qg4BBWr3U2i39RpmycbxMq4ew==",+ "dev": true+ },"@eslint/eslintrc": {"version": "0.4.3","resolved": "https://registry.npmjs.org/@eslint/eslintrc/-/eslintrc-0.4.3.tgz",@@ -4884,6 +5519,32 @@"integrity": "sha512-5bSZojJFnxW5rJvipePACJUkIpQBbpQNyImIutEaERO6xkTuMGH3JrW6lxfPddY9vHIbNr+lBjPsCo9Zg3I/eQ==","dev": true},+ "@nodelib/fs.scandir": {+ "version": "2.1.5",+ "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz",+ "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==",+ "dev": true,+ "requires": {+ "@nodelib/fs.stat": "2.0.5",+ "run-parallel": "^1.1.9"+ }+ },+ "@nodelib/fs.stat": {+ "version": "2.0.5",+ "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz",+ "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==",+ "dev": true+ },+ "@nodelib/fs.walk": {+ "version": "1.2.8",+ "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz",+ "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==",+ "dev": true,+ "requires": {+ "@nodelib/fs.scandir": "2.1.5",+ "fastq": "^1.6.0"+ }+ },"@types/chai": {"version": "4.3.5","resolved": "https://registry.npmjs.org/@types/chai/-/chai-4.3.5.tgz",@@ -4899,13 +5560,140 @@"@types/chai": "*"}},+ "@types/json-schema": {+ "version": "7.0.15",+ "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.15.tgz",+ "integrity": "sha512-5+fP8P8MFNC+AyZCDxrB2pkZFPGzqQWUzpSeuuVLvm8VMcorNYavBqoFcxK8bQz4Qsbn4oUEEem4wDLfcysGHA==",+ "dev": true+ },"@types/node": {- "version": "22.5.4",- "resolved": "https://registry.npmjs.org/@types/node/-/node-22.5.4.tgz",- "integrity": "sha512-FDuKUJQm/ju9fT/SeX/6+gBzoPzlVCzfzmGkwKvRHQVxi4BntVbyIwf6a4Xn62mrvndLiml6z/UBXIdEVjQLXg==",+ "version": "20.19.43",+ "resolved": "https://registry.npmjs.org/@types/node/-/node-20.19.43.tgz",+ "integrity": "sha512-6oYBAi5ikg4Pl+kGsoYtawUMBT2zZMCvPNF7pVLnHZfd1zf38DRiWn/gT01RYCdUqkv7Fhr+C9ot4/tb+2sVvA==","dev": true,"requires": {- "undici-types": "~6.19.2"+ "undici-types": "~6.21.0"+ }+ },+ "@types/semver": {+ "version": "7.8.0",+ "resolved": "https://registry.npmjs.org/@types/semver/-/semver-7.8.0.tgz",+ "integrity": "sha512-1mAINjtQCXXeLkJ9ehXkwOcBpqtLxiVtKhpUf83DdRNdQKV0iXZpaHYqRr7nj+wvxuJzoAmAwXI+sCNMv1CzLQ==",+ "dev": true+ },+ "@typescript-eslint/eslint-plugin": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/eslint-plugin/-/eslint-plugin-5.62.0.tgz",+ "integrity": "sha512-TiZzBSJja/LbhNPvk6yc0JrX9XqhQ0hdh6M2svYfsHGejaKFIAGd9MQ+ERIMzLGlN/kZoYIgdxFV0PuljTKXag==",+ "dev": true,+ "requires": {+ "@eslint-community/regexpp": "^4.4.0",+ "@typescript-eslint/scope-manager": "5.62.0",+ "@typescript-eslint/type-utils": "5.62.0",+ "@typescript-eslint/utils": "5.62.0",+ "debug": "^4.3.4",+ "graphemer": "^1.4.0",+ "ignore": "^5.2.0",+ "natural-compare-lite": "^1.4.0",+ "semver": "^7.3.7",+ "tsutils": "^3.21.0"+ },+ "dependencies": {+ "ignore": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",+ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",+ "dev": true+ }+ }+ },+ "@typescript-eslint/parser": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/parser/-/parser-5.62.0.tgz",+ "integrity": "sha512-VlJEV0fOQ7BExOsHYAGrgbEiZoi8D+Bl2+f6V2RrXerRSylnp+ZBHmPvaIa8cz0Ajx7WO7Z5RqfgYg7ED1nRhA==",+ "dev": true,+ "requires": {+ "@typescript-eslint/scope-manager": "5.62.0",+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/typescript-estree": "5.62.0",+ "debug": "^4.3.4"+ }+ },+ "@typescript-eslint/scope-manager": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/scope-manager/-/scope-manager-5.62.0.tgz",+ "integrity": "sha512-VXuvVvZeQCQb5Zgf4HAxc04q5j+WrNAtNh9OwCsCgpKqESMTu3tF/jhZ3xG6T4NZwWl65Bg8KuS2uEvhSfLl0w==",+ "dev": true,+ "requires": {+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/visitor-keys": "5.62.0"+ }+ },+ "@typescript-eslint/type-utils": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/type-utils/-/type-utils-5.62.0.tgz",+ "integrity": "sha512-xsSQreu+VnfbqQpW5vnCJdq1Z3Q0U31qiWmRhr98ONQmcp/yhiPJFPq8MXiJVLiksmOKSjIldZzkebzHuCGzew==",+ "dev": true,+ "requires": {+ "@typescript-eslint/typescript-estree": "5.62.0",+ "@typescript-eslint/utils": "5.62.0",+ "debug": "^4.3.4",+ "tsutils": "^3.21.0"+ }+ },+ "@typescript-eslint/types": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/types/-/types-5.62.0.tgz",+ "integrity": "sha512-87NVngcbVXUahrRTqIK27gD2t5Cu1yuCXxbLcFtCzZGlfyVWWh8mLHkoxzjsB6DDNnvdL+fW8MiwPEJyGJQDgQ==",+ "dev": true+ },+ "@typescript-eslint/typescript-estree": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/typescript-estree/-/typescript-estree-5.62.0.tgz",+ "integrity": "sha512-CmcQ6uY7b9y694lKdRB8FEel7JbU/40iSAPomu++SjLMntB+2Leay2LO6i8VnJk58MtE9/nQSFIH6jpyRWyYzA==",+ "dev": true,+ "requires": {+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/visitor-keys": "5.62.0",+ "debug": "^4.3.4",+ "globby": "^11.1.0",+ "is-glob": "^4.0.3",+ "semver": "^7.3.7",+ "tsutils": "^3.21.0"+ }+ },+ "@typescript-eslint/utils": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/utils/-/utils-5.62.0.tgz",+ "integrity": "sha512-n8oxjeb5aIbPFEtmQxQYOLI0i9n5ySBEY/ZEHHZqKQSFnxio1rv6dthascc9dLuwrL0RC5mPCxB7vnAVGAYWAQ==",+ "dev": true,+ "requires": {+ "@eslint-community/eslint-utils": "^4.2.0",+ "@types/json-schema": "^7.0.9",+ "@types/semver": "^7.3.12",+ "@typescript-eslint/scope-manager": "5.62.0",+ "@typescript-eslint/types": "5.62.0",+ "@typescript-eslint/typescript-estree": "5.62.0",+ "eslint-scope": "^5.1.1",+ "semver": "^7.3.7"+ }+ },+ "@typescript-eslint/visitor-keys": {+ "version": "5.62.0",+ "resolved": "https://registry.npmjs.org/@typescript-eslint/visitor-keys/-/visitor-keys-5.62.0.tgz",+ "integrity": "sha512-07ny+LHRzQXepkGg6w0mFY41fVUNBrL2Roj/++7V1txKugfjm/Ci/qSND03r2RhlJhJYMcTn9AhhSSqQp0Ysyw==",+ "dev": true,+ "requires": {+ "@typescript-eslint/types": "5.62.0",+ "eslint-visitor-keys": "^3.3.0"+ },+ "dependencies": {+ "eslint-visitor-keys": {+ "version": "3.4.3",+ "resolved": "https://registry.npmjs.org/eslint-visitor-keys/-/eslint-visitor-keys-3.4.3.tgz",+ "integrity": "sha512-wpc+LXeiyiisxPlEkUzU6svyS1frIO3Mgxj1fdy7Pm8Ygzguax2N3Fa/D/ag1WqbOprdI+uY6wMUl8/a2G+iag==",+ "dev": true+ }}},"@vitest/expect": {@@ -5060,6 +5848,12 @@"is-string": "^1.0.5"}},+ "array-union": {+ "version": "2.1.0",+ "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz",+ "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==",+ "dev": true+ },"array.prototype.flat": {"version": "1.2.4","resolved": "https://registry.npmjs.org/array.prototype.flat/-/array.prototype.flat-1.2.4.tgz",@@ -5120,6 +5914,15 @@"concat-map": "0.0.1"}},+ "braces": {+ "version": "3.0.3",+ "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz",+ "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==",+ "dev": true,+ "requires": {+ "fill-range": "^7.1.1"+ }+ },"browserslist": {"version": "4.17.2","resolved": "https://registry.npmjs.org/browserslist/-/browserslist-4.17.2.tgz",@@ -5336,6 +6139,23 @@"resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz","integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ=="},+ "dir-glob": {+ "version": "3.0.1",+ "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz",+ "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==",+ "dev": true,+ "requires": {+ "path-type": "^4.0.0"+ },+ "dependencies": {+ "path-type": {+ "version": "4.0.0",+ "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz",+ "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==",+ "dev": true+ }+ }+ },"doctrine": {"version": "3.0.0","resolved": "https://registry.npmjs.org/doctrine/-/doctrine-3.0.0.tgz",@@ -5771,6 +6591,19 @@"integrity": "sha512-VxPP4NqbUjj6MaAOafWeUn2cXWLcCtljklUtZf0Ind4XQ+QPtmA0b18zZy0jIQx+ExRVCR/ZQpBmik5lXshNsw==","dev": true},+ "fast-glob": {+ "version": "3.3.3",+ "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz",+ "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==",+ "dev": true,+ "requires": {+ "@nodelib/fs.stat": "^2.0.2",+ "@nodelib/fs.walk": "^1.2.3",+ "glob-parent": "^5.1.2",+ "merge2": "^1.3.0",+ "micromatch": "^4.0.8"+ }+ },"fast-json-stable-stringify": {"version": "2.1.0","resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz",@@ -5789,6 +6622,15 @@"integrity": "sha512-iPeeDKJSWf4IEOasVVrknXpaBV0IApz/gp7S2bb7Z4Lljbl2MGJRqInZiUrQwV16cpzw/D3S5j5Julj/gT52AA==","dev": true},+ "fastq": {+ "version": "1.20.3",+ "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.20.3.tgz",+ "integrity": "sha512-XKv5nnLs6nLF71NgiKJLIZFLkPyIEuOselLG7ujZnGrRfQK8HpvY+WqKhAJUAdLomwVHErVS4LfxFlPq0/FTAw==",+ "dev": true,+ "requires": {+ "reusify": "^1.0.4"+ }+ },"file-entry-cache": {"version": "6.0.1","resolved": "https://registry.npmjs.org/file-entry-cache/-/file-entry-cache-6.0.1.tgz",@@ -5798,6 +6640,15 @@"flat-cache": "^3.0.4"}},+ "fill-range": {+ "version": "7.1.1",+ "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz",+ "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==",+ "dev": true,+ "requires": {+ "to-regex-range": "^5.0.1"+ }+ },"find-up": {"version": "2.1.0","resolved": "https://registry.npmjs.org/find-up/-/find-up-2.1.0.tgz",@@ -5935,6 +6786,28 @@"type-fest": "^0.20.2"}},+ "globby": {+ "version": "11.1.0",+ "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz",+ "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==",+ "dev": true,+ "requires": {+ "array-union": "^2.1.0",+ "dir-glob": "^3.0.1",+ "fast-glob": "^3.2.9",+ "ignore": "^5.2.0",+ "merge2": "^1.4.1",+ "slash": "^3.0.0"+ },+ "dependencies": {+ "ignore": {+ "version": "5.3.2",+ "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz",+ "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==",+ "dev": true+ }+ }+ },"gopd": {"version": "1.2.0","resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",@@ -5946,6 +6819,12 @@"integrity": "sha512-nTnJ528pbqxYanhpDYsi4Rd8MAeaBA67+RZ10CM1m3bTAVFEDcd5AuA4a6W5YkGZ1iNXHzZz8T6TBKLeBuNriQ==","dev": true},+ "graphemer": {+ "version": "1.4.0",+ "resolved": "https://registry.npmjs.org/graphemer/-/graphemer-1.4.0.tgz",+ "integrity": "sha512-EtKwoO6kxCL9WO5xipiHTZlSzBm7WLT627TqC/uVRd0HKmq8NXyebnNYxDoBi7wt8eTWrUrKXCOVaFq9x1kgag==",+ "dev": true+ },"has": {"version": "1.0.3","resolved": "https://registry.npmjs.org/has/-/has-1.0.3.tgz",@@ -6091,9 +6970,9 @@"dev": true},"is-glob": {- "version": "4.0.1",- "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.1.tgz",- "integrity": "sha512-5G0tKtBTFImOqDnLB2hG6Bp2qcKEFduo4tZu9MT/H6NQv/ghhy30o55ufafxJ/LdH79LLs2Kfrn85TLKyA7BUg==",+ "version": "4.0.3",+ "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz",+ "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==","dev": true,"requires": {"is-extglob": "^2.1.1"@@ -6105,6 +6984,12 @@"integrity": "sha512-2z6JzQvZRa9A2Y7xC6dQQm4FSTSTNWjKIYYTt4246eMTJmIo0Q+ZyOsU66X8lxK1AbB92dFeglPLrhwpeRKO6w==","dev": true},+ "is-number": {+ "version": "7.0.0",+ "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz",+ "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==",+ "dev": true+ },"is-number-object": {"version": "1.0.5","resolved": "https://registry.npmjs.org/is-number-object/-/is-number-object-1.0.5.tgz",@@ -6313,6 +7198,22 @@"blueimp-md5": "^2.10.0"}},+ "merge2": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz",+ "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==",+ "dev": true+ },+ "micromatch": {+ "version": "4.0.8",+ "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz",+ "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==",+ "dev": true,+ "requires": {+ "braces": "^3.0.3",+ "picomatch": "^2.3.1"+ }+ },"mime-db": {"version": "1.52.0","resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",@@ -6386,6 +7287,12 @@"integrity": "sha1-Sr6/7tdUHywnrPspvbvRXI1bpPc=","dev": true},+ "natural-compare-lite": {+ "version": "1.4.1",+ "resolved": "https://registry.npmjs.org/natural-compare-lite/-/natural-compare-lite-1.4.1.tgz",+ "integrity": "sha512-8Mz06azhPqiDlxhUaUTjBhNAbib/1MoPr89kgmuV6Ir8ICT2/Q/XSYg6VfL3fq2x8MpSQX8sqyI/NeZ5GsGyXA==",+ "dev": true+ },"node-releases": {"version": "1.1.77","resolved": "https://registry.npmjs.org/node-releases/-/node-releases-1.1.77.tgz",@@ -6581,6 +7488,12 @@"integrity": "sha512-xceH2snhtb5M9liqDsmEw56le376mTZkEX/jEb/RxNFyegNul7eNslCXP9FDj/Lcu0X8KEyMceP2ntpaHrDEVA==","dev": true},+ "picomatch": {+ "version": "2.3.2",+ "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.2.tgz",+ "integrity": "sha512-V7+vQEJ06Z+c5tSye8S+nHUfI51xoXIXjHQ99cQtKUkQqqO1kO/KCJUfZXuB47h/YBlDhah2H3hdUGXn8ie0oA==",+ "dev": true+ },"pify": {"version": "3.0.0","resolved": "https://registry.npmjs.org/pify/-/pify-3.0.0.tgz",@@ -6674,6 +7587,12 @@"integrity": "sha512-XRsRjdf+j5ml+y/6GKHPZbrF/8p2Yga0JPtdqTIY2Xe5ohJPD9saDJJLPvp9+NSBprVvevdXZybnj2cv8OEd0A==","dev": true},+ "queue-microtask": {+ "version": "1.2.3",+ "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz",+ "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==",+ "dev": true+ },"react-is": {"version": "17.0.2","resolved": "https://registry.npmjs.org/react-is/-/react-is-17.0.2.tgz",@@ -6743,6 +7662,12 @@"integrity": "sha512-pb/MYmXstAkysRFx8piNI1tGFNQIFA3vkE3Gq4EuA1dF6gHp/+vgZqsCGJapvy8N3Q+4o7FwvquPJcnZ7RYy4g==","dev": true},+ "reusify": {+ "version": "1.1.0",+ "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz",+ "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==",+ "dev": true+ },"rimraf": {"version": "3.0.2","resolved": "https://registry.npmjs.org/rimraf/-/rimraf-3.0.2.tgz",@@ -6761,6 +7686,15 @@"fsevents": "~2.3.2"}},+ "run-parallel": {+ "version": "1.2.0",+ "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz",+ "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==",+ "dev": true,+ "requires": {+ "queue-microtask": "^1.2.2"+ }+ },"safe-buffer": {"version": "5.1.2","resolved": "https://registry.npmjs.org/safe-buffer/-/safe-buffer-5.1.2.tgz",@@ -6798,6 +7732,12 @@"integrity": "sha512-ybx0WO1/8bSBLEWXZvEd7gMW3Sn3JFlW3TvX1nREbDLRNQNaeNN8WK0meBwPdAaOI7TtRRRJn/Es1zhrrCHu7g==","dev": true},+ "slash": {+ "version": "3.0.0",+ "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz",+ "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==",+ "dev": true+ },"slice-ansi": {"version": "4.0.0","resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-4.0.0.tgz",@@ -7022,6 +7962,15 @@"integrity": "sha512-KYad6Vy5VDWV4GH3fjpseMQ/XU2BhIYP7Vzd0LG44qRWm/Yt2WCOTicFdvmgo6gWaqooMQCawTtILVQJupKu7A==","dev": true},+ "to-regex-range": {+ "version": "5.0.1",+ "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz",+ "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==",+ "dev": true,+ "requires": {+ "is-number": "^7.0.0"+ }+ },"tsconfig-paths": {"version": "3.10.1","resolved": "https://registry.npmjs.org/tsconfig-paths/-/tsconfig-paths-3.10.1.tgz",@@ -7033,6 +7982,21 @@"strip-bom": "^3.0.0"}},+ "tslib": {+ "version": "1.14.1",+ "resolved": "https://registry.npmjs.org/tslib/-/tslib-1.14.1.tgz",+ "integrity": "sha512-Xni35NKzjgMrwevysHTCArtLDpPvye8zV/0E4EyYn43P7/7qvQwPh9BGkHewbMulVntbigmcT7rdX3BNo9wRJg==",+ "dev": true+ },+ "tsutils": {+ "version": "3.21.0",+ "resolved": "https://registry.npmjs.org/tsutils/-/tsutils-3.21.0.tgz",+ "integrity": "sha512-mHKK3iUXL+3UF6xL5k0PEhKRUBKPBCv/+RkEOpjRWxxx27KKRBmmA60A9pgOUvMi8GKhRMPEmjBRPzs2W7O1OA==",+ "dev": true,+ "requires": {+ "tslib": "^1.8.1"+ }+ },"type-check": {"version": "0.4.0","resolved": "https://registry.npmjs.org/type-check/-/type-check-0.4.0.tgz",@@ -7054,6 +8018,12 @@"integrity": "sha512-Ne+eE4r0/iWnpAxD852z3A+N0Bt5RN//NjJwRd2VFHEmrywxf5vsZlh4R6lixl6B+wz/8d+maTSAkN1FIkI3LQ==","dev": true},+ "typescript": {+ "version": "5.9.3",+ "resolved": "https://registry.npmjs.org/typescript/-/typescript-5.9.3.tgz",+ "integrity": "sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==",+ "dev": true+ },"ufo": {"version": "1.5.4","resolved": "https://registry.npmjs.org/ufo/-/ufo-1.5.4.tgz",@@ -7073,9 +8043,9 @@}},"undici-types": {- "version": "6.19.8",- "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.19.8.tgz",- "integrity": "sha512-ve2KP6f/JnbPBFyobGHuerC9g1FYGn/F8n1LWTwNxCEzd6IfqTwUQcNXgEtmmQ6DlRrC1hrSrBnCZPokRrDHjw==",+ "version": "6.21.0",+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-6.21.0.tgz",+ "integrity": "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==","dev": true},"uri-js": {diff --git a/package.json b/package.jsonindex fe2fe5b..860e15f 100644--- a/package.json+++ b/package.json@@ -6,7 +6,10 @@"scripts": {"test": "vitest","example": "node --env-file=.env",- "example:dev": "nodemon --env-file=.env"+ "example:dev": "nodemon --env-file=.env",+ "build:agent": "tsc -p tsconfig.agent.json",+ "prepack": "npm run build:agent",+ "lint:agent": "eslint agent.ts tests/agent.test.ts"},"repository": {"type": "git",@@ -35,10 +38,18 @@"devDependencies": {"@babel/eslint-parser": "^7.15.7","@mathieuc/console": "^1.0.1",+ "@types/node": "^20.19.43",+ "@typescript-eslint/eslint-plugin": "^5.62.0",+ "@typescript-eslint/parser": "^5.62.0","dotenv": "^16.3.1","eslint": "^7.25.0","eslint-config-airbnb-base": "^14.2.1","eslint-plugin-import": "^2.22.1",+ "typescript": "^5.9.3","vitest": "^0.31.4"+ },+ "homepage": "https://github.com/Mathieu2301/TradingView-API#readme",+ "bugs": {+ "url": "https://github.com/Mathieu2301/TradingView-API/issues"}}diff --git a/src/chart/graphicParser.js b/src/chart/graphicParser.jsindex 40c149f..5235dbf 100644--- a/src/chart/graphicParser.js+++ b/src/chart/graphicParser.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst TRANSLATOR = {/** @typedef {'right' | 'left' | 'both' | 'none'} ExtendValue */extend: {diff --git a/src/chart/session.js b/src/chart/session.jsindex 1d2ee20..7bb772c 100644--- a/src/chart/session.js+++ b/src/chart/session.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst { genSessionID } = require('../utils');const studyConstructor = require('./study');diff --git a/src/chart/study.js b/src/chart/study.jsindex d39d8c1..b1c4737 100644--- a/src/chart/study.js+++ b/src/chart/study.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst { genSessionID } = require('../utils');const { parseCompressed } = require('../protocol');const graphicParser = require('./graphicParser');diff --git a/src/classes/BuiltInIndicator.js b/src/classes/BuiltInIndicator.jsindex daad45f..6de9bf7 100644--- a/src/classes/BuiltInIndicator.js+++ b/src/classes/BuiltInIndicator.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingview/*** @typedef {'Volume@tv-basicstudies-241'* | 'VbPFixed@tv-basicstudies-241'diff --git a/src/classes/PineIndicator.js b/src/classes/PineIndicator.jsindex f955163..a23c396 100644--- a/src/classes/PineIndicator.js+++ b/src/classes/PineIndicator.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingview/*** @typedef {Object} IndicatorInput* @property {string} name Input namediff --git a/src/classes/PinePermManager.js b/src/classes/PinePermManager.jsindex 5125bdc..9a49357 100644--- a/src/classes/PinePermManager.js+++ b/src/classes/PinePermManager.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst axios = require('axios');const { genAuthCookies } = require('../utils');diff --git a/src/client.js b/src/client.jsindex 718d15c..ad8f18b 100644--- a/src/client.js+++ b/src/client.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst WebSocket = require('ws');const misc = require('./miscRequests');diff --git a/src/miscRequests.js b/src/miscRequests.jsindex a9707f2..ca1153a 100644--- a/src/miscRequests.js+++ b/src/miscRequests.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst os = require('os');const axios = require('axios');diff --git a/src/protocol.js b/src/protocol.jsindex 6ce42cd..1c94e0a 100644--- a/src/protocol.js+++ b/src/protocol.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst zlib = require('zlib');const JSZip = require('jszip');diff --git a/src/quote/market.js b/src/quote/market.jsindex 3d3c823..6537b25 100644--- a/src/quote/market.js+++ b/src/quote/market.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingview/*** @typedef {'loaded' | 'data' | 'error'} MarketEvent*/diff --git a/src/quote/session.js b/src/quote/session.jsindex 6d59217..fe71e17 100644--- a/src/quote/session.js+++ b/src/quote/session.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewconst { genSessionID } = require('../utils');const quoteMarketConstructor = require('./market');diff --git a/src/types.js b/src/types.jsindex 88604f1..20d4a9a 100644--- a/src/types.js+++ b/src/types.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingview/*** @typedef {string} MarketSymbol Market symbol (like: 'BTCEUR' or 'KRAKEN:BTCEUR')*/diff --git a/src/utils.js b/src/utils.jsindex 8d6feca..7be89f8 100644--- a/src/utils.js+++ b/src/utils.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewmodule.exports = {/*** Generates a session iddiff --git a/tests/agent.test.ts b/tests/agent.test.tsnew file mode 100644index 0000000..c3722ae--- /dev/null+++ b/tests/agent.test.ts@@ -0,0 +1,134 @@+/**+ * https://github.com/Mathieu2301/TradingView-API+ * https://www.npmjs.com/package/@mathieuc/tradingview+ */+import {+ describe, expect, it, vi,+} from 'vitest';+import { fetchCandles, TradingViewProvider, watchCandles } from '../agent.ts';++const bar = (time: number, close: number) => ({+ time, open: close - 1, max: close + 1, min: close - 2, close, volume: 3,+});++function transport() {+ let chart: any;+ let client: any;+ class Chart {+ periods: ReturnType<typeof bar>[] = [];++ symbolLoaded?: () => void;++ update?: () => void;++ error?: (...messages: unknown[]) => void;++ delete = vi.fn();++ setMarket = vi.fn();++ onSymbolLoaded(cb: () => void) { this.symbolLoaded = cb; }++ onUpdate(cb: () => void) { this.update = cb; }++ onError(cb: (...messages: unknown[]) => void) { this.error = cb; }++ constructor() { chart = this; }+ }+ class Client {+ Session = { Chart };++ disconnected?: () => void;++ error?: (...messages: unknown[]) => void;++ end = vi.fn(async () => {});++ onDisconnected(cb: () => void) { this.disconnected = cb; }++ onError(cb: (...messages: unknown[]) => void) { this.error = cb; }++ constructor() { client = this; }+ }+ const provider = new TradingViewProvider({ clientFactory: () => new Client() as any });+ return {+ provider,+ get chart() { return chart as Chart; },+ get client() { return client as Client; },+ };+}++describe('agent-friendly candles API', () => {+ it('fetches one snapshot and releases both resources', async () => {+ const fake = transport();+ const pending = fetchCandles({ symbol: 'BINANCE:BTCUSDT', timeframe: 'D', limit: 2 }, fake.provider);+ fake.chart.periods = [bar(200, 20), bar(100, 10)];+ fake.chart.symbolLoaded?.();+ const candles = await pending;+ expect(candles).toEqual([+ {+ time: 100, open: 9, high: 11, low: 8, close: 10, volume: 3,+ },+ {+ time: 200, open: 19, high: 21, low: 18, close: 20, volume: 3,+ },+ ]);+ expect(fake.chart.setMarket).toHaveBeenCalledWith('BINANCE:BTCUSDT', { timeframe: 'D', range: 2 });+ expect(fake.chart.delete).toHaveBeenCalledTimes(1);+ expect(fake.client.end).toHaveBeenCalledTimes(1);+ });++ it('keeps a worker running until an idempotent stop', async () => {+ const fake = transport();+ const received: number[] = [];+ const pending = watchCandles({ symbol: 'BINANCE:BTCUSDT' }, {+ onData: (candles) => received.push(candles[candles.length - 1].close),+ }, fake.provider);+ fake.chart.symbolLoaded?.();+ fake.chart.periods = [bar(100, 10)];+ fake.chart.update?.();+ const worker = await pending;+ expect(worker.latest[worker.latest.length - 1]?.close).toBe(10);+ fake.chart.periods = [bar(200, 20)];+ fake.chart.update?.();+ expect(received).toEqual([10, 20]);+ await Promise.all([worker.stop(), worker.stop()]);+ fake.chart.update?.();+ expect(received).toEqual([10, 20]);+ expect(fake.chart.delete).toHaveBeenCalledTimes(1);+ expect(fake.client.end).toHaveBeenCalledTimes(1);+ });++ it('times out and cleans up if the first snapshot never arrives', async () => {+ const fake = transport();+ const pending = fetchCandles({ symbol: 'BINANCE:BTCUSDT', timeoutMs: 5 }, fake.provider);+ await expect(pending).rejects.toThrow('Timed out');+ expect(fake.chart.delete).toHaveBeenCalledTimes(1);+ expect(fake.client.end).toHaveBeenCalledTimes(1);+ });++ it('rejects and cleans up on disconnect before the first snapshot', async () => {+ const fake = transport();+ const pending = fetchCandles({ symbol: 'BINANCE:BTCUSDT' }, fake.provider);+ fake.client.disconnected?.();+ await expect(pending).rejects.toThrow('disconnected');+ expect(fake.chart.delete).toHaveBeenCalledTimes(1);+ });++ const abortTest = typeof AbortController === 'undefined' ? it.skip : it;+ abortTest('aborts a pending request and releases the transport', async () => {+ const fake = transport();+ const controller = new AbortController();+ const pending = fetchCandles({ symbol: 'BINANCE:BTCUSDT', signal: controller.signal }, fake.provider);+ controller.abort();+ await expect(pending).rejects.toThrow(/abort/i);+ expect(fake.chart.delete).toHaveBeenCalledTimes(1);+ expect(fake.client.end).toHaveBeenCalledTimes(1);+ });++ it('rejects invalid requests before opening a connection', async () => {+ const fake = transport();+ await expect(fetchCandles({ symbol: '', limit: 0 }, fake.provider)).rejects.toThrow('symbol');+ expect(fake.client).toBeUndefined();+ });+});diff --git a/tests/allErrors.test.ts b/tests/allErrors.test.tsindex 8ea4727..eb8f28d 100644--- a/tests/allErrors.test.ts+++ b/tests/allErrors.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';diff --git a/tests/authenticated.test.ts b/tests/authenticated.test.tsindex d176e67..4fcdda0 100644--- a/tests/authenticated.test.ts+++ b/tests/authenticated.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';import utils from './utils';diff --git a/tests/builtInIndicator.test.ts b/tests/builtInIndicator.test.tsindex 712c45c..1e9951d 100644--- a/tests/builtInIndicator.test.ts+++ b/tests/builtInIndicator.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';import utils from './utils';diff --git a/tests/customChartTypes.test.ts b/tests/customChartTypes.test.tsindex 509a420..10b6535 100644--- a/tests/customChartTypes.test.ts+++ b/tests/customChartTypes.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';import utils from './utils';diff --git a/tests/getUser-redirect.test.ts b/tests/getUser-redirect.test.tsindex 505b2cb..a64def0 100644--- a/tests/getUser-redirect.test.ts+++ b/tests/getUser-redirect.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';describe('getUser redirect protection', () => {diff --git a/tests/indicators.test.ts b/tests/indicators.test.tsindex b68805c..a9ab74c 100644--- a/tests/indicators.test.ts+++ b/tests/indicators.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';diff --git a/tests/quoteSession.test.ts b/tests/quoteSession.test.tsindex 80e4bd7..9577ca8 100644--- a/tests/quoteSession.test.ts+++ b/tests/quoteSession.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';diff --git a/tests/replayMode.test.ts b/tests/replayMode.test.tsindex 3cba8cf..d9edc4e 100644--- a/tests/replayMode.test.ts+++ b/tests/replayMode.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';import utils from './utils';diff --git a/tests/search.test.ts b/tests/search.test.tsindex 8810291..de94eef 100644--- a/tests/search.test.ts+++ b/tests/search.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import { searchMarket, searchIndicator, searchMarketV3 } from '../main';diff --git a/tests/simpleChart.test.ts b/tests/simpleChart.test.tsindex 4ff2a68..396129a 100644--- a/tests/simpleChart.test.ts+++ b/tests/simpleChart.test.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewimport { describe, it, expect } from 'vitest';import TradingView from '../main';import utils from './utils';diff --git a/tests/utils.ts b/tests/utils.tsindex 549585f..5292503 100644--- a/tests/utils.ts+++ b/tests/utils.ts@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewexport const wait = (ms: number) => (new Promise((resolve) => { setTimeout(resolve, ms); }));diff --git a/tsconfig.agent.json b/tsconfig.agent.jsonnew file mode 100644index 0000000..93edc68--- /dev/null+++ b/tsconfig.agent.json@@ -0,0 +1,14 @@+{+ "compilerOptions": {+ "target": "ES2020",+ "module": "CommonJS",+ "moduleResolution": "Node",+ "lib": ["ES2022", "DOM"],+ "types": ["node"],+ "strict": true,+ "declaration": true,+ "outDir": "dist",+ "skipLibCheck": true+ },+ "include": ["agent.ts"]+}diff --git a/vite.config.js b/vite.config.jsindex 5d7aaf3..04522e3 100644--- a/vite.config.js+++ b/vite.config.js@@ -1,3 +1,5 @@+// Project: https://github.com/Mathieu2301/TradingView-API+// Package: https://www.npmjs.com/package/@mathieuc/tradingviewmodule.exports = {test: {testTimeout: 10000,