@nepse-toolkit/core

Core models, provider clients, and utilities that power the NEPSE toolkit.

Part of the nepse-toolkit monorepo.

Overview

• Domain models for market, stock, history, floorsheet, fundamentals, actions, and IPOs
• Provider implementations: NEPSE, MeroLagani, ShareSansar
• Provider failover manager with health tracking and auto-heal
• Payload-schema telemetry capture helpers
• Shared HTTP utilities and Nepali date utilities

Install

npm install @nepse-toolkit/core

Quick Start

import {
  NepseProvider,
  MeroLaganiProvider,
  ShareSansarProvider,
  ProviderManager,
  NEPSE_TOOLKIT_VERSION,
} from "@nepse-toolkit/core";

const nepse = new NepseProvider();
const quote = await nepse.getStockQuote("NABIL");

const providers = new ProviderManager({
  providers: [
    new NepseProvider(),
    new MeroLaganiProvider(),
    new ShareSansarProvider(),
  ],
});

const stocks = await providers.execute((p) => p.getStockList());
console.log(NEPSE_TOOLKIT_VERSION, quote.symbol, stocks.length);

Provider Notes

• NepseProvider: primary official API client with token auth and fallback endpoint logic
• MeroLaganiProvider: supplemental live/historical/fundamental/sentiment coverage
• ShareSansarProvider: CSRF/session-backed data extraction and fallback feeds
• ProviderManager: capability-aware execution with failover

Development

bun --filter @nepse-toolkit/core run build
bun --filter @nepse-toolkit/core run typecheck
bun test packages/core/tests/

License

MIT