@elastic/esql 1.8.0 → 2.0.0

package/lib/ast/mutate/commands/index.d.ts

@@ -1,9 +1,10 @@
 import * as from from './from';
 import * as limit from './limit';
+import * as set from './set';
 import * as sort from './sort';
 import * as stats from './stats';
 import * as where from './where';
 import * as join from './join';
 import * as rerank from './rerank';
-export { from, limit, sort, stats, where, join, rerank };
+export { from, limit, set, sort, stats, where, join, rerank };
 //# sourceMappingURL=index.d.ts.map

package/lib/ast/mutate/commands/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ast/mutate/commands/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/ast/mutate/commands/index.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,OAAO,CAAC;AAC7B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,KAAK,MAAM,SAAS,CAAC;AACjC,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC"}

package/lib/ast/mutate/commands/set/index.d.ts

@@ -0,0 +1,54 @@
+import type { ESQLAstQueryExpression, ESQLAstSetHeaderCommand } from '../../../../types';
+/**
+ * Lists all SET header commands in the query AST.
+ *
+ * @param ast The root AST node.
+ * @returns An iterable of SET header commands.
+ */
+export declare const list: (ast: ESQLAstQueryExpression) => IterableIterator<ESQLAstSetHeaderCommand>;
+/**
+ * Finds a SET header command by its setting name.
+ *
+ * @param ast The root AST node.
+ * @param settingName The name of the setting to find (e.g. "unmapped_fields").
+ * @returns The matching SET header command, or undefined.
+ */
+export declare const findBySettingName: (ast: ESQLAstQueryExpression, settingName: string) => ESQLAstSetHeaderCommand | undefined;
+/**
+ * Updates the value of an existing SET setting. Returns the modified header
+ * command, or `undefined` if no matching setting was found.
+ *
+ * @param ast The root AST node.
+ * @param settingName The name of the setting to modify.
+ * @param value The new value, parsed as an ES|QL expression. For example:
+ *   - `'"LOAD"'` → string literal `"LOAD"`
+ *   - `'true'` → boolean literal `TRUE`
+ *   - `'42'` → integer literal `42`
+ *   - `'{ "key": "value" }'` → map expression
+ * @returns The modified SET header command, or undefined if not found.
+ */
+export declare const update: (ast: ESQLAstQueryExpression, settingName: string, value: string) => ESQLAstSetHeaderCommand | undefined;
+/**
+ * Updates the value of an existing SET setting, or inserts a new SET header
+ * command if the setting does not exist. The new command is inserted as the last
+ * command in the header.
+ *
+ * @param ast The root AST node.
+ * @param settingName The name of the setting (e.g. "unmapped_fields").
+ * @param value The new value, parsed as an ES|QL expression. For example:
+ *   - `'"LOAD"'` → string literal `"LOAD"`
+ *   - `'true'` → boolean literal `TRUE`
+ *   - `'42'` → integer literal `42`
+ *   - `'{ "key": "value" }'` → map expression
+ * @returns The modified or newly created SET header command.
+ */
+export declare const upsert: (ast: ESQLAstQueryExpression, settingName: string, value: string) => ESQLAstSetHeaderCommand;
+/**
+ * Removes a SET header command by its setting name.
+ *
+ * @param ast The root AST node.
+ * @param settingName The name of the setting to remove.
+ * @returns The removed SET header command, or undefined if not found.
+ */
+export declare const remove: (ast: ESQLAstQueryExpression, settingName: string) => ESQLAstSetHeaderCommand | undefined;
+//# sourceMappingURL=index.d.ts.map

package/lib/ast/mutate/commands/set/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ast/mutate/commands/set/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAIxB,MAAM,mBAAmB,CAAC;AAE3B;;;;;GAKG;AACH,eAAO,MAAM,IAAI,GACf,KAAK,sBAAsB,KAC1B,gBAAgB,CAAC,uBAAuB,CAO1C,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAC5B,KAAK,sBAAsB,EAC3B,aAAa,MAAM,KAClB,uBAAuB,GAAG,SAW5B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,MAAM,GACjB,KAAK,sBAAsB,EAC3B,aAAa,MAAM,EACnB,OAAO,MAAM,KACZ,uBAAuB,GAAG,SAU5B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,GACjB,KAAK,sBAAsB,EAC3B,aAAa,MAAM,EACnB,OAAO,MAAM,KACZ,uBAiBF,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GACjB,KAAK,sBAAsB,EAC3B,aAAa,MAAM,KAClB,uBAAuB,GAAG,SAS5B,CAAC"}