@venizia/ignis 0.1.1-8 → 0.1.1

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

@@ -1,13 +1,11 @@
 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';
-/** Search-repository plumbing on `AbstractRepository`. `TDataSource` carries the concrete connector
- * type through `this.connector`: a concretely-bound repository reaches its engine's verbs uncast,
- * while an engine-agnostic one is forced by the compiler to write `connector.alias?.…`. */
+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?: {
         scope?: string;
@@ -24,26 +22,70 @@ export declare abstract class SearchBaseRepository<TDocument extends object = ob
     setDataSource(opts: {
         dataSource: TDataSource;
     }): void;
-    /** WRITE responses never pass through the engine's exclude-fields filter, so hiddenProperties are
-     * stripped here - the relational branch gets the same guarantee from `.returning(visibleProperties)`. */
+    /** WRITE responses never pass through the engine's exclude-fields filter, so hiddenProperties are stripped here - the relational branch gets the same guarantee from `.returning(visibleProperties)`. */
     protected omitHiddenFields<R>(document: R): R;
     protected omitHiddenFieldsAll<R>(documents: R[]): R[];
-    /**
-     * Typesense has no transaction primitive - a caller-supplied options.transaction is rejected
-     * loudly instead of silently running outside the transaction the caller expects.
-     */
+    /** No search engine here has a transaction primitive (this tier is engine-neutral - Typesense and Meilisearch both inherit it) - a caller-supplied options.transaction is rejected loudly instead of silently running outside the transaction the caller expects. */
     protected assertNoTransaction(opts?: {
         transaction?: ITransaction;
     }): void;
-    /** Row-level locking (SELECT ... FOR UPDATE) has no Typesense equivalent - same NotSupported convention as assertNoTransaction. */
+    /** Row-level locking (SELECT ... FOR UPDATE) has no search-engine equivalent - same NotSupported convention as assertNoTransaction. */
     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;;2FAE2F;AAC3F,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;6GACyG;IACzG,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;;;OAGG;IACH,SAAS,CAAC,mBAAmB,CAAC,IAAI,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,YAAY,CAAA;KAAE,GAAG,IAAI;IAY1E,mIAAmI;IACnI,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,10 +2,12 @@
 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");
-/** Search-repository plumbing on `AbstractRepository`. `TDataSource` carries the concrete connector
- * type through `this.connector`: a concretely-bound repository reaches its engine's verbs uncast,
- * while an engine-agnostic one is forced by the compiler to write `connector.alias?.…`. */
+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) {
         super(dataSource, opts);
@@ -37,8 +39,7 @@ class SearchBaseRepository extends core_1.AbstractRepository {
     setDataSource(opts) {
         super.setDataSource(opts);
     }
-    /** WRITE responses never pass through the engine's exclude-fields filter, so hiddenProperties are
-     * stripped here - the relational branch gets the same guarantee from `.returning(visibleProperties)`. */
+    /** WRITE responses never pass through the engine's exclude-fields filter, so hiddenProperties are stripped here - the relational branch gets the same guarantee from `.returning(visibleProperties)`. */
     omitHiddenFields(document) {
         const hiddenFields = this.hiddenFields;
         if (hiddenFields.length === 0 || document === null || typeof document !== 'object') {
@@ -56,10 +57,7 @@ class SearchBaseRepository extends core_1.AbstractRepository {
         }
         return documents.map(document => this.omitHiddenFields(document));
     }
-    /**
-     * Typesense has no transaction primitive - a caller-supplied options.transaction is rejected
-     * loudly instead of silently running outside the transaction the caller expects.
-     */
+    /** No search engine here has a transaction primitive (this tier is engine-neutral - Typesense and Meilisearch both inherit it) - a caller-supplied options.transaction is rejected loudly instead of silently running outside the transaction the caller expects. */
     assertNoTransaction(opts) {
         if (!opts?.transaction) {
             return;
@@ -70,7 +68,7 @@ class SearchBaseRepository extends core_1.AbstractRepository {
             logger: this.logger,
         });
     }
-    /** Row-level locking (SELECT ... FOR UPDATE) has no Typesense equivalent - same NotSupported convention as assertNoTransaction. */
+    /** Row-level locking (SELECT ... FOR UPDATE) has no search-engine equivalent - same NotSupported convention as assertNoTransaction. */
     assertNoLock(opts) {
         if (!opts?.lock) {
             return;
@@ -81,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;
     }
-    mergeWhere(opts) {
-        const { defaultWhere, where } = opts;
-        if (!defaultWhere) {
-            return where;
+    /**
+     * 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`,
+        });
+    }
+    /**
+     * 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":";;;AAEA,mDAA8D;AAG9D,2CAAgD;AAIhD;;2FAE2F;AAC3F,MAAsB,oBAGpB,SAAQ,yBAAwC;IAChD,YACE,UAAwB,EACxB,IAAiE;QAEjE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC1B,CAAC;IAED,IAAa,UAAU;QACrB,OAAO,KAAK,CAAC,UAAyB,CAAC;IACzC,CAAC;IAED,IAAa,UAAU,CAAC,KAAkB;QACxC,KAAK,CAAC,UAAU,GAAG,KAAK,CAAC;IAC3B,CAAC;IAED,IAAa,MAAM;QACjB,OAAO,KAAK,CAAC,MAA0B,CAAC;IAC1C,CAAC;IAED,IAAa,MAAM,CAAC,KAAuB;QACzC,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,IAAI,cAAc;QAChB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC;IAC1B,CAAC;IAED,IAAc,SAAS;QACrB,OAAO,IAAI,CAAC,UAAU,CAAC,YAAY,EAA6C,CAAC;IACnF,CAAC;IAED,IAAc,YAAY;QACxB,OAAO,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;IAC3C,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC3D,CAAC;IAEQ,aAAa,CAAC,IAAiC;QACtD,KAAK,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED;6GACyG;IAC/F,gBAAgB,CAAI,QAAW;QACvC,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;QAEvC,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,IAAI,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;YACnF,OAAO,QAAQ,CAAC;QAClB,CAAC;QAED,MAAM,OAAO,GAA4B,EAAE,GAAI,QAAoC,EAAE,CAAC;QAEtF,KAAK,MAAM,KAAK,IAAI,YAAY,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,CAAC;QAED,OAAO,OAAY,CAAC;IACtB,CAAC;IAES,mBAAmB,CAAI,SAAc;QAC7C,IAAI,IAAI,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACO,mBAAmB,CAAC,IAAqC;QACjE,IAAI,CAAC,IAAI,EAAE,WAAW,EAAE,CAAC;YACvB,OAAO;QACT,CAAC;QAED,IAAA,6BAAiB,EAAC;YAChB,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI;YACvC,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,mIAAmI;IACzH,YAAY,CAAC,IAA8B;QACnD,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAChB,OAAO;QACT,CAAC;QAED,IAAA,6BAAiB,EAAC;YAChB,KAAK,EAAE,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI;YACvC,OAAO,EAAE,mBAAmB;YAC5B,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,iJAAiJ;IACvI,UAAU,CAAC,IAGpB;QACC,MAAM,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,IAAI,CAAC;QACjD,MAAM,YAAY,GAAG,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QAC7E,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QAE5E,MAAM,eAAe,GAAwB,MAAM;YACjD,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE;YACnC,CAAC,CAAC,WAAW;gBACX,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE;gBACxB,CAAC,CAAC,SAAS,CAAC;QAEhB,OAAO,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC;YAC7B,MAAM,EAAE,eAAe;YACvB,YAAY,EAAE,IAAI,CAAC,YAAY;SAChC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,IAA+C;QAChE,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QAErC,IAAI,CAAC,YAAY,EAAE,CAAC;YAClB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,YAAY,CAAC;QACtB,CAAC;QAED,OAAO,EAAE,GAAG,EAAE,CAAC,YAAY,EAAE,KAAK,CAAC,EAAE,CAAC;IACxC,CAAC;CACF;AAxID,oDAwIC"}
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/base.ts"],"names":[],"mappings":"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"}

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

@@ -63,9 +63,7 @@ export declare class PersistableSearchRepository<TDocument extends object = obje
     }): Promise<TCount & {
         data: R;
     }>;
-    /** Count-only contract: search engines have no RETURNING and no extra read is bolted on - `data`
-     * is always `null`, `shouldReturn` rejected at the type level. Callers wanting the affected
-     * documents read them explicitly before updating. */
+    /** Count-only: search engines have no RETURNING and no extra read is bolted on, so `data` is always `null` and `shouldReturn` is rejected at the type level - callers wanting the affected documents read them before updating. */
     updateAll(opts: {
         data: Partial<TDocument>;
         where?: TWhere;
@@ -91,9 +89,7 @@ export declare class PersistableSearchRepository<TDocument extends object = obje
     }): Promise<TCount & {
         data: R;
     }>;
-    /** Count-only like updateAll. Filter-delete when there is an effective where; truncates the whole
-     * collection only when neither where nor defaultFilter is present - truncate reports no
-     * per-document count, so that path returns { count: 0, data: null }. */
+    /** Count-only like updateAll: filter-delete when there is an effective where, truncating the whole collection only when neither where nor defaultFilter is present - truncate reports no per-document count, so that path returns { count: 0, data: null }. */
     deleteAll(opts?: {
         where?: TWhere;
         options?: Omit<IExtraOptions, 'shouldReturn'> & {
@@ -102,8 +98,7 @@ export declare class PersistableSearchRepository<TDocument extends object = obje
     }): Promise<TCount & {
         data: null;
     }>;
-    /** Bulk import through the neutral document facade. Per-row write `action` is Typesense-only
-     * vocabulary - callers needing it use `dataSource.getConnector().importDocuments(...)` directly. */
+    /** Bulk import through the neutral document facade. Per-row write `action` is Typesense-only vocabulary - callers needing it use `dataSource.getConnector().importDocuments(...)` directly. */
     import(opts: {
         documents: TDocument[];
         batchSize?: number;
@@ -113,5 +108,19 @@ export declare class PersistableSearchRepository<TDocument extends object = obje
         where?: TWhere;
         shouldSkipDefaultFilter?: boolean;
     }): string | undefined;
+    /**
+     * The write-path filter as THREE outcomes, because two of them are catastrophically different
+     * here: `filterBy: undefined` means "no effective where", which `deleteAll` treats as licence to
+     * truncate when `force` is set. An absorbing where must never land there -
+     * `deleteAll({ where: { or: permittedIds.map(...) } })` on an EMPTY permission list has to
+     * delete nothing, not the entire collection. `matchNone` is what keeps the two apart.
+     */
+    protected buildScopedFilter(opts: {
+        where?: TWhere;
+        shouldSkipDefaultFilter?: boolean;
+    }): {
+        filterBy?: string;
+        matchNone: boolean;
+    };
 }
 //# sourceMappingURL=persistable.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"persistable.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/persistable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,wBAAwB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAQtD,iHAAiH;AACjH,qBAAa,2BAA2B,CACtC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,SAAS,wBAAwB,GAAG,wBAAwB,CACvE,SAAQ,wBAAwB,CAAC,SAAS,EAAE,WAAW,CAAC;gBAC5C,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAKtF,MAAM,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACnC,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAqBxB,SAAS,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACtE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,SAAS,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACtC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACvE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IA4B/B,UAAU,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACvC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAsCjC;;yDAEqD;IACtC,SAAS,CAAC,IAAI,EAAE;QAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAyB3B,UAAU,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACvC,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAoCjC;;4EAEwE;IACzD,SAAS,CAAC,IAAI,CAAC,EAAE;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IAyCpC;wGACoG;IACpG,MAAM,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAmB7F,+LAA+L;IAC/L,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,MAAM,GAAG,SAAS;CAUvB"}
+{"version":3,"file":"persistable.d.ts","sourceRoot":"","sources":["../../../../../src/connectors/search/repositories/core/persistable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAEhF,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,MAAM,EAAa,MAAM,wBAAwB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAOtD,iHAAiH;AACjH,qBAAa,2BAA2B,CACtC,SAAS,SAAS,MAAM,GAAG,MAAM,EACjC,WAAW,SAAS,wBAAwB,GAAG,wBAAwB,CACvE,SAAQ,wBAAwB,CAAC,SAAS,EAAE,WAAW,CAAC;gBAC5C,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAA;KAAE;IAKtF,MAAM,CAAC,IAAI,EAAE;QACpB,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,MAAM,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACnC,IAAI,EAAE,SAAS,CAAC;QAChB,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAqBxB,SAAS,CAAC,IAAI,EAAE;QACvB,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACtE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,SAAS,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACtC,IAAI,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAC;YAAC,SAAS,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACvE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;IA0B/B,UAAU,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACvC,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAqCjC,mOAAmO;IACpN,SAAS,CAAC,IAAI,EAAE;QAC7B,IAAI,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IA+B3B,UAAU,CAAC,IAAI,EAAE;QACxB,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,EAAE,aAAa,GAAG;YAAE,YAAY,EAAE,KAAK,CAAA;SAAE,CAAC;KAClD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,SAAS,GAAG,IAAI,CAAA;KAAE,CAAC;IAEvC,UAAU,CAAC,CAAC,GAAG,SAAS,EAAE,IAAI,EAAE;QACvC,EAAE,EAAE,MAAM,CAAC;QACX,OAAO,CAAC,EAAE,aAAa,GAAG;YAAE,YAAY,CAAC,EAAE,IAAI,CAAA;SAAE,CAAC;KACnD,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,CAAC,CAAA;KAAE,CAAC;IAmCjC,+PAA+P;IAChP,SAAS,CAAC,IAAI,CAAC,EAAE;QAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,cAAc,CAAC,GAAG;YAAE,KAAK,CAAC,EAAE,OAAO,CAAA;SAAE,CAAC;KACrE,GAAG,OAAO,CAAC,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,CAAA;KAAE,CAAC;IA+CpC,+LAA+L;IAC/L,MAAM,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,SAAS,EAAE,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;IAmB7F,+LAA+L;IAC/L,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE;QAC5B,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,uBAAuB,CAAC,EAAE,OAAO,CAAC;KACnC,GAAG,MAAM,GAAG,SAAS;IAItB;;;;;;OAMG;IACH,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,uBAAuB,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG;QACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,OAAO,CAAC;KACpB;CAUF"}

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

@@ -1,12 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PersistableSearchRepository = void 0;
-const common_1 = require("../../../../common");
+const common_1 = require("../../../../connectors/search/common");
 const common_2 = require("../../../../base/repositories/common");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
 const readable_1 = require("./readable");
-/** Narrows one `IImportResult.responses` row (`unknown` - see connector.ts's `IImportResult<TResponse
- * = unknown>`) enough to read the per-row `success` flag `createAll` filters on. */
+/** Narrows one `unknown` `IImportResult.responses` row enough to read the per-row `success` flag `createAll` filters on. */
 const isImportRowLike = (value) => {
     return typeof value === 'object' && value !== null;
 };
@@ -28,8 +27,7 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         }
         return { count: 1, data: this.omitHiddenFields(created) };
     }
-    /** Delegates to import(). Typesense's bulk import reports only per-row success/fail (no echoed
-     * document), so "created" is just the caller's input rows filtered to the accepted ones. */
+    /** Delegates to import(). Typesense's bulk import reports only per-row success/fail with no echoed document, so "created" is the caller's input rows filtered to the accepted ones. */
     async createAll(opts) {
         this.assertNoTransaction(opts.options);
         this.assertNoLock(opts.options);
@@ -42,8 +40,7 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
             const response = rs.responses[index];
             return isImportRowLike(response) ? response.success !== false : true;
         });
-        // `created` is the caller's own input rows (bulk import echoes nothing back), so R is the
-        // caller's unchecked assertion here exactly as it is on the non-hidden path.
+        // `created` is the caller's own input rows (bulk import echoes nothing back), so R is the caller's unchecked assertion, as on the non-hidden path.
         return { count: rs.count.success, data: this.omitHiddenFieldsAll(created) };
     }
     /** Guards against defaultWhere by re-reading via findById first (costs one read; skippable via shouldSkipDefaultFilter). A guard failure throws the same sanitized 404 as a missing document. */
@@ -55,8 +52,7 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
             const found = await this.findById({ id, options });
             if (!found) {
                 throw (0, ignis_helpers_1.getError)({
-                    statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.NotFound,
-                    messageCode: common_1.SearchErrorCodes.NOT_FOUND,
+                    error: common_1.SearchErrors.NOT_FOUND,
                     message: `[${this.constructor.name}][updateById] Document not found or excluded by the default filter | Collection: ${this.collectionName} | Id: ${id}`,
                 });
             }
@@ -71,17 +67,20 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         }
         return { count: 1, data: this.omitHiddenFields(updated) };
     }
-    /** Count-only contract: search engines have no RETURNING and no extra read is bolted on - `data`
-     * is always `null`, `shouldReturn` rejected at the type level. Callers wanting the affected
-     * documents read them explicitly before updating. */
+    /** Count-only: search engines have no RETURNING and no extra read is bolted on, so `data` is always `null` and `shouldReturn` is rejected at the type level - callers wanting the affected documents read them before updating. */
     async updateAll(opts) {
         this.assertNoTransaction(opts.options);
         this.assertNoLock(opts.options);
         const { data, where, options } = opts;
-        const filterBy = this.buildFilterBy({
+        const { filterBy, matchNone } = this.buildScopedFilter({
             where,
             shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
         });
+        // Checked BEFORE the undefined guard: an absorbing where selects no document, which is a
+        // well-formed request to update nothing - not the "no effective where" the guard refuses.
+        if (matchNone) {
+            return { count: 0, data: null };
+        }
         if (filterBy === undefined) {
             throw (0, ignis_helpers_1.getError)({
                 message: `[${this.constructor.name}][updateAll] DENY to perform | Collection: ${this.collectionName} | No effective where condition (no where and no @model defaultFilter) - refusing an unfiltered bulk update`,
@@ -113,26 +112,28 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         if (!didDelete) {
             return { count: 0, data: null };
         }
-        // Typesense's delete has no RETURNING equivalent - `data` is only populated when the
-        // defaultFilter guard above already read the document; no extra read is done purely for shouldReturn.
+        // Typesense's delete has no RETURNING equivalent - `data` is populated only when the defaultFilter guard above already read the document; no extra read is done for shouldReturn.
         const data = options?.shouldReturn === false ? null : (found ?? null);
         return { count: 1, data };
     }
-    /** Count-only like updateAll. Filter-delete when there is an effective where; truncates the whole
-     * collection only when neither where nor defaultFilter is present - truncate reports no
-     * per-document count, so that path returns { count: 0, data: null }. */
+    /** Count-only like updateAll: filter-delete when there is an effective where, truncating the whole collection only when neither where nor defaultFilter is present - truncate reports no per-document count, so that path returns { count: 0, data: null }. */
     async deleteAll(opts) {
         this.assertNoTransaction(opts?.options);
         this.assertNoLock(opts?.options);
         const logger = this.logger.for(this.deleteAll.name);
         const { where, options } = opts ?? {};
-        const filterBy = this.buildFilterBy({
+        const { filterBy, matchNone } = this.buildScopedFilter({
             where,
             shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
         });
+        // Checked BEFORE the undefined guard, and the reason `matchNone` exists as a distinct outcome:
+        // an absorbing where selects no document. Collapsing it to `undefined` would enter the branch
+        // below and, with `force`, TRUNCATE the collection - the exact inversion of what was asked.
+        if (matchNone) {
+            return { count: 0, data: null };
+        }
         if (filterBy === undefined) {
-            // `where: {}` compiles to NO filter; wiping a collection must be asked for explicitly,
-            // exactly as Postgres demands `force` for an empty-where delete.
+            // `where: {}` compiles to NO filter; wiping a collection must be asked for explicitly, exactly as Postgres demands `force` for an empty-where delete.
             if (!options?.force) {
                 throw (0, ignis_helpers_1.getError)({
                     message: `[${this.constructor.name}][deleteAll] DENY to perform | Collection: ${this.collectionName} | No effective where condition (no where and no @model defaultFilter) - pass options.force to truncate the collection`,
@@ -150,8 +151,7 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         });
         return { count: deletedCount, data: null };
     }
-    /** Bulk import through the neutral document facade. Per-row write `action` is Typesense-only
-     * vocabulary - callers needing it use `dataSource.getConnector().importDocuments(...)` directly. */
+    /** Bulk import through the neutral document facade. Per-row write `action` is Typesense-only vocabulary - callers needing it use `dataSource.getConnector().importDocuments(...)` directly. */
     import(opts) {
         const { documents, batchSize } = opts;
         const importOpts = {
@@ -165,12 +165,22 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
     }
     /** Resolves filterBy, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
     buildFilterBy(opts) {
+        return this.buildScopedFilter(opts).filterBy;
+    }
+    /**
+     * The write-path filter as THREE outcomes, because two of them are catastrophically different
+     * here: `filterBy: undefined` means "no effective where", which `deleteAll` treats as licence to
+     * truncate when `force` is set. An absorbing where must never land there -
+     * `deleteAll({ where: { or: permittedIds.map(...) } })` on an EMPTY permission list has to
+     * delete nothing, not the entire collection. `matchNone` is what keeps the two apart.
+     */
+    buildScopedFilter(opts) {
         const { where, shouldSkipDefaultFilter } = opts;
         const query = this.buildQuery({
             filter: where !== undefined ? { where } : undefined,
             shouldSkipDefaultFilter,
         });
-        return query.filterBy;
+        return { filterBy: query.filterBy, matchNone: query.matchNone === true };
     }
 }
 exports.PersistableSearchRepository = PersistableSearchRepository;

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

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

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

@@ -3,8 +3,13 @@ import type { IExtraOptions, TCount, TDataWithRange, TFilter, TFindOneOptions, T
 import type { IdType } from '../../../../base/models';
 import type { ISearchResult } from '../../../../connectors/search';
 import type { TSearchInput } from '../../../../connectors/search/repositories/common';
+import { SearchModes } from '../../../../connectors/search/repositories/common';
 import type { AbstractSearchDataSource } from '../../../../connectors/search/datasources';
 import { SearchBaseRepository } from './base';
+/** The inputs the dialect translates - `raw` has already returned by the time these are resolved, and `applySearchInput` accepts only this narrowed union. */
+type TTranslatableSearchInput = Exclude<TSearchInput, {
+    mode: typeof SearchModes.RAW;
+}>;
 /** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */
 export declare class ReadableSearchRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends SearchBaseRepository<TDocument, TDataSource> {
     count(opts: {
@@ -27,17 +32,28 @@ export declare class ReadableSearchRepository<TDocument extends object = object,
         filter: TFilter;
         options?: TFindOneOptions<IExtraOptions, R>;
     }): Promise<TNullable<R>>;
-    /** Delegates to findOne with id in where - routes through buildQuery so hiddenFields/defaultFilter apply (a soft-deleted doc resolves to null, not fetched directly). */
+    /**
+     * Delegates to findOne with id in where - routing through buildQuery is what makes
+     * hiddenFields/defaultFilter apply, so a soft-deleted document resolves to null. `where` is spread
+     * away last so a projection can never widen the id lookup.
+     */
     findById<R = TDocument>(opts: {
         id: IdType;
+        filter?: Omit<TFilter, 'where'>;
         options?: TFindOneOptions<IExtraOptions, R>;
     }): Promise<TNullable<R>>;
-    /** Unified search entry, discriminated by `mode`: `raw` is a full passthrough (no dialect/
-     * defaultFilter/hiddenFields); keyword/semantic/hybrid translate via the dialect same as `find()`.
-     * Nothing engine-specific lives here - `ISearchQueryDialect.applySearchInput` owns it all. */
+    /**
+     * Unified search entry discriminated by `mode`: `raw` is a full passthrough - no dialect, no
+     * defaultFilter, no hiddenFields - while keyword/semantic/hybrid translate through the dialect
+     * like `find()`. Nothing engine-specific lives here; `ISearchQueryDialect.applySearchInput`
+     * owns it.
+     */
     search<R extends object = TDocument>(opts: TSearchInput & {
         options?: IExtraOptions;
     }): Promise<ISearchResult<R>>;
+    protected withDefaultQueryBy(opts: {
+        input: TTranslatableSearchInput;
+    }): TTranslatableSearchInput;
     /** @throws Error - disabled in a read-only repository; unlocked progressively by Persistable/DefaultSearchRepository. */
     create(opts: {
         data: TDocument;
@@ -91,7 +107,11 @@ export declare class ReadableSearchRepository<TDocument extends object = object,
     }): Promise<TCount & {
         data: R;
     }>;
-    /** @throws Error - disabled in a read-only repository. */
+    /**
+     * @throws Error - disabled in a read-only repository. `where` is optional where the base contract
+     * requires it: the `@model` defaultFilter alone can supply the effective filter, and Persistable
+     * refuses the write outright when neither is present.
+     */
     updateAll(_opts: {
         data: Partial<TDocument>;
         where?: TWhere;
@@ -128,4 +148,5 @@ export declare class ReadableSearchRepository<TDocument extends object = object,
         data: null;
     }>;
 }
+export {};
 //# sourceMappingURL=readable.d.ts.map