opencandle 0.5.0 → 0.6.0

package/dist/market-state/alert-conditions.d.ts

@@ -0,0 +1,34 @@
+export declare const ALERT_CONDITION_VERSION = 1;
+export type AlertCondition = ReturnType<typeof priceCrossesAbove> | ReturnType<typeof priceCrossesBelow> | ReturnType<typeof percentMove> | ReturnType<typeof priceCrossesSma> | ReturnType<typeof smaCross> | ReturnType<typeof rsiThreshold> | ReturnType<typeof volumeSpike>;
+export declare function priceCrossesAbove(threshold: number): {
+    threshold: number;
+    field: "last_price";
+};
+export declare function priceCrossesBelow(threshold: number): {
+    threshold: number;
+    field: "last_price";
+};
+export declare function percentMove(direction: "up" | "down", percent: number, window?: string): {
+    direction: "up" | "down";
+    percent: number;
+    window: string;
+};
+export declare function priceCrossesSma(period: number, direction: "above" | "below", priceField?: "close" | "last_price"): {
+    period: number;
+    direction: "above" | "below";
+    price_field: "close" | "last_price";
+};
+export declare function smaCross(fastPeriod: number, slowPeriod: number, direction: "above" | "below"): {
+    fast_period: number;
+    slow_period: number;
+    direction: "above" | "below";
+};
+export declare function rsiThreshold(period: number, threshold: number, direction: "above" | "below"): {
+    period: number;
+    threshold: number;
+    direction: "above" | "below";
+};
+export declare function volumeSpike(lookbackPeriod: number, multiplier: number): {
+    lookback_period: number;
+    multiplier: number;
+};

package/dist/market-state/alert-conditions.js

@@ -0,0 +1,23 @@
+export const ALERT_CONDITION_VERSION = 1;
+export function priceCrossesAbove(threshold) {
+    return { threshold, field: "last_price" };
+}
+export function priceCrossesBelow(threshold) {
+    return { threshold, field: "last_price" };
+}
+export function percentMove(direction, percent, window = "1d") {
+    return { direction, percent, window };
+}
+export function priceCrossesSma(period, direction, priceField = "close") {
+    return { period, direction, price_field: priceField };
+}
+export function smaCross(fastPeriod, slowPeriod, direction) {
+    return { fast_period: fastPeriod, slow_period: slowPeriod, direction };
+}
+export function rsiThreshold(period, threshold, direction) {
+    return { period, threshold, direction };
+}
+export function volumeSpike(lookbackPeriod, multiplier) {
+    return { lookback_period: lookbackPeriod, multiplier };
+}
+//# sourceMappingURL=alert-conditions.js.map

package/dist/market-state/alert-conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"alert-conditions.js","sourceRoot":"","sources":["../../src/market-state/alert-conditions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC;AAWzC,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IAIjD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,SAAiB;IAIjD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,SAAwB,EACxB,OAAe,EACf,MAAM,GAAG,IAAI;IAMb,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,MAAc,EACd,SAA4B,EAC5B,aAAqC,OAAO;IAM5C,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,UAAU,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,QAAQ,CACtB,UAAkB,EAClB,UAAkB,EAClB,SAA4B;IAM5B,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,YAAY,CAC1B,MAAc,EACd,SAAiB,EACjB,SAA4B;IAM5B,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,WAAW,CACzB,cAAsB,EACtB,UAAkB;IAKlB,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,CAAC;AACzD,CAAC"}

package/dist/market-state/alert-runner.d.ts

@@ -0,0 +1,55 @@
+import type { OHLCV } from "../types/market.js";
+import type { MarketStateService } from "./service.js";
+export interface AlertQuoteObservation {
+    symbol: string;
+    value: number;
+    sourceProvider: string;
+    observedAt: string;
+    providerDataAt?: string | null;
+    cacheStatus: "live" | "cached" | "stale";
+    dataDelayMs?: number | null;
+    caveat?: string;
+}
+export interface AlertRunnerProviders {
+    getTradingViewQuotes(symbols: string[]): Promise<AlertQuoteObservation[]>;
+    getYahooQuote(symbol: string): Promise<AlertQuoteObservation>;
+    getHistory(symbol: string, range: string, interval: string): Promise<OHLCV[]>;
+}
+export interface AlertRunnerOptions {
+    ownerId?: string | null;
+    triggerType: "heartbeat" | "manual" | "scheduled" | "resume";
+    now?: string;
+    providers: AlertRunnerProviders;
+    providerBudget?: AlertProviderBudget;
+}
+export interface AlertRunnerResult {
+    checked: number;
+    triggered: number;
+    unavailable: number;
+    runId: number;
+    lines: string[];
+}
+export interface AlertProviderBudgetOptions {
+    failureThreshold?: number;
+    backoffMs?: number;
+}
+export interface AlertProviderBudgetSnapshotEntry {
+    state: "available" | "open";
+    failureCount: number;
+    openUntil?: string;
+    reason?: string;
+}
+export declare class AlertProviderBudget {
+    private readonly state;
+    private readonly failureThreshold;
+    private readonly backoffMs;
+    constructor(options?: AlertProviderBudgetOptions);
+    unavailableReason(provider: string, now: string): string | null;
+    recordSuccess(provider: string): void;
+    recordFailure(provider: string, reason: string, now: string): void;
+    reset(): void;
+    snapshot(now: string): Record<string, AlertProviderBudgetSnapshotEntry>;
+}
+export declare const defaultAlertProviderBudget: AlertProviderBudget;
+export declare const defaultAlertRunnerProviders: AlertRunnerProviders;
+export declare function runAlertChecks(service: MarketStateService, options: AlertRunnerOptions): Promise<AlertRunnerResult>;