@venizia/ignis-connectors 0.2.0-2 → 0.2.0-21

package/dist/cjs/search/typesense/common/types/search.d.ts

@@ -0,0 +1,13 @@
+import type { SearchParams, SearchResponse, SearchOptions, ImportResponse } from 'typesense/lib/Typesense/Documents';
+import type { UnionSearchResponse } from 'typesense/lib/Typesense/Types';
+import type { TDocumentSchema } from './schema';
+export type TSearchParams = SearchParams<TDocumentSchema>;
+export type TSearchResponse<T extends TDocumentSchema = TDocumentSchema> = SearchResponse<T>;
+export type TSearchOptions = SearchOptions;
+export type TImportResponse = ImportResponse;
+export interface IMultiSearchResult<T extends TDocumentSchema = TDocumentSchema> {
+    results: TSearchResponse<T>[];
+}
+export interface IUnionSearchResult<T extends TDocumentSchema = TDocumentSchema> extends UnionSearchResponse<T> {
+}
+//# sourceMappingURL=search.d.ts.map

package/dist/cjs/search/typesense/common/types/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../../../../src/search/typesense/common/types/search.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,aAAa,EACb,cAAc,EACf,MAAM,mCAAmC,CAAC;AAC3C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,MAAM,MAAM,aAAa,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAC1D,MAAM,MAAM,eAAe,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe,IAAI,cAAc,CAAC,CAAC,CAAC,CAAC;AAG7F,MAAM,MAAM,cAAc,GAAG,aAAa,CAAC;AAC3C,MAAM,MAAM,eAAe,GAAG,cAAc,CAAC;AAE7C,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,eAAe,GAAG,eAAe;IAC7E,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB,CACjC,CAAC,SAAS,eAAe,GAAG,eAAe,CAC3C,SAAQ,mBAAmB,CAAC,CAAC,CAAC;CAAG"}

package/dist/cjs/search/typesense/common/types/search.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=search.js.map

package/dist/cjs/search/typesense/common/types/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../../../../../src/search/typesense/common/types/search.ts"],"names":[],"mappings":""}

package/dist/cjs/search/typesense/compiler.d.ts

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

package/dist/cjs/search/typesense/compiler.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.compileTypesenseCollection = void 0;
 const core_1 = require("@venizia/ignis-helpers/core");
