@venizia/ignis 0.0.10-4 → 0.1.0

package/dist/connectors/{typesense → search}/repositories/core/persistable.d.ts

@@ -1,14 +1,13 @@
-import { TClass } from '@venizia/ignis-helpers';
-import { IExtraOptions, TCount, TWhere } from '../../../../base/repositories/common';
-import { IdType } from '../../../../base/models';
-import { IImportResult } from '../../driver';
-import { TypesenseDataSource } from '../../../../connectors/typesense/datasources';
-import { BaseSearchEntity } from '../../../../connectors/typesense/models';
-import { TTypesenseImportAction } from '../../../../connectors/typesense/types';
+import type { IdType } from '../../../../base/models';
+import type { IExtraOptions, TCount, TWhere } from '../../../../base/repositories/common';
+import type { AbstractSearchDataSource } from '../../../../connectors/search/datasources';
+import type { BaseSearchEntity } from '../../../../connectors/search/models';
+import type { TClass } from '@venizia/ignis-helpers';
+import type { IImportResult } from '../../../../connectors/search';
 import { ReadableSearchRepository } from './readable';
-/** Write-tier search-repository - creates/updates through the driver, dialect-translating `where` clauses. */
-export declare class PersistableSearchRepository<TDocument extends object = object> extends ReadableSearchRepository<TDocument> {
-    constructor(ds?: TypesenseDataSource, opts?: {
+/** Write-tier search-repository - creates/updates through the connector, dialect-translating `where` clauses. */
+export declare class PersistableSearchRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends ReadableSearchRepository<TDocument, TDataSource> {
+    constructor(ds?: TDataSource, opts?: {
         scope?: string;
         entityClass?: TClass<BaseSearchEntity>;
     });
@@ -64,25 +63,20 @@ export declare class PersistableSearchRepository<TDocument extends object = obje
     }): Promise<TCount & {
         data: R;
     }>;
+    /**
+     * Bulk update on a search engine has no RETURNING and this tier refuses to bolt an extra
+     * engine read onto every call: the contract is count-only, `data` is always `null`, and
+     * `shouldReturn` is rejected at the type level. Callers that need the affected documents
+     * read them explicitly (and pay that cost visibly) before updating.
+     */
     updateAll(opts: {
         data: Partial<TDocument>;
         where?: TWhere;
-        options: IExtraOptions & {
-            shouldReturn: false;
-            force?: boolean;
-        };
-    }): Promise<TCount & {
-        data: undefined | null;
-    }>;
-    updateAll<R = TDocument>(opts: {
-        data: Partial<TDocument>;
-        where?: TWhere;
-        options?: IExtraOptions & {
-            shouldReturn?: true;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
             force?: boolean;
         };
     }): Promise<TCount & {
-        data: Array<R>;
+        data: null;
     }>;
     deleteById(opts: {
         id: IdType;
@@ -100,32 +94,30 @@ export declare class PersistableSearchRepository<TDocument extends object = obje
     }): Promise<TCount & {
         data: R;
     }>;
-    deleteAll(opts: {
+    /**
+     * Count-only, like updateAll: no RETURNING on search engines, no bolted-on read, `data` is
+     * always `null`. Filter-delete when there is an effective where (opts.where and/or
+     * defaultFilter); truncates the whole collection only when neither is present - truncate
+     * reports no per-document count, so that path returns { count: 0, data: null }.
+     */
+    deleteAll(opts?: {
         where?: TWhere;
-        options: IExtraOptions & {
-            shouldReturn: false;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
             force?: boolean;
         };
     }): Promise<TCount & {
-        data: undefined | null;
-    }>;
-    deleteAll<R = TDocument>(opts?: {
-        where?: TWhere;
-        options?: IExtraOptions & {
-            shouldReturn?: true;
-            force?: boolean;
-        };
-    }): Promise<TCount & {
-        data: Array<R>;
+        data: null;
     }>;
-    /** Bulk import passthrough to the driver. `action` is typed as Typesense's own
-     * `TTypesenseImportAction` - this tier is already Typesense-specific, and the driver is typed end to end (no `ISearchDriver` cast). */
+    /**
+     * Bulk import through the neutral document facade. The per-row write `action`
+     * (create/upsert/update/emplace) is Typesense-only vocabulary, so it is not modelled here - a
+     * caller who needs it reaches `dataSource.getConnector().importDocuments(...)` directly.
+     */
     import(opts: {
         documents: TDocument[];
-        action?: TTypesenseImportAction;
         batchSize?: number;
     }): Promise<IImportResult<unknown>>;
-    /** Resolves filter_by, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
+    /** Resolves filterBy, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
     protected buildFilterBy(opts: {
         where?: TWhere;
         shouldSkipDefaultFilter?: boolean;

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

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

package/dist/connectors/{typesense → search}/repositories/core/persistable.js

@@ -1,33 +1,32 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PersistableSearchRepository = void 0;
+const common_1 = require("../../../../common");
+const common_2 = require("../../../../base/repositories/common");
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const common_1 = require("../../../../base/repositories/common");
 const readable_1 = require("./readable");
-/** Narrows one `IImportResult.responses` row (`unknown` - see driver.ts's `IImportResult<TResponse
+/** Narrows one `IImportResult.responses` row (`unknown` - see connector.ts's `IImportResult<TResponse
  * = unknown>`) enough to read the per-row `success` flag `createAll` filters on. */
-function isImportRowLike(value) {
+const isImportRowLike = (value) => {
     return typeof value === 'object' && value !== null;
-}
-/** Write-tier search-repository - creates/updates through the driver, dialect-translating `where` clauses. */
+};
+/** Write-tier search-repository - creates/updates through the connector, dialect-translating `where` clauses. */
 class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
     constructor(ds, opts) {
         super(ds, opts);
-        this._operationScope = common_1.RepositoryOperationScopes.READ_WRITE;
+        this._operationScope = common_2.RepositoryOperationScopes.READ_WRITE;
     }
     async create(opts) {
         this.assertNoTransaction(opts.options);
         this.assertNoLock(opts.options);
-        const created = await this.dataSource.getDriver().createDocument({
+        const created = await this.connector.document.create({
             collection: this.collectionName,
             document: opts.data,
         });
         if (opts.options?.shouldReturn === false) {
             return { count: 1, data: null };
         }
-        // R is the caller-chosen output shape (defaults to TDocument, unrelated by any bound); the
-        // engine-echoed document can't be runtime-validated against an arbitrary caller-supplied R.
-        return { count: 1, data: created };
+        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. */
@@ -37,15 +36,15 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         const { data, options } = opts;
         const rs = await this.import({ documents: data, batchSize: options?.batchSize });
         if (options?.shouldReturn === false) {
-            return { count: rs.successCount, data: null };
+            return { count: rs.count.success, data: null };
         }
         const created = data.filter((_document, index) => {
             const response = rs.responses[index];
             return isImportRowLike(response) ? response.success !== false : true;
         });
-        // R is the caller-chosen output shape; filtered TDocument rows can't be runtime-validated
-        // against an arbitrary caller-supplied R, and TDocument/R share no bound for a direct assertion.
-        return { count: rs.successCount, data: created };
+        // `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.
+        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. */
     async updateById(opts) {
@@ -56,13 +55,13 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
             const found = await this.findById({ id, options });
             if (!found) {
                 throw (0, ignis_helpers_1.getError)({
-                    statusCode: 404,
-                    messageCode: 'core.search_engine.not_found',
+                    statusCode: ignis_helpers_1.HTTP.ResultCodes.RS_4.NotFound,
+                    messageCode: common_1.SearchErrorCodes.NOT_FOUND,
                     message: `[${this.constructor.name}][updateById] Document not found or excluded by the default filter | Collection: ${this.collectionName} | Id: ${id}`,
                 });
             }
         }
-        const updated = await this.dataSource.getDriver().updateDocument({
+        const updated = await this.connector.document.update({
             collection: this.collectionName,
             id: String(id),
             document: data,
@@ -70,9 +69,14 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         if (options?.shouldReturn === false) {
             return { count: 1, data: null };
         }
-        // Same R-is-caller-chosen boundary as create() above.
-        return { count: 1, data: updated };
+        return { count: 1, data: this.omitHiddenFields(updated) };
     }
+    /**
+     * Bulk update on a search engine has no RETURNING and this tier refuses to bolt an extra
+     * engine read onto every call: the contract is count-only, `data` is always `null`, and
+     * `shouldReturn` is rejected at the type level. Callers that need the affected documents
+     * read them explicitly (and pay that cost visibly) before updating.
+     */
     async updateAll(opts) {
         this.assertNoTransaction(opts.options);
         this.assertNoLock(opts.options);
@@ -86,21 +90,12 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
                 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`,
             });
         }
-        const result = await this.dataSource.getDriver().updateByFilter({
+        const result = await this.connector.document.updateBy({
             collection: this.collectionName,
             document: data,
             filterBy,
         });
-        if (options?.shouldReturn === false) {
-            return { count: result.updatedCount, data: null };
-        }
-        // Typesense's update-by-filter has no RETURNING equivalent - snapshots the (now-updated) rows
-        // via find() over the same filter, subject to the same pagination default as any other read.
-        const updated = await this.find({
-            filter: { where },
-            options: { shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter },
-        });
-        return { count: result.updatedCount, data: updated };
+        return { count: result.updatedCount, data: null };
     }
     /** Guards against defaultWhere same as updateById: an excluded document reports { count: 0 }, same as a genuinely missing one. Skippable via shouldSkipDefaultFilter. */
     async deleteById(opts) {
@@ -114,7 +109,7 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
                 return { count: 0, data: null };
             }
         }
-        const didDelete = await this.dataSource.getDriver().deleteDocument({
+        const didDelete = await this.connector.document.delete({
             collection: this.collectionName,
             id: String(id),
         });
@@ -126,7 +121,12 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         const data = options?.shouldReturn === false ? null : (found ?? null);
         return { count: 1, data };
     }
-    /** Filter-delete when there's an effective where (opts.where and/or defaultFilter); truncates the whole collection only when neither is present. Truncate reports no per-document count or data, so that path always returns { count: 0, data: null }. */
+    /**
+     * Count-only, like updateAll: no RETURNING on search engines, no bolted-on read, `data` is
+     * always `null`. Filter-delete when there is an effective where (opts.where and/or
+     * defaultFilter); truncates the whole collection only when neither 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);
@@ -137,32 +137,34 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
             shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
         });
         if (filterBy === undefined) {
-            const didTruncate = await this.dataSource.getDriver().deleteAllDocuments({
+            // `where: {}` compiles to NO filter, which used to read as "truncate everything" - and the
+            // truncate reports no count, so the call returned `{ count: 0 }` and nothing surfaced the
+            // damage. Wiping a collection has to be asked for, 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`,
+                });
+            }
+            const didTruncate = await this.connector.document.deleteAll({
                 collection: this.collectionName,
             });
-            logger.info('Truncated collection (engine does not report a per-document count) | Collection: %s | Truncated: %s', this.collectionName, didTruncate);
-            // Truncate reports neither a count nor the removed rows - `[]` (not null) keeps `data` an
-            // Array<R> like every other path; `null` is reserved for the explicit shouldReturn:false contract.
-            return { count: 0, data: options?.shouldReturn === false ? null : [] };
+            logger.warn('TRUNCATED collection on explicit force (engine reports no per-document count) | Collection: %s | Truncated: %s', this.collectionName, didTruncate);
+            return { count: 0, data: null };
         }
-        // Typesense's delete-by-filter has no RETURNING equivalent - snapshots the about-to-be-deleted
-        // rows via find() over the same filter before deleting; skipped when shouldReturn is false.
-        const affected = options?.shouldReturn === false
-            ? null
-            : await this.find({
-                filter: { where },
-                options: { shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter },
-            });
-        const deletedCount = await this.dataSource.getDriver().deleteByFilter({
+        const deletedCount = await this.connector.document.deleteBy({
             collection: this.collectionName,
             filterBy,
         });
-        return { count: deletedCount, data: affected };
+        return { count: deletedCount, data: null };
     }
-    /** Bulk import passthrough to the driver. `action` is typed as Typesense's own
-     * `TTypesenseImportAction` - this tier is already Typesense-specific, and the driver is typed end to end (no `ISearchDriver` cast). */
+    /**
+     * Bulk import through the neutral document facade. The per-row write `action`
+     * (create/upsert/update/emplace) is Typesense-only vocabulary, so it is not modelled here - a
+     * caller who needs it reaches `dataSource.getConnector().importDocuments(...)` directly.
+     */
     import(opts) {
-        const { documents, action, batchSize } = opts;
+        const { documents, batchSize } = opts;
         const importOpts = {
             collection: this.collectionName,
             documents,
@@ -170,19 +172,16 @@ class PersistableSearchRepository extends readable_1.ReadableSearchRepository {
         if (batchSize !== undefined) {
             importOpts.batchSize = batchSize;
         }
-        if (action !== undefined) {
-            importOpts.action = action;
-        }
-        return this.dataSource.getDriver().importDocuments(importOpts);
+        return this.connector.document.import(importOpts);
     }
-    /** Resolves filter_by, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
+    /** Resolves filterBy, AND-merging defaultWhere unless shouldSkipDefaultFilter. Returns undefined when there's no effective where - callers decide (updateAll refuses; deleteAll truncates). */
     buildFilterBy(opts) {
         const { where, shouldSkipDefaultFilter } = opts;
         const query = this.buildQuery({
             filter: where !== undefined ? { where } : undefined,
             shouldSkipDefaultFilter,
         });
-        return query.filter_by;
+        return query.filterBy;
     }
 }
 exports.PersistableSearchRepository = PersistableSearchRepository;

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

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

package/dist/connectors/{typesense → search}/repositories/core/readable.d.ts

@@ -1,10 +1,12 @@
-import { TNullable } from '@venizia/ignis-helpers';
-import { IExtraOptions, TCount, TDataRange, TFilter, TWhere } from '../../../../base/repositories/common';
-import { IdType } from '../../../../base/models';
-import { ISearchResult } from '../../driver';
+import type { TNullable } from '@venizia/ignis-helpers';
+import type { IExtraOptions, TCount, TDataRange, TFilter, TWhere } from '../../../../base/repositories/common';
+import type { IdType } from '../../../../base/models';
+import type { ISearchResult } from '../../../../connectors/search';
+import type { TSearchInput } from '../../../../connectors/search/repositories/common';
+import type { AbstractSearchDataSource } from '../../../../connectors/search/datasources';
 import { SearchBaseRepository } from './base';
-/** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the driver. */
-export declare class ReadableSearchRepository<TDocument extends object = object> extends SearchBaseRepository<TDocument> {
+/** 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: {
         where: TWhere;
         options?: IExtraOptions;
@@ -14,7 +16,7 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         options?: IExtraOptions;
     }): Promise<boolean>;
     find<R = TDocument>(opts: {
-        filter?: TFilter;
+        filter: TFilter;
         options: IExtraOptions & {
             shouldQueryRange: true;
         };
@@ -22,14 +24,14 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         data: Array<R>;
         range: TDataRange;
     }>;
-    find<R = TDocument>(opts?: {
-        filter?: TFilter;
+    find<R = TDocument>(opts: {
+        filter: TFilter;
         options?: IExtraOptions & {
             shouldQueryRange?: false;
         };
     }): Promise<Array<R>>;
-    findOne<R = TDocument>(opts?: {
-        filter?: TFilter;
+    findOne<R = TDocument>(opts: {
+        filter: TFilter;
         options?: IExtraOptions;
     }): 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). */
@@ -37,12 +39,16 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         id: IdType;
         options?: IExtraOptions;
     }): Promise<TNullable<R>>;
-    /** Raw passthrough to the driver's search - no dialect translation, no default filter.
-     * `TResult` defaults to `ISearchResult<TDocument>`; override it when the engine response is shaped differently (e.g. grouped hits). */
-    search<TResult = ISearchResult<TDocument>>(opts: {
-        params: object;
-        options?: object;
-    }): Promise<TResult>;
+    /** Unified search entry point, discriminated by `mode`:
+     * - `raw` - full-power passthrough straight to the connector, no dialect/defaultFilter/hiddenFields.
+     * - `keyword`/`semantic`/`hybrid` - `where`/`defaultFilter`/`hiddenFields` translated via the
+     *   dialect same as `find()`, then the dialect applies every engine-specific parameter.
+     *
+     * Nothing engine-specific lives here: mode dispatch, the vector clause and the tuning knobs are
+     * all owned by `ISearchQueryDialect.applySearchInput`. */
+    search<R extends object = TDocument>(opts: TSearchInput & {
+        options?: IExtraOptions;
+    }): Promise<ISearchResult<R>>;
     /** @throws Error - disabled in a read-only repository; unlocked progressively by Persistable/DefaultSearchRepository. */
     create(opts: {
         data: TDocument;
@@ -97,25 +103,14 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         data: R;
     }>;
     /** @throws Error - disabled in a read-only repository. */
-    updateAll(opts: {
+    updateAll(_opts: {
         data: Partial<TDocument>;
         where?: TWhere;
-        options: IExtraOptions & {
-            shouldReturn: false;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
             force?: boolean;
         };
     }): Promise<TCount & {
-        data: undefined | null;
-    }>;
-    updateAll<R = TDocument>(opts: {
-        data: Partial<TDocument>;
-        where?: TWhere;
-        options?: IExtraOptions & {
-            shouldReturn?: true;
-            force?: boolean;
-        };
-    }): Promise<TCount & {
-        data: Array<R>;
+        data: null;
     }>;
     /** @throws Error - disabled in a read-only repository. */
     deleteById(opts: {
@@ -135,23 +130,13 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         data: R;
     }>;
     /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */
-    deleteAll(opts: {
-        where?: TWhere;
-        options: IExtraOptions & {
-            shouldReturn: false;
-            force?: boolean;
-        };
-    }): Promise<TCount & {
-        data: undefined | null;
-    }>;
-    deleteAll<R = TDocument>(opts?: {
+    deleteAll(_opts?: {
         where?: TWhere;
-        options?: IExtraOptions & {
-            shouldReturn?: true;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
             force?: boolean;
         };
     }): Promise<TCount & {
-        data: Array<R>;
+        data: null;
     }>;
 }
 //# sourceMappingURL=readable.d.ts.map

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

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

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

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadableSearchRepository = void 0;
+const common_1 = require("../../../../base/repositories/common");
+const common_2 = require("../../../../connectors/search/repositories/common");
+const base_1 = require("./base");
+/** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */
+class ReadableSearchRepository extends base_1.SearchBaseRepository {
+    async count(opts) {
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const query = this.buildQuery({
+            filter: { where: opts.where },
+            shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,
+        });
+        // Counted through the document endpoint, never the search endpoint: an engine whose search
+        // total is capped or estimated would otherwise report a count that quietly lies.
+        const count = await this.connector.document.count({
+            collection: this.collectionName,
+            filterBy: query.filterBy,
+        });
+        return { count };
+    }
+    async existsWith(opts) {
+        const { count } = await this.count(opts);
+        return count > 0;
+    }
+    /** Bare array or `{ data, range }` per shouldQueryRange, postgres-shaped range. Typesense's `found`
+     * already comes back in the same call as `hits`, so unlike SQL no second count query is needed. */
+    async find(opts) {
+        const { filter, options } = opts;
+        this.assertNoTransaction(options);
+        this.assertNoLock(options);
+        // Omitted limit falls back to @model settings.defaultLimit then DEFAULT_LIMIT, rather than leaving `per_page` unset (an unbounded query).
+        const effectiveFilter = {
+            ...filter,
+            limit: filter?.limit ?? this.defaultLimit ?? common_1.DEFAULT_LIMIT,
+        };
+        const query = this.buildQuery({
+            filter: effectiveFilter,
+            shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
+        });
+        const result = await this.connector.search({
+            collection: this.collectionName,
+            params: this.queryDialect.toWireParams({ query }),
+        });
+        const { hits, found } = result;
+        // An explicit `find<Other>()` call is the caller's own unchecked assertion (R defaults to TDocument).
+        // Stripped in JS as well as engine-side: Typesense honours `exclude_fields`, but Meilisearch has
+        // no per-query exclusion at all, so the engine is not the last line of defence here.
+        const data = this.omitHiddenFieldsAll((hits ?? []).map(hit => hit.document));
+        if (!options?.shouldQueryRange) {
+            return data;
+        }
+        return {
+            data,
+            range: (0, common_1.buildDataRange)({
+                skip: effectiveFilter.skip,
+                offset: effectiveFilter.offset,
+                dataLength: data.length,
+                total: found,
+            }),
+        };
+    }
+    async findOne(opts) {
+        const { filter, options } = opts;
+        const results = await this.find({ filter: { ...filter, limit: 1 }, options });
+        return results[0] ?? null;
+    }
+    /** Delegates to findOne with id in where - routes through buildQuery so hiddenFields/defaultFilter apply (a soft-deleted doc resolves to null, not fetched directly). */
+    findById(opts) {
+        const { id, options } = opts;
+        return this.findOne({ filter: { where: { id } }, options });
+    }
+    /** Unified search entry point, discriminated by `mode`:
+     * - `raw` - full-power passthrough straight to the connector, no dialect/defaultFilter/hiddenFields.
+     * - `keyword`/`semantic`/`hybrid` - `where`/`defaultFilter`/`hiddenFields` translated via the
+     *   dialect same as `find()`, then the dialect applies every engine-specific parameter.
+     *
+     * Nothing engine-specific lives here: mode dispatch, the vector clause and the tuning knobs are
+     * all owned by `ISearchQueryDialect.applySearchInput`. */
+    async search(opts) {
+        if (opts.mode === common_2.SearchModes.RAW) {
+            return this.connector.search({
+                collection: this.collectionName,
+                params: opts.params,
+            });
+        }
+        this.assertNoTransaction(opts.options);
+        this.assertNoLock(opts.options);
+        const query = this.buildQuery({
+            filter: opts.filter,
+            shouldSkipDefaultFilter: opts.options?.shouldSkipDefaultFilter,
+        });
+        this.queryDialect.applySearchInput({ query, input: opts });
+        const result = await this.connector.search({
+            collection: this.collectionName,
+            params: this.queryDialect.toWireParams({ query }),
+        });
+        return {
+            ...result,
+            hits: (result.hits ?? []).map(hit => ({
+                ...hit,
+                document: this.omitHiddenFields(hit.document),
+            })),
+        };
+    }
+    create(_opts) {
+        return this.denyOperation(this.create.name);
+    }
+    createAll(_opts) {
+        return this.denyOperation(this.createAll.name);
+    }
+    updateById(_opts) {
+        return this.denyOperation(this.updateById.name);
+    }
+    /** @throws Error - disabled in a read-only repository. */
+    updateAll(_opts) {
+        return this.denyOperation(this.updateAll.name);
+    }
+    deleteById(_opts) {
+        return this.denyOperation(this.deleteById.name);
+    }
+    /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */
+    deleteAll(_opts) {
+        return this.denyOperation(this.deleteAll.name);
+    }
+}
+exports.ReadableSearchRepository = ReadableSearchRepository;
+//# sourceMappingURL=readable.js.map

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

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

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

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

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

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