@livefolio/sdk 0.2.1 → 0.2.4

package/README.md

@@ -8,9 +8,7 @@ TypeScript SDK for market data, strategy evaluation, and portfolio management.
 npm install @livefolio/sdk
 ```
 
-## Getting Started
-
-All modules are created from a single Supabase client:
+## Quick Start
 
 ```ts
 import { createLivefolioClient } from '@livefolio/sdk';
@@ -20,171 +18,50 @@ const supabase = createClient(SUPABASE_URL, SUPABASE_ANON_KEY);
 const livefolio = createLivefolioClient(supabase);
 ```
 
-Individual modules can also be imported directly:
-
-```ts
-import { createMarket } from '@livefolio/sdk/market';
-import { createAuth } from '@livefolio/sdk/auth';
-import { createStrategy } from '@livefolio/sdk/strategy';
-```
-
----
-
-## Auth
-
-Wraps Supabase Auth with a simplified interface.
-
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `getUser()` | `User \| null` | Get the current authenticated user, or `null` if not signed in |
-| `getSession()` | `Session \| null` | Get the current session |
-| `requireUser()` | `User` | Get the current user or throw if not authenticated |
-| `onAuthStateChange(callback)` | `Subscription` | Subscribe to auth state changes (sign in, sign out, token refresh) |
-| `signOut()` | `void` | Sign out the current user |
-
-```ts
-const user = await livefolio.auth.getUser();
-
-const subscription = livefolio.auth.onAuthStateChange((event, session) => {
-  console.log(event, session);
-});
-```
-
----
-
-## Market
-
-Provides historical price series, real-time quotes, and the trading calendar. Series and quotes are served through Supabase Edge Functions with transparent cache-through behavior — the SDK requests data and caching is handled server-side.
-
-### Series
-
-Retrieve historical daily observations for one or more symbols. Each observation has an ISO 8601 `timestamp` (market close) and a `value` (closing price).
-
-```ts
-const spy = await livefolio.market.getSeries('SPY');
-// spy: Observation[] — [{ timestamp: '2025-01-10T21:00:00Z', value: 590.25 }, ...]
-
-const batch = await livefolio.market.getBatchSeries(['SPY', 'QQQ', 'TLT']);
-// batch: Record<string, Observation[]> — { SPY: [...], QQQ: [...], TLT: [...] }
-```
-
-### Quotes
+## Modules
 
-Retrieve the latest real-time quote for one or more symbols.
-
-```ts
-const quote = await livefolio.market.getQuote('SPY');
-// quote: Observation — { timestamp: '2025-03-02T21:00:00Z', value: 592.10 }
-
-const quotes = await livefolio.market.getBatchQuotes(['SPY', 'QQQ']);
-// quotes: Record<string, Observation>
-```
-
-### Trading Calendar
-
-Query the trading calendar for market open/close times. Dates are `YYYY-MM-DD` strings.
-
-```ts
-const days = await livefolio.market.getTradingDays('2025-01-01', '2025-12-31');
-// days: TradingDay[] — [{ date, open, close, extended_open, extended_close }, ...]
-
-const today = await livefolio.market.getTradingDay('2025-03-02');
-// today: TradingDay | null
-```
-
----
-
-## Strategy
-
-Handles strategy retrieval, evaluation, and result caching. The module exposes two evaluation paths:
-
-- **`evaluate()`** (async) — the primary API. Checks the DB cache for a prior result, returns it on hit, or runs a fresh evaluation and stores the result on miss. Consumers never need to manage caching manually.
-- **Pure functions** (sync) — `evaluateIndicator`, `evaluateSignal`, `evaluateAllocation` for direct computation without DB interaction. Useful for testing, debugging, or custom pipelines.
-
-### Retrieving Strategies
-
-Fetch a fully-resolved strategy by its link ID. The `get()` method calls the `strategy` edge function, which looks up the strategy in the database and auto-imports from testfol.io if not found. The returned `Strategy` object contains all named signals, indicators, condition trees, and allocations ready for evaluation.
-
-```ts
-const strategy = await livefolio.strategy.get('abc-123');
-// strategy: Strategy | null
-
-const strategies = await livefolio.strategy.getMany(['abc-123', 'def-456']);
-// strategies: Record<string, Strategy>
-```
-
-### Evaluating a Strategy
-
-The `evaluate` method is the standard way to run a strategy. Pass a strategy and a date — everything else is handled internally:
-
-1. Fetches historical series for all symbols used by the strategy
-2. Computes the evaluation date
-3. Checks the DB cache for a prior result on that trading day
-4. On cache miss: fetches prior signal states (for hysteresis) and indicator metadata (for incremental EMA/RSI), runs the evaluation, and stores the result
-5. On cache hit: returns the cached allocation and signal states
+| Module | Description |
+|--------|-------------|
+| `livefolio.auth` | Authentication (user, session, sign-out) |
+| `livefolio.market` | Historical series, real-time quotes, trading calendar |
+| `livefolio.strategy` | Strategy retrieval, cached evaluation, live streaming |
+| `livefolio.portfolio` | Brokerage account aggregation (stub) |
 
 ```ts
