@venizia/ignis 0.0.10-4 → 0.1.0

package/dist/connectors/meilisearch/repositories/dialect/query-dialect.js

@@ -0,0 +1,383 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MeilisearchQueryDialect = void 0;
+const operators_1 = require("../../../../base/repositories/common/operators");
+const common_1 = require("../../../../connectors/search/repositories/common");
+const dialect_helpers_1 = require("../../../../connectors/search/repositories/common/dialect-helpers");
+const ignis_helpers_1 = require("@venizia/ignis-helpers");
+/** `mode: 'semantic'` is pure vector search; Meilisearch expresses that as an all-semantic hybrid. */
+const SEMANTIC_ONLY_RATIO = 1;
+/** Meilisearch's own default blend when the caller gives no `alpha`. */
+const DEFAULT_SEMANTIC_RATIO = 0.5;
+/** Typesense-only tuning knobs. Setting one against Meilisearch is a caller error, never a silent no-op. */
+const UNSUPPORTED_TUNING_KNOBS = [
+    'numTypos',
+    'infix',
+    'useCache',
+    'cacheTtl',
+    'exhaustiveSearch',
+    'pinnedHits',
+    'hiddenHits',
+    'prioritizeExactMatch',
+    'dropTokensThreshold',
+    'preset',
+    'queryByWeights',
+    'prefix',
+];
+/** camelCase `ISearchQuery` field -> Meilisearch wire field. Values only, never identifiers. */
+class SearchWireKeys {
+    static { this.QUERY = { from: 'query', to: 'q' }; }
+    static { this.FILTER_BY = { from: 'filterBy', to: 'filter' }; }
+    static { this.PER_PAGE = { from: 'perPage', to: 'hitsPerPage' }; }
+    static { this.HIGHLIGHT_START_TAG = { from: 'highlightStartTag', to: 'highlightPreTag' }; }
+    static { this.HIGHLIGHT_END_TAG = { from: 'highlightEndTag', to: 'highlightPostTag' }; }
+    static { this.ENTRIES = [
+        SearchWireKeys.QUERY,
+        SearchWireKeys.FILTER_BY,
+        SearchWireKeys.PER_PAGE,
+        SearchWireKeys.HIGHLIGHT_START_TAG,
+        SearchWireKeys.HIGHLIGHT_END_TAG,
+    ]; }
+    /** Resolves a camelCase field to its wire key; unmapped keys (`page`) pass through. */
+    static wireKey(field) {
+        return SearchWireKeys.ENTRIES.find(entry => entry.from === field)?.to ?? field;
+    }
+}
+/** Comma-joined `ISearchQuery` fields Meilisearch expects as arrays, and the wire name of each. */
+const CSV_TO_ARRAY_KEYS = {
+    sortBy: 'sort',
+    includeFields: 'attributesToRetrieve',
+    queryBy: 'attributesToSearchOn',
+    facetBy: 'facets',
+    highlightFields: 'attributesToHighlight',
+    highlightFullFields: 'attributesToCrop',
+};
+/**
+ * `ISearchQuery` fields Meilisearch has no equivalent for. Every one of them THROWS: dropping a
+ * caller's parameter silently, or half-mapping it onto a differently-shaped engine param, produces a
+ * query that quietly does not mean what was asked.
+ */
+const UNSUPPORTED_QUERY_FIELDS = {
+    excludeFields: 'Meilisearch has no exclude-fields param; declare displayedAttributes instead',
+    facetQuery: 'Meilisearch exposes facet search on its own /facet-search route',
+    maxFacetValues: 'Meilisearch sets this via the faceting.maxValuesPerFacet index setting',
+    snippetThreshold: 'Meilisearch uses cropLength instead',
+    // Meilisearch's search param is `distinct` (one attribute name); `distinctAttribute` is an
+    // index-level SETTING, not a search param, and neither expresses grouped hits.
+    groupBy: 'Meilisearch has no result grouping; set the distinct search param on the raw client',
+    groupLimit: 'Meilisearch has no result grouping, so no per-group limit',
+    groupMissingValues: 'Meilisearch has no result grouping, so no missing-values flag',
+    // Rejected here as well as in applySearchInput, so the multiSearch path (which never calls
+    // applySearchInput) cannot forward it to the engine as an unknown param.
+    queryByWeights: 'Meilisearch has no per-field query weights',
+};
+/**
+ * Translates repository-level TFilter/TWhere into Meilisearch search params. Pure string building -
+ * no dependency on the `meilisearch` package. Untranslatable shapes throw rather than degrade.
+ */
+class MeilisearchQueryDialect {
+    build(opts) {
+        const { filter } = opts;
+        // `hiddenFields` is accepted and deliberately NOT translated: Meilisearch has no per-query field
+        // exclusion (only the index-level `displayedAttributes`). Throwing here made every read of a
+        // model with `hiddenProperties` fail - find, findOne, findById, count, search, and the
+        // default-filter guard inside updateById - while writes happily kept working.
+        //
+        // The guarantee is upheld one layer up instead: `SearchBaseRepository` strips hidden fields from
+        // every document it returns, so nothing escapes regardless of index settings.
+        const { where, fields, order, limit, skip, offset, include } = filter ?? {};
+        if (include) {
+            throw (0, ignis_helpers_1.getError)({
+                message: '[MeilisearchQueryDialect][build] search() does not support "include" - relations cannot be translated to a Meilisearch filter',
+            });
+        }
+        const query = { query: '*' };
+        if (where) {
+            const filterBy = this.toWhere({ where });
+            if (filterBy) {
+                query.filterBy = filterBy;
+            }
+        }
+        if (order) {
+            query.sortBy = this.toOrderBy({ order });
+        }
+        if (limit !== undefined) {
+            query.perPage = limit;
+        }
+        const effectiveSkip = skip ?? offset;
+        if (effectiveSkip !== undefined) {
+            query.page = (0, dialect_helpers_1.toSearchPage)({ skip: effectiveSkip, limit });
+        }
+        if (fields) {
+            query.includeFields = (0, dialect_helpers_1.toFieldsCsv)({ fields });
+        }
+        return query;
+    }
+    /**
+     * Maps the neutral query onto Meilisearch's wire params. Pagination always selects the exhaustive
+     * `page`/`hitsPerPage` mode, never `offset`/`limit`, so `totalHits` is exact rather than the
+     * `estimatedTotalHits` the offset mode returns. `engineParams` merges last, verbatim.
+     */
+    toWireParams(opts) {
+        const { query } = opts;
+        const { engineParams, ...rest } = query;
+        const wire = {};
+        for (const [key, value] of Object.entries(rest)) {
+            if (value === undefined) {
+                continue;
+            }
+            const unsupported = UNSUPPORTED_QUERY_FIELDS[key];
+            if (unsupported) {
+                throw (0, ignis_helpers_1.getError)({
+                    message: `[MeilisearchQueryDialect][toWireParams] '${key}' is not supported | ${unsupported}`,
+                });
+            }
+            const arrayKey = CSV_TO_ARRAY_KEYS[key];
+            if (arrayKey) {
+                wire[arrayKey] = String(value).split(',');
+                continue;
+            }
+            wire[SearchWireKeys.wireKey(key)] = value;
+        }
+        return engineParams ? { ...wire, ...engineParams } : wire;
+    }
+    /** Writes the mode dispatch and the hybrid/vector params onto `query`, and refuses any knob Meilisearch cannot honor. */
+    applySearchInput(opts) {
+        const { input } = opts;
+        const searchQuery = opts.query;
+        this.assertNoUnsupportedKnobs({ input });
+        switch (input.mode) {
+            case common_1.SearchModes.KEYWORD: {
+                if (input.query) {
+                    searchQuery.query = input.query;
+                }
+                if (input.queryBy) {
+                    searchQuery.queryBy = input.queryBy.join(',');
+                }
+                break;
+            }
+            case common_1.SearchModes.SEMANTIC: {
+                searchQuery.hybrid = {
+                    semanticRatio: SEMANTIC_ONLY_RATIO,
+                    embedder: input.vectorField,
+                };
+                if (input.nearVector) {
+                    searchQuery.vector = input.nearVector;
+                    break;
+                }
+                if (!input.queryText) {
+                    throw (0, ignis_helpers_1.getError)({
+                        message: `[MeilisearchQueryDialect][applySearchInput] semantic mode requires 'nearVector' or 'queryText'`,
+                    });
+                }
+                // Auto-embed: the engine vectorizes queryText with the named embedder.
+                searchQuery.query = input.queryText;
+                break;
+            }
+            case common_1.SearchModes.HYBRID: {
+                searchQuery.query = input.query;
+                searchQuery.queryBy = input.queryBy.join(',');
+                searchQuery.hybrid = {
+                    semanticRatio: input.alpha ?? DEFAULT_SEMANTIC_RATIO,
+                    embedder: input.vectorField,
+                };
+                if (input.nearVector) {
+                    searchQuery.vector = input.nearVector;
+                }
+                break;
+            }
+            default: {
+                break;
+            }
+        }
+        if (input.facetBy) {
+            searchQuery.facetBy = input.facetBy.join(',');
+        }
+        if (input.highlightFields) {
+            searchQuery.highlightFields = input.highlightFields.join(',');
+        }
+        if (input.highlightStartTag !== undefined) {
+            searchQuery.highlightStartTag = input.highlightStartTag;
+        }
+        if (input.highlightEndTag !== undefined) {
+            searchQuery.highlightEndTag = input.highlightEndTag;
+        }
+        // Engine-specific tuning arrives keyed by Meilisearch's own wire names in engineParams; carried
+        // onto the query here so the single-search path reaches toWireParams' verbatim merge.
+        if (input.engineParams) {
+            searchQuery.engineParams = input.engineParams;
+        }
+    }
+    /** Translates a `TWhere` into a Meilisearch filter expression. Public - reused by updateBy/deleteBy. */
+    toWhere(opts) {
+        const { where } = opts;
+        const clauses = [];
+        for (const key in where) {
+            // TWhere<T = any> is a mapped-over-`any` type with no narrower runtime shape to recover here.
+            const value = where[key];
+            if (value === undefined) {
+                continue;
+            }
+            switch (key) {
+                case operators_1.QueryOperators.AND: {
+                    clauses.push(this.buildLogicalGroup({ value, joiner: ' AND ' }));
+                    break;
+                }
+                case operators_1.QueryOperators.OR: {
+                    clauses.push(this.buildLogicalGroup({ value, joiner: ' OR ' }));
+                    break;
+                }
+                default: {
+                    clauses.push(this.buildFieldClause({ field: key, value }));
+                }
+            }
+        }
+        return clauses.filter(clause => clause.length > 0).join(' AND ');
+    }
+    assertNoUnsupportedKnobs(opts) {
+        const input = opts.input;
+        for (const knob of UNSUPPORTED_TUNING_KNOBS) {
+            if (input[knob] === undefined) {
+                continue;
+            }
+            throw (0, ignis_helpers_1.getError)({
+                message: `[MeilisearchQueryDialect][applySearchInput] '${knob}' is a Typesense-only search parameter and has no Meilisearch equivalent - remove it, or reach the raw client for engine-specific tuning`,
+            });
+        }
+    }
+    toOrderBy(opts) {
+        return opts.order
+            .map(entry => {
+            const [field, direction = 'asc'] = entry.trim().split(/\s+/);
+            const normalizedDirection = direction.toLowerCase();
+            if (normalizedDirection !== 'asc' && normalizedDirection !== 'desc') {
+                throw (0, ignis_helpers_1.getError)({
+                    message: `[MeilisearchQueryDialect][build] Invalid sort direction '${direction}' for field '${field}'`,
+                });
+            }
+            return `${field}:${normalizedDirection}`;
+        })
+            .join(',');
+    }
+    buildLogicalGroup(opts) {
+        const { value, joiner } = opts;
+        const items = Array.isArray(value) ? value : [value];
+        // Empty members (an `{}` merged in by default-filter plumbing) would emit malformed fragments.
+        const sub = items
+            .map(item => this.toWhere({ where: item }))
+            .filter(clause => clause.length > 0);
+        if (sub.length === 0) {
+            return '';
+        }
+        return `(${sub.join(joiner)})`;
+    }
+    buildFieldClause(opts) {
+        const { field, value } = opts;
+        if (field.includes('.')) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[MeilisearchQueryDialect][toWhere] search() does not support JSON-path fields | field: '${field}'`,
+            });
+        }
+        if (Array.isArray(value)) {
+            return `${field} IN [${this.escapeArray({ field, value })}]`;
+        }
+        if (!(0, dialect_helpers_1.isOperatorObject)(value)) {
+            return `${field} = ${this.escapeValue({ field, value })}`;
+        }
+        const clauses = Object.entries(value).map(([operator, operand]) => this.buildOperatorClause({ field, operator, value: operand }));
+        return clauses.length === 1 ? clauses[0] : `(${clauses.join(' AND ')})`;
+    }
+    buildOperatorClause(opts) {
+        const { field, operator, value } = opts;
+        switch (operator) {
+            case operators_1.QueryOperators.EQ:
+            case operators_1.QueryOperators.IS: {
+                return value === null
+                    ? `${field} IS NULL`
+                    : `${field} = ${this.escapeValue({ field, value })}`;
+            }
+            case operators_1.QueryOperators.NEQ:
+            case operators_1.QueryOperators.NE:
+            case operators_1.QueryOperators.IS_NOT: {
+                return value === null
+                    ? `${field} IS NOT NULL`
+                    : `${field} != ${this.escapeValue({ field, value })}`;
+            }
+            case operators_1.QueryOperators.GT: {
+                return `${field} > ${this.escapeValue({ field, value })}`;
+            }
+            case operators_1.QueryOperators.GTE: {
+                return `${field} >= ${this.escapeValue({ field, value })}`;
+            }
+            case operators_1.QueryOperators.LT: {
+                return `${field} < ${this.escapeValue({ field, value })}`;
+            }
+            case operators_1.QueryOperators.LTE: {
+                return `${field} <= ${this.escapeValue({ field, value })}`;
+            }
+            case operators_1.QueryOperators.IN:
+            case operators_1.QueryOperators.INQ: {
+                return `${field} IN [${this.escapeArray({ field, value })}]`;
+            }
+            case operators_1.QueryOperators.NIN: {
+                return `${field} NOT IN [${this.escapeArray({ field, value })}]`;
+            }
+            case operators_1.QueryOperators.BETWEEN: {
+                return `${field} ${this.escapeBetween({ field, value })}`;
+            }
+            case operators_1.QueryOperators.EXISTS: {
+                return value === false ? `${field} NOT EXISTS` : `${field} EXISTS`;
+            }
+            case operators_1.QueryOperators.NOT_EXISTS: {
+                return `${field} NOT EXISTS`;
+            }
+            default: {
+                throw (0, ignis_helpers_1.getError)({
+                    message: `[MeilisearchQueryDialect][toWhere] search() does not support operator '${operator}' | field: '${field}'`,
+                });
+            }
+        }
+    }
+    escapeValue(opts) {
+        const { field, value } = opts;
+        if (typeof value === 'string') {
+            return `'${value.replaceAll('\\', '\\\\').replaceAll("'", "\\'")}'`;
+        }
+        if (typeof value === 'number') {
+            // NaN/Infinity would produce an unparseable filter token instead of a clear rejection.
+            if (!Number.isFinite(value)) {
+                throw (0, ignis_helpers_1.getError)({
+                    message: `[MeilisearchQueryDialect][toWhere] search() does not support non-finite numbers (NaN/Infinity) | field: '${field}' | value: ${value}`,
+                });
+            }
+            return String(value);
+        }
+        if (typeof value === 'boolean') {
+            return String(value);
+        }
+        throw (0, ignis_helpers_1.getError)({
+            message: `[MeilisearchQueryDialect][toWhere] search() does not support this value type | field: '${field}' | value: ${JSON.stringify(value)}`,
+        });
+    }
+    escapeArray(opts) {
+        const { field, value } = opts;
+        if (!Array.isArray(value)) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[MeilisearchQueryDialect][toWhere] search() expected an array value | field: '${field}' | value: ${JSON.stringify(value)}`,
+            });
+        }
+        return value.map(item => this.escapeValue({ field, value: item })).join(', ');
+    }
+    escapeBetween(opts) {
+        const { field, value } = opts;
+        if (!Array.isArray(value) || value.length !== 2) {
+            throw (0, ignis_helpers_1.getError)({
+                message: `[MeilisearchQueryDialect][toWhere] search() 'between' requires a [min, max] tuple | field: '${field}' | value: ${JSON.stringify(value)}`,
+            });
+        }
+        const [min, max] = value;
+        return `${this.escapeValue({ field, value: min })} TO ${this.escapeValue({ field, value: max })}`;
+    }
+}
+exports.MeilisearchQueryDialect = MeilisearchQueryDialect;
+//# sourceMappingURL=query-dialect.js.map

