@backstage/plugin-search-backend-module-elasticsearch 1.5.7-next.1 → 1.5.7-next.2

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @backstage/plugin-search-backend-module-elasticsearch
 
+## 1.5.7-next.2
+
+### Patch Changes
+
+- Updated dependencies
+  - @backstage/backend-plugin-api@1.0.1-next.1
+  - @backstage/config@1.2.0
+  - @backstage/integration-aws-node@0.1.12
+  - @backstage/plugin-search-backend-node@1.3.3-next.2
+  - @backstage/plugin-search-common@1.2.14
+
 ## 1.5.7-next.1
 
 ### Patch Changes

package/alpha/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@backstage/plugin-search-backend-module-elasticsearch__alpha",
-  "version": "1.5.7-next.1",
+  "version": "1.5.7-next.2",
   "main": "../dist/alpha.cjs.js",
   "types": "../dist/alpha.d.ts"
 }

package/dist/engines/ElasticSearchClientOptions.cjs.js

@@ -0,0 +1,8 @@
+'use strict';
+
+const isOpenSearchCompatible = (opts) => {
+  return ["aws", "opensearch"].includes(opts?.provider ?? "");
+};
+
+exports.isOpenSearchCompatible = isOpenSearchCompatible;
+//# sourceMappingURL=ElasticSearchClientOptions.cjs.js.map

package/dist/engines/ElasticSearchClientOptions.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElasticSearchClientOptions.cjs.js","sources":["../../src/engines/ElasticSearchClientOptions.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\nimport type { ConnectionOptions as TLSConnectionOptions } from 'tls';\n\n/**\n * Typeguard to differentiate ElasticSearch client options which are compatible\n * with OpenSearch vs. ElasticSearch clients. Useful when calling the\n * {@link ElasticSearchSearchEngine.newClient} method.\n *\n * @public\n */\nexport const isOpenSearchCompatible = (\n  opts: ElasticSearchClientOptions,\n): opts is OpenSearchElasticSearchClientOptions => {\n  return ['aws', 'opensearch'].includes(opts?.provider ?? '');\n};\n\n/**\n * Options used to configure the `@elastic/elasticsearch` client or the\n * `@opensearch-project/opensearch` client, depending on the given config. It\n * will be passed as an argument to the\n * {@link ElasticSearchSearchEngine.newClient} method.\n *\n * @public\n */\nexport type ElasticSearchClientOptions =\n  | ElasticSearchElasticSearchClientOptions\n  | OpenSearchElasticSearchClientOptions;\n\n/**\n * Options used to configure the `@opensearch-project/opensearch` client.\n *\n * They are drawn from the `ClientOptions` class of `@opensearch-project/opensearch`,\n * but are maintained separately so that this interface is not coupled to it.\n *\n * @public\n */\nexport interface OpenSearchElasticSearchClientOptions\n  extends BaseElasticSearchClientOptions {\n  provider?: 'aws' | 'opensearch';\n  region?: string;\n  service?: 'es' | 'aoss';\n  auth?: OpenSearchAuth;\n  connection?: OpenSearchConnectionConstructor;\n  node?: string | string[] | OpenSearchNodeOptions | OpenSearchNodeOptions[];\n  nodes?: string | string[] | OpenSearchNodeOptions | OpenSearchNodeOptions[];\n}\n\n/**\n * Options used to configure the `@elastic/elasticsearch` client.\n *\n * They are drawn from the `ClientOptions` class of `@elastic/elasticsearch`,\n * but are maintained separately so that this interface is not coupled to it.\n *\n * @public\n */\nexport interface ElasticSearchElasticSearchClientOptions\n  extends BaseElasticSearchClientOptions {\n  provider?: 'elastic';\n  auth?: ElasticSearchAuth;\n  Connection?: ElasticSearchConnectionConstructor;\n  node?:\n    | string\n    | string[]\n    | ElasticSearchNodeOptions\n    | ElasticSearchNodeOptions[];\n  nodes?:\n    | string\n    | string[]\n    | ElasticSearchNodeOptions\n    | ElasticSearchNodeOptions[];\n  cloud?: {\n    id: string;\n    username?: string;\n    password?: string;\n  };\n}\n\n/**\n * Base client options that are shared across `@opensearch-project/opensearch`\n * and `@elastic/elasticsearch` clients.\n *\n * @public\n */\nexport interface BaseElasticSearchClientOptions {\n  Transport?: ElasticSearchTransportConstructor;\n  maxRetries?: number;\n  requestTimeout?: number;\n  pingTimeout?: number;\n  sniffInterval?: number | boolean;\n  sniffOnStart?: boolean;\n  sniffEndpoint?: string;\n  sniffOnConnectionFault?: boolean;\n  resurrectStrategy?: 'ping' | 'optimistic' | 'none';\n  suggestCompression?: boolean;\n  compression?: 'gzip';\n  ssl?: TLSConnectionOptions;\n  agent?: ElasticSearchAgentOptions | ((opts?: any) => unknown) | false;\n  nodeFilter?: (connection: any) => boolean;\n  nodeSelector?: ((connections: any[]) => any) | string;\n  headers?: Record<string, any>;\n  opaqueIdPrefix?: string;\n  name?: string | symbol;\n  proxy?: string | URL;\n  enableMetaHeader?: boolean;\n  disablePrototypePoisoningProtection?: boolean | 'proto' | 'constructor';\n}\n\n/**\n * @public\n */\nexport type OpenSearchAuth = {\n  username: string;\n  password: string;\n};\n\n/**\n * @public\n */\nexport type ElasticSearchAuth =\n  | OpenSearchAuth\n  | {\n      apiKey:\n        | string\n        | {\n            id: string;\n            api_key: string;\n          };\n    };\n\n/**\n * @public\n */\nexport interface ElasticSearchNodeOptions {\n  url: URL;\n  id?: string;\n  agent?: ElasticSearchAgentOptions;\n  ssl?: TLSConnectionOptions;\n  headers?: Record<string, any>;\n  roles?: {\n    master: boolean;\n    data: boolean;\n    ingest: boolean;\n    ml: boolean;\n  };\n}\n\n/**\n * @public\n */\nexport interface OpenSearchNodeOptions {\n  url: URL;\n  id?: string;\n  agent?: ElasticSearchAgentOptions;\n  ssl?: TLSConnectionOptions;\n  headers?: Record<string, any>;\n  roles?: {\n    master: boolean;\n    data: boolean;\n    ingest: boolean;\n  };\n}\n\n/**\n * @public\n */\nexport interface ElasticSearchAgentOptions {\n  keepAlive?: boolean;\n  keepAliveMsecs?: number;\n  maxSockets?: number;\n  maxFreeSockets?: number;\n}\n\n/**\n * @public\n */\nexport interface ElasticSearchConnectionConstructor {\n  new (opts?: any): any;\n  statuses: {\n    ALIVE: string;\n    DEAD: string;\n  };\n  roles: {\n    MASTER: string;\n    DATA: string;\n    INGEST: string;\n    ML: string;\n  };\n}\n\n/**\n * @public\n */\nexport interface OpenSearchConnectionConstructor {\n  new (opts?: any): any;\n  statuses: {\n    ALIVE: string;\n    DEAD: string;\n  };\n  roles: {\n    MASTER: string;\n    DATA: string;\n    INGEST: string;\n  };\n}\n\n/**\n * @public\n */\nexport interface ElasticSearchTransportConstructor {\n  new (opts?: any): any;\n  sniffReasons: {\n    SNIFF_ON_START: string;\n    SNIFF_INTERVAL: string;\n    SNIFF_ON_CONNECTION_FAULT: string;\n    DEFAULT: string;\n  };\n}\n\n// todo(iamEAP) implement canary types to ensure we remain compatible through upgrades.\n"],"names":[],"mappings":";;AAwBa,MAAA,sBAAA,GAAyB,CACpC,IACiD,KAAA;AACjD,EAAA,OAAO,CAAC,KAAO,EAAA,YAAY,EAAE,QAAS,CAAA,IAAA,EAAM,YAAY,EAAE,CAAA,CAAA;AAC5D;;;;"}

