@venizia/ignis 0.1.1-9 → 0.1.1

package/dist/connectors/search/repositories/common/dialect-helpers.d.ts

@@ -1,4 +1,5 @@
-import type { TFields } from '../../../../base/repositories/query-schemas';
+import { type TFields } from '@venizia/ignis-filter';
+import type { ISearchCompileCapabilities, TCompiledWhere } from './types';
 /** Dialect-shared pure helpers, shared once rather than byte-copied per dialect; not barrel-exported, not part of the connector's public surface. */
 /** skip/offset -> 1-based page number. Requires a page size, and the skip must land on a page boundary. */
 export declare const toSearchPage: (opts: {
@@ -9,6 +10,66 @@ export declare const toSearchPage: (opts: {
 export declare const toFieldsCsv: (opts: {
     fields: TFields;
 }) => string;
-/** A non-null, non-array object carrying at least one key - i.e. a `{ gte: 1 }`-style operator map. */
+/**
+ * A `{ gte: 1 }`-style operator map: non-null, non-array, non-Date, at least one key, and EVERY
+ * key a known operator. The every-key test mirrors the relational reference
+ * (relational/repositories/dialect/filter.ts:546-559) rather than accepting any non-empty object.
+ *
+ * Without it `{ meta: { foo: 1 } }` read as an operator map and reported "does not support
+ * operator 'foo'", naming a key the caller never meant as an operator; it now falls through to
+ * the value path and is rejected for what it actually is - an object where a scalar belongs.
+ */
 export declare const isOperatorObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * AND of two compiled clauses: `matchNone` absorbs, `matchAll` is the identity. This is the
+ * algebra string-joining could not express, and the reason an empty permission disjunction now
+ * survives into the query instead of evaporating out of it.
+ */
+export declare const andCompiled: (left: TCompiledWhere, right: TCompiledWhere, joiner: string) => TCompiledWhere;
+/** OR of two compiled clauses - the dual of `andCompiled`: `matchAll` absorbs, `matchNone` is the identity. */
+export declare const orCompiled: (left: TCompiledWhere, right: TCompiledWhere, joiner: string) => TCompiledWhere;
+/** Folds a clause list, seeded with that operator's IDENTITY so an empty list lands on it: `and: []` -> matchAll (vacuously true), `or: []` -> matchNone (absorbing false). */
+export declare const reduceCompiled: (opts: {
+    clauses: TCompiledWhere[];
+    isDisjunction: boolean;
+    joiner: string;
+}) => TCompiledWhere;
+/** Parenthesises a compiled group; the absorbing outcomes carry no string to wrap. */
+export declare const parenthesize: (compiled: TCompiledWhere) => TCompiledWhere;
+/** Wraps a filter string as a compiled clause. */
+export declare const toFilterClause: (filterBy: string) => TCompiledWhere;
+/**
+ * Rejects a field name the collection does not declare, mirroring the relational reference which
+ * resolves every name against the table's columns and throws `Column NOT FOUND`
+ * (relational/repositories/dialect/filter.ts:377-382 for `where`, :423-428 for `order`). Without it
+ * the name compiles verbatim and the ENGINE's rejection surfaces as an infrastructure failure
+ * rather than a 400 naming the field.
+ *
+ * ONE judgment, shared by both paths a caller can name a field from - `where` and `order` - so the
+ * two cannot drift into disagreeing about what exists. `method` only labels the message with the
+ * path that asked; it never changes the answer.
+ *
+ * Absent `fields` means unvalidated, not "no fields": an entity carrying no collection definition
+ * must compile exactly as it did before this check existed.
+ *
+ * Membership is the WHOLE judgment - a dotted name is not special. Under Typesense's
+ * `enable_nested_fields` a dotted name is an ordinary field name, so `merchantName.en` passes when
+ * declared and `metadata.foo` fails when not, for the only reason that is true of it.
+ *
+ * Hidden fields stay filterable on purpose - `FilterBuilder` does not consult `hiddenProperties`
+ * either, and diverging from the reference is not this change's business.
+ */
+export declare const assertKnownField: (opts: {
+    field: string;
+    engine: string;
+    capabilities?: ISearchCompileCapabilities;
+    method?: string;
+}) => void;
+/** Rejects an operator this engine cannot express, naming BOTH so the caller knows it is the engine choice - not the operator - that decides it. */
+export declare const throwUnsupportedOperator: (opts: {
+    operator: string;
+    field: string;
+    engine: string;
+    reason?: string;
+}) => never;
 //# sourceMappingURL=dialect-helpers.d.ts.map

package/dist/connectors/search/repositories/common/dialect-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dialect-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/dialect-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AAGjE,qJAAqJ;AAErJ,2GAA2G;AAC3G,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAkBrE,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,MAevD,CAAC;AAEF,uGAAuG;AACvG,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAMhF,CAAC"}
+{"version":3,"file":"dialect-helpers.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/dialect-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG1E,qJAAqJ;AAErJ,2GAA2G;AAC3G,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAkBrE,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,MAevD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAWhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,cAAc,EACpB,OAAO,cAAc,EACrB,QAAQ,MAAM,KACb,cAoBF,CAAC;AAEF,+GAA+G;AAC/G,eAAO,MAAM,UAAU,GACrB,MAAM,cAAc,EACpB,OAAO,cAAc,EACrB,QAAQ,MAAM,KACb,cAoBF,CAAC;AAEF,+KAA+K;AAC/K,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,cAQH,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,YAAY,GAAI,UAAU,cAAc,KAAG,cAG1C,CAAC;AAEf,kDAAkD;AAClD,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,cAGhD,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,IAWH,CAAC;AAEF,oJAAoJ;AACpJ,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,KAOH,CAAC"}

package/dist/connectors/search/repositories/common/dialect-helpers.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isOperatorObject = exports.toFieldsCsv = exports.toSearchPage = void 0;
+exports.throwUnsupportedOperator = exports.assertKnownField = exports.toFilterClause = exports.parenthesize = exports.reduceCompiled = exports.orCompiled = exports.andCompiled = exports.isOperatorObject = exports.toFieldsCsv = exports.toSearchPage = void 0;
+const ignis_filter_1 = require("@venizia/ignis-filter");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
+const errors_1 = require("../../../../connectors/search/common/errors");
+const types_1 = require("./types");
 /** Dialect-shared pure helpers, shared once rather than byte-copied per dialect; not barrel-exported, not part of the connector's public surface. */
 /** skip/offset -> 1-based page number. Requires a page size, and the skip must land on a page boundary. */
 const toSearchPage = (opts) => {
@@ -34,12 +37,126 @@ const toFieldsCsv = (opts) => {
     return included.join(',');
 };
 exports.toFieldsCsv = toFieldsCsv;
-/** A non-null, non-array object carrying at least one key - i.e. a `{ gte: 1 }`-style operator map. */
+/**
+ * A `{ gte: 1 }`-style operator map: non-null, non-array, non-Date, at least one key, and EVERY
+ * key a known operator. The every-key test mirrors the relational reference
+ * (relational/repositories/dialect/filter.ts:546-559) rather than accepting any non-empty object.
+ *
+ * Without it `{ meta: { foo: 1 } }` read as an operator map and reported "does not support
+ * operator 'foo'", naming a key the caller never meant as an operator; it now falls through to
+ * the value path and is rejected for what it actually is - an object where a scalar belongs.
+ */
 const isOperatorObject = (value) => {
     if (value === null || Array.isArray(value) || typeof value !== 'object') {
         return false;
     }
-    return Object.keys(value).length > 0;
+    const keys = Object.keys(value);
+    if (keys.length === 0) {
+        return false;
+    }
+    return keys.every(key => ignis_filter_1.QueryOperators.isValid(key));
 };
 exports.isOperatorObject = isOperatorObject;
+/**
+ * AND of two compiled clauses: `matchNone` absorbs, `matchAll` is the identity. This is the
+ * algebra string-joining could not express, and the reason an empty permission disjunction now
+ * survives into the query instead of evaporating out of it.
+ */
+const andCompiled = (left, right, joiner) => {
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_NONE ||
+        right.outcome === types_1.SearchFilterOutcomes.MATCH_NONE) {
+        return { outcome: types_1.SearchFilterOutcomes.MATCH_NONE };
+    }
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_ALL) {
+        return right;
+    }
+    if (right.outcome === types_1.SearchFilterOutcomes.MATCH_ALL) {
+        return left;
+    }
+    return {
+        outcome: types_1.SearchFilterOutcomes.FILTER,
+        filterBy: `${left.filterBy}${joiner}${right.filterBy}`,
+    };
+};
+exports.andCompiled = andCompiled;
+/** OR of two compiled clauses - the dual of `andCompiled`: `matchAll` absorbs, `matchNone` is the identity. */
+const orCompiled = (left, right, joiner) => {
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_ALL ||
+        right.outcome === types_1.SearchFilterOutcomes.MATCH_ALL) {
+        return { outcome: types_1.SearchFilterOutcomes.MATCH_ALL };
+    }
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_NONE) {
+        return right;
+    }
+    if (right.outcome === types_1.SearchFilterOutcomes.MATCH_NONE) {
+        return left;
+    }
+    return {
+        outcome: types_1.SearchFilterOutcomes.FILTER,
+        filterBy: `${left.filterBy}${joiner}${right.filterBy}`,
+    };
+};
+exports.orCompiled = orCompiled;
+/** Folds a clause list, seeded with that operator's IDENTITY so an empty list lands on it: `and: []` -> matchAll (vacuously true), `or: []` -> matchNone (absorbing false). */
+const reduceCompiled = (opts) => {
+    const { clauses, isDisjunction, joiner } = opts;
+    const combine = isDisjunction ? exports.orCompiled : exports.andCompiled;
+    const identity = isDisjunction
+        ? { outcome: types_1.SearchFilterOutcomes.MATCH_NONE }
+        : { outcome: types_1.SearchFilterOutcomes.MATCH_ALL };
+    return clauses.reduce((accumulated, clause) => combine(accumulated, clause, joiner), identity);
+};
+exports.reduceCompiled = reduceCompiled;
+/** Parenthesises a compiled group; the absorbing outcomes carry no string to wrap. */
+const parenthesize = (compiled) => compiled.outcome === types_1.SearchFilterOutcomes.FILTER
+    ? { outcome: types_1.SearchFilterOutcomes.FILTER, filterBy: `(${compiled.filterBy})` }
+    : compiled;
+exports.parenthesize = parenthesize;
+/** Wraps a filter string as a compiled clause. */
+const toFilterClause = (filterBy) => ({
+    outcome: types_1.SearchFilterOutcomes.FILTER,
+    filterBy,
+});
+exports.toFilterClause = toFilterClause;
+/**
+ * Rejects a field name the collection does not declare, mirroring the relational reference which
+ * resolves every name against the table's columns and throws `Column NOT FOUND`
+ * (relational/repositories/dialect/filter.ts:377-382 for `where`, :423-428 for `order`). Without it
+ * the name compiles verbatim and the ENGINE's rejection surfaces as an infrastructure failure
+ * rather than a 400 naming the field.
+ *
+ * ONE judgment, shared by both paths a caller can name a field from - `where` and `order` - so the
+ * two cannot drift into disagreeing about what exists. `method` only labels the message with the
+ * path that asked; it never changes the answer.
+ *
+ * Absent `fields` means unvalidated, not "no fields": an entity carrying no collection definition
+ * must compile exactly as it did before this check existed.
+ *
+ * Membership is the WHOLE judgment - a dotted name is not special. Under Typesense's
+ * `enable_nested_fields` a dotted name is an ordinary field name, so `merchantName.en` passes when
+ * declared and `metadata.foo` fails when not, for the only reason that is true of it.
+ *
+ * Hidden fields stay filterable on purpose - `FilterBuilder` does not consult `hiddenProperties`
+ * either, and diverging from the reference is not this change's business.
+ */
+const assertKnownField = (opts) => {
+    const { field, engine, capabilities, method = 'compileWhere' } = opts;
+    if (!capabilities?.fields || capabilities.fields.has(field)) {
+        return;
+    }
+    throw (0, ignis_helpers_1.getError)({
+        error: errors_1.SearchErrors.UNKNOWN_FIELD,
+        message: `[${engine}QueryDialect][${method}] search() Field NOT FOUND | field: '${field}' | engine: '${engine}' | the collection definition declares no such field`,
+    });
+};
+exports.assertKnownField = assertKnownField;
+/** Rejects an operator this engine cannot express, naming BOTH so the caller knows it is the engine choice - not the operator - that decides it. */
+const throwUnsupportedOperator = (opts) => {
+    const { operator, field, engine, reason } = opts;
+    throw (0, ignis_helpers_1.getError)({
+        error: errors_1.SearchErrors.UNSUPPORTED_OPERATOR,
+        message: `[${engine}QueryDialect][compileWhere] search() does not support operator '${operator}' | operator: '${operator}' | engine: '${engine}' | field: '${field}'${reason ? ` | ${reason}` : ''}`,
+    });
+};
+exports.throwUnsupportedOperator = throwUnsupportedOperator;
 //# sourceMappingURL=dialect-helpers.js.map

package/dist/connectors/search/repositories/common/dialect-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"dialect-helpers.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/dialect-helpers.ts"],"names":[],"mappings":";;;AACA,0DAAkD;AAElD,qJAAqJ;AAErJ,2GAA2G;AACpG,MAAM,YAAY,GAAG,CAAC,IAAsC,EAAU,EAAE;IAC7E,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAE7B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EACL,kIAAkI;SACrI,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,GAAG,KAAK,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAA,wBAAQ,EAAC;YACb,OAAO,EACL,qFAAqF;SACxF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC,CAAC;AAlBW,QAAA,YAAY,gBAkBvB;AAEF,mGAAmG;AAC5F,MAAM,WAAW,GAAG,CAAC,IAAyB,EAAU,EAAE;IAC/D,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAExB,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;YACzB,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC5B,CAAC,CAAC;AAfW,QAAA,WAAW,eAetB;AAEF,uGAAuG;AAChG,MAAM,gBAAgB,GAAG,CAAC,KAAc,EAAoC,EAAE;IACnF,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACvC,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B"}
+{"version":3,"file":"dialect-helpers.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/dialect-helpers.ts"],"names":[],"mappings":"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"}

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