package/dist/connectors/meilisearch/repositories/dialect/query-dialect.js.map

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

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

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

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

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

package/dist/connectors/meilisearch/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("./dialect"), exports);
+//# sourceMappingURL=index.js.map

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

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

package/dist/connectors/meilisearch/types.d.ts

@@ -0,0 +1,45 @@
+import type { TConstValue } from '@venizia/ignis-helpers';
+/** Meilisearch task lifecycle. Every write returns a task uid and is invisible to search until SUCCEEDED. */
+export declare class MeilisearchTaskStatuses {
+    static readonly ENQUEUED = "enqueued";
+    static readonly PROCESSING = "processing";
+    static readonly SUCCEEDED = "succeeded";
+    static readonly FAILED = "failed";
+    static readonly CANCELED = "canceled";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(value: string): value is TMeilisearchTaskStatus;
+    static isTerminal(value: string): boolean;
+}
+export type TMeilisearchTaskStatus = TConstValue<typeof MeilisearchTaskStatuses>;
+/** Page size used when walking `documents/fetch` for ids during an emulated update-by-filter. */
+export declare const MEILISEARCH_DEFAULT_FETCH_PAGE_SIZE = 1000;
+/** Documents per merge-PUT batch. Bounded by the server's payload limit, not by a document count. */
+export declare const MEILISEARCH_DEFAULT_UPDATE_BATCH_SIZE = 1000;
+export interface IMeilisearchConnectorOptions {
+    name: string;
+    host: string;
+    apiKey?: string;
+    /**
+     * Ceiling for awaiting a write task. The `meilisearch` SDK's own `waitForTask` defaults to 5000 ms,
+     * far too short for a bulk import, so this connector never relies on that default.
+     */
+    taskTimeoutMs?: number;
+    /** Poll interval while awaiting a task. */
+    taskIntervalMs?: number;
+    scope?: string;
+    identifier?: string;
+    onInitialized?: (opts: {
+        name: string;
+    }) => void;
+    onError?: (opts: {
+        name: string;
+        error: unknown;
+    }) => void;
+}
+export interface IMeilisearchDataSourceSettings {
+    host: string;
+    apiKey?: string;
+    taskTimeoutMs?: number;
+    taskIntervalMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/connectors/meilisearch/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/connectors/meilisearch/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AAE1D,6GAA6G;AAC7G,qBAAa,uBAAuB;IAClC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,UAAU,gBAAgB;IAC1C,MAAM,CAAC,QAAQ,CAAC,SAAS,eAAe;IACxC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IAEtC,MAAM,CAAC,QAAQ,CAAC,UAAU,cAMvB;IAEH,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,sBAAsB;IAI9D,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAG1C;AAED,MAAM,MAAM,sBAAsB,GAAG,WAAW,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAEjF,iGAAiG;AACjG,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAExD,qGAAqG;AACrG,eAAO,MAAM,qCAAqC,OAAO,CAAC;AAE1D,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;IACjD,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;CAC5D;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}

