@venizia/ignis-connectors 0.2.0-0

package/dist/cjs/search/core/controllers/factory.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchControllerFactory = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const core_1 = require("@venizia/ignis-helpers/core");
+const ignis_inversion_1 = require("@venizia/ignis-inversion");
+const abstract_1 = require("./abstract");
+const definition_1 = require("./definition");
+/** Factory for generating turnkey search controllers (single-collection + cross-collection) from entity definitions. */
+class SearchControllerFactory extends core_1.BaseHelper {
+    constructor() {
+        super({ scope: SearchControllerFactory.name });
+    }
+    /** Creates a search controller with two endpoints: `POST {basePath}/search` via `repository.search()`, and `POST {basePath}/multi-search` via `repository.dataSource.multiSearch()`. */
+    static defineSearchController(defOpts) {
+        const { controller, entity, authenticate, authorize, routes } = defOpts;
+        const { name, basePath = 'unknown_path', isStrict = true } = controller;
+        if (!basePath || basePath === 'unknown_path') {
+            throw (0, core_1.getError)({
+                message: `[defineSearchController] Invalid controller basePath | name: ${name} | basePath: ${basePath}`,
+            });
+        }
+        const entityClass = (0, ignis_inversion_1.isClass)(entity) ? entity : entity();
+        const entityInstance = new entityClass();
+        const selectSchema = entityInstance.getSchema({ type: ignis_kernel_1.SchemaTypes.SELECT });
+        const routeDefinitions = (0, definition_1.defineSearchRouteConfigs)({ selectSchema, authenticate, authorize });
+        const controllerClass = class extends abstract_1.AbstractSearchController {
+            constructor(repository) {
+                super({
+                    scope: name,
+                    path: basePath,
+                    isStrict,
+                    repository,
+                    definitions: routeDefinitions,
+                });
+            }
+            /** Registers the search + multiSearch route handlers, honoring per-route enable flags. */
+            binding() {
+                const isEnabled = (routeKey) => {
+                    return routes?.[routeKey]?.enabled !== false;
+                };
+                if (isEnabled('search')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.SEARCH,
+                        handler: async (context) => this.search({ context }),
+                    });
+                }
+                if (isEnabled('multiSearch')) {
+                    this.defineRoute({
+                        configs: routeDefinitions.MULTI_SEARCH,
+                        handler: async (context) => this.multiSearch({ context }),
+                    });
+                }
+            }
+        };
+        Object.defineProperty(controllerClass, 'name', { value: name, configurable: true });
+        return controllerClass;
+    }
+}
+exports.SearchControllerFactory = SearchControllerFactory;
+//# sourceMappingURL=factory.js.map

package/dist/cjs/search/core/controllers/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../../../../../src/search/core/controllers/factory.ts"],"names":[],"mappings":";;;AAEA,wDAAoD;AAKpD,sDAAmE;AACnE,8DAAmD;AAGnD,yCAAsD;AACtD,6CAAwD;AAmCxD,wHAAwH;AACxH,MAAa,uBAAwB,SAAQ,iBAAU;IACrD;QACE,KAAK,CAAC,EAAE,KAAK,EAAE,uBAAuB,CAAC,IAAI,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,wLAAwL;IACxL,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,eAAQ,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,0BAAW,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;AAxED,0DAwEC"}

package/dist/cjs/search/core/controllers/index.d.ts

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

package/dist/cjs/search/core/controllers/index.d.ts.map

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

package/dist/cjs/search/core/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/cjs/search/core/controllers/index.js.map

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

package/dist/cjs/search/core/datasources/abstract.d.ts

@@ -0,0 +1,23 @@
+import { AbstractDataSource } from '@venizia/ignis-kernel';
+import type { ISearchConnector } from '../../../search/core/connector';
+import type { ISearchCollectionDefinition, TSearchSchema } from '../../../search/core/models';
+import type { ISearchQueryDialect, TMultiSearchEntry } from '../../../search/core/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. Return is `unknown` because each engine's envelope differs (Typesense union, Meilisearch federation) and a concrete datasource narrows it; declared here so a datasource-generic repository 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/cjs/search/core/datasources/abstract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAEhG,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,wOAAwO;IACxO,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/cjs/search/core/datasources/abstract.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractSearchDataSource = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+/** Engine contract only (connector, dialect, collection compile/ensure) - mirrors AbstractPostgresDataSource. Discovery/provisioning lives on BaseSearchDataSource. */
+class AbstractSearchDataSource extends ignis_kernel_1.AbstractDataSource {
+}
+exports.AbstractSearchDataSource = AbstractSearchDataSource;
+//# sourceMappingURL=abstract.js.map

