screener-india 1.0.0

package/lib/client/base.d.ts

@@ -0,0 +1,16 @@
+import { AxiosInstance } from "axios";
+import type { ClientConfig, CompanyMode, Meta } from "../types.js";
+import { TtlCache } from "../utils/cache.js";
+import { Throttle } from "../utils/throttle.js";
+export declare abstract class BaseClient {
+    protected readonly http: AxiosInstance;
+    protected readonly cache: TtlCache;
+    protected readonly throttle: Throttle;
+    protected readonly config: Required<ClientConfig>;
+    constructor(config?: ClientConfig);
+    protected cacheKey(url: string): string;
+    protected meta(url: string): Meta;
+    protected fetchHtml(url: string, scope?: string): Promise<string>;
+    protected companyUrl(symbol: string, mode: CompanyMode): string;
+}
+//# sourceMappingURL=base.d.ts.map

package/lib/client/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/client/base.ts"],"names":[],"mappings":"AAAA,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE7C,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAOhD,8BAAsB,UAAU;IAC9B,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IACvC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC;IACnC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IACtC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;gBAEtC,MAAM,GAAE,YAAiB;IA8BrC,SAAS,CAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIvC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;cAQjB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,SAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAwB1E,SAAS,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM;CAIhE"}

package/lib/client/base.js

@@ -0,0 +1,74 @@
+import axios from "axios";
+import crypto from "crypto";
+import { TtlCache } from "../utils/cache.js";
+import { Throttle } from "../utils/throttle.js";
+import { retryWithBackoff } from "../utils/retry.js";
+const PARSER_VERSION = "1.0.0";
+const DEFAULT_USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+export class BaseClient {
+    http;
+    cache;
+    throttle;
+    config;
+    constructor(config = {}) {
+        this.config = {
+            baseUrl: config.baseUrl ?? "https://www.screener.in",
+            cacheTtlMs: config.cacheTtlMs ?? 300_000,
+            minIntervalMs: config.minIntervalMs ?? 200,
+            maxRetries: config.maxRetries ?? 2,
+            timeoutMs: config.timeoutMs ?? 20_000,
+            proxyUrl: config.proxyUrl ?? "",
+            cookies: config.cookies ?? "",
+        };
+        const defaultHeaders = {
+            "User-Agent": DEFAULT_USER_AGENT,
+            Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+            "Accept-Language": "en-US,en;q=0.9",
+        };
+        if (this.config.cookies) {
+            defaultHeaders["Cookie"] = this.config.cookies;
+        }
+        this.http = axios.create({
+            timeout: this.config.timeoutMs,
+            headers: defaultHeaders,
+        });
+        this.cache = new TtlCache(this.config.cacheTtlMs);
+        this.throttle = new Throttle(this.config.minIntervalMs);
+    }
+    cacheKey(url) {
+        return crypto.createHash("sha256").update(url).digest("hex");
+    }
+    meta(url) {
+        return {
+            sourceUrl: url,
+            fetchedAt: new Date().toISOString(),
+            parserVersion: PARSER_VERSION,
+        };
+    }
+    async fetchHtml(url, scope = "default") {
+        const key = this.cacheKey(url);
+        const cached = this.cache.get(key);
+        if (cached)
+            return cached;
+        await this.throttle.wait(scope);
+        const html = await retryWithBackoff(async () => {
+            const res = await this.http.get(url, {
+                responseType: "text",
+                maxRedirects: 5,
+            });
+            // Detect login-wall: screener.in redirects protected pages to /register/ or /login/
+            const finalUrl = res.request?.res?.responseUrl ?? "";
+            if (finalUrl.includes("/register") || finalUrl.includes("/login")) {
+                throw new Error(`LOGIN_REQUIRED: ${url} requires a screener.in account`);
+            }
+            return res.data;
+        }, this.config.maxRetries);
+        this.cache.set(key, html);
+        return html;
+    }
+    companyUrl(symbol, mode) {
+        const base = `${this.config.baseUrl}/company/${symbol.toUpperCase()}`;
+        return mode === "consolidated" ? `${base}/consolidated/` : `${base}/`;
+    }
+}
+//# sourceMappingURL=base.js.map