package/dist/connectors/meilisearch/types.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MEILISEARCH_DEFAULT_UPDATE_BATCH_SIZE = exports.MEILISEARCH_DEFAULT_FETCH_PAGE_SIZE = exports.MeilisearchTaskStatuses = void 0;
+/** Meilisearch task lifecycle. Every write returns a task uid and is invisible to search until SUCCEEDED. */
+class MeilisearchTaskStatuses {
+    static { this.ENQUEUED = 'enqueued'; }
+    static { this.PROCESSING = 'processing'; }
+    static { this.SUCCEEDED = 'succeeded'; }
+    static { this.FAILED = 'failed'; }
+    static { this.CANCELED = 'canceled'; }
+    static { this.SCHEME_SET = new Set([
+        this.ENQUEUED,
+        this.PROCESSING,
+        this.SUCCEEDED,
+        this.FAILED,
+        this.CANCELED,
+    ]); }
+    static isValid(value) {
+        return this.SCHEME_SET.has(value);
+    }
+    static isTerminal(value) {
+        return value === this.SUCCEEDED || value === this.FAILED || value === this.CANCELED;
+    }
+}
+exports.MeilisearchTaskStatuses = MeilisearchTaskStatuses;
+/** Page size used when walking `documents/fetch` for ids during an emulated update-by-filter. */
+exports.MEILISEARCH_DEFAULT_FETCH_PAGE_SIZE = 1000;
+/** Documents per merge-PUT batch. Bounded by the server's payload limit, not by a document count. */
+exports.MEILISEARCH_DEFAULT_UPDATE_BATCH_SIZE = 1000;
+//# sourceMappingURL=types.js.map

