@open-mercato/search 0.4.11-develop.2543.c880fff2e7 → 0.4.11-develop.2575.e689a7bd59

package/dist/service.js

@@ -4,8 +4,11 @@ import { needsSearchResultEnrichment } from "./lib/search-result-enrichment.js";
 const DEFAULT_MERGE_CONFIG = {
   duplicateHandling: "highest_score"
 };
+const STRATEGY_AVAILABILITY_CACHE_TTL_MS = 2e3;
 class SearchService {
   constructor(options = {}) {
+    this.availabilityCache = /* @__PURE__ */ new Map();
+    this.availabilityInflight = /* @__PURE__ */ new Map();
     this.strategies = /* @__PURE__ */ new Map();
     for (const strategy of options.strategies ?? []) {
       this.strategies.set(strategy.id, strategy);
@@ -14,6 +17,7 @@ class SearchService {
     this.fallbackStrategy = options.fallbackStrategy;
     this.mergeConfig = options.mergeConfig ?? DEFAULT_MERGE_CONFIG;
     this.presenterEnricher = options.presenterEnricher;
+    this.availabilityCacheTtlMs = options.availabilityCacheTtlMs ?? STRATEGY_AVAILABILITY_CACHE_TTL_MS;
   }
   /**
    * Get all registered strategies.
@@ -200,6 +204,8 @@ class SearchService {
    */
   registerStrategy(strategy) {
     this.strategies.set(strategy.id, strategy);
+    this.availabilityCache.delete(strategy.id);
+    this.availabilityInflight.delete(strategy.id);
   }
   /**
    * Unregister a strategy.
@@ -208,6 +214,22 @@ class SearchService {
    */
   unregisterStrategy(strategyId) {
     this.strategies.delete(strategyId);
+    this.availabilityCache.delete(strategyId);
+    this.availabilityInflight.delete(strategyId);
+  }
+  /**
+   * Invalidate the strategy availability cache.
+   * Call after manual reconnects or env changes when callers must observe the
+   * current backend state immediately rather than waiting for TTL expiry.
+   */
+  invalidateAvailabilityCache(strategyId) {
+    if (strategyId) {
+      this.availabilityCache.delete(strategyId);
+      this.availabilityInflight.delete(strategyId);
+      return;
+    }
+    this.availabilityCache.clear();
+    this.availabilityInflight.clear();
   }
   /**
    * Get all registered strategy IDs.
@@ -238,25 +260,62 @@ class SearchService {
   async isStrategyAvailable(strategyId) {
     const strategy = this.strategies.get(strategyId);
     if (!strategy) return false;
-    return strategy.isAvailable();
+    return this.checkStrategyAvailability(strategy);
+  }
+  /**
+   * Resolve a strategy's availability via the short-lived TTL cache.
+   * Coalesces concurrent callers onto a single in-flight probe to avoid
+   * thundering-herd on remote backends.
+   */
+  async checkStrategyAvailability(strategy) {
+    const now = Date.now();
+    const cached = this.availabilityCache.get(strategy.id);
+    if (cached && cached.expiresAt > now) return cached.value;
+    const inflight = this.availabilityInflight.get(strategy.id);
+    if (inflight) return inflight;
+    const probe = (async () => {
+      try {
+        const value = await strategy.isAvailable();
+        this.availabilityCache.set(strategy.id, {
+          value,
+          expiresAt: Date.now() + this.availabilityCacheTtlMs
+        });
+        return value;
+      } catch {
+        this.availabilityCache.set(strategy.id, {
+          value: false,
+          expiresAt: Date.now() + this.availabilityCacheTtlMs
+        });
+        return false;
+      } finally {
+        this.availabilityInflight.delete(strategy.id);
+      }
+    })();
+    this.availabilityInflight.set(strategy.id, probe);
+    return probe;
   }
   /**
    * Get available strategies from the requested list.
    * Filters out strategies that are not registered or not available.
+   * Probes run in parallel and reuse a short-lived per-strategy availability
+   * cache, so hot paths pay the max latency of the slowest probe (or zero
+   * when cached) instead of the sum of all probes.
    */
   async getAvailableStrategies(ids) {
     const targetIds = ids ?? Array.from(this.strategies.keys());
-    const available = [];
+    const candidates = [];
     for (const id of targetIds) {
       const strategy = this.strategies.get(id);
-      if (strategy) {
-        try {
-          const isAvailable = await strategy.isAvailable();
-          if (isAvailable) {
-            available.push(strategy);
-          }
-        } catch {
-        }
+      if (strategy) candidates.push(strategy);
+    }
+    const probes = await Promise.allSettled(
+      candidates.map((strategy) => this.checkStrategyAvailability(strategy))
+    );
+    const available = [];
+    for (let i = 0; i < probes.length; i++) {
+      const probe = probes[i];
+      if (probe.status === "fulfilled" && probe.value) {
+        available.push(candidates[i]);
       }
     }
     return available.sort((a, b) => b.priority - a.priority);

package/dist/service.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/service.ts"],
-  "sourcesContent": ["import type {\n  SearchStrategy,\n  SearchStrategyId,\n  SearchOptions,\n  SearchResult,\n  SearchServiceOptions,\n  ResultMergeConfig,\n  IndexableRecord,\n  PresenterEnricherFn,\n} from './types'\nimport { mergeAndRankResults } from './lib/merger'\nimport { searchError } from './lib/debug'\nimport { needsSearchResultEnrichment } from './lib/search-result-enrichment'\n\n/**\n * Default merge configuration.\n */\nconst DEFAULT_MERGE_CONFIG: ResultMergeConfig = {\n  duplicateHandling: 'highest_score',\n}\n\n/**\n * SearchService orchestrates multiple search strategies, executing searches in parallel\n * and merging results using the RRF algorithm.\n *\n * Features:\n * - Parallel strategy execution for optimal performance\n * - Graceful degradation when strategies fail\n * - Result merging with configurable weights\n * - Strategy availability checking\n *\n * @example\n * ```typescript\n * const service = new SearchService({\n *   strategies: [tokenStrategy, vectorStrategy, fulltextStrategy],\n *   defaultStrategies: ['fulltext', 'vector', 'tokens'],\n *   mergeConfig: {\n *     duplicateHandling: 'highest_score',\n *     strategyWeights: { fulltext: 1.2, vector: 1.0, tokens: 0.8 },\n *   },\n * })\n *\n * const results = await service.search('john doe', { tenantId: 'tenant-123' })\n * ```\n */\nexport class SearchService {\n  private readonly strategies: Map<SearchStrategyId, SearchStrategy>\n  private readonly defaultStrategies: SearchStrategyId[]\n  private readonly fallbackStrategy: SearchStrategyId | undefined\n  private readonly mergeConfig: ResultMergeConfig\n  private readonly presenterEnricher?: PresenterEnricherFn\n\n  constructor(options: SearchServiceOptions = {}) {\n    this.strategies = new Map()\n    for (const strategy of options.strategies ?? []) {\n      this.strategies.set(strategy.id, strategy)\n    }\n    this.defaultStrategies = options.defaultStrategies ?? ['tokens']\n    this.fallbackStrategy = options.fallbackStrategy\n    this.mergeConfig = options.mergeConfig ?? DEFAULT_MERGE_CONFIG\n    this.presenterEnricher = options.presenterEnricher\n  }\n\n  /**\n   * Get all registered strategies.\n   */\n  getStrategies(): SearchStrategy[] {\n    return Array.from(this.strategies.values())\n  }\n\n  /**\n   * Execute a search query across configured strategies.\n   *\n   * @param query - Search query string\n   * @param options - Search options with tenant, filters, etc.\n   * @returns Merged and ranked search results\n   */\n  async search(query: string, options: SearchOptions): Promise<SearchResult[]> {\n    const strategyIds = options.strategies ?? this.defaultStrategies\n    const activeStrategies = await this.getAvailableStrategies(strategyIds)\n\n    if (activeStrategies.length === 0) {\n      // Try fallback strategy if defined\n      if (this.fallbackStrategy) {\n        const fallback = await this.getAvailableStrategies([this.fallbackStrategy])\n        if (fallback.length > 0) {\n          activeStrategies.push(...fallback)\n        }\n      }\n    }\n\n    if (activeStrategies.length === 0) {\n      return []\n    }\n\n    // Execute searches in parallel with graceful degradation\n    const results = await Promise.allSettled(\n      activeStrategies.map((strategy) => this.executeStrategySearch(strategy, query, options)),\n    )\n\n    // Collect successful results, log failures\n    const allResults: SearchResult[] = []\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'fulfilled') {\n        allResults.push(...result.value)\n      } else {\n        const strategy = activeStrategies[i]\n        searchError('SearchService', 'Strategy search failed', {\n          strategyId: strategy?.id,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n\n    // Merge and rank results\n    const merged = mergeAndRankResults(allResults, this.mergeConfig)\n\n    // Enrich results missing presenter or navigation metadata\n    return this.enrichResultsWithPresenter(merged, options.tenantId, options.organizationId)\n  }\n\n  /**\n   * Enrich results that are missing presenter data using the configured enricher.\n   * This ensures token-only results get proper titles/subtitles for display.\n   */\n  private async enrichResultsWithPresenter(\n    results: SearchResult[],\n    tenantId: string,\n    organizationId?: string | null,\n  ): Promise<SearchResult[]> {\n    // If no enricher configured, return as-is\n    if (!this.presenterEnricher) return results\n\n    const hasMissing = results.some(needsSearchResultEnrichment)\n    if (!hasMissing) return results\n\n    // Use the configured presenter enricher\n    try {\n      return await this.presenterEnricher(results, tenantId, organizationId)\n    } catch {\n      // Enrichment failed, return results as-is\n      return results\n    }\n  }\n\n  /**\n   * Index a record across all available strategies.\n   *\n   * @param record - Record to index\n   */\n  async index(record: IndexableRecord): Promise<void> {\n    const strategies = await this.getAvailableStrategies()\n\n    if (strategies.length === 0) {\n      return\n    }\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => this.executeStrategyIndex(strategy, record)),\n    )\n\n    // Log any failures\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        searchError('SearchService', 'Strategy index failed', {\n          strategyId: strategy?.id,\n          entityId: record.entityId,\n          recordId: record.recordId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n  }\n\n  /**\n   * Delete a record from all strategies.\n   *\n   * @param entityId - Entity type identifier\n   * @param recordId - Record primary key\n   * @param tenantId - Tenant for isolation\n   */\n  async delete(entityId: string, recordId: string, tenantId: string): Promise<void> {\n    const strategies = await this.getAvailableStrategies()\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => this.executeStrategyDelete(strategy, entityId, recordId, tenantId)),\n    )\n\n    // Log any failures\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        searchError('SearchService', 'Strategy delete failed', {\n          strategyId: strategy?.id,\n          entityId,\n          recordId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n  }\n\n  /**\n   * Bulk index multiple records.\n   *\n   * @param records - Records to index\n   */\n  async bulkIndex(records: IndexableRecord[]): Promise<void> {\n    if (records.length === 0) return\n\n    const strategies = await this.getAvailableStrategies()\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => {\n        if (strategy.bulkIndex) {\n          return strategy.bulkIndex(records)\n        }\n        // Fallback to individual indexing\n        return Promise.all(records.map((record) => this.executeStrategyIndex(strategy, record)))\n      }),\n    )\n\n    // Collect failures and throw if any occurred\n    const failures: Array<{ strategyId: string; error: string }> = []\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        const errorMessage = result.reason instanceof Error ? result.reason.message : result.reason\n        failures.push({\n          strategyId: strategy?.id || 'unknown',\n          error: errorMessage,\n        })\n        searchError('SearchService', 'Strategy bulkIndex failed', {\n          strategyId: strategy?.id,\n          recordCount: records.length,\n          error: errorMessage,\n        })\n      }\n    }\n\n    if (failures.length > 0) {\n      throw new Error(\n        `Bulk indexing failed for ${failures.length} strategy(ies): ${failures\n          .map((f) => `${f.strategyId} (${f.error})`)\n          .join(', ')}`\n      )\n    }\n  }\n\n  /**\n   * Purge all records for an entity type.\n   *\n   * @param entityId - Entity type to purge\n   * @param tenantId - Tenant for isolation\n   */\n  async purge(entityId: string, tenantId: string): Promise<void> {\n    const strategies = await this.getAvailableStrategies()\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => {\n        if (strategy.purge) {\n          return strategy.purge(entityId, tenantId)\n        }\n        return Promise.resolve()\n      }),\n    )\n\n    // Log any failures\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        searchError('SearchService', 'Strategy purge failed', {\n          strategyId: strategy?.id,\n          entityId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n  }\n\n  /**\n   * Register a new strategy at runtime.\n   *\n   * @param strategy - Strategy to register\n   */\n  registerStrategy(strategy: SearchStrategy): void {\n    this.strategies.set(strategy.id, strategy)\n  }\n\n  /**\n   * Unregister a strategy.\n   *\n   * @param strategyId - Strategy ID to remove\n   */\n  unregisterStrategy(strategyId: SearchStrategyId): void {\n    this.strategies.delete(strategyId)\n  }\n\n  /**\n   * Get all registered strategy IDs.\n   */\n  getRegisteredStrategies(): SearchStrategyId[] {\n    return Array.from(this.strategies.keys())\n  }\n\n  /**\n   * Get a specific strategy by ID.\n   *\n   * @param strategyId - Strategy ID to retrieve\n   * @returns The strategy if registered, undefined otherwise\n   */\n  getStrategy(strategyId: SearchStrategyId): SearchStrategy | undefined {\n    return this.strategies.get(strategyId)\n  }\n\n  /**\n   * Get the default strategies list.\n   */\n  getDefaultStrategies(): SearchStrategyId[] {\n    return [...this.defaultStrategies]\n  }\n\n  /**\n   * Check if a specific strategy is available.\n   *\n   * @param strategyId - Strategy ID to check\n   */\n  async isStrategyAvailable(strategyId: SearchStrategyId): Promise<boolean> {\n    const strategy = this.strategies.get(strategyId)\n    if (!strategy) return false\n    return strategy.isAvailable()\n  }\n\n  /**\n   * Get available strategies from the requested list.\n   * Filters out strategies that are not registered or not available.\n   */\n  private async getAvailableStrategies(ids?: SearchStrategyId[]): Promise<SearchStrategy[]> {\n    const targetIds = ids ?? Array.from(this.strategies.keys())\n    const available: SearchStrategy[] = []\n\n    for (const id of targetIds) {\n      const strategy = this.strategies.get(id)\n      if (strategy) {\n        try {\n          const isAvailable = await strategy.isAvailable()\n          if (isAvailable) {\n            available.push(strategy)\n          }\n        } catch {\n          // Strategy availability check failed, skip it\n        }\n      }\n    }\n\n    // Sort by priority (higher priority first)\n    return available.sort((a, b) => b.priority - a.priority)\n  }\n\n  /**\n   * Execute search on a single strategy with error handling.\n   */\n  private async executeStrategySearch(\n    strategy: SearchStrategy,\n    query: string,\n    options: SearchOptions,\n  ): Promise<SearchResult[]> {\n    await strategy.ensureReady()\n    return strategy.search(query, options)\n  }\n\n  /**\n   * Execute index on a single strategy with error handling.\n   */\n  private async executeStrategyIndex(\n    strategy: SearchStrategy,\n    record: IndexableRecord,\n  ): Promise<void> {\n    await strategy.ensureReady()\n    return strategy.index(record)\n  }\n\n  /**\n   * Execute delete on a single strategy with error handling.\n   */\n  private async executeStrategyDelete(\n    strategy: SearchStrategy,\n    entityId: string,\n    recordId: string,\n    tenantId: string,\n  ): Promise<void> {\n    await strategy.ensureReady()\n    return strategy.delete(entityId, recordId, tenantId)\n  }\n}\n"],
-  "mappings": "AAUA,SAAS,2BAA2B;AACpC,SAAS,mBAAmB;AAC5B,SAAS,mCAAmC;AAK5C,MAAM,uBAA0C;AAAA,EAC9C,mBAAmB;AACrB;AA0BO,MAAM,cAAc;AAAA,EAOzB,YAAY,UAAgC,CAAC,GAAG;AAC9C,SAAK,aAAa,oBAAI,IAAI;AAC1B,eAAW,YAAY,QAAQ,cAAc,CAAC,GAAG;AAC/C,WAAK,WAAW,IAAI,SAAS,IAAI,QAAQ;AAAA,IAC3C;AACA,SAAK,oBAAoB,QAAQ,qBAAqB,CAAC,QAAQ;AAC/D,SAAK,mBAAmB,QAAQ;AAChC,SAAK,cAAc,QAAQ,eAAe;AAC1C,SAAK,oBAAoB,QAAQ;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,gBAAkC;AAChC,WAAO,MAAM,KAAK,KAAK,WAAW,OAAO,CAAC;AAAA,EAC5C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAO,OAAe,SAAiD;AAC3E,UAAM,cAAc,QAAQ,cAAc,KAAK;AAC/C,UAAM,mBAAmB,MAAM,KAAK,uBAAuB,WAAW;AAEtE,QAAI,iBAAiB,WAAW,GAAG;AAEjC,UAAI,KAAK,kBAAkB;AACzB,cAAM,WAAW,MAAM,KAAK,uBAAuB,CAAC,KAAK,gBAAgB,CAAC;AAC1E,YAAI,SAAS,SAAS,GAAG;AACvB,2BAAiB,KAAK,GAAG,QAAQ;AAAA,QACnC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,iBAAiB,WAAW,GAAG;AACjC,aAAO,CAAC;AAAA,IACV;AAGA,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,iBAAiB,IAAI,CAAC,aAAa,KAAK,sBAAsB,UAAU,OAAO,OAAO,CAAC;AAAA,IACzF;AAGA,UAAM,aAA6B,CAAC;AACpC,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,YAAM,SAAS,QAAQ,CAAC;AACxB,UAAI,OAAO,WAAW,aAAa;AACjC,mBAAW,KAAK,GAAG,OAAO,KAAK;AAAA,MACjC,OAAO;AACL,cAAM,WAAW,iBAAiB,CAAC;AACnC,oBAAY,iBAAiB,0BAA0B;AAAA,UACrD,YAAY,UAAU;AAAA,UACtB,OAAO,OAAO,kBAAkB,QAAQ,OAAO,OAAO,UAAU,OAAO;AAAA,QACzE,CAAC;AAAA,MACH;AAAA,IACF;AAGA,UAAM,SAAS,oBAAoB,YAAY,KAAK,WAAW;AAG/D,WAAO,KAAK,2BAA2B,QAAQ,QAAQ,UAAU,QAAQ,cAAc;AAAA,EACzF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,2BACZ,SACA,UACA,gBACyB;AAEzB,QAAI,CAAC,KAAK,kBAAmB,QAAO;AAEpC,UAAM,aAAa,QAAQ,KAAK,2BAA2B;AAC3D,QAAI,CAAC,WAAY,QAAO;AAGxB,QAAI;AACF,aAAO,MAAM,KAAK,kBAAkB,SAAS,UAAU,cAAc;AAAA,IACvE,QAAQ;AAEN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAM,QAAwC;AAClD,UAAM,aAAa,MAAM,KAAK,uBAAuB;AAErD,QAAI,WAAW,WAAW,GAAG;AAC3B;AAAA,IACF;AAEA,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,WAAW,IAAI,CAAC,aAAa,KAAK,qBAAqB,UAAU,MAAM,CAAC;AAAA,IAC1E;AAGA,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,YAAM,SAAS,QAAQ,CAAC;AACxB,UAAI,OAAO,WAAW,YAAY;AAChC,cAAM,WAAW,WAAW,CAAC;AAC7B,oBAAY,iBAAiB,yBAAyB;AAAA,UACpD,YAAY,UAAU;AAAA,UACtB,UAAU,OAAO;AAAA,UACjB,UAAU,OAAO;AAAA,UACjB,OAAO,OAAO,kBAAkB,QAAQ,OAAO,OAAO,UAAU,OAAO;AAAA,QACzE,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,OAAO,UAAkB,UAAkB,UAAiC;AAChF,UAAM,aAAa,MAAM,KAAK,uBAAuB;AAErD,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,WAAW,IAAI,CAAC,aAAa,KAAK,sBAAsB,UAAU,UAAU,UAAU,QAAQ,CAAC;AAAA,IACjG;AAGA,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,YAAM,SAAS,QAAQ,CAAC;AACxB,UAAI,OAAO,WAAW,YAAY;AAChC,cAAM,WAAW,WAAW,CAAC;AAC7B,oBAAY,iBAAiB,0BAA0B;AAAA,UACrD,YAAY,UAAU;AAAA,UACtB;AAAA,UACA;AAAA,UACA,OAAO,OAAO,kBAAkB,QAAQ,OAAO,OAAO,UAAU,OAAO;AAAA,QACzE,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,UAAU,SAA2C;AACzD,QAAI,QAAQ,WAAW,EAAG;AAE1B,UAAM,aAAa,MAAM,KAAK,uBAAuB;AAErD,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,WAAW,IAAI,CAAC,aAAa;AAC3B,YAAI,SAAS,WAAW;AACtB,iBAAO,SAAS,UAAU,OAAO;AAAA,QACnC;AAEA,eAAO,QAAQ,IAAI,QAAQ,IAAI,CAAC,WAAW,KAAK,qBAAqB,UAAU,MAAM,CAAC,CAAC;AAAA,MACzF,CAAC;AAAA,IACH;AAGA,UAAM,WAAyD,CAAC;AAChE,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,YAAM,SAAS,QAAQ,CAAC;AACxB,UAAI,OAAO,WAAW,YAAY;AAChC,cAAM,WAAW,WAAW,CAAC;AAC7B,cAAM,eAAe,OAAO,kBAAkB,QAAQ,OAAO,OAAO,UAAU,OAAO;AACrF,iBAAS,KAAK;AAAA,UACZ,YAAY,UAAU,MAAM;AAAA,UAC5B,OAAO;AAAA,QACT,CAAC;AACD,oBAAY,iBAAiB,6BAA6B;AAAA,UACxD,YAAY,UAAU;AAAA,UACtB,aAAa,QAAQ;AAAA,UACrB,OAAO;AAAA,QACT,CAAC;AAAA,MACH;AAAA,IACF;AAEA,QAAI,SAAS,SAAS,GAAG;AACvB,YAAM,IAAI;AAAA,QACR,4BAA4B,SAAS,MAAM,mBAAmB,SAC3D,IAAI,CAAC,MAAM,GAAG,EAAE,UAAU,KAAK,EAAE,KAAK,GAAG,EACzC,KAAK,IAAI,CAAC;AAAA,MACf;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,MAAM,MAAM,UAAkB,UAAiC;AAC7D,UAAM,aAAa,MAAM,KAAK,uBAAuB;AAErD,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,WAAW,IAAI,CAAC,aAAa;AAC3B,YAAI,SAAS,OAAO;AAClB,iBAAO,SAAS,MAAM,UAAU,QAAQ;AAAA,QAC1C;AACA,eAAO,QAAQ,QAAQ;AAAA,MACzB,CAAC;AAAA,IACH;AAGA,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,YAAM,SAAS,QAAQ,CAAC;AACxB,UAAI,OAAO,WAAW,YAAY;AAChC,cAAM,WAAW,WAAW,CAAC;AAC7B,oBAAY,iBAAiB,yBAAyB;AAAA,UACpD,YAAY,UAAU;AAAA,UACtB;AAAA,UACA,OAAO,OAAO,kBAAkB,QAAQ,OAAO,OAAO,UAAU,OAAO;AAAA,QACzE,CAAC;AAAA,MACH;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,iBAAiB,UAAgC;AAC/C,SAAK,WAAW,IAAI,SAAS,IAAI,QAAQ;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,mBAAmB,YAAoC;AACrD,SAAK,WAAW,OAAO,UAAU;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA,EAKA,0BAA8C;AAC5C,WAAO,MAAM,KAAK,KAAK,WAAW,KAAK,CAAC;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,YAAY,YAA0D;AACpE,WAAO,KAAK,WAAW,IAAI,UAAU;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,uBAA2C;AACzC,WAAO,CAAC,GAAG,KAAK,iBAAiB;AAAA,EACnC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,oBAAoB,YAAgD;AACxE,UAAM,WAAW,KAAK,WAAW,IAAI,UAAU;AAC/C,QAAI,CAAC,SAAU,QAAO;AACtB,WAAO,SAAS,YAAY;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAc,uBAAuB,KAAqD;AACxF,UAAM,YAAY,OAAO,MAAM,KAAK,KAAK,WAAW,KAAK,CAAC;AAC1D,UAAM,YAA8B,CAAC;AAErC,eAAW,MAAM,WAAW;AAC1B,YAAM,WAAW,KAAK,WAAW,IAAI,EAAE;AACvC,UAAI,UAAU;AACZ,YAAI;AACF,gBAAM,cAAc,MAAM,SAAS,YAAY;AAC/C,cAAI,aAAa;AACf,sBAAU,KAAK,QAAQ;AAAA,UACzB;AAAA,QACF,QAAQ;AAAA,QAER;AAAA,MACF;AAAA,IACF;AAGA,WAAO,UAAU,KAAK,CAAC,GAAG,MAAM,EAAE,WAAW,EAAE,QAAQ;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,sBACZ,UACA,OACA,SACyB;AACzB,UAAM,SAAS,YAAY;AAC3B,WAAO,SAAS,OAAO,OAAO,OAAO;AAAA,EACvC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,qBACZ,UACA,QACe;AACf,UAAM,SAAS,YAAY;AAC3B,WAAO,SAAS,MAAM,MAAM;AAAA,EAC9B;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,sBACZ,UACA,UACA,UACA,UACe;AACf,UAAM,SAAS,YAAY;AAC3B,WAAO,SAAS,OAAO,UAAU,UAAU,QAAQ;AAAA,EACrD;AACF;",
+  "sourcesContent": ["import type {\n  SearchStrategy,\n  SearchStrategyId,\n  SearchOptions,\n  SearchResult,\n  SearchServiceOptions,\n  ResultMergeConfig,\n  IndexableRecord,\n  PresenterEnricherFn,\n} from './types'\nimport { mergeAndRankResults } from './lib/merger'\nimport { searchError } from './lib/debug'\nimport { needsSearchResultEnrichment } from './lib/search-result-enrichment'\n\n/**\n * Default merge configuration.\n */\nconst DEFAULT_MERGE_CONFIG: ResultMergeConfig = {\n  duplicateHandling: 'highest_score',\n}\n\n/**\n * Cache TTL for strategy availability checks.\n * Short window so connectivity changes (Meilisearch up/down) propagate quickly,\n * long enough to skip per-request RTT to remote backends on hot paths.\n */\nconst STRATEGY_AVAILABILITY_CACHE_TTL_MS = 2_000\n\n/**\n * SearchService orchestrates multiple search strategies, executing searches in parallel\n * and merging results using the RRF algorithm.\n *\n * Features:\n * - Parallel strategy execution for optimal performance\n * - Graceful degradation when strategies fail\n * - Result merging with configurable weights\n * - Strategy availability checking\n *\n * @example\n * ```typescript\n * const service = new SearchService({\n *   strategies: [tokenStrategy, vectorStrategy, fulltextStrategy],\n *   defaultStrategies: ['fulltext', 'vector', 'tokens'],\n *   mergeConfig: {\n *     duplicateHandling: 'highest_score',\n *     strategyWeights: { fulltext: 1.2, vector: 1.0, tokens: 0.8 },\n *   },\n * })\n *\n * const results = await service.search('john doe', { tenantId: 'tenant-123' })\n * ```\n */\nexport class SearchService {\n  private readonly strategies: Map<SearchStrategyId, SearchStrategy>\n  private readonly defaultStrategies: SearchStrategyId[]\n  private readonly fallbackStrategy: SearchStrategyId | undefined\n  private readonly mergeConfig: ResultMergeConfig\n  private readonly presenterEnricher?: PresenterEnricherFn\n  private readonly availabilityCache = new Map<SearchStrategyId, { value: boolean; expiresAt: number }>()\n  private readonly availabilityInflight = new Map<SearchStrategyId, Promise<boolean>>()\n  private readonly availabilityCacheTtlMs: number\n\n  constructor(options: SearchServiceOptions = {}) {\n    this.strategies = new Map()\n    for (const strategy of options.strategies ?? []) {\n      this.strategies.set(strategy.id, strategy)\n    }\n    this.defaultStrategies = options.defaultStrategies ?? ['tokens']\n    this.fallbackStrategy = options.fallbackStrategy\n    this.mergeConfig = options.mergeConfig ?? DEFAULT_MERGE_CONFIG\n    this.presenterEnricher = options.presenterEnricher\n    this.availabilityCacheTtlMs = options.availabilityCacheTtlMs ?? STRATEGY_AVAILABILITY_CACHE_TTL_MS\n  }\n\n  /**\n   * Get all registered strategies.\n   */\n  getStrategies(): SearchStrategy[] {\n    return Array.from(this.strategies.values())\n  }\n\n  /**\n   * Execute a search query across configured strategies.\n   *\n   * @param query - Search query string\n   * @param options - Search options with tenant, filters, etc.\n   * @returns Merged and ranked search results\n   */\n  async search(query: string, options: SearchOptions): Promise<SearchResult[]> {\n    const strategyIds = options.strategies ?? this.defaultStrategies\n    const activeStrategies = await this.getAvailableStrategies(strategyIds)\n\n    if (activeStrategies.length === 0) {\n      // Try fallback strategy if defined\n      if (this.fallbackStrategy) {\n        const fallback = await this.getAvailableStrategies([this.fallbackStrategy])\n        if (fallback.length > 0) {\n          activeStrategies.push(...fallback)\n        }\n      }\n    }\n\n    if (activeStrategies.length === 0) {\n      return []\n    }\n\n    // Execute searches in parallel with graceful degradation\n    const results = await Promise.allSettled(\n      activeStrategies.map((strategy) => this.executeStrategySearch(strategy, query, options)),\n    )\n\n    // Collect successful results, log failures\n    const allResults: SearchResult[] = []\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'fulfilled') {\n        allResults.push(...result.value)\n      } else {\n        const strategy = activeStrategies[i]\n        searchError('SearchService', 'Strategy search failed', {\n          strategyId: strategy?.id,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n\n    // Merge and rank results\n    const merged = mergeAndRankResults(allResults, this.mergeConfig)\n\n    // Enrich results missing presenter or navigation metadata\n    return this.enrichResultsWithPresenter(merged, options.tenantId, options.organizationId)\n  }\n\n  /**\n   * Enrich results that are missing presenter data using the configured enricher.\n   * This ensures token-only results get proper titles/subtitles for display.\n   */\n  private async enrichResultsWithPresenter(\n    results: SearchResult[],\n    tenantId: string,\n    organizationId?: string | null,\n  ): Promise<SearchResult[]> {\n    // If no enricher configured, return as-is\n    if (!this.presenterEnricher) return results\n\n    const hasMissing = results.some(needsSearchResultEnrichment)\n    if (!hasMissing) return results\n\n    // Use the configured presenter enricher\n    try {\n      return await this.presenterEnricher(results, tenantId, organizationId)\n    } catch {\n      // Enrichment failed, return results as-is\n      return results\n    }\n  }\n\n  /**\n   * Index a record across all available strategies.\n   *\n   * @param record - Record to index\n   */\n  async index(record: IndexableRecord): Promise<void> {\n    const strategies = await this.getAvailableStrategies()\n\n    if (strategies.length === 0) {\n      return\n    }\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => this.executeStrategyIndex(strategy, record)),\n    )\n\n    // Log any failures\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        searchError('SearchService', 'Strategy index failed', {\n          strategyId: strategy?.id,\n          entityId: record.entityId,\n          recordId: record.recordId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n  }\n\n  /**\n   * Delete a record from all strategies.\n   *\n   * @param entityId - Entity type identifier\n   * @param recordId - Record primary key\n   * @param tenantId - Tenant for isolation\n   */\n  async delete(entityId: string, recordId: string, tenantId: string): Promise<void> {\n    const strategies = await this.getAvailableStrategies()\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => this.executeStrategyDelete(strategy, entityId, recordId, tenantId)),\n    )\n\n    // Log any failures\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        searchError('SearchService', 'Strategy delete failed', {\n          strategyId: strategy?.id,\n          entityId,\n          recordId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n  }\n\n  /**\n   * Bulk index multiple records.\n   *\n   * @param records - Records to index\n   */\n  async bulkIndex(records: IndexableRecord[]): Promise<void> {\n    if (records.length === 0) return\n\n    const strategies = await this.getAvailableStrategies()\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => {\n        if (strategy.bulkIndex) {\n          return strategy.bulkIndex(records)\n        }\n        // Fallback to individual indexing\n        return Promise.all(records.map((record) => this.executeStrategyIndex(strategy, record)))\n      }),\n    )\n\n    // Collect failures and throw if any occurred\n    const failures: Array<{ strategyId: string; error: string }> = []\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        const errorMessage = result.reason instanceof Error ? result.reason.message : result.reason\n        failures.push({\n          strategyId: strategy?.id || 'unknown',\n          error: errorMessage,\n        })\n        searchError('SearchService', 'Strategy bulkIndex failed', {\n          strategyId: strategy?.id,\n          recordCount: records.length,\n          error: errorMessage,\n        })\n      }\n    }\n\n    if (failures.length > 0) {\n      throw new Error(\n        `Bulk indexing failed for ${failures.length} strategy(ies): ${failures\n          .map((f) => `${f.strategyId} (${f.error})`)\n          .join(', ')}`\n      )\n    }\n  }\n\n  /**\n   * Purge all records for an entity type.\n   *\n   * @param entityId - Entity type to purge\n   * @param tenantId - Tenant for isolation\n   */\n  async purge(entityId: string, tenantId: string): Promise<void> {\n    const strategies = await this.getAvailableStrategies()\n\n    const results = await Promise.allSettled(\n      strategies.map((strategy) => {\n        if (strategy.purge) {\n          return strategy.purge(entityId, tenantId)\n        }\n        return Promise.resolve()\n      }),\n    )\n\n    // Log any failures\n    for (let i = 0; i < results.length; i++) {\n      const result = results[i]\n      if (result.status === 'rejected') {\n        const strategy = strategies[i]\n        searchError('SearchService', 'Strategy purge failed', {\n          strategyId: strategy?.id,\n          entityId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n  }\n\n  /**\n   * Register a new strategy at runtime.\n   *\n   * @param strategy - Strategy to register\n   */\n  registerStrategy(strategy: SearchStrategy): void {\n    this.strategies.set(strategy.id, strategy)\n    this.availabilityCache.delete(strategy.id)\n    this.availabilityInflight.delete(strategy.id)\n  }\n\n  /**\n   * Unregister a strategy.\n   *\n   * @param strategyId - Strategy ID to remove\n   */\n  unregisterStrategy(strategyId: SearchStrategyId): void {\n    this.strategies.delete(strategyId)\n    this.availabilityCache.delete(strategyId)\n    this.availabilityInflight.delete(strategyId)\n  }\n\n  /**\n   * Invalidate the strategy availability cache.\n   * Call after manual reconnects or env changes when callers must observe the\n   * current backend state immediately rather than waiting for TTL expiry.\n   */\n  invalidateAvailabilityCache(strategyId?: SearchStrategyId): void {\n    if (strategyId) {\n      this.availabilityCache.delete(strategyId)\n      this.availabilityInflight.delete(strategyId)\n      return\n    }\n    this.availabilityCache.clear()\n    this.availabilityInflight.clear()\n  }\n\n  /**\n   * Get all registered strategy IDs.\n   */\n  getRegisteredStrategies(): SearchStrategyId[] {\n    return Array.from(this.strategies.keys())\n  }\n\n  /**\n   * Get a specific strategy by ID.\n   *\n   * @param strategyId - Strategy ID to retrieve\n   * @returns The strategy if registered, undefined otherwise\n   */\n  getStrategy(strategyId: SearchStrategyId): SearchStrategy | undefined {\n    return this.strategies.get(strategyId)\n  }\n\n  /**\n   * Get the default strategies list.\n   */\n  getDefaultStrategies(): SearchStrategyId[] {\n    return [...this.defaultStrategies]\n  }\n\n  /**\n   * Check if a specific strategy is available.\n   *\n   * @param strategyId - Strategy ID to check\n   */\n  async isStrategyAvailable(strategyId: SearchStrategyId): Promise<boolean> {\n    const strategy = this.strategies.get(strategyId)\n    if (!strategy) return false\n    return this.checkStrategyAvailability(strategy)\n  }\n\n  /**\n   * Resolve a strategy's availability via the short-lived TTL cache.\n   * Coalesces concurrent callers onto a single in-flight probe to avoid\n   * thundering-herd on remote backends.\n   */\n  private async checkStrategyAvailability(strategy: SearchStrategy): Promise<boolean> {\n    const now = Date.now()\n    const cached = this.availabilityCache.get(strategy.id)\n    if (cached && cached.expiresAt > now) return cached.value\n\n    const inflight = this.availabilityInflight.get(strategy.id)\n    if (inflight) return inflight\n\n    const probe = (async () => {\n      try {\n        const value = await strategy.isAvailable()\n        this.availabilityCache.set(strategy.id, {\n          value,\n          expiresAt: Date.now() + this.availabilityCacheTtlMs,\n        })\n        return value\n      } catch {\n        this.availabilityCache.set(strategy.id, {\n          value: false,\n          expiresAt: Date.now() + this.availabilityCacheTtlMs,\n        })\n        return false\n      } finally {\n        this.availabilityInflight.delete(strategy.id)\n      }\n    })()\n    this.availabilityInflight.set(strategy.id, probe)\n    return probe\n  }\n\n  /**\n   * Get available strategies from the requested list.\n   * Filters out strategies that are not registered or not available.\n   * Probes run in parallel and reuse a short-lived per-strategy availability\n   * cache, so hot paths pay the max latency of the slowest probe (or zero\n   * when cached) instead of the sum of all probes.\n   */\n  private async getAvailableStrategies(ids?: SearchStrategyId[]): Promise<SearchStrategy[]> {\n    const targetIds = ids ?? Array.from(this.strategies.keys())\n    const candidates: SearchStrategy[] = []\n    for (const id of targetIds) {\n      const strategy = this.strategies.get(id)\n      if (strategy) candidates.push(strategy)\n    }\n\n    const probes = await Promise.allSettled(\n      candidates.map((strategy) => this.checkStrategyAvailability(strategy)),\n    )\n\n    const available: SearchStrategy[] = []\n    for (let i = 0; i < probes.length; i++) {\n      const probe = probes[i]\n      if (probe.status === 'fulfilled' && probe.value) {\n        available.push(candidates[i])\n      }\n    }\n\n    return available.sort((a, b) => b.priority - a.priority)\n  }\n\n  /**\n   * Execute search on a single strategy with error handling.\n   */\n  private async executeStrategySearch(\n    strategy: SearchStrategy,\n    query: string,\n    options: SearchOptions,\n  ): Promise<SearchResult[]> {\n    await strategy.ensureReady()\n    return strategy.search(query, options)\n  }\n\n  /**\n   * Execute index on a single strategy with error handling.\n   */\n  private async executeStrategyIndex(\n    strategy: SearchStrategy,\n    record: IndexableRecord,\n  ): Promise<void> {\n    await strategy.ensureReady()\n    return strategy.index(record)\n  }\n\n  /**\n   * Execute delete on a single strategy with error handling.\n   */\n  private async executeStrategyDelete(\n    strategy: SearchStrategy,\n    entityId: string,\n    recordId: string,\n    tenantId: string,\n  ): Promise<void> {\n    await strategy.ensureReady()\n    return strategy.delete(entityId, recordId, tenantId)\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-mercato/search",
-  "version": "0.4.11-develop.2543.c880fff2e7",
+  "version": "0.4.11-develop.2575.e689a7bd59",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -126,9 +126,9 @@
     "zod": "^4.0.0"
   },
   "peerDependencies": {
-    "@open-mercato/core": "0.4.11-develop.2543.c880fff2e7",
-    "@open-mercato/queue": "0.4.11-develop.2543.c880fff2e7",
-    "@open-mercato/shared": "0.4.11-develop.2543.c880fff2e7"
+    "@open-mercato/core": "0.4.11-develop.2575.e689a7bd59",
+    "@open-mercato/queue": "0.4.11-develop.2575.e689a7bd59",
+    "@open-mercato/shared": "0.4.11-develop.2575.e689a7bd59"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",

package/src/__tests__/service.test.ts

@@ -416,4 +416,167 @@ describe('SearchService', () => {
       expect(strategyWithPurge.purge).toHaveBeenCalledWith('test:entity', 'tenant-123')
     })
   })
+
+  describe('availability checks (issue #1404)', () => {
+    it('runs strategy availability probes in parallel, not sequentially', async () => {
+      const probeTimings: Record<string, { start: number; end: number }> = {}
+      const makeSlowStrategy = (id: string, delayMs: number) =>
+        createMockStrategy({
+          id,
+          isAvailable: jest.fn().mockImplementation(async () => {
+            const start = Date.now()
+            await new Promise((resolve) => setTimeout(resolve, delayMs))
+            probeTimings[id] = { start, end: Date.now() }
+            return true
+          }),
+          search: jest.fn().mockResolvedValue([]),
+        })
+
+      const slowA = makeSlowStrategy('slow-a', 60)
+      const slowB = makeSlowStrategy('slow-b', 60)
+      const slowC = makeSlowStrategy('slow-c', 60)
+      const service = new SearchService({
+        strategies: [slowA, slowB, slowC],
+        defaultStrategies: ['slow-a', 'slow-b', 'slow-c'],
+        availabilityCacheTtlMs: 0,
+      })
+
+      const start = Date.now()
+      await service.search('q', { tenantId: 't-1' })
+      const elapsed = Date.now() - start
+
+      // Sequential would be ~180ms; parallel should land near the slowest probe.
+      expect(elapsed).toBeLessThan(150)
+      expect(slowA.isAvailable).toHaveBeenCalledTimes(1)
+      expect(slowB.isAvailable).toHaveBeenCalledTimes(1)
+      expect(slowC.isAvailable).toHaveBeenCalledTimes(1)
+    })
+
+    it('caches positive availability checks within the TTL window', async () => {
+      const strategy = createMockStrategy({
+        id: 'cached',
+        isAvailable: jest.fn().mockResolvedValue(true),
+        search: jest.fn().mockResolvedValue([]),
+      })
+      const service = new SearchService({
+        strategies: [strategy],
+        defaultStrategies: ['cached'],
+        availabilityCacheTtlMs: 60_000,
+      })
+
+      await service.search('q', { tenantId: 't-1' })
+      await service.search('q', { tenantId: 't-1' })
+      await service.search('q', { tenantId: 't-1' })
+
+      expect(strategy.isAvailable).toHaveBeenCalledTimes(1)
+    })
+
+    it('caches negative availability checks within the TTL window', async () => {
+      const strategy = createMockStrategy({
+        id: 'down',
+        isAvailable: jest.fn().mockResolvedValue(false),
+        search: jest.fn().mockResolvedValue([]),
+      })
+      const service = new SearchService({
+        strategies: [strategy],
+        defaultStrategies: ['down'],
+        availabilityCacheTtlMs: 60_000,
+      })
+
+      await service.search('q', { tenantId: 't-1' })
+      await service.search('q', { tenantId: 't-1' })
+
+      expect(strategy.isAvailable).toHaveBeenCalledTimes(1)
+    })
+
+    it('caches thrown availability errors as unavailable within the TTL window', async () => {
+      const strategy = createMockStrategy({
+        id: 'flaky',
+        isAvailable: jest.fn().mockRejectedValue(new Error('boom')),
+        search: jest.fn().mockResolvedValue([]),
+      })
+      const service = new SearchService({
+        strategies: [strategy],
+        defaultStrategies: ['flaky'],
+        availabilityCacheTtlMs: 60_000,
+      })
+
+      const r1 = await service.search('q', { tenantId: 't-1' })
+      const r2 = await service.search('q', { tenantId: 't-1' })
+
+      expect(r1).toEqual([])
+      expect(r2).toEqual([])
+      expect(strategy.isAvailable).toHaveBeenCalledTimes(1)
+      expect(strategy.search).not.toHaveBeenCalled()
+    })
+
+    it('coalesces concurrent probes of the same strategy onto a single in-flight call', async () => {
+      let resolveProbe: ((value: boolean) => void) | undefined
+      const strategy = createMockStrategy({
+        id: 'coalesced',
+        isAvailable: jest.fn().mockImplementation(
+          () =>
+            new Promise<boolean>((resolve) => {
+              resolveProbe = resolve
+            }),
+        ),
+        search: jest.fn().mockResolvedValue([]),
+      })
+      const service = new SearchService({
+        strategies: [strategy],
+        defaultStrategies: ['coalesced'],
+        availabilityCacheTtlMs: 0,
+      })
+
+      const p1 = service.search('q', { tenantId: 't-1' })
+      const p2 = service.search('q', { tenantId: 't-1' })
+      const p3 = service.isStrategyAvailable('coalesced')
+
+      // Wait a tick so all three callers register their probes.
+      await new Promise((resolve) => setTimeout(resolve, 5))
+      resolveProbe?.(true)
+      await Promise.all([p1, p2, p3])
+
+      expect(strategy.isAvailable).toHaveBeenCalledTimes(1)
+    })
+
+    it('invalidates the availability cache on demand', async () => {
+      const strategy = createMockStrategy({
+        id: 'invalidated',
+        isAvailable: jest.fn().mockResolvedValue(true),
+        search: jest.fn().mockResolvedValue([]),
+      })
+      const service = new SearchService({
+        strategies: [strategy],
+        defaultStrategies: ['invalidated'],
+        availabilityCacheTtlMs: 60_000,
+      })
+
+      await service.search('q', { tenantId: 't-1' })
+      service.invalidateAvailabilityCache('invalidated')
+      await service.search('q', { tenantId: 't-1' })
+
+      expect(strategy.isAvailable).toHaveBeenCalledTimes(2)
+    })
+
+    it('invalidates cached availability when a strategy is unregistered and re-registered', async () => {
+      const strategy = createMockStrategy({
+        id: 'reregistered',
+        isAvailable: jest.fn().mockResolvedValue(true),
+        search: jest.fn().mockResolvedValue([]),
+      })
+      const service = new SearchService({
+        strategies: [strategy],
+        defaultStrategies: ['reregistered'],
+        availabilityCacheTtlMs: 60_000,
+      })
+
+      await service.search('q', { tenantId: 't-1' })
+      service.unregisterStrategy('reregistered')
+      service.registerStrategy(strategy)
+      await service.search('q', { tenantId: 't-1' })
+
+      expect(strategy.isAvailable).toHaveBeenCalledTimes(2)
+    })
+  })
 })

package/src/service.ts

@@ -19,6 +19,13 @@ const DEFAULT_MERGE_CONFIG: ResultMergeConfig = {
   duplicateHandling: 'highest_score',
 }
 
+/**
+ * Cache TTL for strategy availability checks.
+ * Short window so connectivity changes (Meilisearch up/down) propagate quickly,
+ * long enough to skip per-request RTT to remote backends on hot paths.
+ */
+const STRATEGY_AVAILABILITY_CACHE_TTL_MS = 2_000
+
 /**
  * SearchService orchestrates multiple search strategies, executing searches in parallel
  * and merging results using the RRF algorithm.
@@ -49,6 +56,9 @@ export class SearchService {
   private readonly fallbackStrategy: SearchStrategyId | undefined
   private readonly mergeConfig: ResultMergeConfig
   private readonly presenterEnricher?: PresenterEnricherFn
+  private readonly availabilityCache = new Map<SearchStrategyId, { value: boolean; expiresAt: number }>()
+  private readonly availabilityInflight = new Map<SearchStrategyId, Promise<boolean>>()
+  private readonly availabilityCacheTtlMs: number
 
   constructor(options: SearchServiceOptions = {}) {
     this.strategies = new Map()
@@ -59,6 +69,7 @@ export class SearchService {
     this.fallbackStrategy = options.fallbackStrategy
     this.mergeConfig = options.mergeConfig ?? DEFAULT_MERGE_CONFIG
     this.presenterEnricher = options.presenterEnricher
+    this.availabilityCacheTtlMs = options.availabilityCacheTtlMs ?? STRATEGY_AVAILABILITY_CACHE_TTL_MS
   }
 
   /**
@@ -291,6 +302,8 @@ export class SearchService {
    */
   registerStrategy(strategy: SearchStrategy): void {
     this.strategies.set(strategy.id, strategy)
+    this.availabilityCache.delete(strategy.id)
+    this.availabilityInflight.delete(strategy.id)
   }
 
   /**
@@ -300,6 +313,23 @@ export class SearchService {
    */
   unregisterStrategy(strategyId: SearchStrategyId): void {
     this.strategies.delete(strategyId)
+    this.availabilityCache.delete(strategyId)
+    this.availabilityInflight.delete(strategyId)
+  }
+
+  /**
+   * Invalidate the strategy availability cache.
+   * Call after manual reconnects or env changes when callers must observe the
+   * current backend state immediately rather than waiting for TTL expiry.
+   */
+  invalidateAvailabilityCache(strategyId?: SearchStrategyId): void {
+    if (strategyId) {
+      this.availabilityCache.delete(strategyId)
+      this.availabilityInflight.delete(strategyId)
+      return
+    }
+    this.availabilityCache.clear()
+    this.availabilityInflight.clear()
   }
 
   /**
@@ -334,32 +364,71 @@ export class SearchService {
   async isStrategyAvailable(strategyId: SearchStrategyId): Promise<boolean> {
     const strategy = this.strategies.get(strategyId)
     if (!strategy) return false
-    return strategy.isAvailable()
+    return this.checkStrategyAvailability(strategy)
+  }
+
+  /**
+   * Resolve a strategy's availability via the short-lived TTL cache.
+   * Coalesces concurrent callers onto a single in-flight probe to avoid
+   * thundering-herd on remote backends.
+   */
+  private async checkStrategyAvailability(strategy: SearchStrategy): Promise<boolean> {
+    const now = Date.now()
+    const cached = this.availabilityCache.get(strategy.id)
+    if (cached && cached.expiresAt > now) return cached.value
+
+    const inflight = this.availabilityInflight.get(strategy.id)
+    if (inflight) return inflight
+
+    const probe = (async () => {
+      try {
+        const value = await strategy.isAvailable()
+        this.availabilityCache.set(strategy.id, {
+          value,
+          expiresAt: Date.now() + this.availabilityCacheTtlMs,
+        })
+        return value
+      } catch {
+        this.availabilityCache.set(strategy.id, {
+          value: false,
+          expiresAt: Date.now() + this.availabilityCacheTtlMs,
+        })
+        return false
+      } finally {
+        this.availabilityInflight.delete(strategy.id)
+      }
+    })()
+    this.availabilityInflight.set(strategy.id, probe)
+    return probe
   }
 
   /**
    * Get available strategies from the requested list.
    * Filters out strategies that are not registered or not available.
+   * Probes run in parallel and reuse a short-lived per-strategy availability
+   * cache, so hot paths pay the max latency of the slowest probe (or zero
+   * when cached) instead of the sum of all probes.
    */
   private async getAvailableStrategies(ids?: SearchStrategyId[]): Promise<SearchStrategy[]> {
     const targetIds = ids ?? Array.from(this.strategies.keys())
-    const available: SearchStrategy[] = []
-
+    const candidates: SearchStrategy[] = []
     for (const id of targetIds) {
       const strategy = this.strategies.get(id)
-      if (strategy) {
-        try {
-          const isAvailable = await strategy.isAvailable()
-          if (isAvailable) {
-            available.push(strategy)
-          }
-        } catch {
-          // Strategy availability check failed, skip it
-        }
+      if (strategy) candidates.push(strategy)
+    }
+
+    const probes = await Promise.allSettled(
+      candidates.map((strategy) => this.checkStrategyAvailability(strategy)),
+    )
+
+    const available: SearchStrategy[] = []
+    for (let i = 0; i < probes.length; i++) {
+      const probe = probes[i]
+      if (probe.status === 'fulfilled' && probe.value) {
+        available.push(candidates[i])
       }
     }
 
-    // Sort by priority (higher priority first)
     return available.sort((a, b) => b.priority - a.priority)
   }