nse-bse-api 0.1.0

package/dist-cjs/nse/nse/nse-client.js

@@ -0,0 +1,109 @@
+"use strict";
+/**
+ * Main NSE API client that orchestrates all API modules
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NSEClient = void 0;
+const http_client_js_1 = require("../http/http-client.js");
+const equity_api_js_1 = require("../api/equity-api.js");
+const options_api_js_1 = require("../api/options-api.js");
+const historical_api_js_1 = require("../api/historical-api.js");
+const corporate_api_js_1 = require("../api/corporate-api.js");
+const ipo_api_js_1 = require("../api/ipo-api.js");
+const market_api_js_1 = require("../api/market-api.js");
+const download_api_js_1 = require("../api/download-api.js");
+const file_operations_js_1 = require("../utils/file-operations.js");
+const index_js_1 = require("../constants/index.js");
+class NSEClient {
+    static __version__ = "0.1.0";
+    // Re-export constants for backward compatibility
+    static SEGMENT_EQUITY = "equities";
+    static SEGMENT_SME = "sme";
+    static SEGMENT_MF = "mf";
+    static SEGMENT_DEBT = "debt";
+    static HOLIDAY_CLEARING = "clearing";
+    static HOLIDAY_TRADING = "trading";
+    static FNO_BANK = "banknifty";
+    static FNO_NIFTY = "nifty";
+    static FNO_FINNIFTY = "finnifty";
+    static FNO_IT = "niftyit";
+    static UDIFF_SWITCH_DATE = new Date("2024-07-08");
+    httpClient;
+    downloadDir;
+    // API modules
+    equity;
+    options;
+    historical;
+    corporate;
+    ipo;
+    market;
+    download;
+    constructor(downloadFolder, opts = {}) {
+        const server = !!opts.server;
+        const timeout = opts.timeout ?? index_js_1.DEFAULT_TIMEOUT;
+        this.downloadDir = (0, file_operations_js_1.getPath)(downloadFolder, true);
+        this.httpClient = new http_client_js_1.HttpClient(this.downloadDir, server, timeout);
+        // Initialize API modules
+        this.equity = new equity_api_js_1.EquityApi(this.httpClient);
+        this.options = new options_api_js_1.OptionsApi(this.httpClient);
+        this.historical = new historical_api_js_1.HistoricalApi(this.httpClient);
+        this.corporate = new corporate_api_js_1.CorporateApi(this.httpClient);
+        this.ipo = new ipo_api_js_1.IpoApi(this.httpClient);
+        this.market = new market_api_js_1.MarketApi(this.httpClient);
+        this.download = new download_api_js_1.DownloadApi(this.httpClient, this.downloadDir);
+    }
+    /**
+     * Clean up resources and save cookies
+     */
+    exit() {
+        this.httpClient.saveCookies();
+    }
+    // Backward compatibility methods - delegate to appropriate modules
+    async status() { return this.market.getStatus(); }
+    async lookup(query) { return this.market.lookup(query); }
+    async equityBhavcopy(date, folder) { return this.download.downloadEquityBhavcopy(date, folder); }
+    async deliveryBhavcopy(date, folder) { return this.download.downloadDeliveryBhavcopy(date, folder); }
+    async indicesBhavcopy(date, folder) { return this.download.downloadIndicesBhavcopy(date, folder); }
+    async fnoBhavcopy(date, folder) { return this.download.downloadFnoBhavcopy(date, folder); }
+    async priceband_report(date, folder) { return this.download.downloadPricebandReport(date, folder); }
+    async pr_bhavcopy(date, folder) { return this.download.downloadPrBhavcopy(date, folder); }
+    async cm_mii_security_report(date, folder) { return this.download.downloadCmMiiSecurityReport(date, folder); }
+    async download_document(url, folder, extract_files) { return this.download.downloadDocument(url, folder, extract_files); }
+    async actions(params = {}) { return this.corporate.getActions(params); }
+    async announcements(params = {}) { return this.corporate.getAnnouncements(params); }
+    async boardMeetings(params = {}) { return this.corporate.getBoardMeetings(params); }
+    async annual_reports(symbol, segment = "equities") { return this.corporate.getAnnualReports(symbol, segment); }
+    async circulars(params = {}) { return this.corporate.getCirculars(params); }
+    async equityMetaInfo(symbol) { return this.equity.getEquityMetaInfo(symbol); }
+    async quote(params) { return this.equity.getQuote(params); }
+    async equityQuote(symbol) { return this.equity.getEquityQuote(symbol); }
+    gainers(data, count) { return this.equity.getGainers(data, count); }
+    losers(data, count) { return this.equity.getLosers(data, count); }
+    async listEquityStocksByIndex(index) { return this.equity.listEquityStocksByIndex(index); }
+    async listIndices() { return this.equity.listIndices(); }
+    async listEtf() { return this.equity.listEtf(); }
+    async listSme() { return this.equity.listSme(); }
+    async listSgb() { return this.equity.listSgb(); }
+    async listCurrentIPO() { return this.ipo.listCurrentIPO(); }
+    async listUpcomingIPO() { return this.ipo.listUpcomingIPO(); }
+    async getIpoDetails(params) { return this.ipo.getIpoDetails(params); }
+    async listPastIPO(from_date, to_date) { return this.ipo.listPastIPO(from_date, to_date); }
+    async blockDeals() { return this.market.getBlockDeals(); }
+    async bulkdeals(fromdate, todate) { return this.market.getBulkDeals(fromdate, todate); }
+    async holidays(type = "trading") { return this.market.getHolidays(type); }
+    async fnoLots() { return this.options.getFnoLots(); }
+    async optionChain(symbol) { return this.options.getOptionChain(symbol); }
+    async filteredOptionChain(symbol, strikeRange) { return this.options.getFilteredOptionChain(symbol, strikeRange); }
+    static maxpain(optionChain, expiryDate) { return options_api_js_1.OptionsApi.calculateMaxPain(optionChain, expiryDate); }
+    async getFuturesExpiry(index = "nifty") { return this.options.getFuturesExpiry(index); }
+    async compileOptionChain(symbol, expiryDate) { return this.options.compileOptionChain(symbol, expiryDate); }
+    async fetch_equity_historical_data(params) { return this.historical.fetchEquityHistoricalData(params); }
+    async fetch_historical_vix_data(params = {}) { return this.historical.fetchHistoricalVixData(params); }
+    async fetch_historical_fno_data(params) { return this.historical.fetchHistoricalFnoData(params); }
+    async fetch_historical_index_data(params) { return this.historical.fetchHistoricalIndexData(params); }
+    async fetch_fno_underlying() { return this.historical.fetchFnoUnderlying(); }
+    async fetch_index_names() { return this.historical.fetchIndexNames(); }
+    async fetch_daily_reports_file_metadata(segment = "CM") { return this.market.getDailyReportsFileMetadata(segment); }
+}
+exports.NSEClient = NSEClient;
+//# sourceMappingURL=nse-client.js.map