package/dist/connectors/meilisearch/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/connectors/meilisearch/types.ts"],"names":[],"mappings":";;;AAEA,6GAA6G;AAC7G,MAAa,uBAAuB;aAClB,aAAQ,GAAG,UAAU,CAAC;aACtB,eAAU,GAAG,YAAY,CAAC;aAC1B,cAAS,GAAG,WAAW,CAAC;aACxB,WAAM,GAAG,QAAQ,CAAC;aAClB,aAAQ,GAAG,UAAU,CAAC;aAEtB,eAAU,GAAG,IAAI,GAAG,CAAS;QAC3C,IAAI,CAAC,QAAQ;QACb,IAAI,CAAC,UAAU;QACf,IAAI,CAAC,SAAS;QACd,IAAI,CAAC,MAAM;QACX,IAAI,CAAC,QAAQ;KACd,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,CAAC,KAAa;QAC1B,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,KAAa;QAC7B,OAAO,KAAK,KAAK,IAAI,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,MAAM,IAAI,KAAK,KAAK,IAAI,CAAC,QAAQ,CAAC;IACtF,CAAC;;AArBH,0DAsBC;AAID,iGAAiG;AACpF,QAAA,mCAAmC,GAAG,IAAI,CAAC;AAExD,qGAAqG;AACxF,QAAA,qCAAqC,GAAG,IAAI,CAAC"}

