elasticlink 0.2.2-beta → 0.4.0-beta

package/dist/field.helpers.d.ts

@@ -1,51 +1,101 @@
 /**
  * Field type helper functions for ergonomic index mapping definitions.
- * Each helper returns a FieldMapping with `type` pre-filled and only accepts
- * options relevant to that specific field type.
+ * 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 } from 'elasticlink';
+ * import { text, keyword, denseVector, mappings } from 'elasticlink';
  *
- * indexBuilder<Product>()
- *   .mappings({
- *     name: text({ analyzer: 'standard' }),
- *     price: 'float',
- *     category: 'keyword',
- *     embedding: denseVector({ dims: 384 }),
- *   })
+ * const productMappings = mappings({
+ *   name: text({ analyzer: 'standard' }),
+ *   price: float(),
+ *   category: keyword(),
+ *   embedding: denseVector({ dims: 384 }),
+ * });
  */
-import type { FieldMapping, FieldMappingInput } from './index-management.types.js';
-import type { TextFieldOptions, KeywordFieldOptions, NumericFieldOptions, ScaledFloatFieldOptions, DateFieldOptions, BooleanFieldOptions, DenseVectorFieldOptions, NestedFields, ObjectFieldOptions, CompletionFieldOptions, GeoPointFieldOptions, GeoShapeFieldOptions, AliasFieldOptions, IpFieldOptions, RangeFieldOptions } from './field.types.js';
-export declare const text: (options?: TextFieldOptions) => FieldMapping;
-export declare const keyword: (options?: KeywordFieldOptions) => FieldMapping;
-export declare const long: (options?: NumericFieldOptions) => FieldMapping;
-export declare const integer: (options?: NumericFieldOptions) => FieldMapping;
-export declare const short: (options?: NumericFieldOptions) => FieldMapping;
-export declare const byte: (options?: NumericFieldOptions) => FieldMapping;
-export declare const double: (options?: NumericFieldOptions) => FieldMapping;
-export declare const float: (options?: NumericFieldOptions) => FieldMapping;
-export declare const halfFloat: (options?: NumericFieldOptions) => FieldMapping;
-export declare const scaledFloat: (options?: ScaledFloatFieldOptions) => FieldMapping;
-export declare const date: (options?: DateFieldOptions) => FieldMapping;
-export declare const boolean: (options?: BooleanFieldOptions) => FieldMapping;
-export declare const binary: () => FieldMapping;
-export declare const ip: (options?: IpFieldOptions) => FieldMapping;
-export declare const denseVector: (options?: DenseVectorFieldOptions) => FieldMapping;
-export declare const geoPoint: (options?: GeoPointFieldOptions) => FieldMapping;
-export declare const geoShape: (options?: GeoShapeFieldOptions) => FieldMapping;
-export declare const completion: (options?: CompletionFieldOptions) => FieldMapping;
-export declare const nested: (fields?: NestedFields) => FieldMapping;
-export declare const object: (fields?: NestedFields, options?: ObjectFieldOptions) => FieldMapping;
-export declare const alias: (options?: AliasFieldOptions) => FieldMapping;
-export declare const percolator: () => FieldMapping;
-export declare const integerRange: (options?: RangeFieldOptions) => FieldMapping;
-export declare const floatRange: (options?: RangeFieldOptions) => FieldMapping;
-export declare const longRange: (options?: RangeFieldOptions) => FieldMapping;
-export declare const doubleRange: (options?: RangeFieldOptions) => FieldMapping;
-export declare const dateRange: (options?: RangeFieldOptions) => FieldMapping;
+import type { TextFieldOptions, KeywordFieldOptions, NumericFieldOptions, ScaledFloatFieldOptions, DateFieldOptions, BooleanFieldOptions, DenseVectorFieldOptions, NestedFields, ObjectFieldOptions, CompletionFieldOptions, GeoPointFieldOptions, GeoShapeFieldOptions, AliasFieldOptions, IpFieldOptions, RangeFieldOptions, MatchOnlyTextFieldOptions, SearchAsYouTypeFieldOptions, ConstantKeywordFieldOptions, WildcardFieldOptions, FlattenedFieldOptions, TextFieldMapping, KeywordFieldMapping, LongFieldMapping, IntegerFieldMapping, ShortFieldMapping, ByteFieldMapping, DoubleFieldMapping, FloatFieldMapping, HalfFloatFieldMapping, ScaledFloatFieldMapping, DateFieldMapping, BooleanFieldMapping, BinaryFieldMapping, IpFieldMapping, DenseVectorFieldMapping, GeoPointFieldMapping, GeoShapeFieldMapping, CompletionFieldMapping, NestedFieldMapping, ObjectFieldMapping, AliasFieldMapping, PercolatorFieldMapping, IntegerRangeFieldMapping, FloatRangeFieldMapping, LongRangeFieldMapping, DoubleRangeFieldMapping, DateRangeFieldMapping, MatchOnlyTextFieldMapping, SearchAsYouTypeFieldMapping, ConstantKeywordFieldMapping, WildcardFieldMapping, FlattenedFieldMapping } from './field.types.js';
+export declare const text: (options?: TextFieldOptions) => TextFieldMapping;
+export declare const keyword: (options?: KeywordFieldOptions) => KeywordFieldMapping;
+export declare const long: (options?: NumericFieldOptions) => LongFieldMapping;
+export declare const integer: (options?: NumericFieldOptions) => IntegerFieldMapping;
+export declare const short: (options?: NumericFieldOptions) => ShortFieldMapping;
+export declare const byte: (options?: NumericFieldOptions) => ByteFieldMapping;
+export declare const double: (options?: NumericFieldOptions) => DoubleFieldMapping;
+export declare const float: (options?: NumericFieldOptions) => FloatFieldMapping;
+export declare const halfFloat: (options?: NumericFieldOptions) => HalfFloatFieldMapping;
+export declare const scaledFloat: (options?: ScaledFloatFieldOptions) => ScaledFloatFieldMapping;
+export declare const date: (options?: DateFieldOptions) => DateFieldMapping;
+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;
 /**
- * Resolves a FieldMappingInput to a FieldMapping.
- * Converts shorthand strings like 'text' to { type: 'text' }.
+ * 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 = query(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;
+export declare const geoPoint: (options?: GeoPointFieldOptions) => GeoPointFieldMapping;
+export declare const geoShape: (options?: GeoShapeFieldOptions) => GeoShapeFieldMapping;
+export declare const completion: (options?: CompletionFieldOptions) => CompletionFieldMapping;
+export declare const nested: (fields?: NestedFields) => NestedFieldMapping;
+export declare const object: (fields?: NestedFields, options?: ObjectFieldOptions) => ObjectFieldMapping;
+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;
+/**
+ * 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: (options?: MatchOnlyTextFieldOptions) => MatchOnlyTextFieldMapping;
+/**
+ * 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 resolveField: (input: FieldMappingInput) => FieldMapping;
+export declare const flattened: (options?: FlattenedFieldOptions) => FlattenedFieldMapping;
 //# sourceMappingURL=field.helpers.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"field.helpers.d.ts","sourceRoot":"","sources":["../src/field.helpers.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,EACnB,uBAAuB,EACvB,gBAAgB,EAChB,mBAAmB,EACnB,uBAAuB,EACvB,YAAY,EACZ,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAG1B,eAAO,MAAM,IAAI,GAAI,UAAU,gBAAgB,KAAG,YAGhD,CAAC;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,mBAAmB,KAAG,YAGtD,CAAC;AAGH,eAAO,MAAM,IAAI,GAAI,UAAU,mBAAmB,KAAG,YAGnD,CAAC;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,mBAAmB,KAAG,YAGtD,CAAC;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,mBAAmB,KAAG,YAGpD,CAAC;AACH,eAAO,MAAM,IAAI,GAAI,UAAU,mBAAmB,KAAG,YAGnD,CAAC;AACH,eAAO,MAAM,MAAM,GAAI,UAAU,mBAAmB,KAAG,YAGrD,CAAC;AACH,eAAO,MAAM,KAAK,GAAI,UAAU,mBAAmB,KAAG,YAGpD,CAAC;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,mBAAmB,KAAG,YAGxD,CAAC;AACH,eAAO,MAAM,WAAW,GACtB,UAAU,uBAAuB,KAChC,YAAsD,CAAC;AAG1D,eAAO,MAAM,IAAI,GAAI,UAAU,gBAAgB,KAAG,YAGhD,CAAC;AACH,eAAO,MAAM,OAAO,GAAI,UAAU,mBAAmB,KAAG,YAGtD,CAAC;AAGH,eAAO,MAAM,MAAM,QAAO,YAAoC,CAAC;AAG/D,eAAO,MAAM,EAAE,GAAI,UAAU,cAAc,KAAG,YAG5C,CAAC;AAGH,eAAO,MAAM,WAAW,GACtB,UAAU,uBAAuB,KAChC,YAAsD,CAAC;AAG1D,eAAO,MAAM,QAAQ,GAAI,UAAU,oBAAoB,KAAG,YAGxD,CAAC;AACH,eAAO,MAAM,QAAQ,GAAI,UAAU,oBAAoB,KAAG,YAGxD,CAAC;AAGH,eAAO,MAAM,UAAU,GAAI,UAAU,sBAAsB,KAAG,YAG5D,CAAC;AAGH,eAAO,MAAM,MAAM,GAAI,SAAS,YAAY,KAAG,YAG7C,CAAC;AACH,eAAO,MAAM,MAAM,GACjB,SAAS,YAAY,EACrB,UAAU,kBAAkB,KAC3B,YAID,CAAC;AAGH,eAAO,MAAM,KAAK,GAAI,UAAU,iBAAiB,KAAG,YAGlD,CAAC;AAGH,eAAO,MAAM,UAAU,QAAO,YAAwC,CAAC;AAGvE,eAAO,MAAM,YAAY,GAAI,UAAU,iBAAiB,KAAG,YAGzD,CAAC;AACH,eAAO,MAAM,UAAU,GAAI,UAAU,iBAAiB,KAAG,YAGvD,CAAC;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,iBAAiB,KAAG,YAGtD,CAAC;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,iBAAiB,KAAG,YAGxD,CAAC;AACH,eAAO,MAAM,SAAS,GAAI,UAAU,iBAAiB,KAAG,YAGtD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,iBAAiB,KAAG,YACH,CAAC"}
+{"version":3,"file":"field.helpers.d.ts","sourceRoot":"","sources":["../src/field.helpers.ts"],"names":[],"mappings":"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"}

package/dist/field.helpers.js

@@ -1,18 +1,17 @@
 /**
  * Field type helper functions for ergonomic index mapping definitions.
- * Each helper returns a FieldMapping with `type` pre-filled and only accepts
- * options relevant to that specific field type.
+ * 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 } from 'elasticlink';
+ * import { text, keyword, denseVector, mappings } from 'elasticlink';
  *
- * indexBuilder<Product>()
- *   .mappings({
- *     name: text({ analyzer: 'standard' }),
- *     price: 'float',
- *     category: 'keyword',
- *     embedding: denseVector({ dims: 384 }),
- *   })
+ * const productMappings = mappings({
+ *   name: text({ analyzer: 'standard' }),
+ *   price: float(),
+ *   category: keyword(),
+ *   embedding: denseVector({ dims: 384 }),
+ * });
  */
 // Text & keyword
 export const text = (options) => ({
@@ -52,7 +51,10 @@ export const halfFloat = (options) => ({
     type: 'half_float',
     ...options
 });
-export const scaledFloat = (options) => ({ type: 'scaled_float', ...options });
+export const scaledFloat = (options) => ({
+    type: 'scaled_float',
+    ...options
+});
 // Date & boolean
 export const date = (options) => ({
     type: 'date',
@@ -63,6 +65,7 @@ export const boolean = (options) => ({
     ...options
 });
 // Binary
+// eslint-disable-next-line functional/functional-parameters
 export const binary = () => ({ type: 'binary' });
 // IP
 export const ip = (options) => ({
@@ -70,7 +73,46 @@ export const ip = (options) => ({
     ...options
 });
 // Vector
-export const denseVector = (options) => ({ type: 'dense_vector', ...options });
+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 = query(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 }
+});
 // Geo
 export const geoPoint = (options) => ({
     type: 'geo_point',
@@ -88,12 +130,12 @@ export const completion = (options) => ({
 // Structured
 export const nested = (fields) => ({
     type: 'nested',
-    ...(fields && { properties: resolveProperties(fields) })
+    ...(fields && { properties: fields })
 });
 export const object = (fields, options) => ({
     type: 'object',
-    ...(options?.enabled !== undefined && { enabled: options.enabled }),
-    ...(fields && { properties: resolveProperties(fields) })
+    ...(options && options),
+    ...(fields && { properties: fields })
 });
 // Alias
 export const alias = (options) => ({
@@ -101,7 +143,10 @@ export const alias = (options) => ({
     ...options
 });
 // Percolator
-export const percolator = () => ({ type: 'percolator' });
+// eslint-disable-next-line functional/functional-parameters
+export const percolator = () => ({
+    type: 'percolator'
+});
 // Range types
 export const integerRange = (options) => ({
     type: 'integer_range',
@@ -124,8 +169,42 @@ export const dateRange = (options) => ({
     ...options
 });
 /**
- * Resolves a FieldMappingInput to a FieldMapping.
- * Converts shorthand strings like 'text' to { type: 'text' }.
+ * 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 resolveField = (input) => typeof input === 'string' ? { type: input } : input;
-const resolveProperties = (props) => Object.fromEntries(Object.entries(props).map(([k, v]) => [k, resolveField(v)]));
+export const matchOnlyText = (options) => ({
+    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
+});

package/dist/field.types.d.ts

@@ -1,9 +1,9 @@
 /**
- * Per-field-type option types for field helper functions.
- * Each type only includes options relevant to that specific field type,
- * providing type-safe autocomplete in helper functions.
+ * Per-field-type option types and narrowly-typed mapping return types.
+ * Each helper function returns a mapping with a literal `type` field,
+ * enabling compile-time field-type inference in the query builder.
  */
-import type { FieldMapping, FieldMappingInput } from './index-management.types.js';
+import type { FieldMapping } from './index-management.types.js';
 /** Options for text fields */
 export type TextFieldOptions = {
     analyzer?: string;
@@ -14,6 +14,14 @@ export type TextFieldOptions = {
     doc_values?: boolean;
     similarity?: string;
     fields?: Record<string, FieldMapping>;
+    copy_to?: string | string[];
+    index_prefixes?: {
+        min_chars?: number;
+        max_chars?: number;
+    };
+    index_phrases?: boolean;
+    eager_global_ordinals?: boolean;
+    term_vector?: 'no' | 'yes' | 'with_positions' | 'with_offsets' | 'with_positions_offsets' | 'with_positions_payloads' | 'with_positions_offsets_payloads';
 };
 /** Options for keyword fields */
 export type KeywordFieldOptions = {
@@ -24,6 +32,10 @@ export type KeywordFieldOptions = {
     similarity?: string;
     normalizer?: string;
     fields?: Record<string, FieldMapping>;
+    copy_to?: string | string[];
+    null_value?: string;
+    eager_global_ordinals?: boolean;
+    ignore_above?: number;
 };
 /** Options shared by numeric field types (long, integer, short, byte, double, float, half_float) */
 export type NumericFieldOptions = {
@@ -33,6 +45,9 @@ export type NumericFieldOptions = {
     doc_values?: boolean;
     coerce?: boolean;
     fields?: Record<string, FieldMapping>;
+    copy_to?: string | string[];
+    null_value?: number;
+    ignore_malformed?: boolean;
 };
 /** Options for scaled_float (extends numeric with scaling_factor) */
 export type ScaledFloatFieldOptions = NumericFieldOptions & {
@@ -46,6 +61,9 @@ export type DateFieldOptions = {
     store?: boolean;
     doc_values?: boolean;
     fields?: Record<string, FieldMapping>;
+    copy_to?: string | string[];
+    null_value?: string;
+    ignore_malformed?: boolean;
 };
 /** Options for boolean fields */
 export type BooleanFieldOptions = {
@@ -53,6 +71,7 @@ export type BooleanFieldOptions = {
     index?: boolean;
     store?: boolean;
     doc_values?: boolean;
+    null_value?: boolean;
 };
 /** Options for dense_vector fields */
 export type DenseVectorFieldOptions = {
@@ -63,7 +82,7 @@ export type DenseVectorFieldOptions = {
     similarity?: 'cosine' | 'dot_product' | 'l2_norm' | 'max_inner_product';
 };
 /** Sub-fields for nested and object field types */
-export type NestedFields = Record<string, FieldMappingInput>;
+export type NestedFields = Record<string, FieldMapping>;
 /** Options for object fields (enabled flag only — sub-fields are the first argument) */
 export type ObjectFieldOptions = {
     enabled?: boolean;
@@ -81,6 +100,7 @@ export type GeoPointFieldOptions = {
     index?: boolean;
     store?: boolean;
     doc_values?: boolean;
+    ignore_malformed?: boolean;
 };
 /** Options for geo_shape fields */
 export type GeoShapeFieldOptions = {
@@ -92,7 +112,7 @@ export type GeoShapeFieldOptions = {
 };
 /** Options for alias fields */
 export type AliasFieldOptions = {
-    path?: string;
+    path: string;
 };
 /** Options for ip fields */
 export type IpFieldOptions = {
@@ -100,6 +120,8 @@ export type IpFieldOptions = {
     index?: boolean;
     store?: boolean;
     doc_values?: boolean;
+    null_value?: string;
+    ignore_malformed?: boolean;
 };
 /** Options for range fields (integer_range, float_range, long_range, double_range, date_range) */
 export type RangeFieldOptions = {
@@ -109,4 +131,89 @@ export type RangeFieldOptions = {
     doc_values?: boolean;
     coerce?: boolean;
 };
+/**
+ * Options for match_only_text fields.
+ * Use when you only need filter/match but not relevance scoring — faster and uses less disk.
+ */
+export type MatchOnlyTextFieldOptions = {
+    fields?: Record<string, FieldMapping>;
+    copy_to?: string | string[];
+    meta?: Record<string, string>;
+};
+/**
+ * Options for search_as_you_type fields.
+ * Provides out-of-the-box autocomplete / typeahead capabilities.
+ */
+export type SearchAsYouTypeFieldOptions = {
+    analyzer?: string;
+    search_analyzer?: string;
+    max_shingle_size?: number;
+    index?: boolean;
+    similarity?: string;
+};
+/**
+ * Options for constant_keyword fields.
+ * Every document in the index has the same value for this field.
+ * Useful for multi-index queries to identify the index type.
+ */
+export type ConstantKeywordFieldOptions = {
+    value?: string;
+};
+/**
+ * Options for wildcard fields.
+ * Optimized for grep-like wildcard/regexp queries on high-cardinality or large fields.
+ * Use instead of keyword when leading wildcards (`*foo`) are needed.
+ */
+export type WildcardFieldOptions = {
+    null_value?: string;
+    ignore_above?: number;
+};
+/**
+ * Options for flattened fields.
+ * Flattens complex/dynamic objects into a single field. Faster than nested,
+ * but only supports keyword-level queries on inner values.
+ */
+export type FlattenedFieldOptions = {
+    depth_limit?: number;
+    doc_values?: boolean;
+    index?: boolean;
+    null_value?: string;
+    similarity?: string;
+    eager_global_ordinals?: boolean;
+};
+export type TypedFieldMapping<T extends string> = Omit<FieldMapping, 'type'> & {
+    type: T;
+};
+export type TextFieldMapping = TypedFieldMapping<'text'>;
+export type KeywordFieldMapping = TypedFieldMapping<'keyword'>;
+export type LongFieldMapping = TypedFieldMapping<'long'>;
+export type IntegerFieldMapping = TypedFieldMapping<'integer'>;
+export type ShortFieldMapping = TypedFieldMapping<'short'>;
+export type ByteFieldMapping = TypedFieldMapping<'byte'>;
+export type DoubleFieldMapping = TypedFieldMapping<'double'>;
+export type FloatFieldMapping = TypedFieldMapping<'float'>;
+export type HalfFloatFieldMapping = TypedFieldMapping<'half_float'>;
+export type ScaledFloatFieldMapping = TypedFieldMapping<'scaled_float'>;
+export type DateFieldMapping = TypedFieldMapping<'date'>;
+export type BooleanFieldMapping = TypedFieldMapping<'boolean'>;
+export type BinaryFieldMapping = TypedFieldMapping<'binary'>;
+export type IpFieldMapping = TypedFieldMapping<'ip'>;
+export type DenseVectorFieldMapping = TypedFieldMapping<'dense_vector'>;
+export type GeoPointFieldMapping = TypedFieldMapping<'geo_point'>;
+export type GeoShapeFieldMapping = TypedFieldMapping<'geo_shape'>;
+export type CompletionFieldMapping = TypedFieldMapping<'completion'>;
+export type NestedFieldMapping = TypedFieldMapping<'nested'>;
+export type ObjectFieldMapping = TypedFieldMapping<'object'>;
+export type AliasFieldMapping = TypedFieldMapping<'alias'>;
+export type PercolatorFieldMapping = TypedFieldMapping<'percolator'>;
+export type IntegerRangeFieldMapping = TypedFieldMapping<'integer_range'>;
+export type FloatRangeFieldMapping = TypedFieldMapping<'float_range'>;
+export type LongRangeFieldMapping = TypedFieldMapping<'long_range'>;
+export type DoubleRangeFieldMapping = TypedFieldMapping<'double_range'>;
+export type DateRangeFieldMapping = TypedFieldMapping<'date_range'>;
+export type MatchOnlyTextFieldMapping = TypedFieldMapping<'match_only_text'>;
+export type SearchAsYouTypeFieldMapping = TypedFieldMapping<'search_as_you_type'>;
+export type ConstantKeywordFieldMapping = TypedFieldMapping<'constant_keyword'>;
+export type WildcardFieldMapping = TypedFieldMapping<'wildcard'>;
+export type FlattenedFieldMapping = TypedFieldMapping<'flattened'>;
 //# sourceMappingURL=field.types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"field.types.d.ts","sourceRoot":"","sources":["../src/field.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AAErC,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,oGAAoG;AACpG,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,uBAAuB,GAAG,mBAAmB,GAAG;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACvC,CAAC;AAEF,iCAAiC;AACjC,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,sCAAsC;AACtC,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;IACxC,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,mBAAmB,CAAC;CACzE,CAAC;AAEF,mDAAmD;AACnD,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAE7D,wFAAwF;AACxF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,oCAAoC;AACpC,MAAM,MAAM,sBAAsB,GAAG;IACnC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4BAA4B,CAAC,EAAE,OAAO,CAAC;CACxC,CAAC;AAEF,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,mCAAmC;AACnC,MAAM,MAAM,oBAAoB,GAAG;IACjC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC;AAEF,+BAA+B;AAC/B,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,4BAA4B;AAC5B,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,kGAAkG;AAClG,MAAM,MAAM,iBAAiB,GAAG;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC"}
+{"version":3,"file":"field.types.d.ts","sourceRoot":"","sources":["../src/field.types.ts"],"names":[],"mappings":"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"}

package/dist/field.types.js

@@ -1,6 +1,6 @@
 /**
- * Per-field-type option types for field helper functions.
- * Each type only includes options relevant to that specific field type,
- * providing type-safe autocomplete in helper functions.
+ * Per-field-type option types and narrowly-typed mapping return types.
+ * Each helper function returns a mapping with a literal `type` field,
+ * enabling compile-time field-type inference in the query builder.
  */
 export {};

package/dist/index-management.builder.d.ts

@@ -7,22 +7,27 @@ import type { IndexBuilder, CreateIndexOptions } from './index-management.types.
  * Creates an index builder
  * @returns IndexBuilder instance
  */
-export declare const createIndexBuilder: <T>(state?: CreateIndexOptions<T>) => IndexBuilder<T>;
+export declare const createIndexBuilder: (state?: CreateIndexOptions) => IndexBuilder;
 /**
- * Create a new index builder
+ * Create a new index builder for Elasticsearch index configuration.
+ *
+ * Typical lifecycle:
+ * 1. **Create index:** `indexBuilder().mappings(schema).settings(productionSearchSettings()).build()`
+ * 2. **Bulk ingest:** Apply `fastIngestSettings()` via ES `_settings` API → bulk index →
+ *    apply `productionSearchSettings()` → `POST /index/_refresh`
+ * 3. **Normal operations:** Query, update individual docs via `_update` API
+ * 4. **Migration with mapping changes:** Create new index with new mappings → `POST _reindex`
+ *    from old → atomically swap alias via `POST _aliases` → delete old index
+ *
+ * After bulk loading, remember to refresh the index with `POST /index/_refresh`
+ * to make all documents searchable.
+ *
  * @example
- * const indexConfig = indexBuilder<Product>()
- *   .mappings({
- *     name: text({ analyzer: 'standard' }),
- *     price: 'float',
- *     category: 'keyword',
- *   })
- *   .settings({
- *     number_of_shards: 1,
- *     number_of_replicas: 1
- *   })
- *   .alias('products_alias')
+ * const indexConfig = indexBuilder()
+ *   .mappings(productMappings)
+ *   .settings(productionSearchSettings())
+ *   .alias('products')
  *   .build();
  */
-export declare const indexBuilder: <T>() => IndexBuilder<T>;
+export declare const indexBuilder: () => IndexBuilder;
 //# sourceMappingURL=index-management.builder.d.ts.map

package/dist/index-management.builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-management.builder.d.ts","sourceRoot":"","sources":["../src/index-management.builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAKnB,MAAM,6BAA6B,CAAC;AAwBrC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,CAAC,EAClC,QAAO,kBAAkB,CAAC,CAAC,CAAM,KAChC,YAAY,CAAC,CAAC,CAqBf,CAAC;AAEH;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,sBAA8B,CAAC"}
+{"version":3,"file":"index-management.builder.d.ts","sourceRoot":"","sources":["../src/index-management.builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAiC,YAAY,EAAE,kBAAkB,EAAE,MAAM,6BAA6B,CAAC;AAOnH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAO,kBAAuB,KAAG,YAiClE,CAAC;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,eAAO,MAAM,YAAY,oBAA6B,CAAC"}