@venizia/ignis 0.1.1-8 → 0.1.1

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

@@ -1 +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"}
+{"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;AAmCxD,wHAAwH;AACxH,MAAa,uBAAwB,SAAQ,0BAAU;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,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;AAxED,0DAwEC"}

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

@@ -12,9 +12,7 @@ export declare abstract class AbstractSearchDataSource<Settings extends object =
     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. */
+    /** 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;

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

@@ -1 +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"}
+{"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,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/connectors/search/datasources/abstract.js.map

@@ -1 +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"}
+{"version":3,"file":"abstract.js","sourceRoot":"","sources":["../../../../src/connectors/search/datasources/abstract.ts"],"names":[],"mappings":";;;AAAA,oDAAwD;AAQxD,uKAAuK;AACvK,MAAsB,wBAEpB,SAAQ,gCAA2C;CAepD;AAjBD,4DAiBC"}

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

@@ -3,9 +3,7 @@ import type { ISearchCollectionDefinition, TSearchSchema } from '../../../connec
 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 - mirrors
- * BasePostgresDataSource. Paradigm seam: the connector is held via the `ISearchConnector`-bounded
- * generic, never an engine type - engines supply only `createConnector()`. */
+/** 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[]>;
@@ -22,35 +20,26 @@ export declare abstract class BaseSearchDataSource<Settings extends object = {},
     /** Auto-discovers collections from repositories if not manually provided. */
     getSchema(): TSearchSchema;
     hasDiscoverableModels(): boolean;
-    /** Cross-collection search, so it lives on the datasource, not a repository. Engine-specific
-     * envelope: neutral return is `unknown`; `TypesenseDataSource` narrows it. */
+    /** 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`; skips classes
-     * with neither. Honors `@datasource({ autoDiscovery: false })` same as the postgres branch. */
+    /** 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 the
-     * shape-guarded `schema`); returns undefined for a class carrying neither. */
+    /** 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 (multiSearch).
-     * Collections with none are omitted - callers own exclusion for absent entries. Memoized per
-     * instance: `@model`/`@repository` metadata is frozen after boot, so never invalidated. */
+    /** 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. */
+    /** 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. */
+    /** 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 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. */
+    /** 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>;

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

@@ -1 +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;AAoBtD;;8EAE8E;AAC9E,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;kFAC8E;IAC9E,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;mGAC+F;IAC/F,SAAS,CAAC,mBAAmB,IAAI,aAAa;IAO9C;kFAC8E;IAC9E,OAAO,CAAC,wBAAwB;IAYhC;;+FAE2F;IAC3F,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"}
+{"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;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;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,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/connectors/search/datasources/base.js

@@ -5,17 +5,14 @@ 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. */
+/** 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 - mirrors
- * BasePostgresDataSource. Paradigm seam: the connector is held via the `ISearchConnector`-bounded
- * generic, never an engine type - engines supply only `createConnector()`. */
+/** 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 });
@@ -56,14 +53,12 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
         const registry = inversion_1.MetadataRegistry.getInstance();
         return registry.hasModels({ dataSource: this.constructor });
     }
-    /** Cross-collection search, so it lives on the datasource, not a repository. Engine-specific
-     * envelope: neutral return is `unknown`; `TypesenseDataSource` narrows it. */
+    /** 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; unions each entry's hidden fields into
-        // excludeFields per collection, exactly as search() does for @model hiddenProperties.
+        // 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({
@@ -80,16 +75,14 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
             options,
         });
     }
-    /** Reads `static searchCollection`, falling back to shape-guarded `static schema`; skips classes
-     * with neither. Honors `@datasource({ autoDiscovery: false })` same as the postgres branch. */
+    /** 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 the
-     * shape-guarded `schema`); returns undefined for a class carrying neither. */
+    /** 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) {
@@ -97,15 +90,12 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
         }
         return isSearchCollectionDefinition(model.schema) ? model.schema : undefined;
     }
-    /** Collection name -> `@model` hiddenProperties, for cross-collection operations (multiSearch).
-     * Collections with none are omitted - callers own exclusion for absent entries. Memoized per
-     * instance: `@model`/`@repository` metadata is frozen after boot, so never invalidated. */
+    /** 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. */
+    /** The registry/model walk behind `hiddenFieldsByCollection` - mirrors the `getSchema()` / `discoverCollections()` split. */
     discoverHiddenFieldsByCollection() {
         const registry = inversion_1.MetadataRegistry.getInstance();
         const result = {};
@@ -122,9 +112,7 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
         }
         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. */
