elasticlink 0.3.0-beta → 0.4.1-beta

package/README.md

@@ -24,6 +24,7 @@ elasticlink simplifies building Elasticsearch queries and index management in Ty
 
 | elasticlink | Node.js     | Elasticsearch |
 |-------------|-------------|---------------|
+| 0.4.0-beta  | 20, 22, 24  | 9.x (≥9.0.0)  |
 | 0.3.0-beta  | 20, 22, 24  | 9.x (≥9.0.0)  |
 | 0.2.0-beta  | 20, 22      | 9.x (≥9.0.0)  |
 | 0.1.0-beta  | 20, 22      | 9.x (≥9.0.0)  |
@@ -76,7 +77,12 @@ const response = await client.search({ index: 'products', ...q });
 - `match(field, value, options?)` - Full-text search
 - `multiMatch(fields, query, options?)` - Search multiple fields
 - `matchPhrase(field, query)` - Exact phrase matching
-- `matchPhrasePrefix(field, query, options?)` - Prefix phrase matching (search-as-you-type)
+- `matchPhrasePrefix(field, query, options?)` - Prefix phrase matching
+- `matchBoolPrefix(field, value, options?)` - Analyze and build a bool query from query terms, with the last term as a prefix (search-as-you-type)
+- `combinedFields(fields, query, options?)` - Search across multiple fields treating them as one combined field
+- `queryString(query, options?)` - Lucene query string syntax
+- `simpleQueryString(query, options?)` - Simplified query string syntax with limited operators
+- `moreLikeThis(fields, like, options?)` - Find documents similar to a given document or text
 - `term(field, value)` - Exact term matching
 - `terms(field, values)` - Multiple exact values
 - `range(field, conditions)` - Range queries (gte, lte, gt, lt)
@@ -212,8 +218,6 @@ const standaloneAgg = aggregations(productMappings)
 
 ### Vector Search & Semantic Search
 
-**Requires Elasticsearch 8.0+**
-
 KNN (k-nearest neighbors) queries enable semantic search using vector embeddings from machine learning models.
 
 ```typescript
@@ -348,6 +352,8 @@ const customScored = query(scoredProductMappings)
 Percolate queries enable reverse search - match documents against stored queries. Perfect for alerting, content classification, and saved searches.
 
 ```typescript