package/lib/client/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/client/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,MAAM,cAAc,GAAG,OAAO,CAAC;AAC/B,MAAM,kBAAkB,GACtB,uGAAuG,CAAC;AAE1G,MAAM,OAAgB,UAAU;IACX,IAAI,CAAgB;IACpB,KAAK,CAAW;IAChB,QAAQ,CAAW;IACnB,MAAM,CAAyB;IAElD,YAAY,SAAuB,EAAE;QACnC,IAAI,CAAC,MAAM,GAAG;YACZ,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,yBAAyB;YACpD,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,OAAO;YACxC,aAAa,EAAE,MAAM,CAAC,aAAa,IAAI,GAAG;YAC1C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,CAAC;YAClC,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,MAAM;YACrC,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,EAAE;YAC/B,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE;SAC9B,CAAC;QAEF,MAAM,cAAc,GAA2B;YAC7C,YAAY,EAAE,kBAAkB;YAChC,MAAM,EAAE,iEAAiE;YACzE,iBAAiB,EAAE,gBAAgB;SACpC,CAAC;QAEF,IAAI,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxB,cAAc,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QACjD,CAAC;QAED,IAAI,CAAC,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC;YACvB,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAC9B,OAAO,EAAE,cAAc;SACxB,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1D,CAAC;IAES,QAAQ,CAAC,GAAW;QAC5B,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/D,CAAC;IAES,IAAI,CAAC,GAAW;QACxB,OAAO;YACL,SAAS,EAAE,GAAG;YACd,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,aAAa,EAAE,cAAc;SAC9B,CAAC;IACJ,CAAC;IAES,KAAK,CAAC,SAAS,CAAC,GAAW,EAAE,KAAK,GAAG,SAAS;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC/B,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAS,GAAG,CAAC,CAAC;QAC3C,IAAI,MAAM;YAAE,OAAO,MAAM,CAAC;QAE1B,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEhC,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,KAAK,IAAI,EAAE;YAC7C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAS,GAAG,EAAE;gBAC3C,YAAY,EAAE,MAAM;gBACpB,YAAY,EAAE,CAAC;aAChB,CAAC,CAAC;YACH,oFAAoF;YACpF,MAAM,QAAQ,GAAY,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,WAAsB,IAAI,EAAE,CAAC;YACzE,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAClE,MAAM,IAAI,KAAK,CAAC,mBAAmB,GAAG,iCAAiC,CAAC,CAAC;YAC3E,CAAC;YACD,OAAO,GAAG,CAAC,IAAc,CAAC;QAC5B,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE3B,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAES,UAAU,CAAC,MAAc,EAAE,IAAiB;QACpD,MAAM,IAAI,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,YAAY,MAAM,CAAC,WAAW,EAAE,EAAE,CAAC;QACtE,OAAO,IAAI,KAAK,cAAc,CAAC,CAAC,CAAC,GAAG,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC;IACxE,CAAC;CACF"}

package/lib/client/company.d.ts

@@ -0,0 +1,21 @@
+import type { CompanyMode, CompanyTab, CompanyData, CompanyRaw, CompanySummary, ApiResponse } from "../types.js";
+import { BaseClient } from "./base.js";
+export declare abstract class CompanyClient extends BaseClient {
+    /**
+     * Fetch full company snapshot — ratios, financials, analysis, peers, documents.
+     */
+    getCompany(symbol: string, mode?: CompanyMode): Promise<ApiResponse<CompanyData>>;
+    /**
+     * Fetch a specific financial tab for a company.
+     */
+    getCompanyTab(symbol: string, tab: CompanyTab, mode?: CompanyMode): Promise<ApiResponse<Partial<CompanyData>>>;
+    /**
+     * Fetch raw HTML and available section IDs for a company page.
+     */
+    getCompanyRaw(symbol: string, mode?: CompanyMode): Promise<ApiResponse<CompanyRaw>>;
+    /**
+     * Compare multiple companies side-by-side — returns a summary row per symbol.
+     */
+    compareCompanies(symbols: string[], mode?: CompanyMode): Promise<ApiResponse<CompanySummary[]>>;
+}
+//# sourceMappingURL=company.d.ts.map