-const models_1 = require("../../search/core/models");
+const models_1 = require("../core/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 = {

package/dist/cjs/search/typesense/connector.d.ts

@@ -1,62 +1,9 @@
-import type { IAliasInfo, IImportResult, ISearchAliasScoped, ISearchCollectionScoped, ISearchDocumentScoped, ISearchResult, ISearchSynonymSetScoped } from '../../search/core';
-import { BaseSearchConnector } from '../../search/core';
-import type { ISynonym } from '../../search/core/models';
+import type { IAliasInfo, IImportResult, ISearchAliasScoped, ISearchCollectionScoped, ISearchDocumentScoped, ISearchResult, ISearchSynonymSetScoped } from '../core';
+import { BaseSearchConnector } from '../core';
+import type { ISynonym } from '../core/models';
 import { Client } from 'typesense';
-import type { IMultiSearchResult, ITypesenseConnectorOptions, IUnionSearchResult, TCollectionCreateSchema, TCollectionFieldSchema, TCollectionSchema, TDocumentSchema, TImportResponse, TSearchOptions, TSearchParams, TTypesenseDirtyValue, TTypesenseImportAction } from './types';
-interface ITypesenseDocumentsApi {
-    create(document: unknown, options?: unknown): Promise<unknown>;
-    upsert(document: unknown, options?: unknown): Promise<unknown>;
-    update(document: unknown, options: unknown): Promise<unknown>;
-    delete(query?: unknown): Promise<unknown>;
-    import(documents: unknown[], options?: unknown): Promise<unknown>;
-    search(searchParameters: unknown, options?: unknown): Promise<unknown>;
-    export(options?: unknown): Promise<unknown>;
-}
-interface ITypesenseDocumentApi {
-    retrieve(): Promise<unknown>;
-    update(partialDocument: unknown, options?: unknown): Promise<unknown>;
-    delete(options?: unknown): Promise<unknown>;
-}
-interface ITypesenseSynonymSetApi {
-    upsert(params: unknown): Promise<unknown>;
-    retrieve(): Promise<unknown>;
-    delete(): Promise<unknown>;
-}
-interface ITypesenseSynonymSetsApi {
-    retrieve(): Promise<unknown>;
-}
-interface ITypesenseCollectionApi {
-    documents(): ITypesenseDocumentsApi;
-    documents(documentId: string): ITypesenseDocumentApi;
-    retrieve(): Promise<unknown>;
-    update(schema: unknown): Promise<unknown>;
-    delete(options?: unknown): Promise<unknown>;
-    exists(): Promise<boolean>;
-}
-interface ITypesenseCollectionsApi {
-    create(schema: unknown, options?: unknown): Promise<unknown>;
-    retrieve(options?: unknown): Promise<unknown>;
-}
-interface ITypesenseAliasApi {
-    retrieve(): Promise<unknown>;
-}
-interface ITypesenseAliasesApi {
-    upsert(name: string, mapping: unknown): Promise<unknown>;
-}
-export interface ITypesenseClientLike {
-    collections(): ITypesenseCollectionsApi;
-    collections(collectionName: string): ITypesenseCollectionApi;
-    aliases(): ITypesenseAliasesApi;
-    aliases(aliasName: string): ITypesenseAliasApi;
-    synonymSets(): ITypesenseSynonymSetsApi;
-    synonymSets(synonymSetName: string): ITypesenseSynonymSetApi;
-    health: {
-        retrieve(): Promise<unknown>;
-    };
-    multiSearch: {
-        perform(searchRequests: unknown, commonParams?: unknown, options?: unknown): Promise<unknown>;
-    };
-}
+import type { IMultiSearchResult, ITypesenseClientLike, ITypesenseConnectorOptions, IUnionSearchResult, TCollectionCreateSchema, TCollectionFieldSchema, TCollectionSchema, TDocumentSchema, TImportResponse, TSearchOptions, TSearchParams, TTypesenseDirtyValue, TTypesenseImportAction } from './common';
+export type { ITypesenseClientLike } from './common';
 /** Typesense engine connector - built/injected by TypesenseDataSource, which exposes the raw client via getClient(). */
 export declare class TypesenseConnector extends BaseSearchConnector {
     private readonly client;
@@ -215,5 +162,4 @@ export declare class TypesenseConnector extends BaseSearchConnector {
         options?: TSearchOptions;
     }): Promise<IMultiSearchResult<T>>;
 }
-export {};
 //# sourceMappingURL=connector.d.ts.map

package/dist/cjs/search/typesense/connector.d.ts.map

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

package/dist/cjs/search/typesense/connector.js

@@ -1,180 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TypesenseConnector = void 0;
-const common_1 = require("../../search/core/common");
-const core_1 = require("../../search/core");
-const internal_1 = require("../../search/core/internal");
+const common_1 = require("../core/common");
+const core_1 = require("../core");
+const internal_1 = require("../core/internal");
 const core_2 = require("@venizia/ignis-helpers/core");
 const typesense_1 = require("typesense");