+// Fetch and evaluate a strategy
 const strategy = await livefolio.strategy.get('abc-123');
 if (strategy) {
   const result = await livefolio.strategy.evaluate(strategy, new Date());
-
-  result.allocation;   // the winning allocation (name, holdings)
-  result.asOf;         // Date the evaluation corresponds to (trading day market close)
-  result.signals;      // Record<string, boolean> — all signal states
-  result.indicators;   // Record<string, IndicatorEvaluation> — all indicator values
+  console.log(result.allocation.name, result.allocation.holdings);
 }
-```
 
-### Utilities
-
-| Method | Returns | Description |
-|--------|---------|-------------|
-| `extractSymbols(strategy)` | `string[]` | Collect all ticker symbols needed to evaluate a strategy (from signals + holdings) |
-| `getEvaluationDate(trading, options)` | `Date`            | Compute the evaluation date — requires `EvaluationOptions` with series data |
-
-### Pure Evaluation Functions
+// Market data
+const series = await livefolio.market.getBatchSeries(['SPY', 'BND']);
+const quote = await livefolio.market.getQuote('SPY');
+```
 
-For advanced use cases (testing, backtesting, custom pipelines), the pure evaluation functions operate synchronously without any DB interaction. They accept `EvaluationOptions` with `batchSeries` and optionally `previousSignalStates` and `previousIndicatorMetadata`.
+Modules can also be imported individually:
 
 ```ts
-import { evaluate, evaluateIndicator, evaluateSignal } from '@livefolio/sdk/strategy';
-
-// Evaluate a single indicator
-const smaResult = livefolio.strategy.evaluateIndicator(indicator, options);
-
-// Evaluate a signal (comparison of two indicators)
-const isAbove = livefolio.strategy.evaluateSignal(signal, options);
-
-// Evaluate a full allocation condition tree
-const matches = livefolio.strategy.evaluateAllocation(allocation, options);
+import { createMarket } from '@livefolio/sdk/market';
+import { createStrategy } from '@livefolio/sdk/strategy';
 ```
 
----
-
-## Portfolio
+## Documentation
 
-Brokerage account aggregation and trade order management. This module is planned but not yet implemented.
-
----
+Full method reference, arguments, return types, and usage examples: **[docs/](./docs/)**
 
 ## Development
 
 ```bash
-npm install
 npm run build    # compile TypeScript → dist/
 npm test         # run tests
+npm run ingest:init   # backfill price_observations from Yahoo
+npm run ingest:daily  # refresh latest daily bars
+npm run backtest:smoke -- --linkId <strategy-link-id>
 ```
 
-## CI/CD
-
-- PRs to `main` run build + tests and enforce a version bump
-- Merges to `main` auto-publish to npm and create a GitHub release
-
-Before merging, bump the version:
-
-```bash
-npm version patch
-```
+PRs to `main` run build + tests and enforce a version bump. Merges auto-publish to npm.
 
 ## License
 