package/dist/engines/ElasticSearchClientWrapper.cjs.js

@@ -0,0 +1,137 @@
+'use strict';
+
+var elasticsearch = require('@elastic/elasticsearch');
+var opensearch = require('@opensearch-project/opensearch');
+var ElasticSearchClientOptions = require('./ElasticSearchClientOptions.cjs.js');
+
+class ElasticSearchClientWrapper {
+  elasticSearchClient;
+  openSearchClient;
+  constructor(options) {
+    this.openSearchClient = options.openSearchClient;
+    this.elasticSearchClient = options.elasticSearchClient;
+  }
+  static fromClientOptions(options) {
+    if (ElasticSearchClientOptions.isOpenSearchCompatible(options)) {
+      return new ElasticSearchClientWrapper({
+        openSearchClient: new opensearch.Client(options)
+      });
+    }
+    return new ElasticSearchClientWrapper({
+      elasticSearchClient: new elasticsearch.Client(options)
+    });
+  }
+  search(options) {
+    const searchOptions = {
+      ignore_unavailable: true,
+      allow_no_indices: true
+    };
+    if (this.openSearchClient) {
+      return this.openSearchClient.search({
+        ...options,
+        ...searchOptions
+      });
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.search({
+        ...options,
+        ...searchOptions
+      });
+    }
+    throw new Error("No client defined");
+  }
+  bulk(bulkOptions) {
+    if (this.openSearchClient) {
+      return this.openSearchClient.helpers.bulk(bulkOptions);
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.helpers.bulk(bulkOptions);
+    }
+    throw new Error("No client defined");
+  }
+  putIndexTemplate(template) {
+    if (this.openSearchClient) {
+      return this.openSearchClient.indices.putIndexTemplate(template);
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.indices.putIndexTemplate(template);
+    }
+    throw new Error("No client defined");
+  }
+  listIndices(options) {
+    if (this.openSearchClient) {
+      return this.openSearchClient.indices.get(options);
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.indices.get(options);
+    }
+    throw new Error("No client defined");
+  }
+  indexExists(options) {
+    if (this.openSearchClient) {
+      return this.openSearchClient.indices.exists(options);
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.indices.exists(options);
+    }
+    throw new Error("No client defined");
+  }
+  deleteIndex(options) {
+    if (this.openSearchClient) {
+      return this.openSearchClient.indices.delete(options);
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.indices.delete(options);
+    }
+    throw new Error("No client defined");
+  }
+  /**
+   * @deprecated unused by the ElasticSearch Engine, will be removed in the future
+   */
+  getAliases(options) {
+    const { aliases } = options;
+    if (this.openSearchClient) {
+      return this.openSearchClient.cat.aliases({
+        format: "json",
+        name: aliases
+      });
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.cat.aliases({
+        format: "json",
+        name: aliases
+      });
+    }
+    throw new Error("No client defined");
+  }
+  createIndex(options) {
+    if (this.openSearchClient) {
+      return this.openSearchClient.indices.create(options);
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.indices.create(options);
+    }
+    throw new Error("No client defined");
+  }
+  updateAliases(options) {
+    const filteredActions = options.actions.filter(Boolean);
+    if (this.openSearchClient) {
+      return this.openSearchClient.indices.updateAliases({
+        body: {
+          actions: filteredActions
+        }
+      });
+    }
+    if (this.elasticSearchClient) {
+      return this.elasticSearchClient.indices.updateAliases({
+        body: {
+          actions: filteredActions
+        }
+      });
+    }
+    throw new Error("No client defined");
+  }
+}
+
+exports.ElasticSearchClientWrapper = ElasticSearchClientWrapper;
+//# sourceMappingURL=ElasticSearchClientWrapper.cjs.js.map