package/dist/cjs/search/core/datasources/abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../../src/search/core/datasources/abstract.ts"],"names":[],"mappings":";;;AAAA,wDAA2D;AAK3D,uKAAuK;AACvK,MAAsB,wBAEpB,SAAQ,iCAA2C;CAepD;AAjBD,4DAiBC"}

package/dist/cjs/search/core/datasources/base.d.ts

@@ -0,0 +1,47 @@
+import type { ISearchConnector } from '../../../search/core/connector';
+import type { ISearchCollectionDefinition, TSearchSchema } from '../../../search/core/models';
+import type { ISearchDataSourceOptions } from '../../../search/core/datasources/common';
+import type { TMultiSearchEntry } from '../../../search/core/repositories/common';
+import { AbstractSearchDataSource } from './abstract';
+/** Collection discovery/provisioning + connector lifecycle, mirroring BasePostgresDataSource. Paradigm seam: the connector is held via the `ISearchConnector`-bounded generic, never an engine type - 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, so it lives on the datasource, not a repository; the envelope is engine-specific, so the return is `unknown` and `TypesenseDataSource` narrows it. */
+    multiSearch(opts: {
+        searches: TMultiSearchEntry[];
+        union?: boolean;
+        commonParams?: Omit<TMultiSearchEntry, 'collection'>;
+        options?: unknown;
+    }): Promise<unknown>;
+    /** Reads `static searchCollection`, falling back to shape-guarded `static schema`; 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 shape-guarded `schema`; undefined when it carries neither. */
+    private readCollectionDefinition;
+    /** Collection name -> `@model` hiddenProperties for cross-collection operations. Collections with none are omitted, so callers own exclusion for absent entries; memoized per instance and never invalidated because the metadata is frozen after boot. */
+    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 not a discovered definition passes through untouched - the caller owns exclusion there. */
+    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 named linkable sets, a flat per-collection dictionary, or neither - both groups are optional on `ISearchConnector`, hence the branch. */
+    protected provisionSynonyms(opts: {
+        definition: ISearchCollectionDefinition;
+    }): Promise<void>;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/cjs/search/core/datasources/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/datasources/base.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,2BAA2B,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAEvF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AACjF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAI3E,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAkBtD,kPAAkP;AAClP,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;IAmBjF,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;IAKnC,qBAAqB,IAAI,OAAO;IAKhC,2KAA2K;IAC3K,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;IAwBpB,kKAAkK;IAClK,SAAS,CAAC,mBAAmB,IAAI,aAAa;IAO9C,gKAAgK;IAChK,OAAO,CAAC,wBAAwB;IAYhC,2PAA2P;IAC3P,SAAS,CAAC,wBAAwB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAK9D,6HAA6H;IAC7H,SAAS,CAAC,gCAAgC,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAoBtE,2MAA2M;IAC3M,OAAO,CAAC,oBAAoB;IAe5B,kMAAkM;cAClL,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BrD,uKAAuK;cACvJ,iBAAiB,CAAC,IAAI,EAAE;QACtC,UAAU,EAAE,2BAA2B,CAAC;KACzC,GAAG,OAAO,CAAC,IAAI,CAAC;CA6BlB"}

package/dist/cjs/search/core/datasources/base.js

