drishti-sdk 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Market-Stack
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,94 @@
+# market-stack-sdk (JavaScript / TypeScript)
+
+HTTP client for Alpha API (`/v1`). Requires Node 18+ (global `fetch`).
+
+## Install
+
+From this directory:
+
+```bash
+npm install
+npm run build
+```
+
+To use as a local package: `npm pack` or `npm link`.
+
+## Usage
+
+```typescript
+import { MarketStackClient } from "market-stack-sdk";
+
+const client = new MarketStackClient({
+  apiKey: process.env.ALPHA_API_KEY!,
+  // Optional override. Defaults to https://developers.manasija.in
+  // baseUrl: "https://developers.manasija.in",
+});
+
+// Dedicated helpers are available for every route:
+console.log(await client.getNews());
+console.log(await client.getAnnouncements());
+console.log(
+  await client.getEarningsDetail({ symbol: "MEDIASSIST", quarter: "q4_26", detailed: true }),
+);
+```
+
+All calls automatically send `X-API-Key` using the `apiKey` provided in the constructor.
+
+Use `get`, `post`, `put`, `patch`, `delete`, or `request` to call any public `/v1` endpoint programmatically.
+
+## WebSocket (`/v1/ws`)
+
+```typescript
+import { MarketStackClient } from "market-stack-sdk";
+
+const client = new MarketStackClient({ apiKey: process.env.ALPHA_API_KEY! });
+const ws = client.websocket();
+
+await ws.connect();
+await ws.subscribe({ product: "announcements", symbols: ["RELIANCE"], detailed: false });
+
+for await (const event of ws.events()) {
+  if (event.kind === "subscribed") {
+    console.log("ready", event.product, event.tier);
+  } else if (event.kind === "data") {
+    console.log(event.channel, event.data.symbol);
+  }
+}
+
+await ws.close();
+```
+
+Direct session import (without creating `MarketStackClient`):
+
+```typescript
+import { AlphaWebSocketSession } from "market-stack-sdk";
+
+const ws = new AlphaWebSocketSession({
+  apiKey: process.env.ALPHA_API_KEY!,
+  autoReconnect: true,
+});
+
+await ws.connect();
+await ws.subscribe({ product: "news", symbols: ["RELIANCE"], detailed: true });
+await ws.run();
+```
+
+Callback style:
+
+```typescript
+const ws = client.websocket({
+  onData: (event) => console.log(event.data),
+});
+
+await ws.connect();
+await ws.subscribe({ product: "alerts", symbols: ["RELIANCE"] });
+await ws.run();
+
+// Optional resilience hooks:
+// autoReconnect: true,
+// reconnectInitialDelayMs: 1000,
+// reconnectMaxDelayMs: 30000,
+// onReconnectAttempt: (attempt, delayMs, reason) => console.log({ attempt, delayMs, reason }),
+// onOpen: () => console.log("ws connected"),
+// onClose: (reason) => console.log("ws closed", reason),
+```

package/dist/client.d.ts