package/dist/market/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/market/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAA2B,YAAY,EAAE,MAAM,SAAS,CAAC;AAErE,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY,CAgEtE"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/market/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AACpD,OAAO,KAAK,EAA2B,YAAY,EAAE,MAAM,SAAS,CAAC;AAErE,wBAAgB,YAAY,CAAC,MAAM,EAAE,mBAAmB,GAAG,YAAY,CA+FtE"}

package/dist/market/client.js

@@ -13,6 +13,34 @@ function createMarket(client) {
             const result = await this.getBatchSeries([symbol]);
             return result[symbol];
         },
+        async getBatchSeriesFromDb(symbols, startDate, endDate) {
+            const out = Object.fromEntries(symbols.map((symbol) => [symbol, []]));
+            if (symbols.length === 0)
+                return out;
+            const { data, error } = await client
+                .from('price_observations')
+                .select('symbol, date, price_400pm_et, timestamp_400pm_et')
+                .in('symbol', symbols)
+                .gte('date', startDate)
+                .lte('date', endDate)
+                .order('date', { ascending: true });
+            if (error)
+                throw new Error(`Failed to fetch price observations: ${error.message}`);
+            for (const row of data ?? []) {
+                const symbol = row.symbol;
+                if (!out[symbol])
+                    out[symbol] = [];
+                out[symbol].push({
+                    timestamp: row.timestamp_400pm_et ?? `${row.date}T21:00:00.000Z`,
+                    value: row.price_400pm_et,
+                });
+            }
+            return out;
+        },
+        async getSeriesFromDb(symbol, startDate, endDate) {
+            const result = await this.getBatchSeriesFromDb([symbol], startDate, endDate);
+            return result[symbol];
+        },
         async getBatchQuotes(symbols) {
             const { data, error } = await client.functions.invoke('quote', { body: { symbols } });
             if (error)

package/dist/market/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/market/client.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/market/client.ts"],"names":[],"mappings":"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"}

package/dist/market/index.d.ts

@@ -1,3 +1,5 @@
 export type { Observation, TradingDay, MarketModule } from './types';
 export { createMarket } from './client';
+export { TRACKED_TICKERS_DESCRIPTION, TRACKED_TICKERS_YFINANCE } from './trackedTickers';
+export type { TrackedTicker } from './trackedTickers';
 //# sourceMappingURL=index.d.ts.map

package/dist/market/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,OAAO,EAAE,2BAA2B,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AACzF,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/market/index.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createMarket = void 0;
+exports.TRACKED_TICKERS_YFINANCE = exports.TRACKED_TICKERS_DESCRIPTION = exports.createMarket = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "createMarket", { enumerable: true, get: function () { return client_1.createMarket; } });
+var trackedTickers_1 = require("./trackedTickers");
+Object.defineProperty(exports, "TRACKED_TICKERS_DESCRIPTION", { enumerable: true, get: function () { return trackedTickers_1.TRACKED_TICKERS_DESCRIPTION; } });
+Object.defineProperty(exports, "TRACKED_TICKERS_YFINANCE", { enumerable: true, get: function () { return trackedTickers_1.TRACKED_TICKERS_YFINANCE; } });
 //# sourceMappingURL=index.js.map

package/dist/market/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":";;;AACA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/market/index.ts"],"names":[],"mappings":";;;AACA,mCAAwC;AAA/B,sGAAA,YAAY,OAAA;AACrB,mDAAyF;AAAhF,6HAAA,2BAA2B,OAAA;AAAE,0HAAA,wBAAwB,OAAA"}

package/dist/market/trackedTickers.d.ts

