elasticlink 1.0.0-beta.1 → 1.0.0

package/dist/field.helpers.d.ts

@@ -1,241 +0,0 @@
-/**
- * Field type helper functions for ergonomic index mapping definitions.
- * Each helper returns a narrowly-typed mapping with a literal `type` field,
- * enabling compile-time field-type inference in the query builder.
- *
- * @example
- * import { text, keyword, denseVector, mappings } from 'elasticlink';
- *
- * const productMappings = mappings({
- *   name: text({ analyzer: 'standard' }),
- *   price: float(),
- *   category: keyword(),
- *   embedding: denseVector({ dims: 384 }),
- * });
- */
-import type { TextFieldOptions, KeywordFieldOptions, NumericFieldOptions, UnsignedLongFieldOptions, ScaledFloatFieldOptions, DateFieldOptions, DateNanosFieldOptions, IpRangeFieldOptions, NestedFieldOptions, BooleanFieldOptions, DenseVectorFieldOptions, RankFeatureFieldOptions, RankFeaturesFieldOptions, SemanticTextFieldOptions, ObjectFieldOptions, CompletionFieldOptions, GeoPointFieldOptions, GeoShapeFieldOptions, AliasFieldOptions, IpFieldOptions, RangeFieldOptions, MatchOnlyTextFieldOptions, SearchAsYouTypeFieldOptions, ConstantKeywordFieldOptions, WildcardFieldOptions, FlattenedFieldOptions, TokenCountFieldOptions, JoinFieldOptions, FieldMappingWithLiteralType, TextFieldMapping, KeywordFieldMapping, LongFieldMapping, IntegerFieldMapping, ShortFieldMapping, ByteFieldMapping, DoubleFieldMapping, FloatFieldMapping, HalfFloatFieldMapping, ScaledFloatFieldMapping, DateFieldMapping, DateNanosFieldMapping, IpRangeFieldMapping, BooleanFieldMapping, BinaryFieldMapping, IpFieldMapping, DenseVectorFieldMapping, SparseVectorFieldMapping, RankFeatureFieldMapping, RankFeaturesFieldMapping, SemanticTextFieldMapping, UnsignedLongFieldMapping, GeoPointFieldMapping, GeoShapeFieldMapping, CompletionFieldMapping, TypedNestedFieldMapping, TypedObjectFieldMapping, AliasFieldMapping, PercolatorFieldMapping, IntegerRangeFieldMapping, FloatRangeFieldMapping, LongRangeFieldMapping, DoubleRangeFieldMapping, DateRangeFieldMapping, MatchOnlyTextFieldMapping, SearchAsYouTypeFieldMapping, ConstantKeywordFieldMapping, WildcardFieldMapping, FlattenedFieldMapping, TokenCountFieldMapping, Murmur3FieldMapping, JoinFieldMapping } from './field.types.js';
-export declare const text: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: TextFieldOptions<MF>) => TextFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const keyword: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: KeywordFieldOptions<MF>) => KeywordFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const long: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => LongFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const integer: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => IntegerFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const short: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => ShortFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const byte: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => ByteFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const double: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => DoubleFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const float: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => FloatFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const halfFloat: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: NumericFieldOptions<MF>) => HalfFloatFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const scaledFloat: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: ScaledFloatFieldOptions<MF>) => ScaledFloatFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const date: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: DateFieldOptions<MF>) => DateFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-/**
- * Date field stored with nanosecond precision. Same API as `date()` but supports sub-millisecond timestamps.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/date_nanos.html
- */
-export declare const dateNanos: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: DateNanosFieldOptions<MF>) => DateNanosFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const boolean: (options?: BooleanFieldOptions) => BooleanFieldMapping;
-export declare const binary: () => BinaryFieldMapping;
-export declare const ip: (options?: IpFieldOptions) => IpFieldMapping;
-export declare const denseVector: (options?: DenseVectorFieldOptions) => DenseVectorFieldMapping;
-/**
- * Quantized dense vector field — wraps `denseVector()` with `int8_hnsw` index type.
- *
- * Quantizes float32 vectors to int8 at index time, saving ~75% memory.
- * Recommended for vectors with dims >= 384. Original float vectors are retained
- * in the index, enabling a two-phase search pattern:
- *
- * 1. Fast approximate search using quantized int8 vectors
- * 2. Precise rescore of top-k results using retained float vectors
- *
- * @example
- * // Index mapping
- * const schema = mappings({
- *   title: text(),
- *   embedding: quantizedDenseVector({ dims: 768, similarity: 'cosine' }),
- * }, {
- *   _source: { excludes: ['embedding'] },
- * });
- *
- * // Two-phase search: fast kNN + precise rescore
- * const result = queryBuilder(schema)
- *   .knn('embedding', queryVector, { k: 100, num_candidates: 200 })
- *   .rescore(
- *     (q) => q.scriptScore(
- *       (inner) => inner.matchAll(),
- *       { source: "cosineSimilarity(params.v, 'embedding') + 1.0", params: { v: queryVector } }
- *     ),
- *     100
- *   )
- *   .build();
- */
-export declare const quantizedDenseVector: (options?: DenseVectorFieldOptions) => DenseVectorFieldMapping;
-/**
- * Sparse vector field — stores token-weight pairs for sparse retrieval (e.g. ELSER/BM25-style models).
- * Complement to `denseVector()`. Query with the `sparse_vector` query.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/sparse-vector.html
- */
-export declare const sparseVector: () => SparseVectorFieldMapping;
-/**
- * Rank feature field — a single numeric feature used by the `rank_feature` query to boost relevance.
- * Use when each document has one named signal (e.g. `pagerank`, `popularity_score`).
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/rank-feature.html
- */
-export declare const rankFeature: (options?: RankFeatureFieldOptions) => RankFeatureFieldMapping;
-/**
- * Rank features field — a sparse map of numeric features used by the `rank_feature` query.
- * Use when each document has many named signals (e.g. topic scores).
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/rank-features.html
- */
-export declare const rankFeatures: (options?: RankFeaturesFieldOptions) => RankFeaturesFieldMapping;
-/**
- * Semantic text field (ES 9.x) — ML-powered text field for semantic and hybrid search.
- * Automatically generates and stores embeddings at index time using the configured inference endpoint.
- *
- * @example
- * const schema = mappings({
- *   title: text(),
- *   body: semanticText({ inference_id: 'my-elser-endpoint' }),
- * });
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/semantic-text.html
- */
-export declare const semanticText: (options?: SemanticTextFieldOptions) => SemanticTextFieldMapping;
-/**
- * Unsigned long field (ES 9.0+) — stores unsigned 64-bit integer values (0 to 2^64-1).
- * Use when values exceed the `long` range.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/number.html
- */
-export declare const unsignedLong: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: UnsignedLongFieldOptions<MF>) => UnsignedLongFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-export declare const geoPoint: (options?: GeoPointFieldOptions) => GeoPointFieldMapping;
-export declare const geoShape: (options?: GeoShapeFieldOptions) => GeoShapeFieldMapping;
-export declare const completion: (options?: CompletionFieldOptions) => CompletionFieldMapping;
-/**
- * Object field — for JSON-like structured documents where sub-fields are queried with dot-notation.
- *
- * The most common way to model structured data (e.g. `{ address: { city, zip } }`).
- * Sub-fields are indexed inline within the parent document — no special query wrapper needed.
- * Query sub-fields directly using dot-notation: `.term('address.city', 'NYC')`.
- *
- * Use `nested()` instead when you have **arrays of objects** and need cross-field queries
- * within each element to be accurate (e.g. tags with both a label and weight).
- *
- * @example
- * const m = mappings({
- *   address: object({
- *     street: text(),
- *     city: keyword(),
- *     zip: keyword(),
- *   }),
- * });
- * queryBuilder(m).term('address.city', 'NYC').build();
- */
-export declare function object<F extends Record<string, FieldMappingWithLiteralType>>(fields: F, options?: ObjectFieldOptions): TypedObjectFieldMapping<F>;
-/**
- * Nested field — for **arrays of objects** where cross-field queries within each element must be accurate.
- *
- * Each nested object is stored as a separate hidden Elasticsearch document, preserving the
- * relationship between sub-fields within each element. Without `nested`, Elasticsearch flattens
- * array sub-fields and loses which values belong to the same element.
- *
- * Queries on nested fields **must** use the `.nested()` query builder method — direct dot-notation
- * queries will not find nested documents.
- *
- * Use `object()` instead for single structured objects (addresses, names, etc.) — it is simpler,
- * more efficient, and does not require a query wrapper.
- *
- * @example
- * const m = mappings({
- *   tags: nested({
- *     label: keyword(),
- *     weight: float(),
- *   }),
- * });
- * queryBuilder(m).nested('tags', q => q.term('label', 'sale')).build();
- */
-export declare function nested<F extends Record<string, FieldMappingWithLiteralType>>(fields: F, options?: NestedFieldOptions): TypedNestedFieldMapping<F>;
-export declare const alias: (options: AliasFieldOptions) => AliasFieldMapping;
-export declare const percolator: () => PercolatorFieldMapping;
-export declare const integerRange: (options?: RangeFieldOptions) => IntegerRangeFieldMapping;
-export declare const floatRange: (options?: RangeFieldOptions) => FloatRangeFieldMapping;
-export declare const longRange: (options?: RangeFieldOptions) => LongRangeFieldMapping;
-export declare const doubleRange: (options?: RangeFieldOptions) => DoubleRangeFieldMapping;
-export declare const dateRange: (options?: RangeFieldOptions) => DateRangeFieldMapping;
-/**
- * IP range field — stores a range of IPv4/IPv6 addresses.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/range.html
- */
-export declare const ipRange: (options?: IpRangeFieldOptions) => IpRangeFieldMapping;
-/**
- * No-score text field — faster and uses less disk than `text()`.
- * Use when you only need filter/match but not relevance scoring (e.g., logs, simple field matches).
- */
-export declare const matchOnlyText: <MF extends Record<string, FieldMappingWithLiteralType>>(options?: MatchOnlyTextFieldOptions<MF>) => MatchOnlyTextFieldMapping & Readonly<{
-    _multiFields: MF;
-}>;
-/**
- * Autocomplete / typeahead field. Creates sub-fields for edge n-gram matching
- * out of the box. Query with `multi_match` targeting the generated sub-fields.
- */
-export declare const searchAsYouType: (options?: SearchAsYouTypeFieldOptions) => SearchAsYouTypeFieldMapping;
-/**
- * Field where every document has the same value. Useful for multi-index queries
- * to identify the index type (e.g., `constantKeyword({ value: 'product' })`).
- */
-export declare const constantKeyword: (options?: ConstantKeywordFieldOptions) => ConstantKeywordFieldMapping;
-/**
- * Optimized for grep-like wildcard/regexp queries on high-cardinality or large fields.
- * Use instead of `keyword()` when leading wildcards (`*foo`) are needed.
- */
-export declare const wildcardField: (options?: WildcardFieldOptions) => WildcardFieldMapping;
-/**
- * Flattens complex/dynamic objects into a single field. Faster than `nested()`,
- * but only supports keyword-level queries on inner values.
- */
-export declare const flattened: (options?: FlattenedFieldOptions) => FlattenedFieldMapping;
-/**
- * Token count field — stores the number of tokens produced by an analyzer.
- * Useful for enforcing minimum/maximum field lengths via queries or aggregations.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/token-count.html
- */
-export declare const tokenCount: (options?: TokenCountFieldOptions) => TokenCountFieldMapping;
-/**
- * Murmur3 hash field — computes and stores a murmur3 hash of field values at index time.
- * Requires the `mapper-murmur3` plugin.
- * @see https://www.elastic.co/guide/en/elasticsearch/plugins/current/mapper-murmur3.html
- */
-export declare const murmur3Hash: () => Murmur3FieldMapping;
-/**
- * Join field — defines parent/child relationships within a single index.
- * `relations` is required: maps parent names to one or more child names.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/parent-join.html
- *
- * @example
- * const m = mappings({
- *   title: text(),
- *   relation: join({ relations: { question: 'answer' } }),
- * });
- */
-export declare const join: (options: JoinFieldOptions) => JoinFieldMapping;
-//# sourceMappingURL=field.helpers.d.ts.map

