@open-mercato/search 0.6.7-develop.6834.1.e76f4b8cbc → 0.6.7-develop.6851.1.c1680b00d8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/AGENTS.md +2 -0
  2. package/dist/modules/search/api/openapi.js +2 -0
  3. package/dist/modules/search/api/openapi.js.map +2 -2
  4. package/dist/modules/search/api/settings/vector-store/route.js +34 -0
  5. package/dist/modules/search/api/settings/vector-store/route.js.map +2 -2
  6. package/dist/modules/search/frontend/components/SearchSettingsPageClient.js.map +2 -2
  7. package/dist/modules/search/frontend/components/sections/VectorSearchSection.js +14 -2
  8. package/dist/modules/search/frontend/components/sections/VectorSearchSection.js.map +2 -2
  9. package/dist/modules/search/i18n/de.json +2 -0
  10. package/dist/modules/search/i18n/en.json +2 -0
  11. package/dist/modules/search/i18n/es.json +2 -0
  12. package/dist/modules/search/i18n/ko.json +239 -0
  13. package/dist/modules/search/i18n/pl.json +2 -0
  14. package/dist/strategies/vector.strategy.js +3 -1
  15. package/dist/strategies/vector.strategy.js.map +2 -2
  16. package/dist/vector/drivers/pgvector/index.js +55 -1
  17. package/dist/vector/drivers/pgvector/index.js.map +2 -2
  18. package/dist/vector/types.js.map +2 -2
  19. package/package.json +4 -4
  20. package/src/__tests__/pgvector-extension-availability.test.ts +158 -0
  21. package/src/modules/search/api/openapi.ts +2 -0
  22. package/src/modules/search/api/settings/vector-store/route.ts +43 -0
  23. package/src/modules/search/frontend/components/SearchSettingsPageClient.tsx +2 -0
  24. package/src/modules/search/frontend/components/sections/VectorSearchSection.tsx +31 -1
  25. package/src/modules/search/frontend/components/sections/__tests__/VectorSearchSection.test.tsx +36 -1
  26. package/src/modules/search/i18n/de.json +2 -0
  27. package/src/modules/search/i18n/en.json +2 -0
  28. package/src/modules/search/i18n/es.json +2 -0
  29. package/src/modules/search/i18n/ko.json +239 -0
  30. package/src/modules/search/i18n/pl.json +2 -0
  31. package/src/strategies/vector.strategy.ts +7 -1
  32. package/src/vector/drivers/pgvector/index.ts +77 -1
  33. package/src/vector/types.ts +14 -0
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "version": 3,
3
3
  "sources": ["../../src/vector/types.ts"],
