nsekit 0.1.2 → 0.3.0

package/dist/index.js

@@ -12626,10 +12626,10 @@ var require_axios = __commonJS((exports, module) => {
     }
   }
   var CanceledError$1 = CanceledError;
-  function settle(resolve, reject, response) {
+  function settle(resolve2, reject, response) {
     const validateStatus = response.config.validateStatus;
     if (!response.status || !validateStatus || validateStatus(response.status)) {
-      resolve(response);
+      resolve2(response);
     } else {
       reject(new AxiosError$1("Request failed with status code " + response.status, [AxiosError$1.ERR_BAD_REQUEST, AxiosError$1.ERR_BAD_RESPONSE][Math.floor(response.status / 100) - 4], response.config, response.request, response));
     }
@@ -13203,7 +13203,7 @@ var require_axios = __commonJS((exports, module) => {
   }
   var isHttpAdapterSupported = typeof process !== "undefined" && utils$1.kindOf(process) === "process";
   var wrapAsync = (asyncExecutor) => {
-    return new Promise((resolve, reject) => {
+    return new Promise((resolve2, reject) => {
       let onDone;
       let isDone;
       const done = (value, isRejected) => {
@@ -13214,7 +13214,7 @@ var require_axios = __commonJS((exports, module) => {
       };
       const _resolve = (value) => {
         done(value);
-        resolve(value);
+        resolve2(value);
       };
       const _reject = (reason) => {
         done(reason, true);
@@ -13266,7 +13266,7 @@ var require_axios = __commonJS((exports, module) => {
     }
   };
   var httpAdapter = isHttpAdapterSupported && function httpAdapter(config) {
-    return wrapAsync(async function dispatchHttpRequest(resolve, reject, onDone) {
+    return wrapAsync(async function dispatchHttpRequest(resolve2, reject, onDone) {
       let { data, lookup, family, httpVersion = 1, http2Options } = config;
       const { responseType, responseEncoding } = config;
       const method = config.method.toUpperCase();
@@ -13347,7 +13347,7 @@ var require_axios = __commonJS((exports, module) => {
         }
         let convertedData;
         if (method !== "GET") {
-          return settle(resolve, reject, {
+          return settle(resolve2, reject, {
             status: 405,
             statusText: "method not allowed",
             headers: {},
@@ -13369,7 +13369,7 @@ var require_axios = __commonJS((exports, module) => {
         } else if (responseType === "stream") {
           convertedData = stream__default["default"].Readable.from(convertedData);
         }
-        return settle(resolve, reject, {
+        return settle(resolve2, reject, {
           data: convertedData,
           status: 200,
           statusText: "OK",
@@ -13556,7 +13556,7 @@ var require_axios = __commonJS((exports, module) => {
         };
         if (responseType === "stream") {
           response.data = responseStream;
-          settle(resolve, reject, response);
+          settle(resolve2, reject, response);
         } else {
           const responseBuffer = [];
           let totalResponseBytes = 0;
@@ -13595,7 +13595,7 @@ var require_axios = __commonJS((exports, module) => {
             } catch (err) {
               return reject(AxiosError$1.from(err, null, config, response.request, response));
             }
-            settle(resolve, reject, response);
+            settle(resolve2, reject, response);
           });
         }
         abortEmitter.once("abort", (err) => {
@@ -13815,7 +13815,7 @@ var require_axios = __commonJS((exports, module) => {
   };
   var isXHRAdapterSupported = typeof XMLHttpRequest !== "undefined";
   var xhrAdapter = isXHRAdapterSupported && function(config) {
-    return new Promise(function dispatchXhrRequest(resolve, reject) {
+    return new Promise(function dispatchXhrRequest(resolve2, reject) {
       const _config = resolveConfig(config);
       let requestData = _config.data;
       const requestHeaders = AxiosHeaders$1.from(_config.headers).normalize();
@@ -13847,7 +13847,7 @@ var require_axios = __commonJS((exports, module) => {
           request
         };
         settle(function _resolve(value) {
-          resolve(value);
+          resolve2(value);
           done();
         }, function _reject(err) {
           reject(err);
@@ -14198,8 +14198,8 @@ var require_axios = __commonJS((exports, module) => {
         responseType = responseType || "text";
         let responseData = await resolvers[utils$1.findKey(resolvers, responseType) || "text"](response, config);
         !isStreamResponse && unsubscribe && unsubscribe();
-        return await new Promise((resolve, reject) => {
-          settle(resolve, reject, {
+        return await new Promise((resolve2, reject) => {
+          settle(resolve2, reject, {
             data: responseData,
             headers: AxiosHeaders$1.from(response.headers),
             status: response.status,
@@ -14547,8 +14547,8 @@ var require_axios = __commonJS((exports, module) => {
         throw new TypeError("executor must be a function.");
       }
       let resolvePromise;
-      this.promise = new Promise(function promiseExecutor(resolve) {
-        resolvePromise = resolve;
+      this.promise = new Promise(function promiseExecutor(resolve2) {
+        resolvePromise = resolve2;
       });
       const token = this;
       this.promise.then((cancel) => {
@@ -14562,9 +14562,9 @@ var require_axios = __commonJS((exports, module) => {
       });
       this.promise.then = (onfulfilled) => {
         let _resolve;
-        const promise = new Promise((resolve) => {
-          token.subscribe(resolve);
-          _resolve = resolve;
+        const promise = new Promise((resolve2) => {
+          token.subscribe(resolve2);
+          _resolve = resolve2;
         }).then(onfulfilled);
         promise.cancel = function reject() {
           token.unsubscribe(_resolve);
@@ -18454,7 +18454,7 @@ var require_connect2 = __commonJS((exports) => {
       return `${this.default_login_uri}?api_key=${this.api_key}&v=3`;
     }
     generateSession(request_token, api_secret) {
-      return new Promise((resolve, reject) => {
+      return new Promise((resolve2, reject) => {
         const checksum = (0, sha256_1.default)(this.api_key + request_token + api_secret).toString();
         const p = this._post("api.token", {
           api_key: this.api_key,
@@ -18465,7 +18465,7 @@ var require_connect2 = __commonJS((exports) => {
           if (resp && resp.access_token) {
             this.setAccessToken(resp.access_token);
           }
-          return resolve(resp);
+          return resolve2(resp);
         }).catch(function(err) {
           return reject(err);
         });
@@ -18478,7 +18478,7 @@ var require_connect2 = __commonJS((exports) => {
       });
     }
     renewAccessToken(refresh_token, api_secret) {
-      return new Promise((resolve, reject) => {
+      return new Promise((resolve2, reject) => {
         const checksum = (0, sha256_1.default)(this.api_key + refresh_token + api_secret).toString();
         const p = this._post("api.token.renew", {
           api_key: this.api_key,
@@ -18489,7 +18489,7 @@ var require_connect2 = __commonJS((exports) => {
           if (resp && resp.access_token) {
             this.setAccessToken(resp.access_token);
           }
-          return resolve(resp);
+          return resolve2(resp);
         }).catch(function(err) {
           return reject(err);
         });
@@ -19297,44 +19297,63 @@ class InstrumentNotFoundError extends BrokerError {
   }
 }
 // src/instruments/instrument-master.ts
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "fs";
+import { join, resolve } from "path";
+var DEFAULT_INSTRUMENT_PATH = "./InstrumentDump";
+
 class InstrumentMaster {
   instruments = new Map;
   tokenIndex = new Map;
   syncMeta = new Map;
   redis;
+  instrumentFilePath;
   constructor(options) {
     this.redis = options?.redis ?? null;
+    this.instrumentFilePath = resolve(options?.instrumentFilePath ?? DEFAULT_INSTRUMENT_PATH);
   }
   async syncBroker(brokerId, brokerInstruments, force = false) {
     try {
-      const existingMeta = this.syncMeta.get(brokerId);
-      if (!force && existingMeta && brokerInstruments.checkDumpChanged) {
-        const changed = await brokerInstruments.checkDumpChanged({
-          etag: existingMeta.etag,
-          lastModified: existingMeta.lastModified
-        });
-        if (!changed) {
-          return Ok(existingMeta);
+      if (!force) {
+        const diskEntries = this.loadFromDisk(brokerId);
+        if (diskEntries) {
+          this.clearBrokerEntries(brokerId);
+          for (const entry of diskEntries) {
+            this.mergeEntry(brokerId, entry);
+          }
+          const meta2 = {
+            brokerId,
+            lastSyncAt: Date.now(),
+            instrumentCount: diskEntries.length,
+            source: "disk"
+          };
+          this.syncMeta.set(brokerId, meta2);
+          if (this.redis) {
+            this.cacheInstrumentsToRedis();
+          }
+          return Ok(meta2);
         }
       }
       this.clearBrokerEntries(brokerId);
-      let count = 0;
+      const entries = [];
       if (brokerInstruments.capabilities.bulkDump && brokerInstruments.streamDump) {
         for await (const raw of brokerInstruments.streamDump()) {
           const entry = brokerInstruments.normalize(raw);
+          entries.push(entry);
           this.mergeEntry(brokerId, entry);
-          count++;
         }
       }
+      if (this.redis) {
+        this.cacheInstrumentsToRedis();
+      } else {
+        this.saveToDisk(brokerId, entries);
+      }
       const meta = {
         brokerId,
         lastSyncAt: Date.now(),
-        instrumentCount: count
+        instrumentCount: entries.length,
+        source: "network"
       };
       this.syncMeta.set(brokerId, meta);
-      if (this.redis) {
-        this.cacheInstrumentsToRedis();
-      }
       return Ok(meta);
     } catch (err) {
       return Err(err instanceof Error ? err : new Error(String(err)));
@@ -19348,9 +19367,8 @@ class InstrumentMaster {
     this.syncMeta.set(brokerId, {
       brokerId,
       lastSyncAt: Date.now(),
-      etag: existing?.etag,
-      lastModified: existing?.lastModified,
-      instrumentCount: (existing?.instrumentCount ?? 0) + entries.length
+      instrumentCount: (existing?.instrumentCount ?? 0) + entries.length,
+      source: "network"
     });
   }
   search(query, exchange, instrumentType, limit = 50) {
@@ -19396,6 +19414,52 @@ class InstrumentMaster {
       return;
     return this.instruments.get(entry.key);
   }
+  resolve(input) {
+    const { exchange, symbol } = this.parseInput(input);
+    if (exchange) {
+      const key = this.makeKey(exchange, symbol);
+      const inst = this.instruments.get(key);
+      if (inst)
+        return Ok(inst);
+      return Err(new Error(`Symbol "${symbol}" not found on ${exchange}`));
+    }
+    const matches = [];
+    for (const inst of this.instruments.values()) {
+      if (inst.tradingSymbol === symbol)
+        matches.push(inst);
+    }
+    if (matches.length === 0) {
+      return Err(new Error(`Symbol "${symbol}" not found`));
+    }
+    if (matches.length === 1) {
+      return Ok(matches[0]);
+    }
+    if (matches.length === 2) {
+      const exchanges = new Set(matches.map((m) => m.exchange));
+      if (exchanges.has("NSE") && exchanges.has("BSE")) {
+        return Ok(matches.find((m) => m.exchange === "NSE"));
+      }
+    }
+    const list = matches.slice(0, 5).map((m) => `${m.exchange}:${m.tradingSymbol}`).join(", ");
+    return Err(new Error(`Multiple matches found. Specify exchange: ${list}`));
+  }
+  async resolveAsync(input, brokerId, brokerInstruments) {
+    const local = this.resolve(input);
+    if (local.ok)
+      return local;
+    if (brokerInstruments.capabilities.searchAPI && brokerInstruments.searchAPI) {
+      const { symbol } = this.parseInput(input);
+      const apiResult = await brokerInstruments.searchAPI(symbol);
+      if (apiResult.ok && apiResult.value.length > 0) {
+        for (const entry of apiResult.value)
+          this.mergeEntry(brokerId, entry);
+        if (this.redis)
+          this.cacheInstrumentsToRedis();
+        return this.resolve(input);
+      }
+    }
+    return Err(new Error(`Symbol "${input}" not found`));
+  }
   async getOptionChainCached(underlying, expiry) {
     const expiryDate = expiry.toISOString().slice(0, 10);
     const cacheKey = `optchain:${underlying.toUpperCase()}:${expiryDate}`;
@@ -19442,6 +19506,9 @@ class InstrumentMaster {
   get size() {
     return this.instruments.size;
   }
+  get filePath() {
+    return this.instrumentFilePath;
+  }
   getSyncMeta(brokerId) {
     return this.syncMeta.get(brokerId);
   }
@@ -19465,8 +19532,39 @@ class InstrumentMaster {
     this.tokenIndex.clear();
     this.syncMeta.clear();
   }
+  getDiskCachePath(brokerId) {
+    return join(this.instrumentFilePath, `${brokerId}-instruments.json`);
+  }
+  ensureDirectory() {
+    if (!existsSync(this.instrumentFilePath)) {
+      mkdirSync(this.instrumentFilePath, { recursive: true });
+    }
+  }
+  loadFromDisk(brokerId) {
+    const filePath = this.getDiskCachePath(brokerId);
+    try {
+      if (!existsSync(filePath))
+        return null;
+      const raw = readFileSync(filePath, "utf-8");
+      const parsed = JSON.parse(raw);
+      if (!Array.isArray(parsed))
+        return null;
+      return parsed;
+    } catch {
+      return null;
+    }
+  }
+  saveToDisk(brokerId, entries) {
+    try {
+      this.ensureDirectory();
+      const filePath = this.getDiskCachePath(brokerId);
+      const stripped = entries.map(({ raw, ...rest }) => rest);
+      writeFileSync(filePath, JSON.stringify(stripped), "utf-8");
+    } catch {}
+  }
   mergeEntry(brokerId, entry) {
-    const key = this.makeKey(entry.exchange, entry.tradingSymbol);
+    const canonical = this.buildCanonicalSymbol(entry.underlying, entry.instrumentType, entry.strike, entry.expiry);
+    const key = this.makeKey(entry.exchange, canonical);
     let instrument = this.instruments.get(key);
     if (!instrument) {
       instrument = {
@@ -19477,7 +19575,7 @@ class InstrumentMaster {
         strike: entry.strike,
         lotSize: entry.lotSize,
         tickSize: entry.tickSize,
-        tradingSymbol: entry.tradingSymbol,
+        tradingSymbol: canonical,
         brokerTokens: {}
       };
       this.instruments.set(key, instrument);
@@ -19571,6 +19669,35 @@ class InstrumentMaster {
     }
     return true;
   }
+  formatExpiry(date) {
+    const d = date instanceof Date ? date : new Date(date);
+    const dd = String(d.getDate()).padStart(2, "0");
+    const mmm = ["JAN", "FEB", "MAR", "APR", "MAY", "JUN", "JUL", "AUG", "SEP", "OCT", "NOV", "DEC"][d.getMonth()];
+    const yy = String(d.getFullYear()).slice(-2);
+    return `${dd}${mmm}${yy}`;
+  }
+  buildCanonicalSymbol(underlying, instrumentType, strike, expiry) {
+    const name = underlying.toUpperCase();
+    if (instrumentType === "EQ")
+      return name;
+    const exp = expiry ? this.formatExpiry(expiry) : "";
+    if (instrumentType === "FUT")
+      return `${name}-FUT-${exp}`;
+    const s = strike != null ? String(strike) : "0";
+    return `${name}-${s}-${instrumentType}-${exp}`;
+  }
+  parseInput(input) {
+    const upper = input.trim().toUpperCase();
+    const VALID = new Set(["NSE", "BSE", "NFO", "BFO", "MCX", "CDS"]);
+    const idx = upper.indexOf(":");
+    if (idx >= 2 && idx <= 3) {
+      const prefix = upper.slice(0, idx);
+      if (VALID.has(prefix)) {
+        return { exchange: prefix, symbol: upper.slice(idx + 1) };
+      }
+    }
+    return { symbol: upper };
+  }
   makeKey(exchange, tradingSymbol) {
     return `${exchange}:${tradingSymbol}`;
   }
@@ -20455,33 +20582,6 @@ class ZerodhaInstruments {
       yield row;
     }
   }
-  async checkDumpChanged(lastSync) {
-    const response = await fetch(KITE_INSTRUMENTS_URL, { method: "HEAD" });
-    if (!response.ok)
-      return true;
-    const etag = response.headers.get("etag");
-    const lastModified = response.headers.get("last-modified");
-    if (etag && lastSync.etag)
-      return etag !== lastSync.etag;
-    if (lastModified && lastSync.lastModified)
-      return lastModified !== lastSync.lastModified;
-    return true;
-  }
-  async resolve(symbol, exchange) {
-    try {
-      for await (const raw of this.streamDump()) {
-        const fields = raw;
-        const rowSymbol = fields["tradingsymbol"] ?? "";
-        const rowExchange = fields["exchange"] ?? "";
-        if (rowSymbol === symbol && rowExchange === exchange) {
-          return Ok(this.normalize(raw));
-        }
-      }
-      return Err(new Error(`Instrument ${symbol} not found on ${exchange} (Zerodha)`));
-    } catch (err) {
-      return Err(err instanceof Error ? err : new Error(String(err)));
-    }
-  }
   normalize(raw) {
     const fields = raw;
     const tradingSymbol = fields["tradingsymbol"] ?? fields[COL.TRADINGSYMBOL] ?? "";
@@ -20515,13 +20615,23 @@ class ZerodhaBroker {
   id = "zerodha";
   name = "Zerodha";
   instruments;
+  has = {
+    bulkDump: true,
+    searchAPI: false,
+    optionChain: false,
+    historicalCandles: true,
+    websocket: true,
+    pnlReport: false
+  };
   session = null;
   kite = null;
   socket = null;
   apiKey = "";
   KiteConnect = null;
-  constructor() {
+  _iMaster;
+  constructor(options) {
     this.instruments = new ZerodhaInstruments;
+    this._iMaster = new InstrumentMaster(options);
   }
   async authenticate(creds) {
     this.apiKey = creds.apiKey;
@@ -20544,10 +20654,34 @@ class ZerodhaBroker {
       return null;
     return new Date(this.session.expiresAt);
   }
+  async sync(force) {
+    return this._iMaster.syncBroker(this.id, this.instruments, force);
+  }
+  resolve(input) {
+    return this._iMaster.resolve(input);
+  }
+  search(query, exchange, instrumentType, limit) {
+    return this._iMaster.search(query, exchange, instrumentType, limit);
+  }
   async placeOrder(params) {
     try {
+      let resolvedParams = params;
+      if (!params.exchange) {
+        const resolved = this._iMaster.resolve(params.tradingSymbol);
+        if (!resolved.ok) {
+          const asyncResolved = await this._iMaster.resolveAsync(params.tradingSymbol, this.id, this.instruments);
+          if (!asyncResolved.ok) {
+            return Err(new Error(`Cannot resolve "${params.tradingSymbol}". Either run broker.sync() first to use unified nsekit symbols, or provide exchange and the broker-native tradingSymbol directly.`));
+          }
+          const nativeSymbol = asyncResolved.value.brokerTokens.zerodha?.tradingsymbol ?? params.tradingSymbol;
+          resolvedParams = { ...params, exchange: asyncResolved.value.exchange, tradingSymbol: nativeSymbol };
+        } else {
+          const nativeSymbol = resolved.value.brokerTokens.zerodha?.tradingsymbol ?? params.tradingSymbol;
+          resolvedParams = { ...params, exchange: resolved.value.exchange, tradingSymbol: nativeSymbol };
+        }
+      }
       const kite = await this.ensureKite();
-      const kiteParams = toOrderParams(params);
+      const kiteParams = toOrderParams(resolvedParams);
       const res = await kite.placeOrder("regular", kiteParams);
       return Ok({
         orderId: res.order_id,
@@ -21466,25 +21600,7 @@ class FinvasiaInstruments {
       }
     }
   }
-  async checkDumpChanged(lastSync) {
-    const firstFile = Object.values(SHOONYA_INSTRUMENT_FILES)[0];
-    const url = `${SHOONYA_INSTRUMENTS_BASE}${firstFile}`;
-    try {
-      const response = await fetch(url, { method: "HEAD" });
-      if (!response.ok)
-        return true;
-      const etag = response.headers.get("etag");
-      const lastModified = response.headers.get("last-modified");
-      if (etag && lastSync.etag)
-        return etag !== lastSync.etag;
-      if (lastModified && lastSync.lastModified)
-        return lastModified !== lastSync.lastModified;
-      return true;
-    } catch {
-      return true;
-    }
-  }
-  async search(query, exchange) {
+  async searchAPI(query, exchange) {
     if (!this.accessToken) {
       return Err(new Error("Finvasia search requires authentication. Call setCredentials() first."));
     }
@@ -21524,16 +21640,6 @@ class FinvasiaInstruments {
       return Err(err instanceof Error ? err : new Error(String(err)));
     }
   }
-  async resolve(symbol, exchange) {
-    const result = await this.search(symbol, exchange);
-    if (!result.ok)
-      return result;
-    const match = result.value.find((e) => e.tradingSymbol === symbol && e.exchange === exchange);
-    if (!match) {
-      return Err(new Error(`Instrument ${symbol} not found on ${exchange} (Finvasia)`));
-    }
-    return Ok(match);
-  }
   normalize(raw) {
     const fields = raw;
     const exchangeRaw = fields["exchange"] ?? fields["exch"] ?? fields["_exchange"] ?? "NSE";
@@ -21569,12 +21675,22 @@ class FinvasiaBroker {
   id = "finvasia";
   name = "Finvasia (Shoonya)";
   instruments;
+  has = {
+    bulkDump: true,
+    searchAPI: true,
+    optionChain: true,
+    historicalCandles: true,
+    websocket: true,
+    pnlReport: false
+  };
   session = null;
   socket = null;
   instrumentsImpl;
-  constructor() {
+  _iMaster;
+  constructor(options) {
     this.instrumentsImpl = new FinvasiaInstruments;
     this.instruments = this.instrumentsImpl;
+    this._iMaster = new InstrumentMaster(options);
   }
   async authenticate(creds) {
     const result = await authenticate2(creds);
@@ -21595,10 +21711,34 @@ class FinvasiaBroker {
       return null;
     return new Date(this.session.expiresAt);
   }
+  async sync(force) {
+    return this._iMaster.syncBroker(this.id, this.instruments, force);
+  }
+  resolve(input) {
+    return this._iMaster.resolve(input);
+  }
+  search(query, exchange, instrumentType, limit) {
+    return this._iMaster.search(query, exchange, instrumentType, limit);
+  }
   async placeOrder(params) {
     try {
+      let resolvedParams = params;
+      if (!params.exchange) {
+        const resolved = this._iMaster.resolve(params.tradingSymbol);
+        if (!resolved.ok) {
+          const asyncResolved = await this._iMaster.resolveAsync(params.tradingSymbol, this.id, this.instruments);
+          if (!asyncResolved.ok) {
+            return Err(new Error(`Cannot resolve "${params.tradingSymbol}". Either run broker.sync() first to use unified nsekit symbols, or provide exchange and the broker-native tradingSymbol directly.`));
+          }
+          const nativeSymbol = asyncResolved.value.brokerTokens.finvasia?.tsym ?? params.tradingSymbol;
+          resolvedParams = { ...params, exchange: asyncResolved.value.exchange, tradingSymbol: nativeSymbol };
+        } else {
+          const nativeSymbol = resolved.value.brokerTokens.finvasia?.tsym ?? params.tradingSymbol;
+          resolvedParams = { ...params, exchange: resolved.value.exchange, tradingSymbol: nativeSymbol };
+        }
+      }
       const uid = this.session?.userId ?? "";
-      const shoonyaParams = toOrderParams2(params, uid, uid);
+      const shoonyaParams = toOrderParams2(resolvedParams, uid, uid);
       const res = await this.post("PlaceOrder", shoonyaParams);
       if (res.stat !== "Ok" || !res.norenordno) {
         return Err(new Error(`Order placement failed: ${res.emsg ?? "Unknown error"}`));
@@ -22585,23 +22725,7 @@ class DhanInstruments {
       yield row;
     }
   }
-  async checkDumpChanged(lastSync) {
-    try {
-      const response = await fetch(DHAN_INSTRUMENTS_URL, { method: "HEAD" });
-      if (!response.ok)
-        return true;
-      const etag = response.headers.get("etag");
-      const lastModified = response.headers.get("last-modified");
-      if (etag && lastSync.etag)
-        return etag !== lastSync.etag;
-      if (lastModified && lastSync.lastModified)
-        return lastModified !== lastSync.lastModified;
-      return true;
-    } catch {
-      return true;
-    }
-  }
-  async search(query, exchange) {
+  async searchAPI(query, exchange) {
     if (!this.accessToken) {
       return Err(new Error("Dhan search requires authentication. Call setCredentials() first."));
     }
@@ -22644,16 +22768,6 @@ class DhanInstruments {
       return Err(err instanceof Error ? err : new Error(String(err)));
     }
   }
-  async resolve(symbol, exchange) {
-    const result = await this.search(symbol, exchange);
-    if (!result.ok)
-      return result;
-    const match = result.value.find((e) => e.tradingSymbol === symbol && e.exchange === exchange);
-    if (!match) {
-      return Err(new Error(`Instrument ${symbol} not found on ${exchange} (Dhan)`));
-    }
-    return Ok(match);
-  }
   normalize(raw) {
     const fields = raw;
     const securityId = fields["SEM_SMST_SECURITY_ID"] ?? fields["securityId"] ?? "";
@@ -22712,13 +22826,23 @@ class DhanBroker {
   id = "dhan";
   name = "Dhan";
   instruments;
+  has = {
+    bulkDump: true,
+    searchAPI: true,
+    optionChain: true,
+    historicalCandles: true,
+    websocket: true,
+    pnlReport: false
+  };
   session = null;
   socket = null;
   clientId = "";
   instrumentsImpl;
-  constructor() {
+  _iMaster;
+  constructor(options) {
     this.instrumentsImpl = new DhanInstruments;
     this.instruments = this.instrumentsImpl;
+    this._iMaster = new InstrumentMaster(options);
   }
   async authenticate(creds) {
     this.clientId = creds.userId ?? "";
@@ -22740,9 +22864,31 @@ class DhanBroker {
       return null;
     return new Date(this.session.expiresAt);
   }
+  async sync(force) {
+    return this._iMaster.syncBroker(this.id, this.instruments, force);
+  }
+  resolve(input) {
+    return this._iMaster.resolve(input);
+  }
+  search(query, exchange, instrumentType, limit) {
+    return this._iMaster.search(query, exchange, instrumentType, limit);
+  }
   async placeOrder(params) {
     try {
-      const dhanParams = toOrderParams3(params, this.clientId);
+      let resolvedParams = params;
+      if (!params.exchange) {
+        const resolved = this._iMaster.resolve(params.tradingSymbol);
+        if (!resolved.ok) {
+          const asyncResolved = await this._iMaster.resolveAsync(params.tradingSymbol, this.id, this.instruments);
+          if (!asyncResolved.ok) {
+            return Err(new Error(`Cannot resolve "${params.tradingSymbol}". Either run broker.sync() first to use unified nsekit symbols, or provide exchange and the broker-native tradingSymbol directly.`));
+          }
+          resolvedParams = { ...params, exchange: asyncResolved.value.exchange };
+        } else {
+          resolvedParams = { ...params, exchange: resolved.value.exchange };
+        }
+      }
+      const dhanParams = toOrderParams3(resolvedParams, this.clientId);
       const res = await this.request("POST", "/orders", dhanParams);
       return Ok({
         orderId: res.orderId,
@@ -23396,6 +23542,14 @@ class PaperBroker {
   id = "paper";
   name = "Paper Trading";
   instruments;
+  has = {
+    bulkDump: false,
+    searchAPI: false,
+    optionChain: false,
+    historicalCandles: false,
+    websocket: false,
+    pnlReport: true
+  };
   session = null;
   engine;
   positions = new Map;
@@ -23406,6 +23560,7 @@ class PaperBroker {
   initialBalance;
   subscriptions = new Map;
   connectionState = "DISCONNECTED";
+  _iMaster;
   dataSource = null;
   dataSourceSub = null;
   subIdCounter = 0;
@@ -23414,6 +23569,10 @@ class PaperBroker {
     this.initialBalance = config?.initialBalance ?? 1e7;
     this.balance = this.initialBalance;
     this.engine = new PaperFillEngine(config?.fillConfig);
+    this._iMaster = new InstrumentMaster({
+      redis: config?.redis,
+      instrumentFilePath: config?.instrumentFilePath
+    });
     this.engine.setFillCallback((orderId, update) => {
       this.onOrderFill(orderId, update);
     });
@@ -23421,6 +23580,20 @@ class PaperBroker {
   setDataSource(broker) {
     this.dataSource = broker;
   }
+  async sync(_force) {
+    return Ok({
+      brokerId: "paper",
+      lastSyncAt: Date.now(),
+      instrumentCount: 0,
+      source: "network"
+    });
+  }
+  resolve(input) {
+    return this._iMaster.resolve(input);
+  }
+  search(query, exchange, instrumentType, limit) {
+    return this._iMaster.search(query, exchange, instrumentType, limit);
+  }
   async authenticate(_creds) {
     this.session = {
       accessToken: "paper-session",
@@ -23688,7 +23861,8 @@ class PaperBroker {
     for (const sub of this.subscriptions.values()) {}
   }
   updatePositionOnFill(order, update) {
-    const { tradingSymbol, exchange, side, product } = order.params;
+    const { tradingSymbol, side, product } = order.params;
+    const exchange = order.params.exchange ?? "NSE";
     const posKey = `${exchange}:${tradingSymbol}:${product}`;
     if (!this.positions.has(posKey)) {
       this.positions.set(posKey, {
@@ -23745,7 +23919,7 @@ class PaperBroker {
       brokerOrderId: pending.orderId,
       broker: "paper",
       tradingSymbol: pending.params.tradingSymbol,
-      exchange: pending.params.exchange,
+      exchange: pending.params.exchange ?? "NSE",
       side: pending.params.side,
       type: pending.params.type,
       product: pending.params.product,
@@ -23764,17 +23938,17 @@ class PaperBroker {
   }
 }
 // src/index.ts
-var VERSION = "0.1.2";
-function createBroker(brokerId) {
+var VERSION = "0.3.0";
+function createBroker(brokerId, options) {
   switch (brokerId) {
     case "zerodha":
-      return new ZerodhaBroker;
+      return new ZerodhaBroker(options);
     case "finvasia":
-      return new FinvasiaBroker;
+      return new FinvasiaBroker(options);
     case "dhan":
-      return new DhanBroker;
+      return new DhanBroker(options);
     case "paper":
-      return new PaperBroker;
+      return new PaperBroker(options);
     default: {
       const exhaustive = brokerId;
       throw new Error(`Unknown broker: ${exhaustive}`);