@@ -1,5 +1,45 @@
 import type { TFilter, TWhere } from '../../../../base/repositories/common';
+import type { TConstValue } from '@venizia/ignis-helpers';
 import type { SearchModes, TSearchInput } from './constants';
+/**
+ * What a `where` tree compiled down to. A filter STRING cannot express the two absorbing
+ * outcomes: `''` is indistinguishable from "no constraint", which is why an empty `or` used to
+ * compile to a filter byte-identical to the unscoped query - widening the very clause meant to
+ * narrow it. The relational branch has always had this vocabulary (`sql\`false\`` vs `undefined`,
+ * relational/repositories/dialect/filter.ts:637-641); this is that vocabulary for the search branch.
+ */
+export declare class SearchFilterOutcomes {
+    /** A real filter expression the engine should run. */
+    static readonly FILTER = "filter";
+    /** Vacuously true - impose no constraint. */
+    static readonly MATCH_ALL = "matchAll";
+    /** Absorbing false - can never match, so the engine must not be asked. */
+    static readonly MATCH_NONE = "matchNone";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(input: string): input is TSearchFilterOutcome;
+}
+export type TSearchFilterOutcome = TConstValue<typeof SearchFilterOutcomes>;
+export type TCompiledWhere = {
+    outcome: typeof SearchFilterOutcomes.FILTER;
+    filterBy: string;
+} | {
+    outcome: typeof SearchFilterOutcomes.MATCH_ALL;
+} | {
+    outcome: typeof SearchFilterOutcomes.MATCH_NONE;
+};
+/**
+ * Query-time capabilities a dialect compiles against. Passed per call, never stored: every
+ * datasource shares ONE dialect instance (`typesense/datasources/datasource.ts:29` holds it in a
+ * static), so a dialect that remembered a collection would answer the next collection's query
+ * with the previous one's fields.
+ */
+export interface ISearchCompileCapabilities {
+    /**
+     * Field names the collection declares. ABSENT means "unvalidated" - an entity carrying no
+     * collection definition must still compile, exactly as it did before field checking existed.
+     */
+    fields?: ReadonlySet<string>;
+}
 /** Search-engine query parameters translated from a repository-level TFilter. Only the cross-engine intersection lives here - an engine's own tuning knobs go on its own extension. Field names stay camelCase; wire format is produced only at the dialect's `toWireParams` boundary. */
 export interface ISearchQuery {
     /** Full-text search term. Use '*' for pure filter listings. */
@@ -26,16 +66,51 @@ export interface ISearchQuery {
     groupMissingValues?: boolean;
     /** Engine-native wire parameters, merged last into `toWireParams` output verbatim and unvalidated; keys use the engine's own vocabulary (`num_typos`, not `numTypos`). */
     engineParams?: Record<string, unknown>;
+    /** The `where` compiled to an absorbing false: no query can match, so the repository answers empty WITHOUT calling the engine. Internal - `toWireParams` strips it, so it never reaches the wire. */
+    matchNone?: boolean;
 }
 /** Translates repository-level `TFilter`/`TWhere` into a search-engine-specific query. */
 export interface ISearchQueryDialect {
     build(opts: {
         filter?: TFilter;
         hiddenFields?: string[];
+        capabilities?: ISearchCompileCapabilities;
     }): ISearchQuery;
+    /**
+     * @deprecated Use `compileWhere`, which can express the absorbing outcomes a filter STRING
+     * cannot. This signature has no representation for "matches nothing" - it returned `''`, which
+     * the caller could not tell from "no constraint", so an empty `or` widened the query it was
+     * meant to narrow. It now THROWS on that input rather than answering wrongly.
+     */
     toWhere(opts: {
         where: TWhere;
     }): string;
+    /**
+     * Compiles a `where` tree, resolving what a filter string cannot express. `capabilities` is
+     * per-call, never retained - one dialect instance serves every datasource.
+     */
+    compileWhere(opts: {
+        where: TWhere;
+        capabilities?: ISearchCompileCapabilities;
+    }): TCompiledWhere;
+    /**
+     * Whether this engine can express `operator` at all. Published by the dialect rather than
+     * hand-copied by callers, so it cannot drift from the engine's own `switch`; every member of
+     * `QueryOperators.SCHEME_SET` has an answer, which is what stops a new engine from silently
+     * leaving one unclassified.
+     */
+    canExpress(opts: {
+        operator: string;
+    }): boolean;
+    /**
+     * ANDs already-compiled clauses using this engine's own conjunction, honouring the absorbing
+     * outcomes. The repository needs this to combine a caller clause with a repository-owned one it
+     * compiled SEPARATELY - the joiner belongs to the engine, so the dialect supplies it rather
+     * than the caller guessing `&&` versus `AND`.
+     */
+    conjoin(opts: {
+        clauses: TCompiledWhere[];
+    }): TCompiledWhere;
     /** Writes every engine-specific consequence of a non-raw search input onto `query` (mode dispatch, vector clause, tuning knobs) - keeping `ReadableSearchRepository` engine-free. */
     applySearchInput(opts: {
         query: ISearchQuery;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE7D,0RAA0R;AAC1R,MAAM,WAAW,YAAY;IAC3B,+DAA+D;IAC/D,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IAGvB,MAAM,CAAC,EAAE,MAAM,CAAC;IAGhB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IAGxB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAG1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAE7B,0KAA0K;IAC1K,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,0FAA0F;AAC1F,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,IAAI,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,YAAY,CAAC;IACzE,OAAO,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,MAAM,CAAC;IAEzC,qLAAqL;IACrL,gBAAgB,CAAC,IAAI,EAAE;QACrB,KAAK,EAAE,YAAY,CAAC;QACpB,KAAK,EAAE,OAAO,CAAC,YAAY,EAAE;YAAE,IAAI,EAAE,OAAO,WAAW,CAAC,GAAG,CAAA;SAAE,CAAC,CAAC;KAChE,GAAG,IAAI,CAAC;IAET,2JAA2J;IAC3J,YAAY,CAAC,IAAI,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/E"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/types.ts"],"names":[],"mappings":"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"}

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

@@ -1,3 +1,24 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchFilterOutcomes = void 0;
+/**
+ * What a `where` tree compiled down to. A filter STRING cannot express the two absorbing
+ * outcomes: `''` is indistinguishable from "no constraint", which is why an empty `or` used to
+ * compile to a filter byte-identical to the unscoped query - widening the very clause meant to
+ * narrow it. The relational branch has always had this vocabulary (`sql\`false\`` vs `undefined`,
+ * relational/repositories/dialect/filter.ts:637-641); this is that vocabulary for the search branch.
+ */
+class SearchFilterOutcomes {
+    /** A real filter expression the engine should run. */
+    static { this.FILTER = 'filter'; }
+    /** Vacuously true - impose no constraint. */
+    static { this.MATCH_ALL = 'matchAll'; }
+    /** Absorbing false - can never match, so the engine must not be asked. */
+    static { this.MATCH_NONE = 'matchNone'; }
+    static { this.SCHEME_SET = new Set([this.FILTER, this.MATCH_ALL, this.MATCH_NONE]); }
+    static isValid(input) {
+        return this.SCHEME_SET.has(input);
+    }
+}
+exports.SearchFilterOutcomes = SearchFilterOutcomes;
 //# sourceMappingURL=types.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/types.ts"],"names":[],"mappings":""}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/common/types.ts"],"names":[],"mappings":";;;AAIA;;;;;;GAMG;AACH,MAAa,oBAAoB;IAC/B,sDAAsD;aACtC,WAAM,GAAG,QAAQ,CAAC;IAClC,6CAA6C;aAC7B,cAAS,GAAG,UAAU,CAAC;IACvC,0EAA0E;aAC1D,eAAU,GAAG,WAAW,CAAC;aAEzB,eAAU,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAErF,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;;AAZH,oDAaC"}

package/dist/connectors/search/repositories/core/base.d.ts

@@ -1,10 +1,10 @@
 import type { ITransaction } from '../../../../base/datasources';
-import type { TFilter, TLockOptions } from '../../../../base/repositories/common';
+import type { TFilter, TLockOptions, TWhere } from '../../../../base/repositories/common';
 import { AbstractRepository } from '../../../../base/repositories/core';
 import type { AbstractSearchDataSource } from '../../../../connectors/search/datasources';
 import type { BaseSearchEntity } from '../../../../connectors/search/models';
 import type { TClass } from '@venizia/ignis-helpers';
-import type { ISearchQuery, ISearchQueryDialect } from '../../../../connectors/search/repositories/common';
+import type { ISearchQuery, ISearchQueryDialect, TCompiledWhere } from '../../../../connectors/search/repositories/common';
 /** Search-repository plumbing on `AbstractRepository`. `TDataSource` carries the concrete connector type through `this.connector`, so a concretely-bound repository reaches its engine's verbs uncast while an engine-agnostic one is forced to write `connector.alias?.…`. */
 export declare abstract class SearchBaseRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends AbstractRepository<TDocument, TDocument> {
     constructor(dataSource?: TDataSource, opts?: {
@@ -33,11 +33,59 @@ export declare abstract class SearchBaseRepository<TDocument extends object = ob
     protected assertNoLock(opts?: {
         lock?: TLockOptions;
     }): void;
-    /** Builds a dialect-translated query: AND-merges defaultWhere into filter.where (unless shouldSkipDefaultFilter), always strips hiddenFields. */
+    private _collectionFields?;
+    /**
+     * Field names the collection declares, or undefined when it declares none - which means
+     * "unvalidated", not "no fields": an entity carrying no `ISearchCollectionDefinition` must
+     * compile exactly as it did before field checking existed.
+     *
+     * Read from the entity's own typed `schema` rather than by casting into `entity.constructor`;
+     * `BaseSearchEntity.schema` is instance-side and already an `ISearchCollectionDefinition`.
+     * Memoized per repository instance - the definition is frozen after boot.
+     */
+    protected get collectionFields(): ReadonlySet<string> | undefined;
+    /**
+     * Builds a dialect-translated query, always stripping hiddenFields.
+     *
+     * The caller's `where` and the repository-owned `defaultWhere` are compiled SEPARATELY and
+     * combined after, rather than merged into one tree first. Merging first makes the two
+     * indistinguishable, and the repository's own clause would then have to satisfy the
+     * caller-facing field check: `SprocketDocument` in integration-wiring.test.ts declares
+     * [title, secretCode] but carries `defaultFilter: { where: { isActive: true } }`, so every
+     * request through it would 400 ITSELF. Compiling separately makes the trust boundary a matter
+     * of WHICH CALL IS MADE, which - unlike a flag threaded through the recursion - cannot be wrong
+     * at a nested level.
+     */
     protected buildQuery(opts: {
         filter?: TFilter;
         shouldSkipDefaultFilter?: boolean;
     }): ISearchQuery;
-    private mergeWhere;
+    /**
+     * Refuses a caller-supplied page larger than this model allows.
+     *
+     * POLICY, and the counterweight to a guardrail this tier removed: an engine used to refuse more
+     * than 250 hits per page, so an unreasonable `limit` failed fast and cheap. Now that such a page
+     * is served, something has to decide when it is unreasonable, and the framework would otherwise
+     * be less safe than before it could satisfy the request.
+     *
+     * It lives in `buildQuery` because that is the one point BOTH `find()` and `search()` pass
+     * through - enforcing in `find()` alone would leave `search()` as a way around it, which is not
+     * a ceiling. `mode: 'raw'` bypasses `buildQuery` and therefore bypasses this deliberately: raw
+     * is the documented escape hatch and its callers own the consequences. They still cannot exceed
+     * the connector's physical ceiling, which is the intended layering - policy is opt-out-able,
+     * physics is not.
+     */
+    protected assertLimitWithinCeiling(opts: {
+        limit?: number;
+    }): void;
+    /**
+     * Compiles the caller clause (field-checked) and the repository-owned default clause
+     * (unchecked), then ANDs them via the dialect - `defaultWhere` first, preserving the order the
+     * previous `{ and: [defaultWhere, where] }` merge produced.
+     */
+    protected compileEffectiveWhere(opts: {
+        where?: TWhere;
+        defaultWhere?: TWhere;
+    }): TCompiledWhere;
 }
 //# sourceMappingURL=base.d.ts.map

package/dist/connectors/search/repositories/core/base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAU,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AAEjG,+QAA+Q;AAC/Q,8BAAsB,oBAAoB,CACxC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,SAAS,wBAAwB,GAAG,wBAAwB,CACvE,SAAQ,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC;gBAE9C,UAAU,CAAC,EAAE,WAAW,EACxB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAKnE,IAAa,UAAU,IAAI,WAAW,CAErC;IAED,IAAa,UAAU,CAAC,KAAK,EAAE,WAAW,EAEzC;IAED,IAAa,MAAM,IAAI,gBAAgB,CAEtC;IAED,IAAa,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAE1C;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAEjE;IAED,SAAS,KAAK,YAAY,IAAI,mBAAmB,CAEhD;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,aAAa,CAAC,CAE5C;IAEQ,aAAa,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI;IAI/D,yMAAyM;IACzM,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAgB7C,SAAS,CAAC,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAQrD,qQAAqQ;IACrQ,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY1E,uIAAuI;IACvI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY5D,iJAAiJ;IACjJ,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,YAAY;IAiBhB,OAAO,CAAC,UAAU;CAanB"}
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAI9D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAEnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EACV,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACf,MAAM,yCAAyC,CAAC;AAGjD,+QAA+Q;AAC/Q,8BAAsB,oBAAoB,CACxC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,SAAS,wBAAwB,GAAG,wBAAwB,CACvE,SAAQ,kBAAkB,CAAC,SAAS,EAAE,SAAS,CAAC;gBAE9C,UAAU,CAAC,EAAE,WAAW,EACxB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAKnE,IAAa,UAAU,IAAI,WAAW,CAErC;IAED,IAAa,UAAU,CAAC,KAAK,EAAE,WAAW,EAEzC;IAED,IAAa,MAAM,IAAI,gBAAgB,CAEtC;IAED,IAAa,MAAM,CAAC,KAAK,EAAE,gBAAgB,EAE1C;IAED,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED,SAAS,KAAK,SAAS,IAAI,UAAU,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,CAEjE;IAED,SAAS,KAAK,YAAY,IAAI,mBAAmB,CAEhD;IAED,IAAI,WAAW,IAAI,WAAW,CAAC,aAAa,CAAC,CAE5C;IAEQ,aAAa,CAAC,IAAI,EAAE;QAAE,UAAU,EAAE,WAAW,CAAA;KAAE,GAAG,IAAI;IAI/D,yMAAyM;IACzM,SAAS,CAAC,gBAAgB,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC;IAgB7C,SAAS,CAAC,mBAAmB,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE;IAQrD,qQAAqQ;IACrQ,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY1E,uIAAuI;IACvI,SAAS,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY5D,OAAO,CAAC,iBAAiB,CAAC,CAAc;IAExC;;;;;;;;OAQG;IACH,SAAS,KAAK,gBAAgB,IAAI,WAAW,CAAC,MAAM,CAAC,GAAG,SAAS,CAOhE;IAED;;;;;;;;;;;OAWG;IACH,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE;QACzB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,YAAY;IAoChB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,wBAAwB,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAclE;;;;OAIG;IACH,SAAS,CAAC,qBAAqB,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,cAAc;CAiBjG"}

package/dist/connectors/search/repositories/core/base.js

@@ -2,7 +2,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SearchBaseRepository = void 0;
 const core_1 = require("../../../../base/repositories/core");
+const common_1 = require("../../../../base/repositories/common");
+const common_2 = require("../../../../connectors/search/common");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const utilities_1 = require("../../../../utilities");
+const common_3 = require("../../../../connectors/search/repositories/common");
 /** Search-repository plumbing on `AbstractRepository`. `TDataSource` carries the concrete connector type through `this.connector`, so a concretely-bound repository reaches its engine's verbs uncast while an engine-agnostic one is forced to write `connector.alias?.…`. */
 class SearchBaseRepository extends core_1.AbstractRepository {
     constructor(dataSource, opts) {
@@ -75,30 +79,106 @@ class SearchBaseRepository extends core_1.AbstractRepository {
             logger: this.logger,
         });
     }
-    /** Builds a dialect-translated query: AND-merges defaultWhere into filter.where (unless shouldSkipDefaultFilter), always strips hiddenFields. */
+    /**
+     * Field names the collection declares, or undefined when it declares none - which means
+     * "unvalidated", not "no fields": an entity carrying no `ISearchCollectionDefinition` must
+     * compile exactly as it did before field checking existed.
+     *
+     * Read from the entity's own typed `schema` rather than by casting into `entity.constructor`;
+     * `BaseSearchEntity.schema` is instance-side and already an `ISearchCollectionDefinition`.
+     * Memoized per repository instance - the definition is frozen after boot.
+     */
+    get collectionFields() {
+        if (!this._collectionFields) {
+            const fields = this.entity?.schema?.fields;
+            this._collectionFields = new Set((fields ?? []).map(field => field.name));
+        }
+        return this._collectionFields.size > 0 ? this._collectionFields : undefined;
+    }
+    /**
+     * Builds a dialect-translated query, always stripping hiddenFields.
+     *
+     * The caller's `where` and the repository-owned `defaultWhere` are compiled SEPARATELY and
+     * combined after, rather than merged into one tree first. Merging first makes the two
+     * indistinguishable, and the repository's own clause would then have to satisfy the
+     * caller-facing field check: `SprocketDocument` in integration-wiring.test.ts declares
+     * [title, secretCode] but carries `defaultFilter: { where: { isActive: true } }`, so every
+     * request through it would 400 ITSELF. Compiling separately makes the trust boundary a matter
+     * of WHICH CALL IS MADE, which - unlike a flag threaded through the recursion - cannot be wrong
+     * at a nested level.
+     */
     buildQuery(opts) {
         const { filter, shouldSkipDefaultFilter } = opts;
         const defaultWhere = shouldSkipDefaultFilter ? undefined : this.defaultWhere;
-        const mergedWhere = this.mergeWhere({ defaultWhere, where: filter?.where });
-        const effectiveFilter = filter
-            ? { ...filter, where: mergedWhere }
-            : mergedWhere
-                ? { where: mergedWhere }
-                : undefined;
-        return this.queryDialect.build({
-            filter: effectiveFilter,
+        this.assertLimitWithinCeiling({ limit: filter?.limit });
+        // `where` is withheld from `build` and compiled below: handing it over merged would field-check
+        // the repository's own clause along with the caller's.
+        const query = this.queryDialect.build({
+            filter: filter ? { ...filter, where: undefined } : undefined,
             hiddenFields: this.hiddenFields,
+            capabilities: { fields: this.collectionFields },
+        });
+        const compiled = this.compileEffectiveWhere({ where: filter?.where, defaultWhere });
+        switch (compiled.outcome) {
+            case common_3.SearchFilterOutcomes.FILTER: {
+                query.filterBy = compiled.filterBy;
+                break;
+            }
+            case common_3.SearchFilterOutcomes.MATCH_NONE: {
+                query.matchNone = true;
+                break;
+            }
+            case common_3.SearchFilterOutcomes.MATCH_ALL:
+            default: {
+                // Vacuously true - nothing to set and nothing to short-circuit. Spelled out rather than
+                // left as an unwritten else, so all three outcomes are visibly accounted for.
+                break;
+            }
+        }
+        return query;
+    }
+    /**
+     * Refuses a caller-supplied page larger than this model allows.
+     *
+     * POLICY, and the counterweight to a guardrail this tier removed: an engine used to refuse more
+     * than 250 hits per page, so an unreasonable `limit` failed fast and cheap. Now that such a page
+     * is served, something has to decide when it is unreasonable, and the framework would otherwise
+     * be less safe than before it could satisfy the request.
+     *
+     * It lives in `buildQuery` because that is the one point BOTH `find()` and `search()` pass
+     * through - enforcing in `find()` alone would leave `search()` as a way around it, which is not
+     * a ceiling. `mode: 'raw'` bypasses `buildQuery` and therefore bypasses this deliberately: raw
+     * is the documented escape hatch and its callers own the consequences. They still cannot exceed
+     * the connector's physical ceiling, which is the intended layering - policy is opt-out-able,
+     * physics is not.
+     */
+    assertLimitWithinCeiling(opts) {
+        const { limit } = opts;
+        const ceiling = this.maxLimit ?? common_1.DEFAULT_MAX_LIMIT;
+        if (limit === undefined || limit <= ceiling) {
+            return;
+        }
+        throw (0, ignis_helpers_1.getError)({
+            error: common_2.SearchErrors.PAGE_TOO_LARGE,
+            message: `[${this.constructor.name}][buildQuery] Requested page exceeds this model's limit | collection: '${this.collectionName}' | requested: ${limit} | maximum: ${ceiling} | raise it with @model settings.maxLimit if larger pages are genuinely needed`,
         });
     }
-    mergeWhere(opts) {
-        const { defaultWhere, where } = opts;
-        if (!defaultWhere) {
-            return where;
+    /**
+     * Compiles the caller clause (field-checked) and the repository-owned default clause
+     * (unchecked), then ANDs them via the dialect - `defaultWhere` first, preserving the order the
+     * previous `{ and: [defaultWhere, where] }` merge produced.
+     */
+    compileEffectiveWhere(opts) {
+        const { where, defaultWhere } = opts;
+        const dialect = this.queryDialect;
+        const clauses = [];
+        if (defaultWhere) {
+            clauses.push(dialect.compileWhere({ where: defaultWhere }));
         }
-        if (!where) {
-            return defaultWhere;
+        if (where) {
+            clauses.push(dialect.compileWhere({ where, capabilities: { fields: this.collectionFields } }));
         }
-        return { and: [defaultWhere, where] };
+        return dialect.conjoin({ clauses });
     }
 }
 exports.SearchBaseRepository = SearchBaseRepository;

package/dist/connectors/search/repositories/core/base.js.map

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