@@ -0,0 +1,4 @@
+export declare const TRACKED_TICKERS_DESCRIPTION = "Curated default backtest/ingestion universe in Yahoo Finance symbol format.";
+export declare const TRACKED_TICKERS_YFINANCE: readonly ["SPY", "QQQ", "IWM", "DIA", "TLT", "IEF", "SHY", "BIL", "GLD", "SLV", "USO", "UUP", "VNQ", "HYG", "LQD", "XLE", "XLF", "XLK", "XLV", "XLI", "XLP", "XLY", "XLU", "XLB", "XLRE", "^GSPC", "^NDX", "^DJI", "^RUT", "^VIX", "^VIX3M", "^IRX", "^FVX", "^TNX", "^TYX", "TQQQ", "SOXL", "QLD", "SSO", "SPXL", "TSLL", "UPRO", "NVDL", "TECL", "GDXU", "FAS", "BULZ", "USD", "FNGU", "TNA", "NUGT", "KORU", "GGLL", "UDOW", "ROM", "JNUG", "YINN", "UYG", "MSFU", "CONL", "NVDU", "DFEN", "AMDL", "NVDX", "LABU", "FNGO", "DDM", "DPST", "NAIL", "MSTU", "SPYU", "AMZU", "GUSH", "URTY", "MSTX", "ERX", "UWM", "FBL", "CWEB", "AVGX", "SPUU", "SHNY", "IONX", "EDC", "SMCX", "XDEC", "CURE", "MVV", "AAPU", "OKLL", "XJUN", "BRZU", "CHAU", "FNGG", "ROBN", "BABX", "XSEP", "DIG", "WEBL", "XBJA", "RXL", "BIB", "MIDU", "XDSQ", "HIMZ", "XBOC", "INDL", "EURL", "GOOX", "DUSL", "HIBL", "UTSL", "EET", "NRGU", "NFLU", "AMZZ", "UYM", "MSOX", "UXI", "EFO", "UMDD", "TSL", "RETL", "UBOT", "BNKU", "MEXX", "SAA", "TARK", "GMEU", "SMHB", "RIOX", "MSFX", "UPW", "WANT", "XTJL", "EZJ", "XTAP", "XTOC", "AVGU", "AAPB", "TPOR", "QTOC", "XTJA", "KPDD", "PILL", "QTJA", "UGE", "UPV", "HOOX", "XPP", "UCC", "DJTU", "RBLU", "MLPR", "LTL", "AAPX", "SCDL", "FLYU", "BDCX", "HDLB", "QULL", "MTUL", "IWDL", "IWML", "IWFL", "UCYB", "USML", "UBR", "CARU", "ARMU", "KBAB", "SKYU", "KBDU", "GDE", "RSSB", "RSST", "ZROZ", "AI", "TMF", "ALLW", "SIG", "UVXY", "VT", "ASGM", "BITX", "CTAP", "DBMF", "KMLM", "MA", "MSCI", "NTSX", "RSI", "RSSX", "SQQQ", "TFSA", "UGL", "UK", "AHLT", "ARQ", "AVDV", "BLNDX", "CAOS", "DAX", "DRIP", "EDV", "EMF", "ETHU", "EU", "FANG", "GDT", "GEM", "HFEQ", "HFGM", "HFMF", "IGV", "IMO", "LBRT", "LSE", "METU", "MIX", "MOOD", "NQ", "NTSE", "OIL", "ORR", "PLTU", "QDSIX", "QMNNX", "RKLX", "RKLZ", "RS", "RSBA", "RSBT", "RYTTX", "SARK", "SDMF", "SEC", "SIL", "SPLS", "TMV", "TSDD", "VOO", "VS", "VXUS", "WAY", "WTLS", "XQQI", "XSPI", "YEAR"];
+export type TrackedTicker = (typeof TRACKED_TICKERS_YFINANCE)[number];
+//# sourceMappingURL=trackedTickers.d.ts.map

package/dist/market/trackedTickers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackedTickers.d.ts","sourceRoot":"","sources":["../../src/market/trackedTickers.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,gFACuC,CAAC;AAEhF,eAAO,MAAM,wBAAwB,83DA0P3B,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC"}

package/dist/market/trackedTickers.js