package/lib/client/company.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"company.d.ts","sourceRoot":"","sources":["../../src/client/company.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,WAAW,EACZ,MAAM,aAAa,CAAC;AAWrB,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,8BAAsB,aAAc,SAAQ,UAAU;IACpD;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,WAA4B,GACjC,OAAO,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IA2BpC;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,UAAU,EACf,IAAI,GAAE,WAA4B,GACjC,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IA4C7C;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,IAAI,GAAE,WAA4B,GACjC,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;IAYnC;;OAEG;IACG,gBAAgB,CACpB,OAAO,EAAE,MAAM,EAAE,EACjB,IAAI,GAAE,WAA4B,GACjC,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,CAAC,CAAC;CAiC1C"}

package/lib/client/company.js

@@ -0,0 +1,119 @@
+import { parseHtml, parseTitle, parseTopRatios, parseTable, parseAnalysis, parseDocuments, parsePeers, parseSectionIds, } from "../utils/parser.js";
+import { BaseClient } from "./base.js";
+export class CompanyClient extends BaseClient {
+    /**
+     * Fetch full company snapshot — ratios, financials, analysis, peers, documents.
+     */
+    async getCompany(symbol, mode = "consolidated") {
+        const url = this.companyUrl(symbol, mode);
+        const html = await this.fetchHtml(url, "company");
+        const root = parseHtml(html);
+        const warnings = [];
+        const data = {
+            name: parseTitle(root),
+            symbol: symbol.toUpperCase(),
+            mode,
+            topRatios: parseTopRatios(root),
+            quarters: parseTable(root.querySelector("section#quarters")),
+            profitLoss: parseTable(root.querySelector("section#profit-loss")),
+            balanceSheet: parseTable(root.querySelector("section#balance-sheet")),
+            cashFlow: parseTable(root.querySelector("section#cash-flow")),
+            ratios: parseTable(root.querySelector("section#ratios")),
+            shareholding: parseTable(root.querySelector("section#shareholding")),
+            documents: parseDocuments(root),
+            analysis: parseAnalysis(root),
+            peers: parsePeers(root),
+        };
+        if (!data.name)
+            warnings.push("Could not parse company name");
+        return { data, meta: this.meta(url), warnings };
+    }
+    /**
+     * Fetch a specific financial tab for a company.
+     */
+    async getCompanyTab(symbol, tab, mode = "consolidated") {
+        const url = this.companyUrl(symbol, mode);
+        const html = await this.fetchHtml(url, "company");
+        const root = parseHtml(html);
+        const warnings = [];
+        const tabData = {
+            symbol: symbol.toUpperCase(),
+            mode,
+        };
+        switch (tab) {
+            case "quarters":
+                tabData.quarters = parseTable(root.querySelector("section#quarters"));
+                break;
+            case "profit-loss":
+                tabData.profitLoss = parseTable(root.querySelector("section#profit-loss"));
+                break;
+            case "balance-sheet":
+                tabData.balanceSheet = parseTable(root.querySelector("section#balance-sheet"));
+                break;
+            case "cash-flow":
+                tabData.cashFlow = parseTable(root.querySelector("section#cash-flow"));
+                break;
+            case "ratios":
+                tabData.ratios = parseTable(root.querySelector("section#ratios"));
+                break;
+            case "shareholding":
+                tabData.shareholding = parseTable(root.querySelector("section#shareholding"));
+                break;
+            case "documents":
+                tabData.documents = parseDocuments(root);
+                break;
+            case "analysis":
+                tabData.analysis = parseAnalysis(root);
+                break;
+            case "peers":
+                tabData.peers = parsePeers(root);
+                break;
+        }
+        return { data: tabData, meta: this.meta(url), warnings };
+    }
+    /**
+     * Fetch raw HTML and available section IDs for a company page.
+     */
+    async getCompanyRaw(symbol, mode = "consolidated") {
+        const url = this.companyUrl(symbol, mode);
+        const html = await this.fetchHtml(url, "company");
+        const root = parseHtml(html);
+        return {
+            data: { symbol: symbol.toUpperCase(), html, sectionIds: parseSectionIds(root) },
+            meta: this.meta(url),
+            warnings: [],
+        };
+    }
+    /**
+     * Compare multiple companies side-by-side — returns a summary row per symbol.
+     */
+    async compareCompanies(symbols, mode = "consolidated") {
+        const results = await Promise.allSettled(symbols.map((s) => this.getCompany(s, mode)));
+        const warnings = [];
+        const summaries = [];
+        results.forEach((r, i) => {
+            if (r.status === "rejected") {
+                const msg = r.reason instanceof Error ? r.reason.message : String(r.reason);
+                warnings.push(`Failed to fetch ${symbols[i]}: ${msg}`);
+                return;
+            }
+            const { data } = r.value;
+            const ratio = (name) => data.topRatios.find((tr) => tr.name.toLowerCase().includes(name.toLowerCase()))?.value;
+            summaries.push({
+                symbol: data.symbol,
+                name: data.name,
+                marketCap: ratio("market cap"),
+                currentPrice: ratio("current price"),
+                pe: ratio("stock p/e") ?? ratio("p/e"),
+                roe: ratio("roe"),
+                dividendYield: ratio("dividend yield"),
+            });
+        });
+        return {
+            data: summaries,
+            meta: this.meta(`${this.config.baseUrl}/company/`),
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=company.js.map

package/lib/client/company.js.map

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

package/lib/client/index.d.ts

@@ -0,0 +1,22 @@
+import type { ClientConfig } from "../types.js";
+import { SearchClient } from "./search.js";
+/**
+ * ScreenerClient — scrapes screener.in for Indian stock market data.
+ *
+ * @example
+ * ```ts
+ * const client = new ScreenerClient({ minIntervalMs: 300 });
+ * const { data } = await client.getCompany("TCS");
+ * ```
+ *
+ * For protected pages (screens, watchlist, announcements), pass a session cookie:
+ * ```ts
+ * const client = new ScreenerClient({ cookies: "sessionid=YOUR_SESSION_ID" });
+ * ```
+ */
+export declare class ScreenerClient extends SearchClient {
+    constructor(config?: ClientConfig);
+    /** Clear all cached responses. */
+    clearCache(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,qBAAa,cAAe,SAAQ,YAAY;gBAClC,MAAM,GAAE,YAAiB;IAIrC,kCAAkC;IAClC,UAAU,IAAI,IAAI;CAGnB"}

package/lib/client/index.js

@@ -0,0 +1,25 @@
+import { SearchClient } from "./search.js";
+/**
+ * ScreenerClient — scrapes screener.in for Indian stock market data.
+ *
+ * @example
+ * ```ts
+ * const client = new ScreenerClient({ minIntervalMs: 300 });
+ * const { data } = await client.getCompany("TCS");
+ * ```
+ *
+ * For protected pages (screens, watchlist, announcements), pass a session cookie:
+ * ```ts
+ * const client = new ScreenerClient({ cookies: "sessionid=YOUR_SESSION_ID" });
+ * ```
+ */
+export class ScreenerClient extends SearchClient {
+    constructor(config = {}) {
+        super(config);
+    }
+    /** Clear all cached responses. */
+    clearCache() {
+        this.cache.clear();
+    }
+}
+//# sourceMappingURL=index.js.map

package/lib/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC9C,YAAY,SAAuB,EAAE;QACnC,KAAK,CAAC,MAAM,CAAC,CAAC;IAChB,CAAC;IAED,kCAAkC;IAClC,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;CACF"}

package/lib/client/screens.d.ts

@@ -0,0 +1,14 @@
+import type { ScreenItem, ScreenDetails, ListScreensOptions, ScreenDetailsOptions, ApiResponse } from "../types.js";
+import { SectorClient } from "./sectors.js";
+export declare abstract class ScreenClient extends SectorClient {
+    /**
+     * List public stock screens with optional filtering, sorting, and pagination.
+     */
+    listScreens(options?: ListScreensOptions): Promise<ApiResponse<ScreenItem[]>>;
+    /**
+     * Fetch detailed company list for a specific screen.
+     * Requires a session cookie for protected screens.
+     */
+    getScreenDetails(screenId: number, slug: string, options?: ScreenDetailsOptions): Promise<ApiResponse<ScreenDetails>>;
+}
+//# sourceMappingURL=screens.d.ts.map

package/lib/client/screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screens.d.ts","sourceRoot":"","sources":["../../src/client/screens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,aAAa,EACb,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACZ,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,8BAAsB,YAAa,SAAQ,YAAY;IACrD;;OAEG;IACG,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IAkDvF;;;OAGG;IACG,gBAAgB,CACpB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;CAuCvC"}

package/lib/client/screens.js

@@ -0,0 +1,88 @@
+import { parseHtml, parseScreenItems, parseDataTable, parsePagination } from "../utils/parser.js";
+import { SectorClient } from "./sectors.js";
+export class ScreenClient extends SectorClient {
+    /**
+     * List public stock screens with optional filtering, sorting, and pagination.
+     */
+    async listScreens(options = {}) {
+        const { page = 1, includeAllPages = false, maxPages = 20, q, sort, order = "asc" } = options;
+        const fetchPage = async (p) => {
+            const url = `${this.config.baseUrl}/screens/?page=${p}`;
+            const html = await this.fetchHtml(url, "screens");
+            return parseScreenItems(parseHtml(html));
+        };
+        let items = await fetchPage(page);
+        if (includeAllPages) {
+            for (let p = page + 1; p <= maxPages; p++) {
+                const more = await fetchPage(p);
+                if (more.length === 0)
+                    break;
+                items.push(...more);
+            }
+            // Deduplicate by id
+            const seen = new Set();
+            items = items.filter((it) => {
+                if (seen.has(it.id))
+                    return false;
+                seen.add(it.id);
+                return true;
+            });
+        }
+        // Client-side filtering
+        if (q) {
+            const lq = q.toLowerCase();
+            items = items.filter((it) => it.title.toLowerCase().includes(lq) || it.description.toLowerCase().includes(lq));
+        }
+        // Client-side sorting
+        if (sort === "title") {
+            items.sort((a, b) => order === "asc" ? a.title.localeCompare(b.title) : b.title.localeCompare(a.title));
+        }
+        else if (sort === "id") {
+            items.sort((a, b) => (order === "asc" ? a.id - b.id : b.id - a.id));
+        }
+        return {
+            data: items,
+            meta: this.meta(`${this.config.baseUrl}/screens/?page=${page}`),
+            warnings: [],
+        };
+    }
+    /**
+     * Fetch detailed company list for a specific screen.
+     * Requires a session cookie for protected screens.
+     */
+    async getScreenDetails(screenId, slug, options = {}) {
+        const { page = 1, limit = 50, includeAllPages = false } = options;
+        const fetchPage = async (p) => {
+            const url = `${this.config.baseUrl}/screens/${screenId}/${slug}/?page=${p}&limit=${limit}`;
+            const html = await this.fetchHtml(url, "screens");
+            const root = parseHtml(html);
+            return { root, url };
+        };
+        const { root, url } = await fetchPage(page);
+        const { columns, rows } = parseDataTable(root);
+        const { totalPages } = parsePagination(root);
+        const titleEl = root.querySelector("h1, .screen-title, title");
+        const title = titleEl?.text.trim().split("|")[0].trim() ?? `Screen #${screenId}`;
+        const allRows = rows;
+        const warnings = [];
+        if (includeAllPages) {
+            for (let p = page + 1; p <= totalPages; p++) {
+                try {
+                    const { root: r } = await fetchPage(p);
+                    const { rows: moreRows } = parseDataTable(r);
+                    allRows.push(...moreRows);
+                }
+                catch (err) {
+                    const msg = err instanceof Error ? err.message : String(err);
+                    warnings.push(`Failed to fetch page ${p}: ${msg}`);
+                }
+            }
+        }
+        return {
+            data: { id: screenId, slug, title, columns, rows: allRows, page, totalPages },
+            meta: this.meta(url),
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=screens.js.map

package/lib/client/screens.js.map

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

package/lib/client/search.d.ts

@@ -0,0 +1,10 @@
+import type { SearchResult, ApiResponse } from "../types.js";
+import { ScreenClient } from "./screens.js";
+export declare abstract class SearchClient extends ScreenClient {
+    /**
+     * Search companies by name or symbol using the screener.in JSON search API.
+     * Returns real company names (not just symbols like the old sitemap approach).
+     */
+    searchCompanies(query: string, limit?: number): Promise<ApiResponse<SearchResult[]>>;
+}
+//# sourceMappingURL=search.d.ts.map

package/lib/client/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/client/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,8BAAsB,YAAa,SAAQ,YAAY;IACrD;;;OAGG;IACG,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC;CA6BvF"}

package/lib/client/search.js

@@ -0,0 +1,35 @@
+import { retryWithBackoff } from "../utils/retry.js";
+import { ScreenClient } from "./screens.js";
+export class SearchClient extends ScreenClient {
+    /**
+     * Search companies by name or symbol using the screener.in JSON search API.
+     * Returns real company names (not just symbols like the old sitemap approach).
+     */
+    async searchCompanies(query, limit = 10) {
+        const apiUrl = `${this.config.baseUrl}/api/company/search/?q=${encodeURIComponent(query)}&limit=${limit}`;
+        await this.throttle.wait("search");
+        const res = await retryWithBackoff(async () => {
+            return this.http.get(apiUrl, {
+                headers: { Accept: "application/json" },
+            });
+        }, this.config.maxRetries);
+        const items = Array.isArray(res.data) ? res.data : [];
+        const results = items.slice(0, limit).map((item) => {
+            const match = item.url?.match(/\/company\/([^/]+)\//);
+            const symbol = match?.[1] ?? item.name;
+            return {
+                symbol,
+                name: item.name,
+                url: item.url
+                    ? `${this.config.baseUrl}${item.url}`
+                    : `${this.config.baseUrl}/company/${symbol}/`,
+            };
+        });
+        return {
+            data: results,
+            meta: this.meta(apiUrl),
+            warnings: results.length === 0 ? ["No results found for the given query"] : [],
+        };
+    }
+}
+//# sourceMappingURL=search.js.map

package/lib/client/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/client/search.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,MAAM,OAAgB,YAAa,SAAQ,YAAY;IACrD;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,KAAa,EAAE,KAAK,GAAG,EAAE;QAC7C,MAAM,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,0BAA0B,kBAAkB,CAAC,KAAK,CAAC,UAAU,KAAK,EAAE,CAAC;QAC1G,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAEnC,MAAM,GAAG,GAAG,MAAM,gBAAgB,CAAC,KAAK,IAAI,EAAE;YAC5C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,CAAmD,MAAM,EAAE;gBAC7E,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;aACxC,CAAC,CAAC;QACL,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAE3B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,MAAM,OAAO,GAAmB,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACjE,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,sBAAsB,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC;YACvC,OAAO;gBACL,MAAM;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,EAAE,IAAI,CAAC,GAAG;oBACX,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE;oBACrC,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,YAAY,MAAM,GAAG;aAChD,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;YACvB,QAAQ,EAAE,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,sCAAsC,CAAC,CAAC,CAAC,CAAC,EAAE;SAC/E,CAAC;IACJ,CAAC;CACF"}

package/lib/client/sectors.d.ts

@@ -0,0 +1,15 @@
+import type { SectorItem, SectorData, SectorDataOptions, ApiResponse } from "../types.js";
+import { CompanyClient } from "./company.js";
+export declare abstract class SectorClient extends CompanyClient {
+    /**
+     * List all sectors available on screener.in.
+     */
+    listSectors(): Promise<ApiResponse<SectorItem[]>>;
+    /**
+     * Fetch companies in a sector with optional pagination.
+     * Pass `includeAllPages: true` to auto-fetch every page.
+     */
+    getSectorData(sector: string, options?: SectorDataOptions): Promise<ApiResponse<SectorData>>;
+    private _getAllSectorPages;
+}
+//# sourceMappingURL=sectors.d.ts.map

package/lib/client/sectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sectors.d.ts","sourceRoot":"","sources":["../../src/client/sectors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1F,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,8BAAsB,YAAa,SAAQ,aAAa;IACtD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC;IASvD;;;OAGG;IACG,aAAa,CACjB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;YAoBrB,kBAAkB;CAwBjC"}

package/lib/client/sectors.js

@@ -0,0 +1,55 @@
+import { parseHtml, parseSectorLinks, parseDataTable, parsePagination } from "../utils/parser.js";
+import { CompanyClient } from "./company.js";
+export class SectorClient extends CompanyClient {
+    /**
+     * List all sectors available on screener.in.
+     */
+    async listSectors() {
+        const url = `${this.config.baseUrl}/market/`;
+        const html = await this.fetchHtml(url, "sector");
+        const root = parseHtml(html);
+        const sectors = parseSectorLinks(root);
+        return { data: sectors, meta: this.meta(url), warnings: [] };
+    }
+    /**
+     * Fetch companies in a sector with optional pagination.
+     * Pass `includeAllPages: true` to auto-fetch every page.
+     */
+    async getSectorData(sector, options = {}) {
+        const { page = 1, limit = 50, includeAllPages = false } = options;
+        if (includeAllPages) {
+            return this._getAllSectorPages(sector, limit);
+        }
+        const url = `${this.config.baseUrl}/market/${sector}/?limit=${limit}&page=${page}`;
+        const html = await this.fetchHtml(url, "sector");
+        const root = parseHtml(html);
+        const { columns, rows } = parseDataTable(root);
+        const { totalPages } = parsePagination(root);
+        return {
+            data: { sector, columns, rows, page, totalPages, totalResults: rows.length },
+            meta: this.meta(url),
+            warnings: [],
+        };
+    }
+    async _getAllSectorPages(sector, limit) {
+        const first = await this.getSectorData(sector, { page: 1, limit });
+        const allRows = [...first.data.rows];
+        const warnings = [];
+        for (let p = 2; p <= first.data.totalPages; p++) {
+            try {
+                const page = await this.getSectorData(sector, { page: p, limit });
+                allRows.push(...page.data.rows);
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                warnings.push(`Failed to fetch page ${p}: ${msg}`);
+            }
+        }
+        return {
+            data: { ...first.data, rows: allRows, totalResults: allRows.length, page: 1 },
+            meta: first.meta,
+            warnings,
+        };
+    }
+}
+//# sourceMappingURL=sectors.js.map

package/lib/client/sectors.js.map

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

package/lib/client.d.ts

@@ -0,0 +1,2 @@
+export { ScreenerClient } from "./client/index.js";
+//# sourceMappingURL=client.d.ts.map

package/lib/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/client.js

@@ -0,0 +1,3 @@
+// Re-export from the structured client folder
+export { ScreenerClient } from "./client/index.js";
+//# sourceMappingURL=client.js.map

package/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export { ScreenerClient } from "./client.js";
+export type { ClientConfig, CompanyMode, CompanyTab, CompanyData, CompanyRaw, CompanySummary, TopRatio, FinancialTable, TableRow, AnalysisData, DocumentLink, PeerRow, SectorItem, SectorData, SectorDataOptions, ScreenItem, ScreenDetails, ScreenDetailsOptions, ListScreensOptions, SearchResult, ApiResponse, Meta, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,cAAc,EACd,QAAQ,EACR,cAAc,EACd,QAAQ,EACR,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,UAAU,EACV,UAAU,EACV,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,YAAY,EACZ,WAAW,EACX,IAAI,GACL,MAAM,YAAY,CAAC"}

package/lib/index.js

@@ -0,0 +1,2 @@
+export { ScreenerClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}