+    /** 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];
@@ -151,16 +139,14 @@ class BaseSearchDataSource extends abstract_1.AbstractSearchDataSource {
         }
         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. */
+    /** 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) {
-            // Set name stays distinct from Typesense's own auto-migration name
-            // (`<collection>_synonyms_index`) so the two never clash.
+            // 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({

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

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

@@ -1,8 +1,7 @@
 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'. */
+    /** 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/connectors/search/datasources/common/types.d.ts.map

@@ -1 +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"}
+{"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,8IAA8I;IAC9I,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB"}

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

@@ -1,3 +1,4 @@
+export * from './common';
 export * from './connector';
 export * from './controllers';
 export * from './datasources';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/search/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/connectors/search/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/connectors/search/index.js

@@ -14,6 +14,7 @@ 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);

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

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

package/dist/connectors/search/internal/search-connector-internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"search-connector-internal.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/internal/search-connector-internal.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,6KAA6K;AAC7K,qBAAa,uBAAuB;IAElC,MAAM,CAAC,aAAa,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO;IAOvD,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;IAyBT,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,KAAK;CAS5E"}
+{"version":3,"file":"search-connector-internal.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/internal/search-connector-internal.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAGtD,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/connectors/search/internal/search-connector-internal.js

@@ -2,16 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchConnectorInternal = void 0;
 const common_1 = require("../../../common");
+const common_2 = require("../../../connectors/search/common");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
 /** 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.
+    // 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 for caller-actionable progress info (counts, offsets) only, never engine detail.
+    // 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
@@ -23,9 +23,7 @@ class SearchConnectorInternal {
             message: `[${method}] Search engine is temporarily unavailable.`,
             ...(details ? { extra: { details } } : {}),
         });
-        // The original engine error carries the code callers may classify on (e.g. tolerating
-        // `index_already_exists`). Assigned AFTER construction: `cause` via getError() would land in
-        // `extra`, which goes on the WIRE - a plain `cause` is exposed only in development.
+        // 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;
     }
@@ -33,8 +31,7 @@ class SearchConnectorInternal {
     static throwNotFoundError(opts) {
         const { method, subject } = opts;
         throw (0, ignis_helpers_1.getError)({
-            statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.NotFound,
-            messageCode: common_1.SearchErrorCodes.NOT_FOUND,
+            error: common_2.SearchErrors.NOT_FOUND,
             message: `[${method}] ${subject} not found.`,
         });
     }

package/dist/connectors/search/internal/search-connector-internal.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-connector-internal.js","sourceRoot":"","sources":["../../../../src/connectors/search/internal/search-connector-internal.ts"],"names":[],"mappings":";;;AAAA,qCAA4C;AAE5C,0DAAwD;AAExD,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,qFAAqF;IACrF,gGAAgG;IAChG,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,wBAAQ,EAAC;YACvB,UAAU,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;YACpD,WAAW,EAAE,yBAAgB,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,sFAAsF;QACtF,6FAA6F;QAC7F,oFAAoF;QACnF,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,wBAAQ,EAAC;YACb,UAAU,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ;YAC1C,WAAW,EAAE,yBAAgB,CAAC,SAAS;YACvC,OAAO,EAAE,IAAI,MAAM,KAAK,OAAO,aAAa;SAC7C,CAAC,CAAC;IACL,CAAC;CACF;AAhDD,0DAgDC"}
+{"version":3,"file":"search-connector-internal.js","sourceRoot":"","sources":["../../../../src/connectors/search/internal/search-connector-internal.ts"],"names":[],"mappings":";;;AAAA,qCAA4C;AAC5C,uDAA0D;AAE1D,0DAAwD;AAExD,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,wBAAQ,EAAC;YACvB,UAAU,EAAE,oBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB;YACpD,WAAW,EAAE,yBAAgB,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,wBAAQ,EAAC;YACb,KAAK,EAAE,qBAAY,CAAC,SAAS;YAC7B,OAAO,EAAE,IAAI,MAAM,KAAK,OAAO,aAAa;SAC7C,CAAC,CAAC;IACL,CAAC;CACF;AA5CD,0DA4CC"}

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

@@ -2,9 +2,7 @@ import type { z } from '@hono/zod-openapi';
 import type { TSchemaType } from '../../../base/models';
 import { AbstractEntity } from '../../../base/models';
 import type { ISearchCollectionDefinition, TSearchDocument } from './types';
-/** Engine-neutral search-document entity: derives 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. */
+/** 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>;

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

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,2BAA2B,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAG5E;;mEAEmE;AACnE,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"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/models/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,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/connectors/search/models/base.js

@@ -4,9 +4,7 @@ exports.BaseSearchEntity = void 0;
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const models_1 = require("../../../base/models");
 const zod_derivation_1 = require("./zod-derivation");
-/** Engine-neutral search-document entity: derives 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. */
+/** 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. */
 class BaseSearchEntity extends models_1.AbstractEntity {
     static { this._schemaCache = new Map(); }
     constructor(opts) {

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

@@ -1 +1 @@
-{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/search/models/base.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAGlD,0CAA+C;AAE/C,qDAA8D;AAE9D;;mEAEmE;AACnE,MAAa,gBAEX,SAAQ,uBAAc;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,IAAA,wBAAQ,EAAC;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,IAAA,2CAA0B,EAAC,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,IAAA,2CAA0B,EAAC,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;;AAzDH,4CA0DC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../src/connectors/search/models/base.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAGlD,0CAA+C;AAE/C,qDAA8D;AAE9D,wQAAwQ;AACxQ,MAAa,gBAEX,SAAQ,uBAAc;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,IAAA,wBAAQ,EAAC;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,IAAA,2CAA0B,EAAC,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,IAAA,2CAA0B,EAAC,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;;AAzDH,4CA0DC"}

package/dist/connectors/search/models/define-search-collection.d.ts

@@ -33,9 +33,7 @@ export declare const field: {
         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` 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;
@@ -51,9 +49,6 @@ export declare const field: {
         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.
- */
+/** `<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/connectors/search/models/define-search-collection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"define-search-collection.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/models/define-search-collection.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,2BAA2B,EAC3B,kBAAkB,EAElB,WAAW,EAEX,eAAe,EAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AA8B3C,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;;sGAEkG;mBAE1F,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;CAYZ,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GAAI,KAAK,CAAC,CAAC,SAAS,2BAA2B,EAAE,MAAM,CAAC,KAAG,CAiE7F,CAAC"}
+{"version":3,"file":"define-search-collection.d.ts","sourceRoot":"","sources":["../../../../src/connectors/search/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"}

package/dist/connectors/search/models/define-search-collection.js

@@ -3,10 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.defineSearchCollection = exports.field = void 0;
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const types_1 = require("./types");
-/**
- * `<const N, const O>` preserve the field's name/flag literals in the return type - a widened
- * `ISearchFieldDefinition` return would break `TSearchDocument`, which needs literal types.
- */
+/** `<const N, const O>` preserve the field's name/flag literals - a widened `ISearchFieldDefinition` return would break `TSearchDocument`, which needs literal types. */
 const buildField = (opts) => {
     const { name, type, flags } = opts;
     return { name, type, ...flags };
@@ -26,23 +23,30 @@ exports.field = {
     boolean: makeFieldBuilder(types_1.SearchFieldTypes.BOOLEAN),
     booleans: makeFieldBuilder(types_1.SearchFieldTypes.BOOLEAN_ARRAY),
     geopoint: makeFieldBuilder(types_1.SearchFieldTypes.GEOPOINT),
-    /** `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` 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: (name, opts) => {
         const { optional: isOptional, ...vector } = opts;
         const base = { name, type: types_1.SearchFieldTypes.VECTOR, vector };
-        // A single cast is unavoidable here: the conditional-optional branch can't be proven from the
-        // runtime `isOptional ? { ...base, optional: isOptional } : base` shape without widening `O`.
+        // The cast is unavoidable: the conditional-optional branch can't be proven from the runtime shape without widening `O`.
         return (isOptional ? { ...base, optional: isOptional } : base);
     },
 };
-/**
- * `<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.
- */
+/** @throws when two synonym sets in the same collection share an id. */
+const assertUniqueSynonymIds = (opts) => {
+    const { name, synonyms } = opts;
+    const seenSynonymIds = new Set();
+    for (const synonym of synonyms) {
+        if (seenSynonymIds.has(synonym.id)) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[defineSearchCollection] Duplicate synonym id | name: ${name} | id: ${synonym.id}`,
+            });
+        }
+        seenSynonymIds.add(synonym.id);
+    }
+};
+/** `<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. */
 const defineSearchCollection = (opts) => {
-    const { name, fields, defaultSort, synonyms, engineOverrides } = opts;
+    const { name, fields, defaultSort, defaultQueryBy, synonyms, engineOverrides } = opts;
     if (!name || name.trim().length === 0) {
         throw (0, ignis_helpers_1.getError)({
             message: `[defineSearchCollection] Invalid name | name must be non-empty | name: ${String(name)}`,
@@ -72,8 +76,7 @@ const defineSearchCollection = (opts) => {
             message: `[defineSearchCollection] Invalid id field | id field must be of type string | name: ${name} | type: ${idField.type}`,
         });
     }
-    // Engine-neutral rule only: defaultSort must reference a field that exists. Per-engine
-    // constraints (e.g. Typesense's numeric-scalar requirement) are enforced by that engine's compiler.
+    // Engine-neutral rule only: defaultSort must reference an existing field; per-engine constraints (Typesense's numeric-scalar requirement) belong to that engine's compiler.
     if (defaultSort) {
         const sortField = resolvedFields.find(item => item.name === defaultSort);
         if (!sortField) {
@@ -82,20 +85,34 @@ const defineSearchCollection = (opts) => {
             });
         }
     }
-    if (synonyms) {
-        const seenSynonymIds = new Set();
-        for (const synonym of synonyms) {
-            if (seenSynonymIds.has(synonym.id)) {
+    if (defaultQueryBy) {
+        for (const queryByFieldName of defaultQueryBy) {
+            const queryByField = resolvedFields.find(item => item.name === queryByFieldName);
+            if (!queryByField) {
                 throw (0, ignis_helpers_1.getError)({
-                    message: `[defineSearchCollection] Duplicate synonym id | name: ${name} | id: ${synonym.id}`,
+                    message: `[defineSearchCollection] Invalid defaultQueryBy | field not found | name: ${name} | field: ${queryByFieldName}`,
+                });
+            }
+            if (queryByField.type !== types_1.SearchFieldTypes.STRING &&
+                queryByField.type !== types_1.SearchFieldTypes.STRING_ARRAY) {
+                throw (0, ignis_helpers_1.getError)({
+                    message: `[defineSearchCollection] Invalid defaultQueryBy | full-text search matches text fields only (string, string[]) | name: ${name} | field: ${queryByFieldName} | type: ${queryByField.type}`,
                 });
             }
-            seenSynonymIds.add(synonym.id);
         }
     }
-    // The runtime result is only structurally an ISearchCollectionDefinition; the cast back to the
-    // caller's literal T is deliberate - `id` is guaranteed at the type level via TSearchDocument.
-    return { name, fields: resolvedFields, defaultSort, synonyms, engineOverrides };
+    if (synonyms) {
+        assertUniqueSynonymIds({ name, synonyms });
+    }
+    // The runtime result is only structurally an ISearchCollectionDefinition; the cast back to the caller's literal T is deliberate - `id` is guaranteed at the type level via TSearchDocument.
+    return {
+        name,
+        fields: resolvedFields,
+        defaultSort,
+        defaultQueryBy,
+        synonyms,
+        engineOverrides,
+    };
 };
 exports.defineSearchCollection = defineSearchCollection;
 //# sourceMappingURL=define-search-collection.js.map

package/dist/connectors/search/models/define-search-collection.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-search-collection.js","sourceRoot":"","sources":["../../../../src/connectors/search/models/define-search-collection.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"define-search-collection.js","sourceRoot":"","sources":["../../../../src/connectors/search/models/define-search-collection.ts"],"names":[],"mappings":";;;AAAA,0DAAkD;AAWlD,mCAA2C;AAE3C,yKAAyK;AACzK,MAAM,UAAU,GAAG,CAIjB,IAID,EAA6B,EAAE;IAC9B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAEnC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,EAA+B,CAAC;AAC/D,CAAC,CAAC;AAEF,8IAA8I;AAC9I,MAAM,gBAAgB,GACpB,CAA8B,IAAQ,EAAE,EAAE,CAC1C,CACE,IAAO,EACP,IAAQ,EACmB,EAAE;IAC7B,OAAO,UAAU,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACjD,CAAC,CAAC;AAES,QAAA,KAAK,GAAG;IACnB,EAAE,EAAE,GAAmC,EAAE;QACvC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,wBAAgB,CAAC,MAAM,EAAE,CAAC;IACvD,CAAC;IACD,MAAM,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,YAAY,CAAC;IACxD,MAAM,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,MAAM,CAAC;IACjD,OAAO,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,YAAY,CAAC;IACxD,OAAO,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,OAAO,CAAC;IACnD,QAAQ,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,aAAa,CAAC;IAC1D,QAAQ,EAAE,gBAAgB,CAAC,wBAAgB,CAAC,QAAQ,CAAC;IACrD,kRAAkR;IAClR,MAAM,EAAE,CASN,IAAO,EACP,IAAO,EAKG,EAAE;QACZ,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC;QACjD,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,wBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAE7D,wHAAwH;QACxH,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI,CAIG,CAAC;IACnE,CAAC;CACF,CAAC;AAEF,wEAAwE;AACxE,MAAM,sBAAsB,GAAG,CAAC,IAAqD,EAAQ,EAAE;IAC7F,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC;IAChC,MAAM,cAAc,GAAG,IAAI,GAAG,EAAU,CAAC;IAEzC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC;YACnC,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,yDAAyD,IAAI,UAAU,OAAO,CAAC,EAAE,EAAE;aAC7F,CAAC,CAAC;QACL,CAAC;QAED,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAEF,2LAA2L;AACpL,MAAM,sBAAsB,GAAG,CAA8C,IAAO,EAAK,EAAE;IAChG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IAEtF,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtC,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EAAE,0EAA0E,MAAM,CAAC,IAAI,CAAC,EAAE;SAClG,CAAC,CAAC;IACL,CAAC;IAED,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnC,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EAAE,oFAAoF,IAAI,EAAE;SACpG,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;IACpC,KAAK,MAAM,eAAe,IAAI,MAAM,EAAE,CAAC;QACrC,IAAI,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,yDAAyD,IAAI,aAAa,eAAe,CAAC,IAAI,EAAE;aAC1G,CAAC,CAAC;QACL,CAAC;QAED,SAAS,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;IACxD,IAAI,cAAc,GAAsC,MAAM,CAAC;IAE/D,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,cAAc,GAAG,CAAC,aAAK,CAAC,EAAE,EAAE,EAAE,GAAG,MAAM,CAAC,CAAC;IAC3C,CAAC;SAAM,IAAI,OAAO,CAAC,IAAI,KAAK,wBAAgB,CAAC,MAAM,EAAE,CAAC;QACpD,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EAAE,uFAAuF,IAAI,YAAY,OAAO,CAAC,IAAI,EAAE;SAC/H,CAAC,CAAC;IACL,CAAC;IAED,4KAA4K;IAC5K,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,SAAS,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QAEzE,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,IAAA,wBAAQ,EAAC;gBACb,OAAO,EAAE,0EAA0E,IAAI,mBAAmB,WAAW,EAAE;aACxH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,KAAK,MAAM,gBAAgB,IAAI,cAAc,EAAE,CAAC;YAC9C,MAAM,YAAY,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,gBAAgB,CAAC,CAAC;YAEjF,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,IAAA,wBAAQ,EAAC;oBACb,OAAO,EAAE,6EAA6E,IAAI,aAAa,gBAAgB,EAAE;iBAC1H,CAAC,CAAC;YACL,CAAC;YAED,IACE,YAAY,CAAC,IAAI,KAAK,wBAAgB,CAAC,MAAM;gBAC7C,YAAY,CAAC,IAAI,KAAK,wBAAgB,CAAC,YAAY,EACnD,CAAC;gBACD,MAAM,IAAA,wBAAQ,EAAC;oBACb,OAAO,EAAE,0HAA0H,IAAI,aAAa,gBAAgB,YAAY,YAAY,CAAC,IAAI,EAAE;iBACpM,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,sBAAsB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,4LAA4L;IAC5L,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,cAAc;QACtB,WAAW;QACX,cAAc;QACd,QAAQ;QACR,eAAe;KACX,CAAC;AACT,CAAC,CAAC;AAlFW,QAAA,sBAAsB,0BAkFjC"}

package/dist/connectors/search/models/types.d.ts

@@ -22,9 +22,7 @@ export declare class VectorDistances {
     static isValid(value: string): value is TVectorDistance;
 }
 export type TVectorDistance = TConstValue<typeof VectorDistances>;
-/** Embedding-model config for a server-side auto-embedded vector field: local built-in models need
- * only `name`; remote providers add `apiKey` and/or their auth fields. Compilers map these camelCase
- * keys to wire vocabulary. Source secrets from env - never hardcode them into a committed schema. */
+/** Embedding-model config for a server-side auto-embedded vector field: built-in models need only `name`, remote providers add `apiKey` and/or auth fields, and compilers map these camelCase keys to wire vocabulary. Source secrets from env - never hardcode them into a committed schema. */
 export interface ISearchEmbedModelConfig {
     /** Built-in (`ts/...`) or remote (`openai/...`, `google/...`, `azure/...`). */
     name: string;
@@ -70,6 +68,7 @@ export interface ISearchCollectionDefinition {
     name: string;
     fields: readonly ISearchFieldDefinition[];
     defaultSort?: string;
+    defaultQueryBy?: string[];
     /** Declarative synonym sets provisioned alongside the collection (see `BaseSearchDataSource.provisionCollections`). */
     synonyms?: ISynonym[];
     engineOverrides?: {
@@ -84,9 +83,7 @@ export interface ISearchCollectionDefinition {
 export type TSearchSchema = Record<string, ISearchCollectionDefinition>;
 /** Maps a DSL field-type literal to its TypeScript runtime type - the scalar/array counterpart of `TSearchFieldType`. */
 export type TSearchFieldTsType<T extends TSearchFieldType> = T extends 'string' ? string : T extends 'number' ? number : T extends 'boolean' ? boolean : T extends 'geopoint' ? [number, number] : T extends 'string[]' ? string[] : T extends 'number[]' ? number[] : T extends 'boolean[]' ? boolean[] : T extends 'vector' ? number[] : never;
-/** Compile-time document shape for a `defineSearchCollection` literal. Uses `Exclude<..., { optional: true }>`,
- * not `Extract<..., { optional?: false }>` - the latter is a TS weak type and rejects fields with no
- * `optional` key. A `vector.embed` field is server auto-embedded and omitted from the shape entirely. */
+/** Compile-time document shape for a `defineSearchCollection` literal. Uses `Exclude<..., { optional: true }>`, not `Extract<..., { optional?: false }>` - the latter is a TS weak type and rejects fields with no `optional` key. A `vector.embed` field is server auto-embedded, so it is omitted entirely. */
 export type TSearchDocument<T extends ISearchCollectionDefinition> = {
     id: string;
 } & {