-const connector_internal_1 = require("./internal/connector-internal");
-const types_1 = require("./types");
-// Narrow runtime readers for the `unknown` payloads ITypesenseClientLike hands back - the narrowest cast per field, isolated here instead of repeated ad hoc at every call site.
-const isRecord = (value) => {
-    return typeof value === 'object' && value !== null;
-};
-const readBooleanFlag = (opts) => {
-    const { value, key } = opts;
-    return isRecord(value) ? Boolean(value[key]) : false;
-};
-const readNumberField = (opts) => {
-    const { value, key } = opts;
-    if (!isRecord(value) || typeof value[key] !== 'number') {
-        return 0;
-    }
-    return value[key];
-};
-const readStringField = (opts) => {
-    const { value, key } = opts;
-    if (!isRecord(value) || typeof value[key] !== 'string') {
-        return undefined;
-    }
-    return value[key];
-};
-/** Maps a raw Typesense search hit (snake_case `text_match`) onto the camelCase `ISearchResult` hit shape; read via bracket string access so no snake_case identifier is declared here. */
-const mapSearchHit = (hit) => {
-    if (!isRecord(hit)) {
-        return { document: {} };
-    }
-    const mapped = {
-        document: hit['document'],
-    };
-    if (hit['highlight'] !== undefined) {
-        mapped.highlight = hit['highlight'];
-    }
-    if (Array.isArray(hit['highlights'])) {
-        mapped.highlights = hit['highlights'];
-    }
-    if (typeof hit['text_match'] === 'number') {
-        mapped.score = hit['text_match'];
-    }
-    return mapped;
-};
-/** Maps a raw Typesense search response onto the camelCase `ISearchResult`; snake_case wire fields (`out_of`/`search_time_ms`/`facet_counts`/`grouped_hits`) are read only via bracket string access, never as identifiers, and absent fields are omitted rather than mapped as `undefined`. */
-const mapSearchResult = (raw) => {
-    if (!isRecord(raw)) {
-        return { found: 0, isFoundExact: true };
-    }
-    // `found` is exhaustive UNLESS the engine ran out of its search-time budget: `search_cutoff`
-    // means it stopped early and reported what it had, so the count is an estimate. Hardcoding
-    // `true` told every caller that a truncated count was authoritative.
-    const result = {
-        found: readNumberField({ value: raw, key: 'found' }),
-        isFoundExact: raw['search_cutoff'] !== true,
-    };
-    if (typeof raw['out_of'] === 'number') {
-        result.outOf = raw['out_of'];
-    }
-    if (typeof raw['search_time_ms'] === 'number') {
-        result.searchTimeMs = raw['search_time_ms'];
-    }
-    if (Array.isArray(raw['facet_counts'])) {
-        result.facetCounts = raw['facet_counts'];
-    }
-    if (Array.isArray(raw['grouped_hits'])) {
-        result.groupedHits = raw['grouped_hits'];
-    }
-    if (Array.isArray(raw['hits'])) {
-        result.hits = raw['hits'].map(hit => mapSearchHit(hit));
-    }
-    return result;
-};
-/** `--max-per-page`: Typesense refuses a page larger than this, so a bigger caller limit is served as consecutive windows of one multi_search call rather than as several calls. */
-const MAX_HITS_PER_PAGE = 250;
-/** `limit_multi_searches`: entries permitted in ONE multi_search call, which bounds windowing at 50 x 250 = 12,500 hits. Exceeding it is refused, never silently truncated. */
-const MAX_MULTI_SEARCH_ENTRIES = 50;
-/**
- * Splits a requested page into windows the engine will accept.
- *
- * Windows are expressed as `offset`/`limit` rather than `page`/`per_page` because only offset
- * arithmetic can start a window anywhere - which is also what lets a caller's `skip` land off a
- * page boundary. Exactly one pagination pair is ever sent: Typesense documents `offset`/`limit`
- * and `page`/`per_page` as alternatives and does not state which wins if both appear, so the
- * question is designed out rather than answered.
- */
-const toSearchWindows = (opts) => {
-    const { offset, limit } = opts;
-    if (limit <= MAX_HITS_PER_PAGE) {
-        return [{ offset, limit }];
-    }
-    const windows = [];
-    for (let start = 0; start < limit; start += MAX_HITS_PER_PAGE) {
-        windows.push({ offset: offset + start, limit: Math.min(MAX_HITS_PER_PAGE, limit - start) });
-    }
-    return windows;
-};
-/**
- * Folds windowed responses into the single result the caller asked for.
- *
- * `found`/`outOf` come from the first window because every window ran the same filter and reports
- * the same total. `facetCounts` likewise: facets are computed over the whole result set, not the
- * page, so concatenating them would multiply every count by the window count.
- */
-const mergeWindowedResults = (results) => {
-    const [first] = results;
-    if (results.length === 1) {
-        return first;
-    }
-    const merged = {
-        found: first.found,
-        // AND-folded: the total is only exact if EVERY window ran to completion. One cut-off window
-        // makes the merged count an estimate, and saying otherwise would relaunch the bug above.
-        isFoundExact: results.every(result => result.isFoundExact),
-    };
-    if (first.outOf !== undefined) {
-        merged.outOf = first.outOf;
-    }
-    // MAX, not sum: this field is read as latency, and the windows travel in ONE round trip. Summing
-    // would make a windowed query graph at several times its actual wall-clock.
-    const timings = results
-        .map(result => result.searchTimeMs)
-        .filter((value) => typeof value === 'number');
-    if (timings.length > 0) {
-        merged.searchTimeMs = Math.max(...timings);
-    }
-    if (first.facetCounts) {
-        merged.facetCounts = first.facetCounts;
-    }
-    const hits = results.flatMap(result => result.hits ?? []);
-    if (hits.length > 0) {
-        merged.hits = hits;
-    }
-    return merged;
-};
-/**
- * Reads the requested page out of engine-native params, whichever pair the caller used.
- *
- * `mode: 'raw'` hands these params through untouched, so both spellings have to be understood
- * here; the caller is never asked to normalize.
- */
-const readRequestedPage = (params) => {
-    const limit = typeof params['limit'] === 'number' ? params['limit'] : undefined;
-    const perPage = typeof params['per_page'] === 'number' ? params['per_page'] : undefined;
-    const effectiveLimit = limit ?? perPage;
-    if (effectiveLimit === undefined) {
-        return undefined;
-    }
-    const offset = typeof params['offset'] === 'number' ? params['offset'] : undefined;
-    const page = typeof params['page'] === 'number' ? params['page'] : undefined;
-    const effectiveOffset = offset ?? (page !== undefined ? (page - 1) * effectiveLimit : 0);
-    return { offset: effectiveOffset, limit: effectiveLimit };
-};
-/** Empty TSearchResponse shape returned when search() tolerates a missing collection; built via bracket assignment so no snake_case identifier is declared here. */
-const buildEmptySearchResponse = () => {
-    const response = { found: 0, page: 1, hits: [] };
-    response['out_of'] = 0;
-    response['search_time_ms'] = 0;
-    response['request_params'] = {};
-    return response;
-};
-// Typesense's wire shape for a synonym set; `root` is only present for one-way synonyms.
-const isSynonymResponse = (value) => {
-    return isRecord(value) && typeof value.id === 'string' && Array.isArray(value.synonyms);
-};
-const toSynonym = (value) => {
-    const { id, synonyms, root } = value;
-    // Multi-way sets come back with root: "" - treat empty/absent alike so only one-way keeps a root.
-    return root ? { id, synonyms, root } : { id, synonyms };
-};
+const internal_2 = require("./internal");
+const pagination_windows_1 = require("./internal/pagination-windows");
+const common_2 = require("./common");
 /** Typesense engine connector - built/injected by TypesenseDataSource, which exposes the raw client via getClient(). */
 class TypesenseConnector extends core_1.BaseSearchConnector {
     constructor(opts) {
@@ -239,12 +73,12 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
         return this.client;
     }
     isNotFoundError(opts) {
-        return connector_internal_1.TypesenseInternal.isNotFoundError(opts);
+        return internal_2.TypesenseInternal.isNotFoundError(opts);
     }
     async getHealth() {
         try {
             const health = await this.client.health.retrieve();
-            return { ok: readBooleanFlag({ value: health, key: 'ok' }) };
+            return { ok: (0, internal_2.readBooleanFlag)({ value: health, key: 'ok' }) };
         }
         catch (error) {
             this.logger
@@ -264,7 +98,7 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
                 return created;
             },
             tolerate: {
-                when: error => connector_internal_1.TypesenseInternal.isAlreadyExistsError({ error }),
+                when: error => internal_2.TypesenseInternal.isAlreadyExistsError({ error }),
                 handle: () => {
                     logger.info('Collection already exists, skipping | name: %s', schema.name);
                 },
@@ -316,16 +150,14 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
         if (!name || name.trim().length === 0) {
             return false;
         }
-        try {
-            const isExists = await this.client.collections(name).exists();
-            return isExists;
-        }
-        catch (error) {
-            this.logger
-                .for(this.collectionExists.name)
-                .warn('Existence check failed, treating as absent | name: %s | error: %s', name, internal_1.SearchConnectorInternal.describeError({ error }));
-            return false;
-        }
+        // exists() already resolves false for a genuine absence (it swallows its own not-found) and
+        // only ever rejects on an infrastructure failure, so there is nothing to tolerate here -
+        // ensureCollection reads false as "create it", so a failure must surface, not read as absence.
+        const rs = await this.runEngineCall({
+            method: this.collectionExists.name,
+            run: () => this.client.collections(name).exists(),
+        });
+        return rs;
     }
     async patchCollectionSchema(opts) {
         const { name, fields } = opts;
@@ -389,8 +221,8 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
             method: this.getAlias.name,
             run: async () => {
                 const alias = await this.client.aliases(name).retrieve();
-                const aliasName = readStringField({ value: alias, key: 'name' });
-                const collectionName = readStringField({ value: alias, key: 'collection_name' });
+                const aliasName = (0, internal_2.readStringField)({ value: alias, key: 'name' });
+                const collectionName = (0, internal_2.readStringField)({ value: alias, key: 'collection_name' });
                 if (aliasName === undefined || collectionName === undefined) {
                     internal_1.SearchConnectorInternal.throwNotFoundError({
                         method: this.getAlias.name,
@@ -434,8 +266,8 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
             method: this.getSynonymSet.name,
             run: async () => {
                 const result = await this.client.synonymSets(name).retrieve();
-                const items = isRecord(result) && Array.isArray(result.items) ? result.items : [];
-                return items.filter(isSynonymResponse).map(toSynonym);
+                const items = (0, internal_2.isRecord)(result) && Array.isArray(result.items) ? result.items : [];
+                return items.filter(internal_2.isSynonymResponse).map(internal_2.toSynonym);
             },
             tolerate: this.notFoundFallback({
                 method: this.getSynonymSet.name,
@@ -453,7 +285,7 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
                 const result = await this.client.synonymSets().retrieve();
                 const sets = Array.isArray(result) ? result : [];
                 return sets
-                    .filter(isRecord)
+                    .filter(internal_2.isRecord)
                     .map(set => set.name)
                     .filter((setName) => typeof setName === 'string');
             },
@@ -519,7 +351,7 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
             },
             // Typesense rejects a duplicate id with 409; surfaced as the neutral already_exists conflict rather than the generic sanitized 503 - same contract Meilisearch's createDocument throws.
             tolerate: {
-                when: error => connector_internal_1.TypesenseInternal.isAlreadyExistsError({ error }),
+                when: error => internal_2.TypesenseInternal.isAlreadyExistsError({ error }),
                 handle: () => {
                     throw (0, core_2.getError)({
                         error: common_1.SearchErrors.ALREADY_EXISTS,
@@ -652,15 +484,15 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
             method: this.importDocuments.name,
         });
         // typesense's own default action is 'create'; keep runtime validation for untyped callers.
-        const action = opts.action ?? types_1.TypesenseImportActions.CREATE;
-        if (!types_1.TypesenseImportActions.isValid(action)) {
+        const action = opts.action ?? common_2.TypesenseImportActions.CREATE;
+        if (!common_2.TypesenseImportActions.isValid(action)) {
             throw (0, core_2.getError)({
-                message: `[importDocuments] Invalid action | action: ${action} | valids: ${[...types_1.TypesenseImportActions.SCHEME_SET]}`,
+                message: `[importDocuments] Invalid action | action: ${action} | valids: ${[...common_2.TypesenseImportActions.SCHEME_SET]}`,
             });
         }
-        if (dirtyValues && !types_1.TypesenseDirtyValues.isValid(dirtyValues)) {
+        if (dirtyValues && !common_2.TypesenseDirtyValues.isValid(dirtyValues)) {
             throw (0, core_2.getError)({
-                message: `[importDocuments] Invalid dirtyValues | value: ${dirtyValues} | valids: ${[...types_1.TypesenseDirtyValues.SCHEME_SET]}`,
+                message: `[importDocuments] Invalid dirtyValues | value: ${dirtyValues} | valids: ${[...common_2.TypesenseDirtyValues.SCHEME_SET]}`,
             });
         }
         const logger = this.logger.for(this.importDocuments.name);
@@ -685,21 +517,26 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
             }
         }
         catch (error) {
-            // A framework ApplicationError is already sanitized and carries its own statusCode/messageCode, so it surfaces as-is; only raw engine failures get wrapped as a 503, mirroring runEngineCall's guard.
+            // Batches before the failure are already persisted server-side; every failure path carries partial progress so callers can resume or retry.
+            const details = {
+                totalCount: documents.length,
+                processedCount: successCount + failCount,
+                successCount,
+                failCount,
+            };
+            // Re-wrapping an ApplicationError would erase its statusCode/messageCode, so merge progress onto it instead of replacing it.
             if ((0, core_2.isApplicationError)(error)) {
+                error.extra = {
+                    ...error.extra,
+                    details: { ...error.extra?.['details'], ...details },
+                };
                 throw error;
             }
-            // Batches before the failure are already persisted server-side; attach partial progress so callers can decide to resume or retry.
             internal_1.SearchConnectorInternal.wrapDependencyError({
                 method: this.importDocuments.name,
                 error,
                 logger: this.logger,
-                details: {
-                    totalCount: documents.length,
-                    processedCount: successCount + failCount,
-                    successCount,
-                    failCount,
-                },
+                details,
             });
         }
         logger.info('Imported documents | collection: %s | ok: %d | fail: %d', collection, successCount, failCount);
@@ -722,7 +559,7 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
                     .collections(collection)
                     .documents()
                     .update(document, updateOptions);
-                return { updatedCount: readNumberField({ value: result, key: 'num_updated' }) };
+                return { updatedCount: (0, internal_2.readNumberField)({ value: result, key: 'num_updated' }) };
             },
         });
         return rs;
@@ -747,7 +584,7 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
                     deleteParams['ignore_not_found'] = ignoreNotFound;
                 }
                 const result = await this.client.collections(collection).documents().delete(deleteParams);
-                return readNumberField({ value: result, key: 'num_deleted' });
+                return (0, internal_2.readNumberField)({ value: result, key: 'num_deleted' });
             },
         });
         return rs;
@@ -768,7 +605,7 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
                     .collections(collection)
                     .documents()
                     .delete({ truncate: true });
-                logger.info('Truncated collection | name: %s | deleted: %d', collection, readNumberField({ value: result, key: 'num_deleted' }));
+                logger.info('Truncated collection | name: %s | deleted: %d', collection, (0, internal_2.readNumberField)({ value: result, key: 'num_deleted' }));
                 return true;
             },
         });
