@venizia/ignis-connectors 0.4.7-5 → 0.4.7-6

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 (39) hide show
  1. package/dist/esm/search/core/connector.d.ts +25 -2
  2. package/dist/esm/search/core/connector.d.ts.map +1 -1
  3. package/dist/esm/search/core/connector.js.map +1 -1
  4. package/dist/esm/search/core/controllers/factory.d.ts +1 -0
  5. package/dist/esm/search/core/controllers/factory.d.ts.map +1 -1
  6. package/dist/esm/search/core/repositories/common/constants.d.ts +1 -0
  7. package/dist/esm/search/core/repositories/common/constants.d.ts.map +1 -1
  8. package/dist/esm/search/core/repositories/common/constants.js +3 -1
  9. package/dist/esm/search/core/repositories/common/constants.js.map +1 -1
  10. package/dist/esm/search/core/repositories/core/readable.d.ts +38 -1
  11. package/dist/esm/search/core/repositories/core/readable.d.ts.map +1 -1
  12. package/dist/esm/search/core/repositories/core/readable.js +96 -1
  13. package/dist/esm/search/core/repositories/core/readable.js.map +1 -1
  14. package/dist/esm/search/meilisearch/internal/connector-internal.d.ts +6 -1
  15. package/dist/esm/search/meilisearch/internal/connector-internal.d.ts.map +1 -1
  16. package/dist/esm/search/meilisearch/internal/connector-internal.js +36 -1
  17. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  18. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.d.ts.map +1 -1
  19. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js +4 -0
  20. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  21. package/dist/esm/search/typesense/connector.d.ts +1 -1
  22. package/dist/esm/search/typesense/connector.d.ts.map +1 -1
  23. package/dist/esm/search/typesense/connector.js +10 -6
  24. package/dist/esm/search/typesense/connector.js.map +1 -1
  25. package/dist/esm/search/typesense/internal/connector-internal.d.ts +9 -0
  26. package/dist/esm/search/typesense/internal/connector-internal.d.ts.map +1 -1
  27. package/dist/esm/search/typesense/internal/connector-internal.js +15 -0
  28. package/dist/esm/search/typesense/internal/connector-internal.js.map +1 -1
  29. package/dist/esm/search/typesense/internal/mappers.d.ts +7 -1
  30. package/dist/esm/search/typesense/internal/mappers.d.ts.map +1 -1
  31. package/dist/esm/search/typesense/internal/mappers.js +54 -1
  32. package/dist/esm/search/typesense/internal/mappers.js.map +1 -1
  33. package/dist/esm/search/typesense/repositories/common/types.d.ts +27 -2
  34. package/dist/esm/search/typesense/repositories/common/types.d.ts.map +1 -1
  35. package/dist/esm/search/typesense/repositories/common/types.js.map +1 -1
  36. package/dist/esm/search/typesense/repositories/dialect/query-dialect.d.ts.map +1 -1
  37. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js +87 -1
  38. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  39. package/package.json +3 -3
@@ -21,8 +21,29 @@ export interface ISearchConnectorCallbacks {
21
21
  error: unknown;
22
22
  }) => void;
23
23
  }
