@venizia/ignis-connectors 0.2.0-0

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

@@ -0,0 +1,47 @@
+import type { ISearchConnector } from '../../../search/core/connector.js';
+import type { ISearchCollectionDefinition, TSearchSchema } from '../../../search/core/models/index.js';
+import type { ISearchDataSourceOptions } from '../../../search/core/datasources/common/index.js';
+import type { TMultiSearchEntry } from '../../../search/core/repositories/common/index.js';
+import { AbstractSearchDataSource } from './abstract.js';
+/** 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/esm/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/esm/search/core/datasources/base.js

@@ -0,0 +1,162 @@
+import { toSearchQueryParams } from '../../../search/core/repositories/common/index.js';
+import { MetadataRegistry } from '@venizia/ignis-kernel';
+import { getError } from '@venizia/ignis-helpers/core';
+import { AbstractSearchDataSource } from './abstract.js';
+/** 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()`. */
+export class BaseSearchDataSource extends 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 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 = 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: toSearchQueryParams(this.applyHiddenExclusion({ entry, hiddenByCollection })),
+            }),
+        }));
+        const wireCommonParams = commonParams
+            ? dialect.toWireParams({ query: 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 = 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);
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/search/core/datasources/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/search/core/datasources/base.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAQtD,8KAA8K;AAC9K,MAAM,4BAA4B,GAAG,CAAC,KAAc,EAAwC,EAAE;IAC5F,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAQ,KAA4B,CAAC,IAAI,KAAK,QAAQ;QACtD,KAAK,CAAC,OAAO,CAAE,KAA8B,CAAC,MAAM,CAAC,CACtD,CAAC;AACJ,CAAC,CAAC;AAEF,kPAAkP;AAClP,MAAM,OAAgB,oBAGpB,SAAQ,wBAAkC;IAO1C,YAAY,IAAqE;QAC/E,KAAK,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QAE5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC;QAC5B,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,SAAS,CAAC;QAExC,0FAA0F;QAC1F,gFAAgF;QAChF,MAAM,aAAa,GAAG,CACpB,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,iCAAiC,IAAI,OAAO,CACtE,CAAC,WAAW,EAAE,CAAC;QAChB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,IAAI,CAAC,aAAa,KAAK,MAAM,IAAI,aAAa,KAAK,GAAG,CAAC,CAAC;QAC/F,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,6DAA6D,EAC7D,IAAI,CAAC,aAAa,CACnB,CAAC;IACJ,CAAC;IAKD,iKAAiK;IACjK,KAAK,CAAC,SAAS;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC,MAAM;iBACR,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;iBACxB,IAAI,CAAC,0DAA0D,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,OAAO;QACT,CAAC;QAED,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,iBAAiB,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QAElE,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;IACpC,CAAC;IAED,YAAY;QACV,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,uCAAuC,IAAI,CAAC,IAAI,2BAA2B;aAC9G,CAAC,CAAC;QACL,CAAC;QAED,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,6EAA6E;IACpE,SAAS;QAChB,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,qBAAqB;QACnB,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,SAAS,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,WAAkC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,2KAA2K;IAC3K,WAAW,CAAC,IAKX;QACC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;QACjE,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,CAAC;QACvC,MAAM,kBAAkB,GAAG,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAE3D,sHAAsH;QACtH,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YAC1C,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,OAAO,CAAC,YAAY,CAAC;gBACtB,KAAK,EAAE,mBAAmB,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;aACrF,CAAC;SACH,CAAC,CAAC,CAAC;QACJ,MAAM,gBAAgB,GAAG,YAAY;YACnC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,KAAK,EAAE,mBAAmB,CAAC,YAAY,CAAC,EAAE,CAAC;YACpE,CAAC,CAAC,SAAS,CAAC;QAEd,OAAO,IAAI,CAAC,YAAY,EAAE,CAAC,WAAW,CAAC;YACrC,QAAQ,EAAE,YAAY;YACtB,KAAK,EAAE,OAAO;YACd,YAAY,EAAE,gBAAgB;YAC9B,OAAO;SACR,CAAC,CAAC;IACL,CAAC;IAED,kKAAkK;IACxJ,mBAAmB;QAC3B,OAAO,IAAI,CAAC,mBAAmB,CAA8B;YAC3D,IAAI,EAAE,YAAY;YAClB,IAAI,EAAE,UAAU,CAAC,EAAE,CAAC,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC;SAC9D,CAAC,CAAC;IACL,CAAC;IAED,gKAAgK;IACxJ,wBAAwB,CAC9B,UAA2B;QAE3B,MAAM,KAAK,GAAG,UAAqC,CAAC;QAEpD,IAAI,KAAK,CAAC,gBAAgB,EAAE,CAAC;YAC3B,OAAO,KAAK,CAAC,gBAAgB,CAAC;QAChC,CAAC;QAED,OAAO,4BAA4B,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,CAAC;IAED,2PAA2P;IACjP,wBAAwB;QAChC,IAAI,CAAC,2BAA2B,KAAK,IAAI,CAAC,gCAAgC,EAAE,CAAC;QAC7E,OAAO,IAAI,CAAC,2BAA2B,CAAC;IAC1C,CAAC;IAED,6HAA6H;IACnH,gCAAgC;QACxC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,WAAW,EAAE,CAAC;QAChD,MAAM,MAAM,GAA6B,EAAE,CAAC;QAE5C,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;YACrD,MAAM,UAAU,GAAG,IAAI,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;YAC7D,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,SAAS;YACX,CAAC;YAED,MAAM,gBAAgB,GAAG,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,EAAE,QAAQ;gBAClF,EAAE,gBAAgB,CAAC;YACrB,IAAI,gBAAgB,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,gBAAgB,CAAC;YAC7C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2MAA2M;IACnM,oBAAoB,CAAC,IAG5B;QACC,MAAM,EAAE,KAAK,EAAE,kBAAkB,EAAE,GAAG,IAAI,CAAC;QAC3C,MAAM,YAAY,GAAG,kBAAkB,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;QAE1D,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,MAAM,aAAa,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,EAAE,CAAC,EAAE,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;QAC7F,OAAO,EAAE,GAAG,KAAK,EAAE,aAAa,EAAE,CAAC;IACrC,CAAC;IAED,kMAAkM;IACxL,KAAK,CAAC,oBAAoB;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,CAAC;QAE/D,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;YACxB,MAAM,CAAC,IAAI,CACT,sEAAsE,EACtE,IAAI,CAAC,IAAI,CACV,CAAC;YACF,OAAO;QACT,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC;QAEpD,KAAK,MAAM,UAAU,IAAI,WAAW,EAAE,CAAC;YACrC,MAAM,IAAI,CAAC,gBAAgB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;YAE5C,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;gBACjC,SAAS;YACX,CAAC;YAED,MAAM,IAAI,CAAC,iBAAiB,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACjG,CAAC;IAED,uKAAuK;IAC7J,KAAK,CAAC,iBAAiB,CAAC,IAEjC;QACC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC;QAC5D,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACtC,MAAM,KAAK,GAAG,UAAU,CAAC,QAAQ,IAAI,EAAE,CAAC;QAExC,IAAI,SAAS,CAAC,UAAU,EAAE,CAAC;YACzB,kHAAkH;YAClH,MAAM,cAAc,GAAG,GAAG,UAAU,CAAC,IAAI,WAAW,CAAC;YAErD,MAAM,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC;YACnE,MAAM,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC;gBAC9B,UAAU,EAAE,UAAU,CAAC,IAAI;gBAC3B,WAAW,EAAE,CAAC,cAAc,CAAC;aAC9B,CAAC,CAAC;YACH,OAAO;QACT,CAAC;QAED,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;YACvB,MAAM,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;YACrE,OAAO;QACT,CAAC;QAED,MAAM,CAAC,IAAI,CACT,gGAAgG,EAChG,IAAI,CAAC,IAAI,EACT,UAAU,CAAC,IAAI,CAChB,CAAC;IACJ,CAAC;CACF"}

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

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

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

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

package/dist/esm/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,cAAc,SAAS,CAAC"}

package/dist/esm/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/esm/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/esm/search/core/datasources/common/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/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/esm/search/core/datasources/index.d.ts

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

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

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

package/dist/esm/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,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC"}

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

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/search/core/internal/index.d.ts

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

package/dist/esm/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/esm/search/core/internal/index.js

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

package/dist/esm/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,cAAc,6BAA6B,CAAC"}

package/dist/esm/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/esm/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/esm/search/core/internal/search-connector-internal.js

@@ -0,0 +1,37 @@
+import { SearchErrorCodes } from '@venizia/ignis-kernel';
+import { SearchErrors } from '../../../search/core/common/index.js';
+import { getError } from '@venizia/ignis-helpers/core';
+import { HTTP } from '@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. */
+export 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 = getError({
+            statusCode: HTTP.ResultCodes.RS_5.ServiceUnavailable,
+            messageCode: 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 getError({
+            error: SearchErrors.NOT_FOUND,
+            message: `[${method}] ${subject} not found.`,
+        });
+    }
+}
+//# sourceMappingURL=search-connector-internal.js.map

package/dist/esm/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,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEpD,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,+BAA+B,CAAC;AAErD,6KAA6K;AAC7K,MAAM,OAAO,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,QAAQ,CAAC;YACvB,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;YACpD,WAAW,EAAE,gBAAgB,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,QAAQ,CAAC;YACb,KAAK,EAAE,YAAY,CAAC,SAAS;YAC7B,OAAO,EAAE,IAAI,MAAM,KAAK,OAAO,aAAa;SAC7C,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/esm/search/core/models/base.d.ts

@@ -0,0 +1,23 @@
+import type { z } from '@hono/zod-openapi';
+import type { TSchemaType } from '@venizia/ignis-kernel';
+import { AbstractEntity } from '@venizia/ignis-kernel';
+import type { ISearchCollectionDefinition, TSearchDocument } from './types.js';
+/** Engine-neutral search-document entity deriving zod schemas from an `ISearchCollectionDefinition`. `Schema` is instance-side only so `schema` carries the caller's literal collection type - mirrors `BasePostgresEntity`'s static-wide / instance-narrow duality. */
+export declare class BaseSearchEntity<Schema extends ISearchCollectionDefinition = ISearchCollectionDefinition> extends AbstractEntity {
+    schema: Schema;
+    readonly $inferData?: TSearchDocument<Schema>;
+    readonly $inferPersist?: TSearchDocument<Schema>;
+    static COLLECTION_NAME?: string;
+    static AUTHORIZATION_SUBJECT?: string;
+    static schema: ISearchCollectionDefinition;
+    static documentSchema?: z.ZodTypeAny;
+    private static readonly _schemaCache;
+    constructor(opts?: {
+        name?: string;
+        schema?: Schema;
+    });
+    getSchema<T = unknown>(opts: {
+        type: TSchemaType;
+    }): T;
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/esm/search/core/models/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG5E,wQAAwQ;AACxQ,qBAAa,gBAAgB,CAC3B,MAAM,SAAS,2BAA2B,GAAG,2BAA2B,CACxE,SAAQ,cAAc;IACtB,MAAM,EAAE,MAAM,CAAC;IAGf,SAAiB,UAAU,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACtD,SAAiB,aAAa,CAAC,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IAEzD,MAAM,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAChC,MAAM,CAAC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAEtC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAE3C,MAAM,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,UAAU,CAAC;IACrC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,YAAY,CAAuD;gBAE/E,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE;IASrD,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE;QAAE,IAAI,EAAE,WAAW,CAAA;KAAE,GAAG,CAAC;CAgCvD"}

package/dist/esm/search/core/models/base.js

@@ -0,0 +1,40 @@
+import { getError } from '@venizia/ignis-helpers/core';
+import { AbstractEntity } from '@venizia/ignis-kernel';
+import { deriveSearchDocumentSchema } from './zod-derivation.js';
+/** Engine-neutral search-document entity deriving zod schemas from an `ISearchCollectionDefinition`. `Schema` is instance-side only so `schema` carries the caller's literal collection type - mirrors `BasePostgresEntity`'s static-wide / instance-narrow duality. */
+export class BaseSearchEntity extends AbstractEntity {
+    static { this._schemaCache = new Map(); }
+    constructor(opts) {
+        const ctor = new.target;
+        const name = opts?.name ?? ctor.COLLECTION_NAME ?? ctor.schema?.name ?? ctor.name;
+        super({ name });
+        this.schema = opts?.schema ?? ctor.schema;
+    }
+    getSchema(opts) {
+        const ctor = this.constructor;
+        if (ctor.documentSchema) {
+            return ctor.documentSchema;
+        }
+        if (!this.schema) {
+            throw getError({
+                message: `[BaseSearchEntity] Missing collection definition | name: ${this.name} | define a static "schema" (via defineSearchCollection) or pass one to the constructor`,
+            });
+        }
+        if (this.schema !== ctor.schema) {
+            return deriveSearchDocumentSchema({ definition: this.schema, type: opts.type });
+        }
+        let byType = BaseSearchEntity._schemaCache.get(ctor);
+        if (!byType) {
+            byType = new Map();
+            BaseSearchEntity._schemaCache.set(ctor, byType);
+        }
+        const cached = byType.get(opts.type);
+        if (cached) {
+            return cached;
+        }
+        const derived = deriveSearchDocumentSchema({ definition: this.schema, type: opts.type });
+        byType.set(opts.type, derived);
+        return derived;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/esm/search/core/models/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/search/core/models/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAGvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAE9D,wQAAwQ;AACxQ,MAAM,OAAO,gBAEX,SAAQ,cAAc;aAaE,iBAAY,GAAG,IAAI,GAAG,EAA4C,CAAC;IAE3F,YAAY,IAAyC;QACnD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAiC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC;QAElF,KAAK,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAEhB,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,MAAM,IAAK,IAAI,CAAC,MAAiB,CAAC;IACxD,CAAC;IAED,SAAS,CAAc,IAA2B;QAChD,MAAM,IAAI,GAAG,IAAI,CAAC,WAAsC,CAAC;QAEzD,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAmB,CAAC;QAClC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,QAAQ,CAAC;gBACb,OAAO,EAAE,4DAA4D,IAAI,CAAC,IAAI,yFAAyF;aACxK,CAAC,CAAC;QACL,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,0BAA0B,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAM,CAAC;QACvF,CAAC;QAED,IAAI,MAAM,GAAG,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,GAAG,IAAI,GAAG,EAA6B,CAAC;YAC9C,gBAAgB,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAClD,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,MAAW,CAAC;QACrB,CAAC;QAED,MAAM,OAAO,GAAG,0BAA0B,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzF,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAC/B,OAAO,OAAY,CAAC;IACtB,CAAC"}

package/dist/esm/search/core/models/define-search-collection.d.ts

@@ -0,0 +1,54 @@
+import type { ISearchCollectionDefinition, ISearchEmbedConfig, TFieldFlags, TVectorDistance } from './types.js';
+import { SearchFieldTypes } from './types.js';
+export declare const field: {
+    id: () => {
+        name: "id";
+        type: "string";
+    };
+    string: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "string";
+    } & O;
+    strings: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "string[]";
+    } & O;
+    number: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "number";
+    } & O;
+    numbers: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "number[]";
+    } & O;
+    boolean: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "boolean";
+    } & O;
+    booleans: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "boolean[]";
+    } & O;
+    geopoint: <const N extends string, const O extends TFieldFlags = {}>(name: N, opts?: O | undefined) => {
+        name: N;
+        type: "geopoint";
+    } & O;
+    /** `vector` carries its own `O` shape (dimensions/distance/embed) instead of routing through `buildField`; the `O extends { optional: true }` conditional makes `optional` appear, in type and at runtime, only when set - keeping `TSearchDocument`'s optional split working. */
+    vector: <const N extends string, const O extends {
+        dimensions?: number;
+        distance?: TVectorDistance;
+        embed?: ISearchEmbedConfig;
+        optional?: boolean;
+    }>(name: N, opts: O) => {
+        name: N;
+        type: typeof SearchFieldTypes.VECTOR;
+        vector: Omit<O, "optional">;
+    } & (O extends {
+        optional: true;
+    } ? {
+        optional: true;
+    } : object);
+};
+/** `<const T>` preserves field literals so `TSearchDocument<typeof X>` can map over them - a plain `T extends ISearchCollectionDefinition` would widen `fields` and lose every literal. */
+export declare const defineSearchCollection: <const T extends ISearchCollectionDefinition>(opts: T) => T;
+//# sourceMappingURL=define-search-collection.d.ts.map