package/dist-cjs/nse/nse/nse-client.js.map

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

package/dist-cjs/nse/types/index.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Type definitions and interfaces for NSE API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist-cjs/nse/types/index.js.map

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

package/dist-cjs/nse/utils/date-formatter.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Date formatting utilities for NSE API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatDateDMY = formatDateDMY;
+exports.formatDateDDMMYYYY = formatDateDDMMYYYY;
+exports.formatDateDDMMYY = formatDateDDMMYY;
+exports.formatDateYMD = formatDateYMD;
+exports.formatDateArchive = formatDateArchive;
+exports.formatDateExpiry = formatDateExpiry;
+exports.validateDateRange = validateDateRange;
+exports.splitDateRange = splitDateRange;
+/**
+ * Format date as DD-MM-YYYY
+ */
+function formatDateDMY(date) {
+    return `${String(date.getDate()).padStart(2, "0")}-${String(date.getMonth() + 1).padStart(2, "0")}-${date.getFullYear()}`;
+}
+/**
+ * Format date as DDMMYYYY
+ */
+function formatDateDDMMYYYY(date) {
+    return `${String(date.getDate()).padStart(2, "0")}${String(date.getMonth() + 1).padStart(2, "0")}${date.getFullYear()}`;
+}
+/**
+ * Format date as DDMMYY
+ */
+function formatDateDDMMYY(date) {
+    return `${String(date.getDate()).padStart(2, "0")}${String(date.getMonth() + 1).padStart(2, "0")}${String(date.getFullYear()).slice(-2)}`;
+}
+/**
+ * Format date as YYYYMMDD
+ */
+function formatDateYMD(date) {
+    return `${date.getFullYear()}${String(date.getMonth() + 1).padStart(2, "0")}${String(date.getDate()).padStart(2, "0")}`;
+}
+/**
+ * Format date for NSE archive URLs (DDMMMYYYY format)
+ */
+function formatDateArchive(date) {
+    return date
+        .toLocaleDateString("en-GB", {
+        day: "2-digit",
+        month: "short",
+        year: "numeric",
+    })
+        .toUpperCase()
+        .replace(/ /g, "");
+}
+/**
+ * Format date for option expiry (DD-MMM-YYYY format)
+ */
+function formatDateExpiry(date) {
+    return `${String(date.getDate()).padStart(2, "0")}-${new Intl.DateTimeFormat("en-GB", { month: "short" }).format(date)}-${date.getFullYear()}`;
+}
+/**
+ * Validate date range
+ */
+function validateDateRange(fromDate, toDate) {
+    if (fromDate > toDate) {
+        throw new Error("'from_date' cannot be greater than 'to_date'");
+    }
+}
+/**
+ * Split date range into chunks for API pagination
+ */
+function splitDateRange(from, to, maxChunkSizeDays = 365) {
+    const chunks = [];
+    let currentStart = new Date(from.getFullYear(), from.getMonth(), from.getDate());
+    const end = new Date(to.getFullYear(), to.getMonth(), to.getDate());
+    while (currentStart.getTime() <= end.getTime()) {
+        const currentEnd = new Date(currentStart.getTime() + (maxChunkSizeDays - 1) * 86400000);
+        const boundedEnd = currentEnd.getTime() > end.getTime() ? end : currentEnd;
+        chunks.push([currentStart, boundedEnd]);
+        currentStart = new Date(boundedEnd.getTime() + 86400000);
+    }
+    return chunks;
+}
+//# sourceMappingURL=date-formatter.js.map

