drishti-sdk 0.2.0

package/dist/params.js

@@ -0,0 +1,30 @@
+/** Query parameter models aligned with alpha-api /v1 route definitions. */
+function joinList(values) {
+    return values.join(",");
+}
+/**
+ * Convert a params object to flat query-string fields for HTTP.
+ * Keys listed in `listKeys` are joined with commas (alpha-api list filter convention).
+ */
+export function serializeQueryParams(params, listKeys = []) {
+    const listKeySet = new Set(listKeys);
+    const out = {};
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (listKeySet.has(key) && Array.isArray(value)) {
+            if (value.length > 0)
+                out[key] = joinList(value);
+            continue;
+        }
+        if (typeof value === "string" || typeof value === "number" || typeof value === "boolean") {
+            out[key] = value;
+        }
+    }
+    return out;
+}
+/** Announcements list vs by-id modes use different query keys. */
+export function serializeAnnouncementsQueryParams(params) {
+    return serializeQueryParams(params, ["symbols", "scrip_codes", "categories"]);
+}
+//# sourceMappingURL=params.js.map

package/dist/params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.js","sourceRoot":"","sources":["../src/params.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAmH3E,SAAS,QAAQ,CAAC,MAAgB;IAChC,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAS,EACT,WAA0C,EAAE;IAE5C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS,QAAQ,CAAC,CAAC;IAC7C,MAAM,GAAG,GAAmC,EAAE,CAAC;IAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;YAAE,SAAS;QACpD,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAChD,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;gBAAE,GAAG,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QACD,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;YACzF,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,iCAAiC,CAC/C,MAAgC;IAEhC,OAAO,oBAAoB,CAAC,MAAM,EAAE,CAAC,SAAS,EAAE,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;AAChF,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,246 @@
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export type JsonObject = {
+    [key: string]: JsonValue;
+};
+export type PaginatedResponse<TItem> = {
+    data: TItem[];
+    has_next: boolean;
+    missing_ids?: string[];
+};
+export type AttachmentLookupStatus = "ready" | "not_found" | "invalid_id" | "no_attachment" | "no_transcript";
+export type AttachmentLookupItem = {
+    id: string;
+    status: AttachmentLookupStatus;
+    url?: string | null;
+    expires_in?: number | null;
+    message?: string | null;
+};
+export type BatchAttachmentLookupResponse = {
+    data: AttachmentLookupItem[];
+};
+export type StringListResponse = {
+    data: string[];
+};
+export type SymbolMetadata = {
+    symbol: string;
+    company_name?: string | null;
+    logo?: string | null;
+    market_cap?: number | null;
+    sector?: string | null;
+    basic_industry?: string | null;
+    industry?: string | null;
+    macro_economic_indicator?: string | null;
+    theme?: string | null;
+    scrip_code?: string | null;
+};
+export type SymbolMetadataResponse = {
+    data: SymbolMetadata[];
+};
+export type AnnouncementListItem = {
+    id: string;
+    symbol: string;
+    company_name?: string | null;
+    image?: string | null;
+    date?: string | null;
+    headline?: string | null;
+    title?: string | null;
+    summary?: string | null;
+    category?: string | null;
+    attachment_url?: string | null;
+};
+export type AnnouncementDetail = AnnouncementListItem & {
+    long_summary?: string | null;
+    related_categories?: string[];
+    descriptor?: string | null;
+    important?: boolean;
+};
+/** Alias matching alpha-api `AnnouncementSummary` (detail rows with `detailed=true`). */
+export type AnnouncementSummary = AnnouncementDetail;
+export type AnnouncementBatchResponse = {
+    data: Array<AnnouncementListItem | AnnouncementDetail>;
+    missing_ids: string[];
+};
+export type EarningsListItem = {
+    id: string;
+    symbol: string;
+    company_name?: string | null;
+    image?: string | null;
+    date?: string | null;
+    summary?: string | null;
+    attachment_url?: string | null;
+};
+export type EarningsDetail = EarningsListItem & {
+    earnings_significant?: boolean;
+    earnings_table?: JsonObject | null;
+};
+export type NewsItem = {
+    id: string;
+    title?: string | null;
+    specific_title?: string | null;
+    summary?: string | null;
+    long_summary?: string | null;
+    company?: string | null;
+    source?: string | null;
+    symbol?: string | null;
+    sentiment?: string | null;
+    article_type?: string | null;
+    scrip_code?: string | null;
+    date?: string | null;
+    link?: string | null;
+};
+export type AlertMeta = {
+    primary_drivers: string[];
+};
+export type Alert = {
+    id: string;
+    symbol: string;
+    type?: string | null;
+    reason?: string | null;
+    timestamp?: string | null;
+    meta: AlertMeta;
+};
+export type ConcallListItem = {
+    id: string;
+    symbol: string;
+    short_analysis?: JsonValue;
+    transcript_url?: string | null;
+    audio_url?: string | null;
+    sentiment_analysis?: JsonValue;
+    quarter?: string | null;
+    date?: string | null;
+};
+/** Alias for list/detail concall payloads (`expanded_analysis` when `detailed=true`). */
+export type Concall = ConcallListItem & {
+    expanded_analysis?: JsonValue;
+};
+export type ConcallDetail = Concall;
+export type ConcallTranscriptLookupStatus = "ready" | "not_found" | "no_transcript";
+export type SymbolQuarterKey = {
+    symbol: string;
+    quarter: string;
+};
+export type ConcallTranscriptLookupItem = {
+    symbol: string;
+    quarter: string;
+    id?: string | null;
+    status: ConcallTranscriptLookupStatus;
+    transcript_url?: string | null;
+    audio_url?: string | null;
+    expires_in?: number | null;
+    message?: string | null;
+};
+export type ConcallTranscriptBatchResponse = {
+    data: ConcallTranscriptLookupItem[];
+};
+export type ConcallArtifactUrlsResponse = {
+    transcript_url?: string | null;
+    audio_url?: string | null;
+    expires_in?: number | null;
+};
+export type PresignedUrlResponse = {
+    url: string;
+    expires_in?: number | null;
+};
+export type SummaryDetails = {
+    portfolio_size: number;
+    symbols_processed: number;
+    request_id: string;
+};
+export type SummaryResponse = {
+    status: string;
+    summary?: string | null;
+    details?: SummaryDetails | null;
+    error?: string | null;
+};
+export type ProductEntitlement = {
+    product: string;
+    enabled: boolean;
+    rpm?: number | null;
+    daily?: number | null;
+};
+export type WebsocketAddonEntitlement = {
+    product: string;
+    enabled: boolean;
+    tier: string;
+};
+export type AccountResponse = {
+    account_id: string;
+    name?: string | null;
+    status: string;
+    balance: number;
+    products: ProductEntitlement[];
+    websocket_addons: WebsocketAddonEntitlement[];
+    live_entitlement: Record<string, JsonValue>;
+    metadata: Record<string, JsonValue>;
+    created_at?: string | null;
+    updated_at?: string | null;
+};
+export type LedgerEntry = {
+    entry_id: string;
+    account_id: string;
+    api_key?: string | null;
+    entry_type: string;
+    amount: number;
+    balance_after?: number | null;
+    reference_id?: string | null;
+    route_id?: string | null;
+    metadata: Record<string, JsonValue>;
+    created_at: string;
+};
+export type AccountDetailResponse = {
+    data: AccountResponse;
+};
+export type AccountUsageResponse = {
+    account_id: string;
+    balance: number;
+    debited_today: number;
+    live_usage: Record<string, number>;
+    rate_limits: Record<string, Record<string, number>>;
+    live_entitlement: Record<string, JsonValue>;
+    reserved: number;
+};
+export type AccountUsageEnvelope = {
+    data: AccountUsageResponse;
+};
+export type LedgerListResponse = {
+    data: LedgerEntry[];
+};
+export type AccountLimitsResponse = {
+    rest: Record<string, Record<string, number>>;
+    websocket: Record<string, JsonValue>;
+};
+export type RequestCounts = {
+    total: number;
+    completed: number;
+    failed: number;
+};
+export type BatchJobResponse = {
+    id: string;
+    object: string;
+    display_name?: string | null;
+    status: string;
+    created_at: number;
+    in_progress_at?: number | null;
+    completed_at?: number | null;
+    failed_at?: number | null;
+    cancelled_at?: number | null;
+    request_counts: RequestCounts;
+    metadata?: Record<string, JsonValue> | null;
+};
+export type BatchJobListItem = {
+    id: string;
+    object: string;
+    display_name?: string | null;
+    status: string;
+    created_at: number;
+};
+export type BatchJobListResponse = {
+    object: string;
+    data: BatchJobListItem[];
+};
+export type BatchJobCancelResponse = {
+    id: string;
+    status: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/dist/websocket-types.d.ts

@@ -0,0 +1,48 @@
+import type { Alert, AnnouncementDetail, AnnouncementListItem, Concall, ConcallListItem, EarningsDetail, EarningsListItem, NewsItem } from "./types.js";
+export declare const ALPHA_WS_PRODUCTS: readonly ["news", "announcements", "earnings", "concalls", "alerts"];
+export type AlphaWebSocketProduct = (typeof ALPHA_WS_PRODUCTS)[number];
+export type SubscribeOptions = Readonly<{
+    product: AlphaWebSocketProduct;
+    symbols?: readonly string[];
+    detailed?: boolean;
+}>;
+export type SubscribedEvent = Readonly<{
+    kind: "subscribed";
+    product: string;
+    tier: string;
+    fullFeed: boolean;
+    symbols: string[];
+    detailed: boolean;
+}>;
+export type DataPayloadByChannel = Readonly<{
+    news: NewsItem;
+    announcements: AnnouncementDetail | AnnouncementListItem;
+    earnings: EarningsDetail | EarningsListItem;
+    concalls: Concall | ConcallListItem;
+    alerts: Alert;
+}>;
+export type KnownDataEvent = {
+    [K in AlphaWebSocketProduct]: Readonly<{
+        kind: "data";
+        channel: K;
+        data: DataPayloadByChannel[K];
+    }>;
+}[AlphaWebSocketProduct];
+export type UnknownDataEvent = Readonly<{
+    kind: "data";
+    channel: string;
+    data: Record<string, unknown>;
+}>;
+export type DataEvent = KnownDataEvent | UnknownDataEvent;
+export type ErrorEvent = Readonly<{
+    kind: "error";
+    message: string;
+    code?: string;
+}>;
+export type RawEvent = Readonly<{
+    kind: "raw";
+    payload: Record<string, unknown>;
+}>;
+export type WebSocketEvent = SubscribedEvent | DataEvent | ErrorEvent | RawEvent;
+export type WebSocketHandler = (event: WebSocketEvent) => void | Promise<void>;
+//# sourceMappingURL=websocket-types.d.ts.map

package/dist/websocket-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-types.d.ts","sourceRoot":"","sources":["../src/websocket-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,kBAAkB,EAClB,oBAAoB,EACpB,OAAO,EACP,eAAe,EACf,cAAc,EACd,gBAAgB,EAChB,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,iBAAiB,sEAMpB,CAAC;AAEX,MAAM,MAAM,qBAAqB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEvE,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,OAAO,EAAE,qBAAqB,CAAC;IAC/B,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,QAAQ,CAAC;IACrC,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,IAAI,EAAE,QAAQ,CAAC;IACf,aAAa,EAAE,kBAAkB,GAAG,oBAAoB,CAAC;IACzD,QAAQ,EAAE,cAAc,GAAG,gBAAgB,CAAC;IAC5C,QAAQ,EAAE,OAAO,GAAG,eAAe,CAAC;IACpC,MAAM,EAAE,KAAK,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG;KAC1B,CAAC,IAAI,qBAAqB,GAAG,QAAQ,CAAC;QACrC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;KAC/B,CAAC;CACH,CAAC,qBAAqB,CAAC,CAAC;AAEzB,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,CAAC,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAE1D,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC;IAChC,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,IAAI,EAAE,KAAK,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjF,MAAM,MAAM,gBAAgB,GAAG,CAAC,KAAK,EAAE,cAAc,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/websocket-types.js

@@ -0,0 +1,8 @@
+export const ALPHA_WS_PRODUCTS = [
+    "news",
+    "announcements",
+    "earnings",
+    "concalls",
+    "alerts",
+];
+//# sourceMappingURL=websocket-types.js.map

package/dist/websocket-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket-types.js","sourceRoot":"","sources":["../src/websocket-types.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,MAAM;IACN,eAAe;IACf,UAAU;IACV,UAAU;IACV,QAAQ;CACA,CAAC"}

package/dist/websocket.d.ts

@@ -0,0 +1,72 @@
+import type { AlphaWebSocketProduct, SubscribeOptions, WebSocketEvent, WebSocketHandler } from "./websocket-types.js";
+export { ALPHA_WS_PRODUCTS, type AlphaWebSocketProduct, type DataEvent, type DataPayloadByChannel, type ErrorEvent, type KnownDataEvent, type RawEvent, type SubscribeOptions, type SubscribedEvent, type UnknownDataEvent, type WebSocketEvent, type WebSocketHandler, } from "./websocket-types.js";
+export type AlphaWebSocketSessionOptions = Readonly<{
+    apiKey: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    webSocketImpl?: typeof WebSocket;
+    autoReconnect?: boolean;
+    reconnectInitialDelayMs?: number;
+    reconnectMaxDelayMs?: number;
+    reconnectBackoffMultiplier?: number;
+    reconnectJitterRatio?: number;
+    onSubscribed?: WebSocketHandler;
+    onData?: WebSocketHandler;
+    onError?: WebSocketHandler;
+    onMessage?: WebSocketHandler;
+    onOpen?: () => void | Promise<void>;
+    onClose?: (reason: string) => void | Promise<void>;
+    onReconnectAttempt?: (attempt: number, delayMs: number, reason: string) => void | Promise<void>;
+}>;
+export declare function buildWebSocketUrl(baseUrl: string, apiKey?: string): string;
+export declare function parseWebSocketMessage(raw: string): WebSocketEvent;
+export declare class AlphaWebSocketSession {
+    private readonly apiKey;
+    private readonly baseUrl;
+    private readonly headers;
+    private readonly webSocketImpl;
+    private readonly autoReconnect;
+    private readonly reconnectInitialDelayMs;
+    private readonly reconnectMaxDelayMs;
+    private readonly reconnectBackoffMultiplier;
+    private readonly reconnectJitterRatio;
+    private readonly onOpen?;
+    private readonly onClose?;
+    private readonly onReconnectAttempt?;
+    private readonly handlers;
+    private readonly subscriptions;
+    private socket;
+    private readonly queue;
+    private readonly waiters;
+    private closed;
+    private manuallyClosed;
+    private reconnecting;
+    constructor(options: AlphaWebSocketSessionOptions);
+    get connected(): boolean;
+    on(eventName: string, handler: WebSocketHandler): void;
+    connect(): Promise<void>;
+    private openSocket;
+    private attachSocketHandlers;
+    private createSocket;
+    close(): Promise<void>;
+    subscribe(options: SubscribeOptions): Promise<void>;
+    private dispatch;
+    private handleIncoming;
+    private rejectWaiters;
+    private resubscribeAll;
+    private reconnectLoop;
+    private withJitter;
+    private nextEvent;
+    events(): AsyncGenerator<WebSocketEvent>;
+    run(): Promise<void>;
+}
+export declare function streamProduct(options: {
+    apiKey: string;
+    product: AlphaWebSocketProduct;
+    symbols?: readonly string[];
+    detailed?: boolean;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    webSocketImpl?: typeof WebSocket;
+}): AsyncGenerator<Record<string, unknown>>;
+//# sourceMappingURL=websocket.d.ts.map

package/dist/websocket.d.ts.map

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