package/dist/esm/search/core/models/define-search-collection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-search-collection.d.ts","sourceRoot":"","sources":["../../../../../src/search/core/models/define-search-collection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAGlB,WAAW,EAEX,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA2B3C,eAAO,MAAM,KAAK;cACR;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,IAAI,EAAE,QAAQ,CAAA;KAAE;mBAR/B,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;oBAA7C,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;mBAA7C,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;oBAA7C,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;oBAA7C,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;qBAA7C,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;qBAA7C,CAAC,SAAS,MAAM,QAAQ,CAAC,SAAS,WAAW;;;;IAkBpD,kRAAkR;mBAE1Q,CAAC,SAAS,MAAM,QAChB,CAAC,SAAS;QACd,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,EAAE,eAAe,CAAC;QAC3B,KAAK,CAAC,EAAE,kBAAkB,CAAC;QAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC;KACpB,QAEK,CAAC,QACD,CAAC,KACN;QAAE,IAAI,EAAE,CAAC,CAAC;QAAC,IAAI,EAAE,OAAO,gBAAgB,CAAC,MAAM,CAAC;QAAC,MAAM,EAAE,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAA;KAAE,GAAG,CAAC,CAAC,SAAS;QAC7F,QAAQ,EAAE,IAAI,CAAC;KAChB,GACG;QAAE,QAAQ,EAAE,IAAI,CAAA;KAAE,GAClB,MAAM,CAAC;CAWZ,CAAC;AAkBF,2LAA2L;AAC3L,eAAO,MAAM,sBAAsB,GAAI,KAAK,CAAC,CAAC,SAAS,2BAA2B,EAAE,MAAM,CAAC,KAAG,CAkF7F,CAAC"}