package/dist-cjs/nse/utils/date-formatter.js.map

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

package/dist-cjs/nse/utils/file-operations.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * File operations utilities for NSE API
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPath = getPath;
+exports.unzipFile = unzipFile;
+exports.saveStreamToFile = saveStreamToFile;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const util_1 = require("util");
+const zlib_1 = __importDefault(require("zlib"));
+const stream_1 = require("stream");
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const pipeline = (0, util_1.promisify)(stream_1.pipeline);
+/**
+ * Resolve and validate file/folder path
+ */
+function getPath(p, isFolder = false) {
+    const resolved = path_1.default.resolve(p);
+    if (isFolder) {
+        try {
+            const stat = fs_1.default.existsSync(resolved) ? fs_1.default.statSync(resolved) : undefined;
+            if (stat && stat.isFile()) {
+                throw new Error(`${resolved}: must be a folder`);
+            }
+            if (!stat) {
+                fs_1.default.mkdirSync(resolved, { recursive: true });
+            }
+        }
+        catch (e) {
+            throw e;
+        }
+    }
+    return resolved;
+}
+/**
+ * Extract zip or gzip files
+ */
+async function unzipFile(filePath, folder, extractFiles) {
+    const ext = path_1.default.extname(filePath).toLowerCase();
+    if (ext === ".zip") {
+        const zip = new adm_zip_1.default(filePath);
+        if (extractFiles && extractFiles.length > 0) {
+            zip.extractEntryTo(extractFiles[extractFiles.length - 1], folder, false, true);
+            const out = path_1.default.join(folder, extractFiles[extractFiles.length - 1]);
+            fs_1.default.rmSync(filePath, { force: true });
+            return out;
+        }
+        else {
+            const entries = zip.getEntries();
+            if (!entries.length) {
+                throw new Error("Zip is empty");
+            }
+            const first = entries[0].entryName;
+            zip.extractAllTo(folder, true);
+            const out = path_1.default.join(folder, first);
+            fs_1.default.rmSync(filePath, { force: true });
+            return out;
+        }
+    }
+    else if (ext === ".gz") {
+        const dest = path_1.default.join(path_1.default.dirname(filePath), path_1.default.basename(filePath, ".gz"));
+        const gzip = zlib_1.default.createGunzip();
+        await pipeline(fs_1.default.createReadStream(filePath), gzip, fs_1.default.createWriteStream(dest));
+        fs_1.default.rmSync(filePath, { force: true });
+        return dest;
+    }
+    else {
+        throw new Error("Unknown file format");
+    }
+}
+/**
+ * Save file from stream
+ */
+async function saveStreamToFile(stream, filePath) {
+    await pipeline(stream, fs_1.default.createWriteStream(filePath));
+}
+//# sourceMappingURL=file-operations.js.map