@@ -0,0 +1,73 @@
+import { AlphaWebSocketSession, type AlphaWebSocketSessionOptions } from "./websocket.js";
+import { type AccountLedgerQueryParams, type AlertsQueryParams, type AnnouncementsQueryParams, type BatchJobsListQueryParams, type ConcallsQueryParams, type DocumentIdsQueryParams, type EarningsQueryParams, type NewsQueryParams, type SymbolMetadataQueryParams, type SymbolQuarterQueryParams, type ConcallTranscriptBatchParams, type BatchJobIdParams, type DailySummaryParams } from "./params.js";
+import type { AccountDetailResponse, AccountLimitsResponse, AccountUsageEnvelope, Alert, AnnouncementDetail, AnnouncementListItem, EarningsDetail, EarningsListItem, BatchAttachmentLookupResponse, BatchJobCancelResponse, BatchJobListResponse, BatchJobResponse, Concall, ConcallArtifactUrlsResponse, ConcallTranscriptBatchResponse, JsonValue, LedgerListResponse, NewsItem, PaginatedResponse, StringListResponse, SummaryResponse, SymbolMetadataResponse } from "./types.js";
+export declare const DEFAULT_BASE_URL = "https://developers.manasija.in";
+export type JsonBody = Record<string, JsonValue> | JsonValue[] | null;
+export type QueryValue = string | number | boolean | null | undefined;
+/** Serialized query string map used by low-level `request()`. Prefer endpoint param types on client methods. */
+export type QueryParams = Record<string, QueryValue | QueryValue[]>;
+export type PathParams = Record<string, string | number>;
+export type RequestOptions = Readonly<{
+    body?: JsonBody | FormData;
+    query?: QueryParams;
+    pathParams?: PathParams;
+    headers?: Record<string, string>;
+}>;
+export type MarketStackClientOptions = Readonly<{
+    apiKey: string;
+    baseUrl?: string;
+    headers?: Record<string, string>;
+    fetchImpl?: typeof fetch;
+}>;
+export declare class MarketStackClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly extraHeaders;
+    private readonly fetchImpl?;
+    constructor(options: MarketStackClientOptions);
+    private mergeHeaders;
+    private buildPath;
+    private appendQuery;
+    request<TResponse extends JsonValue | string | null>(method: string, path: string, options?: RequestOptions): Promise<TResponse>;
+    get<TResponse extends JsonValue | string | null>(path: string, options?: Omit<RequestOptions, "body">): Promise<TResponse>;
+    post<TResponse extends JsonValue | string | null>(path: string, options?: RequestOptions): Promise<TResponse>;
+    put<TResponse extends JsonValue | string | null>(path: string, options?: RequestOptions): Promise<TResponse>;
+    patch<TResponse extends JsonValue | string | null>(path: string, options?: RequestOptions): Promise<TResponse>;
+    delete<TResponse extends JsonValue | string | null>(path: string, options?: Omit<RequestOptions, "body">): Promise<TResponse>;
+    getNews(params?: NewsQueryParams): Promise<PaginatedResponse<NewsItem>>;
+    getSymbolsMetadata(params: SymbolMetadataQueryParams): Promise<SymbolMetadataResponse>;
+    getAnnouncementsCategories(): Promise<StringListResponse>;
+    getAnnouncements(params?: AnnouncementsQueryParams): Promise<PaginatedResponse<AnnouncementListItem | AnnouncementDetail>>;
+    getAnnouncementsAttachments(params: DocumentIdsQueryParams): Promise<BatchAttachmentLookupResponse>;
+    postDailySummary(params: DailySummaryParams): Promise<SummaryResponse>;
+    getEarnings(params?: EarningsQueryParams): Promise<PaginatedResponse<EarningsListItem | EarningsDetail>>;
+    getEarningsDetail(params: SymbolQuarterQueryParams): Promise<EarningsListItem | EarningsDetail>;
+    getEarningsAttachments(params: DocumentIdsQueryParams): Promise<BatchAttachmentLookupResponse>;
+    getConcalls(params?: ConcallsQueryParams): Promise<PaginatedResponse<Concall>>;
+    getConcallsDetail(params: SymbolQuarterQueryParams): Promise<Concall>;
+    getConcallsTranscript(params: SymbolQuarterQueryParams): Promise<ConcallArtifactUrlsResponse>;
+    postConcallsTranscripts(params: ConcallTranscriptBatchParams): Promise<ConcallTranscriptBatchResponse>;
+    getAlerts(params?: AlertsQueryParams): Promise<PaginatedResponse<Alert>>;
+    getAccount(): Promise<AccountDetailResponse>;
+    getAccountLimits(): Promise<AccountLimitsResponse>;
+    getAccountUsage(): Promise<AccountUsageEnvelope>;
+    getAccountLedger(params?: AccountLedgerQueryParams): Promise<LedgerListResponse>;
+    postBatchJobs(params: {
+        file: Blob;
+        filename?: string;
+        display_name?: string;
+        metadata?: string;
+    }): Promise<BatchJobResponse>;
+    postBatchJobsFile(params: {
+        file: Blob;
+        filename?: string;
+        display_name?: string;
+        metadata?: string;
+    }): Promise<BatchJobResponse>;
+    getBatchJobs(params?: BatchJobsListQueryParams): Promise<BatchJobListResponse>;
+    getBatchJobsJobId(params: BatchJobIdParams): Promise<BatchJobResponse>;
+    deleteBatchJobsJobId(params: BatchJobIdParams): Promise<BatchJobCancelResponse>;
+    getBatchJobsJobIdResults(params: BatchJobIdParams): Promise<string>;
+    websocket(options?: Omit<AlphaWebSocketSessionOptions, "apiKey" | "baseUrl" | "headers">): AlphaWebSocketSession;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,KAAK,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EAGL,KAAK,wBAAwB,EAC7B,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC7B,KAAK,wBAAwB,EAC7B,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,KAAK,4BAA4B,EACjC,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACxB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,qBAAqB,EACrB,qBAAqB,EACrB,oBAAoB,EACpB,KAAK,EACL,kBAAkB,EAClB,oBAAoB,EACpB,cAAc,EACd,gBAAgB,EAChB,6BAA6B,EAC7B,sBAAsB,EACtB,oBAAoB,EACpB,gBAAgB,EAChB,OAAO,EACP,2BAA2B,EAC3B,8BAA8B,EAC9B,SAAS,EACT,kBAAkB,EAClB,QAAQ,EACR,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,gBAAgB,mCAAmC,CAAC;AAEjE,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,SAAS,EAAE,GAAG,IAAI,CAAC;AACtE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC;AACtE,gHAAgH;AAChH,MAAM,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,UAAU,EAAE,CAAC,CAAC;AACpE,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC;AACzD,MAAM,MAAM,cAAc,GAAG,QAAQ,CAAC;IACpC,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B,CAAC,CAAC;AAqCH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAyB;IACtD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAe;gBAE9B,OAAO,EAAE,wBAAwB;IAU7C,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,SAAS;IAqBjB,OAAO,CAAC,WAAW;IAoBb,OAAO,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,GAAG,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IA0B1I,GAAG,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI9H,IAAI,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIjH,GAAG,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIhH,KAAK,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,SAAS,CAAC;IAIlH,MAAM,CAAC,SAAS,SAAS,SAAS,GAAG,MAAM,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,IAAI,CAAC,cAAc,EAAE,MAAM,CAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAIjI,OAAO,CAAC,MAAM,GAAE,eAAoB,GAAG,OAAO,CAAC,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAM3E,kBAAkB,CAAC,MAAM,EAAE,yBAAyB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAMtF,0BAA0B,IAAI,OAAO,CAAC,kBAAkB,CAAC;IAIzD,gBAAgB,CACd,MAAM,GAAE,wBAA6B,GACpC,OAAO,CAAC,iBAAiB,CAAC,oBAAoB,GAAG,kBAAkB,CAAC,CAAC;IAMxE,2BAA2B,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAMnG,gBAAgB,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC;IAItE,WAAW,CACT,MAAM,GAAE,mBAAwB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,gBAAgB,GAAG,cAAc,CAAC,CAAC;IAWhE,iBAAiB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,gBAAgB,GAAG,cAAc,CAAC;IAQ/F,sBAAsB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,6BAA6B,CAAC;IAM9F,WAAW,CAAC,MAAM,GAAE,mBAAwB,GAAG,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAMlF,iBAAiB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAIrE,qBAAqB,CAAC,MAAM,EAAE,wBAAwB,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAM7F,uBAAuB,CAAC,MAAM,EAAE,4BAA4B,GAAG,OAAO,CAAC,8BAA8B,CAAC;IAItG,SAAS,CAAC,MAAM,GAAE,iBAAsB,GAAG,OAAO,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAM5E,UAAU,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAI5C,gBAAgB,IAAI,OAAO,CAAC,qBAAqB,CAAC;IAIlD,eAAe,IAAI,OAAO,CAAC,oBAAoB,CAAC;IAIhD,gBAAgB,CAAC,MAAM,GAAE,wBAA6B,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAIpF,aAAa,CAAC,MAAM,EAAE;QACpB,IAAI,EAAE,IAAI,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAI7B,iBAAiB,CAAC,MAAM,EAAE;QACxB,IAAI,EAAE,IAAI,CAAC;QACX,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAY7B,YAAY,CAAC,MAAM,GAAE,wBAA6B,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAIlF,iBAAiB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAItE,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAI/E,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAInE,SAAS,CACP,OAAO,GAAE,IAAI,CAAC,4BAA4B,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAM,GACjF,qBAAqB;CAQzB"}