4
- "sourcesContent": ["import type { EntityId } from '@open-mercato/shared/modules/entities'\nimport type {\n VectorDriverId,\n VectorIndexSource,\n VectorModuleConfig,\n VectorEntityConfig,\n VectorLinkDescriptor,\n VectorResultPresenter,\n VectorSearchHit,\n VectorQueryRequest,\n VectorIndexEntry,\n} from '@open-mercato/shared/modules/vector'\n\nexport type {\n VectorDriverId,\n VectorIndexSource,\n VectorModuleConfig,\n VectorEntityConfig,\n VectorLinkDescriptor,\n VectorResultPresenter,\n VectorSearchHit,\n VectorQueryRequest,\n VectorIndexEntry,\n}\n\nexport type VectorDriverDocument = {\n entityId: EntityId\n recordId: string\n tenantId: string\n organizationId?: string | null\n checksum: string\n embedding: number[]\n url?: string | null\n presenter?: VectorResultPresenter | null\n links?: VectorLinkDescriptor[] | null\n payload?: Record<string, unknown> | null\n driverId: VectorDriverId\n resultTitle: string\n resultSubtitle?: string | null\n resultIcon?: string | null\n resultBadge?: string | null\n resultSnapshot?: string | null\n primaryLinkHref?: string | null\n primaryLinkLabel?: string | null\n}\n\nexport type VectorDriverQuery = {\n vector: number[]\n limit?: number\n filter?: {\n entityIds?: EntityId[]\n organizationId?: string | null\n organizationIds?: string[] | null\n tenantId: string\n }\n}\n\nexport type VectorDriverQueryResult = {\n entityId: EntityId\n recordId: string\n organizationId?: string | null\n score: number\n checksum: string\n url?: string | null\n presenter?: VectorResultPresenter | null\n links?: VectorLinkDescriptor[] | null\n payload?: Record<string, unknown> | null\n resultTitle: string\n resultSubtitle?: string | null\n resultIcon?: string | null\n resultBadge?: string | null\n resultSnapshot?: string | null\n primaryLinkHref?: string | null\n primaryLinkLabel?: string | null\n}\n\nexport type VectorDriverListParams = {\n tenantId: string\n organizationId?: string | null\n entityId?: EntityId\n limit?: number\n offset?: number\n orderBy?: 'created' | 'updated'\n}\n\nexport type VectorDriverCountParams = {\n tenantId: string\n organizationId?: string | null\n entityId?: EntityId\n}\n\nexport type VectorDriverRemoveOrphansParams = {\n entityId: EntityId\n tenantId?: string | null\n organizationId?: string | null\n olderThan: Date\n}\n\nexport interface VectorDriver {\n readonly id: VectorDriverId\n ensureReady(): Promise<void>\n upsert(doc: VectorDriverDocument): Promise<void>\n delete(entityId: EntityId, recordId: string, tenantId: string): Promise<void>\n query(input: VectorDriverQuery): Promise<VectorDriverQueryResult[]>\n getChecksum(entityId: EntityId, recordId: string, tenantId: string): Promise<string | null>\n purge?(entityId: EntityId, tenantId: string, organizationId?: string | null): Promise<void>\n list?(params: VectorDriverListParams): Promise<VectorIndexEntry[]>\n count?(params: VectorDriverCountParams): Promise<number>\n removeOrphans?(params: VectorDriverRemoveOrphansParams): Promise<number | void>\n getTableDimension?(): Promise<number | null>\n recreateWithDimension?(newDimension: number): Promise<void>\n}\n\n// ============================================================================\n// Embedding Provider Configuration Types\n// ============================================================================\n\nexport type EmbeddingProviderId =\n | 'openai'\n | 'google'\n | 'mistral'\n | 'cohere'\n | 'bedrock'\n | 'ollama'\n\nexport type EmbeddingProviderConfig = {\n providerId: EmbeddingProviderId\n model: string\n dimension: number\n outputDimensionality?: number\n baseUrl?: string\n updatedAt: string\n}\n\nexport type EmbeddingModelInfo = {\n id: string\n name: string\n dimension: number\n configurableDimension?: boolean\n minDimension?: number\n maxDimension?: number\n}\n\nexport type EmbeddingProviderInfo = {\n name: string\n envKeyRequired: string\n defaultModel: string\n models: EmbeddingModelInfo[]\n}\n\nexport const EMBEDDING_PROVIDERS: Record<EmbeddingProviderId, EmbeddingProviderInfo> = {\n openai: {\n name: 'OpenAI',\n envKeyRequired: 'OPENAI_API_KEY',\n defaultModel: 'text-embedding-3-small',\n models: [\n { id: 'text-embedding-3-small', name: 'text-embedding-3-small', dimension: 1536 },\n { id: 'text-embedding-3-large', name: 'text-embedding-3-large', dimension: 3072, configurableDimension: true, minDimension: 256, maxDimension: 3072 },\n { id: 'text-embedding-ada-002', name: 'text-embedding-ada-002', dimension: 1536 },\n ],\n },\n google: {\n name: 'Google Generative AI',\n envKeyRequired: 'GOOGLE_GENERATIVE_AI_API_KEY',\n defaultModel: 'text-embedding-004',\n models: [\n { id: 'text-embedding-004', name: 'text-embedding-004', dimension: 768, configurableDimension: true, minDimension: 1, maxDimension: 768 },\n { id: 'embedding-001', name: 'embedding-001', dimension: 768 },\n ],\n },\n mistral: {\n name: 'Mistral',\n envKeyRequired: 'MISTRAL_API_KEY',\n defaultModel: 'mistral-embed',\n models: [\n { id: 'mistral-embed', name: 'mistral-embed', dimension: 1024 },\n ],\n },\n cohere: {\n name: 'Cohere',\n envKeyRequired: 'COHERE_API_KEY',\n defaultModel: 'embed-english-v3.0',\n models: [\n { id: 'embed-english-v3.0', name: 'embed-english-v3.0', dimension: 1024 },\n { id: 'embed-multilingual-v3.0', name: 'embed-multilingual-v3.0', dimension: 1024 },\n { id: 'embed-english-light-v3.0', name: 'embed-english-light-v3.0', dimension: 384 },\n { id: 'embed-multilingual-light-v3.0', name: 'embed-multilingual-light-v3.0', dimension: 384 },\n ],\n },\n bedrock: {\n name: 'Amazon Bedrock',\n envKeyRequired: 'AWS_ACCESS_KEY_ID',\n defaultModel: 'amazon.titan-embed-text-v2:0',\n models: [\n { id: 'amazon.titan-embed-text-v2:0', name: 'Titan Embed Text v2', dimension: 1024, configurableDimension: true, minDimension: 256, maxDimension: 1024 },\n { id: 'amazon.titan-embed-text-v1', name: 'Titan Embed Text v1', dimension: 1536 },\n { id: 'cohere.embed-english-v3', name: 'Cohere Embed English v3', dimension: 1024 },\n { id: 'cohere.embed-multilingual-v3', name: 'Cohere Embed Multilingual v3', dimension: 1024 },\n ],\n },\n ollama: {\n name: 'Ollama (Local)',\n envKeyRequired: 'OLLAMA_BASE_URL',\n defaultModel: 'nomic-embed-text',\n models: [\n { id: 'nomic-embed-text', name: 'nomic-embed-text', dimension: 768 },\n { id: 'mxbai-embed-large', name: 'mxbai-embed-large', dimension: 1024 },\n { id: 'all-minilm', name: 'all-minilm', dimension: 384 },\n { id: 'snowflake-arctic-embed', name: 'snowflake-arctic-embed', dimension: 1024 },\n ],\n },\n}\n\nexport const EMBEDDING_CONFIG_KEY = 'embedding_provider'\n\nexport const DEFAULT_EMBEDDING_CONFIG: EmbeddingProviderConfig = {\n providerId: 'openai',\n model: 'text-embedding-3-small',\n dimension: 1536,\n updatedAt: new Date().toISOString(),\n}\n"],
5
- "mappings": "AAsJO,MAAM,sBAA0E;AAAA,EACrF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,KAAK;AAAA,MAChF,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,MAAM,uBAAuB,MAAM,cAAc,KAAK,cAAc,KAAK;AAAA,MACpJ,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,KAAK;AAAA,IAClF;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,sBAAsB,MAAM,sBAAsB,WAAW,KAAK,uBAAuB,MAAM,cAAc,GAAG,cAAc,IAAI;AAAA,MACxI,EAAE,IAAI,iBAAiB,MAAM,iBAAiB,WAAW,IAAI;AAAA,IAC/D;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,iBAAiB,MAAM,iBAAiB,WAAW,KAAK;AAAA,IAChE;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,sBAAsB,MAAM,sBAAsB,WAAW,KAAK;AAAA,MACxE,EAAE,IAAI,2BAA2B,MAAM,2BAA2B,WAAW,KAAK;AAAA,MAClF,EAAE,IAAI,4BAA4B,MAAM,4BAA4B,WAAW,IAAI;AAAA,MACnF,EAAE,IAAI,iCAAiC,MAAM,iCAAiC,WAAW,IAAI;AAAA,IAC/F;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,gCAAgC,MAAM,uBAAuB,WAAW,MAAM,uBAAuB,MAAM,cAAc,KAAK,cAAc,KAAK;AAAA,MACvJ,EAAE,IAAI,8BAA8B,MAAM,uBAAuB,WAAW,KAAK;AAAA,MACjF,EAAE,IAAI,2BAA2B,MAAM,2BAA2B,WAAW,KAAK;AAAA,MAClF,EAAE,IAAI,gCAAgC,MAAM,gCAAgC,WAAW,KAAK;AAAA,IAC9F;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,oBAAoB,MAAM,oBAAoB,WAAW,IAAI;AAAA,MACnE,EAAE,IAAI,qBAAqB,MAAM,qBAAqB,WAAW,KAAK;AAAA,MACtE,EAAE,IAAI,cAAc,MAAM,cAAc,WAAW,IAAI;AAAA,MACvD,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,KAAK;AAAA,IAClF;AAAA,EACF;AACF;AAEO,MAAM,uBAAuB;AAE7B,MAAM,2BAAoD;AAAA,EAC/D,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AAAA,EACX,YAAW,oBAAI,KAAK,GAAE,YAAY;AACpC;",
4
+ "sourcesContent": ["import type { EntityId } from '@open-mercato/shared/modules/entities'\nimport type {\n VectorDriverId,\n VectorIndexSource,\n VectorModuleConfig,\n VectorEntityConfig,\n VectorLinkDescriptor,\n VectorResultPresenter,\n VectorSearchHit,\n VectorQueryRequest,\n VectorIndexEntry,\n} from '@open-mercato/shared/modules/vector'\n\nexport type {\n VectorDriverId,\n VectorIndexSource,\n VectorModuleConfig,\n VectorEntityConfig,\n VectorLinkDescriptor,\n VectorResultPresenter,\n VectorSearchHit,\n VectorQueryRequest,\n VectorIndexEntry,\n}\n\nexport type VectorDriverDocument = {\n entityId: EntityId\n recordId: string\n tenantId: string\n organizationId?: string | null\n checksum: string\n embedding: number[]\n url?: string | null\n presenter?: VectorResultPresenter | null\n links?: VectorLinkDescriptor[] | null\n payload?: Record<string, unknown> | null\n driverId: VectorDriverId\n resultTitle: string\n resultSubtitle?: string | null\n resultIcon?: string | null\n resultBadge?: string | null\n resultSnapshot?: string | null\n primaryLinkHref?: string | null\n primaryLinkLabel?: string | null\n}\n\nexport type VectorDriverQuery = {\n vector: number[]\n limit?: number\n filter?: {\n entityIds?: EntityId[]\n organizationId?: string | null\n organizationIds?: string[] | null\n tenantId: string\n }\n}\n\nexport type VectorDriverQueryResult = {\n entityId: EntityId\n recordId: string\n organizationId?: string | null\n score: number\n checksum: string\n url?: string | null\n presenter?: VectorResultPresenter | null\n links?: VectorLinkDescriptor[] | null\n payload?: Record<string, unknown> | null\n resultTitle: string\n resultSubtitle?: string | null\n resultIcon?: string | null\n resultBadge?: string | null\n resultSnapshot?: string | null\n primaryLinkHref?: string | null\n primaryLinkLabel?: string | null\n}\n\nexport type VectorDriverListParams = {\n tenantId: string\n organizationId?: string | null\n entityId?: EntityId\n limit?: number\n offset?: number\n orderBy?: 'created' | 'updated'\n}\n\nexport type VectorDriverCountParams = {\n tenantId: string\n organizationId?: string | null\n entityId?: EntityId\n}\n\nexport type VectorDriverRemoveOrphansParams = {\n entityId: EntityId\n tenantId?: string | null\n organizationId?: string | null\n olderThan: Date\n}\n\nexport type VectorDriverStatus = {\n available: boolean\n reason?: string\n}\n\nexport interface VectorDriver {\n readonly id: VectorDriverId\n ensureReady(): Promise<void>\n /**\n * Cheap, cached probe answering whether the backing store can serve reads and\n * writes at all. Drivers that cannot satisfy their hard requirements (for\n * pgvector: the `vector` extension) MUST report `false` here so callers skip\n * the strategy instead of failing every record. Optional for backward\n * compatibility \u2014 an absent implementation is treated as available.\n */\n isHealthy?(): Promise<boolean>\n getStatus?(): Promise<VectorDriverStatus>\n upsert(doc: VectorDriverDocument): Promise<void>\n delete(entityId: EntityId, recordId: string, tenantId: string): Promise<void>\n query(input: VectorDriverQuery): Promise<VectorDriverQueryResult[]>\n getChecksum(entityId: EntityId, recordId: string, tenantId: string): Promise<string | null>\n purge?(entityId: EntityId, tenantId: string, organizationId?: string | null): Promise<void>\n list?(params: VectorDriverListParams): Promise<VectorIndexEntry[]>\n count?(params: VectorDriverCountParams): Promise<number>\n removeOrphans?(params: VectorDriverRemoveOrphansParams): Promise<number | void>\n getTableDimension?(): Promise<number | null>\n recreateWithDimension?(newDimension: number): Promise<void>\n}\n\n// ============================================================================\n// Embedding Provider Configuration Types\n// ============================================================================\n\nexport type EmbeddingProviderId =\n | 'openai'\n | 'google'\n | 'mistral'\n | 'cohere'\n | 'bedrock'\n | 'ollama'\n\nexport type EmbeddingProviderConfig = {\n providerId: EmbeddingProviderId\n model: string\n dimension: number\n outputDimensionality?: number\n baseUrl?: string\n updatedAt: string\n}\n\nexport type EmbeddingModelInfo = {\n id: string\n name: string\n dimension: number\n configurableDimension?: boolean\n minDimension?: number\n maxDimension?: number\n}\n\nexport type EmbeddingProviderInfo = {\n name: string\n envKeyRequired: string\n defaultModel: string\n models: EmbeddingModelInfo[]\n}\n\nexport const EMBEDDING_PROVIDERS: Record<EmbeddingProviderId, EmbeddingProviderInfo> = {\n openai: {\n name: 'OpenAI',\n envKeyRequired: 'OPENAI_API_KEY',\n defaultModel: 'text-embedding-3-small',\n models: [\n { id: 'text-embedding-3-small', name: 'text-embedding-3-small', dimension: 1536 },\n { id: 'text-embedding-3-large', name: 'text-embedding-3-large', dimension: 3072, configurableDimension: true, minDimension: 256, maxDimension: 3072 },\n { id: 'text-embedding-ada-002', name: 'text-embedding-ada-002', dimension: 1536 },\n ],\n },\n google: {\n name: 'Google Generative AI',\n envKeyRequired: 'GOOGLE_GENERATIVE_AI_API_KEY',\n defaultModel: 'text-embedding-004',\n models: [\n { id: 'text-embedding-004', name: 'text-embedding-004', dimension: 768, configurableDimension: true, minDimension: 1, maxDimension: 768 },\n { id: 'embedding-001', name: 'embedding-001', dimension: 768 },\n ],\n },\n mistral: {\n name: 'Mistral',\n envKeyRequired: 'MISTRAL_API_KEY',\n defaultModel: 'mistral-embed',\n models: [\n { id: 'mistral-embed', name: 'mistral-embed', dimension: 1024 },\n ],\n },\n cohere: {\n name: 'Cohere',\n envKeyRequired: 'COHERE_API_KEY',\n defaultModel: 'embed-english-v3.0',\n models: [\n { id: 'embed-english-v3.0', name: 'embed-english-v3.0', dimension: 1024 },\n { id: 'embed-multilingual-v3.0', name: 'embed-multilingual-v3.0', dimension: 1024 },\n { id: 'embed-english-light-v3.0', name: 'embed-english-light-v3.0', dimension: 384 },\n { id: 'embed-multilingual-light-v3.0', name: 'embed-multilingual-light-v3.0', dimension: 384 },\n ],\n },\n bedrock: {\n name: 'Amazon Bedrock',\n envKeyRequired: 'AWS_ACCESS_KEY_ID',\n defaultModel: 'amazon.titan-embed-text-v2:0',\n models: [\n { id: 'amazon.titan-embed-text-v2:0', name: 'Titan Embed Text v2', dimension: 1024, configurableDimension: true, minDimension: 256, maxDimension: 1024 },\n { id: 'amazon.titan-embed-text-v1', name: 'Titan Embed Text v1', dimension: 1536 },\n { id: 'cohere.embed-english-v3', name: 'Cohere Embed English v3', dimension: 1024 },\n { id: 'cohere.embed-multilingual-v3', name: 'Cohere Embed Multilingual v3', dimension: 1024 },\n ],\n },\n ollama: {\n name: 'Ollama (Local)',\n envKeyRequired: 'OLLAMA_BASE_URL',\n defaultModel: 'nomic-embed-text',\n models: [\n { id: 'nomic-embed-text', name: 'nomic-embed-text', dimension: 768 },\n { id: 'mxbai-embed-large', name: 'mxbai-embed-large', dimension: 1024 },\n { id: 'all-minilm', name: 'all-minilm', dimension: 384 },\n { id: 'snowflake-arctic-embed', name: 'snowflake-arctic-embed', dimension: 1024 },\n ],\n },\n}\n\nexport const EMBEDDING_CONFIG_KEY = 'embedding_provider'\n\nexport const DEFAULT_EMBEDDING_CONFIG: EmbeddingProviderConfig = {\n providerId: 'openai',\n model: 'text-embedding-3-small',\n dimension: 1536,\n updatedAt: new Date().toISOString(),\n}\n"],
5
+ "mappings": "AAoKO,MAAM,sBAA0E;AAAA,EACrF,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,KAAK;AAAA,MAChF,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,MAAM,uBAAuB,MAAM,cAAc,KAAK,cAAc,KAAK;AAAA,MACpJ,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,KAAK;AAAA,IAClF;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,sBAAsB,MAAM,sBAAsB,WAAW,KAAK,uBAAuB,MAAM,cAAc,GAAG,cAAc,IAAI;AAAA,MACxI,EAAE,IAAI,iBAAiB,MAAM,iBAAiB,WAAW,IAAI;AAAA,IAC/D;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,iBAAiB,MAAM,iBAAiB,WAAW,KAAK;AAAA,IAChE;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,sBAAsB,MAAM,sBAAsB,WAAW,KAAK;AAAA,MACxE,EAAE,IAAI,2BAA2B,MAAM,2BAA2B,WAAW,KAAK;AAAA,MAClF,EAAE,IAAI,4BAA4B,MAAM,4BAA4B,WAAW,IAAI;AAAA,MACnF,EAAE,IAAI,iCAAiC,MAAM,iCAAiC,WAAW,IAAI;AAAA,IAC/F;AAAA,EACF;AAAA,EACA,SAAS;AAAA,IACP,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,gCAAgC,MAAM,uBAAuB,WAAW,MAAM,uBAAuB,MAAM,cAAc,KAAK,cAAc,KAAK;AAAA,MACvJ,EAAE,IAAI,8BAA8B,MAAM,uBAAuB,WAAW,KAAK;AAAA,MACjF,EAAE,IAAI,2BAA2B,MAAM,2BAA2B,WAAW,KAAK;AAAA,MAClF,EAAE,IAAI,gCAAgC,MAAM,gCAAgC,WAAW,KAAK;AAAA,IAC9F;AAAA,EACF;AAAA,EACA,QAAQ;AAAA,IACN,MAAM;AAAA,IACN,gBAAgB;AAAA,IAChB,cAAc;AAAA,IACd,QAAQ;AAAA,MACN,EAAE,IAAI,oBAAoB,MAAM,oBAAoB,WAAW,IAAI;AAAA,MACnE,EAAE,IAAI,qBAAqB,MAAM,qBAAqB,WAAW,KAAK;AAAA,MACtE,EAAE,IAAI,cAAc,MAAM,cAAc,WAAW,IAAI;AAAA,MACvD,EAAE,IAAI,0BAA0B,MAAM,0BAA0B,WAAW,KAAK;AAAA,IAClF;AAAA,EACF;AACF;AAEO,MAAM,uBAAuB;AAE7B,MAAM,2BAAoD;AAAA,EAC/D,YAAY;AAAA,EACZ,OAAO;AAAA,EACP,WAAW;AAAA,EACX,YAAW,oBAAI,KAAK,GAAE,YAAY;AACpC;",
6
6
  "names": []
