@venizia/ignis-connectors 0.2.0-0

package/dist/cjs/search/core/repositories/common/constants.d.ts

@@ -0,0 +1,165 @@
+import { z } from '@hono/zod-openapi';
+import type { TConstValue } from '@venizia/ignis-helpers/common';
+import type { ISearchQuery } from './types';
+/** Discriminant values for `TSearchInput.mode` - which search strategy `ReadableSearchRepository.search()` runs. */
+export declare class SearchModes {
+    static readonly KEYWORD = "keyword";
+    static readonly SEMANTIC = "semantic";
+    static readonly HYBRID = "hybrid";
+    static readonly RAW = "raw";
+    static readonly SCHEME_SET: Set<string>;
+    static isValid(input: string): input is TSearchMode;
+}
+export type TSearchMode = TConstValue<typeof SearchModes>;
+export declare const SearchInputSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    facetBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    facetQuery: z.ZodOptional<z.ZodString>;
+    maxFacetValues: z.ZodOptional<z.ZodNumber>;
+    highlightFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightFullFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightStartTag: z.ZodOptional<z.ZodString>;
+    highlightEndTag: z.ZodOptional<z.ZodString>;
+    snippetThreshold: z.ZodOptional<z.ZodNumber>;
+    groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    groupLimit: z.ZodOptional<z.ZodNumber>;
+    groupMissingValues: z.ZodOptional<z.ZodBoolean>;
+    queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    mode: z.ZodLiteral<"keyword">;
+    query: z.ZodOptional<z.ZodString>;
+    queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    filter: z.ZodOptional<z.ZodObject<{
+        where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+        fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
+        order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        skip: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    distanceThreshold: z.ZodOptional<z.ZodNumber>;
+    ef: z.ZodOptional<z.ZodNumber>;
+    facetBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    facetQuery: z.ZodOptional<z.ZodString>;
+    maxFacetValues: z.ZodOptional<z.ZodNumber>;
+    highlightFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightFullFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightStartTag: z.ZodOptional<z.ZodString>;
+    highlightEndTag: z.ZodOptional<z.ZodString>;
+    snippetThreshold: z.ZodOptional<z.ZodNumber>;
+    groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    groupLimit: z.ZodOptional<z.ZodNumber>;
+    groupMissingValues: z.ZodOptional<z.ZodBoolean>;
+    queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    mode: z.ZodLiteral<"semantic">;
+    vectorField: z.ZodString;
+    nearVector: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    queryText: z.ZodOptional<z.ZodString>;
+    k: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodObject<{
+        where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+        fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
+        order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        skip: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    distanceThreshold: z.ZodOptional<z.ZodNumber>;
+    ef: z.ZodOptional<z.ZodNumber>;
+    facetBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    facetQuery: z.ZodOptional<z.ZodString>;
+    maxFacetValues: z.ZodOptional<z.ZodNumber>;
+    highlightFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightFullFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightStartTag: z.ZodOptional<z.ZodString>;
+    highlightEndTag: z.ZodOptional<z.ZodString>;
+    snippetThreshold: z.ZodOptional<z.ZodNumber>;
+    groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    groupLimit: z.ZodOptional<z.ZodNumber>;
+    groupMissingValues: z.ZodOptional<z.ZodBoolean>;
+    queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    mode: z.ZodLiteral<"hybrid">;
+    query: z.ZodString;
+    queryBy: z.ZodArray<z.ZodString>;
+    vectorField: z.ZodString;
+    nearVector: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    alpha: z.ZodOptional<z.ZodNumber>;
+    k: z.ZodOptional<z.ZodNumber>;
+    filter: z.ZodOptional<z.ZodObject<{
+        where: z.ZodOptional<z.ZodUnion<readonly [z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>, z.ZodPipe<z.ZodPipe<z.ZodString, z.ZodTransform<any, string>>, z.ZodType<any, unknown, z.core.$ZodTypeInternals<any, unknown>>>]>>;
+        fields: z.ZodOptional<z.ZodUnion<[z.ZodRecord<z.ZodString, z.ZodBoolean>, z.ZodArray<z.ZodString>]>>;
+        order: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        limit: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        skip: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodObject<{
+    mode: z.ZodLiteral<"raw">;
+    params: z.ZodRecord<z.ZodString, z.ZodAny>;
+}, z.core.$strip>], "mode">;
+export type TSearchInput = z.infer<typeof SearchInputSchema>;
+/** One collection's query within a multi-search - same friendly field names as `search()`. `filterBy` is a raw engine filter string because cross-collection search has no per-collection model to translate a `TFilter` against; the datasource maps entries to wire form via the dialect. */
+export declare const MultiSearchEntrySchema: z.ZodObject<{
+    facetBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    facetQuery: z.ZodOptional<z.ZodString>;
+    maxFacetValues: z.ZodOptional<z.ZodNumber>;
+    highlightFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightFullFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    highlightStartTag: z.ZodOptional<z.ZodString>;
+    highlightEndTag: z.ZodOptional<z.ZodString>;
+    snippetThreshold: z.ZodOptional<z.ZodNumber>;
+    groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    groupLimit: z.ZodOptional<z.ZodNumber>;
+    groupMissingValues: z.ZodOptional<z.ZodBoolean>;
+    queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+    engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    collection: z.ZodString;
+    query: z.ZodOptional<z.ZodString>;
+    queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    filterBy: z.ZodOptional<z.ZodString>;
+    sortBy: z.ZodOptional<z.ZodString>;
+    page: z.ZodOptional<z.ZodNumber>;
+    perPage: z.ZodOptional<z.ZodNumber>;
+    offset: z.ZodOptional<z.ZodNumber>;
+    includeFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    excludeFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    vectorQuery: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type TMultiSearchEntry = z.infer<typeof MultiSearchEntrySchema>;
+/** Friendly multi-search params -> `ISearchQuery`: list fields comma-joined, the rest pass through; keeps `search()`, `multiSearch()` and `commonParams` on one friendly-to-wire path. */
+export declare const toSearchQueryParams: (input: Record<string, unknown>) => Partial<ISearchQuery>;
+/** Cross-collection multi-search input: friendly `searches` entries plus the union flag. */
+export declare const MultiSearchInputSchema: z.ZodObject<{
+    searches: z.ZodArray<z.ZodObject<{
+        facetBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        facetQuery: z.ZodOptional<z.ZodString>;
+        maxFacetValues: z.ZodOptional<z.ZodNumber>;
+        highlightFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        highlightFullFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        highlightStartTag: z.ZodOptional<z.ZodString>;
+        highlightEndTag: z.ZodOptional<z.ZodString>;
+        snippetThreshold: z.ZodOptional<z.ZodNumber>;
+        groupBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        groupLimit: z.ZodOptional<z.ZodNumber>;
+        groupMissingValues: z.ZodOptional<z.ZodBoolean>;
+        queryByWeights: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+        engineParams: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        collection: z.ZodString;
+        query: z.ZodOptional<z.ZodString>;
+        queryBy: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        filterBy: z.ZodOptional<z.ZodString>;
+        sortBy: z.ZodOptional<z.ZodString>;
+        page: z.ZodOptional<z.ZodNumber>;
+        perPage: z.ZodOptional<z.ZodNumber>;
+        offset: z.ZodOptional<z.ZodNumber>;
+        includeFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        excludeFields: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        vectorQuery: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    union: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+export type TMultiSearchInput = z.infer<typeof MultiSearchInputSchema>;
+//# sourceMappingURL=constants.d.ts.map

package/dist/cjs/search/core/repositories/common/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/constants.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,mBAAmB,CAAC;AACtC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,oHAAoH;AACpH,qBAAa,WAAW;IACtB,MAAM,CAAC,QAAQ,CAAC,OAAO,aAAa;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,cAAc;IACtC,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY;IAClC,MAAM,CAAC,QAAQ,CAAC,GAAG,SAAS;IAE5B,MAAM,CAAC,QAAQ,CAAC,UAAU,cAAiE;IAE3F,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW;CAGpD;AACD,MAAM,MAAM,WAAW,GAAG,WAAW,CAAC,OAAO,WAAW,CAAC,CAAC;AAuF1D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2BAK5B,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE7D,+RAA+R;AAC/R,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;iBAe2C,CAAC;AAC/E,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC;AAcvE,0LAA0L;AAC1L,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,OAAO,CAAC,YAAY,CAaxF,CAAC;AAEF,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAO/B,CAAC;AACL,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}

package/dist/cjs/search/core/repositories/common/constants.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiSearchInputSchema = exports.toSearchQueryParams = exports.MultiSearchEntrySchema = exports.SearchInputSchema = exports.SearchModes = void 0;
+const ignis_kernel_1 = require("@venizia/ignis-kernel");
+const zod_openapi_1 = require("@hono/zod-openapi");
+/** Discriminant values for `TSearchInput.mode` - which search strategy `ReadableSearchRepository.search()` runs. */
+class SearchModes {
+    static { this.KEYWORD = 'keyword'; }
+    static { this.SEMANTIC = 'semantic'; }
+    static { this.HYBRID = 'hybrid'; }
+    static { this.RAW = 'raw'; }
+    static { this.SCHEME_SET = new Set([this.KEYWORD, this.SEMANTIC, this.HYBRID, this.RAW]); }
+    static isValid(input) {
+        return this.SCHEME_SET.has(input);
+    }
+}
+exports.SearchModes = SearchModes;
+/** Reassembled from FilterSchema's atomic pieces minus `include` (search has no relations) so `z.infer` stays finite - embedding the recursive FilterSchema collapses optional-key inference for every sibling field, silently turning `filter` into a required `any`. */
+const SearchFilterSchema = zod_openapi_1.z
+    .object({
+    where: ignis_kernel_1.WhereSchema.optional(),
+    fields: ignis_kernel_1.FieldsSchema,
+    order: ignis_kernel_1.OrderBySchema,
+    limit: ignis_kernel_1.LimitSchema,
+    offset: ignis_kernel_1.OffsetSchema,
+    skip: ignis_kernel_1.SkipSchema,
+})
+    .optional()
+    .openapi({
+    description: 'Search-scoped filter - same shape as the repository TFilter minus include (search has no relations)',
+});
+/** Shape object (NOT a z.object) so it spreads into each mode's z.object; `raw` mode skips it. Only cross-engine params live here - engine-specific tuning goes through `engineParams`. */
+const commonSearchParamsShape = {
+    facetBy: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    facetQuery: zod_openapi_1.z.string().optional(),
+    maxFacetValues: zod_openapi_1.z.number().optional(),
+    highlightFields: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    highlightFullFields: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    highlightStartTag: zod_openapi_1.z.string().optional(),
+    highlightEndTag: zod_openapi_1.z.string().optional(),
+    snippetThreshold: zod_openapi_1.z.number().optional(),
+    groupBy: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    groupLimit: zod_openapi_1.z.number().optional(),
+    groupMissingValues: zod_openapi_1.z.boolean().optional(),
+    queryByWeights: zod_openapi_1.z.array(zod_openapi_1.z.number()).optional(),
+    /** Escape hatch for engine-specific tuning: keys are the engine's OWN wire names (`num_typos`, not `numTypos`), merged verbatim and unvalidated after every neutral param. */
+    engineParams: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.unknown()).optional(),
+};
+const KeywordSearchSchema = zod_openapi_1.z
+    .object({
+    mode: zod_openapi_1.z.literal(SearchModes.KEYWORD),
+    query: zod_openapi_1.z.string().optional(),
+    queryBy: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    filter: SearchFilterSchema,
+    ...commonSearchParamsShape,
+})
+    .openapi({ description: 'Keyword full-text search' });
+const SemanticSearchSchema = zod_openapi_1.z
+    .object({
+    mode: zod_openapi_1.z.literal(SearchModes.SEMANTIC),
+    vectorField: zod_openapi_1.z.string(),
+    nearVector: zod_openapi_1.z.array(zod_openapi_1.z.number()).optional(),
+    queryText: zod_openapi_1.z.string().optional(),
+    k: zod_openapi_1.z.number().optional(),
+    filter: SearchFilterSchema,
+    ...commonSearchParamsShape,
+    distanceThreshold: zod_openapi_1.z.number().optional(),
+    ef: zod_openapi_1.z.number().optional(),
+})
+    .openapi({ description: 'Vector / semantic search' });
+const HybridSearchSchema = zod_openapi_1.z
+    .object({
+    mode: zod_openapi_1.z.literal(SearchModes.HYBRID),
+    query: zod_openapi_1.z.string(),
+    queryBy: zod_openapi_1.z.array(zod_openapi_1.z.string()),
+    vectorField: zod_openapi_1.z.string(),
+    nearVector: zod_openapi_1.z.array(zod_openapi_1.z.number()).optional(),
+    alpha: zod_openapi_1.z.number().optional(),
+    k: zod_openapi_1.z.number().optional(),
+    filter: SearchFilterSchema,
+    ...commonSearchParamsShape,
+    distanceThreshold: zod_openapi_1.z.number().optional(),
+    ef: zod_openapi_1.z.number().optional(),
+})
+    .openapi({ description: 'Hybrid keyword + vector search' });
+const RawSearchSchema = zod_openapi_1.z
+    .object({
+    mode: zod_openapi_1.z.literal(SearchModes.RAW),
+    params: zod_openapi_1.z.record(zod_openapi_1.z.string(), zod_openapi_1.z.any()),
+})
+    .openapi({ description: 'Raw engine passthrough' });
+exports.SearchInputSchema = zod_openapi_1.z.discriminatedUnion('mode', [
+    KeywordSearchSchema,
+    SemanticSearchSchema,
+    HybridSearchSchema,
+    RawSearchSchema,
+]);
+/** One collection's query within a multi-search - same friendly field names as `search()`. `filterBy` is a raw engine filter string because cross-collection search has no per-collection model to translate a `TFilter` against; the datasource maps entries to wire form via the dialect. */
+exports.MultiSearchEntrySchema = zod_openapi_1.z
+    .object({
+    collection: zod_openapi_1.z.string(),
+    query: zod_openapi_1.z.string().optional(),
+    queryBy: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    filterBy: zod_openapi_1.z.string().optional(),
+    sortBy: zod_openapi_1.z.string().optional(),
+    page: zod_openapi_1.z.number().optional(),
+    perPage: zod_openapi_1.z.number().optional(),
+    offset: zod_openapi_1.z.number().optional(),
+    includeFields: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    excludeFields: zod_openapi_1.z.array(zod_openapi_1.z.string()).optional(),
+    vectorQuery: zod_openapi_1.z.string().optional(),
+    ...commonSearchParamsShape,
+})
+    .openapi({ description: 'A single collection query within a multi-search' });
+/** List-shaped friendly fields that are comma-joined into their single `ISearchQuery` wire form. */
+const MULTI_SEARCH_LIST_FIELDS = new Set([
+    'queryBy',
+    'includeFields',
+    'excludeFields',
+    'facetBy',
+    'highlightFields',
+    'highlightFullFields',
+    'groupBy',
+    'queryByWeights',
+]);
+/** Friendly multi-search params -> `ISearchQuery`: list fields comma-joined, the rest pass through; keeps `search()`, `multiSearch()` and `commonParams` on one friendly-to-wire path. */
+const toSearchQueryParams = (input) => {
+    const params = {};
+    for (const [key, value] of Object.entries(input)) {
+        if (value === undefined || key === 'collection') {
+            continue;
+        }
+        params[key] =
+            MULTI_SEARCH_LIST_FIELDS.has(key) && Array.isArray(value) ? value.join(',') : value;
+    }
+    return params;
+};
+exports.toSearchQueryParams = toSearchQueryParams;
+/** Cross-collection multi-search input: friendly `searches` entries plus the union flag. */
+exports.MultiSearchInputSchema = zod_openapi_1.z
+    .object({
+    searches: zod_openapi_1.z.array(exports.MultiSearchEntrySchema).min(1),
+    union: zod_openapi_1.z.boolean().optional(),
+})
+    .openapi({
+    description: 'Cross-collection multi-search (federated by default; union merges results)',
+});
+//# sourceMappingURL=constants.js.map

package/dist/cjs/search/core/repositories/common/constants.js.map

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

package/dist/cjs/search/core/repositories/common/dialect-helpers.d.ts

@@ -0,0 +1,75 @@
+import { type TFields } from '@venizia/ignis-filter';
+import type { ISearchCompileCapabilities, TCompiledWhere } from './types';
+/** Dialect-shared pure helpers, shared once rather than byte-copied per dialect; not barrel-exported, not part of the connector's public surface. */
+/** skip/offset -> 1-based page number. Requires a page size, and the skip must land on a page boundary. */
+export declare const toSearchPage: (opts: {
+    skip: number;
+    limit?: number;
+}) => number;
+/** `fields` (array form, or object form keeping only `true` keys) -> comma-joined include list. */
+export declare const toFieldsCsv: (opts: {
+    fields: TFields;
+}) => string;
+/**
+ * A `{ gte: 1 }`-style operator map: non-null, non-array, non-Date, at least one key, and EVERY
+ * key a known operator. The every-key test mirrors the relational reference
+ * (relational/repositories/dialect/filter.ts:546-559) rather than accepting any non-empty object.
+ *
+ * Without it `{ meta: { foo: 1 } }` read as an operator map and reported "does not support
+ * operator 'foo'", naming a key the caller never meant as an operator; it now falls through to
+ * the value path and is rejected for what it actually is - an object where a scalar belongs.
+ */
+export declare const isOperatorObject: (value: unknown) => value is Record<string, unknown>;
+/**
+ * AND of two compiled clauses: `matchNone` absorbs, `matchAll` is the identity. This is the
+ * algebra string-joining could not express, and the reason an empty permission disjunction now
+ * survives into the query instead of evaporating out of it.
+ */
+export declare const andCompiled: (left: TCompiledWhere, right: TCompiledWhere, joiner: string) => TCompiledWhere;
+/** OR of two compiled clauses - the dual of `andCompiled`: `matchAll` absorbs, `matchNone` is the identity. */
+export declare const orCompiled: (left: TCompiledWhere, right: TCompiledWhere, joiner: string) => TCompiledWhere;
+/** Folds a clause list, seeded with that operator's IDENTITY so an empty list lands on it: `and: []` -> matchAll (vacuously true), `or: []` -> matchNone (absorbing false). */
+export declare const reduceCompiled: (opts: {
+    clauses: TCompiledWhere[];
+    isDisjunction: boolean;
+    joiner: string;
+}) => TCompiledWhere;
+/** Parenthesises a compiled group; the absorbing outcomes carry no string to wrap. */
+export declare const parenthesize: (compiled: TCompiledWhere) => TCompiledWhere;
+/** Wraps a filter string as a compiled clause. */
+export declare const toFilterClause: (filterBy: string) => TCompiledWhere;
+/**
+ * Rejects a field name the collection does not declare, mirroring the relational reference which
+ * resolves every name against the table's columns and throws `Column NOT FOUND`
+ * (relational/repositories/dialect/filter.ts:377-382 for `where`, :423-428 for `order`). Without it
+ * the name compiles verbatim and the ENGINE's rejection surfaces as an infrastructure failure
+ * rather than a 400 naming the field.
+ *
+ * ONE judgment, shared by both paths a caller can name a field from - `where` and `order` - so the
+ * two cannot drift into disagreeing about what exists. `method` only labels the message with the
+ * path that asked; it never changes the answer.
+ *
+ * Absent `fields` means unvalidated, not "no fields": an entity carrying no collection definition
+ * must compile exactly as it did before this check existed.
+ *
+ * Membership is the WHOLE judgment - a dotted name is not special. Under Typesense's
+ * `enable_nested_fields` a dotted name is an ordinary field name, so `merchantName.en` passes when
+ * declared and `metadata.foo` fails when not, for the only reason that is true of it.
+ *
+ * Hidden fields stay filterable on purpose - `FilterBuilder` does not consult `hiddenProperties`
+ * either, and diverging from the reference is not this change's business.
+ */
+export declare const assertKnownField: (opts: {
+    field: string;
+    engine: string;
+    capabilities?: ISearchCompileCapabilities;
+    method?: string;
+}) => void;
+/** Rejects an operator this engine cannot express, naming BOTH so the caller knows it is the engine choice - not the operator - that decides it. */
+export declare const throwUnsupportedOperator: (opts: {
+    operator: string;
+    field: string;
+    engine: string;
+    reason?: string;
+}) => never;
+//# sourceMappingURL=dialect-helpers.d.ts.map

package/dist/cjs/search/core/repositories/common/dialect-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dialect-helpers.d.ts","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/dialect-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAGrE,OAAO,KAAK,EAAE,0BAA0B,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG1E,qJAAqJ;AAErJ,2GAA2G;AAC3G,eAAO,MAAM,YAAY,GAAI,MAAM;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAAG,MAkBrE,CAAC;AAEF,mGAAmG;AACnG,eAAO,MAAM,WAAW,GAAI,MAAM;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,KAAG,MAevD,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAWhF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,MAAM,cAAc,EACpB,OAAO,cAAc,EACrB,QAAQ,MAAM,KACb,cAoBF,CAAC;AAEF,+GAA+G;AAC/G,eAAO,MAAM,UAAU,GACrB,MAAM,cAAc,EACpB,OAAO,cAAc,EACrB,QAAQ,MAAM,KACb,cAoBF,CAAC;AAEF,+KAA+K;AAC/K,eAAO,MAAM,cAAc,GAAI,MAAM;IACnC,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B,aAAa,EAAE,OAAO,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;CAChB,KAAG,cAQH,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,YAAY,GAAI,UAAU,cAAc,KAAG,cAG1C,CAAC;AAEf,kDAAkD;AAClD,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,cAGhD,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,0BAA0B,CAAC;IAC1C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,IAWH,CAAC;AAEF,oJAAoJ;AACpJ,eAAO,MAAM,wBAAwB,GAAI,MAAM;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,KAAG,KAOH,CAAC"}

package/dist/cjs/search/core/repositories/common/dialect-helpers.js

@@ -0,0 +1,162 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.throwUnsupportedOperator = exports.assertKnownField = exports.toFilterClause = exports.parenthesize = exports.reduceCompiled = exports.orCompiled = exports.andCompiled = exports.isOperatorObject = exports.toFieldsCsv = exports.toSearchPage = void 0;
+const ignis_filter_1 = require("@venizia/ignis-filter");
+const core_1 = require("@venizia/ignis-helpers/core");
+const errors_1 = require("../../../../search/core/common/errors");
+const types_1 = require("./types");
+/** Dialect-shared pure helpers, shared once rather than byte-copied per dialect; not barrel-exported, not part of the connector's public surface. */
+/** skip/offset -> 1-based page number. Requires a page size, and the skip must land on a page boundary. */
+const toSearchPage = (opts) => {
+    const { skip, limit } = opts;
+    if (limit === undefined) {
+        throw (0, core_1.getError)({
+            message: '[SearchQueryDialect][toPage] skip/offset requires limit for search() pagination - a page cannot be expressed without a page size',
+        });
+    }
+    if (skip % limit !== 0) {
+        throw (0, core_1.getError)({
+            message: '[SearchQueryDialect][toPage] skip must be a multiple of limit for search pagination',
+        });
+    }
+    return Math.floor(skip / limit) + 1;
+};
+exports.toSearchPage = toSearchPage;
+/** `fields` (array form, or object form keeping only `true` keys) -> comma-joined include list. */
+const toFieldsCsv = (opts) => {
+    const { fields } = opts;
+    if (Array.isArray(fields)) {
+        return fields.join(',');
+    }
+    const included = [];
+    for (const key in fields) {
+        if (fields[key] === true) {
+            included.push(key);
+        }
+    }
+    return included.join(',');
+};
+exports.toFieldsCsv = toFieldsCsv;
+/**
+ * A `{ gte: 1 }`-style operator map: non-null, non-array, non-Date, at least one key, and EVERY
+ * key a known operator. The every-key test mirrors the relational reference
+ * (relational/repositories/dialect/filter.ts:546-559) rather than accepting any non-empty object.
+ *
+ * Without it `{ meta: { foo: 1 } }` read as an operator map and reported "does not support
+ * operator 'foo'", naming a key the caller never meant as an operator; it now falls through to
+ * the value path and is rejected for what it actually is - an object where a scalar belongs.
+ */
+const isOperatorObject = (value) => {
+    if (value === null || Array.isArray(value) || typeof value !== 'object') {
+        return false;
+    }
+    const keys = Object.keys(value);
+    if (keys.length === 0) {
+        return false;
+    }
+    return keys.every(key => ignis_filter_1.QueryOperators.isValid(key));
+};
+exports.isOperatorObject = isOperatorObject;
+/**
+ * AND of two compiled clauses: `matchNone` absorbs, `matchAll` is the identity. This is the
+ * algebra string-joining could not express, and the reason an empty permission disjunction now
+ * survives into the query instead of evaporating out of it.
+ */
+const andCompiled = (left, right, joiner) => {
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_NONE ||
+        right.outcome === types_1.SearchFilterOutcomes.MATCH_NONE) {
+        return { outcome: types_1.SearchFilterOutcomes.MATCH_NONE };
+    }
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_ALL) {
+        return right;
+    }
+    if (right.outcome === types_1.SearchFilterOutcomes.MATCH_ALL) {
+        return left;
+    }
+    return {
+        outcome: types_1.SearchFilterOutcomes.FILTER,
+        filterBy: `${left.filterBy}${joiner}${right.filterBy}`,
+    };
+};
+exports.andCompiled = andCompiled;
+/** OR of two compiled clauses - the dual of `andCompiled`: `matchAll` absorbs, `matchNone` is the identity. */
+const orCompiled = (left, right, joiner) => {
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_ALL ||
+        right.outcome === types_1.SearchFilterOutcomes.MATCH_ALL) {
+        return { outcome: types_1.SearchFilterOutcomes.MATCH_ALL };
+    }
+    if (left.outcome === types_1.SearchFilterOutcomes.MATCH_NONE) {
+        return right;
+    }
+    if (right.outcome === types_1.SearchFilterOutcomes.MATCH_NONE) {
+        return left;
+    }
+    return {
+        outcome: types_1.SearchFilterOutcomes.FILTER,
+        filterBy: `${left.filterBy}${joiner}${right.filterBy}`,
+    };
+};
+exports.orCompiled = orCompiled;
+/** Folds a clause list, seeded with that operator's IDENTITY so an empty list lands on it: `and: []` -> matchAll (vacuously true), `or: []` -> matchNone (absorbing false). */
+const reduceCompiled = (opts) => {
+    const { clauses, isDisjunction, joiner } = opts;
+    const combine = isDisjunction ? exports.orCompiled : exports.andCompiled;
+    const identity = isDisjunction
+        ? { outcome: types_1.SearchFilterOutcomes.MATCH_NONE }
+        : { outcome: types_1.SearchFilterOutcomes.MATCH_ALL };
+    return clauses.reduce((accumulated, clause) => combine(accumulated, clause, joiner), identity);
+};
+exports.reduceCompiled = reduceCompiled;
+/** Parenthesises a compiled group; the absorbing outcomes carry no string to wrap. */
+const parenthesize = (compiled) => compiled.outcome === types_1.SearchFilterOutcomes.FILTER
+    ? { outcome: types_1.SearchFilterOutcomes.FILTER, filterBy: `(${compiled.filterBy})` }
+    : compiled;
+exports.parenthesize = parenthesize;
+/** Wraps a filter string as a compiled clause. */
+const toFilterClause = (filterBy) => ({
+    outcome: types_1.SearchFilterOutcomes.FILTER,
+    filterBy,
+});
+exports.toFilterClause = toFilterClause;
+/**
+ * Rejects a field name the collection does not declare, mirroring the relational reference which
+ * resolves every name against the table's columns and throws `Column NOT FOUND`
+ * (relational/repositories/dialect/filter.ts:377-382 for `where`, :423-428 for `order`). Without it
+ * the name compiles verbatim and the ENGINE's rejection surfaces as an infrastructure failure
+ * rather than a 400 naming the field.
+ *
+ * ONE judgment, shared by both paths a caller can name a field from - `where` and `order` - so the
+ * two cannot drift into disagreeing about what exists. `method` only labels the message with the
+ * path that asked; it never changes the answer.
+ *
+ * Absent `fields` means unvalidated, not "no fields": an entity carrying no collection definition
+ * must compile exactly as it did before this check existed.
+ *
+ * Membership is the WHOLE judgment - a dotted name is not special. Under Typesense's
+ * `enable_nested_fields` a dotted name is an ordinary field name, so `merchantName.en` passes when
+ * declared and `metadata.foo` fails when not, for the only reason that is true of it.
+ *
+ * Hidden fields stay filterable on purpose - `FilterBuilder` does not consult `hiddenProperties`
+ * either, and diverging from the reference is not this change's business.
+ */
+const assertKnownField = (opts) => {
+    const { field, engine, capabilities, method = 'compileWhere' } = opts;
+    if (!capabilities?.fields || capabilities.fields.has(field)) {
+        return;
+    }
+    throw (0, core_1.getError)({
+        error: errors_1.SearchErrors.UNKNOWN_FIELD,
+        message: `[${engine}QueryDialect][${method}] search() Field NOT FOUND | field: '${field}' | engine: '${engine}' | the collection definition declares no such field`,
+    });
+};
+exports.assertKnownField = assertKnownField;
+/** Rejects an operator this engine cannot express, naming BOTH so the caller knows it is the engine choice - not the operator - that decides it. */
+const throwUnsupportedOperator = (opts) => {
+    const { operator, field, engine, reason } = opts;
+    throw (0, core_1.getError)({
+        error: errors_1.SearchErrors.UNSUPPORTED_OPERATOR,
+        message: `[${engine}QueryDialect][compileWhere] search() does not support operator '${operator}' | operator: '${operator}' | engine: '${engine}' | field: '${field}'${reason ? ` | ${reason}` : ''}`,
+    });
+};
+exports.throwUnsupportedOperator = throwUnsupportedOperator;
+//# sourceMappingURL=dialect-helpers.js.map

package/dist/cjs/search/core/repositories/common/dialect-helpers.js.map

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

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

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

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

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

package/dist/cjs/search/core/repositories/common/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("./constants"), exports);
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/search/core/repositories/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/search/core/repositories/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,0CAAwB"}