Introduce FlagsEnum<T> marker class

Author: flobernd

specification/_spec_utils/FlagsEnum.ts

@@ -0,0 +1,27 @@
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+/**
+ * This type type marks the underlaying enum as a "flags enum". Individual members of flags enums
+ * are combined using the pipe separator ("A|B|C|...").
+ *
+ * Depending on the target language, code generators can use this hint to generate language specific
+ * flags enum constructs and the corresponding (de-)serialization code.
+ */
+export type FlagsEnum<T> = T

specification/_types/query_dsl/fulltext.ts

@@ -29,6 +29,7 @@ import { Script } from '@_types/Scripting'
 import { QueryBase } from './abstractions'
 import { Operator } from './Operator'
 import { DateMath, TimeZone } from '@_types/Time'
+import { FlagsEnum } from '@spec_utils/FlagsEnum'
 
 /**
  * @shortcut_property query
@@ -271,24 +272,23 @@ export class QueryStringQuery extends QueryBase {
 /**
  * Query flags can be either a single flag or a combination of flags, e.g. `OR|AND|PREFIX`
  * @doc_id supported-flags
- * @codegen_names single, multiple
  */
-export type SimpleQueryStringFlags = SimpleQueryStringFlag | string
+export type SimpleQueryStringFlags = FlagsEnum<SimpleQueryStringFlag[]>
 
 export enum SimpleQueryStringFlag {
-  NONE = 1,
-  AND = 2,
-  OR = 4,
-  NOT = 8,
-  PREFIX = 16,
-  PHRASE = 32,
-  PRECEDENCE = 64,
-  ESCAPE = 128,
-  WHITESPACE = 256,
-  FUZZY = 512,
-  NEAR = 1024,
-  SLOP = 2048,
-  ALL = 4096
+  NONE = 0,
+  AND = 1 << 0,
+  NOT = 1 << 1,
+  OR = 1 << 2,
+  PREFIX = 1 << 3,
+  PHRASE = 1 << 4,
+  PRECEDENCE = 1 << 5,
+  ESCAPE = 1 << 5,
+  WHITESPACE = 1 << 6,
+  FUZZY = 1 << 7,
+  NEAR = 1 << 8,
+  SLOP = 1 << 8, // NEAR and SLOP are synonymous
+  ALL = -1
 }
 
 export class SimpleQueryStringQuery extends QueryBase {
@@ -300,6 +300,7 @@ export class SimpleQueryStringQuery extends QueryBase {
   /** @server_default 'or' */
   default_operator?: Operator
   fields?: Field[]
+  /** @server_default 'ALL' */
   flags?: SimpleQueryStringFlags
   fuzzy_max_expansions?: integer
   fuzzy_prefix_length?: integer