package/dist/engines/ElasticSearchClientWrapper.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElasticSearchClientWrapper.cjs.js","sources":["../../src/engines/ElasticSearchClientWrapper.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Client as ElasticSearchClient } from '@elastic/elasticsearch';\nimport { Client as OpenSearchClient } from '@opensearch-project/opensearch';\nimport { Readable } from 'stream';\nimport {\n  ElasticSearchClientOptions,\n  isOpenSearchCompatible,\n} from './ElasticSearchClientOptions';\nimport { ElasticSearchCustomIndexTemplate } from './types';\n\n/**\n * @public\n */\nexport type ElasticSearchAliasAction =\n  | {\n      remove: { index: any; alias: any };\n      add?: undefined;\n    }\n  | {\n      add: { indices: any; alias: any; index?: undefined };\n      remove?: undefined;\n    }\n  | {\n      add: { index: any; alias: any; indices?: undefined };\n      remove?: undefined;\n    }\n  | undefined;\n\n/**\n * @public\n */\nexport type ElasticSearchIndexAction = {\n  index: {\n    _index: string;\n    [key: string]: any;\n  };\n};\n\n/**\n * A wrapper class that exposes logical methods that are conditionally fired\n * against either a configured Elasticsearch client or a configured Opensearch\n * client.\n *\n * This is necessary because, despite its intention to be API-compatible, the\n * opensearch client does not support API key-based authentication. This is\n * also the sanest way to accomplish this while making typescript happy.\n *\n * In the future, if the differences between implementations become\n * unmaintainably divergent, we should split out the Opensearch and\n * Elasticsearch search engine implementations.\n *\n * @public\n */\nexport class ElasticSearchClientWrapper {\n  private readonly elasticSearchClient: ElasticSearchClient | undefined;\n  private readonly openSearchClient: OpenSearchClient | undefined;\n\n  private constructor(options: {\n    openSearchClient?: OpenSearchClient;\n    elasticSearchClient?: ElasticSearchClient;\n  }) {\n    this.openSearchClient = options.openSearchClient;\n    this.elasticSearchClient = options.elasticSearchClient;\n  }\n\n  static fromClientOptions(options: ElasticSearchClientOptions) {\n    if (isOpenSearchCompatible(options)) {\n      return new ElasticSearchClientWrapper({\n        openSearchClient: new OpenSearchClient(options),\n      });\n    }\n\n    return new ElasticSearchClientWrapper({\n      elasticSearchClient: new ElasticSearchClient(options),\n    });\n  }\n\n  search(options: { index: string | string[]; body: Object }) {\n    const searchOptions = {\n      ignore_unavailable: true,\n      allow_no_indices: true,\n    };\n\n    if (this.openSearchClient) {\n      return this.openSearchClient.search({\n        ...options,\n        ...searchOptions,\n      });\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.search({\n        ...options,\n        ...searchOptions,\n      });\n    }\n\n    throw new Error('No client defined');\n  }\n\n  bulk(bulkOptions: {\n    datasource: Readable;\n    onDocument: () => ElasticSearchIndexAction;\n    refreshOnCompletion?: string | boolean;\n  }) {\n    if (this.openSearchClient) {\n      return this.openSearchClient.helpers.bulk(bulkOptions);\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.helpers.bulk(bulkOptions);\n    }\n\n    throw new Error('No client defined');\n  }\n\n  putIndexTemplate(template: ElasticSearchCustomIndexTemplate) {\n    if (this.openSearchClient) {\n      return this.openSearchClient.indices.putIndexTemplate(template);\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.indices.putIndexTemplate(template);\n    }\n\n    throw new Error('No client defined');\n  }\n\n  listIndices(options: { index: string }) {\n    if (this.openSearchClient) {\n      return this.openSearchClient.indices.get(options);\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.indices.get(options);\n    }\n\n    throw new Error('No client defined');\n  }\n\n  indexExists(options: { index: string | string[] }) {\n    if (this.openSearchClient) {\n      return this.openSearchClient.indices.exists(options);\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.indices.exists(options);\n    }\n\n    throw new Error('No client defined');\n  }\n\n  deleteIndex(options: { index: string | string[] }) {\n    if (this.openSearchClient) {\n      return this.openSearchClient.indices.delete(options);\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.indices.delete(options);\n    }\n\n    throw new Error('No client defined');\n  }\n\n  /**\n   * @deprecated unused by the ElasticSearch Engine, will be removed in the future\n   */\n  getAliases(options: { aliases: string[] }) {\n    const { aliases } = options;\n\n    if (this.openSearchClient) {\n      return this.openSearchClient.cat.aliases({\n        format: 'json',\n        name: aliases,\n      });\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.cat.aliases({\n        format: 'json',\n        name: aliases,\n      });\n    }\n\n    throw new Error('No client defined');\n  }\n\n  createIndex(options: { index: string }) {\n    if (this.openSearchClient) {\n      return this.openSearchClient.indices.create(options);\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.indices.create(options);\n    }\n\n    throw new Error('No client defined');\n  }\n\n  updateAliases(options: { actions: ElasticSearchAliasAction[] }) {\n    const filteredActions = options.actions.filter(Boolean);\n\n    if (this.openSearchClient) {\n      return this.openSearchClient.indices.updateAliases({\n        body: {\n          actions: filteredActions,\n        },\n      });\n    }\n\n    if (this.elasticSearchClient) {\n      return this.elasticSearchClient.indices.updateAliases({\n        body: {\n          actions: filteredActions,\n        },\n      });\n    }\n\n    throw new Error('No client defined');\n  }\n}\n"],"names":["isOpenSearchCompatible","OpenSearchClient","ElasticSearchClient"],"mappings":"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"}

package/dist/engines/ElasticSearchSearchEngine.cjs.js