package/dist/field.helpers.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"field.helpers.d.ts","sourceRoot":"","sources":["../src/field.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACvB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EACjB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,2BAA2B,EAC3B,gBAAgB,EAChB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,qBAAqB,EACrB,uBAAuB,EACvB,gBAAgB,EAChB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,wBAAwB,EACxB,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,uBAAuB,EACvB,iBAAiB,EACjB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,yBAAyB,EACzB,2BAA2B,EAC3B,2BAA2B,EAC3B,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,IAAI,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACzE,UAAU,gBAAgB,CAAC,EAAE,CAAC,KAC7B,gBAAgB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAEZ,CAAC;AACxC,eAAO,MAAM,OAAO,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC5E,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAChC,mBAAmB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAEZ,CAAC;AAG3C,eAAO,MAAM,IAAI,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACzE,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,gBAAgB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA0C,CAAC;AAC9F,eAAO,MAAM,OAAO,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC5E,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,mBAAmB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA6C,CAAC;AACpG,eAAO,MAAM,KAAK,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC1E,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,iBAAiB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA2C,CAAC;AAChG,eAAO,MAAM,IAAI,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACzE,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,gBAAgB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA0C,CAAC;AAC9F,eAAO,MAAM,MAAM,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC3E,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,kBAAkB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA4C,CAAC;AAClG,eAAO,MAAM,KAAK,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC1E,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,iBAAiB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA2C,CAAC;AAChG,eAAO,MAAM,SAAS,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC9E,UAAU,mBAAmB,CAAC,EAAE,CAAC,KAEhC,qBAAqB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAAgD,CAAC;AACzG,eAAO,MAAM,WAAW,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAChF,UAAU,uBAAuB,CAAC,EAAE,CAAC,KAEpC,uBAAuB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAAkD,CAAC;AAG7G,eAAO,MAAM,IAAI,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACzE,UAAU,gBAAgB,CAAC,EAAE,CAAC,KAE7B,gBAAgB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAA0C,CAAC;AAE9F;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC9E,UAAU,qBAAqB,CAAC,EAAE,CAAC,KAElC,qBAAqB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAAgD,CAAC;AACzG,eAAO,MAAM,OAAO,GAAI,UAAU,mBAAmB,KAAG,mBAGtD,CAAC;AAIH,eAAO,MAAM,MAAM,QAAO,kBAA0C,CAAC;AAGrE,eAAO,MAAM,EAAE,GAAI,UAAU,cAAc,KAAG,cAG5C,CAAC;AAGH,eAAO,MAAM,WAAW,GAAI,UAAU,uBAAuB,KAAG,uBAG9D,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,oBAAoB,GAAI,UAAU,uBAAuB,KAAG,uBAIvE,CAAC;AAEH;;;;GAIG;AAEH,eAAO,MAAM,YAAY,QAAO,wBAAuD,CAAC;AAExF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,uBAAuB,KAAG,uBAG9D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,wBAAwB,KAAG,wBAGhE,CAAC;AAEH;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,GAAI,UAAU,wBAAwB,KAAG,wBAGhE,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EACjF,UAAU,wBAAwB,CAAC,EAAE,CAAC,KAErC,wBAAwB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAAmD,CAAC;AAG/G,eAAO,MAAM,QAAQ,GAAI,UAAU,oBAAoB,KAAG,oBAGxD,CAAC;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU,oBAAoB,KAAG,oBAGxD,CAAC;AAGH,eAAO,MAAM,UAAU,GAAI,UAAU,sBAAsB,KAAG,sBAG5D,CAAC;AAIH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC1E,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,kBAAkB,GAC3B,uBAAuB,CAAC,CAAC,CAAC,CAG5B;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC1E,MAAM,EAAE,CAAC,EACT,OAAO,CAAC,EAAE,kBAAkB,GAC3B,uBAAuB,CAAC,CAAC,CAAC,CAG5B;AAGD,eAAO,MAAM,KAAK,GAAI,SAAS,iBAAiB,KAAG,iBAGjD,CAAC;AAIH,eAAO,MAAM,UAAU,QAAO,sBAE5B,CAAC;AAGH,eAAO,MAAM,YAAY,GAAI,UAAU,iBAAiB,KAAG,wBAGzD,CAAC;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,iBAAiB,KAAG,sBAGvD,CAAC;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,iBAAiB,KAAG,qBAGtD,CAAC;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,uBAGxD,CAAC;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,iBAAiB,KAAG,qBAGtD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,mBAAmB,KAAG,mBAGtD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAClF,UAAU,yBAAyB,CAAC,EAAE,CAAC,KAEtC,yBAAyB,GAAG,QAAQ,CAAC;IAAE,YAAY,EAAE,EAAE,CAAA;CAAE,CAAqD,CAAC;AAElH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,2BAA2B,KAAG,2BAGtE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,UAAU,2BAA2B,KAAG,2BAGtE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,UAAU,oBAAoB,KAAG,oBAG7D,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,qBAAqB,KAAG,qBAG1D,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,sBAAsB,KAAG,sBAG5D,CAAC;AAEH;;;;GAIG;AAEH,eAAO,MAAM,WAAW,QAAO,mBAA4C,CAAC;AAE5E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,GAAI,SAAS,gBAAgB,KAAG,gBAG/C,CAAC"}

