@juspay/neurolink 11.23.0 → 11.23.1

package/CHANGELOG.md

@@ -1,8 +1,11 @@
-## [11.23.0](https://github.com/juspay/neurolink/compare/v11.22.5...v11.23.0) (2026-08-24)
+## [11.23.1](https://github.com/juspay/neurolink/compare/v11.23.0...v11.23.1) (2026-08-24)
 
-### Features
+### Bug Fixes
 
-- **(providers):** ride the SSE wire for LiteLLM generate() ([0651db4](https://github.com/juspay/neurolink/commit/0651db4e9fe0d8618a7510ad32c80f3c5008aa26))
+- **(bench):** floor the usage-stats flush sample count ([10f8401](https://github.com/juspay/neurolink/commit/10f84017926fbf55a781eff977d817f12ee7e975))
+- **(rag):** await registration before reading factory metadata ([9c41530](https://github.com/juspay/neurolink/commit/9c41530677845416d8adf67f8f4d3427d60df009)), closes [#1488](https://github.com/juspay/neurolink/issues/1488)
+- **(scripts):** bound the last two unbounded subprocesses in the security check ([6749db0](https://github.com/juspay/neurolink/commit/6749db0e9d4237335d4ac9feebdd8c9a8f090b14)), closes [#1500](https://github.com/juspay/neurolink/issues/1500)
+- **(test):** stop reporting crashed and unwritable-path cases as green ([ced2008](https://github.com/juspay/neurolink/commit/ced20088eb5402767ba6fe492288886ee74d2c4f))
 
 ## [11.2.3](https://github.com/juspay/neurolink/compare/v11.2.2...v11.2.3) (2026-08-19)
 

package/dist/browser/neurolink.min.js

@@ -1733,7 +1733,7 @@ ${c}`;if(u.length>t){l.length>s.length&&a.push(l),a.push(u),l=s;continue}const d
 `+o.content:(r.push(n),n={...o})}return n&&r.push(n),r}}}});async function nLt(e,t){return sLt.createChunker(e,t)}var ru,oLt,sLt,iLt=C({"src/lib/rag/ChunkerFactory.ts"(){"use strict";Yh(),V(),DC(),ru={character:{description:"Splits text into fixed-size character chunks with optional overlap",defaultConfig:{maxSize:1e3,overlap:100},supportedOptions:["maxSize","overlap","minSize"],useCases:["Simple text processing","Fixed-size chunks needed"],aliases:["char","fixed-size","fixed"]},recursive:{description:"Recursively splits text using ordered separators",defaultConfig:{maxSize:1e3,overlap:100,separators:[`
 
 `,`
-`,". "," ",""]},supportedOptions:["maxSize","overlap","separators","keepSeparators"],useCases:["General text documents","Default choice"],aliases:["recursive-character","langchain-default"]},sentence:{description:"Splits text by sentence boundaries",defaultConfig:{maxSize:1e3,overlap:1},supportedOptions:["maxSize","overlap","boundaryDetection","maxSentences"],useCases:["Q&A applications","Sentence-level analysis"],aliases:["sent","sentence-based"]},token:{description:"Splits text by token count using a specific tokenizer",defaultConfig:{maxSize:512,overlap:50},supportedOptions:["maxSize","overlap","tokenizer","maxTokens"],useCases:["Token-aware splitting","Model-specific chunks"],aliases:["tok","tokenized"]},markdown:{description:"Splits markdown content by headers and structural elements",defaultConfig:{maxSize:1e3,overlap:50},supportedOptions:["maxSize","headerLevels","splitCodeBlocks"],useCases:["Documentation processing","README files"],aliases:["md","markdown-header"]},html:{description:"Splits HTML content by semantic tags",defaultConfig:{maxSize:1e3,overlap:0},supportedOptions:["maxSize","splitTags","stripTags","preserveAttributes"],useCases:["Web content processing","HTML documents"],aliases:["html-tag","web"]},json:{description:"Splits JSON documents by object boundaries",defaultConfig:{maxSize:1e3,overlap:0},supportedOptions:["maxSize","maxDepth","chunkKeys"],useCases:["API response processing","Structured data"],aliases:["json-object","structured"]},latex:{description:"Splits LaTeX documents by sections and environments",defaultConfig:{maxSize:1e3,overlap:0},supportedOptions:["maxSize","environments","splitMathBlocks"],useCases:["Academic papers","Scientific documents"],aliases:["tex","latex-section"]},semantic:{description:"Uses LLM to identify semantically meaningful split points",defaultConfig:{maxSize:1e3,overlap:100},supportedOptions:["maxSize","modelName","provider","similarityThreshold"],useCases:["Advanced semantic understanding","AI-enhanced chunking"],aliases:["llm","ai-semantic"]},"semantic-markdown":{description:"Combines markdown splitting with semantic similarity",defaultConfig:{maxSize:1e3,overlap:100},supportedOptions:["maxSize","similarityThreshold","maxMergeSize"],useCases:["Context-aware documentation","Knowledge bases"],aliases:["semantic-md","smart-markdown"]}},oLt=class rh extends v1{static instance=null;metadataMap=new Map;constructor(){super()}static getInstance(){return rh.instance||(rh.instance=new rh),rh.instance}static resetInstance(){rh.instance&&(rh.instance.clear(),rh.instance=null)}async registerAll(){this.registerChunker("character",async t=>{const{CharacterChunker:r}=await Promise.resolve().then(()=>(u6r(),FNt));return new r(t)},ru.character),this.registerChunker("recursive",async t=>{const{RecursiveChunker:r}=await Promise.resolve().then(()=>(zNt(),ate));return new r(t)},ru.recursive),this.registerChunker("sentence",async t=>{const{SentenceChunker:r}=await Promise.resolve().then(()=>(d6r(),jNt));return new r(t)},ru.sentence),this.registerChunker("token",async t=>{const{TokenChunker:r}=await Promise.resolve().then(()=>(p6r(),GNt));return new r(t)},ru.token),this.registerChunker("markdown",async t=>{const{MarkdownChunker:r}=await Promise.resolve().then(()=>(h6r(),VNt));return new r(t)},ru.markdown),this.registerChunker("html",async t=>{const{HTMLChunker:r}=await Promise.resolve().then(()=>(f6r(),JNt));return new r(t)},ru.html),this.registerChunker("json",async t=>{const{JSONChunker:r}=await Promise.resolve().then(()=>(g6r(),ZNt));return new r(t)},ru.json),this.registerChunker("latex",async t=>{const{LaTeXChunker:r}=await Promise.resolve().then(()=>(y6r(),QNt));return new r(t)},ru.latex),this.registerChunker("semantic",async t=>{const{RecursiveChunker:r}=await Promise.resolve().then(()=>(zNt(),ate));return new r(t)},ru.semantic),this.registerChunker("semantic-markdown",async t=>{const{SemanticMarkdownChunker:r}=await Promise.resolve().then(()=>(rLt(),tLt));return new r(t)},ru["semantic-markdown"]),f.debug(`[ChunkerFactory] Registered ${this.items.size} chunking strategies`)}registerChunker(t,r,n){this.metadataMap.set(t,n),this.register(t,r,n.aliases,{metadata:n}),f.debug(`[ChunkerFactory] Registered chunker '${t}' with aliases: ${n.aliases?.join(", ")??"none"}`)}async createChunker(t,r){await this.ensureInitialized();const n=this.resolveName(t);if(!this.has(n)){const o=this.getAvailable();throw new Vu(`Unknown chunking strategy: '${t}'. Available strategies: ${o.join(", ")}`,{code:Pr.CHUNKING_STRATEGY_NOT_FOUND,details:{requestedStrategy:t,availableStrategies:o}})}try{const o=await this.create(n,r);return f.debug(`[ChunkerFactory] Created chunker '${n}' with config:`,r),o}catch(o){throw new Vu(`Failed to create chunker '${n}': ${o instanceof Error?o.message:String(o)}`,{code:Pr.CHUNKING_ERROR,cause:o instanceof Error?o:void 0,details:{strategy:n,config:r}})}}getChunkerMetadata(t){const r=this.resolveName(t);return this.metadataMap.get(r)}getDefaultConfig(t){return this.getChunkerMetadata(t)?.defaultConfig}async getAvailableStrategies(){return await this.ensureInitialized(),this.getAvailable()}getStrategyAliases(){return this.getAliases()}hasStrategy(t){const r=this.resolveName(t);return this.has(r)}getChunkersForUseCase(t){const r=[],n=t.toLowerCase();for(const[o,s]of this.metadataMap)(s.useCases?.some(a=>a.toLowerCase().includes(n))??!1)&&r.push(o);return r}getAllMetadata(){return new Map(this.metadataMap)}clear(){super.clear(),this.metadataMap.clear()}},sLt=oLt.getInstance()}});async function OC(e,t,r,n){return gt({name:"neurolink.rag.rerank",tracer:He.rag,attributes:{"rag.reranker.input_count":e.length,"rag.reranker.top_k":n?.topK??3,"rag.reranker.query_length":t.length}},async o=>{const{queryEmbedding:s,topK:i=3,weights:a=Ca}=n||{};if(e.length===0)return o.setAttribute("rag.reranker.output_count",0),[];const l=(a.semantic||Ca.semantic)+(a.vector||Ca.vector)+(a.position||Ca.position);Math.abs(l-1)>.01&&f.warn("[Reranker] Weights do not sum to 1.0, normalizing",{original:a,total:l});const c={semantic:(a.semantic||Ca.semantic)/l,vector:(a.vector||Ca.vector)/l,position:(a.position||Ca.position)/l},u=[],d=5;for(let h=0;h<e.length;h+=d){const y=e.slice(h,h+d).map(async(w,b)=>{const T=h+b,x=w.score??0,k=1-T/e.length,I=await v6r(t,w.text||w.metadata?.text||"",r),R=c.semantic*I.score+c.vector*x+c.position*k;return{result:w,score:R,details:{semantic:I.score,vector:x,position:k,queryAnalysis:I.analysis}}}),v=await Promise.all(y);u.push(...v)}u.sort((h,g)=>g.score-h.score);const m=u.slice(0,i);return o.setAttribute("rag.reranker.output_count",m.length),m})}async function v6r(e,t,r){const n=`Rate the relevance of the following text to the query on a scale of 0 to 1.
+`,". "," ",""]},supportedOptions:["maxSize","overlap","separators","keepSeparators"],useCases:["General text documents","Default choice"],aliases:["recursive-character","langchain-default"]},sentence:{description:"Splits text by sentence boundaries",defaultConfig:{maxSize:1e3,overlap:1},supportedOptions:["maxSize","overlap","boundaryDetection","maxSentences"],useCases:["Q&A applications","Sentence-level analysis"],aliases:["sent","sentence-based"]},token:{description:"Splits text by token count using a specific tokenizer",defaultConfig:{maxSize:512,overlap:50},supportedOptions:["maxSize","overlap","tokenizer","maxTokens"],useCases:["Token-aware splitting","Model-specific chunks"],aliases:["tok","tokenized"]},markdown:{description:"Splits markdown content by headers and structural elements",defaultConfig:{maxSize:1e3,overlap:50},supportedOptions:["maxSize","headerLevels","splitCodeBlocks"],useCases:["Documentation processing","README files"],aliases:["md","markdown-header"]},html:{description:"Splits HTML content by semantic tags",defaultConfig:{maxSize:1e3,overlap:0},supportedOptions:["maxSize","splitTags","stripTags","preserveAttributes"],useCases:["Web content processing","HTML documents"],aliases:["html-tag","web"]},json:{description:"Splits JSON documents by object boundaries",defaultConfig:{maxSize:1e3,overlap:0},supportedOptions:["maxSize","maxDepth","chunkKeys"],useCases:["API response processing","Structured data"],aliases:["json-object","structured"]},latex:{description:"Splits LaTeX documents by sections and environments",defaultConfig:{maxSize:1e3,overlap:0},supportedOptions:["maxSize","environments","splitMathBlocks"],useCases:["Academic papers","Scientific documents"],aliases:["tex","latex-section"]},semantic:{description:"Uses LLM to identify semantically meaningful split points",defaultConfig:{maxSize:1e3,overlap:100},supportedOptions:["maxSize","modelName","provider","similarityThreshold"],useCases:["Advanced semantic understanding","AI-enhanced chunking"],aliases:["llm","ai-semantic"]},"semantic-markdown":{description:"Combines markdown splitting with semantic similarity",defaultConfig:{maxSize:1e3,overlap:100},supportedOptions:["maxSize","similarityThreshold","maxMergeSize"],useCases:["Context-aware documentation","Knowledge bases"],aliases:["semantic-md","smart-markdown"]}},oLt=class rh extends v1{static instance=null;metadataMap=new Map;constructor(){super()}static getInstance(){return rh.instance||(rh.instance=new rh),rh.instance}static resetInstance(){rh.instance&&(rh.instance.clear(),rh.instance=null)}async registerAll(){this.registerChunker("character",async t=>{const{CharacterChunker:r}=await Promise.resolve().then(()=>(u6r(),FNt));return new r(t)},ru.character),this.registerChunker("recursive",async t=>{const{RecursiveChunker:r}=await Promise.resolve().then(()=>(zNt(),ate));return new r(t)},ru.recursive),this.registerChunker("sentence",async t=>{const{SentenceChunker:r}=await Promise.resolve().then(()=>(d6r(),jNt));return new r(t)},ru.sentence),this.registerChunker("token",async t=>{const{TokenChunker:r}=await Promise.resolve().then(()=>(p6r(),GNt));return new r(t)},ru.token),this.registerChunker("markdown",async t=>{const{MarkdownChunker:r}=await Promise.resolve().then(()=>(h6r(),VNt));return new r(t)},ru.markdown),this.registerChunker("html",async t=>{const{HTMLChunker:r}=await Promise.resolve().then(()=>(f6r(),JNt));return new r(t)},ru.html),this.registerChunker("json",async t=>{const{JSONChunker:r}=await Promise.resolve().then(()=>(g6r(),ZNt));return new r(t)},ru.json),this.registerChunker("latex",async t=>{const{LaTeXChunker:r}=await Promise.resolve().then(()=>(y6r(),QNt));return new r(t)},ru.latex),this.registerChunker("semantic",async t=>{const{RecursiveChunker:r}=await Promise.resolve().then(()=>(zNt(),ate));return new r(t)},ru.semantic),this.registerChunker("semantic-markdown",async t=>{const{SemanticMarkdownChunker:r}=await Promise.resolve().then(()=>(rLt(),tLt));return new r(t)},ru["semantic-markdown"]),f.debug(`[ChunkerFactory] Registered ${this.items.size} chunking strategies`)}registerChunker(t,r,n){this.metadataMap.set(t,n),this.register(t,r,n.aliases,{metadata:n}),f.debug(`[ChunkerFactory] Registered chunker '${t}' with aliases: ${n.aliases?.join(", ")??"none"}`)}async createChunker(t,r){await this.ensureInitialized();const n=this.resolveName(t);if(!this.has(n)){const o=this.getAvailable();throw new Vu(`Unknown chunking strategy: '${t}'. Available strategies: ${o.join(", ")}`,{code:Pr.CHUNKING_STRATEGY_NOT_FOUND,details:{requestedStrategy:t,availableStrategies:o}})}try{const o=await this.create(n,r);return f.debug(`[ChunkerFactory] Created chunker '${n}' with config:`,r),o}catch(o){throw new Vu(`Failed to create chunker '${n}': ${o instanceof Error?o.message:String(o)}`,{code:Pr.CHUNKING_ERROR,cause:o instanceof Error?o:void 0,details:{strategy:n,config:r}})}}async getChunkerMetadata(t){await this.ensureInitialized();const r=this.resolveName(t);return this.metadataMap.get(r)}async getDefaultConfig(t){return(await this.getChunkerMetadata(t))?.defaultConfig}async getAvailableStrategies(){return await this.ensureInitialized(),this.getAvailable()}async getStrategyAliases(){return await this.ensureInitialized(),this.getAliases()}async hasStrategy(t){await this.ensureInitialized();const r=this.resolveName(t);return this.has(r)}async getChunkersForUseCase(t){await this.ensureInitialized();const r=[],n=t.toLowerCase();for(const[o,s]of this.metadataMap)(s.useCases?.some(a=>a.toLowerCase().includes(n))??!1)&&r.push(o);return r}async getAllMetadata(){return await this.ensureInitialized(),new Map(this.metadataMap)}clear(){super.clear(),this.metadataMap.clear()}},sLt=oLt.getInstance()}});async function OC(e,t,r,n){return gt({name:"neurolink.rag.rerank",tracer:He.rag,attributes:{"rag.reranker.input_count":e.length,"rag.reranker.top_k":n?.topK??3,"rag.reranker.query_length":t.length}},async o=>{const{queryEmbedding:s,topK:i=3,weights:a=Ca}=n||{};if(e.length===0)return o.setAttribute("rag.reranker.output_count",0),[];const l=(a.semantic||Ca.semantic)+(a.vector||Ca.vector)+(a.position||Ca.position);Math.abs(l-1)>.01&&f.warn("[Reranker] Weights do not sum to 1.0, normalizing",{original:a,total:l});const c={semantic:(a.semantic||Ca.semantic)/l,vector:(a.vector||Ca.vector)/l,position:(a.position||Ca.position)/l},u=[],d=5;for(let h=0;h<e.length;h+=d){const y=e.slice(h,h+d).map(async(w,b)=>{const T=h+b,x=w.score??0,k=1-T/e.length,I=await v6r(t,w.text||w.metadata?.text||"",r),R=c.semantic*I.score+c.vector*x+c.position*k;return{result:w,score:R,details:{semantic:I.score,vector:x,position:k,queryAnalysis:I.analysis}}}),v=await Promise.all(y);u.push(...v)}u.sort((h,g)=>g.score-h.score);const m=u.slice(0,i);return o.setAttribute("rag.reranker.output_count",m.length),m})}async function v6r(e,t,r){const n=`Rate the relevance of the following text to the query on a scale of 0 to 1.
 
 Query: ${e}
 

package/dist/rag/ChunkerFactory.d.ts

@@ -37,13 +37,23 @@ export declare class ChunkerFactory extends BaseFactory<Chunker, ChunkerConfig>
      */
     createChunker(strategyOrAlias: string, config?: ChunkerConfig): Promise<Chunker>;
     /**
-     * Get metadata for a chunker
+     * Get metadata for a chunker.
+     *
+     * Awaits registration first. `metadataMap` and the alias map are populated by
+     * `registerAll()`, which only runs via the async `ensureInitialized()` — and
+     * the only place that awaited it was `create()`. So on a fresh process this
+     * returned `undefined` for every strategy until something happened to build a
+     * chunker first, and returned real metadata after. Order-dependent, silent,
+     * and `undefined` rather than a throw.
+     *
+     * `createChunker()` and `getAvailableStrategies()` were already async for
+     * exactly this reason; these readers were the ones that had not caught up.
      */
-    getChunkerMetadata(strategyOrAlias: string): ChunkerMetadata | undefined;
+    getChunkerMetadata(strategyOrAlias: string): Promise<ChunkerMetadata | undefined>;
     /**
      * Get default configuration for a chunker
      */
-    getDefaultConfig(strategyOrAlias: string): ChunkerConfig | undefined;
+    getDefaultConfig(strategyOrAlias: string): Promise<ChunkerConfig | undefined>;
     /**
      * Get available chunking strategies (not including aliases)
      */
@@ -51,19 +61,19 @@ export declare class ChunkerFactory extends BaseFactory<Chunker, ChunkerConfig>
     /**
      * Get all aliases mapped to their strategies
      */
-    getStrategyAliases(): Map<string, string>;
+    getStrategyAliases(): Promise<Map<string, string>>;
     /**
      * Check if a strategy exists
      */
-    hasStrategy(strategyOrAlias: string): boolean;
+    hasStrategy(strategyOrAlias: string): Promise<boolean>;
     /**
      * Get chunkers suitable for a use case
      */
-    getChunkersForUseCase(useCase: string): ChunkingStrategy[];
+    getChunkersForUseCase(useCase: string): Promise<ChunkingStrategy[]>;
     /**
      * Get all chunker metadata
      */
-    getAllMetadata(): Map<string, ChunkerMetadata>;
+    getAllMetadata(): Promise<Map<string, ChunkerMetadata>>;
     /**
      * Clear factory and metadata
      */
@@ -84,8 +94,8 @@ export declare function getAvailableStrategies(): Promise<ChunkingStrategy[]>;
 /**
  * Convenience function to get chunker metadata
  */
-export declare function getChunkerMetadata(strategyOrAlias: string): ChunkerMetadata | undefined;
+export declare function getChunkerMetadata(strategyOrAlias: string): Promise<ChunkerMetadata | undefined>;
 /**
  * Convenience function to get default config
  */
-export declare function getDefaultConfig(strategyOrAlias: string): ChunkerConfig | undefined;
+export declare function getDefaultConfig(strategyOrAlias: string): Promise<ChunkerConfig | undefined>;

package/dist/rag/ChunkerFactory.js

@@ -229,17 +229,28 @@ export class ChunkerFactory extends BaseFactory {
         }
     }
     /**
-     * Get metadata for a chunker
+     * Get metadata for a chunker.
+     *
+     * Awaits registration first. `metadataMap` and the alias map are populated by
+     * `registerAll()`, which only runs via the async `ensureInitialized()` — and
+     * the only place that awaited it was `create()`. So on a fresh process this
+     * returned `undefined` for every strategy until something happened to build a
+     * chunker first, and returned real metadata after. Order-dependent, silent,
+     * and `undefined` rather than a throw.
+     *
+     * `createChunker()` and `getAvailableStrategies()` were already async for
+     * exactly this reason; these readers were the ones that had not caught up.
      */
-    getChunkerMetadata(strategyOrAlias) {
+    async getChunkerMetadata(strategyOrAlias) {
+        await this.ensureInitialized();
         const resolvedName = this.resolveName(strategyOrAlias);
         return this.metadataMap.get(resolvedName);
     }
     /**
      * Get default configuration for a chunker
      */
-    getDefaultConfig(strategyOrAlias) {
-        const metadata = this.getChunkerMetadata(strategyOrAlias);
+    async getDefaultConfig(strategyOrAlias) {
+        const metadata = await this.getChunkerMetadata(strategyOrAlias);
         return metadata?.defaultConfig;
     }
     /**
@@ -252,20 +263,23 @@ export class ChunkerFactory extends BaseFactory {
     /**
      * Get all aliases mapped to their strategies
      */
-    getStrategyAliases() {
+    async getStrategyAliases() {
+        await this.ensureInitialized();
         return this.getAliases();
     }
     /**
      * Check if a strategy exists
      */
-    hasStrategy(strategyOrAlias) {
+    async hasStrategy(strategyOrAlias) {
+        await this.ensureInitialized();
         const resolved = this.resolveName(strategyOrAlias);
         return this.has(resolved);
     }
     /**
      * Get chunkers suitable for a use case
      */
-    getChunkersForUseCase(useCase) {
+    async getChunkersForUseCase(useCase) {
+        await this.ensureInitialized();
         const matches = [];
         const useCaseLower = useCase.toLowerCase();
         for (const [strategy, metadata] of this.metadataMap) {
@@ -279,7 +293,8 @@ export class ChunkerFactory extends BaseFactory {
     /**
      * Get all chunker metadata
      */
-    getAllMetadata() {
+    async getAllMetadata() {
+        await this.ensureInitialized();
         return new Map(this.metadataMap);
     }
     /**

package/dist/rag/reranker/RerankerFactory.d.ts

@@ -64,11 +64,11 @@ export declare class RerankerFactory extends BaseFactory<Reranker, RerankerConfi
     /**
      * Get metadata for a reranker
      */
-    getRerankerMetadata(typeOrAlias: string): RerankerMetadata | undefined;
+    getRerankerMetadata(typeOrAlias: string): Promise<RerankerMetadata | undefined>;
     /**
      * Get default configuration for a reranker
      */
-    getDefaultConfig(typeOrAlias: string): Partial<RerankerConfig> | undefined;
+    getDefaultConfig(typeOrAlias: string): Promise<Partial<RerankerConfig> | undefined>;
     /**
      * Get available reranker types (not including aliases)
      */
@@ -76,27 +76,27 @@ export declare class RerankerFactory extends BaseFactory<Reranker, RerankerConfi
     /**
      * Get all aliases mapped to their types
      */
-    getTypeAliases(): Map<string, string>;
+    getTypeAliases(): Promise<Map<string, string>>;
     /**
      * Check if a type exists
      */
-    hasType(typeOrAlias: string): boolean;
+    hasType(typeOrAlias: string): Promise<boolean>;
     /**
      * Get rerankers suitable for a use case
      */
-    getRerankersForUseCase(useCase: string): RerankerType[];
+    getRerankersForUseCase(useCase: string): Promise<RerankerType[]>;
     /**
      * Get rerankers that don't require external APIs
      */
-    getLocalRerankers(): RerankerType[];
+    getLocalRerankers(): Promise<RerankerType[]>;
     /**
      * Get rerankers that don't require AI models
      */
-    getModelFreeRerankers(): RerankerType[];
+    getModelFreeRerankers(): Promise<RerankerType[]>;
     /**
      * Get all reranker metadata
      */
-    getAllMetadata(): Map<RerankerType, RerankerMetadata>;
+    getAllMetadata(): Promise<Map<RerankerType, RerankerMetadata>>;
     /**
      * Clear factory and metadata
      */
@@ -117,8 +117,8 @@ export declare function getAvailableRerankerTypes(): Promise<RerankerType[]>;
 /**
  * Convenience function to get reranker metadata
  */
-export declare function getRerankerMetadata(typeOrAlias: string): RerankerMetadata | undefined;
+export declare function getRerankerMetadata(typeOrAlias: string): Promise<RerankerMetadata | undefined>;
 /**
  * Convenience function to get default config
  */
-export declare function getRerankerDefaultConfig(typeOrAlias: string): Partial<RerankerConfig> | undefined;
+export declare function getRerankerDefaultConfig(typeOrAlias: string): Promise<Partial<RerankerConfig> | undefined>;

package/dist/rag/reranker/RerankerFactory.js

@@ -316,15 +316,16 @@ export class RerankerFactory extends BaseFactory {
     /**
      * Get metadata for a reranker
      */
-    getRerankerMetadata(typeOrAlias) {
+    async getRerankerMetadata(typeOrAlias) {
+        await this.ensureInitialized();
         const resolvedName = this.resolveName(typeOrAlias);
         return this.metadataMap.get(resolvedName);
     }
     /**
      * Get default configuration for a reranker
      */
-    getDefaultConfig(typeOrAlias) {
-        const metadata = this.getRerankerMetadata(typeOrAlias);
+    async getDefaultConfig(typeOrAlias) {
+        const metadata = await this.getRerankerMetadata(typeOrAlias);
         return metadata?.defaultConfig;
     }
     /**
@@ -337,20 +338,23 @@ export class RerankerFactory extends BaseFactory {
     /**
      * Get all aliases mapped to their types
      */
-    getTypeAliases() {
+    async getTypeAliases() {
+        await this.ensureInitialized();
         return this.getAliases();
     }
     /**
      * Check if a type exists
      */
-    hasType(typeOrAlias) {
+    async hasType(typeOrAlias) {
+        await this.ensureInitialized();
         const resolved = this.resolveName(typeOrAlias);
         return this.has(resolved);
     }
     /**
      * Get rerankers suitable for a use case
      */
-    getRerankersForUseCase(useCase) {
+    async getRerankersForUseCase(useCase) {
+        await this.ensureInitialized();
         const matches = [];
         const useCaseLower = useCase.toLowerCase();
         for (const [type, metadata] of this.metadataMap) {
@@ -364,7 +368,8 @@ export class RerankerFactory extends BaseFactory {
     /**
      * Get rerankers that don't require external APIs
      */
-    getLocalRerankers() {
+    async getLocalRerankers() {
+        await this.ensureInitialized();
         const matches = [];
         for (const [type, metadata] of this.metadataMap) {
             if (!metadata.requiresExternalAPI) {
@@ -376,7 +381,8 @@ export class RerankerFactory extends BaseFactory {
     /**
      * Get rerankers that don't require AI models
      */
-    getModelFreeRerankers() {
+    async getModelFreeRerankers() {
+        await this.ensureInitialized();
         const matches = [];
         for (const [type, metadata] of this.metadataMap) {
             if (!metadata.requiresModel) {
@@ -388,7 +394,8 @@ export class RerankerFactory extends BaseFactory {
     /**
      * Get all reranker metadata
      */
-    getAllMetadata() {
+    async getAllMetadata() {
+        await this.ensureInitialized();
         return new Map(this.metadataMap);
     }
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juspay/neurolink",
-  "version": "11.23.0",
+  "version": "11.23.1",
   "packageManager": "pnpm@10.15.1",
   "description": "TypeScript AI SDK with 24+ LLM providers behind one consistent API. MCP-native (connect any MCP server), voice TTS/STT/realtime, RAG, agents, memory, context compaction. OpenAI · Anthropic · Gemini · Bedrock · Azure · Ollama · DeepSeek · NVIDIA NIM and more.",
   "author": {