package/dist/connectors/postgres/datasources/abstract.d.ts

@@ -1,22 +1,51 @@
-import { ValueOrPromise } from '@venizia/ignis-helpers';
-import { Pool } from 'pg';
-import { AbstractDataSource, TAnyDataSourceSchema } from '../../../base/datasources';
+import type { TAnyDataSourceSchema } from '../../../base/datasources';
+import { AbstractDataSource } from '../../../base/datasources';
+import type { IRelationalDriver } from '../../../connectors/postgres/drivers';
 import type { IRelationalQueryDialect } from '../../../connectors/postgres/repositories/common';
-import { IPostgresDataSource, IDatabaseTransaction, IDatabaseTransactionOptions, TNodePostgresConnector } from './common';
+import type { ValueOrPromise } from '@venizia/ignis-helpers';
+import type { Pool } from 'pg';
+import type { IDatabaseTransaction, IDatabaseTransactionOptions, IPostgresDataSource, TRelationalConnector } from './common';
 /** SQL branch root: connector, pool, transactions. */
-export declare abstract class AbstractRelationalDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> implements IPostgresDataSource<Settings, Schema, ConfigurableOptions> {
-    connector: TNodePostgresConnector<Schema>;
-    protected pool: Pool;
-    /** Shared across every relational datasource - FilterBuilder is stateless (its only field is a
-     * logger scope). Unlike the search branch's eager `static readonly`, this is assigned lazily on
-     * first use: an eager static initializer would run at module load, when the FilterBuilder ->
-     * repositories/common -> datasources cycle leaves the binding half-initialized (TDZ). */
+export declare abstract class AbstractRelationalDataSource<Settings extends object = {}, Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema, ConfigurableOptions extends object = {}, Client = Pool> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> implements IPostgresDataSource<Settings, Schema, ConfigurableOptions, Client> {
+    connector: TRelationalConnector<Schema>;
+    /**
+     * The raw driver client a pool-only datasource was configured with: a `pg.Pool`, a postgres-js
+     * `Sql`. Genuinely absent once `configure()` wires a driver instead - every reader guards.
+     */
+    protected client?: Client;
+    /** Owns connection acquisition and the raw control statements. Assign in `configure()`. */
+    protected driver?: IRelationalDriver<Schema>;
     private static queryDialect?;
+    private driverResolution?;
+    /**
+     * Adopts a pool-only datasource (no `this.driver` set) into whichever driver matches its client,
+     * once. No warning is logged: the adoption is exact, and a boot-time warning on every legacy
+     * datasource would be noise, not information.
+     *
+     * Async because the concrete driver is imported on demand - see `resolveDatabaseDriver`. The
+     * in-flight promise is cached, not just its result, so concurrent `beginTransaction()` calls
+     * share one driver over one pool instead of each constructing their own.
+     */
+    protected resolveDriver(): Promise<IRelationalDriver<Schema>>;
+    /**
+     * Wires a driver in one step: assigns `this.driver` AND builds `this.connector` from it. The
+     * two-step form (driver set, connector forgotten) yields a datasource whose pooled queries
+     * silently bypass the driver - this helper makes that state unrepresentable. `schema` defaults to
+     * `getSchema()`; pass it explicitly when configure() computes the schema locally.
+     */
+    protected useDriver(opts: {
+        driver: IRelationalDriver<Schema>;
+        schema?: Schema;
+    }): void;
     abstract getConnectionString(): ValueOrPromise<string>;
     abstract beginTransaction(opts?: IDatabaseTransactionOptions): Promise<IDatabaseTransaction<Schema>>;
-    getConnector(): TNodePostgresConnector<Schema>;
-    /** The relational query dialect (FilterBuilder), obtained by repositories via the datasource -
-     * mirrors the search branch's `getQueryDialect()`. Returns the shared singleton. */
+    getConnector(): TRelationalConnector<Schema>;
+    /**
+     * The raw driver client: `pg.Pool` for node-postgres, `Sql` for postgres-js. Stays synchronous by
+     * reading the configured client directly when no driver has been resolved yet - for a bare client
+     * there is nothing to await. Throws rather than handing back an `undefined` typed as `Client`.
+     */
+    getClient(): Client;
     getQueryDialect(): IRelationalQueryDialect;
 }
 //# sourceMappingURL=abstract.d.ts.map

package/dist/connectors/postgres/datasources/abstract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC1B,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAK9E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AACzF,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,UAAU,CAAC;AAElB,sDAAsD;AACtD,8BAAsB,4BAA4B,CAChD,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,CAEvC,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAChE,YAAW,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAAC;IAErE,SAAS,EAAE,sBAAsB,CAAC,MAAM,CAAC,CAAC;IAE1C,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC;IAErB;;;6FAGyF;IACzF,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAA0B;IAEtD,QAAQ,CAAC,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC;aACpC,gBAAgB,CAChC,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAExC,YAAY;IAIZ;wFACoF;IACpF,eAAe,IAAI,uBAAuB;CAO3C"}
+{"version":3,"file":"abstract.d.ts","sourceRoot":"","sources":["../../../../src/connectors/postgres/datasources/abstract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEvE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,2CAA2C,CAAC;AAEzF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAC/B,OAAO,KAAK,EACV,oBAAoB,EACpB,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,EACrB,MAAM,UAAU,CAAC;AAElB,sDAAsD;AACtD,8BAAsB,4BAA4B,CAChD,QAAQ,SAAS,MAAM,GAAG,EAAE,EAC5B,MAAM,SAAS,oBAAoB,GAAG,oBAAoB,EAC1D,mBAAmB,SAAS,MAAM,GAAG,EAAE,EACvC,MAAM,GAAG,IAAI,CAEb,SAAQ,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,CAChE,YAAW,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,CAAC;IAE7E,SAAS,EAAE,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAExC;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAE1B,2FAA2F;IAC3F,SAAS,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAE7C,OAAO,CAAC,MAAM,CAAC,YAAY,CAAC,CAA0B;IAEtD,OAAO,CAAC,gBAAgB,CAAC,CAAqC;IAE9D;;;;;;;;OAQG;cACa,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;IA6BnE;;;;;OAKG;IACH,SAAS,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAKvF,QAAQ,CAAC,mBAAmB,IAAI,cAAc,CAAC,MAAM,CAAC;aACpC,gBAAgB,CAChC,IAAI,CAAC,EAAE,2BAA2B,GACjC,OAAO,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;IAExC,YAAY;IAIZ;;;;OAIG;IACH,SAAS,IAAI,MAAM;IAcnB,eAAe,IAAI,uBAAuB;CAK3C"}