@venizia/ignis 0.0.10-5 → 0.1.0

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

@@ -1,11 +1,12 @@
 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 '../../connector';
-import type { TSearchInput } from '../common';
+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 connector. */
-export declare class ReadableSearchRepository<TDocument extends object = object> extends SearchBaseRepository<TDocument> {
+export declare class ReadableSearchRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends SearchBaseRepository<TDocument, TDataSource> {
     count(opts: {
         where: TWhere;
         options?: IExtraOptions;
@@ -15,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;
         };
@@ -23,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). */
@@ -39,21 +40,15 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         options?: IExtraOptions;
     }): Promise<TNullable<R>>;
     /** Unified search entry point, discriminated by `mode`:
-     * - `raw` - full-power passthrough straight to the connector, no dialect/defaultFilter/hiddenFields (unchanged legacy behavior).
-     * - `keyword` - full-text search, `where`/`defaultFilter`/`hiddenFields` translated via the dialect same as `find()`.
-     * - `semantic` - vector search; an explicit `nearVector` translates through the dialect, an omitted one falls back to `queryText` for server-side auto-embed.
-     * - `hybrid` - keyword + vector combined via the dialect's `alpha`-weighted `vector_query`.
+     * - `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.
      *
-     * `mode` is read once into a `const` so TypeScript's aliased-discriminant narrowing carries
-     * through both the early `raw` return and the switch below - no casts needed. */
+     * 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>>;
-    /** Applies faceting/highlighting/grouping/search-tuning params (shared by keyword/semantic/hybrid,
-     * absent from `raw`) onto `params` - arrays are comma-joined the same way the dialect joins queryBy/fields. */
-    private applyCommonSearchParams;
-    /** Throws the standardized NOT ALLOWED error for a disabled operation; callers pass their own method name for the message. */
-    protected denyOperation(methodName: string): never;
     /** @throws Error - disabled in a read-only repository; unlocked progressively by Persistable/DefaultSearchRepository. */
     create(opts: {
         data: TDocument;
@@ -108,25 +103,14 @@ export declare class ReadableSearchRepository<TDocument extends object = object>
         data: R;
     }>;
     /** @throws Error - disabled in a read-only repository. */
-    updateAll(opts: {
-        data: Partial<TDocument>;
-        where?: TWhere;
-        options: IExtraOptions & {
-            shouldReturn: false;
-            force?: boolean;
-        };
-    }): Promise<TCount & {
-        data: undefined | null;
-    }>;
-    updateAll<R = TDocument>(opts: {
+    updateAll(_opts: {
         data: Partial<TDocument>;
         where?: TWhere;
-        options?: IExtraOptions & {
-            shouldReturn?: true;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
             force?: boolean;
         };
     }): Promise<TCount & {
-        data: Array<R>;
+        data: null;
     }>;
     /** @throws Error - disabled in a read-only repository. */
     deleteById(opts: {
@@ -146,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"}

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

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./common"), exports);
+__exportStar(require("./core"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/connectors/search/repositories/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,yCAAuB"}

package/dist/connectors/typesense/compiler.d.ts

@@ -1,5 +1,5 @@
 import type { CollectionCreateSchema } from 'typesense/lib/Typesense/Collections';
-import type { ISearchCollectionDefinition } from '../../connectors/typesense/models';
+import type { ISearchCollectionDefinition } from '../../connectors/search/models';
 /** Compiles an engine-neutral `ISearchCollectionDefinition` into a Typesense `CollectionCreateSchema`. */
 export declare const compileTypesenseCollection: (opts: {
     definition: ISearchCollectionDefinition;

package/dist/connectors/typesense/compiler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/connectors/typesense/compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,OAAO,KAAK,EACV,2BAA2B,EAG5B,MAAM,+BAA+B,CAAC;AA4JvC,0GAA0G;AAC1G,eAAO,MAAM,0BAA0B,GAAI,MAAM;IAC/C,UAAU,EAAE,2BAA2B,CAAC;CACzC,KAAG,sBAgCH,CAAC"}
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../src/connectors/typesense/compiler.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qCAAqC,CAAC;AAElF,OAAO,KAAK,EACV,2BAA2B,EAG5B,MAAM,4BAA4B,CAAC;AA4JpC,0GAA0G;AAC1G,eAAO,MAAM,0BAA0B,GAAI,MAAM;IAC/C,UAAU,EAAE,2BAA2B,CAAC;CACzC,KAAG,sBAwCH,CAAC"}

package/dist/connectors/typesense/compiler.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compileTypesenseCollection = void 0;
 const ignis_helpers_1 = require("@venizia/ignis-helpers");
-const models_1 = require("../../connectors/typesense/models");
+const models_1 = require("../../connectors/search/models");
 const RESERVED_ID_FIELD_NAME = 'id';
 /** camelCase embed model-config field -> Typesense `model_config` snake_case wire key; unmapped keys pass through. */
 const EMBED_MODEL_WIRE_KEYS = {
@@ -135,8 +135,15 @@ const compileTypesenseCollection = (opts) => {
     };
     if (defaultSort !== undefined) {
         const sortField = fields.find(item => item.name === defaultSort);
+        // A defaultSort naming a field the collection does not declare would otherwise be forwarded to
+        // the engine verbatim and rejected there - fail here with the field named, same as the type check.
+        if (!sortField) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[compileTypesenseCollection] Invalid defaultSort | references a field that does not exist in the collection | name: ${name} | defaultSort: ${defaultSort}`,
+            });
+        }
         // Typesense's default_sorting_field accepts only a scalar numeric field, never string/array.
-        if (sortField && sortField.type !== models_1.SearchFieldTypes.NUMBER) {
+        if (sortField.type !== models_1.SearchFieldTypes.NUMBER) {
             throw (0, ignis_helpers_1.getError)({
                 message: `[compileTypesenseCollection] Invalid defaultSort | Typesense's default_sorting_field requires a scalar numeric field (int32/int64/float) - not string, not array | name: ${name} | defaultSort: ${defaultSort} | type: ${sortField.type}`,
             });

package/dist/connectors/typesense/compiler.js.map

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

package/dist/connectors/typesense/connector.d.ts

@@ -1,212 +1,8 @@
-import type { ISynonym } from '../../connectors/typesense/models';
-import type { ValueOrPromise } from '@venizia/ignis-helpers';
-import { BaseHelper } from '@venizia/ignis-helpers';
+import type { IAliasInfo, IImportResult, ISearchAliasScoped, ISearchCollectionScoped, ISearchDocumentScoped, ISearchResult, ISearchSynonymSetScoped } from '../../connectors/search';
+import { BaseSearchConnector } from '../../connectors/search';
+import type { ISynonym } from '../../connectors/search/models';
 import { Client } from 'typesense';
 import type { IMultiSearchResult, ITypesenseConnectorOptions, IUnionSearchResult, TCollectionCreateSchema, TCollectionFieldSchema, TCollectionSchema, TDocumentSchema, TImportResponse, TSearchOptions, TSearchParams, TTypesenseDirtyValue, TTypesenseImportAction } from './types';
-export interface IImportResult<TResponse = unknown> {
-    count: {
-        success: number;
-        fail: number;
-    };
-    responses: TResponse[];
-}
-export interface IAliasInfo {
-    name: string;
-    collection: string;
-}
-export interface ISearchConnectorCallbacks {
-    onInitialized?: (opts: {
-        name: string;
-    }) => void;
-    onError?: (opts: {
-        name: string;
-        error: unknown;
-    }) => void;
-}
-/** Search-response envelope - the read-path counterpart to IImportResult, consumed by ReadableSearchRepository without a boundary cast. */
-export interface ISearchResult<DocumentType extends object = object, HighlightType = unknown, FacetCountType = unknown, GroupedHitType = unknown> {
-    found: number;
-    outOf?: number;
-    searchTimeMs?: number;
-    hits?: Array<{
-        document: DocumentType;
-        highlight?: HighlightType;
-        highlights?: HighlightType[];
-        textMatch?: number;
-    }>;
-    facetCounts?: FacetCountType[];
-    groupedHits?: GroupedHitType[];
-}
-export interface ISearchCollectionScoped<CreateSchema = unknown, Schema = unknown, FieldSchema = unknown> {
-    create(opts: {
-        schema: CreateSchema;
-    }): Promise<Schema | void>;
-    ensure(opts: {
-        schema: CreateSchema;
-    }): Promise<Schema>;
-    get(opts: {
-        name: string;
-    }): Promise<Schema>;
-    list(): Promise<Schema[]>;
-    exists(opts: {
-        name: string;
-    }): Promise<boolean>;
-    patchSchema(opts: {
-        name: string;
-        fields: FieldSchema[];
-    }): Promise<void>;
-    delete(opts: {
-        name: string;
-    }): Promise<boolean>;
-}
-export interface ISearchAliasScoped {
-    upsert(opts: {
-        name: string;
-        collection: string;
-    }): Promise<void>;
-    get(opts: {
-        name: string;
-    }): Promise<IAliasInfo | null>;
-}
-export interface ISearchSynonymSetScoped {
-    upsert(opts: {
-        name: string;
-        items: ISynonym[];
-    }): Promise<void>;
-    get(opts: {
-        name: string;
-    }): Promise<ISynonym[] | null>;
-    list(): Promise<string[]>;
-    delete(opts: {
-        name: string;
-    }): Promise<boolean>;
-    link(opts: {
-        collection: string;
-        synonymSets: string[];
-    }): Promise<void>;
-}
-export interface ISearchDocumentScoped {
-    get<T extends object>(opts: {
-        collection: string;
-        id: string;
-    }): Promise<T>;
-    create<T extends object>(opts: {
-        collection: string;
-        document: T;
-    }): Promise<T>;
-    upsert<T extends object>(opts: {
-        collection: string;
-        document: T;
-    }): Promise<T>;
-    update<T extends object>(opts: {
-        collection: string;
-        id: string;
-        document: Partial<T>;
-    }): Promise<T>;
-    updateBy<T extends object>(opts: {
-        collection: string;
-        document: Partial<T>;
-        filterBy: string;
-    }): Promise<{
-        updatedCount: number;
-    }>;
-    delete(opts: {
-        collection: string;
-        id: string;
-    }): Promise<boolean>;
-    deleteBy(opts: {
-        collection: string;
-        filterBy: string;
-    }): Promise<number>;
-    deleteAll(opts: {
-        collection: string;
-    }): Promise<boolean>;
-    import<T extends object>(opts: {
-        collection: string;
-        documents: T[];
-        batchSize?: number;
-    }): Promise<IImportResult<unknown>>;
-    export(opts: {
-        collection: string;
-        filterBy?: string;
-        includeFields?: string[];
-    }): Promise<string>;
-}
-/** Verb contract every search-engine connector implements - kept as an interface so tests can fake one without a real typesense Client. */
-export interface ISearchConnector {
-    getHealth(): Promise<{
-        ok: boolean;
-    }>;
-    ping(): Promise<boolean>;
-    collection: ISearchCollectionScoped;
-    alias: ISearchAliasScoped;
-    synonymSet: ISearchSynonymSetScoped;
-    document: ISearchDocumentScoped;
-    search<TDocument extends object = object>(opts: {
-        collection: string;
-        params: unknown;
-    }): Promise<ISearchResult<TDocument>>;
-    multiSearch(opts: {
-        searches: unknown[];
-        union?: boolean;
-        commonParams?: unknown;
-        options?: unknown;
-    }): Promise<unknown>;
-}
-export declare abstract class BaseSearchConnector extends BaseHelper implements ISearchConnector {
-    constructor(opts: {
-        scope: string;
-        identifier: string;
-    });
-    ping(): Promise<boolean>;
-    protected assertNonEmpty(opts: {
-        value?: string | null;
-        name: string;
-        method: string;
-    }): void;
-    protected runEngineCall<T>(opts: {
-        method: string;
-        run: () => ValueOrPromise<T>;
-        tolerate?: {
-            when: (error: unknown) => boolean;
-            handle: (error: unknown) => ValueOrPromise<T>;
-        };
-    }): Promise<T>;
-    /** Tolerated-404 branch shared by getCollection/patchCollectionSchema/getDocument/updateDocument: throws the sanitized not-found error. */
-    protected notFoundTolerance(opts: {
-        method: string;
-        subject: string;
-    }): {
-        when: (error: unknown) => boolean;
-        handle: (error: unknown) => never;
-    };
-    /** Tolerated-404 branch shared by deleteCollection/getAlias/getSynonymSet/deleteSynonymSet/deleteDocument: logs and returns a benign sentinel instead of throwing. */
-    protected notFoundFallback<T>(opts: {
-        method: string;
-        message: string;
-        args?: unknown[];
-        fallback: T;
-    }): {
-        when: (error: unknown) => boolean;
-        handle: (error: unknown) => T;
-    };
-    abstract getHealth(): Promise<{
-        ok: boolean;
-    }>;
-    abstract collection: ISearchCollectionScoped;
-    abstract alias: ISearchAliasScoped;
-    abstract synonymSet: ISearchSynonymSetScoped;
-    abstract document: ISearchDocumentScoped;
-    abstract search<TDocument extends object = object>(opts: {
-        collection: string;
-        params: unknown;
-    }): Promise<ISearchResult<TDocument>>;
-    abstract multiSearch(opts: {
-        searches: unknown[];
-        union?: boolean;
-        commonParams?: unknown;
-    }): Promise<unknown>;
-}
 interface ITypesenseDocumentsApi {
     create(document: unknown, options?: unknown): Promise<unknown>;
     upsert(document: unknown, options?: unknown): Promise<unknown>;
@@ -268,6 +64,9 @@ export declare class TypesenseConnector extends BaseSearchConnector {
         client?: ITypesenseClientLike;
     });
     getClient(): Client;
+    protected isNotFoundError(opts: {
+        error: unknown;
+    }): boolean;
     readonly collection: ISearchCollectionScoped<TCollectionCreateSchema, TCollectionSchema, TCollectionFieldSchema>;
     readonly alias: ISearchAliasScoped;
     readonly synonymSet: ISearchSynonymSetScoped;
@@ -325,6 +124,11 @@ export declare class TypesenseConnector extends BaseSearchConnector {
         collection: string;
         id: string;
     }): Promise<T>;
+    /** Typesense's `found` is exhaustive, so a `per_page: 0` search is already an exact count - no separate endpoint needed. */
+    countDocuments(opts: {
+        collection: string;
+        filterBy?: string;
+    }): Promise<number>;
     upsertDocument<T extends object>(opts: {
         collection: string;
         document: T;