@@ -0,0 +1,371 @@
+'use strict';
+
+var lodash = require('lodash');
+var aws = require('@opensearch-project/opensearch/aws');
+var aws4 = require('aws4');
+var ElasticSearchClientWrapper = require('./ElasticSearchClientWrapper.cjs.js');
+var ElasticSearchSearchEngineIndexer = require('./ElasticSearchSearchEngineIndexer.cjs.js');
+var pluginSearchBackendNode = require('@backstage/plugin-search-backend-node');
+var esb = require('elastic-builder');
+var uuid = require('uuid');
+var integrationAwsNode = require('@backstage/integration-aws-node');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e : { default: e }; }
+
+var esb__default = /*#__PURE__*/_interopDefaultCompat(esb);
+
+function isBlank(str) {
+  return lodash.isEmpty(str) && !lodash.isNumber(str) || lodash.isNaN(str);
+}
+const DEFAULT_INDEXER_BATCH_SIZE = 1e3;
+class ElasticSearchSearchEngine {
+  constructor(elasticSearchClientOptions, aliasPostfix, indexPrefix, logger, batchSize, highlightOptions) {
+    this.elasticSearchClientOptions = elasticSearchClientOptions;
+    this.aliasPostfix = aliasPostfix;
+    this.indexPrefix = indexPrefix;
+    this.logger = logger;
+    this.batchSize = batchSize;
+    this.elasticSearchClientWrapper = ElasticSearchClientWrapper.ElasticSearchClientWrapper.fromClientOptions(elasticSearchClientOptions);
+    const uuidTag = uuid.v4();
+    this.highlightOptions = {
+      preTag: `<${uuidTag}>`,
+      postTag: `</${uuidTag}>`,
+      fragmentSize: 1e3,
+      numFragments: 1,
+      fragmentDelimiter: " ... ",
+      ...highlightOptions
+    };
+  }
+  elasticSearchClientWrapper;
+  highlightOptions;
+  static async fromConfig(options) {
+    const {
+      logger,
+      config,
+      aliasPostfix = `search`,
+      indexPrefix = ``,
+      translator
+    } = options;
+    const credentialProvider = integrationAwsNode.DefaultAwsCredentialsManager.fromConfig(config);
+    const clientOptions = await this.createElasticSearchClientOptions(
+      await credentialProvider?.getCredentialProvider(),
+      config.getConfig("search.elasticsearch")
+    );
+    if (clientOptions.provider === "elastic") {
+      logger.info("Initializing Elastic.co ElasticSearch search engine.");
+    } else if (clientOptions.provider === "aws") {
+      logger.info("Initializing AWS OpenSearch search engine.");
+    } else if (clientOptions.provider === "opensearch") {
+      logger.info("Initializing OpenSearch search engine.");
+    } else {
+      logger.info("Initializing ElasticSearch search engine.");
+    }
+    const engine = new ElasticSearchSearchEngine(
+      clientOptions,
+      aliasPostfix,
+      indexPrefix,
+      logger,
+      config.getOptionalNumber("search.elasticsearch.batchSize") ?? DEFAULT_INDEXER_BATCH_SIZE,
+      config.getOptional(
+        "search.elasticsearch.highlightOptions"
+      )
+    );
+    for (const indexTemplate of this.readIndexTemplateConfig(
+      config.getConfig("search.elasticsearch")
+    )) {
+      await engine.setIndexTemplate(indexTemplate);
+    }
+    if (translator) {
+      await engine.setTranslator(translator);
+    }
+    return engine;
+  }
+  /**
+   * Create a custom search client from the derived search client configuration.
+   * This need not be the same client that the engine uses internally.
+   *
+   * @example Instantiate an instance of an Elasticsearch client.
+   *
+   * ```ts
+   * import { isOpenSearchCompatible } from '@backstage/plugin-search-backend-module-elasticsearch';
+   * import { Client } from '@elastic/elasticsearch';
+   *
+   * const client = searchEngine.newClient<Client>(options => {
+   *   // This type guard ensures options are compatible with either OpenSearch
+   *   // or Elasticsearch client constructors.
+   *   if (!isOpenSearchCompatible(options)) {
+   *     return new Client(options);
+   *   }
+   *   throw new Error('Incompatible options provided');
+   * });
+   * ```
+   */
+  newClient(create) {
+    return create(this.elasticSearchClientOptions);
+  }
+  translator(query, options) {
+    const { term, filters = {}, types, pageCursor } = query;
+    const filter = Object.entries(filters).filter(([_, value]) => Boolean(value)).map(([key, value]) => {
+      if (["string", "number", "boolean"].includes(typeof value)) {
+        const keyword = typeof value === "string" ? `${key}.keyword` : key;
+        return esb__default.default.matchQuery(keyword, value.toString());
+      }
+      if (Array.isArray(value)) {
+        return esb__default.default.boolQuery().should(value.map((it) => esb__default.default.matchQuery(key, it.toString())));
+      }
+      this.logger.error("Failed to query, unrecognized filter type", {
+        key,
+        value
+      });
+      throw new Error(
+        "Failed to add filters to query. Unrecognized filter type"
+      );
+    });
+    const esbQuery = isBlank(term) ? esb__default.default.matchAllQuery() : esb__default.default.multiMatchQuery(["*"], term).fuzziness("auto").minimumShouldMatch(1);
+    const pageSize = query.pageLimit || 25;
+    const { page } = decodePageCursor(pageCursor);
+    let esbRequestBodySearch = esb__default.default.requestBodySearch().query(esb__default.default.boolQuery().filter(filter).must([esbQuery])).from(page * pageSize).size(pageSize);
+    if (options?.highlightOptions) {
+      esbRequestBodySearch = esbRequestBodySearch.highlight(
+        esb__default.default.highlight("*").numberOfFragments(options.highlightOptions.numFragments).fragmentSize(options.highlightOptions.fragmentSize).preTags(options.highlightOptions.preTag).postTags(options.highlightOptions.postTag)
+      );
+    }
+    return {
+      elasticSearchQuery: esbRequestBodySearch.toJSON(),
+      documentTypes: types,
+      pageSize
+    };
+  }
+  setTranslator(translator) {
+    this.translator = translator;
+  }
+  async setIndexTemplate(template) {
+    try {
+      await this.elasticSearchClientWrapper.putIndexTemplate(template);
+      this.logger.info("Custom index template set");
+    } catch (error) {
+      this.logger.error(`Unable to set custom index template: ${error}`);
+    }
+  }
+  async getIndexer(type) {
+    const alias = this.constructSearchAlias(type);
+    const indexerLogger = this.logger.child({ documentType: type });
+    const indexer = new ElasticSearchSearchEngineIndexer.ElasticSearchSearchEngineIndexer({
+      type,
+      indexPrefix: this.indexPrefix,
+      indexSeparator: this.indexSeparator,
+      alias,
+      elasticSearchClientWrapper: this.elasticSearchClientWrapper,
+      logger: indexerLogger,
+      batchSize: this.batchSize,
+      skipRefresh: this.elasticSearchClientOptions?.service === "aoss"
+    });
+    indexer.on("error", async (e) => {
+      indexerLogger.error(`Failed to index documents for type ${type}`, e);
+      let cleanupError;
+      await new Promise(async (done) => {
+        const maxAttempts = 5;
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+          try {
+            await this.elasticSearchClientWrapper.deleteIndex({
+              index: indexer.indexName
+            });
+            attempts = maxAttempts;
+            cleanupError = void 0;
+            done();
+          } catch (err) {
+            cleanupError = err;
+          }
+          await new Promise((okay) => setTimeout(okay, 1e3));
+          attempts++;
+        }
+        done();
+      });
+      if (cleanupError) {
+        indexerLogger.error(
+          `Unable to clean up elastic index ${indexer.indexName}: ${cleanupError}`
+        );
+      } else {
+        indexerLogger.info(
+          `Removed partial, failed index ${indexer.indexName}`
+        );
+      }
+    });
+    return indexer;
+  }
+  async query(query) {
+    const { elasticSearchQuery, documentTypes, pageSize } = this.translator(
+      query,
+      { highlightOptions: this.highlightOptions }
+    );
+    const queryIndices = documentTypes ? documentTypes.map((it) => this.constructSearchAlias(it)) : this.constructSearchAlias("*");
+    try {
+      const result = await this.elasticSearchClientWrapper.search({
+        index: queryIndices,
+        body: elasticSearchQuery
+      });
+      const { page } = decodePageCursor(query.pageCursor);
+      const hasNextPage = result.body.hits.total.value > (page + 1) * pageSize;
+      const hasPreviousPage = page > 0;
+      const nextPageCursor = hasNextPage ? encodePageCursor({ page: page + 1 }) : void 0;
+      const previousPageCursor = hasPreviousPage ? encodePageCursor({ page: page - 1 }) : void 0;
+      return {
+        results: result.body.hits.hits.map(
+          (d, index) => {
+            const resultItem = {
+              type: this.getTypeFromIndex(d._index),
+              document: d._source,
+              rank: pageSize * page + index + 1
+            };
+            if (d.highlight) {
+              resultItem.highlight = {
+                preTag: this.highlightOptions.preTag,
+                postTag: this.highlightOptions.postTag,
+                fields: Object.fromEntries(
+                  Object.entries(d.highlight).map(([field, fragments]) => [
+                    field,
+                    fragments.join(this.highlightOptions.fragmentDelimiter)
+                  ])
+                )
+              };
+            }
+            return resultItem;
+          }
+        ),
+        nextPageCursor,
+        previousPageCursor,
+        numberOfResults: result.body.hits.total.value
+      };
+    } catch (error) {
+      if (error.meta?.body?.error?.type === "index_not_found_exception") {
+        throw new pluginSearchBackendNode.MissingIndexError(
+          `Missing index for ${queryIndices}. This means there are no documents to search through.`,
+          error
+        );
+      }
+      this.logger.error(
+        `Failed to query documents for indices ${queryIndices}`,
+        error
+      );
+      return Promise.reject({ results: [] });
+    }
+  }
+  indexSeparator = "-index__";
+  getTypeFromIndex(index) {
+    return index.substring(this.indexPrefix.length).split(this.indexSeparator)[0];
+  }
+  constructSearchAlias(type) {
+    const postFix = this.aliasPostfix ? `__${this.aliasPostfix}` : "";
+    return `${this.indexPrefix}${type}${postFix}`;
+  }
+  static async createElasticSearchClientOptions(credentialProvider, config) {
+    if (!config) {
+      throw new Error("No elastic search config found");
+    }
+    const clientOptionsConfig = config.getOptionalConfig("clientOptions");
+    const sslConfig = clientOptionsConfig?.getOptionalConfig("ssl");
+    if (config.getOptionalString("provider") === "elastic") {
+      const authConfig2 = config.getConfig("auth");
+      return {
+        provider: "elastic",
+        cloud: {
+          id: config.getString("cloudId")
+        },
+        auth: {
+          username: authConfig2.getString("username"),
+          password: authConfig2.getString("password")
+        },
+        ...sslConfig ? {
+          ssl: {
+            rejectUnauthorized: sslConfig?.getOptionalBoolean("rejectUnauthorized")
+          }
+        } : {}
+      };
+    }
+    if (config.getOptionalString("provider") === "aws") {
+      const requestSigner = new aws4.RequestSigner(config.getString("node"));
+      const service = config.getOptionalString("service") ?? requestSigner.service;
+      if (service !== "es" && service !== "aoss")
+        throw new Error(`Unrecognized serivce type: ${service}`);
+      return {
+        provider: "aws",
+        node: config.getString("node"),
+        region: config.getOptionalString("region"),
+        service,
+        ...sslConfig ? {
+          ssl: {
+            rejectUnauthorized: sslConfig?.getOptionalBoolean("rejectUnauthorized")
+          }
+        } : {},
+        ...aws.AwsSigv4Signer({
+          region: config.getOptionalString("region") ?? requestSigner.region,
+          // for backwards compatibility
+          service,
+          getCredentials: async () => await credentialProvider.sdkCredentialProvider()
+        })
+      };
+    }
+    if (config.getOptionalString("provider") === "opensearch") {
+      const authConfig2 = config.getConfig("auth");
+      return {
+        provider: "opensearch",
+        node: config.getString("node"),
+        auth: {
+          username: authConfig2.getString("username"),
+          password: authConfig2.getString("password")
+        },
+        ...sslConfig ? {
+          ssl: {
+            rejectUnauthorized: sslConfig?.getOptionalBoolean("rejectUnauthorized")
+          }
+        } : {}
+      };
+    }
+    const authConfig = config.getOptionalConfig("auth");
+    const auth = authConfig && (authConfig.has("apiKey") ? {
+      apiKey: authConfig.getString("apiKey")
+    } : {
+      username: authConfig.getString("username"),
+      password: authConfig.getString("password")
+    });
+    return {
+      node: config.getString("node"),
+      auth,
+      ...sslConfig ? {
+        ssl: {
+          rejectUnauthorized: sslConfig?.getOptionalBoolean("rejectUnauthorized")
+        }
+      } : {}
+    };
+  }
+  static readIndexTemplateConfig(config) {
+    return config.getOptionalConfigArray("indexTemplates")?.map((templateConfig) => {
+      const bodyConfig = templateConfig.getConfig("body");
+      return {
+        name: templateConfig.getString("name"),
+        body: {
+          index_patterns: bodyConfig.getStringArray("index_patterns"),
+          composed_of: bodyConfig.getOptionalStringArray("composed_of"),
+          template: bodyConfig.getOptionalConfig("template")?.get()
+        }
+      };
+    }) ?? [];
+  }
+}
+function decodePageCursor(pageCursor) {
+  if (!pageCursor) {
+    return { page: 0 };
+  }
+  return {
+    page: Number(Buffer.from(pageCursor, "base64").toString("utf-8"))
+  };
+}
+function encodePageCursor({ page }) {
+  return Buffer.from(`${page}`, "utf-8").toString("base64");
+}
+
+exports.ElasticSearchSearchEngine = ElasticSearchSearchEngine;
+exports.decodePageCursor = decodePageCursor;
+exports.encodePageCursor = encodePageCursor;
+//# sourceMappingURL=ElasticSearchSearchEngine.cjs.js.map