package/dist/client.js

@@ -0,0 +1,253 @@
+import { MarketStackApiError } from "./errors.js";
+import { AlphaWebSocketSession } from "./websocket.js";
+import { serializeAnnouncementsQueryParams, serializeQueryParams, } from "./params.js";
+export const DEFAULT_BASE_URL = "https://developers.manasija.in";
+function normalizeEarningsItemPayload(item) {
+    if (!item || typeof item !== "object" || Array.isArray(item)) {
+        return item;
+    }
+    const record = item;
+    if (record.earnings_table === undefined && record.earnings_table_extraction !== undefined) {
+        record.earnings_table = record.earnings_table_extraction;
+    }
+    return record;
+}
+function joinUrl(base, path) {
+    const b = base.replace(/\/+$/, "");
+    const p = path.replace(/^\/+/, "");
+    return `${b}/${p}`;
+}
+async function parseResponse(response) {
+    if (response.status === 204) {
+        return null;
+    }
+    const contentType = response.headers.get("content-type") ?? "";
+    let data;
+    if (contentType.includes("application/json")) {
+        const text = await response.text();
+        data = text.length > 0 ? JSON.parse(text) : null;
+    }
+    else {
+        data = await response.text();
+    }
+    if (!response.ok) {
+        throw new MarketStackApiError(response.status, data);
+    }
+    return data;
+}
+export class MarketStackClient {
+    baseUrl;
+    apiKey;
+    extraHeaders;
+    fetchImpl;
+    constructor(options) {
+        this.baseUrl = options.baseUrl ?? DEFAULT_BASE_URL;
+        this.apiKey = options.apiKey;
+        this.extraHeaders = { ...options.headers };
+        this.fetchImpl = options.fetchImpl;
+        if (!this.apiKey || this.apiKey.trim().length === 0) {
+            throw new Error("MarketStackClient requires a non-empty apiKey");
+        }
+    }
+    mergeHeaders(init) {
+        const h = new Headers(init);
+        for (const [k, v] of Object.entries(this.extraHeaders)) {
+            h.set(k, v);
+        }
+        h.set("X-API-Key", this.apiKey);
+        return h;
+    }
+    buildPath(pathTemplate, pathParams) {
+        if (!pathParams) {
+            return pathTemplate;
+        }
+        let resolved = pathTemplate.replace(/:([a-zA-Z0-9_]+)/g, (_whole, key) => {
+            const value = pathParams[key];
+            if (value === undefined || value === null) {
+                throw new Error(`Missing required path param: ${key}`);
+            }
+            return encodeURIComponent(String(value));
+        });
+        resolved = resolved.replace(/\{([a-zA-Z0-9_]+)\}/g, (_whole, key) => {
+            const value = pathParams[key];
+            if (value === undefined || value === null) {
+                throw new Error(`Missing required path param: ${key}`);
+            }
+            return encodeURIComponent(String(value));
+        });
+        return resolved;
+    }
+    appendQuery(url, query) {
+        if (!query) {
+            return;
+        }
+        for (const [key, rawValue] of Object.entries(query)) {
+            if (rawValue === undefined || rawValue === null) {
+                continue;
+            }
+            if (Array.isArray(rawValue)) {
+                for (const value of rawValue) {
+                    if (value !== undefined && value !== null) {
+                        url.searchParams.append(key, String(value));
+                    }
+                }
+                continue;
+            }
+            url.searchParams.set(key, String(rawValue));
+        }
+    }
+    async request(method, path, options = {}) {
+        const resolvedPath = this.buildPath(path, options.pathParams).replace(/^\/+/, "");
+        const url = new URL(joinUrl(this.baseUrl, resolvedPath));
+        this.appendQuery(url, options.query);
+        const headers = this.mergeHeaders({ Accept: "application/json", ...options.headers });
+        const isFormData = typeof FormData !== "undefined" && options.body instanceof FormData;
+        let body;
+        if (options.body === undefined || options.body === null) {
+            body = undefined;
+        }
+        else if (isFormData) {
+            body = options.body;
+        }
+        else {
+            body = JSON.stringify(options.body);
+            headers.set("Content-Type", "application/json");
+        }
+        const fetchFn = this.fetchImpl
+            ? this.fetchImpl.bind(globalThis)
+            : ((input, init) => globalThis.fetch(input, init));
+        const response = await fetchFn(url.toString(), {
+            method: method.toUpperCase(),
+            headers,
+            body,
+        });
+        return parseResponse(response);
+    }
+    get(path, options = {}) {
+        return this.request("GET", path, options);
+    }
+    post(path, options = {}) {
+        return this.request("POST", path, options);
+    }
+    put(path, options = {}) {
+        return this.request("PUT", path, options);
+    }
+    patch(path, options = {}) {
+        return this.request("PATCH", path, options);
+    }
+    delete(path, options = {}) {
+        return this.request("DELETE", path, options);
+    }
+    getNews(params = {}) {
+        return this.get("/v1/news", {
+            query: serializeQueryParams(params, ["symbols", "scrip_codes"]),
+        });
+    }
+    getSymbolsMetadata(params) {
+        return this.get("/v1/symbols/metadata", {
+            query: serializeQueryParams(params, ["symbols", "scrip_codes"]),
+        });
+    }
+    getAnnouncementsCategories() {
+        return this.get("/v1/announcements/categories");
+    }
+    getAnnouncements(params = {}) {
+        return this.get("/v1/announcements", {
+            query: serializeAnnouncementsQueryParams(params),
+        });
+    }
+    getAnnouncementsAttachments(params) {
+        return this.get("/v1/announcements/attachments", {
+            query: serializeQueryParams(params, ["ids"]),
+        });
+    }
+    postDailySummary(params) {
+        return this.post("/v1/daily-summary", { body: params.body });
+    }
+    getEarnings(params = {}) {
+        return this.get("/v1/earnings", {
+            query: serializeQueryParams(params, ["symbols", "scrip_codes"]),
+        }).then((response) => {
+            response.data = response.data.map((item) => normalizeEarningsItemPayload(item));
+            return response;
+        });
+    }
+    getEarningsDetail(params) {
+        return this.get("/v1/earnings/detail", {
+            query: serializeQueryParams(params),
+        }).then((response) => normalizeEarningsItemPayload(response));
+    }
+    getEarningsAttachments(params) {
+        return this.get("/v1/earnings/attachments", {
+            query: serializeQueryParams(params, ["ids"]),
+        });
+    }
+    getConcalls(params = {}) {
+        return this.get("/v1/concalls", {
+            query: serializeQueryParams(params, ["symbols", "scrip_codes"]),
+        });
+    }
+    getConcallsDetail(params) {
+        return this.get("/v1/concalls/detail", { query: serializeQueryParams(params) });
+    }
+    getConcallsTranscript(params) {
+        return this.get("/v1/concalls/transcript", {
+            query: serializeQueryParams(params),
+        });
+    }
+    postConcallsTranscripts(params) {
+        return this.post("/v1/concalls/transcripts", { body: { items: params.items } });
+    }
+    getAlerts(params = {}) {
+        return this.get("/v1/alerts", {
+            query: serializeQueryParams(params, ["symbols", "scrip_codes", "type"]),
+        });
+    }
+    getAccount() {
+        return this.get("/v1/account");
+    }
+    getAccountLimits() {
+        return this.get("/v1/account/limits");
+    }
+    getAccountUsage() {
+        return this.get("/v1/account/usage");
+    }
+    getAccountLedger(params = {}) {
+        return this.get("/v1/account/ledger", { query: serializeQueryParams(params) });
+    }
+    postBatchJobs(params) {
+        return this.postBatchJobsFile(params);
+    }
+    postBatchJobsFile(params) {
+        const form = new FormData();
+        form.append("file", params.file, params.filename ?? "batch.jsonl");
+        if (params.display_name !== undefined) {
+            form.append("display_name", params.display_name);
+        }
+        if (params.metadata !== undefined) {
+            form.append("metadata", params.metadata);
+        }
+        return this.post("/v1/batch/jobs", { body: form });
+    }
+    getBatchJobs(params = {}) {
+        return this.get("/v1/batch/jobs", { query: serializeQueryParams(params) });
+    }
+    getBatchJobsJobId(params) {
+        return this.get("/v1/batch/jobs/{job_id}", { pathParams: { job_id: params.job_id } });
+    }
+    deleteBatchJobsJobId(params) {
+        return this.delete("/v1/batch/jobs/{job_id}", { pathParams: { job_id: params.job_id } });
+    }
+    getBatchJobsJobIdResults(params) {
+        return this.get("/v1/batch/jobs/{job_id}/results", { pathParams: { job_id: params.job_id } });
+    }
+    websocket(options = {}) {
+        return new AlphaWebSocketSession({
+            apiKey: this.apiKey,
+            baseUrl: this.baseUrl,
+            headers: this.extraHeaders,
+            ...options,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,10 @@
+export type ApiErrorBody = unknown;
+export declare class MarketStackWebSocketError extends Error {
+    constructor(message: string);
+}
+export declare class MarketStackApiError extends Error {
+    readonly statusCode: number;
+    readonly body: ApiErrorBody;
+    constructor(statusCode: number, body: ApiErrorBody);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,OAAO,CAAC;AAEnC,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;gBAEhB,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY;CAMnD"}

package/dist/errors.js

@@ -0,0 +1,17 @@
+export class MarketStackWebSocketError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "MarketStackWebSocketError";
+    }
+}
+export class MarketStackApiError extends Error {
+    statusCode;
+    body;
+    constructor(statusCode, body) {
+        super(`Market-Stack API error ${statusCode}: ${String(body)}`);
+        this.name = "MarketStackApiError";
+        this.statusCode = statusCode;
+        this.body = body;
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IACnC,UAAU,CAAS;IACnB,IAAI,CAAe;IAE5B,YAAY,UAAkB,EAAE,IAAkB;QAChD,KAAK,CAAC,0BAA0B,UAAU,KAAK,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/D,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { DEFAULT_BASE_URL, MarketStackClient } from "./client.js";
+export type { JsonBody, MarketStackClientOptions, PathParams, QueryParams, QueryValue, RequestOptions, } from "./client.js";
+export type * from "./types.js";
+export type * from "./params.js";
+export { serializeAnnouncementsQueryParams, serializeQueryParams } from "./params.js";
+export { MarketStackApiError, MarketStackWebSocketError } from "./errors.js";
+export type { ApiErrorBody } from "./errors.js";
+export { ALPHA_WS_PRODUCTS, AlphaWebSocketSession, buildWebSocketUrl, parseWebSocketMessage, streamProduct, } from "./websocket.js";
+export type { AlphaWebSocketProduct, AlphaWebSocketSessionOptions, DataEvent, DataPayloadByChannel, ErrorEvent, KnownDataEvent, RawEvent, SubscribeOptions, SubscribedEvent, UnknownDataEvent, WebSocketEvent, WebSocketHandler, } from "./websocket.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClE,YAAY,EACV,QAAQ,EACR,wBAAwB,EACxB,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,mBAAmB,YAAY,CAAC;AAChC,mBAAmB,aAAa,CAAC;AACjC,OAAO,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC7E,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,qBAAqB,EACrB,4BAA4B,EAC5B,SAAS,EACT,oBAAoB,EACpB,UAAU,EACV,cAAc,EACd,QAAQ,EACR,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,cAAc,EACd,gBAAgB,GACjB,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { DEFAULT_BASE_URL, MarketStackClient } from "./client.js";
+export { serializeAnnouncementsQueryParams, serializeQueryParams } from "./params.js";
+export { MarketStackApiError, MarketStackWebSocketError } from "./errors.js";
+export { ALPHA_WS_PRODUCTS, AlphaWebSocketSession, buildWebSocketUrl, parseWebSocketMessage, streamProduct, } from "./websocket.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAWlE,OAAO,EAAE,iCAAiC,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtF,OAAO,EAAE,mBAAmB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAE7E,OAAO,EACL,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,aAAa,GACd,MAAM,gBAAgB,CAAC"}

package/dist/params.d.ts

@@ -0,0 +1,99 @@
+/** Query parameter models aligned with alpha-api /v1 route definitions. */
+import type { SymbolQuarterKey } from "./types.js";
+export type NewsSentiment = "positive" | "negative" | "neutral";
+/** ISO date or datetime string (e.g. 2026-05-01 or 2026-05-11T23:59:59Z). */
+export type IsoDateTimeParam = string;
+/** Fiscal quarter key accepted by detail routes (e.g. q4_26). */
+export type FiscalQuarterParam = string;
+export type NewsQueryParams = {
+    /** Serialized as comma-separated `symbols`. */
+    symbols?: string[];
+    /** Serialized as comma-separated `scrip_codes`. */
+    scrip_codes?: string[];
+    sentiment?: NewsSentiment;
+    /** Query key: `from`. */
+    from?: IsoDateTimeParam;
+    to?: IsoDateTimeParam;
+    page?: number;
+    limit?: number;
+};
+export type PaginatedFeedQueryParams = {
+    symbols?: string[];
+    scrip_codes?: string[];
+    from?: IsoDateTimeParam;
+    to?: IsoDateTimeParam;
+    detailed?: boolean;
+    page?: number;
+    limit?: number;
+};
+/** GET /v1/announcements list filter. */
+export type AnnouncementsListQueryParams = PaginatedFeedQueryParams & {
+    categories?: string[];
+};
+export type AnnouncementsQueryParams = AnnouncementsListQueryParams;
+/** GET /v1/earnings — same filters as announcements except categories. */
+export type EarningsQueryParams = PaginatedFeedQueryParams;
+export type ConcallsQueryParams = PaginatedFeedQueryParams;
+export type AlertsQueryParams = {
+    symbols?: string[];
+    scrip_codes?: string[];
+    /** Alert type filter. Query key: `type`. */
+    type?: string[];
+    from?: IsoDateTimeParam;
+    to?: IsoDateTimeParam;
+    important?: boolean;
+    page?: number;
+    limit?: number;
+};
+/** GET /v1/announcements/attachments and GET /v1/earnings/attachments */
+export type DocumentIdsQueryParams = {
+    ids: string[];
+};
+/** GET /v1/symbols/metadata */
+export type SymbolMetadataQueryParams = {
+    symbols?: string[];
+    scrip_codes?: string[];
+};
+/** Optional flags for GET /v1/earnings/detail and GET /v1/concalls/detail */
+export type SymbolQuarterDetailQueryParams = {
+    detailed?: boolean;
+};
+/** GET /v1/earnings/detail, GET /v1/concalls/detail, GET /v1/concalls/transcript */
+export type SymbolQuarterQueryParams = SymbolQuarterDetailQueryParams & {
+    symbol?: string;
+    scrip_code?: string;
+    quarter: string;
+};
+export type ConcallTranscriptBatchParams = {
+    items: SymbolQuarterKey[];
+};
+export type BatchJobIdParams = {
+    job_id: string | number;
+};
+export type DailySummaryParams = {
+    body: DailySummaryRequestBody;
+};
+/** GET /v1/account/ledger */
+export type AccountLedgerQueryParams = {
+    limit?: number;
+};
+/** GET /v1/batch/jobs */
+export type BatchJobsListQueryParams = {
+    limit?: number;
+};
+export type DailySummaryPortfolioItem = {
+    symbol: string;
+    exposure: number;
+};
+export type DailySummaryRequestBody = {
+    portfolio: DailySummaryPortfolioItem[];
+};
+export type QueryPrimitive = string | number | boolean;
+/**
+ * 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 declare function serializeQueryParams<T extends object>(params: T, listKeys?: readonly (keyof T & string)[]): Record<string, QueryPrimitive>;
+/** Announcements list vs by-id modes use different query keys. */
+export declare function serializeAnnouncementsQueryParams(params: AnnouncementsQueryParams): Record<string, QueryPrimitive>;
+//# sourceMappingURL=params.d.ts.map

package/dist/params.d.ts.map

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