nsekit 0.2.0 → 0.3.1

package/dist/index.js

@@ -19443,6 +19443,23 @@ class InstrumentMaster {
     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}`;
@@ -20565,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] ?? "";
@@ -20625,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;
@@ -20654,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,
@@ -20988,7 +21012,7 @@ var VALIDITY_FROM_SHOONYA = {
   IOC: "IOC"
 };
 var SHOONYA_API_BASE = "https://api.shoonya.com/NorenWClientTP";
-var SHOONYA_WS_URL = "wss://api.shoonya.com/NorenWSTP";
+var SHOONYA_WS_URL = "wss://api.shoonya.com/NorenWSTP/";
 var SHOONYA_INSTRUMENTS_BASE = "https://api.shoonya.com/";
 var SHOONYA_INSTRUMENT_FILES = {
   NSE: "NSE_symbols.txt.zip",
@@ -21288,6 +21312,7 @@ function fromQuote2(quote) {
 }
 
 // src/brokers/finvasia/finvasia-socket.ts
+import WS from "ws";
 var subIdCounter3 = 0;
 function nextSubId3() {
   subIdCounter3 += 1;
@@ -21314,12 +21339,13 @@ class FinvasiaSocket {
       return;
     this.state = "CONNECTING";
     try {
-      this.ws = new WebSocket(SHOONYA_WS_URL);
+      this.ws = new WS(SHOONYA_WS_URL);
     } catch {
       this.state = "DISCONNECTED";
       return;
     }
-    this.ws.onopen = () => {
+    this.ws.on("open", () => {
+      console.log(`[FinvasiaSocket] WS open, sending auth for uid=${this.userId}`);
       const authMsg = JSON.stringify({
         t: "c",
         uid: this.userId,
@@ -21328,18 +21354,23 @@ class FinvasiaSocket {
         source: "API"
       });
       this.ws.send(authMsg);
-    };
-    this.ws.onmessage = (event) => {
+    });
+    this.ws.on("message", (raw) => {
       try {
-        const data = JSON.parse(String(event.data));
+        const text = raw.toString();
+        console.log(`[FinvasiaSocket] WS msg: ${text.slice(0, 200)}`);
+        const data = JSON.parse(text);
         this.handleMessage(data);
       } catch {}
-    };
-    this.ws.onclose = () => {
+    });
+    this.ws.on("close", (code, reason) => {
+      console.error(`[FinvasiaSocket] WS closed: code=${code}, reason=${reason.toString()}`);
       this.state = "DISCONNECTED";
       this.attemptReconnect();
-    };
-    this.ws.onerror = () => {};
+    });
+    this.ws.on("error", (err) => {
+      console.error(`[FinvasiaSocket] WS error:`, err.message);
+    });
   }
   disconnect() {
     this.clearReconnectTimer();
@@ -21410,9 +21441,12 @@ class FinvasiaSocket {
     }
     if (type === "tf" || type === "tk" || type === "dk" || type === "df") {
       const tick = data;
-      const tokenKey = tick.tk;
-      const symbol = this.tokenToSymbol.get(tokenKey);
+      const rawToken = tick.tk;
+      const exch = data["e"] ?? "";
+      const fullKey = exch ? `${exch}|${rawToken}` : rawToken;
+      const symbol = this.tokenToSymbol.get(fullKey) ?? this.tokenToSymbol.get(rawToken);
       const unified = fromTick2(tick, symbol);
+      unified.token = fullKey;
       this.dispatchTick(unified);
       return;
     }
@@ -21576,25 +21610,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."));
     }
@@ -21634,16 +21650,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";
@@ -21679,12 +21685,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);
@@ -21705,10 +21721,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"}`));
@@ -21726,20 +21766,28 @@ class FinvasiaBroker {
   async modifyOrder(orderId, params) {
     try {
       const uid = this.session?.userId ?? "";
-      const payload = {
+      const histRaw = await this.post("SingleOrdHist", {
         uid,
         norenordno: orderId
+      });
+      if (!Array.isArray(histRaw) || histRaw.length === 0) {
+        return Err(new Error(`Cannot modify order ${orderId}: order not found`));
+      }
+      const latestOrder = histRaw[histRaw.length - 1];
+      const payload = {
+        uid,
+        norenordno: orderId,
+        exch: latestOrder.exch,
+        tsym: latestOrder.tsym,
+        prctyp: latestOrder.prctyp,
+        prc: String(params.price ?? latestOrder.prc),
+        qty: String(params.quantity ?? latestOrder.qty),
+        ret: params.validity ?? latestOrder.ret
       };
-      if (params.price !== undefined)
-        payload["prc"] = String(params.price);
-      if (params.quantity !== undefined)
-        payload["qty"] = String(params.quantity);
       if (params.triggerPrice !== undefined)
         payload["trgprc"] = String(params.triggerPrice);
       if (params.type !== undefined)
         payload["prctyp"] = params.type;
-      if (params.validity !== undefined)
-        payload["ret"] = params.validity;
       const res = await this.post("ModifyOrder", payload);
       if (res.stat !== "Ok") {
         return Err(new Error(`Order modification failed: ${res.emsg ?? "Unknown error"}`));
@@ -21809,7 +21857,7 @@ class FinvasiaBroker {
   async getPositions() {
     try {
       const uid = this.session?.userId ?? "";
-      const raw = await this.post("PositionBook", { uid });
+      const raw = await this.post("PositionBook", { uid, actid: uid });
       if (!Array.isArray(raw))
         return Ok([]);
       return Ok(raw.map(fromPosition2));
@@ -22083,7 +22131,7 @@ var EXCHANGE_FROM_DHAN = {
   NSE_CURRENCY: "CDS"
 };
 var PRODUCT_TO_DHAN = {
-  INTRADAY: "INTRA",
+  INTRADAY: "INTRADAY",
   DELIVERY: "CNC",
   NORMAL: "MARGIN"
 };
@@ -22361,11 +22409,28 @@ function fromQuote3(quote, symbol, exchange) {
 }
 
 // src/brokers/dhan/dhan-socket.ts
+import WS2 from "ws";
 var subIdCounter4 = 0;
 function nextSubId4() {
   subIdCounter4 += 1;
   return `dsub_${subIdCounter4}`;
 }
+var EXCH_SEG_FROM_BYTE = {
+  0: "IDX",
+  1: "NSE_EQ",
+  2: "NSE_FNO",
+  3: "NSE_CURRENCY",
+  4: "BSE_EQ",
+  5: "BSE_FNO",
+  6: "MCX_COMM"
+};
+function splitToken(token) {
+  const sep = token.includes("|") ? "|" : ":";
+  const idx = token.indexOf(sep);
+  if (idx === -1)
+    return ["NSE_EQ", token];
+  return [token.slice(0, idx), token.slice(idx + 1)];
+}
 
 class DhanSocket {
   ws = null;
@@ -22389,36 +22454,36 @@ class DhanSocket {
     this.state = "CONNECTING";
     try {
       const url = `${DHAN_WS_URL}?version=2&token=${this.accessToken}&clientId=${this.clientId}&authType=2`;
-      this.ws = new WebSocket(url);
-      this.ws.binaryType = "arraybuffer";
+      this.ws = new WS2(url);
     } catch {
       this.state = "DISCONNECTED";
       return;
     }
-    this.ws.onopen = () => {
+    this.ws.on("open", () => {
       this.state = "CONNECTED";
       this.reconnectAttempts = 0;
       this.startHeartbeat();
       if (this.subscribedTokens.size > 0) {
         this.sendSubscribe(Array.from(this.subscribedTokens));
       }
-    };
-    this.ws.onmessage = (event) => {
+    });
+    this.ws.on("message", (raw, isBinary) => {
       try {
-        if (event.data instanceof ArrayBuffer) {
-          this.handleBinaryMessage(event.data);
+        if (isBinary) {
+          const buf = raw instanceof ArrayBuffer ? Buffer.from(raw) : Buffer.isBuffer(raw) ? raw : Array.isArray(raw) ? Buffer.concat(raw) : Buffer.from(raw);
+          this.handleBinaryMessage(buf);
         } else {
-          const data = JSON.parse(String(event.data));
+          const data = JSON.parse(raw.toString());
           this.handleJsonMessage(data);
         }
       } catch {}
-    };
-    this.ws.onclose = () => {
+    });
+    this.ws.on("close", () => {
       this.state = "DISCONNECTED";
       this.stopHeartbeat();
       this.attemptReconnect();
-    };
-    this.ws.onerror = () => {};
+    });
+    this.ws.on("error", () => {});
   }
   disconnect() {
     this.clearReconnectTimer();
@@ -22476,39 +22541,74 @@ class DhanSocket {
       this.tokenToSymbol.set(token, symbol);
     }
   }
-  handleBinaryMessage(buffer) {
-    const view = new DataView(buffer);
-    if (buffer.byteLength < 48)
+  handleBinaryMessage(data) {
+    if (data.length < 8)
       return;
-    try {
+    const responseCode = data.readUInt8(0);
+    const exchSegByte = data.readUInt8(3);
+    const securityId = data.readInt32LE(4);
+    const exchangeSegment = EXCH_SEG_FROM_BYTE[exchSegByte] ?? "NSE_EQ";
+    const fullKey = `${exchangeSegment}|${securityId}`;
+    if (responseCode === 2 && data.length >= 16) {
+      const ltp = data.readFloatLE(8);
+      const ltt = data.readInt32LE(12);
       const tick = {
-        securityId: view.getInt32(0, true),
-        LTP: view.getFloat32(4, true),
-        open: view.getFloat32(8, true),
-        high: view.getFloat32(12, true),
-        low: view.getFloat32(16, true),
-        close: view.getFloat32(20, true),
-        volume: view.getInt32(24, true),
-        OI: view.getInt32(28, true),
-        bestBidPrice: view.getFloat32(32, true),
-        bestAskPrice: view.getFloat32(36, true),
-        bestBidQty: view.getInt32(40, true),
-        bestAskQty: view.getInt32(44, true),
-        exchangeSegment: "",
-        timestamp: Date.now()
+        securityId,
+        LTP: ltp,
+        open: 0,
+        high: 0,
+        low: 0,
+        close: 0,
+        volume: 0,
+        bestBidPrice: 0,
+        bestAskPrice: 0,
+        bestBidQty: 0,
+        bestAskQty: 0,
+        exchangeSegment,
+        timestamp: ltt > 0 ? ltt * 1000 : Date.now()
       };
-      const tokenStr = String(tick.securityId);
-      const symbol = this.tokenToSymbol.get(tokenStr);
+      const symbol = this.tokenToSymbol.get(fullKey) ?? this.tokenToSymbol.get(String(securityId));
       const unified = fromTick3(tick, symbol);
+      unified.token = fullKey;
       this.dispatchTick(unified);
-    } catch {}
+    } else if (responseCode === 4 && data.length >= 50) {
+      const ltp = data.readFloatLE(8);
+      const ltt = data.readInt32LE(14);
+      const volume = data.readInt32LE(22);
+      const totalSellQty = data.readInt32LE(26);
+      const totalBuyQty = data.readInt32LE(30);
+      const open = data.readFloatLE(34);
+      const close = data.readFloatLE(38);
+      const high = data.readFloatLE(42);
+      const low = data.readFloatLE(46);
+      const tick = {
+        securityId,
+        LTP: ltp,
+        open,
+        high,
+        low,
+        close,
+        volume,
+        bestBidPrice: 0,
+        bestAskPrice: 0,
+        bestBidQty: totalBuyQty,
+        bestAskQty: totalSellQty,
+        exchangeSegment,
+        timestamp: ltt > 0 ? ltt * 1000 : Date.now()
+      };
+      const symbol = this.tokenToSymbol.get(fullKey) ?? this.tokenToSymbol.get(String(securityId));
+      const unified = fromTick3(tick, symbol);
+      unified.token = fullKey;
+      this.dispatchTick(unified);
+    }
   }
   handleJsonMessage(data) {
     if (data["type"] === "ticker_data") {
       const tick = data;
-      const tokenStr = String(tick.securityId);
-      const symbol = this.tokenToSymbol.get(tokenStr);
+      const fullKey = tick.exchangeSegment ? `${tick.exchangeSegment}|${tick.securityId}` : String(tick.securityId);
+      const symbol = this.tokenToSymbol.get(fullKey) ?? this.tokenToSymbol.get(String(tick.securityId));
       const unified = fromTick3(tick, symbol);
+      unified.token = fullKey;
       this.dispatchTick(unified);
     }
   }
@@ -22516,10 +22616,10 @@ class DhanSocket {
     if (!this.ws || this.state !== "CONNECTED")
       return;
     const instruments = tokens.map((t) => {
-      const parts = t.split(":");
+      const [segment, id] = splitToken(t);
       return {
-        ExchangeSegment: parts[0] ?? "NSE_EQ",
-        SecurityId: parts[1] ?? parts[0]
+        ExchangeSegment: segment,
+        SecurityId: id
       };
     });
     const request = {
@@ -22533,10 +22633,10 @@ class DhanSocket {
     if (!this.ws || this.state !== "CONNECTED")
       return;
     const instruments = tokens.map((t) => {
-      const parts = t.split(":");
+      const [segment, id] = splitToken(t);
       return {
-        ExchangeSegment: parts[0] ?? "NSE_EQ",
-        SecurityId: parts[1] ?? parts[0]
+        ExchangeSegment: segment,
+        SecurityId: id
       };
     });
     const request = {
@@ -22560,7 +22660,7 @@ class DhanSocket {
     this.heartbeatTimer = setInterval(() => {
       if (this.ws && this.state === "CONNECTED") {
         try {
-          this.ws.send(JSON.stringify({ RequestCode: 12 }));
+          this.ws.ping();
         } catch {}
       }
     }, 30000);
@@ -22695,23 +22795,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."));
     }
@@ -22754,16 +22838,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"] ?? "";
@@ -22822,13 +22896,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 ?? "";
@@ -22850,9 +22934,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,
@@ -22866,20 +22972,18 @@ class DhanBroker {
   }
   async modifyOrder(orderId, params) {
     try {
+      const rawOrder = await this.request("GET", `/orders/${orderId}`);
+      const original = Array.isArray(rawOrder) ? rawOrder[0] : rawOrder;
       const payload = {
         dhanClientId: this.clientId,
-        orderId
+        orderId,
+        orderType: params.type ? ORDER_TYPE_TO_DHAN[params.type] ?? original.orderType : original.orderType,
+        validity: params.validity ?? original.validity ?? "DAY",
+        quantity: params.quantity ?? original.quantity,
+        price: params.price ?? original.price
       };
-      if (params.price !== undefined)
-        payload["price"] = params.price;
-      if (params.quantity !== undefined)
-        payload["quantity"] = params.quantity;
       if (params.triggerPrice !== undefined)
         payload["triggerPrice"] = params.triggerPrice;
-      if (params.type !== undefined)
-        payload["orderType"] = params.type;
-      if (params.validity !== undefined)
-        payload["validity"] = params.validity;
       const res = await this.request("PUT", `/orders/${orderId}`, payload);
       return Ok({
         orderId: res.orderId ?? orderId,
@@ -22946,7 +23050,11 @@ class DhanBroker {
         return Ok([]);
       return Ok(raw.map((h) => fromHolding3(h)));
     } catch (err) {
-      return Err(err instanceof Error ? err : new Error(String(err)));
+      const msg = err instanceof Error ? err.message : String(err);
+      if (msg.includes("No holdings available") || msg.includes("DH-1111")) {
+        return Ok([]);
+      }
+      return Err(err instanceof Error ? err : new Error(msg));
     }
   }
   async getLTP(symbols) {
@@ -23506,6 +23614,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;
@@ -23516,6 +23632,7 @@ class PaperBroker {
   initialBalance;
   subscriptions = new Map;
   connectionState = "DISCONNECTED";
+  _iMaster;
   dataSource = null;
   dataSourceSub = null;
   subIdCounter = 0;
@@ -23524,6 +23641,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);
     });
@@ -23531,6 +23652,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",
@@ -23798,7 +23933,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, {
@@ -23855,7 +23991,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,
@@ -23874,17 +24010,17 @@ class PaperBroker {
   }
 }
 // src/index.ts
-var VERSION = "0.2.0";
-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}`);