@venizia/ignis-connectors 0.2.0-0

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

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

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

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

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

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

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

@@ -0,0 +1,152 @@
+import type { TNullable } from '@venizia/ignis-helpers/common';
+import type { IExtraOptions, TCount, TDataWithRange, TFilter, TFindOneOptions, TFindOptions, TFindRangeOptions, TWhere } from '@venizia/ignis-kernel';
+import type { IdType } from '@venizia/ignis-kernel';
+import type { ISearchResult } from '../../../../search/core';
+import type { TSearchInput } from '../../../../search/core/repositories/common';
+import { SearchModes } from '../../../../search/core/repositories/common';
+import type { AbstractSearchDataSource } from '../../../../search/core/datasources';
+import { SearchBaseRepository } from './base';
+/** The inputs the dialect translates - `raw` has already returned by the time these are resolved, and `applySearchInput` accepts only this narrowed union. */
+type TTranslatableSearchInput = Exclude<TSearchInput, {
+    mode: typeof SearchModes.RAW;
+}>;
+/** Read-only search-repository tier - translates filters via the datasource's dialect and executes through the connector. */
+export declare class ReadableSearchRepository<TDocument extends object = object, TDataSource extends AbstractSearchDataSource = AbstractSearchDataSource> extends SearchBaseRepository<TDocument, TDataSource> {
+    count(opts: {
+        where: TWhere;
+        options?: IExtraOptions;
+    }): Promise<TCount>;
+    existsWith(opts: {
+        where: TWhere;
+        options?: IExtraOptions;
+    }): Promise<boolean>;
+    find<R = TDocument>(opts: {
+        filter: TFilter;
+        options: TFindRangeOptions<IExtraOptions, R>;
+    }): Promise<TDataWithRange<R>>;
+    find<R = TDocument>(opts: {
+        filter: TFilter;
+        options?: TFindOptions<IExtraOptions, R>;
+    }): Promise<Array<R>>;
+    findOne<R = TDocument>(opts: {
+        filter: TFilter;
+        options?: TFindOneOptions<IExtraOptions, R>;
+    }): Promise<TNullable<R>>;
+    /**
+     * Delegates to findOne with id in where - routing through buildQuery is what makes
+     * hiddenFields/defaultFilter apply, so a soft-deleted document resolves to null. `where` is spread
+     * away last so a projection can never widen the id lookup.
+     */
+    findById<R = TDocument>(opts: {
+        id: IdType;
+        filter?: Omit<TFilter, 'where'>;
+        options?: TFindOneOptions<IExtraOptions, R>;
+    }): Promise<TNullable<R>>;
+    /**
+     * Unified search entry discriminated by `mode`: `raw` is a full passthrough - no dialect, no
+     * defaultFilter, no hiddenFields - while keyword/semantic/hybrid translate through the dialect
+     * like `find()`. Nothing engine-specific lives here; `ISearchQueryDialect.applySearchInput`
+     * owns it.
+     */
+    search<R extends object = TDocument>(opts: TSearchInput & {
+        options?: IExtraOptions;
+    }): Promise<ISearchResult<R>>;
+    protected withDefaultQueryBy(opts: {
+        input: TTranslatableSearchInput;
+    }): TTranslatableSearchInput;
+    /** @throws Error - disabled in a read-only repository; unlocked progressively by Persistable/DefaultSearchRepository. */
+    create(opts: {
+        data: TDocument;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    create<R = TDocument>(opts: {
+        data: TDocument;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    /** @throws Error - disabled in a read-only repository. */
+    createAll(opts: {
+        data: Array<TDocument>;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    createAll<R = TDocument>(opts: {
+        data: Array<TDocument>;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: Array<R>;
+    }>;
+    /** @throws Error - disabled in a read-only repository. */
+    updateById(opts: {
+        id: IdType;
+        data: Partial<TDocument>;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    updateById<R = TDocument>(opts: {
+        id: IdType;
+        data: Partial<TDocument>;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    /**
+     * @throws Error - disabled in a read-only repository. `where` is optional where the base contract
+     * requires it: the `@model` defaultFilter alone can supply the effective filter, and Persistable
+     * refuses the write outright when neither is present.
+     */
+    updateAll(_opts: {
+        data: Partial<TDocument>;
+        where?: TWhere;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: null;
+    }>;
+    /** @throws Error - disabled in a read-only repository. */
+    deleteById(opts: {
+        id: IdType;
+        options: IExtraOptions & {
+            shouldReturn: false;
+        };
+    }): Promise<TCount & {
+        data: undefined | null;
+    }>;
+    deleteById<R = TDocument>(opts: {
+        id: IdType;
+        options?: IExtraOptions & {
+            shouldReturn?: true;
+        };
+    }): Promise<TCount & {
+        data: R;
+    }>;
+    /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */
+    deleteAll(_opts?: {
+        where?: TWhere;
+        options?: Omit<IExtraOptions, 'shouldReturn'> & {
+            force?: boolean;
+        };
+    }): Promise<TCount & {
+        data: null;
+    }>;
+}
+export {};
+//# sourceMappingURL=readable.d.ts.map

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

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

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

@@ -0,0 +1,185 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ReadableSearchRepository = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const common_1 = require("../../../../search/core/repositories/common");
+const base_1 = require("./base");
+/** The match-everything term. `build()` already seeds `query` with it, so a filter-only listing reaches the engine as `q: '*'` - naming fields for a term that ignores fields would mean nothing. */
+const WILDCARD_QUERY = '*';
+/** 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,
+        });
+        // An absorbing where counts zero by definition. Asking the engine would mean sending NO
+        // filterBy at all, which counts the entire collection.
+        if (query.matchNone) {
+            return { count: 0 };
+        }
+        // Counted through the document endpoint, never search: an engine whose search total is capped
+        // or estimated would 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 returns
+     * `found` in the same call as `hits`, so unlike SQL no second count query is needed.
+     */
+    async find(opts) {
+        const { filter, options } = opts;
+        if (options?.retry) {
+            return options.shouldQueryRange === true
+                ? this.findRangeUntil({ filter, options })
+                : this.findUntil({ filter, options });
+        }
+        this.assertNoTransaction(options);
+        this.assertNoLock(options);
+        // An omitted limit falls back to @model settings.defaultLimit then DEFAULT_LIMIT - leaving
+        // `per_page` unset would be an unbounded query.
+        const effectiveFilter = {
+            ...filter,
+            limit: filter?.limit ?? this.defaultLimit ?? ignis_kernel_1.DEFAULT_LIMIT,
+        };
+        const query = this.buildQuery({
+            filter: effectiveFilter,
+            shouldSkipDefaultFilter: options?.shouldSkipDefaultFilter,
+        });
+        // No round-trip for an absorbing where: with no filterBy the engine would happily return the
+        // whole collection, which is the opposite of what the filter asked for.
+        const result = query.matchNone
+            ? { hits: [], found: 0 }
+            : await this.connector.search({
+                collection: this.collectionName,
+                params: this.queryDialect.toWireParams({ query }),
+            });
+        const { hits, found } = result;
+        // The cast is the caller's own unchecked assertion when they pass an explicit `find<Other>()`.
+        // Hidden fields are stripped in JS too, not only engine-side: Typesense honours
+        // `exclude_fields`, Meilisearch has no per-query exclusion at all.
+        const data = this.omitHiddenFieldsAll((hits ?? []).map(hit => hit.document));
+        if (!options?.shouldQueryRange) {
+            return data;
+        }
+        return {
+            data,
+            range: (0, ignis_kernel_1.buildDataRange)({
+                skip: effectiveFilter.skip,
+                offset: effectiveFilter.offset,
+                dataLength: data.length,
+                total: found,
+            }),
+        };
+    }
+    async findOne(opts) {
+        const { filter, options } = opts;
+        if (options?.retry) {
+            return this.findOneUntil({ filter, options });
+        }
+        // `retry` is handled above so it is absent here; TFindOneOptions's retry generic (TNullable<R>)
+        // does not unify with find's own (Array<R>), hence the options-only cast.
+        const results = await this.find({
+            filter: { ...filter, limit: 1 },
+            options: options,
+        });
+        return results[0] ?? null;
+    }
+    /**
+     * Delegates to findOne with id in where - routing through buildQuery is what makes
+     * hiddenFields/defaultFilter apply, so a soft-deleted document resolves to null. `where` is spread
+     * away last so a projection can never widen the id lookup.
+     */
+    findById(opts) {
+        const { id, filter, options } = opts;
+        return this.findOne({ filter: { ...filter, where: { id } }, options });
+    }
+    /**
+     * Unified search entry discriminated by `mode`: `raw` is a full passthrough - no dialect, no
+     * defaultFilter, no hiddenFields - while keyword/semantic/hybrid translate through the dialect
+     * like `find()`. Nothing engine-specific lives here; `ISearchQueryDialect.applySearchInput`
+     * owns it.
+     */
+    async search(opts) {
+        if (opts.mode === common_1.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: this.withDefaultQueryBy({ input: opts }) });
+        // Same short-circuit as find(): an absorbing filter cannot be expressed to the engine, and
+        // omitting it would search everything.
+        // `isFoundExact` is true because zero is not an estimate - nothing was searched to approximate.
+        if (query.matchNone) {
+            return { hits: [], found: 0, isFoundExact: true };
+        }
+        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),
+            })),
+        };
+    }
+    withDefaultQueryBy(opts) {
+        const { input } = opts;
+        if (input.mode !== common_1.SearchModes.KEYWORD || input.queryBy) {
+            return input;
+        }
+        const term = input.query?.trim();
+        if (!term || term === WILDCARD_QUERY) {
+            return input;
+        }
+        const defaultQueryBy = this.entity?.schema?.defaultQueryBy;
+        if (!defaultQueryBy || defaultQueryBy.length === 0) {
+            return input;
+        }
+        return { ...input, queryBy: [...defaultQueryBy] };
+    }
+    create(_opts) {
+        return this.denyOperation({ methodName: this.create.name });
+    }
+    createAll(_opts) {
+        return this.denyOperation({ methodName: this.createAll.name });
+    }
+    updateById(_opts) {
+        return this.denyOperation({ methodName: this.updateById.name });
+    }
+    /**
+     * @throws Error - disabled in a read-only repository. `where` is optional where the base contract
+     * requires it: the `@model` defaultFilter alone can supply the effective filter, and Persistable
+     * refuses the write outright when neither is present.
+     */
+    updateAll(_opts) {
+        return this.denyOperation({ methodName: this.updateAll.name });
+    }
+    deleteById(_opts) {
+        return this.denyOperation({ methodName: this.deleteById.name });
+    }
+    /** @throws Error - disabled in a read-only repository. Unlocked by DefaultSearchRepository. */
+    deleteAll(_opts) {
+        return this.denyOperation({ methodName: this.deleteAll.name });
+    }
+}
+exports.ReadableSearchRepository = ReadableSearchRepository;
+//# sourceMappingURL=readable.js.map

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

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

package/dist/cjs/search/core/repositories/index.d.ts

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

package/dist/cjs/search/core/repositories/index.d.ts.map

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

package/dist/cjs/search/core/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/cjs/search/core/repositories/index.js.map

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

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

@@ -0,0 +1,12 @@
+import type { ISearchCollectionDefinition } from '../../search/core/models';
+/** Meilisearch is schemaless: a collection compiles to an index uid plus settings, not a field schema; the DSL's `searchable`/`filterable` flags are load-bearing here (Typesense drops them). */
+export interface IMeilisearchIndexPlan {
+    uid: string;
+    primaryKey?: string;
+    settings: Record<string, unknown>;
+}
+/** Compiles the neutral collection DSL into a Meilisearch index plan. */
+export declare const compileMeilisearchCollection: (opts: {
+    definition: ISearchCollectionDefinition;
+}) => IMeilisearchIndexPlan;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/cjs/search/meilisearch/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../../../src/search/meilisearch/compiler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,2BAA2B,EAI5B,MAAM,sBAAsB,CAAC;AAU9B,kMAAkM;AAClM,MAAM,WAAW,qBAAqB;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAkFD,yEAAyE;AACzE,eAAO,MAAM,4BAA4B,GAAI,MAAM;IACjD,UAAU,EAAE,2BAA2B,CAAC;CACzC,KAAG,qBAoEH,CAAC"}