@open-mercato/search 0.6.6-develop.5651.1.c43359070c → 0.6.6-develop.5672.1.11e27afad2

package/dist/service.js

@@ -116,18 +116,10 @@ class SearchService {
     const results = await Promise.allSettled(
       strategies.map((strategy) => this.executeStrategyIndex(strategy, record))
     );
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i];
-      if (result.status === "rejected") {
-        const strategy = strategies[i];
-        searchError("SearchService", "Strategy index failed", {
-          strategyId: strategy?.id,
-          entityId: record.entityId,
-          recordId: record.recordId,
-          error: result.reason instanceof Error ? result.reason.message : result.reason
-        });
-      }
-    }
+    this.throwOnStrategyFailures("index", strategies, results, {
+      entityId: record.entityId,
+      recordId: record.recordId
+    });
   }
   /**
    * Delete a record from all strategies.
@@ -141,18 +133,7 @@ class SearchService {
     const results = await Promise.allSettled(
       strategies.map((strategy) => this.executeStrategyDelete(strategy, entityId, recordId, tenantId))
     );
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i];
-      if (result.status === "rejected") {
-        const strategy = strategies[i];
-        searchError("SearchService", "Strategy delete failed", {
-          strategyId: strategy?.id,
-          entityId,
-          recordId,
-          error: result.reason instanceof Error ? result.reason.message : result.reason
-        });
-      }
-    }
+    this.throwOnStrategyFailures("delete", strategies, results, { entityId, recordId });
   }
   /**
    * Bulk index multiple records.
@@ -209,17 +190,42 @@ class SearchService {
         return Promise.resolve();
       })
     );
+    this.throwOnStrategyFailures("purge", strategies, results, { entityId });
+  }
+  /**
+   * Inspect the settled results of a per-strategy write operation, log every
+   * rejection, and re-throw an aggregated error when any strategy failed.
+   *
+   * Write operations (index/delete/purge) must surface failures to the caller
+   * so the queue worker re-throws and the job is retried. Swallowing rejections
+   * here causes silent, permanent index gaps on transient failures such as
+   * Postgres connection-pool exhaustion (issue #3103). Successful strategies
+   * still commit their work; only the aggregated failure propagates.
+   */
+  throwOnStrategyFailures(operation, strategies, results, context) {
+    const failures = [];
     for (let i = 0; i < results.length; i++) {
       const result = results[i];
       if (result.status === "rejected") {
         const strategy = strategies[i];
-        searchError("SearchService", "Strategy purge failed", {
+        failures.push({ strategyId: strategy?.id || "unknown", reason: result.reason });
+        searchError("SearchService", `Strategy ${operation} failed`, {
           strategyId: strategy?.id,
-          entityId,
+          entityId: context.entityId,
+          recordId: context.recordId,
           error: result.reason instanceof Error ? result.reason.message : result.reason
         });
       }
     }
+    if (failures.length === 0) return;
+    const summary = `Search ${operation} failed for ${failures.length} strategy(ies): ${failures.map((failure) => {
+      const message = failure.reason instanceof Error ? failure.reason.message : String(failure.reason);
+      return `${failure.strategyId} (${message})`;
+    }).join(", ")}`;
+    throw new AggregateError(
+      failures.map((failure) => failure.reason),
+      summary
+    );
   }
   /**
    * Register a new strategy at runtime.

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 * 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\nfunction normalizeOrganizationFilter(options: SearchOptions): string[] | null {\n  const single = typeof options.organizationId === 'string' ? options.organizationId.trim() : ''\n  if (single) return [single]\n  if (!Array.isArray(options.organizationIds)) return null\n\n  const values = Array.from(new Set(\n    options.organizationIds\n      .map((value) => (typeof value === 'string' ? value.trim() : ''))\n      .filter((value) => value.length > 0),\n  ))\n  return values\n}\n\nfunction filterResultsByOrganizationScope(results: SearchResult[], options: SearchOptions): SearchResult[] {\n  const organizationIds = normalizeOrganizationFilter(options)\n  if (!organizationIds) return results\n  if (organizationIds.length === 0) return []\n\n  const allowed = new Set(organizationIds)\n  return results.filter((result) => {\n    const organizationId = typeof result.organizationId === 'string' ? result.organizationId.trim() : ''\n    return organizationId.length > 0 && allowed.has(organizationId)\n  })\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  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 organizationIds = normalizeOrganizationFilter(options)\n    if (organizationIds && organizationIds.length === 0) {\n      return []\n    }\n\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    const scoped = filterResultsByOrganizationScope(merged, options)\n\n    // Enrich results missing presenter or navigation metadata\n    return this.enrichResultsWithPresenter(scoped, 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, organizationId?: string | null): 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, organizationId)\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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",
+  "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\nfunction normalizeOrganizationFilter(options: SearchOptions): string[] | null {\n  const single = typeof options.organizationId === 'string' ? options.organizationId.trim() : ''\n  if (single) return [single]\n  if (!Array.isArray(options.organizationIds)) return null\n\n  const values = Array.from(new Set(\n    options.organizationIds\n      .map((value) => (typeof value === 'string' ? value.trim() : ''))\n      .filter((value) => value.length > 0),\n  ))\n  return values\n}\n\nfunction filterResultsByOrganizationScope(results: SearchResult[], options: SearchOptions): SearchResult[] {\n  const organizationIds = normalizeOrganizationFilter(options)\n  if (!organizationIds) return results\n  if (organizationIds.length === 0) return []\n\n  const allowed = new Set(organizationIds)\n  return results.filter((result) => {\n    const organizationId = typeof result.organizationId === 'string' ? result.organizationId.trim() : ''\n    return organizationId.length > 0 && allowed.has(organizationId)\n  })\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  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 organizationIds = normalizeOrganizationFilter(options)\n    if (organizationIds && organizationIds.length === 0) {\n      return []\n    }\n\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    const scoped = filterResultsByOrganizationScope(merged, options)\n\n    // Enrich results missing presenter or navigation metadata\n    return this.enrichResultsWithPresenter(scoped, 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    this.throwOnStrategyFailures('index', strategies, results, {\n      entityId: record.entityId,\n      recordId: record.recordId,\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    this.throwOnStrategyFailures('delete', strategies, results, { entityId, recordId })\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, organizationId?: string | null): 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, organizationId)\n        }\n        return Promise.resolve()\n      }),\n    )\n\n    this.throwOnStrategyFailures('purge', strategies, results, { entityId })\n  }\n\n  /**\n   * Inspect the settled results of a per-strategy write operation, log every\n   * rejection, and re-throw an aggregated error when any strategy failed.\n   *\n   * Write operations (index/delete/purge) must surface failures to the caller\n   * so the queue worker re-throws and the job is retried. Swallowing rejections\n   * here causes silent, permanent index gaps on transient failures such as\n   * Postgres connection-pool exhaustion (issue #3103). Successful strategies\n   * still commit their work; only the aggregated failure propagates.\n   */\n  private throwOnStrategyFailures(\n    operation: 'index' | 'delete' | 'purge',\n    strategies: SearchStrategy[],\n    results: PromiseSettledResult<unknown>[],\n    context: { entityId: string; recordId?: string },\n  ): void {\n    const failures: Array<{ strategyId: string; reason: unknown }> = []\n\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        failures.push({ strategyId: strategy?.id || 'unknown', reason: result.reason })\n        searchError('SearchService', `Strategy ${operation} failed`, {\n          strategyId: strategy?.id,\n          entityId: context.entityId,\n          recordId: context.recordId,\n          error: result.reason instanceof Error ? result.reason.message : result.reason,\n        })\n      }\n    }\n\n    if (failures.length === 0) return\n\n    const summary = `Search ${operation} failed for ${failures.length} strategy(ies): ${failures\n      .map((failure) => {\n        const message = failure.reason instanceof Error ? failure.reason.message : String(failure.reason)\n        return `${failure.strategyId} (${message})`\n      })\n      .join(', ')}`\n\n    throw new AggregateError(\n      failures.map((failure) => failure.reason),\n      summary,\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.6.6-develop.5651.1.c43359070c",
+  "version": "0.6.6-develop.5672.1.11e27afad2",
   "type": "module",
   "main": "./dist/index.js",
   "exports": {
@@ -126,9 +126,9 @@
     "zod": "^4.4.3"
   },
   "peerDependencies": {
-    "@open-mercato/core": "0.6.6-develop.5651.1.c43359070c",
-    "@open-mercato/queue": "0.6.6-develop.5651.1.c43359070c",
-    "@open-mercato/shared": "0.6.6-develop.5651.1.c43359070c"
+    "@open-mercato/core": "0.6.6-develop.5672.1.11e27afad2",
+    "@open-mercato/queue": "0.6.6-develop.5672.1.11e27afad2",
+    "@open-mercato/shared": "0.6.6-develop.5672.1.11e27afad2"
   },
   "devDependencies": {
     "@types/jest": "^30.0.0",

package/src/__tests__/service.test.ts

@@ -355,6 +355,52 @@ describe('SearchService', () => {
       expect(availableStrategy.index).toHaveBeenCalled()
       expect(unavailableStrategy.index).not.toHaveBeenCalled()
     })
+
+    // issue #3103: a strategy index failure must surface to the caller so the
+    // queue worker re-throws and the job is retried instead of silently completing.
+    it('should reject when a strategy index fails (so the queue can retry)', async () => {
+      const strategy = createMockStrategy({
+        id: 'vector',
+        index: jest.fn().mockRejectedValue(new Error('sorry, too many clients already')),
+      })
+      const service = new SearchService({ strategies: [strategy] })
+
+      await expect(service.index(createMockRecord())).rejects.toThrow(
+        'Search index failed for 1 strategy(ies): vector (sorry, too many clients already)'
+      )
+    })
+
+    it('should still reject when only one of several strategies fails', async () => {
+      const ok = createMockStrategy({ id: 'tokens', index: jest.fn().mockResolvedValue(undefined) })
+      const failing = createMockStrategy({
+        id: 'vector',
+        index: jest.fn().mockRejectedValue(new Error('embedding provider blip')),
+      })
+      const service = new SearchService({ strategies: [ok, failing] })
+
+      await expect(service.index(createMockRecord())).rejects.toThrow(
+        'Search index failed for 1 strategy(ies): vector (embedding provider blip)'
+      )
+      // Successful strategies still commit their work.
+      expect(ok.index).toHaveBeenCalled()
+    })
+
+    it('should preserve the original strategy errors on the thrown AggregateError', async () => {
+      const cause = new Error('sorry, too many clients already')
+      const strategy = createMockStrategy({ id: 'vector', index: jest.fn().mockRejectedValue(cause) })
+      const service = new SearchService({ strategies: [strategy] })
+
+      await expect(service.index(createMockRecord())).rejects.toMatchObject({
+        errors: [cause],
+      })
+    })
+
+    it('should resolve when all strategies succeed', async () => {
+      const strategy = createMockStrategy({ id: 'tokens', index: jest.fn().mockResolvedValue(undefined) })
+      const service = new SearchService({ strategies: [strategy] })
+
+      await expect(service.index(createMockRecord())).resolves.toBeUndefined()
+    })
   })
 
   describe('bulkIndex', () => {
@@ -439,6 +485,19 @@ describe('SearchService', () => {
       expect(strategy1.delete).toHaveBeenCalledWith('test:entity', 'rec-123', 'tenant-123')
       expect(strategy2.delete).toHaveBeenCalledWith('test:entity', 'rec-123', 'tenant-123')
     })
+
+    // issue #3103: deletes must also surface failures so removals are retried.
+    it('should reject when a strategy delete fails (so the queue can retry)', async () => {
+      const strategy = createMockStrategy({
+        id: 'fulltext',
+        delete: jest.fn().mockRejectedValue(new Error('connection reset')),
+      })
+      const service = new SearchService({ strategies: [strategy] })
+
+      await expect(service.delete('test:entity', 'rec-123', 'tenant-123')).rejects.toThrow(
+        'Search delete failed for 1 strategy(ies): fulltext (connection reset)'
+      )
+    })
   })
 
   describe('purge', () => {
@@ -460,6 +519,19 @@ describe('SearchService', () => {
       // organizationId is forwarded as undefined for a tenant-wide purge (issue #2935)
       expect(strategyWithPurge.purge).toHaveBeenCalledWith('test:entity', 'tenant-123', undefined)
     })
+
+    // issue #3103: purge failures must surface so the reindex job is retried.
+    it('should reject when a strategy purge fails (so the queue can retry)', async () => {
+      const strategy = createMockStrategy({
+        id: 'tokens',
+        purge: jest.fn().mockRejectedValue(new Error('sorry, too many clients already')),
+      })
+      const service = new SearchService({ strategies: [strategy] })
+
+      await expect(service.purge('test:entity', 'tenant-123')).rejects.toThrow(
+        'Search purge failed for 1 strategy(ies): tokens (sorry, too many clients already)'
+      )
+    })
   })
 
   describe('availability checks (issue #1404)', () => {

package/src/service.ts

@@ -202,19 +202,10 @@ export class SearchService {
       strategies.map((strategy) => this.executeStrategyIndex(strategy, record)),
     )
 
-    // Log any failures
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i]
-      if (result.status === 'rejected') {
-        const strategy = strategies[i]
-        searchError('SearchService', 'Strategy index failed', {
-          strategyId: strategy?.id,
-          entityId: record.entityId,
-          recordId: record.recordId,
-          error: result.reason instanceof Error ? result.reason.message : result.reason,
-        })
-      }
-    }
+    this.throwOnStrategyFailures('index', strategies, results, {
+      entityId: record.entityId,
+      recordId: record.recordId,
+    })
   }
 
   /**
@@ -231,19 +222,7 @@ export class SearchService {
       strategies.map((strategy) => this.executeStrategyDelete(strategy, entityId, recordId, tenantId)),
     )
 
-    // Log any failures
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i]
-      if (result.status === 'rejected') {
-        const strategy = strategies[i]
-        searchError('SearchService', 'Strategy delete failed', {
-          strategyId: strategy?.id,
-          entityId,
-          recordId,
-          error: result.reason instanceof Error ? result.reason.message : result.reason,
-        })
-      }
-    }
+    this.throwOnStrategyFailures('delete', strategies, results, { entityId, recordId })
   }
 
   /**
@@ -312,18 +291,54 @@ export class SearchService {
       }),
     )
 
-    // Log any failures
+    this.throwOnStrategyFailures('purge', strategies, results, { entityId })
+  }
+
+  /**
+   * Inspect the settled results of a per-strategy write operation, log every
+   * rejection, and re-throw an aggregated error when any strategy failed.
+   *
+   * Write operations (index/delete/purge) must surface failures to the caller
+   * so the queue worker re-throws and the job is retried. Swallowing rejections
+   * here causes silent, permanent index gaps on transient failures such as
+   * Postgres connection-pool exhaustion (issue #3103). Successful strategies
+   * still commit their work; only the aggregated failure propagates.
+   */
+  private throwOnStrategyFailures(
+    operation: 'index' | 'delete' | 'purge',
+    strategies: SearchStrategy[],
+    results: PromiseSettledResult<unknown>[],
+    context: { entityId: string; recordId?: string },
+  ): void {
+    const failures: Array<{ strategyId: string; reason: unknown }> = []
+
     for (let i = 0; i < results.length; i++) {
       const result = results[i]
       if (result.status === 'rejected') {
         const strategy = strategies[i]
-        searchError('SearchService', 'Strategy purge failed', {
+        failures.push({ strategyId: strategy?.id || 'unknown', reason: result.reason })
+        searchError('SearchService', `Strategy ${operation} failed`, {
           strategyId: strategy?.id,
-          entityId,
+          entityId: context.entityId,
+          recordId: context.recordId,
           error: result.reason instanceof Error ? result.reason.message : result.reason,
         })
       }
     }
+
+    if (failures.length === 0) return
+
+    const summary = `Search ${operation} failed for ${failures.length} strategy(ies): ${failures
+      .map((failure) => {
+        const message = failure.reason instanceof Error ? failure.reason.message : String(failure.reason)
+        return `${failure.strategyId} (${message})`
+      })
+      .join(', ')}`
+
+    throw new AggregateError(
+      failures.map((failure) => failure.reason),
+      summary,
+    )
   }
 
   /**