@venizia/ignis 0.0.10-5 → 0.1.0

package/dist/connectors/{typesense → search}/controllers/definition.d.ts

@@ -35,18 +35,8 @@ export declare const defineSearchRouteConfigs: (opts: {
                             groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
                             groupLimit: z.ZodOptional<z.ZodNumber>;
                             groupMissingValues: z.ZodOptional<z.ZodBoolean>;
-                            numTypos: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-                            prefix: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-                            infix: z.ZodOptional<z.ZodString>;
-                            useCache: z.ZodOptional<z.ZodBoolean>;
-                            cacheTtl: z.ZodOptional<z.ZodNumber>;
-                            exhaustiveSearch: z.ZodOptional<z.ZodBoolean>;
-                            pinnedHits: z.ZodOptional<z.ZodString>;
-                            hiddenHits: z.ZodOptional<z.ZodString>;
                             queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-                            prioritizeExactMatch: z.ZodOptional<z.ZodBoolean>;
-                            dropTokensThreshold: z.ZodOptional<z.ZodNumber>;
-                            preset: z.ZodOptional<z.ZodString>;
+                            engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                             mode: z.ZodLiteral<"keyword">;
                             query: z.ZodOptional<z.ZodString>;
                             queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
@@ -72,18 +62,8 @@ export declare const defineSearchRouteConfigs: (opts: {
                             groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
                             groupLimit: z.ZodOptional<z.ZodNumber>;
                             groupMissingValues: z.ZodOptional<z.ZodBoolean>;
-                            numTypos: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-                            prefix: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-                            infix: z.ZodOptional<z.ZodString>;
-                            useCache: z.ZodOptional<z.ZodBoolean>;
-                            cacheTtl: z.ZodOptional<z.ZodNumber>;
-                            exhaustiveSearch: z.ZodOptional<z.ZodBoolean>;
-                            pinnedHits: z.ZodOptional<z.ZodString>;
-                            hiddenHits: z.ZodOptional<z.ZodString>;
                             queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-                            prioritizeExactMatch: z.ZodOptional<z.ZodBoolean>;
-                            dropTokensThreshold: z.ZodOptional<z.ZodNumber>;
-                            preset: z.ZodOptional<z.ZodString>;
+                            engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                             mode: z.ZodLiteral<"semantic">;
                             vectorField: z.ZodString;
                             nearVector: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
@@ -111,18 +91,8 @@ export declare const defineSearchRouteConfigs: (opts: {
                             groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
                             groupLimit: z.ZodOptional<z.ZodNumber>;
                             groupMissingValues: z.ZodOptional<z.ZodBoolean>;
-                            numTypos: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-                            prefix: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-                            infix: z.ZodOptional<z.ZodString>;
-                            useCache: z.ZodOptional<z.ZodBoolean>;
-                            cacheTtl: z.ZodOptional<z.ZodNumber>;
-                            exhaustiveSearch: z.ZodOptional<z.ZodBoolean>;
-                            pinnedHits: z.ZodOptional<z.ZodString>;
-                            hiddenHits: z.ZodOptional<z.ZodString>;
                             queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-                            prioritizeExactMatch: z.ZodOptional<z.ZodBoolean>;
-                            dropTokensThreshold: z.ZodOptional<z.ZodNumber>;
-                            preset: z.ZodOptional<z.ZodString>;
+                            engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                             mode: z.ZodLiteral<"hybrid">;
                             query: z.ZodString;
                             queryBy: z.ZodArray<z.ZodString>;
@@ -154,6 +124,7 @@ export declare const defineSearchRouteConfigs: (opts: {
                     'application/json': {
                         schema: z.ZodObject<{
                             found: z.ZodNumber;
+                            isFoundExact: z.ZodBoolean;
                             hits: z.ZodArray<z.ZodObject<{
                                 document: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
                             }, z.core.$strip>>;
@@ -168,6 +139,7 @@ export declare const defineSearchRouteConfigs: (opts: {
                     'application/json': {
                         schema: z.ZodObject<{
                             found: z.ZodNumber;
+                            isFoundExact: z.ZodBoolean;
                             hits: z.ZodArray<z.ZodObject<{
                                 document: z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>;
                             }, z.core.$strip>>;
@@ -219,18 +191,8 @@ export declare const defineSearchRouteConfigs: (opts: {
                                 groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
                                 groupLimit: z.ZodOptional<z.ZodNumber>;
                                 groupMissingValues: z.ZodOptional<z.ZodBoolean>;
-                                numTypos: z.ZodOptional<z.ZodUnion<readonly [z.ZodNumber, z.ZodString]>>;
-                                prefix: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>>;
-                                infix: z.ZodOptional<z.ZodString>;
-                                useCache: z.ZodOptional<z.ZodBoolean>;
-                                cacheTtl: z.ZodOptional<z.ZodNumber>;
-                                exhaustiveSearch: z.ZodOptional<z.ZodBoolean>;
-                                pinnedHits: z.ZodOptional<z.ZodString>;
-                                hiddenHits: z.ZodOptional<z.ZodString>;
                                 queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
-                                prioritizeExactMatch: z.ZodOptional<z.ZodBoolean>;
-                                dropTokensThreshold: z.ZodOptional<z.ZodNumber>;
-                                preset: z.ZodOptional<z.ZodString>;
+                                engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
                                 collection: z.ZodString;
                                 query: z.ZodOptional<z.ZodString>;
                                 queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;

package/dist/connectors/search/controllers/definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/definition.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAItC,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,YAAY,EAAE,CAAC,CAAC,UAAU,CAAC;IAC3B,YAAY,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAClE,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;CACvD;;;;;;yBAF+B,aAAa,EAAE;mBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;yBAAjC,aAAa,EAAE;mBAAS,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsDhE,CAAC"}

package/dist/connectors/{typesense → search}/controllers/definition.js

@@ -4,11 +4,14 @@ exports.defineSearchRouteConfigs = void 0;
 const models_1 = require("../../../base/models");
 const zod_openapi_1 = require("@hono/zod-openapi");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const common_1 = require("../repositories/common");
+const common_1 = require("../../../connectors/search/repositories/common");
 const defineSearchRouteConfigs = (opts) => {
     const { selectSchema, authenticate, authorize } = opts;
     const searchResponseSchema = zod_openapi_1.z.object({
         found: zod_openapi_1.z.number(),
+        isFoundExact: zod_openapi_1.z
+            .boolean()
+            .openapi({ description: 'False when the engine reports `found` as an estimate.' }),
         hits: zod_openapi_1.z.array(zod_openapi_1.z.object({ document: selectSchema })),
     });
     const multiSearchResponseSchema = zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.unknown());

package/dist/connectors/search/controllers/definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"definition.js","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/definition.ts"],"names":[],"mappings":";;;AAAA,0CAA0D;AAG1D,mDAAsC;AACtC,0DAA8C;AAC9C,oEAAoG;AAE7F,MAAM,wBAAwB,GAAG,CAAC,IAIxC,EAAE,EAAE;IACH,MAAM,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEvD,MAAM,oBAAoB,GAAG,eAAC,CAAC,MAAM,CAAC;QACpC,KAAK,EAAE,eAAC,CAAC,MAAM,EAAE;QACjB,YAAY,EAAE,eAAC;aACZ,OAAO,EAAE;aACT,OAAO,CAAC,EAAE,WAAW,EAAE,uDAAuD,EAAE,CAAC;QACpF,IAAI,EAAE,eAAC,CAAC,KAAK,CAAC,eAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC;KACpD,CAAC,CAAC;IAEH,MAAM,yBAAyB,GAAG,eAAC,CAAC,MAAM,CAAC,eAAC,CAAC,MAAM,EAAE,EAAE,eAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAEpE,MAAM,oBAAoB,GAAG,YAAY,IAAI,EAAE,CAAC;IAEhD,OAAO;QACL,MAAM,EAAE;YACN,MAAM,EAAE,oBAAI,CAAC,OAAO,CAAC,IAAI;YACzB,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,0EAA0E;YACvF,YAAY,EAAE,oBAAoB;YAClC,SAAS;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,IAAA,oBAAW,EAAC;oBAChB,WAAW,EAAE,qCAAqC;oBAClD,MAAM,EAAE,0BAAiB;iBAC1B,CAAC;aACH;YACD,SAAS,EAAE,IAAA,qBAAY,EAAC;gBACtB,WAAW,EAAE,gBAAgB;gBAC7B,MAAM,EAAE,oBAAoB;aAC7B,CAAC;SACH;QAED,YAAY,EAAE;YACZ,MAAM,EAAE,oBAAI,CAAC,OAAO,CAAC,IAAI;YACzB,IAAI,EAAE,eAAe;YACrB,WAAW,EAAE,kEAAkE;YAC/E,YAAY,EAAE,oBAAoB;YAClC,SAAS;YACT,OAAO,EAAE;gBACP,IAAI,EAAE,IAAA,oBAAW,EAAC;oBAChB,WAAW,EAAE,sEAAsE;oBACnF,MAAM,EAAE,+BAAsB;iBAC/B,CAAC;aACH;YACD,SAAS,EAAE,IAAA,qBAAY,EAAC;gBACtB,WAAW,EAAE,2DAA2D;gBACxE,MAAM,EAAE,yBAAyB;aAClC,CAAC;SACH;KACO,CAAC;AACb,CAAC,CAAC;AAxDW,QAAA,wBAAwB,4BAwDnC"}

package/dist/connectors/{typesense → search}/controllers/factory.d.ts

@@ -21,7 +21,6 @@ export interface ISearchControllerOptions<TEntity extends AbstractEntity<TAnyObj
     /** Entity class or resolver function returning the entity class. Its SELECT schema drives the
      * `hits[].document` shape in the generated search route's response. */
     entity: TClass<TEntity> | TResolver<TClass<TEntity>>;
-    /** Repository binding configuration */
     repository: {
         name: string;
     };
@@ -51,18 +50,18 @@ export declare class SearchControllerFactory extends BaseHelper {
         new (repository: ReadableSearchRepository<TDataObject>): {
             /** Registers the search + multiSearch route handlers, honoring per-route enable flags. */
             binding(): ValueOrPromise<void>;
-            repository: ReadableSearchRepository<TDataObject>;
-            measure<R>(opts: {
-                scope: string;
-                args: unknown;
-                task: () => Promise<R>;
-            }): Promise<any>;
+            repository: ReadableSearchRepository<TDataObject, import("..").AbstractSearchDataSource<{}>>;
             search(opts: {
                 context: import("../../../base/controllers").TRouteContext<RouteEnv>;
             }): Promise<import("../../../base/controllers").TJsonResponse<unknown, 200>>;
             multiSearch(opts: {
                 context: import("../../../base/controllers").TRouteContext<RouteEnv>;
             }): Promise<import("../../../base/controllers").TJsonResponse<unknown, 200>>;
+            measure<R>(opts: {
+                scope: string;
+                args: unknown;
+                task: () => Promise<R>;
+            }): Promise<any>;
             toHonoHandler<ResponseType = unknown>(opts: {
                 handler: import("../../../base/controllers").TRouteHandler<ResponseType, RouteEnv>;
             }): import("hono").Handler<RouteEnv, string, import("hono").Input, (Response | Promise<Response>) | (import("@hono/zod-openapi").RouteConfigToTypedResponse<import("@hono/zod-openapi").RouteConfig> | Promise<import("@hono/zod-openapi").RouteConfigToTypedResponse<import("@hono/zod-openapi").RouteConfig>>)>;
@@ -84,7 +83,9 @@ export declare class SearchControllerFactory extends BaseHelper {
             path: string;
             definitions: Record<string, import("../../../base/controllers").IAuthRouteConfig>;
             getRouter(): import("@hono/zod-openapi").OpenAPIHono<RouteEnv, RouteSchema, BasePath>;
-            registerRoutesFromRegistry(): void;
+            registerRoutesFromRegistry(opts?: {
+                paths?: "static" | "param" | "all";
+            }): void;
             configure(opts?: ConfigurableOptions | undefined): Promise<import("@hono/zod-openapi").OpenAPIHono<RouteEnv, RouteSchema, BasePath>>;
             buildRouteMiddlewares<RouteConfig extends import("../../../base/controllers").IAuthRouteConfig>(opts: {
                 configs: RouteConfig;

package/dist/connectors/search/controllers/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAChG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAAE,UAAU,EAAY,MAAM,wBAAwB,CAAC;AAE9D,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACxC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAI9E,6EAA6E;AAC7E,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC/B,WAAW,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;CACrC;AAED,iHAAiH;AACjH,MAAM,WAAW,wBAAwB,CACvC,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC;IAEnF;2EACuE;IACvE,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAErD,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;KACd,CAAC;IAEF,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,CAAC;IAEF,8DAA8D;IAC9D,YAAY,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,aAAa,EAAE,CAAC;QAAC,IAAI,CAAC,EAAE,SAAS,CAAA;KAAE,CAAC;IAElE,6DAA6D;IAC7D,SAAS,CAAC,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,CAAC;IAEtD,8CAA8C;IAC9C,MAAM,CAAC,EAAE,yBAAyB,CAAC;CACpC;AAED,wHAAwH;AACxH,qBAAa,uBAAwB,SAAQ,UAAU;;IAKrD;;;OAGG;IACH,MAAM,CAAC,sBAAsB,CAC3B,OAAO,SAAS,cAAc,CAAC,gBAAgB,CAAC,GAAG,cAAc,CAAC,gBAAgB,CAAC,EACnF,QAAQ,SAAS,GAAG,GAAG,GAAG,EAC1B,WAAW,SAAS,MAAM,GAAG,EAAE,EAC/B,QAAQ,SAAS,MAAM,GAAG,GAAG,EAC7B,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,WAAW,SAAS,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,EACvD,OAAO,EAAE,wBAAwB,CAAC,OAAO,CAAC;yBAwBhB,wBAAwB,CAAC,WAAW,CAAC;YAU7D,0FAA0F;uBACtE,cAAc,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;qBAlCd,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0DhC"}

package/dist/connectors/{typesense → search}/controllers/factory.js

@@ -23,11 +23,11 @@ class SearchControllerFactory extends ignis_helpers_1.BaseHelper {
                 message: `[defineSearchController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,
             });
         }
-        const _entityClass = (0, ignis_inversion_1.isClass)(entity) ? entity : entity();
-        const entityInstance = new _entityClass();
+        const entityClass = (0, ignis_inversion_1.isClass)(entity) ? entity : entity();
+        const entityInstance = new entityClass();
         const selectSchema = entityInstance.getSchema({ type: models_1.SchemaTypes.SELECT });
         const routeDefinitions = (0, definition_1.defineSearchRouteConfigs)({ selectSchema, authenticate, authorize });
-        const _controller = class extends abstract_1.AbstractSearchController {
+        const controllerClass = class extends abstract_1.AbstractSearchController {
             constructor(repository) {
                 super({
                     scope: name,
@@ -56,8 +56,8 @@ class SearchControllerFactory extends ignis_helpers_1.BaseHelper {
                 }
             }
         };
-        Object.defineProperty(_controller, 'name', { value: name, configurable: true });
-        return _controller;
+        Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });
+        return controllerClass;
     }
 }
 exports.SearchControllerFactory = SearchControllerFactory;

package/dist/connectors/search/controllers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/factory.ts"],"names":[],"mappings":";;;AAEA,0CAA4C;AAK5C,0DAA8D;AAC9D,8DAAmD;AAGnD,yCAAsD;AACtD,6CAAwD;AAoCxD,wHAAwH;AACxH,MAAa,uBAAwB,SAAQ,0BAAU;IACrD;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,sBAAsB,CAO3B,OAA0C;QAC1C,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAExE,MAAM,EAAE,IAAI,EAAE,QAAQ,GAAG,cAAc,EAAE,QAAQ,GAAG,IAAI,EAAE,GAAG,UAAU,CAAC;QACxE,IAAI,CAAC,QAAQ,IAAI,QAAQ,KAAK,cAAc,EAAE,CAAC;YAC7C,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,gEAAgE,IAAI,gBAAgB,QAAQ,EAAE;aACxG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,WAAW,GAAG,IAAA,yBAAO,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,cAAc,GAAG,IAAI,WAAW,EAAE,CAAC;QAEzC,MAAM,YAAY,GAAG,cAAc,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,oBAAW,CAAC,MAAM,EAAE,CAAC,CAAC;QAC5E,MAAM,gBAAgB,GAAG,IAAA,qCAAwB,EAAC,EAAE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,CAAC,CAAC;QAE7F,MAAM,eAAe,GAAG,KAAM,SAAQ,mCAOrC;YACC,YAAY,UAAiD;gBAC3D,KAAK,CAAC;oBACJ,KAAK,EAAE,IAAI;oBACX,IAAI,EAAE,QAAQ;oBACd,QAAQ;oBACR,UAAU;oBACV,WAAW,EAAE,gBAAgB;iBAC9B,CAAC,CAAC;YACL,CAAC;YAED,0FAA0F;YACjF,OAAO;gBACd,MAAM,SAAS,GAAG,CAAC,QAAyC,EAAE,EAAE;oBAC9D,OAAO,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,OAAO,KAAK,KAAK,CAAC;gBAC/C,CAAC,CAAC;gBAEF,IAAI,SAAS,CAAC,QAAQ,CAAC,EAAE,CAAC;oBACxB,IAAI,CAAC,WAAW,CAAC;wBACf,OAAO,EAAE,gBAAgB,CAAC,MAAM;wBAChC,OAAO,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;qBACnD,CAAC,CAAC;gBACL,CAAC;gBAED,IAAI,SAAS,CAAC,aAAa,CAAC,EAAE,CAAC;oBAC7B,IAAI,CAAC,WAAW,CAAC;wBACf,OAAO,EAAE,gBAAgB,CAAC,YAAY;wBACtC,OAAO,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,OAAO,EAAE,CAAC;qBACxD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;SACF,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,eAAe,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC,CAAC;QACpF,OAAO,eAAe,CAAC;IACzB,CAAC;CACF;AA3ED,0DA2EC"}

package/dist/connectors/search/controllers/index.d.ts

@@ -0,0 +1,4 @@
+export * from './abstract';
+export * from './definition';
+export * from './factory';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/search/controllers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC"}

package/dist/connectors/search/controllers/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./abstract"), exports);
+__exportStar(require("./definition"), exports);
+__exportStar(require("./factory"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/search/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/search/controllers/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,+CAA6B;AAC7B,4CAA0B"}

package/dist/connectors/search/datasources/abstract.d.ts

@@ -0,0 +1,25 @@
+import { AbstractDataSource } from '../../../base/datasources';
+import type { ISearchConnector } from '../../../connectors/search/connector';
+import type { ISearchCollectionDefinition, TSearchSchema } from '../../../connectors/search/models';
+import type { ISearchQueryDialect, TMultiSearchEntry } from '../../../connectors/search/repositories/common';
+/** Engine contract only (connector, dialect, collection compile/ensure) - mirrors AbstractPostgresDataSource. Discovery/provisioning lives on BaseSearchDataSource. */
+export declare abstract class AbstractSearchDataSource<Settings extends object = {}> extends AbstractDataSource<Settings, TSearchSchema> {
+    abstract getConnector(): ISearchConnector;
+    abstract getQueryDialect(): ISearchQueryDialect;
+    abstract compileCollection(opts: {
+        definition: ISearchCollectionDefinition;
+    }): unknown;
+    abstract ensureCollection(opts: {
+        definition: ISearchCollectionDefinition;
+    }): Promise<void>;
+    /** Cross-collection search. The neutral return is `unknown` because each engine's multi-search
+     * envelope differs (Typesense `results[]`/union, Meilisearch `results[]`/federation); a concrete
+     * datasource narrows it. Declared here so a repository generic over its datasource can read it. */
+    abstract multiSearch(opts: {
+        searches: TMultiSearchEntry[];
+        union?: boolean;
+        commonParams?: Omit<TMultiSearchEntry, 'collection'>;
+        options?: unknown;
+    }): Promise<unknown>;
+}
+//# sourceMappingURL=abstract.d.ts.map

package/dist/connectors/search/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC7F,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,yCAAyC,CAAC;AAEjD,uKAAuK;AACvK,8BAAsB,wBAAwB,CAC5C,QAAQ,SAAS,MAAM,GAAG,EAAE,CAC5B,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,aAAa,CAAC;IACnD,QAAQ,CAAC,YAAY,IAAI,gBAAgB;IAEzC,QAAQ,CAAC,eAAe,IAAI,mBAAmB;IAE/C,QAAQ,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,2BAA2B,CAAA;KAAE,GAAG,OAAO;IACtF,QAAQ,CAAC,gBAAgB,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,2BAA2B,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAE3F;;uGAEmG;IACnG,QAAQ,CAAC,WAAW,CAAC,IAAI,EAAE;QACzB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;CACrB"}

package/dist/connectors/search/datasources/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/search/datasources/abstract.ts"],"names":[],"mappings":";;;AAAA,oDAAwD;AAQxD,uKAAuK;AACvK,MAAsB,wBAEpB,SAAQ,gCAA2C;CAiBpD;AAnBD,4DAmBC"}

package/dist/connectors/search/datasources/base.d.ts

@@ -0,0 +1,73 @@
+import type { ISearchConnector } from '../../../connectors/search/connector';
+import type { ISearchCollectionDefinition, TSearchSchema } from '../../../connectors/search/models';
+import type { ISearchDataSourceOptions } from '../../../connectors/search/datasources/common';
+import type { TMultiSearchEntry } from '../../../connectors/search/repositories/common';
+import { AbstractSearchDataSource } from './abstract';
+/**
+ * Collection discovery/provisioning + connector lifecycle over AbstractSearchDataSource's engine
+ * contract - mirrors BasePostgresDataSource's schema auto-discovery over AbstractPostgresDataSource.
+ *
+ * The connector is held through the `ISearchConnector`-bounded generic, never as an engine type: this
+ * tier is the paradigm seam and must not import Typesense/Meilisearch. Engines supply only
+ * `createConnector()`.
+ */
+export declare abstract class BaseSearchDataSource<Settings extends object = {}, TConnector extends ISearchConnector = ISearchConnector> extends AbstractSearchDataSource<Settings> {
+    protected autoProvision: boolean;
+    protected hiddenFieldsByCollectionMap?: Record<string, string[]>;
+    protected connector?: TConnector;
+    private readonly injectedConnector?;
+    constructor(opts: ISearchDataSourceOptions<Settings> & {
+        connector?: TConnector;
+    });
+    /** The engine's connector instance - the ONLY engine-specific step of the lifecycle. */
+    protected abstract createConnector(): TConnector;
+    /** Builds the connector (unless injected, e.g. for tests), then provisions collections. Re-entrant-safe: a second call is a logged no-op, not a re-provision. */
+    configure(): Promise<void>;
+    getConnector(): TConnector;
+    /** Auto-discovers collections from repositories if not manually provided. */
+    getSchema(): TSearchSchema;
+    hasDiscoverableModels(): boolean;
+    /**
+     * Cross-collection search - lives on the datasource (not a single-collection repository) since it
+     * spans many collections at once. The envelope is engine-specific, so the neutral return is
+     * `unknown`; `TypesenseDataSource` narrows it to its results/union shapes.
+     */
+    multiSearch(opts: {
+        searches: TMultiSearchEntry[];
+        union?: boolean;
+        commonParams?: Omit<TMultiSearchEntry, 'collection'>;
+        options?: unknown;
+    }): Promise<unknown>;
+    /**
+     * Reads `static searchCollection` (dual-schema escape: a postgres entity carrying a search index
+     * beside its pgTable), falling back to `static schema` (shape-guarded so a
+     * pgTable's `schema` is never mistaken for a collection definition); skips classes with
+     * neither. Honors `@datasource({ autoDiscovery: false })` same as the postgres branch.
+     */
+    protected discoverCollections(): TSearchSchema;
+    /** Reads a bound model class's collection definition (dual-schema `searchCollection` first, then the
+     * shape-guarded `schema`); returns undefined for a class carrying neither. */
+    private readCollectionDefinition;
+    /** Collection name -> its `@model` hiddenProperties, for datasource-level operations (multiSearch)
+     * that span collections and so cannot read a single repository's `hiddenFields`. Collections with
+     * no hidden properties are omitted; callers own exclusion for any collection absent from this map.
+     *
+     * Memoized per instance like `getSchema()`: `@model` settings and `@repository` bindings are frozen
+     * once boot completes, so the walk is computed on first use and never invalidated. */
+    protected hiddenFieldsByCollection(): Record<string, string[]>;
+    /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the
+     * `getSchema()` / `discoverCollections()` split. */
+    protected discoverHiddenFieldsByCollection(): Record<string, string[]>;
+    /** Unions a collection's hidden fields into one multiSearch entry's excludeFields. An entry whose
+     * collection is unknown (not a discovered definition) passes through untouched - the caller owns
+     * exclusion there, exactly as the raw connector escape hatch does. */
+    private applyHiddenExclusion;
+    /** Provisions discovered collections via ensureCollection (additive-only; destructive migration is caller policy). Skipped if autoProvision is false; failures propagate so boot fails loudly. */
+    protected provisionCollections(): Promise<void>;
+    /** Engines expose synonyms as either named linkable sets or a flat per-collection dictionary, and
+     * some expose neither - so both groups are optional on `ISearchConnector` and are branched on here. */
+    protected provisionSynonyms(opts: {
+        definition: ISearchCollectionDefinition;
+    }): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/connectors/search/datasources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/datasources/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE7F,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,wCAAwC,CAAC;AACvF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yCAAyC,CAAC;AAGjF,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAuBtD;;;;;;;GAOG;AACH,8BAAsB,oBAAoB,CACxC,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,UAAU,SAAS,gBAAgB,GAAG,gBAAgB,CACtD,SAAQ,wBAAwB,CAAC,QAAQ,CAAC;IAC1C,SAAS,CAAC,aAAa,EAAE,OAAO,CAAC;IACjC,SAAS,CAAC,2BAA2B,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjE,SAAS,CAAC,SAAS,CAAC,EAAE,UAAU,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAa;gBAEpC,IAAI,EAAE,wBAAwB,CAAC,QAAQ,CAAC,GAAG;QAAE,SAAS,CAAC,EAAE,UAAU,CAAA;KAAE;IAejF,wFAAwF;IACxF,SAAS,CAAC,QAAQ,CAAC,eAAe,IAAI,UAAU;IAEhD,iKAAiK;IAC3J,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAahC,YAAY,IAAI,UAAU;IAU1B,6EAA6E;IACpE,SAAS,IAAI,aAAa;IAOnC,qBAAqB,IAAI,OAAO;IAKhC;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE;QAChB,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,YAAY,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,YAAY,CAAC,CAAC;QACrD,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,GAAG,OAAO,CAAC,OAAO,CAAC;IAyBpB;;;;;OAKG;IACH,SAAS,CAAC,mBAAmB,IAAI,aAAa;IAO9C;kFAC8E;IAC9E,OAAO,CAAC,wBAAwB;IAYhC;;;;;0FAKsF;IACtF,SAAS,CAAC,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAK9D;wDACoD;IACpD,SAAS,CAAC,gCAAgC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAoBtE;;0EAEsE;IACtE,OAAO,CAAC,oBAAoB;IAe5B,kMAAkM;cAClL,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrD;2GACuG;cACvF,iBAAiB,CAAC,IAAI,EAAE;QACtC,UAAU,EAAE,2BAA2B,CAAC;KACzC,GAAG,OAAO,CAAC,IAAI,CAAC;CA8BlB"}

package/dist/connectors/search/datasources/base.js

@@ -0,0 +1,195 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSearchDataSource = void 0;
+const common_1 = require("../../../connectors/search/repositories/common");
+const inversion_1 = require("../../../helpers/inversion");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const abstract_1 = require("./abstract");
+/** A pg entity's `schema` is a pgTable, not an `ISearchCollectionDefinition` - narrows by shape so
+ * a pgTable is never mistaken for (and provisioned as) a search collection. */
+const isSearchCollectionDefinition = (value) => {
+    return (typeof value === 'object' &&
+        value !== null &&
+        typeof value.name === 'string' &&
+        Array.isArray(value.fields));
+};
+/**
+ * Collection discovery/provisioning + connector lifecycle over AbstractSearchDataSource's engine
+ * contract - mirrors BasePostgresDataSource's schema auto-discovery over AbstractPostgresDataSource.
+ *
+ * The connector is held through the `ISearchConnector`-bounded generic, never as an engine type: this
+ * tier is the paradigm seam and must not import Typesense/Meilisearch. Engines supply only
+ * `createConnector()`.
+ */
+class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
+    constructor(opts) {
+        super({ scope: opts.name });
+        this.name = opts.name;
+        this.settings = opts.config;
+        this.injectedConnector = opts.connector;
+        const autoProvision = (process.env.APP_ENV_AUTO_PROVISION_COLLECTION ?? 'false').toLowerCase();
+        this.autoProvision = opts.autoProvision ?? (autoProvision === 'true' || autoProvision === '1');
+        this.logger.info('[constructor] Auto Provision Collection - autoProvision: %s', this.autoProvision);
+    }
+    /** Builds the connector (unless injected, e.g. for tests), then provisions collections. Re-entrant-safe: a second call is a logged no-op, not a re-provision. */
+    async configure() {
+        if (this.connector) {
+            this.logger
+                .for(this.configure.name)
+                .info('Already configured | Name: %s | Skipping re-provisioning', this.name);
+            return;
+        }
+        this.connector = this.injectedConnector ?? this.createConnector();
+        await this.provisionCollections();
+    }
+    getConnector() {
+        if (!this.connector) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[${this.constructor.name}] Connector not initialized | Name: ${this.name} | Call configure() first`,
+            });
+        }
+        return this.connector;
+    }
+    /** Auto-discovers collections from repositories if not manually provided. */
+    getSchema() {
+        if (!this.schema) {
+            this.schema = this.discoverCollections();
+        }
+        return this.schema;
+    }
+    hasDiscoverableModels() {
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        return registry.hasModels({ dataSource: this.constructor });
+    }
+    /**
+     * Cross-collection search - lives on the datasource (not a single-collection repository) since it
+     * spans many collections at once. The envelope is engine-specific, so the neutral return is
+     * `unknown`; `TypesenseDataSource` narrows it to its results/union shapes.
+     */
+    multiSearch(opts) {
+        const { searches, union: isUnion, commonParams, options } = opts;
+        const dialect = this.getQueryDialect();
+        const hiddenByCollection = this.hiddenFieldsByCollection();
+        // Same friendly -> wire mapping search() uses; unions each entry's hidden fields into
+        // excludeFields per collection, exactly as search() does for @model hiddenProperties.
+        const wireSearches = searches.map(entry => ({
+            collection: entry.collection,
+            ...dialect.toWireParams({
+                query: (0, common_1.toSearchQueryParams)(this.applyHiddenExclusion({ entry, hiddenByCollection })),
+            }),
+        }));
+        const wireCommonParams = commonParams
+            ? dialect.toWireParams({ query: (0, common_1.toSearchQueryParams)(commonParams) })
+            : undefined;
+        return this.getConnector().multiSearch({
+            searches: wireSearches,
+            union: isUnion,
+            commonParams: wireCommonParams,
+            options,
+        });
+    }
+    /**
+     * Reads `static searchCollection` (dual-schema escape: a postgres entity carrying a search index
+     * beside its pgTable), falling back to `static schema` (shape-guarded so a
+     * pgTable's `schema` is never mistaken for a collection definition); skips classes with
+     * neither. Honors `@datasource({ autoDiscovery: false })` same as the postgres branch.
+     */
+    discoverCollections() {
+        return this.discoverDefinitions({
+            kind: 'collection',
+            read: modelClass => this.readCollectionDefinition(modelClass),
+        });
+    }
+    /** Reads a bound model class's collection definition (dual-schema `searchCollection` first, then the
+     * shape-guarded `schema`); returns undefined for a class carrying neither. */
+    readCollectionDefinition(modelClass) {
+        const model = modelClass;
+        if (model.searchCollection) {
+            return model.searchCollection;
+        }
+        return isSearchCollectionDefinition(model.schema) ? model.schema : undefined;
+    }
+    /** Collection name -> its `@model` hiddenProperties, for datasource-level operations (multiSearch)
+     * that span collections and so cannot read a single repository's `hiddenFields`. Collections with
+     * no hidden properties are omitted; callers own exclusion for any collection absent from this map.
+     *
+     * Memoized per instance like `getSchema()`: `@model` settings and `@repository` bindings are frozen
+     * once boot completes, so the walk is computed on first use and never invalidated. */
+    hiddenFieldsByCollection() {
+        this.hiddenFieldsByCollectionMap ??= this.discoverHiddenFieldsByCollection();
+        return this.hiddenFieldsByCollectionMap;
+    }
+    /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the
+     * `getSchema()` / `discoverCollections()` split. */
+    discoverHiddenFieldsByCollection() {
+        const registry = inversion_1.MetadataRegistry.getInstance();
+        const result = {};
+        for (const modelClass of this.getBoundModelClasses()) {
+            const definition = this.readCollectionDefinition(modelClass);
+            if (!definition) {
+                continue;
+            }
+            const hiddenProperties = registry.getModelMetadata({ target: modelClass })?.settings
+                ?.hiddenProperties;
+            if (hiddenProperties && hiddenProperties.length > 0) {
+                result[definition.name] = hiddenProperties;
+            }
+        }
+        return result;
+    }
+    /** Unions a collection's hidden fields into one multiSearch entry's excludeFields. An entry whose
+     * collection is unknown (not a discovered definition) passes through untouched - the caller owns
+     * exclusion there, exactly as the raw connector escape hatch does. */
+    applyHiddenExclusion(opts) {
+        const { entry, hiddenByCollection } = opts;
+        const hiddenFields = hiddenByCollection[entry.collection];
+        if (!hiddenFields || hiddenFields.length === 0) {
+            return entry;
+        }
+        const excludeFields = Array.from(new Set([...(entry.excludeFields ?? []), ...hiddenFields]));
+        return { ...entry, excludeFields };
+    }
+    /** Provisions discovered collections via ensureCollection (additive-only; destructive migration is caller policy). Skipped if autoProvision is false; failures propagate so boot fails loudly. */
+    async provisionCollections() {
+        const logger = this.logger.for(this.provisionCollections.name);
+        if (!this.autoProvision) {
+            logger.info('autoProvision disabled | Skipping collection provisioning | Name: %s', this.name);
+            return;
+        }
+        const definitions = Object.values(this.getSchema());
+        for (const definition of definitions) {
+            await this.ensureCollection({ definition });
+            if (!definition.synonyms?.length) {
+                continue;
+            }
+            await this.provisionSynonyms({ definition });
+        }
+        logger.info('Provisioned collection(s) | Name: %s | Count: %s', this.name, definitions.length);
+    }
+    /** Engines expose synonyms as either named linkable sets or a flat per-collection dictionary, and
+     * some expose neither - so both groups are optional on `ISearchConnector` and are branched on here. */
+    async provisionSynonyms(opts) {
+        const { definition } = opts;
+        const logger = this.logger.for(this.provisionSynonyms.name);
+        const connector = this.getConnector();
+        const items = definition.synonyms ?? [];
+        if (connector.synonymSet) {
+            // Set name stays distinct from Typesense's own auto-migration name
+            // (`<collection>_synonyms_index`) so the two never clash.
+            const synonymSetName = `${definition.name}_synonyms`;
+            await connector.synonymSet.upsert({ name: synonymSetName, items });
+            await connector.synonymSet.link({
+                collection: definition.name,
+                synonymSets: [synonymSetName],
+            });
+            return;
+        }
+        if (connector.synonyms) {
+            await connector.synonyms.set({ collection: definition.name, items });
+            return;
+        }
+        logger.warn('Collection declares synonyms but the engine exposes no synonym API | Name: %s | Collection: %s', this.name, definition.name);
+    }
+}
+exports.BaseSearchDataSource = BaseSearchDataSource;
+//# sourceMappingURL=base.js.map

package/dist/connectors/search/datasources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/search/datasources/base.ts"],"names":[],"mappings":"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"}

package/dist/connectors/search/datasources/common/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/connectors/search/datasources/common/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/datasources/common/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC"}

package/dist/connectors/search/datasources/common/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/connectors/search/datasources/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/connectors/search/datasources/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB"}

package/dist/connectors/search/datasources/common/types.d.ts

@@ -0,0 +1,8 @@
+export interface ISearchDataSourceOptions<Settings extends object = {}> {
+    name: string;
+    config: Settings;
+    /** Auto-provision discovered collections on configure(). Defaults to the
+     * `APP_ENV_AUTO_PROVISION_COLLECTION` env flag, which is off unless set to 'true' or '1'. */
+    autoProvision?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/search/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/datasources/common/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,wBAAwB,CAAC,QAAQ,SAAS,MAAM,GAAG,EAAE;IACpE,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,QAAQ,CAAC;IAEjB;iGAC6F;IAC7F,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/connectors/search/datasources/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/connectors/search/datasources/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/search/datasources/common/types.ts"],"names":[],"mappings":""}