elasticlink 0.3.0-beta → 0.4.0-beta

package/dist/field.helpers.js

@@ -51,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',
@@ -62,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) => ({
@@ -69,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',
@@ -91,7 +134,7 @@ export const nested = (fields) => ({
 });
 export const object = (fields, options) => ({
     type: 'object',
-    ...(options?.enabled !== undefined && { enabled: options.enabled }),
+    ...(options && options),
     ...(fields && { properties: fields })
 });
 // Alias
@@ -100,6 +143,7 @@ export const alias = (options) => ({
     ...options
 });
 // Percolator
+// eslint-disable-next-line functional/functional-parameters
 export const percolator = () => ({
     type: 'percolator'
 });
@@ -124,4 +168,43 @@ export const dateRange = (options) => ({
     type: 'date_range',
     ...options
 });
-export const resolveField = (input) => input;
+/**
+ * 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) => ({
+    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

@@ -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 = {
@@ -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,6 +131,56 @@ 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;
 };
@@ -139,4 +211,9 @@ 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":"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"}
+{"version":3,"file":"field.types.d.ts","sourceRoot":"","sources":["../src/field.types.ts"],"names":[],"mappings":"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"}

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

@@ -9,12 +9,24 @@ import type { IndexBuilder, CreateIndexOptions } from './index-management.types.
  */
 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()
  *   .mappings(productMappings)
- *   .settings({ number_of_shards: 1, number_of_replicas: 1 })
- *   .alias('products_alias')
+ *   .settings(productionSearchSettings())
+ *   .alias('products')
  *   .build();
  */
 export declare const indexBuilder: () => IndexBuilder;

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,EAGV,YAAY,EACZ,kBAAkB,EACnB,MAAM,6BAA6B,CAAC;AAUrC;;;GAGG;AACH,eAAO,MAAM,kBAAkB,GAC7B,QAAO,kBAAuB,KAC7B,YAsBD,CAAC;AAEH;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,oBAA6B,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"}

package/dist/index-management.builder.js

@@ -8,13 +8,23 @@ const isMappingsSchema = (input) => '_fieldTypes' in input;
  * @returns IndexBuilder instance
  */
 export const createIndexBuilder = (state = {}) => ({
-    mappings: (schemaOrFields) => {
-        const properties = isMappingsSchema(schemaOrFields)
-            ? schemaOrFields.properties
-            : schemaOrFields;
+    mappings: (schemaOrFields, inlineOptions) => {
+        const rawProperties = isMappingsSchema(schemaOrFields) ? schemaOrFields.properties : schemaOrFields;
+        const properties = Object.fromEntries(Object.entries(rawProperties).filter(([, v]) => v !== undefined));
+        const schemaOptions = isMappingsSchema(schemaOrFields) ? schemaOrFields._mappingOptions : undefined;
+        const mappingOptions = {
+            dynamic: 'strict',
+            ...schemaOptions,
+            ...inlineOptions
+        };
         return createIndexBuilder({
             ...state,
-            mappings: { properties }
+            mappings: {
+                properties,
+                ...(mappingOptions.dynamic !== undefined && { dynamic: mappingOptions.dynamic }),
+                ...(mappingOptions._source !== undefined && { _source: mappingOptions._source }),
+                ...(mappingOptions._meta && { _meta: mappingOptions._meta })
+            }
         });
     },
     settings: (settings) => createIndexBuilder({ ...state, settings }),
@@ -25,15 +35,29 @@ export const createIndexBuilder = (state = {}) => ({
             aliases: { ...aliases, [name]: options }
         });
     },
+    // eslint-disable-next-line functional/functional-parameters
     build: () => state
 });
 /**
- * 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()
  *   .mappings(productMappings)
- *   .settings({ number_of_shards: 1, number_of_replicas: 1 })
- *   .alias('products_alias')
+ *   .settings(productionSearchSettings())
+ *   .alias('products')
  *   .build();
  */
+// eslint-disable-next-line functional/functional-parameters
 export const indexBuilder = () => createIndexBuilder();

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

@@ -4,11 +4,11 @@
  * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/indices.html
  */
 import type { IndicesIndexSettings, IndicesAlias } from '@elastic/elasticsearch/lib/api/types';
-import type { MappingsSchema } from './mapping.types.js';
+import type { MappingsSchema, MappingOptions } from './mapping.types.js';
 /**
  * All supported Elasticsearch field type strings.
  */
-export type FieldTypeString = 'text' | 'keyword' | 'long' | 'integer' | 'short' | 'byte' | 'double' | 'float' | 'half_float' | 'scaled_float' | 'date' | 'boolean' | 'binary' | 'integer_range' | 'float_range' | 'long_range' | 'double_range' | 'date_range' | 'ip' | 'alias' | 'object' | 'nested' | 'geo_point' | 'geo_shape' | 'completion' | 'dense_vector' | 'percolator';
+export type FieldTypeString = 'text' | 'match_only_text' | 'keyword' | 'constant_keyword' | 'wildcard' | 'long' | 'integer' | 'short' | 'byte' | 'double' | 'float' | 'half_float' | 'scaled_float' | 'date' | 'boolean' | 'binary' | 'integer_range' | 'float_range' | 'long_range' | 'double_range' | 'date_range' | 'ip' | 'alias' | 'object' | 'nested' | 'flattened' | 'geo_point' | 'geo_shape' | 'completion' | 'search_as_you_type' | 'dense_vector' | 'percolator';
 /**
  * Field mapping definition.
  */
@@ -36,6 +36,28 @@ export type FieldMapping = {
     preserve_separators?: boolean;
     preserve_position_increments?: boolean;
     orientation?: string;
+    copy_to?: string | string[];
+    index_prefixes?: {
+        min_chars?: number;
+        max_chars?: number;
+    };
+    index_phrases?: boolean;
+    ignore_malformed?: boolean;
+    null_value?: string | number | boolean;
+    eager_global_ordinals?: boolean;
+    term_vector?: string;
+    ignore_above?: number;
+    max_shingle_size?: number;
+    value?: string;
+    depth_limit?: number;
+};
+/**
+ * _source field configuration for index mappings.
+ */
+export type SourceConfig = {
+    enabled?: boolean;
+    includes?: string[];
+    excludes?: string[];
 };
 /**
  * Index mappings configuration.
@@ -44,6 +66,8 @@ export type IndexMappings = {
     properties: Record<string, FieldMapping>;
     dynamic?: boolean | 'strict' | 'runtime';
     dynamic_templates?: any[];
+    _source?: SourceConfig;
+    _meta?: Record<string, unknown>;
 };
 /**
  * Index settings configuration — re-exported from official @elastic/elasticsearch types
@@ -62,7 +86,7 @@ export type CreateIndexOptions = {
  * Index builder interface
  */
 export type IndexBuilder = {
-    mappings: (schemaOrFields: MappingsSchema<Record<string, FieldTypeString>> | Record<string, FieldMapping>) => IndexBuilder;
+    mappings: (schemaOrFields: MappingsSchema<Record<string, FieldTypeString>> | Record<string, FieldMapping>, options?: MappingOptions) => IndexBuilder;
     settings: (settings: IndexSettings) => IndexBuilder;
     alias: (name: string, options?: IndicesAlias) => IndexBuilder;
     build: () => CreateIndexOptions;

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

@@ -1 +1 @@
-{"version":3,"file":"index-management.types.d.ts","sourceRoot":"","sources":["../src/index-management.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,oBAAoB,EACpB,YAAY,EACb,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,SAAS,GACT,MAAM,GACN,SAAS,GACT,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,cAAc,GACd,MAAM,GACN,SAAS,GACT,QAAQ,GACR,eAAe,GACf,aAAa,GACb,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,WAAW,GACX,YAAY,GACZ,cAAc,GACd,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,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,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEzC,iBAAiB,CAAC,EAAE,GAAG,EAAE,CAAC;CAC3B,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,CACR,cAAc,EACV,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAC/C,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAC7B,YAAY,CAAC;IAClB,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,YAAY,CAAC;IACpD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,KAAK,EAAE,MAAM,kBAAkB,CAAC;CACjC,CAAC"}
+{"version":3,"file":"index-management.types.d.ts","sourceRoot":"","sources":["../src/index-management.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;GAEG;AACH,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,iBAAiB,GACjB,SAAS,GACT,kBAAkB,GAClB,UAAU,GACV,MAAM,GACN,SAAS,GACT,OAAO,GACP,MAAM,GACN,QAAQ,GACR,OAAO,GACP,YAAY,GACZ,cAAc,GACd,MAAM,GACN,SAAS,GACT,QAAQ,GACR,eAAe,GACf,aAAa,GACb,YAAY,GACZ,cAAc,GACd,YAAY,GACZ,IAAI,GACJ,OAAO,GACP,QAAQ,GACR,QAAQ,GACR,WAAW,GACX,WAAW,GACX,WAAW,GACX,YAAY,GACZ,oBAAoB,GACpB,cAAc,GACd,YAAY,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACtC,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,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,aAAa,CAAC,EAAE,GAAG,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC1C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;IACvC,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAC;IAEzC,iBAAiB,CAAC,EAAE,GAAG,EAAE,CAAC;IAC1B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,oBAAoB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;CACxC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,EAAE,CACR,cAAc,EAAE,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,EAC9F,OAAO,CAAC,EAAE,cAAc,KACrB,YAAY,CAAC;IAClB,QAAQ,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,YAAY,CAAC;IACpD,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,KAAK,YAAY,CAAC;IAC9D,KAAK,EAAE,MAAM,kBAAkB,CAAC;CACjC,CAAC"}

package/dist/index.d.ts

@@ -5,8 +5,8 @@ export type { QueryBuilder, ClauseBuilder } from './query.types.js';
 export { aggregations } from './aggregation.builder.js';
 export type { AggregationBuilder } from './aggregation.types.js';
 export { mappings } from './mapping.builder.js';
-export { text, keyword, long, integer, short, byte, double, float, halfFloat, scaledFloat, date, boolean, binary, ip, denseVector, geoPoint, geoShape, completion, nested, object, alias, percolator, integerRange, floatRange, longRange, doubleRange, dateRange } from './field.helpers.js';
-export type { MappingsSchema, Infer, FieldsOfType, TextFields, KeywordFields, NumericFields, DateFields, BooleanFields, GeoPointFields, VectorFields } from './mapping.types.js';
+export { text, keyword, long, integer, short, byte, double, float, halfFloat, scaledFloat, date, boolean, binary, ip, denseVector, geoPoint, geoShape, completion, nested, object, alias, percolator, integerRange, floatRange, longRange, doubleRange, dateRange, matchOnlyText, searchAsYouType, constantKeyword, wildcardField, flattened, quantizedDenseVector } from './field.helpers.js';
+export type { MappingsSchema, Infer, FieldsOfType, TextFields, KeywordFields, NumericFields, DateFields, BooleanFields, GeoPointFields, VectorFields, IpFields } from './mapping.types.js';
 export { msearch } from './multi-search.builder.js';
 export type { MSearchBuilder } from './multi-search.types.js';
 export { bulk } from './bulk.builder.js';
@@ -15,4 +15,5 @@ export { indexBuilder } from './index-management.builder.js';
 export type { IndexBuilder } from './index-management.types.js';
 export { suggest } from './suggester.builder.js';
 export type { SuggesterBuilder } from './suggester.types.js';
+export { productionSearchSettings, indexSortSettings, fastIngestSettings } from './settings.presets.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7D,SAAS,cAAc,CAAC,CAAC,CAAC,EAC1B,eAAc,OAAc,+CAC6B,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,SAAS,EACT,WAAW,EACX,IAAI,EACJ,OAAO,EACP,MAAM,EACN,EAAE,EACF,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,MAAM,EACN,MAAM,EACN,KAAK,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACV,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,KAAK,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,eAAO,MAAM,KAAK,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC7D,SAAS,cAAc,CAAC,CAAC,CAAC,EAC1B,eAAc,OAAc,+CAC6B,CAAC;AAC5D,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAGpE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,YAAY,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGjE,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAChD,OAAO,EACL,IAAI,EACJ,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,IAAI,EACJ,MAAM,EACN,KAAK,EACL,SAAS,EACT,WAAW,EACX,IAAI,EACJ,OAAO,EACP,MAAM,EACN,EAAE,EACF,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,MAAM,EACN,MAAM,EACN,KAAK,EACL,UAAU,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,WAAW,EACX,SAAS,EACT,aAAa,EACb,eAAe,EACf,eAAe,EACf,aAAa,EACb,SAAS,EACT,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,cAAc,EACd,KAAK,EACL,YAAY,EACZ,UAAU,EACV,aAAa,EACb,aAAa,EACb,UAAU,EACV,aAAa,EACb,cAAc,EACd,YAAY,EACZ,QAAQ,EACT,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,YAAY,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAG9D,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AACzC,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAGnD,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAC7D,YAAY,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/index.js

@@ -5,7 +5,7 @@ export const query = (_schema, includeQuery = true) => createQueryBuilder({ _inc
 export { aggregations } from './aggregation.builder.js';
 // Mappings API
 export { mappings } from './mapping.builder.js';
-export { text, keyword, long, integer, short, byte, double, float, halfFloat, scaledFloat, date, boolean, binary, ip, denseVector, geoPoint, geoShape, completion, nested, object, alias, percolator, integerRange, floatRange, longRange, doubleRange, dateRange } from './field.helpers.js';
+export { text, keyword, long, integer, short, byte, double, float, halfFloat, scaledFloat, date, boolean, binary, ip, denseVector, geoPoint, geoShape, completion, nested, object, alias, percolator, integerRange, floatRange, longRange, doubleRange, dateRange, matchOnlyText, searchAsYouType, constantKeyword, wildcardField, flattened, quantizedDenseVector } from './field.helpers.js';
 // Multi-search API
 export { msearch } from './multi-search.builder.js';
 // Bulk API
@@ -14,3 +14,5 @@ export { bulk } from './bulk.builder.js';
 export { indexBuilder } from './index-management.builder.js';
 // Suggester API
 export { suggest } from './suggester.builder.js';
+// Settings Presets
+export { productionSearchSettings, indexSortSettings, fastIngestSettings } from './settings.presets.js';

package/dist/mapping.builder.d.ts

@@ -2,23 +2,36 @@
  * Mappings builder — creates a MappingsSchema artifact from field helper functions.
  * The schema carries field-type info at compile time and ES-compatible properties at runtime.
  *
+ * Defaults to `dynamic: 'strict'` to prevent unmapped fields from being silently
+ * indexed. Override with `mappings(fields, { dynamic: true })` if needed.
+ *
  * @example
- * import { mappings, text, keyword, float } from 'elasticlink';
+ * import { mappings, text, keyword, float, denseVector } from 'elasticlink';
  *
  * const productMappings = mappings({
  *   name: text({ analyzer: 'standard' }),
  *   category: keyword(),
  *   price: float(),
  * });
+ * // dynamic: 'strict' by default — unknown fields cause an indexing error
+ *
+ * @example
+ * // Exclude dense_vector fields from _source to reduce response size
+ * const searchMappings = mappings({
+ *   title: text(),
+ *   embedding: denseVector({ dims: 768 }),
+ * }, {
+ *   _source: { excludes: ['embedding'] },
+ * });
  */
 import type { FieldMapping, FieldTypeString } from './index-management.types.js';
-import type { MappingsSchema } from './mapping.types.js';
+import type { MappingOptions, MappingsSchema } from './mapping.types.js';
 type FieldMappingWithLiteralType = FieldMapping & {
     type: FieldTypeString;
 };
 type ExtractFieldTypes<F extends Record<string, FieldMappingWithLiteralType>> = {
     [K in keyof F]: F[K]['type'];
 };
-export declare const mappings: <F extends Record<string, FieldMappingWithLiteralType>>(fields: F) => MappingsSchema<ExtractFieldTypes<F>>;
+export declare const mappings: <F extends Record<string, FieldMappingWithLiteralType>>(fields: F, options?: MappingOptions) => MappingsSchema<ExtractFieldTypes<F>>;
 export {};
 //# sourceMappingURL=mapping.builder.d.ts.map

package/dist/mapping.builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mapping.builder.d.ts","sourceRoot":"","sources":["../src/mapping.builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,eAAe,EAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,KAAK,2BAA2B,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE5E,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,IAC1E;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;CAC7B,CAAC;AAEJ,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC5E,QAAQ,CAAC,KACR,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,CASrC,CAAC"}
+{"version":3,"file":"mapping.builder.d.ts","sourceRoot":"","sources":["../src/mapping.builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACjF,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE,KAAK,2BAA2B,GAAG,YAAY,GAAG;IAAE,IAAI,EAAE,eAAe,CAAA;CAAE,CAAC;AAE5E,KAAK,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,IAAI;KAC7E,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAC5E,QAAQ,CAAC,EACT,UAAU,cAAc,KACvB,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAarC,CAAC"}

package/dist/mapping.builder.js

@@ -2,22 +2,37 @@
  * Mappings builder — creates a MappingsSchema artifact from field helper functions.
  * The schema carries field-type info at compile time and ES-compatible properties at runtime.
  *
+ * Defaults to `dynamic: 'strict'` to prevent unmapped fields from being silently
+ * indexed. Override with `mappings(fields, { dynamic: true })` if needed.
+ *
  * @example
- * import { mappings, text, keyword, float } from 'elasticlink';
+ * import { mappings, text, keyword, float, denseVector } from 'elasticlink';
  *
  * const productMappings = mappings({
  *   name: text({ analyzer: 'standard' }),
  *   category: keyword(),
  *   price: float(),
  * });
+ * // dynamic: 'strict' by default — unknown fields cause an indexing error
+ *
+ * @example
+ * // Exclude dense_vector fields from _source to reduce response size
+ * const searchMappings = mappings({
+ *   title: text(),
+ *   embedding: denseVector({ dims: 768 }),
+ * }, {
+ *   _source: { excludes: ['embedding'] },
+ * });
  */
-export const mappings = (fields) => {
-    const properties = {};
-    for (const key of Object.keys(fields)) {
-        properties[key] = fields[key];
-    }
+export const mappings = (fields, options) => {
+    const properties = { ...fields };
+    const mappingOptions = {
+        dynamic: 'strict',
+        ...options
+    };
     return {
         _fieldTypes: undefined,
-        properties
+        properties,
+        _mappingOptions: mappingOptions
     };
 };