@@ -0,0 +1,256 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TRACKED_TICKERS_YFINANCE = exports.TRACKED_TICKERS_DESCRIPTION = void 0;
+exports.TRACKED_TICKERS_DESCRIPTION = 'Curated default backtest/ingestion universe in Yahoo Finance symbol format.';
+exports.TRACKED_TICKERS_YFINANCE = [
+    'SPY',
+    'QQQ',
+    'IWM',
+    'DIA',
+    'TLT',
+    'IEF',
+    'SHY',
+    'BIL',
+    'GLD',
+    'SLV',
+    'USO',
+    'UUP',
+    'VNQ',
+    'HYG',
+    'LQD',
+    'XLE',
+    'XLF',
+    'XLK',
+    'XLV',
+    'XLI',
+    'XLP',
+    'XLY',
+    'XLU',
+    'XLB',
+    'XLRE',
+    '^GSPC',
+    '^NDX',
+    '^DJI',
+    '^RUT',
+    '^VIX',
+    '^VIX3M',
+    '^IRX',
+    '^FVX',
+    '^TNX',
+    '^TYX',
+    'TQQQ',
+    'SOXL',
+    'QLD',
+    'SSO',
+    'SPXL',
+    'TSLL',
+    'UPRO',
+    'NVDL',
+    'TECL',
+    'GDXU',
+    'FAS',
+    'BULZ',
+    'USD',
+    'FNGU',
+    'TNA',
+    'NUGT',
+    'KORU',
+    'GGLL',
+    'UDOW',
+    'ROM',
+    'JNUG',
+    'YINN',
+    'UYG',
+    'MSFU',
+    'CONL',
+    'NVDU',
+    'DFEN',
+    'AMDL',
+    'NVDX',
+    'LABU',
+    'FNGO',
+    'DDM',
+    'DPST',
+    'NAIL',
+    'MSTU',
+    'SPYU',
+    'AMZU',
+    'GUSH',
+    'URTY',
+    'MSTX',
+    'ERX',
+    'UWM',
+    'FBL',
+    'CWEB',
+    'AVGX',
+    'SPUU',
+    'SHNY',
+    'IONX',
+    'EDC',
+    'SMCX',
+    'XDEC',
+    'CURE',
+    'MVV',
+    'AAPU',
+    'OKLL',
+    'XJUN',
+    'BRZU',
+    'CHAU',
+    'FNGG',
+    'ROBN',
+    'BABX',
+    'XSEP',
+    'DIG',
+    'WEBL',
+    'XBJA',
+    'RXL',
+    'BIB',
+    'MIDU',
+    'XDSQ',
+    'HIMZ',
+    'XBOC',
+    'INDL',
+    'EURL',
+    'GOOX',
+    'DUSL',
+    'HIBL',
+    'UTSL',
+    'EET',
+    'NRGU',
+    'NFLU',
+    'AMZZ',
+    'UYM',
+    'MSOX',
+    'UXI',
+    'EFO',
+    'UMDD',
+    'TSL',
+    'RETL',
+    'UBOT',
+    'BNKU',
+    'MEXX',
+    'SAA',
+    'TARK',
+    'GMEU',
+    'SMHB',
+    'RIOX',
+    'MSFX',
+    'UPW',
+    'WANT',
+    'XTJL',
+    'EZJ',
+    'XTAP',
+    'XTOC',
+    'AVGU',
+    'AAPB',
+    'TPOR',
+    'QTOC',
+    'XTJA',
+    'KPDD',
+    'PILL',
+    'QTJA',
+    'UGE',
+    'UPV',
+    'HOOX',
+    'XPP',
+    'UCC',
+    'DJTU',
+    'RBLU',
+    'MLPR',
+    'LTL',
+    'AAPX',
+    'SCDL',
+    'FLYU',
+    'BDCX',
+    'HDLB',
+    'QULL',
+    'MTUL',
+    'IWDL',
+    'IWML',
+    'IWFL',
+    'UCYB',
+    'USML',
+    'UBR',
+    'CARU',
+    'ARMU',
+    'KBAB',
+    'SKYU',
+    'KBDU',
+    'GDE',
+    'RSSB',
+    'RSST',
+    'ZROZ',
+    'AI',
+    'TMF',
+    'ALLW',
+    'SIG',
+    'UVXY',
+    'VT',
+    'ASGM',
+    'BITX',
+    'CTAP',
+    'DBMF',
+    'KMLM',
+    'MA',
+    'MSCI',
+    'NTSX',
+    'RSI',
+    'RSSX',
+    'SQQQ',
+    'TFSA',
+    'UGL',
+    'UK',
+    'AHLT',
+    'ARQ',
+    'AVDV',
+    'BLNDX',
+    'CAOS',
+    'DAX',
+    'DRIP',
+    'EDV',
+    'EMF',
+    'ETHU',
+    'EU',
+    'FANG',
+    'GDT',
+    'GEM',
+    'HFEQ',
+    'HFGM',
+    'HFMF',
+    'IGV',
+    'IMO',
+    'LBRT',
+    'LSE',
+    'METU',
+    'MIX',
+    'MOOD',
+    'NQ',
+    'NTSE',
+    'OIL',
+    'ORR',
+    'PLTU',
+    'QDSIX',
+    'QMNNX',
+    'RKLX',
+    'RKLZ',
+    'RS',
+    'RSBA',
+    'RSBT',
+    'RYTTX',
+    'SARK',
+    'SDMF',
+    'SEC',
+    'SIL',
+    'SPLS',
+    'TMV',
+    'TSDD',
+    'VOO',
+    'VS',
+    'VXUS',
+    'WAY',
+    'WTLS',
+    'XQQI',
+    'XSPI',
+    'YEAR',
+];
+//# sourceMappingURL=trackedTickers.js.map