package/dist/engines/ElasticSearchSearchEngine.cjs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ElasticSearchSearchEngine.cjs.js","sources":["../../src/engines/ElasticSearchSearchEngine.ts"],"sourcesContent":["/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport {\n  IndexableDocument,\n  IndexableResult,\n  IndexableResultSet,\n  SearchQuery,\n} from '@backstage/plugin-search-common';\nimport { SearchEngine } from '@backstage/plugin-search-backend-node';\nimport { isEmpty, isNumber, isNaN as nan } from 'lodash';\n\nimport { AwsSigv4Signer } from '@opensearch-project/opensearch/aws';\nimport { RequestSigner } from 'aws4';\nimport { Config } from '@backstage/config';\nimport {\n  ElasticSearchClientOptions,\n  OpenSearchElasticSearchClientOptions,\n} from './ElasticSearchClientOptions';\nimport { ElasticSearchClientWrapper } from './ElasticSearchClientWrapper';\nimport { ElasticSearchCustomIndexTemplate } from './types';\nimport { ElasticSearchSearchEngineIndexer } from './ElasticSearchSearchEngineIndexer';\nimport { MissingIndexError } from '@backstage/plugin-search-backend-node';\nimport esb from 'elastic-builder';\nimport { v4 as uuid } from 'uuid';\nimport {\n  AwsCredentialProvider,\n  DefaultAwsCredentialsManager,\n} from '@backstage/integration-aws-node';\nimport { LoggerService } from '@backstage/backend-plugin-api';\n\nexport type { ElasticSearchClientOptions };\n\n/**\n * Search query that the elasticsearch engine understands.\n * @public\n */\nexport type ElasticSearchConcreteQuery = {\n  documentTypes?: string[];\n  elasticSearchQuery: Object;\n  pageSize: number;\n};\n\n/**\n * Options available for the Elasticsearch specific query translator.\n * @public\n */\nexport type ElasticSearchQueryTranslatorOptions = {\n  highlightOptions?: ElasticSearchHighlightConfig;\n};\n\n/**\n * Elasticsearch specific query translator.\n * @public\n */\nexport type ElasticSearchQueryTranslator = (\n  query: SearchQuery,\n  options?: ElasticSearchQueryTranslatorOptions,\n) => ElasticSearchConcreteQuery;\n\n/**\n * Options for instantiate ElasticSearchSearchEngine\n * @public\n */\nexport type ElasticSearchOptions = {\n  logger: LoggerService;\n  config: Config;\n  aliasPostfix?: string;\n  indexPrefix?: string;\n  translator?: ElasticSearchQueryTranslator;\n};\n\n/**\n * @public\n */\nexport type ElasticSearchHighlightOptions = {\n  fragmentDelimiter?: string;\n  fragmentSize?: number;\n  numFragments?: number;\n};\n\n/**\n * @public\n */\nexport type ElasticSearchHighlightConfig = {\n  fragmentDelimiter: string;\n  fragmentSize: number;\n  numFragments: number;\n  preTag: string;\n  postTag: string;\n};\n\ntype ElasticSearchResult = {\n  _index: string;\n  _type: string;\n  _score: number;\n  _source: IndexableDocument;\n  highlight?: {\n    [field: string]: string[];\n  };\n};\n\nfunction isBlank(str: string) {\n  return (isEmpty(str) && !isNumber(str)) || nan(str);\n}\n\nconst DEFAULT_INDEXER_BATCH_SIZE = 1000;\n\n/**\n * @public\n */\nexport class ElasticSearchSearchEngine implements SearchEngine {\n  private readonly elasticSearchClientWrapper: ElasticSearchClientWrapper;\n  private readonly highlightOptions: ElasticSearchHighlightConfig;\n\n  constructor(\n    private readonly elasticSearchClientOptions: ElasticSearchClientOptions,\n    private readonly aliasPostfix: string,\n    private readonly indexPrefix: string,\n    private readonly logger: LoggerService,\n    private readonly batchSize: number,\n    highlightOptions?: ElasticSearchHighlightOptions,\n  ) {\n    this.elasticSearchClientWrapper =\n      ElasticSearchClientWrapper.fromClientOptions(elasticSearchClientOptions);\n    const uuidTag = uuid();\n    this.highlightOptions = {\n      preTag: `<${uuidTag}>`,\n      postTag: `</${uuidTag}>`,\n      fragmentSize: 1000,\n      numFragments: 1,\n      fragmentDelimiter: ' ... ',\n      ...highlightOptions,\n    };\n  }\n\n  static async fromConfig(options: ElasticSearchOptions) {\n    const {\n      logger,\n      config,\n      aliasPostfix = `search`,\n      indexPrefix = ``,\n      translator,\n    } = options;\n    const credentialProvider = DefaultAwsCredentialsManager.fromConfig(config);\n    const clientOptions = await this.createElasticSearchClientOptions(\n      await credentialProvider?.getCredentialProvider(),\n      config.getConfig('search.elasticsearch'),\n    );\n    if (clientOptions.provider === 'elastic') {\n      logger.info('Initializing Elastic.co ElasticSearch search engine.');\n    } else if (clientOptions.provider === 'aws') {\n      logger.info('Initializing AWS OpenSearch search engine.');\n    } else if (clientOptions.provider === 'opensearch') {\n      logger.info('Initializing OpenSearch search engine.');\n    } else {\n      logger.info('Initializing ElasticSearch search engine.');\n    }\n\n    const engine = new ElasticSearchSearchEngine(\n      clientOptions,\n      aliasPostfix,\n      indexPrefix,\n      logger,\n      config.getOptionalNumber('search.elasticsearch.batchSize') ??\n        DEFAULT_INDEXER_BATCH_SIZE,\n      config.getOptional<ElasticSearchHighlightOptions>(\n        'search.elasticsearch.highlightOptions',\n      ),\n    );\n\n    for (const indexTemplate of this.readIndexTemplateConfig(\n      config.getConfig('search.elasticsearch'),\n    )) {\n      await engine.setIndexTemplate(indexTemplate);\n    }\n\n    if (translator) {\n      await engine.setTranslator(translator);\n    }\n\n    return engine;\n  }\n\n  /**\n   * Create a custom search client from the derived search client configuration.\n   * This need not be the same client that the engine uses internally.\n   *\n   * @example Instantiate an instance of an Elasticsearch client.\n   *\n   * ```ts\n   * import { isOpenSearchCompatible } from '@backstage/plugin-search-backend-module-elasticsearch';\n   * import { Client } from '@elastic/elasticsearch';\n   *\n   * const client = searchEngine.newClient<Client>(options => {\n   *   // This type guard ensures options are compatible with either OpenSearch\n   *   // or Elasticsearch client constructors.\n   *   if (!isOpenSearchCompatible(options)) {\n   *     return new Client(options);\n   *   }\n   *   throw new Error('Incompatible options provided');\n   * });\n   * ```\n   */\n  newClient<T>(create: (options: ElasticSearchClientOptions) => T): T {\n    return create(this.elasticSearchClientOptions);\n  }\n\n  protected translator(\n    query: SearchQuery,\n    options?: ElasticSearchQueryTranslatorOptions,\n  ): ElasticSearchConcreteQuery {\n    const { term, filters = {}, types, pageCursor } = query;\n\n    const filter = Object.entries(filters)\n      .filter(([_, value]) => Boolean(value))\n      .map(([key, value]: [key: string, value: any]) => {\n        if (['string', 'number', 'boolean'].includes(typeof value)) {\n          // Use exact matching for string datatype fields\n          const keyword = typeof value === 'string' ? `${key}.keyword` : key;\n          return esb.matchQuery(keyword, value.toString());\n        }\n        if (Array.isArray(value)) {\n          return esb\n            .boolQuery()\n            .should(value.map(it => esb.matchQuery(key, it.toString())));\n        }\n        this.logger.error('Failed to query, unrecognized filter type', {\n          key,\n          value,\n        });\n        throw new Error(\n          'Failed to add filters to query. Unrecognized filter type',\n        );\n      });\n    const esbQuery = isBlank(term)\n      ? esb.matchAllQuery()\n      : esb\n          .multiMatchQuery(['*'], term)\n          .fuzziness('auto')\n          .minimumShouldMatch(1);\n    const pageSize = query.pageLimit || 25;\n    const { page } = decodePageCursor(pageCursor);\n\n    let esbRequestBodySearch = esb\n      .requestBodySearch()\n      .query(esb.boolQuery().filter(filter).must([esbQuery]))\n      .from(page * pageSize)\n      .size(pageSize);\n\n    if (options?.highlightOptions) {\n      esbRequestBodySearch = esbRequestBodySearch.highlight(\n        esb\n          .highlight('*')\n          .numberOfFragments(options.highlightOptions.numFragments as number)\n          .fragmentSize(options.highlightOptions.fragmentSize as number)\n          .preTags(options.highlightOptions.preTag)\n          .postTags(options.highlightOptions.postTag),\n      );\n    }\n\n    return {\n      elasticSearchQuery: esbRequestBodySearch.toJSON(),\n      documentTypes: types,\n      pageSize,\n    };\n  }\n\n  setTranslator(translator: ElasticSearchQueryTranslator) {\n    this.translator = translator;\n  }\n\n  async setIndexTemplate(template: ElasticSearchCustomIndexTemplate) {\n    try {\n      await this.elasticSearchClientWrapper.putIndexTemplate(template);\n      this.logger.info('Custom index template set');\n    } catch (error) {\n      this.logger.error(`Unable to set custom index template: ${error}`);\n    }\n  }\n\n  async getIndexer(type: string) {\n    const alias = this.constructSearchAlias(type);\n    const indexerLogger = this.logger.child({ documentType: type });\n\n    const indexer = new ElasticSearchSearchEngineIndexer({\n      type,\n      indexPrefix: this.indexPrefix,\n      indexSeparator: this.indexSeparator,\n      alias,\n      elasticSearchClientWrapper: this.elasticSearchClientWrapper,\n      logger: indexerLogger,\n      batchSize: this.batchSize,\n      skipRefresh:\n        (\n          this\n            .elasticSearchClientOptions as OpenSearchElasticSearchClientOptions\n        )?.service === 'aoss',\n    });\n\n    // Attempt cleanup upon failure.\n    // todo(@backstage/search-maintainers): Consider introducing a more\n    // formal mechanism for handling such errors in BatchSearchEngineIndexer and\n    // replacing this handler with it. See: #17291\n    indexer.on('error', async e => {\n      indexerLogger.error(`Failed to index documents for type ${type}`, e);\n      let cleanupError: Error | undefined;\n\n      // In some cases, a failure may have occurred before the indexer was able\n      // to complete initialization. Try up to 5 times to remove the dangling\n      // index.\n      await new Promise<void>(async done => {\n        const maxAttempts = 5;\n        let attempts = 0;\n\n        while (attempts < maxAttempts) {\n          try {\n            await this.elasticSearchClientWrapper.deleteIndex({\n              index: indexer.indexName,\n            });\n\n            attempts = maxAttempts;\n            cleanupError = undefined;\n            done();\n          } catch (err) {\n            cleanupError = err;\n          }\n\n          // Wait 1 second between retries.\n          await new Promise(okay => setTimeout(okay, 1000));\n\n          attempts++;\n        }\n        done();\n      });\n\n      if (cleanupError) {\n        indexerLogger.error(\n          `Unable to clean up elastic index ${indexer.indexName}: ${cleanupError}`,\n        );\n      } else {\n        indexerLogger.info(\n          `Removed partial, failed index ${indexer.indexName}`,\n        );\n      }\n    });\n\n    return indexer;\n  }\n\n  async query(query: SearchQuery): Promise<IndexableResultSet> {\n    const { elasticSearchQuery, documentTypes, pageSize } = this.translator(\n      query,\n      { highlightOptions: this.highlightOptions },\n    );\n    const queryIndices = documentTypes\n      ? documentTypes.map(it => this.constructSearchAlias(it))\n      : this.constructSearchAlias('*');\n    try {\n      const result = await this.elasticSearchClientWrapper.search({\n        index: queryIndices,\n        body: elasticSearchQuery,\n      });\n      const { page } = decodePageCursor(query.pageCursor);\n      const hasNextPage = result.body.hits.total.value > (page + 1) * pageSize;\n      const hasPreviousPage = page > 0;\n      const nextPageCursor = hasNextPage\n        ? encodePageCursor({ page: page + 1 })\n        : undefined;\n      const previousPageCursor = hasPreviousPage\n        ? encodePageCursor({ page: page - 1 })\n        : undefined;\n\n      return {\n        results: result.body.hits.hits.map(\n          (d: ElasticSearchResult, index: number) => {\n            const resultItem: IndexableResult = {\n              type: this.getTypeFromIndex(d._index),\n              document: d._source,\n              rank: pageSize * page + index + 1,\n            };\n\n            if (d.highlight) {\n              resultItem.highlight = {\n                preTag: this.highlightOptions.preTag as string,\n                postTag: this.highlightOptions.postTag as string,\n                fields: Object.fromEntries(\n                  Object.entries(d.highlight).map(([field, fragments]) => [\n                    field,\n                    fragments.join(this.highlightOptions.fragmentDelimiter),\n                  ]),\n                ),\n              };\n            }\n\n            return resultItem;\n          },\n        ),\n        nextPageCursor,\n        previousPageCursor,\n        numberOfResults: result.body.hits.total.value,\n      };\n    } catch (error) {\n      if (error.meta?.body?.error?.type === 'index_not_found_exception') {\n        throw new MissingIndexError(\n          `Missing index for ${queryIndices}. This means there are no documents to search through.`,\n          error,\n        );\n      }\n      this.logger.error(\n        `Failed to query documents for indices ${queryIndices}`,\n        error,\n      );\n      return Promise.reject({ results: [] });\n    }\n  }\n\n  private readonly indexSeparator = '-index__';\n\n  private getTypeFromIndex(index: string) {\n    return index\n      .substring(this.indexPrefix.length)\n      .split(this.indexSeparator)[0];\n  }\n\n  private constructSearchAlias(type: string) {\n    const postFix = this.aliasPostfix ? `__${this.aliasPostfix}` : '';\n    return `${this.indexPrefix}${type}${postFix}`;\n  }\n\n  private static async createElasticSearchClientOptions(\n    credentialProvider: AwsCredentialProvider,\n    config?: Config,\n  ): Promise<ElasticSearchClientOptions> {\n    if (!config) {\n      throw new Error('No elastic search config found');\n    }\n    const clientOptionsConfig = config.getOptionalConfig('clientOptions');\n    const sslConfig = clientOptionsConfig?.getOptionalConfig('ssl');\n\n    if (config.getOptionalString('provider') === 'elastic') {\n      const authConfig = config.getConfig('auth');\n      return {\n        provider: 'elastic',\n        cloud: {\n          id: config.getString('cloudId'),\n        },\n        auth: {\n          username: authConfig.getString('username'),\n          password: authConfig.getString('password'),\n        },\n        ...(sslConfig\n          ? {\n              ssl: {\n                rejectUnauthorized:\n                  sslConfig?.getOptionalBoolean('rejectUnauthorized'),\n              },\n            }\n          : {}),\n      };\n    }\n    if (config.getOptionalString('provider') === 'aws') {\n      const requestSigner = new RequestSigner(config.getString('node'));\n      const service =\n        config.getOptionalString('service') ?? requestSigner.service;\n      if (service !== 'es' && service !== 'aoss')\n        throw new Error(`Unrecognized serivce type: ${service}`);\n      return {\n        provider: 'aws',\n        node: config.getString('node'),\n        region: config.getOptionalString('region'),\n        service,\n        ...(sslConfig\n          ? {\n              ssl: {\n                rejectUnauthorized:\n                  sslConfig?.getOptionalBoolean('rejectUnauthorized'),\n              },\n            }\n          : {}),\n        ...AwsSigv4Signer({\n          region: config.getOptionalString('region') ?? requestSigner.region, // for backwards compatibility\n          service: service,\n          getCredentials: async () =>\n            await credentialProvider.sdkCredentialProvider(),\n        }),\n      };\n    }\n    if (config.getOptionalString('provider') === 'opensearch') {\n      const authConfig = config.getConfig('auth');\n      return {\n        provider: 'opensearch',\n        node: config.getString('node'),\n        auth: {\n          username: authConfig.getString('username'),\n          password: authConfig.getString('password'),\n        },\n        ...(sslConfig\n          ? {\n              ssl: {\n                rejectUnauthorized:\n                  sslConfig?.getOptionalBoolean('rejectUnauthorized'),\n              },\n            }\n          : {}),\n      };\n    }\n    const authConfig = config.getOptionalConfig('auth');\n    const auth =\n      authConfig &&\n      (authConfig.has('apiKey')\n        ? {\n            apiKey: authConfig.getString('apiKey'),\n          }\n        : {\n            username: authConfig.getString('username'),\n            password: authConfig.getString('password'),\n          });\n    return {\n      node: config.getString('node'),\n      auth,\n      ...(sslConfig\n        ? {\n            ssl: {\n              rejectUnauthorized:\n                sslConfig?.getOptionalBoolean('rejectUnauthorized'),\n            },\n          }\n        : {}),\n    };\n  }\n\n  private static readIndexTemplateConfig(\n    config: Config,\n  ): ElasticSearchCustomIndexTemplate[] {\n    return (\n      config.getOptionalConfigArray('indexTemplates')?.map(templateConfig => {\n        const bodyConfig = templateConfig.getConfig('body');\n        return {\n          name: templateConfig.getString('name'),\n          body: {\n            index_patterns: bodyConfig.getStringArray('index_patterns'),\n            composed_of: bodyConfig.getOptionalStringArray('composed_of'),\n            template: bodyConfig.getOptionalConfig('template')?.get(),\n          },\n        };\n      }) ?? []\n    );\n  }\n}\n\n/**\n * @public\n */\nexport function decodePageCursor(pageCursor?: string): { page: number } {\n  if (!pageCursor) {\n    return { page: 0 };\n  }\n\n  return {\n    page: Number(Buffer.from(pageCursor, 'base64').toString('utf-8')),\n  };\n}\n\nexport function encodePageCursor({ page }: { page: number }): string {\n  return Buffer.from(`${page}`, 'utf-8').toString('base64');\n}\n"],"names":["isEmpty","isNumber","nan","ElasticSearchClientWrapper","uuid","DefaultAwsCredentialsManager","esb","ElasticSearchSearchEngineIndexer","MissingIndexError","authConfig","RequestSigner","AwsSigv4Signer"],"mappings":"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"}