24
- /** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */
25
- export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = unknown, GroupedHitType = unknown> {
24
+ /** One value of a facet: how many matching documents carry it. `value` is always a string, numbers included, as the engine sends it. */
25
+ export interface ISearchFacetValue {
26
+ value: string;
27
+ count: number;
28
+ highlighted?: string;
29
+ }
30
+ /** Numeric statistics an engine reports for a numeric facet field; only the members the engine returned are set. */
31
+ export interface ISearchFacetStats {
32
+ avg?: number;
33
+ max?: number;
34
+ min?: number;
35
+ sum?: number;
36
+ totalValues?: number;
37
+ }
38
+ /** The counts of one faceted field. `sampled` is set when the engine counted a sample of the matches instead of all of them. */
39
+ export interface ISearchFacetCount {
40
+ fieldName: string;
41
+ counts: ISearchFacetValue[];
42
+ sampled?: boolean;
43
+ stats?: ISearchFacetStats;
44
+ }
45
+ /** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. A hit's `score` is the keyword match score in every mode, hybrid included; `rankFusionScore` and `vectorDistance` are the hybrid and vector scores, set only by an engine that reports them. */
46
+ export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = ISearchFacetCount, GroupedHitType = unknown> {
26
47
  found: number;
27
48
  isFoundExact: boolean;
28
49
  outOf?: number;
@@ -32,6 +53,8 @@ export interface ISearchResult<DocumentType extends object = object, HighlightTy
32
53
  highlight?: HighlightType;
33
54
  highlights?: HighlightType[];
34
55
  score?: number;
56
+ rankFusionScore?: number;
57
+ vectorDistance?: number;
35
58
  }>;
36
59
  facetCounts?: FacetCountType[];
37
60
  groupedHits?: GroupedHitType[];
@@ -1 +1 @@
1
- {"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"connector.d.ts","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"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"}
@@ -1 +1 @@
1
- {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AA8IrD,MAAM,OAAgB,mBAAoB,SAAQ,UAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = unknown,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
1
+ {"version":3,"file":"connector.js","sourceRoot":"","sources":["../../../../src/search/core/connector.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AACvF,OAAO,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAwKrD,MAAM,OAAgB,mBAAoB,SAAQ,UAAU;IAC1D,YAAY,IAA2C;QACrD,KAAK,CAAC,IAAI,CAAC,CAAC;IACd,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC,EAAE,CAAC;IACnB,CAAC;IAES,cAAc,CAAC,IAA6D;QACpF,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACxC,MAAM,QAAQ,CAAC,EAAE,OAAO,EAAE,IAAI,MAAM,oCAAoC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,gHAAgH;IACtG,KAAK,CAAC,aAAa,CAAI,IAIhC;QACC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEvC,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,MAAM,GAAG,EAAE,CAAC;YACvB,OAAO,EAAE,CAAC;QACZ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC1B,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACxC,OAAO,EAAE,CAAC;YACZ,CAAC;YAED,0JAA0J;YAC1J,IAAI,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC;gBAC9B,MAAM,KAAK,CAAC;YACd,CAAC;YAED,uBAAuB,CAAC,mBAAmB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;QACtF,CAAC;IACH,CAAC;IAKD,2IAA2I;IACjI,iBAAiB,CAAC,IAAyC;QAInE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBACvD,uBAAuB,CAAC,kBAAkB,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YAClE,CAAC;SACF,CAAC;IACJ,CAAC;IAED,sKAAsK;IAC5J,gBAAgB,CAAI,IAK7B;QACC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;QAEjD,OAAO;YACL,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,CAAC;YAChD,MAAM,EAAE,GAAG,EAAE;gBACX,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;gBACxD,OAAO,QAAQ,CAAC;YAClB,CAAC;SACF,CAAC;IACJ,CAAC;CAkBF","sourcesContent":["import type { ISynonym } from '@/search/core/models';\nimport type { ValueOrPromise } from '@venizia/ignis-helpers/common';\nimport { BaseHelper, getError, isApplicationError } from '@venizia/ignis-helpers/core';\nimport { SearchConnectorInternal } from './internal';\n\nexport interface IImportResult<TResponse = unknown> {\n count: { success: number; fail: number };\n responses: TResponse[];\n}\n\nexport interface IAliasInfo {\n name: string;\n collection: string;\n}\n\nexport interface ISearchConnectorCallbacks {\n onInitialized?: (opts: { name: string }) => void;\n onError?: (opts: { name: string; error: unknown }) => void;\n}\n\n/** One value of a facet: how many matching documents carry it. `value` is always a string, numbers included, as the engine sends it. */\nexport interface ISearchFacetValue {\n value: string;\n count: number;\n highlighted?: string;\n}\n\n/** Numeric statistics an engine reports for a numeric facet field; only the members the engine returned are set. */\nexport interface ISearchFacetStats {\n avg?: number;\n max?: number;\n min?: number;\n sum?: number;\n totalValues?: number;\n}\n\n/** The counts of one faceted field. `sampled` is set when the engine counted a sample of the matches instead of all of them. */\nexport interface ISearchFacetCount {\n fieldName: string;\n counts: ISearchFacetValue[];\n sampled?: boolean;\n stats?: ISearchFacetStats;\n}\n\n/** Search-response envelope, read without a boundary cast. `score` scales are unrelated across engines - never compare or threshold one against another; `isFoundExact` is false when `found` is approximate. A hit's `score` is the keyword match score in every mode, hybrid included; `rankFusionScore` and `vectorDistance` are the hybrid and vector scores, set only by an engine that reports them. */\nexport interface ISearchResult<\n DocumentType extends object = object,\n HighlightType = unknown,\n FacetCountType = ISearchFacetCount,\n GroupedHitType = unknown,\n> {\n found: number;\n isFoundExact: boolean;\n outOf?: number;\n searchTimeMs?: number;\n hits?: Array<{\n document: DocumentType;\n highlight?: HighlightType;\n highlights?: HighlightType[];\n score?: number;\n rankFusionScore?: number;\n vectorDistance?: number;\n }>;\n facetCounts?: FacetCountType[];\n groupedHits?: GroupedHitType[];\n}\n\n// Schema/field types are engine-specific, not caller-owned - hence interface-level generics filled by the engine's connector, defaulting to `unknown` so `ISearchConnector` stays engine-agnostic.\nexport interface ISearchCollectionScoped<\n CreateSchema = unknown,\n Schema = unknown,\n FieldSchema = unknown,\n> {\n create(opts: { schema: CreateSchema }): Promise<Schema | void>;\n ensure(opts: { schema: CreateSchema }): Promise<Schema>;\n get(opts: { name: string }): Promise<Schema>;\n list(): Promise<Schema[]>;\n exists(opts: { name: string }): Promise<boolean>;\n patchSchema(opts: { name: string; fields: FieldSchema[] }): Promise<void>;\n delete(opts: { name: string }): Promise<boolean>;\n}\n\n/** A named pointer to one physical collection. Engines without aliases omit this group entirely. */\nexport interface ISearchAliasScoped {\n upsert(opts: { name: string; collection: string }): Promise<void>;\n get(opts: { name: string }): Promise<IAliasInfo | null>;\n}\n\n/** Atomic exchange of two collections' documents and settings - the alias-less path to a zero-downtime reindex. */\nexport interface ISearchSwapScoped {\n indexes(opts: { pairs: Array<[string, string]> }): Promise<void>;\n}\n\n// Synonym SETS (Typesense v30+): a named item set linked to one or more collections; `ISynonym` is the item shape.\nexport interface ISearchSynonymSetScoped {\n upsert(opts: { name: string; items: ISynonym[] }): Promise<void>;\n get(opts: { name: string }): Promise<ISynonym[] | null>;\n list(): Promise<string[]>;\n delete(opts: { name: string }): Promise<boolean>;\n link(opts: { collection: string; synonymSets: string[] }): Promise<void>;\n}\n\n/** A flat per-collection synonym dictionary - no named, linkable set resource. */\nexport interface ISearchSynonymScoped {\n set(opts: { collection: string; items: ISynonym[] }): Promise<void>;\n get(opts: { collection: string }): Promise<ISynonym[]>;\n reset(opts: { collection: string }): Promise<void>;\n}\n\nexport interface ISearchDocumentScoped {\n get<T extends object>(opts: { collection: string; id: string }): Promise<T>;\n\n /** Exact count of documents matching `filterBy`. Engines whose search endpoint caps or estimates its total must answer from a document-listing endpoint instead. */\n count(opts: { collection: string; filterBy?: string }): Promise<number>;\n\n create<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n\n upsert<T extends object>(opts: { collection: string; document: T }): Promise<T>;\n update<T extends object>(opts: {\n collection: string;\n id: string;\n document: Partial<T>;\n }): Promise<T>;\n updateBy<T extends object>(opts: {\n collection: string;\n document: Partial<T>;\n filterBy: string;\n }): Promise<{ updatedCount: number }>;\n\n delete(opts: { collection: string; id: string }): Promise<boolean>;\n deleteBy(opts: { collection: string; filterBy: string }): Promise<number>;\n deleteAll(opts: { collection: string }): Promise<boolean>;\n\n import<T extends object>(opts: {\n collection: string;\n documents: T[];\n batchSize?: number;\n }): Promise<IImportResult<unknown>>;\n export(opts: {\n collection: string;\n filterBy?: string;\n includeFields?: string[];\n }): Promise<string>;\n}\n\n/** The verb contract every search engine implements - an interface so tests can fake it clientless. `collection`/`document` are the true intersection; `alias`/`synonymSet`/`synonyms`/`swap` are optional since no engine has all four, so agnostic callers must write `connector.alias?.…`. */\nexport interface ISearchConnector {\n getHealth(): Promise<{ ok: boolean }>;\n ping(): Promise<boolean>;\n\n collection: ISearchCollectionScoped;\n document: ISearchDocumentScoped;\n\n alias?: ISearchAliasScoped;\n synonymSet?: ISearchSynonymSetScoped;\n synonyms?: ISearchSynonymScoped;\n swap?: ISearchSwapScoped;\n\n search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n options?: unknown;\n }): Promise<unknown>;\n}\n\nexport abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {\n constructor(opts: { scope: string; identifier: string }) {\n super(opts);\n }\n\n async ping(): Promise<boolean> {\n const health = await this.getHealth();\n return health.ok;\n }\n\n protected assertNonEmpty(opts: { value?: string | null; name: string; method: string }): void {\n const { value, name, method } = opts;\n if (!value || value.trim().length === 0) {\n throw getError({ message: `[${method}] Missing or empty value | name: ${name}` });\n }\n }\n\n // Runs the engine verb; tolerated errors route to the caller's branch, everything else becomes a sanitized 503.\n protected async runEngineCall<T>(opts: {\n method: string;\n run: () => ValueOrPromise<T>;\n tolerate?: { when: (error: unknown) => boolean; handle: (error: unknown) => ValueOrPromise<T> };\n }) {\n const { method, run, tolerate } = opts;\n\n try {\n const rs = await run();\n return rs;\n } catch (error) {\n if (tolerate?.when(error)) {\n const rs = await tolerate.handle(error);\n return rs;\n }\n\n // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode; only raw engine failures may be wrapped as a generic 503.\n if (isApplicationError(error)) {\n throw error;\n }\n\n SearchConnectorInternal.wrapDependencyError({ method, error, logger: this.logger });\n }\n }\n\n /** Which errors mean \"not found\" is engine-specific classification; the sanitized throw and the benign fallback are not. */\n protected abstract isNotFoundError(opts: { error: unknown }): boolean;\n\n /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */\n protected notFoundTolerance(opts: { method: string; subject: string }): {\n when: (error: unknown) => boolean;\n handle: (error: unknown) => never;\n } {\n const { method, subject } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug('%s not found', subject);\n SearchConnectorInternal.throwNotFoundError({ method, subject });\n },\n };\n }\n\n /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */\n protected notFoundFallback<T>(opts: {\n method: string;\n message: string;\n args?: unknown[];\n fallback: T;\n }): { when: (error: unknown) => boolean; handle: (error: unknown) => T } {\n const { method, message, args, fallback } = opts;\n\n return {\n when: (error) => this.isNotFoundError({ error }),\n handle: () => {\n this.logger.for(method).debug(message, ...(args ?? []));\n return fallback;\n },\n };\n }\n\n abstract getHealth(): Promise<{ ok: boolean }>;\n\n // Resource-scoped verb groups, each supplied by the concrete connector as a facade object; only the intersection is abstract - an engine declares its own alias/synonymSet/synonyms/swap.\n abstract collection: ISearchCollectionScoped;\n abstract document: ISearchDocumentScoped;\n\n abstract search<TDocument extends object = object>(opts: {\n collection: string;\n params: unknown;\n }): Promise<ISearchResult<TDocument>>;\n\n abstract multiSearch(opts: {\n searches: unknown[];\n union?: boolean;\n commonParams?: unknown;\n }): Promise<unknown>;\n}\n"]}
@@ -94,6 +94,7 @@ export declare class SearchControllerFactory extends BaseHelper {
94
94
  mode: z.ZodLiteral<"keyword">;
95
95
  query: z.ZodOptional<z.ZodString>;
96
96
  queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
97
+ highlight: z.ZodOptional<z.ZodBoolean>;
97
98
  filter: z.ZodOptional<z.ZodObject<{
98
99
  where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
99
100
  fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
@@ -1 +1 @@
1
- {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":"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"}
@@ -27,6 +27,7 @@ export declare const SearchInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
27
27
  mode: z.ZodLiteral<"keyword">;
28
28
  query: z.ZodOptional<z.ZodString>;
29
29
  queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
30
+ highlight: z.ZodOptional<z.ZodBoolean>;
30
31
  filter: z.ZodOptional<z.ZodObject<{
31
32
  where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
32
33
  fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
@@ -1 +1 @@
1
- {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAQjE,oHAAoH;AACpH,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAE5B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiE;IAE3F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AACD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAsF1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAK5B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+RAA+R;AAC/R,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;iBAe2B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKsD,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
1
+ {"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAQjE,oHAAoH;AACpH,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAE5B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiE;IAE3F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AACD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAwF1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAK5B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+RAA+R;AAC/R,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;iBAe2B,CAAC;AAC/D,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAEvE,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKsD,CAAC;AAC1F,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}
@@ -41,7 +41,7 @@ const commonSearchParamsShape = {
41
41
  groupLimit: z.number().optional(),
42
42
  groupMissingValues: z.boolean().optional(),
43
43
  queryByWeights: z.array(z.number()).optional(),
44
- /** Escape hatch for engine-specific tuning: keys are the engine's OWN wire names (`num_typos`, not `numTypos`), merged verbatim and unvalidated after every neutral param. */
44
+ /** Escape hatch for engine-specific tuning, merged after every neutral param. Keys are the engine's own wire names, passed verbatim; an engine may also accept camelCase names for its documented tuning (Typesense: `ITypesenseTuning`). */
45
45
  engineParams: z.record(z.string(), z.unknown()).optional(),
46
46
  };
47
47
  const KeywordSearchSchema = z
@@ -49,6 +49,8 @@ const KeywordSearchSchema = z
49
49
  mode: z.literal(SearchModes.KEYWORD),
50
50
  query: z.string().optional(),
51
51
  queryBy: z.array(z.string()).optional(),
52
+ /** `false` returns no highlight markup. It wins over `highlightFields`. */
53
+ highlight: z.boolean().optional(),
52
54
  filter: SearchFilterSchema,
53
55
  ...commonSearchParamsShape,
54
56
  })
@@ -1 +1 @@
1
- {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import { QuerySchemaFactory } from '@venizia/ignis-filter/schemas';\nimport { z } from 'zod';\nimport type { TConstValue } from '@venizia/ignis-helpers/common';\n\nconst { FieldsSchema, LimitSchema, OffsetSchema, OrderBySchema, SkipSchema, WhereSchema } =\n QuerySchemaFactory.build({\n // zod's own `.meta()`, which the OpenAPI generator reads: this layer must load without hono.\n decorate: (schema, metadata) => (schema instanceof z.ZodType ? schema.meta(metadata) : schema),\n });\n\n/** Discriminant values for `TSearchInput.mode` - which search strategy `ReadableSearchRepository.search()` runs. */\nexport class SearchModes {\n static readonly KEYWORD = 'keyword';\n static readonly SEMANTIC = 'semantic';\n static readonly HYBRID = 'hybrid';\n static readonly RAW = 'raw';\n\n static readonly SCHEME_SET = new Set([this.KEYWORD, this.SEMANTIC, this.HYBRID, this.RAW]);\n\n static isValid(input: string): input is TSearchMode {\n return this.SCHEME_SET.has(input);\n }\n}\nexport type TSearchMode = TConstValue<typeof SearchModes>;\n\n/** Reassembled from FilterSchema's atomic pieces minus `include`: search has no relations. */\nconst SearchFilterSchema = z\n .object({\n where: WhereSchema.optional(),\n fields: FieldsSchema,\n order: OrderBySchema,\n limit: LimitSchema,\n offset: OffsetSchema,\n skip: SkipSchema,\n })\n .optional()\n .describe(\n 'Search-scoped filter - same shape as the repository TFilter minus include (search has no relations)',\n );\n\n/** Shape object (NOT a z.object) so it spreads into each mode's z.object; `raw` mode skips it. Only cross-engine params live here - engine-specific tuning goes through `engineParams`. */\nconst commonSearchParamsShape = {\n facetBy: z.array(z.string()).optional(),\n facetQuery: z.string().optional(),\n maxFacetValues: z.number().optional(),\n\n highlightFields: z.array(z.string()).optional(),\n highlightFullFields: z.array(z.string()).optional(),\n highlightStartTag: z.string().optional(),\n highlightEndTag: z.string().optional(),\n snippetThreshold: z.number().optional(),\n\n groupBy: z.array(z.string()).optional(),\n groupLimit: z.number().optional(),\n groupMissingValues: z.boolean().optional(),\n\n queryByWeights: z.array(z.number()).optional(),\n\n /** Escape hatch for engine-specific tuning: keys are the engine's OWN wire names (`num_typos`, not `numTypos`), merged verbatim and unvalidated after every neutral param. */\n engineParams: z.record(z.string(), z.unknown()).optional(),\n};\n\nconst KeywordSearchSchema = z\n .object({\n mode: z.literal(SearchModes.KEYWORD),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n })\n .describe('Keyword full-text search');\n\nconst SemanticSearchSchema = z\n .object({\n mode: z.literal(SearchModes.SEMANTIC),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n queryText: z.string().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Vector / semantic search');\n\nconst HybridSearchSchema = z\n .object({\n mode: z.literal(SearchModes.HYBRID),\n query: z.string(),\n queryBy: z.array(z.string()),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n alpha: z.number().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Hybrid keyword + vector search');\n\nconst RawSearchSchema = z\n .object({\n mode: z.literal(SearchModes.RAW),\n params: z.record(z.string(), z.any()),\n })\n .describe('Raw engine passthrough');\n\nexport const SearchInputSchema = z.discriminatedUnion('mode', [\n KeywordSearchSchema,\n SemanticSearchSchema,\n HybridSearchSchema,\n RawSearchSchema,\n]);\nexport type TSearchInput = z.infer<typeof SearchInputSchema>;\n\n/** One collection's query within a multi-search - same friendly field names as `search()`. `filterBy` is a raw engine filter string because cross-collection search has no per-collection model to translate a `TFilter` against; the datasource maps entries to wire form via the dialect. */\nexport const MultiSearchEntrySchema = z\n .object({\n collection: z.string(),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n filterBy: z.string().optional(),\n sortBy: z.string().optional(),\n page: z.number().optional(),\n perPage: z.number().optional(),\n offset: z.number().optional(),\n includeFields: z.array(z.string()).optional(),\n excludeFields: z.array(z.string()).optional(),\n vectorQuery: z.string().optional(),\n ...commonSearchParamsShape,\n })\n .describe('A single collection query within a multi-search');\nexport type TMultiSearchEntry = z.infer<typeof MultiSearchEntrySchema>;\n\n/** Cross-collection multi-search input: friendly `searches` entries plus the union flag. */\nexport const MultiSearchInputSchema = z\n .object({\n searches: z.array(MultiSearchEntrySchema).min(1),\n union: z.boolean().optional(),\n })\n .describe('Cross-collection multi-search (federated by default; union merges results)');\nexport type TMultiSearchInput = z.infer<typeof MultiSearchInputSchema>;\n"]}
1
+ {"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"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","sourcesContent":["import { QuerySchemaFactory } from '@venizia/ignis-filter/schemas';\nimport { z } from 'zod';\nimport type { TConstValue } from '@venizia/ignis-helpers/common';\n\nconst { FieldsSchema, LimitSchema, OffsetSchema, OrderBySchema, SkipSchema, WhereSchema } =\n QuerySchemaFactory.build({\n // zod's own `.meta()`, which the OpenAPI generator reads: this layer must load without hono.\n decorate: (schema, metadata) => (schema instanceof z.ZodType ? schema.meta(metadata) : schema),\n });\n\n/** Discriminant values for `TSearchInput.mode` - which search strategy `ReadableSearchRepository.search()` runs. */\nexport class SearchModes {\n static readonly KEYWORD = 'keyword';\n static readonly SEMANTIC = 'semantic';\n static readonly HYBRID = 'hybrid';\n static readonly RAW = 'raw';\n\n static readonly SCHEME_SET = new Set([this.KEYWORD, this.SEMANTIC, this.HYBRID, this.RAW]);\n\n static isValid(input: string): input is TSearchMode {\n return this.SCHEME_SET.has(input);\n }\n}\nexport type TSearchMode = TConstValue<typeof SearchModes>;\n\n/** Reassembled from FilterSchema's atomic pieces minus `include`: search has no relations. */\nconst SearchFilterSchema = z\n .object({\n where: WhereSchema.optional(),\n fields: FieldsSchema,\n order: OrderBySchema,\n limit: LimitSchema,\n offset: OffsetSchema,\n skip: SkipSchema,\n })\n .optional()\n .describe(\n 'Search-scoped filter - same shape as the repository TFilter minus include (search has no relations)',\n );\n\n/** Shape object (NOT a z.object) so it spreads into each mode's z.object; `raw` mode skips it. Only cross-engine params live here - engine-specific tuning goes through `engineParams`. */\nconst commonSearchParamsShape = {\n facetBy: z.array(z.string()).optional(),\n facetQuery: z.string().optional(),\n maxFacetValues: z.number().optional(),\n\n highlightFields: z.array(z.string()).optional(),\n highlightFullFields: z.array(z.string()).optional(),\n highlightStartTag: z.string().optional(),\n highlightEndTag: z.string().optional(),\n snippetThreshold: z.number().optional(),\n\n groupBy: z.array(z.string()).optional(),\n groupLimit: z.number().optional(),\n groupMissingValues: z.boolean().optional(),\n\n queryByWeights: z.array(z.number()).optional(),\n\n /** Escape hatch for engine-specific tuning, merged after every neutral param. Keys are the engine's own wire names, passed verbatim; an engine may also accept camelCase names for its documented tuning (Typesense: `ITypesenseTuning`). */\n engineParams: z.record(z.string(), z.unknown()).optional(),\n};\n\nconst KeywordSearchSchema = z\n .object({\n mode: z.literal(SearchModes.KEYWORD),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n /** `false` returns no highlight markup. It wins over `highlightFields`. */\n highlight: z.boolean().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n })\n .describe('Keyword full-text search');\n\nconst SemanticSearchSchema = z\n .object({\n mode: z.literal(SearchModes.SEMANTIC),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n queryText: z.string().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Vector / semantic search');\n\nconst HybridSearchSchema = z\n .object({\n mode: z.literal(SearchModes.HYBRID),\n query: z.string(),\n queryBy: z.array(z.string()),\n vectorField: z.string(),\n nearVector: z.array(z.number()).optional(),\n alpha: z.number().optional(),\n k: z.number().optional(),\n filter: SearchFilterSchema,\n ...commonSearchParamsShape,\n distanceThreshold: z.number().optional(),\n ef: z.number().optional(),\n })\n .describe('Hybrid keyword + vector search');\n\nconst RawSearchSchema = z\n .object({\n mode: z.literal(SearchModes.RAW),\n params: z.record(z.string(), z.any()),\n })\n .describe('Raw engine passthrough');\n\nexport const SearchInputSchema = z.discriminatedUnion('mode', [\n KeywordSearchSchema,\n SemanticSearchSchema,\n HybridSearchSchema,\n RawSearchSchema,\n]);\nexport type TSearchInput = z.infer<typeof SearchInputSchema>;\n\n/** One collection's query within a multi-search - same friendly field names as `search()`. `filterBy` is a raw engine filter string because cross-collection search has no per-collection model to translate a `TFilter` against; the datasource maps entries to wire form via the dialect. */\nexport const MultiSearchEntrySchema = z\n .object({\n collection: z.string(),\n query: z.string().optional(),\n queryBy: z.array(z.string()).optional(),\n filterBy: z.string().optional(),\n sortBy: z.string().optional(),\n page: z.number().optional(),\n perPage: z.number().optional(),\n offset: z.number().optional(),\n includeFields: z.array(z.string()).optional(),\n excludeFields: z.array(z.string()).optional(),\n vectorQuery: z.string().optional(),\n ...commonSearchParamsShape,\n })\n .describe('A single collection query within a multi-search');\nexport type TMultiSearchEntry = z.infer<typeof MultiSearchEntrySchema>;\n\n/** Cross-collection multi-search input: friendly `searches` entries plus the union flag. */\nexport const MultiSearchInputSchema = z\n .object({\n searches: z.array(MultiSearchEntrySchema).min(1),\n union: z.boolean().optional(),\n })\n .describe('Cross-collection multi-search (federated by default; union merges results)');\nexport type TMultiSearchInput = z.infer<typeof MultiSearchInputSchema>;\n"]}
@@ -1,7 +1,7 @@
1
1
  import type { TNullable } from '@venizia/ignis-helpers/common';
2
2
  import type { IExtraOptions, TCount, TByIdFilter, TDataWithRange, TFields, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TRow, TWhere } from '@venizia/ignis-kernel';
3
3
  import type { IdType } from '@venizia/ignis-kernel';
4
- import type { ISearchResult } from '../../index.js';
4
+ import type { ISearchFacetCount, ISearchResult } from '../../index.js';
5
5
  import type { TSearchInput } from '../common/index.js';
6
6
  import { SearchModes } from '../common/index.js';
7
7
  import type { AbstractSearchDataSource } from '../../datasources/index.js';
@@ -51,6 +51,43 @@ export declare class ReadableSearchRepository<TDocument extends object = object,
51
51
  search<R extends object = TDocument>(opts: TSearchInput & {
52
52
  options?: IExtraOptions;
53
53
  }): Promise<ISearchResult<R>>;
54
+ /** The count of a text search: how many documents match `query` and `where`. Unlike `count()`, which asks the document endpoint for an exact filter-only total, this goes through search, so `isFoundExact` says whether the engine stopped early and `count` is an estimate. */
55
+ searchCount(opts: {
56
+ query: string;
57
+ queryBy?: string[];
58
+ where?: TWhere;
59
+ options?: IExtraOptions;
60
+ }): Promise<{
61
+ count: number;
62
+ isFoundExact: boolean;
63
+ }>;
64
+ /** Facet counts without hits, over the documents that match `query` (all of them when omitted) and `where`. `maxFacetValues` and `facetQuery` are for engines that take them; the others refuse them. */
65
+ facets(opts: {
66
+ facetBy: string[];
67
+ query?: string;
68
+ queryBy?: string[];
69
+ where?: TWhere;
70
+ maxFacetValues?: number;
71
+ facetQuery?: string;
72
+ options?: IExtraOptions;
73
+ }): Promise<{
74
+ facets: ISearchFacetCount[];
75
+ found: number;
76
+ isFoundExact: boolean;
77
+ }>;
78
+ /** Autocomplete: documents whose fields match `query` as typed so far. A keyword search with highlighting off and a small page (`limit`, 8 by default); the last word matches as a prefix, which both engines do by default. A blank `query` answers an empty list without asking the engine. */
79
+ suggest<R extends object = TDocument>(opts: {
80
+ query: string;
81
+ queryBy?: string[];
82
+ limit?: number;
83
+ includeFields?: string[];
84
+ where?: TWhere;
85
+ options?: IExtraOptions;
86
+ }): Promise<R[]>;
87
+ /** Documents lose their hidden fields on the way out, but a facet count or a match on one would still tell the caller what the field holds; so they are refused as `facetBy`, in `facetQuery`, as `queryBy`, as `groupBy` and in the highlight fields (a group key and a highlight snippet carry the value too). */
88
+ protected assertNoHiddenFieldsNamed(opts: {
89
+ input: TTranslatableSearchInput;
90
+ }): void;
54
91
  protected withDefaultQueryBy(opts: {
55
92
  input: TTranslatableSearchInput;
56
93
  }): TTranslatableSearchInput;
@@ -1 +1 @@
1
- {"version":3,"file":"readable.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/readable.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"readable.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/readable.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,11 @@
1
1
  import { DataRangeUtility, DEFAULT_LIMIT } from '@venizia/ignis-kernel/repository';
2
+ import { getError } from '@venizia/ignis-helpers/core';
2
3
  import { SearchModes } from '../common/index.js';
3
4
  import { SearchBaseRepository } from './base.js';
4
5
  /** The match-everything term. `build()` already seeds `query` with it, so a filter-only listing reaches the engine as `q: '*'` - naming fields for a term that ignores fields would mean nothing. */
5
6
  const WILDCARD_QUERY = '*';
7
+ /** The page size of `suggest()` when the caller gives none. */
8
+ const SUGGEST_DEFAULT_LIMIT = 8;
6
9
  /** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */
7
10
  export class ReadableSearchRepository extends SearchBaseRepository {
8
11
  async count(opts) {
@@ -122,7 +125,9 @@ export class ReadableSearchRepository extends SearchBaseRepository {
122
125
  filter: opts.filter,
123
126
  shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,
124
127
  });
125
- this.queryDialect.applySearchInput({ query, input: this.withDefaultQueryBy({ input: opts }) });
128
+ const input = this.withDefaultQueryBy({ input: opts });
129
+ this.assertNoHiddenFieldsNamed({ input });
130
+ this.queryDialect.applySearchInput({ query, input });
126
131
  // Same short-circuit as find(): an absorbing filter cannot be expressed to the engine, and
127
132
  // omitting it would search everything.
128
133
  // `isFoundExact` is true because zero is not an estimate - nothing was searched to approximate.
@@ -141,6 +146,96 @@ export class ReadableSearchRepository extends SearchBaseRepository {
141
146
  })),
142
147
  };
143
148
  }
149
+ /** The count of a text search: how many documents match `query` and `where`. Unlike `count()`, which asks the document endpoint for an exact filter-only total, this goes through search, so `isFoundExact` says whether the engine stopped early and `count` is an estimate. */
150
+ async searchCount(opts) {
151
+ const { query, queryBy, where, options } = opts;
152
+ const result = await this.search({
153
+ mode: SearchModes.KEYWORD,
154
+ query,
155
+ queryBy,
156
+ filter: { where, limit: 0 },
157
+ options,
158
+ });
159
+ return { count: result.found, isFoundExact: result.isFoundExact };
160
+ }
161
+ /** Facet counts without hits, over the documents that match `query` (all of them when omitted) and `where`. `maxFacetValues` and `facetQuery` are for engines that take them; the others refuse them. */
162
+ async facets(opts) {
163
+ const { facetBy, query, queryBy, where, maxFacetValues, facetQuery, options } = opts;
164
+ if (facetBy.length === 0 || facetBy.some((name) => name.trim().length === 0)) {
165
+ throw getError({
166
+ message: `[${this.constructor.name}][facets] Invalid facetBy | Expected at least one non-empty field name | Got: ${JSON.stringify(facetBy)}`,
167
+ });
168
+ }
169
+ if (maxFacetValues !== undefined &&
170
+ (!Number.isInteger(maxFacetValues) || maxFacetValues <= 0)) {
171
+ throw getError({
172
+ message: `[${this.constructor.name}][facets] Invalid maxFacetValues | Expected a positive integer | Got: ${String(maxFacetValues)}`,
173
+ });
174
+ }
175
+ const result = await this.search({
176
+ mode: SearchModes.KEYWORD,
177
+ query: query ?? WILDCARD_QUERY,
178
+ queryBy,
179
+ facetBy,
180
+ facetQuery,
181
+ maxFacetValues,
182
+ filter: { where, limit: 0 },
183
+ options,
184
+ });
185
+ return {
186
+ facets: result.facetCounts ?? [],
187
+ found: result.found,
188
+ isFoundExact: result.isFoundExact,
189
+ };
190
+ }
191
+ /** Autocomplete: documents whose fields match `query` as typed so far. A keyword search with highlighting off and a small page (`limit`, 8 by default); the last word matches as a prefix, which both engines do by default. A blank `query` answers an empty list without asking the engine. */
192
+ async suggest(opts) {
193
+ const { query, queryBy, limit = SUGGEST_DEFAULT_LIMIT, includeFields, where, options } = opts;
194
+ if (!Number.isInteger(limit) || limit <= 0) {
195
+ throw getError({
196
+ message: `[${this.constructor.name}][suggest] Invalid limit | Expected a positive integer | Got: ${String(limit)}`,
197
+ });
198
+ }
199
+ if (query.trim().length === 0) {
200
+ return [];
201
+ }
202
+ const result = await this.search({
203
+ mode: SearchModes.KEYWORD,
204
+ query,
205
+ queryBy,
206
+ highlight: false,
207
+ filter: { where, fields: includeFields, limit },
208
+ options,
209
+ });
210
+ return (result.hits ?? []).map((hit) => hit.document);
211
+ }
212
+ /** Documents lose their hidden fields on the way out, but a facet count or a match on one would still tell the caller what the field holds; so they are refused as `facetBy`, in `facetQuery`, as `queryBy`, as `groupBy` and in the highlight fields (a group key and a highlight snippet carry the value too). */
213
+ assertNoHiddenFieldsNamed(opts) {
214
+ const { input } = opts;
215
+ if (this.hiddenFields.length === 0) {
216
+ return;
217
+ }
218
+ const named = [];
219
+ for (const param of ['facetBy', 'groupBy', 'highlightFields', 'highlightFullFields']) {
220
+ for (const field of input[param] ?? []) {
221
+ named.push({ param, field });
222
+ }
223
+ }
224
+ if (input.facetQuery !== undefined) {
225
+ named.push({ param: 'facetQuery', field: input.facetQuery.split(':')[0]?.trim() ?? '' });
226
+ }
227
+ if ('queryBy' in input) {
228
+ for (const field of input.queryBy ?? []) {
229
+ named.push({ param: 'queryBy', field });
230
+ }
231
+ }
232
+ const hidden = named.find(({ field }) => this.hiddenFields.includes(field));
233
+ if (hidden) {
234
+ throw getError({
235
+ message: `[${this.constructor.name}][search] '${hidden.param}' names a hidden field | field: '${hidden.field}' | hidden fields never leave the repository, so they cannot be counted, matched or faceted`,
236
+ });
237
+ }
238
+ }
144
239
  withDefaultQueryBy(opts) {
145
240
  const { input } = opts;
146
241
  if (input.mode !== SearchModes.KEYWORD || input.queryBy) {
@@ -1 +1 @@
1
- {"version":3,"file":"readable.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/readable.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TNullable } from '@venizia/ignis-helpers/common';\nimport type {\n IExtraOptions,\n TCount,\n TByIdFilter,\n TDataWithRange,\n TFields,\n TFilter,\n TFindOneOptions,\n TFindOptions,\n TFindRangeOptions,\n TRow,\n TWhere,\n} from '@venizia/ignis-kernel';\nimport { DataRangeUtility, DEFAULT_LIMIT } from '@venizia/ignis-kernel/repository';\nimport type { IdType } from '@venizia/ignis-kernel';\nimport type { ISearchResult } from '@/search/core';\nimport type { TSearchInput } from '@/search/core/repositories/common';\nimport { SearchModes } from '@/search/core/repositories/common';\nimport type { AbstractSearchDataSource } from '@/search/core/datasources';\nimport { SearchBaseRepository } from './base';\n\n/** The match-everything term. `build()` already seeds `query` with it, so a filter-only listing reaches the engine as `q: '*'` - naming fields for a term that ignores fields would mean nothing. */\nconst WILDCARD_QUERY = '*';\n\n/** The inputs the dialect translates - `raw` has already returned by the time these are resolved, and `applySearchInput` accepts only this narrowed union. */\ntype TTranslatableSearchInput = Exclude<TSearchInput, { mode: typeof SearchModes.RAW }>;\n\n/** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */\nexport class ReadableSearchRepository<\n TDocument extends object = object,\n TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource,\n> extends SearchBaseRepository<TDocument, TDataSource> {\n async count(opts: { where: TWhere; options?: IExtraOptions }): Promise<TCount> {\n this.assertNoTransaction(opts.options);\n this.assertNoLock(opts.options);\n\n const query = this.buildQuery({\n filter: { where: opts.where },\n shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,\n });\n\n // An absorbing where counts zero by definition. Asking the engine would mean sending NO\n // filterBy at all, which counts the entire collection.\n if (query.matchNone) {\n return { count: 0 };\n }\n\n // Counted through the document endpoint, never search: an engine whose search total is capped\n // or estimated would report a count that quietly lies.\n const count = await this.connector.document.count({\n collection: this.collectionName,\n filterBy: query.filterBy,\n });\n\n return { count };\n }\n\n async existsWith(opts: { where: TWhere; options?: IExtraOptions }): Promise<boolean> {\n const { count } = await this.count(opts);\n return count > 0;\n }\n\n find<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options: TFindRangeOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<TDataWithRange<TRow<TDocument, R, F>>>;\n\n find<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options?: TFindOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<Array<TRow<TDocument, R, F>>>;\n\n /**\n * Bare array or `{ data, range }` per shouldQueryRange, postgres-shaped range. Typesense returns\n * `found` in the same call as `hits`, so unlike SQL no second count query is needed.\n */\n async find<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options?:\n | TFindOptions<IExtraOptions, TRow<TDocument, R, F>>\n | TFindRangeOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<Array<TRow<TDocument, R, F>> | TDataWithRange<TRow<TDocument, R, F>>> {\n const { filter, options } = opts;\n\n if (options?.retry) {\n return options.shouldQueryRange === true\n ? this.findRangeUntil<TRow<TDocument, R, F>>({ filter, options })\n : this.findUntil<TRow<TDocument, R, F>>({ filter, options });\n }\n\n this.assertNoTransaction(options);\n this.assertNoLock(options);\n\n // An omitted limit falls back to @model settings.defaultLimit then DEFAULT_LIMIT - leaving\n // `per_page` unset would be an unbounded query.\n const effectiveFilter: TFilter = {\n ...filter,\n limit: filter?.limit ?? this.defaultLimit ?? DEFAULT_LIMIT,\n };\n\n const query = this.buildQuery({\n filter: effectiveFilter,\n shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,\n });\n\n // No round-trip for an absorbing where: with no filterBy the engine would happily return the\n // whole collection, which is the opposite of what the filter asked for.\n let result: Pick<ISearchResult<TDocument>, 'hits' | 'found'> = { hits: [], found: 0 };\n if (!query.matchNone) {\n const searched = await this.connector.search<TDocument>({\n collection: this.collectionName,\n params: this.queryDialect.toWireParams({ query }),\n });\n result = searched;\n }\n\n const { hits, found } = result;\n\n // The cast is the caller's own unchecked assertion when they pass an explicit `find<Other>()`.\n // Hidden fields are stripped in JS too, not only engine-side: Typesense honours\n // `exclude_fields`, Meilisearch has no per-query exclusion at all.\n const data = this.omitHiddenFieldsAll((hits ?? []).map((hit) => hit.document)) as any;\n\n if (!options?.shouldQueryRange) {\n return data;\n }\n\n return {\n data,\n range: DataRangeUtility.buildDataRange({\n skip: effectiveFilter.skip,\n offset: effectiveFilter.offset,\n dataLength: data.length,\n total: found,\n }),\n };\n }\n\n async findOne<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options?: TFindOneOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<TNullable<TRow<TDocument, R, F>>> {\n const { filter, options } = opts;\n\n if (options?.retry) {\n return this.findOneUntil<TRow<TDocument, R, F>>({ filter, options });\n }\n\n // `retry` is handled above so it is absent here; TFindOneOptions's retry generic (TNullable<R>)\n // does not unify with find's own (Array<R>), hence the options-only cast.\n const result = await this.find<R, F>({\n filter: { ...filter, limit: 1 },\n options: options as TFindOptions<IExtraOptions, TRow<TDocument, R, F>>,\n });\n const results = result as Array<TRow<TDocument, R, F>>;\n\n return results[0] ?? null;\n }\n\n /**\n * Delegates to findOne with id in where - routing through buildQuery is what makes\n * hiddenFields/defaultFilter apply, so a soft-deleted document resolves to null. `where` is spread\n * away last so a projection can never widen the id lookup.\n */\n findById<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n id: IdType;\n filter?: TByIdFilter<any, F>;\n options?: TFindOneOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<TNullable<TRow<TDocument, R, F>>> {\n const { id, filter, options } = opts;\n\n return this.findOne<R, F>({ filter: { ...filter, where: { id } }, options });\n }\n\n /**\n * Unified search entry discriminated by `mode`: `raw` is a full passthrough - no dialect, no\n * defaultFilter, no hiddenFields - while keyword/semantic/hybrid translate through the dialect\n * like `find()`. Nothing engine-specific lives here; `ISearchQueryDialect.applySearchInput`\n * owns it.\n */\n async search<R extends object = TDocument>(\n opts: TSearchInput & { options?: IExtraOptions },\n ): Promise<ISearchResult<R>> {\n if (opts.mode === SearchModes.RAW) {\n return this.connector.search<R>({\n collection: this.collectionName,\n params: opts.params,\n });\n }\n\n this.assertNoTransaction(opts.options);\n this.assertNoLock(opts.options);\n\n const query = this.buildQuery({\n filter: opts.filter,\n shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,\n });\n\n this.queryDialect.applySearchInput({ query, input: this.withDefaultQueryBy({ input: opts }) });\n\n // Same short-circuit as find(): an absorbing filter cannot be expressed to the engine, and\n // omitting it would search everything.\n // `isFoundExact` is true because zero is not an estimate - nothing was searched to approximate.\n if (query.matchNone) {\n return { hits: [], found: 0, isFoundExact: true };\n }\n\n const result = await this.connector.search<R>({\n collection: this.collectionName,\n params: this.queryDialect.toWireParams({ query }),\n });\n\n return {\n ...result,\n hits: (result.hits ?? []).map((hit) => ({\n ...hit,\n document: this.omitHiddenFields(hit.document),\n })),\n };\n }\n\n protected withDefaultQueryBy(opts: {\n input: TTranslatableSearchInput;\n }): TTranslatableSearchInput {\n const { input } = opts;\n\n if (input.mode !== SearchModes.KEYWORD || input.queryBy) {\n return input;\n }\n\n const term = input.query?.trim();\n\n if (!term || term === WILDCARD_QUERY) {\n return input;\n }\n\n const defaultQueryBy = this.entity?.schema?.defaultQueryBy;\n\n if (!defaultQueryBy || defaultQueryBy.length === 0) {\n return input;\n }\n\n return { ...input, queryBy: [...defaultQueryBy] };\n }\n\n /** @throws Error - disabled in a read-only repository; unlocked progressively by Persistable/DefaultSearchRepository. */\n create(opts: {\n data: TDocument;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n create<R = TDocument>(opts: {\n data: TDocument;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n create<R = TDocument>(_opts: {\n data: TDocument;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<R> }> {\n return this.denyOperation({ methodName: this.create.name });\n }\n\n /** @throws Error - disabled in a read-only repository. */\n createAll(opts: {\n data: Array<TDocument>;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n createAll<R = TDocument>(opts: {\n data: Array<TDocument>;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: Array<R> }>;\n createAll<R = TDocument>(_opts: {\n data: Array<TDocument>;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<Array<R>> }> {\n return this.denyOperation({ methodName: this.createAll.name });\n }\n\n /** @throws Error - disabled in a read-only repository. */\n updateById(opts: {\n id: IdType;\n data: Partial<TDocument>;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n updateById<R = TDocument>(opts: {\n id: IdType;\n data: Partial<TDocument>;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n updateById<R = TDocument>(_opts: {\n id: IdType;\n data: Partial<TDocument>;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<R> }> {\n return this.denyOperation({ methodName: this.updateById.name });\n }\n\n /**\n * @throws Error - disabled in a read-only repository. `where` is optional where the base contract\n * requires it: the `@model` defaultFilter alone can supply the effective filter, and Persistable\n * refuses the write outright when neither is present.\n */\n updateAll(_opts: {\n data: Partial<TDocument>;\n where?: TWhere;\n options?: Omit<IExtraOptions, 'shouldReturn'> & { force?: boolean };\n }): Promise<TCount & { data: null }> {\n return this.denyOperation({ methodName: this.updateAll.name });\n }\n\n /** @throws Error - disabled in a read-only repository. */\n deleteById(opts: {\n id: IdType;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n deleteById<R = TDocument>(opts: {\n id: IdType;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n deleteById<R = TDocument>(_opts: {\n id: IdType;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<R> }> {\n return this.denyOperation({ methodName: this.deleteById.name });\n }\n\n /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */\n deleteAll(_opts?: {\n where?: TWhere;\n options?: Omit<IExtraOptions, 'shouldReturn'> & { force?: boolean };\n }): Promise<TCount & { data: null }> {\n return this.denyOperation({ methodName: this.deleteAll.name });\n }\n}\n"]}
1
+ {"version":3,"file":"readable.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/core/readable.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TNullable } from '@venizia/ignis-helpers/common';\nimport type {\n IExtraOptions,\n TCount,\n TByIdFilter,\n TDataWithRange,\n TFields,\n TFilter,\n TFindOneOptions,\n TFindOptions,\n TFindRangeOptions,\n TRow,\n TWhere,\n} from '@venizia/ignis-kernel';\nimport { DataRangeUtility, DEFAULT_LIMIT } from '@venizia/ignis-kernel/repository';\nimport type { IdType } from '@venizia/ignis-kernel';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { ISearchFacetCount, ISearchResult } from '@/search/core';\nimport type { TSearchInput } from '@/search/core/repositories/common';\nimport { SearchModes } from '@/search/core/repositories/common';\nimport type { AbstractSearchDataSource } from '@/search/core/datasources';\nimport { SearchBaseRepository } from './base';\n\n/** The match-everything term. `build()` already seeds `query` with it, so a filter-only listing reaches the engine as `q: '*'` - naming fields for a term that ignores fields would mean nothing. */\nconst WILDCARD_QUERY = '*';\n\n/** The page size of `suggest()` when the caller gives none. */\nconst SUGGEST_DEFAULT_LIMIT = 8;\n\n/** The inputs the dialect translates - `raw` has already returned by the time these are resolved, and `applySearchInput` accepts only this narrowed union. */\ntype TTranslatableSearchInput = Exclude<TSearchInput, { mode: typeof SearchModes.RAW }>;\n\n/** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */\nexport class ReadableSearchRepository<\n TDocument extends object = object,\n TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource,\n> extends SearchBaseRepository<TDocument, TDataSource> {\n async count(opts: { where: TWhere; options?: IExtraOptions }): Promise<TCount> {\n this.assertNoTransaction(opts.options);\n this.assertNoLock(opts.options);\n\n const query = this.buildQuery({\n filter: { where: opts.where },\n shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,\n });\n\n // An absorbing where counts zero by definition. Asking the engine would mean sending NO\n // filterBy at all, which counts the entire collection.\n if (query.matchNone) {\n return { count: 0 };\n }\n\n // Counted through the document endpoint, never search: an engine whose search total is capped\n // or estimated would report a count that quietly lies.\n const count = await this.connector.document.count({\n collection: this.collectionName,\n filterBy: query.filterBy,\n });\n\n return { count };\n }\n\n async existsWith(opts: { where: TWhere; options?: IExtraOptions }): Promise<boolean> {\n const { count } = await this.count(opts);\n return count > 0;\n }\n\n find<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options: TFindRangeOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<TDataWithRange<TRow<TDocument, R, F>>>;\n\n find<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options?: TFindOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<Array<TRow<TDocument, R, F>>>;\n\n /**\n * Bare array or `{ data, range }` per shouldQueryRange, postgres-shaped range. Typesense returns\n * `found` in the same call as `hits`, so unlike SQL no second count query is needed.\n */\n async find<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options?:\n | TFindOptions<IExtraOptions, TRow<TDocument, R, F>>\n | TFindRangeOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<Array<TRow<TDocument, R, F>> | TDataWithRange<TRow<TDocument, R, F>>> {\n const { filter, options } = opts;\n\n if (options?.retry) {\n return options.shouldQueryRange === true\n ? this.findRangeUntil<TRow<TDocument, R, F>>({ filter, options })\n : this.findUntil<TRow<TDocument, R, F>>({ filter, options });\n }\n\n this.assertNoTransaction(options);\n this.assertNoLock(options);\n\n // An omitted limit falls back to @model settings.defaultLimit then DEFAULT_LIMIT - leaving\n // `per_page` unset would be an unbounded query.\n const effectiveFilter: TFilter = {\n ...filter,\n limit: filter?.limit ?? this.defaultLimit ?? DEFAULT_LIMIT,\n };\n\n const query = this.buildQuery({\n filter: effectiveFilter,\n shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,\n });\n\n // No round-trip for an absorbing where: with no filterBy the engine would happily return the\n // whole collection, which is the opposite of what the filter asked for.\n let result: Pick<ISearchResult<TDocument>, 'hits' | 'found'> = { hits: [], found: 0 };\n if (!query.matchNone) {\n const searched = await this.connector.search<TDocument>({\n collection: this.collectionName,\n params: this.queryDialect.toWireParams({ query }),\n });\n result = searched;\n }\n\n const { hits, found } = result;\n\n // The cast is the caller's own unchecked assertion when they pass an explicit `find<Other>()`.\n // Hidden fields are stripped in JS too, not only engine-side: Typesense honours\n // `exclude_fields`, Meilisearch has no per-query exclusion at all.\n const data = this.omitHiddenFieldsAll((hits ?? []).map((hit) => hit.document)) as any;\n\n if (!options?.shouldQueryRange) {\n return data;\n }\n\n return {\n data,\n range: DataRangeUtility.buildDataRange({\n skip: effectiveFilter.skip,\n offset: effectiveFilter.offset,\n dataLength: data.length,\n total: found,\n }),\n };\n }\n\n async findOne<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n filter: TFilter<any, F>;\n options?: TFindOneOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<TNullable<TRow<TDocument, R, F>>> {\n const { filter, options } = opts;\n\n if (options?.retry) {\n return this.findOneUntil<TRow<TDocument, R, F>>({ filter, options });\n }\n\n // `retry` is handled above so it is absent here; TFindOneOptions's retry generic (TNullable<R>)\n // does not unify with find's own (Array<R>), hence the options-only cast.\n const result = await this.find<R, F>({\n filter: { ...filter, limit: 1 },\n options: options as TFindOptions<IExtraOptions, TRow<TDocument, R, F>>,\n });\n const results = result as Array<TRow<TDocument, R, F>>;\n\n return results[0] ?? null;\n }\n\n /**\n * Delegates to findOne with id in where - routing through buildQuery is what makes\n * hiddenFields/defaultFilter apply, so a soft-deleted document resolves to null. `where` is spread\n * away last so a projection can never widen the id lookup.\n */\n findById<R = unknown, const F extends TFields<TDocument> = TFields<TDocument>>(opts: {\n id: IdType;\n filter?: TByIdFilter<any, F>;\n options?: TFindOneOptions<IExtraOptions, TRow<TDocument, R, F>>;\n }): Promise<TNullable<TRow<TDocument, R, F>>> {\n const { id, filter, options } = opts;\n\n return this.findOne<R, F>({ filter: { ...filter, where: { id } }, options });\n }\n\n /**\n * Unified search entry discriminated by `mode`: `raw` is a full passthrough - no dialect, no\n * defaultFilter, no hiddenFields - while keyword/semantic/hybrid translate through the dialect\n * like `find()`. Nothing engine-specific lives here; `ISearchQueryDialect.applySearchInput`\n * owns it.\n */\n async search<R extends object = TDocument>(\n opts: TSearchInput & { options?: IExtraOptions },\n ): Promise<ISearchResult<R>> {\n if (opts.mode === SearchModes.RAW) {\n return this.connector.search<R>({\n collection: this.collectionName,\n params: opts.params,\n });\n }\n\n this.assertNoTransaction(opts.options);\n this.assertNoLock(opts.options);\n\n const query = this.buildQuery({\n filter: opts.filter,\n shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,\n });\n\n const input = this.withDefaultQueryBy({ input: opts });\n this.assertNoHiddenFieldsNamed({ input });\n this.queryDialect.applySearchInput({ query, input });\n\n // Same short-circuit as find(): an absorbing filter cannot be expressed to the engine, and\n // omitting it would search everything.\n // `isFoundExact` is true because zero is not an estimate - nothing was searched to approximate.\n if (query.matchNone) {\n return { hits: [], found: 0, isFoundExact: true };\n }\n\n const result = await this.connector.search<R>({\n collection: this.collectionName,\n params: this.queryDialect.toWireParams({ query }),\n });\n\n return {\n ...result,\n hits: (result.hits ?? []).map((hit) => ({\n ...hit,\n document: this.omitHiddenFields(hit.document),\n })),\n };\n }\n\n /** The count of a text search: how many documents match `query` and `where`. Unlike `count()`, which asks the document endpoint for an exact filter-only total, this goes through search, so `isFoundExact` says whether the engine stopped early and `count` is an estimate. */\n async searchCount(opts: {\n query: string;\n queryBy?: string[];\n where?: TWhere;\n options?: IExtraOptions;\n }): Promise<{ count: number; isFoundExact: boolean }> {\n const { query, queryBy, where, options } = opts;\n\n const result = await this.search({\n mode: SearchModes.KEYWORD,\n query,\n queryBy,\n filter: { where, limit: 0 },\n options,\n });\n\n return { count: result.found, isFoundExact: result.isFoundExact };\n }\n\n /** Facet counts without hits, over the documents that match `query` (all of them when omitted) and `where`. `maxFacetValues` and `facetQuery` are for engines that take them; the others refuse them. */\n async facets(opts: {\n facetBy: string[];\n query?: string;\n queryBy?: string[];\n where?: TWhere;\n maxFacetValues?: number;\n facetQuery?: string;\n options?: IExtraOptions;\n }): Promise<{ facets: ISearchFacetCount[]; found: number; isFoundExact: boolean }> {\n const { facetBy, query, queryBy, where, maxFacetValues, facetQuery, options } = opts;\n\n if (facetBy.length === 0 || facetBy.some((name) => name.trim().length === 0)) {\n throw getError({\n message: `[${this.constructor.name}][facets] Invalid facetBy | Expected at least one non-empty field name | Got: ${JSON.stringify(facetBy)}`,\n });\n }\n\n if (\n maxFacetValues !== undefined &&\n (!Number.isInteger(maxFacetValues) || maxFacetValues <= 0)\n ) {\n throw getError({\n message: `[${this.constructor.name}][facets] Invalid maxFacetValues | Expected a positive integer | Got: ${String(maxFacetValues)}`,\n });\n }\n\n const result = await this.search({\n mode: SearchModes.KEYWORD,\n query: query ?? WILDCARD_QUERY,\n queryBy,\n facetBy,\n facetQuery,\n maxFacetValues,\n filter: { where, limit: 0 },\n options,\n });\n\n return {\n facets: result.facetCounts ?? [],\n found: result.found,\n isFoundExact: result.isFoundExact,\n };\n }\n\n /** Autocomplete: documents whose fields match `query` as typed so far. A keyword search with highlighting off and a small page (`limit`, 8 by default); the last word matches as a prefix, which both engines do by default. A blank `query` answers an empty list without asking the engine. */\n async suggest<R extends object = TDocument>(opts: {\n query: string;\n queryBy?: string[];\n limit?: number;\n includeFields?: string[];\n where?: TWhere;\n options?: IExtraOptions;\n }): Promise<R[]> {\n const { query, queryBy, limit = SUGGEST_DEFAULT_LIMIT, includeFields, where, options } = opts;\n\n if (!Number.isInteger(limit) || limit <= 0) {\n throw getError({\n message: `[${this.constructor.name}][suggest] Invalid limit | Expected a positive integer | Got: ${String(limit)}`,\n });\n }\n\n if (query.trim().length === 0) {\n return [];\n }\n\n const result = await this.search<R>({\n mode: SearchModes.KEYWORD,\n query,\n queryBy,\n highlight: false,\n filter: { where, fields: includeFields, limit },\n options,\n });\n\n return (result.hits ?? []).map((hit) => hit.document);\n }\n\n /** Documents lose their hidden fields on the way out, but a facet count or a match on one would still tell the caller what the field holds; so they are refused as `facetBy`, in `facetQuery`, as `queryBy`, as `groupBy` and in the highlight fields (a group key and a highlight snippet carry the value too). */\n protected assertNoHiddenFieldsNamed(opts: { input: TTranslatableSearchInput }): void {\n const { input } = opts;\n\n if (this.hiddenFields.length === 0) {\n return;\n }\n\n const named: Array<{ param: string; field: string }> = [];\n\n for (const param of ['facetBy', 'groupBy', 'highlightFields', 'highlightFullFields'] as const) {\n for (const field of input[param] ?? []) {\n named.push({ param, field });\n }\n }\n\n if (input.facetQuery !== undefined) {\n named.push({ param: 'facetQuery', field: input.facetQuery.split(':')[0]?.trim() ?? '' });\n }\n\n if ('queryBy' in input) {\n for (const field of input.queryBy ?? []) {\n named.push({ param: 'queryBy', field });\n }\n }\n\n const hidden = named.find(({ field }) => this.hiddenFields.includes(field));\n\n if (hidden) {\n throw getError({\n message: `[${this.constructor.name}][search] '${hidden.param}' names a hidden field | field: '${hidden.field}' | hidden fields never leave the repository, so they cannot be counted, matched or faceted`,\n });\n }\n }\n\n protected withDefaultQueryBy(opts: {\n input: TTranslatableSearchInput;\n }): TTranslatableSearchInput {\n const { input } = opts;\n\n if (input.mode !== SearchModes.KEYWORD || input.queryBy) {\n return input;\n }\n\n const term = input.query?.trim();\n\n if (!term || term === WILDCARD_QUERY) {\n return input;\n }\n\n const defaultQueryBy = this.entity?.schema?.defaultQueryBy;\n\n if (!defaultQueryBy || defaultQueryBy.length === 0) {\n return input;\n }\n\n return { ...input, queryBy: [...defaultQueryBy] };\n }\n\n /** @throws Error - disabled in a read-only repository; unlocked progressively by Persistable/DefaultSearchRepository. */\n create(opts: {\n data: TDocument;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n create<R = TDocument>(opts: {\n data: TDocument;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n create<R = TDocument>(_opts: {\n data: TDocument;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<R> }> {\n return this.denyOperation({ methodName: this.create.name });\n }\n\n /** @throws Error - disabled in a read-only repository. */\n createAll(opts: {\n data: Array<TDocument>;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n createAll<R = TDocument>(opts: {\n data: Array<TDocument>;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: Array<R> }>;\n createAll<R = TDocument>(_opts: {\n data: Array<TDocument>;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<Array<R>> }> {\n return this.denyOperation({ methodName: this.createAll.name });\n }\n\n /** @throws Error - disabled in a read-only repository. */\n updateById(opts: {\n id: IdType;\n data: Partial<TDocument>;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n updateById<R = TDocument>(opts: {\n id: IdType;\n data: Partial<TDocument>;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n updateById<R = TDocument>(_opts: {\n id: IdType;\n data: Partial<TDocument>;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<R> }> {\n return this.denyOperation({ methodName: this.updateById.name });\n }\n\n /**\n * @throws Error - disabled in a read-only repository. `where` is optional where the base contract\n * requires it: the `@model` defaultFilter alone can supply the effective filter, and Persistable\n * refuses the write outright when neither is present.\n */\n updateAll(_opts: {\n data: Partial<TDocument>;\n where?: TWhere;\n options?: Omit<IExtraOptions, 'shouldReturn'> & { force?: boolean };\n }): Promise<TCount & { data: null }> {\n return this.denyOperation({ methodName: this.updateAll.name });\n }\n\n /** @throws Error - disabled in a read-only repository. */\n deleteById(opts: {\n id: IdType;\n options: IExtraOptions & { shouldReturn: false };\n }): Promise<TCount & { data: undefined | null }>;\n deleteById<R = TDocument>(opts: {\n id: IdType;\n options?: IExtraOptions & { shouldReturn?: true };\n }): Promise<TCount & { data: R }>;\n deleteById<R = TDocument>(_opts: {\n id: IdType;\n options?: IExtraOptions & { shouldReturn?: boolean };\n }): Promise<TCount & { data: TNullable<R> }> {\n return this.denyOperation({ methodName: this.deleteById.name });\n }\n\n /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */\n deleteAll(_opts?: {\n where?: TWhere;\n options?: Omit<IExtraOptions, 'shouldReturn'> & { force?: boolean };\n }): Promise<TCount & { data: null }> {\n return this.denyOperation({ methodName: this.deleteAll.name });\n }\n}\n"]}
@@ -1,4 +1,4 @@
1
- import type { ISearchResult } from '../../core/index.js';
1
+ import type { ISearchFacetCount, ISearchResult } from '../../core/index.js';
2
2
  import { type Meilisearch } from 'meilisearch';
3
3
  import type { IMeilisearchClientLike } from '../common/index.js';
4
4
  /** Meilisearch error bodies carry `{ message, code, type, link }`; classification keys off `code`. */
@@ -24,6 +24,11 @@ export declare class MeilisearchInternal {
24
24
  }): boolean;
25
25
  /** Strips Meilisearch's reserved response metadata, leaving the caller's own document intact. */
26
26
  private static extractDocument;
27
+ /** Maps `facetDistribution` (`{ field: { value: count } }`) and `facetStats` (`{ field: { min, max } }`) onto one `ISearchFacetCount` per field; a count that is not a number is dropped. */
28
+ static mapFacets(opts: {
29
+ distribution: Record<string, unknown>;
30
+ stats?: unknown;
31
+ }): ISearchFacetCount[];
27
32
  /** Maps a Meilisearch response onto `ISearchResult`: exhaustive `totalHits` preferred over approximate `estimatedTotalHits` (`isFoundExact` says which), wire keys read via bracket access, never identifiers. */
28
33
  static mapSearchResult<TDocument extends object>(opts: {
29
34
  raw: unknown;
@@ -1 +1 @@
1
- {"version":3,"file":"connector-internal.d.ts","sourceRoot":"","sources":["../../../../../src/search/meilisearch/internal/connector-internal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD,sGAAsG;AACtG,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,oBAAoB,0BAA0B;IAC9D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,wBAAwB;IAE1D,sJAAsJ;IACtJ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAQtC;IAEH,4TAA4T;IAC5T,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAgBjE,wEAAwE;IACxE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAgBlE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAazD,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAI9D,iGAAiG;IACjG,OAAO,CAAC,MAAM,CAAC,eAAe;IAkB9B,kNAAkN;IAClN,MAAM,CAAC,eAAe,CAAC,SAAS,SAAS,MAAM,EAAE,IAAI,EAAE;QACrD,GAAG,EAAE,OAAO,CAAC;KACd,GAAG,aAAa,CAAC,SAAS,CAAC;IA+C5B,2EAA2E;IAC3E,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,sBAAsB;CAiBvE"}
1
+ {"version":3,"file":"connector-internal.d.ts","sourceRoot":"","sources":["../../../../../src/search/meilisearch/internal/connector-internal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,WAAW,CAAC;AAExD,sGAAsG;AACtG,qBAAa,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,eAAe,qBAAqB;IACpD,MAAM,CAAC,QAAQ,CAAC,oBAAoB,0BAA0B;IAC9D,MAAM,CAAC,QAAQ,CAAC,kBAAkB,wBAAwB;IAE1D,sJAAsJ;IACtJ,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAQtC;IAEH,4TAA4T;IAC5T,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAgBjE,wEAAwE;IACxE,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,GAAG,SAAS;IAgBlE,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAazD,MAAM,CAAC,oBAAoB,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAI9D,iGAAiG;IACjG,OAAO,CAAC,MAAM,CAAC,eAAe;IAkB9B,6LAA6L;IAC7L,MAAM,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;IAsCjF,kNAAkN;IAClN,MAAM,CAAC,eAAe,CAAC,SAAS,SAAS,MAAM,EAAE,IAAI,EAAE;QACrD,GAAG,EAAE,OAAO,CAAC;KACd,GAAG,aAAa,CAAC,SAAS,CAAC;IAkD5B,2EAA2E;IAC3E,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE;QAAE,GAAG,EAAE,WAAW,CAAA;KAAE,GAAG,sBAAsB;CAiBvE"}