@@ -827,8 +664,8 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
         this.assertNonEmpty({ value: collection, name: 'collection', method: this.search.name });
         const logger = this.logger.for(this.search.name);
         const paramsRecord = params;
-        const requested = readRequestedPage(paramsRecord);
-        const windows = requested ? toSearchWindows(requested) : [{ offset: 0, limit: 0 }];
+        const requested = (0, pagination_windows_1.readRequestedPage)(paramsRecord);
+        const windows = requested ? (0, pagination_windows_1.toSearchWindows)(requested) : [{ offset: 0, limit: 0 }];
         if (windows.length > 1 && requested) {
             this.assertSplittablePage({ paramsRecord, requested, windows, collection });
         }
@@ -856,34 +693,34 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
         const results = Array.isArray(response?.results) ? response.results : [];
         const mapped = [];
         for (const entry of results) {
-            const classification = connector_internal_1.TypesenseInternal.classifyEntry({ entry });
+            const classification = internal_2.TypesenseInternal.classifyEntry({ entry });
             switch (classification.kind) {
                 // Preserves the tolerance the GET path had: an unprovisioned collection answers empty with
                 // a warning rather than a 500.
-                case connector_internal_1.EntryOutcomes.MISSING_COLLECTION: {
+                case internal_2.EntryOutcomes.MISSING_COLLECTION: {
                     logger.warn('Search on missing collection, returning empty | name: %s', collection);
-                    return mapSearchResult(buildEmptySearchResponse());
+                    return (0, internal_2.mapSearchResult)((0, pagination_windows_1.buildEmptySearchResponse)());
                 }
                 // A failed entry arrives inside an HTTP 200. Answering empty here would make a rejected
                 // filter indistinguishable from a genuine no-match, and `ISearchResult` has nowhere to put
                 // the error - so this throws rather than returning a plausible zero.
-                case connector_internal_1.EntryOutcomes.FAILED: {
+                case internal_2.EntryOutcomes.FAILED: {
                     throw (0, core_2.getError)({
                         message: `[${TypesenseConnector.name}][search] Engine rejected the search | collection: '${collection}' | code: ${classification.code} | ${classification.message}`,
                     });
                 }
                 // A real result - map it and let the loop collect the remaining windows.
-                case connector_internal_1.EntryOutcomes.OK:
+                case internal_2.EntryOutcomes.OK:
                 default: {
-                    mapped.push(mapSearchResult(entry));
+                    mapped.push((0, internal_2.mapSearchResult)(entry));
                     break;
                 }
             }
         }
         if (mapped.length === 0) {
-            return mapSearchResult(buildEmptySearchResponse());
+            return (0, internal_2.mapSearchResult)((0, pagination_windows_1.buildEmptySearchResponse)());
         }
-        return mergeWindowedResults(mapped);
+        return (0, pagination_windows_1.mergeWindowedResults)(mapped);
     }
     /**
      * Refuses a page that cannot be served honestly, rather than serving part of it.
@@ -902,13 +739,13 @@ class TypesenseConnector extends core_1.BaseSearchConnector {
         if (paramsRecord['group_by'] !== undefined) {
             throw (0, core_2.getError)({
                 error: common_1.SearchErrors.PAGE_TOO_LARGE,
-                message: `[${TypesenseConnector.name}][search] A grouped search cannot be split across pages | collection: '${collection}' | group_by: '${String(paramsRecord['group_by'])}' | requested: ${requested.limit} | maximum: ${MAX_HITS_PER_PAGE}`,
+                message: `[${TypesenseConnector.name}][search] A grouped search cannot be split across pages | collection: '${collection}' | group_by: '${String(paramsRecord['group_by'])}' | requested: ${requested.limit} | maximum: ${pagination_windows_1.MAX_HITS_PER_PAGE}`,
             });
         }
-        if (windows.length > MAX_MULTI_SEARCH_ENTRIES) {
+        if (windows.length > pagination_windows_1.MAX_MULTI_SEARCH_ENTRIES) {
             throw (0, core_2.getError)({
                 error: common_1.SearchErrors.PAGE_TOO_LARGE,
-                message: `[${TypesenseConnector.name}][search] Requested page needs ${windows.length} windows but one multi_search call carries at most ${MAX_MULTI_SEARCH_ENTRIES} | collection: '${collection}' | requested: ${requested.limit} | maximum: ${MAX_MULTI_SEARCH_ENTRIES * MAX_HITS_PER_PAGE}`,
+                message: `[${TypesenseConnector.name}][search] Requested page needs ${windows.length} windows but one multi_search call carries at most ${pagination_windows_1.MAX_MULTI_SEARCH_ENTRIES} | collection: '${collection}' | requested: ${requested.limit} | maximum: ${pagination_windows_1.MAX_MULTI_SEARCH_ENTRIES * pagination_windows_1.MAX_HITS_PER_PAGE}`,
             });
         }
     }