package/dist/market/trackedTickers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trackedTickers.js","sourceRoot":"","sources":["../../src/market/trackedTickers.ts"],"names":[],"mappings":";;;AAAa,QAAA,2BAA2B,GACtC,6EAA6E,CAAC;AAEnE,QAAA,wBAAwB,GAAG;IACtC,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,QAAQ;IACR,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,MAAM;IACN,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACE,CAAC"}

package/dist/market/types.d.ts

@@ -12,6 +12,8 @@ export interface TradingDay {
 export interface MarketModule {
     getSeries(symbol: string): Promise<Observation[]>;
     getBatchSeries(symbols: string[]): Promise<Record<string, Observation[]>>;
+    getSeriesFromDb(symbol: string, startDate: string, endDate: string): Promise<Observation[]>;
+    getBatchSeriesFromDb(symbols: string[], startDate: string, endDate: string): Promise<Record<string, Observation[]>>;
     getQuote(symbol: string): Promise<Observation>;
     getBatchQuotes(symbols: string[]): Promise<Record<string, Observation>>;
     getTradingDays(startDate: string, endDate: string): Promise<TradingDay[]>;

package/dist/market/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/market/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAE3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAG1E,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAGxE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACzD"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/market/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,YAAY;IAE3B,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAClD,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAC1E,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC5F,oBAAoB,CAClB,OAAO,EAAE,MAAM,EAAE,EACjB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC;IAG1C,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;IAC/C,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IAGxE,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAC1E,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;CACzD"}

package/dist/strategy/backtest.d.ts

@@ -0,0 +1,6 @@
+import type { BacktestOptions, BacktestResult, Strategy, StrategyDraft } from './types';
+import type { MarketModule } from '../market/types';
+export declare function backtestWithMarketData(market: Pick<MarketModule, 'getBatchSeriesFromDb' | 'getTradingDays'>, strategy: Strategy, options: BacktestOptions): Promise<BacktestResult>;
+export declare function backtestRulesWithMarketData(market: Pick<MarketModule, 'getBatchSeriesFromDb' | 'getTradingDays'>, strategyDraft: StrategyDraft, options: BacktestOptions): Promise<BacktestResult>;
+export declare function backtest(strategy: Strategy, options: BacktestOptions): Promise<BacktestResult>;
+//# sourceMappingURL=backtest.d.ts.map

package/dist/strategy/backtest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backtest.d.ts","sourceRoot":"","sources":["../../src/strategy/backtest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,eAAe,EAEf,cAAc,EAEd,QAAQ,EACR,aAAa,EACd,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,YAAY,EAA2B,MAAM,iBAAiB,CAAC;AA4c7E,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,sBAAsB,GAAG,gBAAgB,CAAC,EACrE,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAEzB;AAED,wBAAsB,2BAA2B,CAC/C,MAAM,EAAE,IAAI,CAAC,YAAY,EAAE,sBAAsB,GAAG,gBAAgB,CAAC,EACrE,aAAa,EAAE,aAAa,EAC5B,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,cAAc,CAAC,CAGzB;AAED,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CAwVpG"}