package/dist/field.helpers.js

@@ -1,333 +0,0 @@
-/**
- * Field type helper functions for ergonomic index mapping definitions.
- * Each helper returns a narrowly-typed mapping with a literal `type` field,
- * enabling compile-time field-type inference in the query builder.
- *
- * @example
- * import { text, keyword, denseVector, mappings } from 'elasticlink';
- *
- * const productMappings = mappings({
- *   name: text({ analyzer: 'standard' }),
- *   price: float(),
- *   category: keyword(),
- *   embedding: denseVector({ dims: 384 }),
- * });
- */
-// Text & keyword
-export const text = (options) => 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-({ type: 'text', ...options });
-export const keyword = (options) => 
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-({ type: 'keyword', ...options });
-// Numeric
-export const long = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'long', ...options });
-export const integer = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'integer', ...options });
-export const short = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'short', ...options });
-export const byte = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'byte', ...options });
-export const double = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'double', ...options });
-export const float = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'float', ...options });
-export const halfFloat = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'half_float', ...options });
-export const scaledFloat = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'scaled_float', ...options });
-// Date & boolean
-export const date = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'date', ...options });
-/**
- * Date field stored with nanosecond precision. Same API as `date()` but supports sub-millisecond timestamps.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/date_nanos.html
- */
-export const dateNanos = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'date_nanos', ...options });
-export const boolean = (options) => ({
-    type: 'boolean',
-    ...options
-});
-// Binary
-// eslint-disable-next-line functional/functional-parameters
-export const binary = () => ({ type: 'binary' });
-// IP
-export const ip = (options) => ({
-    type: 'ip',
-    ...options
-});
-// Vector
-export const denseVector = (options) => ({
-    type: 'dense_vector',
-    ...options
-});
-/**
- * Quantized dense vector field — wraps `denseVector()` with `int8_hnsw` index type.
- *
- * Quantizes float32 vectors to int8 at index time, saving ~75% memory.
- * Recommended for vectors with dims >= 384. Original float vectors are retained
- * in the index, enabling a two-phase search pattern:
- *
- * 1. Fast approximate search using quantized int8 vectors
- * 2. Precise rescore of top-k results using retained float vectors
- *
- * @example
- * // Index mapping
- * const schema = mappings({
- *   title: text(),
- *   embedding: quantizedDenseVector({ dims: 768, similarity: 'cosine' }),
- * }, {
- *   _source: { excludes: ['embedding'] },
- * });
- *
- * // Two-phase search: fast kNN + precise rescore
- * const result = queryBuilder(schema)
- *   .knn('embedding', queryVector, { k: 100, num_candidates: 200 })
- *   .rescore(
- *     (q) => q.scriptScore(
- *       (inner) => inner.matchAll(),
- *       { source: "cosineSimilarity(params.v, 'embedding') + 1.0", params: { v: queryVector } }
- *     ),
- *     100
- *   )
- *   .build();
- */
-export const quantizedDenseVector = (options) => ({
-    type: 'dense_vector',
-    ...options,
-    index_options: { type: 'int8_hnsw', ...options?.index_options }
-});
-/**
- * Sparse vector field — stores token-weight pairs for sparse retrieval (e.g. ELSER/BM25-style models).
- * Complement to `denseVector()`. Query with the `sparse_vector` query.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/sparse-vector.html
- */
-// eslint-disable-next-line functional/functional-parameters
-export const sparseVector = () => ({ type: 'sparse_vector' });
-/**
- * Rank feature field — a single numeric feature used by the `rank_feature` query to boost relevance.
- * Use when each document has one named signal (e.g. `pagerank`, `popularity_score`).
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/rank-feature.html
- */
-export const rankFeature = (options) => ({
-    type: 'rank_feature',
-    ...options
-});
-/**
- * Rank features field — a sparse map of numeric features used by the `rank_feature` query.
- * Use when each document has many named signals (e.g. topic scores).
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/rank-features.html
- */
-export const rankFeatures = (options) => ({
-    type: 'rank_features',
-    ...options
-});
-/**
- * Semantic text field (ES 9.x) — ML-powered text field for semantic and hybrid search.
- * Automatically generates and stores embeddings at index time using the configured inference endpoint.
- *
- * @example
- * const schema = mappings({
- *   title: text(),
- *   body: semanticText({ inference_id: 'my-elser-endpoint' }),
- * });
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/semantic-text.html
- */
-export const semanticText = (options) => ({
-    type: 'semantic_text',
-    ...options
-});
-/**
- * Unsigned long field (ES 9.0+) — stores unsigned 64-bit integer values (0 to 2^64-1).
- * Use when values exceed the `long` range.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/number.html
- */
-export const unsignedLong = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'unsigned_long', ...options });
-// Geo
-export const geoPoint = (options) => ({
-    type: 'geo_point',
-    ...options
-});
-export const geoShape = (options) => ({
-    type: 'geo_shape',
-    ...options
-});
-// Completion
-export const completion = (options) => ({
-    type: 'completion',
-    ...options
-});
-// Structured
-/**
- * Object field — for JSON-like structured documents where sub-fields are queried with dot-notation.
- *
- * The most common way to model structured data (e.g. `{ address: { city, zip } }`).
- * Sub-fields are indexed inline within the parent document — no special query wrapper needed.
- * Query sub-fields directly using dot-notation: `.term('address.city', 'NYC')`.
- *
- * Use `nested()` instead when you have **arrays of objects** and need cross-field queries
- * within each element to be accurate (e.g. tags with both a label and weight).
- *
- * @example
- * const m = mappings({
- *   address: object({
- *     street: text(),
- *     city: keyword(),
- *     zip: keyword(),
- *   }),
- * });
- * queryBuilder(m).term('address.city', 'NYC').build();
- */
-export function object(fields, options) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return { type: 'object', ...(options ?? {}), properties: fields };
-}
-/**
- * Nested field — for **arrays of objects** where cross-field queries within each element must be accurate.
- *
- * Each nested object is stored as a separate hidden Elasticsearch document, preserving the
- * relationship between sub-fields within each element. Without `nested`, Elasticsearch flattens
- * array sub-fields and loses which values belong to the same element.
- *
- * Queries on nested fields **must** use the `.nested()` query builder method — direct dot-notation
- * queries will not find nested documents.
- *
- * Use `object()` instead for single structured objects (addresses, names, etc.) — it is simpler,
- * more efficient, and does not require a query wrapper.
- *
- * @example
- * const m = mappings({
- *   tags: nested({
- *     label: keyword(),
- *     weight: float(),
- *   }),
- * });
- * queryBuilder(m).nested('tags', q => q.term('label', 'sale')).build();
- */
-export function nested(fields, options) {
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    return { type: 'nested', ...(options ?? {}), properties: fields };
-}
-// Alias
-export const alias = (options) => ({
-    type: 'alias',
-    ...options
-});
-// Percolator
-// eslint-disable-next-line functional/functional-parameters
-export const percolator = () => ({
-    type: 'percolator'
-});
-// Range types
-export const integerRange = (options) => ({
-    type: 'integer_range',
-    ...options
-});
-export const floatRange = (options) => ({
-    type: 'float_range',
-    ...options
-});
-export const longRange = (options) => ({
-    type: 'long_range',
-    ...options
-});
-export const doubleRange = (options) => ({
-    type: 'double_range',
-    ...options
-});
-export const dateRange = (options) => ({
-    type: 'date_range',
-    ...options
-});
-/**
- * IP range field — stores a range of IPv4/IPv6 addresses.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/range.html
- */
-export const ipRange = (options) => ({
-    type: 'ip_range',
-    ...options
-});
-/**
- * No-score text field — faster and uses less disk than `text()`.
- * Use when you only need filter/match but not relevance scoring (e.g., logs, simple field matches).
- */
-export const matchOnlyText = (options
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-) => ({ type: 'match_only_text', ...options });
-/**
- * Autocomplete / typeahead field. Creates sub-fields for edge n-gram matching
- * out of the box. Query with `multi_match` targeting the generated sub-fields.
- */
-export const searchAsYouType = (options) => ({
-    type: 'search_as_you_type',
-    ...options
-});
-/**
- * Field where every document has the same value. Useful for multi-index queries
- * to identify the index type (e.g., `constantKeyword({ value: 'product' })`).
- */
-export const constantKeyword = (options) => ({
-    type: 'constant_keyword',
-    ...options
-});
-/**
- * Optimized for grep-like wildcard/regexp queries on high-cardinality or large fields.
- * Use instead of `keyword()` when leading wildcards (`*foo`) are needed.
- */
-export const wildcardField = (options) => ({
-    type: 'wildcard',
-    ...options
-});
-/**
- * Flattens complex/dynamic objects into a single field. Faster than `nested()`,
- * but only supports keyword-level queries on inner values.
- */
-export const flattened = (options) => ({
-    type: 'flattened',
-    ...options
-});
-/**
- * Token count field — stores the number of tokens produced by an analyzer.
- * Useful for enforcing minimum/maximum field lengths via queries or aggregations.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/token-count.html
- */
-export const tokenCount = (options) => ({
-    type: 'token_count',
-    ...options
-});
-/**
- * Murmur3 hash field — computes and stores a murmur3 hash of field values at index time.
- * Requires the `mapper-murmur3` plugin.
- * @see https://www.elastic.co/guide/en/elasticsearch/plugins/current/mapper-murmur3.html
- */
-// eslint-disable-next-line functional/functional-parameters
-export const murmur3Hash = () => ({ type: 'murmur3' });
-/**
- * Join field — defines parent/child relationships within a single index.
- * `relations` is required: maps parent names to one or more child names.
- * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/parent-join.html
- *
- * @example
- * const m = mappings({
- *   title: text(),
- *   relation: join({ relations: { question: 'answer' } }),
- * });
- */
-export const join = (options) => ({
-    type: 'join',
-    ...options
-});