package/dist-cjs/nse/utils/file-operations.js.map

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

package/dist-cjs/nse/utils/index.js

@@ -0,0 +1,22 @@
+"use strict";
+/**
+ * Utility functions for NSE API
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./date-formatter.js"), exports);
+__exportStar(require("./file-operations.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist-cjs/nse/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/nse/utils/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;;;;;;;;;;;;;;AAEH,sDAAoC;AACpC,uDAAqC"}

package/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist-cjs/types/index.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Combined Types Module
+ *
+ * Re-exports types from both NSE and BSE modules with proper namespacing
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BSETypes = exports.NSETypes = void 0;
+// NSE Types (with namespace to avoid conflicts)
+const NSETypes = __importStar(require("../nse/types/index.js"));
+exports.NSETypes = NSETypes;
+const BSETypes = __importStar(require("../bse/types/index.js"));
+exports.BSETypes = BSETypes;
+//# sourceMappingURL=index.js.map

package/dist-cjs/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAEH,gDAAgD;AAChD,gEAAkD;AAIzC,4BAAQ;AAHjB,gEAAkD;AAG/B,4BAAQ"}

package/package.json

@@ -0,0 +1,99 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "nse-bse-api",
+  "version": "0.1.0",
+  "description": "Unified TypeScript API for NSE and BSE India stock exchanges",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/bshada/nse-bse-api.git"
+  },
+  "bugs": {
+    "url": "https://github.com/bshada/nse-bse-api/issues"
+  },
+  "homepage": "https://github.com/bshada/nse-bse-api#readme",
+  "author": "bshada",
+  "type": "module",
+  "browser": false,
+  "main": "dist-cjs/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist-cjs/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./nse": {
+      "import": "./dist/nse/index.js",
+      "require": "./dist-cjs/nse/index.js",
+      "types": "./dist/nse/index.d.ts"
+    },
+    "./bse": {
+      "import": "./dist/bse/index.js",
+      "require": "./dist-cjs/bse/index.js",
+      "types": "./dist/bse/index.d.ts"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && tsc -p tsconfig.cjs.json && node scripts/postbuild-cjs.js",
+    "clean": "rimraf dist dist-cjs",
+    "lint": "eslint 'src/**/*.ts'",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:network": "vitest run",
+    "test:nse": "vitest run tests/nse",
+    "test:bse": "vitest run tests/bse",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "dist-cjs",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "nse",
+    "bse",
+    "nseindia",
+    "bseindia",
+    "stocks",
+    "api",
+    "typescript",
+    "india",
+    "stock-exchange",
+    "stock-market-api"
+  ],
+  "dependencies": {
+    "adm-zip": "^0.5.16",
+    "axios": "^1.7.7",
+    "axios-cookiejar-support": "^6.0.2",
+    "got": "^12.6.1",
+    "node-html-parser": "^6.1.10",
+    "tough-cookie": "^4.1.3"
+  },
+  "devDependencies": {
+    "@types/adm-zip": "^0.5.6",
+    "@types/node": "^22.7.4",
+    "@types/tough-cookie": "^4.0.5",
+    "@typescript-eslint/eslint-plugin": "^8.46.1",
+    "@typescript-eslint/parser": "^8.46.1",
+    "@vitest/coverage-v8": "^2.0.5",
+    "@vitest/ui": "^2.0.5",
+    "cross-env": "^7.0.3",
+    "eslint": "^9.11.0",
+    "prettier": "^3.1.0",
+    "rimraf": "^6.0.1",
+    "tsx": "^4.20.6",
+    "typescript": "^5.5.4",
+    "vitest": "^2.0.5"
+  }
+}