@@ -0,0 +1,166 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSearchDataSource = void 0;
+const common_1 = require("../../../search/core/repositories/common");
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const core_1 = require("@venizia/ignis-helpers/core");
+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, mirroring BasePostgresDataSource. Paradigm seam: the connector is held via the `ISearchConnector`-bounded generic, never an engine type - 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;
+        // `globalThis.process?.` not bare `process.`: `search/core` sits in the browser-pure root
+        // barrel, and a free `process` identifier throws a ReferenceError outside Node.
+        const autoProvision = (globalThis.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, core_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() {
+        this.schema ??= this.discoverCollections();
+        return this.schema;
+    }
+    hasDiscoverableModels() {
+        const registry = ignis_kernel_1.MetadataRegistry.getInstance();
+        return registry.hasModels({ dataSource: this.constructor });
+    }
+    /** Cross-collection, so it lives on the datasource, not a repository; the envelope is engine-specific, so the return is `unknown` and `TypesenseDataSource` narrows it. */
+    multiSearch(opts) {
+        const { searches, union: isUnion, commonParams, options } = opts;
+        const dialect = this.getQueryDialect();
+        const hiddenByCollection = this.hiddenFieldsByCollection();
+        // Same friendly -> wire mapping search() uses, unioning each entry's hidden fields into excludeFields per collection.
+        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`, falling back to shape-guarded `static schema`; 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 shape-guarded `schema`; undefined when it carries neither. */
+    readCollectionDefinition(modelClass) {
+        const model = modelClass;
+        if (model.searchCollection) {
+            return model.searchCollection;
+        }
+        return isSearchCollectionDefinition(model.schema) ? model.schema : undefined;
+    }
+    /** Collection name -> `@model` hiddenProperties for cross-collection operations. Collections with none are omitted, so callers own exclusion for absent entries; memoized per instance and never invalidated because the metadata is frozen after boot. */
+    hiddenFieldsByCollection() {
+        this.hiddenFieldsByCollectionMap ??= this.discoverHiddenFieldsByCollection();
+        return this.hiddenFieldsByCollectionMap;
+    }
+    /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the `getSchema()` / `discoverCollections()` split. */
+    discoverHiddenFieldsByCollection() {
+        const registry = ignis_kernel_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 not a discovered definition passes through untouched - the caller owns exclusion there. */
+    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 named linkable sets, a flat per-collection dictionary, or neither - both groups are optional on `ISearchConnector`, hence the branch. */
+    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) {
+            // 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/cjs/search/core/datasources/base.js.map

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

package/dist/cjs/search/core/datasources/common/index.d.ts

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

package/dist/cjs/search/core/datasources/common/index.d.ts.map

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

package/dist/cjs/search/core/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/cjs/search/core/datasources/common/index.js.map

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

package/dist/cjs/search/core/datasources/common/types.d.ts

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

package/dist/cjs/search/core/datasources/common/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/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,8IAA8I;IAC9I,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

package/dist/cjs/search/core/datasources/common/types.js

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

package/dist/cjs/search/core/datasources/common/types.js.map

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

package/dist/cjs/search/core/datasources/index.d.ts

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

package/dist/cjs/search/core/datasources/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/datasources/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

package/dist/cjs/search/core/datasources/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("./base"), exports);
+__exportStar(require("./common"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/search/core/datasources/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/search/core/datasources/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6CAA2B;AAC3B,yCAAuB;AACvB,2CAAyB"}

package/dist/cjs/search/core/index.d.ts

@@ -0,0 +1,7 @@
+export * from './common';
+export * from './connector';
+export * from './controllers';
+export * from './datasources';
+export * from './models';
+export * from './repositories';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/search/core/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/search/core/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}

package/dist/cjs/search/core/index.js

@@ -0,0 +1,23 @@
+"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("./common"), exports);
+__exportStar(require("./connector"), exports);
+__exportStar(require("./controllers"), exports);
+__exportStar(require("./datasources"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./repositories"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/search/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/search/core/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,8CAA4B;AAC5B,gDAA8B;AAC9B,gDAA8B;AAC9B,2CAAyB;AACzB,iDAA+B"}

package/dist/cjs/search/core/internal/index.d.ts

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

package/dist/cjs/search/core/internal/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/internal/index.ts"],"names":[],"mappings":"AAAA,cAAc,6BAA6B,CAAC"}

package/dist/cjs/search/core/internal/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("./search-connector-internal"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/search/core/internal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/search/core/internal/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8DAA4C"}

package/dist/cjs/search/core/internal/search-connector-internal.d.ts

@@ -0,0 +1,18 @@
+import type { ILogger } from '@venizia/ignis-helpers/core';
+/** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */
+export declare class SearchConnectorInternal {
+    static describeError(opts: {
+        error: unknown;
+    }): unknown;
+    static wrapDependencyError(opts: {
+        method: string;
+        error: unknown;
+        logger: ILogger;
+        details?: Record<string, unknown>;
+    }): never;
+    static throwNotFoundError(opts: {
+        method: string;
+        subject: string;
+    }): never;
+}
+//# sourceMappingURL=search-connector-internal.d.ts.map

package/dist/cjs/search/core/internal/search-connector-internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-connector-internal.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/internal/search-connector-internal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAI3D,6KAA6K;AAC7K,qBAAa,uBAAuB;IAElC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAMvD,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE;QAC/B,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,OAAO,CAAC;QACf,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACnC,GAAG,KAAK;IAuBT,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;CAQ5E"}

package/dist/cjs/search/core/internal/search-connector-internal.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchConnectorInternal = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const common_1 = require("../../../search/core/common");
+const core_1 = require("@venizia/ignis-helpers/core");
+const common_2 = require("@venizia/ignis-helpers/common");
+/** Engine-agnostic error plumbing shared by every search connector; backend-specific classification (what counts as 404/409) lives in each backend's own internal helper. */
+class SearchConnectorInternal {
+    // Error/stack are non-enumerable, so `%j` on a raw Error yields `{}` - extract them so logs retain detail.
+    static describeError(opts) {
+        const { error } = opts;
+        return error instanceof Error ? (error.stack ?? error.message) : error;
+    }
+    // Logs the full error internally, throws a sanitized 503 with zero internal leakage; `details` is caller-actionable progress info (counts, offsets) only, never engine detail.
+    static wrapDependencyError(opts) {
+        const { method, error, logger, details } = opts;
+        logger
+            .for(method)
+            .error('Search engine dependency error | detail: %s', SearchConnectorInternal.describeError({ error }));
+        const wrapped = (0, core_1.getError)({
+            statusCode: common_2.HTTP.ResultCodes.RS_5.ServiceUnavailable,
+            messageCode: ignis_kernel_1.SearchErrorCodes.DEPENDENCY_UNAVAILABLE,
+            message: `[${method}] Search engine is temporarily unavailable.`,
+            ...(details ? { extra: { details } } : {}),
+        });
+        // Keeps the engine's own code for callers to classify on (tolerating `index_already_exists`); assigned AFTER construction because `cause` via getError() lands in `extra`, which goes on the WIRE, while a plain `cause` is exposed only in development.
+        wrapped.cause = error;
+        throw wrapped;
+    }
+    // Throws a sanitized 404; `subject` must only contain caller-provided identifiers, never engine internals.
+    static throwNotFoundError(opts) {
+        const { method, subject } = opts;
+        throw (0, core_1.getError)({
+            error: common_1.SearchErrors.NOT_FOUND,
+            message: `[${method}] ${subject} not found.`,
+        });
+    }
+}
+exports.SearchConnectorInternal = SearchConnectorInternal;
+//# sourceMappingURL=search-connector-internal.js.map

package/dist/cjs/search/core/internal/search-connector-internal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search-connector-internal.js","sourceRoot":"","sources":["../../../../../src/search/core/internal/search-connector-internal.ts"],"names":[],"mappings":";;;AAAA,wDAAyD;AACzD,iDAAoD;AAEpD,sDAAuD;AACvD,0DAAqD;AAErD,6KAA6K;AAC7K,MAAa,uBAAuB;IAClC,2GAA2G;IAC3G,MAAM,CAAC,aAAa,CAAC,IAAwB;QAC3C,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;IACzE,CAAC;IAED,+KAA+K;IAC/K,MAAM,CAAC,mBAAmB,CAAC,IAK1B;QACC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEhD,MAAM;aACH,GAAG,CAAC,MAAM,CAAC;aACX,KAAK,CACJ,6CAA6C,EAC7C,uBAAuB,CAAC,aAAa,CAAC,EAAE,KAAK,EAAE,CAAC,CACjD,CAAC;QAEJ,MAAM,OAAO,GAAG,IAAA,eAAQ,EAAC;YACvB,UAAU,EAAE,aAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;YACpD,WAAW,EAAE,+BAAgB,CAAC,sBAAsB;YACpD,OAAO,EAAE,IAAI,MAAM,6CAA6C;YAChE,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC3C,CAAC,CAAC;QAEH,yPAAyP;QACxP,OAA+B,CAAC,KAAK,GAAG,KAAK,CAAC;QAC/C,MAAM,OAAO,CAAC;IAChB,CAAC;IAED,2GAA2G;IAC3G,MAAM,CAAC,kBAAkB,CAAC,IAAyC;QACjE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QAEjC,MAAM,IAAA,eAAQ,EAAC;YACb,KAAK,EAAE,qBAAY,CAAC,SAAS;YAC7B,OAAO,EAAE,IAAI,MAAM,KAAK,OAAO,aAAa;SAC7C,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,0DA4CC"}