+import { query, mappings, keyword, percolator } from 'elasticlink';
+
 const alertRuleMappings = mappings({
   query: percolator(),
   name: keyword(),
@@ -612,17 +618,18 @@ denseVector({ dims: 384, index: true, similarity: 'cosine' })
 
 #### Field Types (25+ supported)
 
-| Category    | Helpers                                                                                                 |
-| ----------- | ------------------------------------------------------------------------------------------------------- |
-| Text        | `text`, `keyword`, `constantKeyword`                                                                    |
-| Numeric     | `long`, `integer`, `short`, `byte`, `double`, `float`, `halfFloat`, `scaledFloat`                       |
-| Date        | `date`, `dateNanos`                                                                                     |
-| Boolean     | `boolean`                                                                                               |
-| Range       | `integerRange`, `floatRange`, `longRange`, `doubleRange`, `dateRange`                                   |
-| Objects     | `object`, `nested`, `flattened`                                                                         |
-| Spatial     | `geoPoint`, `geoShape`                                                                                  |
-| Specialized | `ip`, `completion`, `tokenCount`, `denseVector`, `rankFeature`, `rankFeatures`, `binary`, `percolator`  |
-| Alias       | `alias`                                                                                                 |
+| Category    | Helpers                                                                                                                       |
+| ----------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| Text        | `text`, `keyword`, `constantKeyword`, `matchOnlyText`, `searchAsYouType`, `wildcardField`                                     |
+| Numeric     | `long`, `integer`, `short`, `byte`, `double`, `float`, `halfFloat`, `scaledFloat`                                             |
+| Date        | `date`                                                                                                                        |
+| Boolean     | `boolean`                                                                                                                     |
+| Range       | `integerRange`, `floatRange`, `longRange`, `doubleRange`, `dateRange`                                                         |
+| Objects     | `object`, `nested`, `flattened`                                                                                               |
+| Spatial     | `geoPoint`, `geoShape`                                                                                                        |
+| Vector      | `denseVector`, `quantizedDenseVector`                                                                                         |
+| Specialized | `ip`, `binary`, `completion`, `percolator`                                                                                    |
+| Alias       | `alias`                                                                                                                       |
 
 #### Mapping Properties
 
@@ -678,6 +685,46 @@ The `.alias()` method accepts an optional `IndicesAlias` object:
 | `search_routing`  | `string`  | Routing value for search operations only                          |
 | `is_hidden`       | `boolean` | Hide alias from wildcard expressions                              |
 
+### Settings Presets
+
+Ready-made index settings for common lifecycle stages. Use with `.settings()` on `indexBuilder()` or pass directly to the ES `_settings` API.
+
+```typescript
+import { productionSearchSettings, indexSortSettings, fastIngestSettings } from 'elasticlink';
+
+// Create index with production settings
+const indexConfig = indexBuilder()
+  .mappings(myMappings)
+  .settings(productionSearchSettings())
+  .build();
+
+// Index-time sort for compression and early termination
+const sortedConfig = indexBuilder()
+  .mappings(myMappings)
+  .settings({
+    ...productionSearchSettings(),
+    index: indexSortSettings({ timestamp: 'desc', status: 'asc' })
+  })
+  .build();
+
+// Before bulk ingest — disables refresh, removes replicas, async translog
+await client.indices.putSettings({ index: 'my-index', body: fastIngestSettings() });
+
+// Perform bulk ingest...
+
+// Restore production settings afterward
+await client.indices.putSettings({ index: 'my-index', body: productionSearchSettings() });
+await client.indices.refresh({ index: 'my-index' });
+```
+
+| Preset | Purpose |
+| ------ | ------- |
+| `productionSearchSettings(overrides?)` | Balanced production defaults — 1 replica, 5s refresh |
+| `indexSortSettings(fields)` | Configure index-time sort order for disk compression and early termination |
+| `fastIngestSettings(overrides?)` | Maximum indexing throughput — async translog, no replicas, refresh disabled |
+
+`fastIngestSettings` deep-merges the `translog` key so individual translog overrides don't clobber the other defaults. All presets accept an optional `overrides` argument typed as `Partial<IndicesIndexSettings>`.
+
 ## Examples
 
 More examples available in [src/\_\_tests\_\_/examples.test.ts](src/__tests__/examples.test.ts).

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

@@ -1 +1 @@
-{"version":3,"file":"aggregation.builder.d.ts","sourceRoot":"","sources":["../src/aggregation.builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAajB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,wBAAwB,GACnC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAEzC,QAAO,gBAAqB,KAC3B,kBAAkB,CAAC,CAAC,CAiNrB,CAAC;AAGH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EACpE,SAAS,cAAc,CAAC,CAAC,CAAC,0BACM,CAAC"}
+{"version":3,"file":"aggregation.builder.d.ts","sourceRoot":"","sources":["../src/aggregation.builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAajB,MAAM,wBAAwB,CAAC;AAEhC,eAAO,MAAM,wBAAwB,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAChF,QAAO,gBAAqB,KAC3B,kBAAkB,CAAC,CAAC,CAsKrB,CAAC;AAGH,eAAO,MAAM,YAAY,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,0BACnE,CAAC"}

package/dist/aggregation.builder.js

@@ -1,147 +1,154 @@
 export const createAggregationBuilder = (state = {}) => ({
     // Bucket aggregations
     terms: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            terms: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                terms: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     dateHistogram: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            date_histogram: {
-                field: String(field),
-                ...options
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                date_histogram: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     range: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            range: {
-                field: String(field),
-                ranges: options.ranges
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                range: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     histogram: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            histogram: {
-                field: String(field),
-                ...options
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                histogram: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     // Metric aggregations
     avg: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            avg: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                avg: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     sum: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            sum: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                sum: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     min: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            min: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                min: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     max: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            max: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                max: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     cardinality: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            cardinality: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                cardinality: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     percentiles: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            percentiles: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                percentiles: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     stats: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            stats: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                stats: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     valueCount: (name, field, options) => {
-        const aggregations = { ...state };
-        aggregations[name] = {
-            value_count: {
-                field: String(field),
-                ...(options && Object.keys(options).length > 0 ? options : {})
+        return createAggregationBuilder({
+            ...state,
+            [name]: {
+                value_count: {
+                    field,
+                    ...(options && options)
+                }
             }
-        };
-        return createAggregationBuilder(aggregations);
+        });
     },
     // Sub-aggregations
     subAgg: (fn) => {
-        // Get the last aggregation added
         const keys = Object.keys(state);
-        if (keys.length === 0) {
-            throw new Error('No aggregation to add sub-aggregation to');
-        }
-        const lastKey = keys[keys.length - 1];
-        const lastAgg = state[lastKey];
-        // Apply sub-aggregations
+        const lastKey = keys.at(-1);
+        const { [lastKey]: lastAgg } = state;
         const subAggs = fn(createAggregationBuilder({})).build();
-        const updatedState = {
+        return createAggregationBuilder({
             ...state,
             [lastKey]: {
                 ...lastAgg,
                 aggs: subAggs
             }
-        };
-        return createAggregationBuilder(updatedState);
+        });
     },
     // Build
+    // eslint-disable-next-line functional/functional-parameters
     build: () => state
 });
 // Helper function to create aggregations without needing to import the builder

package/dist/aggregation.types.d.ts

@@ -5,6 +5,7 @@
  */
 import type { AggregationsTermsAggregation, AggregationsDateHistogramAggregation, AggregationsRangeAggregation, AggregationsHistogramAggregation, AggregationsAverageAggregation, AggregationsSumAggregation, AggregationsMinAggregation, AggregationsMaxAggregation, AggregationsCardinalityAggregation, AggregationsPercentilesAggregation, AggregationsStatsAggregation, AggregationsValueCountAggregation, AggregationsCalendarInterval } from '@elastic/elasticsearch/lib/api/types';
 import type { FieldTypeString } from './index-management.types.js';
+import type { DateFields, NumericFields } from './mapping.types.js';
 /**
  * Options for terms aggregation (excludes 'field' which is handled by the builder)
  * @see https://www.elastic.co/guide/en/elasticsearch/reference/current/search-aggregations-bucket-terms-aggregation.html
@@ -83,25 +84,25 @@ export type AggregationBuilder<M extends Record<string, FieldTypeString>> = {
     /** Terms aggregation - group by field values */
     terms: <K extends string & keyof M>(name: string, field: K, options?: TermsAggOptions) => AggregationBuilder<M>;
     /** Date histogram aggregation - group by time intervals */
-    dateHistogram: <K extends string & keyof M>(name: string, field: K, options: DateHistogramAggOptions) => AggregationBuilder<M>;
+    dateHistogram: <K extends DateFields<M> & string>(name: string, field: K, options?: DateHistogramAggOptions) => AggregationBuilder<M>;
     /** Range aggregation - group by numeric/date ranges */
-    range: <K extends string & keyof M>(name: string, field: K, options: RangeAggOptions) => AggregationBuilder<M>;
+    range: <K extends string & keyof M>(name: string, field: K, options?: RangeAggOptions) => AggregationBuilder<M>;
     /** Histogram aggregation - group by numeric intervals */
-    histogram: <K extends string & keyof M>(name: string, field: K, options: HistogramAggOptions) => AggregationBuilder<M>;
+    histogram: <K extends NumericFields<M> & string>(name: string, field: K, options?: HistogramAggOptions) => AggregationBuilder<M>;
     /** Average aggregation */
-    avg: <K extends string & keyof M>(name: string, field: K, options?: AvgAggOptions) => AggregationBuilder<M>;
+    avg: <K extends NumericFields<M> & string>(name: string, field: K, options?: AvgAggOptions) => AggregationBuilder<M>;
     /** Sum aggregation */
-    sum: <K extends string & keyof M>(name: string, field: K, options?: SumAggOptions) => AggregationBuilder<M>;
+    sum: <K extends NumericFields<M> & string>(name: string, field: K, options?: SumAggOptions) => AggregationBuilder<M>;
     /** Minimum value aggregation */
-    min: <K extends string & keyof M>(name: string, field: K, options?: MinAggOptions) => AggregationBuilder<M>;
+    min: <K extends NumericFields<M> & string>(name: string, field: K, options?: MinAggOptions) => AggregationBuilder<M>;
     /** Maximum value aggregation */
-    max: <K extends string & keyof M>(name: string, field: K, options?: MaxAggOptions) => AggregationBuilder<M>;
+    max: <K extends NumericFields<M> & string>(name: string, field: K, options?: MaxAggOptions) => AggregationBuilder<M>;
     /** Cardinality aggregation - count unique values */
     cardinality: <K extends string & keyof M>(name: string, field: K, options?: CardinalityAggOptions) => AggregationBuilder<M>;
     /** Percentiles aggregation */
-    percentiles: <K extends string & keyof M>(name: string, field: K, options?: PercentilesAggOptions) => AggregationBuilder<M>;
+    percentiles: <K extends NumericFields<M> & string>(name: string, field: K, options?: PercentilesAggOptions) => AggregationBuilder<M>;
     /** Statistics aggregation (count, min, max, avg, sum) */
-    stats: <K extends string & keyof M>(name: string, field: K, options?: StatsAggOptions) => AggregationBuilder<M>;
+    stats: <K extends NumericFields<M> & string>(name: string, field: K, options?: StatsAggOptions) => AggregationBuilder<M>;
     /** Value count aggregation */
     valueCount: <K extends string & keyof M>(name: string, field: K, options?: ValueCountAggOptions) => AggregationBuilder<M>;
     /** Add sub-aggregation to parent bucket aggregation */

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

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

package/dist/bulk.builder.d.ts

@@ -15,7 +15,7 @@ export declare const createBulkBuilder: <T>(operations?: any[]) => BulkBuilder<T
  * `.build()` returns an NDJSON string (newline-delimited JSON) ready to POST to `/_bulk`.
  * `.buildArray()` returns the raw operation objects if you need to inspect or transform them.
  * @example
- * const ndjson = bulk<Product>()
+ * const ndjson = bulk(productMappings)
  *   .index({ id: '1', name: 'Product 1' }, { _index: 'products', _id: '1' })
  *   .create({ id: '2', name: 'Product 2' }, { _index: 'products', _id: '2' })
  *   .update({ _index: 'products', _id: '3', doc: { name: 'Updated' } })
@@ -24,7 +24,10 @@ export declare const createBulkBuilder: <T>(operations?: any[]) => BulkBuilder<T
  */
 export declare const bulk: <M extends Record<string, FieldTypeString>>(_schema: MappingsSchema<M>) => BulkBuilder<{ [K in keyof M]: M[K] extends keyof {
     text: string;
+    match_only_text: string;
     keyword: string;
+    constant_keyword: string;
+    wildcard: string;
     long: number;
     integer: number;
     short: number;
@@ -44,8 +47,10 @@ export declare const bulk: <M extends Record<string, FieldTypeString>>(_schema:
     geo_shape: Record<string, unknown>;
     dense_vector: number[];
     completion: string;
+    search_as_you_type: string;
     nested: unknown;
     object: unknown;
+    flattened: Record<string, unknown>;
     alias: unknown;
     percolator: unknown;
     integer_range: {
@@ -80,7 +85,10 @@ export declare const bulk: <M extends Record<string, FieldTypeString>>(_schema:
     };
 } ? {
     text: string;
+    match_only_text: string;
     keyword: string;
+    constant_keyword: string;
+    wildcard: string;
     long: number;
     integer: number;
     short: number;
@@ -100,8 +108,10 @@ export declare const bulk: <M extends Record<string, FieldTypeString>>(_schema:
     geo_shape: Record<string, unknown>;
     dense_vector: number[];
     completion: string;
+    search_as_you_type: string;
     nested: unknown;
     object: unknown;
+    flattened: Record<string, unknown>;
     alias: unknown;
     percolator: unknown;
     integer_range: {

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

@@ -1 +1 @@
-{"version":3,"file":"bulk.builder.d.ts","sourceRoot":"","sources":["../src/bulk.builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAEjC,aAAY,GAAG,EAAO,KACrB,WAAW,CAAC,CAAC,CA8Bd,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAC5D,SAAS,cAAc,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;WAnBiC,CAAC;WAC5D,CAAC;UAEM,CAAC;UAAY,CAAC;;;WAIP,CAAA;WAAa,CAAC;UAC7B,CAAC;UAAY,CAAC;;;WAA+B,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAC1D,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAChE,CAAC;WACE,CAAA;UAAY,CAAC;UACrB,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAZ4D,CAAC;WAC5D,CAAC;UAEM,CAAC;UAAY,CAAC;;;WAIP,CAAA;WAAa,CAAC;UAC7B,CAAC;UAAY,CAAC;;;WAA+B,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAC1D,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAChE,CAAC;WACE,CAAA;UAAY,CAAC;UACrB,CAAA;;qBAQiD,CAAC"}
+{"version":3,"file":"bulk.builder.d.ts","sourceRoot":"","sources":["../src/bulk.builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAS,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,EAEjC,aAAY,GAAG,EAAO,KACrB,WAAW,CAAC,CAAC,CAiCd,CAAC;AAEH;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAE6F,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAAgC,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAA+B,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAAiC,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAA+B,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAA5U,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAAgC,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAA+B,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAAiC,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;;WAA+B,CAAC;WAAa,CAAC;UAAY,CAAC;UAAY,CAAC;;qBADpd,CAAC"}

package/dist/bulk.builder.js

@@ -18,23 +18,22 @@ operations = []) => ({
     update: (meta) => {
         const { doc, script, upsert, doc_as_upsert, ...header } = meta;
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
-        const updateDoc = {};
-        if (doc)
-            updateDoc.doc = doc;
-        if (script)
-            updateDoc.script = script;
-        if (upsert)
-            updateDoc.upsert = upsert;
-        if (doc_as_upsert !== undefined)
-            updateDoc.doc_as_upsert = doc_as_upsert;
+        const updateDoc = {
+            ...(doc && { doc }),
+            ...(script && { script }),
+            ...(upsert && { upsert }),
+            ...(doc_as_upsert !== undefined && { doc_as_upsert })
+        };
         return createBulkBuilder([...operations, { update: header }, updateDoc]);
     },
     delete: (meta) => {
         return createBulkBuilder([...operations, { delete: meta }]);
     },
+    // eslint-disable-next-line functional/functional-parameters
     build: () => {
-        return operations.map((op) => JSON.stringify(op)).join('\n') + '\n';
+        return `${operations.map((op) => JSON.stringify(op)).join('\n')}\n`;
     },
+    // eslint-disable-next-line functional/functional-parameters
     buildArray: () => operations
 });
 /**
@@ -42,7 +41,7 @@ operations = []) => ({
  * `.build()` returns an NDJSON string (newline-delimited JSON) ready to POST to `/_bulk`.
  * `.buildArray()` returns the raw operation objects if you need to inspect or transform them.
  * @example
- * const ndjson = bulk<Product>()
+ * const ndjson = bulk(productMappings)
  *   .index({ id: '1', name: 'Product 1' }, { _index: 'products', _id: '1' })
  *   .create({ id: '2', name: 'Product 2' }, { _index: 'products', _id: '2' })
  *   .update({ _index: 'products', _id: '3', doc: { name: 'Updated' } })

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

@@ -1 +1 @@
-{"version":3,"file":"bulk.types.d.ts","sourceRoot":"","sources":["../src/bulk.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,sCAAsC,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,mBAAmB,GACjD,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAElC;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,2CAA2C;IAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,sDAAsD;IACtD,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1D,kCAAkC;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACpD,wBAAwB;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACjD,sDAAsD;IACtD,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,gCAAgC;IAEhC,UAAU,EAAE,MAAM,GAAG,EAAE,CAAC;CACzB,CAAC"}
+{"version":3,"file":"bulk.types.d.ts","sourceRoot":"","sources":["../src/bulk.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,EACpB,MAAM,sCAAsC,CAAC;AAE9C;;;GAGG;AACH,MAAM,MAAM,aAAa,GAAG,kBAAkB,CAAC;AAE/C;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,mBAAmB,GAAG,gBAAgB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEtF;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;IAC3B,2CAA2C;IAC3C,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,aAAa,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACxD,sDAAsD;IACtD,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,cAAc,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IAC1D,kCAAkC;IAClC,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACpD,wBAAwB;IACxB,MAAM,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC;IACjD,sDAAsD;IACtD,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,gCAAgC;IAEhC,UAAU,EAAE,MAAM,GAAG,EAAE,CAAC;CACzB,CAAC"}

package/dist/field.helpers.d.ts

@@ -13,8 +13,7 @@
  *   embedding: denseVector({ dims: 384 }),
  * });
  */
-import type { FieldMapping } from './index-management.types.js';
-import type { TextFieldOptions, KeywordFieldOptions, NumericFieldOptions, ScaledFloatFieldOptions, DateFieldOptions, BooleanFieldOptions, DenseVectorFieldOptions, NestedFields, ObjectFieldOptions, CompletionFieldOptions, GeoPointFieldOptions, GeoShapeFieldOptions, AliasFieldOptions, IpFieldOptions, RangeFieldOptions, 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 } from './field.types.js';
+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;
@@ -30,17 +29,73 @@ export declare const boolean: (options?: BooleanFieldOptions) => BooleanFieldMap
 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 = 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 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;
-export declare const resolveField: (input: FieldMapping) => FieldMapping;
+/**
+ * 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 flattened: (options?: FlattenedFieldOptions) => FlattenedFieldMapping;
 //# sourceMappingURL=field.helpers.d.ts.map