7
7
  }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@open-mercato/search",
3
- "version": "0.6.7-develop.6834.1.e76f4b8cbc",
3
+ "version": "0.6.7-develop.6851.1.c1680b00d8",
4
4
  "license": "MIT",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
@@ -127,9 +127,9 @@
127
127
  "zod": "^4.4.3"
128
128
  },
129
129
  "peerDependencies": {
130
- "@open-mercato/core": "0.6.7-develop.6834.1.e76f4b8cbc",
131
- "@open-mercato/queue": "0.6.7-develop.6834.1.e76f4b8cbc",
132
- "@open-mercato/shared": "0.6.7-develop.6834.1.e76f4b8cbc"
130
+ "@open-mercato/core": "0.6.7-develop.6851.1.c1680b00d8",
131
+ "@open-mercato/queue": "0.6.7-develop.6851.1.c1680b00d8",
132
+ "@open-mercato/shared": "0.6.7-develop.6851.1.c1680b00d8"
133
133
  },
134
134
  "devDependencies": {
135
135
  "@types/jest": "^30.0.0",
@@ -0,0 +1,158 @@
1
+ import { createPgVectorDriver, type PgPool } from '../vector/drivers/pgvector'
2
+ import { VectorSearchStrategy } from '../strategies/vector.strategy'
3
+ import { SearchService } from '../service'
4
+ import type { IndexableRecord } from '../types'
5
+
6
+ type QueryCall = { text: string; params?: unknown[] }
7
+
8
+ function pgError(code: string, message: string): Error & { code: string } {
9
+ return Object.assign(new Error(message), { code })
10
+ }
11
+
12
+ function createPool(options: {
13
+ extensionInstalled?: boolean
14
+ extensionInstallable?: boolean
15
+ calls: QueryCall[]
16
+ }): PgPool {
17
+ const { calls } = options
18
+ const run = async (text: string, params?: unknown[]) => {
19
+ calls.push({ text, params })
20
+ if (/pg_available_extensions/.test(text)) {
21
+ return {
22
+ rows: [{
23
+ installed: options.extensionInstalled ?? false,
24
+ installable: options.extensionInstallable ?? false,
25
+ }],
26
+ }
27
+ }
28
+ if (/CREATE EXTENSION IF NOT EXISTS vector/.test(text)) {
29
+ if (options.extensionInstalled || options.extensionInstallable) return { rows: [] }
30
+ throw pgError('58P01', 'extension "vector" is not available')
31
+ }
32
+ return { rows: [] }
33
+ }
34
+ return {
35
+ connect: async () => ({ query: run as PgPool['query'], release: () => {} }),
36
+ query: run as PgPool['query'],
37
+ end: async () => {},
38
+ }
39
+ }
40
+
41
+ describe('pgvector extension availability', () => {
42
+ it('reports the driver unhealthy when the extension cannot be installed', async () => {
43
+ const calls: QueryCall[] = []
44
+ const driver = createPgVectorDriver({ pool: createPool({ calls }) })
45
+
46
+ expect(await driver.isHealthy!()).toBe(false)
47
+ const status = await driver.getStatus!()
48
+ expect(status.available).toBe(false)
49
+ // Curated, not the raw Postgres message: the settings API surfaces this to the browser.
50
+ expect(status.reason).toBe('extension "vector" is not available on this PostgreSQL server')
51
+ })
52
+
53
+ it('probes the catalog once instead of running DDL for every record', async () => {
54
+ const calls: QueryCall[] = []
55
+ const driver = createPgVectorDriver({ pool: createPool({ calls }) })
56
+
57
+ for (let attempt = 0; attempt < 5; attempt += 1) {
58
+ expect(await driver.isHealthy!()).toBe(false)
59
+ }
60
+
61
+ const probes = calls.filter((call) => /pg_available_extensions/.test(call.text))
62
+ expect(probes).toHaveLength(1)
63
+ expect(calls.some((call) => /CREATE TABLE/.test(call.text))).toBe(false)
64
+ })
65
+
66
+ it('short-circuits ensureReady once the extension is known to be missing', async () => {
67
+ const calls: QueryCall[] = []
68
+ const driver = createPgVectorDriver({ pool: createPool({ calls }) })
69
+
70
+ await expect(driver.ensureReady()).rejects.toThrow(/vector/)
71
+ const afterFirst = calls.length
72
+ await expect(driver.ensureReady()).rejects.toThrow(/vector/)
73
+
74
+ expect(calls.length).toBe(afterFirst)
75
+ })
76
+
77
+ it('stays healthy when the extension is installable', async () => {
78
+ const calls: QueryCall[] = []
79
+ const driver = createPgVectorDriver({ pool: createPool({ calls, extensionInstallable: true }) })
80
+
81
+ expect(await driver.isHealthy!()).toBe(true)
82
+ await expect(driver.ensureReady()).resolves.toBeUndefined()
83
+ })
84
+
85
+ it('keeps the existing superuser-less degradation path', async () => {
86
+ const calls: QueryCall[] = []
87
+ const pool = createPool({ calls, extensionInstalled: true })
88
+ const originalQuery = pool.query
89
+ pool.query = (async (text: string, params?: unknown[]) => {
90
+ if (/CREATE EXTENSION IF NOT EXISTS vector/.test(text)) {
91
+ calls.push({ text, params })
92
+ throw pgError('42501', 'permission denied to create extension "vector"')
93
+ }
94
+ return originalQuery(text, params)
95
+ }) as PgPool['query']
96
+ pool.connect = async () => ({ query: pool.query as never, release: () => {} })
97
+
98
+ const driver = createPgVectorDriver({ pool })
99
+ await expect(driver.ensureReady()).resolves.toBeUndefined()
100
+ expect(await driver.isHealthy!()).toBe(true)
101
+ })
102
+ })
103
+
104
+ describe('vector strategy availability', () => {
105
+ const embeddingService = { available: true, createEmbedding: jest.fn() }
106
+
107
+ function createDriver(overrides: Partial<Record<string, unknown>> = {}) {
108
+ return {
109
+ id: 'pgvector' as const,
110
+ ensureReady: jest.fn().mockResolvedValue(undefined),
111
+ upsert: jest.fn().mockResolvedValue(undefined),
112
+ delete: jest.fn().mockResolvedValue(undefined),
113
+ query: jest.fn().mockResolvedValue([]),
114
+ getChecksum: jest.fn().mockResolvedValue(null),
115
+ ...overrides,
116
+ }
117
+ }
118
+
119
+ it('is unavailable when the store reports itself unhealthy', async () => {
120
+ const driver = createDriver({ isHealthy: jest.fn().mockResolvedValue(false) })
121
+ const strategy = new VectorSearchStrategy(embeddingService, driver)
122
+
123
+ expect(await strategy.isAvailable()).toBe(false)
124
+ })
125
+
126
+ it('stays available for drivers that expose no probe', async () => {
127
+ const strategy = new VectorSearchStrategy(embeddingService, createDriver())
128
+
129
+ expect(await strategy.isAvailable()).toBe(true)
130
+ })
131
+
132
+ it('never touches the store on delete when it is unhealthy', async () => {
133
+ const driver = createDriver({ isHealthy: jest.fn().mockResolvedValue(false) })
134
+ const strategy = new VectorSearchStrategy(embeddingService, driver)
135
+ const service = new SearchService({ strategies: [strategy] })
136
+
137
+ await expect(service.delete('customers:customer_deal', 'rec-1', 'tenant-1')).resolves.toBeUndefined()
138
+ expect(driver.ensureReady).not.toHaveBeenCalled()
139
+ expect(driver.delete).not.toHaveBeenCalled()
140
+ })
141
+
142
+ it('never touches the store on index when it is unhealthy', async () => {
143
+ const driver = createDriver({ isHealthy: jest.fn().mockResolvedValue(false) })
144
+ const strategy = new VectorSearchStrategy(embeddingService, driver)
145
+ const service = new SearchService({ strategies: [strategy] })
146
+ const record: IndexableRecord = {
147
+ entityId: 'customers:customer_deal',
148
+ recordId: 'rec-1',
149
+ tenantId: 'tenant-1',
150
+ fields: { name: 'Deal' },
151
+ text: 'Deal',
152
+ }
153
+
154
+ await expect(service.index(record)).resolves.toBeUndefined()
155
+ expect(driver.ensureReady).not.toHaveBeenCalled()
156
+ expect(driver.upsert).not.toHaveBeenCalled()
157
+ })
158
+ })
@@ -246,6 +246,8 @@ export const vectorDriverStatusSchema = z.object({
246
246
  name: z.string(),
247
247
  configured: z.boolean(),
248
248
  implemented: z.boolean(),
249
+ available: z.boolean().nullable(),
250
+ unavailableReason: z.string().nullable(),
249
251
  envVars: z.array(vectorDriverEnvVarSchema),
250
252
  })
251
253
 
@@ -1,7 +1,9 @@
1
1
  import { NextResponse } from 'next/server'
2
+ import { createRequestContainer } from '@open-mercato/shared/lib/di/container'
2
3
  import { getAuthFromRequest } from '@open-mercato/shared/lib/auth/server'
3
4
  import { resolveTranslations } from '@open-mercato/shared/lib/i18n/server'
4
5
  import type { VectorDriverId } from '@open-mercato/shared/modules/vector'
6
+ import type { VectorDriver } from '../../../../../vector'
5
7
  import { vectorStoreSettingsOpenApi } from '../../openapi'
6
8
 
7
9
  export const metadata = {
@@ -13,6 +15,9 @@ type DriverStatus = {
13
15
  name: string
14
16
  configured: boolean
15
17
  implemented: boolean
18
+ /** Runtime reachability of the store itself; `null` when the driver exposes no probe. */
19
+ available: boolean | null
20
+ unavailableReason: string | null
16
21
  envVars: {
17
22
  name: string
18
23
  set: boolean
@@ -26,6 +31,24 @@ type VectorStoreConfigResponse = {
26
31
  drivers: DriverStatus[]
27
32
  }
28
33
 
34
+ async function probeDriverStatus(
35
+ container: { resolve: <T = unknown>(name: string) => T },
36
+ driverId: VectorDriverId,
37
+ ): Promise<{ available: boolean | null; unavailableReason: string | null }> {
38
+ try {
39
+ const drivers = container.resolve<VectorDriver[]>('vectorDrivers')
40
+ const driver = drivers.find((entry) => entry.id === driverId)
41
+ if (!driver?.getStatus) return { available: null, unavailableReason: null }
42
+ const status = await driver.getStatus()
43
+ return {
44
+ available: status.available,
45
+ unavailableReason: status.available ? null : status.reason ?? null,
46
+ }
47
+ } catch {
48
+ return { available: null, unavailableReason: null }
49
+ }
50
+ }
51
+
29
52
  const unauthorized = async () => {
30
53
  const { t } = await resolveTranslations()
31
54
  return NextResponse.json({ error: t('api.errors.unauthorized', 'Unauthorized') }, { status: 401 })
@@ -45,12 +68,28 @@ export async function GET(req: Request) {
45
68
  // Check chromadb - would need CHROMA_URL
46
69
  const chromaUrlSet = Boolean(process.env.CHROMA_URL?.trim())
47
70
 
71
+ let pgvectorStatus: { available: boolean | null; unavailableReason: string | null } = {
72
+ available: null,
73
+ unavailableReason: null,
74
+ }
75
+ if (databaseUrlSet) {
76
+ const container = await createRequestContainer()
77
+ try {
78
+ pgvectorStatus = await probeDriverStatus(container, 'pgvector')
79
+ } finally {
80
+ const disposable = container as { dispose?: () => Promise<unknown> }
81
+ if (typeof disposable.dispose === 'function') await disposable.dispose()
82
+ }
83
+ }
84
+
48
85
  const drivers: DriverStatus[] = [
49
86
  {
50
87
  id: 'pgvector',
51
88
  name: 'PostgreSQL (pgvector)',
52
89
  configured: databaseUrlSet,
53
90
  implemented: true,
91
+ available: pgvectorStatus.available,
92
+ unavailableReason: pgvectorStatus.unavailableReason,
54
93
  envVars: [
55
94
  {
56
95
  name: 'DATABASE_URL',
@@ -64,6 +103,8 @@ export async function GET(req: Request) {
64
103
  name: 'Qdrant',
65
104
  configured: qdrantUrlSet,
66
105
  implemented: false,
106
+ available: null,
107
+ unavailableReason: null,
67
108
  envVars: [
68
109
  {
69
110
  name: 'QDRANT_URL',
@@ -82,6 +123,8 @@ export async function GET(req: Request) {
82
123
  name: 'ChromaDB',
83
124
  configured: chromaUrlSet,
84
125
  implemented: false,
126
+ available: null,
127
+ unavailableReason: null,
85
128
  envVars: [
86
129
  {
87
130
  name: 'CHROMA_URL',
@@ -118,6 +118,8 @@ type VectorDriverStatus = {
118
118
  name: string
119
119
  configured: boolean
120
120
  implemented: boolean
121
+ available?: boolean | null
122
+ unavailableReason?: string | null
121
123
  envVars: VectorDriverEnvVar[]
122
124
  }
123
125
 
@@ -79,6 +79,8 @@ type VectorDriverStatus = {
79
79
  name: string
80
80
  configured: boolean
81
81
  implemented: boolean
82
+ available?: boolean | null
83
+ unavailableReason?: string | null
82
84
  envVars: VectorDriverEnvVar[]
83
85
  }
84
86
 
@@ -447,6 +449,31 @@ export function VectorSearchSection({
447
449
  const isEmbeddingConfigured = embeddingSettings?.configuredProviders?.includes(savedProvider)
448
450
  const providerOptions: EmbeddingProviderId[] = ['openai', 'google', 'mistral', 'cohere', 'bedrock', 'ollama']
449
451
 
452
+ const activeDriver = vectorStoreConfig?.drivers.find((driver) => driver.id === vectorStoreConfig.currentDriver)
453
+ const isStoreUnavailable = activeDriver?.available === false
454
+ const storeUnavailableReason = activeDriver?.unavailableReason ?? null
455
+
456
+ const storeUnavailableBanner = isStoreUnavailable ? (
457
+ <div className="p-4 rounded-md bg-status-warning-bg border border-status-warning-border">
458
+ <div className="flex items-start gap-3">
459
+ <svg className="h-5 w-5 text-status-warning-icon flex-shrink-0 mt-0.5" fill="none" viewBox="0 0 24 24" stroke="currentColor">
460
+ <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z" />
461
+ </svg>
462
+ <div>
463
+ <p className="text-sm font-medium text-status-warning-text">
464
+ {t('search.settings.vector.storeUnavailable', 'Vector store is not available')}
465
+ </p>
466
+ <p className="text-xs text-status-warning-text mt-1">
467
+ {t('search.settings.vector.storeUnavailableHint', 'Vector indexing and semantic search are skipped until the store is reachable. Install the pgvector extension on your PostgreSQL server; the status is rechecked about once a minute.')}
468
+ </p>
469
+ {storeUnavailableReason ? (
470
+ <p className="text-xs text-status-warning-text mt-1 font-mono">{storeUnavailableReason}</p>
471
+ ) : null}
472
+ </div>
473
+ </div>
474
+ </div>
475
+ ) : null
476
+
450
477
  const autoIndexingChecked = embeddingSettings ? embeddingSettings.autoIndexingEnabled : true
451
478
  const autoIndexingDisabled = embeddingLoading || embeddingSaving || Boolean(embeddingSettings?.autoIndexingLocked)
452
479
 
@@ -481,13 +508,14 @@ export function VectorSearchSection({
481
508
  </div>
482
509
  ) : (
483
510
  <div className="space-y-4">
511
+ {storeUnavailableBanner}
484
512
  {/* Vector Store Driver Status */}
485
513
  <div>
486
514
  <h3 className="text-sm font-semibold mb-2">{t('search.settings.vector.store', 'Vector Store')}</h3>
487
515
  <div className="grid gap-2 sm:grid-cols-3">
488
516
  {vectorStoreConfig?.drivers.map((driver) => {
489
517
  const isCurrent = driver.id === vectorStoreConfig.currentDriver
490
- const isReady = driver.configured && driver.implemented
518
+ const isReady = driver.configured && driver.implemented && driver.available !== false
491
519
  return (
492
520
  <div
493
521
  key={driver.id}
@@ -746,6 +774,8 @@ export function VectorSearchSection({
746
774
  <Spinner size="sm" />
747
775
  <span>{t('search.settings.loadingLabel', 'Loading settings...')}</span>
748
776
  </div>
777
+ ) : isStoreUnavailable ? (
778
+ storeUnavailableBanner
749
779
  ) : !isEmbeddingConfigured ? (
750
780
  <div className="p-4 rounded-md bg-status-warning-bg border border-status-warning-border">
751
781
  <div className="flex items-start gap-3">
@@ -50,13 +50,14 @@ const vectorStoreConfig: NonNullable<VectorSearchSectionProps['vectorStoreConfig
50
50
 
51
51
  function renderSection(
52
52
  settings: NonNullable<VectorSearchSectionProps['embeddingSettings']> = embeddingSettings,
53
+ storeConfig: NonNullable<VectorSearchSectionProps['vectorStoreConfig']> = vectorStoreConfig,
53
54
  ) {
54
55
  return render(
55
56
  <I18nProvider locale="en" dict={{}}>
56
57
  <VectorSearchSection
57
58
  embeddingSettings={settings}
58
59
  embeddingLoading={false}
59
- vectorStoreConfig={vectorStoreConfig}
60
+ vectorStoreConfig={storeConfig}
60
61
  vectorStoreConfigLoading={false}
61
62
  vectorReindexLock={null}
62
63
  onEmbeddingSettingsUpdate={jest.fn()}
@@ -113,3 +114,37 @@ describe('VectorSearchSection provider controls', () => {
113
114
  expect(document.getElementById('provider-ollama-configuration')).toBeNull()
114
115
  })
115
116
  })
117
+
118
+ describe('VectorSearchSection store availability', () => {
119
+ beforeEach(() => {
120
+ Object.defineProperty(globalThis, 'fetch', {
121
+ configurable: true,
122
+ value: jest.fn(() => new Promise(() => undefined)),
123
+ })
124
+ })
125
+
126
+ it('warns that the vector store is unavailable and surfaces the driver reason', () => {
127
+ renderSection(embeddingSettings, {
128
+ ...vectorStoreConfig,
129
+ drivers: [
130
+ {
131
+ ...vectorStoreConfig.drivers[0],
132
+ available: false,
133
+ unavailableReason: 'extension "vector" is not available on this PostgreSQL server',
134
+ },
135
+ ],
136
+ })
137
+
138
+ expect(screen.getByText('Vector store is not available')).toBeTruthy()
139
+ expect(screen.getByText(/extension "vector" is not available/)).toBeTruthy()
140
+ })
141
+
142
+ it('keeps the banner hidden while the store is reachable', () => {
143
+ renderSection(embeddingSettings, {
144
+ ...vectorStoreConfig,
145
+ drivers: [{ ...vectorStoreConfig.drivers[0], available: true, unavailableReason: null }],
146
+ })
147
+
148
+ expect(screen.queryByText('Vector store is not available')).toBeNull()
149
+ })
150
+ })
@@ -214,6 +214,8 @@
214
214
  "search.settings.vector.sectionTitle": "Vektorsuche",
215
215
  "search.settings.vector.setEnvVar": "Umgebungsvariable setzen",
216
216
  "search.settings.vector.store": "Vektorspeicher",
217
+ "search.settings.vector.storeUnavailable": "Vektorspeicher ist nicht verfügbar",
218
+ "search.settings.vector.storeUnavailableHint": "Vektorindizierung und semantische Suche werden übersprungen, bis der Speicher erreichbar ist. Installieren Sie die pgvector-Erweiterung auf Ihrem PostgreSQL-Server; der Status wird etwa einmal pro Minute neu geprüft.",
217
219
  "search.settings.vector.usingTenantConfig": "Dieser Mandant verwendet eigene Embedding-Einstellungen.",
218
220
  "search.settings.vectorDocumentsLabel": "Vektordokumente",
219
221
  "search.settings.vectorNotConfigured": "Vektorsuche ist nicht konfiguriert.",
@@ -214,6 +214,8 @@
214
214
  "search.settings.vector.sectionTitle": "Vector Search",
215
215
  "search.settings.vector.setEnvVar": "Set environment variable",
216
216
  "search.settings.vector.store": "Vector store",
217
+ "search.settings.vector.storeUnavailable": "Vector store is not available",
218
+ "search.settings.vector.storeUnavailableHint": "Vector indexing and semantic search are skipped until the store is reachable. Install the pgvector extension on your PostgreSQL server; the status is rechecked about once a minute.",
217
219
  "search.settings.vector.usingTenantConfig": "This tenant is using its own embedding settings.",
218
220
  "search.settings.vectorDocumentsLabel": "Vector documents",
219
221
  "search.settings.vectorNotConfigured": "Vector search is not configured.",
@@ -214,6 +214,8 @@
214
214
  "search.settings.vector.sectionTitle": "Búsqueda vectorial",
215
215
  "search.settings.vector.setEnvVar": "Configurar variable de entorno",
216
216
  "search.settings.vector.store": "Almacén vectorial",
217
+ "search.settings.vector.storeUnavailable": "El almacén vectorial no está disponible",
218
+ "search.settings.vector.storeUnavailableHint": "La indexación vectorial y la búsqueda semántica se omiten hasta que el almacén esté disponible. Instala la extensión pgvector en tu servidor PostgreSQL; el estado se vuelve a comprobar aproximadamente cada minuto.",
217
219
  "search.settings.vector.usingTenantConfig": "Este inquilino usa su propia configuración de incrustaciones.",
218
220
  "search.settings.vectorDocumentsLabel": "Documentos vectoriales",
219
221
  "search.settings.vectorNotConfigured": "La búsqueda vectorial no está configurada.",