From 6985478a324832de604a9181f63b0a3ba23666fe Mon Sep 17 00:00:00 2001 From: Brandon Morelli Date: Thu, 9 Apr 2020 08:22:00 -0700 Subject: [PATCH 001/102] docs: fix rendering of bulleted list (#62855) --- docs/user/alerting/index.asciidoc | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/user/alerting/index.asciidoc b/docs/user/alerting/index.asciidoc index b4f7e6af3d61c..c7cf1186a44be 100644 --- a/docs/user/alerting/index.asciidoc +++ b/docs/user/alerting/index.asciidoc @@ -163,7 +163,8 @@ If you are using an *on-premises* Elastic Stack deployment with <> * <> * <> From a0c247b9cc165638c3c01c87ce02c13ac2a4a698 Mon Sep 17 00:00:00 2001 From: Sandra Gonzales Date: Thu, 9 Apr 2020 11:42:10 -0400 Subject: [PATCH 002/102] [EPM] Change PACKAGES_SAVED_OBJECT_TYPE id (#62818) * changed PACKAGES_SAVED_OBJECT_TYPE id from packageName-version to packageName * change references to keys to package and version Co-authored-by: Elastic Machine --- .../server/routes/epm/handlers.ts | 4 +- .../server/services/datasource.ts | 10 ++-- .../services/epm/elasticsearch/ilm/install.ts | 12 +++-- .../elasticsearch/ingest_pipeline/install.ts | 23 +++++---- .../epm/elasticsearch/template/install.ts | 17 +++++-- .../epm/kibana/index_pattern/install.ts | 27 +++++++---- .../server/services/epm/packages/assets.ts | 2 +- .../server/services/epm/packages/get.ts | 40 +++++----------- .../services/epm/packages/get_objects.ts | 40 ---------------- .../server/services/epm/packages/index.ts | 1 - .../server/services/epm/packages/install.ts | 47 ++++++++++++------- .../server/services/epm/packages/remove.ts | 6 ++- .../server/services/epm/registry/index.ts | 25 +++++----- .../ingest_manager/server/services/setup.ts | 3 +- 14 files changed, 118 insertions(+), 139 deletions(-) diff --git a/x-pack/plugins/ingest_manager/server/routes/epm/handlers.ts b/x-pack/plugins/ingest_manager/server/routes/epm/handlers.ts index 48f37a4d65ac6..ad16e1dde456b 100644 --- a/x-pack/plugins/ingest_manager/server/routes/epm/handlers.ts +++ b/x-pack/plugins/ingest_manager/server/routes/epm/handlers.ts @@ -102,7 +102,9 @@ export const getInfoHandler: RequestHandler { - const pkgInstall = await findInstalledPackageByName({ - savedObjectsClient: soClient, - pkgName, - }); + const pkgInstall = await getInstallation({ savedObjectsClient: soClient, pkgName }); if (pkgInstall) { const [pkgInfo, defaultOutputId] = await Promise.all([ getPackageInfo({ savedObjectsClient: soClient, - pkgkey: `${pkgInstall.name}-${pkgInstall.version}`, + pkgName: pkgInstall.name, + pkgVersion: pkgInstall.version, }), outputService.getDefaultOutputId(soClient), ]); diff --git a/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ilm/install.ts b/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ilm/install.ts index c56322239f27b..60a85e367079f 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ilm/install.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ilm/install.ts @@ -7,9 +7,15 @@ import { CallESAsCurrentUser, ElasticsearchAssetType } from '../../../../types'; import * as Registry from '../../registry'; -export async function installILMPolicy(pkgkey: string, callCluster: CallESAsCurrentUser) { - const ilmPaths = await Registry.getArchiveInfo(pkgkey, (entry: Registry.ArchiveEntry) => - isILMPolicy(entry) +export async function installILMPolicy( + pkgName: string, + pkgVersion: string, + callCluster: CallESAsCurrentUser +) { + const ilmPaths = await Registry.getArchiveInfo( + pkgName, + pkgVersion, + (entry: Registry.ArchiveEntry) => isILMPolicy(entry) ); if (!ilmPaths.length) return; await Promise.all( diff --git a/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ingest_pipeline/install.ts b/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ingest_pipeline/install.ts index 4b65e5554567e..2bbb555ef7393 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ingest_pipeline/install.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/ingest_pipeline/install.ts @@ -30,11 +30,10 @@ export const installPipelines = async ( if (dataset.ingest_pipeline) { acc.push( installPipelinesForDataset({ - pkgkey: Registry.pkgToPkgKey(registryPackage), dataset, callCluster, - packageName: registryPackage.name, - packageVersion: registryPackage.version, + pkgName: registryPackage.name, + pkgVersion: registryPackage.version, }) ); } @@ -68,19 +67,19 @@ export function rewriteIngestPipeline( export async function installPipelinesForDataset({ callCluster, - pkgkey, + pkgName, + pkgVersion, dataset, - packageName, - packageVersion, }: { callCluster: CallESAsCurrentUser; - pkgkey: string; + pkgName: string; + pkgVersion: string; dataset: Dataset; - packageName: string; - packageVersion: string; }): Promise { - const pipelinePaths = await Registry.getArchiveInfo(pkgkey, (entry: Registry.ArchiveEntry) => - isDatasetPipeline(entry, dataset.path) + const pipelinePaths = await Registry.getArchiveInfo( + pkgName, + pkgVersion, + (entry: Registry.ArchiveEntry) => isDatasetPipeline(entry, dataset.path) ); let pipelines: any[] = []; const substitutions: RewriteSubstitution[] = []; @@ -90,7 +89,7 @@ export async function installPipelinesForDataset({ const nameForInstallation = getPipelineNameForInstallation({ pipelineName: name, dataset, - packageVersion, + packageVersion: pkgVersion, }); const content = Registry.getAsset(path).toString('utf-8'); pipelines.push({ diff --git a/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/template/install.ts b/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/template/install.ts index de4ba25590c98..560ddfc1f6885 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/template/install.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/elasticsearch/template/install.ts @@ -20,11 +20,12 @@ import * as Registry from '../../registry'; export const installTemplates = async ( registryPackage: RegistryPackage, callCluster: CallESAsCurrentUser, - pkgkey: string + pkgName: string, + pkgVersion: string ) => { // install any pre-built index template assets, // atm, this is only the base package's global template - installPreBuiltTemplates(pkgkey, callCluster); + installPreBuiltTemplates(pkgName, pkgVersion, callCluster); // build templates per dataset from yml files const datasets = registryPackage.datasets; @@ -45,9 +46,15 @@ export const installTemplates = async ( }; // this is temporary until we update the registry to use index templates v2 structure -const installPreBuiltTemplates = async (pkgkey: string, callCluster: CallESAsCurrentUser) => { - const templatePaths = await Registry.getArchiveInfo(pkgkey, (entry: Registry.ArchiveEntry) => - isTemplate(entry) +const installPreBuiltTemplates = async ( + pkgName: string, + pkgVersion: string, + callCluster: CallESAsCurrentUser +) => { + const templatePaths = await Registry.getArchiveInfo( + pkgName, + pkgVersion, + (entry: Registry.ArchiveEntry) => isTemplate(entry) ); templatePaths.forEach(async path => { const { file } = Registry.pathParts(path); diff --git a/x-pack/plugins/ingest_manager/server/services/epm/kibana/index_pattern/install.ts b/x-pack/plugins/ingest_manager/server/services/epm/kibana/index_pattern/install.ts index 0657fb7759b49..05e64c6565dc6 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/kibana/index_pattern/install.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/kibana/index_pattern/install.ts @@ -68,25 +68,32 @@ export enum IndexPatternType { metrics = 'metrics', events = 'events', } - +// TODO: use a function overload and make pkgName and pkgVersion required for install/update +// and not for an update removal. or separate out the functions export async function installIndexPatterns( savedObjectsClient: SavedObjectsClientContract, - pkgkey?: string + pkgName?: string, + pkgVersion?: string ) { // get all user installed packages const installedPackages = await getPackageKeysByStatus( savedObjectsClient, InstallationStatus.installed ); - // add this package to the array if it doesn't already exist - // this should not happen because a user can't "reinstall" a package - // if it does because the install endpoint is called directly, the install continues - if (pkgkey && !installedPackages.includes(pkgkey)) { - installedPackages.push(pkgkey); + if (pkgName && pkgVersion) { + // add this package to the array if it doesn't already exist + const foundPkg = installedPackages.find(pkg => pkg.pkgName === pkgName); + // this may be removed if we add the packged to saved objects before installing index patterns + // otherwise this is a first time install + // TODO: handle update case when versions are different + if (!foundPkg) { + installedPackages.push({ pkgName, pkgVersion }); + } } - // get each package's registry info - const installedPackagesFetchInfoPromise = installedPackages.map(pkg => Registry.fetchInfo(pkg)); + const installedPackagesFetchInfoPromise = installedPackages.map(pkg => + Registry.fetchInfo(pkg.pkgName, pkg.pkgVersion) + ); const installedPackagesInfo = await Promise.all(installedPackagesFetchInfoPromise); // for each index pattern type, create an index pattern @@ -97,7 +104,7 @@ export async function installIndexPatterns( ]; indexPatternTypes.forEach(async indexPatternType => { // if this is an update because a package is being unisntalled (no pkgkey argument passed) and no other packages are installed, remove the index pattern - if (!pkgkey && installedPackages.length === 0) { + if (!pkgName && installedPackages.length === 0) { try { await savedObjectsClient.delete(INDEX_PATTERN_SAVED_OBJECT_TYPE, `${indexPatternType}-*`); } catch (err) { diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/assets.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/assets.ts index d7a5c5569986e..7026d9eae24c3 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/assets.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/assets.ts @@ -58,7 +58,7 @@ export async function getAssetsData( ): Promise { // TODO: Needs to be called to fill the cache but should not be required const pkgkey = packageInfo.name + '-' + packageInfo.version; - if (!cacheHas(pkgkey)) await Registry.getArchiveInfo(pkgkey); + if (!cacheHas(pkgkey)) await Registry.getArchiveInfo(packageInfo.name, packageInfo.version); // Gather all asset data const assets = getAssets(packageInfo, filter, datasetName); diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts index e963ea138dfd5..0e2c2a3d26073 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts @@ -41,7 +41,7 @@ export async function getPackages( .map(item => createInstallableFrom( item, - savedObjectsVisible.find(({ attributes }) => attributes.name === item.name) + savedObjectsVisible.find(({ id }) => id === item.name) ) ) .sort(sortByName); @@ -53,9 +53,9 @@ export async function getPackageKeysByStatus( status: InstallationStatus ) { const allPackages = await getPackages({ savedObjectsClient }); - return allPackages.reduce((acc, pkg) => { + return allPackages.reduce>((acc, pkg) => { if (pkg.status === status) { - acc.push(`${pkg.name}-${pkg.version}`); + acc.push({ pkgName: pkg.name, pkgVersion: pkg.version }); } return acc; }, []); @@ -63,13 +63,14 @@ export async function getPackageKeysByStatus( export async function getPackageInfo(options: { savedObjectsClient: SavedObjectsClientContract; - pkgkey: string; + pkgName: string; + pkgVersion: string; }): Promise { - const { savedObjectsClient, pkgkey } = options; + const { savedObjectsClient, pkgName, pkgVersion } = options; const [item, savedObject] = await Promise.all([ - Registry.fetchInfo(pkgkey), - getInstallationObject({ savedObjectsClient, pkgkey }), - Registry.getArchiveInfo(pkgkey), + Registry.fetchInfo(pkgName, pkgVersion), + getInstallationObject({ savedObjectsClient, pkgName }), + Registry.getArchiveInfo(pkgName, pkgVersion), ] as const); // adding `as const` due to regression in TS 3.7.2 // see https://github.com/microsoft/TypeScript/issues/34925#issuecomment-550021453 @@ -86,37 +87,22 @@ export async function getPackageInfo(options: { export async function getInstallationObject(options: { savedObjectsClient: SavedObjectsClientContract; - pkgkey: string; + pkgName: string; }) { - const { savedObjectsClient, pkgkey } = options; + const { savedObjectsClient, pkgName } = options; return savedObjectsClient - .get(PACKAGES_SAVED_OBJECT_TYPE, pkgkey) + .get(PACKAGES_SAVED_OBJECT_TYPE, pkgName) .catch(e => undefined); } export async function getInstallation(options: { savedObjectsClient: SavedObjectsClientContract; - pkgkey: string; + pkgName: string; }) { const savedObject = await getInstallationObject(options); return savedObject?.attributes; } -export async function findInstalledPackageByName(options: { - savedObjectsClient: SavedObjectsClientContract; - pkgName: string; -}): Promise { - const { savedObjectsClient, pkgName } = options; - - const res = await savedObjectsClient.find({ - type: PACKAGES_SAVED_OBJECT_TYPE, - search: pkgName, - searchFields: ['name'], - }); - if (res.saved_objects.length) return res.saved_objects[0].attributes; - return undefined; -} - function sortByName(a: { name: string }, b: { name: string }) { if (a.name > b.name) { return 1; diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/get_objects.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/get_objects.ts index b924c045870f3..b623295c5e060 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/get_objects.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/get_objects.ts @@ -11,46 +11,6 @@ import * as Registry from '../registry'; type ArchiveAsset = Pick; type SavedObjectToBe = Required & { type: AssetType }; -export async function getObjects( - pkgkey: string, - filter = (entry: Registry.ArchiveEntry): boolean => true -): Promise { - // Create a Map b/c some values, especially index-patterns, are referenced multiple times - const objects: Map = new Map(); - - // Get paths which match the given filter - const paths = await Registry.getArchiveInfo(pkgkey, filter); - - // Get all objects which matched filter. Add them to the Map - const rootObjects = await Promise.all(paths.map(getObject)); - rootObjects.forEach(obj => objects.set(obj.id, obj)); - - // Each of those objects might have `references` property like [{id, type, name}] - for (const object of rootObjects) { - // For each of those objects, if they have references - for (const reference of object.references) { - // Get the referenced objects. Call same function with a new filter - const referencedObjects = await getObjects(pkgkey, (entry: Registry.ArchiveEntry) => { - // Skip anything we've already stored - if (objects.has(reference.id)) return false; - - // Is the archive entry the reference we want? - const { type, file } = Registry.pathParts(entry.path); - const isType = type === reference.type; - const isJson = file === `${reference.id}.json`; - - return isType && isJson; - }); - - // Add referenced objects to the Map - referencedObjects.forEach(ro => objects.set(ro.id, ro)); - } - } - - // return the array of unique objects - return Array.from(objects.values()); -} - export async function getObject(key: string) { const buffer = Registry.getAsset(key); diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/index.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/index.ts index 79259ce79ff41..d49e0e661440f 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/index.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/index.ts @@ -21,7 +21,6 @@ export { getPackageInfo, getPackages, SearchParams, - findInstalledPackageByName, } from './get'; export { installKibanaAssets, installPackage, ensureInstalledPackage } from './install'; diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/install.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/install.ts index 82523e37509d1..e250b4f176819 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/install.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/install.ts @@ -16,7 +16,7 @@ import { import { installIndexPatterns } from '../kibana/index_pattern/install'; import * as Registry from '../registry'; import { getObject } from './get_objects'; -import { getInstallation, findInstalledPackageByName } from './index'; +import { getInstallation } from './index'; import { installTemplates } from '../elasticsearch/template/install'; import { installPipelines } from '../elasticsearch/ingest_pipeline/install'; import { installILMPolicy } from '../elasticsearch/ilm/install'; @@ -63,7 +63,7 @@ export async function ensureInstalledPackage(options: { callCluster: CallESAsCurrentUser; }): Promise { const { savedObjectsClient, pkgName, callCluster } = options; - const installedPackage = await findInstalledPackageByName({ savedObjectsClient, pkgName }); + const installedPackage = await getInstallation({ savedObjectsClient, pkgName }); if (installedPackage) { return installedPackage; } @@ -74,7 +74,7 @@ export async function ensureInstalledPackage(options: { pkgName, callCluster, }); - return await findInstalledPackageByName({ savedObjectsClient, pkgName }); + return await getInstallation({ savedObjectsClient, pkgName }); } catch (err) { throw new Error(err.message); } @@ -86,22 +86,30 @@ export async function installPackage(options: { callCluster: CallESAsCurrentUser; }): Promise { const { savedObjectsClient, pkgkey, callCluster } = options; - const registryPackageInfo = await Registry.fetchInfo(pkgkey); - const { name: pkgName, version: pkgVersion, internal = false } = registryPackageInfo; + // TODO: change epm API to /packageName/version so we don't need to do this + const [pkgName, pkgVersion] = pkgkey.split('-'); + const registryPackageInfo = await Registry.fetchInfo(pkgName, pkgVersion); + const { internal = false } = registryPackageInfo; const installKibanaAssetsPromise = installKibanaAssets({ savedObjectsClient, - pkgkey, + pkgName, + pkgVersion, }); const installPipelinePromises = installPipelines(registryPackageInfo, callCluster); - const installTemplatePromises = installTemplates(registryPackageInfo, callCluster, pkgkey); + const installTemplatePromises = installTemplates( + registryPackageInfo, + callCluster, + pkgName, + pkgVersion + ); // index patterns and ilm policies are not currently associated with a particular package // so we do not save them in the package saved object state. at some point ILM policies can be installed/modified // per dataset and we should then save them - await installIndexPatterns(savedObjectsClient, pkgkey); + await installIndexPatterns(savedObjectsClient, pkgName, pkgVersion); // currenly only the base package has an ILM policy - await installILMPolicy(pkgkey, callCluster); + await installILMPolicy(pkgName, pkgVersion, callCluster); const res = await Promise.all([ installKibanaAssetsPromise, @@ -126,14 +134,15 @@ export async function installPackage(options: { // e.g. switch statement with cases for each enum key returning `never` for default case export async function installKibanaAssets(options: { savedObjectsClient: SavedObjectsClientContract; - pkgkey: string; + pkgName: string; + pkgVersion: string; }) { - const { savedObjectsClient, pkgkey } = options; + const { savedObjectsClient, pkgName, pkgVersion } = options; // Only install Kibana assets during package installation. const kibanaAssetTypes = Object.values(KibanaAssetType); const installationPromises = kibanaAssetTypes.map(async assetType => - installKibanaSavedObjects({ savedObjectsClient, pkgkey, assetType }) + installKibanaSavedObjects({ savedObjectsClient, pkgName, pkgVersion, assetType }) ); // installKibanaSavedObjects returns AssetReference[], so .map creates AssetReference[][] @@ -149,8 +158,8 @@ export async function saveInstallationReferences(options: { internal: boolean; toSave: AssetReference[]; }) { - const { savedObjectsClient, pkgkey, pkgName, pkgVersion, internal, toSave } = options; - const installation = await getInstallation({ savedObjectsClient, pkgkey }); + const { savedObjectsClient, pkgName, pkgVersion, internal, toSave } = options; + const installation = await getInstallation({ savedObjectsClient, pkgName }); const savedRefs = installation?.installed || []; const mergeRefsReducer = (current: AssetReference[], pending: AssetReference) => { const hasRef = current.find(c => c.id === pending.id && c.type === pending.type); @@ -162,7 +171,7 @@ export async function saveInstallationReferences(options: { await savedObjectsClient.create( PACKAGES_SAVED_OBJECT_TYPE, { installed: toInstall, name: pkgName, version: pkgVersion, internal }, - { id: pkgkey, overwrite: true } + { id: pkgName, overwrite: true } ); return toInstall; @@ -170,16 +179,18 @@ export async function saveInstallationReferences(options: { async function installKibanaSavedObjects({ savedObjectsClient, - pkgkey, + pkgName, + pkgVersion, assetType, }: { savedObjectsClient: SavedObjectsClientContract; - pkgkey: string; + pkgName: string; + pkgVersion: string; assetType: KibanaAssetType; }) { const isSameType = ({ path }: Registry.ArchiveEntry) => assetType === Registry.pathParts(path).type; - const paths = await Registry.getArchiveInfo(pkgkey, isSameType); + const paths = await Registry.getArchiveInfo(pkgName, pkgVersion, isSameType); const toBeSavedObjects = await Promise.all(paths.map(getObject)); if (toBeSavedObjects.length === 0) { diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/remove.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/remove.ts index 2e73160453c2b..a30acb97b99cf 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/remove.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/remove.ts @@ -17,12 +17,14 @@ export async function removeInstallation(options: { callCluster: CallESAsCurrentUser; }): Promise { const { savedObjectsClient, pkgkey, callCluster } = options; - const installation = await getInstallation({ savedObjectsClient, pkgkey }); + // TODO: the epm api should change to /name/version so we don't need to do this + const [pkgName] = pkgkey.split('-'); + const installation = await getInstallation({ savedObjectsClient, pkgName }); const installedObjects = installation?.installed || []; // Delete the manager saved object with references to the asset objects // could also update with [] or some other state - await savedObjectsClient.delete(PACKAGES_SAVED_OBJECT_TYPE, pkgkey); + await savedObjectsClient.delete(PACKAGES_SAVED_OBJECT_TYPE, pkgName); // recreate or delete index patterns when a package is uninstalled await installIndexPatterns(savedObjectsClient); diff --git a/x-pack/plugins/ingest_manager/server/services/epm/registry/index.ts b/x-pack/plugins/ingest_manager/server/services/epm/registry/index.ts index 36a04b88bba29..a96afc5eb7fa5 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/registry/index.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/registry/index.ts @@ -56,10 +56,9 @@ export async function fetchFindLatestPackage( } } -export async function fetchInfo(pkgkey: string): Promise { +export async function fetchInfo(pkgName: string, pkgVersion: string): Promise { const registryUrl = appContextService.getConfig()?.epm.registryUrl; - // change pkg-version to pkg/version - return fetchUrl(`${registryUrl}/package/${pkgkey.replace('-', '/')}`).then(JSON.parse); + return fetchUrl(`${registryUrl}/package/${pkgName}/${pkgVersion}`).then(JSON.parse); } export async function fetchFile(filePath: string): Promise { @@ -73,7 +72,8 @@ export async function fetchCategories(): Promise { } export async function getArchiveInfo( - pkgkey: string, + pkgName: string, + pkgVersion: string, filter = (entry: ArchiveEntry): boolean => true ): Promise { const paths: string[] = []; @@ -87,7 +87,7 @@ export async function getArchiveInfo( } }; - await extract(pkgkey, filter, onEntry); + await extract(pkgName, pkgVersion, filter, onEntry); return paths; } @@ -123,21 +123,22 @@ export function pathParts(path: string): AssetParts { } async function extract( - pkgkey: string, + pkgName: string, + pkgVersion: string, filter = (entry: ArchiveEntry): boolean => true, onEntry: (entry: ArchiveEntry) => void ) { - const archiveBuffer = await getOrFetchArchiveBuffer(pkgkey); + const archiveBuffer = await getOrFetchArchiveBuffer(pkgName, pkgVersion); return untarBuffer(archiveBuffer, filter, onEntry); } -async function getOrFetchArchiveBuffer(pkgkey: string): Promise { +async function getOrFetchArchiveBuffer(pkgName: string, pkgVersion: string): Promise { // assume .tar.gz for now. add support for .zip if/when we need it - const key = `${pkgkey}.tar.gz`; + const key = `${pkgName}-${pkgVersion}.tar.gz`; let buffer = cacheGet(key); if (!buffer) { - buffer = await fetchArchiveBuffer(pkgkey); + buffer = await fetchArchiveBuffer(pkgName, pkgVersion); cacheSet(key, buffer); } @@ -148,8 +149,8 @@ async function getOrFetchArchiveBuffer(pkgkey: string): Promise { } } -async function fetchArchiveBuffer(key: string): Promise { - const { download: archivePath } = await fetchInfo(key); +async function fetchArchiveBuffer(pkgName: string, pkgVersion: string): Promise { + const { download: archivePath } = await fetchInfo(pkgName, pkgVersion); const registryUrl = appContextService.getConfig()?.epm.registryUrl; return getResponseStream(`${registryUrl}${archivePath}`).then(streamToBuffer); } diff --git a/x-pack/plugins/ingest_manager/server/services/setup.ts b/x-pack/plugins/ingest_manager/server/services/setup.ts index 224355ced7cb1..bbaf083fb8396 100644 --- a/x-pack/plugins/ingest_manager/server/services/setup.ts +++ b/x-pack/plugins/ingest_manager/server/services/setup.ts @@ -120,7 +120,8 @@ async function addPackageToConfig( ) { const packageInfo = await getPackageInfo({ savedObjectsClient: soClient, - pkgkey: `${packageToInstall.name}-${packageToInstall.version}`, + pkgName: packageToInstall.name, + pkgVersion: packageToInstall.version, }); await datasourceService.create( soClient, From fddf6cbee5ca1e486f6bc2724d55b2143e93fe74 Mon Sep 17 00:00:00 2001 From: Brandon Morelli Date: Thu, 9 Apr 2020 08:52:06 -0700 Subject: [PATCH 003/102] [APM] docs: add alerting examples for APM (#62864) --- docs/apm/apm-alerts.asciidoc | 97 +++++++++++++++++++++++++++++ docs/apm/images/apm-alert.png | Bin 0 -> 658181 bytes docs/apm/using-the-apm-ui.asciidoc | 3 + 3 files changed, 100 insertions(+) create mode 100644 docs/apm/apm-alerts.asciidoc create mode 100644 docs/apm/images/apm-alert.png diff --git a/docs/apm/apm-alerts.asciidoc b/docs/apm/apm-alerts.asciidoc new file mode 100644 index 0000000000000..b8552c007b13d --- /dev/null +++ b/docs/apm/apm-alerts.asciidoc @@ -0,0 +1,97 @@ +[role="xpack"] +[[apm-alerts]] +=== Create an alert + +beta::[] + +The APM app is integrated with Kibana's {kibana-ref}/alerting-getting-started.html[alerting and actions] feature. +It provides a set of built-in **actions** and APM specific threshold **alerts** for you to use, +and allows all alerts to be centrally managed from <>. + +[role="screenshot"] +image::apm/images/apm-alert.png[Create an alert in the APM app] + +There are two different types of threshold alerts: transaction duration, and error rate. +Below, we'll create one of each. + +[float] +[[apm-create-transaction-alert]] +=== Create a transaction duration alert + +This guide creates an alert for the `opbeans-java` service based on the following criteria: + +* Transaction type: `transaction.type:request` +* Average request is above `1500ms` for the last 5 minutes +* Check every 10 minutes, and repeat the alert every 30 minutes +* Send the alert via Slack + +From the APM app, navigate to the `opbeans-java` service and select +**Alerts** > **Create threshold alert** > **Transaction duration**. + +The name of your alert will automatically be set as `Transaction duration | opbeans-java`, +and the alert will be tagged with `apm` and `service.name:opbeans-java`. +Feel free to edit either of these defaults. + +Based on the alert criteria, define the following alert details: + +* **Check every** - `10 minutes` +* **Notify every** - `30 minutes` +* **TYPE** - `request` +* **WHEN** - `avg` +* **IS ABOVE** - `1500ms` +* **FOR THE LAST** - `5 minutes` + +Select an action type. +Multiple action types can be selected, but in this example we want to post to a slack channel. +Select **Slack** > **Create a connector**. +Enter a name for the connector, +and paste the webhook URL. +See Slack's webhook documentation if you need to create one. + +Select **Save**. The alert has been created and is now active! + +[float] +[[apm-create-error-alert]] +=== Create an error rate alert + +This guide creates an alert for the `opbeans-python` service based on the following criteria: + +* Error rate is above 25 for the last minute +* Check every 1 minute, and repeat the alert every 10 minutes +* Send the alert via email to the `opbeans-python` team + +From the APM app, navigate to the `opbeans-python` service and select +**Alerts** > **Create threshold alert** > **Error rate**. + +The name of your alert will automatically be set as `Error rate | opbeans-python`, +and the alert will be tagged with `apm` and `service.name:opbeans-python`. +Feel free to edit either of these defaults. + +Based on the alert criteria, define the following alert details: + +* **Check every** - `1 minute` +* **Notify every** - `10 minutes` +* **IS ABOVE** - `25 errors` +* **FOR THE LAST** - `1 minute` + +Select the **Email** action type and click **Create a connector**. +Fill out the required details: sender, host, port, etc., and click **save**. + +Select **Save**. The alert has been created and is now active! + +[float] +[[apm-alert-manage]] +=== Manage alerts and actions + +From the APM app, select **Alerts** > **View active alerts** to be taken to the Kibana alerts and actions management page. +From this page, you can create, edit, disable, mute, and delete alerts, and create, edit, and disable connectors. + +[float] +[[apm-alert-more-info]] +=== More information + +See {kibana-ref}/alerting-getting-started.html[alerting and actions] for more information. + +NOTE: If you are using an **on-premise** Elastic Stack deployment with security, +TLS must be configured for communication between Elasticsearch and Kibana. +More information is in the alerting {kibana-ref}/alerting-getting-started.html#alerting-setup-prerequisites[prerequisites]. \ No newline at end of file diff --git a/docs/apm/images/apm-alert.png b/docs/apm/images/apm-alert.png new file mode 100644 index 0000000000000000000000000000000000000000..4cee7214637f8e235db2f9ee1201c603cfdb8aa7 GIT binary patch literal 658181 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

#q|^Hy8wAq!HGKrX@3GsH68Pm$O( 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 z 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 Sfju@hR&lzL+{V0hctHXv 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

+ + + +

); }); @@ -170,3 +186,15 @@ export const HostDetailsFlyout = () => { ); }; + +const useHostLogsUrl = (hostId: string): { url: string; appId: string; appPath: string } => { + const { services } = useKibana(); + return useMemo(() => { + const appPath = `/stream?logFilter=(expression:'host.id:${hostId}',kind:kuery)`; + return { + url: `${services.application.getUrlForApp('logs')}${appPath}`, + appId: 'logs', + appPath, + }; + }, [hostId, services.application]); +}; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx index f6dfae99c1b11..c3ff41268e3db 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx @@ -6,40 +6,26 @@ import React from 'react'; import * as reactTestingLibrary from '@testing-library/react'; -import { Provider } from 'react-redux'; -import { I18nProvider } from '@kbn/i18n/react'; -import { EuiThemeProvider } from '../../../../../../../legacy/common/eui_styled_components'; -import { appStoreFactory } from '../../store'; -import { RouteCapture } from '../route_capture'; -import { createMemoryHistory, MemoryHistory } from 'history'; -import { Router } from 'react-router-dom'; +import { fireEvent } from '@testing-library/react'; import { AppAction } from '../../types'; import { HostList } from './index'; -import { mockHostResultList } from '../../store/hosts/mock_host_result_list'; +import { + mockHostDetailsApiResult, + mockHostResultList, +} from '../../store/hosts/mock_host_result_list'; +import { AppContextTestRender, createAppRootMockRenderer } from '../../mocks'; +import { HostInfo } from '../../../../../common/types'; describe('when on the hosts page', () => { - let render: () => reactTestingLibrary.RenderResult; - let history: MemoryHistory; - let store: ReturnType; + let render: () => ReturnType; + let history: AppContextTestRender['history']; + let store: AppContextTestRender['store']; + let coreStart: AppContextTestRender['coreStart']; beforeEach(async () => { - history = createMemoryHistory(); - store = appStoreFactory(); - render = () => { - return reactTestingLibrary.render( - - - - - - - - - - - - ); - }; + const mockedContext = createAppRootMockRenderer(); + ({ history, store, coreStart } = mockedContext); + render = () => mockedContext.render(); }); it('should show a table', async () => { @@ -56,7 +42,7 @@ describe('when on the hosts page', () => { expect(e).not.toBeNull(); }); }); - describe('when data loads', () => { + describe('when list data loads', () => { beforeEach(() => { reactTestingLibrary.act(() => { const action: AppAction = { @@ -76,6 +62,16 @@ describe('when on the hosts page', () => { describe('when the user clicks the hostname in the table', () => { let renderResult: reactTestingLibrary.RenderResult; beforeEach(async () => { + const hostDetailsApiResponse = mockHostDetailsApiResult(); + + coreStart.http.get.mockReturnValue(Promise.resolve(hostDetailsApiResponse)); + reactTestingLibrary.act(() => { + store.dispatch({ + type: 'serverReturnedHostDetails', + payload: hostDetailsApiResponse, + }); + }); + renderResult = render(); const detailsLink = await renderResult.findByTestId('hostnameCellLink'); if (detailsLink) { @@ -93,19 +89,71 @@ describe('when on the hosts page', () => { }); describe('when there is a selected host in the url', () => { + let hostDetails: HostInfo; beforeEach(() => { + const { + host_status, + metadata: { host, ...details }, + } = mockHostDetailsApiResult(); + hostDetails = { + host_status, + metadata: { + ...details, + host: { + ...host, + id: '1', + }, + }, + }; + + coreStart.http.get.mockReturnValue(Promise.resolve(hostDetails)); + coreStart.application.getUrlForApp.mockReturnValue('/app/logs'); + reactTestingLibrary.act(() => { history.push({ ...history.location, search: '?selected_host=1', }); }); + reactTestingLibrary.act(() => { + store.dispatch({ + type: 'serverReturnedHostDetails', + payload: hostDetails, + }); + }); }); + afterEach(() => { + jest.clearAllMocks(); + }); + it('should show the flyout', () => { const renderResult = render(); return renderResult.findByTestId('hostDetailsFlyout').then(flyout => { expect(flyout).not.toBeNull(); }); }); + it('should include the link to logs', async () => { + const renderResult = render(); + const linkToLogs = await renderResult.findByTestId('hostDetailsLinkToLogs'); + expect(linkToLogs).not.toBeNull(); + expect(linkToLogs.textContent).toEqual('Endpoint Logs'); + expect(linkToLogs.getAttribute('href')).toEqual( + "/app/logs/stream?logFilter=(expression:'host.id:1',kind:kuery)" + ); + }); + describe('when link to logs is clicked', () => { + beforeEach(async () => { + const renderResult = render(); + const linkToLogs = await renderResult.findByTestId('hostDetailsLinkToLogs'); + reactTestingLibrary.act(() => { + fireEvent.click(linkToLogs); + }); + }); + + it('should navigate to logs without full page refresh', async () => { + // FIXME: this is not working :( + expect(coreStart.application.navigateToApp.mock.calls).toHaveLength(1); + }); + }); }); }); From 0dd89e388d3a0d87e7ea07be74b706db234c1c26 Mon Sep 17 00:00:00 2001 From: Nathan Reese Date: Thu, 9 Apr 2020 09:56:11 -0600 Subject: [PATCH 006/102] [Maps] create NOT EXISTS filter for tooltip property with no value (#62849) * [Maps] create NOT EXISTS filter for tooltip property with no value * review feedback --- .../tooltips/es_tooltip_property.test.ts | 105 ++++++++++++++++++ .../layers/tooltips/es_tooltip_property.ts | 19 +++- .../layers/tooltips/join_tooltip_property.ts | 4 +- .../layers/tooltips/tooltip_property.ts | 6 +- 4 files changed, 125 insertions(+), 9 deletions(-) create mode 100644 x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.test.ts diff --git a/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.test.ts b/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.test.ts new file mode 100644 index 0000000000000..2cc9e1513719b --- /dev/null +++ b/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.test.ts @@ -0,0 +1,105 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { IFieldType, IndexPattern } from '../../../../../../src/plugins/data/public'; +import { ESTooltipProperty } from './es_tooltip_property'; +import { TooltipProperty } from './tooltip_property'; +import { AbstractField } from '../fields/field'; +import { FIELD_ORIGIN } from '../../../common/constants'; + +class MockField extends AbstractField {} + +const indexPatternField = { + name: 'machine.os', + type: 'string', + esTypes: ['text'], + count: 0, + scripted: false, + searchable: true, + aggregatable: true, + readFromDocValues: false, +} as IFieldType; + +const featurePropertyField = new MockField({ + fieldName: 'machine.os', + origin: FIELD_ORIGIN.SOURCE, +}); + +const indexPattern = { + id: 'indexPatternId', + fields: { + getByName: (name: string): IFieldType | null => { + return name === 'machine.os' ? indexPatternField : null; + }, + }, + title: 'my index pattern', +} as IndexPattern; + +describe('getESFilters', () => { + test('Should return empty array when field does not exist in index pattern', async () => { + const notFoundFeaturePropertyField = new MockField({ + fieldName: 'field name that is not in index pattern', + origin: FIELD_ORIGIN.SOURCE, + }); + const esTooltipProperty = new ESTooltipProperty( + new TooltipProperty( + notFoundFeaturePropertyField.getName(), + await notFoundFeaturePropertyField.getLabel(), + 'my value' + ), + indexPattern, + notFoundFeaturePropertyField + ); + expect(await esTooltipProperty.getESFilters()).toEqual([]); + }); + + test('Should return phrase filter when field value is provided', async () => { + const esTooltipProperty = new ESTooltipProperty( + new TooltipProperty( + featurePropertyField.getName(), + await featurePropertyField.getLabel(), + 'my value' + ), + indexPattern, + featurePropertyField + ); + expect(await esTooltipProperty.getESFilters()).toEqual([ + { + meta: { + index: 'indexPatternId', + }, + query: { + match_phrase: { + ['machine.os']: 'my value', + }, + }, + }, + ]); + }); + + test('Should return NOT exists filter for null values', async () => { + const esTooltipProperty = new ESTooltipProperty( + new TooltipProperty( + featurePropertyField.getName(), + await featurePropertyField.getLabel(), + undefined + ), + indexPattern, + featurePropertyField + ); + expect(await esTooltipProperty.getESFilters()).toEqual([ + { + meta: { + index: 'indexPatternId', + negate: true, + }, + exists: { + field: 'machine.os', + }, + }, + ]); + }); +}); diff --git a/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.ts b/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.ts index 5c35009881920..d2fdcfaab476c 100644 --- a/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.ts +++ b/x-pack/plugins/maps/public/layers/tooltips/es_tooltip_property.ts @@ -7,8 +7,12 @@ import _ from 'lodash'; import { ITooltipProperty } from './tooltip_property'; import { IField } from '../fields/field'; -import { esFilters, IFieldType, IndexPattern } from '../../../../../../src/plugins/data/public'; -import { PhraseFilter } from '../../../../../../src/plugins/data/public'; +import { + esFilters, + Filter, + IFieldType, + IndexPattern, +} from '../../../../../../src/plugins/data/public'; export class ESTooltipProperty implements ITooltipProperty { private readonly _tooltipProperty: ITooltipProperty; @@ -64,12 +68,19 @@ export class ESTooltipProperty implements ITooltipProperty { ); } - async getESFilters(): Promise { + async getESFilters(): Promise { const indexPatternField = this._getIndexPatternField(); if (!indexPatternField) { return []; } - return [esFilters.buildPhraseFilter(indexPatternField, this.getRawValue(), this._indexPattern)]; + const value = this.getRawValue(); + if (value == null) { + const existsFilter = esFilters.buildExistsFilter(indexPatternField, this._indexPattern); + existsFilter.meta.negate = true; + return [existsFilter]; + } else { + return [esFilters.buildPhraseFilter(indexPatternField, value, this._indexPattern)]; + } } } diff --git a/x-pack/plugins/maps/public/layers/tooltips/join_tooltip_property.ts b/x-pack/plugins/maps/public/layers/tooltips/join_tooltip_property.ts index 4af236f6e9e36..cc95c12ef630f 100644 --- a/x-pack/plugins/maps/public/layers/tooltips/join_tooltip_property.ts +++ b/x-pack/plugins/maps/public/layers/tooltips/join_tooltip_property.ts @@ -6,7 +6,7 @@ import { ITooltipProperty } from './tooltip_property'; import { IJoin } from '../joins/join'; -import { PhraseFilter } from '../../../../../../src/plugins/data/public'; +import { Filter } from '../../../../../../src/plugins/data/public'; export class JoinTooltipProperty implements ITooltipProperty { private readonly _tooltipProperty: ITooltipProperty; @@ -37,7 +37,7 @@ export class JoinTooltipProperty implements ITooltipProperty { return this._tooltipProperty.getHtmlDisplayValue(); } - async getESFilters(): Promise { + async getESFilters(): Promise { const esFilters = []; if (this._tooltipProperty.isFilterable()) { esFilters.push(...(await this._tooltipProperty.getESFilters())); diff --git a/x-pack/plugins/maps/public/layers/tooltips/tooltip_property.ts b/x-pack/plugins/maps/public/layers/tooltips/tooltip_property.ts index 7d680dfe9cae0..8da2ed795943b 100644 --- a/x-pack/plugins/maps/public/layers/tooltips/tooltip_property.ts +++ b/x-pack/plugins/maps/public/layers/tooltips/tooltip_property.ts @@ -5,7 +5,7 @@ */ import _ from 'lodash'; -import { PhraseFilter } from '../../../../../../src/plugins/data/public'; +import { Filter } from '../../../../../../src/plugins/data/public'; import { TooltipFeature } from '../../../../../plugins/maps/common/descriptor_types'; export interface ITooltipProperty { @@ -14,7 +14,7 @@ export interface ITooltipProperty { getHtmlDisplayValue(): string; getRawValue(): string | undefined; isFilterable(): boolean; - getESFilters(): Promise; + getESFilters(): Promise; } export interface LoadFeatureProps { @@ -70,7 +70,7 @@ export class TooltipProperty implements ITooltipProperty { return false; } - async getESFilters(): Promise { + async getESFilters(): Promise { return []; } } From dfea62187f0e1984a50c9cff0c367f31b8728083 Mon Sep 17 00:00:00 2001 From: Maryia Lapata Date: Thu, 9 Apr 2020 18:56:36 +0300 Subject: [PATCH 007/102] [NP] Inline buildPointSeriesData and buildHierarchicalData dependencies (#61575) * Move buildHierarchicalData to vislib * Move shortened version of buildPointSeriesData to Discover * Move buildPointSeriesData to vis_type_vislib * Convert unit tests to jest * Remove ui/agg_response * Convert point_series files to TS * Update TS in unit tests * Convert buildHierarchicalData to TS * Convert buildPointSeriesData to TS in Discover * Clean TS in Discover * Update TS for buildHierarchicalData * Update buildHierarchicalData unit tests * Clean up TS in point_series * Add unit tests fro response_handler.js * Simplify point_series for Discover * Return array for data * Add check for empty row * Simplify point_series for Discover * Return all points * Specify TS * Refactoring * Simplifying * improve types * Update _get_point.test.ts Co-authored-by: Elastic Machine Co-authored-by: Joe Reuter --- .../kibana/public/discover/kibana_services.ts | 2 - .../np_ready/angular/directives/histogram.tsx | 14 +- .../np_ready/angular/helpers/index.ts} | 0 .../np_ready/angular/helpers/point_series.ts | 111 +++++++ .../np_ready/angular/response_handler.js | 3 +- .../core_plugins/kibana/public/kibana.js | 1 - .../vis_type_vislib/public/legacy_imports.ts | 5 - .../vislib/__tests__/response_handlers.js | 137 --------- .../build_hierarchical_data.test.ts} | 108 ++++--- .../hierarchical/build_hierarchical_data.ts} | 50 +++- .../public/vislib/helpers/index.ts} | 13 +- .../helpers/point_series/_add_to_siri.test.ts | 84 ++++++ .../helpers/point_series/_add_to_siri.ts | 60 ++++ .../point_series/_fake_x_aspect.test.ts} | 15 +- .../helpers/point_series/_fake_x_aspect.ts} | 5 +- .../point_series/_get_aspects.test.ts} | 53 ++-- .../helpers/point_series/_get_aspects.ts} | 20 +- .../helpers/point_series/_get_point.test.ts | 104 +++++++ .../helpers/point_series/_get_point.ts} | 53 +++- .../helpers/point_series/_get_series.test.ts | 281 +++++++++++++++++ .../helpers/point_series/_get_series.ts | 88 ++++++ .../point_series/_init_x_axis.test.ts} | 91 +++--- .../helpers/point_series/_init_x_axis.ts} | 20 +- .../point_series/_init_y_axis.test.ts} | 19 +- .../helpers/point_series/_init_y_axis.ts} | 13 +- .../point_series/_ordered_date_axis.test.ts} | 20 +- .../point_series/_ordered_date_axis.ts} | 10 +- .../vislib/helpers/point_series/index.ts} | 10 +- .../point_series/point_series.test.ts} | 81 ++--- .../helpers/point_series/point_series.ts | 118 ++++++++ .../public/vislib/response_handler.js | 4 +- .../public/vislib/response_handler.test.ts | 130 ++++++++ .../vis_type_vislib/public/vislib/types.ts} | 36 ++- .../point_series/__tests__/_add_to_siri.js | 82 ----- .../point_series/__tests__/_get_point.js | 97 ------ .../point_series/__tests__/_get_series.js | 283 ------------------ .../agg_response/point_series/_get_series.js | 100 ------- .../agg_response/point_series/point_series.js | 42 --- .../dashboard_mode/public/dashboard_viewer.js | 1 - .../translations/translations/ja-JP.json | 2 +- .../translations/translations/zh-CN.json | 2 +- 41 files changed, 1328 insertions(+), 1040 deletions(-) rename src/legacy/{ui/public/agg_response/point_series/index.js => core_plugins/kibana/public/discover/np_ready/angular/helpers/index.ts} (100%) create mode 100644 src/legacy/core_plugins/kibana/public/discover/np_ready/angular/helpers/point_series.ts delete mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/__tests__/response_handlers.js rename src/legacy/{ui/public/agg_response/hierarchical/build_hierarchical_data.test.js => core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.test.ts} (80%) rename src/legacy/{ui/public/agg_response/hierarchical/build_hierarchical_data.js => core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.ts} (63%) rename src/legacy/{ui/public/agg_response/point_series/__tests__/point_series.js => core_plugins/vis_type_vislib/public/vislib/helpers/index.ts} (71%) create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.test.ts create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.ts rename src/legacy/{ui/public/agg_response/point_series/__tests__/_fake_x_aspect.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.test.ts} (74%) rename src/legacy/{ui/public/agg_response/point_series/_fake_x_aspect.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.ts} (88%) rename src/legacy/{ui/public/agg_response/point_series/__tests__/_get_aspects.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.test.ts} (53%) rename src/legacy/{ui/public/agg_response/point_series/_get_aspects.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.ts} (72%) create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.test.ts rename src/legacy/{ui/public/agg_response/point_series/_get_point.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.ts} (69%) create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.test.ts create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.ts rename src/legacy/{ui/public/agg_response/point_series/__tests__/_init_x_axis.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.test.ts} (51%) rename src/legacy/{ui/public/agg_response/point_series/_init_x_axis.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.ts} (73%) rename src/legacy/{ui/public/agg_response/point_series/__tests__/_init_y_axis.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.test.ts} (81%) rename src/legacy/{ui/public/agg_response/point_series/_init_y_axis.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.ts} (82%) rename src/legacy/{ui/public/agg_response/point_series/__tests__/_ordered_date_axis.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.test.ts} (76%) rename src/legacy/{ui/public/agg_response/point_series/_ordered_date_axis.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.ts} (72%) rename src/legacy/{ui/public/agg_response/index.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/index.ts} (69%) rename src/legacy/{ui/public/agg_response/point_series/__tests__/_main.js => core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.test.ts} (62%) create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.ts create mode 100644 src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.test.ts rename src/legacy/{ui/public/agg_response/point_series/_add_to_siri.js => core_plugins/vis_type_vislib/public/vislib/types.ts} (67%) delete mode 100644 src/legacy/ui/public/agg_response/point_series/__tests__/_add_to_siri.js delete mode 100644 src/legacy/ui/public/agg_response/point_series/__tests__/_get_point.js delete mode 100644 src/legacy/ui/public/agg_response/point_series/__tests__/_get_series.js delete mode 100644 src/legacy/ui/public/agg_response/point_series/_get_series.js delete mode 100644 src/legacy/ui/public/agg_response/point_series/point_series.js diff --git a/src/legacy/core_plugins/kibana/public/discover/kibana_services.ts b/src/legacy/core_plugins/kibana/public/discover/kibana_services.ts index 98679a8f24d16..0a81ca0222b0a 100644 --- a/src/legacy/core_plugins/kibana/public/discover/kibana_services.ts +++ b/src/legacy/core_plugins/kibana/public/discover/kibana_services.ts @@ -76,5 +76,3 @@ export { EsQuerySortValue, SortDirection, } from '../../../../../plugins/data/public'; -// @ts-ignore -export { buildPointSeriesData } from 'ui/agg_response/point_series/point_series'; diff --git a/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/directives/histogram.tsx b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/directives/histogram.tsx index f788347ac016c..8c55622e4c604 100644 --- a/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/directives/histogram.tsx +++ b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/directives/histogram.tsx @@ -46,9 +46,10 @@ import { IUiSettingsClient } from 'kibana/public'; import { EuiChartThemeType } from '@elastic/eui/dist/eui_charts_theme'; import { Subscription } from 'rxjs'; import { getServices } from '../../../kibana_services'; +import { Chart as IChart } from '../helpers/point_series'; export interface DiscoverHistogramProps { - chartData: any; + chartData: IChart; timefilterUpdateHandler: (ranges: { from: number; to: number }) => void; } @@ -163,7 +164,7 @@ export class DiscoverHistogram extends Component { - const xAxisFormat = this.props.chartData.xAxisFormat.params.pattern; + const xAxisFormat = this.props.chartData.xAxisFormat.params!.pattern; return moment(val).format(xAxisFormat); }; @@ -208,18 +209,19 @@ export class DiscoverHistogram extends Component domainStart ? domainStart : data[0].x; + const domainMin = data[0]?.x > domainStart ? domainStart : data[0]?.x; const domainMax = domainEnd - xInterval > lastXValue ? domainEnd - xInterval : lastXValue; const xDomain = { diff --git a/src/legacy/ui/public/agg_response/point_series/index.js b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/helpers/index.ts similarity index 100% rename from src/legacy/ui/public/agg_response/point_series/index.js rename to src/legacy/core_plugins/kibana/public/discover/np_ready/angular/helpers/index.ts diff --git a/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/helpers/point_series.ts b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/helpers/point_series.ts new file mode 100644 index 0000000000000..02dd024b09812 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/helpers/point_series.ts @@ -0,0 +1,111 @@ +/* + * 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. + */ + +import { uniq } from 'lodash'; +import { Duration, Moment } from 'moment'; +import { Unit } from '@elastic/datemath'; + +import { SerializedFieldFormat } from '../../../../../../../../plugins/expressions/common/types'; + +export interface Column { + id: string; + name: string; +} + +export interface Row { + [key: string]: number | 'NaN'; +} + +export interface Table { + columns: Column[]; + rows: Row[]; +} + +interface HistogramParams { + date: true; + interval: Duration; + intervalESValue: number; + intervalESUnit: Unit; + format: string; + bounds: { + min: Moment; + max: Moment; + }; +} +export interface Dimension { + accessor: 0 | 1; + format: SerializedFieldFormat<{ pattern: string }>; +} + +export interface Dimensions { + x: Dimension & { params: HistogramParams }; + y: Dimension; +} + +interface Ordered { + date: true; + interval: Duration; + intervalESUnit: string; + intervalESValue: number; + min: Moment; + max: Moment; +} +export interface Chart { + values: Array<{ + x: number; + y: number; + }>; + xAxisOrderedValues: number[]; + xAxisFormat: Dimension['format']; + xAxisLabel: Column['name']; + yAxisLabel?: Column['name']; + ordered: Ordered; +} + +export const buildPointSeriesData = (table: Table, dimensions: Dimensions) => { + const { x, y } = dimensions; + const xAccessor = table.columns[x.accessor].id; + const yAccessor = table.columns[y.accessor].id; + const chart = {} as Chart; + + chart.xAxisOrderedValues = uniq(table.rows.map(r => r[xAccessor] as number)); + chart.xAxisFormat = x.format; + chart.xAxisLabel = table.columns[x.accessor].name; + + const { intervalESUnit, intervalESValue, interval, bounds } = x.params; + chart.ordered = { + date: true, + interval, + intervalESUnit, + intervalESValue, + min: bounds.min, + max: bounds.max, + }; + + chart.yAxisLabel = table.columns[y.accessor].name; + + chart.values = table.rows + .filter(row => row && row[yAccessor] !== 'NaN') + .map(row => ({ + x: row[xAccessor] as number, + y: row[yAccessor] as number, + })); + + return chart; +}; diff --git a/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/response_handler.js b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/response_handler.js index 0c19c10841535..04ccb67ec7e25 100644 --- a/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/response_handler.js +++ b/src/legacy/core_plugins/kibana/public/discover/np_ready/angular/response_handler.js @@ -17,7 +17,8 @@ * under the License. */ -import { buildPointSeriesData, getServices } from '../../kibana_services'; +import { getServices } from '../../kibana_services'; +import { buildPointSeriesData } from './helpers'; function tableResponseHandler(table, dimensions) { const converted = { tables: [] }; diff --git a/src/legacy/core_plugins/kibana/public/kibana.js b/src/legacy/core_plugins/kibana/public/kibana.js index bceb3fa7eef8a..0a026a5e0c310 100644 --- a/src/legacy/core_plugins/kibana/public/kibana.js +++ b/src/legacy/core_plugins/kibana/public/kibana.js @@ -46,7 +46,6 @@ import './discover/legacy'; import './visualize/legacy'; import './management'; import './dev_tools'; -import 'ui/agg_response'; import { showAppRedirectNotification } from '../../../../plugins/kibana_legacy/public'; import 'leaflet'; import { localApplicationService } from './local_application_service'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/legacy_imports.ts b/src/legacy/core_plugins/vis_type_vislib/public/legacy_imports.ts index da16a38deba9f..c04ffa506eb04 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/legacy_imports.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/legacy_imports.ts @@ -19,8 +19,3 @@ import { search } from '../../../../plugins/data/public'; export const { tabifyAggResponse, tabifyGetColumns } = search; - -// @ts-ignore -export { buildHierarchicalData } from 'ui/agg_response/hierarchical/build_hierarchical_data'; -// @ts-ignore -export { buildPointSeriesData } from 'ui/agg_response/point_series/point_series'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/__tests__/response_handlers.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/__tests__/response_handlers.js deleted file mode 100644 index 3574fb232883d..0000000000000 --- a/src/legacy/core_plugins/vis_type_vislib/public/vislib/__tests__/response_handlers.js +++ /dev/null @@ -1,137 +0,0 @@ -/* - * 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. - */ - -import sinon from 'sinon'; -import ngMock from 'ng_mock'; -import expect from '@kbn/expect'; - -// eslint-disable-next-line @kbn/eslint/no-restricted-paths -import { aggResponseIndex } from 'ui/agg_response'; - -import { vislibSeriesResponseHandler } from '../response_handler'; - -/** - * TODO: Fix these tests if still needed - * - * All these tests were not being run in master or prodiced false positive results - * Fixing them would require changes to the response handler logic. - */ - -describe.skip('Basic Response Handler', function() { - beforeEach(ngMock.module('kibana')); - - it('returns empty object if conversion failed', () => { - const data = vislibSeriesResponseHandler({}); - expect(data).to.not.be.an('undefined'); - expect(data).to.equal({}); - }); - - it('returns empty object if no data was found', () => { - const data = vislibSeriesResponseHandler({ - columns: [{ id: '1', title: '1', aggConfig: {} }], - rows: [], - }); - expect(data).to.not.be.an('undefined'); - expect(data.rows).to.equal([]); - }); -}); - -describe.skip('renderbot#buildChartData', function() { - describe('for hierarchical vis', function() { - it('defers to hierarchical aggResponse converter', function() { - const football = {}; - const stub = sinon.stub(aggResponseIndex, 'hierarchical').returns(football); - expect(vislibSeriesResponseHandler(football)).to.be(football); - expect(stub).to.have.property('callCount', 1); - expect(stub.firstCall.args[1]).to.be(football); - }); - }); - - describe('for point plot', function() { - it('calls tabify to simplify the data into a table', function() { - const football = { tables: [], hits: { total: 1 } }; - const stub = sinon.stub(aggResponseIndex, 'tabify').returns(football); - expect(vislibSeriesResponseHandler(football)).to.eql({ rows: [], hits: 1 }); - expect(stub).to.have.property('callCount', 1); - expect(stub.firstCall.args[1]).to.be(football); - }); - - it('returns a single chart if the tabify response contains only a single table', function() { - const chart = { hits: 1, rows: [], columns: [] }; - const esResp = { hits: { total: 1 } }; - const tabbed = { tables: [{}] }; - - sinon.stub(aggResponseIndex, 'tabify').returns(tabbed); - expect(vislibSeriesResponseHandler(esResp)).to.eql(chart); - }); - - it('converts table groups into rows/columns wrappers for charts', function() { - const converter = sinon.stub().returns('chart'); - const esResp = { hits: { total: 1 } }; - const tables = [{}, {}, {}, {}]; - - sinon.stub(aggResponseIndex, 'tabify').returns({ - tables: [ - { - aggConfig: { params: { row: true } }, - tables: [ - { - aggConfig: { params: { row: false } }, - tables: [tables[0]], - }, - { - aggConfig: { params: { row: false } }, - tables: [tables[1]], - }, - ], - }, - { - aggConfig: { params: { row: true } }, - tables: [ - { - aggConfig: { params: { row: false } }, - tables: [tables[2]], - }, - { - aggConfig: { params: { row: false } }, - tables: [tables[3]], - }, - ], - }, - ], - }); - - const chartData = vislibSeriesResponseHandler(esResp); - - // verify tables were converted - expect(converter).to.have.property('callCount', 4); - expect(converter.args[0][1]).to.be(tables[0]); - expect(converter.args[1][1]).to.be(tables[1]); - expect(converter.args[2][1]).to.be(tables[2]); - expect(converter.args[3][1]).to.be(tables[3]); - - expect(chartData).to.have.property('rows'); - expect(chartData.rows).to.have.length(2); - chartData.rows.forEach(function(row) { - expect(row).to.have.property('columns'); - expect(row.columns).to.eql(['chart', 'chart']); - }); - }); - }); -}); diff --git a/src/legacy/ui/public/agg_response/hierarchical/build_hierarchical_data.test.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.test.ts similarity index 80% rename from src/legacy/ui/public/agg_response/hierarchical/build_hierarchical_data.test.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.test.ts index 21a937bf1fb66..475555f3a15f3 100644 --- a/src/legacy/ui/public/agg_response/hierarchical/build_hierarchical_data.test.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.test.ts @@ -17,24 +17,26 @@ * under the License. */ -import { buildHierarchicalData } from './build_hierarchical_data'; +import { buildHierarchicalData, Dimensions, Dimension } from './build_hierarchical_data'; +import { Table, TableParent } from '../../types'; -function tableVisResponseHandler(table, dimensions) { - const converted = { +function tableVisResponseHandler(table: Table, dimensions: Dimensions) { + const converted: { + tables: Array; + } = { tables: [], }; const split = dimensions.splitColumn || dimensions.splitRow; if (split) { - converted.direction = dimensions.splitRow ? 'row' : 'column'; const splitColumnIndex = split[0].accessor; const splitColumn = table.columns[splitColumnIndex]; - const splitMap = {}; + const splitMap: { [key: string]: number } = {}; let splitIndex = 0; table.rows.forEach((row, rowIndex) => { - const splitValue = row[splitColumn.id]; + const splitValue = row[splitColumn.id] as string; if (!splitMap.hasOwnProperty(splitValue)) { splitMap[splitValue] = splitIndex++; @@ -46,8 +48,8 @@ function tableVisResponseHandler(table, dimensions) { column: splitColumnIndex, row: rowIndex, table, - tables: [], - }; + tables: [] as Table[], + } as any; tableGroup.tables.push({ $parent: tableGroup, @@ -59,34 +61,30 @@ function tableVisResponseHandler(table, dimensions) { } const tableIndex = splitMap[splitValue]; - converted.tables[tableIndex].tables[0].rows.push(row); + (converted.tables[tableIndex] as TableParent).tables![0].rows.push(row); }); } else { converted.tables.push({ columns: table.columns, rows: table.rows, - }); + } as Table); } return converted; } -jest.mock('ui/new_platform'); -jest.mock('ui/chrome', () => ({ - getUiSettingsClient: jest.fn().mockReturnValue({ - get: jest.fn().mockReturnValue('KQL'), - }), -})); -jest.mock('ui/visualize/loader/pipeline_helpers/utilities', () => ({ - getFormat: jest.fn(() => ({ - convert: jest.fn(v => v), +jest.mock('../../../services', () => ({ + getFormatService: jest.fn(() => ({ + deserialize: () => ({ + convert: jest.fn(v => JSON.stringify(v)), + }), })), })); describe('buildHierarchicalData convertTable', () => { describe('metric only', () => { - let dimensions; - let table; + let dimensions: Dimensions; + let table: Table; beforeEach(() => { const tabifyResponse = { @@ -94,11 +92,11 @@ describe('buildHierarchicalData convertTable', () => { rows: [{ 'col-0-agg_1': 412032 }], }; dimensions = { - metric: { accessor: 0 }, + metric: { accessor: 0 } as Dimension, }; const tableGroup = tableVisResponseHandler(tabifyResponse, dimensions); - table = tableGroup.tables[0]; + table = tableGroup.tables[0] as Table; }); it('should set the slices with one child to a consistent label', () => { @@ -118,8 +116,8 @@ describe('buildHierarchicalData convertTable', () => { }); describe('threeTermBuckets', () => { - let dimensions; - let tables; + let dimensions: Dimensions; + let tables: TableParent[]; beforeEach(async () => { const tabifyResponse = { @@ -231,60 +229,60 @@ describe('buildHierarchicalData convertTable', () => { ], }; dimensions = { - splitRow: [{ accessor: 0 }], - metric: { accessor: 5 }, - buckets: [{ accessor: 2 }, { accessor: 4 }], + splitRow: [{ accessor: 0 } as Dimension], + metric: { accessor: 5 } as Dimension, + buckets: [{ accessor: 2 }, { accessor: 4 }] as Dimension[], }; const tableGroup = await tableVisResponseHandler(tabifyResponse, dimensions); - tables = tableGroup.tables; + tables = tableGroup.tables as TableParent[]; }); it('should set the correct hits attribute for each of the results', () => { tables.forEach(t => { - const results = buildHierarchicalData(t.tables[0], dimensions); + const results = buildHierarchicalData(t.tables![0], dimensions); expect(results).toHaveProperty('hits'); expect(results.hits).toBe(4); }); }); it('should set the correct names for each of the results', () => { - const results0 = buildHierarchicalData(tables[0].tables[0], dimensions); + const results0 = buildHierarchicalData(tables[0].tables![0], dimensions); expect(results0).toHaveProperty('names'); expect(results0.names).toHaveLength(5); - const results1 = buildHierarchicalData(tables[1].tables[0], dimensions); + const results1 = buildHierarchicalData(tables[1].tables![0], dimensions); expect(results1).toHaveProperty('names'); expect(results1.names).toHaveLength(5); - const results2 = buildHierarchicalData(tables[2].tables[0], dimensions); + const results2 = buildHierarchicalData(tables[2].tables![0], dimensions); expect(results2).toHaveProperty('names'); expect(results2.names).toHaveLength(4); }); it('should set the parent of the first item in the split', () => { - const results0 = buildHierarchicalData(tables[0].tables[0], dimensions); + const results0 = buildHierarchicalData(tables[0].tables![0], dimensions); expect(results0).toHaveProperty('slices'); expect(results0.slices).toHaveProperty('children'); expect(results0.slices.children).toHaveLength(2); - expect(results0.slices.children[0].rawData.table.$parent).toHaveProperty('key', 'png'); + expect(results0.slices.children[0].rawData!.table.$parent).toHaveProperty('key', 'png'); - const results1 = buildHierarchicalData(tables[1].tables[0], dimensions); + const results1 = buildHierarchicalData(tables[1].tables![0], dimensions); expect(results1).toHaveProperty('slices'); expect(results1.slices).toHaveProperty('children'); expect(results1.slices.children).toHaveLength(2); - expect(results1.slices.children[0].rawData.table.$parent).toHaveProperty('key', 'css'); + expect(results1.slices.children[0].rawData!.table.$parent).toHaveProperty('key', 'css'); - const results2 = buildHierarchicalData(tables[2].tables[0], dimensions); + const results2 = buildHierarchicalData(tables[2].tables![0], dimensions); expect(results2).toHaveProperty('slices'); expect(results2.slices).toHaveProperty('children'); expect(results2.slices.children).toHaveLength(2); - expect(results2.slices.children[0].rawData.table.$parent).toHaveProperty('key', 'html'); + expect(results2.slices.children[0].rawData!.table.$parent).toHaveProperty('key', 'html'); }); }); describe('oneHistogramBucket', () => { - let dimensions; - let table; + let dimensions: Dimensions; + let table: Table; beforeEach(async () => { const tabifyResponse = { @@ -302,11 +300,11 @@ describe('buildHierarchicalData convertTable', () => { ], }; dimensions = { - metric: { accessor: 1 }, - buckets: [{ accessor: 0, params: { field: 'bytes', interval: 8192 } }], + metric: { accessor: 1 } as Dimension, + buckets: [{ accessor: 0 } as Dimension], }; const tableGroup = await tableVisResponseHandler(tabifyResponse, dimensions); - table = tableGroup.tables[0]; + table = tableGroup.tables[0] as Table; }); it('should set the hits attribute for the results', () => { @@ -320,8 +318,8 @@ describe('buildHierarchicalData convertTable', () => { }); describe('oneRangeBucket', () => { - let dimensions; - let table; + let dimensions: Dimensions; + let table: Table; beforeEach(async () => { const tabifyResponse = { @@ -335,11 +333,11 @@ describe('buildHierarchicalData convertTable', () => { ], }; dimensions = { - metric: { accessor: 1 }, - buckets: [{ accessor: 0, format: { id: 'range', params: { id: 'agg_2' } } }], + metric: { accessor: 1 } as Dimension, + buckets: [{ accessor: 0, format: { id: 'range', params: { id: 'agg_2' } } } as Dimension], }; const tableGroup = await tableVisResponseHandler(tabifyResponse, dimensions); - table = tableGroup.tables[0]; + table = tableGroup.tables[0] as Table; }); it('should set the hits attribute for the results', () => { @@ -348,13 +346,13 @@ describe('buildHierarchicalData convertTable', () => { expect(results).toHaveProperty('slices'); expect(results.slices).toHaveProperty('children'); expect(results).toHaveProperty('names'); - // expect(results.names).toHaveLength(2); + expect(results.names).toHaveLength(2); }); }); describe('oneFilterBucket', () => { - let dimensions; - let table; + let dimensions: Dimensions; + let table: Table; beforeEach(async () => { const tabifyResponse = { @@ -368,15 +366,15 @@ describe('buildHierarchicalData convertTable', () => { ], }; dimensions = { - metric: { accessor: 1 }, + metric: { accessor: 1 } as Dimension, buckets: [ { accessor: 0, }, - ], + ] as Dimension[], }; const tableGroup = await tableVisResponseHandler(tabifyResponse, dimensions); - table = tableGroup.tables[0]; + table = tableGroup.tables[0] as Table; }); it('should set the hits attribute for the results', () => { diff --git a/src/legacy/ui/public/agg_response/hierarchical/build_hierarchical_data.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.ts similarity index 63% rename from src/legacy/ui/public/agg_response/hierarchical/build_hierarchical_data.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.ts index dcc27e956b3f8..2c6d62ed084b5 100644 --- a/src/legacy/ui/public/agg_response/hierarchical/build_hierarchical_data.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/hierarchical/build_hierarchical_data.ts @@ -18,11 +18,41 @@ */ import { toArray } from 'lodash'; -import { getFormat } from 'ui/visualize/loader/pipeline_helpers/utilities'; +import { SerializedFieldFormat } from '../../../../../../../plugins/expressions/common/types'; +import { getFormatService } from '../../../services'; +import { Table } from '../../types'; -export const buildHierarchicalData = (table, { metric, buckets = [] }) => { - let slices; - const names = {}; +export interface Dimension { + accessor: number; + format: { + id?: string; + params?: SerializedFieldFormat; + }; +} + +export interface Dimensions { + metric: Dimension; + buckets?: Dimension[]; + splitRow?: Dimension[]; + splitColumn?: Dimension[]; +} + +interface Slice { + name: string; + size: number; + parent?: Slice; + children?: []; + rawData?: { + table: Table; + row: number; + column: number; + value: string | number | object; + }; +} + +export const buildHierarchicalData = (table: Table, { metric, buckets = [] }: Dimensions) => { + let slices: Slice[]; + const names: { [key: string]: string } = {}; const metricColumn = table.columns[metric.accessor]; const metricFieldFormatter = metric.format; @@ -30,25 +60,25 @@ export const buildHierarchicalData = (table, { metric, buckets = [] }) => { slices = [ { name: metricColumn.name, - size: table.rows[0][metricColumn.id], + size: table.rows[0][metricColumn.id] as number, }, ]; names[metricColumn.name] = metricColumn.name; } else { slices = []; table.rows.forEach((row, rowIndex) => { - let parent; + let parent: Slice; let dataLevel = slices; buckets.forEach(bucket => { const bucketColumn = table.columns[bucket.accessor]; const bucketValueColumn = table.columns[bucket.accessor + 1]; - const bucketFormatter = getFormat(bucket.format); + const bucketFormatter = getFormatService().deserialize(bucket.format); const name = bucketFormatter.convert(row[bucketColumn.id]); - const size = row[bucketValueColumn.id]; + const size = row[bucketValueColumn.id] as number; names[name] = name; - let slice = dataLevel.find(slice => slice.name === name); + let slice = dataLevel.find(dataLevelSlice => dataLevelSlice.name === name); if (!slice) { slice = { name, @@ -66,7 +96,7 @@ export const buildHierarchicalData = (table, { metric, buckets = [] }) => { } parent = slice; - dataLevel = slice.children; + dataLevel = slice.children as []; }); }); } diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/point_series.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/index.ts similarity index 71% rename from src/legacy/ui/public/agg_response/point_series/__tests__/point_series.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/index.ts index 9c3e1c8180eb5..90924e79f6027 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/point_series.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/index.ts @@ -17,14 +17,5 @@ * under the License. */ -describe('Point Series Agg Response', function() { - require('./_main'); - require('./_add_to_siri'); - require('./_fake_x_aspect'); - require('./_get_aspects'); - require('./_get_point'); - require('./_get_series'); - require('./_init_x_axis'); - require('./_init_y_axis'); - require('./_ordered_date_axis'); -}); +export { buildPointSeriesData } from './point_series'; +export { buildHierarchicalData } from './hierarchical/build_hierarchical_data'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.test.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.test.ts new file mode 100644 index 0000000000000..e4fdd6bb71c00 --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.test.ts @@ -0,0 +1,84 @@ +/* + * 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. + */ + +import { addToSiri, Serie } from './_add_to_siri'; +import { Point } from './_get_point'; +import { Dimension } from './point_series'; + +describe('addToSiri', function() { + it('creates a new series the first time it sees an id', function() { + const series = new Map(); + const point = {} as Point; + const id = 'id'; + addToSiri(series, point, id, id, { id }); + + const expectedSerie = series.get(id) as Serie; + expect(series.has(id)).toBe(true); + expect(expectedSerie).toEqual(expect.any(Object)); + expect(expectedSerie.label).toBe(id); + expect(expectedSerie.values).toHaveLength(1); + expect(expectedSerie.values[0]).toBe(point); + }); + + it('adds points to existing series if id has been seen', function() { + const series = new Map(); + const id = 'id'; + + const point = {} as Point; + addToSiri(series, point, id, id, { id }); + + const point2 = {} as Point; + addToSiri(series, point2, id, id, { id }); + + expect(series.has(id)).toBe(true); + expect(series.get(id)).toEqual(expect.any(Object)); + expect(series.get(id).label).toBe(id); + expect(series.get(id).values).toHaveLength(2); + expect(series.get(id).values[0]).toBe(point); + expect(series.get(id).values[1]).toBe(point2); + }); + + it('allows overriding the series label', function() { + const series = new Map(); + const id = 'id'; + const label = 'label'; + const point = {} as Point; + addToSiri(series, point, id, label, { id }); + + expect(series.has(id)).toBe(true); + expect(series.get(id)).toEqual(expect.any(Object)); + expect(series.get(id).label).toBe(label); + expect(series.get(id).values).toHaveLength(1); + expect(series.get(id).values[0]).toBe(point); + }); + + it('correctly sets id and rawId', function() { + const series = new Map(); + const id = 'id-id2'; + + const point = {} as Point; + addToSiri(series, point, id, undefined, {} as Dimension['format']); + + expect(series.has(id)).toBe(true); + expect(series.get(id)).toEqual(expect.any(Object)); + expect(series.get(id).label).toBe(id); + expect(series.get(id).rawId).toBe(id); + expect(series.get(id).id).toBe('id2'); + }); +}); diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.ts new file mode 100644 index 0000000000000..5e5185d6c31ab --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_add_to_siri.ts @@ -0,0 +1,60 @@ +/* + * 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. + */ + +import { Point } from './_get_point'; +import { Dimension } from './point_series'; + +export interface Serie { + id: string; + rawId: string; + label: string; + count: number; + values: Point[]; + format: Dimension['format']; + zLabel?: string; + zFormat?: Dimension['format']; +} + +export function addToSiri( + series: Map, + point: Point, + id: string, + yLabel: string | undefined | null, + yFormat: Dimension['format'], + zFormat?: Dimension['format'], + zLabel?: string +) { + id = id == null ? '' : id + ''; + + if (series.has(id)) { + (series.get(id) as Serie).values.push(point); + return; + } + + series.set(id, { + id: id.split('-').pop() as string, + rawId: id, + label: yLabel == null ? id : yLabel, + count: 0, + values: [point], + format: yFormat, + zLabel, + zFormat, + }); +} diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_fake_x_aspect.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.test.ts similarity index 74% rename from src/legacy/ui/public/agg_response/point_series/__tests__/_fake_x_aspect.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.test.ts index 6c246d7f50897..43d4c3d7ca7c4 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_fake_x_aspect.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.test.ts @@ -16,20 +16,17 @@ * specific language governing permissions and limitations * under the License. */ - -import expect from '@kbn/expect'; -import { makeFakeXAspect } from '../_fake_x_aspect'; +import { makeFakeXAspect } from './_fake_x_aspect'; describe('makeFakeXAspect', function() { it('creates an object that looks like an aspect', function() { const aspect = makeFakeXAspect(); - expect(aspect) - .to.have.property('accessor', -1) - .and.have.property('title', 'All docs') - .and.have.property('format') - .and.have.property('params'); + expect(aspect).toHaveProperty('accessor', -1); + expect(aspect).toHaveProperty('title', 'All docs'); + expect(aspect).toHaveProperty('format'); + expect(aspect).toHaveProperty('params'); - expect(aspect.params).to.have.property('defaultValue', '_all'); + expect(aspect.params).toHaveProperty('defaultValue', '_all'); }); }); diff --git a/src/legacy/ui/public/agg_response/point_series/_fake_x_aspect.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.ts similarity index 88% rename from src/legacy/ui/public/agg_response/point_series/_fake_x_aspect.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.ts index 254a42baeddb0..1bffa4cceb5b0 100644 --- a/src/legacy/ui/public/agg_response/point_series/_fake_x_aspect.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_fake_x_aspect.ts @@ -18,16 +18,17 @@ */ import { i18n } from '@kbn/i18n'; +import { Aspect } from './point_series'; export function makeFakeXAspect() { return { accessor: -1, - title: i18n.translate('common.ui.aggResponse.allDocsTitle', { + title: i18n.translate('visTypeVislib.aggResponse.allDocsTitle', { defaultMessage: 'All docs', }), params: { defaultValue: '_all', }, format: {}, - }; + } as Aspect; } diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_get_aspects.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.test.ts similarity index 53% rename from src/legacy/ui/public/agg_response/point_series/__tests__/_get_aspects.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.test.ts index fab5c2e290e7e..450b283abbed2 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_get_aspects.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.test.ts @@ -17,37 +17,37 @@ * under the License. */ -import expect from '@kbn/expect'; -import { getAspects } from '../_get_aspects'; +import { getAspects } from './_get_aspects'; +import { Dimension, Dimensions, Aspect } from './point_series'; +import { Table, Row } from '../../types'; describe('getAspects', function() { - let table; - let dimensions; + let table: Table; + let dimensions: Dimensions; - function validate(aspect, i) { - expect(aspect) - .to.be.an('object') - .and.have.property('accessor', i); + function validate(aspect: Aspect, i: string) { + expect(aspect).toEqual(expect.any(Object)); + expect(aspect).toHaveProperty('accessor', i); } - function init(group, x, y) { + function init(group: number, x: number | null, y: number) { table = { columns: [ - { id: '0', title: 'date' }, // date - { id: '1', title: 'date utc_time' }, // date - { id: '2', title: 'ext' }, // extension - { id: '3', title: 'geo.src' }, // extension - { id: '4', title: 'count' }, // count - { id: '5', title: 'avg bytes' }, // avg + { id: '0', name: 'date' }, // date + { id: '1', name: 'date utc_time' }, // date + { id: '2', name: 'ext' }, // extension + { id: '3', name: 'geo.src' }, // extension + { id: '4', name: 'count' }, // count + { id: '5', name: 'avg bytes' }, // avg ], - rows: [], - }; + rows: [] as Row[], + } as Table; dimensions = { - x: { accessor: x }, - y: { accessor: y }, - series: { accessor: group }, - }; + x: { accessor: x } as Dimension, + y: [{ accessor: y } as Dimension], + series: [{ accessor: group } as Dimension], + } as Dimensions; } it('produces an aspect object for each of the aspect types found in the columns', function() { @@ -55,8 +55,8 @@ describe('getAspects', function() { const aspects = getAspects(table, dimensions); validate(aspects.x[0], '0'); - validate(aspects.series[0], '1'); - validate(aspects.y[0], '2'); + validate(aspects.series![0], '1'); + validate(aspects.y![0], '2'); }); it('creates a fake x aspect if the column does not exist', function() { @@ -64,9 +64,8 @@ describe('getAspects', function() { const aspects = getAspects(table, dimensions); - expect(aspects.x[0]) - .to.be.an('object') - .and.have.property('accessor', -1) - .and.have.property('title'); + expect(aspects.x[0]).toEqual(expect.any(Object)); + expect(aspects.x[0]).toHaveProperty('accessor', -1); + expect(aspects.x[0]).toHaveProperty('title'); }); }); diff --git a/src/legacy/ui/public/agg_response/point_series/_get_aspects.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.ts similarity index 72% rename from src/legacy/ui/public/agg_response/point_series/_get_aspects.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.ts index fe74d8566c0e7..29134409ddd5f 100644 --- a/src/legacy/ui/public/agg_response/point_series/_get_aspects.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_aspects.ts @@ -18,20 +18,22 @@ */ import { makeFakeXAspect } from './_fake_x_aspect'; +import { Dimensions, Aspects } from './point_series'; +import { Table } from '../../types'; /** * Identify and group the columns based on the aspect of the pointSeries * they represent. * - * @param {array} columns - the list of columns * @return {object} - an object with a key for each aspect (see map). The values - * may be undefined, a single aspect, or an array of aspects. + * may be undefined or an array of aspects. */ -export function getAspects(table, dimensions) { - const aspects = {}; - Object.keys(dimensions).forEach(name => { - const dimension = Array.isArray(dimensions[name]) ? dimensions[name] : [dimensions[name]]; - dimension.forEach(d => { +export function getAspects(table: Table, dimensions: Dimensions) { + const aspects: Partial = {}; + (Object.keys(dimensions) as Array).forEach(name => { + const dimension = dimensions[name]; + const dimensionList = Array.isArray(dimension) ? dimension : [dimension]; + dimensionList.forEach(d => { if (!d) { return; } @@ -42,7 +44,7 @@ export function getAspects(table, dimensions) { if (!aspects[name]) { aspects[name] = []; } - aspects[name].push({ + aspects[name]!.push({ accessor: column.id, column: d.accessor, title: column.name, @@ -56,5 +58,5 @@ export function getAspects(table, dimensions) { aspects.x = [makeFakeXAspect()]; } - return aspects; + return aspects as Aspects; } diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.test.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.test.ts new file mode 100644 index 0000000000000..0c79c5b263cea --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.test.ts @@ -0,0 +1,104 @@ +/* + * 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. + */ + +import { IFieldFormatsRegistry } from '../../../../../../../plugins/data/common'; +import { getPoint } from './_get_point'; +import { setFormatService } from '../../../services'; +import { Aspect } from './point_series'; +import { Table, Row, Column } from '../../types'; + +describe('getPoint', function() { + let deserialize: IFieldFormatsRegistry['deserialize']; + + beforeAll(() => { + deserialize = jest.fn(() => ({ + convert: jest.fn(v => v), + })) as any; + + setFormatService({ + deserialize, + } as any); + }); + + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 1, '1': 2, '2': 3 }, + { '0': 4, '1': 'NaN', '2': 6 }, + ], + } as Table; + + describe('Without series aspect', function() { + let seriesAspect: undefined; + let xAspect: Aspect; + let yAspect: Aspect; + + beforeEach(function() { + xAspect = { accessor: '0' } as Aspect; + yAspect = { accessor: '1', title: 'Y' } as Aspect; + }); + + it('properly unwraps values', function() { + const row = table.rows[0]; + const zAspect = { accessor: '2' } as Aspect; + const point = getPoint(table, xAspect, seriesAspect, row, 0, yAspect, zAspect); + + expect(point).toHaveProperty('x', 1); + expect(point).toHaveProperty('y', 2); + expect(point).toHaveProperty('z', 3); + expect(point).toHaveProperty('series', yAspect.title); + }); + + it('ignores points with a y value of NaN', function() { + const row = table.rows[1]; + const point = getPoint(table, xAspect, seriesAspect, row, 1, yAspect); + expect(point).toBe(void 0); + }); + }); + + describe('With series aspect', function() { + let row: Row; + let xAspect: Aspect; + let yAspect: Aspect; + + beforeEach(function() { + row = table.rows[0]; + xAspect = { accessor: '0' } as Aspect; + yAspect = { accessor: '2' } as Aspect; + }); + + it('properly unwraps values', function() { + const seriesAspect = [{ accessor: '1' } as Aspect]; + const point = getPoint(table, xAspect, seriesAspect, row, 0, yAspect); + + expect(point).toHaveProperty('x', 1); + expect(point).toHaveProperty('series', '2'); + expect(point).toHaveProperty('y', 3); + }); + + it('should call deserialize', function() { + const seriesAspect = [ + { accessor: '1', format: { id: 'number', params: { pattern: '$' } } } as Aspect, + ]; + getPoint(table, xAspect, seriesAspect, row, 0, yAspect); + + expect(deserialize).toHaveBeenCalledWith(seriesAspect[0].format); + }); + }); +}); diff --git a/src/legacy/ui/public/agg_response/point_series/_get_point.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.ts similarity index 69% rename from src/legacy/ui/public/agg_response/point_series/_get_point.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.ts index 11e639f3f54a8..3fc13eb0c04b5 100644 --- a/src/legacy/ui/public/agg_response/point_series/_get_point.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_point.ts @@ -17,19 +17,55 @@ * under the License. */ -import { getFormat } from '../../visualize/loader/pipeline_helpers/utilities'; +import { getFormatService } from '../../../services'; +import { Aspect } from './point_series'; +import { Table, Row } from '../../types'; -export function getPoint(table, x, series, yScale, row, rowIndex, y, z) { +type RowValue = number | string | object | 'NaN'; +interface Raw { + table: Table; + column: number | undefined; + row: number | undefined; + value?: RowValue; +} +export interface Point { + x: RowValue | '_all'; + y: RowValue; + z?: RowValue; + extraMetrics: []; + seriesRaw?: Raw; + xRaw: Raw; + yRaw: Raw; + zRaw?: Raw; + tableRaw?: { + table: Table; + column: number; + row: number; + value: number; + title: string; + }; + parent: Aspect | null; + series?: string; + seriesId?: string; +} +export function getPoint( + table: Table, + x: Aspect, + series: Aspect[] | undefined, + row: Row, + rowIndex: number, + y: Aspect, + z?: Aspect +): Point | undefined { const xRow = x.accessor === -1 ? '_all' : row[x.accessor]; const yRow = row[y.accessor]; const zRow = z && row[z.accessor]; - const point = { + const point: Point = { x: xRow, y: yRow, z: zRow, extraMetrics: [], - yScale: yScale, seriesRaw: series && { table, column: series[0].column, @@ -71,10 +107,9 @@ export function getPoint(table, x, series, yScale, row, rowIndex, y, z) { } if (series) { - const seriesArray = series.length ? series : [series]; - point.series = seriesArray + point.series = series .map(s => { - const fieldFormatter = getFormat(s.format); + const fieldFormatter = getFormatService().deserialize(s.format); return fieldFormatter.convert(row[s.accessor]); }) .join(' - '); @@ -84,9 +119,5 @@ export function getPoint(table, x, series, yScale, row, rowIndex, y, z) { point.series = y.title; } - if (yScale) { - point.y *= yScale; - } - return point; } diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.test.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.test.ts new file mode 100644 index 0000000000000..6b94b9de8e15f --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.test.ts @@ -0,0 +1,281 @@ +/* + * 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. + */ + +import { getSeries } from './_get_series'; +import { setFormatService } from '../../../services'; +import { Chart, Aspect } from './point_series'; +import { Table, Column } from '../../types'; +import { Serie } from './_add_to_siri'; +import { Point } from './_get_point'; + +describe('getSeries', function() { + beforeAll(() => { + setFormatService({ + deserialize: () => ({ + convert: jest.fn(v => v), + }), + } as any); + }); + + it('produces a single series with points for each row', function() { + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + ], + } as Table; + + const chart = { + aspects: { + x: [{ accessor: '0' }], + y: [{ accessor: '1', title: 'y' }], + z: [{ accessor: '2' }], + }, + } as Chart; + + const series = getSeries(table, chart); + + expect(series).toEqual(expect.any(Array)); + expect(series).toHaveLength(1); + + const siri = series[0]; + + expect(siri).toEqual(expect.any(Object)); + expect(siri).toHaveProperty('label', chart.aspects.y[0].title); + expect(siri).toHaveProperty('values'); + + expect(siri.values).toEqual(expect.any(Array)); + expect(siri.values).toHaveLength(5); + + siri.values.forEach(point => { + expect(point).toHaveProperty('x', 1); + expect(point).toHaveProperty('y', 2); + expect(point).toHaveProperty('z', 3); + }); + }); + + it('adds the seriesId to each point', function() { + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + ], + } as Table; + + const chart = { + aspects: { + x: [{ accessor: '0' }], + y: [ + { accessor: '1', title: '0' }, + { accessor: '2', title: '1' }, + ], + }, + } as Chart; + + const series = getSeries(table, chart); + + series[0].values.forEach(point => { + expect(point).toHaveProperty('seriesId', '1'); + }); + + series[1].values.forEach(point => { + expect(point).toHaveProperty('seriesId', '2'); + }); + }); + + it('produces multiple series if there are multiple y aspects', function() { + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + ], + } as Table; + + const chart = { + aspects: { + x: [{ accessor: '0' }], + y: [ + { accessor: '1', title: '0' }, + { accessor: '2', title: '1' }, + ], + }, + } as Chart; + + const series = getSeries(table, chart); + + expect(series).toEqual(expect.any(Array)); + expect(series).toHaveLength(2); + + series.forEach(function(siri: Serie, i: number) { + expect(siri).toEqual(expect.any(Object)); + expect(siri).toHaveProperty('label', '' + i); + expect(siri).toHaveProperty('values'); + + expect(siri.values).toEqual(expect.any(Array)); + expect(siri.values).toHaveLength(5); + + siri.values.forEach(function(point: Point) { + expect(point).toHaveProperty('x', 1); + expect(point).toHaveProperty('y', i + 2); + }); + }); + }); + + it('produces multiple series if there is a series aspect', function() { + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 0, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 0, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 0, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + ], + } as Table; + + const chart = { + aspects: { + x: [{ accessor: -1 } as Aspect], + series: [{ accessor: '0' }], + y: [{ accessor: '1', title: '0' }], + }, + } as Chart; + + const series = getSeries(table, chart); + + expect(series).toEqual(expect.any(Array)); + expect(series).toHaveLength(2); + + series.forEach(function(siri: Serie, i: number) { + expect(siri).toEqual(expect.any(Object)); + expect(siri).toHaveProperty('label', '' + i); + expect(siri).toHaveProperty('values'); + + expect(siri.values).toEqual(expect.any(Array)); + expect(siri.values).toHaveLength(3); + + siri.values.forEach(function(point: Point) { + expect(point).toHaveProperty('y', 2); + }); + }); + }); + + it('produces multiple series if there is a series aspect and multiple y aspects', function() { + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 0, '1': 3, '2': 4 }, + { '0': 1, '1': 3, '2': 4 }, + { '0': 0, '1': 3, '2': 4 }, + { '0': 1, '1': 3, '2': 4 }, + { '0': 0, '1': 3, '2': 4 }, + { '0': 1, '1': 3, '2': 4 }, + ], + } as Table; + + const chart = { + aspects: { + x: [{ accessor: -1 } as Aspect], + series: [{ accessor: '0' }], + y: [ + { accessor: '1', title: '0' }, + { accessor: '2', title: '1' }, + ], + }, + } as Chart; + + const series = getSeries(table, chart); + + expect(series).toEqual(expect.any(Array)); + expect(series).toHaveLength(4); // two series * two metrics + + checkSiri(series[0], '0: 0', 3); + checkSiri(series[1], '0: 1', 4); + checkSiri(series[2], '1: 0', 3); + checkSiri(series[3], '1: 1', 4); + + function checkSiri(siri: Serie, label: string, y: number) { + expect(siri).toEqual(expect.any(Object)); + expect(siri).toHaveProperty('label', label); + expect(siri).toHaveProperty('values'); + + expect(siri.values).toEqual(expect.any(Array)); + expect(siri.values).toHaveLength(3); + + siri.values.forEach(function(point: Point) { + expect(point).toHaveProperty('y', y); + }); + } + }); + + it('produces a series list in the same order as its corresponding metric column', function() { + const table = { + columns: [{ id: '0' }, { id: '1' }, { id: '3' }] as Column[], + rows: [ + { '0': 0, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 0, '1': 2, '2': 3 }, + { '0': 1, '1': 2, '2': 3 }, + { '0': 0, '1': 2, '2': 3 }, + ], + } as Table; + + const chart = { + aspects: { + x: [{ accessor: -1 } as Aspect], + series: [{ accessor: '0' }], + y: [ + { accessor: '1', title: '0' }, + { accessor: '2', title: '1' }, + ], + }, + } as Chart; + + const series = getSeries(table, chart); + expect(series[0]).toHaveProperty('label', '0: 0'); + expect(series[1]).toHaveProperty('label', '0: 1'); + expect(series[2]).toHaveProperty('label', '1: 0'); + expect(series[3]).toHaveProperty('label', '1: 1'); + + // switch the order of the y columns + chart.aspects.y = chart.aspects.y.reverse(); + chart.aspects.y.forEach(function(y: any, i) { + y.i = i; + }); + + const series2 = getSeries(table, chart); + expect(series2[0]).toHaveProperty('label', '0: 1'); + expect(series2[1]).toHaveProperty('label', '0: 0'); + expect(series2[2]).toHaveProperty('label', '1: 1'); + expect(series2[3]).toHaveProperty('label', '1: 0'); + }); +}); diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.ts new file mode 100644 index 0000000000000..edde5b69af022 --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_get_series.ts @@ -0,0 +1,88 @@ +/* + * 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. + */ + +import { partial } from 'lodash'; +import { getPoint } from './_get_point'; +import { addToSiri, Serie } from './_add_to_siri'; +import { Chart } from './point_series'; +import { Table } from '../../types'; + +export function getSeries(table: Table, chart: Chart) { + const aspects = chart.aspects; + const xAspect = aspects.x[0]; + const yAspect = aspects.y[0]; + const zAspect = aspects.z && aspects.z[0]; + const multiY = Array.isArray(aspects.y) && aspects.y.length > 1; + + const partGetPoint = partial(getPoint, table, xAspect, aspects.series); + + const seriesMap = new Map(); + + table.rows.forEach((row, rowIndex) => { + if (!multiY) { + const point = partGetPoint(row, rowIndex, yAspect, zAspect); + if (point) { + const id = `${point.series}-${yAspect.accessor}`; + point.seriesId = id; + addToSiri( + seriesMap, + point, + id, + point.series, + yAspect.format, + zAspect && zAspect.format, + zAspect && zAspect.title + ); + } + return; + } + + aspects.y.forEach(function(y) { + const point = partGetPoint(row, rowIndex, y, zAspect); + if (!point) { + return; + } + + // use the point's y-axis as it's series by default, + // but augment that with series aspect if it's actually + // available + let seriesId = y.accessor; + let seriesLabel = y.title; + + if (aspects.series) { + const prefix = point.series ? point.series + ': ' : ''; + seriesId = prefix + seriesId; + seriesLabel = prefix + seriesLabel; + } + + point.seriesId = seriesId; + addToSiri( + seriesMap, + point, + seriesId as string, + seriesLabel, + y.format, + zAspect && zAspect.format, + zAspect && zAspect.title + ); + }); + }); + + return [...seriesMap.values()]; +} diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_init_x_axis.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.test.ts similarity index 51% rename from src/legacy/ui/public/agg_response/point_series/__tests__/_init_x_axis.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.test.ts index a8512edee658b..d3049d7675408 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_init_x_axis.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.test.ts @@ -17,14 +17,22 @@ * under the License. */ -import expect from '@kbn/expect'; import moment from 'moment'; -import { initXAxis } from '../_init_x_axis'; -import { makeFakeXAspect } from '../_fake_x_aspect'; +import { initXAxis } from './_init_x_axis'; +import { makeFakeXAspect } from './_fake_x_aspect'; +import { + Aspects, + Chart, + DateHistogramOrdered, + DateHistogramParams, + HistogramOrdered, + HistogramParams, +} from './point_series'; +import { Table, Column } from '../../types'; describe('initXAxis', function() { - let chart; - let table; + let chart: Chart; + let table: Table; beforeEach(function() { chart = { @@ -32,50 +40,48 @@ describe('initXAxis', function() { x: [ { ...makeFakeXAspect(), - accessor: 0, + accessor: '0', title: 'label', }, ], - }, - }; + } as Aspects, + } as Chart; table = { - columns: [{ id: '0' }], + columns: [{ id: '0' } as Column], rows: [{ '0': 'hello' }, { '0': 'world' }, { '0': 'foo' }, { '0': 'bar' }, { '0': 'baz' }], }; }); it('sets the xAxisFormatter if the agg is not ordered', function() { initXAxis(chart, table); - expect(chart) - .to.have.property('xAxisLabel', 'label') - .and.have.property('xAxisFormat', chart.aspects.x[0].format); + expect(chart).toHaveProperty('xAxisLabel', 'label'); + expect(chart).toHaveProperty('xAxisFormat', chart.aspects.x[0].format); }); it('makes the chart ordered if the agg is ordered', function() { - chart.aspects.x[0].params.interval = 10; + (chart.aspects.x[0].params as HistogramParams).interval = 10; initXAxis(chart, table); - expect(chart) - .to.have.property('xAxisLabel', 'label') - .and.have.property('xAxisFormat', chart.aspects.x[0].format) - .and.have.property('ordered'); + expect(chart).toHaveProperty('xAxisLabel', 'label'); + expect(chart).toHaveProperty('xAxisFormat', chart.aspects.x[0].format); + expect(chart).toHaveProperty('ordered'); }); describe('xAxisOrderedValues', function() { it('sets the xAxisOrderedValues property', function() { initXAxis(chart, table); - expect(chart).to.have.property('xAxisOrderedValues'); + expect(chart).toHaveProperty('xAxisOrderedValues'); }); it('returns a list of values, preserving the table order', function() { initXAxis(chart, table); - expect(chart.xAxisOrderedValues).to.eql(['hello', 'world', 'foo', 'bar', 'baz']); + expect(chart.xAxisOrderedValues).toEqual(['hello', 'world', 'foo', 'bar', 'baz']); }); it('only returns unique values', function() { table = { - columns: [{ id: '0' }], + columns: [{ id: '0' } as Column], rows: [ { '0': 'hello' }, { '0': 'world' }, @@ -88,45 +94,46 @@ describe('initXAxis', function() { ], }; initXAxis(chart, table); - expect(chart.xAxisOrderedValues).to.eql(['hello', 'world', 'foo', 'bar', 'baz']); + expect(chart.xAxisOrderedValues).toEqual(['hello', 'world', 'foo', 'bar', 'baz']); }); it('returns the defaultValue if using fake x aspect', function() { chart = { aspects: { x: [makeFakeXAspect()], - }, - }; + } as Aspects, + } as Chart; initXAxis(chart, table); - expect(chart.xAxisOrderedValues).to.eql(['_all']); + expect(chart.xAxisOrderedValues).toEqual(['_all']); }); }); it('reads the date interval param from the x agg', function() { - chart.aspects.x[0].params.interval = 'P1D'; - chart.aspects.x[0].params.intervalESValue = 1; - chart.aspects.x[0].params.intervalESUnit = 'd'; - chart.aspects.x[0].params.date = true; + const dateHistogramParams = chart.aspects.x[0].params as DateHistogramParams; + dateHistogramParams.interval = 'P1D'; + dateHistogramParams.intervalESValue = 1; + dateHistogramParams.intervalESUnit = 'd'; + dateHistogramParams.date = true; initXAxis(chart, table); - expect(chart) - .to.have.property('xAxisLabel', 'label') - .and.have.property('xAxisFormat', chart.aspects.x[0].format) - .and.have.property('ordered'); + expect(chart).toHaveProperty('xAxisLabel', 'label'); + expect(chart).toHaveProperty('xAxisFormat', chart.aspects.x[0].format); + expect(chart).toHaveProperty('ordered'); - expect(moment.isDuration(chart.ordered.interval)).to.be(true); - expect(chart.ordered.interval.toISOString()).to.eql('P1D'); - expect(chart.ordered.intervalESValue).to.be(1); - expect(chart.ordered.intervalESUnit).to.be('d'); + expect(chart.ordered).toEqual(expect.any(Object)); + const { intervalESUnit, intervalESValue, interval } = chart.ordered as DateHistogramOrdered; + expect(moment.isDuration(interval)).toBe(true); + expect(interval.toISOString()).toEqual('P1D'); + expect(intervalESValue).toBe(1); + expect(intervalESUnit).toBe('d'); }); it('reads the numeric interval param from the x agg', function() { - chart.aspects.x[0].params.interval = 0.5; + (chart.aspects.x[0].params as HistogramParams).interval = 0.5; initXAxis(chart, table); - expect(chart) - .to.have.property('xAxisLabel', 'label') - .and.have.property('xAxisFormat', chart.aspects.x[0].format) - .and.have.property('ordered'); + expect(chart).toHaveProperty('xAxisLabel', 'label'); + expect(chart).toHaveProperty('xAxisFormat', chart.aspects.x[0].format); + expect(chart).toHaveProperty('ordered'); - expect(chart.ordered.interval).to.eql(0.5); + expect((chart.ordered as HistogramOrdered).interval).toEqual(0.5); }); }); diff --git a/src/legacy/ui/public/agg_response/point_series/_init_x_axis.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.ts similarity index 73% rename from src/legacy/ui/public/agg_response/point_series/_init_x_axis.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.ts index 4a81486783b08..9d16c4857be00 100644 --- a/src/legacy/ui/public/agg_response/point_series/_init_x_axis.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_x_axis.ts @@ -19,27 +19,31 @@ import { uniq } from 'lodash'; import moment from 'moment'; +import { Chart } from './point_series'; +import { Table } from '../../types'; -export function initXAxis(chart, table) { +export function initXAxis(chart: Chart, table: Table) { const { format, title, params, accessor } = chart.aspects.x[0]; chart.xAxisOrderedValues = - accessor === -1 ? [params.defaultValue] : uniq(table.rows.map(r => r[accessor])); + accessor === -1 && 'defaultValue' in params + ? [params.defaultValue] + : uniq(table.rows.map(r => r[accessor])); chart.xAxisFormat = format; chart.xAxisLabel = title; - const { interval, date } = params; - if (interval) { - if (date) { + if ('interval' in params) { + const { interval } = params; + if ('date' in params) { const { intervalESUnit, intervalESValue } = params; chart.ordered = { interval: moment.duration(interval), - intervalESUnit: intervalESUnit, - intervalESValue: intervalESValue, + intervalESUnit, + intervalESValue, }; } else { chart.ordered = { - interval, + interval: params.interval, }; } } diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_init_y_axis.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.test.ts similarity index 81% rename from src/legacy/ui/public/agg_response/point_series/__tests__/_init_y_axis.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.test.ts index 78cd5334e6c86..df84d69c9f849 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_init_y_axis.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.test.ts @@ -18,8 +18,8 @@ */ import _ from 'lodash'; -import expect from '@kbn/expect'; -import { initYAxis } from '../_init_y_axis'; +import { initYAxis } from './_init_y_axis'; +import { Chart } from './point_series'; describe('initYAxis', function() { const baseChart = { @@ -34,7 +34,7 @@ describe('initYAxis', function() { }, ], }, - }; + } as Chart; describe('with a single y aspect', function() { const singleYBaseChart = _.cloneDeep(baseChart); @@ -43,13 +43,13 @@ describe('initYAxis', function() { it('sets the yAxisFormatter the the field formats convert fn', function() { const chart = _.cloneDeep(singleYBaseChart); initYAxis(chart); - expect(chart).to.have.property('yAxisFormat'); + expect(chart).toHaveProperty('yAxisFormat'); }); it('sets the yAxisLabel', function() { const chart = _.cloneDeep(singleYBaseChart); initYAxis(chart); - expect(chart).to.have.property('yAxisLabel', 'y1'); + expect(chart).toHaveProperty('yAxisLabel', 'y1'); }); }); @@ -58,16 +58,15 @@ describe('initYAxis', function() { const chart = _.cloneDeep(baseChart); initYAxis(chart); - expect(chart).to.have.property('yAxisFormat'); - expect(chart.yAxisFormat) - .to.be(chart.aspects.y[0].format) - .and.not.be(chart.aspects.y[1].format); + expect(chart).toHaveProperty('yAxisFormat'); + expect(chart.yAxisFormat).toBe(chart.aspects.y[0].format); + expect(chart.yAxisFormat).not.toBe(chart.aspects.y[1].format); }); it('does not set the yAxisLabel, it does not make sense to put multiple labels on the same axis', function() { const chart = _.cloneDeep(baseChart); initYAxis(chart); - expect(chart).to.have.property('yAxisLabel', ''); + expect(chart).toHaveProperty('yAxisLabel', ''); }); }); }); diff --git a/src/legacy/ui/public/agg_response/point_series/_init_y_axis.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.ts similarity index 82% rename from src/legacy/ui/public/agg_response/point_series/_init_y_axis.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.ts index 42f5e79a63172..43ba0557949ac 100644 --- a/src/legacy/ui/public/agg_response/point_series/_init_y_axis.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_init_y_axis.ts @@ -17,7 +17,9 @@ * under the License. */ -export function initYAxis(chart) { +import { Chart } from './point_series'; + +export function initYAxis(chart: Chart) { const y = chart.aspects.y; if (Array.isArray(y)) { @@ -28,12 +30,7 @@ export function initYAxis(chart) { const z = chart.aspects.series; if (z) { - if (Array.isArray(z)) { - chart.zAxisFormat = z[0].format; - chart.zAxisLabel = ''; - } else { - chart.zAxisFormat = z.format; - chart.zAxisLabel = z.title; - } + chart.zAxisFormat = z[0].format; + chart.zAxisLabel = ''; } } diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_ordered_date_axis.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.test.ts similarity index 76% rename from src/legacy/ui/public/agg_response/point_series/__tests__/_ordered_date_axis.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.test.ts index 2e08be16278d5..25e466f21c3e7 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_ordered_date_axis.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.test.ts @@ -19,8 +19,8 @@ import moment from 'moment'; import _ from 'lodash'; -import expect from '@kbn/expect'; -import { orderedDateAxis } from '../_ordered_date_axis'; +import { orderedDateAxis } from './_ordered_date_axis'; +import { DateHistogramParams, OrderedChart } from './point_series'; describe('orderedDateAxis', function() { const baseArgs = { @@ -46,7 +46,7 @@ describe('orderedDateAxis', function() { }, ], }, - }, + } as OrderedChart, }; describe('ordered object', function() { @@ -54,24 +54,24 @@ describe('orderedDateAxis', function() { const args = _.cloneDeep(baseArgs); orderedDateAxis(args.chart); - expect(args.chart).to.have.property('ordered'); + expect(args.chart).toHaveProperty('ordered'); - expect(args.chart.ordered).to.have.property('date', true); + expect(args.chart.ordered).toHaveProperty('date', true); }); it('sets the min/max when the buckets are bounded', function() { const args = _.cloneDeep(baseArgs); orderedDateAxis(args.chart); - expect(args.chart.ordered).to.have.property('min'); - expect(args.chart.ordered).to.have.property('max'); + expect(args.chart.ordered).toHaveProperty('min'); + expect(args.chart.ordered).toHaveProperty('max'); }); it('does not set the min/max when the buckets are unbounded', function() { const args = _.cloneDeep(baseArgs); - args.chart.aspects.x[0].params.bounds = null; + (args.chart.aspects.x[0].params as DateHistogramParams).bounds = undefined; orderedDateAxis(args.chart); - expect(args.chart.ordered).to.not.have.property('min'); - expect(args.chart.ordered).to.not.have.property('max'); + expect(args.chart.ordered).not.toHaveProperty('min'); + expect(args.chart.ordered).not.toHaveProperty('max'); }); }); }); diff --git a/src/legacy/ui/public/agg_response/point_series/_ordered_date_axis.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.ts similarity index 72% rename from src/legacy/ui/public/agg_response/point_series/_ordered_date_axis.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.ts index a1dd50dc6c71b..193b10a563563 100644 --- a/src/legacy/ui/public/agg_response/point_series/_ordered_date_axis.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/_ordered_date_axis.ts @@ -17,17 +17,17 @@ * under the License. */ -// import moment from 'moment'; +import { OrderedChart } from './point_series'; -export function orderedDateAxis(chart) { +export function orderedDateAxis(chart: OrderedChart) { const x = chart.aspects.x[0]; - const { bounds } = x.params; + const bounds = 'bounds' in x.params ? x.params.bounds : undefined; chart.ordered.date = true; if (bounds) { - chart.ordered.min = isNaN(bounds.min) ? Date.parse(bounds.min) : bounds.min; - chart.ordered.max = isNaN(bounds.max) ? Date.parse(bounds.max) : bounds.max; + chart.ordered.min = typeof bounds.min === 'string' ? Date.parse(bounds.min) : bounds.min; + chart.ordered.max = typeof bounds.max === 'string' ? Date.parse(bounds.max) : bounds.max; } else { chart.ordered.endzones = false; } diff --git a/src/legacy/ui/public/agg_response/index.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/index.ts similarity index 69% rename from src/legacy/ui/public/agg_response/index.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/index.ts index 982c1c25a8101..9bfba4de966be 100644 --- a/src/legacy/ui/public/agg_response/index.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/index.ts @@ -17,12 +17,4 @@ * under the License. */ -import { buildHierarchicalData } from './hierarchical/build_hierarchical_data'; -import { buildPointSeriesData } from './point_series/point_series'; -import { search } from '../../../../plugins/data/public'; - -export const aggResponseIndex = { - hierarchical: buildHierarchicalData, - pointSeries: buildPointSeriesData, - tabify: search.tabifyAggResponse, -}; +export { buildPointSeriesData } from './point_series'; diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_main.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.test.ts similarity index 62% rename from src/legacy/ui/public/agg_response/point_series/__tests__/_main.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.test.ts index a4c23cb537488..3725bf06660e2 100644 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_main.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.test.ts @@ -18,17 +18,25 @@ */ import _ from 'lodash'; -import expect from '@kbn/expect'; -import { buildPointSeriesData } from '../point_series'; +import { buildPointSeriesData, Dimensions } from './point_series'; +import { Table, Column } from '../../types'; +import { setFormatService } from '../../../services'; +import { Serie } from './_add_to_siri'; describe('pointSeriesChartDataFromTable', function() { - this.slow(1000); + beforeAll(() => { + setFormatService({ + deserialize: () => ({ + convert: jest.fn(v => v), + }), + } as any); + }); it('handles a table with just a count', function() { const table = { - columns: [{ id: '0' }], + columns: [{ id: '0' } as Column], rows: [{ '0': 100 }], - }; + } as Table; const chartData = buildPointSeriesData(table, { y: [ { @@ -36,16 +44,15 @@ describe('pointSeriesChartDataFromTable', function() { params: {}, }, ], - }); + } as Dimensions); - expect(chartData).to.be.an('object'); - expect(chartData.series).to.be.an('array'); - expect(chartData.series).to.have.length(1); + expect(chartData).toEqual(expect.any(Object)); + expect(chartData.series).toEqual(expect.any(Array)); + expect(chartData.series).toHaveLength(1); const series = chartData.series[0]; - expect(series.values).to.have.length(1); - expect(series.values[0]) - .to.have.property('x', '_all') - .and.have.property('y', 100); + expect(series.values).toHaveLength(1); + expect(series.values[0]).toHaveProperty('x', '_all'); + expect(series.values[0]).toHaveProperty('y', 100); }); it('handles a table with x and y column', function() { @@ -59,21 +66,21 @@ describe('pointSeriesChartDataFromTable', function() { { '0': 2, '1': 200 }, { '0': 3, '1': 200 }, ], - }; + } as Table; const dimensions = { - x: [{ accessor: 0, params: {} }], + x: { accessor: 0, params: {} }, y: [{ accessor: 1, params: {} }], - }; + } as Dimensions; const chartData = buildPointSeriesData(table, dimensions); - expect(chartData).to.be.an('object'); - expect(chartData.series).to.be.an('array'); - expect(chartData.series).to.have.length(1); + expect(chartData).toEqual(expect.any(Object)); + expect(chartData.series).toEqual(expect.any(Array)); + expect(chartData.series).toHaveLength(1); const series = chartData.series[0]; - expect(series).to.have.property('label', 'Count'); - expect(series.values).to.have.length(3); + expect(series).toHaveProperty('label', 'Count'); + expect(series.values).toHaveLength(3); }); it('handles a table with an x and two y aspects', function() { @@ -84,23 +91,23 @@ describe('pointSeriesChartDataFromTable', function() { { '0': 2, '1': 200, '2': 300 }, { '0': 3, '1': 200, '2': 300 }, ], - }; + } as Table; const dimensions = { - x: [{ accessor: 0, params: {} }], + x: { accessor: 0, params: {} }, y: [ { accessor: 1, params: {} }, { accessor: 2, params: {} }, ], - }; + } as Dimensions; const chartData = buildPointSeriesData(table, dimensions); - expect(chartData).to.be.an('object'); - expect(chartData.series).to.be.an('array'); - expect(chartData.series).to.have.length(2); - chartData.series.forEach(function(siri, i) { - expect(siri).to.have.property('label', `Count-${i}`); - expect(siri.values).to.have.length(3); + expect(chartData).toEqual(expect.any(Object)); + expect(chartData.series).toEqual(expect.any(Array)); + expect(chartData.series).toHaveLength(2); + chartData.series.forEach(function(siri: Serie, i: number) { + expect(siri).toHaveProperty('label', `Count-${i}`); + expect(siri.values).toHaveLength(3); }); }); @@ -121,21 +128,21 @@ describe('pointSeriesChartDataFromTable', function() { }; const dimensions = { - x: [{ accessor: 0, params: {} }], + x: { accessor: 0, params: {} }, series: [{ accessor: 1, params: {} }], y: [ { accessor: 2, params: {} }, { accessor: 3, params: {} }, ], - }; + } as Dimensions; const chartData = buildPointSeriesData(table, dimensions); - expect(chartData).to.be.an('object'); - expect(chartData.series).to.be.an('array'); + expect(chartData).toEqual(expect.any(Object)); + expect(chartData.series).toEqual(expect.any(Array)); // one series for each extension, and then one for each metric inside - expect(chartData.series).to.have.length(4); - chartData.series.forEach(function(siri) { - expect(siri.values).to.have.length(2); + expect(chartData.series).toHaveLength(4); + chartData.series.forEach(function(siri: Serie) { + expect(siri.values).toHaveLength(2); }); }); }); diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.ts new file mode 100644 index 0000000000000..a1681e0d71bd3 --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/helpers/point_series/point_series.ts @@ -0,0 +1,118 @@ +/* + * 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. + */ + +import { Duration } from 'moment'; +import { getSeries } from './_get_series'; +import { getAspects } from './_get_aspects'; +import { initYAxis } from './_init_y_axis'; +import { initXAxis } from './_init_x_axis'; +import { orderedDateAxis } from './_ordered_date_axis'; +import { Serie } from './_add_to_siri'; +import { Column, Table } from '../../types'; + +export interface DateHistogramParams { + date: boolean; + interval: string; + intervalESValue: number; + intervalESUnit: string; + format: string; + bounds?: { + min: string | number; + max: string | number; + }; +} +export interface HistogramParams { + interval: number; +} +export interface FakeParams { + defaultValue: string; +} +export interface Dimension { + accessor: number; + format: { + id?: string; + params?: { pattern?: string; [key: string]: any }; + }; + params: DateHistogramParams | HistogramParams | FakeParams | {}; +} + +export interface Dimensions { + x: Dimension | null; + y: Dimension[]; + z?: Dimension[]; + series?: Dimension | Dimension[]; +} +export interface Aspect { + accessor: Column['id']; + column?: Dimension['accessor']; + title: Column['name']; + format: Dimension['format']; + params: Dimension['params']; +} +export type Aspects = { x: Aspect[]; y: Aspect[] } & { [key in keyof Dimensions]?: Aspect[] }; + +export interface DateHistogramOrdered { + interval: Duration; + intervalESUnit: DateHistogramParams['intervalESUnit']; + intervalESValue: DateHistogramParams['intervalESValue']; +} +export interface HistogramOrdered { + interval: HistogramParams['interval']; +} + +type Ordered = (DateHistogramOrdered | HistogramOrdered) & { + date?: boolean; + min?: number; + max?: number; + endzones?: boolean; +}; + +export interface Chart { + aspects: Aspects; + series: Serie[]; + xAxisOrderedValues?: Array; + xAxisFormat?: Dimension['format']; + xAxisLabel?: Column['name']; + yAxisFormat?: Dimension['format']; + yAxisLabel?: Column['name']; + zAxisFormat?: Dimension['format']; + zAxisLabel?: Column['name']; + ordered?: Ordered; +} + +export type OrderedChart = Chart & { ordered: Ordered }; + +export const buildPointSeriesData = (table: Table, dimensions: Dimensions) => { + const chart = { + aspects: getAspects(table, dimensions), + } as Chart; + + initXAxis(chart, table); + initYAxis(chart); + + if ('date' in chart.aspects.x[0].params) { + // initXAxis will turn `chart` into an `OrderedChart if it is a date axis` + orderedDateAxis(chart as OrderedChart); + } + + chart.series = getSeries(table, chart); + + delete chart.aspects; + return chart; +}; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.js index 9ba86c5181a4c..b5f80303b1d74 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.js @@ -17,8 +17,8 @@ * under the License. */ -import { buildHierarchicalData, buildPointSeriesData } from '../legacy_imports'; import { getFormatService } from '../services'; +import { buildHierarchicalData, buildPointSeriesData } from './helpers'; function tableResponseHandler(table, dimensions) { const converted = { tables: [] }; @@ -72,7 +72,7 @@ function tableResponseHandler(table, dimensions) { function convertTableGroup(tableGroup, convertTable) { const tables = tableGroup.tables; - if (!tables.length) return; + if (!tables || !tables.length) return; const firstChild = tables[0]; if (firstChild.columns) { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.test.ts b/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.test.ts new file mode 100644 index 0000000000000..4a8bebc493235 --- /dev/null +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/response_handler.test.ts @@ -0,0 +1,130 @@ +/* + * 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. + */ + +import { setFormatService } from '../services'; + +jest.mock('./helpers', () => ({ + buildHierarchicalData: jest.fn(() => ({})), + buildPointSeriesData: jest.fn(() => ({})), +})); + +// @ts-ignore +import { vislibSeriesResponseHandler, vislibSlicesResponseHandler } from './response_handler'; +import { buildHierarchicalData, buildPointSeriesData } from './helpers'; +import { Table } from './types'; + +describe('response_handler', () => { + describe('vislibSlicesResponseHandler', () => { + test('should not call buildHierarchicalData when no columns', () => { + vislibSlicesResponseHandler({ rows: [] }, {}); + expect(buildHierarchicalData).not.toHaveBeenCalled(); + }); + + test('should call buildHierarchicalData', () => { + const response = { + rows: [{ 'col-0-1': 1 }], + columns: [{ id: 'col-0-1', name: 'Count' }], + }; + const dimensions = { metric: { accessor: 0 } }; + vislibSlicesResponseHandler(response, dimensions); + + expect(buildHierarchicalData).toHaveBeenCalledWith( + { columns: [...response.columns], rows: [...response.rows] }, + dimensions + ); + }); + }); + + describe('vislibSeriesResponseHandler', () => { + let resp: Table; + let expected: any; + + beforeAll(() => { + setFormatService({ + deserialize: () => ({ + convert: jest.fn(v => v), + }), + } as any); + }); + + beforeAll(() => { + resp = { + rows: [ + { 'col-0-3': 158599872, 'col-1-1': 1 }, + { 'col-0-3': 158599893, 'col-1-1': 2 }, + { 'col-0-3': 158599908, 'col-1-1': 1 }, + ], + columns: [ + { id: 'col-0-3', name: 'timestamp per 30 seconds' }, + { id: 'col-1-1', name: 'Count' }, + ], + } as Table; + + const colId = resp.columns[0].id; + expected = [ + { label: `${resp.rows[0][colId]}: ${resp.columns[0].name}` }, + { label: `${resp.rows[1][colId]}: ${resp.columns[0].name}` }, + { label: `${resp.rows[2][colId]}: ${resp.columns[0].name}` }, + ]; + }); + + test('should not call buildPointSeriesData when no columns', () => { + vislibSeriesResponseHandler({ rows: [] }, {}); + expect(buildPointSeriesData).not.toHaveBeenCalled(); + }); + + test('should call buildPointSeriesData', () => { + const response = { + rows: [{ 'col-0-1': 1 }], + columns: [{ id: 'col-0-1', name: 'Count' }], + }; + const dimensions = { x: null, y: { accessor: 0 } }; + vislibSeriesResponseHandler(response, dimensions); + + expect(buildPointSeriesData).toHaveBeenCalledWith( + { columns: [...response.columns], rows: [...response.rows] }, + dimensions + ); + }); + + test('should split columns', () => { + const dimensions = { + x: null, + y: [{ accessor: 1 }], + splitColumn: [{ accessor: 0 }], + }; + + const convertedResp = vislibSlicesResponseHandler(resp, dimensions); + expect(convertedResp.columns).toHaveLength(resp.rows.length); + expect(convertedResp.columns).toEqual(expected); + }); + + test('should split rows', () => { + const dimensions = { + x: null, + y: [{ accessor: 1 }], + splitRow: [{ accessor: 0 }], + }; + + const convertedResp = vislibSlicesResponseHandler(resp, dimensions); + expect(convertedResp.rows).toHaveLength(resp.rows.length); + expect(convertedResp.rows).toEqual(expected); + }); + }); +}); diff --git a/src/legacy/ui/public/agg_response/point_series/_add_to_siri.js b/src/legacy/core_plugins/vis_type_vislib/public/vislib/types.ts similarity index 67% rename from src/legacy/ui/public/agg_response/point_series/_add_to_siri.js rename to src/legacy/core_plugins/vis_type_vislib/public/vislib/types.ts index 9a0fcbc7b267c..ad59603663b84 100644 --- a/src/legacy/ui/public/agg_response/point_series/_add_to_siri.js +++ b/src/legacy/core_plugins/vis_type_vislib/public/vislib/types.ts @@ -17,22 +17,26 @@ * under the License. */ -export function addToSiri(series, point, id, yLabel, yFormat, zFormat, zLabel) { - id = id == null ? '' : id + ''; +export interface Column { + // -1 value can be in a fake X aspect + id: string | -1; + name: string; +} - if (series.has(id)) { - series.get(id).values.push(point); - return; - } +export interface Row { + [key: string]: number | string | object; +} - series.set(id, { - id: id.split('-').pop(), - rawId: id, - label: yLabel == null ? id : yLabel, - count: 0, - values: [point], - format: yFormat, - zLabel, - zFormat, - }); +export interface TableParent { + table: Table; + tables?: Table[]; + column: number; + row: number; + key: number; + name: string; +} +export interface Table { + columns: Column[]; + rows: Row[]; + $parent?: TableParent; } diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_add_to_siri.js b/src/legacy/ui/public/agg_response/point_series/__tests__/_add_to_siri.js deleted file mode 100644 index 43a10ebbfb12e..0000000000000 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_add_to_siri.js +++ /dev/null @@ -1,82 +0,0 @@ -/* - * 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. - */ - -import expect from '@kbn/expect'; -import { addToSiri } from '../_add_to_siri'; - -describe('addToSiri', function() { - it('creates a new series the first time it sees an id', function() { - const series = new Map(); - const point = {}; - const id = 'id'; - addToSiri(series, point, id, id, { id: id }); - - expect(series.has(id)).to.be(true); - expect(series.get(id)).to.be.an('object'); - expect(series.get(id).label).to.be(id); - expect(series.get(id).values).to.have.length(1); - expect(series.get(id).values[0]).to.be(point); - }); - - it('adds points to existing series if id has been seen', function() { - const series = new Map(); - const id = 'id'; - - const point = {}; - addToSiri(series, point, id, id, { id: id }); - - const point2 = {}; - addToSiri(series, point2, id, id, { id: id }); - - expect(series.has(id)).to.be(true); - expect(series.get(id)).to.be.an('object'); - expect(series.get(id).label).to.be(id); - expect(series.get(id).values).to.have.length(2); - expect(series.get(id).values[0]).to.be(point); - expect(series.get(id).values[1]).to.be(point2); - }); - - it('allows overriding the series label', function() { - const series = new Map(); - const id = 'id'; - const label = 'label'; - const point = {}; - addToSiri(series, point, id, label, { id: id }); - - expect(series.has(id)).to.be(true); - expect(series.get(id)).to.be.an('object'); - expect(series.get(id).label).to.be(label); - expect(series.get(id).values).to.have.length(1); - expect(series.get(id).values[0]).to.be(point); - }); - - it('correctly sets id and rawId', function() { - const series = new Map(); - const id = 'id-id2'; - - const point = {}; - addToSiri(series, point, id); - - expect(series.has(id)).to.be(true); - expect(series.get(id)).to.be.an('object'); - expect(series.get(id).label).to.be(id); - expect(series.get(id).rawId).to.be(id); - expect(series.get(id).id).to.be('id2'); - }); -}); diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_get_point.js b/src/legacy/ui/public/agg_response/point_series/__tests__/_get_point.js deleted file mode 100644 index 0eb2c608d6d6c..0000000000000 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_get_point.js +++ /dev/null @@ -1,97 +0,0 @@ -/* - * 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. - */ - -import expect from '@kbn/expect'; -import { getPoint } from '../_get_point'; - -describe('getPoint', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 1, '1': 2, '2': 3 }, - { '0': 4, '1': 'NaN', '2': 6 }, - ], - }; - - describe('Without series aspect', function() { - let seriesAspect; - let xAspect; - let yAspect; - let yScale; - - beforeEach(function() { - seriesAspect = null; - xAspect = { accessor: 0 }; - yAspect = { accessor: 1, title: 'Y' }; - yScale = 5; - }); - - it('properly unwraps and scales values', function() { - const row = table.rows[0]; - const zAspect = { accessor: 2 }; - const point = getPoint(table, xAspect, seriesAspect, yScale, row, 0, yAspect, zAspect); - - expect(point) - .to.have.property('x', 1) - .and.have.property('y', 10) - .and.have.property('z', 3) - .and.have.property('series', yAspect.title); - }); - - it('ignores points with a y value of NaN', function() { - const row = table.rows[1]; - const point = getPoint(table, xAspect, seriesAspect, yScale, row, 1, yAspect); - expect(point).to.be(void 0); - }); - }); - - describe('With series aspect', function() { - let row; - let xAspect; - let yAspect; - let yScale; - - beforeEach(function() { - row = table.rows[0]; - xAspect = { accessor: 0 }; - yAspect = { accessor: 2 }; - yScale = null; - }); - - it('properly unwraps and scales values', function() { - const seriesAspect = [{ accessor: 1 }]; - const point = getPoint(table, xAspect, seriesAspect, yScale, row, 0, yAspect); - - expect(point) - .to.have.property('x', 1) - .and.have.property('series', '2') - .and.have.property('y', 3); - }); - - it('properly formats series values', function() { - const seriesAspect = [{ accessor: 1, format: { id: 'number', params: { pattern: '$' } } }]; - const point = getPoint(table, xAspect, seriesAspect, yScale, row, 0, yAspect); - - expect(point) - .to.have.property('x', 1) - .and.have.property('series', '$2') - .and.have.property('y', 3); - }); - }); -}); diff --git a/src/legacy/ui/public/agg_response/point_series/__tests__/_get_series.js b/src/legacy/ui/public/agg_response/point_series/__tests__/_get_series.js deleted file mode 100644 index 1727994976383..0000000000000 --- a/src/legacy/ui/public/agg_response/point_series/__tests__/_get_series.js +++ /dev/null @@ -1,283 +0,0 @@ -/* - * 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. - */ - -import _ from 'lodash'; -import expect from '@kbn/expect'; -import { getSeries } from '../_get_series'; - -describe('getSeries', function() { - it('produces a single series with points for each row', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - ], - }; - - const chart = { - aspects: { - x: [{ accessor: 0 }], - y: [{ accessor: 1, title: 'y' }], - z: { accessor: 2 }, - }, - }; - - const series = getSeries(table, chart); - - expect(series) - .to.be.an('array') - .and.to.have.length(1); - - const siri = series[0]; - expect(siri) - .to.be.an('object') - .and.have.property('label', chart.aspects.y.title) - .and.have.property('values'); - - expect(siri.values) - .to.be.an('array') - .and.have.length(5); - - siri.values.forEach(function(point) { - expect(point) - .to.have.property('x', 1) - .and.property('y', 2) - .and.property('z', 3); - }); - }); - - it('adds the seriesId to each point', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - ], - }; - - const chart = { - aspects: { - x: [{ accessor: 0 }], - y: [ - { accessor: 1, title: '0' }, - { accessor: 2, title: '1' }, - ], - }, - }; - - const series = getSeries(table, chart); - - series[0].values.forEach(function(point) { - expect(point).to.have.property('seriesId', 1); - }); - - series[1].values.forEach(function(point) { - expect(point).to.have.property('seriesId', 2); - }); - }); - - it('produces multiple series if there are multiple y aspects', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - ], - }; - - const chart = { - aspects: { - x: [{ accessor: 0 }], - y: [ - { accessor: 1, title: '0' }, - { accessor: 2, title: '1' }, - ], - }, - }; - - const series = getSeries(table, chart); - - expect(series) - .to.be.an('array') - .and.to.have.length(2); - - series.forEach(function(siri, i) { - expect(siri) - .to.be.an('object') - .and.have.property('label', '' + i) - .and.have.property('values'); - - expect(siri.values) - .to.be.an('array') - .and.have.length(5); - - siri.values.forEach(function(point) { - expect(point) - .to.have.property('x', 1) - .and.property('y', i + 2); - }); - }); - }); - - it('produces multiple series if there is a series aspect', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 0, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 0, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 0, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - ], - }; - - const chart = { - aspects: { - x: [{ accessor: -1 }], - series: [{ accessor: 0, fieldFormatter: _.identity }], - y: [{ accessor: 1, title: '0' }], - }, - }; - - const series = getSeries(table, chart); - - expect(series) - .to.be.an('array') - .and.to.have.length(2); - - series.forEach(function(siri, i) { - expect(siri) - .to.be.an('object') - .and.have.property('label', '' + i) - .and.have.property('values'); - - expect(siri.values) - .to.be.an('array') - .and.have.length(3); - - siri.values.forEach(function(point) { - expect(point).to.have.property('y', 2); - }); - }); - }); - - it('produces multiple series if there is a series aspect and multiple y aspects', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 0, '1': 3, '2': 4 }, - { '0': 1, '1': 3, '2': 4 }, - { '0': 0, '1': 3, '2': 4 }, - { '0': 1, '1': 3, '2': 4 }, - { '0': 0, '1': 3, '2': 4 }, - { '0': 1, '1': 3, '2': 4 }, - ], - }; - - const chart = { - aspects: { - x: [{ accessor: -1 }], - series: [{ accessor: 0, fieldFormatter: _.identity }], - y: [ - { accessor: 1, title: '0' }, - { accessor: 2, title: '1' }, - ], - }, - }; - - const series = getSeries(table, chart); - - expect(series) - .to.be.an('array') - .and.to.have.length(4); // two series * two metrics - - checkSiri(series[0], '0: 0', 3); - checkSiri(series[1], '0: 1', 4); - checkSiri(series[2], '1: 0', 3); - checkSiri(series[3], '1: 1', 4); - - function checkSiri(siri, label, y) { - expect(siri) - .to.be.an('object') - .and.have.property('label', label) - .and.have.property('values'); - - expect(siri.values) - .to.be.an('array') - .and.have.length(3); - - siri.values.forEach(function(point) { - expect(point).to.have.property('y', y); - }); - } - }); - - it('produces a series list in the same order as its corresponding metric column', function() { - const table = { - columns: [{ id: '0' }, { id: '1' }, { id: '3' }], - rows: [ - { '0': 0, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 0, '1': 2, '2': 3 }, - { '0': 1, '1': 2, '2': 3 }, - { '0': 0, '1': 2, '2': 3 }, - ], - }; - - const chart = { - aspects: { - x: [{ accessor: -1 }], - series: [{ accessor: 0, fieldFormatter: _.identity }], - y: [ - { accessor: 1, title: '0' }, - { accessor: 2, title: '1' }, - ], - }, - }; - - const series = getSeries(table, chart); - expect(series[0]).to.have.property('label', '0: 0'); - expect(series[1]).to.have.property('label', '0: 1'); - expect(series[2]).to.have.property('label', '1: 0'); - expect(series[3]).to.have.property('label', '1: 1'); - - // switch the order of the y columns - chart.aspects.y = chart.aspects.y.reverse(); - chart.aspects.y.forEach(function(y, i) { - y.i = i; - }); - - const series2 = getSeries(table, chart); - expect(series2[0]).to.have.property('label', '0: 1'); - expect(series2[1]).to.have.property('label', '0: 0'); - expect(series2[2]).to.have.property('label', '1: 1'); - expect(series2[3]).to.have.property('label', '1: 0'); - }); -}); diff --git a/src/legacy/ui/public/agg_response/point_series/_get_series.js b/src/legacy/ui/public/agg_response/point_series/_get_series.js deleted file mode 100644 index 73c1735191abc..0000000000000 --- a/src/legacy/ui/public/agg_response/point_series/_get_series.js +++ /dev/null @@ -1,100 +0,0 @@ -/* - * 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. - */ - -import _ from 'lodash'; -import { getPoint } from './_get_point'; -import { addToSiri } from './_add_to_siri'; - -export function getSeries(table, chart) { - const aspects = chart.aspects; - const xAspect = aspects.x[0]; - const yAspect = aspects.y[0]; - const zAspect = aspects.z && aspects.z.length ? aspects.z[0] : aspects.z; - const multiY = Array.isArray(aspects.y) && aspects.y.length > 1; - const yScale = chart.yScale; - - const partGetPoint = _.partial(getPoint, table, xAspect, aspects.series, yScale); - - let series = _(table.rows) - .transform(function(series, row, rowIndex) { - if (!multiY) { - const point = partGetPoint(row, rowIndex, yAspect, zAspect); - if (point) { - const id = `${point.series}-${yAspect.accessor}`; - point.seriesId = id; - addToSiri( - series, - point, - id, - point.series, - yAspect.format, - zAspect && zAspect.format, - zAspect && zAspect.title - ); - } - return; - } - - aspects.y.forEach(function(y) { - const point = partGetPoint(row, rowIndex, y, zAspect); - if (!point) return; - - // use the point's y-axis as it's series by default, - // but augment that with series aspect if it's actually - // available - let seriesId = y.accessor; - let seriesLabel = y.title; - - if (aspects.series) { - const prefix = point.series ? point.series + ': ' : ''; - seriesId = prefix + seriesId; - seriesLabel = prefix + seriesLabel; - } - - point.seriesId = seriesId; - addToSiri( - series, - point, - seriesId, - seriesLabel, - y.format, - zAspect && zAspect.format, - zAspect && zAspect.title - ); - }); - }, new Map()) - .thru(series => [...series.values()]) - .value(); - - if (multiY) { - series = _.sortBy(series, function(siri) { - const firstVal = siri.values[0]; - let y; - - if (firstVal) { - y = _.find(aspects.y, function(y) { - return y.accessor === firstVal.accessor; - }); - } - - return y ? y.i : series.length; - }); - } - return series; -} diff --git a/src/legacy/ui/public/agg_response/point_series/point_series.js b/src/legacy/ui/public/agg_response/point_series/point_series.js deleted file mode 100644 index 8489f7bc2ca45..0000000000000 --- a/src/legacy/ui/public/agg_response/point_series/point_series.js +++ /dev/null @@ -1,42 +0,0 @@ -/* - * 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. - */ - -import { getSeries } from './_get_series'; -import { getAspects } from './_get_aspects'; -import { initYAxis } from './_init_y_axis'; -import { initXAxis } from './_init_x_axis'; -import { orderedDateAxis } from './_ordered_date_axis'; - -export const buildPointSeriesData = (table, dimensions) => { - const chart = { - aspects: getAspects(table, dimensions), - }; - - initXAxis(chart, table); - initYAxis(chart); - - if (chart.aspects.x[0].params.date) { - orderedDateAxis(chart); - } - - chart.series = getSeries(table, chart); - - delete chart.aspects; - return chart; -}; diff --git a/x-pack/legacy/plugins/dashboard_mode/public/dashboard_viewer.js b/x-pack/legacy/plugins/dashboard_mode/public/dashboard_viewer.js index 905c88a6d18a0..532c49803e7b0 100644 --- a/x-pack/legacy/plugins/dashboard_mode/public/dashboard_viewer.js +++ b/x-pack/legacy/plugins/dashboard_mode/public/dashboard_viewer.js @@ -27,7 +27,6 @@ import 'uiExports/search'; import 'uiExports/shareContextMenuExtensions'; import _ from 'lodash'; import 'ui/autoload/all'; -import 'ui/agg_response'; import 'leaflet'; import { npStart } from 'ui/new_platform'; import { localApplicationService } from 'plugins/kibana/local_application_service'; diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index d357e40c02934..705a4577cbd07 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -130,7 +130,6 @@ "charts.colormaps.greysText": "グレー", "charts.colormaps.redsText": "赤", "charts.colormaps.yellowToRedText": "黄色から赤", - "common.ui.aggResponse.allDocsTitle": "すべてのドキュメント", "common.ui.errorAutoCreateIndex.breadcrumbs.errorText": "エラー", "common.ui.errorAutoCreateIndex.errorDescription": "Elasticsearch クラスターの {autoCreateIndexActionConfig} 設定が原因で、Kibana が保存されたオブジェクトを格納するインデックスを自動的に作成できないようです。Kibana は、保存されたオブジェクトインデックスが適切なマッピング/スキーマを使用し Kibana から Elasticsearch へのポーリングの回数を減らすための最適な手段であるため、この Elasticsearch の機能を使用します。", "common.ui.errorAutoCreateIndex.errorDisclaimer": "申し訳ございませんが、この問題が解決されるまで Kibana で何も保存することができません。", @@ -3809,6 +3808,7 @@ "visTypeVega.visualization.renderErrorTitle": "Vega エラー", "visTypeVega.visualization.unableToFindDefaultIndexErrorMessage": "デフォルトのインデックスが見つかりません", "visTypeVega.visualization.unableToRenderWithoutDataWarningMessage": "データなしにはレンダリングできません", + "visTypeVislib.aggResponse.allDocsTitle": "すべてのドキュメント", "visTypeVislib.area.areaDescription": "折れ線グラフの下の数量を強調します。", "visTypeVislib.area.areaTitle": "エリア", "visTypeVislib.area.countText": "カウント", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index 839c89f3b1cae..50b807a4934ed 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -130,7 +130,6 @@ "charts.colormaps.greysText": "灰色", "charts.colormaps.redsText": "红色", "charts.colormaps.yellowToRedText": "黄到红", - "common.ui.aggResponse.allDocsTitle": "所有文档", "common.ui.errorAutoCreateIndex.breadcrumbs.errorText": "错误", "common.ui.errorAutoCreateIndex.errorDescription": "似乎 Elasticsearch 集群的 {autoCreateIndexActionConfig} 设置使 Kibana 无法自动创建用于存储已保存对象的索引。Kibana 将使用此 Elasticsearch 功能，因为这是确保已保存对象索引使用正确映射/架构的最好方式，而且其允许 Kibana 较少地轮询 Elasticsearch。", "common.ui.errorAutoCreateIndex.errorDisclaimer": "但是，只有解决了此问题后，您才能在 Kibana 保存内容。", @@ -3810,6 +3809,7 @@ "visTypeVega.visualization.renderErrorTitle": "Vega 错误", "visTypeVega.visualization.unableToFindDefaultIndexErrorMessage": "找不到默认索引", "visTypeVega.visualization.unableToRenderWithoutDataWarningMessage": "没有数据时无法渲染", + "visTypeVislib.aggResponse.allDocsTitle": "所有文档", "visTypeVislib.area.areaDescription": "突出折线图下方的数量", "visTypeVislib.area.areaTitle": "面积图", "visTypeVislib.area.countText": "计数", From b73fe279d6609162530619b4582f7f1da35a88c6 Mon Sep 17 00:00:00 2001 From: Jen Huang Date: Thu, 9 Apr 2020 09:44:33 -0700 Subject: [PATCH 008/102] [EPM] Update UI copy to use `integration` (#63077) * Update epm copy to say Integrations * Update copy in create data source flow * Update copy in data sources table * Fix missed copies * Remove unused translation keys (they were renamed & strings were changed) --- .../ingest_manager/layouts/default.tsx | 4 ++-- .../components/layout.tsx | 2 +- .../components/navigation.tsx | 2 +- .../create_datasource_page/index.tsx | 2 +- .../step_select_package.tsx | 8 ++++---- .../datasources/datasources_table.tsx | 2 +- .../epm/components/package_list_grid.tsx | 2 +- .../sections/epm/screens/detail/header.tsx | 8 +++++++- .../sections/epm/screens/home/header.tsx | 4 ++-- .../sections/epm/screens/home/index.tsx | 18 +++++++++--------- .../translations/translations/ja-JP.json | 5 ----- .../translations/translations/zh-CN.json | 5 ----- 12 files changed, 29 insertions(+), 33 deletions(-) diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/layouts/default.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/layouts/default.tsx index 8ec2d2ec03b35..26f2c85a291a3 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/layouts/default.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/layouts/default.tsx @@ -55,8 +55,8 @@ export const DefaultLayout: React.FunctionComponent = ({ section, childre disabled={!epm?.enabled} > diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx index 8bb7b2553c1b1..dd242f366e8c0 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx @@ -88,7 +88,7 @@ export const CreateDatasourcePageLayout: React.FunctionComponent<{ diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx index 099a7a83caa10..7dae981e65c30 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx @@ -27,7 +27,7 @@ export const CreateDatasourceStepsNavigation: React.FunctionComponent<{ from === 'config' ? { title: i18n.translate('xpack.ingestManager.createDatasource.stepSelectPackageLabel', { - defaultMessage: 'Select package', + defaultMessage: 'Select integration', }), isSelected: currentStep === 'selectPackage', isComplete: diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx index 7815ab9cd1d6e..461bb750ca6f5 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx @@ -221,7 +221,7 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { {from === 'config' ? ( ) : ( } error={packagesError} @@ -114,7 +114,7 @@ export const StepSelectPackage: React.FunctionComponent<{

@@ -149,7 +149,7 @@ export const StepSelectPackage: React.FunctionComponent<{ placeholder: i18n.translate( 'xpack.ingestManager.createDatasource.stepSelectPackage.filterPackagesInputPlaceholder', { - defaultMessage: 'Search for packages', + defaultMessage: 'Search for integrations', } ), }} @@ -179,7 +179,7 @@ export const StepSelectPackage: React.FunctionComponent<{ title={ } error={selectedPkgError} diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/details_page/components/datasources/datasources_table.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/details_page/components/datasources/datasources_table.tsx index 87155afdc21be..1eee9f6b0c346 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/details_page/components/datasources/datasources_table.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/details_page/components/datasources/datasources_table.tsx @@ -138,7 +138,7 @@ export const DatasourcesTable: React.FunctionComponent = ({ name: i18n.translate( 'xpack.ingestManager.configDetails.datasourcesTable.packageNameColumnTitle', { - defaultMessage: 'Package', + defaultMessage: 'Integration', } ), render(packageTitle: string, datasource: InMemoryDatasource) { diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/components/package_list_grid.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/components/package_list_grid.tsx index 2ca49298decf9..818b365d5be12 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/components/package_list_grid.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/components/package_list_grid.tsx @@ -62,7 +62,7 @@ export function PackageListGrid({ query={searchTerm} box={{ placeholder: i18n.translate('xpack.ingestManager.epmList.searchPackagesPlaceholder', { - defaultMessage: 'Search for a package', + defaultMessage: 'Search for integrations', }), incremental: true, }} diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/header.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/header.tsx index a7204dd722603..d83910f29f1a7 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/header.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/header.tsx @@ -5,6 +5,7 @@ */ import React, { Fragment } from 'react'; import styled from 'styled-components'; +import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; import { EuiFlexGroup, EuiFlexItem, EuiPage, EuiTitle, IconType, EuiButton } from '@elastic/eui'; import { PackageInfo } from '../../../../types'; @@ -41,7 +42,12 @@ export function Header(props: HeaderProps) { return ( - + {iconType ? ( diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/header.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/header.tsx index 4230775c04e00..4d6c02eeef8b4 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/header.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/header.tsx @@ -17,7 +17,7 @@ export const HeroCopy = memo(() => {

@@ -27,7 +27,7 @@ export const HeroCopy = memo(() => {

diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/index.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/index.tsx index 5f215b7788259..bf785147502b5 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/index.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/home/index.tsx @@ -35,16 +35,16 @@ export function EPMHomePage() { ([ { id: 'all_packages', - name: i18n.translate('xpack.ingestManager.epmList.allPackagesTabText', { - defaultMessage: 'All packages', + name: i18n.translate('xpack.ingestManager.epmList.allTabText', { + defaultMessage: 'All integrations', }), href: ALL_PACKAGES_URI, isSelected: tabId !== 'installed', }, { id: 'installed_packages', - name: i18n.translate('xpack.ingestManager.epmList.installedPackagesTabText', { - defaultMessage: 'Installed packages', + name: i18n.translate('xpack.ingestManager.epmList.installedTabText', { + defaultMessage: 'Installed integrations', }), href: INSTALLED_PACKAGES_URI, isSelected: tabId === 'installed', @@ -72,14 +72,14 @@ function InstalledPackages() { ? allPackages.response.filter(pkg => pkg.status === 'installed') : []; - const title = i18n.translate('xpack.ingestManager.epmList.installedPackagesTitle', { - defaultMessage: 'Installed packages', + const title = i18n.translate('xpack.ingestManager.epmList.installedTitle', { + defaultMessage: 'Installed integrations', }); const categories = [ { id: '', - title: i18n.translate('xpack.ingestManager.epmList.allPackagesFilterLinkText', { + title: i18n.translate('xpack.ingestManager.epmList.allFilterLinkText', { defaultMessage: 'All', }), count: packages.length, @@ -120,8 +120,8 @@ function AvailablePackages() { const packages = categoryPackagesRes && categoryPackagesRes.response ? categoryPackagesRes.response : []; - const title = i18n.translate('xpack.ingestManager.epmList.allPackagesTitle', { - defaultMessage: 'All packages', + const title = i18n.translate('xpack.ingestManager.epmList.allTitle', { + defaultMessage: 'All integrations', }); const categories = [ diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index 705a4577cbd07..687834a683c4d 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -8389,7 +8389,6 @@ "xpack.ingestManager.appNavigation.configurationsLinkText": "構成", "xpack.ingestManager.appNavigation.fleetLinkText": "フリート", "xpack.ingestManager.appNavigation.overviewLinkText": "概要", - "xpack.ingestManager.appNavigation.packagesLinkText": "パッケージ", "xpack.ingestManager.appTitle": "Ingest Manager", "xpack.ingestManager.configDetails.addDatasourceButtonText": "データソースを作成", "xpack.ingestManager.configDetails.configDetailsTitle": "構成「{id}」", @@ -8515,10 +8514,6 @@ "xpack.ingestManager.epm.pageSubtitle": "人気のアプリやサービスのパッケージを参照する", "xpack.ingestManager.epm.pageTitle": "Elastic Package Manager", "xpack.ingestManager.epmList.allPackagesFilterLinkText": "すべて", - "xpack.ingestManager.epmList.allPackagesTabText": "すべてのパッケージ", - "xpack.ingestManager.epmList.allPackagesTitle": "すべてのパッケージ", - "xpack.ingestManager.epmList.installedPackagesTabText": "パッケージをインストールしました", - "xpack.ingestManager.epmList.installedPackagesTitle": "パッケージをインストールしました", "xpack.ingestManager.epmList.noPackagesFoundPlaceholder": "パッケージが見つかりません", "xpack.ingestManager.epmList.searchPackagesPlaceholder": "パッケージを検索", "xpack.ingestManager.epmList.updatesAvailableFilterLinkText": "更新が可能です", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index 50b807a4934ed..58905787da8d5 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -8392,7 +8392,6 @@ "xpack.ingestManager.appNavigation.configurationsLinkText": "配置", "xpack.ingestManager.appNavigation.fleetLinkText": "Fleet", "xpack.ingestManager.appNavigation.overviewLinkText": "概览", - "xpack.ingestManager.appNavigation.packagesLinkText": "软件包", "xpack.ingestManager.appTitle": "Ingest Manager", "xpack.ingestManager.configDetails.addDatasourceButtonText": "创建数据源", "xpack.ingestManager.configDetails.configDetailsTitle": "配置“{id}”", @@ -8518,10 +8517,6 @@ "xpack.ingestManager.epm.pageSubtitle": "浏览热门应用和服务的软件。", "xpack.ingestManager.epm.pageTitle": "Elastic Package Manager", "xpack.ingestManager.epmList.allPackagesFilterLinkText": "全部", - "xpack.ingestManager.epmList.allPackagesTabText": "所有软件包", - "xpack.ingestManager.epmList.allPackagesTitle": "所有软件包", - "xpack.ingestManager.epmList.installedPackagesTabText": "已安装软件包", - "xpack.ingestManager.epmList.installedPackagesTitle": "已安装软件包", "xpack.ingestManager.epmList.noPackagesFoundPlaceholder": "未找到任何软件包", "xpack.ingestManager.epmList.searchPackagesPlaceholder": "搜索软件包", "xpack.ingestManager.epmList.updatesAvailableFilterLinkText": "有可用更新", From 59c044ff00d88d63c7bf30685a6f1371c7164f8c Mon Sep 17 00:00:00 2001 From: Kaarina Tungseth Date: Thu, 9 Apr 2020 12:42:30 -0500 Subject: [PATCH 009/102] [DOCS] Removed references to right (#62508) --- docs/apm/spans.asciidoc | 2 +- docs/apm/transactions.asciidoc | 1 + docs/canvas/canvas-share-workpad.asciidoc | 4 ++-- docs/canvas/canvas-tutorial.asciidoc | 6 +++--- docs/canvas/canvas-workpad.asciidoc | 2 +- .../alerting/alert-management.asciidoc | 14 ++++++------- .../alerting/connector-management.asciidoc | 8 ++++---- docs/management/index-patterns.asciidoc | 1 - docs/management/managing-fields.asciidoc | 2 +- .../create_and_manage_rollups.asciidoc | 4 ++-- docs/maps/geojson-upload.asciidoc | 3 +-- .../indexing-geojson-data-tutorial.asciidoc | 4 ++-- docs/maps/maps-getting-started.asciidoc | 5 ++--- docs/maps/search.asciidoc | 2 +- docs/user/alerting/defining-alerts.asciidoc | 20 +++++++++---------- docs/user/dashboard.asciidoc | 2 +- docs/user/discover.asciidoc | 2 +- docs/user/graph/getting-started.asciidoc | 4 ++-- docs/user/monitoring/beats-details.asciidoc | 4 ++-- docs/visualize/lens.asciidoc | 12 +++++------ 20 files changed, 50 insertions(+), 52 deletions(-) diff --git a/docs/apm/spans.asciidoc b/docs/apm/spans.asciidoc index b09de576f2d4a..ef21e1c5333e0 100644 --- a/docs/apm/spans.asciidoc +++ b/docs/apm/spans.asciidoc @@ -34,4 +34,4 @@ which indicates the next transaction in the trace. These transactions can be expanded and viewed in detail by clicking on them. After exploring these traces, -you can return to the full trace by clicking *View full trace* in the upper right hand corner of the page. +you can return to the full trace by clicking *View full trace*. diff --git a/docs/apm/transactions.asciidoc b/docs/apm/transactions.asciidoc index 5c92afa55109d..1eb037009efff 100644 --- a/docs/apm/transactions.asciidoc +++ b/docs/apm/transactions.asciidoc @@ -105,6 +105,7 @@ image::apm/images/apm-transaction-duration-dist.png[Example view of transactions This graph shows a typical distribution, and indicates most of our requests were served quickly - awesome! It's the requests on the right, the ones taking longer than average, that we probably want to focus on. + When you select one of these buckets, you're presented with up to ten trace samples. Each sample has a span timeline waterfall that shows what a typical request in that bucket was doing. diff --git a/docs/canvas/canvas-share-workpad.asciidoc b/docs/canvas/canvas-share-workpad.asciidoc index ee29926914ad6..5cae3fcc7b531 100644 --- a/docs/canvas/canvas-share-workpad.asciidoc +++ b/docs/canvas/canvas-share-workpad.asciidoc @@ -76,7 +76,7 @@ After you've added the workpad to your website, you can change the autoplay and To change the autoplay settings: -. In the lower right corner of the shareable workpad, click the settings icon. +. Click the settings icon. . Click *Auto Play*, then change the settings. + @@ -85,7 +85,7 @@ image::images/canvas_share_autoplay_480.gif[Autoplay settings] To change the toolbar settings: -. In the lower right corner, click the settings icon. +. Click the settings icon. . Click *Toolbar*, then change the settings. + diff --git a/docs/canvas/canvas-tutorial.asciidoc b/docs/canvas/canvas-tutorial.asciidoc index b6d684bdf5dde..a38ab4a69598e 100644 --- a/docs/canvas/canvas-tutorial.asciidoc +++ b/docs/canvas/canvas-tutorial.asciidoc @@ -18,7 +18,7 @@ Your first step to working with Canvas is to create a workpad. . Click *Create workpad*. -. To add a *Name* for your workpad, use the editor on the right. For example, `My Canvas Workpad`. +. To add a *Name* for your workpad, use the editor. For example, `My Canvas Workpad`. [float] === Customize your workpad with images @@ -29,7 +29,7 @@ To customize your workpad to look the way you want, add your own images. + The default Elastic logo image appears on your page. -. To replace the Elastic logo with your own image, select the image, then use the editor on the right. +. To replace the Elastic logo with your own image, select the image, then use the editor. . To move the image, click and drag it to your preferred location. @@ -73,7 +73,7 @@ You'll notice that the error is gone, but the number could use some formatting. . To format the number, use the Canvas expression language. -.. In the lower right corner, click *Expression editor*. +.. Click *Expression editor*. + You're now looking at the raw data syntax that Canvas uses to display the element. diff --git a/docs/canvas/canvas-workpad.asciidoc b/docs/canvas/canvas-workpad.asciidoc index c5c163441439c..42eedf55c404d 100644 --- a/docs/canvas/canvas-workpad.asciidoc +++ b/docs/canvas/canvas-workpad.asciidoc @@ -124,7 +124,7 @@ Organize your ideas onto separate pages by adding more pages. . Click *Page 1*, then click *+*. -. On the *Page* editor panel on the right, select the page transition from the *Transition* dropdown. +. On the *Page* editor panel, select the page transition from the *Transition* dropdown. + [role="screenshot"] image::images/canvas-add-pages.gif[Add pages] diff --git a/docs/management/alerting/alert-management.asciidoc b/docs/management/alerting/alert-management.asciidoc index caf260937b7be..73cf40c4d7c40 100644 --- a/docs/management/alerting/alert-management.asciidoc +++ b/docs/management/alerting/alert-management.asciidoc @@ -18,9 +18,9 @@ For more information on alerting concepts and the types of alerts and actions av [float] ==== Finding alerts -The *Alerts* tab lists all alerts in the current space, including summary information about their execution frequency, tags, and type. +The *Alerts* tab lists all alerts in the current space, including summary information about their execution frequency, tags, and type. -The *search bar* can be used to quickly find alerts by name or tag. +The *search bar* can be used to quickly find alerts by name or tag. [role="screenshot"] image::images/alerts-filter-by-search.png[Filtering the alerts list using the search bar] @@ -30,7 +30,7 @@ The *type* dropdown lets you filter to a subset of alert types. [role="screenshot"] image::images/alerts-filter-by-type.png[Filtering the alerts list by types of alert] -The *Action type* dropdown lets you filter by the type of action used in the alert. +The *Action type* dropdown lets you filter by the type of action used in the alert. [role="screenshot"] image::images/alerts-filter-by-action-type.png[Filtering the alert list by type of action] @@ -39,16 +39,16 @@ image::images/alerts-filter-by-action-type.png[Filtering the alert list by type [[create-edit-alerts]] ==== Creating and editing alerts -Many alerts must be created within the context of a {kib} app like <>, <>, or <>, but others are generic. Generic alert types can be created in the *Alerts* management UI by clicking the *Create* button. This will launch a flyout that guides you through selecting an alert type and configuring it's properties. Refer to <> for details on what types of alerts are available and how to configure them. +Many alerts must be created within the context of a {kib} app like <>, <>, or <>, but others are generic. Generic alert types can be created in the *Alerts* management UI by clicking the *Create* button. This will launch a flyout that guides you through selecting an alert type and configuring it's properties. Refer to <> for details on what types of alerts are available and how to configure them. -After an alert is created, you can re-open the flyout and change an alerts properties by clicking the *Edit* button shown on each row of the alert listing. +After an alert is created, you can re-open the flyout and change an alerts properties by clicking the *Edit* button shown on each row of the alert listing. [float] [[controlling-alerts]] ==== Controlling alerts -The alert listing allows you to quickly mute/unmute, disable/enable, and delete individual alerts by clicking the action button at the right of each row. +The alert listing allows you to quickly mute/unmute, disable/enable, and delete individual alerts by clicking the action button. [role="screenshot"] image:management/alerting/images/individual-mute-disable.png[The actions button allows an individual alert to be muted, disabled, or deleted] @@ -56,4 +56,4 @@ image:management/alerting/images/individual-mute-disable.png[The actions button These operations can also be performed in bulk by multi-selecting alerts and clicking the *Manage alerts* button: [role="screenshot"] -image:management/alerting/images/bulk-mute-disable.png[The Manage alerts button lets you mute/unmute, enable/disable, and delete in bulk] \ No newline at end of file +image:management/alerting/images/bulk-mute-disable.png[The Manage alerts button lets you mute/unmute, enable/disable, and delete in bulk] diff --git a/docs/management/alerting/connector-management.asciidoc b/docs/management/alerting/connector-management.asciidoc index 1002a372f9460..46e106e6e9648 100644 --- a/docs/management/alerting/connector-management.asciidoc +++ b/docs/management/alerting/connector-management.asciidoc @@ -15,7 +15,7 @@ image::images/connector-listing.png[Example connector listing in the Alerts and [float] ==== Connector list -The *Connectors* tab lists all connectors in the current space. The *search bar* can be used to find specific connectors by name and/or type. +The *Connectors* tab lists all connectors in the current space. The *search bar* can be used to find specific connectors by name and/or type. [role="screenshot"] image::images/connector-filter-by-search.png[Filtering the connector list using the search bar] @@ -26,12 +26,12 @@ The *type* dropdown also lets you filter to a subset of action types. [role="screenshot"] image::images/connector-filter-by-type.png[Filtering the connector list by types of actions] -The *Actions* column indicates the number of actions that reference the connector. This count helps you confirm a connector is unused before you delete it, and tells you how many actions will be affected when a connector is modified. +The *Actions* column indicates the number of actions that reference the connector. This count helps you confirm a connector is unused before you delete it, and tells you how many actions will be affected when a connector is modified. [role="screenshot"] image::images/connector-action-count.png[Filtering the connector list by types of actions] -You can delete individual connectors using the trash icon on the right of each row. Connectors can also be deleted in bulk by multi-selecting them and clicking the *Delete* button to the left of the search box. +You can delete individual connectors using the trash icon. Connectors can also be deleted in bulk by multi-selecting them and clicking the *Delete* button to the left of the search box. [role="screenshot"] image::images/connector-delete.png[Deleting connectors individually or in bulk] @@ -44,4 +44,4 @@ When this happens the action will fail to execute, and appear as errors in the { ==== Creating a new connector -New connectors can be created by clicking the *Create connector* button, which will guide you to select the type of connector and configure it's properties. Refer to <> for the types of connectors available and how to configure them. Once you create a connector it will be made available to you anytime you set up an action in the current space. \ No newline at end of file +New connectors can be created by clicking the *Create connector* button, which will guide you to select the type of connector and configure it's properties. Refer to <> for the types of connectors available and how to configure them. Once you create a connector it will be made available to you anytime you set up an action in the current space. diff --git a/docs/management/index-patterns.asciidoc b/docs/management/index-patterns.asciidoc index 45f8bd13a5c54..bb16faab7fe5a 100644 --- a/docs/management/index-patterns.asciidoc +++ b/docs/management/index-patterns.asciidoc @@ -38,7 +38,6 @@ image:management/index-patterns/images/rollup-index-pattern.png["Menu with rollu Just start typing in the *Index pattern* field, and {kib} looks for the names of {es} indices that match your input. Make sure that the name of the index pattern is unique. -To include system indices in your search, toggle the switch in the upper right. [role="screenshot"] image:management/index-patterns/images/create-index-pattern.png["Create index pattern"] diff --git a/docs/management/managing-fields.asciidoc b/docs/management/managing-fields.asciidoc index 1a1bcec10ab50..9682d918aabe4 100644 --- a/docs/management/managing-fields.asciidoc +++ b/docs/management/managing-fields.asciidoc @@ -25,7 +25,7 @@ the *Index patterns* overview. [role="screenshot"] image::management/index-patterns/images/new-index-pattern.png["Index files and data types"] -Use the icons in the upper right to perform the following actions: +Use the icons to perform the following actions: * [[set-default-pattern]]*Set the default index pattern.* {kib} uses a badge to make users aware of which index pattern is the default. The first pattern diff --git a/docs/management/rollups/create_and_manage_rollups.asciidoc b/docs/management/rollups/create_and_manage_rollups.asciidoc index 6a56970687fd6..da2e190847fdb 100644 --- a/docs/management/rollups/create_and_manage_rollups.asciidoc +++ b/docs/management/rollups/create_and_manage_rollups.asciidoc @@ -42,8 +42,8 @@ image::images/management_create_rollup_job.png[][Wizard that walks you through c === Start, stop, and delete rollup jobs Once you’ve saved a rollup job, you’ll see it the *Rollup Jobs* overview page, -where you can drill down for further investigation. The *Manage* menu in -the lower right enables you to start, stop, and delete the rollup job. +where you can drill down for further investigation. The *Manage* menu enables +you to start, stop, and delete the rollup job. You must first stop a rollup job before deleting it. [role="screenshot"] diff --git a/docs/maps/geojson-upload.asciidoc b/docs/maps/geojson-upload.asciidoc index ad20264f56138..7e2cdddfd30ef 100644 --- a/docs/maps/geojson-upload.asciidoc +++ b/docs/maps/geojson-upload.asciidoc @@ -37,7 +37,6 @@ the Elasticsearch responses are shown on the *Layer add panel* and the indexed d appears on the map. The geospatial data on the map should be identical to the locally-previewed data, but now it's indexed data from Elasticsearch. -. To continue adding data to the map, click *Add layer* in the lower -right-hand corner. +. To continue adding data to the map, click *Add layer*. . In *Layer settings*, adjust any settings or <> as needed. . Click *Save & close*. diff --git a/docs/maps/indexing-geojson-data-tutorial.asciidoc b/docs/maps/indexing-geojson-data-tutorial.asciidoc index a94e5757d5dfa..bf846a2b80e03 100644 --- a/docs/maps/indexing-geojson-data-tutorial.asciidoc +++ b/docs/maps/indexing-geojson-data-tutorial.asciidoc @@ -55,14 +55,14 @@ auto-populate *Index type* with either {ref}/geo-point.html[geo_point] or {ref}/geo-shape.html[geo_shape] and *Index name* with ``. -. Click *Import file* in the lower right. +. Click *Import file*. + You'll see activity as the GeoJSON Upload utility creates a new index and index pattern for the data set. When the process is complete, you should receive messages that the creation of the new index and index pattern were successful. -. Click *Add layer* in the bottom right. +. Click *Add layer*. . In *Layer settings*, adjust settings and <> as needed. . Click *Save & close*. diff --git a/docs/maps/maps-getting-started.asciidoc b/docs/maps/maps-getting-started.asciidoc index b13eeebe56fd8..6495b8a057cf6 100644 --- a/docs/maps/maps-getting-started.asciidoc +++ b/docs/maps/maps-getting-started.asciidoc @@ -80,7 +80,7 @@ To symbolize countries by web traffic, you'll need to augment the world country To do this, you'll create a <> to link the vector source *World Countries* to the {es} index `kibana_sample_data_logs` on the shared key iso2 = geo.src. -. Click plus image:maps/images/gs_plus_icon.png[] to the right of *Term Joins* label. +. Click plus image:maps/images/gs_plus_icon.png[] next to the *Term Joins* label. . Click *Join --select--* . Set *Left field* to *ISO 3166-1 alpha-2 code*. . Set *Right source* to *kibana_sample_data_logs*. @@ -238,7 +238,7 @@ The *machine.os.keyword: osx* filter appears in the dashboard query bar. + . Click the *x* to remove the *machine.os.keyword: osx* filter. . In the map, click in the United States vector. -. Click plus image:maps/images/gs_plus_icon.png[] to the right of *iso2* row in the tooltip. +. Click plus image:maps/images/gs_plus_icon.png[] next to the *iso2* row in the tooltip. + Both the visualizations and the map are filtered to only show documents where *geo.src* is *US*. The *geo.src: US* filter appears in the dashboard query bar. @@ -247,4 +247,3 @@ Your dashboard should look like this: + [role="screenshot"] image::maps/images/gs_dashboard_with_terms_filter.png[] - diff --git a/docs/maps/search.asciidoc b/docs/maps/search.asciidoc index 8a93352798d2c..a461ab6fbb3a6 100644 --- a/docs/maps/search.asciidoc +++ b/docs/maps/search.asciidoc @@ -4,7 +4,7 @@ **Elastic Maps** embeds the search bar for real-time search. Only layers requesting data from {es} are filtered when you submit a search request. -Layers narrowed by the search context contain the filter icon image:maps/images/filter_icon.png[] to the right of layer name in the legend. +Layers narrowed by the search context contain the filter icon image:maps/images/filter_icon.png[] next to the layer name in the legend. You can create a layer that requests data from {es} from the following: diff --git a/docs/user/alerting/defining-alerts.asciidoc b/docs/user/alerting/defining-alerts.asciidoc index 89c4c88708d58..f05afac34e595 100644 --- a/docs/user/alerting/defining-alerts.asciidoc +++ b/docs/user/alerting/defining-alerts.asciidoc @@ -2,7 +2,7 @@ [[defining-alerts]] == Defining alerts -{kib} alerts can be created in a variety of apps including <>, <>, <>, <> and from <> UI. While alerting details may differ from app to app, they share a common interface for defining and configuring alerts that this section describes in more detail. +{kib} alerts can be created in a variety of apps including <>, <>, <>, <> and from <> UI. While alerting details may differ from app to app, they share a common interface for defining and configuring alerts that this section describes in more detail. [float] === Alert flyout @@ -25,20 +25,20 @@ All alert share the following four properties in common: image::images/alert-flyout-general-details.png[All alerts have name, tags, check every, and re-notify every properties in common] Name:: The name of the alert. While this name does not have to be unique, the name can be referenced in actions and also appears in the searchable alert listing in the management UI. A distinctive name can help identify and find an alert. -Tags:: A list of tag names that can be applied to an alert. Tags can help you organize and find alerts, because tags appear in the alert listing in the management UI which is searchable by tag. +Tags:: A list of tag names that can be applied to an alert. Tags can help you organize and find alerts, because tags appear in the alert listing in the management UI which is searchable by tag. Check every:: This value determines how frequently the alert conditions below are checked. Note that the timing of background alert checks are not guaranteed, particularly for intervals of less than 10 seconds. See <> for more information. -Re-notify every:: This value limits how often actions are repeated when an alert instance remains active across alert checks. See <> for more information. +Re-notify every:: This value limits how often actions are repeated when an alert instance remains active across alert checks. See <> for more information. [float] [[defining-alerts-type-conditions]] === Alert type and conditions -Depending upon the {kib} app and context, you may be prompted to choose the type of alert you wish to create. Some apps will pre-select the type of alert for you. +Depending upon the {kib} app and context, you may be prompted to choose the type of alert you wish to create. Some apps will pre-select the type of alert for you. [role="screenshot"] image::images/alert-flyout-alert-type-selection.png[Choosing the type of alert to create] -Each alert type provides its own way of defining the conditions to detect, but an expression formed by a series of clauses is a common pattern. Each clause has a UI control that allows you to define the clause. For example, in an index threshold alert the `WHEN` clause allows you to select an aggregation operation to apply to a numeric field. +Each alert type provides its own way of defining the conditions to detect, but an expression formed by a series of clauses is a common pattern. Each clause has a UI control that allows you to define the clause. For example, in an index threshold alert the `WHEN` clause allows you to select an aggregation operation to apply to a numeric field. [role="screenshot"] image::images/alert-flyout-alert-conditions.png[UI for defining alert conditions on an index threshold alert] @@ -52,19 +52,19 @@ To add an action to an alert, you first select the type of action: [role="screenshot"] image::images/alert-flyout-action-type-selection.png[UI for selecting an action type] -Each action must specify a <> instance. If no connectors exist for that action type, click "Add new" to create one. +Each action must specify a <> instance. If no connectors exist for that action type, click "Add new" to create one. -Each action type exposes different properties. For example an email action allows you to set the recipients, the subject, and a message body in markdown format. See <> for details on the types of actions provided by {kib} and their properties. +Each action type exposes different properties. For example an email action allows you to set the recipients, the subject, and a message body in markdown format. See <> for details on the types of actions provided by {kib} and their properties. [role="screenshot"] image::images/alert-flyout-action-details.png[UI for defining an email action] -Using the https://mustache.github.io/[Mustache] template syntax `{{variable name}}`, you can pass alert values at the time a condition is detected to an action. Available variables differ by alert type, and a list can be accessed using the "add variable" button at the right of the text box. +Using the https://mustache.github.io/[Mustache] template syntax `{{variable name}}`, you can pass alert values at the time a condition is detected to an action. Available variables differ by alert type, and a list can be accessed using the "add variable" button. [role="screenshot"] image::images/alert-flyout-action-variables.png[Passing alert values to an action] -You can attach more than one action. Clicking the "Add action" button will prompt you to select another alert type and repeat the above steps again. +You can attach more than one action. Clicking the "Add action" button will prompt you to select another alert type and repeat the above steps again. [role="screenshot"] image::images/alert-flyout-add-action.png[You can add multiple actions on an alert] @@ -77,4 +77,4 @@ Actions are not required on alerts. In some cases you may want to run an alert w [float] === Managing alerts -To modify an alert after it was created, including muting or disabling it, use the <>. \ No newline at end of file +To modify an alert after it was created, including muting or disabling it, use the <>. diff --git a/docs/user/dashboard.asciidoc b/docs/user/dashboard.asciidoc index a17e46c5b3542..ab529a533d5e3 100644 --- a/docs/user/dashboard.asciidoc +++ b/docs/user/dashboard.asciidoc @@ -90,7 +90,7 @@ In *Edit* mode, you can move, resize, customize, and delete panels to suit your * To move a panel, click and hold the panel header and drag to the new location. [[resizing-containers]] -* To resize a panel, click the resize control on the lower right and drag +* To resize a panel, click the resize control and drag to the new dimensions. * To toggle the use of margins and panel titles, use the *Options* menu. diff --git a/docs/user/discover.asciidoc b/docs/user/discover.asciidoc index 4222ba40debb7..2547b38a22616 100644 --- a/docs/user/discover.asciidoc +++ b/docs/user/discover.asciidoc @@ -33,7 +33,7 @@ which has a pre-built index pattern. By default, *Discover* shows data for the last 15 minutes. If you have a time-based index, and no data displays, -you might need to increase the time range. Using the <> in the upper right, +you might need to increase the time range. Using the <>, you can specify a common or recently-used time range, a relative time from now, or an absolute time range. diff --git a/docs/user/graph/getting-started.asciidoc b/docs/user/graph/getting-started.asciidoc index 1749678ace9e3..a155017f1bb22 100644 --- a/docs/user/graph/getting-started.asciidoc +++ b/docs/user/graph/getting-started.asciidoc @@ -38,7 +38,7 @@ image::user/graph/images/graph-url-connections.png["URL connections"] [role="screenshot"] image::user/graph/images/graph-link-summary.png["Link summary"] -. Use the control bar on the right to explore +. Use the control bar to explore additional connections: + * To display additional vertices that connect to your graph, click the expand icon @@ -70,7 +70,7 @@ select *Edit settings*. To change the color and label of selected vertices, click the style icon image:user/graph/images/graph-style-button.png[Style] -in the control bar on the right. +in the control bar. [float] diff --git a/docs/user/monitoring/beats-details.asciidoc b/docs/user/monitoring/beats-details.asciidoc index 0b2be4dd9e3d9..f4ecb2a74d91e 100644 --- a/docs/user/monitoring/beats-details.asciidoc +++ b/docs/user/monitoring/beats-details.asciidoc @@ -14,8 +14,8 @@ image::user/monitoring/images/monitoring-beats.jpg["Monitoring Beats",link="imag To view an overview of the Beats data in the cluster, click *Overview*. The overview page has a section for activity in the last day, which is a real-time sample of data. The summary bar and charts follow the typical paradigm -of data in the Monitoring UI, which is bound to the span of the time filter in -the top right corner of the page. This overview page can therefore show +of data in the Monitoring UI, which is bound to the span of the time filter. +This overview page can therefore show up-to-date or historical information. To view a listing of the individual Beat instances in the cluster, click *Beats*. diff --git a/docs/visualize/lens.asciidoc b/docs/visualize/lens.asciidoc index 35570ea7ca1dc..b181763c0d0d0 100644 --- a/docs/visualize/lens.asciidoc +++ b/docs/visualize/lens.asciidoc @@ -38,7 +38,7 @@ you'll see two places highlighted in green: * The visualization builder pane -* The *X-axis* or *Y-axis* fields in the right column +* The *X-axis* or *Y-axis* fields You can incorporate many fields into your visualization, and Lens uses heuristics to decide how to apply each one to the visualization. @@ -89,8 +89,8 @@ You can switch between suggestions without losing your previous state: [role="screenshot"] image::images/lens_suggestions.gif[] -If you want to switch to a chart type that is not suggested, click the chart type in the -top right, then select a chart type. When there is an exclamation point (!) +If you want to switch to a chart type that is not suggested, click the chart type, +then select a chart type. When there is an exclamation point (!) next to a chart type, Lens is unable to transfer your current data, but still allows you to make the change. @@ -106,7 +106,7 @@ If there is a match, Lens displays the new data. All fields that do not match th . Change the data field options, such as the aggregation or label. -.. Click *Drop a field here* or the field name in the right column. +.. Click *Drop a field here* or the field name in the column. .. Change the options that appear depending on the type of field. @@ -168,7 +168,7 @@ image::images/lens_tutorial_2.png[Lens tutorial] Customize your visualization to look exactly how you want. -. In the right column, click *Average of taxful_total_price*. +. Click *Average of taxful_total_price*. .. Change the *Label* to `Sales`, or a name that you prefer for the data. @@ -180,7 +180,7 @@ six available categories. . Look at the suggestions. None of them show an area chart, but for sales data, a stacked area chart might make sense. To switch the chart type: -.. Click *Stacked bar chart* in the right column. +.. Click *Stacked bar chart* in the column. .. Click *Stacked area*. + From bc3f38288337220fba91c32de3ed5a14e9c219cc Mon Sep 17 00:00:00 2001 From: spalger Date: Thu, 9 Apr 2020 10:47:42 -0700 Subject: [PATCH 010/102] skip flaky suite (#62927) --- x-pack/test/functional/apps/canvas/custom_elements.ts | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/x-pack/test/functional/apps/canvas/custom_elements.ts b/x-pack/test/functional/apps/canvas/custom_elements.ts index 6c34556840960..de3976509be1f 100644 --- a/x-pack/test/functional/apps/canvas/custom_elements.ts +++ b/x-pack/test/functional/apps/canvas/custom_elements.ts @@ -19,7 +19,8 @@ export default function canvasCustomElementTest({ const PageObjects = getPageObjects(['canvas', 'common']); const find = getService('find'); - describe('custom elements', function() { + // FLAKY: https://github.com/elastic/kibana/issues/62927 + describe.skip('custom elements', function() { this.tags('skipFirefox'); before(async () => { From 2574d0f8055981e4a44416dcfea2a9b9b64c5d9b Mon Sep 17 00:00:00 2001 From: Joel Griffith Date: Thu, 9 Apr 2020 11:01:25 -0700 Subject: [PATCH 011/102] Adds a new config flag to encode with BOM for our CSVs (#63006) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * Adds a new config flag to encode with BOM for our CSVs * Push out bom-chars to it's own constant * Getting those snapshots back into shape 💪 Co-authored-by: Elastic Machine --- .../__snapshots__/index.test.js.snap | 4 ++ .../plugins/reporting/common/constants.ts | 1 + x-pack/legacy/plugins/reporting/config.ts | 1 + .../csv/server/execute_job.test.js | 45 +++++++++++++++++++ .../export_types/csv/server/execute_job.ts | 6 ++- .../plugins/reporting/server/config/index.ts | 1 + 6 files changed, 56 insertions(+), 2 deletions(-) diff --git a/x-pack/legacy/plugins/reporting/__snapshots__/index.test.js.snap b/x-pack/legacy/plugins/reporting/__snapshots__/index.test.js.snap index 757677f1d4f82..3ae3079da136b 100644 --- a/x-pack/legacy/plugins/reporting/__snapshots__/index.test.js.snap +++ b/x-pack/legacy/plugins/reporting/__snapshots__/index.test.js.snap @@ -66,6 +66,7 @@ Object { "duration": "30s", "size": 500, }, + "useByteOrderMarkEncoding": false, }, "enabled": true, "encryptionKey": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", @@ -162,6 +163,7 @@ Object { "duration": "30s", "size": 500, }, + "useByteOrderMarkEncoding": false, }, "enabled": true, "index": ".reporting", @@ -257,6 +259,7 @@ Object { "duration": "30s", "size": 500, }, + "useByteOrderMarkEncoding": false, }, "enabled": true, "encryptionKey": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa", @@ -353,6 +356,7 @@ Object { "duration": "30s", "size": 500, }, + "useByteOrderMarkEncoding": false, }, "enabled": true, "index": ".reporting", diff --git a/x-pack/legacy/plugins/reporting/common/constants.ts b/x-pack/legacy/plugins/reporting/common/constants.ts index 8f7a06ba9f8e9..e3d6a4274e7df 100644 --- a/x-pack/legacy/plugins/reporting/common/constants.ts +++ b/x-pack/legacy/plugins/reporting/common/constants.ts @@ -19,6 +19,7 @@ export const API_GENERATE_IMMEDIATE = `${API_BASE_URL_V1}/generate/immediate/csv export const CONTENT_TYPE_CSV = 'text/csv'; export const CSV_REPORTING_ACTION = 'downloadCsvReport'; +export const CSV_BOM_CHARS = '\ufeff'; export const WHITELISTED_JOB_CONTENT_TYPES = [ 'application/json', diff --git a/x-pack/legacy/plugins/reporting/config.ts b/x-pack/legacy/plugins/reporting/config.ts index 211fa70301bbf..5eceb84c83e43 100644 --- a/x-pack/legacy/plugins/reporting/config.ts +++ b/x-pack/legacy/plugins/reporting/config.ts @@ -135,6 +135,7 @@ export async function config(Joi: any) { .default(), }).default(), csv: Joi.object({ + useByteOrderMarkEncoding: Joi.boolean().default(false), checkForFormulas: Joi.boolean().default(true), enablePanelActionDownload: Joi.boolean().default(true), maxSizeBytes: Joi.number() diff --git a/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js b/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js index 93dbe598b367c..4870e1e35cdaf 100644 --- a/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js +++ b/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js @@ -13,6 +13,7 @@ import { createMockReportingCore } from '../../../test_helpers'; import { LevelLogger } from '../../../server/lib/level_logger'; import { setFieldFormats } from '../../../server/services'; import { executeJobFactory } from './execute_job'; +import { CSV_BOM_CHARS } from '../../../common/constants'; const delay = ms => new Promise(resolve => setTimeout(() => resolve(), ms)); @@ -374,6 +375,50 @@ describe('CSV Execute Job', function() { }); }); + describe('Byte order mark encoding', () => { + it('encodes CSVs with BOM', async () => { + configGetStub.withArgs('csv', 'useByteOrderMarkEncoding').returns(true); + callAsCurrentUserStub.onFirstCall().returns({ + hits: { + hits: [{ _source: { one: 'one', two: 'bar' } }], + }, + _scroll_id: 'scrollId', + }); + + const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); + const jobParams = { + headers: encryptedHeaders, + fields: ['one', 'two'], + conflictedTypesFields: [], + searchRequest: { index: null, body: null }, + }; + const { content } = await executeJob('job123', jobParams, cancellationToken); + + expect(content).toEqual(`${CSV_BOM_CHARS}one,two\none,bar\n`); + }); + + it('encodes CSVs without BOM', async () => { + configGetStub.withArgs('csv', 'useByteOrderMarkEncoding').returns(false); + callAsCurrentUserStub.onFirstCall().returns({ + hits: { + hits: [{ _source: { one: 'one', two: 'bar' } }], + }, + _scroll_id: 'scrollId', + }); + + const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); + const jobParams = { + headers: encryptedHeaders, + fields: ['one', 'two'], + conflictedTypesFields: [], + searchRequest: { index: null, body: null }, + }; + const { content } = await executeJob('job123', jobParams, cancellationToken); + + expect(content).toEqual('one,two\none,bar\n'); + }); + }); + describe('Elasticsearch call errors', function() { it('should reject Promise if search call errors out', async function() { callAsCurrentUserStub.rejects(new Error()); diff --git a/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.ts b/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.ts index 3a282eb0b2974..376a398da274f 100644 --- a/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.ts +++ b/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.ts @@ -7,7 +7,7 @@ import { i18n } from '@kbn/i18n'; import Hapi from 'hapi'; import { IUiSettingsClient, KibanaRequest } from '../../../../../../../src/core/server'; -import { CSV_JOB_TYPE } from '../../../common/constants'; +import { CSV_JOB_TYPE, CSV_BOM_CHARS } from '../../../common/constants'; import { ReportingCore } from '../../../server/core'; import { cryptoFactory } from '../../../server/lib'; import { getFieldFormats } from '../../../server/services'; @@ -121,6 +121,8 @@ export const executeJobFactory: ExecuteJobFactory Date: Thu, 9 Apr 2020 21:26:13 +0300 Subject: [PATCH 012/102] [SIEM][CASE] Test configuration API and hooks (#62803) * Test API * Test useConnectors * Test useConfigure * Fixes --- .../case/configure/__mocks__/api.ts | 31 ++ .../containers/case/configure/api.test.ts | 115 +++++++ .../public/containers/case/configure/mock.ts | 99 ++++++ .../case/configure/use_configure.test.tsx | 299 ++++++++++++++++++ .../case/configure/use_configure.tsx | 2 +- .../case/configure/use_connectors.test.tsx | 95 ++++++ 6 files changed, 640 insertions(+), 1 deletion(-) create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/configure/__mocks__/api.ts create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/configure/api.test.ts create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/configure/mock.ts create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/configure/use_connectors.test.tsx diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/__mocks__/api.ts b/x-pack/legacy/plugins/siem/public/containers/case/configure/__mocks__/api.ts new file mode 100644 index 0000000000000..03f7d241e5dff --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/__mocks__/api.ts @@ -0,0 +1,31 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { + CasesConfigurePatch, + CasesConfigureRequest, + Connector, +} from '../../../../../../../../plugins/case/common/api'; + +import { ApiProps } from '../../types'; +import { CaseConfigure } from '../types'; +import { connectorsMock, caseConfigurationCamelCaseResponseMock } from '../mock'; + +export const fetchConnectors = async ({ signal }: ApiProps): Promise => + Promise.resolve(connectorsMock); + +export const getCaseConfigure = async ({ signal }: ApiProps): Promise => + Promise.resolve(caseConfigurationCamelCaseResponseMock); + +export const postCaseConfigure = async ( + caseConfiguration: CasesConfigureRequest, + signal: AbortSignal +): Promise => Promise.resolve(caseConfigurationCamelCaseResponseMock); + +export const patchCaseConfigure = async ( + caseConfiguration: CasesConfigurePatch, + signal: AbortSignal +): Promise => Promise.resolve(caseConfigurationCamelCaseResponseMock); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/api.test.ts b/x-pack/legacy/plugins/siem/public/containers/case/configure/api.test.ts new file mode 100644 index 0000000000000..ef0e51fb1c24d --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/api.test.ts @@ -0,0 +1,115 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { KibanaServices } from '../../../lib/kibana'; +import { fetchConnectors, getCaseConfigure, postCaseConfigure, patchCaseConfigure } from './api'; +import { + connectorsMock, + caseConfigurationMock, + caseConfigurationResposeMock, + caseConfigurationCamelCaseResponseMock, +} from './mock'; + +const abortCtrl = new AbortController(); +const mockKibanaServices = KibanaServices.get as jest.Mock; +jest.mock('../../../lib/kibana'); + +const fetchMock = jest.fn(); +mockKibanaServices.mockReturnValue({ http: { fetch: fetchMock } }); + +describe('Case Configuration API', () => { + describe('fetch connectors', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(connectorsMock); + }); + + test('check url, method, signal', async () => { + await fetchConnectors({ signal: abortCtrl.signal }); + expect(fetchMock).toHaveBeenCalledWith('/api/cases/configure/connectors/_find', { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await fetchConnectors({ signal: abortCtrl.signal }); + expect(resp).toEqual(connectorsMock); + }); + }); + + describe('fetch configuration', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(caseConfigurationResposeMock); + }); + + test('check url, method, signal', async () => { + await getCaseConfigure({ signal: abortCtrl.signal }); + expect(fetchMock).toHaveBeenCalledWith('/api/cases/configure', { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getCaseConfigure({ signal: abortCtrl.signal }); + expect(resp).toEqual(caseConfigurationCamelCaseResponseMock); + }); + + test('return null on empty response', async () => { + fetchMock.mockResolvedValue({}); + const resp = await getCaseConfigure({ signal: abortCtrl.signal }); + expect(resp).toBe(null); + }); + }); + + describe('create configuration', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(caseConfigurationResposeMock); + }); + + test('check url, body, method, signal', async () => { + await postCaseConfigure(caseConfigurationMock, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith('/api/cases/configure', { + body: + '{"connector_id":"123","connector_name":"My Connector","closure_type":"close-by-user"}', + method: 'POST', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await postCaseConfigure(caseConfigurationMock, abortCtrl.signal); + expect(resp).toEqual(caseConfigurationCamelCaseResponseMock); + }); + }); + + describe('update configuration', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(caseConfigurationResposeMock); + }); + + test('check url, body, method, signal', async () => { + await patchCaseConfigure({ connector_id: '456', version: 'WzHJ12' }, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith('/api/cases/configure', { + body: '{"connector_id":"456","version":"WzHJ12"}', + method: 'PATCH', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await patchCaseConfigure( + { connector_id: '456', version: 'WzHJ12' }, + abortCtrl.signal + ); + expect(resp).toEqual(caseConfigurationCamelCaseResponseMock); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/mock.ts b/x-pack/legacy/plugins/siem/public/containers/case/configure/mock.ts new file mode 100644 index 0000000000000..d2491b39fdf56 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/mock.ts @@ -0,0 +1,99 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { + Connector, + CasesConfigureResponse, + CasesConfigureRequest, +} from '../../../../../../../plugins/case/common/api'; +import { CaseConfigure } from './types'; + +export const connectorsMock: Connector[] = [ + { + id: '123', + actionTypeId: '.servicenow', + name: 'My Connector', + config: { + apiUrl: 'https://instance1.service-now.com', + casesConfiguration: { + mapping: [ + { + source: 'title', + target: 'short_description', + actionType: 'overwrite', + }, + { + source: 'description', + target: 'description', + actionType: 'append', + }, + { + source: 'comments', + target: 'comments', + actionType: 'append', + }, + ], + }, + }, + isPreconfigured: true, + }, + { + id: '456', + actionTypeId: '.servicenow', + name: 'My Connector 2', + config: { + apiUrl: 'https://instance2.service-now.com', + casesConfiguration: { + mapping: [ + { + source: 'title', + target: 'short_description', + actionType: 'overwrite', + }, + { + source: 'description', + target: 'description', + actionType: 'overwrite', + }, + { + source: 'comments', + target: 'comments', + actionType: 'append', + }, + ], + }, + }, + isPreconfigured: true, + }, +]; + +export const caseConfigurationResposeMock: CasesConfigureResponse = { + created_at: '2020-04-06T13:03:18.657Z', + created_by: { username: 'elastic', full_name: 'Elastic', email: 'elastic@elastic.co' }, + connector_id: '123', + connector_name: 'My Connector', + closure_type: 'close-by-user', + updated_at: '2020-04-06T14:03:18.657Z', + updated_by: { username: 'elastic', full_name: 'Elastic', email: 'elastic@elastic.co' }, + version: 'WzHJ12', +}; + +export const caseConfigurationMock: CasesConfigureRequest = { + connector_id: '123', + connector_name: 'My Connector', + closure_type: 'close-by-user', +}; + +export const caseConfigurationCamelCaseResponseMock: CaseConfigure = { + createdAt: '2020-04-06T13:03:18.657Z', + createdBy: { username: 'elastic', fullName: 'Elastic', email: 'elastic@elastic.co' }, + connectorId: '123', + connectorName: 'My Connector', + closureType: 'close-by-user', + updatedAt: '2020-04-06T14:03:18.657Z', + updatedBy: { username: 'elastic', fullName: 'Elastic', email: 'elastic@elastic.co' }, + version: 'WzHJ12', +}; diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.test.tsx new file mode 100644 index 0000000000000..3ee16e19eaf9f --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.test.tsx @@ -0,0 +1,299 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useCaseConfigure, ReturnUseCaseConfigure, PersistCaseConfigure } from './use_configure'; +import { caseConfigurationCamelCaseResponseMock } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +const configuration: PersistCaseConfigure = { + connectorId: '456', + connectorName: 'My Connector 2', + closureType: 'close-by-pushing', +}; + +describe('useConfigure', () => { + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + const args = { + setConnector: jest.fn(), + setClosureType: jest.fn(), + setCurrentConfiguration: jest.fn(), + }; + + test('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + loading: true, + persistLoading: false, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); + + test('fetch case configuration', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + loading: false, + persistLoading: false, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); + + test('fetch case configuration - setConnector', async () => { + await act(async () => { + const { waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(args.setConnector).toHaveBeenCalledWith('123', 'My Connector'); + }); + }); + + test('fetch case configuration - setClosureType', async () => { + await act(async () => { + const { waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(args.setClosureType).toHaveBeenCalledWith('close-by-user'); + }); + }); + + test('fetch case configuration - setCurrentConfiguration', async () => { + await act(async () => { + const { waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(args.setCurrentConfiguration).toHaveBeenCalledWith({ + connectorId: '123', + closureType: 'close-by-user', + }); + }); + }); + + test('fetch case configuration - only setConnector', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure({ setConnector: jest.fn() }) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + loading: false, + persistLoading: false, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); + + test('refetch case configuration', async () => { + const spyOnGetCaseConfigure = jest.spyOn(api, 'getCaseConfigure'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.refetchCaseConfigure(); + expect(spyOnGetCaseConfigure).toHaveBeenCalledTimes(2); + }); + }); + + test('set isLoading to true when fetching case configuration', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.refetchCaseConfigure(); + + expect(result.current.loading).toBe(true); + }); + }); + + test('persist case configuration', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + result.current.persistCaseConfigure(configuration); + + expect(result.current).toEqual({ + loading: false, + persistLoading: true, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); + + test('save case configuration - postCaseConfigure', async () => { + // When there is no version, a configuration is created. Otherwise is updated. + const spyOnGetCaseConfigure = jest.spyOn(api, 'getCaseConfigure'); + spyOnGetCaseConfigure.mockImplementation(() => + Promise.resolve({ + ...caseConfigurationCamelCaseResponseMock, + version: '', + }) + ); + + const spyOnPostCaseConfigure = jest.spyOn(api, 'postCaseConfigure'); + spyOnPostCaseConfigure.mockImplementation(() => + Promise.resolve({ + ...caseConfigurationCamelCaseResponseMock, + ...configuration, + }) + ); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + result.current.persistCaseConfigure(configuration); + + await waitForNextUpdate(); + + expect(args.setConnector).toHaveBeenNthCalledWith(2, '456'); + expect(args.setClosureType).toHaveBeenNthCalledWith(2, 'close-by-pushing'); + expect(args.setCurrentConfiguration).toHaveBeenNthCalledWith(2, { + connectorId: '456', + closureType: 'close-by-pushing', + }); + }); + }); + + test('save case configuration - patchCaseConfigure', async () => { + const spyOnPatchCaseConfigure = jest.spyOn(api, 'patchCaseConfigure'); + spyOnPatchCaseConfigure.mockImplementation(() => + Promise.resolve({ + ...caseConfigurationCamelCaseResponseMock, + ...configuration, + }) + ); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + result.current.persistCaseConfigure(configuration); + + await waitForNextUpdate(); + + expect(args.setConnector).toHaveBeenNthCalledWith(2, '456'); + expect(args.setClosureType).toHaveBeenNthCalledWith(2, 'close-by-pushing'); + expect(args.setCurrentConfiguration).toHaveBeenNthCalledWith(2, { + connectorId: '456', + closureType: 'close-by-pushing', + }); + }); + }); + + test('save case configuration - only setConnector', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure({ setConnector: jest.fn() }) + ); + + await waitForNextUpdate(); + await waitForNextUpdate(); + + result.current.persistCaseConfigure(configuration); + + await waitForNextUpdate(); + + expect(result.current).toEqual({ + loading: false, + persistLoading: false, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); + + test('unhappy path - fetch case configuration', async () => { + const spyOnGetCaseConfigure = jest.spyOn(api, 'getCaseConfigure'); + spyOnGetCaseConfigure.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + loading: false, + persistLoading: false, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); + + test('unhappy path - persist case configuration', async () => { + const spyOnPostCaseConfigure = jest.spyOn(api, 'postCaseConfigure'); + spyOnPostCaseConfigure.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useCaseConfigure(args) + ); + + await waitForNextUpdate(); + await waitForNextUpdate(); + + result.current.persistCaseConfigure(configuration); + + await waitForNextUpdate(); + + expect(result.current).toEqual({ + loading: false, + persistLoading: false, + refetchCaseConfigure: result.current.refetchCaseConfigure, + persistCaseConfigure: result.current.persistCaseConfigure, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx index 19d80bba1e0f8..7f57149d4e56d 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx @@ -12,7 +12,7 @@ import * as i18n from './translations'; import { ClosureType } from './types'; import { CurrentConfiguration } from '../../../pages/case/components/configure_cases/reducer'; -interface PersistCaseConfigure { +export interface PersistCaseConfigure { connectorId: string; connectorName: string; closureType: ClosureType; diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/use_connectors.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_connectors.test.tsx new file mode 100644 index 0000000000000..0d6b6acfd9065 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_connectors.test.tsx @@ -0,0 +1,95 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useConnectors, ReturnConnectors } from './use_connectors'; +import { connectorsMock } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useConnectors', () => { + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + test('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useConnectors() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + loading: true, + connectors: [], + refetchConnectors: result.current.refetchConnectors, + }); + }); + }); + + test('fetch connectors', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useConnectors() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + loading: false, + connectors: connectorsMock, + refetchConnectors: result.current.refetchConnectors, + }); + }); + }); + + test('refetch connectors', async () => { + const spyOnfetchConnectors = jest.spyOn(api, 'fetchConnectors'); + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useConnectors() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.refetchConnectors(); + expect(spyOnfetchConnectors).toHaveBeenCalledTimes(2); + }); + }); + + test('set isLoading to true when refetching connectors', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useConnectors() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.refetchConnectors(); + + expect(result.current.loading).toBe(true); + }); + }); + + test('unhappy path', async () => { + const spyOnfetchConnectors = jest.spyOn(api, 'fetchConnectors'); + spyOnfetchConnectors.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook(() => + useConnectors() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + loading: false, + connectors: [], + refetchConnectors: result.current.refetchConnectors, + }); + }); + }); +}); From 9fd63a7daad6f3f13585d2d6397402654c278914 Mon Sep 17 00:00:00 2001 From: gchaps <33642766+gchaps@users.noreply.github.com> Date: Thu, 9 Apr 2020 11:31:19 -0700 Subject: [PATCH 013/102] [DOCS] Adds docs for Painless Lab (#62997) * [DOCS] Adds docs for Painless Lab * [DOCS] Incorporated review comments --- .../painlesslab/images/painless-lab.png | Bin 0 -> 220876 bytes docs/dev-tools/painlesslab/index.asciidoc | 17 +++++++++++ docs/user/dev-tools.asciidoc | 28 ++++++++++++++---- 3 files changed, 40 insertions(+), 5 deletions(-) create mode 100644 docs/dev-tools/painlesslab/images/painless-lab.png create mode 100644 docs/dev-tools/painlesslab/index.asciidoc diff --git a/docs/dev-tools/painlesslab/images/painless-lab.png b/docs/dev-tools/painlesslab/images/painless-lab.png new file mode 100644 index 0000000000000000000000000000000000000000..f65257852792e03eae3d2e111da11d81f6df630f GIT binary patch literal 220876 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%0DJ;r1F_I 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

}xIV{+K-l~dNlQoghqoZX| zq*lE>_mE2WMeDvfL=K>BVzhAsEo)qYPx0h9=wkReA$c=EYl;0d`6t`J>s7b)H+ z>ozYInE2c0lz-Xc)~a`XA%=+a{(E&*TH4Y8^4k(vG8S%_5(Y}GX5u24gMIUQ=?bF? zcaN1M_26o=PoI9CSr!Jn3{S?eP;!=i31^;LS{#tSvwT|euG|^U56Y$uk zgCgcvm@XcM8&qJVqeI&8O!dW|qTQI`I*YrV1mS!)h@^&JEmoi<~lr3rvQ3RO~{l6evPBy2CYH zlUtsYuWvOp;zQYr)W+u#BBtBIQ))j=J>j42j085hoX-~6unsMAn=RyGZITNgKMVd! zk0r3RI)ycS;TF@lA5qtdXSsXtCF7|q(yYLX9UZT?2IATR`GD}Jyb@$fiidE#{eF}7~s7ED4=ij2>T(a}Qm^|<)~-;3^=Acfslsw@{Sou{TG7@WlI zV&&_=rx~YetaW}vcD8H?J-qNDgFTLJ@8R8p>Q=-08P++a3wDyDY`0t@Ol=q*v;Mu4 z*@FQh5+N@kkm2Yk*+UUZ3tt|B#erI=LMJ#?5XXGflkdnOGGSpdk}gv}tybmCrO|Q? z1$Y3)wdkP-V9)T$*__H867Yhn^SPJB7h;RLlbjzB(0 z@Jue~Yj(*Cw?p;3;{`9csRET6S=ke38)UA`2QKZ8fh@}asDaJ26Z-057C40Dc?XXNn(O}$n;D=HQx=^|X(L?|Fk|Yak@o61oyXqmMsZ`YomfrEM#g^%2wMg z=jM60rw8?joGyFsy4?k|=9qZDI!B=w5^Oh~%7V<& z@R<=pCp~F(EuFbdrV@kaezc4U8irr|%Bq>&!xNz<&?j;=rK|ZQah5-g-s|81IhIl1 zjg{SW;gb@>J2HGH;y}`jQdlh{-;^xw;Z6UqUw?Fkmaf;%3H&1P;!->|r@_R06|j5q z-l*5&m#Nyl0*BcozD&xyR^Z4@&!z538CYrrM{!A+7=4jyYK(Rc@1lGz#_t~<%H4lu zU>^}4#K|3Aj0s4Ks;toM-Y#o?*t59q9aF1uueM(yRars$vv`RB?| z3waxSlKf~y@Y^Q$uQ#K*;XfkDZr}uUkpFLs`0saoVo3y{3hi0qR3 zW5SJ)D5T32<>yE@ZJt8a;U>G|<}Tnq=R#XQlx_BK2PW2AxYDMc&&}%o)(=qp(S=1i z2-&PT7~i~k<#fC(^5u(k6U&F!a!mmc(6F$Em&p!$m6l+BO)(5<9=9VXZqOXonMV{+ zN3|tK*;8xg8)WSg|L)^u(4FJLNsB9h=UaE(AmSXxm&ZkqR%34yu-nMbjH!4S&X;ez zwOebaFjNTX+|p@!A|V;G=4!lZZ*MOH9DUhFVl@mQAyK0fFBuH6hN-7oSj*CtGAbyI zta1JBhgv>^)0Y5$y<#at&9IpNS|ve^H-gNw-OB1M<~;n52bM@g{MZ@p{Dg|8!+}8^ z8fq2p^tUMYFuF*u!yo-xI>J+&s*3V%Id`sQQ=7e5#ddJVYFqVVvHJ6iIBP|SNUaPo{`u~}})xke`9MgT|@sivd`8uBVixmjW>`P!P*IUC-e#gs8 zXxJ?)x?y5HTHpYrsZJ1DPTK^{NDJ??=)9!-?{iQPpL{jByE}$5K(R?pAL(EQhz{N9 ztlsBfcD+YBSoDCnOfU6GsXfv=46xpvJCu1vvl~dw>e+E{S?N@o*+^l|LR|-A_f5W;q zy=+mbhtJSya>fIeRp`kRgvoIKDjp48i$4^bv682e&2lo9_+%{D=N(ey>NUl9jsP869iOF%=CSJCnmhz^j?d-l!+`gTQV_WUwt==?)h` z{vY$Jj4D`&tK0XCi-+O5V3|&nARIAX#bxDK9XSS`llT)( zWV^^mK2?2p1yDY|rm#oJgVT%chsOk(>8)Z}v)Qr|ovo`wo;N_Okz+;JV-Cj?i| zll1gsstSWGi@{_*Vqh8u$YvavzCY#l#!uk@k45)S+n)8+OvB!IHda8Z<_FZ+U-R*s%8~rF(}Y6<|C;*R07+>1*E%s)0D(Eb!lQKE?v(hK@Eu_CF*^n z4SDiA3vV4_N0AyUbvwXV9&mpkM0~t{sqW!1#jDXYs+19#b^4yPT-@_AE}`tpoWQKt zD${(^B$OZQrQ#*{P~dBDOx{Lk@WjdafZquJ1DwPDi}N~>9i{#E0h3LRrP%4sz`T-bahSS;wIbl#{#Pg;7zP#Sk+9qhK`QQYxKtPa5;2! z^&_upCH}3~BRs-pBS~Jn7my zyS*fME*$^}%YbX@YnCPbzR@O!;itn}>UoB+T*T*>e3HR+5r zZf}FzXeH9myO7||BuYe?DN_Bp< zgGf7?)bA!UWbv&%$fF6wY~BubbvrZZh{W`22Zl^*35<*dD#h9TxHAXDh}edY_b;hb zim3SaE}I*0QrAkHzI_cU=Fh>i+hB5Bd;_QvVbv>df4I#!jTRWQPWh1^MMp;`GMP8< zkMO$KcPuPuPA!xh*4}#3EA`%kyPQj=CDw42UG}Kp(YQJ04283_l*H<1C@Hy#iH0uJARW>qZzE9$EPpVS{a zsm)Ep&n?wg1H-Sy^%CdoEymlB>uz^_`Yly{(y`xU1Z=;Ul~2!-a^bl~7eCha`=M^H zr&o+4PbY;E1X1*oQPs&^sTy8<%HyT-*{k+2a?LLp-C$v&jn-mXGo7Dw+zG|ue64jW9hQ{z|YJB(h_>1Ty%$#tP&bi4mWLw6AH2-XA5y$EztGF##Lj4oxC@J&TQ z1JFWWT$eHSC(!z>>vd=lY-rJY&CS4mh_Ikyj zHA*%#G=z2BwDdvS68$EDPCM9o!SOpVV$q0|ItU(=a6dW<20fB3KX9A!)5LNh{tUJr zQPUB%*PMAn$&F7T^{RuB^{sx}aZ77Y4?t2wW>u*sIG#LZ0~P`b81U|%KJw5!3ZGN< zCNM@8kTVE9YF%@9hE%@+gTWGQvw@!?N-n{Ml;73L$r7(Oz}WmjQt?zJw`Nm6@CuZR zi`K`zOo)j+fQaG}p~jkGru%)N#G7+1t!9iBVRgpTpx%~!j(k`o`eY7ya5FDN6o~}7 zOagsUWV44WHM;#>#1ec>Dy^z4+vAL`molGKluK{V(2z{&-62?DZ-tdC%u>I5&=0ikbQ-WEnl;GA}p0B?ZD{|k|YoItESFbif;Gydcm%= z-DY;|9e#yn>Uts8n^JJD zGk_!EmPMNH2@e-q!hnC~zI3J(%xe@L3qK% z-F$`7K&f%Z`|ZC9zt$Ks!2vyUxAjCrE8IcL5P^gmZvR5l}#)>b|i2UJy zW;oPPT=4P+b;6W%a!?aG93fsMBW-5baAqh}@)MuSF}KAwZ3v}*KNZqKXQCuY2F<7x#TKe&^|nT zJs;~v+&2@c`ImX%^-*iD*nSi2EW*nau1eI+EcI>tfqrrIis)}Cg|ugPTO!e9@$1G{ z2kLRgX_L%0Y82BTiVz(6=?XxOEqrrk%xwDzb+I@1nnLoG;yr$d+C0yG#x42r>O4ootUro$qvPx1np~HADp-KBe>sA z+Vy_xdR!!o>`bM#ecgK>U#b?qV>zRg67nH}6?=HN%62~)fC@H1PCO!7oT=OnFfS1{ zRc)A4&E<+fTjZopC0f|ion&abr!Bd3)m`hiK(0tX)HI_mzw+{OwdXa{$0@wiOF_1H zhU2DS(A{9l3OsSS8aD0WY7|=NW7X+&p(bK-b^T%}5JI8^PL9u*G`yS95f8^#mM{1M zFP*^!3&5a?8R_(4-%MqwVz@}87Q8H+#F8^w zB14NrY+gg-7|`gz6Un64 zgJI>uH!Rxe-42&b7scKe#YqAq-L~gAKNPy`uMGr=U(s54uA16vOTOUxy#4Wzkk=Vn zD!!z>DC2Fu-3J5V8Bt;g^8Yz`zQO@@;EM)tU7alswMTN#YbVTdV7%RQcl8uS5sJF( za?Vzy-GW8HZY^=RQ=mUkv(&q8h)r_%4m|k=XW*MuhLj0dn$r%<-HD;5#TLu7dE;W* ze;s~6C_+fLb->c6tOx4kze&i5$lU=G3i>Sn0Cd?xWIg-2QuL>WZK-01wvT6LG%mUJ#gBd$|lka!f7cghA zKzE)#jJIGFTe9A|Z=Yo*-`t@7_i#BI3NoY(UeLj5BnY_Z)zN57*S_Q_8ex8nD`IXF zY(I|;XhzVgB5wWF>^)71^r4+IRmk18f~SvI)uq=L-Hg-XRY9Z66Z^zG9GEC(5g4Gc zz>A5R>NsF^QcJ5jb$`(DBJ_>{+vCU-N@ow*DVzv zJDz6d&QG_Z(A8QT&3&N?gXBs|@JLGaH3QKr#k1@>ZgIJ@Tl(?Orl^chDc_2PVs{Hz zu4@?vu@$hcwYHI8?_z#-o8EG=(td%?{|*0u8BJfIh`&^)v4n%(p!9l3n(7senPcsz ztHqbGR66f6*V)gz9Nc$RgG<~&(bO=lmuVcDy-PYlSkLW ziozYufXON5LoNN{HETmrUxfPBOs9+ah^7Xe&}P~ImgmCk=*pz=7YU3>+STtt0|^h8 zZi1FQnT3Y1i(90=yp#Q@U9dTl@uSI~_sj}M4$852*1hUKkxFsU!`mgmLUGu178BT! zZxHNfEpmPz&yl1e-V|xR#m*AP|7_LMrFxC?qD94XRM+K(0u)s_^CsU??l=hjzZ>57 z(2zY(4yi!_>A62NoemU_NZUKe0p*j+!5;`l(h_kmuUtBR9{UZ+G9+8}r zj1bmVw`~KiQf~Y9Mv9Dv692R8f#@eAPGK_gvdu-Iuc86u+%@YRWoTP82E%rh$LhtP zNp72kW~q9<-e^7oQKplts}CRH;>&vr2PzanO}TWwUBLM0QloOycqCmLG|x~POZ=Sc zUYp2~7sFfb+z23t*}COH6Gaf1$r)Bx6hBIfj&Ns+4FDjC6_mBCBJeaUitYj;(L?%T-=u#i`bZXDW1^ z0l^BX_Ch2KFmEPHv_;ef7#`h{3f^u+BWD8~nR|cBODHHJ{1nBR%Z#a~^*g{!=H&ax z=~S6*oD{qv>8asjrRqKGi*A;h^-|D0HeluUaXr6IjVS;CNqzvhb(!Y|wxRvE4Kh7( z@vo#*oND#`07~XRRAVt!5bUtePOUp%5rBzcKtZdry56G>Z4-<`n_Sk_$omm}?D{x| zcIpFcZGqFTGQX=w>1M5H@Mx&>(jq#KlO7&=8thZgBpT6%`=oS|E~lx`)Z z`L^dg&pAH6-#PrXhab$|`;K+5bzRq5%XCe`4!nPbt|cRFMEHOho6k;G(ViJxGqODDoOXp zWS`DGv(qw3w`aJF{9CzKmo;2klmQttF?^&kpR)JK4M(e<>#hDc)iSNL=Vp?;i2GoG zn)W$Gar_2q(O$4d9>Z1Tr$_3DPbCx`n}f*i7s(ho3jR@Hf6jWmB_gla*2j73FTVAW z{lVIV_s)kH^tOo7R5qxTG$9AXc^tsMnoeygszEv#J{+2j%fzScsFiKZL1Pq@CK~>V z&8!Lib`zA3^1iJ?T7dWub^F5D>iBw>Hy`#gqY zpw>_X7jyf3U0L34TE^^3cbLRSg(Hv6&j(rnE>kcWGHBM0a<0{Y*=}0Tq1_USOOhE~ zRy`k#ih-{|(H4e-zw`%NJG*R6f{lb(ZPMH&%&OHcUCyNpt7K5e%n0f? z(u{++;zkAt=%TC8{!aWI7+{HWcB~c>POf|d#!x%o1jIx;xs6w1_$^XQ6l-bU^j%0;b{$h(@Wdq^v&5A<$fi&bB& zjT{$YMq+MbEkAOHmRr}E1BRo^!s3-CXU8$R>3(+#=!0IfATBbNq&08KBNppPk+_DR zy_<@kSbxqU_yOS4EG81f(wv&6lHf#Ji`PhJUcNL8ejbb-)7?XhPtJ+Fi48d5ef{|k zw58_Y;d|xE2S+O30GrWo~trxL1DNzEFIZ$UXhZFBwf>94_mbktT z_sKYWl$iQ6XUCn9R5NS~KZrU0G1N#UMJyC$(dcnYc5`#1+j6XGK9D?`oKRAy3-$H( z$+u4HC4cVaRR@zwyu-k9A8@K3MoCUC1m8hceCMIbnRf*6)CT}-<6=IXS@>2eRbq3W z$}f8|zvip43qrtb-F{8tGUlA;WN`ZZcqVlJ`VMm6+v<}amQwTZY(ZB*bHe|XSYigI zV4cXWr+($s*lhP+-)^`k47`B}6rIC|M|7W)c$Se65PoVdHZP-*DE==gcw5jqm7amx z|0_o&DuM=xaGv$Q@J*WQT%dd;wBTSFu^GoBH@|Mqk0S;T(_0v9@pDiH#U%MJ^+q4s zSLfx`CqHBU5~n3nE$GuY(;`a}s(waa8Ke4MMh`k!y)n#JfC}zUl$gJlshypw1PNSs z6;O*pker^L2KlK!hDhjJ`H>p@VCnGNpFb7gCpIazyE&h0NbPhbbc0{OfNr(;{d!h_ zCWg59M(^#Eu{TR*9W%<-jO)f|t!nu_QU^-CBK?>Hh4hG#jQ3I%kwTxQ=s%wKH7IRC z89x`S`ug~6Qw#`c7^95Q)e2CSZ+isIiR6Ev zb;;S5848Wmsrf^!;ZIOlWS(5D-dui@HEj05gNNVODl@u?s5Mr%6}Nwj_Ff85XefL{ z2>%-AZAGgq`$96UnUSc#4m7>ETBVR0!`MGwu>5TOn0ILBQ=MQs+J9}plLoqXpO>^xU&Yw$ z&Gf5!z7~A(%i$Qvt4fXdipfXGXB5$%$isU(txa5cwm^BOgLVeyA}kUo1RrF}z{~7p z_?ugC=MliQi)bGNibedW-s+D(pwP( zQLBM51}_)0EIz<&d|idIwMIsax>KK*^wBl_?-71CiP`h5DEF!cR+dwpGZr^(sc+VK z@GF~@ONG*aRC27Qreqc@`A}ub)VT_?EnoL7)?u(g+6R7BweS`6VEu<&T>kVuCH5*D z{vVj*`Hd*x6{bSXDTlHz#MkSVbe;;z)u%oZ0#s z*#y7)O?7}lJWpoHTpjvUnUUNK?D}LirFB3Ch@sW06&V1by2&d(?4 z?_Q(l1erj&35KWVk5%5aiZXB}piN5VwZPCW(Z54z%79BDj08|AF4MBM7Q&|A_kOH^ zFLu3wVuNUaJh=4*B04M5{}O+>R)|MaKQ8~|p#AOjNWLzl zKzXKdi@nW2nwYXgtq{^g>l)u;vmMvrYF{X80;|4eEVNIMm`6JT!#-W!fD?M8+Uv36 zZjrnpQ9SkXXq_^d&mZNdXpF~dm=36dDzkCFJm3yiG@0Ap7`el&d)FJhw9#BJDj?mv zAHZQ4PSx#SY&apmKm-r}_^j7d7v`35L)|9nIY9fznmCKW>hbhczggFt8VyJ*TCz+MEKx|KXH8gkdujA<()D>0b7>HfewF}uh;;PZaQqymyl1k|Ss zW7Zn>a~x6&1CP2rh-<vsyB`W#?6Ep<>cdbZCEJ1W z(~rb&HvPRU`*OG8$w;Gtp$7oT4f4D}@#CwLkpAB6`%N4ulO3MXc$YfOiKJ<64XdWf0O;%5&FE`(E%+KjZSrOp0&CAZ5AypE4H|?IN6U*%!#BcVsi2@ zmho5ZfEe#Hnd`<7o|6-omK6|T0fUInY1k07Gv)O1hAM!@q^0T1@w3i_?vH&52$(n@ z_!^>xMSmr%c%KyoNKaFaGUL_x6cPK`k<&dEeF8D@&2S(XE}Yy2y&C}7j~9r68QZ4w zqcxd1{?hnjwE7szLD!A4=0f9A>_gJ;8vgO@dWMwM?kx_NoX=8)Q9pkCYCT#4I;9j1 zNg02oX(7HfPW8<*fYhQtUVY=6`%Y+ku(%x1+L1C^4x7uU2D@LUw7oaZ>UlOm#b4SI zV3Q1#PtTdX<1^4c-W~8yVHqu0`RgzM(R9kOCBN*vt2Fb33Gg*0UfQ*uQ z_s9sh-$l#Ry88xj#-g zUOZ4RP{)llZwDwV z9CO>plBM?cU8b*O*=)L`e3p3>U%gcuRU=p`8kRZ(cklucEo#>3ewab+H)>j1sljIX zuN^>>5G8iQI<(qv^Kd{M$@-9X)7IW`u_5d{fK#fGzm)r8uH5-+hXv3s!SvfHs$$z^ z(>J-EOb#|gWL6Nn>nph*WllTtIXO8{$7@SJ0ZWt?3L!M_qg9}yD?Nt45bomQBAJMf zAg9S`cSWpO{AQAX)1&z&Z=Aru7;d{EszO63yJ9?Z{%n7oNbLiS+gDj%HlcCJ+}>}* zWmy0%3^D`S-OV4MM|aS_UV?}Zq$*{Lp2Z&cZEM>)cJleBtLp%d#IT2i-_#ImP#B* zAtWLyTAq~|H<^h9eS9A1w|NAe(qpTcnxfW`+ z;0|RpMy3fk(!4D%e^4CB(war(xYSZGJJpT(rS0Zvp$X7UMB-vbDE{ zer|r~tkY3lm;Ua{4~--S?Yqfh4GKU;@Uw$mhg2ucWIMpV=4cOY<8RE=y+jQ`duzHsFHr&L ze&V@w9{BqNKxjj8Sn?ldI(}Yo)_G-gBqRjP zBU+1Fc2;L4;AMU|(p@s~^-pj0ODoNbE0Oofgw_GRRl?hzg%>oed=E*~E`d=NI zz*PbWC=F4>$a}3p8fa#Ejoz=O2&t}skww2@(LXkE#nZ8)(Ir-nFcvsxt^-eZqIcFQd*G` z*b+PMd~1Cx6^gyN5_zvUZPPkUl-4X;tyH$!%iC1JuulG^n2{l|VXL>2L=t+n)e^G# z;c?d|o{i_UlNRk0I|84T-Qc&Zt8^a?>tW8W!CiCMo% z-mnp=gN`l%z473JQrP2RwVgyk5}RffGoa@>cHLrnEIa8FFO&MZraG%mCEUjKVn+JFQf8oQRY0L|LO1+=#XwX?Os(s^?< z^tVL~Sc8=^{g&^B>yJo54ztg$9$Se6IXMwI-Krm-$4YH~RMqqnJX{+tKos!srqtVR zxKMV`(rRTzBjR{GRowRHf#T26n#uaSPLZ77JY+4MoCHljfH(|3mOPMK>$|UIqTk@r zUi9unHvklWYDL)2Q8GxL`0 zRBytezZ@c7iCDT$M5G&E+jBM54>GBj%N4vwv=ZAn8O@!+Y9l4{((Kt}Fr6Zsuk9vn|nRJ)Y;xRkP7?`3L?i2CcW=rR$x(TygQnHUS&|-Vs zTf4zcA(HYMkMq(5zH1WD$yK@W(dpaWliu(h48of(v0!(Cez0e43NwN|i7v z*Cn0rsr^O$yx>A(YtF!CH{f)3$Y2BJ;;LseQEfqfnNIiW^g*yL)5c&11+dAV0ub=Q z_m|ZC_S4yhhSt~e=Kzfkg->0+uj)X@S)Q$?@R{Wc2=KBRD#=Q_1Ob5RG^_HyMjWhg z;^N(<)D^Ye#^bW14X%#4Zk$k@`@Hxwj)sPu@*+UK6woV0cFjd{C{I}q7l3q4*CXqJ zRzfO$TA{igfPj>~!8vB+y*Bwq26qK*ara`T@e0<^# z(J9g;uf9J?X!iZl(npMe6(xt%G`)>pWj~6`q>_%v?Hx~$aX+$*N|?j)#pQLT0lt^3 zK7UrXN>s?W!3#YU`#vni6OdM|jmffqApbK;zVStgp<>#r)yhps!%PXgI*p7DM^qmB z?zOfCJw*OHo)b+&lNR8^X;Zw_B9I<_e(MS{z-VNp5k#GzpC33M&7SUR(RPR${D|(L z$WolDT}y z4SCv7B}KBhImi6N8^rEO_y0F7^}jdplEth`72CC)tj)%am}Zr-P5;0u?xh70%dKLx z=a>usZuc_fA=??N6UoIB^Lv(IfvegOe~QGfqANA`rz9cfLo z;V^BFr~DBWmLUGw!aD|^C)_3l+xfLcYM3oHq>I_LA{l$%EGzm&Ph{ssMk*6Slo?5b zBUS_}EnS6jLMzms^Yacd|2?7q6HomCDu@Q78On_CH5zeChE>2&VK6j)2R*ej;$h9qV%~nNxO?JQ9!#kO8G41u%U|2DB8LcU_SrP50~Nq+RR6pj$QKIam+a|yV@MVF?d0?V}2 zUOlnhlxEk|MXi}lL7(^)AF_}(a}7zF#)~@ppnn^>F-qjAiV94NP&SJ0_S}J>LD~vo z0o`RpX2CWtot?W!&|UC%Zw+(w*jy8=JVdTT|Vk!IsG~|E7Ld z6+^Df3Uw1!CJcmM=yWX!e(T(p9%Ob5Zmg?v6V}2{`?t4zFGIZ$(Z0+h)uh0@MA*Rn zu=Z1W-$#=45}A&^U;VY;uD7zDG>`8E83G3{t8^zLixgkCsZn53uwvhjakCr|na zot5kJGyRkpNx}GEvm=AdZb7(GDL52EGLLFhc+7be|MfjVfo=}u_TeB&dgF5e*%0Hn zo@NkKJY=mX3NNRmjgbUFkAW-kOMBFSZipL1e|+_1pZeZ2A>kd#yrkbcst6KmdZ0wD+;= zdWR6q2yB(ngp+bb3%hTB07&|Gbs<3P`SttP&gmBa#_*lve_Qs{fo@XNMg|xZd?uA~ zm~6#&Q(^B?5F1 zrdMeRm$(+R|%3keK4f9f|fq+)NdGC9Y zEl~y0z+(sUk{ZbPO_&(tsIYE`F%%;a?tZkcjPu@G}?gaH8&kts+vB`5N_BNT^q zVPS#taW@fz;**di$zY66Zl&o!V`iD_f)i=M6659vzNfpAw>Q@sZmC;_xRdje^o!Wj z@@nisY&vDQde1xG;C1fKR33ETaD8xGXegSlahQuIU{_^mYHprTW^(Tm7N`!6h``Ct z$swMIQkb{uvbHDEN(lYO_d-I3p53Q8`__7k2*DygCRAtw99FNbyd?XUu>Huy)o0|* zo%FJP{{Ctoo**;m_KTW}S6U8+Po-`ee{22$l!XA2ei=M~C2-V}Ccp*YRv!V`Iw6RU zot@nnY_-nuCJhkJ9&9r*w5Qypv&6->>`f>vInq93WHxC>%rK~vk`Vh4dc$eYuFjA8 zRGlM8I6e>3bJ7C6D@vAWZxr=d=q%ty(zdBf0q1K;x-EV}K$WPNfZJ=*r*HAKOpp+t zY!7HBXfru+<|yzSb{F#=1L#*=pSDjE6@}k{wY?!@zH%dJ;D&cC9(w( z6GD>M^|Ek0XzUVi`5-mpl|N#4b*9*NBW!O{4{l-RAmxzJdvc)43STt%P2 zwI+UjtRXh2oeOL`R`0{r-o6niF!43va3!3(cXjlW&3SDfu`(bl%!zPBQgE@YywJ^X~H>U0btTqgxmW;^1U2i%KjF=O+4<&d zJ0^EPk3=zT3~V0xYp%T@P{RIt_lbh?yC?iHT$8#@gJ>}~k2{I%qC9Y`TyEMz?Xka|3^(bv4 zF(HjEdk|kO;d15Ev2-k$uDOQr&Wr1i{O2E~`o!S9aZIC?R;tZ)kxC?aXMx_|zXWDF zQWC~p0tkB1YK-`WJXV*ftps>kdM8`-f1&xmQ8W1*G{A9>0y=w3hD?+5SW+`HV|K?- zbpyL9p*{Pgg3F`@cQA+-$d@<+b_Y=W5l`zGyA^ydsLpVN{W-(ad433z9@JC@0%6}L zuOUsObIVzn1s>l#ysHbGv-U+JXuxt z$4cXOaM7I<=HcbNM~i7EDQ!Z2$<=xlRPVY`WDX`~b6WA-o7K`IOk&ZH4TE>6A_~x< z+%>g#lC=>RnOEoWb^|8+&`9c(7TjwH)>0V7ohKQ#djqafg(ksBesI~Zc8^BX!|7l$V z<#Z0>p|7kp{YXl!T*Q#@OVk@&1; zNCQ#JtFqz1h~Q`Js78ar?jviDb!i1z8--!fW>N&_uY|qKQ?nx8u_er~c$GR)iMfxU zCTTcae`Oj}*^p^SHF`g^`FjEwXjsS%GGeH=hrwT1!56RZ;J@sjq})7GNUyegFPEWs ze+^5?79ITNdO3m%VP~9K0hwtaS+xlX0ZtWL1roU#wNc}D1?ZEK=@uJ98FRuZ8^5`0 ze|_9~-3C;ki`@F5hVl@= zWIgG6aq#VO-gTIz_)FHS3oKYt;@P)}c^Y{kImt?S5@cPRLysm%GqCZ4tLIR`?bJXr zC_Eup7p+_uDpkCFtTrz~7Ht27seO~PGnp%>q|WXgHAy{!+U!{gSqWH0e(LgKryOM7 zLtqigkvN%65k41H-g40=7@`@*WPt18p$Q1~yQdE{xb3^FanE5{l@sdC>6TyFOn;Jfc zs$7u}OC{ogyU^&VLlGS&Q>=#T!OJsapm=o~-UtE8lWfbZ83whswhH&H+nR#eeRaZy z=*x(^27@0eC9tB8rmPzF&EU{Jh}dK^BaPL-0Xm}Ta8fLKt>EE+bo-`>RjV5m#1ykk zd#~E>P%#ToAUw<;9Wu69gF9s1Bo0Q4(V<;6_j&E?dWmr?b8vL6+{Fkp;YM%k609dn z$c=rr7eyO>7n^Ksz=Rr@`DEiL)b0A3|)yA0(J-I*^c zLHwSCpQ0qYyv#--rK0v30Y^5cN}x2Iry+CG(-fI~HXE|bV>P5{T3z)KYlK!)$vGF* z)}Qe-*}ngUoOtja-umtg&RLZwc4LI|m|Vq4a*fjxeto_4Y668+CJHVE|1+T)l3O;S zE`8m@E;N(R0SA=qD(RHxq&559Gp+~2v^bIonpawrWkwMw=-7o!k4?Att?2{_U*$y$ zt|g{vT*dbcZtXI94n@cQE)V!C+E7n=Z7pRAYIOc8m3OyyZh4t8+vjAvPgrLx1J6{A zeX?CWpf8?95vf$ax`@aUF04%q%4;4>6L?B2%cq0q5;r;s-3kkwW;2*m)#DM5eo3GOYr4SZGY&X19DWzV8UkWTv4h9J z!t=Rj9Eu`P8%Vj3k z4nG1LUu6~fDU2hSvdSs8`u4TAMom0X5XS@6Kw?5q_ye!`Ig}T_)dCn7m^E^5w*Im+|8w!K1rq{Z0mzRDCI(qf?Q(?jmU{N!@yHv< zCf1hy^7v0T6-%W%ljf5_Xd!4Agw+cEnUMEvtw-U%(UFbxv_Chol>t-6oBDohOI zO1cDEZs~~CJCA!veEBEW{(t|II`CNW$rW9{r6){oYOOzMe214EaV@yZ=xe z>8C;Z@`?8QJxF`}>#U;ty}kc*@&Uik#SR4GknS#|N&Siw@1hrGIsY>Sztsx_W+c}M zM3%2RtND6-3btbXPca+t44J%vZk!n14>0WXD?B2tIInV{Fo}O1YXh{gTCx&yjHl8s zjj*B_?EN!q+FW`6?Rmb_V*$@2$Otsm!kDZ!5j&(8f^q%pJ;u?-s>#@4<$4zrXfO7x zEgbt}yA%%Z?R)}gF1EY#iR8|^713+(C1%)Sd zLM%y3C`<2@vvp09|6_ddb1?=MWWJ8j9m>~{6ciT5RvQHY4Q}}jP$^1Yvs{ax*d-DF z3*H5&@{{P~qM3EDx6}ym@7|Sr=BByJ?*bx_(G_r;q+=B#l-G^_2aEj&)|M%bQbvpN zZLapN9?V=aQ`Gy*-d^eDOoHg3i|$b~1tn$aSk+O;J8K8Begz6nPR>4BJv)=b>bl7q zZ5!s-Gd+*`7_@%Podd)5nYPLiv9uqdPUY%D1A z$d9V(Jb0rO?ASi$K+Ciz)lxyK5q5H?PR1s)`XgS#!VhL_)*k-(XY>Jw0%hn9VnV{R ztlyXilMCS0bW>DQSzr!9eNX+&(!=PnNN;^Z5tnQ5HThIf4dNlCLxN|#<-qvzZ0t_V z&Tt*c!%`8BVQp_Y8-yrF8D;%V-A$yOq=8v>, +process {ref}/docs-reindex.html[reindexed data], define complex +<>, +and work with data in other contexts. + +To get started, go to *Dev Tools > Painless Lab*. + +image::dev-tools/painlesslab/images/painless-lab.png[Painless Lab] diff --git a/docs/user/dev-tools.asciidoc b/docs/user/dev-tools.asciidoc index 77a781fd069e4..0ee7fbc741e00 100644 --- a/docs/user/dev-tools.asciidoc +++ b/docs/user/dev-tools.asciidoc @@ -4,13 +4,29 @@ [partintro] -- -The *Dev Tools* page contains development tools that you can use to interact -with your data in Kibana. +*Dev Tools* contains tools that you can use to interact +with your data. -* <> -* <> -* <> +[cols="2"] +|=== +a| <> + +| Interact with the REST API of Elasticsearch, including sending requests +and viewing API documentation. + +a| <> + +| Inspect and analyze your search queries. + +a| <> + +| Build and debug grok patterns before you use them in your data processing pipelines. + +a| <> + +| beta:[] Test and debug Painless scripts in real-time. +|=== -- @@ -19,3 +35,5 @@ include::{kib-repo-dir}/dev-tools/console/console.asciidoc[] include::{kib-repo-dir}/dev-tools/searchprofiler/index.asciidoc[] include::{kib-repo-dir}/dev-tools/grokdebugger/index.asciidoc[] + +include::{kib-repo-dir}/dev-tools/painlesslab/index.asciidoc[] From 087df824523d007409c68e7d3ba32d824cce07ee Mon Sep 17 00:00:00 2001 From: Chris Cowan Date: Thu, 9 Apr 2020 11:48:56 -0700 Subject: [PATCH 014/102] [TSVB] Add Positive Rate to Aggregations (#59843) * [TSVB] Add Rate to Aggregations * Fixing i18n labels * Changing from rate to growth_rate; adding message to aggregation form; * Change units to scale; change free text to combobox * Fixing placeholder * Fixing i18n label * Changing from Growth Rate to Positive Rate Co-authored-by: Elastic Machine --- .../public/components/aggs/agg_select.js | 6 + .../public/components/aggs/positive_rate.js | 191 ++++++++++++++++++ .../public/components/lib/agg_to_component.js | 2 + .../vis_type_timeseries/common/agg_lookup.js | 3 + .../common/calculate_label.js | 6 + .../request_processors/series/index.js | 2 + .../series/positive_rate.js | 68 +++++++ .../series/positive_rate.test.js | 95 +++++++++ .../request_processors/table/index.js | 2 + .../request_processors/table/positive_rate.js | 35 ++++ 10 files changed, 410 insertions(+) create mode 100644 src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/positive_rate.js create mode 100644 src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.js create mode 100644 src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.test.js create mode 100644 src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/positive_rate.js diff --git a/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/agg_select.js b/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/agg_select.js index f93dee14d0eed..8607ff184dfaa 100644 --- a/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/agg_select.js +++ b/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/agg_select.js @@ -49,6 +49,12 @@ const metricAggs = [ }), value: 'filter_ratio', }, + { + label: i18n.translate('visTypeTimeseries.aggSelect.metricsAggs.positiveRateLabel', { + defaultMessage: 'Positive Rate', + }), + value: 'positive_rate', + }, { label: i18n.translate('visTypeTimeseries.aggSelect.metricsAggs.maxLabel', { defaultMessage: 'Max', diff --git a/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/positive_rate.js b/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/positive_rate.js new file mode 100644 index 0000000000000..39558fa3a9224 --- /dev/null +++ b/src/legacy/core_plugins/vis_type_timeseries/public/components/aggs/positive_rate.js @@ -0,0 +1,191 @@ +/* + * 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. + */ + +import PropTypes from 'prop-types'; +import React from 'react'; +import { AggSelect } from './agg_select'; +import { FieldSelect } from './field_select'; +import { AggRow } from './agg_row'; +import { createChangeHandler } from '../lib/create_change_handler'; +import { createSelectHandler } from '../lib/create_select_handler'; +import { + htmlIdGenerator, + EuiFlexGroup, + EuiFlexItem, + EuiFormLabel, + EuiFormRow, + EuiSpacer, + EuiText, + EuiLink, + EuiComboBox, +} from '@elastic/eui'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { i18n } from '@kbn/i18n'; +import { KBN_FIELD_TYPES } from '../../../../../../plugins/data/public'; + +const UNIT_OPTIONS = [ + { + label: i18n.translate('visTypeTimeseries.units.auto', { defaultMessage: 'auto' }), + value: '', + }, + { + label: i18n.translate('visTypeTimeseries.units.perMillisecond', { + defaultMessage: 'per millisecond', + }), + value: '1ms', + }, + { + label: i18n.translate('visTypeTimeseries.units.perSecond', { defaultMessage: 'per second' }), + value: '1s', + }, + { + label: i18n.translate('visTypeTimeseries.units.perMinute', { defaultMessage: 'per minute' }), + value: '1m', + }, + { + label: i18n.translate('visTypeTimeseries.units.perHour', { defaultMessage: 'per hour' }), + value: '1h', + }, + { + label: i18n.translate('visTypeTimeseries.units.perDay', { defaultMessage: 'per day' }), + value: '1d', + }, +]; + +export const PositiveRateAgg = props => { + const defaults = { unit: '' }; + const model = { ...defaults, ...props.model }; + + const handleChange = createChangeHandler(props.onChange, model); + const handleSelectChange = createSelectHandler(handleChange); + + const htmlId = htmlIdGenerator(); + const indexPattern = + (props.series.override_index_pattern && props.series.series_index_pattern) || + props.panel.index_pattern; + + const selectedUnitOptions = UNIT_OPTIONS.filter(o => o.value === model.unit); + + return ( + + + + + + + + + + + + } + fullWidth + > + + + + + + } + fullWidth + > + + + + + + +

+ + + + ), + }} + /> +

+ + + ); +}; + +PositiveRateAgg.propTypes = { + disableDelete: PropTypes.bool, + fields: PropTypes.object, + model: PropTypes.object, + onAdd: PropTypes.func, + onChange: PropTypes.func, + onDelete: PropTypes.func, + panel: PropTypes.object, + series: PropTypes.object, + siblings: PropTypes.array, +}; diff --git a/src/legacy/core_plugins/vis_type_timeseries/public/components/lib/agg_to_component.js b/src/legacy/core_plugins/vis_type_timeseries/public/components/lib/agg_to_component.js index ca40d60f20848..a53192afafdcc 100644 --- a/src/legacy/core_plugins/vis_type_timeseries/public/components/lib/agg_to_component.js +++ b/src/legacy/core_plugins/vis_type_timeseries/public/components/lib/agg_to_component.js @@ -33,6 +33,7 @@ import { PercentileRankAgg } from '../aggs/percentile_rank'; import { Static } from '../aggs/static'; import { MathAgg } from '../aggs/math'; import { TopHitAgg } from '../aggs/top_hit'; +import { PositiveRateAgg } from '../aggs/positive_rate'; export const aggToComponent = { count: StandardAgg, @@ -65,4 +66,5 @@ export const aggToComponent = { static: Static, math: MathAgg, top_hit: TopHitAgg, + positive_rate: PositiveRateAgg, }; diff --git a/src/plugins/vis_type_timeseries/common/agg_lookup.js b/src/plugins/vis_type_timeseries/common/agg_lookup.js index 4dfdc83dcfabb..432da03e3d45d 100644 --- a/src/plugins/vis_type_timeseries/common/agg_lookup.js +++ b/src/plugins/vis_type_timeseries/common/agg_lookup.js @@ -97,6 +97,9 @@ export const lookup = { defaultMessage: 'Static Value', }), top_hit: i18n.translate('visTypeTimeseries.aggLookup.topHitLabel', { defaultMessage: 'Top Hit' }), + positive_rate: i18n.translate('visTypeTimeseries.aggLookup.positiveRateLabel', { + defaultMessage: 'Positive Rate', + }), }; const pipeline = [ diff --git a/src/plugins/vis_type_timeseries/common/calculate_label.js b/src/plugins/vis_type_timeseries/common/calculate_label.js index 756d6e57a83e8..71aa0aed7dc11 100644 --- a/src/plugins/vis_type_timeseries/common/calculate_label.js +++ b/src/plugins/vis_type_timeseries/common/calculate_label.js @@ -70,6 +70,12 @@ export function calculateLabel(metric, metrics) { defaultMessage: 'Filter Ratio', }); } + if (metric.type === 'positive_rate') { + return i18n.translate('visTypeTimeseries.calculateLabel.positiveRateLabel', { + defaultMessage: 'Positive Rate of {field}', + values: { field: metric.field }, + }); + } if (metric.type === 'static') { return i18n.translate('visTypeTimeseries.calculateLabel.staticValueLabel', { defaultMessage: 'Static Value of {metricValue}', diff --git a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/index.js b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/index.js index 4b0b8f33716a2..c727a3131f5df 100644 --- a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/index.js +++ b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/index.js @@ -26,6 +26,7 @@ import { dateHistogram } from './date_histogram'; import { metricBuckets } from './metric_buckets'; import { siblingBuckets } from './sibling_buckets'; import { ratios as filterRatios } from './filter_ratios'; +import { positiveRate } from './positive_rate'; import { normalizeQuery } from './normalize_query'; export const processors = [ @@ -38,5 +39,6 @@ export const processors = [ metricBuckets, siblingBuckets, filterRatios, + positiveRate, normalizeQuery, ]; diff --git a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.js b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.js new file mode 100644 index 0000000000000..1ff548cc19e02 --- /dev/null +++ b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.js @@ -0,0 +1,68 @@ +/* + * 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. + */ + +import { getBucketSize } from '../../helpers/get_bucket_size'; +import { getIntervalAndTimefield } from '../../get_interval_and_timefield'; +import { bucketTransform } from '../../helpers/bucket_transform'; +import { set } from 'lodash'; + +export const filter = metric => metric.type === 'positive_rate'; + +export const createPositiveRate = (doc, intervalString, aggRoot) => metric => { + const maxFn = bucketTransform.max; + const derivativeFn = bucketTransform.derivative; + const positiveOnlyFn = bucketTransform.positive_only; + + const maxMetric = { id: `${metric.id}-positive-rate-max`, type: 'max', field: metric.field }; + const derivativeMetric = { + id: `${metric.id}-positive-rate-derivative`, + type: 'derivative', + field: `${metric.id}-positive-rate-max`, + unit: metric.unit, + }; + const positiveOnlyMetric = { + id: metric.id, + type: 'positive_only', + field: `${metric.id}-positive-rate-derivative`, + }; + + const fakeSeriesMetrics = [maxMetric, derivativeMetric, positiveOnlyMetric]; + + const maxBucket = maxFn(maxMetric, fakeSeriesMetrics, intervalString); + const derivativeBucket = derivativeFn(derivativeMetric, fakeSeriesMetrics, intervalString); + const positiveOnlyBucket = positiveOnlyFn(positiveOnlyMetric, fakeSeriesMetrics, intervalString); + + set(doc, `${aggRoot}.timeseries.aggs.${metric.id}-positive-rate-max`, maxBucket); + set(doc, `${aggRoot}.timeseries.aggs.${metric.id}-positive-rate-derivative`, derivativeBucket); + set(doc, `${aggRoot}.timeseries.aggs.${metric.id}`, positiveOnlyBucket); +}; + +export function positiveRate(req, panel, series, esQueryConfig, indexPatternObject, capabilities) { + return next => doc => { + const { interval } = getIntervalAndTimefield(panel, series, indexPatternObject); + const { intervalString } = getBucketSize(req, interval, capabilities); + if (series.metrics.some(filter)) { + series.metrics + .filter(filter) + .forEach(createPositiveRate(doc, intervalString, `aggs.${series.id}.aggs`)); + return next(doc); + } + return next(doc); + }; +} diff --git a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.test.js b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.test.js new file mode 100644 index 0000000000000..946884c05c722 --- /dev/null +++ b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/series/positive_rate.test.js @@ -0,0 +1,95 @@ +/* + * 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. + */ + +import { positiveRate } from './positive_rate'; +describe('positiveRate(req, panel, series)', () => { + let panel; + let series; + let req; + beforeEach(() => { + panel = { + time_field: 'timestamp', + }; + series = { + id: 'test', + split_mode: 'terms', + terms_size: 10, + terms_field: 'host', + metrics: [ + { + id: 'metric-1', + type: 'positive_rate', + field: 'system.network.out.bytes', + unit: '1s', + }, + ], + }; + req = { + payload: { + timerange: { + min: '2017-01-01T00:00:00Z', + max: '2017-01-01T01:00:00Z', + }, + }, + }; + }); + + test('calls next when finished', () => { + const next = jest.fn(); + positiveRate(req, panel, series)(next)({}); + expect(next.mock.calls.length).toEqual(1); + }); + + test('returns positive rate aggs', () => { + const next = doc => doc; + const doc = positiveRate(req, panel, series)(next)({}); + expect(doc).toEqual({ + aggs: { + test: { + aggs: { + timeseries: { + aggs: { + 'metric-1-positive-rate-max': { + max: { field: 'system.network.out.bytes' }, + }, + 'metric-1-positive-rate-derivative': { + derivative: { + buckets_path: 'metric-1-positive-rate-max', + gap_policy: 'skip', + unit: '1s', + }, + }, + 'metric-1': { + bucket_script: { + buckets_path: { value: 'metric-1-positive-rate-derivative[normalized_value]' }, + script: { + source: 'params.value > 0.0 ? params.value : 0.0', + lang: 'painless', + }, + gap_policy: 'skip', + }, + }, + }, + }, + }, + }, + }, + }); + }); +}); diff --git a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/index.js b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/index.js index a62533ae7a37c..5864d2538005d 100644 --- a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/index.js +++ b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/index.js @@ -26,6 +26,7 @@ import { metricBuckets } from './metric_buckets'; import { siblingBuckets } from './sibling_buckets'; import { ratios as filterRatios } from './filter_ratios'; import { normalizeQuery } from './normalize_query'; +import { positiveRate } from './positive_rate'; export const processors = [ query, @@ -36,5 +37,6 @@ export const processors = [ metricBuckets, siblingBuckets, filterRatios, + positiveRate, normalizeQuery, ]; diff --git a/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/positive_rate.js b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/positive_rate.js new file mode 100644 index 0000000000000..da4b834822d70 --- /dev/null +++ b/src/plugins/vis_type_timeseries/server/lib/vis_data/request_processors/table/positive_rate.js @@ -0,0 +1,35 @@ +/* + * 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. + */ + +import { getBucketSize } from '../../helpers/get_bucket_size'; +import { getIntervalAndTimefield } from '../../get_interval_and_timefield'; +import { calculateAggRoot } from './calculate_agg_root'; +import { createPositiveRate, filter } from '../series/positive_rate'; + +export function positiveRate(req, panel, esQueryConfig, indexPatternObject) { + return next => doc => { + const { interval } = getIntervalAndTimefield(panel, {}, indexPatternObject); + const { intervalString } = getBucketSize(req, interval); + panel.series.forEach(column => { + const aggRoot = calculateAggRoot(doc, column); + column.metrics.filter(filter).forEach(createPositiveRate(doc, intervalString, aggRoot)); + }); + return next(doc); + }; +} From b8738b0eebf7a7ad708b5f498dcc51f6a7fb2c87 Mon Sep 17 00:00:00 2001 From: Brian Seeders Date: Thu, 9 Apr 2020 15:05:09 -0400 Subject: [PATCH 015/102] Ensure that discover data exists for home/_navigation test so that the test suite can run in isolation (#62516) --- test/functional/apps/home/_navigation.ts | 1 + 1 file changed, 1 insertion(+) diff --git a/test/functional/apps/home/_navigation.ts b/test/functional/apps/home/_navigation.ts index efc0dad394464..2c927e9a2f4c7 100644 --- a/test/functional/apps/home/_navigation.ts +++ b/test/functional/apps/home/_navigation.ts @@ -52,6 +52,7 @@ export default function({ getService, getPageObjects }: FtrProviderContext) { describe('Kibana browser back navigation should work', function describeIndexTests() { before(async () => { + await esArchiver.loadIfNeeded('discover'); await esArchiver.loadIfNeeded('logstash_functional'); if (browser.isInternetExplorer) { await kibanaServer.uiSettings.replace({ 'state:storeInSessionStorage': false }); From e61680571acce5b6bb8be8d9f6e574864c49f290 Mon Sep 17 00:00:00 2001 From: Brian Seeders Date: Thu, 9 Apr 2020 15:05:21 -0400 Subject: [PATCH 016/102] Ensure alerting action exists in connectors test setup (#62511) --- .../apps/triggers_actions_ui/connectors.ts | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts b/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts index c2013ba3502e2..b5bcd33c3b9ab 100644 --- a/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts +++ b/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts @@ -13,12 +13,20 @@ function generateUniqueKey() { } export default ({ getPageObjects, getService }: FtrProviderContext) => { + const alerting = getService('alerting'); const testSubjects = getService('testSubjects'); const pageObjects = getPageObjects(['common', 'triggersActionsUI', 'header']); const find = getService('find'); describe('Connectors', function() { before(async () => { + await alerting.actions.createAction({ + name: `server-log-${Date.now()}`, + actionTypeId: '.server-log', + config: {}, + secrets: {}, + }); + await pageObjects.common.navigateToApp('triggersActions'); await testSubjects.click('connectorsTab'); }); From 783e3c17a9ed32d6a5aff39a83bdfa38aa152bf1 Mon Sep 17 00:00:00 2001 From: Tim Schnell Date: Thu, 9 Apr 2020 14:32:24 -0500 Subject: [PATCH 017/102] ignore some things for code coverage (#62701) Co-authored-by: Elastic Machine --- x-pack/legacy/plugins/canvas/scripts/jest.js | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/x-pack/legacy/plugins/canvas/scripts/jest.js b/x-pack/legacy/plugins/canvas/scripts/jest.js index cce1b8d355846..133f775c7192f 100644 --- a/x-pack/legacy/plugins/canvas/scripts/jest.js +++ b/x-pack/legacy/plugins/canvas/scripts/jest.js @@ -36,6 +36,14 @@ run( `!${path}/**/__tests__/**/*`, '--collectCoverageFrom', // Ignore coverage on example files `!${path}/**/__examples__/**/*`, + '--collectCoverageFrom', // Ignore flot files + `!${path}/**/flot-charts/**`, + '--collectCoverageFrom', // Ignore coverage files + `!${path}/**/coverage/**`, + '--collectCoverageFrom', // Ignore scripts + `!${path}/**/scripts/**`, + '--collectCoverageFrom', // Ignore mock files + `!${path}/**/mocks/**`, '--collectCoverageFrom', // Include JS files `${path}/**/*.js`, '--collectCoverageFrom', // Include TS/X files @@ -76,7 +84,7 @@ run( --all Runs all tests and snapshots. Slower. --storybook Runs Storybook Snapshot tests only. --update Updates Storybook Snapshot tests. - --path Runs any tests at a given path. + --path Runs any tests at a given path. --coverage Collect coverage statistics. `, }, From 834306458ac5178cbe26a0f962c764a0451568e2 Mon Sep 17 00:00:00 2001 From: Frank Hassanabad Date: Thu, 9 Apr 2020 13:52:02 -0600 Subject: [PATCH 018/102] Fixes a needed import that was coming from APM but now isolates things better for optimization import builds ## Summary Adds a single line to work with ts config optimizers. What is happening is that this is relying on an import from here: ``` x-pack/legacy/plugins/apm/public/utils/testHelpers.tsx ``` when really it should be isolated and imported within this file. Testing is just to go to siem and run these commands: ```ts cd /projects/kibana node x-pack/legacy/plugins/siem/scripts/optimize_tsconfig.js node scripts/type_check.js --project x-pack/tsconfig.json ``` Ensure you don't see any errors. --- .../public/application/components/health_check.test.tsx | 1 + 1 file changed, 1 insertion(+) diff --git a/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx b/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx index 5156a6146f3a1..9c51139993b3f 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx @@ -10,6 +10,7 @@ import { HealthCheck } from './health_check'; import { act } from 'react-dom/test-utils'; import { httpServiceMock } from '../../../../../../src/core/public/mocks'; +import '@testing-library/jest-dom/extend-expect'; const docLinks = { ELASTIC_WEBSITE_URL: 'elastic.co/', DOC_LINK_VERSION: 'current' }; From bc8c4a754db653762fe50a7bfc9bee7f9006e20c Mon Sep 17 00:00:00 2001 From: Aaron Caldwell Date: Thu, 9 Apr 2020 15:43:07 -0600 Subject: [PATCH 019/102] [File upload] Change 'file_upload' id and refs to 'fileUpload' (#63000) --- x-pack/plugins/file_upload/kibana.json | 3 +-- x-pack/plugins/maps/public/plugin.ts | 4 ++-- 2 files changed, 3 insertions(+), 4 deletions(-) diff --git a/x-pack/plugins/file_upload/kibana.json b/x-pack/plugins/file_upload/kibana.json index 3fda32fb6ebe5..7676a01d0b0f9 100644 --- a/x-pack/plugins/file_upload/kibana.json +++ b/x-pack/plugins/file_upload/kibana.json @@ -1,8 +1,7 @@ { - "id": "file_upload", + "id": "fileUpload", "version": "8.0.0", "kibanaVersion": "kibana", - "configPath": ["xpack", "file_upload"], "server": true, "ui": true, "requiredPlugins": ["data", "usageCollection"] diff --git a/x-pack/plugins/maps/public/plugin.ts b/x-pack/plugins/maps/public/plugin.ts index 9437c2512ded4..14487b615e759 100644 --- a/x-pack/plugins/maps/public/plugin.ts +++ b/x-pack/plugins/maps/public/plugin.ts @@ -43,9 +43,9 @@ export const bindSetupCoreAndPlugins = (core: CoreSetup, plugins: any) => { }; export const bindStartCoreAndPlugins = (core: CoreStart, plugins: any) => { - const { file_upload, data, inspector } = plugins; + const { fileUpload, data, inspector } = plugins; setInspector(inspector); - setFileUpload(file_upload); + setFileUpload(fileUpload); setIndexPatternSelect(data.ui.IndexPatternSelect); setTimeFilter(data.query.timefilter.timefilter); setIndexPatternService(data.indexPatterns); From 93b34632c08884e7850114f1fe21adfb47471c22 Mon Sep 17 00:00:00 2001 From: Marco Vettorello Date: Thu, 9 Apr 2020 23:53:47 +0200 Subject: [PATCH 020/102] [TSVB] Fix wrongly display stacked as percentage charts (#62654) Update to elastic-charts 18.2.2 with the valid 0% rendering --- package.json | 2 +- packages/kbn-ui-shared-deps/package.json | 2 +- yarn.lock | 8 ++++---- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/package.json b/package.json index bd0fec3a5c116..ea930d07e7b43 100644 --- a/package.json +++ b/package.json @@ -119,7 +119,7 @@ "@babel/core": "^7.9.0", "@babel/register": "^7.9.0", "@elastic/apm-rum": "^4.6.0", - "@elastic/charts": "^18.1.1", + "@elastic/charts": "18.2.2", "@elastic/datemath": "5.0.3", "@elastic/ems-client": "7.8.0", "@elastic/eui": "21.0.1", diff --git a/packages/kbn-ui-shared-deps/package.json b/packages/kbn-ui-shared-deps/package.json index e2823f23d0431..7c5d6a62a11ca 100644 --- a/packages/kbn-ui-shared-deps/package.json +++ b/packages/kbn-ui-shared-deps/package.json @@ -9,7 +9,7 @@ "kbn:watch": "node scripts/build --watch" }, "dependencies": { - "@elastic/charts": "^18.1.1", + "@elastic/charts": "18.2.2", "@elastic/eui": "21.0.1", "@kbn/i18n": "1.0.0", "abortcontroller-polyfill": "^1.4.0", diff --git a/yarn.lock b/yarn.lock index 3f04b2d26a013..20e33fdefc996 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1197,10 +1197,10 @@ dependencies: "@elastic/apm-rum-core" "^4.7.0" -"@elastic/charts@^18.1.1": - version "18.2.0" - resolved "https://registry.yarnpkg.com/@elastic/charts/-/charts-18.2.0.tgz#e141151b4d7ecc71c9f6f235f8ce141665c67195" - integrity sha512-OWsARaHI/4Ict/GkeKIO3a+e2c86esGw3FtSGRLPFVgzpwBXdjvjYyraGntKOIVs/NAGNVWYj5XoRRb5C6cMlQ== +"@elastic/charts@18.2.2": + version "18.2.2" + resolved "https://registry.yarnpkg.com/@elastic/charts/-/charts-18.2.2.tgz#f59d6ee597d553d193314d8598561c65da787e8d" + integrity sha512-ss8AqLj9wHa2C+9ULUKbXw8ZCQmEjLuaVU5AkqE2j3hOVtAN75HO2p7nMIsxcSldfmqy+4jSptybJLNAfizegQ== dependencies: classnames "^2.2.6" d3-array "^1.2.4" From 982c0da78e67694e0c2e05e8e2e7431ab9bda880 Mon Sep 17 00:00:00 2001 From: CJ Cenizal Date: Thu, 9 Apr 2020 16:51:22 -0700 Subject: [PATCH 021/102] Move ILM out of legacy (#61915) * Rename IndexMgmtSetup to IndexManagementPluginSetup. * Remove unused fetch index template route and related tests. * Remove unnecessary custom styles. --- .github/CODEOWNERS | 2 +- x-pack/.i18nrc.json | 2 +- x-pack/index.js | 2 - .../np_ready/extend_index_management.ts | 4 +- .../public/np_ready/plugin.ts | 4 +- .../server/np_ready/plugin.ts | 4 +- .../index_lifecycle_management/index.ts | 62 -------- .../index_lifecycle_management/plugin.ts | 54 ------- .../public/legacy.ts | 109 ------------- .../_index_lifecycle_management.scss | 17 -- .../public/np_ready/application/index.scss | 3 - .../public/np_ready/application/index.tsx | 63 -------- .../np_ready/application/services/api.js | 81 ---------- .../public/np_ready/plugin.tsx | 58 ------- .../call_with_request_factory.ts | 19 --- .../lib/call_with_request_factory/index.ts | 7 - .../check_license/__tests__/check_license.js | 145 ------------------ .../server/lib/check_license/check_license.ts | 66 -------- .../__tests__/wrap_custom_error.js | 21 --- .../error_wrappers/__tests__/wrap_es_error.js | 38 ----- .../__tests__/wrap_unknown_error.js | 19 --- .../server/lib/error_wrappers/index.ts | 9 -- .../lib/error_wrappers/wrap_custom_error.ts | 18 --- .../lib/error_wrappers/wrap_es_error.ts | 29 ---- .../lib/error_wrappers/wrap_unknown_error.ts | 17 -- .../server/lib/is_es_error/index.ts | 7 - .../__tests__/license_pre_routing_factory.js | 69 --------- .../license_pre_routing_factory.ts | 29 ---- .../lib/register_license_checker/index.ts | 7 - .../register_license_checker.ts | 23 --- .../server/routes/api/index/index.ts | 7 - .../api/index/register_add_policy_route.ts | 58 ------- .../routes/api/index/register_remove_route.ts | 51 ------ .../routes/api/index/register_retry_route.ts | 51 ------ .../server/routes/api/nodes/constants.ts | 15 -- .../server/routes/api/nodes/index.ts | 7 - .../api/nodes/register_details_route.ts | 61 -------- .../routes/api/nodes/register_list_route.ts | 63 -------- .../server/routes/api/policies/index.ts | 7 - .../api/policies/register_create_route.ts | 52 ------- .../api/policies/register_delete_route.ts | 46 ------ .../api/policies/register_fetch_route.ts | 84 ---------- .../server/routes/api/templates/index.ts | 7 - .../templates/register_add_policy_route.ts | 67 -------- .../api/templates/register_get_route.ts | 48 ------ .../index_lifecycle_management/shim.ts | 17 -- .../legacy/plugins/index_management/index.ts | 1 + x-pack/legacy/plugins/rollup/public/plugin.ts | 4 +- x-pack/legacy/plugins/rollup/server/plugin.ts | 4 +- .../extend_index_management.test.js.snap | 0 .../__snapshots__/policy_table.test.js.snap | 0 .../__jest__/components/edit_policy.test.js | 20 ++- .../__jest__/components/policy_table.test.js | 16 +- .../__jest__/extend_index_management.test.js | 17 +- .../common/constants/index.ts | 6 + .../index_lifecycle_management/kibana.json | 16 ++ .../public}/application/app.tsx | 2 +- .../public}/application/constants/index.ts | 0 .../application/constants/ui_metric.ts | 0 .../public/application/index.tsx | 27 ++++ .../sections/components/active_badge.js | 0 .../application/sections/components/index.js | 0 .../sections/components/learn_more_link.js | 0 .../sections/components/optional_label.js | 0 .../components/phase_error_message.js | 0 .../cold_phase/cold_phase.container.js | 0 .../components/cold_phase/cold_phase.js | 0 .../components/cold_phase/index.js | 0 .../delete_phase/delete_phase.container.js | 0 .../components/delete_phase/delete_phase.js | 0 .../components/delete_phase/index.js | 0 .../hot_phase/hot_phase.container.js | 0 .../components/hot_phase/hot_phase.js | 0 .../edit_policy/components/hot_phase/index.js | 0 .../edit_policy/components/min_age_input.js | 0 .../components/node_allocation/index.js | 0 .../node_allocation.container.js | 0 .../node_allocation/node_allocation.js | 0 .../components/node_attrs_details/index.js | 0 .../node_attrs_details.container.js | 0 .../node_attrs_details/node_attrs_details.js | 0 .../components/policy_json_flyout.js | 0 .../components/set_priority_input.js | 0 .../components/warm_phase/index.js | 0 .../warm_phase/warm_phase.container.js | 0 .../components/warm_phase/warm_phase.js | 0 .../edit_policy/edit_policy.container.js | 0 .../sections/edit_policy/edit_policy.js | 0 .../sections/edit_policy/form_errors.js | 0 .../sections/edit_policy/index.d.ts | 0 .../application/sections/edit_policy/index.js | 0 .../no_match/components/no_match/index.js | 0 .../no_match/components/no_match/no_match.js | 0 .../policy_table/components/no_match/index.js | 0 .../add_policy_to_template_confirm_modal.js | 0 .../components/policy_table/confirm_delete.js | 0 .../components/policy_table/index.js | 0 .../policy_table/policy_table.container.js | 0 .../components/policy_table/policy_table.js | 8 +- .../sections/policy_table/index.d.ts | 0 .../sections/policy_table/index.js | 0 .../public/application/services/api.js | 72 +++++++++ .../application/services/api_errors.js | 0 .../application/services/documentation.ts | 0 .../application/services/filter_items.js | 0 .../application/services/find_errors.js | 0 .../services/flatten_panel_tree.js | 0 .../public}/application/services/http.ts | 14 +- .../public}/application/services/index.js | 0 .../application/services/navigation.ts | 12 +- .../application/services/notification.ts | 0 .../application/services/sort_table.js | 0 .../application/services/ui_metric.test.js | 0 .../public}/application/services/ui_metric.ts | 11 +- .../application/store/actions/general.js | 0 .../application/store/actions/index.js | 0 .../application/store/actions/lifecycle.js | 0 .../application/store/actions/nodes.js | 0 .../application/store/actions/policies.js | 0 .../application/store/defaults/cold_phase.js | 0 .../store/defaults/delete_phase.js | 0 .../application/store/defaults/hot_phase.js | 0 .../application/store/defaults/index.d.ts | 0 .../application/store/defaults/index.js | 0 .../application/store/defaults/warm_phase.js | 0 .../public}/application/store/index.d.ts | 0 .../public}/application/store/index.js | 0 .../application/store/reducers/general.js | 0 .../application/store/reducers/index.js | 0 .../application/store/reducers/nodes.js | 0 .../application/store/reducers/policies.js | 0 .../application/store/selectors/general.js | 0 .../application/store/selectors/index.js | 0 .../application/store/selectors/lifecycle.js | 0 .../application/store/selectors/nodes.js | 0 .../application/store/selectors/policies.js | 0 .../public}/application/store/store.js | 0 .../components/add_lifecycle_confirm_modal.js | 6 +- .../components/index_lifecycle_summary.js | 0 .../remove_lifecycle_confirm_modal.js | 4 +- .../extend_index_management/index.d.ts | 0 .../public}/extend_index_management/index.js | 50 +----- .../public}/index.ts | 8 +- .../public/plugin.tsx | 69 +++++++++ .../public/types.ts | 21 +++ .../server/config.ts | 18 +++ .../server/index.ts | 19 +++ .../server/lib}/is_es_error.ts | 0 .../server/plugin.ts | 86 +++++++++++ .../server/routes/api/index/index.ts} | 9 +- .../api/index/register_add_policy_route.ts | 66 ++++++++ .../routes/api/index/register_remove_route.ts | 54 +++++++ .../routes/api/index/register_retry_route.ts | 54 +++++++ .../server/routes/api/nodes/index.ts} | 7 +- .../api/nodes/register_details_route.ts | 64 ++++++++ .../routes/api/nodes/register_list_route.ts | 69 +++++++++ .../server/routes/api/policies/index.ts} | 9 +- .../api/policies/register_create_route.ts | 145 ++++++++++++++++++ .../api/policies/register_delete_route.ts | 50 ++++++ .../api/policies/register_fetch_route.ts | 90 +++++++++++ .../server/routes/api/templates/index.ts} | 9 +- .../templates/register_add_policy_route.ts | 81 ++++++++++ .../api/templates/register_fetch_route.ts | 51 +++--- .../server/routes/index.ts | 19 +++ .../server/services/add_base_path.ts} | 4 +- .../server/services}/index.ts | 3 +- .../server/services/license.ts | 82 ++++++++++ .../server/types.ts | 27 ++++ .../index_actions_context_menu.js | 15 +- .../plugins/index_management/public/index.ts | 4 +- .../plugins/index_management/public/plugin.ts | 4 +- .../plugins/index_management/server/index.ts | 2 +- .../plugins/index_management/server/plugin.ts | 6 +- .../translations/translations/ja-JP.json | 3 - .../translations/translations/zh-CN.json | 3 - .../templates.helpers.js | 3 - .../index_lifecycle_management/templates.js | 19 +-- 177 files changed, 1264 insertions(+), 1828 deletions(-) delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/plugin.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/public/legacy.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/_index_lifecycle_management.scss delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.scss delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.tsx delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/api.js delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/plugin.tsx delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/call_with_request_factory.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/__tests__/check_license.js delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/check_license.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_custom_error.js delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_es_error.js delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_unknown_error.js delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_custom_error.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_es_error.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_unknown_error.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/is_es_error/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/license_pre_routing_factory.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/register_license_checker.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/constants.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/index.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_get_route.ts delete mode 100644 x-pack/legacy/plugins/index_lifecycle_management/shim.ts rename x-pack/{legacy => }/plugins/index_lifecycle_management/__jest__/__snapshots__/extend_index_management.test.js.snap (100%) rename x-pack/{legacy => }/plugins/index_lifecycle_management/__jest__/components/__snapshots__/policy_table.test.js.snap (100%) rename x-pack/{legacy => }/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js (96%) rename x-pack/{legacy => }/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js (91%) rename x-pack/{legacy => }/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js (93%) rename x-pack/{legacy => }/plugins/index_lifecycle_management/common/constants/index.ts (72%) create mode 100644 x-pack/plugins/index_lifecycle_management/kibana.json rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/app.tsx (94%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/constants/index.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/constants/ui_metric.ts (100%) create mode 100644 x-pack/plugins/index_lifecycle_management/public/application/index.tsx rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/components/active_badge.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/components/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/components/learn_more_link.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/components/optional_label.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/components/phase_error_message.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/cold_phase/cold_phase.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/cold_phase/cold_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/cold_phase/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/delete_phase/delete_phase.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/delete_phase/delete_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/delete_phase/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/hot_phase/hot_phase.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/hot_phase/hot_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/hot_phase/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/min_age_input.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/node_allocation/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/node_allocation/node_allocation.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/node_allocation/node_allocation.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/node_attrs_details/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/policy_json_flyout.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/set_priority_input.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/warm_phase/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/warm_phase/warm_phase.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/components/warm_phase/warm_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/edit_policy.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/edit_policy.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/form_errors.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/index.d.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/edit_policy/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/no_match/components/no_match/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/no_match/components/no_match/no_match.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/no_match/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/policy_table/add_policy_to_template_confirm_modal.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/policy_table/confirm_delete.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/policy_table/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/policy_table/policy_table.container.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/components/policy_table/policy_table.js (98%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/index.d.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/sections/policy_table/index.js (100%) create mode 100644 x-pack/plugins/index_lifecycle_management/public/application/services/api.js rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/api_errors.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/documentation.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/filter_items.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/find_errors.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/flatten_panel_tree.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/http.ts (50%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/navigation.ts (59%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/notification.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/sort_table.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/ui_metric.test.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/services/ui_metric.ts (85%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/actions/general.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/actions/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/actions/lifecycle.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/actions/nodes.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/actions/policies.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/defaults/cold_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/defaults/delete_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/defaults/hot_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/defaults/index.d.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/defaults/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/defaults/warm_phase.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/index.d.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/reducers/general.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/reducers/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/reducers/nodes.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/reducers/policies.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/selectors/general.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/selectors/index.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/selectors/lifecycle.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/selectors/nodes.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/selectors/policies.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/application/store/store.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/extend_index_management/components/add_lifecycle_confirm_modal.js (97%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/extend_index_management/components/index_lifecycle_summary.js (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/extend_index_management/components/remove_lifecycle_confirm_modal.js (96%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/extend_index_management/index.d.ts (100%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/extend_index_management/index.js (80%) rename x-pack/{legacy/plugins/index_lifecycle_management/public/np_ready => plugins/index_lifecycle_management/public}/index.ts (58%) create mode 100644 x-pack/plugins/index_lifecycle_management/public/plugin.tsx create mode 100644 x-pack/plugins/index_lifecycle_management/public/types.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/config.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/index.ts rename x-pack/{legacy/plugins/index_lifecycle_management/server/lib/is_es_error => plugins/index_lifecycle_management/server/lib}/is_es_error.ts (100%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/plugin.ts rename x-pack/{legacy/plugins/index_lifecycle_management/server/routes/api/index/register_index_routes.ts => plugins/index_lifecycle_management/server/routes/api/index/index.ts} (65%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts rename x-pack/{legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_nodes_routes.ts => plugins/index_lifecycle_management/server/routes/api/nodes/index.ts} (65%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts rename x-pack/{legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_policies_routes.ts => plugins/index_lifecycle_management/server/routes/api/policies/index.ts} (64%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts rename x-pack/{legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_templates_routes.ts => plugins/index_lifecycle_management/server/routes/api/templates/index.ts} (64%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts rename x-pack/{legacy => }/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts (63%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/routes/index.ts rename x-pack/{legacy/plugins/index_lifecycle_management/server/lib/check_license/index.ts => plugins/index_lifecycle_management/server/services/add_base_path.ts} (64%) rename x-pack/{legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory => plugins/index_lifecycle_management/server/services}/index.ts (74%) create mode 100644 x-pack/plugins/index_lifecycle_management/server/services/license.ts create mode 100644 x-pack/plugins/index_lifecycle_management/server/types.ts diff --git a/.github/CODEOWNERS b/.github/CODEOWNERS index e707250ff3261..267f3dde0b66f 100644 --- a/.github/CODEOWNERS +++ b/.github/CODEOWNERS @@ -180,7 +180,7 @@ /src/plugins/console/ @elastic/es-ui /src/plugins/es_ui_shared/ @elastic/es-ui /x-pack/legacy/plugins/cross_cluster_replication/ @elastic/es-ui -/x-pack/legacy/plugins/index_lifecycle_management/ @elastic/es-ui +/x-pack/plugins/index_lifecycle_management/ @elastic/es-ui /x-pack/legacy/plugins/index_management/ @elastic/es-ui /x-pack/legacy/plugins/license_management/ @elastic/es-ui /x-pack/legacy/plugins/rollup/ @elastic/es-ui diff --git a/x-pack/.i18nrc.json b/x-pack/.i18nrc.json index ae8d61769b14c..bbbcc062786b0 100644 --- a/x-pack/.i18nrc.json +++ b/x-pack/.i18nrc.json @@ -18,7 +18,7 @@ "xpack.graph": ["legacy/plugins/graph", "plugins/graph"], "xpack.grokDebugger": "plugins/grokdebugger", "xpack.idxMgmt": "plugins/index_management", - "xpack.indexLifecycleMgmt": "legacy/plugins/index_lifecycle_management", + "xpack.indexLifecycleMgmt": "plugins/index_lifecycle_management", "xpack.infra": "plugins/infra", "xpack.ingestManager": "plugins/ingest_manager", "xpack.lens": "legacy/plugins/lens", diff --git a/x-pack/index.js b/x-pack/index.js index 6fab13d726fa6..3126dc17a7107 100644 --- a/x-pack/index.js +++ b/x-pack/index.js @@ -16,7 +16,6 @@ import { beats } from './legacy/plugins/beats_management'; import { apm } from './legacy/plugins/apm'; import { maps } from './legacy/plugins/maps'; import { indexManagement } from './legacy/plugins/index_management'; -import { indexLifecycleManagement } from './legacy/plugins/index_lifecycle_management'; import { spaces } from './legacy/plugins/spaces'; import { canvas } from './legacy/plugins/canvas'; import { infra } from './legacy/plugins/infra'; @@ -50,7 +49,6 @@ module.exports = function(kibana) { maps(kibana), canvas(kibana), indexManagement(kibana), - indexLifecycleManagement(kibana), infra(kibana), taskManager(kibana), rollup(kibana), diff --git a/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/extend_index_management.ts b/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/extend_index_management.ts index 01c6250383fb8..4ffe0db4e3c4e 100644 --- a/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/extend_index_management.ts +++ b/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/extend_index_management.ts @@ -6,7 +6,7 @@ import { i18n } from '@kbn/i18n'; import { get } from 'lodash'; -import { IndexMgmtSetup } from '../../../../../plugins/index_management/public'; +import { IndexManagementPluginSetup } from '../../../../../plugins/index_management/public'; const propertyPath = 'isFollowerIndex'; @@ -21,7 +21,7 @@ const followerBadgeExtension = { filterExpression: 'isFollowerIndex:true', }; -export const extendIndexManagement = (indexManagement?: IndexMgmtSetup) => { +export const extendIndexManagement = (indexManagement?: IndexManagementPluginSetup) => { if (indexManagement) { indexManagement.extensionsService.addBadge(followerBadgeExtension); } diff --git a/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/plugin.ts b/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/plugin.ts index f7651cbb210a7..46259c698b282 100644 --- a/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/plugin.ts +++ b/x-pack/legacy/plugins/cross_cluster_replication/public/np_ready/plugin.ts @@ -11,7 +11,7 @@ import { DocLinksStart, } from 'src/core/public'; -import { IndexMgmtSetup } from '../../../../../plugins/index_management/public'; +import { IndexManagementPluginSetup } from '../../../../../plugins/index_management/public'; // @ts-ignore; import { setHttpClient } from './app/services/api'; @@ -21,7 +21,7 @@ import { setNotifications } from './app/services/notifications'; import { extendIndexManagement } from './extend_index_management'; interface PluginDependencies { - indexManagement: IndexMgmtSetup; + indexManagement: IndexManagementPluginSetup; __LEGACY: { chrome: any; MANAGEMENT_BREADCRUMB: ChromeBreadcrumb; diff --git a/x-pack/legacy/plugins/cross_cluster_replication/server/np_ready/plugin.ts b/x-pack/legacy/plugins/cross_cluster_replication/server/np_ready/plugin.ts index 1012c07af3d2a..829de10ad0177 100644 --- a/x-pack/legacy/plugins/cross_cluster_replication/server/np_ready/plugin.ts +++ b/x-pack/legacy/plugins/cross_cluster_replication/server/np_ready/plugin.ts @@ -6,7 +6,7 @@ import { Plugin, PluginInitializerContext, CoreSetup } from 'src/core/server'; -import { IndexMgmtSetup } from '../../../../../plugins/index_management/server'; +import { IndexManagementPluginSetup } from '../../../../../plugins/index_management/server'; // @ts-ignore import { registerLicenseChecker } from './lib/register_license_checker'; @@ -15,7 +15,7 @@ import { registerRoutes } from './routes/register_routes'; import { ccrDataEnricher } from './cross_cluster_replication_data'; interface PluginDependencies { - indexManagement: IndexMgmtSetup; + indexManagement: IndexManagementPluginSetup; __LEGACY: { server: any; ccrUIEnabled: boolean; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/index.ts deleted file mode 100644 index 9b14b7143bf44..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/index.ts +++ /dev/null @@ -1,62 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { Legacy } from 'kibana'; -import { resolve } from 'path'; -import { PLUGIN } from './common/constants'; -import { Plugin as IndexLifecycleManagementPlugin } from './plugin'; -import { createShim } from './shim'; - -export function indexLifecycleManagement(kibana: any) { - return new kibana.Plugin({ - id: PLUGIN.ID, - configPrefix: 'xpack.ilm', - publicDir: resolve(__dirname, 'public'), - require: ['kibana', 'elasticsearch', 'xpack_main', 'index_management'], - uiExports: { - styleSheetPaths: resolve(__dirname, 'public/np_ready/application/index.scss'), - managementSections: ['plugins/index_lifecycle_management/legacy'], - injectDefaultVars(server: Legacy.Server) { - const config = server.config(); - return { - ilmUiEnabled: config.get('xpack.ilm.ui.enabled'), - }; - }, - }, - config: (Joi: any) => { - return Joi.object({ - // display menu item - ui: Joi.object({ - enabled: Joi.boolean().default(true), - }).default(), - - // enable plugin - enabled: Joi.boolean().default(true), - - filteredNodeAttributes: Joi.array() - .items(Joi.string()) - .default([]), - }).default(); - }, - isEnabled(config: any) { - return ( - config.get('xpack.ilm.enabled') && - config.has('xpack.index_management.enabled') && - config.get('xpack.index_management.enabled') - ); - }, - init(server: Legacy.Server) { - const core = server.newPlatform.setup.core; - const plugins = {}; - const __LEGACY = createShim(server); - - const indexLifecycleManagementPlugin = new IndexLifecycleManagementPlugin(); - - // Set up plugin. - indexLifecycleManagementPlugin.setup(core, plugins, __LEGACY); - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/plugin.ts b/x-pack/legacy/plugins/index_lifecycle_management/plugin.ts deleted file mode 100644 index 38d1bea45ce07..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/plugin.ts +++ /dev/null @@ -1,54 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { CoreSetup } from 'kibana/server'; -import { LegacySetup } from './shim'; -import { registerLicenseChecker } from './server/lib/register_license_checker'; -import { registerIndexRoutes } from './server/routes/api/index'; -import { registerNodesRoutes } from './server/routes/api/nodes'; -import { registerPoliciesRoutes } from './server/routes/api/policies'; -import { registerTemplatesRoutes } from './server/routes/api/templates'; - -const indexLifecycleDataEnricher = async (indicesList: any, callWithRequest: any) => { - if (!indicesList || !indicesList.length) { - return; - } - const params = { - path: '/*/_ilm/explain', - method: 'GET', - }; - const { indices: ilmIndicesData } = await callWithRequest('transport.request', params); - return indicesList.map((index: any): any => { - return { - ...index, - ilm: { ...(ilmIndicesData[index.name] || {}) }, - }; - }); -}; - -export class Plugin { - public setup(core: CoreSetup, plugins: any, __LEGACY: LegacySetup): void { - const { server } = __LEGACY; - - registerLicenseChecker(server); - - // Register routes. - registerIndexRoutes(server); - registerNodesRoutes(server); - registerPoliciesRoutes(server); - registerTemplatesRoutes(server); - - const serverPlugins = server.newPlatform.setup.plugins as any; - - if ( - server.config().get('xpack.ilm.ui.enabled') && - serverPlugins.indexManagement && - serverPlugins.indexManagement.indexDataEnricher - ) { - serverPlugins.indexManagement.indexDataEnricher.add(indexLifecycleDataEnricher); - } - } -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/legacy.ts b/x-pack/legacy/plugins/index_lifecycle_management/public/legacy.ts deleted file mode 100644 index 006e5f6098f2b..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/legacy.ts +++ /dev/null @@ -1,109 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { App } from 'src/core/public'; - -/* Legacy Imports */ -import { npSetup, npStart } from 'ui/new_platform'; -import chrome from 'ui/chrome'; -import routes from 'ui/routes'; -import { management } from 'ui/management'; -import { createUiStatsReporter } from '../../../../../src/legacy/core_plugins/ui_metric/public'; - -import { PLUGIN, BASE_PATH } from '../common/constants'; -import { createPlugin } from './np_ready'; -import { addAllExtensions } from './np_ready/extend_index_management'; - -if (chrome.getInjected('ilmUiEnabled')) { - // We have to initialize this outside of the NP lifecycle, otherwise these extensions won't - // be available in Index Management unless the user visits ILM first. - if ((npSetup.plugins as any).indexManagement) { - addAllExtensions((npSetup.plugins as any).indexManagement.extensionsService); - } - - // This method handles the cleanup needed when route is scope is destroyed. It also prevents Angular - // from destroying scope when route changes and both old route and new route are this same route. - const manageAngularLifecycle = ($scope: any, $route: any, unmount: () => void) => { - const lastRoute = $route.current; - const deregister = $scope.$on('$locationChangeSuccess', () => { - const currentRoute = $route.current; - // if templates are the same we are on the same route - if (lastRoute.$$route.template === currentRoute.$$route.template) { - // this prevents angular from destroying scope - $route.current = lastRoute; - } - }); - $scope.$on('$destroy', () => { - if (deregister) { - deregister(); - } - unmount(); - }); - }; - - // Once this app no longer depends upon Angular's routing (e.g. for the "redirect" service), we can - // use the Management plugin's API to register this app within the Elasticsearch section. - const esSection = management.getSection('elasticsearch'); - esSection.register('index_lifecycle_policies', { - visible: true, - display: PLUGIN.TITLE, - order: 2, - url: `#${BASE_PATH}policies`, - }); - - const REACT_ROOT_ID = 'indexLifecycleManagementReactRoot'; - - const template = ` -
- - `; - - routes.when(`${BASE_PATH}:view?/:action?/:id?`, { - template, - controllerAs: 'indexLifecycleManagement', - controller: class IndexLifecycleManagementController { - constructor($scope: any, $route: any, kbnUrl: any, $rootScope: any) { - $scope.$$postDigest(() => { - const element = document.getElementById(REACT_ROOT_ID)!; - const { core } = npSetup; - - const coreDependencies = { - ...core, - application: { - ...core.application, - async register(app: App) { - const unmountApp = await app.mount({ ...npStart } as any, { - element, - appBasePath: '', - onAppLeave: () => undefined, - // TODO: adapt to use Core's ScopedHistory - history: {} as any, - }); - manageAngularLifecycle($scope, $route, unmountApp as any); - }, - }, - }; - - // The Plugin interface won't allow us to pass __LEGACY as a third argument, so we'll just - // sneak it inside of the plugins argument for now. - const pluginDependencies = { - __LEGACY: { - redirect: (path: string) => { - $scope.$evalAsync(() => { - kbnUrl.redirect(path); - }); - }, - createUiStatsReporter, - }, - }; - - const plugin = createPlugin({} as any); - plugin.setup(coreDependencies, pluginDependencies); - }); - } - } as any, - } as any); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/_index_lifecycle_management.scss b/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/_index_lifecycle_management.scss deleted file mode 100644 index 96c6d1a938c61..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/_index_lifecycle_management.scss +++ /dev/null @@ -1,17 +0,0 @@ -.policyTable__horizontalScrollContainer { - overflow-x: auto; - max-width: 100%; -} - -.policyTable__horizontalScroll { - min-width: 800px; - width: 100%; -} - -.policyTable__link { - font-weight: 400; -} - -.ilmEditPolicyPageContent { - max-width: 1200px !important; -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.scss b/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.scss deleted file mode 100644 index 53e90e2aae35b..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.scss +++ /dev/null @@ -1,3 +0,0 @@ -// Import the EUI global scope so we can use EUI constants -@import 'src/legacy/ui/public/styles/_styling_constants'; -@import 'index_lifecycle_management'; \ No newline at end of file diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.tsx b/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.tsx deleted file mode 100644 index b87a633d65c9c..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/index.tsx +++ /dev/null @@ -1,63 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React from 'react'; -import { render, unmountComponentAtNode } from 'react-dom'; -import { Provider } from 'react-redux'; -import { DocLinksStart, ToastsSetup, HttpSetup, FatalErrorsSetup } from 'src/core/public'; - -import { App } from './app'; -import { indexLifecycleManagementStore } from './store'; -import { init as initHttp } from './services/http'; -import { init as initNavigation } from './services/navigation'; -import { init as initDocumentation } from './services/documentation'; -import { init as initUiMetric } from './services/ui_metric'; -import { init as initNotification } from './services/notification'; - -export interface LegacySetup { - redirect: any; - createUiStatsReporter: any; -} - -interface AppDependencies { - legacy: LegacySetup; - I18nContext: any; - http: HttpSetup; - toasts: ToastsSetup; - fatalErrors: FatalErrorsSetup; - docLinks: DocLinksStart; - element: HTMLElement; -} - -export const renderApp = (appDependencies: AppDependencies) => { - const { - legacy: { redirect, createUiStatsReporter }, - I18nContext, - http, - toasts, - fatalErrors, - docLinks: { ELASTIC_WEBSITE_URL, DOC_LINK_VERSION }, - element, - } = appDependencies; - - // Initialize services - initHttp(http); - initNavigation(redirect); - initDocumentation(`${ELASTIC_WEBSITE_URL}guide/en/elasticsearch/reference/${DOC_LINK_VERSION}/`); - initUiMetric(createUiStatsReporter); - initNotification(toasts, fatalErrors); - - render( - - - - - , - element - ); - - return () => unmountComponentAtNode(element); -}; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/api.js b/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/api.js deleted file mode 100644 index f13bbcb6162b8..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/api.js +++ /dev/null @@ -1,81 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { - UIM_POLICY_DELETE, - UIM_POLICY_ATTACH_INDEX, - UIM_POLICY_ATTACH_INDEX_TEMPLATE, - UIM_POLICY_DETACH_INDEX, - UIM_INDEX_RETRY_STEP, -} from '../constants'; - -import { trackUiMetric } from './ui_metric'; -import { sendGet, sendPost, sendDelete } from './http'; - -// The extend_index_management module that we support an injected httpClient here. - -export async function loadNodes(httpClient) { - return await sendGet(`nodes/list`, httpClient); -} - -export async function loadNodeDetails(selectedNodeAttrs, httpClient) { - return await sendGet(`nodes/${selectedNodeAttrs}/details`, httpClient); -} - -export async function loadIndexTemplates(httpClient) { - return await sendGet(`templates`, httpClient); -} - -export async function loadIndexTemplate(templateName, httpClient) { - if (!templateName) { - return {}; - } - return await sendGet(`templates/${templateName}`, httpClient); -} - -export async function loadPolicies(withIndices, httpClient) { - const query = withIndices ? '?withIndices=true' : ''; - return await sendGet('policies', query, httpClient); -} - -export async function savePolicy(policy, httpClient) { - return await sendPost(`policies`, policy, httpClient); -} - -export async function deletePolicy(policyName, httpClient) { - const response = await sendDelete(`policies/${encodeURIComponent(policyName)}`, httpClient); - // Only track successful actions. - trackUiMetric('count', UIM_POLICY_DELETE); - return response; -} - -export const retryLifecycleForIndex = async (indexNames, httpClient) => { - const response = await sendPost(`index/retry`, { indexNames }, httpClient); - // Only track successful actions. - trackUiMetric('count', UIM_INDEX_RETRY_STEP); - return response; -}; - -export const removeLifecycleForIndex = async (indexNames, httpClient) => { - const response = await sendPost(`index/remove`, { indexNames }, httpClient); - // Only track successful actions. - trackUiMetric('count', UIM_POLICY_DETACH_INDEX); - return response; -}; - -export const addLifecyclePolicyToIndex = async (body, httpClient) => { - const response = await sendPost(`index/add`, body, httpClient); - // Only track successful actions. - trackUiMetric('count', UIM_POLICY_ATTACH_INDEX); - return response; -}; - -export const addLifecyclePolicyToTemplate = async (body, httpClient) => { - const response = await sendPost(`template`, body, httpClient); - // Only track successful actions. - trackUiMetric('count', UIM_POLICY_ATTACH_INDEX_TEMPLATE); - return response; -}; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/plugin.tsx b/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/plugin.tsx deleted file mode 100644 index e2897f09fa892..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/plugin.tsx +++ /dev/null @@ -1,58 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { CoreSetup, CoreStart, Plugin } from 'src/core/public'; -import { PLUGIN } from '../../common/constants'; -import { LegacySetup } from './application'; - -interface PluginsSetup { - __LEGACY: LegacySetup; -} - -export class IndexLifecycleManagementPlugin implements Plugin { - setup(core: CoreSetup, plugins: PluginsSetup) { - // Extract individual core dependencies. - const { - application, - notifications: { toasts }, - fatalErrors, - http, - } = core; - - // The Plugin interface won't allow us to pass __LEGACY as a third argument, so we'll just - // sneak it inside of the plugins parameter for now. - const { __LEGACY } = plugins; - - application.register({ - id: PLUGIN.ID, - title: PLUGIN.TITLE, - async mount(config, mountPoint) { - const { - core: { - docLinks, - i18n: { Context: I18nContext }, - }, - } = config; - - const { element } = mountPoint; - const { renderApp } = await import('./application'); - - // Inject all dependencies into our app. - return renderApp({ - legacy: { ...__LEGACY }, - I18nContext, - http, - toasts, - fatalErrors, - docLinks, - element, - }); - }, - }); - } - start(core: CoreStart, plugins: any) {} - stop() {} -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/call_with_request_factory.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/call_with_request_factory.ts deleted file mode 100644 index 1b28dc4fde4f7..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/call_with_request_factory.ts +++ /dev/null @@ -1,19 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { once } from 'lodash'; -import { Legacy } from 'kibana'; - -const callWithRequest = once((server: Legacy.Server): any => { - const cluster = server.plugins.elasticsearch.getCluster('data'); - return cluster.callWithRequest; -}); - -export const callWithRequestFactory = (server: Legacy.Server, request: any) => { - return (...args: any[]) => { - return callWithRequest(server)(request, ...args); - }; -}; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/index.ts deleted file mode 100644 index 787814d87dff9..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/call_with_request_factory/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { callWithRequestFactory } from './call_with_request_factory'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/__tests__/check_license.js b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/__tests__/check_license.js deleted file mode 100644 index 933fda01c055d..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/__tests__/check_license.js +++ /dev/null @@ -1,145 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { set } from 'lodash'; -import { checkLicense } from '../check_license'; - -describe('check_license', function() { - let mockLicenseInfo; - beforeEach(() => (mockLicenseInfo = {})); - - describe('license information is undefined', () => { - beforeEach(() => (mockLicenseInfo = undefined)); - - it('should set isAvailable to false', () => { - expect(checkLicense(mockLicenseInfo).isAvailable).to.be(false); - }); - - it('should set showLinks to true', () => { - expect(checkLicense(mockLicenseInfo).showLinks).to.be(true); - }); - - it('should set enableLinks to false', () => { - expect(checkLicense(mockLicenseInfo).enableLinks).to.be(false); - }); - - it('should set a message', () => { - expect(checkLicense(mockLicenseInfo).message).to.not.be(undefined); - }); - }); - - describe('license information is not available', () => { - beforeEach(() => (mockLicenseInfo.isAvailable = () => false)); - - it('should set isAvailable to false', () => { - expect(checkLicense(mockLicenseInfo).isAvailable).to.be(false); - }); - - it('should set showLinks to true', () => { - expect(checkLicense(mockLicenseInfo).showLinks).to.be(true); - }); - - it('should set enableLinks to false', () => { - expect(checkLicense(mockLicenseInfo).enableLinks).to.be(false); - }); - - it('should set a message', () => { - expect(checkLicense(mockLicenseInfo).message).to.not.be(undefined); - }); - }); - - describe('license information is available', () => { - beforeEach(() => { - mockLicenseInfo.isAvailable = () => true; - set(mockLicenseInfo, 'license.getType', () => 'basic'); - }); - - describe('& license is > basic', () => { - beforeEach(() => set(mockLicenseInfo, 'license.isOneOf', () => true)); - - describe('& license is active', () => { - beforeEach(() => set(mockLicenseInfo, 'license.isActive', () => true)); - - it('should set isAvailable to true', () => { - expect(checkLicense(mockLicenseInfo).isAvailable).to.be(true); - }); - - it('should set showLinks to true', () => { - expect(checkLicense(mockLicenseInfo).showLinks).to.be(true); - }); - - it('should set enableLinks to true', () => { - expect(checkLicense(mockLicenseInfo).enableLinks).to.be(true); - }); - - it('should not set a message', () => { - expect(checkLicense(mockLicenseInfo).message).to.be(undefined); - }); - }); - - describe('& license is expired', () => { - beforeEach(() => set(mockLicenseInfo, 'license.isActive', () => false)); - - it('should set isAvailable to false', () => { - expect(checkLicense(mockLicenseInfo).isAvailable).to.be(false); - }); - - it('should set showLinks to true', () => { - expect(checkLicense(mockLicenseInfo).showLinks).to.be(true); - }); - - it('should set enableLinks to false', () => { - expect(checkLicense(mockLicenseInfo).enableLinks).to.be(false); - }); - - it('should set a message', () => { - expect(checkLicense(mockLicenseInfo).message).to.not.be(undefined); - }); - }); - }); - - describe('& license is basic', () => { - beforeEach(() => set(mockLicenseInfo, 'license.isOneOf', () => true)); - - describe('& license is active', () => { - beforeEach(() => set(mockLicenseInfo, 'license.isActive', () => true)); - - it('should set isAvailable to true', () => { - expect(checkLicense(mockLicenseInfo).isAvailable).to.be(true); - }); - - it('should set showLinks to true', () => { - expect(checkLicense(mockLicenseInfo).showLinks).to.be(true); - }); - - it('should set enableLinks to true', () => { - expect(checkLicense(mockLicenseInfo).enableLinks).to.be(true); - }); - - it('should not set a message', () => { - expect(checkLicense(mockLicenseInfo).message).to.be(undefined); - }); - }); - - describe('& license is expired', () => { - beforeEach(() => set(mockLicenseInfo, 'license.isActive', () => false)); - - it('should set isAvailable to false', () => { - expect(checkLicense(mockLicenseInfo).isAvailable).to.be(false); - }); - - it('should set showLinks to true', () => { - expect(checkLicense(mockLicenseInfo).showLinks).to.be(true); - }); - - it('should set a message', () => { - expect(checkLicense(mockLicenseInfo).message).to.not.be(undefined); - }); - }); - }); - }); -}); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/check_license.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/check_license.ts deleted file mode 100644 index b35ab14964d55..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/check_license.ts +++ /dev/null @@ -1,66 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { i18n } from '@kbn/i18n'; - -export function checkLicense(xpackLicenseInfo: any): any { - const pluginName = 'Index Lifecycle Policies'; - - // If, for some reason, we cannot get the license information - // from Elasticsearch, assume worst case and disable - if (!xpackLicenseInfo || !xpackLicenseInfo.isAvailable()) { - return { - isAvailable: false, - showLinks: true, - enableLinks: false, - message: i18n.translate('xpack.indexLifecycleMgmt.checkLicense.errorUnavailableMessage', { - defaultMessage: - 'You cannot use {pluginName} because license information is not available at this time.', - values: { pluginName }, - }), - }; - } - - const VALID_LICENSE_MODES = ['basic', 'standard', 'gold', 'platinum', 'enterprise', 'trial']; - - const isLicenseModeValid = xpackLicenseInfo.license.isOneOf(VALID_LICENSE_MODES); - const isLicenseActive = xpackLicenseInfo.license.isActive(); - const licenseType = xpackLicenseInfo.license.getType(); - - // License is not valid - if (!isLicenseModeValid) { - return { - isAvailable: false, - showLinks: false, - message: i18n.translate('xpack.indexLifecycleMgmt.checkLicense.errorUnsupportedMessage', { - defaultMessage: - 'Your {licenseType} license does not support {pluginName}. Please upgrade your license.', - values: { licenseType, pluginName }, - }), - }; - } - - // License is valid but not active - if (!isLicenseActive) { - return { - isAvailable: false, - showLinks: true, - enableLinks: false, - message: i18n.translate('xpack.indexLifecycleMgmt.checkLicense.errorExpiredMessage', { - defaultMessage: - 'You cannot use {pluginName} because your {licenseType} license has expired.', - values: { pluginName, licenseType }, - }), - }; - } - - // License is valid and active - return { - isAvailable: true, - showLinks: true, - enableLinks: true, - }; -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_custom_error.js b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_custom_error.js deleted file mode 100644 index f9c102be7a1ff..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_custom_error.js +++ /dev/null @@ -1,21 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { wrapCustomError } from '../wrap_custom_error'; - -describe('wrap_custom_error', () => { - describe('#wrapCustomError', () => { - it('should return a Boom object', () => { - const originalError = new Error('I am an error'); - const statusCode = 404; - const wrappedError = wrapCustomError(originalError, statusCode); - - expect(wrappedError.isBoom).to.be(true); - expect(wrappedError.output.statusCode).to.equal(statusCode); - }); - }); -}); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_es_error.js b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_es_error.js deleted file mode 100644 index fe2b6cce652f1..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_es_error.js +++ /dev/null @@ -1,38 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { wrapEsError } from '../wrap_es_error'; - -describe('wrap_es_error', () => { - describe('#wrapEsError', () => { - let originalError; - beforeEach(() => { - originalError = new Error('I am an error'); - originalError.statusCode = 404; - }); - - it('should return a Boom object', () => { - const wrappedError = wrapEsError(originalError); - - expect(wrappedError.isBoom).to.be(true); - }); - - it('should return the correct Boom object', () => { - const wrappedError = wrapEsError(originalError); - - expect(wrappedError.output.statusCode).to.be(originalError.statusCode); - expect(wrappedError.output.payload.message).to.be(originalError.message); - }); - - it('should return the correct Boom object with custom message', () => { - const wrappedError = wrapEsError(originalError, { 404: 'No encontrado!' }); - - expect(wrappedError.output.statusCode).to.be(originalError.statusCode); - expect(wrappedError.output.payload.message).to.be('No encontrado!'); - }); - }); -}); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_unknown_error.js b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_unknown_error.js deleted file mode 100644 index 85e0b2b3033ad..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/__tests__/wrap_unknown_error.js +++ /dev/null @@ -1,19 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { wrapUnknownError } from '../wrap_unknown_error'; - -describe('wrap_unknown_error', () => { - describe('#wrapUnknownError', () => { - it('should return a Boom object', () => { - const originalError = new Error('I am an error'); - const wrappedError = wrapUnknownError(originalError); - - expect(wrappedError.isBoom).to.be(true); - }); - }); -}); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/index.ts deleted file mode 100644 index f275f15637091..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/index.ts +++ /dev/null @@ -1,9 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { wrapCustomError } from './wrap_custom_error'; -export { wrapEsError } from './wrap_es_error'; -export { wrapUnknownError } from './wrap_unknown_error'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_custom_error.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_custom_error.ts deleted file mode 100644 index c5780e7c83fb5..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_custom_error.ts +++ /dev/null @@ -1,18 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; - -/** - * Wraps a custom error into a Boom error response and returns it - * - * @param err Object error - * @param statusCode Error status code - * @return Object Boom error response - */ -export function wrapCustomError(err: any, statusCode: any): any { - return Boom.boomify(err, { statusCode }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_es_error.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_es_error.ts deleted file mode 100644 index 6980a5afa5eac..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_es_error.ts +++ /dev/null @@ -1,29 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; - -/** - * Wraps an error thrown by the ES JS client into a Boom error response and returns it - * - * @param err Object Error thrown by ES JS client - * @param statusCodeToMessageMap Object Optional map of HTTP status codes => error messages - * @return Object Boom error response - */ -export function wrapEsError(err: any, statusCodeToMessageMap: any = {}): any { - const statusCode = err.statusCode; - - // If no custom message if specified for the error's status code, just - // wrap the error as a Boom error response and return it - if (!statusCodeToMessageMap[statusCode]) { - return Boom.boomify(err, { statusCode }); - } - - // Otherwise, use the custom message to create a Boom error response and - // return it - const message = statusCodeToMessageMap[statusCode]; - return new Boom(message, { statusCode }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_unknown_error.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_unknown_error.ts deleted file mode 100644 index ede1baec286f3..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/error_wrappers/wrap_unknown_error.ts +++ /dev/null @@ -1,17 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; - -/** - * Wraps an unknown error into a Boom error response and returns it - * - * @param err Object Unknown error - * @return Object Boom error response - */ -export function wrapUnknownError(err: any): any { - return Boom.boomify(err); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/is_es_error/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/is_es_error/index.ts deleted file mode 100644 index a9a3c61472d8c..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/is_es_error/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { isEsError } from './is_es_error'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js deleted file mode 100644 index 4d3b33f8b3af3..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js +++ /dev/null @@ -1,69 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { licensePreRoutingFactory } from '../license_pre_routing_factory'; - -describe('license_pre_routing_factory', () => { - describe('#reportingFeaturePreRoutingFactory', () => { - let mockServer; - let mockLicenseCheckResults; - - beforeEach(() => { - mockServer = { - plugins: { - xpack_main: { - info: { - feature: () => ({ - getLicenseCheckResults: () => mockLicenseCheckResults, - }), - }, - }, - }, - }; - }); - - it('only instantiates one instance per server', () => { - const firstInstance = licensePreRoutingFactory(mockServer); - const secondInstance = licensePreRoutingFactory(mockServer); - - expect(firstInstance).to.be(secondInstance); - }); - - describe('isAvailable is false', () => { - beforeEach(() => { - mockLicenseCheckResults = { - isAvailable: false, - }; - }); - - it('replies with 403', () => { - const licensePreRouting = licensePreRoutingFactory(mockServer); - const stubRequest = {}; - expect(() => licensePreRouting(stubRequest)).to.throwException(response => { - expect(response).to.be.an(Error); - expect(response.isBoom).to.be(true); - expect(response.output.statusCode).to.be(403); - }); - }); - }); - - describe('isAvailable is true', () => { - beforeEach(() => { - mockLicenseCheckResults = { - isAvailable: true, - }; - }); - - it('replies with nothing', () => { - const licensePreRouting = licensePreRoutingFactory(mockServer); - const stubRequest = {}; - const response = licensePreRouting(stubRequest); - expect(response).to.be(null); - }); - }); - }); -}); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/license_pre_routing_factory.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/license_pre_routing_factory.ts deleted file mode 100644 index e348125967c14..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/license_pre_routing_factory.ts +++ /dev/null @@ -1,29 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { once } from 'lodash'; -import { Legacy } from 'kibana'; - -import { PLUGIN } from '../../../common/constants'; -import { wrapCustomError } from '../error_wrappers'; - -export const licensePreRoutingFactory = once((server: Legacy.Server) => { - const xpackMainPlugin = server.plugins.xpack_main; - - // License checking and enable/disable logic - function licensePreRouting() { - const licenseCheckResults = xpackMainPlugin.info.feature(PLUGIN.ID).getLicenseCheckResults(); - if (!licenseCheckResults.isAvailable) { - const error = new Error(licenseCheckResults.message); - const statusCode = 403; - throw wrapCustomError(error, statusCode); - } - - return null; - } - - return licensePreRouting; -}); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/index.ts deleted file mode 100644 index 7b0f97c38d129..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerLicenseChecker } from './register_license_checker'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/register_license_checker.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/register_license_checker.ts deleted file mode 100644 index 8e3b89fa20e33..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/register_license_checker/register_license_checker.ts +++ /dev/null @@ -1,23 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { Legacy } from 'kibana'; -// @ts-ignore -import { mirrorPluginStatus } from '../../../../../server/lib/mirror_plugin_status'; -import { PLUGIN } from '../../../common/constants'; -import { checkLicense } from '../check_license'; - -export function registerLicenseChecker(server: Legacy.Server) { - const xpackMainPlugin = server.plugins.xpack_main as any; - const ilmPlugin = (server.plugins as any).index_lifecycle_management; - - mirrorPluginStatus(xpackMainPlugin, ilmPlugin); - xpackMainPlugin.status.once('green', () => { - // Register a function that is called whenever the xpack info changes, - // to re-compute the license check results for this plugin - xpackMainPlugin.info.feature(PLUGIN.ID).registerLicenseCheckResultsGenerator(checkLicense); - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/index.ts deleted file mode 100644 index 82fb2e3b2a372..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerIndexRoutes } from './register_index_routes'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts deleted file mode 100644 index c3e235220931c..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts +++ /dev/null @@ -1,58 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function addLifecyclePolicy( - callWithRequest: any, - indexName: string, - policyName: string, - alias: string -) { - const body = { - lifecycle: { - name: policyName, - rollover_alias: alias, - }, - }; - - const params = { - method: 'PUT', - path: `/${encodeURIComponent(indexName)}/_settings`, - body, - }; - - return callWithRequest('transport.request', params); -} - -export function registerAddPolicyRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/index/add', - method: 'POST', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - const { indexName, policyName, alias } = request.payload as any; - try { - const response = await addLifecyclePolicy(callWithRequest, indexName, policyName, alias); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts deleted file mode 100644 index ed3b5a97a3b42..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts +++ /dev/null @@ -1,51 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function removeLifecycle(callWithRequest: any, indexNames: string[]) { - const responses = []; - for (let i = 0; i < indexNames.length; i++) { - const indexName = indexNames[i]; - const params = { - method: 'POST', - path: `/${encodeURIComponent(indexName)}/_ilm/remove`, - ignore: [404], - }; - - responses.push(callWithRequest('transport.request', params)); - } - return Promise.all(responses); -} - -export function registerRemoveRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/index/remove', - method: 'POST', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - - try { - const response = await removeLifecycle(callWithRequest, request.payload.indexNames); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts deleted file mode 100644 index 89278edbecea2..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts +++ /dev/null @@ -1,51 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function retryLifecycle(callWithRequest: any, indexNames: string[]) { - const responses = []; - for (let i = 0; i < indexNames.length; i++) { - const indexName = indexNames[i]; - const params = { - method: 'POST', - path: `/${encodeURIComponent(indexName)}/_ilm/retry`, - ignore: [404], - }; - - responses.push(callWithRequest('transport.request', params)); - } - return Promise.all(responses); -} - -export function registerRetryRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/index/retry', - method: 'POST', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - - try { - const response = await retryLifecycle(callWithRequest, request.payload.indexNames); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/constants.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/constants.ts deleted file mode 100644 index 4392dacac8fa4..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/constants.ts +++ /dev/null @@ -1,15 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export const NODE_ATTRS_KEYS_TO_IGNORE: string[] = [ - 'ml.enabled', - 'ml.machine_memory', - 'ml.max_open_jobs', - // Used by ML to identify nodes that have transform enabled: - // https://github.com/elastic/elasticsearch/pull/52712/files#diff-225cc2c1291b4c60a8c3412a619094e1R147 - 'transform.node', - 'xpack.installed', -]; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts deleted file mode 100644 index ef0ac271ae60e..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerNodesRoutes } from './register_nodes_routes'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts deleted file mode 100644 index c2c3f8bf07028..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts +++ /dev/null @@ -1,61 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function findMatchingNodes(stats: any, nodeAttrs: string): any { - return Object.entries(stats.nodes).reduce((accum: any[], [nodeId, nodeStats]: [any, any]) => { - const attributes = nodeStats.attributes || {}; - for (const [key, value] of Object.entries(attributes)) { - if (`${key}:${value}` === nodeAttrs) { - accum.push({ - nodeId, - stats: nodeStats, - }); - break; - } - } - return accum; - }, []); -} - -async function fetchNodeStats(callWithRequest: any): Promise { - const params = { - format: 'json', - }; - - return await callWithRequest('nodes.stats', params); -} - -export function registerDetailsRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/nodes/{nodeAttrs}/details', - method: 'GET', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - - try { - const stats = await fetchNodeStats(callWithRequest); - const response = findMatchingNodes(stats, request.params.nodeAttrs); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts deleted file mode 100644 index edbe4289ed83c..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts +++ /dev/null @@ -1,63 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; -import { NODE_ATTRS_KEYS_TO_IGNORE } from './constants'; - -function convertStatsIntoList(stats: any, attributesToBeFiltered: string[]): any { - return Object.entries(stats.nodes).reduce((accum: any, [nodeId, nodeStats]: [any, any]) => { - const attributes = nodeStats.attributes || {}; - for (const [key, value] of Object.entries(attributes)) { - if (!attributesToBeFiltered.includes(key)) { - const attributeString = `${key}:${value}`; - accum[attributeString] = accum[attributeString] || []; - accum[attributeString].push(nodeId); - } - } - return accum; - }, {}); -} - -async function fetchNodeStats(callWithRequest: any): Promise { - const params = { - format: 'json', - }; - - return await callWithRequest('nodes.stats', params); -} - -export function registerListRoute(server: any) { - const config = server.config(); - const filteredNodeAttributes = config.get('xpack.ilm.filteredNodeAttributes'); - const attributesToBeFiltered = [...NODE_ATTRS_KEYS_TO_IGNORE, ...filteredNodeAttributes]; - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/nodes/list', - method: 'GET', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - - try { - const stats = await fetchNodeStats(callWithRequest); - const response = convertStatsIntoList(stats, attributesToBeFiltered); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/index.ts deleted file mode 100644 index 7c6103a3389ab..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerPoliciesRoutes } from './register_policies_routes'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts deleted file mode 100644 index f6bc96dd498a4..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts +++ /dev/null @@ -1,52 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function createPolicy(callWithRequest: any, policy: any): Promise { - const body = { - policy: { - phases: policy.phases, - }, - }; - const params = { - method: 'PUT', - path: `/_ilm/policy/${encodeURIComponent(policy.name)}`, - ignore: [404], - body, - }; - - return await callWithRequest('transport.request', params); -} - -export function registerCreateRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/policies', - method: 'POST', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - - try { - const response = await createPolicy(callWithRequest, request.payload); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts deleted file mode 100644 index c84f2efd92d8f..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts +++ /dev/null @@ -1,46 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function deletePolicies(policyNames: string, callWithRequest: any): Promise { - const params = { - method: 'DELETE', - path: `/_ilm/policy/${encodeURIComponent(policyNames)}`, - // we allow 404 since they may have no policies - ignore: [404], - }; - - return await callWithRequest('transport.request', params); -} - -export function registerDeleteRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/policies/{policyNames}', - method: 'DELETE', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - const { policyNames } = request.params; - try { - await deletePolicies(policyNames, callWithRequest); - return {}; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts deleted file mode 100644 index c65f849a47d87..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts +++ /dev/null @@ -1,84 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function formatPolicies(policiesMap: any): any { - if (policiesMap.status === 404) { - return []; - } - - return Object.keys(policiesMap).reduce((accum: any[], lifecycleName: string) => { - const policyEntry = policiesMap[lifecycleName]; - accum.push({ - ...policyEntry, - name: lifecycleName, - }); - return accum; - }, []); -} - -async function fetchPolicies(callWithRequest: any): Promise { - const params = { - method: 'GET', - path: '/_ilm/policy', - // we allow 404 since they may have no policies - ignore: [404], - }; - - return await callWithRequest('transport.request', params); -} -async function addLinkedIndices(policiesMap: any, callWithRequest: any) { - if (policiesMap.status === 404) { - return policiesMap; - } - const params = { - method: 'GET', - path: '/*/_ilm/explain', - // we allow 404 since they may have no policies - ignore: [404], - }; - - const policyExplanation: any = await callWithRequest('transport.request', params); - Object.entries(policyExplanation.indices).forEach(([indexName, { policy }]: [string, any]) => { - if (policy && policiesMap[policy]) { - policiesMap[policy].linkedIndices = policiesMap[policy].linkedIndices || []; - policiesMap[policy].linkedIndices.push(indexName); - } - }); -} - -export function registerFetchRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/policies', - method: 'GET', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - const { withIndices } = request.query; - try { - const policiesMap = await fetchPolicies(callWithRequest); - if (withIndices) { - await addLinkedIndices(policiesMap, callWithRequest); - } - return formatPolicies(policiesMap); - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/index.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/index.ts deleted file mode 100644 index dc9a0acaaf09b..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerTemplatesRoutes } from './register_templates_routes'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts deleted file mode 100644 index 57e5a91f60f5b..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts +++ /dev/null @@ -1,67 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { merge } from 'lodash'; - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function getIndexTemplate(callWithRequest: any, templateName: string): Promise { - const response = await callWithRequest('indices.getTemplate', { name: templateName }); - return response[templateName]; -} - -async function updateIndexTemplate(callWithRequest: any, indexTemplatePatch: any): Promise { - // Fetch existing template - const template = await getIndexTemplate(callWithRequest, indexTemplatePatch.templateName); - merge(template, { - settings: { - index: { - lifecycle: { - name: indexTemplatePatch.policyName, - rollover_alias: indexTemplatePatch.aliasName, - }, - }, - }, - }); - - const params = { - method: 'PUT', - path: `/_template/${encodeURIComponent(indexTemplatePatch.templateName)}`, - ignore: [404], - body: template, - }; - - return await callWithRequest('transport.request', params); -} - -export function registerAddPolicyRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/template', - method: 'POST', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - - try { - const response = await updateIndexTemplate(callWithRequest, request.payload); - return response; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_get_route.ts b/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_get_route.ts deleted file mode 100644 index 3edaea6e15818..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_get_route.ts +++ /dev/null @@ -1,48 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -async function fetchTemplate(callWithRequest: any, templateName: string): Promise { - const params = { - method: 'GET', - path: `/_template/${encodeURIComponent(templateName)}`, - // we allow 404 incase the user shutdown security in-between the check and now - ignore: [404], - }; - - return await callWithRequest('transport.request', params); -} - -export function registerGetRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/templates/{templateName}', - method: 'GET', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); - const templateName = request.params.templateName; - - try { - const template = await fetchTemplate(callWithRequest, templateName); - return template[templateName]; - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); - } - - return wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/shim.ts b/x-pack/legacy/plugins/index_lifecycle_management/shim.ts deleted file mode 100644 index 18b3d9ef28b6a..0000000000000 --- a/x-pack/legacy/plugins/index_lifecycle_management/shim.ts +++ /dev/null @@ -1,17 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { Legacy } from 'kibana'; - -export interface LegacySetup { - server: Legacy.Server; -} - -export function createShim(server: Legacy.Server): LegacySetup { - return { - server, - }; -} diff --git a/x-pack/legacy/plugins/index_management/index.ts b/x-pack/legacy/plugins/index_management/index.ts index 9eba98a526d2b..afca15203b970 100644 --- a/x-pack/legacy/plugins/index_management/index.ts +++ b/x-pack/legacy/plugins/index_management/index.ts @@ -4,6 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ +// TODO: Remove this once CCR is migrated to the plugins directory. export function indexManagement(kibana: any) { return new kibana.Plugin({ id: 'index_management', diff --git a/x-pack/legacy/plugins/rollup/public/plugin.ts b/x-pack/legacy/plugins/rollup/public/plugin.ts index 5782e88c3448b..17ec8a5a4aedf 100644 --- a/x-pack/legacy/plugins/rollup/public/plugin.ts +++ b/x-pack/legacy/plugins/rollup/public/plugin.ts @@ -24,7 +24,7 @@ import { // @ts-ignore import { CRUD_APP_BASE_PATH } from './crud_app/constants'; import { ManagementSetup } from '../../../../../src/plugins/management/public'; -import { IndexMgmtSetup } from '../../../../plugins/index_management/public'; +import { IndexManagementPluginSetup } from '../../../../plugins/index_management/public'; import { IndexPatternManagementSetup } from '../../../../../src/plugins/index_pattern_management/public'; import { search } from '../../../../../src/plugins/data/public'; // @ts-ignore @@ -35,7 +35,7 @@ import { renderApp } from './application'; export interface RollupPluginSetupDependencies { home?: HomePublicPluginSetup; management: ManagementSetup; - indexManagement?: IndexMgmtSetup; + indexManagement?: IndexManagementPluginSetup; indexPatternManagement: IndexPatternManagementSetup; } diff --git a/x-pack/legacy/plugins/rollup/server/plugin.ts b/x-pack/legacy/plugins/rollup/server/plugin.ts index 090cb8a47377a..5f29ad160e052 100644 --- a/x-pack/legacy/plugins/rollup/server/plugin.ts +++ b/x-pack/legacy/plugins/rollup/server/plugin.ts @@ -9,7 +9,7 @@ import { i18n } from '@kbn/i18n'; import { UsageCollectionSetup } from 'src/plugins/usage_collection/server'; import { VisTypeTimeseriesSetup } from 'src/plugins/vis_type_timeseries/server'; -import { IndexMgmtSetup } from '../../../../plugins/index_management/server'; +import { IndexManagementPluginSetup } from '../../../../plugins/index_management/server'; import { registerLicenseChecker } from '../../../server/lib/register_license_checker'; import { PLUGIN } from '../common'; import { ServerShim, RouteDependencies } from './types'; @@ -44,7 +44,7 @@ export class RollupsServerPlugin implements Plugin { __LEGACY: ServerShim; usageCollection?: UsageCollectionSetup; metrics?: VisTypeTimeseriesSetup; - indexManagement?: IndexMgmtSetup; + indexManagement?: IndexManagementPluginSetup; } ) { const elasticsearch = await elasticsearchService.adminClient; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/__snapshots__/extend_index_management.test.js.snap b/x-pack/plugins/index_lifecycle_management/__jest__/__snapshots__/extend_index_management.test.js.snap similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/__jest__/__snapshots__/extend_index_management.test.js.snap rename to x-pack/plugins/index_lifecycle_management/__jest__/__snapshots__/extend_index_management.test.js.snap diff --git a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/__snapshots__/policy_table.test.js.snap b/x-pack/plugins/index_lifecycle_management/__jest__/components/__snapshots__/policy_table.test.js.snap similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/__snapshots__/policy_table.test.js.snap rename to x-pack/plugins/index_lifecycle_management/__jest__/components/__snapshots__/policy_table.test.js.snap diff --git a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js b/x-pack/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js similarity index 96% rename from x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js rename to x-pack/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js index 9d143c4d3fc8e..bf4de823f1833 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js +++ b/x-pack/plugins/index_lifecycle_management/__jest__/components/edit_policy.test.js @@ -13,13 +13,13 @@ import axiosXhrAdapter from 'axios/lib/adapters/xhr'; import sinon from 'sinon'; import { findTestSubject } from '@elastic/eui/lib/test'; -import { mountWithIntl } from '../../../../../test_utils/enzyme_helpers'; -import { fetchedPolicies, fetchedNodes } from '../../public/np_ready/application/store/actions'; -import { indexLifecycleManagementStore } from '../../public/np_ready/application/store'; -import { EditPolicy } from '../../public/np_ready/application/sections/edit_policy'; -import { init as initHttp } from '../../public/np_ready/application/services/http'; -import { init as initUiMetric } from '../../public/np_ready/application/services/ui_metric'; -import { init as initNotification } from '../../public/np_ready/application/services/notification'; +import { mountWithIntl } from '../../../../test_utils/enzyme_helpers'; +import { fetchedPolicies, fetchedNodes } from '../../public/application/store/actions'; +import { indexLifecycleManagementStore } from '../../public/application/store'; +import { EditPolicy } from '../../public/application/sections/edit_policy'; +import { init as initHttp } from '../../public/application/services/http'; +import { init as initUiMetric } from '../../public/application/services/ui_metric'; +import { init as initNotification } from '../../public/application/services/notification'; import { positiveNumbersAboveZeroErrorMessage, positiveNumberRequiredMessage, @@ -33,16 +33,14 @@ import { policyNameMustBeDifferentErrorMessage, policyNameAlreadyUsedErrorMessage, maximumDocumentsRequiredMessage, -} from '../../public/np_ready/application/store/selectors/lifecycle'; +} from '../../public/application/store/selectors/lifecycle'; initHttp(axios.create({ adapter: axiosXhrAdapter }), path => path); -initUiMetric(() => () => {}); +initUiMetric({ reportUiStats: () => {} }); initNotification({ addDanger: () => {}, }); -jest.mock('ui/new_platform'); - let server; let store; const policy = { diff --git a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js b/x-pack/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js similarity index 91% rename from x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js rename to x-pack/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js index a3a9c5e59bfa4..78c5c181eea62 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js +++ b/x-pack/plugins/index_lifecycle_management/__jest__/components/policy_table.test.js @@ -12,17 +12,15 @@ import axiosXhrAdapter from 'axios/lib/adapters/xhr'; import sinon from 'sinon'; import { findTestSubject, takeMountedSnapshot } from '@elastic/eui/lib/test'; -import { mountWithIntl } from '../../../../../test_utils/enzyme_helpers'; -import { fetchedPolicies } from '../../public/np_ready/application/store/actions'; -import { indexLifecycleManagementStore } from '../../public/np_ready/application/store'; -import { PolicyTable } from '../../public/np_ready/application/sections/policy_table'; -import { init as initHttp } from '../../public/np_ready/application/services/http'; -import { init as initUiMetric } from '../../public/np_ready/application/services/ui_metric'; +import { mountWithIntl } from '../../../../test_utils/enzyme_helpers'; +import { fetchedPolicies } from '../../public/application/store/actions'; +import { indexLifecycleManagementStore } from '../../public/application/store'; +import { PolicyTable } from '../../public/application/sections/policy_table'; +import { init as initHttp } from '../../public/application/services/http'; +import { init as initUiMetric } from '../../public/application/services/ui_metric'; initHttp(axios.create({ adapter: axiosXhrAdapter }), path => path); -initUiMetric(() => () => {}); - -jest.mock('ui/new_platform'); +initUiMetric({ reportUiStats: () => {} }); let server = null; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js b/x-pack/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js similarity index 93% rename from x-pack/legacy/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js rename to x-pack/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js index d2619778617c3..900de27ca36ab 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js +++ b/x-pack/plugins/index_lifecycle_management/__jest__/extend_index_management.test.js @@ -8,7 +8,7 @@ import moment from 'moment-timezone'; import axios from 'axios'; import axiosXhrAdapter from 'axios/lib/adapters/xhr'; -import { mountWithIntl } from '../../../../test_utils/enzyme_helpers'; +import { mountWithIntl } from '../../../test_utils/enzyme_helpers'; import { retryLifecycleActionExtension, removeLifecyclePolicyActionExtension, @@ -16,21 +16,18 @@ import { ilmBannerExtension, ilmFilterExtension, ilmSummaryExtension, -} from '../public/np_ready/extend_index_management'; -import { init as initHttp } from '../public/np_ready/application/services/http'; -import { init as initUiMetric } from '../public/np_ready/application/services/ui_metric'; +} from '../public/extend_index_management'; +import { init as initHttp } from '../public/application/services/http'; +import { init as initUiMetric } from '../public/application/services/ui_metric'; // We need to init the http with a mock for any tests that depend upon the http service. // For example, add_lifecycle_confirm_modal makes an API request in its componentDidMount // lifecycle method. If we don't mock this, CI will fail with "Call retries were exceeded". initHttp(axios.create({ adapter: axiosXhrAdapter }), path => path); -initUiMetric(() => () => {}); +initUiMetric({ reportUiStats: () => {} }); -jest.mock('ui/new_platform'); -jest.mock('../../../../plugins/index_management/public', async () => { - const { indexManagementMock } = await import( - '../../../../plugins/index_management/public/mocks.ts' - ); +jest.mock('../../../plugins/index_management/public', async () => { + const { indexManagementMock } = await import('../../../plugins/index_management/public/mocks.ts'); return indexManagementMock.createSetup(); }); diff --git a/x-pack/legacy/plugins/index_lifecycle_management/common/constants/index.ts b/x-pack/plugins/index_lifecycle_management/common/constants/index.ts similarity index 72% rename from x-pack/legacy/plugins/index_lifecycle_management/common/constants/index.ts rename to x-pack/plugins/index_lifecycle_management/common/constants/index.ts index 9193efb561a0f..700039985eaf5 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/common/constants/index.ts +++ b/x-pack/plugins/index_lifecycle_management/common/constants/index.ts @@ -5,12 +5,18 @@ */ import { i18n } from '@kbn/i18n'; +import { LicenseType } from '../../../licensing/common/types'; + +const basicLicense: LicenseType = 'basic'; export const PLUGIN = { ID: 'index_lifecycle_management', + minimumLicenseType: basicLicense, TITLE: i18n.translate('xpack.indexLifecycleMgmt.appTitle', { defaultMessage: 'Index Lifecycle Policies', }), }; export const BASE_PATH = '/management/elasticsearch/index_lifecycle_management/'; + +export const API_BASE_PATH = '/api/index_lifecycle_management'; diff --git a/x-pack/plugins/index_lifecycle_management/kibana.json b/x-pack/plugins/index_lifecycle_management/kibana.json new file mode 100644 index 0000000000000..6385646b95789 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/kibana.json @@ -0,0 +1,16 @@ +{ + "id": "indexLifecycleManagement", + "version": "kibana", + "server": true, + "ui": true, + "requiredPlugins": [ + "home", + "licensing", + "management" + ], + "optionalPlugins": [ + "usageCollection", + "indexManagement" + ], + "configPath": ["xpack", "ilm"] +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/app.tsx b/x-pack/plugins/index_lifecycle_management/public/application/app.tsx similarity index 94% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/app.tsx rename to x-pack/plugins/index_lifecycle_management/public/application/app.tsx index 6738d7caa4444..993dced20bbe6 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/app.tsx +++ b/x-pack/plugins/index_lifecycle_management/public/application/app.tsx @@ -8,7 +8,7 @@ import React, { useEffect } from 'react'; import { HashRouter, Switch, Route, Redirect } from 'react-router-dom'; import { METRIC_TYPE } from '@kbn/analytics'; -import { BASE_PATH } from '../../../common/constants'; +import { BASE_PATH } from '../../common/constants'; import { UIM_APP_LOAD } from './constants'; import { EditPolicy } from './sections/edit_policy'; import { PolicyTable } from './sections/policy_table'; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/constants/index.ts b/x-pack/plugins/index_lifecycle_management/public/application/constants/index.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/constants/index.ts rename to x-pack/plugins/index_lifecycle_management/public/application/constants/index.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/constants/ui_metric.ts b/x-pack/plugins/index_lifecycle_management/public/application/constants/ui_metric.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/constants/ui_metric.ts rename to x-pack/plugins/index_lifecycle_management/public/application/constants/ui_metric.ts diff --git a/x-pack/plugins/index_lifecycle_management/public/application/index.tsx b/x-pack/plugins/index_lifecycle_management/public/application/index.tsx new file mode 100644 index 0000000000000..a7d88d31e58fc --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/public/application/index.tsx @@ -0,0 +1,27 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { render, unmountComponentAtNode } from 'react-dom'; +import { Provider } from 'react-redux'; +import { I18nStart } from 'kibana/public'; +import { UnmountCallback } from 'src/core/public'; + +import { App } from './app'; +import { indexLifecycleManagementStore } from './store'; + +export const renderApp = (element: Element, I18nContext: I18nStart['Context']): UnmountCallback => { + render( + + + + + , + element + ); + + return () => unmountComponentAtNode(element); +}; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/active_badge.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/components/active_badge.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/active_badge.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/components/active_badge.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/components/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/components/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/learn_more_link.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/components/learn_more_link.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/learn_more_link.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/components/learn_more_link.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/optional_label.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/components/optional_label.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/optional_label.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/components/optional_label.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/phase_error_message.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/components/phase_error_message.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/components/phase_error_message.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/components/phase_error_message.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/cold_phase/cold_phase.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/cold_phase/cold_phase.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/cold_phase/cold_phase.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/cold_phase/cold_phase.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/cold_phase/cold_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/cold_phase/cold_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/cold_phase/cold_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/cold_phase/cold_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/cold_phase/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/cold_phase/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/cold_phase/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/cold_phase/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/delete_phase/delete_phase.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/delete_phase/delete_phase.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/delete_phase/delete_phase.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/delete_phase/delete_phase.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/delete_phase/delete_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/delete_phase/delete_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/delete_phase/delete_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/delete_phase/delete_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/delete_phase/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/delete_phase/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/delete_phase/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/delete_phase/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/hot_phase/hot_phase.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/hot_phase/hot_phase.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/hot_phase/hot_phase.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/hot_phase/hot_phase.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/hot_phase/hot_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/hot_phase/hot_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/hot_phase/hot_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/hot_phase/hot_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/hot_phase/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/hot_phase/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/hot_phase/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/hot_phase/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/min_age_input.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/min_age_input.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/min_age_input.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/min_age_input.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_allocation/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_allocation/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_allocation/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_allocation/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_allocation/node_allocation.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_allocation/node_allocation.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_allocation/node_allocation.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_allocation/node_allocation.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_allocation/node_allocation.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_allocation/node_allocation.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_allocation/node_allocation.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_allocation/node_allocation.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_attrs_details/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_attrs_details/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_attrs_details/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_attrs_details/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/node_attrs_details/node_attrs_details.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/policy_json_flyout.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/policy_json_flyout.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/policy_json_flyout.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/policy_json_flyout.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/set_priority_input.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/set_priority_input.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/set_priority_input.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/set_priority_input.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/warm_phase/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/warm_phase/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/warm_phase/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/warm_phase/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/warm_phase/warm_phase.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/warm_phase/warm_phase.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/warm_phase/warm_phase.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/warm_phase/warm_phase.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/warm_phase/warm_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/warm_phase/warm_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/components/warm_phase/warm_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/components/warm_phase/warm_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/edit_policy.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/edit_policy.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/edit_policy.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/edit_policy.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/edit_policy.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/edit_policy.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/edit_policy.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/edit_policy.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/form_errors.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/form_errors.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/form_errors.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/form_errors.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/index.d.ts b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/index.d.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/index.d.ts rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/index.d.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/edit_policy/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/edit_policy/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/no_match/components/no_match/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/no_match/components/no_match/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/no_match/components/no_match/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/no_match/components/no_match/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/no_match/components/no_match/no_match.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/no_match/components/no_match/no_match.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/no_match/components/no_match/no_match.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/no_match/components/no_match/no_match.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/no_match/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/no_match/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/no_match/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/no_match/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/add_policy_to_template_confirm_modal.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/add_policy_to_template_confirm_modal.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/add_policy_to_template_confirm_modal.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/add_policy_to_template_confirm_modal.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/confirm_delete.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/confirm_delete.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/confirm_delete.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/confirm_delete.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/index.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/policy_table.container.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/policy_table.container.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/policy_table.container.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/policy_table.container.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/policy_table.js b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/policy_table.js similarity index 98% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/policy_table.js rename to x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/policy_table.js index 903161fe094fc..d406d86bc6ce7 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/sections/policy_table/components/policy_table/policy_table.js +++ b/x-pack/plugins/index_lifecycle_management/public/application/sections/policy_table/components/policy_table/policy_table.js @@ -37,8 +37,8 @@ import { import { RIGHT_ALIGNMENT } from '@elastic/eui/lib/services'; -import { getIndexListUri } from '../../../../../../../../../../plugins/index_management/public'; -import { BASE_PATH } from '../../../../../../../common/constants'; +import { getIndexListUri } from '../../../../../../../index_management/public'; +import { BASE_PATH } from '../../../../../../common/constants'; import { UIM_EDIT_CLICK } from '../../../../constants'; import { getPolicyPath } from '../../../../services/navigation'; import { flattenPanelTree } from '../../../../services/flatten_panel_tree'; @@ -52,6 +52,7 @@ const COLUMNS = { label: i18n.translate('xpack.indexLifecycleMgmt.policyTable.headers.nameHeader', { defaultMessage: 'Name', }), + width: 200, }, linkedIndices: { label: i18n.translate('xpack.indexLifecycleMgmt.policyTable.headers.linkedIndicesHeader', { @@ -179,7 +180,6 @@ export class PolicyTable extends Component { return ( /* eslint-disable-next-line @elastic/eui/href-or-on-click */ trackUiMetric('click', UIM_EDIT_CLICK)} @@ -415,7 +415,7 @@ export class PolicyTable extends Component { tableContent = ; } else if (totalNumberOfPolicies > 0) { tableContent = ( - + { + const response = await sendPost(`index/retry`, { indexNames }); + // Only track successful actions. + trackUiMetric('count', UIM_INDEX_RETRY_STEP); + return response; +}; + +export const removeLifecycleForIndex = async indexNames => { + const response = await sendPost(`index/remove`, { indexNames }); + // Only track successful actions. + trackUiMetric('count', UIM_POLICY_DETACH_INDEX); + return response; +}; + +export const addLifecyclePolicyToIndex = async body => { + const response = await sendPost(`index/add`, body); + // Only track successful actions. + trackUiMetric('count', UIM_POLICY_ATTACH_INDEX); + return response; +}; + +export const addLifecyclePolicyToTemplate = async body => { + const response = await sendPost(`template`, body); + // Only track successful actions. + trackUiMetric('count', UIM_POLICY_ATTACH_INDEX_TEMPLATE); + return response; +}; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/api_errors.js b/x-pack/plugins/index_lifecycle_management/public/application/services/api_errors.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/api_errors.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/api_errors.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/documentation.ts b/x-pack/plugins/index_lifecycle_management/public/application/services/documentation.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/documentation.ts rename to x-pack/plugins/index_lifecycle_management/public/application/services/documentation.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/filter_items.js b/x-pack/plugins/index_lifecycle_management/public/application/services/filter_items.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/filter_items.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/filter_items.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/find_errors.js b/x-pack/plugins/index_lifecycle_management/public/application/services/find_errors.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/find_errors.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/find_errors.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/flatten_panel_tree.js b/x-pack/plugins/index_lifecycle_management/public/application/services/flatten_panel_tree.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/flatten_panel_tree.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/flatten_panel_tree.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/http.ts b/x-pack/plugins/index_lifecycle_management/public/application/services/http.ts similarity index 50% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/http.ts rename to x-pack/plugins/index_lifecycle_management/public/application/services/http.ts index bbda1ebd2e0e5..47e96ea28bb8c 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/http.ts +++ b/x-pack/plugins/index_lifecycle_management/public/application/services/http.ts @@ -20,16 +20,14 @@ function getFullPath(path: string): string { return apiPrefix; } -// The extend_index_management module requires that we support an injected httpClient here. - -export function sendPost(path: string, payload: any, httpClient = _httpClient): any { - return httpClient.post(getFullPath(path), { body: JSON.stringify(payload) }); +export function sendPost(path: string, payload: any): any { + return _httpClient.post(getFullPath(path), { body: JSON.stringify(payload) }); } -export function sendGet(path: string, query: any, httpClient = _httpClient): any { - return httpClient.get(getFullPath(path), { query }); +export function sendGet(path: string, query: any): any { + return _httpClient.get(getFullPath(path), { query }); } -export function sendDelete(path: string, httpClient = _httpClient): any { - return httpClient.delete(getFullPath(path)); +export function sendDelete(path: string): any { + return _httpClient.delete(getFullPath(path)); } diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/index.js b/x-pack/plugins/index_lifecycle_management/public/application/services/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/navigation.ts b/x-pack/plugins/index_lifecycle_management/public/application/services/navigation.ts similarity index 59% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/navigation.ts rename to x-pack/plugins/index_lifecycle_management/public/application/services/navigation.ts index 943f9a49d0ab6..2d518ebb3015e 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/navigation.ts +++ b/x-pack/plugins/index_lifecycle_management/public/application/services/navigation.ts @@ -4,18 +4,10 @@ * you may not use this file except in compliance with the Elastic License. */ -import { BASE_PATH } from '../../../../common/constants'; - -// This depends upon Angular, which is why we use this provider pattern to access it within -// our React app. -let _redirect: any; - -export function init(redirect: any) { - _redirect = redirect; -} +import { BASE_PATH } from '../../../common/constants'; export const goToPolicyList = () => { - _redirect(`${BASE_PATH}policies`); + window.location.hash = `${BASE_PATH}policies`; }; export const getPolicyPath = (policyName: string): string => { diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/notification.ts b/x-pack/plugins/index_lifecycle_management/public/application/services/notification.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/notification.ts rename to x-pack/plugins/index_lifecycle_management/public/application/services/notification.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/sort_table.js b/x-pack/plugins/index_lifecycle_management/public/application/services/sort_table.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/sort_table.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/sort_table.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/ui_metric.test.js b/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.test.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/ui_metric.test.js rename to x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.test.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/ui_metric.ts b/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts similarity index 85% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/ui_metric.ts rename to x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts index d9f2c26048317..ca6c0b44d5804 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/services/ui_metric.ts +++ b/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts @@ -6,7 +6,8 @@ import { get } from 'lodash'; -import { createUiStatsReporter } from '../../../../../../../../src/legacy/core_plugins/ui_metric/public'; +import { UsageCollectionSetup } from 'src/plugins/usage_collection/public'; +import { UiStatsMetricType } from '@kbn/analytics'; import { UIM_APP_NAME, @@ -22,12 +23,10 @@ import { import { defaultColdPhase, defaultWarmPhase, defaultHotPhase } from '../store/defaults'; -export let trackUiMetric: ReturnType; +export let trackUiMetric: (metricType: UiStatsMetricType, eventName: string) => void; -export function init(getReporter: typeof createUiStatsReporter): void { - if (getReporter) { - trackUiMetric = getReporter(UIM_APP_NAME); - } +export function init(usageCollection: UsageCollectionSetup): void { + trackUiMetric = usageCollection.reportUiStats.bind(usageCollection, UIM_APP_NAME); } export function getUiMetricsForPhases(phases: any): any { diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/general.js b/x-pack/plugins/index_lifecycle_management/public/application/store/actions/general.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/general.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/actions/general.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/index.js b/x-pack/plugins/index_lifecycle_management/public/application/store/actions/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/actions/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/lifecycle.js b/x-pack/plugins/index_lifecycle_management/public/application/store/actions/lifecycle.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/lifecycle.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/actions/lifecycle.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/nodes.js b/x-pack/plugins/index_lifecycle_management/public/application/store/actions/nodes.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/nodes.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/actions/nodes.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/policies.js b/x-pack/plugins/index_lifecycle_management/public/application/store/actions/policies.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/actions/policies.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/actions/policies.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/cold_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/store/defaults/cold_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/cold_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/defaults/cold_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/delete_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/store/defaults/delete_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/delete_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/defaults/delete_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/hot_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/store/defaults/hot_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/hot_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/defaults/hot_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/index.d.ts b/x-pack/plugins/index_lifecycle_management/public/application/store/defaults/index.d.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/index.d.ts rename to x-pack/plugins/index_lifecycle_management/public/application/store/defaults/index.d.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/index.js b/x-pack/plugins/index_lifecycle_management/public/application/store/defaults/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/defaults/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/warm_phase.js b/x-pack/plugins/index_lifecycle_management/public/application/store/defaults/warm_phase.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/defaults/warm_phase.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/defaults/warm_phase.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/index.d.ts b/x-pack/plugins/index_lifecycle_management/public/application/store/index.d.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/index.d.ts rename to x-pack/plugins/index_lifecycle_management/public/application/store/index.d.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/index.js b/x-pack/plugins/index_lifecycle_management/public/application/store/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/general.js b/x-pack/plugins/index_lifecycle_management/public/application/store/reducers/general.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/general.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/reducers/general.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/index.js b/x-pack/plugins/index_lifecycle_management/public/application/store/reducers/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/reducers/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/nodes.js b/x-pack/plugins/index_lifecycle_management/public/application/store/reducers/nodes.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/nodes.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/reducers/nodes.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/policies.js b/x-pack/plugins/index_lifecycle_management/public/application/store/reducers/policies.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/reducers/policies.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/reducers/policies.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/general.js b/x-pack/plugins/index_lifecycle_management/public/application/store/selectors/general.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/general.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/selectors/general.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/index.js b/x-pack/plugins/index_lifecycle_management/public/application/store/selectors/index.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/index.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/selectors/index.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/lifecycle.js b/x-pack/plugins/index_lifecycle_management/public/application/store/selectors/lifecycle.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/lifecycle.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/selectors/lifecycle.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/nodes.js b/x-pack/plugins/index_lifecycle_management/public/application/store/selectors/nodes.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/nodes.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/selectors/nodes.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/policies.js b/x-pack/plugins/index_lifecycle_management/public/application/store/selectors/policies.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/selectors/policies.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/selectors/policies.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/store.js b/x-pack/plugins/index_lifecycle_management/public/application/store/store.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/application/store/store.js rename to x-pack/plugins/index_lifecycle_management/public/application/store/store.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/add_lifecycle_confirm_modal.js b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/add_lifecycle_confirm_modal.js similarity index 97% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/add_lifecycle_confirm_modal.js rename to x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/add_lifecycle_confirm_modal.js index 5b8f2d197daf4..143895150172d 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/add_lifecycle_confirm_modal.js +++ b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/add_lifecycle_confirm_modal.js @@ -23,7 +23,7 @@ import { EuiModalHeaderTitle, } from '@elastic/eui'; -import { BASE_PATH } from '../../../../common/constants'; +import { BASE_PATH } from '../../../common/constants'; import { loadPolicies, addLifecyclePolicyToIndex } from '../../application/services/api'; import { showApiError } from '../../application/services/api_errors'; import { toasts } from '../../application/services/notification'; @@ -38,7 +38,7 @@ export class AddLifecyclePolicyConfirmModal extends Component { }; } addPolicy = async () => { - const { indexName, httpClient, closeModal, reloadIndices } = this.props; + const { indexName, closeModal, reloadIndices } = this.props; const { selectedPolicyName, selectedAlias } = this.state; if (!selectedPolicyName) { this.setState({ @@ -55,7 +55,7 @@ export class AddLifecyclePolicyConfirmModal extends Component { policyName: selectedPolicyName, alias: selectedAlias, }; - await addLifecyclePolicyToIndex(body, httpClient); + await addLifecyclePolicyToIndex(body); closeModal(); toasts.addSuccess( i18n.translate( diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/index_lifecycle_summary.js b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/index_lifecycle_summary.js similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/index_lifecycle_summary.js rename to x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/index_lifecycle_summary.js diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/remove_lifecycle_confirm_modal.js b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/remove_lifecycle_confirm_modal.js similarity index 96% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/remove_lifecycle_confirm_modal.js rename to x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/remove_lifecycle_confirm_modal.js index 0ba5ed1720084..4e0d2383c7d79 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/components/remove_lifecycle_confirm_modal.js +++ b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/components/remove_lifecycle_confirm_modal.js @@ -24,10 +24,10 @@ export class RemoveLifecyclePolicyConfirmModal extends Component { } removePolicy = async () => { - const { indexNames, httpClient, closeModal, reloadIndices } = this.props; + const { indexNames, closeModal, reloadIndices } = this.props; try { - await removeLifecycleForIndex(indexNames, httpClient); + await removeLifecycleForIndex(indexNames); closeModal(); toasts.addSuccess( i18n.translate( diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/index.d.ts b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/index.d.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/index.d.ts rename to x-pack/plugins/index_lifecycle_management/public/extend_index_management/index.d.ts diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/index.js b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/index.js similarity index 80% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/index.js rename to x-pack/plugins/index_lifecycle_management/public/extend_index_management/index.js index 69658d31695bc..40ff04408002f 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/extend_index_management/index.js +++ b/x-pack/plugins/index_lifecycle_management/public/extend_index_management/index.js @@ -9,8 +9,6 @@ import { get, every, any } from 'lodash'; import { i18n } from '@kbn/i18n'; import { EuiSearchBar } from '@elastic/eui'; -import { init as initUiMetric } from '../application/services/ui_metric'; -import { init as initNotification } from '../application/services/notification'; import { retryLifecycleForIndex } from '../application/services/api'; import { IndexLifecycleSummary } from './components/index_lifecycle_summary'; import { AddLifecyclePolicyConfirmModal } from './components/add_lifecycle_confirm_modal'; @@ -18,21 +16,7 @@ import { RemoveLifecyclePolicyConfirmModal } from './components/remove_lifecycle const stepPath = 'ilm.step'; -export const retryLifecycleActionExtension = ({ - indices, - usageCollection, - toasts, - fatalErrors, -}) => { - // These are hacks that we can remove once the New Platform migration is done. They're needed here - // because API requests and API errors require them. - const getLegacyReporter = appName => (type, name) => { - usageCollection.reportUiStats(appName, type, name); - }; - - initUiMetric(getLegacyReporter); - initNotification(toasts, fatalErrors); - +export const retryLifecycleActionExtension = ({ indices }) => { const allHaveErrors = every(indices, index => { return index.ilm && index.ilm.failed_step; }); @@ -57,19 +41,7 @@ export const retryLifecycleActionExtension = ({ }; }; -export const removeLifecyclePolicyActionExtension = ({ - indices, - reloadIndices, - createUiStatsReporter, - toasts, - fatalErrors, - httpClient, -}) => { - // These are hacks that we can remove once the New Platform migration is done. They're needed here - // because API requests and API errors require them. - initUiMetric(createUiStatsReporter); - initNotification(toasts, fatalErrors); - +export const removeLifecyclePolicyActionExtension = ({ indices, reloadIndices }) => { const allHaveIlm = every(indices, index => { return index.ilm && index.ilm.managed; }); @@ -83,8 +55,6 @@ export const removeLifecyclePolicyActionExtension = ({ ); @@ -97,19 +67,7 @@ export const removeLifecyclePolicyActionExtension = ({ }; }; -export const addLifecyclePolicyActionExtension = ({ - indices, - reloadIndices, - createUiStatsReporter, - toasts, - fatalErrors, - httpClient, -}) => { - // These are hacks that we can remove once the New Platform migration is done. They're needed here - // because API requests and API errors require them. - initUiMetric(createUiStatsReporter); - initNotification(toasts, fatalErrors); - +export const addLifecyclePolicyActionExtension = ({ indices, reloadIndices }) => { if (indices.length !== 1) { return null; } @@ -126,8 +84,6 @@ export const addLifecyclePolicyActionExtension = ({ diff --git a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/index.ts b/x-pack/plugins/index_lifecycle_management/public/index.ts similarity index 58% rename from x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/index.ts rename to x-pack/plugins/index_lifecycle_management/public/index.ts index 1af0b697a9283..586763188a54b 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/public/np_ready/index.ts +++ b/x-pack/plugins/index_lifecycle_management/public/index.ts @@ -4,7 +4,11 @@ * you may not use this file except in compliance with the Elastic License. */ -import { PluginInitializerContext } from 'src/core/public'; +import { PluginInitializerContext } from 'kibana/public'; + import { IndexLifecycleManagementPlugin } from './plugin'; -export const createPlugin = (ctx: PluginInitializerContext) => new IndexLifecycleManagementPlugin(); +/** @public */ +export const plugin = (initializerContext: PluginInitializerContext) => { + return new IndexLifecycleManagementPlugin(initializerContext); +}; diff --git a/x-pack/plugins/index_lifecycle_management/public/plugin.tsx b/x-pack/plugins/index_lifecycle_management/public/plugin.tsx new file mode 100644 index 0000000000000..ca93646e20fcf --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/public/plugin.tsx @@ -0,0 +1,69 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { CoreSetup, PluginInitializerContext } from 'src/core/public'; + +import { PLUGIN } from '../common/constants'; +import { init as initHttp } from './application/services/http'; +import { init as initDocumentation } from './application/services/documentation'; +import { init as initUiMetric } from './application/services/ui_metric'; +import { init as initNotification } from './application/services/notification'; +import { addAllExtensions } from './extend_index_management'; +import { PluginsDependencies, ClientConfigType } from './types'; + +export class IndexLifecycleManagementPlugin { + constructor(private readonly initializerContext: PluginInitializerContext) {} + + public setup(coreSetup: CoreSetup, plugins: PluginsDependencies) { + const { + ui: { enabled: isIndexLifecycleManagementUiEnabled }, + } = this.initializerContext.config.get(); + + if (isIndexLifecycleManagementUiEnabled) { + const { + http, + notifications: { toasts }, + fatalErrors, + getStartServices, + } = coreSetup; + + const { usageCollection, management, indexManagement } = plugins; + + // Initialize services even if the app isn't mounted, because they're used by index management extensions. + initHttp(http); + initUiMetric(usageCollection); + initNotification(toasts, fatalErrors); + + management.sections.getSection('elasticsearch')!.registerApp({ + id: PLUGIN.ID, + title: PLUGIN.TITLE, + order: 2, + mount: async ({ element }) => { + const [coreStart] = await getStartServices(); + const { + i18n: { Context: I18nContext }, + docLinks: { ELASTIC_WEBSITE_URL, DOC_LINK_VERSION }, + } = coreStart; + + // Initialize additional services. + initDocumentation( + `${ELASTIC_WEBSITE_URL}guide/en/elasticsearch/reference/${DOC_LINK_VERSION}/` + ); + + const { renderApp } = await import('./application'); + return renderApp(element, I18nContext); + }, + }); + + if (indexManagement) { + addAllExtensions(indexManagement.extensionsService); + } + } + } + + public start() {} + public stop() {} +} diff --git a/x-pack/plugins/index_lifecycle_management/public/types.ts b/x-pack/plugins/index_lifecycle_management/public/types.ts new file mode 100644 index 0000000000000..f9e0abae56cb4 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/public/types.ts @@ -0,0 +1,21 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { UsageCollectionSetup } from '../../../../src/plugins/usage_collection/public'; +import { ManagementSetup } from '../../../../src/plugins/management/public'; +import { IndexManagementPluginSetup } from '../../index_management/public'; + +export interface PluginsDependencies { + usageCollection: UsageCollectionSetup; + management: ManagementSetup; + indexManagement?: IndexManagementPluginSetup; +} + +export interface ClientConfigType { + ui: { + enabled: boolean; + }; +} diff --git a/x-pack/plugins/index_lifecycle_management/server/config.ts b/x-pack/plugins/index_lifecycle_management/server/config.ts new file mode 100644 index 0000000000000..9728e31a8a148 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/config.ts @@ -0,0 +1,18 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema, TypeOf } from '@kbn/config-schema'; + +export const configSchema = schema.object({ + enabled: schema.boolean({ defaultValue: true }), + ui: schema.object({ + enabled: schema.boolean({ defaultValue: true }), + }), + // Cloud requires the ability to hide internal node attributes from users. + filteredNodeAttributes: schema.arrayOf(schema.string(), { defaultValue: [] }), +}); + +export type IndexLifecycleManagementConfig = TypeOf; diff --git a/x-pack/plugins/index_lifecycle_management/server/index.ts b/x-pack/plugins/index_lifecycle_management/server/index.ts new file mode 100644 index 0000000000000..8a5f0fe19f9b0 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/index.ts @@ -0,0 +1,19 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { PluginInitializerContext, PluginConfigDescriptor } from 'kibana/server'; +import { IndexLifecycleManagementServerPlugin } from './plugin'; +import { configSchema, IndexLifecycleManagementConfig } from './config'; + +export const plugin = (ctx: PluginInitializerContext) => + new IndexLifecycleManagementServerPlugin(ctx); + +export const config: PluginConfigDescriptor = { + schema: configSchema, + exposeToBrowser: { + ui: true, + }, +}; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/is_es_error/is_es_error.ts b/x-pack/plugins/index_lifecycle_management/server/lib/is_es_error.ts similarity index 100% rename from x-pack/legacy/plugins/index_lifecycle_management/server/lib/is_es_error/is_es_error.ts rename to x-pack/plugins/index_lifecycle_management/server/lib/is_es_error.ts diff --git a/x-pack/plugins/index_lifecycle_management/server/plugin.ts b/x-pack/plugins/index_lifecycle_management/server/plugin.ts new file mode 100644 index 0000000000000..48c50f9a48ee5 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/plugin.ts @@ -0,0 +1,86 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { Observable } from 'rxjs'; +import { first } from 'rxjs/operators'; +import { i18n } from '@kbn/i18n'; +import { CoreSetup, Plugin, Logger, PluginInitializerContext, APICaller } from 'src/core/server'; + +import { PLUGIN } from '../common/constants'; +import { Dependencies } from './types'; +import { registerApiRoutes } from './routes'; +import { License } from './services'; +import { IndexLifecycleManagementConfig } from './config'; +import { isEsError } from './lib/is_es_error'; + +const indexLifecycleDataEnricher = async (indicesList: any, callAsCurrentUser: APICaller) => { + if (!indicesList || !indicesList.length) { + return; + } + + const params = { + path: '/*/_ilm/explain', + method: 'GET', + }; + + const { indices: ilmIndicesData } = await callAsCurrentUser('transport.request', params); + + return indicesList.map((index: any): any => { + return { + ...index, + ilm: { ...(ilmIndicesData[index.name] || {}) }, + }; + }); +}; + +export class IndexLifecycleManagementServerPlugin implements Plugin { + private readonly config$: Observable; + private readonly license: License; + private readonly logger: Logger; + + constructor(initializerContext: PluginInitializerContext) { + this.logger = initializerContext.logger.get(); + this.config$ = initializerContext.config.create(); + this.license = new License(); + } + + async setup({ http }: CoreSetup, { licensing, indexManagement }: Dependencies): Promise { + const router = http.createRouter(); + const config = await this.config$.pipe(first()).toPromise(); + + this.license.setup( + { + pluginId: PLUGIN.ID, + minimumLicenseType: PLUGIN.minimumLicenseType, + defaultErrorMessage: i18n.translate('xpack.indexLifecycleMgmt.licenseCheckErrorMessage', { + defaultMessage: 'License check failed', + }), + }, + { + licensing, + logger: this.logger, + } + ); + + registerApiRoutes({ + router, + config, + license: this.license, + lib: { + isEsError, + }, + }); + + if (config.ui.enabled) { + if (indexManagement.indexDataEnricher) { + indexManagement.indexDataEnricher.add(indexLifecycleDataEnricher); + } + } + } + + start() {} + stop() {} +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_index_routes.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/index.ts similarity index 65% rename from x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_index_routes.ts rename to x-pack/plugins/index_lifecycle_management/server/routes/api/index/index.ts index 74eb1a86a93ba..abe00af74b63a 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/index/register_index_routes.ts +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/index.ts @@ -4,12 +4,13 @@ * you may not use this file except in compliance with the Elastic License. */ +import { RouteDependencies } from '../../../types'; import { registerRetryRoute } from './register_retry_route'; import { registerRemoveRoute } from './register_remove_route'; import { registerAddPolicyRoute } from './register_add_policy_route'; -export function registerIndexRoutes(server: any) { - registerRetryRoute(server); - registerRemoveRoute(server); - registerAddPolicyRoute(server); +export function registerIndexRoutes(dependencies: RouteDependencies) { + registerRetryRoute(dependencies); + registerRemoveRoute(dependencies); + registerAddPolicyRoute(dependencies); } diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts new file mode 100644 index 0000000000000..9627f6399eaaf --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_add_policy_route.ts @@ -0,0 +1,66 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +async function addLifecyclePolicy( + callAsCurrentUser: APICaller, + indexName: string, + policyName: string, + alias: string +) { + const params = { + method: 'PUT', + path: `/${encodeURIComponent(indexName)}/_settings`, + body: { + lifecycle: { + name: policyName, + rollover_alias: alias, + }, + }, + }; + + return callAsCurrentUser('transport.request', params); +} + +const bodySchema = schema.object({ + indexName: schema.string(), + policyName: schema.string(), + alias: schema.maybe(schema.string()), +}); + +export function registerAddPolicyRoute({ router, license, lib }: RouteDependencies) { + router.post( + { path: addBasePath('/index/add'), validate: { body: bodySchema } }, + license.guardApiRoute(async (context, request, response) => { + const body = request.body as typeof bodySchema.type; + const { indexName, policyName, alias = '' } = body; + + try { + await addLifecyclePolicy( + context.core.elasticsearch.dataClient.callAsCurrentUser, + indexName, + policyName, + alias + ); + return response.ok(); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts new file mode 100644 index 0000000000000..8ec94a8591785 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_remove_route.ts @@ -0,0 +1,54 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +async function removeLifecycle(callAsCurrentUser: APICaller, indexNames: string[]) { + const responses = []; + for (let i = 0; i < indexNames.length; i++) { + const indexName = indexNames[i]; + const params = { + method: 'POST', + path: `/${encodeURIComponent(indexName)}/_ilm/remove`, + ignore: [404], + }; + + responses.push(callAsCurrentUser('transport.request', params)); + } + return Promise.all(responses); +} + +const bodySchema = schema.object({ + indexNames: schema.arrayOf(schema.string()), +}); + +export function registerRemoveRoute({ router, license, lib }: RouteDependencies) { + router.post( + { path: addBasePath('/index/remove'), validate: { body: bodySchema } }, + license.guardApiRoute(async (context, request, response) => { + const body = request.body as typeof bodySchema.type; + const { indexNames } = body; + + try { + await removeLifecycle(context.core.elasticsearch.dataClient.callAsCurrentUser, indexNames); + return response.ok(); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts new file mode 100644 index 0000000000000..1e2d621cab173 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/index/register_retry_route.ts @@ -0,0 +1,54 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +async function retryLifecycle(callAsCurrentUser: APICaller, indexNames: string[]) { + const responses = []; + for (let i = 0; i < indexNames.length; i++) { + const indexName = indexNames[i]; + const params = { + method: 'POST', + path: `/${encodeURIComponent(indexName)}/_ilm/retry`, + ignore: [404], + }; + + responses.push(callAsCurrentUser('transport.request', params)); + } + return Promise.all(responses); +} + +const bodySchema = schema.object({ + indexNames: schema.arrayOf(schema.string()), +}); + +export function registerRetryRoute({ router, license, lib }: RouteDependencies) { + router.post( + { path: addBasePath('/index/retry'), validate: { body: bodySchema } }, + license.guardApiRoute(async (context, request, response) => { + const body = request.body as typeof bodySchema.type; + const { indexNames } = body; + + try { + await retryLifecycle(context.core.elasticsearch.dataClient.callAsCurrentUser, indexNames); + return response.ok(); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_nodes_routes.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts similarity index 65% rename from x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_nodes_routes.ts rename to x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts index 4486d97038657..bde56f0318bbd 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/nodes/register_nodes_routes.ts +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/index.ts @@ -4,10 +4,11 @@ * you may not use this file except in compliance with the Elastic License. */ +import { RouteDependencies } from '../../../types'; import { registerListRoute } from './register_list_route'; import { registerDetailsRoute } from './register_details_route'; -export function registerNodesRoutes(server: any) { - registerListRoute(server); - registerDetailsRoute(server); +export function registerNodesRoutes(dependencies: RouteDependencies) { + registerListRoute(dependencies); + registerDetailsRoute(dependencies); } diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts new file mode 100644 index 0000000000000..6ff1f147e7ea7 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_details_route.ts @@ -0,0 +1,64 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +function findMatchingNodes(stats: any, nodeAttrs: string): any { + return Object.entries(stats.nodes).reduce((accum: any[], [nodeId, nodeStats]: [any, any]) => { + const attributes = nodeStats.attributes || {}; + for (const [key, value] of Object.entries(attributes)) { + if (`${key}:${value}` === nodeAttrs) { + accum.push({ + nodeId, + stats: nodeStats, + }); + break; + } + } + return accum; + }, []); +} + +async function fetchNodeStats(callAsCurrentUser: APICaller): Promise { + const params = { + format: 'json', + }; + + return await callAsCurrentUser('nodes.stats', params); +} + +const paramsSchema = schema.object({ + nodeAttrs: schema.string(), +}); + +export function registerDetailsRoute({ router, license, lib }: RouteDependencies) { + router.get( + { path: addBasePath('/nodes/{nodeAttrs}/details'), validate: { params: paramsSchema } }, + license.guardApiRoute(async (context, request, response) => { + const params = request.params as typeof paramsSchema.type; + const { nodeAttrs } = params; + + try { + const stats = await fetchNodeStats(context.core.elasticsearch.dataClient.callAsCurrentUser); + const okResponse = { body: findMatchingNodes(stats, nodeAttrs) }; + return response.ok(okResponse); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts new file mode 100644 index 0000000000000..73d85c78d3b11 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/nodes/register_list_route.ts @@ -0,0 +1,69 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +function convertStatsIntoList(stats: any, disallowedNodeAttributes: string[]): any { + return Object.entries(stats.nodes).reduce((accum: any, [nodeId, nodeStats]: [any, any]) => { + const attributes = nodeStats.attributes || {}; + for (const [key, value] of Object.entries(attributes)) { + const isNodeAttributeAllowed = !disallowedNodeAttributes.includes(key); + if (isNodeAttributeAllowed) { + const attributeString = `${key}:${value}`; + accum[attributeString] = accum[attributeString] || []; + accum[attributeString].push(nodeId); + } + } + return accum; + }, {}); +} + +async function fetchNodeStats(callAsCurrentUser: APICaller): Promise { + const params = { + format: 'json', + }; + + return await callAsCurrentUser('nodes.stats', params); +} + +export function registerListRoute({ router, config, license, lib }: RouteDependencies) { + const { filteredNodeAttributes } = config; + + const NODE_ATTRS_KEYS_TO_IGNORE: string[] = [ + 'ml.enabled', + 'ml.machine_memory', + 'ml.max_open_jobs', + // Used by ML to identify nodes that have transform enabled: + // https://github.com/elastic/elasticsearch/pull/52712/files#diff-225cc2c1291b4c60a8c3412a619094e1R147 + 'transform.node', + 'xpack.installed', + ]; + + const disallowedNodeAttributes = [...NODE_ATTRS_KEYS_TO_IGNORE, ...filteredNodeAttributes]; + + router.get( + { path: addBasePath('/nodes/list'), validate: false }, + license.guardApiRoute(async (context, request, response) => { + try { + const stats = await fetchNodeStats(context.core.elasticsearch.dataClient.callAsCurrentUser); + const okResponse = { body: convertStatsIntoList(stats, disallowedNodeAttributes) }; + return response.ok(okResponse); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_policies_routes.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/index.ts similarity index 64% rename from x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_policies_routes.ts rename to x-pack/plugins/index_lifecycle_management/server/routes/api/policies/index.ts index 279b016da178f..c30dc04c61169 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/policies/register_policies_routes.ts +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/index.ts @@ -4,12 +4,13 @@ * you may not use this file except in compliance with the Elastic License. */ +import { RouteDependencies } from '../../../types'; import { registerFetchRoute } from './register_fetch_route'; import { registerCreateRoute } from './register_create_route'; import { registerDeleteRoute } from './register_delete_route'; -export function registerPoliciesRoutes(server: any) { - registerFetchRoute(server); - registerCreateRoute(server); - registerDeleteRoute(server); +export function registerPoliciesRoutes(dependencies: RouteDependencies) { + registerFetchRoute(dependencies); + registerCreateRoute(dependencies); + registerDeleteRoute(dependencies); } diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts new file mode 100644 index 0000000000000..a9c6bab58fdd9 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_create_route.ts @@ -0,0 +1,145 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +async function createPolicy(callAsCurrentUser: APICaller, name: string, phases: any): Promise { + const body = { + policy: { + phases, + }, + }; + const params = { + method: 'PUT', + path: `/_ilm/policy/${encodeURIComponent(name)}`, + ignore: [404], + body, + }; + + return await callAsCurrentUser('transport.request', params); +} + +const minAgeSchema = schema.maybe(schema.string()); + +const setPrioritySchema = schema.maybe( + schema.object({ + priority: schema.number(), + }) +); + +const unfollowSchema = schema.maybe(schema.object({})); // Unfollow has no options + +const allocateNodeSchema = schema.maybe(schema.recordOf(schema.string(), schema.string())); +const allocateSchema = schema.maybe( + schema.object({ + number_of_replicas: schema.maybe(schema.number()), + include: allocateNodeSchema, + exclude: allocateNodeSchema, + require: allocateNodeSchema, + }) +); + +const hotPhaseSchema = schema.object({ + min_age: minAgeSchema, + actions: schema.object({ + set_priority: setPrioritySchema, + unfollow: unfollowSchema, + rollover: schema.maybe( + schema.object({ + max_age: schema.maybe(schema.string()), + max_size: schema.maybe(schema.string()), + max_docs: schema.maybe(schema.number()), + }) + ), + }), +}); + +const warmPhaseSchema = schema.maybe( + schema.object({ + min_age: minAgeSchema, + actions: schema.object({ + set_priority: setPrioritySchema, + unfollow: unfollowSchema, + read_only: schema.maybe(schema.object({})), // Readonly has no options + allocate: allocateSchema, + shrink: schema.maybe( + schema.object({ + number_of_shards: schema.number(), + }) + ), + forcemerge: schema.maybe( + schema.object({ + max_num_segments: schema.number(), + }) + ), + }), + }) +); + +const coldPhaseSchema = schema.maybe( + schema.object({ + min_age: minAgeSchema, + actions: schema.object({ + set_priority: setPrioritySchema, + unfollow: unfollowSchema, + allocate: allocateSchema, + freeze: schema.maybe(schema.object({})), // Freeze has no options + }), + }) +); + +const deletePhaseSchema = schema.maybe( + schema.object({ + min_age: minAgeSchema, + actions: schema.object({ + wait_for_snapshot: schema.maybe( + schema.object({ + policy: schema.string(), + }) + ), + delete: schema.maybe(schema.object({})), // Delete has no options + }), + }) +); + +// Per https://www.elastic.co/guide/en/elasticsearch/reference/current/_actions.html +const bodySchema = schema.object({ + name: schema.string(), + phases: schema.object({ + hot: hotPhaseSchema, + warm: warmPhaseSchema, + cold: coldPhaseSchema, + delete: deletePhaseSchema, + }), +}); + +export function registerCreateRoute({ router, license, lib }: RouteDependencies) { + router.post( + { path: addBasePath('/policies'), validate: { body: bodySchema } }, + license.guardApiRoute(async (context, request, response) => { + const body = request.body as typeof bodySchema.type; + const { name, phases } = body; + + try { + await createPolicy(context.core.elasticsearch.dataClient.callAsCurrentUser, name, phases); + return response.ok(); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts new file mode 100644 index 0000000000000..e08297f4d7bc4 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_delete_route.ts @@ -0,0 +1,50 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +async function deletePolicies(callAsCurrentUser: APICaller, policyNames: string): Promise { + const params = { + method: 'DELETE', + path: `/_ilm/policy/${encodeURIComponent(policyNames)}`, + // we allow 404 since they may have no policies + ignore: [404], + }; + + return await callAsCurrentUser('transport.request', params); +} + +const paramsSchema = schema.object({ + policyNames: schema.string(), +}); + +export function registerDeleteRoute({ router, license, lib }: RouteDependencies) { + router.delete( + { path: addBasePath('/policies/{policyNames}'), validate: { params: paramsSchema } }, + license.guardApiRoute(async (context, request, response) => { + const params = request.params as typeof paramsSchema.type; + const { policyNames } = params; + + try { + await deletePolicies(context.core.elasticsearch.dataClient.callAsCurrentUser, policyNames); + return response.ok(); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts new file mode 100644 index 0000000000000..294b7c4c65cba --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/policies/register_fetch_route.ts @@ -0,0 +1,90 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +function formatPolicies(policiesMap: any): any { + if (policiesMap.status === 404) { + return []; + } + + return Object.keys(policiesMap).reduce((accum: any[], lifecycleName: string) => { + const policyEntry = policiesMap[lifecycleName]; + accum.push({ + ...policyEntry, + name: lifecycleName, + }); + return accum; + }, []); +} + +async function fetchPolicies(callAsCurrentUser: APICaller): Promise { + const params = { + method: 'GET', + path: '/_ilm/policy', + // we allow 404 since they may have no policies + ignore: [404], + }; + + return await callAsCurrentUser('transport.request', params); +} + +async function addLinkedIndices(callAsCurrentUser: APICaller, policiesMap: any) { + if (policiesMap.status === 404) { + return policiesMap; + } + const params = { + method: 'GET', + path: '/*/_ilm/explain', + // we allow 404 since they may have no policies + ignore: [404], + }; + + const policyExplanation: any = await callAsCurrentUser('transport.request', params); + Object.entries(policyExplanation.indices).forEach(([indexName, { policy }]: [string, any]) => { + if (policy && policiesMap[policy]) { + policiesMap[policy].linkedIndices = policiesMap[policy].linkedIndices || []; + policiesMap[policy].linkedIndices.push(indexName); + } + }); +} + +const querySchema = schema.object({ + withIndices: schema.boolean({ defaultValue: false }), +}); + +export function registerFetchRoute({ router, license, lib }: RouteDependencies) { + router.get( + { path: addBasePath('/policies'), validate: { query: querySchema } }, + license.guardApiRoute(async (context, request, response) => { + const query = request.query as typeof querySchema.type; + const { withIndices } = query; + const { callAsCurrentUser } = context.core.elasticsearch.dataClient; + + try { + const policiesMap = await fetchPolicies(callAsCurrentUser); + if (withIndices) { + await addLinkedIndices(callAsCurrentUser, policiesMap); + } + const okResponse = { body: formatPolicies(policiesMap) }; + return response.ok(okResponse); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_templates_routes.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/index.ts similarity index 64% rename from x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_templates_routes.ts rename to x-pack/plugins/index_lifecycle_management/server/routes/api/templates/index.ts index 424b2d36b1ba2..a2d885c3170b9 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_templates_routes.ts +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/index.ts @@ -4,12 +4,11 @@ * you may not use this file except in compliance with the Elastic License. */ +import { RouteDependencies } from '../../../types'; import { registerFetchRoute } from './register_fetch_route'; -import { registerGetRoute } from './register_get_route'; import { registerAddPolicyRoute } from './register_add_policy_route'; -export function registerTemplatesRoutes(server: any) { - registerFetchRoute(server); - registerGetRoute(server); - registerAddPolicyRoute(server); +export function registerTemplatesRoutes(dependencies: RouteDependencies) { + registerFetchRoute(dependencies); + registerAddPolicyRoute(dependencies); } diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts new file mode 100644 index 0000000000000..0da8535f8d4ec --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_add_policy_route.ts @@ -0,0 +1,81 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { merge } from 'lodash'; +import { schema } from '@kbn/config-schema'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; + +async function getIndexTemplate(callAsCurrentUser: APICaller, templateName: string): Promise { + const response = await callAsCurrentUser('indices.getTemplate', { name: templateName }); + return response[templateName]; +} + +async function updateIndexTemplate( + callAsCurrentUser: APICaller, + templateName: string, + policyName: string, + aliasName?: string +): Promise { + // Fetch existing template + const template = await getIndexTemplate(callAsCurrentUser, templateName); + merge(template, { + settings: { + index: { + lifecycle: { + name: policyName, + rollover_alias: aliasName, + }, + }, + }, + }); + + const params = { + method: 'PUT', + path: `/_template/${encodeURIComponent(templateName)}`, + ignore: [404], + body: template, + }; + + return await callAsCurrentUser('transport.request', params); +} + +const bodySchema = schema.object({ + templateName: schema.string(), + policyName: schema.string(), + aliasName: schema.maybe(schema.string()), +}); + +export function registerAddPolicyRoute({ router, license, lib }: RouteDependencies) { + router.post( + { path: addBasePath('/template'), validate: { body: bodySchema } }, + license.guardApiRoute(async (context, request, response) => { + const body = request.body as typeof bodySchema.type; + const { templateName, policyName, aliasName } = body; + + try { + await updateIndexTemplate( + context.core.elasticsearch.dataClient.callAsCurrentUser, + templateName, + policyName, + aliasName + ); + return response.ok(); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); + } + // Case: default + return response.internalError({ body: e }); + } + }) + ); +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts b/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts similarity index 63% rename from x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts rename to x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts index fd58f471d69bb..a2dc67cb77afe 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts +++ b/x-pack/plugins/index_lifecycle_management/server/routes/api/templates/register_fetch_route.ts @@ -4,10 +4,10 @@ * you may not use this file except in compliance with the Elastic License. */ -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { isEsError } from '../../../lib/is_es_error'; -import { wrapEsError, wrapUnknownError } from '../../../lib/error_wrappers'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; +import { APICaller } from 'src/core/server'; + +import { RouteDependencies } from '../../../types'; +import { addBasePath } from '../../../services'; /** * We don't want to output system template (whose name starts with a ".") which don't @@ -49,7 +49,7 @@ function filterAndFormatTemplates(templates: any): any { return formattedTemplates; } -async function fetchTemplates(callWithRequest: any): Promise { +async function fetchTemplates(callAsCurrentUser: APICaller): Promise { const params = { method: 'GET', path: '/_template', @@ -57,30 +57,29 @@ async function fetchTemplates(callWithRequest: any): Promise { ignore: [404], }; - return await callWithRequest('transport.request', params); + return await callAsCurrentUser('transport.request', params); } -export function registerFetchRoute(server: any) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/index_lifecycle_management/templates', - method: 'GET', - handler: async (request: any) => { - const callWithRequest = callWithRequestFactory(server, request); +export function registerFetchRoute({ router, license, lib }: RouteDependencies) { + router.get( + { path: addBasePath('/templates'), validate: false }, + license.guardApiRoute(async (context, request, response) => { try { - const templates = await fetchTemplates(callWithRequest); - return filterAndFormatTemplates(templates); - } catch (err) { - if (isEsError(err)) { - return wrapEsError(err); + const templates = await fetchTemplates( + context.core.elasticsearch.dataClient.callAsCurrentUser + ); + const okResponse = { body: filterAndFormatTemplates(templates) }; + return response.ok(okResponse); + } catch (e) { + if (lib.isEsError(e)) { + return response.customError({ + statusCode: e.statusCode, + body: e, + }); } - - return wrapUnknownError(err); + // Case: default + return response.internalError({ body: e }); } - }, - config: { - pre: [licensePreRouting], - }, - }); + }) + ); } diff --git a/x-pack/plugins/index_lifecycle_management/server/routes/index.ts b/x-pack/plugins/index_lifecycle_management/server/routes/index.ts new file mode 100644 index 0000000000000..35996721854c6 --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/routes/index.ts @@ -0,0 +1,19 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { RouteDependencies } from '../types'; + +import { registerIndexRoutes } from './api/index'; +import { registerNodesRoutes } from './api/nodes'; +import { registerPoliciesRoutes } from './api/policies'; +import { registerTemplatesRoutes } from './api/templates'; + +export function registerApiRoutes(dependencies: RouteDependencies) { + registerIndexRoutes(dependencies); + registerNodesRoutes(dependencies); + registerPoliciesRoutes(dependencies); + registerTemplatesRoutes(dependencies); +} diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/index.ts b/x-pack/plugins/index_lifecycle_management/server/services/add_base_path.ts similarity index 64% rename from x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/index.ts rename to x-pack/plugins/index_lifecycle_management/server/services/add_base_path.ts index f2c070fd44b6e..3f3dd131df7c7 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/check_license/index.ts +++ b/x-pack/plugins/index_lifecycle_management/server/services/add_base_path.ts @@ -4,4 +4,6 @@ * you may not use this file except in compliance with the Elastic License. */ -export { checkLicense } from './check_license'; +import { API_BASE_PATH } from '../../common/constants'; + +export const addBasePath = (uri: string): string => `${API_BASE_PATH}${uri}`; diff --git a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/index.ts b/x-pack/plugins/index_lifecycle_management/server/services/index.ts similarity index 74% rename from x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/index.ts rename to x-pack/plugins/index_lifecycle_management/server/services/index.ts index 0743e443955f4..d7b544b290c39 100644 --- a/x-pack/legacy/plugins/index_lifecycle_management/server/lib/license_pre_routing_factory/index.ts +++ b/x-pack/plugins/index_lifecycle_management/server/services/index.ts @@ -4,4 +4,5 @@ * you may not use this file except in compliance with the Elastic License. */ -export { licensePreRoutingFactory } from './license_pre_routing_factory'; +export { License } from './license'; +export { addBasePath } from './add_base_path'; diff --git a/x-pack/plugins/index_lifecycle_management/server/services/license.ts b/x-pack/plugins/index_lifecycle_management/server/services/license.ts new file mode 100644 index 0000000000000..31d3654c51e3e --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/services/license.ts @@ -0,0 +1,82 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { Logger } from 'src/core/server'; +import { + KibanaRequest, + KibanaResponseFactory, + RequestHandler, + RequestHandlerContext, +} from 'kibana/server'; + +import { LicensingPluginSetup } from '../../../licensing/server'; +import { LicenseType } from '../../../licensing/common/types'; + +export interface LicenseStatus { + isValid: boolean; + message?: string; +} + +interface SetupSettings { + pluginId: string; + minimumLicenseType: LicenseType; + defaultErrorMessage: string; +} + +export class License { + private licenseStatus: LicenseStatus = { + isValid: false, + message: 'Invalid License', + }; + + setup( + { pluginId, minimumLicenseType, defaultErrorMessage }: SetupSettings, + { licensing, logger }: { licensing: LicensingPluginSetup; logger: Logger } + ) { + licensing.license$.subscribe(license => { + const { state, message } = license.check(pluginId, minimumLicenseType); + const hasRequiredLicense = state === 'valid'; + + if (hasRequiredLicense) { + this.licenseStatus = { isValid: true }; + } else { + this.licenseStatus = { + isValid: false, + message: message || defaultErrorMessage, + }; + if (message) { + logger.info(message); + } + } + }); + } + + guardApiRoute(handler: RequestHandler) { + const license = this; + + return function licenseCheck( + ctx: RequestHandlerContext, + request: KibanaRequest, + response: KibanaResponseFactory + ) { + const licenseStatus = license.getStatus(); + + if (!licenseStatus.isValid) { + return response.customError({ + body: { + message: licenseStatus.message || '', + }, + statusCode: 403, + }); + } + + return handler(ctx, request, response); + }; + } + + getStatus() { + return this.licenseStatus; + } +} diff --git a/x-pack/plugins/index_lifecycle_management/server/types.ts b/x-pack/plugins/index_lifecycle_management/server/types.ts new file mode 100644 index 0000000000000..7f64c1a47197a --- /dev/null +++ b/x-pack/plugins/index_lifecycle_management/server/types.ts @@ -0,0 +1,27 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { IRouter } from 'src/core/server'; + +import { LicensingPluginSetup } from '../../licensing/server'; +import { IndexManagementPluginSetup } from '../../index_management/server'; +import { License } from './services'; +import { IndexLifecycleManagementConfig } from './config'; +import { isEsError } from './lib/is_es_error'; + +export interface Dependencies { + licensing: LicensingPluginSetup; + indexManagement: IndexManagementPluginSetup; +} + +export interface RouteDependencies { + router: IRouter; + config: IndexLifecycleManagementConfig; + license: License; + lib: { + isEsError: typeof isEsError; + }; +} diff --git a/x-pack/plugins/index_management/public/application/sections/home/index_list/index_actions_context_menu/index_actions_context_menu.js b/x-pack/plugins/index_management/public/application/sections/home/index_list/index_actions_context_menu/index_actions_context_menu.js index 8f794ce1ed612..a351d39b123a8 100644 --- a/x-pack/plugins/index_management/public/application/sections/home/index_list/index_actions_context_menu/index_actions_context_menu.js +++ b/x-pack/plugins/index_management/public/application/sections/home/index_list/index_actions_context_menu/index_actions_context_menu.js @@ -46,11 +46,7 @@ export class IndexActionsContextMenu extends Component { confirmAction = isActionConfirmed => { this.setState({ isActionConfirmed }); }; - panels({ - core: { fatalErrors }, - services: { extensionsService, httpService, notificationService }, - plugins: { usageCollection }, - }) { + panels({ services: { extensionsService } }) { const { closeIndices, openIndices, @@ -218,15 +214,6 @@ export class IndexActionsContextMenu extends Component { const actionExtensionDefinition = actionExtension({ indices, reloadIndices, - // These config options can be removed once the NP migration out of legacy is complete. - // They're needed for now because ILM's extensions make API calls which require these - // dependencies, but they're not available unless the app's "setup" lifecycle stage occurs. - // Within the old platform, "setup" only occurs once the user actually visits the app. - // Once ILM and IM have been moved out of legacy this hack won't be necessary. - usageCollection, - toasts: notificationService.toasts, - fatalErrors, - httpClient: httpService.httpClient, }); if (actionExtensionDefinition) { const { diff --git a/x-pack/plugins/index_management/public/index.ts b/x-pack/plugins/index_management/public/index.ts index 6bb921ef648f3..7a76fff7f3ec6 100644 --- a/x-pack/plugins/index_management/public/index.ts +++ b/x-pack/plugins/index_management/public/index.ts @@ -4,13 +4,13 @@ * you may not use this file except in compliance with the Elastic License. */ import './index.scss'; -import { IndexMgmtUIPlugin, IndexMgmtSetup } from './plugin'; +import { IndexMgmtUIPlugin, IndexManagementPluginSetup } from './plugin'; /** @public */ export const plugin = () => { return new IndexMgmtUIPlugin(); }; -export { IndexMgmtSetup }; +export { IndexManagementPluginSetup }; export { getIndexListUri } from './application/services/navigation'; diff --git a/x-pack/plugins/index_management/public/plugin.ts b/x-pack/plugins/index_management/public/plugin.ts index 4aa06d286e3c4..f9e2a47170b3d 100644 --- a/x-pack/plugins/index_management/public/plugin.ts +++ b/x-pack/plugins/index_management/public/plugin.ts @@ -20,7 +20,7 @@ import { setUiMetricService } from './application/services/api'; import { IndexMgmtMetricsType } from './types'; import { ExtensionsService, ExtensionsSetup } from './services'; -export interface IndexMgmtSetup { +export interface IndexManagementPluginSetup { extensionsService: ExtensionsSetup; } @@ -40,7 +40,7 @@ export class IndexMgmtUIPlugin { setUiMetricService(this.uiMetricService); } - public setup(coreSetup: CoreSetup, plugins: PluginsDependencies): IndexMgmtSetup { + public setup(coreSetup: CoreSetup, plugins: PluginsDependencies): IndexManagementPluginSetup { const { http, notifications } = coreSetup; const { usageCollection, management } = plugins; diff --git a/x-pack/plugins/index_management/server/index.ts b/x-pack/plugins/index_management/server/index.ts index e4102711708cb..4d9409e4a516c 100644 --- a/x-pack/plugins/index_management/server/index.ts +++ b/x-pack/plugins/index_management/server/index.ts @@ -17,6 +17,6 @@ export const config = { /** @public */ export { Dependencies } from './types'; -export { IndexMgmtSetup } from './plugin'; +export { IndexManagementPluginSetup } from './plugin'; export { Index } from './types'; export { IndexManagementConfig } from './config'; diff --git a/x-pack/plugins/index_management/server/plugin.ts b/x-pack/plugins/index_management/server/plugin.ts index a0a9151cdb71f..e5bd7451b028f 100644 --- a/x-pack/plugins/index_management/server/plugin.ts +++ b/x-pack/plugins/index_management/server/plugin.ts @@ -12,13 +12,13 @@ import { ApiRoutes } from './routes'; import { License, IndexDataEnricher } from './services'; import { isEsError } from './lib/is_es_error'; -export interface IndexMgmtSetup { +export interface IndexManagementPluginSetup { indexDataEnricher: { add: IndexDataEnricher['add']; }; } -export class IndexMgmtServerPlugin implements Plugin { +export class IndexMgmtServerPlugin implements Plugin { private readonly apiRoutes: ApiRoutes; private readonly license: License; private readonly logger: Logger; @@ -31,7 +31,7 @@ export class IndexMgmtServerPlugin implements Plugin { const loadTemplates = () => supertest.get(`${API_BASE_PATH}/templates`); - const getTemplate = name => supertest.get(`${API_BASE_PATH}/templates/${name}`); - const addPolicyToTemplate = (templateName, policyName, aliasName) => supertest .post(`${API_BASE_PATH}/template`) @@ -23,7 +21,6 @@ export const registerHelpers = ({ supertest }) => { return { loadTemplates, - getTemplate, addPolicyToTemplate, }; }; diff --git a/x-pack/test/api_integration/apis/management/index_lifecycle_management/templates.js b/x-pack/test/api_integration/apis/management/index_lifecycle_management/templates.js index 374577825cd94..d30c20527471b 100644 --- a/x-pack/test/api_integration/apis/management/index_lifecycle_management/templates.js +++ b/x-pack/test/api_integration/apis/management/index_lifecycle_management/templates.js @@ -16,7 +16,7 @@ export default function({ getService }) { const { createIndexTemplate, cleanUp: cleanUpEsResources } = initElasticsearchHelpers(es); - const { loadTemplates, getTemplate, addPolicyToTemplate } = registerTemplatesHelpers({ + const { loadTemplates, addPolicyToTemplate } = registerTemplatesHelpers({ supertest, }); @@ -48,18 +48,6 @@ export default function({ getService }) { }); }); - describe('get', () => { - it('should fetch a single template', async () => { - // Create a template with the ES client - const templateName = getRandomString(); - const template = getTemplatePayload(); - await createIndexTemplate(templateName, template); - - const { body } = await getTemplate(templateName).expect(200); - expect(body.index_patterns).to.eql(template.index_patterns); - }); - }); - describe('update', () => { it('should add a policy to a template', async () => { // Create policy @@ -78,12 +66,13 @@ export default function({ getService }) { await addPolicyToTemplate(templateName, policyName, rolloverAlias).expect(200); // Fetch the template and verify that the policy has been attached - const { body } = await getTemplate(templateName); + const { body } = await loadTemplates(); + const fetchedTemplate = body.find(({ name }) => templateName === name); const { settings: { index: { lifecycle }, }, - } = body; + } = fetchedTemplate; expect(lifecycle.name).to.equal(policyName); expect(lifecycle.rollover_alias).to.equal(rolloverAlias); }); From 330956ec1a7ea94cc6665147b870075f683d05b3 Mon Sep 17 00:00:00 2001 From: Dmitry Lemeshko Date: Fri, 10 Apr 2020 02:55:28 +0300 Subject: [PATCH 022/102] Code coverage: fix missing coverage after merging oss & x-pack data (#63178) * update nyc & istanbul-babel deps * update index.js in kbn-pm Co-authored-by: Elastic Machine --- package.json | 4 +- packages/kbn-pm/dist/index.js | 1919 ++++++++++++++++----------------- yarn.lock | 410 ++++--- 3 files changed, 1190 insertions(+), 1143 deletions(-) diff --git a/package.json b/package.json index ea930d07e7b43..ec72d5b660345 100644 --- a/package.json +++ b/package.json @@ -396,7 +396,7 @@ "axe-core": "^3.4.1", "babel-eslint": "^10.0.3", "babel-jest": "^24.9.0", - "babel-plugin-istanbul": "^5.2.0", + "babel-plugin-istanbul": "^6.0.0", "backport": "5.1.3", "chai": "3.5.0", "chance": "1.0.18", @@ -469,7 +469,7 @@ "nock": "12.0.3", "node-sass": "^4.13.1", "normalize-path": "^3.0.0", - "nyc": "^14.1.1", + "nyc": "^15.0.1", "pixelmatch": "^5.1.0", "pkg-up": "^2.0.0", "pngjs": "^3.4.0", diff --git a/packages/kbn-pm/dist/index.js b/packages/kbn-pm/dist/index.js index 7a858deff41d3..399720f310f67 100644 --- a/packages/kbn-pm/dist/index.js +++ b/packages/kbn-pm/dist/index.js @@ -94,7 +94,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var _cli__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(1); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "run", function() { return _cli__WEBPACK_IMPORTED_MODULE_0__["run"]; }); -/* harmony import */ var _production__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(704); +/* harmony import */ var _production__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(703); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "buildProductionProjects", function() { return _production__WEBPACK_IMPORTED_MODULE_1__["buildProductionProjects"]; }); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "prepareExternalProjectDependencies", function() { return _production__WEBPACK_IMPORTED_MODULE_1__["prepareExternalProjectDependencies"]; }); @@ -105,10 +105,10 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var _utils_project__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(515); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "Project", function() { return _utils_project__WEBPACK_IMPORTED_MODULE_3__["Project"]; }); -/* harmony import */ var _utils_workspaces__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(577); +/* harmony import */ var _utils_workspaces__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(576); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "copyWorkspacePackages", function() { return _utils_workspaces__WEBPACK_IMPORTED_MODULE_4__["copyWorkspacePackages"]; }); -/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(578); +/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(577); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "getProjectPaths", function() { return _config__WEBPACK_IMPORTED_MODULE_5__["getProjectPaths"]; }); /* @@ -152,7 +152,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(16); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_3___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_3__); /* harmony import */ var _commands__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(17); -/* harmony import */ var _run__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(688); +/* harmony import */ var _run__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(687); /* harmony import */ var _utils_log__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(34); /* * Licensed to Elasticsearch B.V. under one or more contributor @@ -2506,9 +2506,9 @@ module.exports = require("path"); __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "commands", function() { return commands; }); /* harmony import */ var _bootstrap__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(18); -/* harmony import */ var _clean__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(585); -/* harmony import */ var _run__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(685); -/* harmony import */ var _watch__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(686); +/* harmony import */ var _clean__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(584); +/* harmony import */ var _run__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(684); +/* harmony import */ var _watch__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(685); /* * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with @@ -2551,8 +2551,8 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var _utils_log__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(34); /* harmony import */ var _utils_parallelize__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(499); /* harmony import */ var _utils_projects__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(500); -/* harmony import */ var _utils_project_checksums__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(579); -/* harmony import */ var _utils_bootstrap_cache_file__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(584); +/* harmony import */ var _utils_project_checksums__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(578); +/* harmony import */ var _utils_bootstrap_cache_file__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(583); /* * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with @@ -43866,7 +43866,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var util__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(util__WEBPACK_IMPORTED_MODULE_2__); /* harmony import */ var _errors__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(514); /* harmony import */ var _project__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(515); -/* harmony import */ var _workspaces__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(577); +/* harmony import */ var _workspaces__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(576); /* * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with @@ -47386,7 +47386,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var _errors__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(514); /* harmony import */ var _log__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(34); /* harmony import */ var _package_json__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(516); -/* harmony import */ var _scripts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(562); +/* harmony import */ var _scripts__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(561); function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; } function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; } @@ -52557,8 +52557,8 @@ const fs = __webpack_require__(545); const writeFileAtomic = __webpack_require__(549); const sortKeys = __webpack_require__(556); const makeDir = __webpack_require__(558); -const pify = __webpack_require__(560); -const detectIndent = __webpack_require__(561); +const pify = __webpack_require__(559); +const detectIndent = __webpack_require__(560); const init = (fn, filePath, data, options) => { if (!filePath) { @@ -54852,81 +54852,6 @@ module.exports = (input, options) => { "use strict"; -const processFn = (fn, options) => function (...args) { - const P = options.promiseModule; - - return new P((resolve, reject) => { - if (options.multiArgs) { - args.push((...result) => { - if (options.errorFirst) { - if (result[0]) { - reject(result); - } else { - result.shift(); - resolve(result); - } - } else { - resolve(result); - } - }); - } else if (options.errorFirst) { - args.push((error, result) => { - if (error) { - reject(error); - } else { - resolve(result); - } - }); - } else { - args.push(resolve); - } - - fn.apply(this, args); - }); -}; - -module.exports = (input, options) => { - options = Object.assign({ - exclude: [/.+(Sync|Stream)$/], - errorFirst: true, - promiseModule: Promise - }, options); - - const objType = typeof input; - if (!(input !== null && (objType === 'object' || objType === 'function'))) { - throw new TypeError(`Expected \`input\` to be a \`Function\` or \`Object\`, got \`${input === null ? 'null' : objType}\``); - } - - const filter = key => { - const match = pattern => typeof pattern === 'string' ? key === pattern : pattern.test(key); - return options.include ? options.include.some(match) : !options.exclude.some(match); - }; - - let ret; - if (objType === 'function') { - ret = function (...args) { - return options.excludeMain ? input(...args) : processFn(input, options).apply(this, args); - }; - } else { - ret = Object.create(Object.getPrototypeOf(input)); - } - - for (const key in input) { // eslint-disable-line guard-for-in - const property = input[key]; - ret[key] = typeof property === 'function' && filter(key) ? processFn(property, options) : property; - } - - return ret; -}; - - -/***/ }), -/* 561 */ -/***/ (function(module, exports, __webpack_require__) { - -"use strict"; - - // detect either spaces or tabs but not both to properly handle tabs // for indentation and spaces for alignment const INDENT_RE = /^(?:( )+|\t+)/; @@ -55050,7 +54975,7 @@ module.exports = str => { /***/ }), -/* 562 */ +/* 561 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -55059,7 +54984,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "runScriptInPackage", function() { return runScriptInPackage; }); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "runScriptInPackageStreaming", function() { return runScriptInPackageStreaming; }); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "yarnWorkspacesInfo", function() { return yarnWorkspacesInfo; }); -/* harmony import */ var _child_process__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(563); +/* harmony import */ var _child_process__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(562); /* * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with @@ -55129,7 +55054,7 @@ async function yarnWorkspacesInfo(directory) { } /***/ }), -/* 563 */ +/* 562 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -55140,9 +55065,9 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(chalk__WEBPACK_IMPORTED_MODULE_0__); /* harmony import */ var execa__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(351); /* harmony import */ var execa__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(execa__WEBPACK_IMPORTED_MODULE_1__); -/* harmony import */ var log_symbols__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(564); +/* harmony import */ var log_symbols__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(563); /* harmony import */ var log_symbols__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(log_symbols__WEBPACK_IMPORTED_MODULE_2__); -/* harmony import */ var strong_log_transformer__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(569); +/* harmony import */ var strong_log_transformer__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(568); /* harmony import */ var strong_log_transformer__WEBPACK_IMPORTED_MODULE_3___default = /*#__PURE__*/__webpack_require__.n(strong_log_transformer__WEBPACK_IMPORTED_MODULE_3__); function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; } @@ -55208,12 +55133,12 @@ function spawnStreaming(command, args, opts, { } /***/ }), -/* 564 */ +/* 563 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const chalk = __webpack_require__(565); +const chalk = __webpack_require__(564); const isSupported = process.platform !== 'win32' || process.env.CI || process.env.TERM === 'xterm-256color'; @@ -55235,16 +55160,16 @@ module.exports = isSupported ? main : fallbacks; /***/ }), -/* 565 */ +/* 564 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const escapeStringRegexp = __webpack_require__(3); -const ansiStyles = __webpack_require__(566); -const stdoutColor = __webpack_require__(567).stdout; +const ansiStyles = __webpack_require__(565); +const stdoutColor = __webpack_require__(566).stdout; -const template = __webpack_require__(568); +const template = __webpack_require__(567); const isSimpleWindowsTerm = process.platform === 'win32' && !(process.env.TERM || '').toLowerCase().startsWith('xterm'); @@ -55470,7 +55395,7 @@ module.exports.default = module.exports; // For TypeScript /***/ }), -/* 566 */ +/* 565 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -55643,7 +55568,7 @@ Object.defineProperty(module, 'exports', { /* WEBPACK VAR INJECTION */}.call(this, __webpack_require__(5)(module))) /***/ }), -/* 567 */ +/* 566 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -55785,7 +55710,7 @@ module.exports = { /***/ }), -/* 568 */ +/* 567 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -55920,7 +55845,7 @@ module.exports = (chalk, tmp) => { /***/ }), -/* 569 */ +/* 568 */ /***/ (function(module, exports, __webpack_require__) { // Copyright IBM Corp. 2014,2018. All Rights Reserved. @@ -55928,12 +55853,12 @@ module.exports = (chalk, tmp) => { // This file is licensed under the Apache License 2.0. // License text available at https://opensource.org/licenses/Apache-2.0 -module.exports = __webpack_require__(570); -module.exports.cli = __webpack_require__(574); +module.exports = __webpack_require__(569); +module.exports.cli = __webpack_require__(573); /***/ }), -/* 570 */ +/* 569 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -55948,9 +55873,9 @@ var stream = __webpack_require__(27); var util = __webpack_require__(29); var fs = __webpack_require__(23); -var through = __webpack_require__(571); -var duplexer = __webpack_require__(572); -var StringDecoder = __webpack_require__(573).StringDecoder; +var through = __webpack_require__(570); +var duplexer = __webpack_require__(571); +var StringDecoder = __webpack_require__(572).StringDecoder; module.exports = Logger; @@ -56139,7 +56064,7 @@ function lineMerger(host) { /***/ }), -/* 571 */ +/* 570 */ /***/ (function(module, exports, __webpack_require__) { var Stream = __webpack_require__(27) @@ -56253,7 +56178,7 @@ function through (write, end, opts) { /***/ }), -/* 572 */ +/* 571 */ /***/ (function(module, exports, __webpack_require__) { var Stream = __webpack_require__(27) @@ -56346,13 +56271,13 @@ function duplex(writer, reader) { /***/ }), -/* 573 */ +/* 572 */ /***/ (function(module, exports) { module.exports = require("string_decoder"); /***/ }), -/* 574 */ +/* 573 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -56363,11 +56288,11 @@ module.exports = require("string_decoder"); -var minimist = __webpack_require__(575); +var minimist = __webpack_require__(574); var path = __webpack_require__(16); -var Logger = __webpack_require__(570); -var pkg = __webpack_require__(576); +var Logger = __webpack_require__(569); +var pkg = __webpack_require__(575); module.exports = cli; @@ -56421,7 +56346,7 @@ function usage($0, p) { /***/ }), -/* 575 */ +/* 574 */ /***/ (function(module, exports) { module.exports = function (args, opts) { @@ -56663,13 +56588,13 @@ function isNumber (x) { /***/ }), -/* 576 */ +/* 575 */ /***/ (function(module) { module.exports = JSON.parse("{\"name\":\"strong-log-transformer\",\"version\":\"2.1.0\",\"description\":\"Stream transformer that prefixes lines with timestamps and other things.\",\"author\":\"Ryan Graham \",\"license\":\"Apache-2.0\",\"repository\":{\"type\":\"git\",\"url\":\"git://github.com/strongloop/strong-log-transformer\"},\"keywords\":[\"logging\",\"streams\"],\"bugs\":{\"url\":\"https://github.com/strongloop/strong-log-transformer/issues\"},\"homepage\":\"https://github.com/strongloop/strong-log-transformer\",\"directories\":{\"test\":\"test\"},\"bin\":{\"sl-log-transformer\":\"bin/sl-log-transformer.js\"},\"main\":\"index.js\",\"scripts\":{\"test\":\"tap --100 test/test-*\"},\"dependencies\":{\"duplexer\":\"^0.1.1\",\"minimist\":\"^1.2.0\",\"through\":\"^2.3.4\"},\"devDependencies\":{\"tap\":\"^12.0.1\"},\"engines\":{\"node\":\">=4\"}}"); /***/ }), -/* 577 */ +/* 576 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -56682,7 +56607,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_1__); /* harmony import */ var util__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(29); /* harmony import */ var util__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(util__WEBPACK_IMPORTED_MODULE_2__); -/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(578); +/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(577); /* harmony import */ var _fs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(20); /* harmony import */ var _package_json__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(516); /* harmony import */ var _projects__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(500); @@ -56777,7 +56702,7 @@ function packagesFromGlobPattern({ } /***/ }), -/* 578 */ +/* 577 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -56847,7 +56772,7 @@ function getProjectPaths({ } /***/ }), -/* 579 */ +/* 578 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -56855,13 +56780,13 @@ __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "getAllChecksums", function() { return getAllChecksums; }); /* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(23); /* harmony import */ var fs__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(fs__WEBPACK_IMPORTED_MODULE_0__); -/* harmony import */ var crypto__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(580); +/* harmony import */ var crypto__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(579); /* harmony import */ var crypto__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(crypto__WEBPACK_IMPORTED_MODULE_1__); /* harmony import */ var util__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(29); /* harmony import */ var util__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(util__WEBPACK_IMPORTED_MODULE_2__); /* harmony import */ var execa__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(351); /* harmony import */ var execa__WEBPACK_IMPORTED_MODULE_3___default = /*#__PURE__*/__webpack_require__.n(execa__WEBPACK_IMPORTED_MODULE_3__); -/* harmony import */ var _yarn_lock__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(581); +/* harmony import */ var _yarn_lock__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(580); /* * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with @@ -57087,19 +57012,19 @@ async function getAllChecksums(kbn, log) { } /***/ }), -/* 580 */ +/* 579 */ /***/ (function(module, exports) { module.exports = require("crypto"); /***/ }), -/* 581 */ +/* 580 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "readYarnLock", function() { return readYarnLock; }); -/* harmony import */ var _yarnpkg_lockfile__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(582); +/* harmony import */ var _yarnpkg_lockfile__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(581); /* harmony import */ var _yarnpkg_lockfile__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(_yarnpkg_lockfile__WEBPACK_IMPORTED_MODULE_0__); /* harmony import */ var _utils_fs__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(20); /* @@ -57143,7 +57068,7 @@ async function readYarnLock(kbn) { } /***/ }), -/* 582 */ +/* 581 */ /***/ (function(module, exports, __webpack_require__) { module.exports = @@ -58702,7 +58627,7 @@ module.exports = invariant; /* 9 */ /***/ (function(module, exports) { -module.exports = __webpack_require__(580); +module.exports = __webpack_require__(579); /***/ }), /* 10 */, @@ -61026,7 +60951,7 @@ function onceStrict (fn) { /* 63 */ /***/ (function(module, exports) { -module.exports = __webpack_require__(583); +module.exports = __webpack_require__(582); /***/ }), /* 64 */, @@ -67421,13 +67346,13 @@ module.exports = process && support(supportLevel); /******/ ]); /***/ }), -/* 583 */ +/* 582 */ /***/ (function(module, exports) { module.exports = require("buffer"); /***/ }), -/* 584 */ +/* 583 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -67524,7 +67449,7 @@ class BootstrapCacheFile { } /***/ }), -/* 585 */ +/* 584 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -67532,9 +67457,9 @@ __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "CleanCommand", function() { return CleanCommand; }); /* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(2); /* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(chalk__WEBPACK_IMPORTED_MODULE_0__); -/* harmony import */ var del__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(586); +/* harmony import */ var del__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(585); /* harmony import */ var del__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(del__WEBPACK_IMPORTED_MODULE_1__); -/* harmony import */ var ora__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(674); +/* harmony import */ var ora__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(673); /* harmony import */ var ora__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(ora__WEBPACK_IMPORTED_MODULE_2__); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(16); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_3___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_3__); @@ -67633,21 +67558,21 @@ const CleanCommand = { }; /***/ }), -/* 586 */ +/* 585 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const {promisify} = __webpack_require__(29); const path = __webpack_require__(16); -const globby = __webpack_require__(587); -const isGlob = __webpack_require__(604); -const slash = __webpack_require__(665); +const globby = __webpack_require__(586); +const isGlob = __webpack_require__(603); +const slash = __webpack_require__(664); const gracefulFs = __webpack_require__(22); -const isPathCwd = __webpack_require__(667); -const isPathInside = __webpack_require__(668); -const rimraf = __webpack_require__(669); -const pMap = __webpack_require__(670); +const isPathCwd = __webpack_require__(666); +const isPathInside = __webpack_require__(667); +const rimraf = __webpack_require__(668); +const pMap = __webpack_require__(669); const rimrafP = promisify(rimraf); @@ -67761,19 +67686,19 @@ module.exports.sync = (patterns, {force, dryRun, cwd = process.cwd(), ...options /***/ }), -/* 587 */ +/* 586 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); -const arrayUnion = __webpack_require__(588); -const merge2 = __webpack_require__(589); -const glob = __webpack_require__(590); -const fastGlob = __webpack_require__(595); -const dirGlob = __webpack_require__(661); -const gitignore = __webpack_require__(663); -const {FilterStream, UniqueStream} = __webpack_require__(666); +const arrayUnion = __webpack_require__(587); +const merge2 = __webpack_require__(588); +const glob = __webpack_require__(589); +const fastGlob = __webpack_require__(594); +const dirGlob = __webpack_require__(660); +const gitignore = __webpack_require__(662); +const {FilterStream, UniqueStream} = __webpack_require__(665); const DEFAULT_FILTER = () => false; @@ -67946,7 +67871,7 @@ module.exports.gitignore = gitignore; /***/ }), -/* 588 */ +/* 587 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -67958,7 +67883,7 @@ module.exports = (...arguments_) => { /***/ }), -/* 589 */ +/* 588 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -68072,7 +67997,7 @@ function pauseStreams (streams, options) { /***/ }), -/* 590 */ +/* 589 */ /***/ (function(module, exports, __webpack_require__) { // Approach: @@ -68121,13 +68046,13 @@ var fs = __webpack_require__(23) var rp = __webpack_require__(502) var minimatch = __webpack_require__(504) var Minimatch = minimatch.Minimatch -var inherits = __webpack_require__(591) +var inherits = __webpack_require__(590) var EE = __webpack_require__(379).EventEmitter var path = __webpack_require__(16) var assert = __webpack_require__(30) var isAbsolute = __webpack_require__(510) -var globSync = __webpack_require__(593) -var common = __webpack_require__(594) +var globSync = __webpack_require__(592) +var common = __webpack_require__(593) var alphasort = common.alphasort var alphasorti = common.alphasorti var setopts = common.setopts @@ -68868,7 +68793,7 @@ Glob.prototype._stat2 = function (f, abs, er, stat, cb) { /***/ }), -/* 591 */ +/* 590 */ /***/ (function(module, exports, __webpack_require__) { try { @@ -68878,12 +68803,12 @@ try { module.exports = util.inherits; } catch (e) { /* istanbul ignore next */ - module.exports = __webpack_require__(592); + module.exports = __webpack_require__(591); } /***/ }), -/* 592 */ +/* 591 */ /***/ (function(module, exports) { if (typeof Object.create === 'function') { @@ -68916,7 +68841,7 @@ if (typeof Object.create === 'function') { /***/ }), -/* 593 */ +/* 592 */ /***/ (function(module, exports, __webpack_require__) { module.exports = globSync @@ -68926,12 +68851,12 @@ var fs = __webpack_require__(23) var rp = __webpack_require__(502) var minimatch = __webpack_require__(504) var Minimatch = minimatch.Minimatch -var Glob = __webpack_require__(590).Glob +var Glob = __webpack_require__(589).Glob var util = __webpack_require__(29) var path = __webpack_require__(16) var assert = __webpack_require__(30) var isAbsolute = __webpack_require__(510) -var common = __webpack_require__(594) +var common = __webpack_require__(593) var alphasort = common.alphasort var alphasorti = common.alphasorti var setopts = common.setopts @@ -69408,7 +69333,7 @@ GlobSync.prototype._makeAbs = function (f) { /***/ }), -/* 594 */ +/* 593 */ /***/ (function(module, exports, __webpack_require__) { exports.alphasort = alphasort @@ -69654,17 +69579,17 @@ function childrenIgnored (self, path) { /***/ }), -/* 595 */ +/* 594 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const taskManager = __webpack_require__(596); -const async_1 = __webpack_require__(624); -const stream_1 = __webpack_require__(657); -const sync_1 = __webpack_require__(658); -const settings_1 = __webpack_require__(660); -const utils = __webpack_require__(597); +const taskManager = __webpack_require__(595); +const async_1 = __webpack_require__(623); +const stream_1 = __webpack_require__(656); +const sync_1 = __webpack_require__(657); +const settings_1 = __webpack_require__(659); +const utils = __webpack_require__(596); function FastGlob(source, options) { try { assertPatternsInput(source); @@ -69722,13 +69647,13 @@ module.exports = FastGlob; /***/ }), -/* 596 */ +/* 595 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const utils = __webpack_require__(597); +const utils = __webpack_require__(596); function generate(patterns, settings) { const positivePatterns = getPositivePatterns(patterns); const negativePatterns = getNegativePatternsAsPositive(patterns, settings.ignore); @@ -69796,28 +69721,28 @@ exports.convertPatternGroupToTask = convertPatternGroupToTask; /***/ }), -/* 597 */ +/* 596 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const array = __webpack_require__(598); +const array = __webpack_require__(597); exports.array = array; -const errno = __webpack_require__(599); +const errno = __webpack_require__(598); exports.errno = errno; -const fs = __webpack_require__(600); +const fs = __webpack_require__(599); exports.fs = fs; -const path = __webpack_require__(601); +const path = __webpack_require__(600); exports.path = path; -const pattern = __webpack_require__(602); +const pattern = __webpack_require__(601); exports.pattern = pattern; -const stream = __webpack_require__(623); +const stream = __webpack_require__(622); exports.stream = stream; /***/ }), -/* 598 */ +/* 597 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -69830,7 +69755,7 @@ exports.flatten = flatten; /***/ }), -/* 599 */ +/* 598 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -69843,7 +69768,7 @@ exports.isEnoentCodeError = isEnoentCodeError; /***/ }), -/* 600 */ +/* 599 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -69868,7 +69793,7 @@ exports.createDirentFromStats = createDirentFromStats; /***/ }), -/* 601 */ +/* 600 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -69889,16 +69814,16 @@ exports.makeAbsolute = makeAbsolute; /***/ }), -/* 602 */ +/* 601 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const path = __webpack_require__(16); -const globParent = __webpack_require__(603); -const isGlob = __webpack_require__(604); -const micromatch = __webpack_require__(606); +const globParent = __webpack_require__(602); +const isGlob = __webpack_require__(603); +const micromatch = __webpack_require__(605); const GLOBSTAR = '**'; function isStaticPattern(pattern) { return !isDynamicPattern(pattern); @@ -69987,13 +69912,13 @@ exports.matchAny = matchAny; /***/ }), -/* 603 */ +/* 602 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isGlob = __webpack_require__(604); +var isGlob = __webpack_require__(603); var pathPosixDirname = __webpack_require__(16).posix.dirname; var isWin32 = __webpack_require__(11).platform() === 'win32'; @@ -70028,7 +69953,7 @@ module.exports = function globParent(str) { /***/ }), -/* 604 */ +/* 603 */ /***/ (function(module, exports, __webpack_require__) { /*! @@ -70038,7 +69963,7 @@ module.exports = function globParent(str) { * Released under the MIT License. */ -var isExtglob = __webpack_require__(605); +var isExtglob = __webpack_require__(604); var chars = { '{': '}', '(': ')', '[': ']'}; var strictRegex = /\\(.)|(^!|\*|[\].+)]\?|\[[^\\\]]+\]|\{[^\\}]+\}|\(\?[:!=][^\\)]+\)|\([^|]+\|[^\\)]+\))/; var relaxedRegex = /\\(.)|(^!|[*?{}()[\]]|\(\?)/; @@ -70082,7 +70007,7 @@ module.exports = function isGlob(str, options) { /***/ }), -/* 605 */ +/* 604 */ /***/ (function(module, exports) { /*! @@ -70108,16 +70033,16 @@ module.exports = function isExtglob(str) { /***/ }), -/* 606 */ +/* 605 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const util = __webpack_require__(29); -const braces = __webpack_require__(607); -const picomatch = __webpack_require__(617); -const utils = __webpack_require__(620); +const braces = __webpack_require__(606); +const picomatch = __webpack_require__(616); +const utils = __webpack_require__(619); const isEmptyString = val => typeof val === 'string' && (val === '' || val === './'); /** @@ -70582,16 +70507,16 @@ module.exports = micromatch; /***/ }), -/* 607 */ +/* 606 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const stringify = __webpack_require__(608); -const compile = __webpack_require__(610); -const expand = __webpack_require__(614); -const parse = __webpack_require__(615); +const stringify = __webpack_require__(607); +const compile = __webpack_require__(609); +const expand = __webpack_require__(613); +const parse = __webpack_require__(614); /** * Expand the given pattern or create a regex-compatible string. @@ -70759,13 +70684,13 @@ module.exports = braces; /***/ }), -/* 608 */ +/* 607 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const utils = __webpack_require__(609); +const utils = __webpack_require__(608); module.exports = (ast, options = {}) => { let stringify = (node, parent = {}) => { @@ -70798,7 +70723,7 @@ module.exports = (ast, options = {}) => { /***/ }), -/* 609 */ +/* 608 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -70917,14 +70842,14 @@ exports.flatten = (...args) => { /***/ }), -/* 610 */ +/* 609 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const fill = __webpack_require__(611); -const utils = __webpack_require__(609); +const fill = __webpack_require__(610); +const utils = __webpack_require__(608); const compile = (ast, options = {}) => { let walk = (node, parent = {}) => { @@ -70981,7 +70906,7 @@ module.exports = compile; /***/ }), -/* 611 */ +/* 610 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -70995,7 +70920,7 @@ module.exports = compile; const util = __webpack_require__(29); -const toRegexRange = __webpack_require__(612); +const toRegexRange = __webpack_require__(611); const isObject = val => val !== null && typeof val === 'object' && !Array.isArray(val); @@ -71237,7 +71162,7 @@ module.exports = fill; /***/ }), -/* 612 */ +/* 611 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -71250,7 +71175,7 @@ module.exports = fill; -const isNumber = __webpack_require__(613); +const isNumber = __webpack_require__(612); const toRegexRange = (min, max, options) => { if (isNumber(min) === false) { @@ -71532,7 +71457,7 @@ module.exports = toRegexRange; /***/ }), -/* 613 */ +/* 612 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -71557,15 +71482,15 @@ module.exports = function(num) { /***/ }), -/* 614 */ +/* 613 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const fill = __webpack_require__(611); -const stringify = __webpack_require__(608); -const utils = __webpack_require__(609); +const fill = __webpack_require__(610); +const stringify = __webpack_require__(607); +const utils = __webpack_require__(608); const append = (queue = '', stash = '', enclose = false) => { let result = []; @@ -71677,13 +71602,13 @@ module.exports = expand; /***/ }), -/* 615 */ +/* 614 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const stringify = __webpack_require__(608); +const stringify = __webpack_require__(607); /** * Constants @@ -71705,7 +71630,7 @@ const { CHAR_SINGLE_QUOTE, /* ' */ CHAR_NO_BREAK_SPACE, CHAR_ZERO_WIDTH_NOBREAK_SPACE -} = __webpack_require__(616); +} = __webpack_require__(615); /** * parse @@ -72017,7 +71942,7 @@ module.exports = parse; /***/ }), -/* 616 */ +/* 615 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -72081,26 +72006,26 @@ module.exports = { /***/ }), -/* 617 */ +/* 616 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -module.exports = __webpack_require__(618); +module.exports = __webpack_require__(617); /***/ }), -/* 618 */ +/* 617 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); -const scan = __webpack_require__(619); -const parse = __webpack_require__(622); -const utils = __webpack_require__(620); +const scan = __webpack_require__(618); +const parse = __webpack_require__(621); +const utils = __webpack_require__(619); /** * Creates a matcher function from one or more glob patterns. The @@ -72403,7 +72328,7 @@ picomatch.toRegex = (source, options) => { * @return {Object} */ -picomatch.constants = __webpack_require__(621); +picomatch.constants = __webpack_require__(620); /** * Expose "picomatch" @@ -72413,13 +72338,13 @@ module.exports = picomatch; /***/ }), -/* 619 */ +/* 618 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const utils = __webpack_require__(620); +const utils = __webpack_require__(619); const { CHAR_ASTERISK, /* * */ @@ -72437,7 +72362,7 @@ const { CHAR_RIGHT_CURLY_BRACE, /* } */ CHAR_RIGHT_PARENTHESES, /* ) */ CHAR_RIGHT_SQUARE_BRACKET /* ] */ -} = __webpack_require__(621); +} = __webpack_require__(620); const isPathSeparator = code => { return code === CHAR_FORWARD_SLASH || code === CHAR_BACKWARD_SLASH; @@ -72639,7 +72564,7 @@ module.exports = (input, options) => { /***/ }), -/* 620 */ +/* 619 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -72651,7 +72576,7 @@ const { REGEX_SPECIAL_CHARS, REGEX_SPECIAL_CHARS_GLOBAL, REGEX_REMOVE_BACKSLASH -} = __webpack_require__(621); +} = __webpack_require__(620); exports.isObject = val => val !== null && typeof val === 'object' && !Array.isArray(val); exports.hasRegexChars = str => REGEX_SPECIAL_CHARS.test(str); @@ -72689,7 +72614,7 @@ exports.escapeLast = (input, char, lastIdx) => { /***/ }), -/* 621 */ +/* 620 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -72875,14 +72800,14 @@ module.exports = { /***/ }), -/* 622 */ +/* 621 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const utils = __webpack_require__(620); -const constants = __webpack_require__(621); +const utils = __webpack_require__(619); +const constants = __webpack_require__(620); /** * Constants @@ -73893,13 +73818,13 @@ module.exports = parse; /***/ }), -/* 623 */ +/* 622 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const merge2 = __webpack_require__(589); +const merge2 = __webpack_require__(588); function merge(streams) { const mergedStream = merge2(streams); streams.forEach((stream) => { @@ -73911,14 +73836,14 @@ exports.merge = merge; /***/ }), -/* 624 */ +/* 623 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const stream_1 = __webpack_require__(625); -const provider_1 = __webpack_require__(652); +const stream_1 = __webpack_require__(624); +const provider_1 = __webpack_require__(651); class ProviderAsync extends provider_1.default { constructor() { super(...arguments); @@ -73946,16 +73871,16 @@ exports.default = ProviderAsync; /***/ }), -/* 625 */ +/* 624 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const stream_1 = __webpack_require__(27); -const fsStat = __webpack_require__(626); -const fsWalk = __webpack_require__(631); -const reader_1 = __webpack_require__(651); +const fsStat = __webpack_require__(625); +const fsWalk = __webpack_require__(630); +const reader_1 = __webpack_require__(650); class ReaderStream extends reader_1.default { constructor() { super(...arguments); @@ -74008,15 +73933,15 @@ exports.default = ReaderStream; /***/ }), -/* 626 */ +/* 625 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const async = __webpack_require__(627); -const sync = __webpack_require__(628); -const settings_1 = __webpack_require__(629); +const async = __webpack_require__(626); +const sync = __webpack_require__(627); +const settings_1 = __webpack_require__(628); exports.Settings = settings_1.default; function stat(path, optionsOrSettingsOrCallback, callback) { if (typeof optionsOrSettingsOrCallback === 'function') { @@ -74039,7 +73964,7 @@ function getSettings(settingsOrOptions = {}) { /***/ }), -/* 627 */ +/* 626 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74077,7 +74002,7 @@ function callSuccessCallback(callback, result) { /***/ }), -/* 628 */ +/* 627 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74106,13 +74031,13 @@ exports.read = read; /***/ }), -/* 629 */ +/* 628 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fs = __webpack_require__(630); +const fs = __webpack_require__(629); class Settings { constructor(_options = {}) { this._options = _options; @@ -74129,7 +74054,7 @@ exports.default = Settings; /***/ }), -/* 630 */ +/* 629 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74152,16 +74077,16 @@ exports.createFileSystemAdapter = createFileSystemAdapter; /***/ }), -/* 631 */ +/* 630 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const async_1 = __webpack_require__(632); -const stream_1 = __webpack_require__(647); -const sync_1 = __webpack_require__(648); -const settings_1 = __webpack_require__(650); +const async_1 = __webpack_require__(631); +const stream_1 = __webpack_require__(646); +const sync_1 = __webpack_require__(647); +const settings_1 = __webpack_require__(649); exports.Settings = settings_1.default; function walk(dir, optionsOrSettingsOrCallback, callback) { if (typeof optionsOrSettingsOrCallback === 'function') { @@ -74191,13 +74116,13 @@ function getSettings(settingsOrOptions = {}) { /***/ }), -/* 632 */ +/* 631 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const async_1 = __webpack_require__(633); +const async_1 = __webpack_require__(632); class AsyncProvider { constructor(_root, _settings) { this._root = _root; @@ -74228,17 +74153,17 @@ function callSuccessCallback(callback, entries) { /***/ }), -/* 633 */ +/* 632 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const events_1 = __webpack_require__(379); -const fsScandir = __webpack_require__(634); -const fastq = __webpack_require__(643); -const common = __webpack_require__(645); -const reader_1 = __webpack_require__(646); +const fsScandir = __webpack_require__(633); +const fastq = __webpack_require__(642); +const common = __webpack_require__(644); +const reader_1 = __webpack_require__(645); class AsyncReader extends reader_1.default { constructor(_root, _settings) { super(_root, _settings); @@ -74328,15 +74253,15 @@ exports.default = AsyncReader; /***/ }), -/* 634 */ +/* 633 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const async = __webpack_require__(635); -const sync = __webpack_require__(640); -const settings_1 = __webpack_require__(641); +const async = __webpack_require__(634); +const sync = __webpack_require__(639); +const settings_1 = __webpack_require__(640); exports.Settings = settings_1.default; function scandir(path, optionsOrSettingsOrCallback, callback) { if (typeof optionsOrSettingsOrCallback === 'function') { @@ -74359,16 +74284,16 @@ function getSettings(settingsOrOptions = {}) { /***/ }), -/* 635 */ +/* 634 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fsStat = __webpack_require__(626); -const rpl = __webpack_require__(636); -const constants_1 = __webpack_require__(637); -const utils = __webpack_require__(638); +const fsStat = __webpack_require__(625); +const rpl = __webpack_require__(635); +const constants_1 = __webpack_require__(636); +const utils = __webpack_require__(637); function read(dir, settings, callback) { if (!settings.stats && constants_1.IS_SUPPORT_READDIR_WITH_FILE_TYPES) { return readdirWithFileTypes(dir, settings, callback); @@ -74457,7 +74382,7 @@ function callSuccessCallback(callback, result) { /***/ }), -/* 636 */ +/* 635 */ /***/ (function(module, exports) { module.exports = runParallel @@ -74511,7 +74436,7 @@ function runParallel (tasks, cb) { /***/ }), -/* 637 */ +/* 636 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74527,18 +74452,18 @@ exports.IS_SUPPORT_READDIR_WITH_FILE_TYPES = MAJOR_VERSION > 10 || (MAJOR_VERSIO /***/ }), -/* 638 */ +/* 637 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fs = __webpack_require__(639); +const fs = __webpack_require__(638); exports.fs = fs; /***/ }), -/* 639 */ +/* 638 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74563,15 +74488,15 @@ exports.createDirentFromStats = createDirentFromStats; /***/ }), -/* 640 */ +/* 639 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fsStat = __webpack_require__(626); -const constants_1 = __webpack_require__(637); -const utils = __webpack_require__(638); +const fsStat = __webpack_require__(625); +const constants_1 = __webpack_require__(636); +const utils = __webpack_require__(637); function read(dir, settings) { if (!settings.stats && constants_1.IS_SUPPORT_READDIR_WITH_FILE_TYPES) { return readdirWithFileTypes(dir, settings); @@ -74622,15 +74547,15 @@ exports.readdir = readdir; /***/ }), -/* 641 */ +/* 640 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const path = __webpack_require__(16); -const fsStat = __webpack_require__(626); -const fs = __webpack_require__(642); +const fsStat = __webpack_require__(625); +const fs = __webpack_require__(641); class Settings { constructor(_options = {}) { this._options = _options; @@ -74653,7 +74578,7 @@ exports.default = Settings; /***/ }), -/* 642 */ +/* 641 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74678,13 +74603,13 @@ exports.createFileSystemAdapter = createFileSystemAdapter; /***/ }), -/* 643 */ +/* 642 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var reusify = __webpack_require__(644) +var reusify = __webpack_require__(643) function fastqueue (context, worker, concurrency) { if (typeof context === 'function') { @@ -74858,7 +74783,7 @@ module.exports = fastqueue /***/ }), -/* 644 */ +/* 643 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74898,7 +74823,7 @@ module.exports = reusify /***/ }), -/* 645 */ +/* 644 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -74929,13 +74854,13 @@ exports.joinPathSegments = joinPathSegments; /***/ }), -/* 646 */ +/* 645 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const common = __webpack_require__(645); +const common = __webpack_require__(644); class Reader { constructor(_root, _settings) { this._root = _root; @@ -74947,14 +74872,14 @@ exports.default = Reader; /***/ }), -/* 647 */ +/* 646 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const stream_1 = __webpack_require__(27); -const async_1 = __webpack_require__(633); +const async_1 = __webpack_require__(632); class StreamProvider { constructor(_root, _settings) { this._root = _root; @@ -74984,13 +74909,13 @@ exports.default = StreamProvider; /***/ }), -/* 648 */ +/* 647 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const sync_1 = __webpack_require__(649); +const sync_1 = __webpack_require__(648); class SyncProvider { constructor(_root, _settings) { this._root = _root; @@ -75005,15 +74930,15 @@ exports.default = SyncProvider; /***/ }), -/* 649 */ +/* 648 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fsScandir = __webpack_require__(634); -const common = __webpack_require__(645); -const reader_1 = __webpack_require__(646); +const fsScandir = __webpack_require__(633); +const common = __webpack_require__(644); +const reader_1 = __webpack_require__(645); class SyncReader extends reader_1.default { constructor() { super(...arguments); @@ -75071,14 +74996,14 @@ exports.default = SyncReader; /***/ }), -/* 650 */ +/* 649 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const path = __webpack_require__(16); -const fsScandir = __webpack_require__(634); +const fsScandir = __webpack_require__(633); class Settings { constructor(_options = {}) { this._options = _options; @@ -75104,15 +75029,15 @@ exports.default = Settings; /***/ }), -/* 651 */ +/* 650 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const path = __webpack_require__(16); -const fsStat = __webpack_require__(626); -const utils = __webpack_require__(597); +const fsStat = __webpack_require__(625); +const utils = __webpack_require__(596); class Reader { constructor(_settings) { this._settings = _settings; @@ -75144,17 +75069,17 @@ exports.default = Reader; /***/ }), -/* 652 */ +/* 651 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const path = __webpack_require__(16); -const deep_1 = __webpack_require__(653); -const entry_1 = __webpack_require__(654); -const error_1 = __webpack_require__(655); -const entry_2 = __webpack_require__(656); +const deep_1 = __webpack_require__(652); +const entry_1 = __webpack_require__(653); +const error_1 = __webpack_require__(654); +const entry_2 = __webpack_require__(655); class Provider { constructor(_settings) { this._settings = _settings; @@ -75199,13 +75124,13 @@ exports.default = Provider; /***/ }), -/* 653 */ +/* 652 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const utils = __webpack_require__(597); +const utils = __webpack_require__(596); class DeepFilter { constructor(_settings, _micromatchOptions) { this._settings = _settings; @@ -75265,13 +75190,13 @@ exports.default = DeepFilter; /***/ }), -/* 654 */ +/* 653 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const utils = __webpack_require__(597); +const utils = __webpack_require__(596); class EntryFilter { constructor(_settings, _micromatchOptions) { this._settings = _settings; @@ -75326,13 +75251,13 @@ exports.default = EntryFilter; /***/ }), -/* 655 */ +/* 654 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const utils = __webpack_require__(597); +const utils = __webpack_require__(596); class ErrorFilter { constructor(_settings) { this._settings = _settings; @@ -75348,13 +75273,13 @@ exports.default = ErrorFilter; /***/ }), -/* 656 */ +/* 655 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const utils = __webpack_require__(597); +const utils = __webpack_require__(596); class EntryTransformer { constructor(_settings) { this._settings = _settings; @@ -75381,15 +75306,15 @@ exports.default = EntryTransformer; /***/ }), -/* 657 */ +/* 656 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); const stream_1 = __webpack_require__(27); -const stream_2 = __webpack_require__(625); -const provider_1 = __webpack_require__(652); +const stream_2 = __webpack_require__(624); +const provider_1 = __webpack_require__(651); class ProviderStream extends provider_1.default { constructor() { super(...arguments); @@ -75417,14 +75342,14 @@ exports.default = ProviderStream; /***/ }), -/* 658 */ +/* 657 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const sync_1 = __webpack_require__(659); -const provider_1 = __webpack_require__(652); +const sync_1 = __webpack_require__(658); +const provider_1 = __webpack_require__(651); class ProviderSync extends provider_1.default { constructor() { super(...arguments); @@ -75447,15 +75372,15 @@ exports.default = ProviderSync; /***/ }), -/* 659 */ +/* 658 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fsStat = __webpack_require__(626); -const fsWalk = __webpack_require__(631); -const reader_1 = __webpack_require__(651); +const fsStat = __webpack_require__(625); +const fsWalk = __webpack_require__(630); +const reader_1 = __webpack_require__(650); class ReaderSync extends reader_1.default { constructor() { super(...arguments); @@ -75497,7 +75422,7 @@ exports.default = ReaderSync; /***/ }), -/* 660 */ +/* 659 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -75557,13 +75482,13 @@ exports.default = Settings; /***/ }), -/* 661 */ +/* 660 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); -const pathType = __webpack_require__(662); +const pathType = __webpack_require__(661); const getExtensions = extensions => extensions.length > 1 ? `{${extensions.join(',')}}` : extensions[0]; @@ -75639,7 +75564,7 @@ module.exports.sync = (input, options) => { /***/ }), -/* 662 */ +/* 661 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -75689,7 +75614,7 @@ exports.isSymlinkSync = isTypeSync.bind(null, 'lstatSync', 'isSymbolicLink'); /***/ }), -/* 663 */ +/* 662 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -75697,9 +75622,9 @@ exports.isSymlinkSync = isTypeSync.bind(null, 'lstatSync', 'isSymbolicLink'); const {promisify} = __webpack_require__(29); const fs = __webpack_require__(23); const path = __webpack_require__(16); -const fastGlob = __webpack_require__(595); -const gitIgnore = __webpack_require__(664); -const slash = __webpack_require__(665); +const fastGlob = __webpack_require__(594); +const gitIgnore = __webpack_require__(663); +const slash = __webpack_require__(664); const DEFAULT_IGNORE = [ '**/node_modules/**', @@ -75813,7 +75738,7 @@ module.exports.sync = options => { /***/ }), -/* 664 */ +/* 663 */ /***/ (function(module, exports) { // A simple implementation of make-array @@ -76404,7 +76329,7 @@ if ( /***/ }), -/* 665 */ +/* 664 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -76422,7 +76347,7 @@ module.exports = path => { /***/ }), -/* 666 */ +/* 665 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -76475,7 +76400,7 @@ module.exports = { /***/ }), -/* 667 */ +/* 666 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -76497,7 +76422,7 @@ module.exports = path_ => { /***/ }), -/* 668 */ +/* 667 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -76525,7 +76450,7 @@ module.exports = (childPath, parentPath) => { /***/ }), -/* 669 */ +/* 668 */ /***/ (function(module, exports, __webpack_require__) { const assert = __webpack_require__(30) @@ -76533,7 +76458,7 @@ const path = __webpack_require__(16) const fs = __webpack_require__(23) let glob = undefined try { - glob = __webpack_require__(590) + glob = __webpack_require__(589) } catch (_err) { // treat glob as optional. } @@ -76899,12 +76824,12 @@ rimraf.sync = rimrafSync /***/ }), -/* 670 */ +/* 669 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const AggregateError = __webpack_require__(671); +const AggregateError = __webpack_require__(670); module.exports = async ( iterable, @@ -76987,13 +76912,13 @@ module.exports = async ( /***/ }), -/* 671 */ +/* 670 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const indentString = __webpack_require__(672); -const cleanStack = __webpack_require__(673); +const indentString = __webpack_require__(671); +const cleanStack = __webpack_require__(672); const cleanInternalStack = stack => stack.replace(/\s+at .*aggregate-error\/index.js:\d+:\d+\)?/g, ''); @@ -77041,7 +76966,7 @@ module.exports = AggregateError; /***/ }), -/* 672 */ +/* 671 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -77083,7 +77008,7 @@ module.exports = (string, count = 1, options) => { /***/ }), -/* 673 */ +/* 672 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -77130,15 +77055,15 @@ module.exports = (stack, options) => { /***/ }), -/* 674 */ +/* 673 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const chalk = __webpack_require__(675); -const cliCursor = __webpack_require__(679); -const cliSpinners = __webpack_require__(683); -const logSymbols = __webpack_require__(564); +const chalk = __webpack_require__(674); +const cliCursor = __webpack_require__(678); +const cliSpinners = __webpack_require__(682); +const logSymbols = __webpack_require__(563); class Ora { constructor(options) { @@ -77285,16 +77210,16 @@ module.exports.promise = (action, options) => { /***/ }), -/* 675 */ +/* 674 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const escapeStringRegexp = __webpack_require__(3); -const ansiStyles = __webpack_require__(676); -const stdoutColor = __webpack_require__(677).stdout; +const ansiStyles = __webpack_require__(675); +const stdoutColor = __webpack_require__(676).stdout; -const template = __webpack_require__(678); +const template = __webpack_require__(677); const isSimpleWindowsTerm = process.platform === 'win32' && !(process.env.TERM || '').toLowerCase().startsWith('xterm'); @@ -77520,7 +77445,7 @@ module.exports.default = module.exports; // For TypeScript /***/ }), -/* 676 */ +/* 675 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -77693,7 +77618,7 @@ Object.defineProperty(module, 'exports', { /* WEBPACK VAR INJECTION */}.call(this, __webpack_require__(5)(module))) /***/ }), -/* 677 */ +/* 676 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -77835,7 +77760,7 @@ module.exports = { /***/ }), -/* 678 */ +/* 677 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -77970,12 +77895,12 @@ module.exports = (chalk, tmp) => { /***/ }), -/* 679 */ +/* 678 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const restoreCursor = __webpack_require__(680); +const restoreCursor = __webpack_require__(679); let hidden = false; @@ -78016,12 +77941,12 @@ exports.toggle = (force, stream) => { /***/ }), -/* 680 */ +/* 679 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const onetime = __webpack_require__(681); +const onetime = __webpack_require__(680); const signalExit = __webpack_require__(377); module.exports = onetime(() => { @@ -78032,12 +77957,12 @@ module.exports = onetime(() => { /***/ }), -/* 681 */ +/* 680 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const mimicFn = __webpack_require__(682); +const mimicFn = __webpack_require__(681); module.exports = (fn, opts) => { // TODO: Remove this in v3 @@ -78078,7 +78003,7 @@ module.exports = (fn, opts) => { /***/ }), -/* 682 */ +/* 681 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -78094,22 +78019,22 @@ module.exports = (to, from) => { /***/ }), -/* 683 */ +/* 682 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -module.exports = __webpack_require__(684); +module.exports = __webpack_require__(683); /***/ }), -/* 684 */ +/* 683 */ /***/ (function(module) { module.exports = JSON.parse("{\"dots\":{\"interval\":80,\"frames\":[\"⠋\",\"⠙\",\"⠹\",\"⠸\",\"⠼\",\"⠴\",\"⠦\",\"⠧\",\"⠇\",\"⠏\"]},\"dots2\":{\"interval\":80,\"frames\":[\"⣾\",\"⣽\",\"⣻\",\"⢿\",\"⡿\",\"⣟\",\"⣯\",\"⣷\"]},\"dots3\":{\"interval\":80,\"frames\":[\"⠋\",\"⠙\",\"⠚\",\"⠞\",\"⠖\",\"⠦\",\"⠴\",\"⠲\",\"⠳\",\"⠓\"]},\"dots4\":{\"interval\":80,\"frames\":[\"⠄\",\"⠆\",\"⠇\",\"⠋\",\"⠙\",\"⠸\",\"⠰\",\"⠠\",\"⠰\",\"⠸\",\"⠙\",\"⠋\",\"⠇\",\"⠆\"]},\"dots5\":{\"interval\":80,\"frames\":[\"⠋\",\"⠙\",\"⠚\",\"⠒\",\"⠂\",\"⠂\",\"⠒\",\"⠲\",\"⠴\",\"⠦\",\"⠖\",\"⠒\",\"⠐\",\"⠐\",\"⠒\",\"⠓\",\"⠋\"]},\"dots6\":{\"interval\":80,\"frames\":[\"⠁\",\"⠉\",\"⠙\",\"⠚\",\"⠒\",\"⠂\",\"⠂\",\"⠒\",\"⠲\",\"⠴\",\"⠤\",\"⠄\",\"⠄\",\"⠤\",\"⠴\",\"⠲\",\"⠒\",\"⠂\",\"⠂\",\"⠒\",\"⠚\",\"⠙\",\"⠉\",\"⠁\"]},\"dots7\":{\"interval\":80,\"frames\":[\"⠈\",\"⠉\",\"⠋\",\"⠓\",\"⠒\",\"⠐\",\"⠐\",\"⠒\",\"⠖\",\"⠦\",\"⠤\",\"⠠\",\"⠠\",\"⠤\",\"⠦\",\"⠖\",\"⠒\",\"⠐\",\"⠐\",\"⠒\",\"⠓\",\"⠋\",\"⠉\",\"⠈\"]},\"dots8\":{\"interval\":80,\"frames\":[\"⠁\",\"⠁\",\"⠉\",\"⠙\",\"⠚\",\"⠒\",\"⠂\",\"⠂\",\"⠒\",\"⠲\",\"⠴\",\"⠤\",\"⠄\",\"⠄\",\"⠤\",\"⠠\",\"⠠\",\"⠤\",\"⠦\",\"⠖\",\"⠒\",\"⠐\",\"⠐\",\"⠒\",\"⠓\",\"⠋\",\"⠉\",\"⠈\",\"⠈\"]},\"dots9\":{\"interval\":80,\"frames\":[\"⢹\",\"⢺\",\"⢼\",\"⣸\",\"⣇\",\"⡧\",\"⡗\",\"⡏\"]},\"dots10\":{\"interval\":80,\"frames\":[\"⢄\",\"⢂\",\"⢁\",\"⡁\",\"⡈\",\"⡐\",\"⡠\"]},\"dots11\":{\"interval\":100,\"frames\":[\"⠁\",\"⠂\",\"⠄\",\"⡀\",\"⢀\",\"⠠\",\"⠐\",\"⠈\"]},\"dots12\":{\"interval\":80,\"frames\":[\"⢀⠀\",\"⡀⠀\",\"⠄⠀\",\"⢂⠀\",\"⡂⠀\",\"⠅⠀\",\"⢃⠀\",\"⡃⠀\",\"⠍⠀\",\"⢋⠀\",\"⡋⠀\",\"⠍⠁\",\"⢋⠁\",\"⡋⠁\",\"⠍⠉\",\"⠋⠉\",\"⠋⠉\",\"⠉⠙\",\"⠉⠙\",\"⠉⠩\",\"⠈⢙\",\"⠈⡙\",\"⢈⠩\",\"⡀⢙\",\"⠄⡙\",\"⢂⠩\",\"⡂⢘\",\"⠅⡘\",\"⢃⠨\",\"⡃⢐\",\"⠍⡐\",\"⢋⠠\",\"⡋⢀\",\"⠍⡁\",\"⢋⠁\",\"⡋⠁\",\"⠍⠉\",\"⠋⠉\",\"⠋⠉\",\"⠉⠙\",\"⠉⠙\",\"⠉⠩\",\"⠈⢙\",\"⠈⡙\",\"⠈⠩\",\"⠀⢙\",\"⠀⡙\",\"⠀⠩\",\"⠀⢘\",\"⠀⡘\",\"⠀⠨\",\"⠀⢐\",\"⠀⡐\",\"⠀⠠\",\"⠀⢀\",\"⠀⡀\"]},\"line\":{\"interval\":130,\"frames\":[\"-\",\"\\\\\",\"|\",\"/\"]},\"line2\":{\"interval\":100,\"frames\":[\"⠂\",\"-\",\"–\",\"—\",\"–\",\"-\"]},\"pipe\":{\"interval\":100,\"frames\":[\"┤\",\"┘\",\"┴\",\"└\",\"├\",\"┌\",\"┬\",\"┐\"]},\"simpleDots\":{\"interval\":400,\"frames\":[\". \",\".. \",\"...\",\" \"]},\"simpleDotsScrolling\":{\"interval\":200,\"frames\":[\". \",\".. \",\"...\",\" ..\",\" .\",\" \"]},\"star\":{\"interval\":70,\"frames\":[\"✶\",\"✸\",\"✹\",\"✺\",\"✹\",\"✷\"]},\"star2\":{\"interval\":80,\"frames\":[\"+\",\"x\",\"*\"]},\"flip\":{\"interval\":70,\"frames\":[\"_\",\"_\",\"_\",\"-\",\"`\",\"`\",\"'\",\"´\",\"-\",\"_\",\"_\",\"_\"]},\"hamburger\":{\"interval\":100,\"frames\":[\"☱\",\"☲\",\"☴\"]},\"growVertical\":{\"interval\":120,\"frames\":[\"▁\",\"▃\",\"▄\",\"▅\",\"▆\",\"▇\",\"▆\",\"▅\",\"▄\",\"▃\"]},\"growHorizontal\":{\"interval\":120,\"frames\":[\"▏\",\"▎\",\"▍\",\"▌\",\"▋\",\"▊\",\"▉\",\"▊\",\"▋\",\"▌\",\"▍\",\"▎\"]},\"balloon\":{\"interval\":140,\"frames\":[\" \",\".\",\"o\",\"O\",\"@\",\"*\",\" \"]},\"balloon2\":{\"interval\":120,\"frames\":[\".\",\"o\",\"O\",\"°\",\"O\",\"o\",\".\"]},\"noise\":{\"interval\":100,\"frames\":[\"▓\",\"▒\",\"░\"]},\"bounce\":{\"interval\":120,\"frames\":[\"⠁\",\"⠂\",\"⠄\",\"⠂\"]},\"boxBounce\":{\"interval\":120,\"frames\":[\"▖\",\"▘\",\"▝\",\"▗\"]},\"boxBounce2\":{\"interval\":100,\"frames\":[\"▌\",\"▀\",\"▐\",\"▄\"]},\"triangle\":{\"interval\":50,\"frames\":[\"◢\",\"◣\",\"◤\",\"◥\"]},\"arc\":{\"interval\":100,\"frames\":[\"◜\",\"◠\",\"◝\",\"◞\",\"◡\",\"◟\"]},\"circle\":{\"interval\":120,\"frames\":[\"◡\",\"⊙\",\"◠\"]},\"squareCorners\":{\"interval\":180,\"frames\":[\"◰\",\"◳\",\"◲\",\"◱\"]},\"circleQuarters\":{\"interval\":120,\"frames\":[\"◴\",\"◷\",\"◶\",\"◵\"]},\"circleHalves\":{\"interval\":50,\"frames\":[\"◐\",\"◓\",\"◑\",\"◒\"]},\"squish\":{\"interval\":100,\"frames\":[\"╫\",\"╪\"]},\"toggle\":{\"interval\":250,\"frames\":[\"⊶\",\"⊷\"]},\"toggle2\":{\"interval\":80,\"frames\":[\"▫\",\"▪\"]},\"toggle3\":{\"interval\":120,\"frames\":[\"□\",\"■\"]},\"toggle4\":{\"interval\":100,\"frames\":[\"■\",\"□\",\"▪\",\"▫\"]},\"toggle5\":{\"interval\":100,\"frames\":[\"▮\",\"▯\"]},\"toggle6\":{\"interval\":300,\"frames\":[\"ဝ\",\"၀\"]},\"toggle7\":{\"interval\":80,\"frames\":[\"⦾\",\"⦿\"]},\"toggle8\":{\"interval\":100,\"frames\":[\"◍\",\"◌\"]},\"toggle9\":{\"interval\":100,\"frames\":[\"◉\",\"◎\"]},\"toggle10\":{\"interval\":100,\"frames\":[\"㊂\",\"㊀\",\"㊁\"]},\"toggle11\":{\"interval\":50,\"frames\":[\"⧇\",\"⧆\"]},\"toggle12\":{\"interval\":120,\"frames\":[\"☗\",\"☖\"]},\"toggle13\":{\"interval\":80,\"frames\":[\"=\",\"*\",\"-\"]},\"arrow\":{\"interval\":100,\"frames\":[\"←\",\"↖\",\"↑\",\"↗\",\"→\",\"↘\",\"↓\",\"↙\"]},\"arrow2\":{\"interval\":80,\"frames\":[\"⬆️ \",\"↗️ \",\"➡️ \",\"↘️ \",\"⬇️ \",\"↙️ \",\"⬅️ \",\"↖️ \"]},\"arrow3\":{\"interval\":120,\"frames\":[\"▹▹▹▹▹\",\"▸▹▹▹▹\",\"▹▸▹▹▹\",\"▹▹▸▹▹\",\"▹▹▹▸▹\",\"▹▹▹▹▸\"]},\"bouncingBar\":{\"interval\":80,\"frames\":[\"[ ]\",\"[= ]\",\"[== ]\",\"[=== ]\",\"[ ===]\",\"[ ==]\",\"[ =]\",\"[ ]\",\"[ =]\",\"[ ==]\",\"[ ===]\",\"[====]\",\"[=== ]\",\"[== ]\",\"[= ]\"]},\"bouncingBall\":{\"interval\":80,\"frames\":[\"( ● )\",\"( ● )\",\"( ● )\",\"( ● )\",\"( ●)\",\"( ● )\",\"( ● )\",\"( ● )\",\"( ● )\",\"(● )\"]},\"smiley\":{\"interval\":200,\"frames\":[\"😄 \",\"😝 \"]},\"monkey\":{\"interval\":300,\"frames\":[\"🙈 \",\"🙈 \",\"🙉 \",\"🙊 \"]},\"hearts\":{\"interval\":100,\"frames\":[\"💛 \",\"💙 \",\"💜 \",\"💚 \",\"❤️ \"]},\"clock\":{\"interval\":100,\"frames\":[\"🕐 \",\"🕑 \",\"🕒 \",\"🕓 \",\"🕔 \",\"🕕 \",\"🕖 \",\"🕗 \",\"🕘 \",\"🕙 \",\"🕚 \"]},\"earth\":{\"interval\":180,\"frames\":[\"🌍 \",\"🌎 \",\"🌏 \"]},\"moon\":{\"interval\":80,\"frames\":[\"🌑 \",\"🌒 \",\"🌓 \",\"🌔 \",\"🌕 \",\"🌖 \",\"🌗 \",\"🌘 \"]},\"runner\":{\"interval\":140,\"frames\":[\"🚶 \",\"🏃 \"]},\"pong\":{\"interval\":80,\"frames\":[\"▐⠂ ▌\",\"▐⠈ ▌\",\"▐ ⠂ ▌\",\"▐ ⠠ ▌\",\"▐ ⡀ ▌\",\"▐ ⠠ ▌\",\"▐ ⠂ ▌\",\"▐ ⠈ ▌\",\"▐ ⠂ ▌\",\"▐ ⠠ ▌\",\"▐ ⡀ ▌\",\"▐ ⠠ ▌\",\"▐ ⠂ ▌\",\"▐ ⠈ ▌\",\"▐ ⠂▌\",\"▐ ⠠▌\",\"▐ ⡀▌\",\"▐ ⠠ ▌\",\"▐ ⠂ ▌\",\"▐ ⠈ ▌\",\"▐ ⠂ ▌\",\"▐ ⠠ ▌\",\"▐ ⡀ ▌\",\"▐ ⠠ ▌\",\"▐ ⠂ ▌\",\"▐ ⠈ ▌\",\"▐ ⠂ ▌\",\"▐ ⠠ ▌\",\"▐ ⡀ ▌\",\"▐⠠ ▌\"]},\"shark\":{\"interval\":120,\"frames\":[\"▐|\\\\____________▌\",\"▐_|\\\\___________▌\",\"▐__|\\\\__________▌\",\"▐___|\\\\_________▌\",\"▐____|\\\\________▌\",\"▐_____|\\\\_______▌\",\"▐______|\\\\______▌\",\"▐_______|\\\\_____▌\",\"▐________|\\\\____▌\",\"▐_________|\\\\___▌\",\"▐__________|\\\\__▌\",\"▐___________|\\\\_▌\",\"▐____________|\\\\▌\",\"▐____________/|▌\",\"▐___________/|_▌\",\"▐__________/|__▌\",\"▐_________/|___▌\",\"▐________/|____▌\",\"▐_______/|_____▌\",\"▐______/|______▌\",\"▐_____/|_______▌\",\"▐____/|________▌\",\"▐___/|_________▌\",\"▐__/|__________▌\",\"▐_/|___________▌\",\"▐/|____________▌\"]},\"dqpb\":{\"interval\":100,\"frames\":[\"d\",\"q\",\"p\",\"b\"]},\"weather\":{\"interval\":100,\"frames\":[\"☀️ \",\"☀️ \",\"☀️ \",\"🌤 \",\"⛅️ \",\"🌥 \",\"☁️ \",\"🌧 \",\"🌨 \",\"🌧 \",\"🌨 \",\"🌧 \",\"🌨 \",\"⛈ \",\"🌨 \",\"🌧 \",\"🌨 \",\"☁️ \",\"🌥 \",\"⛅️ \",\"🌤 \",\"☀️ \",\"☀️ \"]},\"christmas\":{\"interval\":400,\"frames\":[\"🌲\",\"🎄\"]}}"); /***/ }), -/* 685 */ +/* 684 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -78169,7 +78094,7 @@ const RunCommand = { }; /***/ }), -/* 686 */ +/* 685 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -78180,7 +78105,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var _utils_log__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(34); /* harmony import */ var _utils_parallelize__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(499); /* harmony import */ var _utils_projects__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(500); -/* harmony import */ var _utils_watch__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(687); +/* harmony import */ var _utils_watch__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(686); /* * Licensed to Elasticsearch B.V. under one or more contributor * license agreements. See the NOTICE file distributed with @@ -78264,7 +78189,7 @@ const WatchCommand = { }; /***/ }), -/* 687 */ +/* 686 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -78338,7 +78263,7 @@ function waitUntilWatchIsReady(stream, opts = {}) { } /***/ }), -/* 688 */ +/* 687 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -78346,15 +78271,15 @@ __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "runCommand", function() { return runCommand; }); /* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(2); /* harmony import */ var chalk__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(chalk__WEBPACK_IMPORTED_MODULE_0__); -/* harmony import */ var indent_string__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(689); +/* harmony import */ var indent_string__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(688); /* harmony import */ var indent_string__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(indent_string__WEBPACK_IMPORTED_MODULE_1__); -/* harmony import */ var wrap_ansi__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(690); +/* harmony import */ var wrap_ansi__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(689); /* harmony import */ var wrap_ansi__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(wrap_ansi__WEBPACK_IMPORTED_MODULE_2__); /* harmony import */ var _utils_errors__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(514); /* harmony import */ var _utils_log__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(34); /* harmony import */ var _utils_projects__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(500); -/* harmony import */ var _utils_projects_tree__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(697); -/* harmony import */ var _utils_kibana__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(698); +/* harmony import */ var _utils_projects_tree__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(696); +/* harmony import */ var _utils_kibana__WEBPACK_IMPORTED_MODULE_7__ = __webpack_require__(697); function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; } function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; } @@ -78442,7 +78367,7 @@ function toArray(value) { } /***/ }), -/* 689 */ +/* 688 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -78476,13 +78401,13 @@ module.exports = (str, count, opts) => { /***/ }), -/* 690 */ +/* 689 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const stringWidth = __webpack_require__(691); -const stripAnsi = __webpack_require__(695); +const stringWidth = __webpack_require__(690); +const stripAnsi = __webpack_require__(694); const ESCAPES = new Set([ '\u001B', @@ -78676,13 +78601,13 @@ module.exports = (str, cols, opts) => { /***/ }), -/* 691 */ +/* 690 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const stripAnsi = __webpack_require__(692); -const isFullwidthCodePoint = __webpack_require__(694); +const stripAnsi = __webpack_require__(691); +const isFullwidthCodePoint = __webpack_require__(693); module.exports = str => { if (typeof str !== 'string' || str.length === 0) { @@ -78719,18 +78644,18 @@ module.exports = str => { /***/ }), -/* 692 */ +/* 691 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const ansiRegex = __webpack_require__(693); +const ansiRegex = __webpack_require__(692); module.exports = input => typeof input === 'string' ? input.replace(ansiRegex(), '') : input; /***/ }), -/* 693 */ +/* 692 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -78747,7 +78672,7 @@ module.exports = () => { /***/ }), -/* 694 */ +/* 693 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -78800,18 +78725,18 @@ module.exports = x => { /***/ }), -/* 695 */ +/* 694 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const ansiRegex = __webpack_require__(696); +const ansiRegex = __webpack_require__(695); module.exports = input => typeof input === 'string' ? input.replace(ansiRegex(), '') : input; /***/ }), -/* 696 */ +/* 695 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -78828,7 +78753,7 @@ module.exports = () => { /***/ }), -/* 697 */ +/* 696 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -78981,7 +78906,7 @@ function addProjectToTree(tree, pathParts, project) { } /***/ }), -/* 698 */ +/* 697 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; @@ -78989,12 +78914,12 @@ __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "Kibana", function() { return Kibana; }); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(16); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_0__); -/* harmony import */ var multimatch__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(699); +/* harmony import */ var multimatch__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(698); /* harmony import */ var multimatch__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(multimatch__WEBPACK_IMPORTED_MODULE_1__); -/* harmony import */ var is_path_inside__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(703); +/* harmony import */ var is_path_inside__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(702); /* harmony import */ var is_path_inside__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(is_path_inside__WEBPACK_IMPORTED_MODULE_2__); /* harmony import */ var _projects__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(500); -/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(578); +/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(577); function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); if (enumerableOnly) symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; }); keys.push.apply(keys, symbols); } return keys; } function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = arguments[i] != null ? arguments[i] : {}; if (i % 2) { ownKeys(Object(source), true).forEach(function (key) { _defineProperty(target, key, source[key]); }); } else if (Object.getOwnPropertyDescriptors) { Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)); } else { ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } } return target; } @@ -79135,15 +79060,15 @@ class Kibana { } /***/ }), -/* 699 */ +/* 698 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const minimatch = __webpack_require__(504); -const arrayUnion = __webpack_require__(700); -const arrayDiffer = __webpack_require__(701); -const arrify = __webpack_require__(702); +const arrayUnion = __webpack_require__(699); +const arrayDiffer = __webpack_require__(700); +const arrify = __webpack_require__(701); module.exports = (list, patterns, options = {}) => { list = arrify(list); @@ -79167,7 +79092,7 @@ module.exports = (list, patterns, options = {}) => { /***/ }), -/* 700 */ +/* 699 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79179,7 +79104,7 @@ module.exports = (...arguments_) => { /***/ }), -/* 701 */ +/* 700 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79194,7 +79119,7 @@ module.exports = arrayDiffer; /***/ }), -/* 702 */ +/* 701 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79224,7 +79149,7 @@ module.exports = arrify; /***/ }), -/* 703 */ +/* 702 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79252,15 +79177,15 @@ module.exports = (childPath, parentPath) => { /***/ }), -/* 704 */ +/* 703 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; __webpack_require__.r(__webpack_exports__); -/* harmony import */ var _build_production_projects__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(705); +/* harmony import */ var _build_production_projects__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(704); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "buildProductionProjects", function() { return _build_production_projects__WEBPACK_IMPORTED_MODULE_0__["buildProductionProjects"]; }); -/* harmony import */ var _prepare_project_dependencies__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(923); +/* harmony import */ var _prepare_project_dependencies__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(922); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "prepareExternalProjectDependencies", function() { return _prepare_project_dependencies__WEBPACK_IMPORTED_MODULE_1__["prepareExternalProjectDependencies"]; }); /* @@ -79285,19 +79210,19 @@ __webpack_require__.r(__webpack_exports__); /***/ }), -/* 705 */ +/* 704 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; __webpack_require__.r(__webpack_exports__); /* harmony export (binding) */ __webpack_require__.d(__webpack_exports__, "buildProductionProjects", function() { return buildProductionProjects; }); -/* harmony import */ var cpy__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(706); +/* harmony import */ var cpy__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(705); /* harmony import */ var cpy__WEBPACK_IMPORTED_MODULE_0___default = /*#__PURE__*/__webpack_require__.n(cpy__WEBPACK_IMPORTED_MODULE_0__); -/* harmony import */ var del__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(586); +/* harmony import */ var del__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(585); /* harmony import */ var del__WEBPACK_IMPORTED_MODULE_1___default = /*#__PURE__*/__webpack_require__.n(del__WEBPACK_IMPORTED_MODULE_1__); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_2__ = __webpack_require__(16); /* harmony import */ var path__WEBPACK_IMPORTED_MODULE_2___default = /*#__PURE__*/__webpack_require__.n(path__WEBPACK_IMPORTED_MODULE_2__); -/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(578); +/* harmony import */ var _config__WEBPACK_IMPORTED_MODULE_3__ = __webpack_require__(577); /* harmony import */ var _utils_fs__WEBPACK_IMPORTED_MODULE_4__ = __webpack_require__(20); /* harmony import */ var _utils_log__WEBPACK_IMPORTED_MODULE_5__ = __webpack_require__(34); /* harmony import */ var _utils_package_json__WEBPACK_IMPORTED_MODULE_6__ = __webpack_require__(516); @@ -79433,7 +79358,7 @@ async function copyToBuild(project, kibanaRoot, buildRoot) { } /***/ }), -/* 706 */ +/* 705 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79441,13 +79366,13 @@ async function copyToBuild(project, kibanaRoot, buildRoot) { const EventEmitter = __webpack_require__(379); const path = __webpack_require__(16); const os = __webpack_require__(11); -const pAll = __webpack_require__(707); -const arrify = __webpack_require__(709); -const globby = __webpack_require__(710); -const isGlob = __webpack_require__(604); -const cpFile = __webpack_require__(908); -const junk = __webpack_require__(920); -const CpyError = __webpack_require__(921); +const pAll = __webpack_require__(706); +const arrify = __webpack_require__(708); +const globby = __webpack_require__(709); +const isGlob = __webpack_require__(603); +const cpFile = __webpack_require__(907); +const junk = __webpack_require__(919); +const CpyError = __webpack_require__(920); const defaultOptions = { ignoreJunk: true @@ -79566,12 +79491,12 @@ module.exports = (source, destination, { /***/ }), -/* 707 */ +/* 706 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const pMap = __webpack_require__(708); +const pMap = __webpack_require__(707); module.exports = (iterable, options) => pMap(iterable, element => element(), options); // TODO: Remove this for the next major release @@ -79579,7 +79504,7 @@ module.exports.default = module.exports; /***/ }), -/* 708 */ +/* 707 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79658,7 +79583,7 @@ module.exports.default = pMap; /***/ }), -/* 709 */ +/* 708 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79688,17 +79613,17 @@ module.exports = arrify; /***/ }), -/* 710 */ +/* 709 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); -const arrayUnion = __webpack_require__(711); -const glob = __webpack_require__(713); -const fastGlob = __webpack_require__(718); -const dirGlob = __webpack_require__(901); -const gitignore = __webpack_require__(904); +const arrayUnion = __webpack_require__(710); +const glob = __webpack_require__(712); +const fastGlob = __webpack_require__(717); +const dirGlob = __webpack_require__(900); +const gitignore = __webpack_require__(903); const DEFAULT_FILTER = () => false; @@ -79843,12 +79768,12 @@ module.exports.gitignore = gitignore; /***/ }), -/* 711 */ +/* 710 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var arrayUniq = __webpack_require__(712); +var arrayUniq = __webpack_require__(711); module.exports = function () { return arrayUniq([].concat.apply([], arguments)); @@ -79856,7 +79781,7 @@ module.exports = function () { /***/ }), -/* 712 */ +/* 711 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -79925,7 +79850,7 @@ if ('Set' in global) { /***/ }), -/* 713 */ +/* 712 */ /***/ (function(module, exports, __webpack_require__) { // Approach: @@ -79974,13 +79899,13 @@ var fs = __webpack_require__(23) var rp = __webpack_require__(502) var minimatch = __webpack_require__(504) var Minimatch = minimatch.Minimatch -var inherits = __webpack_require__(714) +var inherits = __webpack_require__(713) var EE = __webpack_require__(379).EventEmitter var path = __webpack_require__(16) var assert = __webpack_require__(30) var isAbsolute = __webpack_require__(510) -var globSync = __webpack_require__(716) -var common = __webpack_require__(717) +var globSync = __webpack_require__(715) +var common = __webpack_require__(716) var alphasort = common.alphasort var alphasorti = common.alphasorti var setopts = common.setopts @@ -80721,7 +80646,7 @@ Glob.prototype._stat2 = function (f, abs, er, stat, cb) { /***/ }), -/* 714 */ +/* 713 */ /***/ (function(module, exports, __webpack_require__) { try { @@ -80731,12 +80656,12 @@ try { module.exports = util.inherits; } catch (e) { /* istanbul ignore next */ - module.exports = __webpack_require__(715); + module.exports = __webpack_require__(714); } /***/ }), -/* 715 */ +/* 714 */ /***/ (function(module, exports) { if (typeof Object.create === 'function') { @@ -80769,7 +80694,7 @@ if (typeof Object.create === 'function') { /***/ }), -/* 716 */ +/* 715 */ /***/ (function(module, exports, __webpack_require__) { module.exports = globSync @@ -80779,12 +80704,12 @@ var fs = __webpack_require__(23) var rp = __webpack_require__(502) var minimatch = __webpack_require__(504) var Minimatch = minimatch.Minimatch -var Glob = __webpack_require__(713).Glob +var Glob = __webpack_require__(712).Glob var util = __webpack_require__(29) var path = __webpack_require__(16) var assert = __webpack_require__(30) var isAbsolute = __webpack_require__(510) -var common = __webpack_require__(717) +var common = __webpack_require__(716) var alphasort = common.alphasort var alphasorti = common.alphasorti var setopts = common.setopts @@ -81261,7 +81186,7 @@ GlobSync.prototype._makeAbs = function (f) { /***/ }), -/* 717 */ +/* 716 */ /***/ (function(module, exports, __webpack_require__) { exports.alphasort = alphasort @@ -81507,10 +81432,10 @@ function childrenIgnored (self, path) { /***/ }), -/* 718 */ +/* 717 */ /***/ (function(module, exports, __webpack_require__) { -const pkg = __webpack_require__(719); +const pkg = __webpack_require__(718); module.exports = pkg.async; module.exports.default = pkg.async; @@ -81523,19 +81448,19 @@ module.exports.generateTasks = pkg.generateTasks; /***/ }), -/* 719 */ +/* 718 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var optionsManager = __webpack_require__(720); -var taskManager = __webpack_require__(721); -var reader_async_1 = __webpack_require__(872); -var reader_stream_1 = __webpack_require__(896); -var reader_sync_1 = __webpack_require__(897); -var arrayUtils = __webpack_require__(899); -var streamUtils = __webpack_require__(900); +var optionsManager = __webpack_require__(719); +var taskManager = __webpack_require__(720); +var reader_async_1 = __webpack_require__(871); +var reader_stream_1 = __webpack_require__(895); +var reader_sync_1 = __webpack_require__(896); +var arrayUtils = __webpack_require__(898); +var streamUtils = __webpack_require__(899); /** * Synchronous API. */ @@ -81601,7 +81526,7 @@ function isString(source) { /***/ }), -/* 720 */ +/* 719 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -81639,13 +81564,13 @@ exports.prepare = prepare; /***/ }), -/* 721 */ +/* 720 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var patternUtils = __webpack_require__(722); +var patternUtils = __webpack_require__(721); /** * Generate tasks based on parent directory of each pattern. */ @@ -81736,16 +81661,16 @@ exports.convertPatternGroupToTask = convertPatternGroupToTask; /***/ }), -/* 722 */ +/* 721 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); var path = __webpack_require__(16); -var globParent = __webpack_require__(723); -var isGlob = __webpack_require__(726); -var micromatch = __webpack_require__(727); +var globParent = __webpack_require__(722); +var isGlob = __webpack_require__(725); +var micromatch = __webpack_require__(726); var GLOBSTAR = '**'; /** * Return true for static pattern. @@ -81891,15 +81816,15 @@ exports.matchAny = matchAny; /***/ }), -/* 723 */ +/* 722 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; var path = __webpack_require__(16); -var isglob = __webpack_require__(724); -var pathDirname = __webpack_require__(725); +var isglob = __webpack_require__(723); +var pathDirname = __webpack_require__(724); var isWin32 = __webpack_require__(11).platform() === 'win32'; module.exports = function globParent(str) { @@ -81922,7 +81847,7 @@ module.exports = function globParent(str) { /***/ }), -/* 724 */ +/* 723 */ /***/ (function(module, exports, __webpack_require__) { /*! @@ -81932,7 +81857,7 @@ module.exports = function globParent(str) { * Licensed under the MIT License. */ -var isExtglob = __webpack_require__(605); +var isExtglob = __webpack_require__(604); module.exports = function isGlob(str) { if (typeof str !== 'string' || str === '') { @@ -81953,7 +81878,7 @@ module.exports = function isGlob(str) { /***/ }), -/* 725 */ +/* 724 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -82103,7 +82028,7 @@ module.exports.win32 = win32; /***/ }), -/* 726 */ +/* 725 */ /***/ (function(module, exports, __webpack_require__) { /*! @@ -82113,7 +82038,7 @@ module.exports.win32 = win32; * Released under the MIT License. */ -var isExtglob = __webpack_require__(605); +var isExtglob = __webpack_require__(604); var chars = { '{': '}', '(': ')', '[': ']'}; module.exports = function isGlob(str, options) { @@ -82155,7 +82080,7 @@ module.exports = function isGlob(str, options) { /***/ }), -/* 727 */ +/* 726 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -82166,18 +82091,18 @@ module.exports = function isGlob(str, options) { */ var util = __webpack_require__(29); -var braces = __webpack_require__(728); -var toRegex = __webpack_require__(830); -var extend = __webpack_require__(838); +var braces = __webpack_require__(727); +var toRegex = __webpack_require__(829); +var extend = __webpack_require__(837); /** * Local dependencies */ -var compilers = __webpack_require__(841); -var parsers = __webpack_require__(868); -var cache = __webpack_require__(869); -var utils = __webpack_require__(870); +var compilers = __webpack_require__(840); +var parsers = __webpack_require__(867); +var cache = __webpack_require__(868); +var utils = __webpack_require__(869); var MAX_LENGTH = 1024 * 64; /** @@ -83039,7 +82964,7 @@ module.exports = micromatch; /***/ }), -/* 728 */ +/* 727 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -83049,18 +82974,18 @@ module.exports = micromatch; * Module dependencies */ -var toRegex = __webpack_require__(729); -var unique = __webpack_require__(741); -var extend = __webpack_require__(738); +var toRegex = __webpack_require__(728); +var unique = __webpack_require__(740); +var extend = __webpack_require__(737); /** * Local dependencies */ -var compilers = __webpack_require__(742); -var parsers = __webpack_require__(757); -var Braces = __webpack_require__(767); -var utils = __webpack_require__(743); +var compilers = __webpack_require__(741); +var parsers = __webpack_require__(756); +var Braces = __webpack_require__(766); +var utils = __webpack_require__(742); var MAX_LENGTH = 1024 * 64; var cache = {}; @@ -83364,15 +83289,15 @@ module.exports = braces; /***/ }), -/* 729 */ +/* 728 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var define = __webpack_require__(730); -var extend = __webpack_require__(738); -var not = __webpack_require__(740); +var define = __webpack_require__(729); +var extend = __webpack_require__(737); +var not = __webpack_require__(739); var MAX_LENGTH = 1024 * 64; /** @@ -83519,7 +83444,7 @@ module.exports.makeRe = makeRe; /***/ }), -/* 730 */ +/* 729 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -83532,7 +83457,7 @@ module.exports.makeRe = makeRe; -var isDescriptor = __webpack_require__(731); +var isDescriptor = __webpack_require__(730); module.exports = function defineProperty(obj, prop, val) { if (typeof obj !== 'object' && typeof obj !== 'function') { @@ -83557,7 +83482,7 @@ module.exports = function defineProperty(obj, prop, val) { /***/ }), -/* 731 */ +/* 730 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -83570,9 +83495,9 @@ module.exports = function defineProperty(obj, prop, val) { -var typeOf = __webpack_require__(732); -var isAccessor = __webpack_require__(733); -var isData = __webpack_require__(736); +var typeOf = __webpack_require__(731); +var isAccessor = __webpack_require__(732); +var isData = __webpack_require__(735); module.exports = function isDescriptor(obj, key) { if (typeOf(obj) !== 'object') { @@ -83586,7 +83511,7 @@ module.exports = function isDescriptor(obj, key) { /***/ }), -/* 732 */ +/* 731 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -83739,7 +83664,7 @@ function isBuffer(val) { /***/ }), -/* 733 */ +/* 732 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -83752,7 +83677,7 @@ function isBuffer(val) { -var typeOf = __webpack_require__(734); +var typeOf = __webpack_require__(733); // accessor descriptor properties var accessor = { @@ -83815,10 +83740,10 @@ module.exports = isAccessorDescriptor; /***/ }), -/* 734 */ +/* 733 */ /***/ (function(module, exports, __webpack_require__) { -var isBuffer = __webpack_require__(735); +var isBuffer = __webpack_require__(734); var toString = Object.prototype.toString; /** @@ -83937,7 +83862,7 @@ module.exports = function kindOf(val) { /***/ }), -/* 735 */ +/* 734 */ /***/ (function(module, exports) { /*! @@ -83964,7 +83889,7 @@ function isSlowBuffer (obj) { /***/ }), -/* 736 */ +/* 735 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -83977,7 +83902,7 @@ function isSlowBuffer (obj) { -var typeOf = __webpack_require__(737); +var typeOf = __webpack_require__(736); // data descriptor properties var data = { @@ -84026,10 +83951,10 @@ module.exports = isDataDescriptor; /***/ }), -/* 737 */ +/* 736 */ /***/ (function(module, exports, __webpack_require__) { -var isBuffer = __webpack_require__(735); +var isBuffer = __webpack_require__(734); var toString = Object.prototype.toString; /** @@ -84148,13 +84073,13 @@ module.exports = function kindOf(val) { /***/ }), -/* 738 */ +/* 737 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isObject = __webpack_require__(739); +var isObject = __webpack_require__(738); module.exports = function extend(o/*, objects*/) { if (!isObject(o)) { o = {}; } @@ -84188,7 +84113,7 @@ function hasOwn(obj, key) { /***/ }), -/* 739 */ +/* 738 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -84208,13 +84133,13 @@ module.exports = function isExtendable(val) { /***/ }), -/* 740 */ +/* 739 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var extend = __webpack_require__(738); +var extend = __webpack_require__(737); /** * The main export is a function that takes a `pattern` string and an `options` object. @@ -84281,7 +84206,7 @@ module.exports = toRegex; /***/ }), -/* 741 */ +/* 740 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -84331,13 +84256,13 @@ module.exports.immutable = function uniqueImmutable(arr) { /***/ }), -/* 742 */ +/* 741 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var utils = __webpack_require__(743); +var utils = __webpack_require__(742); module.exports = function(braces, options) { braces.compiler @@ -84620,25 +84545,25 @@ function hasQueue(node) { /***/ }), -/* 743 */ +/* 742 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var splitString = __webpack_require__(744); +var splitString = __webpack_require__(743); var utils = module.exports; /** * Module dependencies */ -utils.extend = __webpack_require__(738); -utils.flatten = __webpack_require__(750); -utils.isObject = __webpack_require__(748); -utils.fillRange = __webpack_require__(751); -utils.repeat = __webpack_require__(756); -utils.unique = __webpack_require__(741); +utils.extend = __webpack_require__(737); +utils.flatten = __webpack_require__(749); +utils.isObject = __webpack_require__(747); +utils.fillRange = __webpack_require__(750); +utils.repeat = __webpack_require__(755); +utils.unique = __webpack_require__(740); utils.define = function(obj, key, val) { Object.defineProperty(obj, key, { @@ -84970,7 +84895,7 @@ utils.escapeRegex = function(str) { /***/ }), -/* 744 */ +/* 743 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -84983,7 +84908,7 @@ utils.escapeRegex = function(str) { -var extend = __webpack_require__(745); +var extend = __webpack_require__(744); module.exports = function(str, options, fn) { if (typeof str !== 'string') { @@ -85148,14 +85073,14 @@ function keepEscaping(opts, str, idx) { /***/ }), -/* 745 */ +/* 744 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isExtendable = __webpack_require__(746); -var assignSymbols = __webpack_require__(749); +var isExtendable = __webpack_require__(745); +var assignSymbols = __webpack_require__(748); module.exports = Object.assign || function(obj/*, objects*/) { if (obj === null || typeof obj === 'undefined') { @@ -85215,7 +85140,7 @@ function isEnum(obj, key) { /***/ }), -/* 746 */ +/* 745 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85228,7 +85153,7 @@ function isEnum(obj, key) { -var isPlainObject = __webpack_require__(747); +var isPlainObject = __webpack_require__(746); module.exports = function isExtendable(val) { return isPlainObject(val) || typeof val === 'function' || Array.isArray(val); @@ -85236,7 +85161,7 @@ module.exports = function isExtendable(val) { /***/ }), -/* 747 */ +/* 746 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85249,7 +85174,7 @@ module.exports = function isExtendable(val) { -var isObject = __webpack_require__(748); +var isObject = __webpack_require__(747); function isObjectObject(o) { return isObject(o) === true @@ -85280,7 +85205,7 @@ module.exports = function isPlainObject(o) { /***/ }), -/* 748 */ +/* 747 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85299,7 +85224,7 @@ module.exports = function isObject(val) { /***/ }), -/* 749 */ +/* 748 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85346,7 +85271,7 @@ module.exports = function(receiver, objects) { /***/ }), -/* 750 */ +/* 749 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85375,7 +85300,7 @@ function flat(arr, res) { /***/ }), -/* 751 */ +/* 750 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85389,10 +85314,10 @@ function flat(arr, res) { var util = __webpack_require__(29); -var isNumber = __webpack_require__(752); -var extend = __webpack_require__(738); -var repeat = __webpack_require__(754); -var toRegex = __webpack_require__(755); +var isNumber = __webpack_require__(751); +var extend = __webpack_require__(737); +var repeat = __webpack_require__(753); +var toRegex = __webpack_require__(754); /** * Return a range of numbers or letters. @@ -85590,7 +85515,7 @@ module.exports = fillRange; /***/ }), -/* 752 */ +/* 751 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85603,7 +85528,7 @@ module.exports = fillRange; -var typeOf = __webpack_require__(753); +var typeOf = __webpack_require__(752); module.exports = function isNumber(num) { var type = typeOf(num); @@ -85619,10 +85544,10 @@ module.exports = function isNumber(num) { /***/ }), -/* 753 */ +/* 752 */ /***/ (function(module, exports, __webpack_require__) { -var isBuffer = __webpack_require__(735); +var isBuffer = __webpack_require__(734); var toString = Object.prototype.toString; /** @@ -85741,7 +85666,7 @@ module.exports = function kindOf(val) { /***/ }), -/* 754 */ +/* 753 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85818,7 +85743,7 @@ function repeat(str, num) { /***/ }), -/* 755 */ +/* 754 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -85831,8 +85756,8 @@ function repeat(str, num) { -var repeat = __webpack_require__(754); -var isNumber = __webpack_require__(752); +var repeat = __webpack_require__(753); +var isNumber = __webpack_require__(751); var cache = {}; function toRegexRange(min, max, options) { @@ -86119,7 +86044,7 @@ module.exports = toRegexRange; /***/ }), -/* 756 */ +/* 755 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -86144,14 +86069,14 @@ module.exports = function repeat(ele, num) { /***/ }), -/* 757 */ +/* 756 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var Node = __webpack_require__(758); -var utils = __webpack_require__(743); +var Node = __webpack_require__(757); +var utils = __webpack_require__(742); /** * Braces parsers @@ -86511,15 +86436,15 @@ function concatNodes(pos, node, parent, options) { /***/ }), -/* 758 */ +/* 757 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isObject = __webpack_require__(748); -var define = __webpack_require__(759); -var utils = __webpack_require__(766); +var isObject = __webpack_require__(747); +var define = __webpack_require__(758); +var utils = __webpack_require__(765); var ownNames; /** @@ -87010,7 +86935,7 @@ exports = module.exports = Node; /***/ }), -/* 759 */ +/* 758 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -87023,7 +86948,7 @@ exports = module.exports = Node; -var isDescriptor = __webpack_require__(760); +var isDescriptor = __webpack_require__(759); module.exports = function defineProperty(obj, prop, val) { if (typeof obj !== 'object' && typeof obj !== 'function') { @@ -87048,7 +86973,7 @@ module.exports = function defineProperty(obj, prop, val) { /***/ }), -/* 760 */ +/* 759 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -87061,9 +86986,9 @@ module.exports = function defineProperty(obj, prop, val) { -var typeOf = __webpack_require__(761); -var isAccessor = __webpack_require__(762); -var isData = __webpack_require__(764); +var typeOf = __webpack_require__(760); +var isAccessor = __webpack_require__(761); +var isData = __webpack_require__(763); module.exports = function isDescriptor(obj, key) { if (typeOf(obj) !== 'object') { @@ -87077,7 +87002,7 @@ module.exports = function isDescriptor(obj, key) { /***/ }), -/* 761 */ +/* 760 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -87212,7 +87137,7 @@ function isBuffer(val) { /***/ }), -/* 762 */ +/* 761 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -87225,7 +87150,7 @@ function isBuffer(val) { -var typeOf = __webpack_require__(763); +var typeOf = __webpack_require__(762); // accessor descriptor properties var accessor = { @@ -87288,7 +87213,7 @@ module.exports = isAccessorDescriptor; /***/ }), -/* 763 */ +/* 762 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -87423,7 +87348,7 @@ function isBuffer(val) { /***/ }), -/* 764 */ +/* 763 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -87436,7 +87361,7 @@ function isBuffer(val) { -var typeOf = __webpack_require__(765); +var typeOf = __webpack_require__(764); module.exports = function isDataDescriptor(obj, prop) { // data descriptor properties @@ -87479,7 +87404,7 @@ module.exports = function isDataDescriptor(obj, prop) { /***/ }), -/* 765 */ +/* 764 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -87614,13 +87539,13 @@ function isBuffer(val) { /***/ }), -/* 766 */ +/* 765 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var typeOf = __webpack_require__(753); +var typeOf = __webpack_require__(752); var utils = module.exports; /** @@ -88640,17 +88565,17 @@ function assert(val, message) { /***/ }), -/* 767 */ +/* 766 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var extend = __webpack_require__(738); -var Snapdragon = __webpack_require__(768); -var compilers = __webpack_require__(742); -var parsers = __webpack_require__(757); -var utils = __webpack_require__(743); +var extend = __webpack_require__(737); +var Snapdragon = __webpack_require__(767); +var compilers = __webpack_require__(741); +var parsers = __webpack_require__(756); +var utils = __webpack_require__(742); /** * Customize Snapdragon parser and renderer @@ -88751,17 +88676,17 @@ module.exports = Braces; /***/ }), -/* 768 */ +/* 767 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var Base = __webpack_require__(769); -var define = __webpack_require__(730); -var Compiler = __webpack_require__(798); -var Parser = __webpack_require__(827); -var utils = __webpack_require__(807); +var Base = __webpack_require__(768); +var define = __webpack_require__(729); +var Compiler = __webpack_require__(797); +var Parser = __webpack_require__(826); +var utils = __webpack_require__(806); var regexCache = {}; var cache = {}; @@ -88932,20 +88857,20 @@ module.exports.Parser = Parser; /***/ }), -/* 769 */ +/* 768 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; var util = __webpack_require__(29); -var define = __webpack_require__(770); -var CacheBase = __webpack_require__(771); -var Emitter = __webpack_require__(772); -var isObject = __webpack_require__(748); -var merge = __webpack_require__(789); -var pascal = __webpack_require__(792); -var cu = __webpack_require__(793); +var define = __webpack_require__(769); +var CacheBase = __webpack_require__(770); +var Emitter = __webpack_require__(771); +var isObject = __webpack_require__(747); +var merge = __webpack_require__(788); +var pascal = __webpack_require__(791); +var cu = __webpack_require__(792); /** * Optionally define a custom `cache` namespace to use. @@ -89374,7 +89299,7 @@ module.exports.namespace = namespace; /***/ }), -/* 770 */ +/* 769 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -89387,7 +89312,7 @@ module.exports.namespace = namespace; -var isDescriptor = __webpack_require__(760); +var isDescriptor = __webpack_require__(759); module.exports = function defineProperty(obj, prop, val) { if (typeof obj !== 'object' && typeof obj !== 'function') { @@ -89412,21 +89337,21 @@ module.exports = function defineProperty(obj, prop, val) { /***/ }), -/* 771 */ +/* 770 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isObject = __webpack_require__(748); -var Emitter = __webpack_require__(772); -var visit = __webpack_require__(773); -var toPath = __webpack_require__(776); -var union = __webpack_require__(777); -var del = __webpack_require__(781); -var get = __webpack_require__(779); -var has = __webpack_require__(786); -var set = __webpack_require__(780); +var isObject = __webpack_require__(747); +var Emitter = __webpack_require__(771); +var visit = __webpack_require__(772); +var toPath = __webpack_require__(775); +var union = __webpack_require__(776); +var del = __webpack_require__(780); +var get = __webpack_require__(778); +var has = __webpack_require__(785); +var set = __webpack_require__(779); /** * Create a `Cache` constructor that when instantiated will @@ -89680,7 +89605,7 @@ module.exports.namespace = namespace; /***/ }), -/* 772 */ +/* 771 */ /***/ (function(module, exports, __webpack_require__) { @@ -89849,7 +89774,7 @@ Emitter.prototype.hasListeners = function(event){ /***/ }), -/* 773 */ +/* 772 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -89862,8 +89787,8 @@ Emitter.prototype.hasListeners = function(event){ -var visit = __webpack_require__(774); -var mapVisit = __webpack_require__(775); +var visit = __webpack_require__(773); +var mapVisit = __webpack_require__(774); module.exports = function(collection, method, val) { var result; @@ -89886,7 +89811,7 @@ module.exports = function(collection, method, val) { /***/ }), -/* 774 */ +/* 773 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -89899,7 +89824,7 @@ module.exports = function(collection, method, val) { -var isObject = __webpack_require__(748); +var isObject = __webpack_require__(747); module.exports = function visit(thisArg, method, target, val) { if (!isObject(thisArg) && typeof thisArg !== 'function') { @@ -89926,14 +89851,14 @@ module.exports = function visit(thisArg, method, target, val) { /***/ }), -/* 775 */ +/* 774 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; var util = __webpack_require__(29); -var visit = __webpack_require__(774); +var visit = __webpack_require__(773); /** * Map `visit` over an array of objects. @@ -89970,7 +89895,7 @@ function isObject(val) { /***/ }), -/* 776 */ +/* 775 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -89983,7 +89908,7 @@ function isObject(val) { -var typeOf = __webpack_require__(753); +var typeOf = __webpack_require__(752); module.exports = function toPath(args) { if (typeOf(args) !== 'arguments') { @@ -90010,16 +89935,16 @@ function filter(arr) { /***/ }), -/* 777 */ +/* 776 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isObject = __webpack_require__(739); -var union = __webpack_require__(778); -var get = __webpack_require__(779); -var set = __webpack_require__(780); +var isObject = __webpack_require__(738); +var union = __webpack_require__(777); +var get = __webpack_require__(778); +var set = __webpack_require__(779); module.exports = function unionValue(obj, prop, value) { if (!isObject(obj)) { @@ -90047,7 +89972,7 @@ function arrayify(val) { /***/ }), -/* 778 */ +/* 777 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90083,7 +90008,7 @@ module.exports = function union(init) { /***/ }), -/* 779 */ +/* 778 */ /***/ (function(module, exports) { /*! @@ -90139,7 +90064,7 @@ function toString(val) { /***/ }), -/* 780 */ +/* 779 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90152,10 +90077,10 @@ function toString(val) { -var split = __webpack_require__(744); -var extend = __webpack_require__(738); -var isPlainObject = __webpack_require__(747); -var isObject = __webpack_require__(739); +var split = __webpack_require__(743); +var extend = __webpack_require__(737); +var isPlainObject = __webpack_require__(746); +var isObject = __webpack_require__(738); module.exports = function(obj, prop, val) { if (!isObject(obj)) { @@ -90201,7 +90126,7 @@ function isValidKey(key) { /***/ }), -/* 781 */ +/* 780 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90214,8 +90139,8 @@ function isValidKey(key) { -var isObject = __webpack_require__(748); -var has = __webpack_require__(782); +var isObject = __webpack_require__(747); +var has = __webpack_require__(781); module.exports = function unset(obj, prop) { if (!isObject(obj)) { @@ -90240,7 +90165,7 @@ module.exports = function unset(obj, prop) { /***/ }), -/* 782 */ +/* 781 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90253,9 +90178,9 @@ module.exports = function unset(obj, prop) { -var isObject = __webpack_require__(783); -var hasValues = __webpack_require__(785); -var get = __webpack_require__(779); +var isObject = __webpack_require__(782); +var hasValues = __webpack_require__(784); +var get = __webpack_require__(778); module.exports = function(obj, prop, noZero) { if (isObject(obj)) { @@ -90266,7 +90191,7 @@ module.exports = function(obj, prop, noZero) { /***/ }), -/* 783 */ +/* 782 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90279,7 +90204,7 @@ module.exports = function(obj, prop, noZero) { -var isArray = __webpack_require__(784); +var isArray = __webpack_require__(783); module.exports = function isObject(val) { return val != null && typeof val === 'object' && isArray(val) === false; @@ -90287,7 +90212,7 @@ module.exports = function isObject(val) { /***/ }), -/* 784 */ +/* 783 */ /***/ (function(module, exports) { var toString = {}.toString; @@ -90298,7 +90223,7 @@ module.exports = Array.isArray || function (arr) { /***/ }), -/* 785 */ +/* 784 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90341,7 +90266,7 @@ module.exports = function hasValue(o, noZero) { /***/ }), -/* 786 */ +/* 785 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90354,9 +90279,9 @@ module.exports = function hasValue(o, noZero) { -var isObject = __webpack_require__(748); -var hasValues = __webpack_require__(787); -var get = __webpack_require__(779); +var isObject = __webpack_require__(747); +var hasValues = __webpack_require__(786); +var get = __webpack_require__(778); module.exports = function(val, prop) { return hasValues(isObject(val) && prop ? get(val, prop) : val); @@ -90364,7 +90289,7 @@ module.exports = function(val, prop) { /***/ }), -/* 787 */ +/* 786 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90377,8 +90302,8 @@ module.exports = function(val, prop) { -var typeOf = __webpack_require__(788); -var isNumber = __webpack_require__(752); +var typeOf = __webpack_require__(787); +var isNumber = __webpack_require__(751); module.exports = function hasValue(val) { // is-number checks for NaN and other edge cases @@ -90431,10 +90356,10 @@ module.exports = function hasValue(val) { /***/ }), -/* 788 */ +/* 787 */ /***/ (function(module, exports, __webpack_require__) { -var isBuffer = __webpack_require__(735); +var isBuffer = __webpack_require__(734); var toString = Object.prototype.toString; /** @@ -90556,14 +90481,14 @@ module.exports = function kindOf(val) { /***/ }), -/* 789 */ +/* 788 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isExtendable = __webpack_require__(790); -var forIn = __webpack_require__(791); +var isExtendable = __webpack_require__(789); +var forIn = __webpack_require__(790); function mixinDeep(target, objects) { var len = arguments.length, i = 0; @@ -90627,7 +90552,7 @@ module.exports = mixinDeep; /***/ }), -/* 790 */ +/* 789 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90640,7 +90565,7 @@ module.exports = mixinDeep; -var isPlainObject = __webpack_require__(747); +var isPlainObject = __webpack_require__(746); module.exports = function isExtendable(val) { return isPlainObject(val) || typeof val === 'function' || Array.isArray(val); @@ -90648,7 +90573,7 @@ module.exports = function isExtendable(val) { /***/ }), -/* 791 */ +/* 790 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -90671,7 +90596,7 @@ module.exports = function forIn(obj, fn, thisArg) { /***/ }), -/* 792 */ +/* 791 */ /***/ (function(module, exports) { /*! @@ -90698,14 +90623,14 @@ module.exports = pascalcase; /***/ }), -/* 793 */ +/* 792 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; var util = __webpack_require__(29); -var utils = __webpack_require__(794); +var utils = __webpack_require__(793); /** * Expose class utils @@ -91070,7 +90995,7 @@ cu.bubble = function(Parent, events) { /***/ }), -/* 794 */ +/* 793 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -91084,10 +91009,10 @@ var utils = {}; * Lazily required module dependencies */ -utils.union = __webpack_require__(778); -utils.define = __webpack_require__(730); -utils.isObj = __webpack_require__(748); -utils.staticExtend = __webpack_require__(795); +utils.union = __webpack_require__(777); +utils.define = __webpack_require__(729); +utils.isObj = __webpack_require__(747); +utils.staticExtend = __webpack_require__(794); /** @@ -91098,7 +91023,7 @@ module.exports = utils; /***/ }), -/* 795 */ +/* 794 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -91111,8 +91036,8 @@ module.exports = utils; -var copy = __webpack_require__(796); -var define = __webpack_require__(730); +var copy = __webpack_require__(795); +var define = __webpack_require__(729); var util = __webpack_require__(29); /** @@ -91195,15 +91120,15 @@ module.exports = extend; /***/ }), -/* 796 */ +/* 795 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var typeOf = __webpack_require__(753); -var copyDescriptor = __webpack_require__(797); -var define = __webpack_require__(730); +var typeOf = __webpack_require__(752); +var copyDescriptor = __webpack_require__(796); +var define = __webpack_require__(729); /** * Copy static properties, prototype properties, and descriptors from one object to another. @@ -91376,7 +91301,7 @@ module.exports.has = has; /***/ }), -/* 797 */ +/* 796 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -91464,16 +91389,16 @@ function isObject(val) { /***/ }), -/* 798 */ +/* 797 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var use = __webpack_require__(799); -var define = __webpack_require__(730); -var debug = __webpack_require__(801)('snapdragon:compiler'); -var utils = __webpack_require__(807); +var use = __webpack_require__(798); +var define = __webpack_require__(729); +var debug = __webpack_require__(800)('snapdragon:compiler'); +var utils = __webpack_require__(806); /** * Create a new `Compiler` with the given `options`. @@ -91627,7 +91552,7 @@ Compiler.prototype = { // source map support if (opts.sourcemap) { - var sourcemaps = __webpack_require__(826); + var sourcemaps = __webpack_require__(825); sourcemaps(this); this.mapVisit(this.ast.nodes); this.applySourceMaps(); @@ -91648,7 +91573,7 @@ module.exports = Compiler; /***/ }), -/* 799 */ +/* 798 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -91661,7 +91586,7 @@ module.exports = Compiler; -var utils = __webpack_require__(800); +var utils = __webpack_require__(799); module.exports = function base(app, opts) { if (!utils.isObject(app) && typeof app !== 'function') { @@ -91776,7 +91701,7 @@ module.exports = function base(app, opts) { /***/ }), -/* 800 */ +/* 799 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -91790,8 +91715,8 @@ var utils = {}; * Lazily required module dependencies */ -utils.define = __webpack_require__(730); -utils.isObject = __webpack_require__(748); +utils.define = __webpack_require__(729); +utils.isObject = __webpack_require__(747); utils.isString = function(val) { @@ -91806,7 +91731,7 @@ module.exports = utils; /***/ }), -/* 801 */ +/* 800 */ /***/ (function(module, exports, __webpack_require__) { /** @@ -91815,14 +91740,14 @@ module.exports = utils; */ if (typeof process !== 'undefined' && process.type === 'renderer') { - module.exports = __webpack_require__(802); + module.exports = __webpack_require__(801); } else { - module.exports = __webpack_require__(805); + module.exports = __webpack_require__(804); } /***/ }), -/* 802 */ +/* 801 */ /***/ (function(module, exports, __webpack_require__) { /** @@ -91831,7 +91756,7 @@ if (typeof process !== 'undefined' && process.type === 'renderer') { * Expose `debug()` as the module. */ -exports = module.exports = __webpack_require__(803); +exports = module.exports = __webpack_require__(802); exports.log = log; exports.formatArgs = formatArgs; exports.save = save; @@ -92013,7 +91938,7 @@ function localstorage() { /***/ }), -/* 803 */ +/* 802 */ /***/ (function(module, exports, __webpack_require__) { @@ -92029,7 +91954,7 @@ exports.coerce = coerce; exports.disable = disable; exports.enable = enable; exports.enabled = enabled; -exports.humanize = __webpack_require__(804); +exports.humanize = __webpack_require__(803); /** * The currently active debug mode names, and names to skip. @@ -92221,7 +92146,7 @@ function coerce(val) { /***/ }), -/* 804 */ +/* 803 */ /***/ (function(module, exports) { /** @@ -92379,7 +92304,7 @@ function plural(ms, n, name) { /***/ }), -/* 805 */ +/* 804 */ /***/ (function(module, exports, __webpack_require__) { /** @@ -92395,7 +92320,7 @@ var util = __webpack_require__(29); * Expose `debug()` as the module. */ -exports = module.exports = __webpack_require__(803); +exports = module.exports = __webpack_require__(802); exports.init = init; exports.log = log; exports.formatArgs = formatArgs; @@ -92574,7 +92499,7 @@ function createWritableStdioStream (fd) { case 'PIPE': case 'TCP': - var net = __webpack_require__(806); + var net = __webpack_require__(805); stream = new net.Socket({ fd: fd, readable: false, @@ -92633,13 +92558,13 @@ exports.enable(load()); /***/ }), -/* 806 */ +/* 805 */ /***/ (function(module, exports) { module.exports = require("net"); /***/ }), -/* 807 */ +/* 806 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -92649,9 +92574,9 @@ module.exports = require("net"); * Module dependencies */ -exports.extend = __webpack_require__(738); -exports.SourceMap = __webpack_require__(808); -exports.sourceMapResolve = __webpack_require__(819); +exports.extend = __webpack_require__(737); +exports.SourceMap = __webpack_require__(807); +exports.sourceMapResolve = __webpack_require__(818); /** * Convert backslash in the given string to forward slashes @@ -92694,7 +92619,7 @@ exports.last = function(arr, n) { /***/ }), -/* 808 */ +/* 807 */ /***/ (function(module, exports, __webpack_require__) { /* @@ -92702,13 +92627,13 @@ exports.last = function(arr, n) { * Licensed under the New BSD license. See LICENSE.txt or: * http://opensource.org/licenses/BSD-3-Clause */ -exports.SourceMapGenerator = __webpack_require__(809).SourceMapGenerator; -exports.SourceMapConsumer = __webpack_require__(815).SourceMapConsumer; -exports.SourceNode = __webpack_require__(818).SourceNode; +exports.SourceMapGenerator = __webpack_require__(808).SourceMapGenerator; +exports.SourceMapConsumer = __webpack_require__(814).SourceMapConsumer; +exports.SourceNode = __webpack_require__(817).SourceNode; /***/ }), -/* 809 */ +/* 808 */ /***/ (function(module, exports, __webpack_require__) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -92718,10 +92643,10 @@ exports.SourceNode = __webpack_require__(818).SourceNode; * http://opensource.org/licenses/BSD-3-Clause */ -var base64VLQ = __webpack_require__(810); -var util = __webpack_require__(812); -var ArraySet = __webpack_require__(813).ArraySet; -var MappingList = __webpack_require__(814).MappingList; +var base64VLQ = __webpack_require__(809); +var util = __webpack_require__(811); +var ArraySet = __webpack_require__(812).ArraySet; +var MappingList = __webpack_require__(813).MappingList; /** * An instance of the SourceMapGenerator represents a source map which is @@ -93130,7 +93055,7 @@ exports.SourceMapGenerator = SourceMapGenerator; /***/ }), -/* 810 */ +/* 809 */ /***/ (function(module, exports, __webpack_require__) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -93170,7 +93095,7 @@ exports.SourceMapGenerator = SourceMapGenerator; * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. */ -var base64 = __webpack_require__(811); +var base64 = __webpack_require__(810); // A single base 64 digit can contain 6 bits of data. For the base 64 variable // length quantities we use in the source map spec, the first bit is the sign, @@ -93276,7 +93201,7 @@ exports.decode = function base64VLQ_decode(aStr, aIndex, aOutParam) { /***/ }), -/* 811 */ +/* 810 */ /***/ (function(module, exports) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -93349,7 +93274,7 @@ exports.decode = function (charCode) { /***/ }), -/* 812 */ +/* 811 */ /***/ (function(module, exports) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -93772,7 +93697,7 @@ exports.compareByGeneratedPositionsInflated = compareByGeneratedPositionsInflate /***/ }), -/* 813 */ +/* 812 */ /***/ (function(module, exports, __webpack_require__) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -93782,7 +93707,7 @@ exports.compareByGeneratedPositionsInflated = compareByGeneratedPositionsInflate * http://opensource.org/licenses/BSD-3-Clause */ -var util = __webpack_require__(812); +var util = __webpack_require__(811); var has = Object.prototype.hasOwnProperty; var hasNativeMap = typeof Map !== "undefined"; @@ -93899,7 +93824,7 @@ exports.ArraySet = ArraySet; /***/ }), -/* 814 */ +/* 813 */ /***/ (function(module, exports, __webpack_require__) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -93909,7 +93834,7 @@ exports.ArraySet = ArraySet; * http://opensource.org/licenses/BSD-3-Clause */ -var util = __webpack_require__(812); +var util = __webpack_require__(811); /** * Determine whether mappingB is after mappingA with respect to generated @@ -93984,7 +93909,7 @@ exports.MappingList = MappingList; /***/ }), -/* 815 */ +/* 814 */ /***/ (function(module, exports, __webpack_require__) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -93994,11 +93919,11 @@ exports.MappingList = MappingList; * http://opensource.org/licenses/BSD-3-Clause */ -var util = __webpack_require__(812); -var binarySearch = __webpack_require__(816); -var ArraySet = __webpack_require__(813).ArraySet; -var base64VLQ = __webpack_require__(810); -var quickSort = __webpack_require__(817).quickSort; +var util = __webpack_require__(811); +var binarySearch = __webpack_require__(815); +var ArraySet = __webpack_require__(812).ArraySet; +var base64VLQ = __webpack_require__(809); +var quickSort = __webpack_require__(816).quickSort; function SourceMapConsumer(aSourceMap) { var sourceMap = aSourceMap; @@ -95072,7 +94997,7 @@ exports.IndexedSourceMapConsumer = IndexedSourceMapConsumer; /***/ }), -/* 816 */ +/* 815 */ /***/ (function(module, exports) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -95189,7 +95114,7 @@ exports.search = function search(aNeedle, aHaystack, aCompare, aBias) { /***/ }), -/* 817 */ +/* 816 */ /***/ (function(module, exports) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -95309,7 +95234,7 @@ exports.quickSort = function (ary, comparator) { /***/ }), -/* 818 */ +/* 817 */ /***/ (function(module, exports, __webpack_require__) { /* -*- Mode: js; js-indent-level: 2; -*- */ @@ -95319,8 +95244,8 @@ exports.quickSort = function (ary, comparator) { * http://opensource.org/licenses/BSD-3-Clause */ -var SourceMapGenerator = __webpack_require__(809).SourceMapGenerator; -var util = __webpack_require__(812); +var SourceMapGenerator = __webpack_require__(808).SourceMapGenerator; +var util = __webpack_require__(811); // Matches a Windows-style `\r\n` newline or a `\n` newline used by all other // operating systems these days (capturing the result). @@ -95728,17 +95653,17 @@ exports.SourceNode = SourceNode; /***/ }), -/* 819 */ +/* 818 */ /***/ (function(module, exports, __webpack_require__) { // Copyright 2014, 2015, 2016, 2017 Simon Lydell // X11 (“MIT”) Licensed. (See LICENSE.) -var sourceMappingURL = __webpack_require__(820) -var resolveUrl = __webpack_require__(821) -var decodeUriComponent = __webpack_require__(822) -var urix = __webpack_require__(824) -var atob = __webpack_require__(825) +var sourceMappingURL = __webpack_require__(819) +var resolveUrl = __webpack_require__(820) +var decodeUriComponent = __webpack_require__(821) +var urix = __webpack_require__(823) +var atob = __webpack_require__(824) @@ -96036,7 +95961,7 @@ module.exports = { /***/ }), -/* 820 */ +/* 819 */ /***/ (function(module, exports, __webpack_require__) { var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_RESULT__;// Copyright 2014 Simon Lydell @@ -96099,7 +96024,7 @@ void (function(root, factory) { /***/ }), -/* 821 */ +/* 820 */ /***/ (function(module, exports, __webpack_require__) { // Copyright 2014 Simon Lydell @@ -96117,13 +96042,13 @@ module.exports = resolveUrl /***/ }), -/* 822 */ +/* 821 */ /***/ (function(module, exports, __webpack_require__) { // Copyright 2017 Simon Lydell // X11 (“MIT”) Licensed. (See LICENSE.) -var decodeUriComponent = __webpack_require__(823) +var decodeUriComponent = __webpack_require__(822) function customDecodeUriComponent(string) { // `decodeUriComponent` turns `+` into ` `, but that's not wanted. @@ -96134,7 +96059,7 @@ module.exports = customDecodeUriComponent /***/ }), -/* 823 */ +/* 822 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -96235,7 +96160,7 @@ module.exports = function (encodedURI) { /***/ }), -/* 824 */ +/* 823 */ /***/ (function(module, exports, __webpack_require__) { // Copyright 2014 Simon Lydell @@ -96258,7 +96183,7 @@ module.exports = urix /***/ }), -/* 825 */ +/* 824 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -96272,7 +96197,7 @@ module.exports = atob.atob = atob; /***/ }), -/* 826 */ +/* 825 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -96280,8 +96205,8 @@ module.exports = atob.atob = atob; var fs = __webpack_require__(23); var path = __webpack_require__(16); -var define = __webpack_require__(730); -var utils = __webpack_require__(807); +var define = __webpack_require__(729); +var utils = __webpack_require__(806); /** * Expose `mixin()`. @@ -96424,19 +96349,19 @@ exports.comment = function(node) { /***/ }), -/* 827 */ +/* 826 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var use = __webpack_require__(799); +var use = __webpack_require__(798); var util = __webpack_require__(29); -var Cache = __webpack_require__(828); -var define = __webpack_require__(730); -var debug = __webpack_require__(801)('snapdragon:parser'); -var Position = __webpack_require__(829); -var utils = __webpack_require__(807); +var Cache = __webpack_require__(827); +var define = __webpack_require__(729); +var debug = __webpack_require__(800)('snapdragon:parser'); +var Position = __webpack_require__(828); +var utils = __webpack_require__(806); /** * Create a new `Parser` with the given `input` and `options`. @@ -96964,7 +96889,7 @@ module.exports = Parser; /***/ }), -/* 828 */ +/* 827 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -97071,13 +96996,13 @@ MapCache.prototype.del = function mapDelete(key) { /***/ }), -/* 829 */ +/* 828 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var define = __webpack_require__(730); +var define = __webpack_require__(729); /** * Store position for a node @@ -97092,16 +97017,16 @@ module.exports = function Position(start, parser) { /***/ }), -/* 830 */ +/* 829 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var safe = __webpack_require__(831); -var define = __webpack_require__(837); -var extend = __webpack_require__(838); -var not = __webpack_require__(840); +var safe = __webpack_require__(830); +var define = __webpack_require__(836); +var extend = __webpack_require__(837); +var not = __webpack_require__(839); var MAX_LENGTH = 1024 * 64; /** @@ -97254,10 +97179,10 @@ module.exports.makeRe = makeRe; /***/ }), -/* 831 */ +/* 830 */ /***/ (function(module, exports, __webpack_require__) { -var parse = __webpack_require__(832); +var parse = __webpack_require__(831); var types = parse.types; module.exports = function (re, opts) { @@ -97303,13 +97228,13 @@ function isRegExp (x) { /***/ }), -/* 832 */ +/* 831 */ /***/ (function(module, exports, __webpack_require__) { -var util = __webpack_require__(833); -var types = __webpack_require__(834); -var sets = __webpack_require__(835); -var positions = __webpack_require__(836); +var util = __webpack_require__(832); +var types = __webpack_require__(833); +var sets = __webpack_require__(834); +var positions = __webpack_require__(835); module.exports = function(regexpStr) { @@ -97591,11 +97516,11 @@ module.exports.types = types; /***/ }), -/* 833 */ +/* 832 */ /***/ (function(module, exports, __webpack_require__) { -var types = __webpack_require__(834); -var sets = __webpack_require__(835); +var types = __webpack_require__(833); +var sets = __webpack_require__(834); // All of these are private and only used by randexp. @@ -97708,7 +97633,7 @@ exports.error = function(regexp, msg) { /***/ }), -/* 834 */ +/* 833 */ /***/ (function(module, exports) { module.exports = { @@ -97724,10 +97649,10 @@ module.exports = { /***/ }), -/* 835 */ +/* 834 */ /***/ (function(module, exports, __webpack_require__) { -var types = __webpack_require__(834); +var types = __webpack_require__(833); var INTS = function() { return [{ type: types.RANGE , from: 48, to: 57 }]; @@ -97812,10 +97737,10 @@ exports.anyChar = function() { /***/ }), -/* 836 */ +/* 835 */ /***/ (function(module, exports, __webpack_require__) { -var types = __webpack_require__(834); +var types = __webpack_require__(833); exports.wordBoundary = function() { return { type: types.POSITION, value: 'b' }; @@ -97835,7 +97760,7 @@ exports.end = function() { /***/ }), -/* 837 */ +/* 836 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -97848,8 +97773,8 @@ exports.end = function() { -var isobject = __webpack_require__(748); -var isDescriptor = __webpack_require__(760); +var isobject = __webpack_require__(747); +var isDescriptor = __webpack_require__(759); var define = (typeof Reflect !== 'undefined' && Reflect.defineProperty) ? Reflect.defineProperty : Object.defineProperty; @@ -97880,14 +97805,14 @@ module.exports = function defineProperty(obj, key, val) { /***/ }), -/* 838 */ +/* 837 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isExtendable = __webpack_require__(839); -var assignSymbols = __webpack_require__(749); +var isExtendable = __webpack_require__(838); +var assignSymbols = __webpack_require__(748); module.exports = Object.assign || function(obj/*, objects*/) { if (obj === null || typeof obj === 'undefined') { @@ -97947,7 +97872,7 @@ function isEnum(obj, key) { /***/ }), -/* 839 */ +/* 838 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -97960,7 +97885,7 @@ function isEnum(obj, key) { -var isPlainObject = __webpack_require__(747); +var isPlainObject = __webpack_require__(746); module.exports = function isExtendable(val) { return isPlainObject(val) || typeof val === 'function' || Array.isArray(val); @@ -97968,14 +97893,14 @@ module.exports = function isExtendable(val) { /***/ }), -/* 840 */ +/* 839 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var extend = __webpack_require__(838); -var safe = __webpack_require__(831); +var extend = __webpack_require__(837); +var safe = __webpack_require__(830); /** * The main export is a function that takes a `pattern` string and an `options` object. @@ -98047,14 +97972,14 @@ module.exports = toRegex; /***/ }), -/* 841 */ +/* 840 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var nanomatch = __webpack_require__(842); -var extglob = __webpack_require__(857); +var nanomatch = __webpack_require__(841); +var extglob = __webpack_require__(856); module.exports = function(snapdragon) { var compilers = snapdragon.compiler.compilers; @@ -98131,7 +98056,7 @@ function escapeExtglobs(compiler) { /***/ }), -/* 842 */ +/* 841 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -98142,17 +98067,17 @@ function escapeExtglobs(compiler) { */ var util = __webpack_require__(29); -var toRegex = __webpack_require__(729); -var extend = __webpack_require__(843); +var toRegex = __webpack_require__(728); +var extend = __webpack_require__(842); /** * Local dependencies */ -var compilers = __webpack_require__(845); -var parsers = __webpack_require__(846); -var cache = __webpack_require__(849); -var utils = __webpack_require__(851); +var compilers = __webpack_require__(844); +var parsers = __webpack_require__(845); +var cache = __webpack_require__(848); +var utils = __webpack_require__(850); var MAX_LENGTH = 1024 * 64; /** @@ -98976,14 +98901,14 @@ module.exports = nanomatch; /***/ }), -/* 843 */ +/* 842 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var isExtendable = __webpack_require__(844); -var assignSymbols = __webpack_require__(749); +var isExtendable = __webpack_require__(843); +var assignSymbols = __webpack_require__(748); module.exports = Object.assign || function(obj/*, objects*/) { if (obj === null || typeof obj === 'undefined') { @@ -99043,7 +98968,7 @@ function isEnum(obj, key) { /***/ }), -/* 844 */ +/* 843 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -99056,7 +98981,7 @@ function isEnum(obj, key) { -var isPlainObject = __webpack_require__(747); +var isPlainObject = __webpack_require__(746); module.exports = function isExtendable(val) { return isPlainObject(val) || typeof val === 'function' || Array.isArray(val); @@ -99064,7 +98989,7 @@ module.exports = function isExtendable(val) { /***/ }), -/* 845 */ +/* 844 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -99410,15 +99335,15 @@ module.exports = function(nanomatch, options) { /***/ }), -/* 846 */ +/* 845 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var regexNot = __webpack_require__(740); -var toRegex = __webpack_require__(729); -var isOdd = __webpack_require__(847); +var regexNot = __webpack_require__(739); +var toRegex = __webpack_require__(728); +var isOdd = __webpack_require__(846); /** * Characters to use in negation regex (we want to "not" match @@ -99804,7 +99729,7 @@ module.exports.not = NOT_REGEX; /***/ }), -/* 847 */ +/* 846 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -99817,7 +99742,7 @@ module.exports.not = NOT_REGEX; -var isNumber = __webpack_require__(848); +var isNumber = __webpack_require__(847); module.exports = function isOdd(i) { if (!isNumber(i)) { @@ -99831,7 +99756,7 @@ module.exports = function isOdd(i) { /***/ }), -/* 848 */ +/* 847 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -99859,14 +99784,14 @@ module.exports = function isNumber(num) { /***/ }), -/* 849 */ +/* 848 */ /***/ (function(module, exports, __webpack_require__) { -module.exports = new (__webpack_require__(850))(); +module.exports = new (__webpack_require__(849))(); /***/ }), -/* 850 */ +/* 849 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -99879,7 +99804,7 @@ module.exports = new (__webpack_require__(850))(); -var MapCache = __webpack_require__(828); +var MapCache = __webpack_require__(827); /** * Create a new `FragmentCache` with an optional object to use for `caches`. @@ -100001,7 +99926,7 @@ exports = module.exports = FragmentCache; /***/ }), -/* 851 */ +/* 850 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -100014,14 +99939,14 @@ var path = __webpack_require__(16); * Module dependencies */ -var isWindows = __webpack_require__(852)(); -var Snapdragon = __webpack_require__(768); -utils.define = __webpack_require__(853); -utils.diff = __webpack_require__(854); -utils.extend = __webpack_require__(843); -utils.pick = __webpack_require__(855); -utils.typeOf = __webpack_require__(856); -utils.unique = __webpack_require__(741); +var isWindows = __webpack_require__(851)(); +var Snapdragon = __webpack_require__(767); +utils.define = __webpack_require__(852); +utils.diff = __webpack_require__(853); +utils.extend = __webpack_require__(842); +utils.pick = __webpack_require__(854); +utils.typeOf = __webpack_require__(855); +utils.unique = __webpack_require__(740); /** * Returns true if the given value is effectively an empty string @@ -100387,7 +100312,7 @@ utils.unixify = function(options) { /***/ }), -/* 852 */ +/* 851 */ /***/ (function(module, exports, __webpack_require__) { var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_DEFINE_RESULT__;/*! @@ -100415,7 +100340,7 @@ var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_ /***/ }), -/* 853 */ +/* 852 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -100428,8 +100353,8 @@ var __WEBPACK_AMD_DEFINE_FACTORY__, __WEBPACK_AMD_DEFINE_ARRAY__, __WEBPACK_AMD_ -var isobject = __webpack_require__(748); -var isDescriptor = __webpack_require__(760); +var isobject = __webpack_require__(747); +var isDescriptor = __webpack_require__(759); var define = (typeof Reflect !== 'undefined' && Reflect.defineProperty) ? Reflect.defineProperty : Object.defineProperty; @@ -100460,7 +100385,7 @@ module.exports = function defineProperty(obj, key, val) { /***/ }), -/* 854 */ +/* 853 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -100514,7 +100439,7 @@ function diffArray(one, two) { /***/ }), -/* 855 */ +/* 854 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -100527,7 +100452,7 @@ function diffArray(one, two) { -var isObject = __webpack_require__(748); +var isObject = __webpack_require__(747); module.exports = function pick(obj, keys) { if (!isObject(obj) && typeof obj !== 'function') { @@ -100556,7 +100481,7 @@ module.exports = function pick(obj, keys) { /***/ }), -/* 856 */ +/* 855 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -100691,7 +100616,7 @@ function isBuffer(val) { /***/ }), -/* 857 */ +/* 856 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -100701,18 +100626,18 @@ function isBuffer(val) { * Module dependencies */ -var extend = __webpack_require__(738); -var unique = __webpack_require__(741); -var toRegex = __webpack_require__(729); +var extend = __webpack_require__(737); +var unique = __webpack_require__(740); +var toRegex = __webpack_require__(728); /** * Local dependencies */ -var compilers = __webpack_require__(858); -var parsers = __webpack_require__(864); -var Extglob = __webpack_require__(867); -var utils = __webpack_require__(866); +var compilers = __webpack_require__(857); +var parsers = __webpack_require__(863); +var Extglob = __webpack_require__(866); +var utils = __webpack_require__(865); var MAX_LENGTH = 1024 * 64; /** @@ -101029,13 +100954,13 @@ module.exports = extglob; /***/ }), -/* 858 */ +/* 857 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var brackets = __webpack_require__(859); +var brackets = __webpack_require__(858); /** * Extglob compilers @@ -101205,7 +101130,7 @@ module.exports = function(extglob) { /***/ }), -/* 859 */ +/* 858 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -101215,17 +101140,17 @@ module.exports = function(extglob) { * Local dependencies */ -var compilers = __webpack_require__(860); -var parsers = __webpack_require__(862); +var compilers = __webpack_require__(859); +var parsers = __webpack_require__(861); /** * Module dependencies */ -var debug = __webpack_require__(801)('expand-brackets'); -var extend = __webpack_require__(738); -var Snapdragon = __webpack_require__(768); -var toRegex = __webpack_require__(729); +var debug = __webpack_require__(800)('expand-brackets'); +var extend = __webpack_require__(737); +var Snapdragon = __webpack_require__(767); +var toRegex = __webpack_require__(728); /** * Parses the given POSIX character class `pattern` and returns a @@ -101423,13 +101348,13 @@ module.exports = brackets; /***/ }), -/* 860 */ +/* 859 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var posix = __webpack_require__(861); +var posix = __webpack_require__(860); module.exports = function(brackets) { brackets.compiler @@ -101517,7 +101442,7 @@ module.exports = function(brackets) { /***/ }), -/* 861 */ +/* 860 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -101546,14 +101471,14 @@ module.exports = { /***/ }), -/* 862 */ +/* 861 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var utils = __webpack_require__(863); -var define = __webpack_require__(730); +var utils = __webpack_require__(862); +var define = __webpack_require__(729); /** * Text regex @@ -101772,14 +101697,14 @@ module.exports.TEXT_REGEX = TEXT_REGEX; /***/ }), -/* 863 */ +/* 862 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var toRegex = __webpack_require__(729); -var regexNot = __webpack_require__(740); +var toRegex = __webpack_require__(728); +var regexNot = __webpack_require__(739); var cached; /** @@ -101813,15 +101738,15 @@ exports.createRegex = function(pattern, include) { /***/ }), -/* 864 */ +/* 863 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var brackets = __webpack_require__(859); -var define = __webpack_require__(865); -var utils = __webpack_require__(866); +var brackets = __webpack_require__(858); +var define = __webpack_require__(864); +var utils = __webpack_require__(865); /** * Characters to use in text regex (we want to "not" match @@ -101976,7 +101901,7 @@ module.exports = parsers; /***/ }), -/* 865 */ +/* 864 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -101989,7 +101914,7 @@ module.exports = parsers; -var isDescriptor = __webpack_require__(760); +var isDescriptor = __webpack_require__(759); module.exports = function defineProperty(obj, prop, val) { if (typeof obj !== 'object' && typeof obj !== 'function') { @@ -102014,14 +101939,14 @@ module.exports = function defineProperty(obj, prop, val) { /***/ }), -/* 866 */ +/* 865 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var regex = __webpack_require__(740); -var Cache = __webpack_require__(850); +var regex = __webpack_require__(739); +var Cache = __webpack_require__(849); /** * Utils @@ -102090,7 +102015,7 @@ utils.createRegex = function(str) { /***/ }), -/* 867 */ +/* 866 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102100,16 +102025,16 @@ utils.createRegex = function(str) { * Module dependencies */ -var Snapdragon = __webpack_require__(768); -var define = __webpack_require__(865); -var extend = __webpack_require__(738); +var Snapdragon = __webpack_require__(767); +var define = __webpack_require__(864); +var extend = __webpack_require__(737); /** * Local dependencies */ -var compilers = __webpack_require__(858); -var parsers = __webpack_require__(864); +var compilers = __webpack_require__(857); +var parsers = __webpack_require__(863); /** * Customize Snapdragon parser and renderer @@ -102175,16 +102100,16 @@ module.exports = Extglob; /***/ }), -/* 868 */ +/* 867 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -var extglob = __webpack_require__(857); -var nanomatch = __webpack_require__(842); -var regexNot = __webpack_require__(740); -var toRegex = __webpack_require__(830); +var extglob = __webpack_require__(856); +var nanomatch = __webpack_require__(841); +var regexNot = __webpack_require__(739); +var toRegex = __webpack_require__(829); var not; /** @@ -102265,14 +102190,14 @@ function textRegex(pattern) { /***/ }), -/* 869 */ +/* 868 */ /***/ (function(module, exports, __webpack_require__) { -module.exports = new (__webpack_require__(850))(); +module.exports = new (__webpack_require__(849))(); /***/ }), -/* 870 */ +/* 869 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102285,13 +102210,13 @@ var path = __webpack_require__(16); * Module dependencies */ -var Snapdragon = __webpack_require__(768); -utils.define = __webpack_require__(837); -utils.diff = __webpack_require__(854); -utils.extend = __webpack_require__(838); -utils.pick = __webpack_require__(855); -utils.typeOf = __webpack_require__(871); -utils.unique = __webpack_require__(741); +var Snapdragon = __webpack_require__(767); +utils.define = __webpack_require__(836); +utils.diff = __webpack_require__(853); +utils.extend = __webpack_require__(837); +utils.pick = __webpack_require__(854); +utils.typeOf = __webpack_require__(870); +utils.unique = __webpack_require__(740); /** * Returns true if the platform is windows, or `path.sep` is `\\`. @@ -102588,7 +102513,7 @@ utils.unixify = function(options) { /***/ }), -/* 871 */ +/* 870 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -102723,7 +102648,7 @@ function isBuffer(val) { /***/ }), -/* 872 */ +/* 871 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102742,9 +102667,9 @@ var __extends = (this && this.__extends) || (function () { }; })(); Object.defineProperty(exports, "__esModule", { value: true }); -var readdir = __webpack_require__(873); -var reader_1 = __webpack_require__(886); -var fs_stream_1 = __webpack_require__(890); +var readdir = __webpack_require__(872); +var reader_1 = __webpack_require__(885); +var fs_stream_1 = __webpack_require__(889); var ReaderAsync = /** @class */ (function (_super) { __extends(ReaderAsync, _super); function ReaderAsync() { @@ -102805,15 +102730,15 @@ exports.default = ReaderAsync; /***/ }), -/* 873 */ +/* 872 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const readdirSync = __webpack_require__(874); -const readdirAsync = __webpack_require__(882); -const readdirStream = __webpack_require__(885); +const readdirSync = __webpack_require__(873); +const readdirAsync = __webpack_require__(881); +const readdirStream = __webpack_require__(884); module.exports = exports = readdirAsyncPath; exports.readdir = exports.readdirAsync = exports.async = readdirAsyncPath; @@ -102897,7 +102822,7 @@ function readdirStreamStat (dir, options) { /***/ }), -/* 874 */ +/* 873 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102905,11 +102830,11 @@ function readdirStreamStat (dir, options) { module.exports = readdirSync; -const DirectoryReader = __webpack_require__(875); +const DirectoryReader = __webpack_require__(874); let syncFacade = { - fs: __webpack_require__(880), - forEach: __webpack_require__(881), + fs: __webpack_require__(879), + forEach: __webpack_require__(880), sync: true }; @@ -102938,7 +102863,7 @@ function readdirSync (dir, options, internalOptions) { /***/ }), -/* 875 */ +/* 874 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102947,9 +102872,9 @@ function readdirSync (dir, options, internalOptions) { const Readable = __webpack_require__(27).Readable; const EventEmitter = __webpack_require__(379).EventEmitter; const path = __webpack_require__(16); -const normalizeOptions = __webpack_require__(876); -const stat = __webpack_require__(878); -const call = __webpack_require__(879); +const normalizeOptions = __webpack_require__(875); +const stat = __webpack_require__(877); +const call = __webpack_require__(878); /** * Asynchronously reads the contents of a directory and streams the results @@ -103325,14 +103250,14 @@ module.exports = DirectoryReader; /***/ }), -/* 876 */ +/* 875 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); -const globToRegExp = __webpack_require__(877); +const globToRegExp = __webpack_require__(876); module.exports = normalizeOptions; @@ -103509,7 +103434,7 @@ function normalizeOptions (options, internalOptions) { /***/ }), -/* 877 */ +/* 876 */ /***/ (function(module, exports) { module.exports = function (glob, opts) { @@ -103646,13 +103571,13 @@ module.exports = function (glob, opts) { /***/ }), -/* 878 */ +/* 877 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const call = __webpack_require__(879); +const call = __webpack_require__(878); module.exports = stat; @@ -103727,7 +103652,7 @@ function symlinkStat (fs, path, lstats, callback) { /***/ }), -/* 879 */ +/* 878 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103788,14 +103713,14 @@ function callOnce (fn) { /***/ }), -/* 880 */ +/* 879 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); -const call = __webpack_require__(879); +const call = __webpack_require__(878); /** * A facade around {@link fs.readdirSync} that allows it to be called @@ -103859,7 +103784,7 @@ exports.lstat = function (path, callback) { /***/ }), -/* 881 */ +/* 880 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103888,7 +103813,7 @@ function syncForEach (array, iterator, done) { /***/ }), -/* 882 */ +/* 881 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103896,12 +103821,12 @@ function syncForEach (array, iterator, done) { module.exports = readdirAsync; -const maybe = __webpack_require__(883); -const DirectoryReader = __webpack_require__(875); +const maybe = __webpack_require__(882); +const DirectoryReader = __webpack_require__(874); let asyncFacade = { fs: __webpack_require__(23), - forEach: __webpack_require__(884), + forEach: __webpack_require__(883), async: true }; @@ -103943,7 +103868,7 @@ function readdirAsync (dir, options, callback, internalOptions) { /***/ }), -/* 883 */ +/* 882 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103970,7 +103895,7 @@ module.exports = function maybe (cb, promise) { /***/ }), -/* 884 */ +/* 883 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104006,7 +103931,7 @@ function asyncForEach (array, iterator, done) { /***/ }), -/* 885 */ +/* 884 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104014,11 +103939,11 @@ function asyncForEach (array, iterator, done) { module.exports = readdirStream; -const DirectoryReader = __webpack_require__(875); +const DirectoryReader = __webpack_require__(874); let streamFacade = { fs: __webpack_require__(23), - forEach: __webpack_require__(884), + forEach: __webpack_require__(883), async: true }; @@ -104038,16 +103963,16 @@ function readdirStream (dir, options, internalOptions) { /***/ }), -/* 886 */ +/* 885 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); var path = __webpack_require__(16); -var deep_1 = __webpack_require__(887); -var entry_1 = __webpack_require__(889); -var pathUtil = __webpack_require__(888); +var deep_1 = __webpack_require__(886); +var entry_1 = __webpack_require__(888); +var pathUtil = __webpack_require__(887); var Reader = /** @class */ (function () { function Reader(options) { this.options = options; @@ -104113,14 +104038,14 @@ exports.default = Reader; /***/ }), -/* 887 */ +/* 886 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var pathUtils = __webpack_require__(888); -var patternUtils = __webpack_require__(722); +var pathUtils = __webpack_require__(887); +var patternUtils = __webpack_require__(721); var DeepFilter = /** @class */ (function () { function DeepFilter(options, micromatchOptions) { this.options = options; @@ -104203,7 +104128,7 @@ exports.default = DeepFilter; /***/ }), -/* 888 */ +/* 887 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104234,14 +104159,14 @@ exports.makeAbsolute = makeAbsolute; /***/ }), -/* 889 */ +/* 888 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var pathUtils = __webpack_require__(888); -var patternUtils = __webpack_require__(722); +var pathUtils = __webpack_require__(887); +var patternUtils = __webpack_require__(721); var EntryFilter = /** @class */ (function () { function EntryFilter(options, micromatchOptions) { this.options = options; @@ -104326,7 +104251,7 @@ exports.default = EntryFilter; /***/ }), -/* 890 */ +/* 889 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104346,8 +104271,8 @@ var __extends = (this && this.__extends) || (function () { })(); Object.defineProperty(exports, "__esModule", { value: true }); var stream = __webpack_require__(27); -var fsStat = __webpack_require__(891); -var fs_1 = __webpack_require__(895); +var fsStat = __webpack_require__(890); +var fs_1 = __webpack_require__(894); var FileSystemStream = /** @class */ (function (_super) { __extends(FileSystemStream, _super); function FileSystemStream() { @@ -104397,14 +104322,14 @@ exports.default = FileSystemStream; /***/ }), -/* 891 */ +/* 890 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const optionsManager = __webpack_require__(892); -const statProvider = __webpack_require__(894); +const optionsManager = __webpack_require__(891); +const statProvider = __webpack_require__(893); /** * Asynchronous API. */ @@ -104435,13 +104360,13 @@ exports.statSync = statSync; /***/ }), -/* 892 */ +/* 891 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fsAdapter = __webpack_require__(893); +const fsAdapter = __webpack_require__(892); function prepare(opts) { const options = Object.assign({ fs: fsAdapter.getFileSystemAdapter(opts ? opts.fs : undefined), @@ -104454,7 +104379,7 @@ exports.prepare = prepare; /***/ }), -/* 893 */ +/* 892 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104477,7 +104402,7 @@ exports.getFileSystemAdapter = getFileSystemAdapter; /***/ }), -/* 894 */ +/* 893 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104529,7 +104454,7 @@ exports.isFollowedSymlink = isFollowedSymlink; /***/ }), -/* 895 */ +/* 894 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104560,7 +104485,7 @@ exports.default = FileSystem; /***/ }), -/* 896 */ +/* 895 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104580,9 +104505,9 @@ var __extends = (this && this.__extends) || (function () { })(); Object.defineProperty(exports, "__esModule", { value: true }); var stream = __webpack_require__(27); -var readdir = __webpack_require__(873); -var reader_1 = __webpack_require__(886); -var fs_stream_1 = __webpack_require__(890); +var readdir = __webpack_require__(872); +var reader_1 = __webpack_require__(885); +var fs_stream_1 = __webpack_require__(889); var TransformStream = /** @class */ (function (_super) { __extends(TransformStream, _super); function TransformStream(reader) { @@ -104650,7 +104575,7 @@ exports.default = ReaderStream; /***/ }), -/* 897 */ +/* 896 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104669,9 +104594,9 @@ var __extends = (this && this.__extends) || (function () { }; })(); Object.defineProperty(exports, "__esModule", { value: true }); -var readdir = __webpack_require__(873); -var reader_1 = __webpack_require__(886); -var fs_sync_1 = __webpack_require__(898); +var readdir = __webpack_require__(872); +var reader_1 = __webpack_require__(885); +var fs_sync_1 = __webpack_require__(897); var ReaderSync = /** @class */ (function (_super) { __extends(ReaderSync, _super); function ReaderSync() { @@ -104731,7 +104656,7 @@ exports.default = ReaderSync; /***/ }), -/* 898 */ +/* 897 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104750,8 +104675,8 @@ var __extends = (this && this.__extends) || (function () { }; })(); Object.defineProperty(exports, "__esModule", { value: true }); -var fsStat = __webpack_require__(891); -var fs_1 = __webpack_require__(895); +var fsStat = __webpack_require__(890); +var fs_1 = __webpack_require__(894); var FileSystemSync = /** @class */ (function (_super) { __extends(FileSystemSync, _super); function FileSystemSync() { @@ -104797,7 +104722,7 @@ exports.default = FileSystemSync; /***/ }), -/* 899 */ +/* 898 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104813,13 +104738,13 @@ exports.flatten = flatten; /***/ }), -/* 900 */ +/* 899 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var merge2 = __webpack_require__(589); +var merge2 = __webpack_require__(588); /** * Merge multiple streams and propagate their errors into one stream in parallel. */ @@ -104834,13 +104759,13 @@ exports.merge = merge; /***/ }), -/* 901 */ +/* 900 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); -const pathType = __webpack_require__(902); +const pathType = __webpack_require__(901); const getExtensions = extensions => extensions.length > 1 ? `{${extensions.join(',')}}` : extensions[0]; @@ -104906,13 +104831,13 @@ module.exports.sync = (input, opts) => { /***/ }), -/* 902 */ +/* 901 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); -const pify = __webpack_require__(903); +const pify = __webpack_require__(902); function type(fn, fn2, fp) { if (typeof fp !== 'string') { @@ -104955,7 +104880,7 @@ exports.symlinkSync = typeSync.bind(null, 'lstatSync', 'isSymbolicLink'); /***/ }), -/* 903 */ +/* 902 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -105046,17 +104971,17 @@ module.exports = (obj, opts) => { /***/ }), -/* 904 */ +/* 903 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); const path = __webpack_require__(16); -const fastGlob = __webpack_require__(718); -const gitIgnore = __webpack_require__(905); -const pify = __webpack_require__(906); -const slash = __webpack_require__(907); +const fastGlob = __webpack_require__(717); +const gitIgnore = __webpack_require__(904); +const pify = __webpack_require__(905); +const slash = __webpack_require__(906); const DEFAULT_IGNORE = [ '**/node_modules/**', @@ -105154,7 +105079,7 @@ module.exports.sync = options => { /***/ }), -/* 905 */ +/* 904 */ /***/ (function(module, exports) { // A simple implementation of make-array @@ -105623,7 +105548,7 @@ module.exports = options => new IgnoreBase(options) /***/ }), -/* 906 */ +/* 905 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -105698,7 +105623,7 @@ module.exports = (input, options) => { /***/ }), -/* 907 */ +/* 906 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -105716,17 +105641,17 @@ module.exports = input => { /***/ }), -/* 908 */ +/* 907 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); const {constants: fsConstants} = __webpack_require__(23); -const pEvent = __webpack_require__(909); -const CpFileError = __webpack_require__(912); -const fs = __webpack_require__(916); -const ProgressEmitter = __webpack_require__(919); +const pEvent = __webpack_require__(908); +const CpFileError = __webpack_require__(911); +const fs = __webpack_require__(915); +const ProgressEmitter = __webpack_require__(918); const cpFileAsync = async (source, destination, options, progressEmitter) => { let readError; @@ -105840,12 +105765,12 @@ module.exports.sync = (source, destination, options) => { /***/ }), -/* 909 */ +/* 908 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const pTimeout = __webpack_require__(910); +const pTimeout = __webpack_require__(909); const symbolAsyncIterator = Symbol.asyncIterator || '@@asyncIterator'; @@ -106136,12 +106061,12 @@ module.exports.iterator = (emitter, event, options) => { /***/ }), -/* 910 */ +/* 909 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const pFinally = __webpack_require__(911); +const pFinally = __webpack_require__(910); class TimeoutError extends Error { constructor(message) { @@ -106187,7 +106112,7 @@ module.exports.TimeoutError = TimeoutError; /***/ }), -/* 911 */ +/* 910 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -106209,12 +106134,12 @@ module.exports = (promise, onFinally) => { /***/ }), -/* 912 */ +/* 911 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const NestedError = __webpack_require__(913); +const NestedError = __webpack_require__(912); class CpFileError extends NestedError { constructor(message, nested) { @@ -106228,10 +106153,10 @@ module.exports = CpFileError; /***/ }), -/* 913 */ +/* 912 */ /***/ (function(module, exports, __webpack_require__) { -var inherits = __webpack_require__(914); +var inherits = __webpack_require__(913); var NestedError = function (message, nested) { this.nested = nested; @@ -106282,7 +106207,7 @@ module.exports = NestedError; /***/ }), -/* 914 */ +/* 913 */ /***/ (function(module, exports, __webpack_require__) { try { @@ -106290,12 +106215,12 @@ try { if (typeof util.inherits !== 'function') throw ''; module.exports = util.inherits; } catch (e) { - module.exports = __webpack_require__(915); + module.exports = __webpack_require__(914); } /***/ }), -/* 915 */ +/* 914 */ /***/ (function(module, exports) { if (typeof Object.create === 'function') { @@ -106324,16 +106249,16 @@ if (typeof Object.create === 'function') { /***/ }), -/* 916 */ +/* 915 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const {promisify} = __webpack_require__(29); const fs = __webpack_require__(22); -const makeDir = __webpack_require__(917); -const pEvent = __webpack_require__(909); -const CpFileError = __webpack_require__(912); +const makeDir = __webpack_require__(916); +const pEvent = __webpack_require__(908); +const CpFileError = __webpack_require__(911); const stat = promisify(fs.stat); const lstat = promisify(fs.lstat); @@ -106430,7 +106355,7 @@ exports.copyFileSync = (source, destination, flags) => { /***/ }), -/* 917 */ +/* 916 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -106438,7 +106363,7 @@ exports.copyFileSync = (source, destination, flags) => { const fs = __webpack_require__(23); const path = __webpack_require__(16); const {promisify} = __webpack_require__(29); -const semver = __webpack_require__(918); +const semver = __webpack_require__(917); const defaults = { mode: 0o777 & (~process.umask()), @@ -106587,7 +106512,7 @@ module.exports.sync = (input, options) => { /***/ }), -/* 918 */ +/* 917 */ /***/ (function(module, exports) { exports = module.exports = SemVer @@ -108189,7 +108114,7 @@ function coerce (version, options) { /***/ }), -/* 919 */ +/* 918 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -108230,7 +108155,7 @@ module.exports = ProgressEmitter; /***/ }), -/* 920 */ +/* 919 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -108276,12 +108201,12 @@ exports.default = module.exports; /***/ }), -/* 921 */ +/* 920 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const NestedError = __webpack_require__(922); +const NestedError = __webpack_require__(921); class CpyError extends NestedError { constructor(message, nested) { @@ -108295,7 +108220,7 @@ module.exports = CpyError; /***/ }), -/* 922 */ +/* 921 */ /***/ (function(module, exports, __webpack_require__) { var inherits = __webpack_require__(29).inherits; @@ -108351,7 +108276,7 @@ module.exports = NestedError; /***/ }), -/* 923 */ +/* 922 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; diff --git a/yarn.lock b/yarn.lock index 20e33fdefc996..11abd95498c8d 100644 --- a/yarn.lock +++ b/yarn.lock @@ -61,7 +61,7 @@ semver "^5.4.1" source-map "^0.5.0" -"@babel/core@^7.0.0", "@babel/core@^7.0.1", "@babel/core@^7.1.0", "@babel/core@^7.4.3", "@babel/core@^7.9.0": +"@babel/core@^7.0.0", "@babel/core@^7.0.1", "@babel/core@^7.1.0", "@babel/core@^7.4.3", "@babel/core@^7.7.5", "@babel/core@^7.9.0": version "7.9.0" resolved "https://registry.yarnpkg.com/@babel/core/-/core-7.9.0.tgz#ac977b538b77e132ff706f3b8a4dbad09c03c56e" integrity sha512-kWc7L0fw1xwvI0zi8OKVBuxRVefwGOrKSQMvrQ3dW+bIIavBY3/NpXmpjMy7bQnLgwgzWQZ8TlM57YHpHNHz4w== @@ -83,7 +83,7 @@ semver "^5.4.1" source-map "^0.5.0" -"@babel/generator@^7.0.0", "@babel/generator@^7.4.0", "@babel/generator@^7.5.5", "@babel/generator@^7.9.0": +"@babel/generator@^7.0.0", "@babel/generator@^7.5.5", "@babel/generator@^7.9.0": version "7.9.4" resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.9.4.tgz#12441e90c3b3c4159cdecf312075bf1a8ce2dbce" integrity sha512-rjP8ahaDy/ouhrvCoU1E5mqaitWrxwuNGU+dy1EpaoK48jZay4MdkskKGIMHLZNewg8sAsqpGSREJwP0zH3YQA== @@ -93,6 +93,16 @@ lodash "^4.17.13" source-map "^0.5.0" +"@babel/generator@^7.9.5": + version "7.9.5" + resolved "https://registry.yarnpkg.com/@babel/generator/-/generator-7.9.5.tgz#27f0917741acc41e6eaaced6d68f96c3fa9afaf9" + integrity sha512-GbNIxVB3ZJe3tLeDm1HSn2AhuD/mVcyLDpgtLXa5tplmWrJdF/elxB56XNqCuD6szyNkDi6wuoKXln3QeBmCHQ== + dependencies: + "@babel/types" "^7.9.5" + jsesc "^2.5.1" + lodash "^4.17.13" + source-map "^0.5.0" + "@babel/helper-annotate-as-pure@^7.0.0", "@babel/helper-annotate-as-pure@^7.8.3": version "7.8.3" resolved "https://registry.yarnpkg.com/@babel/helper-annotate-as-pure/-/helper-annotate-as-pure-7.8.3.tgz#60bc0bc657f63a0924ff9a4b4a0b24a13cf4deee" @@ -183,6 +193,15 @@ "@babel/template" "^7.8.3" "@babel/types" "^7.8.3" +"@babel/helper-function-name@^7.9.5": + version "7.9.5" + resolved "https://registry.yarnpkg.com/@babel/helper-function-name/-/helper-function-name-7.9.5.tgz#2b53820d35275120e1874a82e5aabe1376920a5c" + integrity sha512-JVcQZeXM59Cd1qanDUxv9fgJpt3NeKUaqBqUEvfmQ+BCOKq2xUgaWZW2hr0dkbyJgezYuplEoh5knmrnS68efw== + dependencies: + "@babel/helper-get-function-arity" "^7.8.3" + "@babel/template" "^7.8.3" + "@babel/types" "^7.9.5" + "@babel/helper-get-function-arity@^7.8.3": version "7.8.3" resolved "https://registry.yarnpkg.com/@babel/helper-get-function-arity/-/helper-get-function-arity-7.8.3.tgz#b894b947bd004381ce63ea1db9f08547e920abd5" @@ -284,6 +303,11 @@ resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.9.0.tgz#ad53562a7fc29b3b9a91bbf7d10397fd146346ed" integrity sha512-6G8bQKjOh+of4PV/ThDm/rRqlU7+IGoJuofpagU5GlEl29Vv0RGqqt86ZGRV8ZuSOY3o+8yXl5y782SMcG7SHw== +"@babel/helper-validator-identifier@^7.9.5": + version "7.9.5" + resolved "https://registry.yarnpkg.com/@babel/helper-validator-identifier/-/helper-validator-identifier-7.9.5.tgz#90977a8e6fbf6b431a7dc31752eee233bf052d80" + integrity sha512-/8arLKUFq882w4tWGj9JYzRpAlZgiWUJ+dtteNTDqrRBz9Iguck9Rn3ykuBDoUwh2TO4tSAJlrxDUOXWklJe4g== + "@babel/helper-wrap-function@^7.8.3": version "7.8.3" resolved "https://registry.yarnpkg.com/@babel/helper-wrap-function/-/helper-wrap-function-7.8.3.tgz#9dbdb2bb55ef14aaa01fe8c99b629bd5352d8610" @@ -312,7 +336,7 @@ chalk "^2.0.0" js-tokens "^4.0.0" -"@babel/parser@^7.0.0", "@babel/parser@^7.1.0", "@babel/parser@^7.2.0", "@babel/parser@^7.4.3", "@babel/parser@^7.5.5", "@babel/parser@^7.8.6", "@babel/parser@^7.9.0", "@babel/parser@^7.9.3": +"@babel/parser@^7.0.0", "@babel/parser@^7.1.0", "@babel/parser@^7.2.0", "@babel/parser@^7.5.5", "@babel/parser@^7.7.5", "@babel/parser@^7.8.6", "@babel/parser@^7.9.0", "@babel/parser@^7.9.3": version "7.9.4" resolved "https://registry.yarnpkg.com/@babel/parser/-/parser-7.9.4.tgz#68a35e6b0319bbc014465be43828300113f2f2e8" integrity sha512-bC49otXX6N0/VYhgOMh4gnP26E9xnDZK3TmbNpxYzzz9BQLBosQwfyOe9/cXUU3txYhTzLCbcqd5c8y/OmCjHA== @@ -1101,7 +1125,7 @@ dependencies: regenerator-runtime "^0.13.4" -"@babel/template@^7.0.0", "@babel/template@^7.4.0", "@babel/template@^7.4.4", "@babel/template@^7.8.3", "@babel/template@^7.8.6": +"@babel/template@^7.0.0", "@babel/template@^7.4.4", "@babel/template@^7.7.4", "@babel/template@^7.8.3", "@babel/template@^7.8.6": version "7.8.6" resolved "https://registry.yarnpkg.com/@babel/template/-/template-7.8.6.tgz#86b22af15f828dfb086474f964dcc3e39c43ce2b" integrity sha512-zbMsPMy/v0PWFZEhQJ66bqjhH+z0JgMoBWuikXybgG3Gkd/3t5oQ1Rw2WQhnSrsOmsKXnZOx15tkC4qON/+JPg== @@ -1110,7 +1134,7 @@ "@babel/parser" "^7.8.6" "@babel/types" "^7.8.6" -"@babel/traverse@^7.0.0", "@babel/traverse@^7.1.0", "@babel/traverse@^7.1.6", "@babel/traverse@^7.4.3", "@babel/traverse@^7.4.5", "@babel/traverse@^7.5.5", "@babel/traverse@^7.8.3", "@babel/traverse@^7.8.6", "@babel/traverse@^7.9.0": +"@babel/traverse@^7.0.0", "@babel/traverse@^7.1.0", "@babel/traverse@^7.1.6", "@babel/traverse@^7.4.5", "@babel/traverse@^7.5.5", "@babel/traverse@^7.8.3", "@babel/traverse@^7.8.6", "@babel/traverse@^7.9.0": version "7.9.0" resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.9.0.tgz#d3882c2830e513f4fe4cec9fe76ea1cc78747892" integrity sha512-jAZQj0+kn4WTHO5dUZkZKhbFrqZE7K5LAQ5JysMnmvGij+wOdr+8lWqPeW0BcF4wFwrEXXtdGO7wcV6YPJcf3w== @@ -1125,6 +1149,21 @@ globals "^11.1.0" lodash "^4.17.13" +"@babel/traverse@^7.7.4": + version "7.9.5" + resolved "https://registry.yarnpkg.com/@babel/traverse/-/traverse-7.9.5.tgz#6e7c56b44e2ac7011a948c21e283ddd9d9db97a2" + integrity sha512-c4gH3jsvSuGUezlP6rzSJ6jf8fYjLj3hsMZRx/nX0h+fmHN0w+ekubRrHPqnMec0meycA2nwCsJ7dC8IPem2FQ== + dependencies: + "@babel/code-frame" "^7.8.3" + "@babel/generator" "^7.9.5" + "@babel/helper-function-name" "^7.9.5" + "@babel/helper-split-export-declaration" "^7.8.3" + "@babel/parser" "^7.9.0" + "@babel/types" "^7.9.5" + debug "^4.1.0" + globals "^11.1.0" + lodash "^4.17.13" + "@babel/types@^7.0.0", "@babel/types@^7.2.0", "@babel/types@^7.3.0", "@babel/types@^7.4.0", "@babel/types@^7.4.4", "@babel/types@^7.5.5", "@babel/types@^7.8.3", "@babel/types@^7.8.6", "@babel/types@^7.9.0": version "7.9.0" resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.9.0.tgz#00b064c3df83ad32b2dbf5ff07312b15c7f1efb5" @@ -1134,6 +1173,15 @@ lodash "^4.17.13" to-fast-properties "^2.0.0" +"@babel/types@^7.9.5": + version "7.9.5" + resolved "https://registry.yarnpkg.com/@babel/types/-/types-7.9.5.tgz#89231f82915a8a566a703b3b20133f73da6b9444" + integrity sha512-XjnvNqenk818r5zMaba+sLQjnbda31UfUURv3ei0qPQw4u+j2jMyJ5b11y8ZHYTRSI3NnInQkkkRT4fLqqPdHg== + dependencies: + "@babel/helper-validator-identifier" "^7.9.5" + lodash "^4.17.13" + to-fast-properties "^2.0.0" + "@cnakazawa/watch@^1.0.3": version "1.0.3" resolved "https://registry.yarnpkg.com/@cnakazawa/watch/-/watch-1.0.3.tgz#099139eaec7ebf07a27c1786a3ff64f39464d2ef" @@ -1542,6 +1590,21 @@ resolved "https://registry.yarnpkg.com/@icons/material/-/material-0.2.4.tgz#e90c9f71768b3736e76d7dd6783fc6c2afa88bc8" integrity sha512-QPcGmICAPbGLGb6F/yNf/KzKqvFx8z5qx3D1yFqVAjoFmXK35EgyW+cJ57Te3CNsmzblwtzakLGFqHPqrfb4Tw== +"@istanbuljs/load-nyc-config@^1.0.0": + version "1.0.0" + resolved "https://registry.yarnpkg.com/@istanbuljs/load-nyc-config/-/load-nyc-config-1.0.0.tgz#10602de5570baea82f8afbfa2630b24e7a8cfe5b" + integrity sha512-ZR0rq/f/E4f4XcgnDvtMWXCUJpi8eO0rssVhmztsZqLIEFA9UUP9zmpE0VxlM+kv/E1ul2I876Fwil2ayptDVg== + dependencies: + camelcase "^5.3.1" + find-up "^4.1.0" + js-yaml "^3.13.1" + resolve-from "^5.0.0" + +"@istanbuljs/schema@^0.1.2": + version "0.1.2" + resolved "https://registry.yarnpkg.com/@istanbuljs/schema/-/schema-0.1.2.tgz#26520bf09abe4a5644cd5414e37125a8954241dd" + integrity sha512-tsAQNx32a8CoFhjhijUIhI4kccIAgmGhy8LZMZgGfmXcpMbPRUqn5LWmgRttILi6yeGmBJd2xsPkFMs0PzgPCw== + "@jest/console@^24.7.1": version "24.7.1" resolved "https://registry.yarnpkg.com/@jest/console/-/console-24.7.1.tgz#32a9e42535a97aedfe037e725bd67e954b459545" @@ -6109,12 +6172,12 @@ append-buffer@^1.0.2: dependencies: buffer-equal "^1.0.0" -append-transform@^1.0.0: - version "1.0.0" - resolved "https://registry.yarnpkg.com/append-transform/-/append-transform-1.0.0.tgz#046a52ae582a228bd72f58acfbe2967c678759ab" - integrity sha512-P009oYkeHyU742iSZJzZZywj4QRJdnTWffaKuJQLablCZ1uz6/cW4yaRgcDaoQ+uwOxxnt0gRUcwfsNP2ri0gw== +append-transform@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/append-transform/-/append-transform-2.0.0.tgz#99d9d29c7b38391e6f428d28ce136551f0b77e12" + integrity sha512-7yeyCEurROLQJFv5Xj4lEGTy0borxepjFv1g22oAdqFu//SrAlDl1O1Nxx15SH1RoliUml6p8dwJW9jvZughhg== dependencies: - default-require-extensions "^2.0.0" + default-require-extensions "^3.0.0" aproba@^1.0.3, aproba@^1.1.1: version "1.2.0" @@ -6867,15 +6930,16 @@ babel-plugin-istanbul@^5.1.0: istanbul-lib-instrument "^3.0.0" test-exclude "^5.0.0" -babel-plugin-istanbul@^5.2.0: - version "5.2.0" - resolved "https://registry.yarnpkg.com/babel-plugin-istanbul/-/babel-plugin-istanbul-5.2.0.tgz#df4ade83d897a92df069c4d9a25cf2671293c854" - integrity sha512-5LphC0USA8t4i1zCtjbbNb6jJj/9+X6P37Qfirc/70EQ34xKlMW+a1RHGwxGI+SwWpNwZ27HqvzAobeqaXwiZw== +babel-plugin-istanbul@^6.0.0: + version "6.0.0" + resolved "https://registry.yarnpkg.com/babel-plugin-istanbul/-/babel-plugin-istanbul-6.0.0.tgz#e159ccdc9af95e0b570c75b4573b7c34d671d765" + integrity sha512-AF55rZXpe7trmEylbaE1Gv54wn6rwU03aptvRoVIGP8YykoSxqdVLV1TfwflBCE/QtHmqtP8SWlTENqbK8GCSQ== dependencies: "@babel/helper-plugin-utils" "^7.0.0" - find-up "^3.0.0" - istanbul-lib-instrument "^3.3.0" - test-exclude "^5.2.3" + "@istanbuljs/load-nyc-config" "^1.0.0" + "@istanbuljs/schema" "^0.1.2" + istanbul-lib-instrument "^4.0.0" + test-exclude "^6.0.0" babel-plugin-jest-hoist@^24.9.0: version "24.9.0" @@ -8129,15 +8193,15 @@ cachedir@2.3.0: resolved "https://registry.yarnpkg.com/cachedir/-/cachedir-2.3.0.tgz#0c75892a052198f0b21c7c1804d8331edfcae0e8" integrity sha512-A+Fezp4zxnit6FanDmv9EqXNAi3vt9DWp51/71UEhXukb7QUuvtv9344h91dyAxuTLoSYJFU299qzR3tzwPAhw== -caching-transform@^3.0.2: - version "3.0.2" - resolved "https://registry.yarnpkg.com/caching-transform/-/caching-transform-3.0.2.tgz#601d46b91eca87687a281e71cef99791b0efca70" - integrity sha512-Mtgcv3lh3U0zRii/6qVgQODdPA4G3zhG+jtbCWj39RXuUFTMzH0vcdMtaJS1jPowd+It2Pqr6y3NJMQqOqCE2w== +caching-transform@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/caching-transform/-/caching-transform-4.0.0.tgz#00d297a4206d71e2163c39eaffa8157ac0651f0f" + integrity sha512-kpqOvwXnjjN44D89K5ccQC+RUrsy7jB/XLlRrx0D7/2HNcTPqzsb6XgYoErwko6QsV184CA2YgS1fxDiiDZMWA== dependencies: - hasha "^3.0.0" - make-dir "^2.0.0" - package-hash "^3.0.0" - write-file-atomic "^2.4.2" + hasha "^5.0.0" + make-dir "^3.0.0" + package-hash "^4.0.0" + write-file-atomic "^3.0.0" call-me-maybe@^1.0.1: version "1.0.1" @@ -9564,7 +9628,7 @@ convert-source-map@^0.3.3: resolved "https://registry.yarnpkg.com/convert-source-map/-/convert-source-map-0.3.5.tgz#f1d802950af7dd2631a1febe0596550c86ab3190" integrity sha1-8dgClQr33SYxof6+BZZVDIarMZA= -convert-source-map@^1.5.1, convert-source-map@^1.6.0: +convert-source-map@^1.5.1: version "1.6.0" resolved "https://registry.yarnpkg.com/convert-source-map/-/convert-source-map-1.6.0.tgz#51b537a8c43e0f04dec1993bffcdd504e758ac20" integrity sha512-eFu7XigvxdZ1ETfbgPBohgyQ/Z++C0eEhTor0qRwBw9unw+L0/6V8wkSuGgzdThkiS5lSpdptOQPD8Ak40a+7A== @@ -9768,17 +9832,6 @@ cosmiconfig@^5.2.0, cosmiconfig@^5.2.1: js-yaml "^3.13.1" parse-json "^4.0.0" -cp-file@^6.2.0: - version "6.2.0" - resolved "https://registry.yarnpkg.com/cp-file/-/cp-file-6.2.0.tgz#40d5ea4a1def2a9acdd07ba5c0b0246ef73dc10d" - integrity sha512-fmvV4caBnofhPe8kOcitBwSn2f39QLjnAnGq3gO9dfd75mUytzKNZB1hde6QHunW2Rt+OwuBOMc3i1tNElbszA== - dependencies: - graceful-fs "^4.1.2" - make-dir "^2.0.0" - nested-error-stacks "^2.0.0" - pify "^4.0.1" - safe-buffer "^5.0.1" - cp-file@^7.0.0: version "7.0.0" resolved "https://registry.yarnpkg.com/cp-file/-/cp-file-7.0.0.tgz#b9454cfd07fe3b974ab9ea0e5f29655791a9b8cd" @@ -9948,7 +10001,7 @@ cross-spawn@^3.0.0: lru-cache "^4.0.1" which "^1.2.9" -cross-spawn@^4, cross-spawn@^4.0.2: +cross-spawn@^4.0.2: version "4.0.2" resolved "https://registry.yarnpkg.com/cross-spawn/-/cross-spawn-4.0.2.tgz#7b9247621c23adfdd3856004a823cbe397424d41" integrity sha1-e5JHYhwjrf3ThWAEqCPL45dCTUE= @@ -10847,12 +10900,12 @@ default-gateway@^4.2.0: execa "^1.0.0" ip-regex "^2.1.0" -default-require-extensions@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/default-require-extensions/-/default-require-extensions-2.0.0.tgz#f5f8fbb18a7d6d50b21f641f649ebb522cfe24f7" - integrity sha1-9fj7sYp9bVCyH2QfZJ67Uiz+JPc= +default-require-extensions@^3.0.0: + version "3.0.0" + resolved "https://registry.yarnpkg.com/default-require-extensions/-/default-require-extensions-3.0.0.tgz#e03f93aac9b2b6443fc52e5e4a37b3ad9ad8df96" + integrity sha512-ek6DpXq/SCpvjhpFsLFRVtIxJCRw6fUR42lYMVZuUMK7n8eMz4Uh5clckdBjEpLhn/gEBZo7hDJnJcwdKLKQjg== dependencies: - strip-bom "^3.0.0" + strip-bom "^4.0.0" default-resolution@^2.0.0: version "2.0.0" @@ -13842,13 +13895,13 @@ foreachasync@^3.0.0: resolved "https://registry.yarnpkg.com/foreachasync/-/foreachasync-3.0.0.tgz#5502987dc8714be3392097f32e0071c9dee07cf6" integrity sha1-VQKYfchxS+M5IJfzLgBxyd7gfPY= -foreground-child@^1.5.6: - version "1.5.6" - resolved "https://registry.yarnpkg.com/foreground-child/-/foreground-child-1.5.6.tgz#4fd71ad2dfde96789b980a5c0a295937cb2f5ce9" - integrity sha1-T9ca0t/elnibmApcCilZN8svXOk= +foreground-child@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/foreground-child/-/foreground-child-2.0.0.tgz#71b32800c9f15aa8f2f83f4a6bd9bff35d861a53" + integrity sha512-dCIq9FpEcyQyXKCkyzmlPTFNgrCzPudOe+mhvJU5zAtlBnGVy2yKxtfsxK2tQBThwq225jcvBjpw1Gr40uzZCA== dependencies: - cross-spawn "^4" - signal-exit "^3.0.0" + cross-spawn "^7.0.0" + signal-exit "^3.0.2" forever-agent@~0.6.1: version "0.6.1" @@ -13954,6 +14007,11 @@ from2@^2.1.0, from2@^2.1.1, from2@^2.3.0: inherits "^2.0.1" readable-stream "^2.0.0" +fromentries@^1.2.0: + version "1.2.0" + resolved "https://registry.yarnpkg.com/fromentries/-/fromentries-1.2.0.tgz#e6aa06f240d6267f913cea422075ef88b63e7897" + integrity sha512-33X7H/wdfO99GdRLLgkjUrD4geAFdq/Uv0kl3HD4da6HDixd2GUg8Mw7dahLCV9r/EARkmtYBB6Tch4EEokFTQ== + front-matter@2.1.2: version "2.1.2" resolved "https://registry.yarnpkg.com/front-matter/-/front-matter-2.1.2.tgz#f75983b9f2f413be658c93dfd7bd8ce4078f5cdb" @@ -15636,12 +15694,13 @@ hash.js@^1.0.0, hash.js@^1.0.3: inherits "^2.0.3" minimalistic-assert "^1.0.0" -hasha@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/hasha/-/hasha-3.0.0.tgz#52a32fab8569d41ca69a61ff1a214f8eb7c8bd39" - integrity sha1-UqMvq4Vp1BymmmH/GiFPjrfIvTk= +hasha@^5.0.0: + version "5.2.0" + resolved "https://registry.yarnpkg.com/hasha/-/hasha-5.2.0.tgz#33094d1f69c40a4a6ac7be53d5fe3ff95a269e0c" + integrity sha512-2W+jKdQbAdSIrggA8Q35Br8qKadTrqCTC8+XZvBWepKDK6m9XkX6Iz1a2yh2KP01kzAR/dpuMeUnocoLYDcskw== dependencies: - is-stream "^1.0.1" + is-stream "^2.0.0" + type-fest "^0.8.0" hast-util-from-parse5@^5.0.0: version "5.0.0" @@ -15845,6 +15904,11 @@ html-entities@^1.2.0, html-entities@^1.2.1: resolved "https://registry.yarnpkg.com/html-entities/-/html-entities-1.2.1.tgz#0df29351f0721163515dfb9e5543e5f6eed5162f" integrity sha1-DfKTUfByEWNRXfueVUPl9u7VFi8= +html-escaper@^2.0.0: + version "2.0.2" + resolved "https://registry.yarnpkg.com/html-escaper/-/html-escaper-2.0.2.tgz#dfd60027da36a36dfcbe236262c00a5822681453" + integrity sha512-H2iMtd0I4Mt5eYiapRdIDjp+XzelXQ0tFE4JS7YFwFevXXMmOp9myNrUvCg0D6ws8iqkRPBfKHgbwig1SmlLfg== + html-loader@^0.5.5: version "0.5.5" resolved "https://registry.yarnpkg.com/html-loader/-/html-loader-0.5.5.tgz#6356dbeb0c49756d8ebd5ca327f16ff06ab5faea" @@ -17320,7 +17384,7 @@ is-symbol@^1.0.2: dependencies: has-symbols "^1.0.0" -is-typedarray@~1.0.0: +is-typedarray@^1.0.0, is-typedarray@~1.0.0: version "1.0.0" resolved "https://registry.yarnpkg.com/is-typedarray/-/is-typedarray-1.0.0.tgz#e479c80858df0c1b11ddda6940f96011fcda4a9a" integrity sha1-5HnICFjfDBsR3dppQPlgEfzaSpo= @@ -17482,17 +17546,17 @@ istanbul-lib-coverage@^2.0.2, istanbul-lib-coverage@^2.0.3: resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.3.tgz#0b891e5ad42312c2b9488554f603795f9a2211ba" integrity sha512-dKWuzRGCs4G+67VfW9pBFFz2Jpi4vSp/k7zBcJ888ofV5Mi1g5CUML5GvMvV6u9Cjybftu+E8Cgp+k0dI1E5lw== -istanbul-lib-coverage@^2.0.5: - version "2.0.5" - resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-2.0.5.tgz#675f0ab69503fad4b1d849f736baaca803344f49" - integrity sha512-8aXznuEPCJvGnMSRft4udDRDtb1V3pkQkMMI5LI+6HuQz5oQ4J2UFn1H82raA3qJtyOLkkwVqICBQkjnGtn5mA== +istanbul-lib-coverage@^3.0.0, istanbul-lib-coverage@^3.0.0-alpha.1: + version "3.0.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-coverage/-/istanbul-lib-coverage-3.0.0.tgz#f5944a37c70b550b02a78a5c3b2055b280cec8ec" + integrity sha512-UiUIqxMgRDET6eR+o5HbfRYP1l0hqkWOs7vNxC/mggutCMUIhWMm8gAHb8tHlyfD3/l6rlgNA5cKdDzEAf6hEg== -istanbul-lib-hook@^2.0.7: - version "2.0.7" - resolved "https://registry.yarnpkg.com/istanbul-lib-hook/-/istanbul-lib-hook-2.0.7.tgz#c95695f383d4f8f60df1f04252a9550e15b5b133" - integrity sha512-vrRztU9VRRFDyC+aklfLoeXyNdTfga2EI3udDGn4cZ6fpSXpHLV9X6CHvfoMCPtggg8zvDDmC4b9xfu0z6/llA== +istanbul-lib-hook@^3.0.0: + version "3.0.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-hook/-/istanbul-lib-hook-3.0.0.tgz#8f84c9434888cc6b1d0a9d7092a76d239ebf0cc6" + integrity sha512-Pt/uge1Q9s+5VAZ+pCo16TYMWPBIl+oaNIjgLQxcX0itS6ueeaA+pEfThZpH8WxhFgCiEb8sAJY6MdUKgiIWaQ== dependencies: - append-transform "^1.0.0" + append-transform "^2.0.0" istanbul-lib-instrument@^1.7.3: version "1.10.2" @@ -17520,18 +17584,31 @@ istanbul-lib-instrument@^3.0.0, istanbul-lib-instrument@^3.0.1: istanbul-lib-coverage "^2.0.3" semver "^5.5.0" -istanbul-lib-instrument@^3.3.0: - version "3.3.0" - resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-3.3.0.tgz#a5f63d91f0bbc0c3e479ef4c5de027335ec6d630" - integrity sha512-5nnIN4vo5xQZHdXno/YDXJ0G+I3dAm4XgzfSVTPLQpj/zAV2dV6Juy0yaf10/zrJOJeHoN3fraFe+XRq2bFVZA== +istanbul-lib-instrument@^4.0.0: + version "4.0.1" + resolved "https://registry.yarnpkg.com/istanbul-lib-instrument/-/istanbul-lib-instrument-4.0.1.tgz#61f13ac2c96cfefb076fe7131156cc05907874e6" + integrity sha512-imIchxnodll7pvQBYOqUu88EufLCU56LMeFPZZM/fJZ1irYcYdqroaV+ACK1Ila8ls09iEYArp+nqyC6lW1Vfg== + dependencies: + "@babel/core" "^7.7.5" + "@babel/parser" "^7.7.5" + "@babel/template" "^7.7.4" + "@babel/traverse" "^7.7.4" + "@istanbuljs/schema" "^0.1.2" + istanbul-lib-coverage "^3.0.0" + semver "^6.3.0" + +istanbul-lib-processinfo@^2.0.2: + version "2.0.2" + resolved "https://registry.yarnpkg.com/istanbul-lib-processinfo/-/istanbul-lib-processinfo-2.0.2.tgz#e1426514662244b2f25df728e8fd1ba35fe53b9c" + integrity sha512-kOwpa7z9hme+IBPZMzQ5vdQj8srYgAtaRqeI48NGmAQ+/5yKiHLV0QbYqQpxsdEF0+w14SoB8YbnHKcXE2KnYw== dependencies: - "@babel/generator" "^7.4.0" - "@babel/parser" "^7.4.3" - "@babel/template" "^7.4.0" - "@babel/traverse" "^7.4.3" - "@babel/types" "^7.4.0" - istanbul-lib-coverage "^2.0.5" - semver "^6.0.0" + archy "^1.0.0" + cross-spawn "^7.0.0" + istanbul-lib-coverage "^3.0.0-alpha.1" + make-dir "^3.0.0" + p-map "^3.0.0" + rimraf "^3.0.0" + uuid "^3.3.3" istanbul-lib-report@^2.0.4: version "2.0.4" @@ -17542,14 +17619,14 @@ istanbul-lib-report@^2.0.4: make-dir "^1.3.0" supports-color "^6.0.0" -istanbul-lib-report@^2.0.8: - version "2.0.8" - resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-2.0.8.tgz#5a8113cd746d43c4889eba36ab10e7d50c9b4f33" - integrity sha512-fHBeG573EIihhAblwgxrSenp0Dby6tJMFR/HvlerBsrCTD5bkUuoNtn3gVh29ZCS824cGGBPn7Sg7cNk+2xUsQ== +istanbul-lib-report@^3.0.0: + version "3.0.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-report/-/istanbul-lib-report-3.0.0.tgz#7518fe52ea44de372f460a76b5ecda9ffb73d8a6" + integrity sha512-wcdi+uAKzfiGT2abPpKZ0hSU1rGQjUQnLvtY5MpQ7QCTahD3VODhcu4wcfY1YtkGaDD5yuydOLINXsfbus9ROw== dependencies: - istanbul-lib-coverage "^2.0.5" - make-dir "^2.1.0" - supports-color "^6.1.0" + istanbul-lib-coverage "^3.0.0" + make-dir "^3.0.0" + supports-color "^7.1.0" istanbul-lib-source-maps@^3.0.1: version "3.0.2" @@ -17562,24 +17639,30 @@ istanbul-lib-source-maps@^3.0.1: rimraf "^2.6.2" source-map "^0.6.1" -istanbul-lib-source-maps@^3.0.6: - version "3.0.6" - resolved "https://registry.yarnpkg.com/istanbul-lib-source-maps/-/istanbul-lib-source-maps-3.0.6.tgz#284997c48211752ec486253da97e3879defba8c8" - integrity sha512-R47KzMtDJH6X4/YW9XTx+jrLnZnscW4VpNN+1PViSYTejLVPWv7oov+Duf8YQSPyVRUvueQqz1TcsC6mooZTXw== +istanbul-lib-source-maps@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/istanbul-lib-source-maps/-/istanbul-lib-source-maps-4.0.0.tgz#75743ce6d96bb86dc7ee4352cf6366a23f0b1ad9" + integrity sha512-c16LpFRkR8vQXyHZ5nLpY35JZtzj1PQY1iZmesUbf1FZHbIupcWfjgOXBY9YHkLEQ6puz1u4Dgj6qmU/DisrZg== dependencies: debug "^4.1.1" - istanbul-lib-coverage "^2.0.5" - make-dir "^2.1.0" - rimraf "^2.6.3" + istanbul-lib-coverage "^3.0.0" source-map "^0.6.1" -istanbul-reports@^2.2.4, istanbul-reports@^2.2.6: +istanbul-reports@^2.2.6: version "2.2.6" resolved "https://registry.yarnpkg.com/istanbul-reports/-/istanbul-reports-2.2.6.tgz#7b4f2660d82b29303a8fe6091f8ca4bf058da1af" integrity sha512-SKi4rnMyLBKe0Jy2uUdx28h8oG7ph2PPuQPvIAh31d+Ci+lSiEu4C+h3oBPuJ9+mPKhOyW0M8gY4U5NM1WLeXA== dependencies: handlebars "^4.1.2" +istanbul-reports@^3.0.2: + version "3.0.2" + resolved "https://registry.yarnpkg.com/istanbul-reports/-/istanbul-reports-3.0.2.tgz#d593210e5000683750cb09fc0644e4b6e27fd53b" + integrity sha512-9tZvz7AiR3PEDNGiV9vIouQ/EAcqMXFmkcA1CDFTwOB98OZVDL0PH9glHotf5Ugp6GCOTypfzGWI/OqjWNCRUw== + dependencies: + html-escaper "^2.0.0" + istanbul-lib-report "^3.0.0" + istanbul@^0.4.0: version "0.4.5" resolved "https://registry.yarnpkg.com/istanbul/-/istanbul-0.4.5.tgz#65c7d73d4c4da84d4f3ac310b918fb0b8033733b" @@ -20121,13 +20204,6 @@ merge-source-map@1.0.4: dependencies: source-map "^0.5.6" -merge-source-map@^1.1.0: - version "1.1.0" - resolved "https://registry.yarnpkg.com/merge-source-map/-/merge-source-map-1.1.0.tgz#2fdde7e6020939f70906a68f2d7ae685e4c8c646" - integrity sha512-Qkcp7P2ygktpMPh2mCQZaf3jhN6D3Z/qVZHSdWvQ+2Ef5HgRAPBO57A77+ENm0CPx2+1Ce/MYKi3ymqdfuqibw== - dependencies: - source-map "^0.6.1" - merge-stream@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/merge-stream/-/merge-stream-1.0.1.tgz#4041202d508a342ba00174008df0c251b8c135e1" @@ -21224,6 +21300,13 @@ node-notifier@^5.4.2: shellwords "^0.1.1" which "^1.3.0" +node-preload@^0.2.1: + version "0.2.1" + resolved "https://registry.yarnpkg.com/node-preload/-/node-preload-0.2.1.tgz#c03043bb327f417a18fee7ab7ee57b408a144301" + integrity sha512-RM5oyBy45cLEoHqCeh+MNuFAxO0vTFBLskvQbOKnEE7YTTSN4tbN8QWDIPQ6L+WvKsB/qLEGpYe2ZZ9d4W9OIQ== + dependencies: + process-on-spawn "^1.0.0" + node-releases@^1.1.25, node-releases@^1.1.46: version "1.1.47" resolved "https://registry.yarnpkg.com/node-releases/-/node-releases-1.1.47.tgz#c59ef739a1fd7ecbd9f0b7cf5b7871e8a8b591e4" @@ -21490,36 +21573,37 @@ nwsapi@^2.2.0: resolved "https://registry.yarnpkg.com/nwsapi/-/nwsapi-2.2.0.tgz#204879a9e3d068ff2a55139c2c772780681a38b7" integrity sha512-h2AatdwYH+JHiZpv7pt/gSX1XoRGb7L/qSIeuqA6GwYoF9w1vP1cw42TO0aI2pNyshRK5893hNSl+1//vHK7hQ== -nyc@^14.1.1: - version "14.1.1" - resolved "https://registry.yarnpkg.com/nyc/-/nyc-14.1.1.tgz#151d64a6a9f9f5908a1b73233931e4a0a3075eeb" - integrity sha512-OI0vm6ZGUnoGZv/tLdZ2esSVzDwUC88SNs+6JoSOMVxA+gKMB8Tk7jBwgemLx4O40lhhvZCVw1C+OYLOBOPXWw== +nyc@^15.0.1: + version "15.0.1" + resolved "https://registry.yarnpkg.com/nyc/-/nyc-15.0.1.tgz#bd4d5c2b17f2ec04370365a5ca1fc0ed26f9f93d" + integrity sha512-n0MBXYBYRqa67IVt62qW1r/d9UH/Qtr7SF1w/nQLJ9KxvWF6b2xCHImRAixHN9tnMMYHC2P14uo6KddNGwMgGg== dependencies: - archy "^1.0.0" - caching-transform "^3.0.2" - convert-source-map "^1.6.0" - cp-file "^6.2.0" - find-cache-dir "^2.1.0" - find-up "^3.0.0" - foreground-child "^1.5.6" - glob "^7.1.3" - istanbul-lib-coverage "^2.0.5" - istanbul-lib-hook "^2.0.7" - istanbul-lib-instrument "^3.3.0" - istanbul-lib-report "^2.0.8" - istanbul-lib-source-maps "^3.0.6" - istanbul-reports "^2.2.4" - js-yaml "^3.13.1" - make-dir "^2.1.0" - merge-source-map "^1.1.0" - resolve-from "^4.0.0" - rimraf "^2.6.3" + "@istanbuljs/load-nyc-config" "^1.0.0" + "@istanbuljs/schema" "^0.1.2" + caching-transform "^4.0.0" + convert-source-map "^1.7.0" + decamelize "^1.2.0" + find-cache-dir "^3.2.0" + find-up "^4.1.0" + foreground-child "^2.0.0" + glob "^7.1.6" + istanbul-lib-coverage "^3.0.0" + istanbul-lib-hook "^3.0.0" + istanbul-lib-instrument "^4.0.0" + istanbul-lib-processinfo "^2.0.2" + istanbul-lib-report "^3.0.0" + istanbul-lib-source-maps "^4.0.0" + istanbul-reports "^3.0.2" + make-dir "^3.0.0" + node-preload "^0.2.1" + p-map "^3.0.0" + process-on-spawn "^1.0.0" + resolve-from "^5.0.0" + rimraf "^3.0.0" signal-exit "^3.0.2" - spawn-wrap "^1.4.2" - test-exclude "^5.2.3" - uuid "^3.3.2" - yargs "^13.2.2" - yargs-parser "^13.0.0" + spawn-wrap "^2.0.0" + test-exclude "^6.0.0" + yargs "^15.0.2" oauth-sign@~0.8.1, oauth-sign@~0.8.2: version "0.8.2" @@ -21958,7 +22042,7 @@ os-browserify@^0.3.0: resolved "https://registry.yarnpkg.com/os-browserify/-/os-browserify-0.3.0.tgz#854373c7f5c2315914fc9bfc6bd8238fdda1ec27" integrity sha1-hUNzx/XCMVkU/Jv8a9gjj92h7Cc= -os-homedir@^1.0.0, os-homedir@^1.0.1: +os-homedir@^1.0.0: version "1.0.2" resolved "https://registry.yarnpkg.com/os-homedir/-/os-homedir-1.0.2.tgz#ffbc4988336e0e833de0c168c7ef152121aa7fb3" integrity sha1-/7xJiDNuDoM94MFox+8VISGqf7M= @@ -22200,13 +22284,13 @@ p-try@^2.0.0: resolved "https://registry.yarnpkg.com/p-try/-/p-try-2.2.0.tgz#cb2868540e313d61de58fafbe35ce9004d5540e6" integrity sha512-R4nPAVTAU0B9D35/Gk3uJf/7XYbQcyohSKdvAxIRSNghFl4e71hVoGnBNQz9cWaXxO2I10KTC+3jMdvvoKw6dQ== -package-hash@^3.0.0: - version "3.0.0" - resolved "https://registry.yarnpkg.com/package-hash/-/package-hash-3.0.0.tgz#50183f2d36c9e3e528ea0a8605dff57ce976f88e" - integrity sha512-lOtmukMDVvtkL84rJHI7dpTYq+0rli8N2wlnqUcBuDWCfVhRUfOmnR9SsoHFMLpACvEV60dX7rd0rFaYDZI+FA== +package-hash@^4.0.0: + version "4.0.0" + resolved "https://registry.yarnpkg.com/package-hash/-/package-hash-4.0.0.tgz#3537f654665ec3cc38827387fc904c163c54f506" + integrity sha512-whdkPIooSu/bASggZ96BWVvZTRMOFxnyUG5PnTSGKoJE2gd5mbVNmR2Nj20QFzxYYgAXpoqC+AiXzl+UMRh7zQ== dependencies: graceful-fs "^4.1.15" - hasha "^3.0.0" + hasha "^5.0.0" lodash.flattendeep "^4.4.0" release-zalgo "^1.0.0" @@ -23202,6 +23286,13 @@ process-nextick-args@~2.0.0: resolved "https://registry.yarnpkg.com/process-nextick-args/-/process-nextick-args-2.0.1.tgz#7820d9b16120cc55ca9ae7792680ae7dba6d7fe2" integrity sha512-3ouUOpQhtgrbOa17J7+uxOTpITYWaGP7/AhoR3+A+/1e9skrzelGi/dXzEYyvbxubEF6Wn2ypscTKiKJFFn1ag== +process-on-spawn@^1.0.0: + version "1.0.0" + resolved "https://registry.yarnpkg.com/process-on-spawn/-/process-on-spawn-1.0.0.tgz#95b05a23073d30a17acfdc92a440efd2baefdc93" + integrity sha512-1WsPDsUSMmZH5LeMLegqkPDrsGgsWwk1Exipy2hvB0o/F0ASzbpIctSCcZIK1ykJvtTJULEH+20WOFjMvGnCTg== + dependencies: + fromentries "^1.2.0" + process@^0.11.10: version "0.11.10" resolved "https://registry.yarnpkg.com/process/-/process-0.11.10.tgz#7332300e840161bda3e69a1d1d91a7d4bc16f182" @@ -27207,17 +27298,17 @@ spawn-sync@^1.0.15: concat-stream "^1.4.7" os-shim "^0.1.2" -spawn-wrap@^1.4.2: - version "1.4.2" - resolved "https://registry.yarnpkg.com/spawn-wrap/-/spawn-wrap-1.4.2.tgz#cff58e73a8224617b6561abdc32586ea0c82248c" - integrity sha512-vMwR3OmmDhnxCVxM8M+xO/FtIp6Ju/mNaDfCMMW7FDcLRTPFWUswec4LXJHTJE2hwTI9O0YBfygu4DalFl7Ylg== +spawn-wrap@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/spawn-wrap/-/spawn-wrap-2.0.0.tgz#103685b8b8f9b79771318827aa78650a610d457e" + integrity sha512-EeajNjfN9zMnULLwhZZQU3GWBoFNkbngTUPfaawT4RkMiviTxcX0qfhVbGey39mfctfDHkWtuecgQ8NJcyQWHg== dependencies: - foreground-child "^1.5.6" - mkdirp "^0.5.0" - os-homedir "^1.0.1" - rimraf "^2.6.2" + foreground-child "^2.0.0" + is-windows "^1.0.2" + make-dir "^3.0.0" + rimraf "^3.0.0" signal-exit "^3.0.2" - which "^1.3.0" + which "^2.0.1" spdx-compare@^0.1.2: version "0.1.2" @@ -28536,7 +28627,7 @@ terser@^4.4.3: source-map "~0.6.1" source-map-support "~0.5.12" -test-exclude@^5.0.0, test-exclude@^5.2.3: +test-exclude@^5.0.0: version "5.2.3" resolved "https://registry.yarnpkg.com/test-exclude/-/test-exclude-5.2.3.tgz#c3d3e1e311eb7ee405e092dac10aefd09091eac0" integrity sha512-M+oxtseCFO3EDtAaGH7iiej3CBkzXqFMbzqYAACdzKui4eZA+pq3tZEwChvOdNfa7xxy8BfbmgJSIr43cC/+2g== @@ -28546,6 +28637,15 @@ test-exclude@^5.0.0, test-exclude@^5.2.3: read-pkg-up "^4.0.0" require-main-filename "^2.0.0" +test-exclude@^6.0.0: + version "6.0.0" + resolved "https://registry.yarnpkg.com/test-exclude/-/test-exclude-6.0.0.tgz#04a8698661d805ea6fa293b6cb9e63ac044ef15e" + integrity sha512-cAGWPIyOHU6zlmg88jwm7VRyXnMN7iV68OGAbYDk/Mh/xC/pzVPlQtY6ngoIH/5/tciuhGfvESU8GrHrcxD56w== + dependencies: + "@istanbuljs/schema" "^0.1.2" + glob "^7.1.4" + minimatch "^3.0.4" + text-hex@1.0.x: version "1.0.0" resolved "https://registry.yarnpkg.com/text-hex/-/text-hex-1.0.0.tgz#69dc9c1b17446ee79a92bf5b884bb4b9127506f5" @@ -29688,7 +29788,7 @@ type-fest@^0.6.0: resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.6.0.tgz#8d2a2370d3df886eb5c90ada1c5bf6188acf838b" integrity sha512-q+MB8nYR1KDLrgr4G5yemftpMC7/QLqVndBmEEdqzmNj5dcFOO4Oo8qlwZE3ULT3+Zim1F8Kq4cBnikNhlCMlg== -type-fest@^0.8.1: +type-fest@^0.8.0, type-fest@^0.8.1: version "0.8.1" resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.8.1.tgz#09e249ebde851d3b1e48d27c105444667f17b83d" integrity sha512-4dbzIzqvjtgiM5rw1k5rEHtBANKmdudhGyBEajN01fEyhaAIhsoKNy6y7+IN93IfpFtwY9iqi7kD+xwKhQsNJA== @@ -29726,6 +29826,13 @@ typed-styles@^0.0.7: resolved "https://registry.yarnpkg.com/typed-styles/-/typed-styles-0.0.7.tgz#93392a008794c4595119ff62dde6809dbc40a3d9" integrity sha512-pzP0PWoZUhsECYjABgCGQlRGL1n7tOHsgwYv3oIiEpJwGhFTuty/YNeduxQYzXXa3Ge5BdT6sHYIQYpl4uJ+5Q== +typedarray-to-buffer@^3.1.5: + version "3.1.5" + resolved "https://registry.yarnpkg.com/typedarray-to-buffer/-/typedarray-to-buffer-3.1.5.tgz#a97ee7a9ff42691b9f783ff1bc5112fe3fca9080" + integrity sha512-zdu8XMNEDepKKR+XYOXAVPtWui0ly0NtohUscw+UmaHiAWT8hrV1rr//H6V+0DvJ3OQ19S979M0laLfX8rm82Q== + dependencies: + is-typedarray "^1.0.0" + typedarray@^0.0.6, typedarray@~0.0.5: version "0.0.6" resolved "https://registry.yarnpkg.com/typedarray/-/typedarray-0.0.6.tgz#867ac74e3864187b1d3d47d996a78ec5c8830777" @@ -30453,6 +30560,11 @@ uuid@^3.0.0: resolved "https://registry.yarnpkg.com/uuid/-/uuid-3.1.0.tgz#3dd3d3e790abc24d7b0d3a034ffababe28ebbc04" integrity sha512-DIWtzUkw04M4k3bf1IcpS2tngXEL26YUD2M0tMDUpnUrz2hgzUBlD55a4FjdLGPvfHxS6uluGWvaVEqgBcVa+g== +uuid@^3.3.3: + version "3.4.0" + resolved "https://registry.yarnpkg.com/uuid/-/uuid-3.4.0.tgz#b23e4358afa8a202fe7a100af1f5f883f02007ee" + integrity sha512-HjSDRw6gZE5JMggctHBcjVak08+KEVhSIiDzFnT9S9aegmp85S/bReBVTb4QTFaRNptJ9kuYaNhnbNEOkbKb/A== + v8-compile-cache@2.0.3: version "2.0.3" resolved "https://registry.yarnpkg.com/v8-compile-cache/-/v8-compile-cache-2.0.3.tgz#00f7494d2ae2b688cfe2899df6ed2c54bef91dbe" @@ -31713,6 +31825,16 @@ write-file-atomic@^2.4.2: imurmurhash "^0.1.4" signal-exit "^3.0.2" +write-file-atomic@^3.0.0: + version "3.0.3" + resolved "https://registry.yarnpkg.com/write-file-atomic/-/write-file-atomic-3.0.3.tgz#56bd5c5a5c70481cd19c571bd39ab965a5de56e8" + integrity sha512-AvHcyZ5JnSfq3ioSyjrBkH9yW4m7Ayk8/9My/DD9onKeu/94fwrMocemO2QAJFAlnnDN+ZDS+ZjAR5ua1/PV/Q== + dependencies: + imurmurhash "^0.1.4" + is-typedarray "^1.0.0" + signal-exit "^3.0.2" + typedarray-to-buffer "^3.1.5" + write-json-file@^3.2.0: version "3.2.0" resolved "https://registry.yarnpkg.com/write-json-file/-/write-json-file-3.2.0.tgz#65bbdc9ecd8a1458e15952770ccbadfcff5fe62a" @@ -31954,7 +32076,7 @@ yallist@^4.0.0: resolved "https://registry.yarnpkg.com/yallist/-/yallist-4.0.0.tgz#9bb92790d9c0effec63be73519e11a35019a3a72" integrity sha512-3wdGidZyq5PB084XLES5TpOSRA3wjXAlIWMhum2kRcv/41Sn2emQ0dycQW4uZXLejwKvg6EsvbdlVL+FYEct7A== -yargs-parser@13.1.2, yargs-parser@^13.0.0, yargs-parser@^13.1.0, yargs-parser@^13.1.1, yargs-parser@^13.1.2: +yargs-parser@13.1.2, yargs-parser@^13.1.0, yargs-parser@^13.1.1, yargs-parser@^13.1.2: version "13.1.2" resolved "https://registry.yarnpkg.com/yargs-parser/-/yargs-parser-13.1.2.tgz#130f09702ebaeef2650d54ce6e3e5706f7a4fb38" integrity sha512-3lbsNRf/j+A4QuSZfDRA7HRSfWrzO0YjqTJd5kjAq37Zep1CEgaYmrH9Q3GwPiB9cHyd1Y1UwggGhJGoxipbzg== @@ -32121,7 +32243,7 @@ yargs@^13.2.2, yargs@^13.3.0: y18n "^4.0.0" yargs-parser "^13.1.1" -yargs@^15.3.1: +yargs@^15.0.2, yargs@^15.3.1: version "15.3.1" resolved "https://registry.yarnpkg.com/yargs/-/yargs-15.3.1.tgz#9505b472763963e54afe60148ad27a330818e98b" integrity sha512-92O1HWEjw27sBfgmXiixJWT5hRBp2eobqXicLtPBIDBhYB+1HpwZlXmbW2luivBJHBzki+7VyCLRtAkScbTBQA== From 97d1685c3dea682f80fd1a907bbc1d6f3702ea85 Mon Sep 17 00:00:00 2001 From: Joe Portner <5295965+jportner@users.noreply.github.com> Date: Thu, 9 Apr 2020 23:18:18 -0400 Subject: [PATCH 023/102] Sharing saved-objects phase 1 (#54605) Co-authored-by: kobelb --- docs/api/saved-objects/bulk_create.asciidoc | 2 +- .../kibana-plugin-core-public.savedobject.md | 1 + ...ugin-core-public.savedobject.namespaces.md | 13 + ...in-core-server.isavedobjecttyperegistry.md | 2 +- .../core/server/kibana-plugin-core-server.md | 3 + .../kibana-plugin-core-server.savedobject.md | 1 + ...ugin-core-server.savedobject.namespaces.md | 13 + ...rver.savedobjectsaddtonamespacesoptions.md | 20 + ...edobjectsaddtonamespacesoptions.refresh.md | 13 + ...edobjectsaddtonamespacesoptions.version.md | 13 + ...rver.savedobjectsclient.addtonamespaces.md | 27 + ...savedobjectsclient.deletefromnamespaces.md | 27 + ...a-plugin-core-server.savedobjectsclient.md | 2 + ...savedobjectsdeletefromnamespacesoptions.md | 19 + ...ectsdeletefromnamespacesoptions.refresh.md | 13 + ...objectserrorhelpers.createconflicterror.md | 23 + ...pers.decorateescannotexecutescripterror.md | 23 + ...rorhelpers.isescannotexecutescripterror.md | 22 + ...in-core-server.savedobjectserrorhelpers.md | 3 + ...n-core-server.savedobjectsnamespacetype.md | 15 + ....savedobjectsrepository.addtonamespaces.md | 27 + ...dobjectsrepository.deletefromnamespaces.md | 27 + ...ugin-core-server.savedobjectsrepository.md | 2 + ...r.savedobjectsservicesetup.registertype.md | 2 +- ...ana-plugin-core-server.savedobjectstype.md | 3 +- ...rver.savedobjectstype.namespaceagnostic.md | 9 +- ...e-server.savedobjectstype.namespacetype.md | 13 + ...avedobjecttyperegistry.ismultinamespace.md | 24 + ...dobjecttyperegistry.isnamespaceagnostic.md | 2 +- ...vedobjecttyperegistry.issinglenamespace.md | 24 + ...gin-core-server.savedobjecttyperegistry.md | 4 +- src/core/public/public.api.md | 1 + src/core/server/index.ts | 3 + .../__snapshots__/utils.test.ts.snap | 48 +- src/core/server/saved_objects/index.ts | 1 + .../build_active_mappings.test.ts.snap | 8 + .../migrations/core/build_active_mappings.ts | 3 + .../migrations/core/index_migrator.test.ts | 4 + .../kibana_migrator.test.ts.snap | 4 + .../routes/integration_tests/import.test.ts | 2 +- .../saved_objects_service.test.ts | 4 +- .../saved_objects/saved_objects_service.ts | 2 +- .../saved_objects_type_registry.mock.ts | 6 + .../saved_objects_type_registry.test.ts | 98 +- .../saved_objects_type_registry.ts | 37 +- .../saved_objects/schema/schema.test.ts | 98 +- .../server/saved_objects/schema/schema.ts | 33 +- .../serialization/serializer.test.ts | 1710 +++--- .../saved_objects/serialization/serializer.ts | 15 +- .../saved_objects/serialization/types.ts | 2 + .../lib/__snapshots__/repository.test.js.snap | 5 - .../service/lib/decorate_es_error.test.ts | 32 + .../service/lib/decorate_es_error.ts | 10 +- .../saved_objects/service/lib/errors.test.ts | 172 +- .../saved_objects/service/lib/errors.ts | 16 + .../service/lib/included_fields.test.ts | 26 +- .../service/lib/included_fields.ts | 1 + .../service/lib/repository.mock.ts | 2 + .../service/lib/repository.test.js | 4970 +++++++++-------- .../saved_objects/service/lib/repository.ts | 769 ++- .../lib/search_dsl/query_params.test.ts | 1460 +---- .../service/lib/search_dsl/query_params.ts | 14 +- .../service/saved_objects_client.mock.ts | 2 + .../service/saved_objects_client.test.js | 34 + .../service/saved_objects_client.ts | 54 + src/core/server/saved_objects/types.ts | 24 +- src/core/server/saved_objects/utils.test.ts | 63 +- src/core/server/saved_objects/utils.ts | 11 +- src/core/server/server.api.md | 37 +- src/core/types/saved_objects.ts | 2 + .../apis/saved_objects/bulk_create.js | 4 +- .../apis/saved_objects/bulk_get.js | 13 +- .../apis/saved_objects/export.js | 3 +- ...ypted_saved_objects_client_wrapper.test.ts | 308 +- .../encrypted_saved_objects_client_wrapper.ts | 42 +- .../server/saved_objects/index.ts | 3 +- .../server/audit/audit_logger.test.ts | 36 +- .../security/server/audit/audit_logger.ts | 17 +- .../check_privileges.test.ts.snap | 27 - .../authorization/check_privileges.test.ts | 1216 ++-- .../server/authorization/check_privileges.ts | 95 +- .../check_privileges_dynamically.ts | 4 +- .../check_saved_objects_privileges.test.ts | 132 +- .../check_saved_objects_privileges.ts | 34 +- .../disable_ui_capabilities.test.ts | 47 +- .../authorization/disable_ui_capabilities.ts | 8 +- x-pack/plugins/security/server/plugin.ts | 1 + .../security/server/saved_objects/index.ts | 10 +- ...ecure_saved_objects_client_wrapper.test.ts | 1448 +++-- .../secure_saved_objects_client_wrapper.ts | 212 +- .../edit_space/delete_spaces_button.tsx | 11 +- .../spaces_grid/spaces_grid_page.tsx | 11 +- .../lib/copy_to_spaces/copy_to_spaces.test.ts | 6 + .../resolve_copy_conflicts.test.ts | 6 + .../lib/spaces_client/spaces_client.test.ts | 24 +- .../server/lib/spaces_client/spaces_client.ts | 14 +- .../server/routes/api/external/delete.test.ts | 30 +- .../server/routes/api/external/delete.ts | 10 +- .../server/routes/api/external/index.ts | 4 + .../routes/api/external/share_add_spaces.ts | 62 + .../api/external/share_remove_spaces.ts | 62 + .../spaces_saved_objects_client.test.ts.snap | 29 - .../spaces_saved_objects_client.test.ts | 314 +- .../spaces_saved_objects_client.ts | 46 + .../plugins/uptime/server/rest_api/types.ts | 15 +- .../apis/spaces/saved_objects.ts | 2 +- .../common/config.ts | 2 + .../saved_objects/spaces/data.json | 103 +- .../saved_objects/spaces/mappings.json | 78 +- .../fixtures/hidden_type_plugin/index.js | 2 + .../fixtures/hidden_type_plugin/mappings.json | 2 +- .../fixtures/isolated_type_plugin/index.js | 26 + .../isolated_type_plugin/mappings.json | 31 + .../isolated_type_plugin/package.json | 7 + .../mappings.json | 2 +- .../fixtures/shared_type_plugin/index.js | 27 + .../fixtures/shared_type_plugin/mappings.json | 15 + .../fixtures/shared_type_plugin/package.json | 7 + .../common/lib/saved_object_test_cases.ts | 40 + .../common/lib/saved_object_test_utils.ts | 302 + .../common/lib/space_test_utils.ts | 24 - .../common/lib/types.ts | 27 +- .../common/suites/bulk_create.ts | 293 +- .../common/suites/bulk_get.ts | 257 +- .../common/suites/bulk_update.ts | 291 +- .../common/suites/create.ts | 259 +- .../common/suites/delete.ts | 190 +- .../common/suites/export.ts | 291 +- .../common/suites/find.ts | 401 +- .../common/suites/get.ts | 226 +- .../common/suites/import.ts | 285 +- .../common/suites/resolve_import_errors.ts | 312 +- .../common/suites/update.ts | 246 +- .../security_and_spaces/apis/bulk_create.ts | 278 +- .../security_and_spaces/apis/bulk_get.ts | 260 +- .../security_and_spaces/apis/bulk_update.ts | 347 +- .../security_and_spaces/apis/create.ts | 313 +- .../security_and_spaces/apis/delete.ts | 337 +- .../security_and_spaces/apis/export.ts | 314 +- .../security_and_spaces/apis/find.ts | 766 +-- .../security_and_spaces/apis/get.ts | 339 +- .../security_and_spaces/apis/import.ts | 301 +- .../security_and_spaces/apis/index.ts | 2 +- .../apis/resolve_import_errors.ts | 325 +- .../security_and_spaces/apis/update.ts | 338 +- .../security_only/apis/bulk_create.ts | 232 +- .../security_only/apis/bulk_get.ts | 226 +- .../security_only/apis/bulk_update.ts | 323 +- .../security_only/apis/create.ts | 275 +- .../security_only/apis/delete.ts | 313 +- .../security_only/apis/export.ts | 299 +- .../security_only/apis/find.ts | 791 +-- .../security_only/apis/get.ts | 312 +- .../security_only/apis/import.ts | 278 +- .../security_only/apis/index.ts | 2 +- .../apis/resolve_import_errors.ts | 277 +- .../security_only/apis/update.ts | 314 +- .../spaces_only/apis/bulk_create.ts | 123 +- .../spaces_only/apis/bulk_get.ts | 68 +- .../spaces_only/apis/bulk_update.ts | 110 +- .../spaces_only/apis/create.ts | 118 +- .../spaces_only/apis/delete.ts | 109 +- .../spaces_only/apis/export.ts | 65 +- .../spaces_only/apis/find.ts | 157 +- .../spaces_only/apis/get.ts | 110 +- .../spaces_only/apis/import.ts | 74 +- .../spaces_only/apis/index.ts | 2 +- .../spaces_only/apis/resolve_import_errors.ts | 85 +- .../spaces_only/apis/update.ts | 110 +- .../spaces_api_integration/common/config.ts | 1 + .../saved_objects/spaces/data.json | 120 + .../saved_objects/spaces/mappings.json | 16 + .../fixtures/shared_type_plugin/index.js | 27 + .../fixtures/shared_type_plugin/mappings.json | 15 + .../fixtures/shared_type_plugin/package.json | 7 + .../common/lib/saved_object_test_cases.ts | 40 + .../common/suites/delete.ts | 20 + .../common/suites/share_add.ts | 118 + .../common/suites/share_remove.ts | 116 + .../security_and_spaces/apis/index.ts | 2 + .../security_and_spaces/apis/share_add.ts | 124 + .../security_and_spaces/apis/share_remove.ts | 99 + .../spaces_only/apis/index.ts | 2 + .../spaces_only/apis/share_add.ts | 84 + .../spaces_only/apis/share_remove.ts | 99 + 185 files changed, 12261 insertions(+), 15549 deletions(-) create mode 100644 docs/development/core/public/kibana-plugin-core-public.savedobject.namespaces.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobject.namespaces.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.refresh.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.version.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.addtonamespaces.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.deletefromnamespaces.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.refresh.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.createconflicterror.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.decorateescannotexecutescripterror.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.isescannotexecutescripterror.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsnamespacetype.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespacetype.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.ismultinamespace.md create mode 100644 docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.issinglenamespace.md delete mode 100644 src/core/server/saved_objects/service/lib/__snapshots__/repository.test.js.snap delete mode 100644 x-pack/plugins/security/server/authorization/__snapshots__/check_privileges.test.ts.snap create mode 100644 x-pack/plugins/spaces/server/routes/api/external/share_add_spaces.ts create mode 100644 x-pack/plugins/spaces/server/routes/api/external/share_remove_spaces.ts delete mode 100644 x-pack/plugins/spaces/server/saved_objects/__snapshots__/spaces_saved_objects_client.test.ts.snap create mode 100644 x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/index.js create mode 100644 x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/mappings.json create mode 100644 x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/package.json create mode 100644 x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/index.js create mode 100644 x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/mappings.json create mode 100644 x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/package.json create mode 100644 x-pack/test/saved_object_api_integration/common/lib/saved_object_test_cases.ts create mode 100644 x-pack/test/saved_object_api_integration/common/lib/saved_object_test_utils.ts delete mode 100644 x-pack/test/saved_object_api_integration/common/lib/space_test_utils.ts create mode 100644 x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/index.js create mode 100644 x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/mappings.json create mode 100644 x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/package.json create mode 100644 x-pack/test/spaces_api_integration/common/lib/saved_object_test_cases.ts create mode 100644 x-pack/test/spaces_api_integration/common/suites/share_add.ts create mode 100644 x-pack/test/spaces_api_integration/common/suites/share_remove.ts create mode 100644 x-pack/test/spaces_api_integration/security_and_spaces/apis/share_add.ts create mode 100644 x-pack/test/spaces_api_integration/security_and_spaces/apis/share_remove.ts create mode 100644 x-pack/test/spaces_api_integration/spaces_only/apis/share_add.ts create mode 100644 x-pack/test/spaces_api_integration/spaces_only/apis/share_remove.ts diff --git a/docs/api/saved-objects/bulk_create.asciidoc b/docs/api/saved-objects/bulk_create.asciidoc index 9daba224b317c..fbd4c6e77f8bf 100644 --- a/docs/api/saved-objects/bulk_create.asciidoc +++ b/docs/api/saved-objects/bulk_create.asciidoc @@ -104,7 +104,7 @@ The API returns the following: "type": "dashboard", "error": { "statusCode": 409, - "message": "version conflict, document already exists" + "message": "Saved object [dashboard/be3733a0-9efe-11e7-acb3-3dab96693fab] conflict" } } ] diff --git a/docs/development/core/public/kibana-plugin-core-public.savedobject.md b/docs/development/core/public/kibana-plugin-core-public.savedobject.md index c6bc13b98bc06..b67d0536fb336 100644 --- a/docs/development/core/public/kibana-plugin-core-public.savedobject.md +++ b/docs/development/core/public/kibana-plugin-core-public.savedobject.md @@ -18,6 +18,7 @@ export interface SavedObject | [error](./kibana-plugin-core-public.savedobject.error.md) | {
message: string;
statusCode: number;
} | | | [id](./kibana-plugin-core-public.savedobject.id.md) | string | The ID of this Saved Object, guaranteed to be unique for all objects of the same type | | [migrationVersion](./kibana-plugin-core-public.savedobject.migrationversion.md) | SavedObjectsMigrationVersion | Information about the migrations that have been applied to this SavedObject. When Kibana starts up, KibanaMigrator detects outdated documents and migrates them based on this value. For each migration that has been applied, the plugin's name is used as a key and the latest migration version as the value. | +| [namespaces](./kibana-plugin-core-public.savedobject.namespaces.md) | string[] | Namespace(s) that this saved object exists in. This attribute is only used for multi-namespace saved object types. | | [references](./kibana-plugin-core-public.savedobject.references.md) | SavedObjectReference[] | A reference to another saved object. | | [type](./kibana-plugin-core-public.savedobject.type.md) | string | The type of Saved Object. Each plugin can define it's own custom Saved Object types. | | [updated\_at](./kibana-plugin-core-public.savedobject.updated_at.md) | string | Timestamp of the last time this document had been updated. | diff --git a/docs/development/core/public/kibana-plugin-core-public.savedobject.namespaces.md b/docs/development/core/public/kibana-plugin-core-public.savedobject.namespaces.md new file mode 100644 index 0000000000000..257df45934506 --- /dev/null +++ b/docs/development/core/public/kibana-plugin-core-public.savedobject.namespaces.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [kibana-plugin-core-public](./kibana-plugin-core-public.md) > [SavedObject](./kibana-plugin-core-public.savedobject.md) > [namespaces](./kibana-plugin-core-public.savedobject.namespaces.md) + +## SavedObject.namespaces property + +Namespace(s) that this saved object exists in. This attribute is only used for multi-namespace saved object types. + +Signature: + +```typescript +namespaces?: string[]; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.isavedobjecttyperegistry.md b/docs/development/core/server/kibana-plugin-core-server.isavedobjecttyperegistry.md index 245cb1a56439f..f9c621885c001 100644 --- a/docs/development/core/server/kibana-plugin-core-server.isavedobjecttyperegistry.md +++ b/docs/development/core/server/kibana-plugin-core-server.isavedobjecttyperegistry.md @@ -9,5 +9,5 @@ See [SavedObjectTypeRegistry](./kibana-plugin-core-server.savedobjecttyperegistr Signature: ```typescript -export declare type ISavedObjectTypeRegistry = Pick; +export declare type ISavedObjectTypeRegistry = Omit; ``` diff --git a/docs/development/core/server/kibana-plugin-core-server.md b/docs/development/core/server/kibana-plugin-core-server.md index accab9bf0cb36..5c0f10cac5179 100644 --- a/docs/development/core/server/kibana-plugin-core-server.md +++ b/docs/development/core/server/kibana-plugin-core-server.md @@ -130,6 +130,7 @@ The plugin integrates with the core system via lifecycle events: `setup` | [SavedObjectMigrationContext](./kibana-plugin-core-server.savedobjectmigrationcontext.md) | Migration context provided when invoking a [migration handler](./kibana-plugin-core-server.savedobjectmigrationfn.md) | | [SavedObjectMigrationMap](./kibana-plugin-core-server.savedobjectmigrationmap.md) | A map of [migration functions](./kibana-plugin-core-server.savedobjectmigrationfn.md) to be used for a given type. The map's keys must be valid semver versions.For a given document, only migrations with a higher version number than that of the document will be applied. Migrations are executed in order, starting from the lowest version and ending with the highest one. | | [SavedObjectReference](./kibana-plugin-core-server.savedobjectreference.md) | A reference to another saved object. | +| [SavedObjectsAddToNamespacesOptions](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md) | | | [SavedObjectsBaseOptions](./kibana-plugin-core-server.savedobjectsbaseoptions.md) | | | [SavedObjectsBulkCreateObject](./kibana-plugin-core-server.savedobjectsbulkcreateobject.md) | | | [SavedObjectsBulkGetObject](./kibana-plugin-core-server.savedobjectsbulkgetobject.md) | | @@ -143,6 +144,7 @@ The plugin integrates with the core system via lifecycle events: `setup` | [SavedObjectsCoreFieldMapping](./kibana-plugin-core-server.savedobjectscorefieldmapping.md) | See [SavedObjectsFieldMapping](./kibana-plugin-core-server.savedobjectsfieldmapping.md) for documentation. | | [SavedObjectsCreateOptions](./kibana-plugin-core-server.savedobjectscreateoptions.md) | | | [SavedObjectsDeleteByNamespaceOptions](./kibana-plugin-core-server.savedobjectsdeletebynamespaceoptions.md) | | +| [SavedObjectsDeleteFromNamespacesOptions](./kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md) | | | [SavedObjectsDeleteOptions](./kibana-plugin-core-server.savedobjectsdeleteoptions.md) | | | [SavedObjectsExportOptions](./kibana-plugin-core-server.savedobjectsexportoptions.md) | Options controlling the export operation. | | [SavedObjectsExportResultDetails](./kibana-plugin-core-server.savedobjectsexportresultdetails.md) | Structure of the export result details entry | @@ -262,6 +264,7 @@ The plugin integrates with the core system via lifecycle events: `setup` | [SavedObjectsClientFactoryProvider](./kibana-plugin-core-server.savedobjectsclientfactoryprovider.md) | Provider to invoke to retrieve a [SavedObjectsClientFactory](./kibana-plugin-core-server.savedobjectsclientfactory.md). | | [SavedObjectsClientWrapperFactory](./kibana-plugin-core-server.savedobjectsclientwrapperfactory.md) | Describes the factory used to create instances of Saved Objects Client Wrappers. | | [SavedObjectsFieldMapping](./kibana-plugin-core-server.savedobjectsfieldmapping.md) | Describe a [saved object type mapping](./kibana-plugin-core-server.savedobjectstypemappingdefinition.md) field.Please refer to [elasticsearch documentation](https://www.elastic.co/guide/en/elasticsearch/reference/current/mapping-types.html) For the mapping documentation | +| [SavedObjectsNamespaceType](./kibana-plugin-core-server.savedobjectsnamespacetype.md) | The namespace type dictates how a saved object can be interacted in relation to namespaces. Each type is mutually exclusive: \* single (default): this type of saved object is namespace-isolated, e.g., it exists in only one namespace. \* multiple: this type of saved object is shareable, e.g., it can exist in one or more namespaces. \* agnostic: this type of saved object is global.Note: do not write logic that uses this value directly; instead, use the appropriate accessors in the [type registry](./kibana-plugin-core-server.savedobjecttyperegistry.md). | | [ScopeableRequest](./kibana-plugin-core-server.scopeablerequest.md) | A user credentials container. It accommodates the necessary auth credentials to impersonate the current user.See [KibanaRequest](./kibana-plugin-core-server.kibanarequest.md). | | [ServiceStatusLevel](./kibana-plugin-core-server.servicestatuslevel.md) | A convenience type that represents the union of each value in [ServiceStatusLevels](./kibana-plugin-core-server.servicestatuslevels.md). | | [SharedGlobalConfig](./kibana-plugin-core-server.sharedglobalconfig.md) | | diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobject.md b/docs/development/core/server/kibana-plugin-core-server.savedobject.md index 0df97b0d4221a..94d1c378899df 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobject.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobject.md @@ -18,6 +18,7 @@ export interface SavedObject | [error](./kibana-plugin-core-server.savedobject.error.md) | {
message: string;
statusCode: number;
} | | | [id](./kibana-plugin-core-server.savedobject.id.md) | string | The ID of this Saved Object, guaranteed to be unique for all objects of the same type | | [migrationVersion](./kibana-plugin-core-server.savedobject.migrationversion.md) | SavedObjectsMigrationVersion | Information about the migrations that have been applied to this SavedObject. When Kibana starts up, KibanaMigrator detects outdated documents and migrates them based on this value. For each migration that has been applied, the plugin's name is used as a key and the latest migration version as the value. | +| [namespaces](./kibana-plugin-core-server.savedobject.namespaces.md) | string[] | Namespace(s) that this saved object exists in. This attribute is only used for multi-namespace saved object types. | | [references](./kibana-plugin-core-server.savedobject.references.md) | SavedObjectReference[] | A reference to another saved object. | | [type](./kibana-plugin-core-server.savedobject.type.md) | string | The type of Saved Object. Each plugin can define it's own custom Saved Object types. | | [updated\_at](./kibana-plugin-core-server.savedobject.updated_at.md) | string | Timestamp of the last time this document had been updated. | diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobject.namespaces.md b/docs/development/core/server/kibana-plugin-core-server.savedobject.namespaces.md new file mode 100644 index 0000000000000..2a555db01df3b --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobject.namespaces.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObject](./kibana-plugin-core-server.savedobject.md) > [namespaces](./kibana-plugin-core-server.savedobject.namespaces.md) + +## SavedObject.namespaces property + +Namespace(s) that this saved object exists in. This attribute is only used for multi-namespace saved object types. + +Signature: + +```typescript +namespaces?: string[]; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md new file mode 100644 index 0000000000000..711588bdd608c --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md @@ -0,0 +1,20 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsAddToNamespacesOptions](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md) + +## SavedObjectsAddToNamespacesOptions interface + + +Signature: + +```typescript +export interface SavedObjectsAddToNamespacesOptions extends SavedObjectsBaseOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [refresh](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.refresh.md) | MutatingOperationRefreshSetting | The Elasticsearch Refresh setting for this operation | +| [version](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.version.md) | string | An opaque version number which changes on each successful write operation. Can be used for implementing optimistic concurrency control. | + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.refresh.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.refresh.md new file mode 100644 index 0000000000000..c0a1008ab5331 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.refresh.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsAddToNamespacesOptions](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md) > [refresh](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.refresh.md) + +## SavedObjectsAddToNamespacesOptions.refresh property + +The Elasticsearch Refresh setting for this operation + +Signature: + +```typescript +refresh?: MutatingOperationRefreshSetting; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.version.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.version.md new file mode 100644 index 0000000000000..9432b4bf80da6 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.version.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsAddToNamespacesOptions](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.md) > [version](./kibana-plugin-core-server.savedobjectsaddtonamespacesoptions.version.md) + +## SavedObjectsAddToNamespacesOptions.version property + +An opaque version number which changes on each successful write operation. Can be used for implementing optimistic concurrency control. + +Signature: + +```typescript +version?: string; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.addtonamespaces.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.addtonamespaces.md new file mode 100644 index 0000000000000..45c9c39f9626a --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.addtonamespaces.md @@ -0,0 +1,27 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsClient](./kibana-plugin-core-server.savedobjectsclient.md) > [addToNamespaces](./kibana-plugin-core-server.savedobjectsclient.addtonamespaces.md) + +## SavedObjectsClient.addToNamespaces() method + +Adds namespaces to a SavedObject + +Signature: + +```typescript +addToNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsAddToNamespacesOptions): Promise<{}>; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | +| id | string | | +| namespaces | string[] | | +| options | SavedObjectsAddToNamespacesOptions | | + +Returns: + +`Promise<{}>` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.deletefromnamespaces.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.deletefromnamespaces.md new file mode 100644 index 0000000000000..80b58d29d393b --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.deletefromnamespaces.md @@ -0,0 +1,27 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsClient](./kibana-plugin-core-server.savedobjectsclient.md) > [deleteFromNamespaces](./kibana-plugin-core-server.savedobjectsclient.deletefromnamespaces.md) + +## SavedObjectsClient.deleteFromNamespaces() method + +Removes namespaces from a SavedObject + +Signature: + +```typescript +deleteFromNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsDeleteFromNamespacesOptions): Promise<{}>; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | +| id | string | | +| namespaces | string[] | | +| options | SavedObjectsDeleteFromNamespacesOptions | | + +Returns: + +`Promise<{}>` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.md index 5a8a213d2bccc..7038c0c07012f 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsclient.md @@ -25,11 +25,13 @@ The constructor for this class is marked as internal. Third-party code should no | Method | Modifiers | Description | | --- | --- | --- | +| [addToNamespaces(type, id, namespaces, options)](./kibana-plugin-core-server.savedobjectsclient.addtonamespaces.md) | | Adds namespaces to a SavedObject | | [bulkCreate(objects, options)](./kibana-plugin-core-server.savedobjectsclient.bulkcreate.md) | | Persists multiple documents batched together as a single request | | [bulkGet(objects, options)](./kibana-plugin-core-server.savedobjectsclient.bulkget.md) | | Returns an array of objects by id | | [bulkUpdate(objects, options)](./kibana-plugin-core-server.savedobjectsclient.bulkupdate.md) | | Bulk Updates multiple SavedObject at once | | [create(type, attributes, options)](./kibana-plugin-core-server.savedobjectsclient.create.md) | | Persists a SavedObject | | [delete(type, id, options)](./kibana-plugin-core-server.savedobjectsclient.delete.md) | | Deletes a SavedObject | +| [deleteFromNamespaces(type, id, namespaces, options)](./kibana-plugin-core-server.savedobjectsclient.deletefromnamespaces.md) | | Removes namespaces from a SavedObject | | [find(options)](./kibana-plugin-core-server.savedobjectsclient.find.md) | | Find all SavedObjects matching the search query | | [get(type, id, options)](./kibana-plugin-core-server.savedobjectsclient.get.md) | | Retrieves a single object | | [update(type, id, attributes, options)](./kibana-plugin-core-server.savedobjectsclient.update.md) | | Updates an SavedObject | diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md new file mode 100644 index 0000000000000..8a2afe6656fa4 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md @@ -0,0 +1,19 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsDeleteFromNamespacesOptions](./kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md) + +## SavedObjectsDeleteFromNamespacesOptions interface + + +Signature: + +```typescript +export interface SavedObjectsDeleteFromNamespacesOptions extends SavedObjectsBaseOptions +``` + +## Properties + +| Property | Type | Description | +| --- | --- | --- | +| [refresh](./kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.refresh.md) | MutatingOperationRefreshSetting | The Elasticsearch Refresh setting for this operation | + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.refresh.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.refresh.md new file mode 100644 index 0000000000000..1175b79bc1abd --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.refresh.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsDeleteFromNamespacesOptions](./kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.md) > [refresh](./kibana-plugin-core-server.savedobjectsdeletefromnamespacesoptions.refresh.md) + +## SavedObjectsDeleteFromNamespacesOptions.refresh property + +The Elasticsearch Refresh setting for this operation + +Signature: + +```typescript +refresh?: MutatingOperationRefreshSetting; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.createconflicterror.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.createconflicterror.md new file mode 100644 index 0000000000000..8e04282ce0c71 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.createconflicterror.md @@ -0,0 +1,23 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsErrorHelpers](./kibana-plugin-core-server.savedobjectserrorhelpers.md) > [createConflictError](./kibana-plugin-core-server.savedobjectserrorhelpers.createconflicterror.md) + +## SavedObjectsErrorHelpers.createConflictError() method + +Signature: + +```typescript +static createConflictError(type: string, id: string): DecoratedError; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | +| id | string | | + +Returns: + +`DecoratedError` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.decorateescannotexecutescripterror.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.decorateescannotexecutescripterror.md new file mode 100644 index 0000000000000..94060bba50067 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.decorateescannotexecutescripterror.md @@ -0,0 +1,23 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsErrorHelpers](./kibana-plugin-core-server.savedobjectserrorhelpers.md) > [decorateEsCannotExecuteScriptError](./kibana-plugin-core-server.savedobjectserrorhelpers.decorateescannotexecutescripterror.md) + +## SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError() method + +Signature: + +```typescript +static decorateEsCannotExecuteScriptError(error: Error, reason?: string): DecoratedError; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| error | Error | | +| reason | string | | + +Returns: + +`DecoratedError` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.isescannotexecutescripterror.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.isescannotexecutescripterror.md new file mode 100644 index 0000000000000..debb94fe4f8d8 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.isescannotexecutescripterror.md @@ -0,0 +1,22 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsErrorHelpers](./kibana-plugin-core-server.savedobjectserrorhelpers.md) > [isEsCannotExecuteScriptError](./kibana-plugin-core-server.savedobjectserrorhelpers.isescannotexecutescripterror.md) + +## SavedObjectsErrorHelpers.isEsCannotExecuteScriptError() method + +Signature: + +```typescript +static isEsCannotExecuteScriptError(error: Error | DecoratedError): boolean; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| error | Error | DecoratedError | | + +Returns: + +`boolean` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.md index 55a42e4f4eb7a..250b9d3899670 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectserrorhelpers.md @@ -16,12 +16,14 @@ export declare class SavedObjectsErrorHelpers | Method | Modifiers | Description | | --- | --- | --- | | [createBadRequestError(reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.createbadrequesterror.md) | static | | +| [createConflictError(type, id)](./kibana-plugin-core-server.savedobjectserrorhelpers.createconflicterror.md) | static | | | [createEsAutoCreateIndexError()](./kibana-plugin-core-server.savedobjectserrorhelpers.createesautocreateindexerror.md) | static | | | [createGenericNotFoundError(type, id)](./kibana-plugin-core-server.savedobjectserrorhelpers.creategenericnotfounderror.md) | static | | | [createInvalidVersionError(versionInput)](./kibana-plugin-core-server.savedobjectserrorhelpers.createinvalidversionerror.md) | static | | | [createUnsupportedTypeError(type)](./kibana-plugin-core-server.savedobjectserrorhelpers.createunsupportedtypeerror.md) | static | | | [decorateBadRequestError(error, reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.decoratebadrequesterror.md) | static | | | [decorateConflictError(error, reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.decorateconflicterror.md) | static | | +| [decorateEsCannotExecuteScriptError(error, reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.decorateescannotexecutescripterror.md) | static | | | [decorateEsUnavailableError(error, reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.decorateesunavailableerror.md) | static | | | [decorateForbiddenError(error, reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.decorateforbiddenerror.md) | static | | | [decorateGeneralError(error, reason)](./kibana-plugin-core-server.savedobjectserrorhelpers.decorategeneralerror.md) | static | | @@ -30,6 +32,7 @@ export declare class SavedObjectsErrorHelpers | [isBadRequestError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isbadrequesterror.md) | static | | | [isConflictError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isconflicterror.md) | static | | | [isEsAutoCreateIndexError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isesautocreateindexerror.md) | static | | +| [isEsCannotExecuteScriptError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isescannotexecutescripterror.md) | static | | | [isEsUnavailableError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isesunavailableerror.md) | static | | | [isForbiddenError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isforbiddenerror.md) | static | | | [isInvalidVersionError(error)](./kibana-plugin-core-server.savedobjectserrorhelpers.isinvalidversionerror.md) | static | | diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsnamespacetype.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsnamespacetype.md new file mode 100644 index 0000000000000..173b9e19321d0 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsnamespacetype.md @@ -0,0 +1,15 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsNamespaceType](./kibana-plugin-core-server.savedobjectsnamespacetype.md) + +## SavedObjectsNamespaceType type + +The namespace type dictates how a saved object can be interacted in relation to namespaces. Each type is mutually exclusive: \* single (default): this type of saved object is namespace-isolated, e.g., it exists in only one namespace. \* multiple: this type of saved object is shareable, e.g., it can exist in one or more namespaces. \* agnostic: this type of saved object is global. + +Note: do not write logic that uses this value directly; instead, use the appropriate accessors in the [type registry](./kibana-plugin-core-server.savedobjecttyperegistry.md). + +Signature: + +```typescript +export declare type SavedObjectsNamespaceType = 'single' | 'multiple' | 'agnostic'; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md new file mode 100644 index 0000000000000..bbb20d2bc3b96 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md @@ -0,0 +1,27 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsRepository](./kibana-plugin-core-server.savedobjectsrepository.md) > [addToNamespaces](./kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md) + +## SavedObjectsRepository.addToNamespaces() method + +Adds one or more namespaces to a given multi-namespace saved object. This method and \[`deleteFromNamespaces`\][SavedObjectsRepository.deleteFromNamespaces()](./kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md) are the only ways to change which Spaces a multi-namespace saved object is shared to. + +Signature: + +```typescript +addToNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsAddToNamespacesOptions): Promise<{}>; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | +| id | string | | +| namespaces | string[] | | +| options | SavedObjectsAddToNamespacesOptions | | + +Returns: + +`Promise<{}>` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md new file mode 100644 index 0000000000000..471c3e3c5092d --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md @@ -0,0 +1,27 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsRepository](./kibana-plugin-core-server.savedobjectsrepository.md) > [deleteFromNamespaces](./kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md) + +## SavedObjectsRepository.deleteFromNamespaces() method + +Removes one or more namespaces from a given multi-namespace saved object. If no namespaces remain, the saved object is deleted entirely. This method and \[`addToNamespaces`\][SavedObjectsRepository.addToNamespaces()](./kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md) are the only ways to change which Spaces a multi-namespace saved object is shared to. + +Signature: + +```typescript +deleteFromNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsDeleteFromNamespacesOptions): Promise<{}>; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | +| id | string | | +| namespaces | string[] | | +| options | SavedObjectsDeleteFromNamespacesOptions | | + +Returns: + +`Promise<{}>` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.md index 37547af2497e9..bd86ff3abbe9b 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsrepository.md @@ -15,12 +15,14 @@ export declare class SavedObjectsRepository | Method | Modifiers | Description | | --- | --- | --- | +| [addToNamespaces(type, id, namespaces, options)](./kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md) | | Adds one or more namespaces to a given multi-namespace saved object. This method and \[deleteFromNamespaces\][SavedObjectsRepository.deleteFromNamespaces()](./kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md) are the only ways to change which Spaces a multi-namespace saved object is shared to. | | [bulkCreate(objects, options)](./kibana-plugin-core-server.savedobjectsrepository.bulkcreate.md) | | Creates multiple documents at once | | [bulkGet(objects, options)](./kibana-plugin-core-server.savedobjectsrepository.bulkget.md) | | Returns an array of objects by id | | [bulkUpdate(objects, options)](./kibana-plugin-core-server.savedobjectsrepository.bulkupdate.md) | | Updates multiple objects in bulk | | [create(type, attributes, options)](./kibana-plugin-core-server.savedobjectsrepository.create.md) | | Persists an object | | [delete(type, id, options)](./kibana-plugin-core-server.savedobjectsrepository.delete.md) | | Deletes an object | | [deleteByNamespace(namespace, options)](./kibana-plugin-core-server.savedobjectsrepository.deletebynamespace.md) | | Deletes all objects from the provided namespace. | +| [deleteFromNamespaces(type, id, namespaces, options)](./kibana-plugin-core-server.savedobjectsrepository.deletefromnamespaces.md) | | Removes one or more namespaces from a given multi-namespace saved object. If no namespaces remain, the saved object is deleted entirely. This method and \[addToNamespaces\][SavedObjectsRepository.addToNamespaces()](./kibana-plugin-core-server.savedobjectsrepository.addtonamespaces.md) are the only ways to change which Spaces a multi-namespace saved object is shared to. | | [find({ search, defaultSearchOperator, searchFields, hasReference, page, perPage, sortField, sortOrder, fields, namespace, type, filter, })](./kibana-plugin-core-server.savedobjectsrepository.find.md) | | | | [get(type, id, options)](./kibana-plugin-core-server.savedobjectsrepository.get.md) | | Gets a single object | | [incrementCounter(type, id, counterFieldName, options)](./kibana-plugin-core-server.savedobjectsrepository.incrementcounter.md) | | Increases a counter field by one. Creates the document if one doesn't exist for the given id. | diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectsservicesetup.registertype.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectsservicesetup.registertype.md index c24fa7e7038c6..57c9e04966c1b 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjectsservicesetup.registertype.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectsservicesetup.registertype.md @@ -29,7 +29,7 @@ import * as migrations from './migrations'; export const myType: SavedObjectsType = { name: 'MyType', hidden: false, - namespaceAgnostic: true, + namespaceType: 'multiple', mappings: { properties: { textField: { diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md index ad7bf9a0f00d0..d8202545f0eae 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.md @@ -25,5 +25,6 @@ This is only internal for now, and will only be public when we expose the regist | [mappings](./kibana-plugin-core-server.savedobjectstype.mappings.md) | SavedObjectsTypeMappingDefinition | The [mapping definition](./kibana-plugin-core-server.savedobjectstypemappingdefinition.md) for the type. | | [migrations](./kibana-plugin-core-server.savedobjectstype.migrations.md) | SavedObjectMigrationMap | An optional map of [migrations](./kibana-plugin-core-server.savedobjectmigrationfn.md) to be used to migrate the type. | | [name](./kibana-plugin-core-server.savedobjectstype.name.md) | string | The name of the type, which is also used as the internal id. | -| [namespaceAgnostic](./kibana-plugin-core-server.savedobjectstype.namespaceagnostic.md) | boolean | Is the type global (true), or namespaced (false). | +| [namespaceAgnostic](./kibana-plugin-core-server.savedobjectstype.namespaceagnostic.md) | boolean | Is the type global (true), or not (false). | +| [namespaceType](./kibana-plugin-core-server.savedobjectstype.namespacetype.md) | SavedObjectsNamespaceType | The [namespace type](./kibana-plugin-core-server.savedobjectsnamespacetype.md) for the type. | diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespaceagnostic.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespaceagnostic.md index 8f43db86449d0..e347421590482 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespaceagnostic.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespaceagnostic.md @@ -4,10 +4,15 @@ ## SavedObjectsType.namespaceAgnostic property -Is the type global (true), or namespaced (false). +> Warning: This API is now obsolete. +> +> Use `namespaceType` instead. +> + +Is the type global (true), or not (false). Signature: ```typescript -namespaceAgnostic: boolean; +namespaceAgnostic?: boolean; ``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespacetype.md b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespacetype.md new file mode 100644 index 0000000000000..69912f9144980 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjectstype.namespacetype.md @@ -0,0 +1,13 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectsType](./kibana-plugin-core-server.savedobjectstype.md) > [namespaceType](./kibana-plugin-core-server.savedobjectstype.namespacetype.md) + +## SavedObjectsType.namespaceType property + +The [namespace type](./kibana-plugin-core-server.savedobjectsnamespacetype.md) for the type. + +Signature: + +```typescript +namespaceType?: SavedObjectsNamespaceType; +``` diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.ismultinamespace.md b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.ismultinamespace.md new file mode 100644 index 0000000000000..6532c5251d816 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.ismultinamespace.md @@ -0,0 +1,24 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectTypeRegistry](./kibana-plugin-core-server.savedobjecttyperegistry.md) > [isMultiNamespace](./kibana-plugin-core-server.savedobjecttyperegistry.ismultinamespace.md) + +## SavedObjectTypeRegistry.isMultiNamespace() method + +Returns whether the type is multi-namespace (shareable); resolves to `false` if the type is not registered + +Signature: + +```typescript +isMultiNamespace(type: string): boolean; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | + +Returns: + +`boolean` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.isnamespaceagnostic.md b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.isnamespaceagnostic.md index 92dfa5465235a..859c7b9711816 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.isnamespaceagnostic.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.isnamespaceagnostic.md @@ -4,7 +4,7 @@ ## SavedObjectTypeRegistry.isNamespaceAgnostic() method -Returns the `namespaceAgnostic` property for given type, or `false` if the type is not registered. +Returns whether the type is namespace-agnostic (global); resolves to `false` if the type is not registered Signature: diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.issinglenamespace.md b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.issinglenamespace.md new file mode 100644 index 0000000000000..18146b2fd6ea1 --- /dev/null +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.issinglenamespace.md @@ -0,0 +1,24 @@ + + +[Home](./index.md) > [kibana-plugin-core-server](./kibana-plugin-core-server.md) > [SavedObjectTypeRegistry](./kibana-plugin-core-server.savedobjecttyperegistry.md) > [isSingleNamespace](./kibana-plugin-core-server.savedobjecttyperegistry.issinglenamespace.md) + +## SavedObjectTypeRegistry.isSingleNamespace() method + +Returns whether the type is single-namespace (isolated); resolves to `true` if the type is not registered + +Signature: + +```typescript +isSingleNamespace(type: string): boolean; +``` + +## Parameters + +| Parameter | Type | Description | +| --- | --- | --- | +| type | string | | + +Returns: + +`boolean` + diff --git a/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.md b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.md index 410b709252b72..69a94e4ad8c88 100644 --- a/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.md +++ b/docs/development/core/server/kibana-plugin-core-server.savedobjecttyperegistry.md @@ -22,6 +22,8 @@ export declare class SavedObjectTypeRegistry | [getType(type)](./kibana-plugin-core-server.savedobjecttyperegistry.gettype.md) | | Return the [type](./kibana-plugin-core-server.savedobjectstype.md) definition for given type name. | | [isHidden(type)](./kibana-plugin-core-server.savedobjecttyperegistry.ishidden.md) | | Returns the hidden property for given type, or false if the type is not registered. | | [isImportableAndExportable(type)](./kibana-plugin-core-server.savedobjecttyperegistry.isimportableandexportable.md) | | Returns the management.importableAndExportable property for given type, or false if the type is not registered or does not define a management section. | -| [isNamespaceAgnostic(type)](./kibana-plugin-core-server.savedobjecttyperegistry.isnamespaceagnostic.md) | | Returns the namespaceAgnostic property for given type, or false if the type is not registered. | +| [isMultiNamespace(type)](./kibana-plugin-core-server.savedobjecttyperegistry.ismultinamespace.md) | | Returns whether the type is multi-namespace (shareable); resolves to false if the type is not registered | +| [isNamespaceAgnostic(type)](./kibana-plugin-core-server.savedobjecttyperegistry.isnamespaceagnostic.md) | | Returns whether the type is namespace-agnostic (global); resolves to false if the type is not registered | +| [isSingleNamespace(type)](./kibana-plugin-core-server.savedobjecttyperegistry.issinglenamespace.md) | | Returns whether the type is single-namespace (isolated); resolves to true if the type is not registered | | [registerType(type)](./kibana-plugin-core-server.savedobjecttyperegistry.registertype.md) | | Register a [type](./kibana-plugin-core-server.savedobjectstype.md) inside the registry. A type can only be registered once. subsequent calls with the same type name will throw an error. | diff --git a/src/core/public/public.api.md b/src/core/public/public.api.md index 9f7f649f1e2a5..a5aa37becabc2 100644 --- a/src/core/public/public.api.md +++ b/src/core/public/public.api.md @@ -956,6 +956,7 @@ export interface SavedObject { }; id: string; migrationVersion?: SavedObjectsMigrationVersion; + namespaces?: string[]; references: SavedObjectReference[]; type: string; updated_at?: string; diff --git a/src/core/server/index.ts b/src/core/server/index.ts index a298f80f96d8f..039988fa08968 100644 --- a/src/core/server/index.ts +++ b/src/core/server/index.ts @@ -227,6 +227,8 @@ export { SavedObjectsLegacyService, SavedObjectsUpdateOptions, SavedObjectsUpdateResponse, + SavedObjectsAddToNamespacesOptions, + SavedObjectsDeleteFromNamespacesOptions, SavedObjectsServiceStart, SavedObjectsServiceSetup, SavedObjectStatusMeta, @@ -242,6 +244,7 @@ export { SavedObjectsMappingProperties, SavedObjectTypeRegistry, ISavedObjectTypeRegistry, + SavedObjectsNamespaceType, SavedObjectsType, SavedObjectsTypeManagementDefinition, SavedObjectMigrationMap, diff --git a/src/core/server/saved_objects/__snapshots__/utils.test.ts.snap b/src/core/server/saved_objects/__snapshots__/utils.test.ts.snap index 5431d2ca47892..7cd0297e57857 100644 --- a/src/core/server/saved_objects/__snapshots__/utils.test.ts.snap +++ b/src/core/server/saved_objects/__snapshots__/utils.test.ts.snap @@ -16,7 +16,7 @@ Array [ }, "migrations": Object {}, "name": "typeA", - "namespaceAgnostic": false, + "namespaceType": "single", }, Object { "convertToAliasScript": undefined, @@ -32,7 +32,7 @@ Array [ }, "migrations": Object {}, "name": "typeB", - "namespaceAgnostic": false, + "namespaceType": "single", }, Object { "convertToAliasScript": undefined, @@ -48,7 +48,7 @@ Array [ }, "migrations": Object {}, "name": "typeC", - "namespaceAgnostic": false, + "namespaceType": "single", }, ] `; @@ -72,7 +72,7 @@ Array [ "2.0.4": [Function], }, "name": "typeA", - "namespaceAgnostic": true, + "namespaceType": "agnostic", }, Object { "convertToAliasScript": "some alias script", @@ -91,7 +91,7 @@ Array [ }, "migrations": Object {}, "name": "typeB", - "namespaceAgnostic": false, + "namespaceType": "single", }, Object { "convertToAliasScript": undefined, @@ -109,7 +109,7 @@ Array [ "1.5.3": [Function], }, "name": "typeC", - "namespaceAgnostic": false, + "namespaceType": "single", }, ] `; @@ -130,7 +130,23 @@ Array [ }, "migrations": Object {}, "name": "typeA", - "namespaceAgnostic": true, + "namespaceType": "agnostic", + }, + Object { + "convertToAliasScript": undefined, + "hidden": false, + "indexPattern": "barBaz", + "management": undefined, + "mappings": Object { + "properties": Object { + "fieldB": Object { + "type": "text", + }, + }, + }, + "migrations": Object {}, + "name": "typeB", + "namespaceType": "multiple", }, Object { "convertToAliasScript": undefined, @@ -146,7 +162,23 @@ Array [ }, "migrations": Object {}, "name": "typeC", - "namespaceAgnostic": false, + "namespaceType": "single", + }, + Object { + "convertToAliasScript": undefined, + "hidden": false, + "indexPattern": "bazQux", + "management": undefined, + "mappings": Object { + "properties": Object { + "fieldD": Object { + "type": "text", + }, + }, + }, + "migrations": Object {}, + "name": "typeD", + "namespaceType": "agnostic", }, ] `; diff --git a/src/core/server/saved_objects/index.ts b/src/core/server/saved_objects/index.ts index fe4795cad11a5..a294b28753f7b 100644 --- a/src/core/server/saved_objects/index.ts +++ b/src/core/server/saved_objects/index.ts @@ -69,6 +69,7 @@ export { } from './migrations'; export { + SavedObjectsNamespaceType, SavedObjectStatusMeta, SavedObjectsType, SavedObjectsTypeManagementDefinition, diff --git a/src/core/server/saved_objects/migrations/core/__snapshots__/build_active_mappings.test.ts.snap b/src/core/server/saved_objects/migrations/core/__snapshots__/build_active_mappings.test.ts.snap index fc26d7e9cf6e9..bc9a66926e880 100644 --- a/src/core/server/saved_objects/migrations/core/__snapshots__/build_active_mappings.test.ts.snap +++ b/src/core/server/saved_objects/migrations/core/__snapshots__/build_active_mappings.test.ts.snap @@ -8,6 +8,7 @@ Object { "bbb": "18c78c995965207ed3f6e7fc5c6e55fe", "migrationVersion": "4a1746014a75ade3a714e1db5763276f", "namespace": "2f4316de49999235636386fe51dc06c1", + "namespaces": "2f4316de49999235636386fe51dc06c1", "references": "7997cf5a56cc02bdc9c93361bde732b0", "type": "2f4316de49999235636386fe51dc06c1", "updated_at": "00da57df13e94e9d98437d13ace4bfe0", @@ -28,6 +29,9 @@ Object { "namespace": Object { "type": "keyword", }, + "namespaces": Object { + "type": "keyword", + }, "references": Object { "properties": Object { "id": Object { @@ -59,6 +63,7 @@ Object { "firstType": "635418ab953d81d93f1190b70a8d3f57", "migrationVersion": "4a1746014a75ade3a714e1db5763276f", "namespace": "2f4316de49999235636386fe51dc06c1", + "namespaces": "2f4316de49999235636386fe51dc06c1", "references": "7997cf5a56cc02bdc9c93361bde732b0", "secondType": "72d57924f415fbadb3ee293b67d233ab", "thirdType": "510f1f0adb69830cf8a1c5ce2923ed82", @@ -83,6 +88,9 @@ Object { "namespace": Object { "type": "keyword", }, + "namespaces": Object { + "type": "keyword", + }, "references": Object { "properties": Object { "id": Object { diff --git a/src/core/server/saved_objects/migrations/core/build_active_mappings.ts b/src/core/server/saved_objects/migrations/core/build_active_mappings.ts index 4d1a607414ca6..418ed95f14e05 100644 --- a/src/core/server/saved_objects/migrations/core/build_active_mappings.ts +++ b/src/core/server/saved_objects/migrations/core/build_active_mappings.ts @@ -142,6 +142,9 @@ function defaultMapping(): IndexMapping { namespace: { type: 'keyword', }, + namespaces: { + type: 'keyword', + }, updated_at: { type: 'date', }, diff --git a/src/core/server/saved_objects/migrations/core/index_migrator.test.ts b/src/core/server/saved_objects/migrations/core/index_migrator.test.ts index 1c2d3f501ff80..19208e6c83596 100644 --- a/src/core/server/saved_objects/migrations/core/index_migrator.test.ts +++ b/src/core/server/saved_objects/migrations/core/index_migrator.test.ts @@ -61,6 +61,7 @@ describe('IndexMigrator', () => { foo: '18c78c995965207ed3f6e7fc5c6e55fe', migrationVersion: '4a1746014a75ade3a714e1db5763276f', namespace: '2f4316de49999235636386fe51dc06c1', + namespaces: '2f4316de49999235636386fe51dc06c1', references: '7997cf5a56cc02bdc9c93361bde732b0', type: '2f4316de49999235636386fe51dc06c1', updated_at: '00da57df13e94e9d98437d13ace4bfe0', @@ -70,6 +71,7 @@ describe('IndexMigrator', () => { foo: { type: 'long' }, migrationVersion: { dynamic: 'true', type: 'object' }, namespace: { type: 'keyword' }, + namespaces: { type: 'keyword' }, type: { type: 'keyword' }, updated_at: { type: 'date' }, references: { @@ -178,6 +180,7 @@ describe('IndexMigrator', () => { foo: '625b32086eb1d1203564cf85062dd22e', migrationVersion: '4a1746014a75ade3a714e1db5763276f', namespace: '2f4316de49999235636386fe51dc06c1', + namespaces: '2f4316de49999235636386fe51dc06c1', references: '7997cf5a56cc02bdc9c93361bde732b0', type: '2f4316de49999235636386fe51dc06c1', updated_at: '00da57df13e94e9d98437d13ace4bfe0', @@ -188,6 +191,7 @@ describe('IndexMigrator', () => { foo: { type: 'text' }, migrationVersion: { dynamic: 'true', type: 'object' }, namespace: { type: 'keyword' }, + namespaces: { type: 'keyword' }, type: { type: 'keyword' }, updated_at: { type: 'date' }, references: { diff --git a/src/core/server/saved_objects/migrations/kibana/__snapshots__/kibana_migrator.test.ts.snap b/src/core/server/saved_objects/migrations/kibana/__snapshots__/kibana_migrator.test.ts.snap index 507c0b0d9339f..3453f3fc80310 100644 --- a/src/core/server/saved_objects/migrations/kibana/__snapshots__/kibana_migrator.test.ts.snap +++ b/src/core/server/saved_objects/migrations/kibana/__snapshots__/kibana_migrator.test.ts.snap @@ -8,6 +8,7 @@ Object { "bmap": "510f1f0adb69830cf8a1c5ce2923ed82", "migrationVersion": "4a1746014a75ade3a714e1db5763276f", "namespace": "2f4316de49999235636386fe51dc06c1", + "namespaces": "2f4316de49999235636386fe51dc06c1", "references": "7997cf5a56cc02bdc9c93361bde732b0", "type": "2f4316de49999235636386fe51dc06c1", "updated_at": "00da57df13e94e9d98437d13ace4bfe0", @@ -36,6 +37,9 @@ Object { "namespace": Object { "type": "keyword", }, + "namespaces": Object { + "type": "keyword", + }, "references": Object { "properties": Object { "id": Object { diff --git a/src/core/server/saved_objects/routes/integration_tests/import.test.ts b/src/core/server/saved_objects/routes/integration_tests/import.test.ts index c72d3e241b882..c4a03a0e2e7d2 100644 --- a/src/core/server/saved_objects/routes/integration_tests/import.test.ts +++ b/src/core/server/saved_objects/routes/integration_tests/import.test.ts @@ -187,7 +187,7 @@ describe('POST /internal/saved_objects/_import', () => { references: [], error: { statusCode: 409, - message: 'version conflict, document already exists', + message: 'Saved object [index-pattern/my-pattern] conflict', }, }, { diff --git a/src/core/server/saved_objects/saved_objects_service.test.ts b/src/core/server/saved_objects/saved_objects_service.test.ts index 018117776dcc8..819d79803f371 100644 --- a/src/core/server/saved_objects/saved_objects_service.test.ts +++ b/src/core/server/saved_objects/saved_objects_service.test.ts @@ -138,7 +138,7 @@ describe('SavedObjectsService', () => { const type = { name: 'someType', hidden: false, - namespaceAgnostic: false, + namespaceType: 'single' as 'single', mappings: { properties: {} }, }; setup.registerType(type); @@ -251,7 +251,7 @@ describe('SavedObjectsService', () => { setup.registerType({ name: 'someType', hidden: false, - namespaceAgnostic: false, + namespaceType: 'single' as 'single', mappings: { properties: {} }, }); }).toThrowErrorMatchingInlineSnapshot( diff --git a/src/core/server/saved_objects/saved_objects_service.ts b/src/core/server/saved_objects/saved_objects_service.ts index 62027928c0bb5..ed4ffef5729ab 100644 --- a/src/core/server/saved_objects/saved_objects_service.ts +++ b/src/core/server/saved_objects/saved_objects_service.ts @@ -124,7 +124,7 @@ export interface SavedObjectsServiceSetup { * export const myType: SavedObjectsType = { * name: 'MyType', * hidden: false, - * namespaceAgnostic: true, + * namespaceType: 'multiple', * mappings: { * properties: { * textField: { diff --git a/src/core/server/saved_objects/saved_objects_type_registry.mock.ts b/src/core/server/saved_objects/saved_objects_type_registry.mock.ts index 8c8458d7a5ce4..8bb66859feca2 100644 --- a/src/core/server/saved_objects/saved_objects_type_registry.mock.ts +++ b/src/core/server/saved_objects/saved_objects_type_registry.mock.ts @@ -27,6 +27,8 @@ const createRegistryMock = (): jest.Mocked type === 'global'); + mock.isSingleNamespace.mockImplementation( + (type: string) => type !== 'global' && type !== 'shared' + ); + mock.isMultiNamespace.mockImplementation((type: string) => type === 'shared'); mock.isImportableAndExportable.mockReturnValue(true); return mock; diff --git a/src/core/server/saved_objects/saved_objects_type_registry.test.ts b/src/core/server/saved_objects/saved_objects_type_registry.test.ts index 4d1d5c1eacc25..84337474f3ee3 100644 --- a/src/core/server/saved_objects/saved_objects_type_registry.test.ts +++ b/src/core/server/saved_objects/saved_objects_type_registry.test.ts @@ -23,7 +23,7 @@ import { SavedObjectsType } from './types'; const createType = (type: Partial): SavedObjectsType => ({ name: 'unknown', hidden: false, - namespaceAgnostic: false, + namespaceType: 'single' as 'single', mappings: { properties: {} }, migrations: {}, ...type, @@ -164,18 +164,92 @@ describe('SavedObjectTypeRegistry', () => { }); describe('#isNamespaceAgnostic', () => { - it('returns correct value for the type', () => { - registry.registerType(createType({ name: 'typeA', namespaceAgnostic: true })); - registry.registerType(createType({ name: 'typeB', namespaceAgnostic: false })); + const expectResult = (expected: boolean, schemaDefinition?: Partial) => { + registry = new SavedObjectTypeRegistry(); + registry.registerType(createType({ name: 'foo', ...schemaDefinition })); + expect(registry.isNamespaceAgnostic('foo')).toBe(expected); + }; - expect(registry.isNamespaceAgnostic('typeA')).toEqual(true); - expect(registry.isNamespaceAgnostic('typeB')).toEqual(false); + it(`returns false when the type is not registered`, () => { + expect(registry.isNamespaceAgnostic('unknownType')).toEqual(false); }); - it('returns false when the type is not registered', () => { - registry.registerType(createType({ name: 'typeA', namespaceAgnostic: true })); - registry.registerType(createType({ name: 'typeB', namespaceAgnostic: false })); - expect(registry.isNamespaceAgnostic('unknownType')).toEqual(false); + it(`returns true for namespaceType 'agnostic'`, () => { + expectResult(true, { namespaceType: 'agnostic' }); + }); + + it(`returns false for other namespaceType`, () => { + expectResult(false, { namespaceType: 'multiple' }); + expectResult(false, { namespaceType: 'single' }); + expectResult(false, { namespaceType: undefined }); + }); + + // deprecated test cases + it(`returns true when namespaceAgnostic is true`, () => { + expectResult(true, { namespaceAgnostic: true, namespaceType: 'agnostic' }); + expectResult(true, { namespaceAgnostic: true, namespaceType: 'multiple' }); + expectResult(true, { namespaceAgnostic: true, namespaceType: 'single' }); + expectResult(true, { namespaceAgnostic: true, namespaceType: undefined }); + }); + }); + + describe('#isSingleNamespace', () => { + const expectResult = (expected: boolean, schemaDefinition?: Partial) => { + registry = new SavedObjectTypeRegistry(); + registry.registerType(createType({ name: 'foo', ...schemaDefinition })); + expect(registry.isSingleNamespace('foo')).toBe(expected); + }; + + it(`returns true when the type is not registered`, () => { + expect(registry.isSingleNamespace('unknownType')).toEqual(true); + }); + + it(`returns true for namespaceType 'single'`, () => { + expectResult(true, { namespaceType: 'single' }); + expectResult(true, { namespaceType: undefined }); + }); + + it(`returns false for other namespaceType`, () => { + expectResult(false, { namespaceType: 'agnostic' }); + expectResult(false, { namespaceType: 'multiple' }); + }); + + // deprecated test cases + it(`returns false when namespaceAgnostic is true`, () => { + expectResult(false, { namespaceAgnostic: true, namespaceType: 'agnostic' }); + expectResult(false, { namespaceAgnostic: true, namespaceType: 'multiple' }); + expectResult(false, { namespaceAgnostic: true, namespaceType: 'single' }); + expectResult(false, { namespaceAgnostic: true, namespaceType: undefined }); + }); + }); + + describe('#isMultiNamespace', () => { + const expectResult = (expected: boolean, schemaDefinition?: Partial) => { + registry = new SavedObjectTypeRegistry(); + registry.registerType(createType({ name: 'foo', ...schemaDefinition })); + expect(registry.isMultiNamespace('foo')).toBe(expected); + }; + + it(`returns false when the type is not registered`, () => { + expect(registry.isMultiNamespace('unknownType')).toEqual(false); + }); + + it(`returns true for namespaceType 'multiple'`, () => { + expectResult(true, { namespaceType: 'multiple' }); + }); + + it(`returns false for other namespaceType`, () => { + expectResult(false, { namespaceType: 'agnostic' }); + expectResult(false, { namespaceType: 'single' }); + expectResult(false, { namespaceType: undefined }); + }); + + // deprecated test cases + it(`returns false when namespaceAgnostic is true`, () => { + expectResult(false, { namespaceAgnostic: true, namespaceType: 'agnostic' }); + expectResult(false, { namespaceAgnostic: true, namespaceType: 'multiple' }); + expectResult(false, { namespaceAgnostic: true, namespaceType: 'single' }); + expectResult(false, { namespaceAgnostic: true, namespaceType: undefined }); }); }); @@ -206,8 +280,8 @@ describe('SavedObjectTypeRegistry', () => { expect(registry.getIndex('typeWithNoIndex')).toBeUndefined(); }); it('returns undefined when the type is not registered', () => { - registry.registerType(createType({ name: 'typeA', namespaceAgnostic: true })); - registry.registerType(createType({ name: 'typeB', namespaceAgnostic: false })); + registry.registerType(createType({ name: 'typeA', namespaceType: 'agnostic' })); + registry.registerType(createType({ name: 'typeB', namespaceType: 'single' })); expect(registry.getIndex('unknownType')).toBeUndefined(); }); diff --git a/src/core/server/saved_objects/saved_objects_type_registry.ts b/src/core/server/saved_objects/saved_objects_type_registry.ts index 5580ce3815d0d..be3fdb86a994c 100644 --- a/src/core/server/saved_objects/saved_objects_type_registry.ts +++ b/src/core/server/saved_objects/saved_objects_type_registry.ts @@ -25,16 +25,7 @@ import { SavedObjectsType } from './types'; * * @public */ -export type ISavedObjectTypeRegistry = Pick< - SavedObjectTypeRegistry, - | 'getType' - | 'getAllTypes' - | 'getIndex' - | 'isNamespaceAgnostic' - | 'isHidden' - | 'getImportableAndExportableTypes' - | 'isImportableAndExportable' ->; +export type ISavedObjectTypeRegistry = Omit; /** * Registry holding information about all the registered {@link SavedObjectsType | saved object types}. @@ -77,11 +68,31 @@ export class SavedObjectTypeRegistry { } /** - * Returns the `namespaceAgnostic` property for given type, or `false` if - * the type is not registered. + * Returns whether the type is namespace-agnostic (global); + * resolves to `false` if the type is not registered */ public isNamespaceAgnostic(type: string) { - return this.types.get(type)?.namespaceAgnostic ?? false; + return ( + this.types.get(type)?.namespaceType === 'agnostic' || + this.types.get(type)?.namespaceAgnostic || + false + ); + } + + /** + * Returns whether the type is single-namespace (isolated); + * resolves to `true` if the type is not registered + */ + public isSingleNamespace(type: string) { + return !this.isNamespaceAgnostic(type) && !this.isMultiNamespace(type); + } + + /** + * Returns whether the type is multi-namespace (shareable); + * resolves to `false` if the type is not registered + */ + public isMultiNamespace(type: string) { + return !this.isNamespaceAgnostic(type) && this.types.get(type)?.namespaceType === 'multiple'; } /** diff --git a/src/core/server/saved_objects/schema/schema.test.ts b/src/core/server/saved_objects/schema/schema.test.ts index 43cf27fbae790..f2daa13e43fce 100644 --- a/src/core/server/saved_objects/schema/schema.test.ts +++ b/src/core/server/saved_objects/schema/schema.test.ts @@ -17,32 +17,90 @@ * under the License. */ -import { SavedObjectsSchema } from './schema'; +import { SavedObjectsSchema, SavedObjectsSchemaDefinition } from './schema'; describe('#isNamespaceAgnostic', () => { + const expectResult = (expected: boolean, schemaDefinition?: SavedObjectsSchemaDefinition) => { + const schema = new SavedObjectsSchema(schemaDefinition); + const result = schema.isNamespaceAgnostic('foo'); + expect(result).toBe(expected); + }; + + it(`returns false when no schema is defined`, () => { + expectResult(false); + }); + it(`returns false for unknown types`, () => { - const schema = new SavedObjectsSchema(); - const result = schema.isNamespaceAgnostic('bar'); - expect(result).toBe(false); + expectResult(false, { bar: {} }); }); - it(`returns true for explicitly namespace agnostic type`, () => { - const schema = new SavedObjectsSchema({ - foo: { - isNamespaceAgnostic: true, - }, - }); - const result = schema.isNamespaceAgnostic('foo'); - expect(result).toBe(true); + it(`returns false for non-namespace-agnostic type`, () => { + expectResult(false, { foo: { isNamespaceAgnostic: false } }); + expectResult(false, { foo: { isNamespaceAgnostic: undefined } }); }); - it(`returns false for explicitly namespaced type`, () => { - const schema = new SavedObjectsSchema({ - foo: { - isNamespaceAgnostic: false, - }, - }); - const result = schema.isNamespaceAgnostic('foo'); - expect(result).toBe(false); + it(`returns true for explicitly namespace-agnostic type`, () => { + expectResult(true, { foo: { isNamespaceAgnostic: true } }); + }); +}); + +describe('#isSingleNamespace', () => { + const expectResult = (expected: boolean, schemaDefinition?: SavedObjectsSchemaDefinition) => { + const schema = new SavedObjectsSchema(schemaDefinition); + const result = schema.isSingleNamespace('foo'); + expect(result).toBe(expected); + }; + + it(`returns true when no schema is defined`, () => { + expectResult(true); + }); + + it(`returns true for unknown types`, () => { + expectResult(true, { bar: {} }); + }); + + it(`returns false for explicitly namespace-agnostic type`, () => { + expectResult(false, { foo: { isNamespaceAgnostic: true } }); + }); + + it(`returns false for explicitly multi-namespace type`, () => { + expectResult(false, { foo: { multiNamespace: true } }); + }); + + it(`returns true for non-namespace-agnostic and non-multi-namespace type`, () => { + expectResult(true, { foo: { isNamespaceAgnostic: false, multiNamespace: false } }); + expectResult(true, { foo: { isNamespaceAgnostic: false, multiNamespace: undefined } }); + expectResult(true, { foo: { isNamespaceAgnostic: undefined, multiNamespace: false } }); + expectResult(true, { foo: { isNamespaceAgnostic: undefined, multiNamespace: undefined } }); + }); +}); + +describe('#isMultiNamespace', () => { + const expectResult = (expected: boolean, schemaDefinition?: SavedObjectsSchemaDefinition) => { + const schema = new SavedObjectsSchema(schemaDefinition); + const result = schema.isMultiNamespace('foo'); + expect(result).toBe(expected); + }; + + it(`returns false when no schema is defined`, () => { + expectResult(false); + }); + + it(`returns false for unknown types`, () => { + expectResult(false, { bar: {} }); + }); + + it(`returns false for explicitly namespace-agnostic type`, () => { + expectResult(false, { foo: { isNamespaceAgnostic: true } }); + }); + + it(`returns false for non-multi-namespace type`, () => { + expectResult(false, { foo: { multiNamespace: false } }); + expectResult(false, { foo: { multiNamespace: undefined } }); + }); + + it(`returns true for non-namespace-agnostic and explicitly multi-namespace type`, () => { + expectResult(true, { foo: { isNamespaceAgnostic: false, multiNamespace: true } }); + expectResult(true, { foo: { isNamespaceAgnostic: undefined, multiNamespace: true } }); }); }); diff --git a/src/core/server/saved_objects/schema/schema.ts b/src/core/server/saved_objects/schema/schema.ts index 17ca406ea109a..ba1905158e822 100644 --- a/src/core/server/saved_objects/schema/schema.ts +++ b/src/core/server/saved_objects/schema/schema.ts @@ -24,7 +24,8 @@ import { LegacyConfig } from '../../legacy'; * @internal **/ interface SavedObjectsSchemaTypeDefinition { - isNamespaceAgnostic: boolean; + isNamespaceAgnostic?: boolean; + multiNamespace?: boolean; hidden?: boolean; indexPattern?: ((config: LegacyConfig) => string) | string; convertToAliasScript?: string; @@ -72,7 +73,7 @@ export class SavedObjectsSchema { } public isNamespaceAgnostic(type: string) { - // if no plugins have registered a uiExports.savedObjectSchemas, + // if no plugins have registered a Saved Objects Schema, // this.schema will be undefined, and no types are namespace agnostic if (!this.definition) { return false; @@ -84,4 +85,32 @@ export class SavedObjectsSchema { } return Boolean(typeSchema.isNamespaceAgnostic); } + + public isSingleNamespace(type: string) { + // if no plugins have registered a Saved Objects Schema, + // this.schema will be undefined, and all types are namespace isolated + if (!this.definition) { + return true; + } + + const typeSchema = this.definition[type]; + if (!typeSchema) { + return true; + } + return !Boolean(typeSchema.isNamespaceAgnostic) && !Boolean(typeSchema.multiNamespace); + } + + public isMultiNamespace(type: string) { + // if no plugins have registered a Saved Objects Schema, + // this.schema will be undefined, and no types are multi-namespace + if (!this.definition) { + return false; + } + + const typeSchema = this.definition[type]; + if (!typeSchema) { + return false; + } + return !Boolean(typeSchema.isNamespaceAgnostic) && Boolean(typeSchema.multiNamespace); + } } diff --git a/src/core/server/saved_objects/serialization/serializer.test.ts b/src/core/server/saved_objects/serialization/serializer.test.ts index 8f09b25bb3908..1a7dfdd2d130e 100644 --- a/src/core/server/saved_objects/serialization/serializer.test.ts +++ b/src/core/server/saved_objects/serialization/serializer.test.ts @@ -19,101 +19,101 @@ import _ from 'lodash'; import { SavedObjectsSerializer } from './serializer'; +import { SavedObjectsRawDoc } from './types'; import { typeRegistryMock } from '../saved_objects_type_registry.mock'; import { encodeVersion } from '../version'; -describe('saved object conversion', () => { - let typeRegistry: ReturnType; - - beforeEach(() => { - typeRegistry = typeRegistryMock.create(); - typeRegistry.isNamespaceAgnostic.mockReturnValue(false); +let typeRegistry = typeRegistryMock.create(); +typeRegistry.isNamespaceAgnostic.mockReturnValue(true); +typeRegistry.isSingleNamespace.mockReturnValue(false); +typeRegistry.isMultiNamespace.mockReturnValue(false); +const namespaceAgnosticSerializer = new SavedObjectsSerializer(typeRegistry); + +typeRegistry = typeRegistryMock.create(); +typeRegistry.isNamespaceAgnostic.mockReturnValue(false); +typeRegistry.isSingleNamespace.mockReturnValue(true); +typeRegistry.isMultiNamespace.mockReturnValue(false); +const singleNamespaceSerializer = new SavedObjectsSerializer(typeRegistry); + +typeRegistry = typeRegistryMock.create(); +typeRegistry.isNamespaceAgnostic.mockReturnValue(false); +typeRegistry.isSingleNamespace.mockReturnValue(false); +typeRegistry.isMultiNamespace.mockReturnValue(true); +const multiNamespaceSerializer = new SavedObjectsSerializer(typeRegistry); + +const sampleTemplate = { + _id: 'foo:bar', + _source: { + type: 'foo', + }, +}; +const createSampleDoc = (raw: any, template = sampleTemplate): SavedObjectsRawDoc => + _.defaultsDeep(raw, template); + +describe('#rawToSavedObject', () => { + test('it copies the _source.type property to type', () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + }, + }); + expect(actual).toHaveProperty('type', 'foo'); }); - describe('#rawToSavedObject', () => { - test('it copies the _source.type property to type', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - }, - }); - expect(actual).toHaveProperty('type', 'foo'); + test('it copies the _source.references property to references', () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + references: [{ name: 'ref_0', type: 'index-pattern', id: 'pattern*' }], + }, }); + expect(actual).toHaveProperty('references', [ + { + name: 'ref_0', + type: 'index-pattern', + id: 'pattern*', + }, + ]); + }); - test('it copies the _source.references property to references', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - references: [{ name: 'ref_0', type: 'index-pattern', id: 'pattern*' }], - }, - }); - expect(actual).toHaveProperty('references', [ - { - name: 'ref_0', - type: 'index-pattern', - id: 'pattern*', + test('if specified it copies the _source.migrationVersion property to migrationVersion', () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + migrationVersion: { + hello: '1.2.3', + acl: '33.3.5', }, - ]); + }, }); - - test('if specified it copies the _source.migrationVersion property to migrationVersion', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - migrationVersion: { - hello: '1.2.3', - acl: '33.3.5', - }, - }, - }); - expect(actual).toHaveProperty('migrationVersion', { - hello: '1.2.3', - acl: '33.3.5', - }); + expect(actual).toHaveProperty('migrationVersion', { + hello: '1.2.3', + acl: '33.3.5', }); + }); - test(`if _source.migrationVersion is unspecified it doesn't set migrationVersion`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - }, - }); - expect(actual).not.toHaveProperty('migrationVersion'); + test(`if _source.migrationVersion is unspecified it doesn't set migrationVersion`, () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + }, }); + expect(actual).not.toHaveProperty('migrationVersion'); + }); - test('it converts the id and type properties, and retains migrationVersion', () => { - const now = String(new Date()); - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'hello:world', - _seq_no: 3, - _primary_term: 1, - _source: { - type: 'hello', - hello: { - a: 'b', - c: 'd', - }, - migrationVersion: { - hello: '1.2.3', - acl: '33.3.5', - }, - updated_at: now, - }, - }); - const expected = { - id: 'world', + test('it converts the id and type properties, and retains migrationVersion', () => { + const now = String(new Date()); + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'hello:world', + _seq_no: 3, + _primary_term: 1, + _source: { type: 'hello', - version: encodeVersion(3, 1), - attributes: { + hello: { a: 'b', c: 'd', }, @@ -122,909 +122,937 @@ describe('saved object conversion', () => { acl: '33.3.5', }, updated_at: now, - references: [], - }; - expect(expected).toEqual(actual); + }, + }); + const expected = { + id: 'world', + type: 'hello', + version: encodeVersion(3, 1), + attributes: { + a: 'b', + c: 'd', + }, + migrationVersion: { + hello: '1.2.3', + acl: '33.3.5', + }, + updated_at: now, + references: [], + }; + expect(expected).toEqual(actual); + }); + + test(`if version is unspecified it doesn't set version`, () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + hello: {}, + }, }); + expect(actual).not.toHaveProperty('version'); + }); - test(`if version is unspecified it doesn't set version`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ + test(`if specified it encodes _seq_no and _primary_term to version`, () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _seq_no: 4, + _primary_term: 1, + _source: { + type: 'foo', + hello: {}, + }, + }); + expect(actual).toHaveProperty('version', encodeVersion(4, 1)); + }); + + test(`if only _seq_no is specified it throws`, () => { + expect(() => + singleNamespaceSerializer.rawToSavedObject({ _id: 'foo:bar', + _seq_no: 4, _source: { type: 'foo', hello: {}, }, - }); - expect(actual).not.toHaveProperty('version'); - }); + }) + ).toThrowErrorMatchingInlineSnapshot(`"_primary_term from elasticsearch must be an integer"`); + }); - test(`if specified it encodes _seq_no and _primary_term to version`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ + test(`if only _primary_term is throws`, () => { + expect(() => + singleNamespaceSerializer.rawToSavedObject({ _id: 'foo:bar', - _seq_no: 4, _primary_term: 1, _source: { type: 'foo', hello: {}, }, - }); - expect(actual).toHaveProperty('version', encodeVersion(4, 1)); - }); + }) + ).toThrowErrorMatchingInlineSnapshot(`"_seq_no from elasticsearch must be an integer"`); + }); - test(`if only _seq_no is specified it throws`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect(() => - serializer.rawToSavedObject({ - _id: 'foo:bar', - _seq_no: 4, - _source: { - type: 'foo', - hello: {}, - }, - }) - ).toThrowErrorMatchingInlineSnapshot(`"_primary_term from elasticsearch must be an integer"`); + test('if specified it copies the _source.updated_at property to updated_at', () => { + const now = Date(); + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + updated_at: now, + }, }); + expect(actual).toHaveProperty('updated_at', now); + }); - test(`if only _primary_term is throws`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect(() => - serializer.rawToSavedObject({ - _id: 'foo:bar', - _primary_term: 1, - _source: { - type: 'foo', - hello: {}, - }, - }) - ).toThrowErrorMatchingInlineSnapshot(`"_seq_no from elasticsearch must be an integer"`); + test(`if _source.updated_at is unspecified it doesn't set updated_at`, () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'foo:bar', + _source: { + type: 'foo', + }, }); + expect(actual).not.toHaveProperty('updated_at'); + }); - test('if specified it copies the _source.updated_at property to updated_at', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const now = Date(); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - updated_at: now, + test('it does not pass unknown properties through', () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'universe', + _source: { + type: 'hello', + hello: { + world: 'earth', }, - }); - expect(actual).toHaveProperty('updated_at', now); + banjo: 'Steve Martin', + }, + }); + expect(actual).toEqual({ + id: 'universe', + type: 'hello', + attributes: { + world: 'earth', + }, + references: [], }); + }); - test(`if _source.updated_at is unspecified it doesn't set updated_at`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - }, - }); - expect(actual).not.toHaveProperty('updated_at'); + test('it does not create attributes if [type] is missing', () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'universe', + _source: { + type: 'hello', + }, }); + expect(actual).toEqual({ + id: 'universe', + type: 'hello', + references: [], + }); + }); - test('it does not pass unknown properties through', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ + test('it fails for documents which do not specify a type', () => { + expect(() => + singleNamespaceSerializer.rawToSavedObject({ _id: 'universe', _source: { - type: 'hello', hello: { world: 'earth', }, - banjo: 'Steve Martin', + } as any, + }) + ).toThrow(/Expected "undefined" to be a saved object type/); + }); + + test('it is complimentary with savedObjectToRaw', () => { + const raw = { + _id: 'foo-namespace:foo:bar', + _primary_term: 24, + _seq_no: 42, + _source: { + type: 'foo', + foo: { + meaning: 42, + nested: { stuff: 'here' }, }, - }); - expect(actual).toEqual({ - id: 'universe', - type: 'hello', - attributes: { - world: 'earth', + migrationVersion: { + foo: '1.2.3', + bar: '9.8.7', }, + namespace: 'foo-namespace', + updated_at: String(new Date()), references: [], - }); - }); + }, + }; + + expect( + singleNamespaceSerializer.savedObjectToRaw( + singleNamespaceSerializer.rawToSavedObject(_.cloneDeep(raw)) + ) + ).toEqual(raw); + }); - test('it does not create attributes if [type] is missing', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'universe', - _source: { - type: 'hello', - }, - }); - expect(actual).toEqual({ - id: 'universe', + test('it handles unprefixed ids', () => { + const actual = singleNamespaceSerializer.rawToSavedObject({ + _id: 'universe', + _source: { type: 'hello', - references: [], - }); + }, }); - test('it fails for documents which do not specify a type', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect(() => - serializer.rawToSavedObject({ - _id: 'universe', - _source: { - hello: { - world: 'earth', - }, - } as any, - }) - ).toThrow(/Expected "undefined" to be a saved object type/); + expect(actual).toHaveProperty('id', 'universe'); + }); + + describe('namespace-agnostic type with a namespace', () => { + const raw = createSampleDoc({ _source: { namespace: 'baz' } }); + const actual = namespaceAgnosticSerializer.rawToSavedObject(raw); + + test(`removes type prefix from _id`, () => { + expect(actual).toHaveProperty('id', 'bar'); }); - test('it is complimentary with savedObjectToRaw', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const raw = { - _id: 'foo-namespace:foo:bar', - _primary_term: 24, - _seq_no: 42, - _source: { - type: 'foo', - foo: { - meaning: 42, - nested: { stuff: 'here' }, - }, - migrationVersion: { - foo: '1.2.3', - bar: '9.8.7', - }, - namespace: 'foo-namespace', - updated_at: String(new Date()), - references: [], - }, - }; + test(`copies _id to id if prefixed by namespace and type`, () => { + const _id = `${raw._source.namespace}:${raw._id}`; + const _actual = namespaceAgnosticSerializer.rawToSavedObject({ ...raw, _id }); + expect(_actual).toHaveProperty('id', _id); + }); - expect(serializer.savedObjectToRaw(serializer.rawToSavedObject(_.cloneDeep(raw)))).toEqual( - raw - ); + test(`doesn't copy _source.namespace to namespace`, () => { + expect(actual).not.toHaveProperty('namespace'); }); + }); - test('it handles unprefixed ids', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'universe', - _source: { - type: 'hello', - }, - }); + describe('namespace-agnostic type with namespaces', () => { + const raw = createSampleDoc({ _source: { namespaces: ['baz'] } }); + const actual = namespaceAgnosticSerializer.rawToSavedObject(raw); - expect(actual).toHaveProperty('id', 'universe'); + test(`doesn't copy _source.namespaces to namespaces`, () => { + expect(actual).not.toHaveProperty('namespaces'); }); + }); - describe('namespaced type without a namespace', () => { - test(`removes type prefix from _id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - }, - }); + describe('single-namespace type without a namespace', () => { + const raw = createSampleDoc({}); + const actual = singleNamespaceSerializer.rawToSavedObject(raw); - expect(actual).toHaveProperty('id', 'bar'); - }); + test(`removes type prefix from _id`, () => { + expect(actual).toHaveProperty('id', 'bar'); + }); - test(`if prefixed by random prefix and type it copies _id to id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'random:foo:bar', - _source: { - type: 'foo', - }, - }); + test(`copies _id to id if prefixed by random prefix and type`, () => { + const _id = `random:${raw._id}`; + const _actual = singleNamespaceSerializer.rawToSavedObject({ ...raw, _id }); + expect(_actual).toHaveProperty('id', _id); + }); - expect(actual).toHaveProperty('id', 'random:foo:bar'); - }); + test(`doesn't specify namespace`, () => { + expect(actual).not.toHaveProperty('namespace'); + }); + }); - test(`doesn't specify namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - }, - }); + describe('single-namespace type with a namespace', () => { + const namespace = 'baz'; + const raw = createSampleDoc({ _source: { namespace } }); + const actual = singleNamespaceSerializer.rawToSavedObject(raw); - expect(actual).not.toHaveProperty('namespace'); - }); + test(`removes type and namespace prefix from _id`, () => { + const _id = `${namespace}:${raw._id}`; + const _actual = singleNamespaceSerializer.rawToSavedObject({ ...raw, _id }); + expect(_actual).toHaveProperty('id', 'bar'); }); - describe('namespaced type with a namespace', () => { - test(`removes type and namespace prefix from _id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'baz:foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); + test(`copies _id to id if prefixed only by type`, () => { + expect(actual).toHaveProperty('id', raw._id); + }); - expect(actual).toHaveProperty('id', 'bar'); - }); + test(`copies _id to id if prefixed by random prefix and type`, () => { + const _id = `random:${raw._id}`; + const _actual = singleNamespaceSerializer.rawToSavedObject({ ...raw, _id }); + expect(_actual).toHaveProperty('id', _id); + }); - test(`if prefixed by only type it copies _id to id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); + test(`copies _source.namespace to namespace`, () => { + expect(actual).toHaveProperty('namespace', 'baz'); + }); + }); - expect(actual).toHaveProperty('id', 'foo:bar'); - }); + describe('single-namespace type with namespaces', () => { + const raw = createSampleDoc({ _source: { namespaces: ['baz'] } }); + const actual = singleNamespaceSerializer.rawToSavedObject(raw); - test(`if prefixed by random prefix and type it copies _id to id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'random:foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); + test(`doesn't copy _source.namespaces to namespaces`, () => { + expect(actual).not.toHaveProperty('namespaces'); + }); + }); - expect(actual).toHaveProperty('id', 'random:foo:bar'); - }); + describe('multi-namespace type with a namespace', () => { + const raw = createSampleDoc({ _source: { namespace: 'baz' } }); + const actual = multiNamespaceSerializer.rawToSavedObject(raw); - test(`copies _source.namespace to namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'baz:foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); + test(`removes type prefix from _id`, () => { + expect(actual).toHaveProperty('id', 'bar'); + }); - expect(actual).toHaveProperty('namespace', 'baz'); - }); + test(`copies _id to id if prefixed by namespace and type`, () => { + const _id = `${raw._source.namespace}:${raw._id}`; + const _actual = multiNamespaceSerializer.rawToSavedObject({ ...raw, _id }); + expect(_actual).toHaveProperty('id', _id); }); - describe('namespace agnostic type with a namespace', () => { - beforeEach(() => { - typeRegistry.isNamespaceAgnostic.mockReturnValue(true); - }); + test(`doesn't copy _source.namespace to namespace`, () => { + expect(actual).not.toHaveProperty('namespace'); + }); + }); - test(`removes type prefix from _id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); + describe('multi-namespace type with namespaces', () => { + const raw = createSampleDoc({ _source: { namespaces: ['baz'] } }); + const actual = multiNamespaceSerializer.rawToSavedObject(raw); - expect(actual).toHaveProperty('id', 'bar'); - }); + test(`copies _source.namespaces to namespaces`, () => { + expect(actual).toHaveProperty('namespaces', ['baz']); + }); + }); +}); - test(`if prefixed by namespace and type it copies _id to id`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'baz:foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); +describe('#savedObjectToRaw', () => { + test('it copies the type property to _source.type and uses the ROOT_TYPE as _type', () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + attributes: {}, + } as any); - expect(actual).toHaveProperty('id', 'baz:foo:bar'); - }); + expect(actual._source).toHaveProperty('type', 'foo'); + }); - test(`doesn't copy _source.namespace to namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.rawToSavedObject({ - _id: 'baz:foo:bar', - _source: { - type: 'foo', - namespace: 'baz', - }, - }); + test('it copies the references property to _source.references', () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + id: '1', + type: 'foo', + attributes: {}, + references: [{ name: 'ref_0', type: 'index-pattern', id: 'pattern*' }], + }); + expect(actual._source).toHaveProperty('references', [ + { + name: 'ref_0', + type: 'index-pattern', + id: 'pattern*', + }, + ]); + }); + + test('if specified it copies the updated_at property to _source.updated_at', () => { + const now = new Date(); + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: '', + attributes: {}, + updated_at: now, + } as any); + + expect(actual._source).toHaveProperty('updated_at', now); + }); + + test(`if unspecified it doesn't add updated_at property to _source`, () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: '', + attributes: {}, + } as any); - expect(actual).not.toHaveProperty('namespace'); - }); + expect(actual._source).not.toHaveProperty('updated_at'); + }); + + test('it copies the migrationVersion property to _source.migrationVersion', () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: '', + attributes: {}, + migrationVersion: { + foo: '1.2.3', + bar: '9.8.7', + }, + } as any); + + expect(actual._source).toHaveProperty('migrationVersion', { + foo: '1.2.3', + bar: '9.8.7', }); }); - describe('#savedObjectToRaw', () => { - test('it copies the type property to _source.type and uses the ROOT_TYPE as _type', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: 'foo', + test(`if unspecified it doesn't add migrationVersion property to _source`, () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: '', + attributes: {}, + } as any); + + expect(actual._source).not.toHaveProperty('migrationVersion'); + }); + + test('it decodes the version property to _seq_no and _primary_term', () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: '', + attributes: {}, + version: encodeVersion(1, 2), + } as any); + + expect(actual).toHaveProperty('_seq_no', 1); + expect(actual).toHaveProperty('_primary_term', 2); + }); + + test(`if unspecified it doesn't add _seq_no or _primary_term properties`, () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: '', + attributes: {}, + } as any); + + expect(actual).not.toHaveProperty('_seq_no'); + expect(actual).not.toHaveProperty('_primary_term'); + }); + + test(`if version invalid it throws`, () => { + expect(() => + singleNamespaceSerializer.savedObjectToRaw({ + type: '', attributes: {}, - } as any); + version: 'foo', + } as any) + ).toThrowErrorMatchingInlineSnapshot(`"Invalid version [foo]"`); + }); - expect(actual._source).toHaveProperty('type', 'foo'); + test('it copies attributes to _source[type]', () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + attributes: { + foo: true, + bar: 'quz', + }, + } as any); + + expect(actual._source).toHaveProperty('foo', { + foo: true, + bar: 'quz', }); + }); - test('it copies the references property to _source.references', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - id: '1', + describe('single-namespace type without a namespace', () => { + test('generates an id prefixed with type, if no id is specified', () => { + const v1 = singleNamespaceSerializer.savedObjectToRaw({ type: 'foo', - attributes: {}, - references: [{ name: 'ref_0', type: 'index-pattern', id: 'pattern*' }], - }); - expect(actual._source).toHaveProperty('references', [ - { - name: 'ref_0', - type: 'index-pattern', - id: 'pattern*', - }, - ]); + attributes: { bar: true }, + } as any); + + const v2 = singleNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + attributes: { bar: true }, + } as any); + + expect(v1._id).toMatch(/^foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); }); - test('if specified it copies the updated_at property to _source.updated_at', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const now = new Date(); - const actual = serializer.savedObjectToRaw({ + test(`doesn't specify _source.namespace`, () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ type: '', attributes: {}, - updated_at: now, } as any); - expect(actual._source).toHaveProperty('updated_at', now); + expect(actual._source).not.toHaveProperty('namespace'); }); + }); - test(`if unspecified it doesn't add updated_at property to _source`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: '', + describe('single-namespace type with a namespace', () => { + test('generates an id prefixed with namespace and type, if no id is specified', () => { + const v1 = singleNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', + attributes: { bar: true }, + } as any); + + const v2 = singleNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', + attributes: { bar: true }, + } as any); + + expect(v1._id).toMatch(/^bar\:foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); + }); + + test(`it copies namespace to _source.namespace`, () => { + const actual = singleNamespaceSerializer.savedObjectToRaw({ + type: 'foo', attributes: {}, + namespace: 'bar', } as any); - expect(actual._source).not.toHaveProperty('updated_at'); + expect(actual._source).toHaveProperty('namespace', 'bar'); }); + }); - test('it copies the migrationVersion property to _source.migrationVersion', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: '', + describe('single-namespace type with namespaces', () => { + test('generates an id prefixed with type, if no id is specified', () => { + const v1 = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], + attributes: { bar: true }, + } as any); + + const v2 = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], + attributes: { bar: true }, + } as any); + + expect(v1._id).toMatch(/^foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); + }); + + test(`doesn't specify _source.namespaces`, () => { + const actual = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], attributes: {}, - migrationVersion: { - foo: '1.2.3', - bar: '9.8.7', - }, } as any); - expect(actual._source).toHaveProperty('migrationVersion', { - foo: '1.2.3', - bar: '9.8.7', - }); + expect(actual._source).not.toHaveProperty('namespaces'); }); + }); - test(`if unspecified it doesn't add migrationVersion property to _source`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: '', + describe('namespace-agnostic type with a namespace', () => { + test('generates an id prefixed with type, if no id is specified', () => { + const v1 = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', + attributes: { bar: true }, + } as any); + + const v2 = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', + attributes: { bar: true }, + } as any); + + expect(v1._id).toMatch(/^foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); + }); + + test(`doesn't specify _source.namespace`, () => { + const actual = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', attributes: {}, } as any); - expect(actual._source).not.toHaveProperty('migrationVersion'); + expect(actual._source).not.toHaveProperty('namespace'); }); + }); - test('it decodes the version property to _seq_no and _primary_term', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: '', + describe('namespace-agnostic type with namespaces', () => { + test('generates an id prefixed with type, if no id is specified', () => { + const v1 = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], + attributes: { bar: true }, + } as any); + + const v2 = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], + attributes: { bar: true }, + } as any); + + expect(v1._id).toMatch(/^foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); + }); + + test(`doesn't specify _source.namespaces`, () => { + const actual = namespaceAgnosticSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], attributes: {}, - version: encodeVersion(1, 2), } as any); - expect(actual).toHaveProperty('_seq_no', 1); - expect(actual).toHaveProperty('_primary_term', 2); + expect(actual._source).not.toHaveProperty('namespaces'); }); + }); - test(`if unspecified it doesn't add _seq_no or _primary_term properties`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: '', + describe('multi-namespace type with a namespace', () => { + test('generates an id prefixed with type, if no id is specified', () => { + const v1 = multiNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', + attributes: { bar: true }, + } as any); + + const v2 = multiNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', + attributes: { bar: true }, + } as any); + + expect(v1._id).toMatch(/^foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); + }); + + test(`doesn't specify _source.namespace`, () => { + const actual = multiNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespace: 'bar', attributes: {}, } as any); - expect(actual).not.toHaveProperty('_seq_no'); - expect(actual).not.toHaveProperty('_primary_term'); + expect(actual._source).not.toHaveProperty('namespace'); }); + }); + + describe('multi-namespace type with namespaces', () => { + test('generates an id prefixed with type, if no id is specified', () => { + const v1 = multiNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], + attributes: { bar: true }, + } as any); + + const v2 = multiNamespaceSerializer.savedObjectToRaw({ + type: 'foo', + namespaces: ['bar'], + attributes: { bar: true }, + } as any); - test(`if version invalid it throws`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect(() => - serializer.savedObjectToRaw({ - type: '', - attributes: {}, - version: 'foo', - } as any) - ).toThrowErrorMatchingInlineSnapshot(`"Invalid version [foo]"`); + expect(v1._id).toMatch(/^foo\:[\w-]+$/); + expect(v1._id).not.toEqual(v2._id); }); - test('it copies attributes to _source[type]', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ + test(`it copies namespaces to _source.namespaces`, () => { + const actual = multiNamespaceSerializer.savedObjectToRaw({ type: 'foo', - attributes: { - foo: true, - bar: 'quz', - }, + namespaces: ['bar'], + attributes: {}, } as any); - expect(actual._source).toHaveProperty('foo', { - foo: true, - bar: 'quz', - }); + expect(actual._source).toHaveProperty('namespaces', ['bar']); }); + }); +}); - describe('namespaced type without a namespace', () => { - test('generates an id prefixed with type, if no id is specified', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const v1 = serializer.savedObjectToRaw({ - type: 'foo', - attributes: { - bar: true, +describe('#isRawSavedObject', () => { + describe('single-namespace type without a namespace', () => { + test('is true if the id is prefixed and the type matches', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'hello', + hello: {}, }, - } as any); + }) + ).toBeTruthy(); + }); - const v2 = serializer.savedObjectToRaw({ - type: 'foo', - attributes: { - bar: true, + test('is false if the id is not prefixed', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'world', + _source: { + type: 'hello', + hello: {}, }, - } as any); + }) + ).toBeFalsy(); + }); - expect(v1._id).toMatch(/foo\:[\w-]+$/); - expect(v1._id).not.toEqual(v2._id); - }); + test('is false if the type attribute is missing', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + hello: {}, + } as any, + }) + ).toBeFalsy(); + }); - test(`doesn't specify _source.namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: '', - attributes: {}, - } as any); + test(`is false if the type prefix omits the :`, () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'helloworld', + _source: { + type: 'hello', + hello: {}, + }, + }) + ).toBeFalsy(); + }); - expect(actual._source).not.toHaveProperty('namespace'); - }); + test('is false if the type attribute does not match the id', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'jam', + jam: {}, + hello: {}, + }, + }) + ).toBeFalsy(); }); - describe('namespaced type with a namespace', () => { - test('generates an id prefixed with namespace and type, if no id is specified', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const v1 = serializer.savedObjectToRaw({ - type: 'foo', - namespace: 'bar', - attributes: { - bar: true, + test('is false if there is no [type] attribute', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'hello', + jam: {}, }, - } as any); + }) + ).toBeFalsy(); + }); + }); - const v2 = serializer.savedObjectToRaw({ - type: 'foo', - namespace: 'bar', - attributes: { - bar: true, + describe('single-namespace type with a namespace', () => { + test('is true if the id is prefixed with type and namespace and the type matches', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'foo:hello:world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', }, - } as any); + }) + ).toBeTruthy(); + }); - expect(v1._id).toMatch(/bar\:foo\:[\w-]+$/); - expect(v1._id).not.toEqual(v2._id); - }); + test('is false if the id is not prefixed by anything', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); - test(`it copies namespace to _source.namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: 'foo', - attributes: {}, - namespace: 'bar', - } as any); + test('is false if the id is prefixed only with type and the type matches', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + + test('is false if the id is prefixed only with namespace and the namespace matches', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'foo:world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); - expect(actual._source).toHaveProperty('namespace', 'bar'); - }); + test(`is false if the id prefix omits the trailing :`, () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'foo:helloworld', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); }); - describe('namespace agnostic type with a namespace', () => { - beforeEach(() => { - typeRegistry.isNamespaceAgnostic.mockReturnValue(true); - }); + test('is false if the type attribute is missing', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'foo:hello:world', + _source: { + hello: {}, + namespace: 'foo', + } as any, + }) + ).toBeFalsy(); + }); - test('generates an id prefixed with type, if no id is specified', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const v1 = serializer.savedObjectToRaw({ - type: 'foo', - namespace: 'bar', - attributes: { - bar: true, + test('is false if the type attribute does not match the id', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'foo:hello:world', + _source: { + type: 'jam', + jam: {}, + hello: {}, + namespace: 'foo', }, - } as any); + }) + ).toBeFalsy(); + }); - const v2 = serializer.savedObjectToRaw({ - type: 'foo', - namespace: 'bar', - attributes: { - bar: true, + test('is false if the namespace attribute does not match the id', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'bar:jam:world', + _source: { + type: 'jam', + jam: {}, + hello: {}, + namespace: 'foo', }, - } as any); + }) + ).toBeFalsy(); + }); - expect(v1._id).toMatch(/foo\:[\w-]+$/); - expect(v1._id).not.toEqual(v2._id); - }); + test('is false if there is no [type] attribute', () => { + expect( + singleNamespaceSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'hello', + jam: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + }); - test(`doesn't specify _source.namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const actual = serializer.savedObjectToRaw({ - type: 'foo', - namespace: 'bar', - attributes: {}, - } as any); + describe('namespace-agnostic type with a namespace', () => { + test('is true if the id is prefixed with type and the type matches', () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeTruthy(); + }); + + test('is false if the id is not prefixed', () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + + test('is false if the id is prefixed with type and namespace', () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'foo:hello:world', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + + test(`is false if the type prefix omits the :`, () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'helloworld', + _source: { + type: 'hello', + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + + test('is false if the type attribute is missing', () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + hello: {}, + namespace: 'foo', + } as any, + }) + ).toBeFalsy(); + }); + + test('is false if the type attribute does not match the id', () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'jam', + jam: {}, + hello: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + + test('is false if there is no [type] attribute', () => { + expect( + namespaceAgnosticSerializer.isRawSavedObject({ + _id: 'hello:world', + _source: { + type: 'hello', + jam: {}, + namespace: 'foo', + }, + }) + ).toBeFalsy(); + }); + }); +}); - expect(actual._source).not.toHaveProperty('namespace'); - }); +describe('#generateRawId', () => { + describe('single-namespace type without a namespace', () => { + test('generates an id if none is specified', () => { + const id = singleNamespaceSerializer.generateRawId('', 'goodbye'); + expect(id).toMatch(/^goodbye\:[\w-]+$/); + }); + + test('uses the id that is specified', () => { + const id = singleNamespaceSerializer.generateRawId('', 'hello', 'world'); + expect(id).toEqual('hello:world'); }); }); - describe('#isRawSavedObject', () => { - describe('namespaced type without a namespace', () => { - test('is true if the id is prefixed and the type matches', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'hello', - hello: {}, - }, - }) - ).toBeTruthy(); - }); - - test('is false if the id is not prefixed', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'world', - _source: { - type: 'hello', - hello: {}, - }, - }) - ).toBeFalsy(); - }); - - test('is false if the type attribute is missing', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - hello: {}, - } as any, - }) - ).toBeFalsy(); - }); - - test(`is false if the type prefix omits the :`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'helloworld', - _source: { - type: 'hello', - hello: {}, - }, - }) - ).toBeFalsy(); - }); - - test('is false if the type attribute does not match the id', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'jam', - jam: {}, - hello: {}, - }, - }) - ).toBeFalsy(); - }); - - test('is false if there is no [type] attribute', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'hello', - jam: {}, - }, - }) - ).toBeFalsy(); - }); - }); - - describe('namespaced type with a namespace', () => { - test('is true if the id is prefixed with type and namespace and the type matches', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'foo:hello:world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeTruthy(); - }); - - test('is false if the id is not prefixed by anything', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if the id is prefixed only with type and the type matches', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if the id is prefixed only with namespace and the namespace matches', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'foo:world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test(`is false if the id prefix omits the trailing :`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'foo:helloworld', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if the type attribute is missing', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'foo:hello:world', - _source: { - hello: {}, - namespace: 'foo', - } as any, - }) - ).toBeFalsy(); - }); - - test('is false if the type attribute does not match the id', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'foo:hello:world', - _source: { - type: 'jam', - jam: {}, - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if the namespace attribute does not match the id', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'bar:jam:world', - _source: { - type: 'jam', - jam: {}, - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if there is no [type] attribute', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'hello', - jam: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - }); - - describe('namespace agnostic type with a namespace', () => { - beforeEach(() => { - typeRegistry.isNamespaceAgnostic.mockReturnValue(true); - }); - - test('is true if the id is prefixed with type and the type matches', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeTruthy(); - }); - - test('is false if the id is not prefixed', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if the id is prefixed with type and namespace', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'foo:hello:world', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test(`is false if the type prefix omits the :`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'helloworld', - _source: { - type: 'hello', - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if the type attribute is missing', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - hello: {}, - namespace: 'foo', - } as any, - }) - ).toBeFalsy(); - }); - - test('is false if the type attribute does not match the id', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'jam', - jam: {}, - hello: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); - - test('is false if there is no [type] attribute', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - expect( - serializer.isRawSavedObject({ - _id: 'hello:world', - _source: { - type: 'hello', - jam: {}, - namespace: 'foo', - }, - }) - ).toBeFalsy(); - }); + describe('single-namespace type with a namespace', () => { + test('generates an id if none is specified and prefixes namespace', () => { + const id = singleNamespaceSerializer.generateRawId('foo', 'goodbye'); + expect(id).toMatch(/^foo:goodbye\:[\w-]+$/); + }); + + test('uses the id that is specified and prefixes the namespace', () => { + const id = singleNamespaceSerializer.generateRawId('foo', 'hello', 'world'); + expect(id).toEqual('foo:hello:world'); }); }); - describe('#generateRawId', () => { - describe('namespaced type without a namespace', () => { - test('generates an id if none is specified', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const id = serializer.generateRawId('', 'goodbye'); - expect(id).toMatch(/goodbye\:[\w-]+$/); - }); - - test('uses the id that is specified', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const id = serializer.generateRawId('', 'hello', 'world'); - expect(id).toMatch('hello:world'); - }); - }); - - describe('namespaced type with a namespace', () => { - test('generates an id if none is specified and prefixes namespace', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const id = serializer.generateRawId('foo', 'goodbye'); - expect(id).toMatch(/foo:goodbye\:[\w-]+$/); - }); - - test('uses the id that is specified and prefixes the namespace', () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const id = serializer.generateRawId('foo', 'hello', 'world'); - expect(id).toMatch('foo:hello:world'); - }); - }); - - describe('namespace agnostic type with a namespace', () => { - test(`generates an id if none is specified and doesn't prefix namespace`, () => { - typeRegistry.isNamespaceAgnostic.mockReturnValue(true); - - const serializer = new SavedObjectsSerializer(typeRegistry); - const id = serializer.generateRawId('foo', 'goodbye'); - expect(id).toMatch(/goodbye\:[\w-]+$/); - }); - - test(`uses the id that is specified and doesn't prefix the namespace`, () => { - const serializer = new SavedObjectsSerializer(typeRegistry); - const id = serializer.generateRawId('foo', 'hello', 'world'); - expect(id).toMatch('hello:world'); - }); + describe('namespace-agnostic type with a namespace', () => { + test(`generates an id if none is specified and doesn't prefix namespace`, () => { + const id = namespaceAgnosticSerializer.generateRawId('foo', 'goodbye'); + expect(id).toMatch(/^goodbye\:[\w-]+$/); + }); + + test(`uses the id that is specified and doesn't prefix the namespace`, () => { + const id = namespaceAgnosticSerializer.generateRawId('foo', 'hello', 'world'); + expect(id).toEqual('hello:world'); }); }); }); diff --git a/src/core/server/saved_objects/serialization/serializer.ts b/src/core/server/saved_objects/serialization/serializer.ts index 99d6b0c6b59f9..3b19d494d8ecf 100644 --- a/src/core/server/saved_objects/serialization/serializer.ts +++ b/src/core/server/saved_objects/serialization/serializer.ts @@ -49,7 +49,7 @@ export class SavedObjectsSerializer { public isRawSavedObject(rawDoc: SavedObjectsRawDoc) { const { type, namespace } = rawDoc._source; const namespacePrefix = - namespace && !this.registry.isNamespaceAgnostic(type) ? `${namespace}:` : ''; + namespace && this.registry.isSingleNamespace(type) ? `${namespace}:` : ''; return Boolean( type && rawDoc._id.startsWith(`${namespacePrefix}${type}:`) && @@ -64,7 +64,7 @@ export class SavedObjectsSerializer { */ public rawToSavedObject(doc: SavedObjectsRawDoc): SavedObjectSanitizedDoc { const { _id, _source, _seq_no, _primary_term } = doc; - const { type, namespace } = _source; + const { type, namespace, namespaces } = _source; const version = _seq_no != null || _primary_term != null @@ -74,7 +74,8 @@ export class SavedObjectsSerializer { return { type, id: this.trimIdPrefix(namespace, type, _id), - ...(namespace && !this.registry.isNamespaceAgnostic(type) && { namespace }), + ...(namespace && this.registry.isSingleNamespace(type) && { namespace }), + ...(namespaces && this.registry.isMultiNamespace(type) && { namespaces }), attributes: _source[type], references: _source.references || [], ...(_source.migrationVersion && { migrationVersion: _source.migrationVersion }), @@ -93,6 +94,7 @@ export class SavedObjectsSerializer { id, type, namespace, + namespaces, attributes, migrationVersion, updated_at, @@ -103,7 +105,8 @@ export class SavedObjectsSerializer { [type]: attributes, type, references, - ...(namespace && !this.registry.isNamespaceAgnostic(type) && { namespace }), + ...(namespace && this.registry.isSingleNamespace(type) && { namespace }), + ...(namespaces && this.registry.isMultiNamespace(type) && { namespaces }), ...(migrationVersion && { migrationVersion }), ...(updated_at && { updated_at }), }; @@ -124,7 +127,7 @@ export class SavedObjectsSerializer { */ public generateRawId(namespace: string | undefined, type: string, id?: string) { const namespacePrefix = - namespace && !this.registry.isNamespaceAgnostic(type) ? `${namespace}:` : ''; + namespace && this.registry.isSingleNamespace(type) ? `${namespace}:` : ''; return `${namespacePrefix}${type}:${id || uuid.v1()}`; } @@ -133,7 +136,7 @@ export class SavedObjectsSerializer { assertNonEmptyString(type, 'saved object type'); const namespacePrefix = - namespace && !this.registry.isNamespaceAgnostic(type) ? `${namespace}:` : ''; + namespace && this.registry.isSingleNamespace(type) ? `${namespace}:` : ''; const prefix = `${namespacePrefix}${type}:`; if (!id.startsWith(prefix)) { diff --git a/src/core/server/saved_objects/serialization/types.ts b/src/core/server/saved_objects/serialization/types.ts index dfaec127ba159..7ea61f67e9496 100644 --- a/src/core/server/saved_objects/serialization/types.ts +++ b/src/core/server/saved_objects/serialization/types.ts @@ -36,6 +36,7 @@ export interface SavedObjectsRawDoc { export interface SavedObjectsRawDocSource { type: string; namespace?: string; + namespaces?: string[]; migrationVersion?: SavedObjectsMigrationVersion; updated_at?: string; references?: SavedObjectReference[]; @@ -54,6 +55,7 @@ interface SavedObjectDoc { id?: string; // NOTE: SavedObjectDoc is used for uncreated objects where `id` is optional type: string; namespace?: string; + namespaces?: string[]; migrationVersion?: SavedObjectsMigrationVersion; version?: string; updated_at?: string; diff --git a/src/core/server/saved_objects/service/lib/__snapshots__/repository.test.js.snap b/src/core/server/saved_objects/service/lib/__snapshots__/repository.test.js.snap deleted file mode 100644 index 609906c97d599..0000000000000 --- a/src/core/server/saved_objects/service/lib/__snapshots__/repository.test.js.snap +++ /dev/null @@ -1,5 +0,0 @@ -// Jest Snapshot v1, https://goo.gl/fbAQLP - -exports[`SavedObjectsRepository #deleteByNamespace requires namespace to be a string 1`] = `"namespace is required, and must be a string"`; - -exports[`SavedObjectsRepository #deleteByNamespace requires namespace to be defined 1`] = `"namespace is required, and must be a string"`; diff --git a/src/core/server/saved_objects/service/lib/decorate_es_error.test.ts b/src/core/server/saved_objects/service/lib/decorate_es_error.test.ts index 2fd9b487f470a..1fdebd87397eb 100644 --- a/src/core/server/saved_objects/service/lib/decorate_es_error.test.ts +++ b/src/core/server/saved_objects/service/lib/decorate_es_error.test.ts @@ -100,6 +100,38 @@ describe('savedObjectsClient/decorateEsError', () => { expect(SavedObjectsErrorHelpers.isBadRequestError(error)).toBe(true); }); + describe('when es.BadRequest has a reason', () => { + it('makes a SavedObjectsClient/esCannotExecuteScriptError error when script context is disabled', () => { + const error = new esErrors.BadRequest(); + (error as Record).body = { + error: { reason: 'cannot execute scripts using [update] context' }, + }; + expect(SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)).toBe(false); + expect(decorateEsError(error)).toBe(error); + expect(SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)).toBe(true); + expect(SavedObjectsErrorHelpers.isBadRequestError(error)).toBe(false); + }); + + it('makes a SavedObjectsClient/esCannotExecuteScriptError error when inline scripts are disabled', () => { + const error = new esErrors.BadRequest(); + (error as Record).body = { + error: { reason: 'cannot execute [inline] scripts' }, + }; + expect(SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)).toBe(false); + expect(decorateEsError(error)).toBe(error); + expect(SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)).toBe(true); + expect(SavedObjectsErrorHelpers.isBadRequestError(error)).toBe(false); + }); + + it('makes a SavedObjectsClient/BadRequest error for any other reason', () => { + const error = new esErrors.BadRequest(); + (error as Record).body = { error: { reason: 'some other reason' } }; + expect(SavedObjectsErrorHelpers.isBadRequestError(error)).toBe(false); + expect(decorateEsError(error)).toBe(error); + expect(SavedObjectsErrorHelpers.isBadRequestError(error)).toBe(true); + }); + }); + it('returns other errors as Boom errors', () => { const error = new Error(); expect(error).not.toHaveProperty('isBoom'); diff --git a/src/core/server/saved_objects/service/lib/decorate_es_error.ts b/src/core/server/saved_objects/service/lib/decorate_es_error.ts index eb9bc89636435..e57f08aa7a527 100644 --- a/src/core/server/saved_objects/service/lib/decorate_es_error.ts +++ b/src/core/server/saved_objects/service/lib/decorate_es_error.ts @@ -35,6 +35,8 @@ const { NotFound, BadRequest, } = legacyElasticsearch.errors; +const SCRIPT_CONTEXT_DISABLED_REGEX = /(?:cannot execute scripts using \[)([a-z]*)(?:\] context)/; +const INLINE_SCRIPTS_DISABLED_MESSAGE = 'cannot execute [inline] scripts'; import { SavedObjectsErrorHelpers } from './errors'; @@ -43,7 +45,7 @@ export function decorateEsError(error: Error) { throw new Error('Expected an instance of Error'); } - const { reason } = get(error, 'body.error', { reason: undefined }); + const { reason } = get(error, 'body.error', { reason: undefined }) as { reason?: string }; if ( error instanceof ConnectionFault || error instanceof ServiceUnavailable || @@ -74,6 +76,12 @@ export function decorateEsError(error: Error) { } if (error instanceof BadRequest) { + if ( + SCRIPT_CONTEXT_DISABLED_REGEX.test(reason || '') || + reason === INLINE_SCRIPTS_DISABLED_MESSAGE + ) { + return SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError(error, reason); + } return SavedObjectsErrorHelpers.decorateBadRequestError(error, reason); } diff --git a/src/core/server/saved_objects/service/lib/errors.test.ts b/src/core/server/saved_objects/service/lib/errors.test.ts index 12fc913f93090..4a43835d795d1 100644 --- a/src/core/server/saved_objects/service/lib/errors.test.ts +++ b/src/core/server/saved_objects/service/lib/errors.test.ts @@ -34,6 +34,7 @@ describe('savedObjectsClient/errorTypes', () => { }); it('has boom properties', () => { + expect(errorObj).toHaveProperty('isBoom', true); expect(errorObj.output.payload).toMatchObject({ statusCode: 400, message: "Unsupported saved object type: 'someType': Bad Request", @@ -57,6 +58,7 @@ describe('savedObjectsClient/errorTypes', () => { }); it('has boom properties', () => { + expect(errorObj).toHaveProperty('isBoom', true); expect(errorObj.output.payload).toMatchObject({ statusCode: 400, message: 'test reason message: Bad Request', @@ -80,14 +82,7 @@ describe('savedObjectsClient/errorTypes', () => { it('adds boom properties', () => { const error = SavedObjectsErrorHelpers.decorateBadRequestError(new Error()); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(400); - }); - - it('preserves boom properties of input', () => { - const error = Boom.notFound(); - SavedObjectsErrorHelpers.decorateBadRequestError(error); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -95,6 +90,7 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.decorateBadRequestError(new Error('foobar')); expect(error.output.payload).toHaveProperty('message', 'foobar'); }); + it('prefixes message with passed reason', () => { const error = SavedObjectsErrorHelpers.decorateBadRequestError( new Error('foobar'), @@ -102,13 +98,21 @@ describe('savedObjectsClient/errorTypes', () => { ); expect(error.output.payload).toHaveProperty('message', 'biz: foobar'); }); + it('sets statusCode to 400', () => { const error = SavedObjectsErrorHelpers.decorateBadRequestError(new Error('foo')); expect(error.output).toHaveProperty('statusCode', 400); }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateBadRequestError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); }); }); }); + describe('NotAuthorized error', () => { describe('decorateNotAuthorizedError', () => { it('returns original object', () => { @@ -125,14 +129,7 @@ describe('savedObjectsClient/errorTypes', () => { it('adds boom properties', () => { const error = SavedObjectsErrorHelpers.decorateNotAuthorizedError(new Error()); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(401); - }); - - it('preserves boom properties of input', () => { - const error = Boom.notFound(); - SavedObjectsErrorHelpers.decorateNotAuthorizedError(error); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -140,6 +137,7 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.decorateNotAuthorizedError(new Error('foobar')); expect(error.output.payload).toHaveProperty('message', 'foobar'); }); + it('prefixes message with passed reason', () => { const error = SavedObjectsErrorHelpers.decorateNotAuthorizedError( new Error('foobar'), @@ -147,13 +145,21 @@ describe('savedObjectsClient/errorTypes', () => { ); expect(error.output.payload).toHaveProperty('message', 'biz: foobar'); }); + it('sets statusCode to 401', () => { const error = SavedObjectsErrorHelpers.decorateNotAuthorizedError(new Error('foo')); expect(error.output).toHaveProperty('statusCode', 401); }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateNotAuthorizedError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); }); }); }); + describe('Forbidden error', () => { describe('decorateForbiddenError', () => { it('returns original object', () => { @@ -170,14 +176,7 @@ describe('savedObjectsClient/errorTypes', () => { it('adds boom properties', () => { const error = SavedObjectsErrorHelpers.decorateForbiddenError(new Error()); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(403); - }); - - it('preserves boom properties of input', () => { - const error = Boom.notFound(); - SavedObjectsErrorHelpers.decorateForbiddenError(error); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -185,17 +184,26 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.decorateForbiddenError(new Error('foobar')); expect(error.output.payload).toHaveProperty('message', 'foobar'); }); + it('prefixes message with passed reason', () => { const error = SavedObjectsErrorHelpers.decorateForbiddenError(new Error('foobar'), 'biz'); expect(error.output.payload).toHaveProperty('message', 'biz: foobar'); }); + it('sets statusCode to 403', () => { const error = SavedObjectsErrorHelpers.decorateForbiddenError(new Error('foo')); expect(error.output).toHaveProperty('statusCode', 403); }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateForbiddenError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); }); }); }); + describe('NotFound error', () => { describe('createGenericNotFoundError', () => { it('makes an error identifiable as a NotFound error', () => { @@ -203,11 +211,9 @@ describe('savedObjectsClient/errorTypes', () => { expect(SavedObjectsErrorHelpers.isNotFoundError(error)).toBe(true); }); - it('is a boom error, has boom properties', () => { + it('returns a boom error', () => { const error = SavedObjectsErrorHelpers.createGenericNotFoundError(); - expect(error).toHaveProperty('isBoom'); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -215,6 +221,7 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.createGenericNotFoundError(); expect(error.output.payload).toHaveProperty('message', 'Not Found'); }); + it('sets statusCode to 404', () => { const error = SavedObjectsErrorHelpers.createGenericNotFoundError(); expect(error.output).toHaveProperty('statusCode', 404); @@ -222,6 +229,7 @@ describe('savedObjectsClient/errorTypes', () => { }); }); }); + describe('Conflict error', () => { describe('decorateConflictError', () => { it('returns original object', () => { @@ -238,14 +246,7 @@ describe('savedObjectsClient/errorTypes', () => { it('adds boom properties', () => { const error = SavedObjectsErrorHelpers.decorateConflictError(new Error()); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(409); - }); - - it('preserves boom properties of input', () => { - const error = Boom.notFound(); - SavedObjectsErrorHelpers.decorateConflictError(error); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -253,17 +254,77 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.decorateConflictError(new Error('foobar')); expect(error.output.payload).toHaveProperty('message', 'foobar'); }); + it('prefixes message with passed reason', () => { const error = SavedObjectsErrorHelpers.decorateConflictError(new Error('foobar'), 'biz'); expect(error.output.payload).toHaveProperty('message', 'biz: foobar'); }); + it('sets statusCode to 409', () => { const error = SavedObjectsErrorHelpers.decorateConflictError(new Error('foo')); expect(error.output).toHaveProperty('statusCode', 409); }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateConflictError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); + }); + }); + }); + + describe('EsCannotExecuteScript error', () => { + describe('decorateEsCannotExecuteScriptError', () => { + it('returns original object', () => { + const error = new Error(); + expect(SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError(error)).toBe(error); + }); + + it('makes the error identifiable as a EsCannotExecuteScript error', () => { + const error = new Error(); + expect(SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)).toBe(false); + SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError(error); + expect(SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)).toBe(true); + }); + + it('adds boom properties', () => { + const error = SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError(new Error()); + expect(error).toHaveProperty('isBoom', true); + }); + + describe('error.output', () => { + it('defaults to message of error', () => { + const error = SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError( + new Error('foobar') + ); + expect(error.output.payload).toHaveProperty('message', 'foobar'); + }); + + it('prefixes message with passed reason', () => { + const error = SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError( + new Error('foobar'), + 'biz' + ); + expect(error.output.payload).toHaveProperty('message', 'biz: foobar'); + }); + + it('sets statusCode to 501', () => { + const error = SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError( + new Error('foo') + ); + expect(error.output).toHaveProperty('statusCode', 400); + }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); }); }); }); + describe('EsUnavailable error', () => { describe('decorateEsUnavailableError', () => { it('returns original object', () => { @@ -280,14 +341,7 @@ describe('savedObjectsClient/errorTypes', () => { it('adds boom properties', () => { const error = SavedObjectsErrorHelpers.decorateEsUnavailableError(new Error()); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(503); - }); - - it('preserves boom properties of input', () => { - const error = Boom.notFound(); - SavedObjectsErrorHelpers.decorateEsUnavailableError(error); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -295,6 +349,7 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.decorateEsUnavailableError(new Error('foobar')); expect(error.output.payload).toHaveProperty('message', 'foobar'); }); + it('prefixes message with passed reason', () => { const error = SavedObjectsErrorHelpers.decorateEsUnavailableError( new Error('foobar'), @@ -302,13 +357,21 @@ describe('savedObjectsClient/errorTypes', () => { ); expect(error.output.payload).toHaveProperty('message', 'biz: foobar'); }); + it('sets statusCode to 503', () => { const error = SavedObjectsErrorHelpers.decorateEsUnavailableError(new Error('foo')); expect(error.output).toHaveProperty('statusCode', 503); }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateEsUnavailableError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); }); }); }); + describe('General error', () => { describe('decorateGeneralError', () => { it('returns original object', () => { @@ -318,14 +381,7 @@ describe('savedObjectsClient/errorTypes', () => { it('adds boom properties', () => { const error = SavedObjectsErrorHelpers.decorateGeneralError(new Error()); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(500); - }); - - it('preserves boom properties of input', () => { - const error = Boom.notFound(); - SavedObjectsErrorHelpers.decorateGeneralError(error); - expect(error.output.statusCode).toBe(404); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -333,10 +389,17 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.decorateGeneralError(new Error('foobar')); expect(error.output.payload.message).toMatch(/internal server error/i); }); + it('sets statusCode to 500', () => { const error = SavedObjectsErrorHelpers.decorateGeneralError(new Error('foo')); expect(error.output).toHaveProperty('statusCode', 500); }); + + it('preserves boom properties of input', () => { + const error = Boom.notFound(); + SavedObjectsErrorHelpers.decorateGeneralError(error); + expect(error.output).toHaveProperty('statusCode', 404); + }); }); }); }); @@ -363,9 +426,7 @@ describe('savedObjectsClient/errorTypes', () => { it('returns a boom error', () => { const error = SavedObjectsErrorHelpers.createEsAutoCreateIndexError(); - expect(error).toHaveProperty('isBoom'); - expect(typeof error.output).toBe('object'); - expect(error.output.statusCode).toBe(503); + expect(error).toHaveProperty('isBoom', true); }); describe('error.output', () => { @@ -373,6 +434,7 @@ describe('savedObjectsClient/errorTypes', () => { const error = SavedObjectsErrorHelpers.createEsAutoCreateIndexError(); expect(error.output.payload).toHaveProperty('message', 'Automatic index creation failed'); }); + it('sets statusCode to 503', () => { const error = SavedObjectsErrorHelpers.createEsAutoCreateIndexError(); expect(error.output).toHaveProperty('statusCode', 503); diff --git a/src/core/server/saved_objects/service/lib/errors.ts b/src/core/server/saved_objects/service/lib/errors.ts index e9138e9b8a347..478c6b6d26d53 100644 --- a/src/core/server/saved_objects/service/lib/errors.ts +++ b/src/core/server/saved_objects/service/lib/errors.ts @@ -33,6 +33,8 @@ const CODE_REQUEST_ENTITY_TOO_LARGE = 'SavedObjectsClient/requestEntityTooLarge' const CODE_NOT_FOUND = 'SavedObjectsClient/notFound'; // 409 - Conflict const CODE_CONFLICT = 'SavedObjectsClient/conflict'; +// 400 - Es Cannot Execute Script +const CODE_ES_CANNOT_EXECUTE_SCRIPT = 'SavedObjectsClient/esCannotExecuteScript'; // 503 - Es Unavailable const CODE_ES_UNAVAILABLE = 'SavedObjectsClient/esUnavailable'; // 503 - Unable to automatically create index because of action.auto_create_index setting @@ -152,10 +154,24 @@ export class SavedObjectsErrorHelpers { return decorate(error, CODE_CONFLICT, 409, reason); } + public static createConflictError(type: string, id: string) { + return SavedObjectsErrorHelpers.decorateConflictError( + Boom.conflict(`Saved object [${type}/${id}] conflict`) + ); + } + public static isConflictError(error: Error | DecoratedError) { return isSavedObjectsClientError(error) && error[code] === CODE_CONFLICT; } + public static decorateEsCannotExecuteScriptError(error: Error, reason?: string) { + return decorate(error, CODE_ES_CANNOT_EXECUTE_SCRIPT, 400, reason); + } + + public static isEsCannotExecuteScriptError(error: Error | DecoratedError) { + return isSavedObjectsClientError(error) && error[code] === CODE_ES_CANNOT_EXECUTE_SCRIPT; + } + public static decorateEsUnavailableError(error: Error, reason?: string) { return decorate(error, CODE_ES_UNAVAILABLE, 503, reason); } diff --git a/src/core/server/saved_objects/service/lib/included_fields.test.ts b/src/core/server/saved_objects/service/lib/included_fields.test.ts index 40d6552c2ad5f..ced99361f1ea0 100644 --- a/src/core/server/saved_objects/service/lib/included_fields.test.ts +++ b/src/core/server/saved_objects/service/lib/included_fields.test.ts @@ -26,7 +26,7 @@ describe('includedFields', () => { it('accepts type string', () => { const fields = includedFields('config', 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('type'); }); @@ -37,6 +37,7 @@ Array [ "config.foo", "secret.foo", "namespace", + "namespaces", "type", "references", "migrationVersion", @@ -48,14 +49,14 @@ Array [ it('accepts field as string', () => { const fields = includedFields('config', 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('config.foo'); }); it('accepts fields as an array', () => { const fields = includedFields('config', ['foo', 'bar']); - expect(fields).toHaveLength(9); + expect(fields).toHaveLength(10); expect(fields).toContain('config.foo'); expect(fields).toContain('config.bar'); }); @@ -69,6 +70,7 @@ Array [ "secret.foo", "secret.bar", "namespace", + "namespaces", "type", "references", "migrationVersion", @@ -81,31 +83,37 @@ Array [ it('includes namespace', () => { const fields = includedFields('config', 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('namespace'); }); + it('includes namespaces', () => { + const fields = includedFields('config', 'foo'); + expect(fields).toHaveLength(8); + expect(fields).toContain('namespaces'); + }); + it('includes references', () => { const fields = includedFields('config', 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('references'); }); it('includes migrationVersion', () => { const fields = includedFields('config', 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('migrationVersion'); }); it('includes updated_at', () => { const fields = includedFields('config', 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('updated_at'); }); it('uses wildcard when type is not provided', () => { const fields = includedFields(undefined, 'foo'); - expect(fields).toHaveLength(7); + expect(fields).toHaveLength(8); expect(fields).toContain('*.foo'); }); @@ -113,7 +121,7 @@ Array [ it('includes legacy field path', () => { const fields = includedFields('config', ['foo', 'bar']); - expect(fields).toHaveLength(9); + expect(fields).toHaveLength(10); expect(fields).toContain('foo'); expect(fields).toContain('bar'); }); diff --git a/src/core/server/saved_objects/service/lib/included_fields.ts b/src/core/server/saved_objects/service/lib/included_fields.ts index f372db5a1a635..c50ac22594008 100644 --- a/src/core/server/saved_objects/service/lib/included_fields.ts +++ b/src/core/server/saved_objects/service/lib/included_fields.ts @@ -37,6 +37,7 @@ export function includedFields(type: string | string[] = '*', fields?: string[] return [...acc, ...sourceFields.map(f => `${t}.${f}`)]; }, []) .concat('namespace') + .concat('namespaces') .concat('type') .concat('references') .concat('migrationVersion') diff --git a/src/core/server/saved_objects/service/lib/repository.mock.ts b/src/core/server/saved_objects/service/lib/repository.mock.ts index e69c0ff37d1be..afef378b7307b 100644 --- a/src/core/server/saved_objects/service/lib/repository.mock.ts +++ b/src/core/server/saved_objects/service/lib/repository.mock.ts @@ -28,6 +28,8 @@ const create = (): jest.Mocked => ({ find: jest.fn(), get: jest.fn(), update: jest.fn(), + addToNamespaces: jest.fn(), + deleteFromNamespaces: jest.fn(), deleteByNamespace: jest.fn(), incrementCounter: jest.fn(), }); diff --git a/src/core/server/saved_objects/service/lib/repository.test.js b/src/core/server/saved_objects/service/lib/repository.test.js index 2e5eeec04e0a8..927171438ae99 100644 --- a/src/core/server/saved_objects/service/lib/repository.test.js +++ b/src/core/server/saved_objects/service/lib/repository.test.js @@ -16,7 +16,6 @@ * specific language governing permissions and limitations * under the License. */ -import _ from 'lodash'; import { SavedObjectsRepository } from './repository'; import * as getSearchDslNS from './search_dsl/search_dsl'; @@ -30,162 +29,31 @@ jest.mock('./search_dsl/search_dsl', () => ({ getSearchDsl: jest.fn() })); // BEWARE: The SavedObjectClient depends on the implementation details of the SavedObjectsRepository // so any breaking changes to this repository are considered breaking changes to the SavedObjectsClient. +const createBadRequestError = (...args) => + SavedObjectsErrorHelpers.createBadRequestError(...args).output.payload; +const createConflictError = (...args) => + SavedObjectsErrorHelpers.createConflictError(...args).output.payload; +const createGenericNotFoundError = (...args) => + SavedObjectsErrorHelpers.createGenericNotFoundError(...args).output.payload; +const createUnsupportedTypeError = (...args) => + SavedObjectsErrorHelpers.createUnsupportedTypeError(...args).output.payload; + describe('SavedObjectsRepository', () => { let callAdminCluster; let savedObjectsRepository; let migrator; + let serializer; const mockTimestamp = '2017-08-14T15:49:14.886Z'; const mockTimestampFields = { updated_at: mockTimestamp }; const mockVersionProps = { _seq_no: 1, _primary_term: 1 }; const mockVersion = encodeHitVersion(mockVersionProps); - const noNamespaceSearchResults = { - hits: { - total: 4, - hits: [ - { - _index: '.kibana', - _id: 'index-pattern:logstash-*', - _score: 1, - ...mockVersionProps, - _source: { - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { - title: 'logstash-*', - timeFieldName: '@timestamp', - notExpandable: true, - }, - }, - }, - { - _index: '.kibana', - _id: 'config:6.0.0-alpha1', - _score: 1, - ...mockVersionProps, - _source: { - type: 'config', - ...mockTimestampFields, - config: { - buildNum: 8467, - defaultIndex: 'logstash-*', - }, - }, - }, - { - _index: '.kibana', - _id: 'index-pattern:stocks-*', - _score: 1, - ...mockVersionProps, - _source: { - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { - title: 'stocks-*', - timeFieldName: '@timestamp', - notExpandable: true, - }, - }, - }, - { - _index: '.kibana', - _id: 'globaltype:something', - _score: 1, - ...mockVersionProps, - _source: { - type: 'globaltype', - ...mockTimestampFields, - globaltype: { - name: 'bar', - }, - }, - }, - ], - }, - }; - - const namespacedSearchResults = { - hits: { - total: 4, - hits: [ - { - _index: '.kibana', - _id: 'foo-namespace:index-pattern:logstash-*', - _score: 1, - ...mockVersionProps, - _source: { - namespace: 'foo-namespace', - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { - title: 'logstash-*', - timeFieldName: '@timestamp', - notExpandable: true, - }, - }, - }, - { - _index: '.kibana', - _id: 'foo-namespace:config:6.0.0-alpha1', - _score: 1, - ...mockVersionProps, - _source: { - namespace: 'foo-namespace', - type: 'config', - ...mockTimestampFields, - config: { - buildNum: 8467, - defaultIndex: 'logstash-*', - }, - }, - }, - { - _index: '.kibana', - _id: 'foo-namespace:index-pattern:stocks-*', - _score: 1, - ...mockVersionProps, - _source: { - namespace: 'foo-namespace', - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { - title: 'stocks-*', - timeFieldName: '@timestamp', - notExpandable: true, - }, - }, - }, - { - _index: '.kibana', - _id: 'globaltype:something', - _score: 1, - ...mockVersionProps, - _source: { - type: 'globaltype', - ...mockTimestampFields, - globaltype: { - name: 'bar', - }, - }, - }, - ], - }, - }; - const deleteByQueryResults = { - took: 27, - timed_out: false, - total: 23, - deleted: 23, - batches: 1, - version_conflicts: 0, - noops: 0, - retries: { bulk: 0, search: 0 }, - throttled_millis: 0, - requests_per_second: -1, - throttled_until_millis: 0, - failures: [], - }; + const CUSTOM_INDEX_TYPE = 'customIndex'; + const NAMESPACE_AGNOSTIC_TYPE = 'globalType'; + const MULTI_NAMESPACE_TYPE = 'shareableType'; + const MULTI_NAMESPACE_CUSTOM_INDEX_TYPE = 'shareableTypeCustomIndex'; + const HIDDEN_TYPE = 'hiddenType'; const mappings = { properties: { @@ -194,43 +62,47 @@ describe('SavedObjectsRepository', () => { type: 'keyword', }, }, - foo: { + 'index-pattern': { properties: { - type: 'keyword', + someField: { + type: 'keyword', + }, }, }, - bar: { + dashboard: { properties: { - type: 'keyword', + otherField: { + type: 'keyword', + }, }, }, - baz: { + [CUSTOM_INDEX_TYPE]: { properties: { type: 'keyword', }, }, - 'index-pattern': { + [NAMESPACE_AGNOSTIC_TYPE]: { properties: { - someField: { + yetAnotherField: { type: 'keyword', }, }, }, - dashboard: { + [MULTI_NAMESPACE_TYPE]: { properties: { - otherField: { + evenYetAnotherField: { type: 'keyword', }, }, }, - globaltype: { + [MULTI_NAMESPACE_CUSTOM_INDEX_TYPE]: { properties: { - yetAnotherField: { + evenYetAnotherField: { type: 'keyword', }, }, }, - hiddenType: { + [HIDDEN_TYPE]: { properties: { someField: { type: 'keyword', @@ -240,96 +112,97 @@ describe('SavedObjectsRepository', () => { }, }; - const typeRegistry = new SavedObjectTypeRegistry(); - typeRegistry.registerType({ - name: 'config', - hidden: false, - namespaceAgnostic: false, - mappings: { - properties: { - type: 'keyword', - }, - }, + const createType = type => ({ + name: type, + mappings: { properties: mappings.properties[type].properties }, }); - typeRegistry.registerType({ - name: 'index-pattern', - hidden: false, - namespaceAgnostic: false, - mappings: { - properties: { - someField: { - type: 'keyword', - }, - }, - }, + + const registry = new SavedObjectTypeRegistry(); + registry.registerType(createType('config')); + registry.registerType(createType('index-pattern')); + registry.registerType(createType('dashboard')); + registry.registerType({ + ...createType(CUSTOM_INDEX_TYPE), + indexPattern: 'custom', }); - typeRegistry.registerType({ - name: 'dashboard', - hidden: false, - namespaceAgnostic: false, - mappings: { - properties: { - otherField: { - type: 'keyword', - }, - }, - }, + registry.registerType({ + ...createType(NAMESPACE_AGNOSTIC_TYPE), + namespaceType: 'agnostic', }); - typeRegistry.registerType({ - name: 'globaltype', - hidden: false, - namespaceAgnostic: true, - mappings: { - properties: { - yetAnotherField: { - type: 'keyword', - }, - }, - }, + registry.registerType({ + ...createType(MULTI_NAMESPACE_TYPE), + namespaceType: 'multiple', }); - typeRegistry.registerType({ - name: 'foo', - hidden: false, - namespaceAgnostic: true, - mappings: { - properties: { - type: 'keyword', - }, - }, + registry.registerType({ + ...createType(MULTI_NAMESPACE_CUSTOM_INDEX_TYPE), + namespaceType: 'multiple', + indexPattern: 'custom', }); - typeRegistry.registerType({ - name: 'bar', - hidden: false, - namespaceAgnostic: true, - mappings: { - properties: { - type: 'keyword', - }, - }, + registry.registerType({ + ...createType(HIDDEN_TYPE), + hidden: true, + namespaceType: 'agnostic', }); - typeRegistry.registerType({ - name: 'baz', - hidden: false, - namespaceAgnostic: false, - indexPattern: 'beats', - mappings: { - properties: { - type: 'keyword', - }, + + const getMockGetResponse = ({ type, id, references, namespace }) => ({ + // NOTE: Elasticsearch returns more fields (_index, _type) but the SavedObjectsRepository method ignores these + found: true, + _id: `${registry.isSingleNamespace(type) && namespace ? `${namespace}:` : ''}${type}:${id}`, + ...mockVersionProps, + _source: { + ...(registry.isSingleNamespace(type) && { namespace }), + ...(registry.isMultiNamespace(type) && { namespaces: [namespace ?? 'default'] }), + type, + [type]: { title: 'Testing' }, + references, + specialProperty: 'specialValue', + ...mockTimestampFields, }, }); - typeRegistry.registerType({ - name: 'hiddenType', - hidden: true, - namespaceAgnostic: true, - mappings: { - properties: { - someField: { - type: 'keyword', - }, - }, + + const getMockMgetResponse = (objects, namespace) => ({ + status: 200, + docs: objects.map(obj => + obj.found === false ? obj : getMockGetResponse({ ...obj, namespace }) + ), + }); + + const expectClusterCalls = (...actions) => { + for (let i = 0; i < actions.length; i++) { + expect(callAdminCluster).toHaveBeenNthCalledWith(i + 1, actions[i], expect.any(Object)); + } + expect(callAdminCluster).toHaveBeenCalledTimes(actions.length); + }; + const expectClusterCallArgs = (args, n = 1) => { + expect(callAdminCluster).toHaveBeenNthCalledWith( + n, + expect.any(String), + expect.objectContaining(args) + ); + }; + + expect.extend({ + toBeDocumentWithoutError(received, type, id) { + if (received.type === type && received.id === id && !received.error) { + return { message: () => `expected type and id not to match without error`, pass: true }; + } else { + return { message: () => `expected type and id to match without error`, pass: false }; + } }, }); + const expectSuccess = ({ type, id }) => expect.toBeDocumentWithoutError(type, id); + const expectError = ({ type, id }) => ({ type, id, error: expect.any(Object) }); + const expectErrorResult = ({ type, id }, error) => ({ type, id, error }); + const expectErrorNotFound = obj => + expectErrorResult(obj, createGenericNotFoundError(obj.type, obj.id)); + const expectErrorConflict = obj => expectErrorResult(obj, createConflictError(obj.type, obj.id)); + const expectErrorInvalidType = obj => + expectErrorResult(obj, createUnsupportedTypeError(obj.type, obj.id)); + + const expectMigrationArgs = (args, contains = true, n = 1) => { + const obj = contains ? expect.objectContaining(args) : expect.not.objectContaining(args); + expect(migrator.migrateDocument).toHaveBeenNthCalledWith(n, obj); + }; beforeEach(() => { callAdminCluster = jest.fn(); @@ -338,16 +211,28 @@ describe('SavedObjectsRepository', () => { runMigrations: async () => ({ status: 'skipped' }), }; - const serializer = new SavedObjectsSerializer(typeRegistry); - const allTypes = typeRegistry.getAllTypes().map(type => type.name); - const allowedTypes = [...new Set(allTypes.filter(type => !typeRegistry.isHidden(type)))]; + // create a mock serializer "shim" so we can track function calls, but use the real serializer's implementation + serializer = { + isRawSavedObject: jest.fn(), + rawToSavedObject: jest.fn(), + savedObjectToRaw: jest.fn(), + generateRawId: jest.fn(), + trimIdPrefix: jest.fn(), + }; + const _serializer = new SavedObjectsSerializer(registry); + Object.keys(serializer).forEach(key => { + serializer[key].mockImplementation((...args) => _serializer[key](...args)); + }); + + const allTypes = registry.getAllTypes().map(type => type.name); + const allowedTypes = [...new Set(allTypes.filter(type => !registry.isHidden(type)))]; savedObjectsRepository = new SavedObjectsRepository({ index: '.kibana-test', mappings, callCluster: callAdminCluster, migrator, - typeRegistry, + typeRegistry: registry, serializer, allowedTypes, }); @@ -356,2644 +241,2819 @@ describe('SavedObjectsRepository', () => { getSearchDslNS.getSearchDsl.mockReset(); }); - describe('#create', () => { - beforeEach(() => { - callAdminCluster.mockImplementation((method, params) => ({ - _id: params.id, - ...mockVersionProps, - })); - }); + const mockMigrationVersion = { foo: '2.3.4' }; + const mockMigrateDocument = doc => ({ + ...doc, + attributes: { + ...doc.attributes, + ...(doc.attributes?.title && { title: `${doc.attributes.title}!!` }), + }, + migrationVersion: mockMigrationVersion, + references: [{ name: 'search_0', type: 'search', id: '123' }], + }); - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); + describe('#addToNamespaces', () => { + const id = 'some-id'; + const type = MULTI_NAMESPACE_TYPE; + const currentNs1 = 'default'; + const currentNs2 = 'foo-namespace'; + const newNs1 = 'bar-namespace'; + const newNs2 = 'baz-namespace'; + + const mockGetResponse = (type, id) => { + // mock a document that exists in two namespaces + const mockResponse = getMockGetResponse({ type, id }); + mockResponse._source.namespaces = [currentNs1, currentNs2]; + callAdminCluster.mockResolvedValueOnce(mockResponse); // this._callCluster('get', ...) + }; - await expect( - savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { - id: 'logstash-*', - namespace: 'foo-namespace', - } - ) - ).resolves.toBeDefined(); - expect(migrator.runMigrations).toHaveBeenCalledTimes(1); - }); + const addToNamespacesSuccess = async (type, id, namespaces, options) => { + mockGetResponse(type, id); // this._callCluster('get', ...) + callAdminCluster.mockResolvedValue({ + _id: `${type}:${id}`, + ...mockVersionProps, + result: 'updated', + }); // this._writeToCluster('update', ...) + const result = await savedObjectsRepository.addToNamespaces(type, id, namespaces, options); + expect(callAdminCluster).toHaveBeenCalledTimes(2); + return result; + }; - it('formats Elasticsearch response', async () => { - const response = await savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { - id: 'logstash-*', - namespace: 'foo-namespace', - references: [ - { - name: 'ref_0', - type: 'test', - id: '123', - }, - ], - } - ); + describe('cluster calls', () => { + it(`should use ES get action then update action`, async () => { + await addToNamespacesSuccess(type, id, [newNs1, newNs2]); + expectClusterCalls('get', 'update'); + }); - expect(response).toEqual({ - type: 'index-pattern', - id: 'logstash-*', - ...mockTimestampFields, - version: mockVersion, - attributes: { - title: 'Logstash', - }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '123', - }, - ], + it(`defaults to the version of the existing document`, async () => { + await addToNamespacesSuccess(type, id, [newNs1, newNs2]); + const versionProperties = { + if_seq_no: mockVersionProps._seq_no, + if_primary_term: mockVersionProps._primary_term, + }; + expectClusterCallArgs(versionProperties, 2); + }); + + it(`accepts version`, async () => { + await addToNamespacesSuccess(type, id, [newNs1, newNs2], { + version: encodeHitVersion({ _seq_no: 100, _primary_term: 200 }), + }); + expectClusterCallArgs({ if_seq_no: 100, if_primary_term: 200 }, 2); }); - }); - it('should use ES index action', async () => { - await savedObjectsRepository.create('index-pattern', { - id: 'logstash-*', - title: 'Logstash', + it(`defaults to a refresh setting of wait_for`, async () => { + await addToNamespacesSuccess(type, id, [newNs1, newNs2]); + expectClusterCallArgs({ refresh: 'wait_for' }, 2); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('index', expect.any(Object)); + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await addToNamespacesSuccess(type, id, [newNs1, newNs2], { refresh }); + expectClusterCallArgs({ refresh }, 2); + }); }); - it('should use default index', async () => { - await savedObjectsRepository.create('index-pattern', { - id: 'logstash-*', - title: 'Logstash', + describe('errors', () => { + const expectNotFoundError = async (type, id, namespaces, options) => { + await expect( + savedObjectsRepository.addToNamespaces(type, id, namespaces, options) + ).rejects.toThrowError(createGenericNotFoundError(type, id)); + }; + const expectBadRequestError = async (type, id, namespaces, message) => { + await expect( + savedObjectsRepository.addToNamespaces(type, id, namespaces) + ).rejects.toThrowError(createBadRequestError(message)); + }; + + it(`throws when type is invalid`, async () => { + await expectNotFoundError('unknownType', id, [newNs1, newNs2]); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'index', - expect.objectContaining({ - index: '.kibana-test', - }) - ); - }); + it(`throws when type is hidden`, async () => { + await expectNotFoundError(HIDDEN_TYPE, id, [newNs1, newNs2]); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - it('should use custom index', async () => { - await savedObjectsRepository.create('baz', { - id: 'logstash-*', - title: 'Logstash', + it(`throws when type is not multi-namespace`, async () => { + const test = async type => { + const message = `${type} doesn't support multiple namespaces`; + await expectBadRequestError(type, id, [newNs1, newNs2], message); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; + await test('index-pattern'); + await test(NAMESPACE_AGNOSTIC_TYPE); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'index', - expect.objectContaining({ - index: 'beats', - }) - ); - }); + it(`throws when namespaces is an empty array`, async () => { + const test = async namespaces => { + const message = 'namespaces must be a non-empty array of strings'; + await expectBadRequestError(type, id, namespaces, message); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; + await test([]); + }); - it('migrates the doc', async () => { - migrator.migrateDocument = doc => { - doc.attributes.title = doc.attributes.title + '!!'; - doc.migrationVersion = { foo: '2.3.4' }; - doc.references = [{ name: 'search_0', type: 'search', id: '123' }]; - return doc; - }; + it(`throws when ES is unable to find the document during get`, async () => { + callAdminCluster.mockResolvedValue({ found: false }); // this._callCluster('get', ...) + await expectNotFoundError(type, id, [newNs1, newNs2]); + expectClusterCalls('get'); + }); - await savedObjectsRepository.create('index-pattern', { - id: 'logstash-*', - title: 'Logstash', + it(`throws when ES is unable to find the index during get`, async () => { + callAdminCluster.mockResolvedValue({ status: 404 }); // this._callCluster('get', ...) + await expectNotFoundError(type, id, [newNs1, newNs2]); + expectClusterCalls('get'); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - body: { - 'index-pattern': { id: 'logstash-*', title: 'Logstash!!' }, - migrationVersion: { foo: '2.3.4' }, - type: 'index-pattern', - updated_at: '2017-08-14T15:49:14.886Z', - references: [{ name: 'search_0', type: 'search', id: '123' }], - }, + it(`throws when the document exists, but not in this namespace`, async () => { + mockGetResponse(type, id); // this._callCluster('get', ...) + await expectNotFoundError(type, id, [newNs1, newNs2], { + namespace: 'some-other-namespace', + }); + expectClusterCalls('get'); }); - }); - it('defaults to a refresh setting of `wait_for`', async () => { - await savedObjectsRepository.create('index-pattern', { - id: 'logstash-*', - title: 'Logstash', + it(`throws when ES is unable to find the document during update`, async () => { + mockGetResponse(type, id); // this._callCluster('get', ...) + callAdminCluster.mockResolvedValue({ status: 404 }); // this._writeToCluster('update', ...) + await expectNotFoundError(type, id, [newNs1, newNs2]); + expectClusterCalls('get', 'update'); }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: 'wait_for', + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + let callAdminClusterCount = 0; + migrator.runMigrations = jest.fn(async () => + // runMigrations should resolve before callAdminCluster is initiated + expect(callAdminCluster).toHaveBeenCalledTimes(callAdminClusterCount++) + ); + await expect(addToNamespacesSuccess(type, id, [newNs1, newNs2])).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveReturnedTimes(2); }); }); - it('accepts custom refresh settings', async () => { - await savedObjectsRepository.create( - 'index-pattern', - { - id: 'logstash-*', - title: 'Logstash', - }, - { - refresh: true, - } - ); + describe('returns', () => { + it(`returns an empty object on success`, async () => { + const result = await addToNamespacesSuccess(type, id, [newNs1, newNs2]); + expect(result).toEqual({}); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: true, + it(`succeeds when adding existing namespaces`, async () => { + const result = await addToNamespacesSuccess(type, id, [currentNs1]); + expect(result).toEqual({}); }); }); + }); - it('should use create action if ID defined and overwrite=false', async () => { - await savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { - id: 'logstash-*', - } - ); + describe('#bulkCreate', () => { + const obj1 = { + type: 'config', + id: '6.0.0-alpha1', + attributes: { title: 'Test One' }, + references: [{ name: 'ref_0', type: 'test', id: '1' }], + }; + const obj2 = { + type: 'index-pattern', + id: 'logstash-*', + attributes: { title: 'Test Two' }, + references: [{ name: 'ref_0', type: 'test', id: '2' }], + }; + const namespace = 'foo-namespace'; - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('create', expect.any(Object)); - }); + const getMockBulkCreateResponse = (objects, namespace) => { + return { + items: objects.map(({ type, id }) => ({ + create: { + _id: `${namespace ? `${namespace}:` : ''}${type}:${id}`, + ...mockVersionProps, + }, + })), + }; + }; - it('allows for id to be provided', async () => { - await savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { id: 'logstash-*' } - ); + const bulkCreateSuccess = async (objects, options) => { + const multiNamespaceObjects = + options?.overwrite && + objects.filter(({ type, id }) => registry.isMultiNamespace(type) && id); + if (multiNamespaceObjects?.length) { + const response = getMockMgetResponse(multiNamespaceObjects, options?.namespace); + callAdminCluster.mockResolvedValueOnce(response); // this._callCluster('mget', ...) + } + const response = getMockBulkCreateResponse(objects, options?.namespace); + callAdminCluster.mockResolvedValue(response); // this._writeToCluster('bulk', ...) + const result = await savedObjectsRepository.bulkCreate(objects, options); + expect(callAdminCluster).toHaveBeenCalledTimes(multiNamespaceObjects?.length ? 2 : 1); + return result; + }; - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: 'index-pattern:logstash-*', - }) - ); + // bulk create calls have two objects for each source -- the action, and the source + const expectClusterCallArgsAction = ( + objects, + { method, _index = expect.any(String), getId = () => expect.any(String) } + ) => { + const body = []; + for (const { type, id } of objects) { + body.push({ [method]: { _index, _id: getId(type, id) } }); + body.push(expect.any(Object)); + } + expectClusterCallArgs({ body }); + }; + + const expectObjArgs = ({ type, attributes, references }, overrides) => [ + expect.any(Object), + expect.objectContaining({ + [type]: attributes, + references, + type, + ...overrides, + ...mockTimestampFields, + }), + ]; + + const expectSuccessResult = obj => ({ + ...obj, + migrationVersion: undefined, + version: mockVersion, + ...mockTimestampFields, }); - it('self-generates an ID', async () => { - await savedObjectsRepository.create('index-pattern', { - title: 'Logstash', + describe('cluster calls', () => { + it(`should use the ES bulk action by default`, async () => { + await bulkCreateSuccess([obj1, obj2]); + expectClusterCalls('bulk'); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: expect.objectContaining(/index-pattern:[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}/), - }) - ); - }); + it(`should use the ES mget action before bulk action for any types that are multi-namespace, when overwrite=true`, async () => { + const objects = [obj1, { ...obj2, type: MULTI_NAMESPACE_TYPE }]; + await bulkCreateSuccess(objects, { overwrite: true }); + expectClusterCalls('mget', 'bulk'); + const docs = [expect.objectContaining({ _id: `${MULTI_NAMESPACE_TYPE}:${obj2.id}` })]; + expectClusterCallArgs({ body: { docs } }, 1); + }); - it('prepends namespace to the id and adds namespace to body when providing namespace for namespaced type', async () => { - await savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { - id: 'foo-id', - namespace: 'foo-namespace', - } - ); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: `foo-namespace:index-pattern:foo-id`, - body: expect.objectContaining({ - [`index-pattern`]: { title: 'Logstash' }, - namespace: 'foo-namespace', - type: 'index-pattern', - updated_at: '2017-08-14T15:49:14.886Z', - }), - }) - ); - }); + it(`should use the ES create method if ID is undefined and overwrite=true`, async () => { + const objects = [obj1, obj2].map(obj => ({ ...obj, id: undefined })); + await bulkCreateSuccess(objects, { overwrite: true }); + expectClusterCallArgsAction(objects, { method: 'create' }); + }); - it(`doesn't prepend namespace to the id or add namespace property when providing no namespace for namespaced type`, async () => { - await savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { - id: 'foo-id', - } - ); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: `index-pattern:foo-id`, - body: expect.objectContaining({ - [`index-pattern`]: { title: 'Logstash' }, - type: 'index-pattern', - updated_at: '2017-08-14T15:49:14.886Z', - }), - }) - ); - }); + it(`should use the ES create method if ID is undefined and overwrite=false`, async () => { + const objects = [obj1, obj2].map(obj => ({ ...obj, id: undefined })); + await bulkCreateSuccess(objects); + expectClusterCallArgsAction(objects, { method: 'create' }); + }); - it(`doesn't prepend namespace to the id or add namespace property when providing namespace for namespace agnostic type`, async () => { - await savedObjectsRepository.create( - 'globaltype', - { - title: 'Logstash', - }, - { - id: 'foo-id', - namespace: 'foo-namespace', - } - ); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: `globaltype:foo-id`, - body: expect.objectContaining({ - [`globaltype`]: { title: 'Logstash' }, - type: 'globaltype', - updated_at: '2017-08-14T15:49:14.886Z', - }), - }) - ); - }); - - it('defaults to empty references array if none are provided', async () => { - await savedObjectsRepository.create( - 'index-pattern', - { - title: 'Logstash', - }, - { - id: 'logstash-*', - } - ); + it(`should use the ES index method if ID is defined and overwrite=true`, async () => { + await bulkCreateSuccess([obj1, obj2], { overwrite: true }); + expectClusterCallArgsAction([obj1, obj2], { method: 'index' }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - body: expect.objectContaining({ - references: [], - }), - }) - ); - }); - }); + it(`should use the ES create method if ID is defined and overwrite=false`, async () => { + await bulkCreateSuccess([obj1, obj2]); + expectClusterCallArgsAction([obj1, obj2], { method: 'create' }); + }); - describe('#bulkCreate', () => { - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); - callAdminCluster.mockReturnValue({ - items: [ - { create: { type: 'config', id: 'config:one', _primary_term: 1, _seq_no: 1 } }, - { - create: { - type: 'index-pattern', - id: 'index-pattern:two', - _primary_term: 1, - _seq_no: 1, - }, - }, - ], + it(`formats the ES request`, async () => { + await bulkCreateSuccess([obj1, obj2]); + const body = [...expectObjArgs(obj1), ...expectObjArgs(obj2)]; + expectClusterCallArgs({ body }); }); - await expect( - savedObjectsRepository.bulkCreate([ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'index-pattern', id: 'two', attributes: { title: 'Test Two' } }, - ]) - ).resolves.toBeDefined(); + it(`adds namespace to request body for any types that are single-namespace`, async () => { + await bulkCreateSuccess([obj1, obj2], { namespace }); + const expected = expect.objectContaining({ namespace }); + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }); + }); - expect(migrator.runMigrations).toHaveBeenCalledTimes(1); - }); + it(`doesn't add namespace to request body for any types that are not single-namespace`, async () => { + const objects = [ + { ...obj1, type: NAMESPACE_AGNOSTIC_TYPE }, + { ...obj2, type: MULTI_NAMESPACE_TYPE }, + ]; + await bulkCreateSuccess(objects, { namespace }); + const expected = expect.not.objectContaining({ namespace: expect.anything() }); + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }); + }); - it('formats Elasticsearch request', async () => { - callAdminCluster.mockReturnValue({ - items: [ - { create: { type: 'config', id: 'config:one', _primary_term: 1, _seq_no: 1 } }, - { create: { type: 'index-pattern', id: 'config:two', _primary_term: 1, _seq_no: 1 } }, - ], + it(`adds namespaces to request body for any types that are multi-namespace`, async () => { + const test = async namespace => { + const objects = [obj1, obj2].map(x => ({ ...x, type: MULTI_NAMESPACE_TYPE })); + const namespaces = [namespace ?? 'default']; + await bulkCreateSuccess(objects, { namespace, overwrite: true }); + const expected = expect.objectContaining({ namespaces }); + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }, 2); + callAdminCluster.mockReset(); + }; + await test(undefined); + await test(namespace); }); - await savedObjectsRepository.bulkCreate([ - { - type: 'config', - id: 'one', - attributes: { title: 'Test One' }, - references: [{ name: 'ref_0', type: 'test', id: '1' }], - }, - { - type: 'index-pattern', - id: 'two', - attributes: { title: 'Test Two' }, - references: [{ name: 'ref_0', type: 'test', id: '2' }], - }, - ]); + it(`doesn't add namespaces to request body for any types that are not multi-namespace`, async () => { + const test = async namespace => { + const objects = [obj1, { ...obj2, type: NAMESPACE_AGNOSTIC_TYPE }]; + await bulkCreateSuccess(objects, { namespace, overwrite: true }); + const expected = expect.not.objectContaining({ namespaces: expect.anything() }); + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }); + callAdminCluster.mockReset(); + }; + await test(undefined); + await test(namespace); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - const bulkCalls = callAdminCluster.mock.calls.filter(([path]) => path === 'bulk'); + it(`defaults to a refresh setting of wait_for`, async () => { + await bulkCreateSuccess([obj1, obj2]); + expectClusterCallArgs({ refresh: 'wait_for' }); + }); - expect(bulkCalls.length).toEqual(1); + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await bulkCreateSuccess([obj1, obj2], { refresh }); + expectClusterCallArgs({ refresh }); + }); - expect(bulkCalls[0][1].body).toEqual([ - { create: { _index: '.kibana-test', _id: 'config:one' } }, - { - type: 'config', - ...mockTimestampFields, - config: { title: 'Test One' }, - references: [{ name: 'ref_0', type: 'test', id: '1' }], - }, - { create: { _index: '.kibana-test', _id: 'index-pattern:two' } }, - { - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { title: 'Test Two' }, - references: [{ name: 'ref_0', type: 'test', id: '2' }], - }, - ]); - }); + it(`should use default index`, async () => { + await bulkCreateSuccess([obj1, obj2]); + expectClusterCallArgsAction([obj1, obj2], { method: 'create', _index: '.kibana-test' }); + }); - it('defaults to a refresh setting of `wait_for`', async () => { - callAdminCluster.mockReturnValue({ - items: [{ create: { type: 'config', id: 'config:one', _primary_term: 1, _seq_no: 1 } }], + it(`should use custom index`, async () => { + await bulkCreateSuccess([obj1, obj2].map(x => ({ ...x, type: CUSTOM_INDEX_TYPE }))); + expectClusterCallArgsAction([obj1, obj2], { method: 'create', _index: 'custom' }); }); - await savedObjectsRepository.bulkCreate([ - { - type: 'config', - id: 'one', - attributes: { title: 'Test One' }, - references: [{ name: 'ref_0', type: 'test', id: '1' }], - }, - ]); + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + const getId = (type, id) => `${namespace}:${type}:${id}`; + await bulkCreateSuccess([obj1, obj2], { namespace }); + expectClusterCallArgsAction([obj1, obj2], { method: 'create', getId }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + const getId = (type, id) => `${type}:${id}`; + await bulkCreateSuccess([obj1, obj2]); + expectClusterCallArgsAction([obj1, obj2], { method: 'create', getId }); + }); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: 'wait_for', + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + const getId = (type, id) => `${type}:${id}`; + const objects = [ + { ...obj1, type: NAMESPACE_AGNOSTIC_TYPE }, + { ...obj2, type: MULTI_NAMESPACE_TYPE }, + ]; + await bulkCreateSuccess(objects, { namespace }); + expectClusterCallArgsAction(objects, { method: 'create', getId }); }); }); - it('accepts a custom refresh setting', async () => { - callAdminCluster.mockReturnValue({ - items: [ - { create: { type: 'config', id: 'config:one', _primary_term: 1, _seq_no: 1 } }, - { create: { type: 'index-pattern', id: 'config:two', _primary_term: 1, _seq_no: 1 } }, - ], - }); + describe('errors', () => { + const obj3 = { + type: 'dashboard', + id: 'three', + attributes: { title: 'Test Three' }, + references: [{ name: 'ref_0', type: 'test', id: '2' }], + }; - await savedObjectsRepository.bulkCreate( - [ - { - type: 'config', - id: 'one', - attributes: { title: 'Test One' }, - references: [{ name: 'ref_0', type: 'test', id: '1' }], - }, - { - type: 'index-pattern', - id: 'two', - attributes: { title: 'Test Two' }, - references: [{ name: 'ref_0', type: 'test', id: '2' }], - }, - ], - { - refresh: true, + const bulkCreateError = async (obj, esError, expectedError) => { + const objects = [obj1, obj, obj2]; + const response = getMockBulkCreateResponse(objects); + if (esError) { + response.items[1].create = { error: esError }; } - ); - - expect(callAdminCluster).toHaveBeenCalledTimes(1); + callAdminCluster.mockResolvedValue(response); // this._writeToCluster('bulk', ...) + + const result = await savedObjectsRepository.bulkCreate(objects); + expectClusterCalls('bulk'); + const objCall = esError ? expectObjArgs(obj) : []; + const body = [...expectObjArgs(obj1), ...objCall, ...expectObjArgs(obj2)]; + expectClusterCallArgs({ body }); + expect(result).toEqual({ + saved_objects: [expectSuccess(obj1), expectedError, expectSuccess(obj2)], + }); + }; - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: true, + it(`returns error when type is invalid`, async () => { + const obj = { ...obj3, type: 'unknownType' }; + await bulkCreateError(obj, undefined, expectErrorInvalidType(obj)); }); - }); - it('migrates the docs', async () => { - callAdminCluster.mockReturnValue({ - items: [ - { - create: { - error: false, - _id: '1', - _seq_no: 1, - _primary_term: 1, - }, - }, - { - create: { - error: false, - _id: '2', - _seq_no: 1, - _primary_term: 1, - }, - }, - ], + it(`returns error when type is hidden`, async () => { + const obj = { ...obj3, type: HIDDEN_TYPE }; + await bulkCreateError(obj, undefined, expectErrorInvalidType(obj)); }); - migrator.migrateDocument = doc => { - doc.attributes.title = doc.attributes.title + '!!'; - doc.migrationVersion = { foo: '2.3.4' }; - doc.references = [{ name: 'search_0', type: 'search', id: '123' }]; - return doc; - }; - - const bulkCreateResp = await savedObjectsRepository.bulkCreate([ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'index-pattern', id: 'two', attributes: { title: 'Test Two' } }, - ]); - - expect(callAdminCluster).toHaveBeenCalledWith( - 'bulk', - expect.objectContaining({ - body: [ - { create: { _index: '.kibana-test', _id: 'config:one' } }, - { - type: 'config', - ...mockTimestampFields, - config: { title: 'Test One!!' }, - migrationVersion: { foo: '2.3.4' }, - references: [{ name: 'search_0', type: 'search', id: '123' }], - }, - { create: { _index: '.kibana-test', _id: 'index-pattern:two' } }, + it(`returns error when there is a conflict with an existing multi-namespace saved object (get)`, async () => { + const obj = { ...obj3, type: MULTI_NAMESPACE_TYPE }; + const response1 = { + status: 200, + docs: [ { - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { title: 'Test Two!!' }, - migrationVersion: { foo: '2.3.4' }, - references: [{ name: 'search_0', type: 'search', id: '123' }], + found: true, + _source: { + type: obj.type, + namespaces: ['bar-namespace'], + }, }, ], - }) - ); - - expect(bulkCreateResp).toEqual({ - saved_objects: [ - { - id: 'one', - type: 'config', - version: mockVersion, - updated_at: mockTimestamp, - attributes: { - title: 'Test One!!', - }, - references: [{ name: 'search_0', type: 'search', id: '123' }], - }, - { - id: 'two', - type: 'index-pattern', - version: mockVersion, - updated_at: mockTimestamp, - attributes: { - title: 'Test Two!!', - }, - references: [{ name: 'search_0', type: 'search', id: '123' }], - }, - ], + }; + callAdminCluster.mockResolvedValueOnce(response1); // this._callCluster('mget', ...) + const response2 = getMockBulkCreateResponse([obj1, obj2]); + callAdminCluster.mockResolvedValue(response2); // this._writeToCluster('bulk', ...) + + const options = { overwrite: true }; + const result = await savedObjectsRepository.bulkCreate([obj1, obj, obj2], options); + expectClusterCalls('mget', 'bulk'); + const body1 = { docs: [expect.objectContaining({ _id: `${obj.type}:${obj.id}` })] }; + expectClusterCallArgs({ body: body1 }, 1); + const body2 = [...expectObjArgs(obj1), ...expectObjArgs(obj2)]; + expectClusterCallArgs({ body: body2 }, 2); + expect(result).toEqual({ + saved_objects: [expectSuccess(obj1), expectErrorConflict(obj), expectSuccess(obj2)], + }); }); - }); - it('should overwrite objects if overwrite is truthy', async () => { - callAdminCluster.mockReturnValue({ - items: [{ create: { type: 'foo', id: 'bar', _primary_term: 1, _seq_no: 1 } }], + it(`returns error when there is a version conflict (bulk)`, async () => { + const esError = { type: 'version_conflict_engine_exception' }; + await bulkCreateError(obj3, esError, expectErrorConflict(obj3)); }); - await savedObjectsRepository.bulkCreate([{ type: 'foo', id: 'bar', attributes: {} }], { - overwrite: false, + it(`returns error when document is missing`, async () => { + const esError = { type: 'document_missing_exception' }; + await bulkCreateError(obj3, esError, expectErrorNotFound(obj3)); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'bulk', - expect.objectContaining({ - body: [ - // uses create because overwriting is not allowed - { create: { _index: '.kibana-test', _id: 'foo:bar' } }, - { type: 'foo', ...mockTimestampFields, foo: {}, references: [] }, - ], - }) - ); - - callAdminCluster.mockReset(); - callAdminCluster.mockReturnValue({ - items: [{ create: { type: 'foo', id: 'bar', _primary_term: 1, _seq_no: 1 } }], + it(`returns error reason for other errors`, async () => { + const esError = { reason: 'some_other_error' }; + await bulkCreateError(obj3, esError, expectErrorResult(obj3, { message: esError.reason })); }); - await savedObjectsRepository.bulkCreate([{ type: 'foo', id: 'bar', attributes: {} }], { - overwrite: true, + it(`returns error string for other errors if no reason is defined`, async () => { + const esError = { foo: 'some_other_error' }; + const expectedError = expectErrorResult(obj3, { message: JSON.stringify(esError) }); + await bulkCreateError(obj3, esError, expectedError); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'bulk', - expect.objectContaining({ - body: [ - // uses index because overwriting is allowed - { index: { _index: '.kibana-test', _id: 'foo:bar' } }, - { type: 'foo', ...mockTimestampFields, foo: {}, references: [] }, - ], - }) - ); }); - it('mockReturnValue document errors', async () => { - callAdminCluster.mockResolvedValue({ - errors: false, - items: [ - { - create: { - _id: 'config:one', - error: { - reason: 'type[config] missing', - }, - }, - }, - { - create: { - _id: 'index-pattern:two', - ...mockVersionProps, - }, - }, - ], + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(bulkCreateSuccess([obj1, obj2])).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); }); - const response = await savedObjectsRepository.bulkCreate([ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'index-pattern', id: 'two', attributes: { title: 'Test Two' } }, - ]); + it(`migrates the docs and serializes the migrated docs`, async () => { + migrator.migrateDocument.mockImplementation(mockMigrateDocument); + await bulkCreateSuccess([obj1, obj2]); + const docs = [obj1, obj2].map(x => ({ ...x, ...mockTimestampFields })); + expectMigrationArgs(docs[0], true, 1); + expectMigrationArgs(docs[1], true, 2); - expect(response).toEqual({ - saved_objects: [ - { - id: 'one', - type: 'config', - error: { message: 'type[config] missing' }, - }, - { - id: 'two', - type: 'index-pattern', - version: mockVersion, - ...mockTimestampFields, - attributes: { title: 'Test Two' }, - references: [], - }, - ], + const migratedDocs = docs.map(x => migrator.migrateDocument(x)); + expect(serializer.savedObjectToRaw).toHaveBeenNthCalledWith(1, migratedDocs[0]); + expect(serializer.savedObjectToRaw).toHaveBeenNthCalledWith(2, migratedDocs[1]); }); - }); - it('formats Elasticsearch response', async () => { - callAdminCluster.mockResolvedValue({ - errors: false, - items: [ - { - create: { - _id: 'config:one', - ...mockVersionProps, - }, - }, - { - create: { - _id: 'index-pattern:two', - ...mockVersionProps, - }, - }, - ], + it(`adds namespace to body when providing namespace for single-namespace type`, async () => { + await bulkCreateSuccess([obj1, obj2], { namespace }); + expectMigrationArgs({ namespace }, true, 1); + expectMigrationArgs({ namespace }, true, 2); }); - const response = await savedObjectsRepository.bulkCreate( - [ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'index-pattern', id: 'two', attributes: { title: 'Test Two' } }, - ], - { - namespace: 'foo-namespace', - } - ); + it(`doesn't add namespace to body when providing no namespace for single-namespace type`, async () => { + await bulkCreateSuccess([obj1, obj2]); + expectMigrationArgs({ namespace: expect.anything() }, false, 1); + expectMigrationArgs({ namespace: expect.anything() }, false, 2); + }); - expect(response).toEqual({ - saved_objects: [ - { - id: 'one', - type: 'config', - version: mockVersion, - ...mockTimestampFields, - attributes: { title: 'Test One' }, - references: [], - }, - { - id: 'two', - type: 'index-pattern', - version: mockVersion, - ...mockTimestampFields, - attributes: { title: 'Test Two' }, - references: [], - }, - ], + it(`doesn't add namespace to body when not using single-namespace type`, async () => { + const objects = [ + { ...obj1, type: NAMESPACE_AGNOSTIC_TYPE }, + { ...obj2, type: MULTI_NAMESPACE_TYPE }, + ]; + await bulkCreateSuccess(objects, { namespace }); + expectMigrationArgs({ namespace: expect.anything() }, false, 1); + expectMigrationArgs({ namespace: expect.anything() }, false, 2); }); - }); - it('prepends namespace to the id and adds namespace to body when providing namespace for namespaced type', async () => { - callAdminCluster.mockReturnValue({ - items: [ - { - create: { - _id: 'foo-namespace:config:one', - _index: '.kibana-test', - _primary_term: 1, - _seq_no: 2, - }, - }, - { - create: { - _id: 'foo-namespace:index-pattern:two', - _primary_term: 1, - _seq_no: 2, - }, - }, - ], + it(`adds namespaces to body when providing namespace for multi-namespace type`, async () => { + const objects = [obj1, obj2].map(obj => ({ ...obj, type: MULTI_NAMESPACE_TYPE })); + await bulkCreateSuccess(objects, { namespace }); + expectMigrationArgs({ namespaces: [namespace] }, true, 1); + expectMigrationArgs({ namespaces: [namespace] }, true, 2); }); - await savedObjectsRepository.bulkCreate( - [ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'index-pattern', id: 'two', attributes: { title: 'Test Two' } }, - ], - { - namespace: 'foo-namespace', - } - ); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'bulk', - expect.objectContaining({ - body: [ - { create: { _index: '.kibana-test', _id: 'foo-namespace:config:one' } }, - { - namespace: 'foo-namespace', - type: 'config', - ...mockTimestampFields, - config: { title: 'Test One' }, - references: [], - }, - { create: { _index: '.kibana-test', _id: 'foo-namespace:index-pattern:two' } }, - { - namespace: 'foo-namespace', - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { title: 'Test Two' }, - references: [], - }, - ], - }) - ); - }); - it(`doesn't prepend namespace to the id or add namespace property when providing no namespace for namespaced type`, async () => { - callAdminCluster.mockResolvedValue({ - errors: false, - items: [ - { - create: { - _id: 'config:one', - ...mockVersionProps, - }, - }, - { - create: { - _id: 'index-pattern:two', - ...mockVersionProps, - }, - }, - ], + it(`adds default namespaces to body when providing no namespace for multi-namespace type`, async () => { + const objects = [obj1, obj2].map(obj => ({ ...obj, type: MULTI_NAMESPACE_TYPE })); + await bulkCreateSuccess(objects); + expectMigrationArgs({ namespaces: ['default'] }, true, 1); + expectMigrationArgs({ namespaces: ['default'] }, true, 2); }); - await savedObjectsRepository.bulkCreate([ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'index-pattern', id: 'two', attributes: { title: 'Test Two' } }, - ]); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'bulk', - expect.objectContaining({ - body: [ - { create: { _id: 'config:one', _index: '.kibana-test' } }, - { - type: 'config', - ...mockTimestampFields, - config: { title: 'Test One' }, - references: [], - }, - { create: { _id: 'index-pattern:two', _index: '.kibana-test' } }, - { - type: 'index-pattern', - ...mockTimestampFields, - 'index-pattern': { title: 'Test Two' }, - references: [], - }, - ], - }) - ); - }); - it(`doesn't prepend namespace to the id or add namespace property when providing namespace for namespace agnostic type`, async () => { - callAdminCluster.mockReturnValue({ - items: [{ create: { _type: '_doc', _id: 'globaltype:one', _primary_term: 1, _seq_no: 2 } }], + it(`doesn't add namespaces to body when not using multi-namespace type`, async () => { + const objects = [obj1, { ...obj2, type: NAMESPACE_AGNOSTIC_TYPE }]; + await bulkCreateSuccess(objects); + expectMigrationArgs({ namespaces: expect.anything() }, false, 1); + expectMigrationArgs({ namespaces: expect.anything() }, false, 2); }); - await savedObjectsRepository.bulkCreate( - [{ type: 'globaltype', id: 'one', attributes: { title: 'Test One' } }], - { - namespace: 'foo-namespace', - } - ); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'bulk', - expect.objectContaining({ - body: [ - { create: { _id: 'globaltype:one', _index: '.kibana-test' } }, - { - type: 'globaltype', - ...mockTimestampFields, - globaltype: { title: 'Test One' }, - references: [], - }, - ], - }) - ); }); - it('should return objects in the same order regardless of type', () => {}); - }); + describe('returns', () => { + it(`formats the ES response`, async () => { + const result = await bulkCreateSuccess([obj1, obj2]); + expect(result).toEqual({ + saved_objects: [obj1, obj2].map(x => expectSuccessResult(x)), + }); + }); - describe('#delete', () => { - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); - callAdminCluster.mockReturnValue({ result: 'deleted' }); - await expect( - savedObjectsRepository.delete('index-pattern', 'logstash-*', { - namespace: 'foo-namespace', - }) - ).resolves.toBeDefined(); - - expect(migrator.runMigrations).toHaveBeenCalledTimes(1); + it(`should return objects in the same order regardless of type`, async () => { + // TODO + }); + + it(`handles a mix of successful creates and errors`, async () => { + const obj = { + type: 'unknownType', + id: 'three', + }; + const objects = [obj1, obj, obj2]; + const response = getMockBulkCreateResponse(objects); + callAdminCluster.mockResolvedValue(response); // this._writeToCluster('bulk', ...) + const result = await savedObjectsRepository.bulkCreate(objects); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + expect(result).toEqual({ + saved_objects: [expectSuccessResult(obj1), expectError(obj), expectSuccessResult(obj2)], + }); + }); }); + }); - it('throws notFound when ES is unable to find the document', async () => { - expect.assertions(1); + describe('#bulkGet', () => { + const obj1 = { + type: 'config', + id: '6.0.0-alpha1', + attributes: { title: 'Testing' }, + references: [ + { + name: 'ref_0', + type: 'test', + id: '1', + }, + ], + }; + const obj2 = { + type: 'index-pattern', + id: 'logstash-*', + attributes: { title: 'Testing' }, + references: [ + { + name: 'ref_0', + type: 'test', + id: '2', + }, + ], + }; + const namespace = 'foo-namespace'; - callAdminCluster.mockResolvedValue({ result: 'not_found' }); + const bulkGet = async (objects, options) => + savedObjectsRepository.bulkGet( + objects.map(({ type, id }) => ({ type, id })), // bulkGet only uses type and id + options + ); + const bulkGetSuccess = async (objects, options) => { + const response = getMockMgetResponse(objects, options?.namespace); + callAdminCluster.mockReturnValue(response); + const result = await bulkGet(objects, options); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + return result; + }; - try { - await savedObjectsRepository.delete('index-pattern', 'logstash-*'); - } catch (e) { - expect(e.output.statusCode).toEqual(404); - } - }); + const _expectClusterCallArgs = ( + objects, + { _index = expect.any(String), getId = () => expect.any(String) } + ) => { + expectClusterCallArgs({ + body: { + docs: objects.map(({ type, id }) => + expect.objectContaining({ + _index, + _id: getId(type, id), + }) + ), + }, + }); + }; - it(`prepends namespace to the id when providing namespace for namespaced type`, async () => { - callAdminCluster.mockReturnValue({ result: 'deleted' }); - await savedObjectsRepository.delete('index-pattern', 'logstash-*', { - namespace: 'foo-namespace', + describe('cluster calls', () => { + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + const getId = (type, id) => `${namespace}:${type}:${id}`; + await bulkGetSuccess([obj1, obj2], { namespace }); + _expectClusterCallArgs([obj1, obj2], { getId }); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('delete', { - id: 'foo-namespace:index-pattern:logstash-*', - refresh: 'wait_for', - index: '.kibana-test', - ignore: [404], + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + const getId = (type, id) => `${type}:${id}`; + await bulkGetSuccess([obj1, obj2]); + _expectClusterCallArgs([obj1, obj2], { getId }); }); - }); - it(`doesn't prepend namespace to the id when providing no namespace for namespaced type`, async () => { - callAdminCluster.mockReturnValue({ result: 'deleted' }); - await savedObjectsRepository.delete('index-pattern', 'logstash-*'); + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + const getId = (type, id) => `${type}:${id}`; + let objects = [obj1, obj2].map(obj => ({ ...obj, type: NAMESPACE_AGNOSTIC_TYPE })); + await bulkGetSuccess(objects, { namespace }); + _expectClusterCallArgs(objects, { getId }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('delete', { - id: 'index-pattern:logstash-*', - refresh: 'wait_for', - index: '.kibana-test', - ignore: [404], + callAdminCluster.mockReset(); + objects = [obj1, obj2].map(obj => ({ ...obj, type: MULTI_NAMESPACE_TYPE })); + await bulkGetSuccess(objects, { namespace }); + _expectClusterCallArgs(objects, { getId }); }); }); - it(`doesn't prepend namespace to the id when providing namespace for namespace agnostic type`, async () => { - callAdminCluster.mockReturnValue({ result: 'deleted' }); - await savedObjectsRepository.delete('globaltype', 'logstash-*', { - namespace: 'foo-namespace', - }); + describe('errors', () => { + const bulkGetErrorInvalidType = async ([obj1, obj, obj2]) => { + const response = getMockMgetResponse([obj1, obj2]); + callAdminCluster.mockResolvedValue(response); + const result = await bulkGet([obj1, obj, obj2]); + expectClusterCalls('mget'); + expect(result).toEqual({ + saved_objects: [expectSuccess(obj1), expectErrorInvalidType(obj), expectSuccess(obj2)], + }); + }; - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('delete', { - id: 'globaltype:logstash-*', - refresh: 'wait_for', - index: '.kibana-test', - ignore: [404], - }); - }); + const bulkGetErrorNotFound = async ([obj1, obj, obj2], options, response) => { + callAdminCluster.mockResolvedValue(response); + const result = await bulkGet([obj1, obj, obj2], options); + expectClusterCalls('mget'); + expect(result).toEqual({ + saved_objects: [expectSuccess(obj1), expectErrorNotFound(obj), expectSuccess(obj2)], + }); + }; - it('defaults to a refresh setting of `wait_for`', async () => { - callAdminCluster.mockReturnValue({ result: 'deleted' }); - await savedObjectsRepository.delete('globaltype', 'logstash-*'); + it(`returns error when type is invalid`, async () => { + const obj = { type: 'unknownType', id: 'three' }; + await bulkGetErrorInvalidType([obj1, obj, obj2]); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: 'wait_for', + it(`returns error when type is hidden`, async () => { + const obj = { type: HIDDEN_TYPE, id: 'three' }; + await bulkGetErrorInvalidType([obj1, obj, obj2]); }); - }); - it(`accepts a custom refresh setting`, async () => { - callAdminCluster.mockReturnValue({ result: 'deleted' }); - await savedObjectsRepository.delete('globaltype', 'logstash-*', { - refresh: false, + it(`returns error when document is not found`, async () => { + const obj = { type: 'dashboard', id: 'three', found: false }; + const response = getMockMgetResponse([obj1, obj, obj2]); + await bulkGetErrorNotFound([obj1, obj, obj2], undefined, response); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: false, + it(`handles missing ids gracefully`, async () => { + const obj = { type: 'dashboard', id: undefined, found: false }; + const response = getMockMgetResponse([obj1, obj, obj2]); + await bulkGetErrorNotFound([obj1, obj, obj2], undefined, response); }); - }); - }); - describe('#deleteByNamespace', () => { - it('requires namespace to be defined', async () => { - callAdminCluster.mockReturnValue(deleteByQueryResults); - expect(savedObjectsRepository.deleteByNamespace()).rejects.toThrowErrorMatchingSnapshot(); - expect(callAdminCluster).not.toHaveBeenCalled(); + it(`returns error when type is multi-namespace and the document exists, but not in this namespace`, async () => { + const obj = { type: MULTI_NAMESPACE_TYPE, id: 'three' }; + const response = getMockMgetResponse([obj1, obj, obj2]); + response.docs[1].namespaces = ['bar-namespace']; + await bulkGetErrorNotFound([obj1, obj, obj2], { namespace }, response); + }); }); - it('requires namespace to be a string', async () => { - callAdminCluster.mockReturnValue(deleteByQueryResults); - expect( - savedObjectsRepository.deleteByNamespace(['namespace-1', 'namespace-2']) - ).rejects.toThrowErrorMatchingSnapshot(); - expect(callAdminCluster).not.toHaveBeenCalled(); + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(bulkGetSuccess([obj1, obj2])).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); + }); }); - it('constructs a deleteByQuery call using all types that are namespace aware', async () => { - callAdminCluster.mockReturnValue(deleteByQueryResults); - const result = await savedObjectsRepository.deleteByNamespace('my-namespace'); - - expect(result).toEqual(deleteByQueryResults); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - - expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith(mappings, typeRegistry, { - namespace: 'my-namespace', - type: ['config', 'baz', 'index-pattern', 'dashboard'], + describe('returns', () => { + const expectSuccessResult = ({ type, id }, doc) => ({ + type, + id, + ...(doc._source.namespaces && { namespaces: doc._source.namespaces }), + ...(doc._source.updated_at && { updated_at: doc._source.updated_at }), + version: encodeHitVersion(doc), + attributes: doc._source[type], + references: doc._source.references || [], + migrationVersion: doc._source.migrationVersion, }); - expect(callAdminCluster).toHaveBeenCalledWith('deleteByQuery', { - body: { conflicts: 'proceed' }, - ignore: [404], - index: ['.kibana-test', 'beats'], - refresh: 'wait_for', + it(`returns early for empty objects argument`, async () => { + const result = await bulkGet([]); + expect(result).toEqual({ saved_objects: [] }); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - }); - - it('defaults to a refresh setting of `wait_for`', async () => { - callAdminCluster.mockReturnValue(deleteByQueryResults); - await savedObjectsRepository.deleteByNamespace('my-namespace'); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: 'wait_for', + it(`formats the ES response`, async () => { + const response = getMockMgetResponse([obj1, obj2]); + callAdminCluster.mockResolvedValue(response); + const result = await bulkGet([obj1, obj2]); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + expect(result).toEqual({ + saved_objects: [ + expectSuccessResult(obj1, response.docs[0]), + expectSuccessResult(obj2, response.docs[1]), + ], + }); }); - }); - it('accepts a custom refresh setting', async () => { - callAdminCluster.mockReturnValue(deleteByQueryResults); - await savedObjectsRepository.deleteByNamespace('my-namespace', { refresh: true }); + it(`handles a mix of successful gets and errors`, async () => { + const response = getMockMgetResponse([obj1, obj2]); + callAdminCluster.mockResolvedValue(response); + const obj = { type: 'unknownType', id: 'three' }; + const result = await bulkGet([obj1, obj, obj2]); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + expect(result).toEqual({ + saved_objects: [ + expectSuccessResult(obj1, response.docs[0]), + expectError(obj), + expectSuccessResult(obj2, response.docs[1]), + ], + }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: true, + it(`includes namespaces property for multi-namespace documents`, async () => { + const obj = { type: MULTI_NAMESPACE_TYPE, id: 'three' }; + const result = await bulkGetSuccess([obj1, obj]); + expect(result).toEqual({ + saved_objects: [ + expect.not.objectContaining({ namespaces: expect.anything() }), + expect.objectContaining({ namespaces: expect.any(Array) }), + ], + }); }); }); }); - describe('#find', () => { - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); - - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - await expect(savedObjectsRepository.find({ type: 'foo' })).resolves.toBeDefined(); - - expect(migrator.runMigrations).toHaveBeenCalledTimes(1); - }); - - it('requires type to be defined', async () => { - await expect(savedObjectsRepository.find({})).rejects.toThrow(/options\.type must be/); - expect(callAdminCluster).not.toHaveBeenCalled(); + describe('#bulkUpdate', () => { + const obj1 = { + type: 'config', + id: '6.0.0-alpha1', + attributes: { title: 'Test One' }, + }; + const obj2 = { + type: 'index-pattern', + id: 'logstash-*', + attributes: { title: 'Test Two' }, + }; + const references = [{ name: 'ref_0', type: 'test', id: '1' }]; + const namespace = 'foo-namespace'; + + const getMockBulkUpdateResponse = (objects, options) => ({ + items: objects.map(({ type, id }) => ({ + update: { + _id: `${ + registry.isSingleNamespace(type) && options?.namespace ? `${options?.namespace}:` : '' + }${type}:${id}`, + ...mockVersionProps, + result: 'updated', + }, + })), }); - it('requires searchFields be an array if defined', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - try { - await savedObjectsRepository.find({ type: 'foo', searchFields: 'string' }); - throw new Error('expected find() to reject'); - } catch (error) { - expect(callAdminCluster).not.toHaveBeenCalled(); - expect(error.message).toMatch('must be an array'); + const bulkUpdateSuccess = async (objects, options) => { + const multiNamespaceObjects = objects.filter(({ type }) => registry.isMultiNamespace(type)); + if (multiNamespaceObjects?.length) { + const response = getMockMgetResponse(multiNamespaceObjects, options?.namespace); + callAdminCluster.mockResolvedValueOnce(response); // this._callCluster('mget', ...) } - }); + const response = getMockBulkUpdateResponse(objects, options?.namespace); + callAdminCluster.mockResolvedValue(response); // this._writeToCluster('bulk', ...) + const result = await savedObjectsRepository.bulkUpdate(objects, options); + expect(callAdminCluster).toHaveBeenCalledTimes(multiNamespaceObjects?.length ? 2 : 1); + return result; + }; - it('requires fields be an array if defined', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - try { - await savedObjectsRepository.find({ type: 'foo', fields: 'string' }); - throw new Error('expected find() to reject'); - } catch (error) { - expect(callAdminCluster).not.toHaveBeenCalled(); - expect(error.message).toMatch('must be an array'); + // bulk create calls have two objects for each source -- the action, and the source + const expectClusterCallArgsAction = ( + objects, + { method, _index = expect.any(String), getId = () => expect.any(String), overrides }, + n + ) => { + const body = []; + for (const { type, id } of objects) { + body.push({ + [method]: { + _index, + _id: getId(type, id), + ...overrides, + }, + }); + body.push(expect.any(Object)); } - }); - - it('passes mappings, schema, search, defaultSearchOperator, searchFields, type, sortField, sortOrder and hasReference to getSearchDsl', async () => { - callAdminCluster.mockReturnValue(namespacedSearchResults); - const relevantOpts = { - namespace: 'foo-namespace', - search: 'foo*', - searchFields: ['foo'], - type: ['bar'], - sortField: 'name', - sortOrder: 'desc', - defaultSearchOperator: 'AND', - hasReference: { - type: 'foo', - id: '1', - }, - kueryNode: undefined, - }; + expectClusterCallArgs({ body }, n); + }; - await savedObjectsRepository.find(relevantOpts); - expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledTimes(1); - expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith( - mappings, - typeRegistry, - relevantOpts - ); - }); + const expectObjArgs = ({ type, attributes }) => [ + expect.any(Object), + { + doc: expect.objectContaining({ + [type]: attributes, + ...mockTimestampFields, + }), + }, + ]; - it('accepts KQL filter and passes keuryNode to getSearchDsl', async () => { - callAdminCluster.mockReturnValue(namespacedSearchResults); - const findOpts = { - namespace: 'foo-namespace', - search: 'foo*', - searchFields: ['foo'], - type: ['dashboard'], - sortField: 'name', - sortOrder: 'desc', - defaultSearchOperator: 'AND', - hasReference: { - type: 'foo', - id: '1', - }, - indexPattern: undefined, - filter: 'dashboard.attributes.otherField: *', + describe('cluster calls', () => { + it(`should use the ES bulk action by default`, async () => { + await bulkUpdateSuccess([obj1, obj2]); + expectClusterCalls('bulk'); + }); + + it(`should use the ES mget action before bulk action for any types that are multi-namespace`, async () => { + const objects = [obj1, { ...obj2, type: MULTI_NAMESPACE_TYPE }]; + await bulkUpdateSuccess(objects); + expectClusterCalls('mget', 'bulk'); + const docs = [expect.objectContaining({ _id: `${MULTI_NAMESPACE_TYPE}:${obj2.id}` })]; + expectClusterCallArgs({ body: { docs } }, 1); + }); + + it(`formats the ES request`, async () => { + await bulkUpdateSuccess([obj1, obj2]); + const body = [...expectObjArgs(obj1), ...expectObjArgs(obj2)]; + expectClusterCallArgs({ body }); + }); + + it(`formats the ES request for any types that are multi-namespace`, async () => { + const _obj2 = { ...obj2, type: MULTI_NAMESPACE_TYPE }; + await bulkUpdateSuccess([obj1, _obj2]); + const body = [...expectObjArgs(obj1), ...expectObjArgs(_obj2)]; + expectClusterCallArgs({ body }, 2); + }); + + it(`doesnt call Elasticsearch if there are no valid objects to update`, async () => { + const objects = [obj1, obj2].map(x => ({ ...x, type: 'unknownType' })); + await savedObjectsRepository.bulkUpdate(objects); + expect(callAdminCluster).toHaveBeenCalledTimes(0); + }); + + it(`defaults to no references`, async () => { + await bulkUpdateSuccess([obj1, obj2]); + const expected = { doc: expect.not.objectContaining({ references: expect.anything() }) }; + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }); + }); + + it(`accepts custom references array`, async () => { + const test = async references => { + const objects = [obj1, obj2].map(obj => ({ ...obj, references })); + await bulkUpdateSuccess(objects); + const expected = { doc: expect.objectContaining({ references }) }; + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }); + callAdminCluster.mockReset(); + }; + await test(references); + await test(['string']); + await test([]); + }); + + it(`doesn't accept custom references if not an array`, async () => { + const test = async references => { + const objects = [obj1, obj2].map(obj => ({ ...obj, references })); + await bulkUpdateSuccess(objects); + const expected = { doc: expect.not.objectContaining({ references: expect.anything() }) }; + const body = [expect.any(Object), expected, expect.any(Object), expected]; + expectClusterCallArgs({ body }); + callAdminCluster.mockReset(); + }; + await test('string'); + await test(123); + await test(true); + await test(null); + }); + + it(`defaults to a refresh setting of wait_for`, async () => { + await bulkUpdateSuccess([obj1, obj2]); + expectClusterCallArgs({ refresh: 'wait_for' }); + }); + + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await bulkUpdateSuccess([obj1, obj2], { refresh }); + expectClusterCallArgs({ refresh }); + }); + + it(`defaults to the version of the existing document for multi-namespace types`, async () => { + // only multi-namespace documents are obtained using a pre-flight mget request + const objects = [ + { ...obj1, type: MULTI_NAMESPACE_TYPE }, + { ...obj2, type: MULTI_NAMESPACE_TYPE }, + ]; + await bulkUpdateSuccess(objects); + const overrides = { + if_seq_no: mockVersionProps._seq_no, + if_primary_term: mockVersionProps._primary_term, + }; + expectClusterCallArgsAction(objects, { method: 'update', overrides }, 2); + }); + + it(`defaults to no version for types that are not multi-namespace`, async () => { + const objects = [obj1, { ...obj2, type: NAMESPACE_AGNOSTIC_TYPE }]; + await bulkUpdateSuccess(objects); + expectClusterCallArgsAction(objects, { method: 'update' }); + }); + + it(`accepts version`, async () => { + const version = encodeHitVersion({ _seq_no: 100, _primary_term: 200 }); + // test with both non-multi-namespace and multi-namespace types + const objects = [ + { ...obj1, version }, + { ...obj2, type: MULTI_NAMESPACE_TYPE, version }, + ]; + await bulkUpdateSuccess(objects); + const overrides = { if_seq_no: 100, if_primary_term: 200 }; + expectClusterCallArgsAction(objects, { method: 'update', overrides }, 2); + }); + + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + const getId = (type, id) => `${namespace}:${type}:${id}`; + await bulkUpdateSuccess([obj1, obj2], { namespace }); + expectClusterCallArgsAction([obj1, obj2], { method: 'update', getId }); + }); + + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + const getId = (type, id) => `${type}:${id}`; + await bulkUpdateSuccess([obj1, obj2]); + expectClusterCallArgsAction([obj1, obj2], { method: 'update', getId }); + }); + + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + const getId = (type, id) => `${type}:${id}`; + const objects1 = [{ ...obj1, type: NAMESPACE_AGNOSTIC_TYPE }]; + await bulkUpdateSuccess(objects1, { namespace }); + expectClusterCallArgsAction(objects1, { method: 'update', getId }); + callAdminCluster.mockReset(); + const overrides = { + // bulkUpdate uses a preflight `get` request for multi-namespace saved objects, and specifies that version on `update` + // we aren't testing for this here, but we need to include Jest assertions so this test doesn't fail + if_primary_term: expect.any(Number), + if_seq_no: expect.any(Number), + }; + const objects2 = [{ ...obj2, type: MULTI_NAMESPACE_TYPE }]; + await bulkUpdateSuccess(objects2, { namespace }); + expectClusterCallArgsAction(objects2, { method: 'update', getId, overrides }, 2); + }); + }); + + describe('errors', () => { + const obj = { + type: 'dashboard', + id: 'three', }; - await savedObjectsRepository.find(findOpts); - expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledTimes(1); - const { kueryNode } = getSearchDslNS.getSearchDsl.mock.calls[0][2]; - expect(kueryNode).toMatchInlineSnapshot(` - Object { - "arguments": Array [ - Object { - "type": "literal", - "value": "dashboard.otherField", - }, - Object { - "type": "wildcard", - "value": "@kuery-wildcard@", - }, - Object { - "type": "literal", - "value": false, - }, - ], - "function": "is", - "type": "function", + const bulkUpdateError = async (obj, esError, expectedError) => { + const objects = [obj1, obj, obj2]; + const mockResponse = getMockBulkUpdateResponse(objects); + if (esError) { + mockResponse.items[1].update = { error: esError }; } - `); - }); + callAdminCluster.mockResolvedValue(mockResponse); // this._writeToCluster('bulk', ...) + + const result = await savedObjectsRepository.bulkUpdate(objects); + expectClusterCalls('bulk'); + const objCall = esError ? expectObjArgs(obj) : []; + const body = [...expectObjArgs(obj1), ...objCall, ...expectObjArgs(obj2)]; + expectClusterCallArgs({ body }); + expect(result).toEqual({ + saved_objects: [expectSuccess(obj1), expectedError, expectSuccess(obj2)], + }); + }; - it('KQL filter syntax errors rejects with bad request', async () => { - callAdminCluster.mockReturnValue(namespacedSearchResults); - const findOpts = { - namespace: 'foo-namespace', - search: 'foo*', - searchFields: ['foo'], - type: ['dashboard'], - sortField: 'name', - sortOrder: 'desc', - defaultSearchOperator: 'AND', - hasReference: { - type: 'foo', - id: '1', - }, - indexPattern: undefined, - filter: 'dashboard.attributes.otherField:<', + const bulkUpdateMultiError = async ([obj1, _obj, obj2], options, mgetResponse) => { + callAdminCluster.mockResolvedValueOnce(mgetResponse); // this._callCluster('mget', ...) + const bulkResponse = getMockBulkUpdateResponse([obj1, obj2], namespace); + callAdminCluster.mockResolvedValue(bulkResponse); // this._writeToCluster('bulk', ...) + + const result = await savedObjectsRepository.bulkUpdate([obj1, _obj, obj2], options); + expectClusterCalls('mget', 'bulk'); + const body = [...expectObjArgs(obj1), ...expectObjArgs(obj2)]; + expectClusterCallArgs({ body }, 2); + expect(result).toEqual({ + saved_objects: [expectSuccess(obj1), expectErrorNotFound(_obj), expectSuccess(obj2)], + }); }; - await expect(savedObjectsRepository.find(findOpts)).rejects.toMatchInlineSnapshot(` - [Error: KQLSyntaxError: Expected "(", "{", value, whitespace but "<" found. - dashboard.attributes.otherField:< - --------------------------------^: Bad Request] - `); - expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledTimes(0); - }); + it(`returns error when type is invalid`, async () => { + const _obj = { ...obj, type: 'unknownType' }; + await bulkUpdateError(_obj, undefined, expectErrorNotFound(_obj)); + }); - it('merges output of getSearchDsl into es request body', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - getSearchDslNS.getSearchDsl.mockReturnValue({ query: 1, aggregations: 2 }); - await savedObjectsRepository.find({ type: 'foo' }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - 'search', - expect.objectContaining({ - body: expect.objectContaining({ - query: 1, - aggregations: 2, - }), - }) - ); - }); + it(`returns error when type is hidden`, async () => { + const _obj = { ...obj, type: HIDDEN_TYPE }; + await bulkUpdateError(_obj, undefined, expectErrorNotFound(_obj)); + }); - it('formats Elasticsearch response when there is no namespace', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - const count = noNamespaceSearchResults.hits.hits.length; + it(`returns error when ES is unable to find the document (mget)`, async () => { + const _obj = { ...obj, type: MULTI_NAMESPACE_TYPE, found: false }; + const mgetResponse = getMockMgetResponse([_obj]); + await bulkUpdateMultiError([obj1, _obj, obj2], undefined, mgetResponse); + }); - const response = await savedObjectsRepository.find({ type: 'foo' }); + it(`returns error when ES is unable to find the index (mget)`, async () => { + const _obj = { ...obj, type: MULTI_NAMESPACE_TYPE }; + const mgetResponse = { status: 404 }; + await bulkUpdateMultiError([obj1, _obj, obj2], { namespace }, mgetResponse); + }); - expect(response.total).toBe(count); - expect(response.saved_objects).toHaveLength(count); + it(`returns error when there is a conflict with an existing multi-namespace saved object (mget)`, async () => { + const _obj = { ...obj, type: MULTI_NAMESPACE_TYPE }; + const mgetResponse = getMockMgetResponse([_obj], 'bar-namespace'); + await bulkUpdateMultiError([obj1, _obj, obj2], { namespace }, mgetResponse); + }); - noNamespaceSearchResults.hits.hits.forEach((doc, i) => { - expect(response.saved_objects[i]).toEqual({ - id: doc._id.replace(/(index-pattern|config|globaltype)\:/, ''), - type: doc._source.type, - ...mockTimestampFields, - version: mockVersion, - attributes: doc._source[doc._source.type], - references: [], - }); + it(`returns error when there is a version conflict (bulk)`, async () => { + const esError = { type: 'version_conflict_engine_exception' }; + await bulkUpdateError(obj, esError, expectErrorConflict(obj)); }); - }); - it('formats Elasticsearch response when there is a namespace', async () => { - callAdminCluster.mockReturnValue(namespacedSearchResults); - const count = namespacedSearchResults.hits.hits.length; + it(`returns error when document is missing (bulk)`, async () => { + const esError = { type: 'document_missing_exception' }; + await bulkUpdateError(obj, esError, expectErrorNotFound(obj)); + }); - const response = await savedObjectsRepository.find({ - type: 'foo', - namespace: 'foo-namespace', + it(`returns error reason for other errors (bulk)`, async () => { + const esError = { reason: 'some_other_error' }; + await bulkUpdateError(obj, esError, expectErrorResult(obj, { message: esError.reason })); }); - expect(response.total).toBe(count); - expect(response.saved_objects).toHaveLength(count); + it(`returns error string for other errors if no reason is defined (bulk)`, async () => { + const esError = { foo: 'some_other_error' }; + const expectedError = expectErrorResult(obj, { message: JSON.stringify(esError) }); + await bulkUpdateError(obj, esError, expectedError); + }); + }); - namespacedSearchResults.hits.hits.forEach((doc, i) => { - expect(response.saved_objects[i]).toEqual({ - id: doc._id.replace(/(foo-namespace\:)?(index-pattern|config|globaltype)\:/, ''), - type: doc._source.type, - ...mockTimestampFields, - version: mockVersion, - attributes: doc._source[doc._source.type], - references: [], - }); + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(bulkUpdateSuccess([obj1, obj2])).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveReturnedTimes(1); }); }); - it('accepts per_page/page', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - await savedObjectsRepository.find({ type: 'foo', perPage: 10, page: 6 }); + describe('returns', () => { + const expectSuccessResult = ({ type, id, attributes, references }) => ({ + type, + id, + attributes, + references, + version: mockVersion, + ...mockTimestampFields, + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - size: 10, - from: 50, - }) - ); - }); + it(`formats the ES response`, async () => { + const response = await bulkUpdateSuccess([obj1, obj2]); + expect(response).toEqual({ + saved_objects: [obj1, obj2].map(expectSuccessResult), + }); + }); - it('can filter by fields', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - await savedObjectsRepository.find({ type: 'foo', fields: ['title'] }); + it(`includes references`, async () => { + const objects = [obj1, obj2].map(obj => ({ ...obj, references })); + const response = await bulkUpdateSuccess(objects); + expect(response).toEqual({ + saved_objects: objects.map(expectSuccessResult), + }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - _source: [ - 'foo.title', - 'namespace', - 'type', - 'references', - 'migrationVersion', - 'updated_at', - 'title', + it(`handles a mix of successful updates and errors`, async () => { + const obj = { + type: 'unknownType', + id: 'three', + }; + const objects = [obj1, obj, obj2]; + const mockResponse = getMockBulkUpdateResponse(objects); + callAdminCluster.mockResolvedValue(mockResponse); // this._writeToCluster('bulk', ...) + const result = await savedObjectsRepository.bulkUpdate(objects); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + expect(result).toEqual({ + saved_objects: [expectSuccessResult(obj1), expectError(obj), expectSuccessResult(obj2)], + }); + }); + + it(`includes namespaces property for multi-namespace documents`, async () => { + const obj = { type: MULTI_NAMESPACE_TYPE, id: 'three' }; + const result = await bulkUpdateSuccess([obj1, obj]); + expect(result).toEqual({ + saved_objects: [ + expect.not.objectContaining({ namespaces: expect.anything() }), + expect.objectContaining({ namespaces: expect.any(Array) }), ], - }) - ); + }); + }); }); + }); - it('should set rest_total_hits_as_int to true on a request', async () => { - callAdminCluster.mockReturnValue(noNamespaceSearchResults); - await savedObjectsRepository.find({ type: 'foo' }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toHaveProperty('rest_total_hits_as_int', true); + describe('#create', () => { + beforeEach(() => { + callAdminCluster.mockImplementation((method, params) => ({ + _id: params.id, + ...mockVersionProps, + })); }); - }); - describe('#get', () => { - const noNamespaceResult = { - _id: 'index-pattern:logstash-*', - ...mockVersionProps, - _source: { - type: 'index-pattern', - specialProperty: 'specialValue', - ...mockTimestampFields, - 'index-pattern': { - title: 'Testing', - }, - }, - }; - const namespacedResult = { - _id: 'foo-namespace:index-pattern:logstash-*', - ...mockVersionProps, - _source: { - namespace: 'foo-namespace', - type: 'index-pattern', - specialProperty: 'specialValue', - ...mockTimestampFields, - 'index-pattern': { - title: 'Testing', - }, + const type = 'index-pattern'; + const attributes = { title: 'Logstash' }; + const id = 'logstash-*'; + const namespace = 'foo-namespace'; + const references = [ + { + name: 'ref_0', + type: 'test', + id: '123', }, - }; + ]; - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); + const createSuccess = async (type, attributes, options) => { + const result = await savedObjectsRepository.create(type, attributes, options); + expect(callAdminCluster).toHaveBeenCalledTimes( + registry.isMultiNamespace(type) && options.overwrite ? 2 : 1 + ); + return result; + }; - callAdminCluster.mockResolvedValue(noNamespaceResult); - await expect( - savedObjectsRepository.get('index-pattern', 'logstash-*') - ).resolves.toBeDefined(); + describe('cluster calls', () => { + it(`should use the ES create action if ID is undefined and overwrite=true`, async () => { + await createSuccess(type, attributes, { overwrite: true }); + expectClusterCalls('create'); + }); - expect(migrator.runMigrations).toHaveBeenCalledTimes(1); - }); + it(`should use the ES create action if ID is undefined and overwrite=false`, async () => { + await createSuccess(type, attributes); + expectClusterCalls('create'); + }); - it('formats Elasticsearch response when there is no namespace', async () => { - callAdminCluster.mockResolvedValue(noNamespaceResult); - const response = await savedObjectsRepository.get('index-pattern', 'logstash-*'); - expect(response).toEqual({ - id: 'logstash-*', - type: 'index-pattern', - updated_at: mockTimestamp, - version: mockVersion, - attributes: { - title: 'Testing', - }, - references: [], + it(`should use the ES index action if ID is defined and overwrite=true`, async () => { + await createSuccess(type, attributes, { id, overwrite: true }); + expectClusterCalls('index'); }); - }); - it('formats Elasticsearch response when there are namespaces', async () => { - callAdminCluster.mockResolvedValue(namespacedResult); - const response = await savedObjectsRepository.get('index-pattern', 'logstash-*'); - expect(response).toEqual({ - id: 'logstash-*', - type: 'index-pattern', - updated_at: mockTimestamp, - version: mockVersion, - attributes: { - title: 'Testing', - }, - references: [], + it(`should use the ES create action if ID is defined and overwrite=false`, async () => { + await createSuccess(type, attributes, { id }); + expectClusterCalls('create'); }); - }); - it('prepends namespace and type to the id when providing namespace for namespaced type', async () => { - callAdminCluster.mockResolvedValue(namespacedResult); - await savedObjectsRepository.get('index-pattern', 'logstash-*', { - namespace: 'foo-namespace', + it(`should use the ES get action then index action if type is multi-namespace, ID is defined, and overwrite=true`, async () => { + await createSuccess(MULTI_NAMESPACE_TYPE, attributes, { id, overwrite: true }); + expectClusterCalls('get', 'index'); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: 'foo-namespace:index-pattern:logstash-*', - }) - ); - }); + it(`defaults to empty references array`, async () => { + await createSuccess(type, attributes, { id }); + expectClusterCallArgs({ + body: expect.objectContaining({ references: [] }), + }); + }); - it(`only prepends type to the id when providing no namespace for namespaced type`, async () => { - callAdminCluster.mockResolvedValue(noNamespaceResult); - await savedObjectsRepository.get('index-pattern', 'logstash-*'); + it(`accepts custom references array`, async () => { + const test = async references => { + await createSuccess(type, attributes, { id, references }); + expectClusterCallArgs({ + body: expect.objectContaining({ references }), + }); + callAdminCluster.mockReset(); + }; + await test(references); + await test(['string']); + await test([]); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: 'index-pattern:logstash-*', - }) - ); - }); + it(`doesn't accept custom references if not an array`, async () => { + const test = async references => { + await createSuccess(type, attributes, { id, references }); + expectClusterCallArgs({ + body: expect.not.objectContaining({ references: expect.anything() }), + }); + callAdminCluster.mockReset(); + }; + await test('string'); + await test(123); + await test(true); + await test(null); + }); - it(`doesn't prepend namespace to the id when providing namespace for namespace agnostic type`, async () => { - callAdminCluster.mockResolvedValue(namespacedResult); - await savedObjectsRepository.get('globaltype', 'logstash-*', { - namespace: 'foo-namespace', + it(`defaults to a refresh setting of wait_for`, async () => { + await createSuccess(type, attributes); + expectClusterCallArgs({ refresh: 'wait_for' }); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - id: 'globaltype:logstash-*', - }) - ); - }); - }); + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await createSuccess(type, attributes, { refresh }); + expectClusterCallArgs({ refresh }); + }); - describe('#bulkGet', () => { - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); - - callAdminCluster.mockReturnValue({ docs: [] }); - await expect( - savedObjectsRepository.bulkGet([ - { id: 'one', type: 'config' }, - { id: 'two', type: 'index-pattern' }, - { id: 'three', type: 'globaltype' }, - ]) - ).resolves.toBeDefined(); - - expect(migrator.runMigrations).toHaveBeenCalledTimes(1); - }); + it(`should use default index`, async () => { + await createSuccess(type, attributes, { id }); + expectClusterCallArgs({ index: '.kibana-test' }); + }); - it('prepends type to id when getting objects when there is no namespace', async () => { - callAdminCluster.mockReturnValue({ docs: [] }); + it(`should use custom index`, async () => { + await createSuccess(CUSTOM_INDEX_TYPE, attributes, { id }); + expectClusterCallArgs({ index: 'custom' }); + }); - await savedObjectsRepository.bulkGet([ - { id: 'one', type: 'config' }, - { id: 'two', type: 'index-pattern' }, - { id: 'three', type: 'globaltype' }, - ]); + it(`self-generates an id if none is provided`, async () => { + await createSuccess(type, attributes); + expectClusterCallArgs({ + id: expect.objectContaining(/index-pattern:[0-9a-f]{8}-([0-9a-f]{4}-){3}[0-9a-f]{12}/), + }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - body: { - docs: [ - { _id: 'config:one', _index: '.kibana-test' }, - { _id: 'index-pattern:two', _index: '.kibana-test' }, - { _id: 'globaltype:three', _index: '.kibana-test' }, - ], - }, - }) - ); - }); + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + await createSuccess(type, attributes, { id, namespace }); + expectClusterCallArgs({ id: `${namespace}:${type}:${id}` }); + }); - it('prepends namespace and type appropriately to id when getting objects when there is a namespace', async () => { - callAdminCluster.mockReturnValue({ docs: [] }); + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + await createSuccess(type, attributes, { id }); + expectClusterCallArgs({ id: `${type}:${id}` }); + }); - await savedObjectsRepository.bulkGet( - [ - { id: 'one', type: 'config' }, - { id: 'two', type: 'index-pattern' }, - { id: 'three', type: 'globaltype' }, - ], - { - namespace: 'foo-namespace', - } - ); + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + await createSuccess(NAMESPACE_AGNOSTIC_TYPE, attributes, { id, namespace }); + expectClusterCallArgs({ id: `${NAMESPACE_AGNOSTIC_TYPE}:${id}` }); + callAdminCluster.mockReset(); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - body: { - docs: [ - { _id: 'foo-namespace:config:one', _index: '.kibana-test' }, - { _id: 'foo-namespace:index-pattern:two', _index: '.kibana-test' }, - { _id: 'globaltype:three', _index: '.kibana-test' }, - ], - }, - }) - ); + await createSuccess(MULTI_NAMESPACE_TYPE, attributes, { id, namespace }); + expectClusterCallArgs({ id: `${MULTI_NAMESPACE_TYPE}:${id}` }); + }); }); - it('mockReturnValue early for empty objects argument', async () => { - callAdminCluster.mockReturnValue({ docs: [] }); + describe('errors', () => { + it(`throws when type is invalid`, async () => { + await expect(savedObjectsRepository.create('unknownType', attributes)).rejects.toThrowError( + createUnsupportedTypeError('unknownType') + ); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - const response = await savedObjectsRepository.bulkGet([]); + it(`throws when type is hidden`, async () => { + await expect(savedObjectsRepository.create(HIDDEN_TYPE, attributes)).rejects.toThrowError( + createUnsupportedTypeError(HIDDEN_TYPE) + ); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - expect(response.saved_objects).toHaveLength(0); - expect(callAdminCluster).not.toHaveBeenCalled(); + it(`throws when there is a conflict with an existing multi-namespace saved object (get)`, async () => { + const response = getMockGetResponse({ + type: MULTI_NAMESPACE_TYPE, + id, + namespace: 'bar-namespace', + }); + callAdminCluster.mockResolvedValue(response); // this._callCluster('get', ...) + await expect( + savedObjectsRepository.create(MULTI_NAMESPACE_TYPE, attributes, { + id, + overwrite: true, + namespace, + }) + ).rejects.toThrowError(createConflictError(MULTI_NAMESPACE_TYPE, id)); + expectClusterCalls('get'); + }); + + it(`throws when automatic index creation fails`, async () => { + // TODO + }); + + it(`throws when an unexpected failure occurs`, async () => { + // TODO + }); }); - it('handles missing ids gracefully', async () => { - callAdminCluster.mockResolvedValue({ - docs: [ - { - _id: 'config:good', - found: true, - ...mockVersionProps, - _source: { ...mockTimestampFields, config: { title: 'Test' } }, - }, - { - _id: 'config:bad', - found: false, - }, - ], + describe('migration', () => { + beforeEach(() => { + migrator.migrateDocument.mockImplementation(mockMigrateDocument); }); - const { saved_objects: savedObjects } = await savedObjectsRepository.bulkGet([ - { id: 'good', type: 'config' }, - { type: 'config' }, - ]); + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(createSuccess(type, attributes, { id, namespace })).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); + }); - expect(savedObjects[1]).toEqual({ - type: 'config', - error: { statusCode: 404, message: 'Not found' }, + it(`migrates a document and serializes the migrated doc`, async () => { + const migrationVersion = mockMigrationVersion; + await createSuccess(type, attributes, { id, references, migrationVersion }); + const doc = { type, id, attributes, references, migrationVersion, ...mockTimestampFields }; + expectMigrationArgs(doc); + + const migratedDoc = migrator.migrateDocument(doc); + expect(serializer.savedObjectToRaw).toHaveBeenLastCalledWith(migratedDoc); }); - }); - it('reports error on missed objects', async () => { - callAdminCluster.mockResolvedValue({ - docs: [ - { - _id: 'config:good', - found: true, - ...mockVersionProps, - _source: { ...mockTimestampFields, config: { title: 'Test' } }, - }, - { - _id: 'config:bad', - found: false, - }, - ], + it(`adds namespace to body when providing namespace for single-namespace type`, async () => { + await createSuccess(type, attributes, { id, namespace }); + expectMigrationArgs({ namespace }); }); - const { saved_objects: savedObjects } = await savedObjectsRepository.bulkGet([ - { id: 'good', type: 'config' }, - { id: 'bad', type: 'config' }, - ]); + it(`doesn't add namespace to body when providing no namespace for single-namespace type`, async () => { + await createSuccess(type, attributes, { id }); + expectMigrationArgs({ namespace: expect.anything() }, false); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`doesn't add namespace to body when not using single-namespace type`, async () => { + await createSuccess(NAMESPACE_AGNOSTIC_TYPE, attributes, { id, namespace }); + expectMigrationArgs({ namespace: expect.anything() }, false, 1); - expect(savedObjects).toHaveLength(2); - expect(savedObjects[0]).toEqual({ - id: 'good', - type: 'config', - ...mockTimestampFields, - version: mockVersion, - attributes: { title: 'Test' }, - references: [], + callAdminCluster.mockReset(); + await createSuccess(MULTI_NAMESPACE_TYPE, attributes, { id }); + expectMigrationArgs({ namespace: expect.anything() }, false, 2); }); - expect(savedObjects[1]).toEqual({ - id: 'bad', - type: 'config', - error: { statusCode: 404, message: 'Not found' }, + + it(`adds namespaces to body when providing namespace for multi-namespace type`, async () => { + await createSuccess(MULTI_NAMESPACE_TYPE, attributes, { id, namespace }); + expectMigrationArgs({ namespaces: [namespace] }); }); - }); - it('returns errors when requesting unsupported types', async () => { - callAdminCluster.mockResolvedValue({ - docs: [ - { - _id: 'one', - found: true, - ...mockVersionProps, - _source: { ...mockTimestampFields, config: { title: 'Test1' } }, - }, - { - _id: 'three', - found: true, - ...mockVersionProps, - _source: { ...mockTimestampFields, config: { title: 'Test3' } }, - }, - { - _id: 'five', - found: true, - ...mockVersionProps, - _source: { ...mockTimestampFields, config: { title: 'Test5' } }, - }, - ], + it(`adds default namespaces to body when providing no namespace for multi-namespace type`, async () => { + await createSuccess(MULTI_NAMESPACE_TYPE, attributes, { id }); + expectMigrationArgs({ namespaces: ['default'] }); }); - const { saved_objects: savedObjects } = await savedObjectsRepository.bulkGet([ - { id: 'one', type: 'config' }, - { id: 'two', type: 'invalidtype' }, - { id: 'three', type: 'config' }, - { id: 'four', type: 'invalidtype' }, - { id: 'five', type: 'config' }, - ]); + it(`doesn't add namespaces to body when not using multi-namespace type`, async () => { + await createSuccess(type, attributes, { id }); + expectMigrationArgs({ namespaces: expect.anything() }, false, 1); - expect(savedObjects).toEqual([ - { - attributes: { title: 'Test1' }, - id: 'one', - ...mockTimestampFields, - references: [], - type: 'config', - version: mockVersion, - migrationVersion: undefined, - }, - { - attributes: { title: 'Test3' }, - id: 'three', - ...mockTimestampFields, - references: [], - type: 'config', - version: mockVersion, - migrationVersion: undefined, - }, - { - attributes: { title: 'Test5' }, - id: 'five', + callAdminCluster.mockReset(); + await createSuccess(NAMESPACE_AGNOSTIC_TYPE, attributes, { id }); + expectMigrationArgs({ namespaces: expect.anything() }, false, 2); + }); + }); + + describe('returns', () => { + it(`formats the ES response`, async () => { + const result = await createSuccess(type, attributes, { id, namespace, references }); + expect(result).toEqual({ + type, + id, ...mockTimestampFields, - references: [], - type: 'config', version: mockVersion, - migrationVersion: undefined, - }, - { - error: { - error: 'Bad Request', - message: "Unsupported saved object type: 'invalidtype': Bad Request", - statusCode: 400, - }, - id: 'two', - type: 'invalidtype', - }, - { - error: { - error: 'Bad Request', - message: "Unsupported saved object type: 'invalidtype': Bad Request", - statusCode: 400, - }, - id: 'four', - type: 'invalidtype', - }, - ]); + attributes, + references, + }); + }); }); }); - describe('#update', () => { - const id = 'logstash-*'; + describe('#delete', () => { const type = 'index-pattern'; - const attributes = { title: 'Testing' }; + const id = 'logstash-*'; + const namespace = 'foo-namespace'; - beforeEach(() => { - callAdminCluster.mockResolvedValue({ - _id: `${type}:${id}`, - ...mockVersionProps, - result: 'updated', + const deleteSuccess = async (type, id, options) => { + if (registry.isMultiNamespace(type)) { + const mockGetResponse = getMockGetResponse({ type, id, namespace: options?.namespace }); + callAdminCluster.mockResolvedValueOnce(mockGetResponse); // this._callCluster('get', ...) + } + callAdminCluster.mockResolvedValue({ result: 'deleted' }); // this._writeToCluster('delete', ...) + const result = await savedObjectsRepository.delete(type, id, options); + expect(callAdminCluster).toHaveBeenCalledTimes(registry.isMultiNamespace(type) ? 2 : 1); + return result; + }; + + describe('cluster calls', () => { + it(`should use the ES delete action when not using a multi-namespace type`, async () => { + await deleteSuccess(type, id); + expectClusterCalls('delete'); }); - }); - it('waits until migrations are complete before proceeding', async () => { - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); + it(`should use ES get action then delete action when using a multi-namespace type with no namespaces remaining`, async () => { + await deleteSuccess(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get', 'delete'); + }); - await expect( - savedObjectsRepository.update('index-pattern', 'logstash-*', attributes, { - namespace: 'foo-namespace', - }) - ).resolves.toBeDefined(); + it(`should use ES get action then update action when using a multi-namespace type with one or more namespaces remaining`, async () => { + const mockResponse = getMockGetResponse({ type: MULTI_NAMESPACE_TYPE, id }); + mockResponse._source.namespaces = ['default', 'some-other-nameespace']; + callAdminCluster + .mockResolvedValueOnce(mockResponse) // this._callCluster('get', ...) + .mockResolvedValue({ result: 'updated' }); // this._writeToCluster('update', ...) + await savedObjectsRepository.delete(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get', 'update'); + }); - expect(migrator.runMigrations).toHaveReturnedTimes(1); - }); + it(`includes the version of the existing document when type is multi-namespace`, async () => { + await deleteSuccess(MULTI_NAMESPACE_TYPE, id); + const versionProperties = { + if_seq_no: mockVersionProps._seq_no, + if_primary_term: mockVersionProps._primary_term, + }; + expectClusterCallArgs(versionProperties, 2); + }); - it('mockReturnValue current ES document _seq_no and _primary_term encoded as version', async () => { - const response = await savedObjectsRepository.update( - 'index-pattern', - 'logstash-*', - attributes, - { - namespace: 'foo-namespace', - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - } - ); - expect(response).toEqual({ - id, - type, - ...mockTimestampFields, - version: mockVersion, - attributes, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], + it(`defaults to a refresh setting of wait_for`, async () => { + await deleteSuccess(type, id); + expectClusterCallArgs({ refresh: 'wait_for' }); }); - }); - it('accepts version', async () => { - await savedObjectsRepository.update( - type, - id, - { title: 'Testing' }, - { - version: encodeHitVersion({ - _seq_no: 100, - _primary_term: 200, - }), - } - ); + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await deleteSuccess(type, id, { refresh }); + expectClusterCallArgs({ refresh }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - if_seq_no: 100, - if_primary_term: 200, - }) - ); + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + await deleteSuccess(type, id, { namespace }); + expectClusterCallArgs({ id: `${namespace}:${type}:${id}` }); + }); + + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + await deleteSuccess(type, id); + expectClusterCallArgs({ id: `${type}:${id}` }); + }); + + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + await deleteSuccess(NAMESPACE_AGNOSTIC_TYPE, id, { namespace }); + expectClusterCallArgs({ id: `${NAMESPACE_AGNOSTIC_TYPE}:${id}` }); + + callAdminCluster.mockReset(); + await deleteSuccess(MULTI_NAMESPACE_TYPE, id, { namespace }); + expectClusterCallArgs({ id: `${MULTI_NAMESPACE_TYPE}:${id}` }); + }); }); - it('does not pass references if omitted', async () => { - await savedObjectsRepository.update(type, id, { title: 'Testing' }); + describe('errors', () => { + const expectNotFoundError = async (type, id, options) => { + await expect(savedObjectsRepository.delete(type, id, options)).rejects.toThrowError( + createGenericNotFoundError(type, id) + ); + }; + + it(`throws when type is invalid`, async () => { + await expectNotFoundError('unknownType', id); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); + + it(`throws when type is hidden`, async () => { + await expectNotFoundError(HIDDEN_TYPE, id); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); + + it(`throws when ES is unable to find the document during get`, async () => { + callAdminCluster.mockResolvedValue({ found: false }); // this._callCluster('get', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get'); + }); + + it(`throws when ES is unable to find the index during get`, async () => { + callAdminCluster.mockResolvedValue({ status: 404 }); // this._callCluster('get', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get'); + }); + + it(`throws when the type is multi-namespace and the document exists, but not in this namespace`, async () => { + const response = getMockGetResponse({ type: MULTI_NAMESPACE_TYPE, id, namespace }); + callAdminCluster.mockResolvedValue(response); // this._callCluster('get', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id, { namespace: 'bar-namespace' }); + expectClusterCalls('get'); + }); + + it(`throws when ES is unable to find the document during update`, async () => { + const mockResponse = getMockGetResponse({ type: MULTI_NAMESPACE_TYPE, id }); + mockResponse._source.namespaces = ['default', 'some-other-nameespace']; + callAdminCluster + .mockResolvedValueOnce(mockResponse) // this._callCluster('get', ...) + .mockResolvedValue({ status: 404 }); // this._writeToCluster('update', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get', 'update'); + }); + + it(`throws when ES is unable to find the document during delete`, async () => { + callAdminCluster.mockResolvedValue({ result: 'not_found' }); // this._writeToCluster('delete', ...) + await expectNotFoundError(type, id); + expectClusterCalls('delete'); + }); + + it(`throws when ES is unable to find the index during delete`, async () => { + callAdminCluster.mockResolvedValue({ error: { type: 'index_not_found_exception' } }); // this._writeToCluster('delete', ...) + await expectNotFoundError(type, id); + expectClusterCalls('delete'); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).not.toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - body: { - doc: expect.objectContaining({ - references: [], - }), - }, - }) - ); + it(`throws when ES returns an unexpected response`, async () => { + callAdminCluster.mockResolvedValue({ result: 'something unexpected' }); // this._writeToCluster('delete', ...) + await expect(savedObjectsRepository.delete(type, id)).rejects.toThrowError( + 'Unexpected Elasticsearch DELETE response' + ); + expectClusterCalls('delete'); + }); }); - it('passes references if they are provided', async () => { - await savedObjectsRepository.update(type, id, { title: 'Testing' }, { references: ['foo'] }); + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + let callAdminClusterCount = 0; + migrator.runMigrations = jest.fn(async () => + // runMigrations should resolve before callAdminCluster is initiated + expect(callAdminCluster).toHaveBeenCalledTimes(callAdminClusterCount++) + ); + await expect(deleteSuccess(type, id)).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); + }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - body: { - doc: expect.objectContaining({ - references: ['foo'], - }), - }, - }) - ); + describe('returns', () => { + it(`returns an empty object on success`, async () => { + const result = await deleteSuccess(type, id); + expect(result).toEqual({}); + }); }); + }); - it('passes empty references array if empty references array is provided', async () => { - await savedObjectsRepository.update(type, id, { title: 'Testing' }, { references: [] }); + describe('#deleteByNamespace', () => { + const namespace = 'foo-namespace'; + const mockUpdateResults = { + took: 15, + timed_out: false, + total: 3, + updated: 2, + deleted: 1, + batches: 1, + version_conflicts: 0, + noops: 0, + retries: { bulk: 0, search: 0 }, + throttled_millis: 0, + requests_per_second: -1.0, + throttled_until_millis: 0, + failures: [], + }; + const deleteByNamespaceSuccess = async (namespace, options) => { + callAdminCluster.mockResolvedValue(mockUpdateResults); + const result = await savedObjectsRepository.deleteByNamespace(namespace, options); + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledTimes(1); expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith( - expect.any(String), - expect.objectContaining({ - body: { - doc: expect.objectContaining({ - references: [], - }), - }, - }) - ); - }); + return result; + }; - it(`prepends namespace to the id but doesn't add namespace to body when providing namespace for namespaced type`, async () => { - await savedObjectsRepository.update( - 'index-pattern', - 'logstash-*', - { - title: 'Testing', - }, - { - namespace: 'foo-namespace', - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - } - ); + describe('cluster calls', () => { + it(`should use the ES updateByQuery action`, async () => { + await deleteByNamespaceSuccess(namespace); + expectClusterCalls('updateByQuery'); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('update', { - id: 'foo-namespace:index-pattern:logstash-*', - body: { - doc: { - updated_at: mockTimestamp, - 'index-pattern': { title: 'Testing' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - }, - }, - ignore: [404], - refresh: 'wait_for', - index: '.kibana-test', + it(`defaults to a refresh setting of wait_for`, async () => { + await deleteByNamespaceSuccess(namespace); + expectClusterCallArgs({ refresh: 'wait_for' }); }); - }); - it(`doesn't prepend namespace to the id or add namespace property when providing no namespace for namespaced type`, async () => { - await savedObjectsRepository.update( - 'index-pattern', - 'logstash-*', - { - title: 'Testing', - }, - { - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - } - ); + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await deleteByNamespaceSuccess(namespace, { refresh }); + expectClusterCallArgs({ refresh }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('update', { - id: 'index-pattern:logstash-*', - body: { - doc: { - updated_at: mockTimestamp, - 'index-pattern': { title: 'Testing' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - }, - }, - ignore: [404], - refresh: 'wait_for', - index: '.kibana-test', + it(`should use all indices for types that are not namespace-agnostic`, async () => { + await deleteByNamespaceSuccess(namespace); + expectClusterCallArgs({ index: ['.kibana-test', 'custom'] }, 1); }); }); - it(`doesn't prepend namespace to the id or add namespace property when providing namespace for namespace agnostic type`, async () => { - await savedObjectsRepository.update( - 'globaltype', - 'foo', - { - name: 'bar', - }, - { - namespace: 'foo-namespace', - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - } - ); - - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster).toHaveBeenCalledWith('update', { - id: 'globaltype:foo', - body: { - doc: { - updated_at: mockTimestamp, - globaltype: { name: 'bar' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - }, - }, - ignore: [404], - refresh: 'wait_for', - index: '.kibana-test', + describe('errors', () => { + it(`throws when namespace is not a string`, async () => { + const test = async namespace => { + await expect(savedObjectsRepository.deleteByNamespace(namespace)).rejects.toThrowError( + `namespace is required, and must be a string` + ); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; + await test(undefined); + await test(['namespace']); + await test(123); + await test(true); }); }); - it('defaults to a refresh setting of `wait_for`', async () => { - await savedObjectsRepository.update('globaltype', 'foo', { - name: 'bar', + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(deleteByNamespaceSuccess(namespace)).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: 'wait_for', + describe('returns', () => { + it(`returns the query results on success`, async () => { + const result = await deleteByNamespaceSuccess(namespace); + expect(result).toEqual(mockUpdateResults); }); }); - it('accepts a custom refresh setting', async () => { - await savedObjectsRepository.update( - 'globaltype', - 'foo', - { - name: 'bar', - }, - { - refresh: true, - namespace: 'foo-namespace', - } - ); - - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: true, + describe('search dsl', () => { + it(`constructs a query using all multi-namespace types, and another using all single-namespace types`, async () => { + await deleteByNamespaceSuccess(namespace); + const allTypes = registry.getAllTypes().map(type => type.name); + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith(mappings, registry, { + namespace, + type: allTypes.filter(type => !registry.isNamespaceAgnostic(type)), + }); }); }); }); - describe('#bulkUpdate', () => { - const { generateSavedObject, reset } = (() => { - let count = 0; + describe('#find', () => { + const generateSearchResults = namespace => { return { - generateSavedObject(overrides) { - count++; - return _.merge( + hits: { + total: 4, + hits: [ { - type: 'index-pattern', - id: `logstash-${count}`, - attributes: { title: `Testing ${count}` }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', + _index: '.kibana', + _id: `${namespace ? `${namespace}:` : ''}index-pattern:logstash-*`, + _score: 1, + ...mockVersionProps, + _source: { + namespace, + type: 'index-pattern', + ...mockTimestampFields, + 'index-pattern': { + title: 'logstash-*', + timeFieldName: '@timestamp', + notExpandable: true, }, - ], + }, }, - overrides - ); - }, - reset() { - count = 0; + { + _index: '.kibana', + _id: `${namespace ? `${namespace}:` : ''}config:6.0.0-alpha1`, + _score: 1, + ...mockVersionProps, + _source: { + namespace, + type: 'config', + ...mockTimestampFields, + config: { + buildNum: 8467, + defaultIndex: 'logstash-*', + }, + }, + }, + { + _index: '.kibana', + _id: `${namespace ? `${namespace}:` : ''}index-pattern:stocks-*`, + _score: 1, + ...mockVersionProps, + _source: { + namespace, + type: 'index-pattern', + ...mockTimestampFields, + 'index-pattern': { + title: 'stocks-*', + timeFieldName: '@timestamp', + notExpandable: true, + }, + }, + }, + { + _index: '.kibana', + _id: `${NAMESPACE_AGNOSTIC_TYPE}:something`, + _score: 1, + ...mockVersionProps, + _source: { + type: NAMESPACE_AGNOSTIC_TYPE, + ...mockTimestampFields, + [NAMESPACE_AGNOSTIC_TYPE]: { + name: 'bar', + }, + }, + }, + ], }, }; - })(); + }; - beforeEach(() => { - reset(); - }); + const type = 'index-pattern'; + const namespace = 'foo-namespace'; - const mockValidResponse = objects => - callAdminCluster.mockReturnValue({ - items: objects.map(items => ({ - update: { - _id: `${items.type}:${items.id}`, - ...mockVersionProps, - result: 'updated', - }, - })), + const findSuccess = async (options, namespace) => { + callAdminCluster.mockResolvedValue(generateSearchResults(namespace)); + const result = await savedObjectsRepository.find(options); + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledTimes(1); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + return result; + }; + + describe('cluster calls', () => { + it(`should use the ES search action`, async () => { + await findSuccess({ type }); + expectClusterCalls('search'); + }); + + it(`merges output of getSearchDsl into es request body`, async () => { + const query = { query: 1, aggregations: 2 }; + getSearchDslNS.getSearchDsl.mockReturnValue(query); + await findSuccess({ type }); + expectClusterCallArgs({ body: expect.objectContaining({ ...query }) }); }); - it('waits until migrations are complete before proceeding', async () => { - const objects = [generateSavedObject(), generateSavedObject()]; + it(`accepts per_page/page`, async () => { + await findSuccess({ type, perPage: 10, page: 6 }); + expectClusterCallArgs({ + size: 10, + from: 50, + }); + }); - migrator.runMigrations = jest.fn(async () => expect(callAdminCluster).not.toHaveBeenCalled()); + it(`can filter by fields`, async () => { + await findSuccess({ type, fields: ['title'] }); + expectClusterCallArgs({ + _source: [ + `${type}.title`, + 'namespace', + 'namespaces', + 'type', + 'references', + 'migrationVersion', + 'updated_at', + 'title', + ], + }); + }); - mockValidResponse(objects); + it(`should set rest_total_hits_as_int to true on a request`, async () => { + await findSuccess({ type }); + expectClusterCallArgs({ rest_total_hits_as_int: true }); + }); - await expect( - savedObjectsRepository.bulkUpdate([generateSavedObject()]) - ).resolves.toBeDefined(); + it(`should not make a cluster call when attempting to find only invalid or hidden types`, async () => { + const test = async types => { + await savedObjectsRepository.find({ type: types }); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; - expect(migrator.runMigrations).toHaveReturnedTimes(1); + await test('unknownType'); + await test(HIDDEN_TYPE); + await test(['unknownType', HIDDEN_TYPE]); + }); }); - it('returns current ES document, _seq_no and _primary_term encoded as version', async () => { - const objects = [generateSavedObject(), generateSavedObject()]; - - mockValidResponse(objects); + describe('errors', () => { + it(`throws when type is not defined`, async () => { + await expect(savedObjectsRepository.find({})).rejects.toThrowError( + 'options.type must be a string or an array of strings' + ); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - const response = await savedObjectsRepository.bulkUpdate(objects); + it(`throws when searchFields is defined but not an array`, async () => { + await expect( + savedObjectsRepository.find({ type, searchFields: 'string' }) + ).rejects.toThrowError('options.searchFields must be an array'); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - expect(response.saved_objects[0]).toMatchObject({ - ..._.pick(objects[0], 'id', 'type', 'attributes'), - version: mockVersion, - references: objects[0].references, + it(`throws when fields is defined but not an array`, async () => { + await expect(savedObjectsRepository.find({ type, fields: 'string' })).rejects.toThrowError( + 'options.fields must be an array' + ); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - expect(response.saved_objects[1]).toMatchObject({ - ..._.pick(objects[1], 'id', 'type', 'attributes'), - version: mockVersion, - references: objects[1].references, + + it(`throws when KQL filter syntax is invalid`, async () => { + const findOpts = { + namespace, + search: 'foo*', + searchFields: ['foo'], + type: ['dashboard'], + sortField: 'name', + sortOrder: 'desc', + defaultSearchOperator: 'AND', + hasReference: { + type: 'foo', + id: '1', + }, + indexPattern: undefined, + filter: 'dashboard.attributes.otherField:<', + }; + + await expect(savedObjectsRepository.find(findOpts)).rejects.toMatchInlineSnapshot(` + [Error: KQLSyntaxError: Expected "(", "{", value, whitespace but "<" found. + dashboard.attributes.otherField:< + --------------------------------^: Bad Request] + `); + expect(getSearchDslNS.getSearchDsl).not.toHaveBeenCalled(); + expect(callAdminCluster).not.toHaveBeenCalled(); }); }); - it('handles a mix of succesfull updates and errors', async () => { - const objects = [ - generateSavedObject(), - { - type: 'invalid-type', - id: 'invalid', - attributes: { title: 'invalid' }, - }, - generateSavedObject(), - generateSavedObject({ - id: 'version_clash', - }), - ]; - - callAdminCluster.mockReturnValue({ - items: objects - // remove invalid from mocks - .filter(item => item.id !== 'invalid') - .map(items => { - switch (items.id) { - case 'version_clash': - return { - update: { - _id: `${items.type}:${items.id}`, - error: { - type: 'version_conflict_engine_exception', - }, - }, - }; - default: - return { - update: { - _id: `${items.type}:${items.id}`, - ...mockVersionProps, - result: 'updated', - }, - }; - } - }), - }); - - const { - saved_objects: [firstUpdatedObject, invalidType, secondUpdatedObject, versionClashObject], - } = await savedObjectsRepository.bulkUpdate(objects); - - expect(firstUpdatedObject).toMatchObject({ - ..._.pick(objects[0], 'id', 'type', 'attributes', 'references'), - version: mockVersion, + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(findSuccess({ type })).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); }); + }); - expect(invalidType).toMatchObject({ - ..._.pick(objects[1], 'id', 'type'), - error: SavedObjectsErrorHelpers.createGenericNotFoundError('invalid-type', 'invalid').output - .payload, - }); + describe('returns', () => { + it(`formats the ES response when there is no namespace`, async () => { + const noNamespaceSearchResults = generateSearchResults(); + callAdminCluster.mockReturnValue(noNamespaceSearchResults); + const count = noNamespaceSearchResults.hits.hits.length; - expect(secondUpdatedObject).toMatchObject({ - ..._.pick(objects[2], 'id', 'type', 'attributes', 'references'), - version: mockVersion, - }); + const response = await savedObjectsRepository.find({ type }); + + expect(response.total).toBe(count); + expect(response.saved_objects).toHaveLength(count); - expect(versionClashObject).toMatchObject({ - ..._.pick(objects[3], 'id', 'type'), - error: { statusCode: 409, message: 'version conflict, document already exists' }, + noNamespaceSearchResults.hits.hits.forEach((doc, i) => { + expect(response.saved_objects[i]).toEqual({ + id: doc._id.replace(/(index-pattern|config|globalType)\:/, ''), + type: doc._source.type, + ...mockTimestampFields, + version: mockVersion, + attributes: doc._source[doc._source.type], + references: [], + }); + }); }); - }); - it('doesnt call Elasticsearch if there are no valid objects to update', async () => { - const objects = [ - { - type: 'invalid-type', - id: 'invalid', - attributes: { title: 'invalid' }, - }, - { - type: 'invalid-type', - id: 'invalid 2', - attributes: { title: 'invalid' }, - }, - ]; + it(`formats the ES response when there is a namespace`, async () => { + const namespacedSearchResults = generateSearchResults(namespace); + callAdminCluster.mockReturnValue(namespacedSearchResults); + const count = namespacedSearchResults.hits.hits.length; - const { - saved_objects: [invalidType, invalidType2], - } = await savedObjectsRepository.bulkUpdate(objects); + const response = await savedObjectsRepository.find({ type, namespace }); - expect(callAdminCluster).not.toHaveBeenCalled(); + expect(response.total).toBe(count); + expect(response.saved_objects).toHaveLength(count); - expect(invalidType).toMatchObject({ - ..._.pick(objects[0], 'id', 'type'), - error: SavedObjectsErrorHelpers.createGenericNotFoundError('invalid-type', 'invalid').output - .payload, + namespacedSearchResults.hits.hits.forEach((doc, i) => { + expect(response.saved_objects[i]).toEqual({ + id: doc._id.replace(/(foo-namespace\:)?(index-pattern|config|globalType)\:/, ''), + type: doc._source.type, + ...mockTimestampFields, + version: mockVersion, + attributes: doc._source[doc._source.type], + references: [], + }); + }); }); - expect(invalidType2).toMatchObject({ - ..._.pick(objects[1], 'id', 'type'), - error: SavedObjectsErrorHelpers.createGenericNotFoundError('invalid-type', 'invalid 2') - .output.payload, + it(`should return empty results when attempting to find only invalid or hidden types`, async () => { + const test = async types => { + const result = await savedObjectsRepository.find({ type: types }); + expect(result).toEqual(expect.objectContaining({ saved_objects: [] })); + }; + + await test('unknownType'); + await test(HIDDEN_TYPE); + await test(['unknownType', HIDDEN_TYPE]); }); }); - it('accepts version', async () => { - const objects = [ - generateSavedObject({ - version: encodeHitVersion({ - _seq_no: 100, - _primary_term: 200, - }), - }), - generateSavedObject({ - version: encodeHitVersion({ - _seq_no: 300, - _primary_term: 400, - }), - }), - ]; + describe('search dsl', () => { + it(`passes mappings, registry, search, defaultSearchOperator, searchFields, type, sortField, sortOrder and hasReference to getSearchDsl`, async () => { + const relevantOpts = { + namespace, + search: 'foo*', + searchFields: ['foo'], + type: [type], + sortField: 'name', + sortOrder: 'desc', + defaultSearchOperator: 'AND', + hasReference: { + type: 'foo', + id: '1', + }, + kueryNode: undefined, + }; - mockValidResponse(objects); + await findSuccess(relevantOpts, namespace); + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith(mappings, registry, relevantOpts); + }); + + it(`accepts KQL filter and passes kueryNode to getSearchDsl`, async () => { + const findOpts = { + namespace, + search: 'foo*', + searchFields: ['foo'], + type: ['dashboard'], + sortField: 'name', + sortOrder: 'desc', + defaultSearchOperator: 'AND', + hasReference: { + type: 'foo', + id: '1', + }, + indexPattern: undefined, + filter: 'dashboard.attributes.otherField: *', + }; + + await findSuccess(findOpts, namespace); + const { kueryNode } = getSearchDslNS.getSearchDsl.mock.calls[0][2]; + expect(kueryNode).toMatchInlineSnapshot(` + Object { + "arguments": Array [ + Object { + "type": "literal", + "value": "dashboard.otherField", + }, + Object { + "type": "wildcard", + "value": "@kuery-wildcard@", + }, + Object { + "type": "literal", + "value": false, + }, + ], + "function": "is", + "type": "function", + } + `); + }); - await savedObjectsRepository.bulkUpdate(objects); + it(`supports multiple types`, async () => { + const types = ['config', 'index-pattern']; + await findSuccess({ type: types }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith( + mappings, + registry, + expect.objectContaining({ + type: types, + }) + ); + }); - const [ - , - { - body: [{ update: firstUpdate }, , { update: secondUpdate }], - }, - ] = callAdminCluster.mock.calls[0]; + it(`filters out invalid types`, async () => { + const types = ['config', 'unknownType', 'index-pattern']; + await findSuccess({ type: types }); - expect(firstUpdate).toMatchObject({ - if_seq_no: 100, - if_primary_term: 200, + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith( + mappings, + registry, + expect.objectContaining({ + type: ['config', 'index-pattern'], + }) + ); }); - expect(secondUpdate).toMatchObject({ - if_seq_no: 300, - if_primary_term: 400, + it(`filters out hidden types`, async () => { + const types = ['config', HIDDEN_TYPE, 'index-pattern']; + await findSuccess({ type: types }); + + expect(getSearchDslNS.getSearchDsl).toHaveBeenCalledWith( + mappings, + registry, + expect.objectContaining({ + type: ['config', 'index-pattern'], + }) + ); }); }); + }); - it('does not pass references if omitted', async () => { - const objects = [ - { - type: 'index-pattern', - id: `logstash-no-ref`, - attributes: { title: `Testing no-ref` }, - }, - ]; + describe('#get', () => { + const type = 'index-pattern'; + const id = 'logstash-*'; + const namespace = 'foo-namespace'; + + const getSuccess = async (type, id, options) => { + const response = getMockGetResponse({ type, id, namespace: options?.namespace }); + callAdminCluster.mockResolvedValue(response); + const result = await savedObjectsRepository.get(type, id, options); + expect(callAdminCluster).toHaveBeenCalledTimes(1); + return result; + }; - mockValidResponse(objects); + describe('cluster calls', () => { + it(`should use the ES get action`, async () => { + await getSuccess(type, id); + expectClusterCalls('get'); + }); - await savedObjectsRepository.bulkUpdate(objects); + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + await getSuccess(type, id, { namespace }); + expectClusterCallArgs({ id: `${namespace}:${type}:${id}` }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + await getSuccess(type, id); + expectClusterCallArgs({ id: `${type}:${id}` }); + }); - const [ - , - { - body: [, { doc: firstDoc }], - }, - ] = callAdminCluster.mock.calls[0]; + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + await getSuccess(NAMESPACE_AGNOSTIC_TYPE, id, { namespace }); + expectClusterCallArgs({ id: `${NAMESPACE_AGNOSTIC_TYPE}:${id}` }); - expect(firstDoc).not.toMatchObject({ - references: [], + callAdminCluster.mockReset(); + await getSuccess(MULTI_NAMESPACE_TYPE, id, { namespace }); + expectClusterCallArgs({ id: `${MULTI_NAMESPACE_TYPE}:${id}` }); }); }); - it('passes references if they are provided', async () => { - const objects = [ - generateSavedObject({ - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], - }), - ]; + describe('errors', () => { + const expectNotFoundError = async (type, id, options) => { + await expect(savedObjectsRepository.get(type, id, options)).rejects.toThrowError( + createGenericNotFoundError(type, id) + ); + }; - mockValidResponse(objects); + it(`throws when type is invalid`, async () => { + await expectNotFoundError('unknownType', id); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - await savedObjectsRepository.bulkUpdate(objects); + it(`throws when type is hidden`, async () => { + await expectNotFoundError(HIDDEN_TYPE, id); + expect(callAdminCluster).not.toHaveBeenCalled(); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`throws when ES is unable to find the document during get`, async () => { + callAdminCluster.mockResolvedValue({ found: false }); + await expectNotFoundError(type, id); + expectClusterCalls('get'); + }); - const [ - , - { - body: [, { doc }], - }, - ] = callAdminCluster.mock.calls[0]; + it(`throws when ES is unable to find the index during get`, async () => { + callAdminCluster.mockResolvedValue({ status: 404 }); + await expectNotFoundError(type, id); + expectClusterCalls('get'); + }); - expect(doc).toMatchObject({ - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], + it(`throws when type is multi-namespace and the document exists, but not in this namespace`, async () => { + const response = getMockGetResponse({ type: MULTI_NAMESPACE_TYPE, id, namespace }); + callAdminCluster.mockResolvedValue(response); + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id, { namespace: 'bar-namespace' }); + expectClusterCalls('get'); }); }); - it('passes empty references array if empty references array is provided', async () => { - const objects = [ - { - type: 'index-pattern', - id: `logstash-no-ref`, - attributes: { title: `Testing no-ref` }, - references: [], - }, - ]; - - mockValidResponse(objects); - - await savedObjectsRepository.bulkUpdate(objects); + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect(getSuccess(type, id)).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); + }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + describe('returns', () => { + it(`formats the ES response`, async () => { + const result = await getSuccess(type, id); + expect(result).toEqual({ + id, + type, + updated_at: mockTimestamp, + version: mockVersion, + attributes: { + title: 'Testing', + }, + references: [], + }); + }); - const [ - , - { - body: [, { doc }], - }, - ] = callAdminCluster.mock.calls[0]; + it(`includes namespaces if type is multi-namespace`, async () => { + const result = await getSuccess(MULTI_NAMESPACE_TYPE, id); + expect(result).toMatchObject({ + namespaces: expect.any(Array), + }); + }); - expect(doc).toMatchObject({ - references: [], + it(`doesn't include namespaces if type is not multi-namespace`, async () => { + const result = await getSuccess(type, id); + expect(result).not.toMatchObject({ + namespaces: expect.anything(), + }); }); }); + }); - it('defaults to a refresh setting of `wait_for`', async () => { - const objects = [ - { - type: 'index-pattern', - id: `logstash-no-ref`, - attributes: { title: `Testing no-ref` }, - references: [], + describe('#incrementCounter', () => { + const type = 'config'; + const id = 'one'; + const field = 'buildNum'; + const namespace = 'foo-namespace'; + + const incrementCounterSuccess = async (type, id, field, options) => { + const isMultiNamespace = registry.isMultiNamespace(type); + if (isMultiNamespace) { + const response = getMockGetResponse({ type, id, namespace: options?.namespace }); + callAdminCluster.mockResolvedValueOnce(response); // this._callCluster('get', ...) + } + callAdminCluster.mockImplementation((method, params) => ({ + _id: params.id, + ...mockVersionProps, + _index: '.kibana', + get: { + found: true, + _source: { + type, + ...mockTimestampFields, + [type]: { + [field]: 8468, + defaultIndex: 'logstash-*', + }, + }, }, - ]; - - mockValidResponse(objects); + })); + const result = await savedObjectsRepository.incrementCounter(type, id, field, options); + expect(callAdminCluster).toHaveBeenCalledTimes(isMultiNamespace ? 2 : 1); + return result; + }; - await savedObjectsRepository.bulkUpdate(objects); + describe('cluster calls', () => { + it(`should use the ES update action if type is not multi-namespace`, async () => { + await incrementCounterSuccess(type, id, field, { namespace }); + expectClusterCalls('update'); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`should use the ES get action then update action if type is multi-namespace, ID is defined, and overwrite=true`, async () => { + await incrementCounterSuccess(MULTI_NAMESPACE_TYPE, id, field, { namespace }); + expectClusterCalls('get', 'update'); + }); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ refresh: 'wait_for' }); - }); + it(`defaults to a refresh setting of wait_for`, async () => { + await incrementCounterSuccess(type, id, field, { namespace }); + expectClusterCallArgs({ refresh: 'wait_for' }); + }); - it('accepts a custom refresh setting', async () => { - const objects = [ - { - type: 'index-pattern', - id: `logstash-no-ref`, - attributes: { title: `Testing no-ref` }, - references: [], - }, - ]; + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await incrementCounterSuccess(type, id, field, { namespace, refresh }); + expectClusterCallArgs({ refresh }); + }); - mockValidResponse(objects); + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + await incrementCounterSuccess(type, id, field, { namespace }); + expectClusterCallArgs({ id: `${namespace}:${type}:${id}` }); + }); - await savedObjectsRepository.bulkUpdate(objects, { refresh: true }); + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + await incrementCounterSuccess(type, id, field); + expectClusterCallArgs({ id: `${type}:${id}` }); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + await incrementCounterSuccess(NAMESPACE_AGNOSTIC_TYPE, id, field, { namespace }); + expectClusterCallArgs({ id: `${NAMESPACE_AGNOSTIC_TYPE}:${id}` }); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ refresh: true }); + callAdminCluster.mockReset(); + await incrementCounterSuccess(MULTI_NAMESPACE_TYPE, id, field, { namespace }); + expectClusterCallArgs({ id: `${MULTI_NAMESPACE_TYPE}:${id}` }); + }); }); - it(`prepends namespace to the id but doesn't add namespace to body when providing namespace for namespaced type`, async () => { - const objects = [generateSavedObject(), generateSavedObject()]; + describe('errors', () => { + const expectUnsupportedTypeError = async (type, id, field) => { + await expect(savedObjectsRepository.incrementCounter(type, id, field)).rejects.toThrowError( + createUnsupportedTypeError(type) + ); + }; - mockValidResponse(objects); + it(`throws when type is not a string`, async () => { + const test = async type => { + await expect( + savedObjectsRepository.incrementCounter(type, id, field) + ).rejects.toThrowError(`"type" argument must be a string`); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; - await savedObjectsRepository.bulkUpdate(objects, { - namespace: 'foo-namespace', + await test(null); + await test(42); + await test(false); + await test({}); }); - const [ - , - { - body: [ - { update: firstUpdate }, - { doc: firstUpdateDoc }, - { update: secondUpdate }, - { doc: secondUpdateDoc }, - ], - }, - ] = callAdminCluster.mock.calls[0]; + it(`throws when counterFieldName is not a string`, async () => { + const test = async field => { + await expect( + savedObjectsRepository.incrementCounter(type, id, field) + ).rejects.toThrowError(`"counterFieldName" argument must be a string`); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; - expect(firstUpdate).toMatchObject({ - _id: 'foo-namespace:index-pattern:logstash-1', - _index: '.kibana-test', + await test(null); + await test(42); + await test(false); + await test({}); }); - expect(firstUpdateDoc).toMatchObject({ - updated_at: mockTimestamp, - 'index-pattern': { title: 'Testing 1' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], + it(`throws when type is invalid`, async () => { + await expectUnsupportedTypeError('unknownType', id, field); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - expect(secondUpdate).toMatchObject({ - _id: 'foo-namespace:index-pattern:logstash-2', - _index: '.kibana-test', + it(`throws when type is hidden`, async () => { + await expectUnsupportedTypeError(HIDDEN_TYPE, id, field); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - expect(secondUpdateDoc).toMatchObject({ - updated_at: mockTimestamp, - 'index-pattern': { title: 'Testing 2' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], + it(`throws when there is a conflict with an existing multi-namespace saved object (get)`, async () => { + const response = getMockGetResponse({ + type: MULTI_NAMESPACE_TYPE, + id, + namespace: 'bar-namespace', + }); + callAdminCluster.mockResolvedValue(response); // this._callCluster('get', ...) + await expect( + savedObjectsRepository.incrementCounter(MULTI_NAMESPACE_TYPE, id, field, { namespace }) + ).rejects.toThrowError(createConflictError(MULTI_NAMESPACE_TYPE, id)); + expectClusterCalls('get'); }); }); - it(`doesn't prepend namespace to the id or add namespace property when providing no namespace for namespaced type`, async () => { - const objects = [generateSavedObject(), generateSavedObject()]; - - mockValidResponse(objects); + describe('migration', () => { + beforeEach(() => { + migrator.migrateDocument.mockImplementation(mockMigrateDocument); + }); - await savedObjectsRepository.bulkUpdate(objects); + it(`waits until migrations are complete before proceeding`, async () => { + migrator.runMigrations = jest.fn(async () => + expect(callAdminCluster).not.toHaveBeenCalled() + ); + await expect( + incrementCounterSuccess(type, id, field, { namespace }) + ).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveBeenCalledTimes(1); + }); - const [ - , - { - body: [ - { update: firstUpdate }, - { doc: firstUpdateDoc }, - { update: secondUpdate }, - { doc: secondUpdateDoc }, - ], - }, - ] = callAdminCluster.mock.calls[0]; + it(`migrates a document and serializes the migrated doc`, async () => { + const migrationVersion = mockMigrationVersion; + await incrementCounterSuccess(type, id, field, { migrationVersion }); + const attributes = { buildNum: 1 }; // this is added by the incrementCounter function + const doc = { type, id, attributes, migrationVersion, ...mockTimestampFields }; + expectMigrationArgs(doc); - expect(firstUpdate).toMatchObject({ - _id: 'index-pattern:logstash-1', - _index: '.kibana-test', + const migratedDoc = migrator.migrateDocument(doc); + expect(serializer.savedObjectToRaw).toHaveBeenLastCalledWith(migratedDoc); }); + }); - expect(firstUpdateDoc).toMatchObject({ - updated_at: mockTimestamp, - 'index-pattern': { title: 'Testing 1' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', + describe('returns', () => { + it(`formats the ES response`, async () => { + callAdminCluster.mockImplementation((method, params) => ({ + _id: params.id, + ...mockVersionProps, + _index: '.kibana', + get: { + found: true, + _source: { + type: 'config', + ...mockTimestampFields, + config: { + buildNum: 8468, + defaultIndex: 'logstash-*', + }, + }, }, - ], - }); - - expect(secondUpdate).toMatchObject({ - _id: 'index-pattern:logstash-2', - _index: '.kibana-test', - }); + })); - expect(secondUpdateDoc).toMatchObject({ - updated_at: mockTimestamp, - 'index-pattern': { title: 'Testing 2' }, - references: [ + const response = await savedObjectsRepository.incrementCounter( + 'config', + '6.0.0-alpha1', + 'buildNum', { - name: 'ref_0', - type: 'test', - id: '1', + namespace: 'foo-namespace', + } + ); + + expect(response).toEqual({ + type: 'config', + id: '6.0.0-alpha1', + ...mockTimestampFields, + version: mockVersion, + attributes: { + buildNum: 8468, + defaultIndex: 'logstash-*', }, - ], + }); }); }); + }); - it(`doesn't prepend namespace to the id or add namespace property when providing namespace for namespace agnostic type`, async () => { - const objects = [ - generateSavedObject({ - type: 'globaltype', - id: 'foo', - namespace: 'foo-namespace', - }), - ]; + describe('#deleteFromNamespaces', () => { + const id = 'some-id'; + const type = MULTI_NAMESPACE_TYPE; + const namespace1 = 'default'; + const namespace2 = 'foo-namespace'; + const namespace3 = 'bar-namespace'; + + const mockGetResponse = (type, id, namespaces) => { + // mock a document that exists in two namespaces + const mockResponse = getMockGetResponse({ type, id }); + mockResponse._source.namespaces = namespaces; + callAdminCluster.mockResolvedValueOnce(mockResponse); // this._callCluster('get', ...) + }; + + const deleteFromNamespacesSuccess = async ( + type, + id, + namespaces, + currentNamespaces, + options + ) => { + mockGetResponse(type, id, currentNamespaces); // this._callCluster('get', ...) + const isDelete = currentNamespaces.every(namespace => namespaces.includes(namespace)); + callAdminCluster.mockResolvedValue({ + _id: `${type}:${id}`, + ...mockVersionProps, + result: isDelete ? 'deleted' : 'updated', + }); // this._writeToCluster('delete', ...) *or* this._writeToCluster('update', ...) + const result = await savedObjectsRepository.deleteFromNamespaces( + type, + id, + namespaces, + options + ); + expect(callAdminCluster).toHaveBeenCalledTimes(2); + return result; + }; - mockValidResponse(objects); + describe('cluster calls', () => { + describe('delete action', () => { + const deleteFromNamespacesSuccessDelete = async (expectFn, options, _type = type) => { + const test = async namespaces => { + await deleteFromNamespacesSuccess(_type, id, namespaces, namespaces, options); + expectFn(); + callAdminCluster.mockReset(); + }; + await test([namespace1]); + await test([namespace1, namespace2]); + }; + + it(`should use ES get action then delete action if the object has no namespaces remaining`, async () => { + const expectFn = () => expectClusterCalls('get', 'delete'); + await deleteFromNamespacesSuccessDelete(expectFn); + }); - await savedObjectsRepository.bulkUpdate(objects); + it(`formats the ES requests`, async () => { + const expectFn = () => { + expectClusterCallArgs({ id: `${type}:${id}` }, 1); + const versionProperties = { + if_seq_no: mockVersionProps._seq_no, + if_primary_term: mockVersionProps._primary_term, + }; + expectClusterCallArgs({ id: `${type}:${id}`, ...versionProperties }, 2); + }; + await deleteFromNamespacesSuccessDelete(expectFn); + }); - const [ - , - { - body: [{ update }, { doc }], - }, - ] = callAdminCluster.mock.calls[0]; + it(`defaults to a refresh setting of wait_for`, async () => { + await deleteFromNamespacesSuccessDelete(() => + expectClusterCallArgs({ refresh: 'wait_for' }, 2) + ); + }); - expect(update).toMatchObject({ - _id: 'globaltype:foo', - _index: '.kibana-test', - }); + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + const expectFn = () => expectClusterCallArgs({ refresh }, 2); + await deleteFromNamespacesSuccessDelete(expectFn, { refresh }); + }); - expect(doc).toMatchObject({ - updated_at: mockTimestamp, - globaltype: { title: 'Testing 1' }, - references: [ - { - name: 'ref_0', - type: 'test', - id: '1', - }, - ], + it(`should use default index`, async () => { + const expectFn = () => expectClusterCallArgs({ index: '.kibana-test' }, 2); + await deleteFromNamespacesSuccessDelete(expectFn); + }); + + it(`should use custom index`, async () => { + const expectFn = () => expectClusterCallArgs({ index: 'custom' }, 2); + await deleteFromNamespacesSuccessDelete(expectFn, {}, MULTI_NAMESPACE_CUSTOM_INDEX_TYPE); + }); }); - }); - }); - describe('#incrementCounter', () => { - beforeEach(() => { - callAdminCluster.mockImplementation((method, params) => ({ - _id: params.id, - ...mockVersionProps, - _index: '.kibana', - get: { - found: true, - _source: { - type: 'config', - ...mockTimestampFields, - config: { - buildNum: 8468, - defaultIndex: 'logstash-*', - }, - }, - }, - })); - }); + describe('update action', () => { + const deleteFromNamespacesSuccessUpdate = async (expectFn, options, _type = type) => { + const test = async remaining => { + const currentNamespaces = [namespace1].concat(remaining); + await deleteFromNamespacesSuccess(_type, id, [namespace1], currentNamespaces, options); + expectFn(); + callAdminCluster.mockReset(); + }; + await test([namespace2]); + await test([namespace2, namespace3]); + }; + + it(`should use ES get action then update action if the object has one or more namespaces remaining`, async () => { + await deleteFromNamespacesSuccessUpdate(() => expectClusterCalls('get', 'update')); + }); - it('formats Elasticsearch response', async () => { - callAdminCluster.mockImplementation((method, params) => ({ - _id: params.id, - ...mockVersionProps, - _index: '.kibana', - get: { - found: true, - _source: { - type: 'config', - ...mockTimestampFields, - config: { - buildNum: 8468, - defaultIndex: 'logstash-*', - }, - }, - }, - })); + it(`formats the ES requests`, async () => { + let ctr = 0; + const expectFn = () => { + expectClusterCallArgs({ id: `${type}:${id}` }, 1); + const namespaces = ctr++ === 0 ? [namespace2] : [namespace2, namespace3]; + const versionProperties = { + if_seq_no: mockVersionProps._seq_no, + if_primary_term: mockVersionProps._primary_term, + }; + expectClusterCallArgs( + { + id: `${type}:${id}`, + ...versionProperties, + body: { doc: { ...mockTimestampFields, namespaces } }, + }, + 2 + ); + }; + await deleteFromNamespacesSuccessUpdate(expectFn); + }); - const response = await savedObjectsRepository.incrementCounter( - 'config', - '6.0.0-alpha1', - 'buildNum', - { - namespace: 'foo-namespace', - } - ); + it(`defaults to a refresh setting of wait_for`, async () => { + const expectFn = () => expectClusterCallArgs({ refresh: 'wait_for' }, 2); + await deleteFromNamespacesSuccessUpdate(expectFn); + }); - expect(response).toEqual({ - type: 'config', - id: '6.0.0-alpha1', - ...mockTimestampFields, - version: mockVersion, - attributes: { - buildNum: 8468, - defaultIndex: 'logstash-*', - }, + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + const expectFn = () => expectClusterCallArgs({ refresh }, 2); + await deleteFromNamespacesSuccessUpdate(expectFn, { refresh }); + }); + + it(`should use default index`, async () => { + const expectFn = () => expectClusterCallArgs({ index: '.kibana-test' }, 2); + await deleteFromNamespacesSuccessUpdate(expectFn); + }); + + it(`should use custom index`, async () => { + const expectFn = () => expectClusterCallArgs({ index: 'custom' }, 2); + await deleteFromNamespacesSuccessUpdate(expectFn, {}, MULTI_NAMESPACE_CUSTOM_INDEX_TYPE); + }); }); }); - it('migrates the doc if an upsert is required', async () => { - migrator.migrateDocument = doc => { - doc.attributes.buildNum = 42; - doc.migrationVersion = { foo: '2.3.4' }; - doc.references = [{ name: 'search_0', type: 'search', id: '123' }]; - return doc; + describe('errors', () => { + const expectNotFoundError = async (type, id, namespaces, options) => { + await expect( + savedObjectsRepository.deleteFromNamespaces(type, id, namespaces, options) + ).rejects.toThrowError(createGenericNotFoundError(type, id)); + }; + const expectBadRequestError = async (type, id, namespaces, message) => { + await expect( + savedObjectsRepository.deleteFromNamespaces(type, id, namespaces) + ).rejects.toThrowError(createBadRequestError(message)); }; - await savedObjectsRepository.incrementCounter('config', 'doesnotexist', 'buildNum', { - namespace: 'foo-namespace', + it(`throws when type is invalid`, async () => { + await expectNotFoundError('unknownType', id, [namespace1, namespace2]); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - body: { - upsert: { - config: { buildNum: 42 }, - migrationVersion: { foo: '2.3.4' }, - type: 'config', - ...mockTimestampFields, - references: [{ name: 'search_0', type: 'search', id: '123' }], - }, - }, + it(`throws when type is hidden`, async () => { + await expectNotFoundError(HIDDEN_TYPE, id, [namespace1, namespace2]); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - }); - it('defaults to a refresh setting of `wait_for`', async () => { - await savedObjectsRepository.incrementCounter('config', 'doesnotexist', 'buildNum', { - namespace: 'foo-namespace', + it(`throws when type is not namespace-agnostic`, async () => { + const test = async type => { + const message = `${type} doesn't support multiple namespaces`; + await expectBadRequestError(type, id, [namespace1, namespace2], message); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; + await test('index-pattern'); + await test(NAMESPACE_AGNOSTIC_TYPE); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: 'wait_for', + it(`throws when namespaces is an empty array`, async () => { + const test = async namespaces => { + const message = 'namespaces must be a non-empty array of strings'; + await expectBadRequestError(type, id, namespaces, message); + expect(callAdminCluster).not.toHaveBeenCalled(); + }; + await test([]); }); - }); - it('accepts a custom refresh setting', async () => { - await savedObjectsRepository.incrementCounter('config', 'doesnotexist', 'buildNum', { - namespace: 'foo-namespace', - refresh: true, + it(`throws when ES is unable to find the document during get`, async () => { + callAdminCluster.mockResolvedValue({ found: false }); // this._callCluster('get', ...) + await expectNotFoundError(type, id, [namespace1, namespace2]); + expectClusterCalls('get'); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); - expect(callAdminCluster.mock.calls[0][1]).toMatchObject({ - refresh: true, + it(`throws when ES is unable to find the index during get`, async () => { + callAdminCluster.mockResolvedValue({ status: 404 }); // this._callCluster('get', ...) + await expectNotFoundError(type, id, [namespace1, namespace2]); + expectClusterCalls('get'); }); - }); - it(`prepends namespace to the id but doesn't add namespace to body when providing namespace for namespaced type`, async () => { - await savedObjectsRepository.incrementCounter('config', '6.0.0-alpha1', 'buildNum', { - namespace: 'foo-namespace', + it(`throws when the document exists, but not in this namespace`, async () => { + mockGetResponse(type, id, [namespace1]); // this._callCluster('get', ...) + await expectNotFoundError(type, id, [namespace1], { namespace: 'some-other-namespace' }); + expectClusterCalls('get'); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`throws when ES is unable to find the document during delete`, async () => { + mockGetResponse(type, id, [namespace1]); // this._callCluster('get', ...) + callAdminCluster.mockResolvedValue({ result: 'not_found' }); // this._writeToCluster('delete', ...) + await expectNotFoundError(type, id, [namespace1]); + expectClusterCalls('get', 'delete'); + }); + + it(`throws when ES is unable to find the index during delete`, async () => { + mockGetResponse(type, id, [namespace1]); // this._callCluster('get', ...) + callAdminCluster.mockResolvedValue({ error: { type: 'index_not_found_exception' } }); // this._writeToCluster('delete', ...) + await expectNotFoundError(type, id, [namespace1]); + expectClusterCalls('get', 'delete'); + }); + + it(`throws when ES returns an unexpected response`, async () => { + mockGetResponse(type, id, [namespace1]); // this._callCluster('get', ...) + callAdminCluster.mockResolvedValue({ result: 'something unexpected' }); // this._writeToCluster('delete', ...) + await expect( + savedObjectsRepository.deleteFromNamespaces(type, id, [namespace1]) + ).rejects.toThrowError('Unexpected Elasticsearch DELETE response'); + expectClusterCalls('get', 'delete'); + }); + + it(`throws when ES is unable to find the document during update`, async () => { + mockGetResponse(type, id, [namespace1, namespace2]); // this._callCluster('get', ...) + callAdminCluster.mockResolvedValue({ status: 404 }); // this._writeToCluster('update', ...) + await expectNotFoundError(type, id, [namespace1]); + expectClusterCalls('get', 'update'); + }); + }); - const requestDoc = callAdminCluster.mock.calls[0][1]; - expect(requestDoc.id).toBe('foo-namespace:config:6.0.0-alpha1'); - expect(requestDoc.body.script.params.type).toBe('config'); - expect(requestDoc.body.upsert.type).toBe('config'); - expect(requestDoc).toHaveProperty('body.upsert.config'); + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + let callAdminClusterCount = 0; + migrator.runMigrations = jest.fn(async () => + // runMigrations should resolve before callAdminCluster is initiated + expect(callAdminCluster).toHaveBeenCalledTimes(callAdminClusterCount++) + ); + await expect( + deleteFromNamespacesSuccess(type, id, [namespace1], [namespace1]) + ).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveReturnedTimes(2); + }); }); - it(`doesn't prepend namespace to the id or add namespace property when providing no namespace for namespaced type`, async () => { - await savedObjectsRepository.incrementCounter('config', '6.0.0-alpha1', 'buildNum'); + describe('returns', () => { + it(`returns an empty object on success (delete)`, async () => { + const test = async namespaces => { + const result = await deleteFromNamespacesSuccess(type, id, namespaces, namespaces); + expect(result).toEqual({}); + callAdminCluster.mockReset(); + }; + await test([namespace1]); + await test([namespace1, namespace2]); + }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`returns an empty object on success (update)`, async () => { + const test = async remaining => { + const currentNamespaces = [namespace1].concat(remaining); + const result = await deleteFromNamespacesSuccess( + type, + id, + [namespace1], + currentNamespaces + ); + expect(result).toEqual({}); + callAdminCluster.mockReset(); + }; + await test([namespace2]); + await test([namespace2, namespace3]); + }); - const requestDoc = callAdminCluster.mock.calls[0][1]; - expect(requestDoc.id).toBe('config:6.0.0-alpha1'); - expect(requestDoc.body.script.params.type).toBe('config'); - expect(requestDoc.body.upsert.type).toBe('config'); - expect(requestDoc).toHaveProperty('body.upsert.config'); + it(`succeeds when the document doesn't exist in all of the targeted namespaces`, async () => { + const namespaces = [namespace2]; + const currentNamespaces = [namespace1]; + const result = await deleteFromNamespacesSuccess(type, id, namespaces, currentNamespaces); + expect(result).toEqual({}); + }); }); + }); - it(`doesn't prepend namespace to the id or add namespace property when providing namespace for namespace agnostic type`, async () => { - callAdminCluster.mockImplementation((method, params) => ({ - _id: params.id, + describe('#update', () => { + const id = 'logstash-*'; + const type = 'index-pattern'; + const attributes = { title: 'Testing' }; + const namespace = 'foo-namespace'; + const references = [ + { + name: 'ref_0', + type: 'test', + id: '1', + }, + ]; + + const updateSuccess = async (type, id, attributes, options) => { + if (registry.isMultiNamespace(type)) { + const mockGetResponse = getMockGetResponse({ type, id, namespace: options?.namespace }); + callAdminCluster.mockResolvedValueOnce(mockGetResponse); // this._callCluster('get', ...) + } + callAdminCluster.mockResolvedValue({ + _id: `${type}:${id}`, ...mockVersionProps, - _index: '.kibana', - get: { - found: true, - _source: { - type: 'globaltype', - ...mockTimestampFields, - globaltype: { - counter: 1, - }, - }, - }, - })); + result: 'updated', + ...(registry.isMultiNamespace(type) && { + // don't need the rest of the source for test purposes, just the namespaces attribute + get: { _source: { namespaces: [options?.namespace ?? 'default'] } }, + }), + }); // this._writeToCluster('update', ...) + const result = await savedObjectsRepository.update(type, id, attributes, options); + expect(callAdminCluster).toHaveBeenCalledTimes(registry.isMultiNamespace(type) ? 2 : 1); + return result; + }; - await savedObjectsRepository.incrementCounter('globaltype', 'foo', 'counter', { - namespace: 'foo-namespace', + describe('cluster calls', () => { + it(`should use the ES get action then update action when type is multi-namespace`, async () => { + await updateSuccess(MULTI_NAMESPACE_TYPE, id, attributes); + expectClusterCalls('get', 'update'); }); - expect(callAdminCluster).toHaveBeenCalledTimes(1); + it(`should use the ES update action when type is not multi-namespace`, async () => { + await updateSuccess(type, id, attributes); + expectClusterCalls('update'); + }); - const requestDoc = callAdminCluster.mock.calls[0][1]; - expect(requestDoc.id).toBe('globaltype:foo'); - expect(requestDoc.body.script.params.type).toBe('globaltype'); - expect(requestDoc.body.upsert.type).toBe('globaltype'); - expect(requestDoc).toHaveProperty('body.upsert.globaltype'); - }); + it(`defaults to no references array`, async () => { + await updateSuccess(type, id, attributes); + expectClusterCallArgs({ + body: { doc: expect.not.objectContaining({ references: expect.anything() }) }, + }); + }); - it('should assert that the "type" and "counterFieldName" arguments are strings', () => { - expect.assertions(6); - - expect( - savedObjectsRepository.incrementCounter(null, '6.0.0-alpha1', 'buildNum', { - namespace: 'foo-namespace', - }) - ).rejects.toEqual(new Error('"type" argument must be a string')); - - expect( - savedObjectsRepository.incrementCounter(42, '6.0.0-alpha1', 'buildNum', { - namespace: 'foo-namespace', - }) - ).rejects.toEqual(new Error('"type" argument must be a string')); - - expect( - savedObjectsRepository.incrementCounter({}, '6.0.0-alpha1', 'buildNum', { - namespace: 'foo-namespace', - }) - ).rejects.toEqual(new Error('"type" argument must be a string')); - - expect( - savedObjectsRepository.incrementCounter('config', '6.0.0-alpha1', null, { - namespace: 'foo-namespace', - }) - ).rejects.toEqual(new Error('"counterFieldName" argument must be a string')); - - expect( - savedObjectsRepository.incrementCounter('config', '6.0.0-alpha1', 42, { - namespace: 'foo-namespace', - }) - ).rejects.toEqual(new Error('"counterFieldName" argument must be a string')); - - expect( - savedObjectsRepository.incrementCounter( - 'config', - '6.0.0-alpha1', - {}, - { - namespace: 'foo-namespace', - } - ) - ).rejects.toEqual(new Error('"counterFieldName" argument must be a string')); - }); - }); + it(`accepts custom references array`, async () => { + const test = async references => { + await updateSuccess(type, id, attributes, { references }); + expectClusterCallArgs({ + body: { doc: expect.objectContaining({ references }) }, + }); + callAdminCluster.mockReset(); + }; + await test(references); + await test(['string']); + await test([]); + }); + + it(`doesn't accept custom references if not an array`, async () => { + const test = async references => { + await updateSuccess(type, id, attributes, { references }); + expectClusterCallArgs({ + body: { doc: expect.not.objectContaining({ references: expect.anything() }) }, + }); + callAdminCluster.mockReset(); + }; + await test('string'); + await test(123); + await test(true); + await test(null); + }); + + it(`defaults to a refresh setting of wait_for`, async () => { + await updateSuccess(type, id, { foo: 'bar' }); + expectClusterCallArgs({ refresh: 'wait_for' }); + }); + + it(`accepts a custom refresh setting`, async () => { + const refresh = 'foo'; + await updateSuccess(type, id, { foo: 'bar' }, { refresh }); + expectClusterCallArgs({ refresh }); + }); + + it(`defaults to the version of the existing document when type is multi-namespace`, async () => { + await updateSuccess(MULTI_NAMESPACE_TYPE, id, attributes, { references }); + const versionProperties = { + if_seq_no: mockVersionProps._seq_no, + if_primary_term: mockVersionProps._primary_term, + }; + expectClusterCallArgs(versionProperties, 2); + }); + + it(`accepts version`, async () => { + await updateSuccess(type, id, attributes, { + version: encodeHitVersion({ _seq_no: 100, _primary_term: 200 }), + }); + expectClusterCallArgs({ if_seq_no: 100, if_primary_term: 200 }); + }); - describe('types on custom index', () => { - it("should error when attempting to 'update' an unsupported type", async () => { - await expect( - savedObjectsRepository.update('hiddenType', 'bogus', { title: 'some title' }) - ).rejects.toEqual(new Error('Saved object [hiddenType/bogus] not found')); - }); - }); + it(`prepends namespace to the id when providing namespace for single-namespace type`, async () => { + await updateSuccess(type, id, attributes, { namespace }); + expectClusterCallArgs({ id: expect.stringMatching(`${namespace}:${type}:${id}`) }); + }); - describe('unsupported types', () => { - it("should error when attempting to 'update' an unsupported type", async () => { - await expect( - savedObjectsRepository.update('hiddenType', 'bogus', { title: 'some title' }) - ).rejects.toEqual(new Error('Saved object [hiddenType/bogus] not found')); - }); + it(`doesn't prepend namespace to the id when providing no namespace for single-namespace type`, async () => { + await updateSuccess(type, id, attributes, { references }); + expectClusterCallArgs({ id: expect.stringMatching(`${type}:${id}`) }); + }); - it("should error when attempting to 'get' an unsupported type", async () => { - await expect(savedObjectsRepository.get('hiddenType')).rejects.toEqual( - new Error('Not Found') - ); - }); + it(`doesn't prepend namespace to the id when not using single-namespace type`, async () => { + await updateSuccess(NAMESPACE_AGNOSTIC_TYPE, id, attributes, { namespace }); + expectClusterCallArgs({ id: expect.stringMatching(`${NAMESPACE_AGNOSTIC_TYPE}:${id}`) }); - it("should return an error object when attempting to 'create' an unsupported type", async () => { - await expect( - savedObjectsRepository.create('hiddenType', { title: 'some title' }) - ).rejects.toEqual(new Error("Unsupported saved object type: 'hiddenType': Bad Request")); - }); + callAdminCluster.mockReset(); + await updateSuccess(MULTI_NAMESPACE_TYPE, id, attributes, { namespace }); + expectClusterCallArgs({ id: expect.stringMatching(`${MULTI_NAMESPACE_TYPE}:${id}`) }, 2); + }); - it("should not return hidden saved ojects when attempting to 'find' support and unsupported types", async () => { - callAdminCluster.mockReturnValue({ - hits: { - total: 1, - hits: [ - { - _id: 'one', - _source: { - updated_at: mockTimestamp, - type: 'config', - }, - references: [], - }, - ], - }, + it(`includes _sourceIncludes when type is multi-namespace`, async () => { + await updateSuccess(MULTI_NAMESPACE_TYPE, id, attributes); + expectClusterCallArgs({ _sourceIncludes: ['namespaces'] }, 2); }); - const results = await savedObjectsRepository.find({ type: ['hiddenType', 'config'] }); - expect(results).toEqual({ - total: 1, - saved_objects: [ - { - id: 'one', - references: [], - type: 'config', - updated_at: mockTimestamp, - }, - ], - page: 1, - per_page: 20, + + it(`doesn't include _sourceIncludes when type is not multi-namespace`, async () => { + await updateSuccess(type, id, attributes); + expect(callAdminCluster).toHaveBeenLastCalledWith( + expect.any(String), + expect.not.objectContaining({ + _sourceIncludes: expect.anything(), + }) + ); }); }); - it("should return empty results when attempting to 'find' an unsupported type", async () => { - callAdminCluster.mockReturnValue({ - hits: { - total: 0, - hits: [], - }, + describe('errors', () => { + const expectNotFoundError = async (type, id) => { + await expect(savedObjectsRepository.update(type, id)).rejects.toThrowError( + createGenericNotFoundError(type, id) + ); + }; + + it(`throws when type is invalid`, async () => { + await expectNotFoundError('unknownType', id); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - const results = await savedObjectsRepository.find({ type: 'hiddenType' }); - expect(results).toEqual({ - total: 0, - saved_objects: [], - page: 1, - per_page: 20, + + it(`throws when type is hidden`, async () => { + await expectNotFoundError(HIDDEN_TYPE, id); + expect(callAdminCluster).not.toHaveBeenCalled(); }); - }); - it("should return empty results when attempting to 'find' more than one unsupported types", async () => { - const findParams = { type: ['hiddenType', 'hiddenType2'] }; - callAdminCluster.mockReturnValue({ - status: 200, - hits: { - total: 0, - hits: [], - }, + it(`throws when ES is unable to find the document during get`, async () => { + callAdminCluster.mockResolvedValue({ found: false }); // this._callCluster('get', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get'); }); - const results = await savedObjectsRepository.find(findParams); - expect(results).toEqual({ - total: 0, - saved_objects: [], - page: 1, - per_page: 20, + + it(`throws when ES is unable to find the index during get`, async () => { + callAdminCluster.mockResolvedValue({ status: 404 }); // this._callCluster('get', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id); + expectClusterCalls('get'); }); - }); - it("should error when attempting to 'delete' hidden types", async () => { - await expect(savedObjectsRepository.delete('hiddenType')).rejects.toEqual( - new Error('Not Found') - ); + it(`throws when type is multi-namespace and the document exists, but not in this namespace`, async () => { + const response = getMockGetResponse({ type: MULTI_NAMESPACE_TYPE, id, namespace }); + callAdminCluster.mockResolvedValue(response); // this._callCluster('get', ...) + await expectNotFoundError(MULTI_NAMESPACE_TYPE, id, { namespace: 'bar-namespace' }); + expectClusterCalls('get'); + }); + + it(`throws when ES is unable to find the document during update`, async () => { + callAdminCluster.mockResolvedValue({ status: 404 }); // this._writeToCluster('update', ...) + await expectNotFoundError(type, id); + expectClusterCalls('update'); + }); }); - it("should error when attempting to 'bulkCreate' an unsupported type", async () => { - callAdminCluster.mockReturnValue({ - items: [ - { - index: { - _id: 'one', - _seq_no: 1, - _primary_term: 1, - _type: 'config', - attributes: { - title: 'Test One', - }, - }, - }, - ], - }); - const results = await savedObjectsRepository.bulkCreate([ - { type: 'config', id: 'one', attributes: { title: 'Test One' } }, - { type: 'hiddenType', id: 'two', attributes: { title: 'Test Two' } }, - ]); - expect(results).toEqual({ - saved_objects: [ - { - type: 'config', - id: 'one', - attributes: { title: 'Test One' }, - references: [], - version: 'WzEsMV0=', - updated_at: mockTimestamp, - }, - { - error: { - error: 'Bad Request', - message: "Unsupported saved object type: 'hiddenType': Bad Request", - statusCode: 400, - }, - id: 'two', - type: 'hiddenType', - }, - ], + describe('migration', () => { + it(`waits until migrations are complete before proceeding`, async () => { + let callAdminClusterCount = 0; + migrator.runMigrations = jest.fn(async () => + // runMigrations should resolve before callAdminCluster is initiated + expect(callAdminCluster).toHaveBeenCalledTimes(callAdminClusterCount++) + ); + await expect(updateSuccess(type, id, attributes)).resolves.toBeDefined(); + expect(migrator.runMigrations).toHaveReturnedTimes(1); }); }); - it("should error when attempting to 'incrementCounter' for an unsupported type", async () => { - await expect( - savedObjectsRepository.incrementCounter('hiddenType', 'doesntmatter', 'fieldArg') - ).rejects.toEqual(new Error("Unsupported saved object type: 'hiddenType': Bad Request")); + describe('returns', () => { + it(`returns _seq_no and _primary_term encoded as version`, async () => { + const result = await updateSuccess(type, id, attributes, { + namespace, + references, + }); + expect(result).toEqual({ + id, + type, + ...mockTimestampFields, + version: mockVersion, + attributes, + references, + }); + }); + + it(`includes namespaces if type is multi-namespace`, async () => { + const result = await updateSuccess(MULTI_NAMESPACE_TYPE, id, attributes); + expect(result).toMatchObject({ + namespaces: expect.any(Array), + }); + }); + + it(`doesn't include namespaces if type is not multi-namespace`, async () => { + const result = await updateSuccess(type, id, attributes); + expect(result).not.toMatchObject({ + namespaces: expect.anything(), + }); + }); }); }); }); diff --git a/src/core/server/saved_objects/service/lib/repository.ts b/src/core/server/saved_objects/service/lib/repository.ts index 72a7867854b60..5f17c11792763 100644 --- a/src/core/server/saved_objects/service/lib/repository.ts +++ b/src/core/server/saved_objects/service/lib/repository.ts @@ -45,6 +45,8 @@ import { SavedObjectsBulkUpdateObject, SavedObjectsBulkUpdateOptions, SavedObjectsDeleteOptions, + SavedObjectsAddToNamespacesOptions, + SavedObjectsDeleteFromNamespacesOptions, } from '../saved_objects_client'; import { SavedObject, @@ -60,20 +62,12 @@ import { validateConvertFilterToKueryNode } from './filter_utils'; // so any breaking changes to this repository are considered breaking changes to the SavedObjectsClient. // eslint-disable-next-line @typescript-eslint/consistent-type-definitions -type Left = { - tag: 'Left'; - error: T; -}; +type Left = { tag: 'Left'; error: Record }; // eslint-disable-next-line @typescript-eslint/consistent-type-definitions -type Right = { - tag: 'Right'; - value: T; -}; - -type Either = Left | Right; -const isLeft = (either: Either): either is Left => { - return either.tag === 'Left'; -}; +type Right = { tag: 'Right'; value: Record }; +type Either = Left | Right; +const isLeft = (either: Either): either is Left => either.tag === 'Left'; +const isRight = (either: Either): either is Right => either.tag === 'Right'; export interface SavedObjectsRepositoryOptions { index: string; @@ -220,8 +214,8 @@ export class SavedObjectsRepository { const { id, migrationVersion, - overwrite = false, namespace, + overwrite = false, references = [], refresh = DEFAULT_REFRESH_SETTING, } = options; @@ -230,22 +224,36 @@ export class SavedObjectsRepository { throw SavedObjectsErrorHelpers.createUnsupportedTypeError(type); } - const method = id && !overwrite ? 'create' : 'index'; const time = this._getCurrentTime(); + let savedObjectNamespace; + let savedObjectNamespaces: string[] | undefined; + + if (this._registry.isSingleNamespace(type) && namespace) { + savedObjectNamespace = namespace; + } else if (this._registry.isMultiNamespace(type)) { + if (id && overwrite) { + // we will overwrite a multi-namespace saved object if it exists; if that happens, ensure we preserve its included namespaces + savedObjectNamespaces = await this.preflightGetNamespaces(type, id, namespace); + } else { + savedObjectNamespaces = getSavedObjectNamespaces(namespace); + } + } try { const migrated = this._migrator.migrateDocument({ id, type, - namespace, + ...(savedObjectNamespace && { namespace: savedObjectNamespace }), + ...(savedObjectNamespaces && { namespaces: savedObjectNamespaces }), attributes, migrationVersion, updated_at: time, - references, + ...(Array.isArray(references) && { references }), }); const raw = this._serializer.savedObjectToRaw(migrated as SavedObjectSanitizedDoc); + const method = id && overwrite ? 'index' : 'create'; const response = await this._writeToCluster(method, { id: raw._id, index: this.getIndexForType(type), @@ -282,10 +290,9 @@ export class SavedObjectsRepository { ): Promise> { const { namespace, overwrite = false, refresh = DEFAULT_REFRESH_SETTING } = options; const time = this._getCurrentTime(); - const bulkCreateParams: object[] = []; - let requestIndexCounter = 0; - const expectedResults: Array> = objects.map(object => { + let bulkGetRequestIndexCounter = 0; + const expectedResults: Either[] = objects.map(object => { if (!this._allowedTypes.includes(object.type)) { return { tag: 'Left' as 'Left', @@ -297,9 +304,73 @@ export class SavedObjectsRepository { }; } - const method = object.id && !overwrite ? 'create' : 'index'; + const method = object.id && overwrite ? 'index' : 'create'; + const requiresNamespacesCheck = + method === 'index' && this._registry.isMultiNamespace(object.type); + + return { + tag: 'Right' as 'Right', + value: { + method, + object, + ...(requiresNamespacesCheck && { esRequestIndex: bulkGetRequestIndexCounter++ }), + }, + }; + }); + + const bulkGetDocs = expectedResults + .filter(isRight) + .filter(({ value }) => value.esRequestIndex !== undefined) + .map(({ value: { object: { type, id } } }) => ({ + _id: this._serializer.generateRawId(namespace, type, id), + _index: this.getIndexForType(type), + _source: ['type', 'namespaces'], + })); + const bulkGetResponse = bulkGetDocs.length + ? await this._callCluster('mget', { + body: { + docs: bulkGetDocs, + }, + ignore: [404], + }) + : undefined; + + let bulkRequestIndexCounter = 0; + const bulkCreateParams: object[] = []; + const expectedBulkResults: Either[] = expectedResults.map(expectedBulkGetResult => { + if (isLeft(expectedBulkGetResult)) { + return expectedBulkGetResult; + } + + let savedObjectNamespace; + let savedObjectNamespaces; + const { esRequestIndex, object, method } = expectedBulkGetResult.value; + if (esRequestIndex !== undefined) { + const indexFound = bulkGetResponse.status !== 404; + const actualResult = indexFound ? bulkGetResponse.docs[esRequestIndex] : undefined; + const docFound = indexFound && actualResult.found === true; + if (docFound && !this.rawDocExistsInNamespace(actualResult, namespace)) { + const { id, type } = object; + return { + tag: 'Left' as 'Left', + error: { + id, + type, + error: SavedObjectsErrorHelpers.createConflictError(type, id).output.payload, + }, + }; + } + savedObjectNamespaces = getSavedObjectNamespaces(namespace, docFound && actualResult); + } else { + if (this._registry.isSingleNamespace(object.type)) { + savedObjectNamespace = namespace; + } else if (this._registry.isMultiNamespace(object.type)) { + savedObjectNamespaces = getSavedObjectNamespaces(namespace); + } + } + const expectedResult = { - esRequestIndex: requestIndexCounter++, + esRequestIndex: bulkRequestIndexCounter++, requestedId: object.id, rawMigratedDoc: this._serializer.savedObjectToRaw( this._migrator.migrateDocument({ @@ -307,7 +378,8 @@ export class SavedObjectsRepository { type: object.type, attributes: object.attributes, migrationVersion: object.migrationVersion, - namespace, + ...(savedObjectNamespace && { namespace: savedObjectNamespace }), + ...(savedObjectNamespaces && { namespaces: savedObjectNamespaces }), updated_at: time, references: object.references || [], }) as SavedObjectSanitizedDoc @@ -327,19 +399,21 @@ export class SavedObjectsRepository { return { tag: 'Right' as 'Right', value: expectedResult }; }); - const esResponse = await this._writeToCluster('bulk', { - refresh, - body: bulkCreateParams, - }); + const bulkResponse = bulkCreateParams.length + ? await this._writeToCluster('bulk', { + refresh, + body: bulkCreateParams, + }) + : undefined; return { - saved_objects: expectedResults.map(expectedResult => { + saved_objects: expectedBulkResults.map(expectedResult => { if (isLeft(expectedResult)) { - return expectedResult.error; + return expectedResult.error as any; } const { requestedId, rawMigratedDoc, esRequestIndex } = expectedResult.value; - const response = esResponse.items[esRequestIndex]; + const response = bulkResponse.items[esRequestIndex]; const { error, _id: responseId, @@ -348,7 +422,7 @@ export class SavedObjectsRepository { } = Object.values(response)[0] as any; const { - _source: { type, [type]: attributes, references = [] }, + _source: { type, [type]: attributes, references = [], namespaces }, } = rawMigratedDoc; const id = requestedId || responseId; @@ -362,6 +436,7 @@ export class SavedObjectsRepository { return { id, type, + ...(namespaces && { namespaces }), updated_at: time, version: encodeVersion(seqNo, primaryTerm), attributes, @@ -382,32 +457,76 @@ export class SavedObjectsRepository { */ async delete(type: string, id: string, options: SavedObjectsDeleteOptions = {}): Promise<{}> { if (!this._allowedTypes.includes(type)) { - throw SavedObjectsErrorHelpers.createGenericNotFoundError(); + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); } const { namespace, refresh = DEFAULT_REFRESH_SETTING } = options; - const response = await this._writeToCluster('delete', { - id: this._serializer.generateRawId(namespace, type, id), + const rawId = this._serializer.generateRawId(namespace, type, id); + let preflightResult: SavedObjectsRawDoc | undefined; + + if (this._registry.isMultiNamespace(type)) { + preflightResult = await this.preflightCheckIncludesNamespace(type, id, namespace); + const existingNamespaces = getSavedObjectNamespaces(undefined, preflightResult); + const remainingNamespaces = existingNamespaces?.filter( + x => x !== getNamespaceString(namespace) + ); + + if (remainingNamespaces?.length) { + // if there is 1 or more namespace remaining, update the saved object + const time = this._getCurrentTime(); + + const doc = { + updated_at: time, + namespaces: remainingNamespaces, + }; + + const updateResponse = await this._writeToCluster('update', { + id: rawId, + index: this.getIndexForType(type), + ...getExpectedVersionProperties(undefined, preflightResult), + refresh, + ignore: [404], + body: { + doc, + }, + }); + + if (updateResponse.status === 404) { + // see "404s from missing index" above + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + return {}; + } + } + + const deleteResponse = await this._writeToCluster('delete', { + id: rawId, index: this.getIndexForType(type), + ...getExpectedVersionProperties(undefined, preflightResult), refresh, ignore: [404], }); - const deleted = response.result === 'deleted'; + const deleted = deleteResponse.result === 'deleted'; if (deleted) { return {}; } - const docNotFound = response.result === 'not_found'; - const indexNotFound = response.error && response.error.type === 'index_not_found_exception'; - if (docNotFound || indexNotFound) { + const deleteDocNotFound = deleteResponse.result === 'not_found'; + const deleteIndexNotFound = + deleteResponse.error && deleteResponse.error.type === 'index_not_found_exception'; + if (deleteDocNotFound || deleteIndexNotFound) { // see "404s from missing index" above throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); } throw new Error( - `Unexpected Elasticsearch DELETE response: ${JSON.stringify({ type, id, response })}` + `Unexpected Elasticsearch DELETE response: ${JSON.stringify({ + type, + id, + response: deleteResponse, + })}` ); } @@ -426,25 +545,37 @@ export class SavedObjectsRepository { } const { refresh = DEFAULT_REFRESH_SETTING } = options; - const allTypes = Object.keys(getRootPropertiesObjects(this._mappings)); + const typesToUpdate = allTypes.filter(type => !this._registry.isNamespaceAgnostic(type)); - const typesToDelete = allTypes.filter(type => !this._registry.isNamespaceAgnostic(type)); - - const esOptions = { - index: this.getIndicesForTypes(typesToDelete), + const updateOptions = { + index: this.getIndicesForTypes(typesToUpdate), ignore: [404], refresh, body: { + script: { + source: ` + if (!ctx._source.containsKey('namespaces')) { + ctx.op = "delete"; + } else { + ctx._source['namespaces'].removeAll(Collections.singleton(params['namespace'])); + if (ctx._source['namespaces'].empty) { + ctx.op = "delete"; + } + } + `, + lang: 'painless', + params: { namespace: getNamespaceString(namespace) }, + }, conflicts: 'proceed', ...getSearchDsl(this._mappings, this._registry, { namespace, - type: typesToDelete, + type: typesToUpdate, }), }, }; - return await this._writeToCluster('deleteByQuery', esOptions); + return await this._writeToCluster('updateByQuery', updateOptions); } /** @@ -586,55 +717,77 @@ export class SavedObjectsRepository { return { saved_objects: [] }; } - const unsupportedTypeObjects = objects - .filter(o => !this._allowedTypes.includes(o.type)) - .map(({ type, id }) => { - return ({ - id, - type, - error: SavedObjectsErrorHelpers.createUnsupportedTypeError(type).output.payload, - } as any) as SavedObject; - }); + let bulkGetRequestIndexCounter = 0; + const expectedBulkGetResults: Either[] = objects.map(object => { + const { type, id, fields } = object; - const supportedTypeObjects = objects.filter(o => this._allowedTypes.includes(o.type)); + if (!this._allowedTypes.includes(type)) { + return { + tag: 'Left' as 'Left', + error: { + id, + type, + error: SavedObjectsErrorHelpers.createUnsupportedTypeError(type).output.payload, + }, + }; + } - const response = await this._callCluster('mget', { - body: { - docs: supportedTypeObjects.map(({ type, id, fields }) => { - return { - _id: this._serializer.generateRawId(namespace, type, id), - _index: this.getIndexForType(type), - _source: includedFields(type, fields), - }; - }), - }, + return { + tag: 'Right' as 'Right', + value: { + type, + id, + fields, + esRequestIndex: bulkGetRequestIndexCounter++, + }, + }; }); + const bulkGetDocs = expectedBulkGetResults + .filter(isRight) + .map(({ value: { type, id, fields } }) => ({ + _id: this._serializer.generateRawId(namespace, type, id), + _index: this.getIndexForType(type), + _source: includedFields(type, fields), + })); + const bulkGetResponse = bulkGetDocs.length + ? await this._callCluster('mget', { + body: { + docs: bulkGetDocs, + }, + ignore: [404], + }) + : undefined; + return { - saved_objects: (response.docs as any[]) - .map((doc, i) => { - const { id, type } = supportedTypeObjects[i]; + saved_objects: expectedBulkGetResults.map(expectedResult => { + if (isLeft(expectedResult)) { + return expectedResult.error as any; + } - if (!doc.found) { - return ({ - id, - type, - error: { statusCode: 404, message: 'Not found' }, - } as any) as SavedObject; - } + const { type, id, esRequestIndex } = expectedResult.value; + const doc = bulkGetResponse.docs[esRequestIndex]; - const time = doc._source.updated_at; - return { + if (!doc.found || !this.rawDocExistsInNamespace(doc, namespace)) { + return ({ id, type, - ...(time && { updated_at: time }), - version: encodeHitVersion(doc), - attributes: doc._source[type], - references: doc._source.references || [], - migrationVersion: doc._source.migrationVersion, - }; - }) - .concat(unsupportedTypeObjects), + error: SavedObjectsErrorHelpers.createGenericNotFoundError(type, id).output.payload, + } as any) as SavedObject; + } + + const time = doc._source.updated_at; + return { + id, + type, + ...(doc._source.namespaces && { namespaces: doc._source.namespaces }), + ...(time && { updated_at: time }), + version: encodeHitVersion(doc), + attributes: doc._source[type], + references: doc._source.references || [], + migrationVersion: doc._source.migrationVersion, + }; + }), }; } @@ -666,7 +819,7 @@ export class SavedObjectsRepository { const docNotFound = response.found === false; const indexNotFound = response.status === 404; - if (docNotFound || indexNotFound) { + if (docNotFound || indexNotFound || !this.rawDocExistsInNamespace(response, namespace)) { // see "404s from missing index" above throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); } @@ -676,6 +829,7 @@ export class SavedObjectsRepository { return { id, type, + ...(response._source.namespaces && { namespaces: response._source.namespaces }), ...(updatedAt && { updated_at: updatedAt }), version: encodeHitVersion(response), attributes: response._source[type], @@ -707,29 +861,32 @@ export class SavedObjectsRepository { const { version, namespace, references, refresh = DEFAULT_REFRESH_SETTING } = options; + let preflightResult: SavedObjectsRawDoc | undefined; + if (this._registry.isMultiNamespace(type)) { + preflightResult = await this.preflightCheckIncludesNamespace(type, id, namespace); + } + const time = this._getCurrentTime(); const doc = { [type]: attributes, updated_at: time, - references, + ...(Array.isArray(references) && { references }), }; - if (!Array.isArray(doc.references)) { - delete doc.references; - } - const response = await this._writeToCluster('update', { + const updateResponse = await this._writeToCluster('update', { id: this._serializer.generateRawId(namespace, type, id), index: this.getIndexForType(type), - ...(version && decodeRequestVersion(version)), + ...getExpectedVersionProperties(version, preflightResult), refresh, ignore: [404], body: { doc, }, + ...(this._registry.isMultiNamespace(type) && { _sourceIncludes: ['namespaces'] }), }); - if (response.status === 404) { + if (updateResponse.status === 404) { // see "404s from missing index" above throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); } @@ -738,12 +895,168 @@ export class SavedObjectsRepository { id, type, updated_at: time, - version: encodeHitVersion(response), + version: encodeHitVersion(updateResponse), + ...(this._registry.isMultiNamespace(type) && { + namespaces: updateResponse.get._source.namespaces, + }), references, attributes, }; } + /** + * Adds one or more namespaces to a given multi-namespace saved object. This method and + * [`deleteFromNamespaces`]{@link SavedObjectsRepository.deleteFromNamespaces} are the only ways to change which Spaces a multi-namespace + * saved object is shared to. + */ + async addToNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsAddToNamespacesOptions = {} + ): Promise<{}> { + if (!this._allowedTypes.includes(type)) { + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + + if (!this._registry.isMultiNamespace(type)) { + throw SavedObjectsErrorHelpers.createBadRequestError( + `${type} doesn't support multiple namespaces` + ); + } + + if (!namespaces.length) { + throw SavedObjectsErrorHelpers.createBadRequestError( + 'namespaces must be a non-empty array of strings' + ); + } + + const { version, namespace, refresh = DEFAULT_REFRESH_SETTING } = options; + + const rawId = this._serializer.generateRawId(undefined, type, id); + const preflightResult = await this.preflightCheckIncludesNamespace(type, id, namespace); + const existingNamespaces = getSavedObjectNamespaces(undefined, preflightResult); + // there should never be a case where a multi-namespace object does not have any existing namespaces + // however, it is a possibility if someone manually modifies the document in Elasticsearch + const time = this._getCurrentTime(); + + const doc = { + updated_at: time, + namespaces: existingNamespaces ? unique(existingNamespaces.concat(namespaces)) : namespaces, + }; + + const updateResponse = await this._writeToCluster('update', { + id: rawId, + index: this.getIndexForType(type), + ...getExpectedVersionProperties(version, preflightResult), + refresh, + ignore: [404], + body: { + doc, + }, + }); + + if (updateResponse.status === 404) { + // see "404s from missing index" above + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + + return {}; + } + + /** + * Removes one or more namespaces from a given multi-namespace saved object. If no namespaces remain, the saved object is deleted + * entirely. This method and [`addToNamespaces`]{@link SavedObjectsRepository.addToNamespaces} are the only ways to change which Spaces a + * multi-namespace saved object is shared to. + */ + async deleteFromNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsDeleteFromNamespacesOptions = {} + ): Promise<{}> { + if (!this._allowedTypes.includes(type)) { + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + + if (!this._registry.isMultiNamespace(type)) { + throw SavedObjectsErrorHelpers.createBadRequestError( + `${type} doesn't support multiple namespaces` + ); + } + + if (!namespaces.length) { + throw SavedObjectsErrorHelpers.createBadRequestError( + 'namespaces must be a non-empty array of strings' + ); + } + + const { namespace, refresh = DEFAULT_REFRESH_SETTING } = options; + + const rawId = this._serializer.generateRawId(undefined, type, id); + const preflightResult = await this.preflightCheckIncludesNamespace(type, id, namespace); + const existingNamespaces = getSavedObjectNamespaces(undefined, preflightResult); + // if there are somehow no existing namespaces, allow the operation to proceed and delete this saved object + const remainingNamespaces = existingNamespaces?.filter(x => !namespaces.includes(x)); + + if (remainingNamespaces?.length) { + // if there is 1 or more namespace remaining, update the saved object + const time = this._getCurrentTime(); + + const doc = { + updated_at: time, + namespaces: remainingNamespaces, + }; + + const updateResponse = await this._writeToCluster('update', { + id: rawId, + index: this.getIndexForType(type), + ...getExpectedVersionProperties(undefined, preflightResult), + refresh, + ignore: [404], + body: { + doc, + }, + }); + + if (updateResponse.status === 404) { + // see "404s from missing index" above + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + return {}; + } else { + // if there are no namespaces remaining, delete the saved object + const deleteResponse = await this._writeToCluster('delete', { + id: this._serializer.generateRawId(undefined, type, id), + index: this.getIndexForType(type), + ...getExpectedVersionProperties(undefined, preflightResult), + refresh, + ignore: [404], + }); + + const deleted = deleteResponse.result === 'deleted'; + if (deleted) { + return {}; + } + + const deleteDocNotFound = deleteResponse.result === 'not_found'; + const deleteIndexNotFound = + deleteResponse.error && deleteResponse.error.type === 'index_not_found_exception'; + if (deleteDocNotFound || deleteIndexNotFound) { + // see "404s from missing index" above + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + + throw new Error( + `Unexpected Elasticsearch DELETE response: ${JSON.stringify({ + type, + id, + response: deleteResponse, + })}` + ); + } + } + /** * Updates multiple objects in bulk * @@ -757,10 +1070,10 @@ export class SavedObjectsRepository { options: SavedObjectsBulkUpdateOptions = {} ): Promise> { const time = this._getCurrentTime(); - const bulkUpdateParams: object[] = []; + const { namespace } = options; - let requestIndexCounter = 0; - const expectedResults: Array> = objects.map(object => { + let bulkGetRequestIndexCounter = 0; + const expectedBulkGetResults: Either[] = objects.map(object => { const { type, id } = object; if (!this._allowedTypes.includes(type)) { @@ -775,41 +1088,100 @@ export class SavedObjectsRepository { } const { attributes, references, version } = object; - const { namespace } = options; const documentToSave = { [type]: attributes, updated_at: time, - references, + ...(Array.isArray(references) && { references }), }; - if (!Array.isArray(documentToSave.references)) { - delete documentToSave.references; - } + const requiresNamespacesCheck = this._registry.isMultiNamespace(object.type); - const expectedResult = { - type, - id, - esRequestIndex: requestIndexCounter++, - documentToSave, + return { + tag: 'Right' as 'Right', + value: { + type, + id, + version, + documentToSave, + ...(requiresNamespacesCheck && { esRequestIndex: bulkGetRequestIndexCounter++ }), + }, }; + }); - bulkUpdateParams.push( - { - update: { - _id: this._serializer.generateRawId(namespace, type, id), - _index: this.getIndexForType(type), - ...(version && decodeRequestVersion(version)), + const bulkGetDocs = expectedBulkGetResults + .filter(isRight) + .filter(({ value }) => value.esRequestIndex !== undefined) + .map(({ value: { type, id } }) => ({ + _id: this._serializer.generateRawId(namespace, type, id), + _index: this.getIndexForType(type), + _source: ['type', 'namespaces'], + })); + const bulkGetResponse = bulkGetDocs.length + ? await this._callCluster('mget', { + body: { + docs: bulkGetDocs, }, - }, - { doc: documentToSave } - ); + ignore: [404], + }) + : undefined; - return { tag: 'Right' as 'Right', value: expectedResult }; - }); + let bulkUpdateRequestIndexCounter = 0; + const bulkUpdateParams: object[] = []; + const expectedBulkUpdateResults: Either[] = expectedBulkGetResults.map( + expectedBulkGetResult => { + if (isLeft(expectedBulkGetResult)) { + return expectedBulkGetResult; + } + + const { esRequestIndex, id, type, version, documentToSave } = expectedBulkGetResult.value; + let namespaces; + let versionProperties; + if (esRequestIndex !== undefined) { + const indexFound = bulkGetResponse.status !== 404; + const actualResult = indexFound ? bulkGetResponse.docs[esRequestIndex] : undefined; + const docFound = indexFound && actualResult.found === true; + if (!docFound || !this.rawDocExistsInNamespace(actualResult, namespace)) { + return { + tag: 'Left' as 'Left', + error: { + id, + type, + error: SavedObjectsErrorHelpers.createGenericNotFoundError(type, id).output.payload, + }, + }; + } + namespaces = actualResult._source.namespaces; + versionProperties = getExpectedVersionProperties(version, actualResult); + } else { + versionProperties = getExpectedVersionProperties(version); + } + + const expectedResult = { + type, + id, + namespaces, + esRequestIndex: bulkUpdateRequestIndexCounter++, + documentToSave: expectedBulkGetResult.value.documentToSave, + }; + + bulkUpdateParams.push( + { + update: { + _id: this._serializer.generateRawId(namespace, type, id), + _index: this.getIndexForType(type), + ...versionProperties, + }, + }, + { doc: documentToSave } + ); + + return { tag: 'Right' as 'Right', value: expectedResult }; + } + ); const { refresh = DEFAULT_REFRESH_SETTING } = options; - const esResponse = bulkUpdateParams.length + const bulkUpdateResponse = bulkUpdateParams.length ? await this._writeToCluster('bulk', { refresh, body: bulkUpdateParams, @@ -817,13 +1189,13 @@ export class SavedObjectsRepository { : {}; return { - saved_objects: expectedResults.map(expectedResult => { + saved_objects: expectedBulkUpdateResults.map(expectedResult => { if (isLeft(expectedResult)) { - return expectedResult.error; + return expectedResult.error as any; } - const { type, id, documentToSave, esRequestIndex } = expectedResult.value; - const response = esResponse.items[esRequestIndex]; + const { type, id, namespaces, documentToSave, esRequestIndex } = expectedResult.value; + const response = bulkUpdateResponse.items[esRequestIndex]; const { error, _seq_no: seqNo, _primary_term: primaryTerm } = Object.values( response )[0] as any; @@ -839,6 +1211,7 @@ export class SavedObjectsRepository { return { id, type, + ...(namespaces && { namespaces }), updated_at, version: encodeVersion(seqNo, primaryTerm), attributes, @@ -877,10 +1250,20 @@ export class SavedObjectsRepository { const { migrationVersion, namespace, refresh = DEFAULT_REFRESH_SETTING } = options; const time = this._getCurrentTime(); + let savedObjectNamespace; + let savedObjectNamespaces: string[] | undefined; + + if (this._registry.isSingleNamespace(type) && namespace) { + savedObjectNamespace = namespace; + } else if (this._registry.isMultiNamespace(type)) { + savedObjectNamespaces = await this.preflightGetNamespaces(type, id, namespace); + } const migrated = this._migrator.migrateDocument({ id, type, + ...(savedObjectNamespace && { namespace: savedObjectNamespace }), + ...(savedObjectNamespaces && { namespaces: savedObjectNamespaces }), attributes: { [counterFieldName]: 1 }, migrationVersion, updated_at: time, @@ -889,7 +1272,7 @@ export class SavedObjectsRepository { const raw = this._serializer.savedObjectToRaw(migrated as SavedObjectSanitizedDoc); const response = await this._writeToCluster('update', { - id: this._serializer.generateRawId(namespace, type, id), + id: raw._id, index: this.getIndexForType(type), refresh, _source: true, @@ -952,14 +1335,13 @@ export class SavedObjectsRepository { } /** - * Returns an array of indices as specified in `this._schema` for each of the + * Returns an array of indices as specified in `this._registry` for each of the * given `types`. If any of the types don't have an associated index, the * default index `this._index` will be included. * * @param types The types whose indices should be retrieved */ private getIndicesForTypes(types: string[]) { - const unique = (array: string[]) => [...new Set(array)]; return unique(types.map(t => this.getIndexForType(t))); } @@ -975,12 +1357,97 @@ export class SavedObjectsRepository { const savedObject = this._serializer.rawToSavedObject(raw); return omit(savedObject, 'namespace'); } + + /** + * Check to ensure that a raw document exists in a namespace. If the document is not a multi-namespace type, then this returns `true` as + * we rely on the guarantees of the document ID format. If the document is a multi-namespace type, this checks to ensure that the + * document's `namespaces` value includes the string representation of the given namespace. + * + * WARNING: This should only be used for documents that were retrieved from Elasticsearch. Otherwise, the guarantees of the document ID + * format mentioned above do not apply. + */ + private rawDocExistsInNamespace(raw: SavedObjectsRawDoc, namespace?: string) { + const rawDocType = raw._source.type; + + // if the type is namespace isolated, or namespace agnostic, we can continue to rely on the guarantees + // of the document ID format and don't need to check this + if (!this._registry.isMultiNamespace(rawDocType)) { + return true; + } + + const namespaces = raw._source.namespaces; + return namespaces?.includes(getNamespaceString(namespace)) ?? false; + } + + /** + * Pre-flight check to get a multi-namespace saved object's included namespaces. This ensures that, if the saved object exists, it + * includes the target namespace. + * + * @param type The type of the saved object. + * @param id The ID of the saved object. + * @param namespace The target namespace. + * @returns Array of namespaces that this saved object currently includes, or (if the object does not exist yet) the namespaces that a + * newly-created object will include. Value may be undefined if an existing saved object has no namespaces attribute; this should not + * happen in normal operations, but it is possible if the Elasticsearch document is manually modified. + * @throws Will throw an error if the saved object exists and it does not include the target namespace. + */ + private async preflightGetNamespaces(type: string, id: string, namespace?: string) { + if (!this._registry.isMultiNamespace(type)) { + throw new Error(`Cannot make preflight get request for non-multi-namespace type '${type}'.`); + } + + const response = await this._callCluster('get', { + id: this._serializer.generateRawId(undefined, type, id), + index: this.getIndexForType(type), + ignore: [404], + }); + + const indexFound = response.status !== 404; + const docFound = indexFound && response.found === true; + if (docFound) { + if (!this.rawDocExistsInNamespace(response, namespace)) { + throw SavedObjectsErrorHelpers.createConflictError(type, id); + } + return getSavedObjectNamespaces(namespace, response); + } + return getSavedObjectNamespaces(namespace); + } + + /** + * Pre-flight check for a multi-namespace saved object's namespaces. This ensures that, if the saved object exists, it includes the target + * namespace. + * + * @param type The type of the saved object. + * @param id The ID of the saved object. + * @param namespace The target namespace. + * @returns Raw document from Elasticsearch. + * @throws Will throw an error if the saved object is not found, or if it doesn't include the target namespace. + */ + private async preflightCheckIncludesNamespace(type: string, id: string, namespace?: string) { + if (!this._registry.isMultiNamespace(type)) { + throw new Error(`Cannot make preflight get request for non-multi-namespace type '${type}'.`); + } + + const rawId = this._serializer.generateRawId(undefined, type, id); + const response = await this._callCluster('get', { + id: rawId, + index: this.getIndexForType(type), + ignore: [404], + }); + + const indexFound = response.status !== 404; + const docFound = indexFound && response.found === true; + if (!docFound || !this.rawDocExistsInNamespace(response, namespace)) { + throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } + return response as SavedObjectsRawDoc; + } } function getBulkOperationError(error: { type: string; reason?: string }, type: string, id: string) { switch (error.type) { case 'version_conflict_engine_exception': - return { statusCode: 409, message: 'version conflict, document already exists' }; + return SavedObjectsErrorHelpers.createConflictError(type, id).output.payload; case 'document_missing_exception': return SavedObjectsErrorHelpers.createGenericNotFoundError(type, id).output.payload; default: @@ -989,3 +1456,49 @@ function getBulkOperationError(error: { type: string; reason?: string }, type: s }; } } + +/** + * Returns an object with the expected version properties. This facilitates Elasticsearch's Optimistic Concurrency Control. + * + * @param version Optional version specified by the consumer. + * @param document Optional existing document that was obtained in a preflight operation. + */ +function getExpectedVersionProperties(version?: string, document?: SavedObjectsRawDoc) { + if (version) { + return decodeRequestVersion(version); + } else if (document) { + return { + if_seq_no: document._seq_no, + if_primary_term: document._primary_term, + }; + } + return {}; +} + +/** + * Returns the string representation of a namespace. + * The default namespace is undefined, and is represented by the string 'default'. + */ +function getNamespaceString(namespace?: string) { + return namespace ?? 'default'; +} + +/** + * Returns a string array of namespaces for a given saved object. If the saved object is undefined, the result is an array that contains the + * current namespace. Value may be undefined if an existing saved object has no namespaces attribute; this should not happen in normal + * operations, but it is possible if the Elasticsearch document is manually modified. + * + * @param namespace The current namespace. + * @param document Optional existing saved object that was obtained in a preflight operation. + */ +function getSavedObjectNamespaces( + namespace?: string, + document?: SavedObjectsRawDoc +): string[] | undefined { + if (document) { + return document._source?.namespaces; + } + return [getNamespaceString(namespace)]; +} + +const unique = (array: string[]) => [...new Set(array)]; diff --git a/src/core/server/saved_objects/service/lib/search_dsl/query_params.test.ts b/src/core/server/saved_objects/service/lib/search_dsl/query_params.test.ts index b2129765ee426..a72c21dd5eee4 100644 --- a/src/core/server/saved_objects/service/lib/search_dsl/query_params.test.ts +++ b/src/core/server/saved_objects/service/lib/search_dsl/query_params.test.ts @@ -17,6 +17,9 @@ * under the License. */ +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { esKuery, KueryNode } from '../../../../../../plugins/data/server'; + import { typeRegistryMock } from '../../../saved_objects_type_registry.mock'; import { getQueryParams } from './query_params'; @@ -24,1268 +27,329 @@ const registry = typeRegistryMock.create(); const MAPPINGS = { properties: { - type: { - type: 'keyword', - }, - pending: { - properties: { - title: { - type: 'text', - }, - }, - }, + pending: { properties: { title: { type: 'text' } } }, saved: { properties: { - title: { - type: 'text', - fields: { - raw: { - type: 'keyword', - }, - }, - }, - obj: { - properties: { - key1: { - type: 'text', - }, - }, - }, - }, - }, - global: { - properties: { - name: { - type: 'keyword', - }, + title: { type: 'text', fields: { raw: { type: 'keyword' } } }, + obj: { properties: { key1: { type: 'text' } } }, }, }, + // mock registry returns isMultiNamespace=true for 'shared' type + shared: { properties: { name: { type: 'keyword' } } }, + // mock registry returns isNamespaceAgnostic=true for 'global' type + global: { properties: { name: { type: 'keyword' } } }, }, }; +const ALL_TYPES = Object.keys(MAPPINGS.properties); +// get all possible subsets (combination) of all types +const ALL_TYPE_SUBSETS = ALL_TYPES.reduce( + (subsets, value) => subsets.concat(subsets.map(set => [...set, value])), + [[] as string[]] +) + .filter(x => x.length) // exclude empty set + .map(x => (x.length === 1 ? x[0] : x)); // if a subset is a single string, destructure it -// create a type clause to be used within the "should", if a namespace is specified -// the clause will ensure the namespace matches; otherwise, the clause will ensure -// that there isn't a namespace field. -const createTypeClause = (type: string, namespace?: string) => { - if (namespace) { - return { - bool: { - must: [{ term: { type } }, { term: { namespace } }], - }, - }; - } +/** + * Note: these tests cases are defined in the order they appear in the source code, for readability's sake + */ +describe('#getQueryParams', () => { + const mappings = MAPPINGS; + type Result = ReturnType; - return { - bool: { - must: [{ term: { type } }], - must_not: [{ exists: { field: 'namespace' } }], - }, - }; -}; + describe('kueryNode filter clause (query.bool.filter[...]', () => { + const expectResult = (result: Result, expected: any) => { + expect(result.query.bool.filter).toEqual(expect.arrayContaining([expected])); + }; -describe('searchDsl/queryParams', () => { - describe('no parameters', () => { - it('searches for all known types without a namespace specified', () => { - expect(getQueryParams({ mappings: MAPPINGS, registry })).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending'), - createTypeClause('saved'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - }, - }, + describe('`kueryNode` parameter', () => { + it('does not include the clause when `kueryNode` is not specified', () => { + const result = getQueryParams({ mappings, registry, kueryNode: undefined }); + expect(result.query.bool.filter).toHaveLength(1); }); - }); - }); - describe('namespace', () => { - it('filters namespaced types for namespace, and ensures namespace agnostic types have no namespace', () => { - expect(getQueryParams({ mappings: MAPPINGS, registry, namespace: 'foo-namespace' })).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending', 'foo-namespace'), - createTypeClause('saved', 'foo-namespace'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - }, - }, - }); - }); - }); + it('includes the specified Kuery clause', () => { + const test = (kueryNode: KueryNode) => { + const result = getQueryParams({ mappings, registry, kueryNode }); + const expected = esKuery.toElasticsearchQuery(kueryNode); + expect(result.query.bool.filter).toHaveLength(2); + expectResult(result, expected); + }; - describe('type (singular, namespaced)', () => { - it('includes a terms filter for type and namespace not being specified', () => { - expect( - getQueryParams({ mappings: MAPPINGS, registry, namespace: undefined, type: 'saved' }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved')], - minimum_should_match: 1, - }, - }, - ], - }, - }, - }); - }); - }); + const simpleClause = { + type: 'function', + function: 'is', + arguments: [ + { type: 'literal', value: 'global.name' }, + { type: 'literal', value: 'GLOBAL' }, + { type: 'literal', value: false }, + ], + } as KueryNode; + test(simpleClause); - describe('type (singular, global)', () => { - it('includes a terms filter for type and namespace not being specified', () => { - expect( - getQueryParams({ mappings: MAPPINGS, registry, namespace: undefined, type: 'global' }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('global')], - minimum_should_match: 1, + const complexClause = { + type: 'function', + function: 'and', + arguments: [ + simpleClause, + { + type: 'function', + function: 'not', + arguments: [ + { + type: 'function', + function: 'is', + arguments: [ + { type: 'literal', value: 'saved.obj.key1' }, + { type: 'literal', value: 'key' }, + { type: 'literal', value: true }, + ], }, - }, - ], - }, - }, + ], + }, + ], + } as KueryNode; + test(complexClause); }); }); }); - describe('type (plural, namespaced and global)', () => { - it('includes term filters for types and namespace not being specified', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: ['saved', 'global'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - }, - }, - }); - }); - }); + describe('reference filter clause (query.bool.filter[bool.must])', () => { + describe('`hasReference` parameter', () => { + const expectResult = (result: Result, expected: any) => { + expect(result.query.bool.filter).toEqual( + expect.arrayContaining([{ bool: expect.objectContaining({ must: expected }) }]) + ); + }; - describe('namespace, type (plural, namespaced and global)', () => { - it('includes a terms filter for type and namespace not being specified', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + it('does not include the clause when `hasReference` is not specified', () => { + const result = getQueryParams({ + mappings, registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved', 'foo-namespace'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - }, - }, + hasReference: undefined, + }); + expectResult(result, undefined); }); - }); - }); - describe('search', () => { - it('includes a sqs query and all known types without a namespace specified', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + it('creates a clause with query for specified reference', () => { + const hasReference = { id: 'foo', type: 'bar' }; + const result = getQueryParams({ + mappings, registry, - namespace: undefined, - type: undefined, - search: 'us*', - }) - ).toEqual({ - query: { - bool: { - filter: [ - { + hasReference, + }); + expectResult(result, [ + { + nested: { + path: 'references', + query: { bool: { - should: [ - createTypeClause('pending'), - createTypeClause('saved'), - createTypeClause('global'), + must: [ + { term: { 'references.id': hasReference.id } }, + { term: { 'references.type': hasReference.type } }, ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'us*', - lenient: true, - fields: ['*'], }, }, - ], + }, }, - }, + ]); }); }); }); - describe('namespace, search', () => { - it('includes a sqs query and namespaced types with the namespace and global types without a namespace', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: undefined, - search: 'us*', - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending', 'foo-namespace'), - createTypeClause('saved', 'foo-namespace'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'us*', - lenient: true, - fields: ['*'], - }, - }, - ], - }, - }, - }); - }); - }); + describe('type filter clauses (query.bool.filter[bool.should])', () => { + describe('`type` parameter', () => { + const expectResult = (result: Result, ...types: string[]) => { + expect(result.query.bool.filter).toEqual( + expect.arrayContaining([ + { + bool: expect.objectContaining({ + should: types.map(type => ({ + bool: expect.objectContaining({ + must: expect.arrayContaining([{ term: { type } }]), + }), + })), + minimum_should_match: 1, + }), + }, + ]) + ); + }; - describe('type (plural, namespaced and global), search', () => { - it('includes a sqs query and types without a namespace', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: ['saved', 'global'], - search: 'us*', - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'us*', - lenient: true, - fields: ['*'], - }, - }, - ], - }, - }, + it('searches for all known types when `type` is not specified', () => { + const result = getQueryParams({ mappings, registry, type: undefined }); + expectResult(result, ...ALL_TYPES); }); - }); - }); - describe('namespace, type (plural, namespaced and global), search', () => { - it('includes a sqs query and namespace type with a namespace and global type without a namespace', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - search: 'us*', - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved', 'foo-namespace'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'us*', - lenient: true, - fields: ['*'], - }, - }, - ], - }, - }, + it('searches for specified type/s', () => { + const test = (typeOrTypes: string | string[]) => { + const result = getQueryParams({ + mappings, + registry, + type: typeOrTypes, + }); + const type = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes]; + expectResult(result, ...type); + }; + for (const typeOrTypes of ALL_TYPE_SUBSETS) { + test(typeOrTypes); + } }); }); - }); - describe('search, searchFields', () => { - it('includes all types for field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: undefined, - search: 'y*', - searchFields: ['title'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending'), - createTypeClause('saved'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['pending.title', 'saved.title', 'global.title'], - }, - }, - ], - }, - }, - }); - }); - it('supports field boosting', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: undefined, - search: 'y*', - searchFields: ['title^3'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending'), - createTypeClause('saved'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['pending.title^3', 'saved.title^3', 'global.title^3'], - }, - }, - ], - }, - }, + describe('`namespace` parameter', () => { + const createTypeClause = (type: string, namespace?: string) => { + if (registry.isMultiNamespace(type)) { + return { + bool: { + must: expect.arrayContaining([{ term: { namespaces: namespace ?? 'default' } }]), + must_not: [{ exists: { field: 'namespace' } }], + }, + }; + } else if (namespace && registry.isSingleNamespace(type)) { + return { + bool: { + must: expect.arrayContaining([{ term: { namespace } }]), + must_not: [{ exists: { field: 'namespaces' } }], + }, + }; + } + // isNamespaceAgnostic + return { + bool: expect.objectContaining({ + must_not: [{ exists: { field: 'namespace' } }, { exists: { field: 'namespaces' } }], + }), + }; + }; + + const expectResult = (result: Result, ...typeClauses: any) => { + expect(result.query.bool.filter).toEqual( + expect.arrayContaining([ + { bool: expect.objectContaining({ should: typeClauses, minimum_should_match: 1 }) }, + ]) + ); + }; + + const test = (namespace?: string) => { + for (const typeOrTypes of ALL_TYPE_SUBSETS) { + const result = getQueryParams({ mappings, registry, type: typeOrTypes, namespace }); + const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes]; + expectResult(result, ...types.map(x => createTypeClause(x, namespace))); + } + // also test with no specified type/s + const result = getQueryParams({ mappings, registry, type: undefined, namespace }); + expectResult(result, ...ALL_TYPES.map(x => createTypeClause(x, namespace))); + }; + + it('filters results with "namespace" field when `namespace` is not specified', () => { + test(undefined); }); - }); - it('supports field and multi-field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: undefined, - search: 'y*', - searchFields: ['title', 'title.raw'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending'), - createTypeClause('saved'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: [ - 'pending.title', - 'saved.title', - 'global.title', - 'pending.title.raw', - 'saved.title.raw', - 'global.title.raw', - ], - }, - }, - ], - }, - }, + + it('filters results for specified namespace for appropriate type/s', () => { + test('foo-namespace'); }); }); }); - describe('namespace, search, searchFields', () => { - it('includes all types for field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + describe('search clause (query.bool.must.simple_query_string)', () => { + const search = 'foo*'; + + const expectResult = (result: Result, sqsClause: any) => { + expect(result.query.bool.must).toEqual([{ simple_query_string: sqsClause }]); + }; + + describe('`search` parameter', () => { + it('does not include clause when `search` is not specified', () => { + const result = getQueryParams({ + mappings, registry, - namespace: 'foo-namespace', - type: undefined, - search: 'y*', - searchFields: ['title'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending', 'foo-namespace'), - createTypeClause('saved', 'foo-namespace'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['pending.title', 'saved.title', 'global.title'], - }, - }, - ], - }, - }, + search: undefined, + }); + expect(result.query.bool.must).toBeUndefined(); }); - }); - it('supports field boosting', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + + it('creates a clause with query for specified search', () => { + const result = getQueryParams({ + mappings, registry, - namespace: 'foo-namespace', - type: undefined, - search: 'y*', - searchFields: ['title^3'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending', 'foo-namespace'), - createTypeClause('saved', 'foo-namespace'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['pending.title^3', 'saved.title^3', 'global.title^3'], - }, - }, - ], - }, - }, + search, + }); + expectResult(result, expect.objectContaining({ query: search })); }); }); - it('supports field and multi-field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + + describe('`searchFields` parameter', () => { + const getExpectedFields = (searchFields: string[], typeOrTypes: string | string[]) => { + const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes]; + return searchFields.map(x => types.map(y => `${y}.${x}`)).flat(); + }; + + const test = (searchFields: string[]) => { + for (const typeOrTypes of ALL_TYPE_SUBSETS) { + const result = getQueryParams({ + mappings, + registry, + type: typeOrTypes, + search, + searchFields, + }); + const fields = getExpectedFields(searchFields, typeOrTypes); + expectResult(result, expect.objectContaining({ fields })); + } + // also test with no specified type/s + const result = getQueryParams({ + mappings, registry, - namespace: 'foo-namespace', type: undefined, - search: 'y*', - searchFields: ['title', 'title.raw'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - createTypeClause('pending', 'foo-namespace'), - createTypeClause('saved', 'foo-namespace'), - createTypeClause('global'), - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: [ - 'pending.title', - 'saved.title', - 'global.title', - 'pending.title.raw', - 'saved.title.raw', - 'global.title.raw', - ], - }, - }, - ], - }, - }, - }); - }); - }); + search, + searchFields, + }); + const fields = getExpectedFields(searchFields, ALL_TYPES); + expectResult(result, expect.objectContaining({ fields })); + }; - describe('type (plural, namespaced and global), search, searchFields', () => { - it('includes all types for field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: ['saved', 'global'], - search: 'y*', - searchFields: ['title'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['saved.title', 'global.title'], - }, - }, - ], - }, - }, - }); - }); - it('supports field boosting', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: undefined, - type: ['saved', 'global'], - search: 'y*', - searchFields: ['title^3'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['saved.title^3', 'global.title^3'], - }, - }, - ], - }, - }, - }); - }); - it('supports field and multi-field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + it('includes lenient flag and all fields when `searchFields` is not specified', () => { + const result = getQueryParams({ + mappings, registry, - namespace: undefined, - type: ['saved', 'global'], - search: 'y*', - searchFields: ['title', 'title.raw'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['saved.title', 'global.title', 'saved.title.raw', 'global.title.raw'], - }, - }, - ], - }, - }, + search, + searchFields: undefined, + }); + expectResult(result, expect.objectContaining({ lenient: true, fields: ['*'] })); }); - }); - }); - describe('namespace, type (plural, namespaced and global), search, searchFields', () => { - it('includes all types for field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - search: 'y*', - searchFields: ['title'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved', 'foo-namespace'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['saved.title', 'global.title'], - }, - }, - ], - }, - }, - }); - }); - it('supports field boosting', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - search: 'y*', - searchFields: ['title^3'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved', 'foo-namespace'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['saved.title^3', 'global.title^3'], - }, - }, - ], - }, - }, - }); - }); - it('supports field and multi-field', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - search: 'y*', - searchFields: ['title', 'title.raw'], - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [createTypeClause('saved', 'foo-namespace'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['saved.title', 'global.title', 'saved.title.raw', 'global.title.raw'], - }, - }, - ], - }, - }, + it('includes specified search fields for appropriate type/s', () => { + test(['title']); }); - }); - }); - describe('type (plural, namespaced and global), search, defaultSearchOperator', () => { - it('supports defaultSearchOperator', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - search: 'foo', - searchFields: undefined, - defaultSearchOperator: 'AND', - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - minimum_should_match: 1, - should: [ - { - bool: { - must: [ - { - term: { - type: 'saved', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'global', - }, - }, - ], - must_not: [ - { - exists: { - field: 'namespace', - }, - }, - ], - }, - }, - ], - }, - }, - ], - must: [ - { - simple_query_string: { - lenient: true, - fields: ['*'], - default_operator: 'AND', - query: 'foo', - }, - }, - ], - }, - }, + it('supports boosting', () => { + test(['title^3']); }); - }); - }); - describe('type (plural, namespaced and global), hasReference', () => { - it('supports hasReference', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - type: ['saved', 'global'], - search: undefined, - searchFields: undefined, - defaultSearchOperator: 'OR', - hasReference: { - type: 'bar', - id: '1', - }, - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - must: [ - { - nested: { - path: 'references', - query: { - bool: { - must: [ - { - term: { - 'references.id': '1', - }, - }, - { - term: { - 'references.type': 'bar', - }, - }, - ], - }, - }, - }, - }, - ], - should: [createTypeClause('saved', 'foo-namespace'), createTypeClause('global')], - minimum_should_match: 1, - }, - }, - ], - }, - }, + it('supports multiple fields', () => { + test(['title, title.raw']); }); }); - }); - describe('type filter', () => { - it(' with namespace', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, - registry, - namespace: 'foo-namespace', - kueryNode: { - type: 'function', - function: 'is', - arguments: [ - { type: 'literal', value: 'global.name' }, - { type: 'literal', value: 'GLOBAL' }, - { type: 'literal', value: false }, - ], - }, - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - { - match: { - 'global.name': 'GLOBAL', - }, - }, - ], - minimum_should_match: 1, - }, - }, - { - bool: { - should: [ - { - bool: { - must: [ - { - term: { - type: 'pending', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'saved', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'global', - }, - }, - ], - must_not: [ - { - exists: { - field: 'namespace', - }, - }, - ], - }, - }, - ], - minimum_should_match: 1, - }, - }, - ], - }, - }, - }); - }); - it(' with namespace and more complex filter', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + describe('`defaultSearchOperator` parameter', () => { + it('does not include default_operator when `defaultSearchOperator` is not specified', () => { + const result = getQueryParams({ + mappings, registry, - namespace: 'foo-namespace', - kueryNode: { - type: 'function', - function: 'and', - arguments: [ - { - type: 'function', - function: 'is', - arguments: [ - { type: 'literal', value: 'global.name' }, - { type: 'literal', value: 'GLOBAL' }, - { type: 'literal', value: false }, - ], - }, - { - type: 'function', - function: 'not', - arguments: [ - { - type: 'function', - function: 'is', - arguments: [ - { type: 'literal', value: 'saved.obj.key1' }, - { type: 'literal', value: 'key' }, - { type: 'literal', value: true }, - ], - }, - ], - }, - ], - }, - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - filter: [ - { - bool: { - should: [ - { - match: { - 'global.name': 'GLOBAL', - }, - }, - ], - minimum_should_match: 1, - }, - }, - { - bool: { - must_not: { - bool: { - should: [ - { - match_phrase: { - 'saved.obj.key1': 'key', - }, - }, - ], - minimum_should_match: 1, - }, - }, - }, - }, - ], - }, - }, - { - bool: { - should: [ - { - bool: { - must: [ - { - term: { - type: 'pending', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'saved', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'global', - }, - }, - ], - must_not: [ - { - exists: { - field: 'namespace', - }, - }, - ], - }, - }, - ], - minimum_should_match: 1, - }, - }, - ], - }, - }, + search, + defaultSearchOperator: undefined, + }); + expectResult(result, expect.not.objectContaining({ default_operator: expect.anything() })); }); - }); - it(' with search and searchFields', () => { - expect( - getQueryParams({ - mappings: MAPPINGS, + + it('includes specified default operator', () => { + const defaultSearchOperator = 'AND'; + const result = getQueryParams({ + mappings, registry, - namespace: 'foo-namespace', - search: 'y*', - searchFields: ['title'], - kueryNode: { - type: 'function', - function: 'is', - arguments: [ - { type: 'literal', value: 'global.name' }, - { type: 'literal', value: 'GLOBAL' }, - { type: 'literal', value: false }, - ], - }, - }) - ).toEqual({ - query: { - bool: { - filter: [ - { - bool: { - should: [ - { - match: { - 'global.name': 'GLOBAL', - }, - }, - ], - minimum_should_match: 1, - }, - }, - { - bool: { - should: [ - { - bool: { - must: [ - { - term: { - type: 'pending', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'saved', - }, - }, - { - term: { - namespace: 'foo-namespace', - }, - }, - ], - }, - }, - { - bool: { - must: [ - { - term: { - type: 'global', - }, - }, - ], - must_not: [ - { - exists: { - field: 'namespace', - }, - }, - ], - }, - }, - ], - minimum_should_match: 1, - }, - }, - ], - must: [ - { - simple_query_string: { - query: 'y*', - fields: ['pending.title', 'saved.title', 'global.title'], - }, - }, - ], - }, - }, + search, + defaultSearchOperator, + }); + expectResult(result, expect.objectContaining({ default_operator: defaultSearchOperator })); }); }); }); diff --git a/src/core/server/saved_objects/service/lib/search_dsl/query_params.ts b/src/core/server/saved_objects/service/lib/search_dsl/query_params.ts index e6c06208ca1a5..967ce8bceaf84 100644 --- a/src/core/server/saved_objects/service/lib/search_dsl/query_params.ts +++ b/src/core/server/saved_objects/service/lib/search_dsl/query_params.ts @@ -66,18 +66,26 @@ function getClauseForType( namespace: string | undefined, type: string ) { - if (namespace && !registry.isNamespaceAgnostic(type)) { + if (registry.isMultiNamespace(type)) { + return { + bool: { + must: [{ term: { type } }, { term: { namespaces: namespace ?? 'default' } }], + must_not: [{ exists: { field: 'namespace' } }], + }, + }; + } else if (namespace && registry.isSingleNamespace(type)) { return { bool: { must: [{ term: { type } }, { term: { namespace } }], + must_not: [{ exists: { field: 'namespaces' } }], }, }; } - + // isSingleNamespace in the default namespace, or isNamespaceAgnostic return { bool: { must: [{ term: { type } }], - must_not: [{ exists: { field: 'namespace' } }], + must_not: [{ exists: { field: 'namespace' } }, { exists: { field: 'namespaces' } }], }, }; } diff --git a/src/core/server/saved_objects/service/saved_objects_client.mock.ts b/src/core/server/saved_objects/service/saved_objects_client.mock.ts index c6de9fa94291c..b209c9ca54f63 100644 --- a/src/core/server/saved_objects/service/saved_objects_client.mock.ts +++ b/src/core/server/saved_objects/service/saved_objects_client.mock.ts @@ -31,6 +31,8 @@ const create = () => find: jest.fn(), get: jest.fn(), update: jest.fn(), + addToNamespaces: jest.fn(), + deleteFromNamespaces: jest.fn(), } as unknown) as jest.Mocked); export const savedObjectsClientMock = { create }; diff --git a/src/core/server/saved_objects/service/saved_objects_client.test.js b/src/core/server/saved_objects/service/saved_objects_client.test.js index 1794d9ae86c17..53bb31369adbf 100644 --- a/src/core/server/saved_objects/service/saved_objects_client.test.js +++ b/src/core/server/saved_objects/service/saved_objects_client.test.js @@ -147,3 +147,37 @@ test(`#bulkUpdate`, async () => { }); expect(result).toBe(returnValue); }); + +test(`#addToNamespaces`, async () => { + const returnValue = Symbol(); + const mockRepository = { + addToNamespaces: jest.fn().mockResolvedValue(returnValue), + }; + const client = new SavedObjectsClient(mockRepository); + + const type = Symbol(); + const id = Symbol(); + const namespaces = Symbol(); + const options = Symbol(); + const result = await client.addToNamespaces(type, id, namespaces, options); + + expect(mockRepository.addToNamespaces).toHaveBeenCalledWith(type, id, namespaces, options); + expect(result).toBe(returnValue); +}); + +test(`#deleteFromNamespaces`, async () => { + const returnValue = Symbol(); + const mockRepository = { + deleteFromNamespaces: jest.fn().mockResolvedValue(returnValue), + }; + const client = new SavedObjectsClient(mockRepository); + + const type = Symbol(); + const id = Symbol(); + const namespaces = Symbol(); + const options = Symbol(); + const result = await client.deleteFromNamespaces(type, id, namespaces, options); + + expect(mockRepository.deleteFromNamespaces).toHaveBeenCalledWith(type, id, namespaces, options); + expect(result).toBe(returnValue); +}); diff --git a/src/core/server/saved_objects/service/saved_objects_client.ts b/src/core/server/saved_objects/service/saved_objects_client.ts index 70d69374ba8fe..8780f07cc3091 100644 --- a/src/core/server/saved_objects/service/saved_objects_client.ts +++ b/src/core/server/saved_objects/service/saved_objects_client.ts @@ -107,6 +107,26 @@ export interface SavedObjectsUpdateOptions extends SavedObjectsBaseOptions { refresh?: MutatingOperationRefreshSetting; } +/** + * + * @public + */ +export interface SavedObjectsAddToNamespacesOptions extends SavedObjectsBaseOptions { + /** An opaque version number which changes on each successful write operation. Can be used for implementing optimistic concurrency control. */ + version?: string; + /** The Elasticsearch Refresh setting for this operation */ + refresh?: MutatingOperationRefreshSetting; +} + +/** + * + * @public + */ +export interface SavedObjectsDeleteFromNamespacesOptions extends SavedObjectsBaseOptions { + /** The Elasticsearch Refresh setting for this operation */ + refresh?: MutatingOperationRefreshSetting; +} + /** * * @public @@ -270,6 +290,40 @@ export class SavedObjectsClient { return await this._repository.update(type, id, attributes, options); } + /** + * Adds namespaces to a SavedObject + * + * @param type + * @param id + * @param namespaces + * @param options + */ + async addToNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsAddToNamespacesOptions = {} + ): Promise<{}> { + return await this._repository.addToNamespaces(type, id, namespaces, options); + } + + /** + * Removes namespaces from a SavedObject + * + * @param type + * @param id + * @param namespaces + * @param options + */ + async deleteFromNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsDeleteFromNamespacesOptions = {} + ): Promise<{}> { + return await this._repository.deleteFromNamespaces(type, id, namespaces, options); + } + /** * Bulk Updates multiple SavedObject at once * diff --git a/src/core/server/saved_objects/types.ts b/src/core/server/saved_objects/types.ts index f14e9d9efb5e3..9efc82603b179 100644 --- a/src/core/server/saved_objects/types.ts +++ b/src/core/server/saved_objects/types.ts @@ -172,6 +172,19 @@ export type MutatingOperationRefreshSetting = boolean | 'wait_for'; */ export type SavedObjectsClientContract = Pick; +/** + * The namespace type dictates how a saved object can be interacted in relation to namespaces. Each type is mutually exclusive: + * * single (default): this type of saved object is namespace-isolated, e.g., it exists in only one namespace. + * * multiple: this type of saved object is shareable, e.g., it can exist in one or more namespaces. + * * agnostic: this type of saved object is global. + * + * Note: do not write logic that uses this value directly; instead, use the appropriate accessors in the + * {@link SavedObjectTypeRegistry | type registry}. + * + * @public + */ +export type SavedObjectsNamespaceType = 'single' | 'multiple' | 'agnostic'; + /** * @remarks This is only internal for now, and will only be public when we expose the registerType API * @@ -190,9 +203,14 @@ export interface SavedObjectsType { */ hidden: boolean; /** - * Is the type global (true), or namespaced (false). + * Is the type global (true), or not (false). + * @deprecated Use `namespaceType` instead. + */ + namespaceAgnostic?: boolean; + /** + * The {@link SavedObjectsNamespaceType | namespace type} for the type. */ - namespaceAgnostic: boolean; + namespaceType?: SavedObjectsNamespaceType; /** * If defined, the type instances will be stored in the given index instead of the default one. */ @@ -329,6 +347,8 @@ export type SavedObjectLegacyMigrationFn = ( */ interface SavedObjectsLegacyTypeSchema { isNamespaceAgnostic?: boolean; + /** Cannot be used in conjunction with `isNamespaceAgnostic` */ + multiNamespace?: boolean; hidden?: boolean; indexPattern?: ((config: LegacyConfig) => string) | string; convertToAliasScript?: string; diff --git a/src/core/server/saved_objects/utils.test.ts b/src/core/server/saved_objects/utils.test.ts index 0719fe7138e8a..64bdf1771decc 100644 --- a/src/core/server/saved_objects/utils.test.ts +++ b/src/core/server/saved_objects/utils.test.ts @@ -84,6 +84,16 @@ describe('convertLegacyTypes', () => { }, { pluginId: 'pluginB', + properties: { + typeB: { + properties: { + fieldB: { type: 'text' }, + }, + }, + }, + }, + { + pluginId: 'pluginC', properties: { typeC: { properties: { @@ -92,6 +102,16 @@ describe('convertLegacyTypes', () => { }, }, }, + { + pluginId: 'pluginD', + properties: { + typeD: { + properties: { + fieldD: { type: 'text' }, + }, + }, + }, + }, ], savedObjectMigrations: {}, savedObjectSchemas: { @@ -100,6 +120,18 @@ describe('convertLegacyTypes', () => { hidden: true, isNamespaceAgnostic: true, }, + typeB: { + indexPattern: 'barBaz', + hidden: false, + multiNamespace: true, + }, + typeD: { + indexPattern: 'bazQux', + hidden: false, + // if both isNamespaceAgnostic and multiNamespace are true, the resulting namespaceType is 'agnostic' + isNamespaceAgnostic: true, + multiNamespace: true, + }, }, savedObjectValidations: {}, savedObjectsManagement: {}, @@ -372,29 +404,56 @@ describe('convertTypesToLegacySchema', () => { { name: 'typeA', hidden: false, - namespaceAgnostic: true, + namespaceType: 'agnostic', mappings: { properties: {} }, convertToAliasScript: 'some script', }, { name: 'typeB', hidden: true, - namespaceAgnostic: false, + namespaceType: 'single', indexPattern: 'myIndex', mappings: { properties: {} }, }, + { + name: 'typeC', + hidden: false, + namespaceType: 'multiple', + mappings: { properties: {} }, + }, + // deprecated test case + { + name: 'typeD', + hidden: false, + namespaceAgnostic: true, + namespaceType: 'multiple', // if namespaceAgnostic and namespaceType are both set, namespaceAgnostic takes precedence + mappings: { properties: {} }, + }, ]; expect(convertTypesToLegacySchema(types)).toEqual({ typeA: { hidden: false, isNamespaceAgnostic: true, + multiNamespace: false, convertToAliasScript: 'some script', }, typeB: { hidden: true, isNamespaceAgnostic: false, + multiNamespace: false, indexPattern: 'myIndex', }, + typeC: { + hidden: false, + isNamespaceAgnostic: false, + multiNamespace: true, + }, + // deprecated test case + typeD: { + hidden: false, + isNamespaceAgnostic: true, + multiNamespace: false, + }, }); }); }); diff --git a/src/core/server/saved_objects/utils.ts b/src/core/server/saved_objects/utils.ts index ea90efd8b9fbd..5348963812629 100644 --- a/src/core/server/saved_objects/utils.ts +++ b/src/core/server/saved_objects/utils.ts @@ -20,6 +20,7 @@ import { LegacyConfig } from '../legacy'; import { SavedObjectMigrationMap } from './migrations'; import { + SavedObjectsNamespaceType, SavedObjectsType, SavedObjectsLegacyUiExports, SavedObjectLegacyMigrationMap, @@ -48,10 +49,15 @@ export const convertLegacyTypes = ( const schema = savedObjectSchemas[type]; const migrations = savedObjectMigrations[type]; const management = savedObjectsManagement[type]; + const namespaceType = (schema?.isNamespaceAgnostic + ? 'agnostic' + : schema?.multiNamespace + ? 'multiple' + : 'single') as SavedObjectsNamespaceType; return { name: type, hidden: schema?.hidden ?? false, - namespaceAgnostic: schema?.isNamespaceAgnostic ?? false, + namespaceType, mappings, indexPattern: typeof schema?.indexPattern === 'function' @@ -76,7 +82,8 @@ export const convertTypesToLegacySchema = ( return { ...schema, [type.name]: { - isNamespaceAgnostic: type.namespaceAgnostic, + isNamespaceAgnostic: type.namespaceAgnostic || type.namespaceType === 'agnostic', + multiNamespace: !type.namespaceAgnostic && type.namespaceType === 'multiple', hidden: type.hidden, indexPattern: type.indexPattern, convertToAliasScript: type.convertToAliasScript, diff --git a/src/core/server/server.api.md b/src/core/server/server.api.md index f3e3b7736d8d3..a35bca7375286 100644 --- a/src/core/server/server.api.md +++ b/src/core/server/server.api.md @@ -1003,7 +1003,7 @@ export type IsAuthenticated = (request: KibanaRequest | LegacyRequest) => boolea export type ISavedObjectsRepository = Pick; // @public -export type ISavedObjectTypeRegistry = Pick; +export type ISavedObjectTypeRegistry = Omit; // @public export type IScopedClusterClient = Pick; @@ -1643,6 +1643,7 @@ export interface SavedObject { }; id: string; migrationVersion?: SavedObjectsMigrationVersion; + namespaces?: string[]; references: SavedObjectReference[]; type: string; updated_at?: string; @@ -1687,6 +1688,12 @@ export interface SavedObjectReference { type: string; } +// @public (undocumented) +export interface SavedObjectsAddToNamespacesOptions extends SavedObjectsBaseOptions { + refresh?: MutatingOperationRefreshSetting; + version?: string; +} + // Warning: (ae-forgotten-export) The symbol "SavedObjectDoc" needs to be exported by the entry point index.d.ts // Warning: (ae-forgotten-export) The symbol "Referencable" needs to be exported by the entry point index.d.ts // @@ -1754,11 +1761,13 @@ export interface SavedObjectsBulkUpdateResponse { export class SavedObjectsClient { // @internal constructor(repository: ISavedObjectsRepository); + addToNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsAddToNamespacesOptions): Promise<{}>; bulkCreate(objects: Array>, options?: SavedObjectsCreateOptions): Promise>; bulkGet(objects?: SavedObjectsBulkGetObject[], options?: SavedObjectsBaseOptions): Promise>; bulkUpdate(objects: Array>, options?: SavedObjectsBulkUpdateOptions): Promise>; create(type: string, attributes: T, options?: SavedObjectsCreateOptions): Promise>; delete(type: string, id: string, options?: SavedObjectsDeleteOptions): Promise<{}>; + deleteFromNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsDeleteFromNamespacesOptions): Promise<{}>; // (undocumented) static errors: typeof SavedObjectsErrorHelpers; // (undocumented) @@ -1839,6 +1848,11 @@ export interface SavedObjectsDeleteByNamespaceOptions extends SavedObjectsBaseOp refresh?: MutatingOperationRefreshSetting; } +// @public (undocumented) +export interface SavedObjectsDeleteFromNamespacesOptions extends SavedObjectsBaseOptions { + refresh?: MutatingOperationRefreshSetting; +} + // @public (undocumented) export interface SavedObjectsDeleteOptions extends SavedObjectsBaseOptions { refresh?: MutatingOperationRefreshSetting; @@ -1849,6 +1863,8 @@ export class SavedObjectsErrorHelpers { // (undocumented) static createBadRequestError(reason?: string): DecoratedError; // (undocumented) + static createConflictError(type: string, id: string): DecoratedError; + // (undocumented) static createEsAutoCreateIndexError(): DecoratedError; // (undocumented) static createGenericNotFoundError(type?: string | null, id?: string | null): DecoratedError; @@ -1861,6 +1877,8 @@ export class SavedObjectsErrorHelpers { // (undocumented) static decorateConflictError(error: Error, reason?: string): DecoratedError; // (undocumented) + static decorateEsCannotExecuteScriptError(error: Error, reason?: string): DecoratedError; + // (undocumented) static decorateEsUnavailableError(error: Error, reason?: string): DecoratedError; // (undocumented) static decorateForbiddenError(error: Error, reason?: string): DecoratedError; @@ -1877,6 +1895,8 @@ export class SavedObjectsErrorHelpers { // (undocumented) static isEsAutoCreateIndexError(error: Error | DecoratedError): boolean; // (undocumented) + static isEsCannotExecuteScriptError(error: Error | DecoratedError): boolean; + // (undocumented) static isEsUnavailableError(error: Error | DecoratedError): boolean; // (undocumented) static isForbiddenError(error: Error | DecoratedError): boolean; @@ -2106,6 +2126,9 @@ export interface SavedObjectsMigrationVersion { [pluginName: string]: string; } +// @public +export type SavedObjectsNamespaceType = 'single' | 'multiple' | 'agnostic'; + // @public export interface SavedObjectsRawDoc { // (undocumented) @@ -2124,6 +2147,7 @@ export interface SavedObjectsRawDoc { // @public (undocumented) export class SavedObjectsRepository { + addToNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsAddToNamespacesOptions): Promise<{}>; bulkCreate(objects: Array>, options?: SavedObjectsCreateOptions): Promise>; bulkGet(objects?: SavedObjectsBulkGetObject[], options?: SavedObjectsBaseOptions): Promise>; bulkUpdate(objects: Array>, options?: SavedObjectsBulkUpdateOptions): Promise>; @@ -2134,6 +2158,7 @@ export class SavedObjectsRepository { static createRepository(migrator: KibanaMigrator, typeRegistry: SavedObjectTypeRegistry, indexName: string, callCluster: APICaller, extraTypes?: string[], injectedConstructor?: any): ISavedObjectsRepository; delete(type: string, id: string, options?: SavedObjectsDeleteOptions): Promise<{}>; deleteByNamespace(namespace: string, options?: SavedObjectsDeleteByNamespaceOptions): Promise; + deleteFromNamespaces(type: string, id: string, namespaces: string[], options?: SavedObjectsDeleteFromNamespacesOptions): Promise<{}>; // (undocumented) find({ search, defaultSearchOperator, searchFields, hasReference, page, perPage, sortField, sortOrder, fields, namespace, type, filter, }: SavedObjectsFindOptions): Promise>; get(type: string, id: string, options?: SavedObjectsBaseOptions): Promise>; @@ -2175,7 +2200,11 @@ export class SavedObjectsSchema { // (undocumented) isHiddenType(type: string): boolean; // (undocumented) + isMultiNamespace(type: string): boolean; + // (undocumented) isNamespaceAgnostic(type: string): boolean; + // (undocumented) + isSingleNamespace(type: string): boolean; } // @public @@ -2224,7 +2253,9 @@ export interface SavedObjectsType { mappings: SavedObjectsTypeMappingDefinition; migrations?: SavedObjectMigrationMap; name: string; - namespaceAgnostic: boolean; + // @deprecated + namespaceAgnostic?: boolean; + namespaceType?: SavedObjectsNamespaceType; } // @public @@ -2269,7 +2300,9 @@ export class SavedObjectTypeRegistry { getType(type: string): SavedObjectsType | undefined; isHidden(type: string): boolean; isImportableAndExportable(type: string): boolean; + isMultiNamespace(type: string): boolean; isNamespaceAgnostic(type: string): boolean; + isSingleNamespace(type: string): boolean; registerType(type: SavedObjectsType): void; } diff --git a/src/core/types/saved_objects.ts b/src/core/types/saved_objects.ts index d3faab6c557cd..04aaacc3cf31a 100644 --- a/src/core/types/saved_objects.ts +++ b/src/core/types/saved_objects.ts @@ -96,4 +96,6 @@ export interface SavedObject { references: SavedObjectReference[]; /** {@inheritdoc SavedObjectsMigrationVersion} */ migrationVersion?: SavedObjectsMigrationVersion; + /** Namespace(s) that this saved object exists in. This attribute is only used for multi-namespace saved object types. */ + namespaces?: string[]; } diff --git a/test/api_integration/apis/saved_objects/bulk_create.js b/test/api_integration/apis/saved_objects/bulk_create.js index afa5153336ff7..2d77fdf266793 100644 --- a/test/api_integration/apis/saved_objects/bulk_create.js +++ b/test/api_integration/apis/saved_objects/bulk_create.js @@ -58,7 +58,9 @@ export default function({ getService }) { type: 'visualization', id: 'dd7caf20-9efd-11e7-acb3-3dab96693fab', error: { - message: 'version conflict, document already exists', + error: 'Conflict', + message: + 'Saved object [visualization/dd7caf20-9efd-11e7-acb3-3dab96693fab] conflict', statusCode: 409, }, }, diff --git a/test/api_integration/apis/saved_objects/bulk_get.js b/test/api_integration/apis/saved_objects/bulk_get.js index 984ac781d3e46..67e511f2bf548 100644 --- a/test/api_integration/apis/saved_objects/bulk_get.js +++ b/test/api_integration/apis/saved_objects/bulk_get.js @@ -80,8 +80,9 @@ export default function({ getService }) { id: 'does not exist', type: 'dashboard', error: { + error: 'Not Found', + message: 'Saved object [dashboard/does not exist] not found', statusCode: 404, - message: 'Not found', }, }, { @@ -123,24 +124,28 @@ export default function({ getService }) { id: 'dd7caf20-9efd-11e7-acb3-3dab96693fab', type: 'visualization', error: { + error: 'Not Found', + message: + 'Saved object [visualization/dd7caf20-9efd-11e7-acb3-3dab96693fab] not found', statusCode: 404, - message: 'Not found', }, }, { id: 'does not exist', type: 'dashboard', error: { + error: 'Not Found', + message: 'Saved object [dashboard/does not exist] not found', statusCode: 404, - message: 'Not found', }, }, { id: '7.0.0-alpha1', type: 'config', error: { + error: 'Not Found', + message: 'Saved object [config/7.0.0-alpha1] not found', statusCode: 404, - message: 'Not found', }, }, ], diff --git a/test/api_integration/apis/saved_objects/export.js b/test/api_integration/apis/saved_objects/export.js index fc9ab8140869c..9558e82880deb 100644 --- a/test/api_integration/apis/saved_objects/export.js +++ b/test/api_integration/apis/saved_objects/export.js @@ -170,8 +170,9 @@ export default function({ getService }) { id: '1', type: 'dashboard', error: { + error: 'Not Found', + message: 'Saved object [dashboard/1] not found', statusCode: 404, - message: 'Not found', }, }, ], diff --git a/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.test.ts b/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.test.ts index f691e62b9352a..2caf3a7055df9 100644 --- a/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.test.ts +++ b/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.test.ts @@ -10,14 +10,16 @@ import { SavedObjectsClientContract } from 'src/core/server'; import { EncryptedSavedObjectsService } from '../crypto'; import { EncryptedSavedObjectsClientWrapper } from './encrypted_saved_objects_client_wrapper'; -import { savedObjectsClientMock } from 'src/core/server/mocks'; +import { savedObjectsClientMock, savedObjectsTypeRegistryMock } from 'src/core/server/mocks'; import { encryptedSavedObjectsServiceMock } from '../crypto/index.mock'; let wrapper: EncryptedSavedObjectsClientWrapper; let mockBaseClient: jest.Mocked; +let mockBaseTypeRegistry: ReturnType; let encryptedSavedObjectsServiceMockInstance: jest.Mocked; beforeEach(() => { mockBaseClient = savedObjectsClientMock.create(); + mockBaseTypeRegistry = savedObjectsTypeRegistryMock.create(); encryptedSavedObjectsServiceMockInstance = encryptedSavedObjectsServiceMock.create([ { type: 'known-type', @@ -28,6 +30,7 @@ beforeEach(() => { wrapper = new EncryptedSavedObjectsClientWrapper({ service: encryptedSavedObjectsServiceMockInstance, baseClient: mockBaseClient, + baseTypeRegistry: mockBaseTypeRegistry, } as any); }); @@ -91,35 +94,50 @@ describe('#create', () => { ); }); - it('uses `namespace` to encrypt attributes if it is specified', async () => { - const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; - const options = { overwrite: true, namespace: 'some-namespace' }; - const mockedResponse = { - id: 'uuid-v4-id', - type: 'known-type', - attributes: { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, - references: [], - }; + describe('namespace', () => { + const doTest = async (namespace: string, expectNamespaceInDescriptor: boolean) => { + const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; + const options = { overwrite: true, namespace }; + const mockedResponse = { + id: 'uuid-v4-id', + type: 'known-type', + attributes: { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, + references: [], + }; - mockBaseClient.create.mockResolvedValue(mockedResponse); + mockBaseClient.create.mockResolvedValue(mockedResponse); - expect(await wrapper.create('known-type', attributes, options)).toEqual({ - ...mockedResponse, - attributes: { attrOne: 'one', attrThree: 'three' }, - }); + expect(await wrapper.create('known-type', attributes, options)).toEqual({ + ...mockedResponse, + attributes: { attrOne: 'one', attrThree: 'three' }, + }); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( - { type: 'known-type', id: 'uuid-v4-id', namespace: 'some-namespace' }, - { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } - ); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( + { + type: 'known-type', + id: 'uuid-v4-id', + namespace: expectNamespaceInDescriptor ? namespace : undefined, + }, + { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } + ); - expect(mockBaseClient.create).toHaveBeenCalledTimes(1); - expect(mockBaseClient.create).toHaveBeenCalledWith( - 'known-type', - { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, - { id: 'uuid-v4-id', overwrite: true, namespace: 'some-namespace' } - ); + expect(mockBaseClient.create).toHaveBeenCalledTimes(1); + expect(mockBaseClient.create).toHaveBeenCalledWith( + 'known-type', + { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, + { id: 'uuid-v4-id', overwrite: true, namespace } + ); + }; + + it('uses `namespace` to encrypt attributes if it is specified when type is single-namespace', async () => { + await doTest('some-namespace', true); + }); + + it('does not use `namespace` to encrypt attributes if it is specified when type is not single-namespace', async () => { + mockBaseTypeRegistry.isSingleNamespace.mockReturnValue(false); + await doTest('some-namespace', false); + }); }); it('fails if base client fails', async () => { @@ -190,14 +208,13 @@ describe('#bulkCreate', () => { it('fails if ID is specified for registered type', async () => { const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; - const options = { namespace: 'some-namespace' }; const bulkCreateParams = [ { id: 'some-id', type: 'known-type', attributes }, { type: 'unknown-type', attributes }, ]; - await expect(wrapper.bulkCreate(bulkCreateParams, options)).rejects.toThrowError( + await expect(wrapper.bulkCreate(bulkCreateParams)).rejects.toThrowError( 'Predefined IDs are not allowed for saved objects with encrypted attributes.' ); @@ -257,39 +274,57 @@ describe('#bulkCreate', () => { ); }); - it('uses `namespace` to encrypt attributes if it is specified', async () => { - const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; - const options = { namespace: 'some-namespace' }; - const mockedResponse = { - saved_objects: [{ id: 'uuid-v4-id', type: 'known-type', attributes, references: [] }], - }; + describe('namespace', () => { + const doTest = async (namespace: string, expectNamespaceInDescriptor: boolean) => { + const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; + const options = { namespace }; + const mockedResponse = { + saved_objects: [{ id: 'uuid-v4-id', type: 'known-type', attributes, references: [] }], + }; + + mockBaseClient.bulkCreate.mockResolvedValue(mockedResponse); + + const bulkCreateParams = [{ type: 'known-type', attributes }]; + await expect(wrapper.bulkCreate(bulkCreateParams, options)).resolves.toEqual({ + saved_objects: [ + { + ...mockedResponse.saved_objects[0], + attributes: { attrOne: 'one', attrThree: 'three' }, + }, + ], + }); - mockBaseClient.bulkCreate.mockResolvedValue(mockedResponse); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( + { + type: 'known-type', + id: 'uuid-v4-id', + namespace: expectNamespaceInDescriptor ? namespace : undefined, + }, + { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } + ); + + expect(mockBaseClient.bulkCreate).toHaveBeenCalledTimes(1); + expect(mockBaseClient.bulkCreate).toHaveBeenCalledWith( + [ + { + ...bulkCreateParams[0], + id: 'uuid-v4-id', + attributes: { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, + }, + ], + options + ); + }; - const bulkCreateParams = [{ type: 'known-type', attributes }]; - await expect(wrapper.bulkCreate(bulkCreateParams, options)).resolves.toEqual({ - saved_objects: [ - { ...mockedResponse.saved_objects[0], attributes: { attrOne: 'one', attrThree: 'three' } }, - ], + it('uses `namespace` to encrypt attributes if it is specified when type is single-namespace', async () => { + await doTest('some-namespace', true); }); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( - { type: 'known-type', id: 'uuid-v4-id', namespace: 'some-namespace' }, - { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } - ); - - expect(mockBaseClient.bulkCreate).toHaveBeenCalledTimes(1); - expect(mockBaseClient.bulkCreate).toHaveBeenCalledWith( - [ - { - ...bulkCreateParams[0], - id: 'uuid-v4-id', - attributes: { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, - }, - ], - options - ); + it('does not use `namespace` to encrypt attributes if it is specified when type is not single-namespace', async () => { + mockBaseTypeRegistry.isSingleNamespace.mockReturnValue(false); + await doTest('some-namespace', false); + }); }); it('fails if base client fails', async () => { @@ -432,63 +467,79 @@ describe('#bulkUpdate', () => { ); }); - it('uses `namespace` to encrypt attributes if it is specified', async () => { - const docs = [ - { - id: 'some-id', - type: 'known-type', - attributes: { - attrOne: 'one', - attrSecret: 'secret', - attrThree: 'three', - }, - version: 'some-version', - }, - ]; - - mockBaseClient.bulkUpdate.mockResolvedValue({ - saved_objects: docs.map(doc => ({ ...doc, references: undefined })), - }); - - await expect(wrapper.bulkUpdate(docs, { namespace: 'some-namespace' })).resolves.toEqual({ - saved_objects: [ + describe('namespace', () => { + const doTest = async (namespace: string, expectNamespaceInDescriptor: boolean) => { + const docs = [ { id: 'some-id', type: 'known-type', attributes: { attrOne: 'one', + attrSecret: 'secret', attrThree: 'three', }, version: 'some-version', - references: undefined, }, - ], - }); - - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( - { type: 'known-type', id: 'some-id', namespace: 'some-namespace' }, - { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } - ); + ]; + const options = { namespace }; + + mockBaseClient.bulkUpdate.mockResolvedValue({ + saved_objects: docs.map(doc => ({ ...doc, references: undefined })), + }); + + await expect(wrapper.bulkUpdate(docs, options)).resolves.toEqual({ + saved_objects: [ + { + id: 'some-id', + type: 'known-type', + attributes: { + attrOne: 'one', + attrThree: 'three', + }, + version: 'some-version', + references: undefined, + }, + ], + }); - expect(mockBaseClient.bulkUpdate).toHaveBeenCalledTimes(1); - expect(mockBaseClient.bulkUpdate).toHaveBeenCalledWith( - [ + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( { - id: 'some-id', type: 'known-type', - attributes: { - attrOne: 'one', - attrSecret: '*secret*', - attrThree: 'three', + id: 'some-id', + namespace: expectNamespaceInDescriptor ? namespace : undefined, + }, + { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } + ); + + expect(mockBaseClient.bulkUpdate).toHaveBeenCalledTimes(1); + expect(mockBaseClient.bulkUpdate).toHaveBeenCalledWith( + [ + { + id: 'some-id', + type: 'known-type', + attributes: { + attrOne: 'one', + attrSecret: '*secret*', + attrThree: 'three', + }, + version: 'some-version', + + references: undefined, }, - version: 'some-version', + ], + options + ); + }; - references: undefined, - }, - ], - { namespace: 'some-namespace' } - ); + it('uses `namespace` to encrypt attributes if it is specified when type is single-namespace', async () => { + await doTest('some-namespace', true); + }); + + it('does not use `namespace` to encrypt attributes if it is specified when type is not single-namespace', async () => { + mockBaseTypeRegistry.isSingleNamespace.mockReturnValue(false); + await doTest('some-namespace', false); + }); }); it('fails if base client fails', async () => { @@ -871,31 +922,46 @@ describe('#update', () => { ); }); - it('uses `namespace` to encrypt attributes if it is specified', async () => { - const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; - const options = { version: 'some-version', namespace: 'some-namespace' }; - const mockedResponse = { id: 'some-id', type: 'known-type', attributes, references: [] }; + describe('namespace', () => { + const doTest = async (namespace: string, expectNamespaceInDescriptor: boolean) => { + const attributes = { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' }; + const options = { version: 'some-version', namespace }; + const mockedResponse = { id: 'some-id', type: 'known-type', attributes, references: [] }; - mockBaseClient.update.mockResolvedValue(mockedResponse); + mockBaseClient.update.mockResolvedValue(mockedResponse); - await expect(wrapper.update('known-type', 'some-id', attributes, options)).resolves.toEqual({ - ...mockedResponse, - attributes: { attrOne: 'one', attrThree: 'three' }, - }); + await expect(wrapper.update('known-type', 'some-id', attributes, options)).resolves.toEqual({ + ...mockedResponse, + attributes: { attrOne: 'one', attrThree: 'three' }, + }); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); - expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( - { type: 'known-type', id: 'some-id', namespace: 'some-namespace' }, - { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } - ); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledTimes(1); + expect(encryptedSavedObjectsServiceMockInstance.encryptAttributes).toHaveBeenCalledWith( + { + type: 'known-type', + id: 'some-id', + namespace: expectNamespaceInDescriptor ? namespace : undefined, + }, + { attrOne: 'one', attrSecret: 'secret', attrThree: 'three' } + ); + + expect(mockBaseClient.update).toHaveBeenCalledTimes(1); + expect(mockBaseClient.update).toHaveBeenCalledWith( + 'known-type', + 'some-id', + { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, + options + ); + }; - expect(mockBaseClient.update).toHaveBeenCalledTimes(1); - expect(mockBaseClient.update).toHaveBeenCalledWith( - 'known-type', - 'some-id', - { attrOne: 'one', attrSecret: '*secret*', attrThree: 'three' }, - options - ); + it('uses `namespace` to encrypt attributes if it is specified when type is single-namespace', async () => { + await doTest('some-namespace', true); + }); + + it('does not use `namespace` to encrypt attributes if it is specified when type is not single-namespace', async () => { + mockBaseTypeRegistry.isSingleNamespace.mockReturnValue(false); + await doTest('some-namespace', false); + }); }); it('fails if base client fails', async () => { diff --git a/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.ts b/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.ts index b4f1de52c9ce3..e8197536d29d9 100644 --- a/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.ts +++ b/x-pack/plugins/encrypted_saved_objects/server/saved_objects/encrypted_saved_objects_client_wrapper.ts @@ -19,11 +19,15 @@ import { SavedObjectsFindResponse, SavedObjectsUpdateOptions, SavedObjectsUpdateResponse, + SavedObjectsAddToNamespacesOptions, + SavedObjectsDeleteFromNamespacesOptions, + ISavedObjectTypeRegistry, } from 'src/core/server'; import { EncryptedSavedObjectsService } from '../crypto'; interface EncryptedSavedObjectsClientOptions { baseClient: SavedObjectsClientContract; + baseTypeRegistry: ISavedObjectTypeRegistry; service: Readonly; } @@ -41,6 +45,10 @@ export class EncryptedSavedObjectsClientWrapper implements SavedObjectsClientCon public readonly errors = options.baseClient.errors ) {} + // only include namespace in AAD descriptor if the specified type is single-namespace + private getDescriptorNamespace = (type: string, namespace?: string) => + this.options.baseTypeRegistry.isSingleNamespace(type) ? namespace : undefined; + public async create( type: string, attributes: T = {} as T, @@ -60,11 +68,12 @@ export class EncryptedSavedObjectsClientWrapper implements SavedObjectsClientCon } const id = generateID(); + const namespace = this.getDescriptorNamespace(type, options.namespace); return this.stripEncryptedAttributesFromResponse( await this.options.baseClient.create( type, await this.options.service.encryptAttributes( - { type, id, namespace: options.namespace }, + { type, id, namespace }, attributes as Record ), { ...options, id } @@ -95,11 +104,12 @@ export class EncryptedSavedObjectsClientWrapper implements SavedObjectsClientCon } const id = generateID(); + const namespace = this.getDescriptorNamespace(object.type, options?.namespace); return { ...object, id, attributes: await this.options.service.encryptAttributes( - { type: object.type, id, namespace: options && options.namespace }, + { type: object.type, id, namespace }, object.attributes as Record ), } as SavedObjectsBulkCreateObject; @@ -124,10 +134,11 @@ export class EncryptedSavedObjectsClientWrapper implements SavedObjectsClientCon if (!this.options.service.isRegistered(type)) { return object; } + const namespace = this.getDescriptorNamespace(type, options?.namespace); return { ...object, attributes: await this.options.service.encryptAttributes( - { type, id, namespace: options && options.namespace }, + { type, id, namespace }, attributes ), }; @@ -173,20 +184,35 @@ export class EncryptedSavedObjectsClientWrapper implements SavedObjectsClientCon if (!this.options.service.isRegistered(type)) { return await this.options.baseClient.update(type, id, attributes, options); } - + const namespace = this.getDescriptorNamespace(type, options?.namespace); return this.stripEncryptedAttributesFromResponse( await this.options.baseClient.update( type, id, - await this.options.service.encryptAttributes( - { type, id, namespace: options && options.namespace }, - attributes - ), + await this.options.service.encryptAttributes({ type, id, namespace }, attributes), options ) ); } + public async addToNamespaces( + type: string, + id: string, + namespaces: string[], + options?: SavedObjectsAddToNamespacesOptions + ) { + return await this.options.baseClient.addToNamespaces(type, id, namespaces, options); + } + + public async deleteFromNamespaces( + type: string, + id: string, + namespaces: string[], + options?: SavedObjectsDeleteFromNamespacesOptions + ) { + return await this.options.baseClient.deleteFromNamespaces(type, id, namespaces, options); + } + /** * Strips encrypted attributes from any non-bulk Saved Objects API response. If type isn't * registered, response is returned as is. diff --git a/x-pack/plugins/encrypted_saved_objects/server/saved_objects/index.ts b/x-pack/plugins/encrypted_saved_objects/server/saved_objects/index.ts index c76477cd8da43..10599ae3a1798 100644 --- a/x-pack/plugins/encrypted_saved_objects/server/saved_objects/index.ts +++ b/x-pack/plugins/encrypted_saved_objects/server/saved_objects/index.ts @@ -40,7 +40,8 @@ export function setupSavedObjects({ savedObjects.addClientWrapper( Number.MAX_SAFE_INTEGER, 'encryptedSavedObjects', - ({ client: baseClient }) => new EncryptedSavedObjectsClientWrapper({ baseClient, service }) + ({ client: baseClient, typeRegistry: baseTypeRegistry }) => + new EncryptedSavedObjectsClientWrapper({ baseClient, baseTypeRegistry, service }) ); const internalRepositoryPromise = getStartServices().then(([core]) => diff --git a/x-pack/plugins/security/server/audit/audit_logger.test.ts b/x-pack/plugins/security/server/audit/audit_logger.test.ts index 01cde02b7dfdd..f7ee210a21a74 100644 --- a/x-pack/plugins/security/server/audit/audit_logger.test.ts +++ b/x-pack/plugins/security/server/audit/audit_logger.test.ts @@ -18,25 +18,46 @@ describe(`#savedObjectsAuthorizationFailure`, () => { const username = 'foo-user'; const action = 'foo-action'; const types = ['foo-type-1', 'foo-type-2']; - const missing = [`saved_object:${types[0]}/foo-action`, `saved_object:${types[1]}/foo-action`]; + const spaceIds = ['foo-space', 'bar-space']; + const missing = [ + { + spaceId: 'foo-space', + privilege: `saved_object:${types[0]}/${action}`, + }, + { + spaceId: 'foo-space', + privilege: `saved_object:${types[1]}/${action}`, + }, + ]; const args = { foo: 'bar', baz: 'quz', }; - securityAuditLogger.savedObjectsAuthorizationFailure(username, action, types, missing, args); + securityAuditLogger.savedObjectsAuthorizationFailure( + username, + action, + types, + spaceIds, + missing, + args + ); expect(auditLogger.log).toHaveBeenCalledWith( 'saved_objects_authorization_failure', - expect.stringContaining(`${username} unauthorized to ${action}`), + expect.any(String), { username, action, types, + spaceIds, missing, args, } ); + expect(auditLogger.log.mock.calls[0][1]).toMatchInlineSnapshot( + `"foo-user unauthorized to [foo-action] [foo-type-1,foo-type-2] in [foo-space,bar-space]: missing [(foo-space)saved_object:foo-type-1/foo-action,(foo-space)saved_object:foo-type-2/foo-action]"` + ); }); }); @@ -47,22 +68,27 @@ describe(`#savedObjectsAuthorizationSuccess`, () => { const username = 'foo-user'; const action = 'foo-action'; const types = ['foo-type-1', 'foo-type-2']; + const spaceIds = ['foo-space', 'bar-space']; const args = { foo: 'bar', baz: 'quz', }; - securityAuditLogger.savedObjectsAuthorizationSuccess(username, action, types, args); + securityAuditLogger.savedObjectsAuthorizationSuccess(username, action, types, spaceIds, args); expect(auditLogger.log).toHaveBeenCalledWith( 'saved_objects_authorization_success', - expect.stringContaining(`${username} authorized to ${action}`), + expect.any(String), { username, action, types, + spaceIds, args, } ); + expect(auditLogger.log.mock.calls[0][1]).toMatchInlineSnapshot( + `"foo-user authorized to [foo-action] [foo-type-1,foo-type-2] in [foo-space,bar-space]"` + ); }); }); diff --git a/x-pack/plugins/security/server/audit/audit_logger.ts b/x-pack/plugins/security/server/audit/audit_logger.ts index df8df35f97b49..40b525b5d2188 100644 --- a/x-pack/plugins/security/server/audit/audit_logger.ts +++ b/x-pack/plugins/security/server/audit/audit_logger.ts @@ -13,16 +13,23 @@ export class SecurityAuditLogger { username: string, action: string, types: string[], - missing: string[], + spaceIds: string[], + missing: Array<{ spaceId?: string; privilege: string }>, args?: Record ) { + const typesString = types.join(','); + const spacesString = spaceIds.length ? ` in [${spaceIds.join(',')}]` : ''; + const missingString = missing + .map(({ spaceId, privilege }) => `${spaceId ? `(${spaceId})` : ''}${privilege}`) + .join(','); this.getAuditLogger().log( 'saved_objects_authorization_failure', - `${username} unauthorized to ${action} ${types.join(',')}, missing ${missing.join(',')}`, + `${username} unauthorized to [${action}] [${typesString}]${spacesString}: missing [${missingString}]`, { username, action, types, + spaceIds, missing, args, } @@ -33,15 +40,19 @@ export class SecurityAuditLogger { username: string, action: string, types: string[], + spaceIds: string[], args?: Record ) { + const typesString = types.join(','); + const spacesString = spaceIds.length ? ` in [${spaceIds.join(',')}]` : ''; this.getAuditLogger().log( 'saved_objects_authorization_success', - `${username} authorized to ${action} ${types.join(',')}`, + `${username} authorized to [${action}] [${typesString}]${spacesString}`, { username, action, types, + spaceIds, args, } ); diff --git a/x-pack/plugins/security/server/authorization/__snapshots__/check_privileges.test.ts.snap b/x-pack/plugins/security/server/authorization/__snapshots__/check_privileges.test.ts.snap deleted file mode 100644 index 1212c2cd6a5cb..0000000000000 --- a/x-pack/plugins/security/server/authorization/__snapshots__/check_privileges.test.ts.snap +++ /dev/null @@ -1,27 +0,0 @@ -// Jest Snapshot v1, https://goo.gl/fbAQLP - -exports[`#atSpace throws error when checking for login and user has login but doesn't have version 1`] = `[Error: Multiple versions of Kibana are running against the same Elasticsearch cluster, unable to authorize user.]`; - -exports[`#atSpace with a malformed Elasticsearch response throws a validation error when an extra privilege is present in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_1" fails because ["saved_object:bar-type/get" is not allowed]]]]`; - -exports[`#atSpace with a malformed Elasticsearch response throws a validation error when privileges are missing in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_1" fails because [child "saved_object:foo-type/get" fails because ["saved_object:foo-type/get" is required]]]]]`; - -exports[`#atSpaces throws error when Elasticsearch returns malformed response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_1" fails because [child "mock-action:version" fails because ["mock-action:version" is required]]]]]`; - -exports[`#atSpaces throws error when checking for login and user has login but doesn't have version 1`] = `[Error: Multiple versions of Kibana are running against the same Elasticsearch cluster, unable to authorize user.]`; - -exports[`#atSpaces with a malformed Elasticsearch response throws a validation error when an a space is missing in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_2" fails because ["space:space_2" is required]]]]`; - -exports[`#atSpaces with a malformed Elasticsearch response throws a validation error when an extra privilege is present in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_2" fails because ["space:space_2" is required]]]]`; - -exports[`#atSpaces with a malformed Elasticsearch response throws a validation error when an extra space is present in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because ["space:space_3" is not allowed]]]`; - -exports[`#atSpaces with a malformed Elasticsearch response throws a validation error when privileges are missing in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_2" fails because ["space:space_2" is required]]]]`; - -exports[`#globally throws error when Elasticsearch returns malformed response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "*" fails because [child "mock-action:version" fails because ["mock-action:version" is required]]]]]`; - -exports[`#globally throws error when checking for login and user has login but doesn't have version 1`] = `[Error: Multiple versions of Kibana are running against the same Elasticsearch cluster, unable to authorize user.]`; - -exports[`#globally with a malformed Elasticsearch response throws a validation error when an extra privilege is present in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "*" fails because ["saved_object:bar-type/get" is not allowed]]]]`; - -exports[`#globally with a malformed Elasticsearch response throws a validation error when privileges are missing in the response 1`] = `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "*" fails because [child "saved_object:foo-type/get" fails because ["saved_object:foo-type/get" is required]]]]]`; diff --git a/x-pack/plugins/security/server/authorization/check_privileges.test.ts b/x-pack/plugins/security/server/authorization/check_privileges.test.ts index 8c1241937892e..a64c5d509ca11 100644 --- a/x-pack/plugins/security/server/authorization/check_privileges.test.ts +++ b/x-pack/plugins/security/server/authorization/check_privileges.test.ts @@ -31,123 +31,121 @@ const createMockClusterClient = (response: any) => { }; describe('#atSpace', () => { - const checkPrivilegesAtSpaceTest = ( - description: string, - options: { - spaceId: string; - privilegeOrPrivileges: string | string[]; - esHasPrivilegesResponse: HasPrivilegesResponse; - expectedResult?: any; - expectErrorThrown?: any; + const checkPrivilegesAtSpaceTest = async (options: { + spaceId: string; + privilegeOrPrivileges: string | string[]; + esHasPrivilegesResponse: HasPrivilegesResponse; + }) => { + const { mockClusterClient, mockScopedClusterClient } = createMockClusterClient( + options.esHasPrivilegesResponse + ); + const checkPrivilegesWithRequest = checkPrivilegesWithRequestFactory( + mockActions, + mockClusterClient, + application + ); + const request = httpServerMock.createKibanaRequest(); + const checkPrivileges = checkPrivilegesWithRequest(request); + + let actualResult; + let errorThrown = null; + try { + actualResult = await checkPrivileges.atSpace(options.spaceId, options.privilegeOrPrivileges); + } catch (err) { + errorThrown = err; } - ) => { - test(description, async () => { - const { mockClusterClient, mockScopedClusterClient } = createMockClusterClient( - options.esHasPrivilegesResponse - ); - const checkPrivilegesWithRequest = checkPrivilegesWithRequestFactory( - mockActions, - mockClusterClient, - application - ); - const request = httpServerMock.createKibanaRequest(); - const checkPrivileges = checkPrivilegesWithRequest(request); - - let actualResult; - let errorThrown = null; - try { - actualResult = await checkPrivileges.atSpace( - options.spaceId, - options.privilegeOrPrivileges - ); - } catch (err) { - errorThrown = err; - } - expect(mockClusterClient.asScoped).toHaveBeenCalledWith(request); - expect(mockScopedClusterClient.callAsCurrentUser).toHaveBeenCalledWith( - 'shield.hasPrivileges', - { - body: { - applications: [ - { - application, - resources: [`space:${options.spaceId}`], - privileges: uniq([ - mockActions.version, - mockActions.login, - ...(Array.isArray(options.privilegeOrPrivileges) - ? options.privilegeOrPrivileges - : [options.privilegeOrPrivileges]), - ]), - }, - ], + expect(mockClusterClient.asScoped).toHaveBeenCalledWith(request); + expect(mockScopedClusterClient.callAsCurrentUser).toHaveBeenCalledWith('shield.hasPrivileges', { + body: { + applications: [ + { + application, + resources: [`space:${options.spaceId}`], + privileges: uniq([ + mockActions.version, + mockActions.login, + ...(Array.isArray(options.privilegeOrPrivileges) + ? options.privilegeOrPrivileges + : [options.privilegeOrPrivileges]), + ]), }, - } - ); - - if (options.expectedResult) { - expect(errorThrown).toBeNull(); - expect(actualResult).toEqual(options.expectedResult); - } - - if (options.expectErrorThrown) { - expect(errorThrown).toMatchSnapshot(); - } + ], + }, }); + + if (errorThrown) { + return errorThrown; + } + return actualResult; }; - checkPrivilegesAtSpaceTest('successful when checking for login and user has login', { - spaceId: 'space_1', - privilegeOrPrivileges: mockActions.login, - esHasPrivilegesResponse: { - has_all_requested: true, - username: 'foo-username', - application: { - [application]: { - 'space:space_1': { - [mockActions.login]: true, - [mockActions.version]: true, + test('successful when checking for login and user has login', async () => { + const result = await checkPrivilegesAtSpaceTest({ + spaceId: 'space_1', + privilegeOrPrivileges: mockActions.login, + esHasPrivilegesResponse: { + has_all_requested: true, + username: 'foo-username', + application: { + [application]: { + 'space:space_1': { + [mockActions.login]: true, + [mockActions.version]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: true, - username: 'foo-username', - privileges: { - [mockActions.login]: true, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": true, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "mock-action:login", + "resource": "space_1", + }, + ], + "username": "foo-username", + } + `); }); - checkPrivilegesAtSpaceTest(`failure when checking for login and user doesn't have login`, { - spaceId: 'space_1', - privilegeOrPrivileges: mockActions.login, - esHasPrivilegesResponse: { - has_all_requested: false, - username: 'foo-username', - application: { - [application]: { - 'space:space_1': { - [mockActions.login]: false, - [mockActions.version]: true, + test(`failure when checking for login and user doesn't have login`, async () => { + const result = await checkPrivilegesAtSpaceTest({ + spaceId: 'space_1', + privilegeOrPrivileges: mockActions.login, + esHasPrivilegesResponse: { + has_all_requested: false, + username: 'foo-username', + application: { + [application]: { + 'space:space_1': { + [mockActions.login]: false, + [mockActions.version]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - privileges: { - [mockActions.login]: false, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": false, + "privilege": "mock-action:login", + "resource": "space_1", + }, + ], + "username": "foo-username", + } + `); }); - checkPrivilegesAtSpaceTest( - `throws error when checking for login and user has login but doesn't have version`, - { + test(`throws error when checking for login and user has login but doesn't have version`, async () => { + const result = await checkPrivilegesAtSpaceTest({ spaceId: 'space_1', privilegeOrPrivileges: mockActions.login, esHasPrivilegesResponse: { @@ -162,74 +160,99 @@ describe('#atSpace', () => { }, }, }, - expectErrorThrown: true, - } - ); - - checkPrivilegesAtSpaceTest(`successful when checking for two actions and the user has both`, { - spaceId: 'space_1', - privilegeOrPrivileges: [ - `saved_object:${savedObjectTypes[0]}/get`, - `saved_object:${savedObjectTypes[1]}/get`, - ], - esHasPrivilegesResponse: { - has_all_requested: true, - username: 'foo-username', - application: { - [application]: { - 'space:space_1': { - [mockActions.login]: true, - [mockActions.version]: true, - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + }); + expect(result).toMatchInlineSnapshot( + `[Error: Multiple versions of Kibana are running against the same Elasticsearch cluster, unable to authorize user.]` + ); + }); + + test(`successful when checking for two actions and the user has both`, async () => { + const result = await checkPrivilegesAtSpaceTest({ + spaceId: 'space_1', + privilegeOrPrivileges: [ + `saved_object:${savedObjectTypes[0]}/get`, + `saved_object:${savedObjectTypes[1]}/get`, + ], + esHasPrivilegesResponse: { + has_all_requested: true, + username: 'foo-username', + application: { + [application]: { + 'space:space_1': { + [mockActions.login]: true, + [mockActions.version]: true, + [`saved_object:${savedObjectTypes[0]}/get`]: true, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: true, - username: 'foo-username', - privileges: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": true, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_1", + }, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": "space_1", + }, + ], + "username": "foo-username", + } + `); }); - checkPrivilegesAtSpaceTest(`failure when checking for two actions and the user has only one`, { - spaceId: 'space_1', - privilegeOrPrivileges: [ - `saved_object:${savedObjectTypes[0]}/get`, - `saved_object:${savedObjectTypes[1]}/get`, - ], - esHasPrivilegesResponse: { - has_all_requested: false, - username: 'foo-username', - application: { - [application]: { - 'space:space_1': { - [mockActions.login]: true, - [mockActions.version]: true, - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + test(`failure when checking for two actions and the user has only one`, async () => { + const result = await checkPrivilegesAtSpaceTest({ + spaceId: 'space_1', + privilegeOrPrivileges: [ + `saved_object:${savedObjectTypes[0]}/get`, + `saved_object:${savedObjectTypes[1]}/get`, + ], + esHasPrivilegesResponse: { + has_all_requested: false, + username: 'foo-username', + application: { + [application]: { + 'space:space_1': { + [mockActions.login]: true, + [mockActions.version]: true, + [`saved_object:${savedObjectTypes[0]}/get`]: false, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - privileges: { - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: true, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": false, + "privilege": "saved_object:foo-type/get", + "resource": "space_1", + }, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": "space_1", + }, + ], + "username": "foo-username", + } + `); }); describe('with a malformed Elasticsearch response', () => { - checkPrivilegesAtSpaceTest( - `throws a validation error when an extra privilege is present in the response`, - { + test(`throws a validation error when an extra privilege is present in the response`, async () => { + const result = await checkPrivilegesAtSpaceTest({ spaceId: 'space_1', privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { @@ -246,13 +269,14 @@ describe('#atSpace', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_1" fails because ["saved_object:bar-type/get" is not allowed]]]]` + ); + }); - checkPrivilegesAtSpaceTest( - `throws a validation error when privileges are missing in the response`, - { + test(`throws a validation error when privileges are missing in the response`, async () => { + const result = await checkPrivilegesAtSpaceTest({ spaceId: 'space_1', privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { @@ -267,82 +291,69 @@ describe('#atSpace', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_1" fails because [child "saved_object:foo-type/get" fails because ["saved_object:foo-type/get" is required]]]]]` + ); + }); }); }); describe('#atSpaces', () => { - const checkPrivilegesAtSpacesTest = ( - description: string, - options: { - spaceIds: string[]; - privilegeOrPrivileges: string | string[]; - esHasPrivilegesResponse: HasPrivilegesResponse; - expectedResult?: any; - expectErrorThrown?: any; - } - ) => { - test(description, async () => { - const { mockClusterClient, mockScopedClusterClient } = createMockClusterClient( - options.esHasPrivilegesResponse - ); - const checkPrivilegesWithRequest = checkPrivilegesWithRequestFactory( - mockActions, - mockClusterClient, - application - ); - const request = httpServerMock.createKibanaRequest(); - const checkPrivileges = checkPrivilegesWithRequest(request); - - let actualResult; - let errorThrown = null; - try { - actualResult = await checkPrivileges.atSpaces( - options.spaceIds, - options.privilegeOrPrivileges - ); - } catch (err) { - errorThrown = err; - } + const checkPrivilegesAtSpacesTest = async (options: { + spaceIds: string[]; + privilegeOrPrivileges: string | string[]; + esHasPrivilegesResponse: HasPrivilegesResponse; + }) => { + const { mockClusterClient, mockScopedClusterClient } = createMockClusterClient( + options.esHasPrivilegesResponse + ); + const checkPrivilegesWithRequest = checkPrivilegesWithRequestFactory( + mockActions, + mockClusterClient, + application + ); + const request = httpServerMock.createKibanaRequest(); + const checkPrivileges = checkPrivilegesWithRequest(request); - expect(mockClusterClient.asScoped).toHaveBeenCalledWith(request); - expect(mockScopedClusterClient.callAsCurrentUser).toHaveBeenCalledWith( - 'shield.hasPrivileges', - { - body: { - applications: [ - { - application, - resources: options.spaceIds.map(spaceId => `space:${spaceId}`), - privileges: uniq([ - mockActions.version, - mockActions.login, - ...(Array.isArray(options.privilegeOrPrivileges) - ? options.privilegeOrPrivileges - : [options.privilegeOrPrivileges]), - ]), - }, - ], - }, - } + let actualResult; + let errorThrown = null; + try { + actualResult = await checkPrivileges.atSpaces( + options.spaceIds, + options.privilegeOrPrivileges ); + } catch (err) { + errorThrown = err; + } - if (options.expectedResult) { - expect(errorThrown).toBeNull(); - expect(actualResult).toEqual(options.expectedResult); - } - - if (options.expectErrorThrown) { - expect(errorThrown).toMatchSnapshot(); - } + expect(mockClusterClient.asScoped).toHaveBeenCalledWith(request); + expect(mockScopedClusterClient.callAsCurrentUser).toHaveBeenCalledWith('shield.hasPrivileges', { + body: { + applications: [ + { + application, + resources: options.spaceIds.map(spaceId => `space:${spaceId}`), + privileges: uniq([ + mockActions.version, + mockActions.login, + ...(Array.isArray(options.privilegeOrPrivileges) + ? options.privilegeOrPrivileges + : [options.privilegeOrPrivileges]), + ]), + }, + ], + }, }); + + if (errorThrown) { + return errorThrown; + } + return actualResult; }; - checkPrivilegesAtSpacesTest( - 'successful when checking for login and user has login at both spaces', - { + test('successful when checking for login and user has login at both spaces', async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: mockActions.login, esHasPrivilegesResponse: { @@ -361,24 +372,29 @@ describe('#atSpaces', () => { }, }, }, - expectedResult: { - hasAllRequested: true, - username: 'foo-username', - spacePrivileges: { - space_1: { - [mockActions.login]: true, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": true, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "mock-action:login", + "resource": "space_1", }, - space_2: { - [mockActions.login]: true, + Object { + "authorized": true, + "privilege": "mock-action:login", + "resource": "space_2", }, - }, - }, - } - ); + ], + "username": "foo-username", + } + `); + }); - checkPrivilegesAtSpacesTest( - 'failure when checking for login and user has login at only one space', - { + test('failure when checking for login and user has login at only one space', async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: mockActions.login, esHasPrivilegesResponse: { @@ -397,24 +413,29 @@ describe('#atSpaces', () => { }, }, }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - spacePrivileges: { - space_1: { - [mockActions.login]: true, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "mock-action:login", + "resource": "space_1", }, - space_2: { - [mockActions.login]: false, + Object { + "authorized": false, + "privilege": "mock-action:login", + "resource": "space_2", }, - }, - }, - } - ); + ], + "username": "foo-username", + } + `); + }); - checkPrivilegesAtSpacesTest( - `throws error when checking for login and user has login but doesn't have version`, - { + test(`throws error when checking for login and user has login but doesn't have version`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: mockActions.login, esHasPrivilegesResponse: { @@ -433,38 +454,43 @@ describe('#atSpaces', () => { }, }, }, - expectErrorThrown: true, - } - ); - - checkPrivilegesAtSpacesTest(`throws error when Elasticsearch returns malformed response`, { - spaceIds: ['space_1', 'space_2'], - privilegeOrPrivileges: [ - `saved_object:${savedObjectTypes[0]}/get`, - `saved_object:${savedObjectTypes[1]}/get`, - ], - esHasPrivilegesResponse: { - has_all_requested: true, - username: 'foo-username', - application: { - [application]: { - 'space:space_1': { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, - }, - 'space:space_2': { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + }); + expect(result).toMatchInlineSnapshot( + `[Error: Multiple versions of Kibana are running against the same Elasticsearch cluster, unable to authorize user.]` + ); + }); + + test(`throws error when Elasticsearch returns malformed response`, async () => { + const result = await checkPrivilegesAtSpacesTest({ + spaceIds: ['space_1', 'space_2'], + privilegeOrPrivileges: [ + `saved_object:${savedObjectTypes[0]}/get`, + `saved_object:${savedObjectTypes[1]}/get`, + ], + esHasPrivilegesResponse: { + has_all_requested: true, + username: 'foo-username', + application: { + [application]: { + 'space:space_1': { + [`saved_object:${savedObjectTypes[0]}/get`]: true, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, + 'space:space_2': { + [`saved_object:${savedObjectTypes[0]}/get`]: true, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, }, }, }, - }, - expectErrorThrown: true, + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_1" fails because [child "mock-action:version" fails because ["mock-action:version" is required]]]]]` + ); }); - checkPrivilegesAtSpacesTest( - `successful when checking for two actions at two spaces and user has it all`, - { + test(`successful when checking for two actions at two spaces and user has it all`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [ `saved_object:${savedObjectTypes[0]}/get`, @@ -490,26 +516,39 @@ describe('#atSpaces', () => { }, }, }, - expectedResult: { - hasAllRequested: true, - username: 'foo-username', - spacePrivileges: { - space_1: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": true, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_1", }, - space_2: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": "space_1", }, - }, - }, - } - ); + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_2", + }, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": "space_2", + }, + ], + "username": "foo-username", + } + `); + }); - checkPrivilegesAtSpacesTest( - `failure when checking for two actions at two spaces and user has one action at one space`, - { + test(`failure when checking for two actions at two spaces and user has one action at one space`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [ `saved_object:${savedObjectTypes[0]}/get`, @@ -535,26 +574,39 @@ describe('#atSpaces', () => { }, }, }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - spacePrivileges: { - space_1: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: false, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_1", }, - space_2: { - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: false, + Object { + "authorized": false, + "privilege": "saved_object:bar-type/get", + "resource": "space_1", }, - }, - }, - } - ); + Object { + "authorized": false, + "privilege": "saved_object:foo-type/get", + "resource": "space_2", + }, + Object { + "authorized": false, + "privilege": "saved_object:bar-type/get", + "resource": "space_2", + }, + ], + "username": "foo-username", + } + `); + }); - checkPrivilegesAtSpacesTest( - `failure when checking for two actions at two spaces and user has two actions at one space`, - { + test(`failure when checking for two actions at two spaces and user has two actions at one space`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [ `saved_object:${savedObjectTypes[0]}/get`, @@ -580,26 +632,39 @@ describe('#atSpaces', () => { }, }, }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - spacePrivileges: { - space_1: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_1", }, - space_2: { - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: false, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": "space_1", }, - }, - }, - } - ); + Object { + "authorized": false, + "privilege": "saved_object:foo-type/get", + "resource": "space_2", + }, + Object { + "authorized": false, + "privilege": "saved_object:bar-type/get", + "resource": "space_2", + }, + ], + "username": "foo-username", + } + `); + }); - checkPrivilegesAtSpacesTest( - `failure when checking for two actions at two spaces and user has two actions at one space & one action at the other`, - { + test(`failure when checking for two actions at two spaces and user has two actions at one space & one action at the other`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [ `saved_object:${savedObjectTypes[0]}/get`, @@ -625,27 +690,40 @@ describe('#atSpaces', () => { }, }, }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - spacePrivileges: { - space_1: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_1", }, - space_2: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: false, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": "space_1", }, - }, - }, - } - ); + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": "space_2", + }, + Object { + "authorized": false, + "privilege": "saved_object:bar-type/get", + "resource": "space_2", + }, + ], + "username": "foo-username", + } + `); + }); describe('with a malformed Elasticsearch response', () => { - checkPrivilegesAtSpacesTest( - `throws a validation error when an extra privilege is present in the response`, - { + test(`throws a validation error when an extra privilege is present in the response`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { @@ -668,13 +746,14 @@ describe('#atSpaces', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_2" fails because ["space:space_2" is required]]]]` + ); + }); - checkPrivilegesAtSpacesTest( - `throws a validation error when privileges are missing in the response`, - { + test(`throws a validation error when privileges are missing in the response`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { @@ -695,13 +774,14 @@ describe('#atSpaces', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_2" fails because ["space:space_2" is required]]]]` + ); + }); - checkPrivilegesAtSpacesTest( - `throws a validation error when an extra space is present in the response`, - { + test(`throws a validation error when an extra space is present in the response`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { @@ -727,13 +807,14 @@ describe('#atSpaces', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because ["space:space_3" is not allowed]]]` + ); + }); - checkPrivilegesAtSpacesTest( - `throws a validation error when an a space is missing in the response`, - { + test(`throws a validation error when an a space is missing in the response`, async () => { + const result = await checkPrivilegesAtSpacesTest({ spaceIds: ['space_1', 'space_2'], privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { @@ -749,124 +830,127 @@ describe('#atSpaces', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "space:space_2" fails because ["space:space_2" is required]]]]` + ); + }); }); }); describe('#globally', () => { - const checkPrivilegesGloballyTest = ( - description: string, - options: { - privilegeOrPrivileges: string | string[]; - esHasPrivilegesResponse: HasPrivilegesResponse; - expectedResult?: any; - expectErrorThrown?: any; + const checkPrivilegesGloballyTest = async (options: { + privilegeOrPrivileges: string | string[]; + esHasPrivilegesResponse: HasPrivilegesResponse; + }) => { + const { mockClusterClient, mockScopedClusterClient } = createMockClusterClient( + options.esHasPrivilegesResponse + ); + const checkPrivilegesWithRequest = checkPrivilegesWithRequestFactory( + mockActions, + mockClusterClient, + application + ); + const request = httpServerMock.createKibanaRequest(); + const checkPrivileges = checkPrivilegesWithRequest(request); + + let actualResult; + let errorThrown = null; + try { + actualResult = await checkPrivileges.globally(options.privilegeOrPrivileges); + } catch (err) { + errorThrown = err; } - ) => { - test(description, async () => { - const { mockClusterClient, mockScopedClusterClient } = createMockClusterClient( - options.esHasPrivilegesResponse - ); - const checkPrivilegesWithRequest = checkPrivilegesWithRequestFactory( - mockActions, - mockClusterClient, - application - ); - const request = httpServerMock.createKibanaRequest(); - const checkPrivileges = checkPrivilegesWithRequest(request); - - let actualResult; - let errorThrown = null; - try { - actualResult = await checkPrivileges.globally(options.privilegeOrPrivileges); - } catch (err) { - errorThrown = err; - } - expect(mockClusterClient.asScoped).toHaveBeenCalledWith(request); - expect(mockScopedClusterClient.callAsCurrentUser).toHaveBeenCalledWith( - 'shield.hasPrivileges', - { - body: { - applications: [ - { - application, - resources: [GLOBAL_RESOURCE], - privileges: uniq([ - mockActions.version, - mockActions.login, - ...(Array.isArray(options.privilegeOrPrivileges) - ? options.privilegeOrPrivileges - : [options.privilegeOrPrivileges]), - ]), - }, - ], + expect(mockClusterClient.asScoped).toHaveBeenCalledWith(request); + expect(mockScopedClusterClient.callAsCurrentUser).toHaveBeenCalledWith('shield.hasPrivileges', { + body: { + applications: [ + { + application, + resources: [GLOBAL_RESOURCE], + privileges: uniq([ + mockActions.version, + mockActions.login, + ...(Array.isArray(options.privilegeOrPrivileges) + ? options.privilegeOrPrivileges + : [options.privilegeOrPrivileges]), + ]), }, - } - ); - - if (options.expectedResult) { - expect(errorThrown).toBeNull(); - expect(actualResult).toEqual(options.expectedResult); - } - - if (options.expectErrorThrown) { - expect(errorThrown).toMatchSnapshot(); - } + ], + }, }); + + if (errorThrown) { + return errorThrown; + } + return actualResult; }; - checkPrivilegesGloballyTest('successful when checking for login and user has login', { - privilegeOrPrivileges: mockActions.login, - esHasPrivilegesResponse: { - has_all_requested: true, - username: 'foo-username', - application: { - [application]: { - [GLOBAL_RESOURCE]: { - [mockActions.login]: true, - [mockActions.version]: true, + test('successful when checking for login and user has login', async () => { + const result = await checkPrivilegesGloballyTest({ + privilegeOrPrivileges: mockActions.login, + esHasPrivilegesResponse: { + has_all_requested: true, + username: 'foo-username', + application: { + [application]: { + [GLOBAL_RESOURCE]: { + [mockActions.login]: true, + [mockActions.version]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: true, - username: 'foo-username', - privileges: { - [mockActions.login]: true, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": true, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "mock-action:login", + "resource": undefined, + }, + ], + "username": "foo-username", + } + `); }); - checkPrivilegesGloballyTest(`failure when checking for login and user doesn't have login`, { - privilegeOrPrivileges: mockActions.login, - esHasPrivilegesResponse: { - has_all_requested: false, - username: 'foo-username', - application: { - [application]: { - [GLOBAL_RESOURCE]: { - [mockActions.login]: false, - [mockActions.version]: true, + test(`failure when checking for login and user doesn't have login`, async () => { + const result = await checkPrivilegesGloballyTest({ + privilegeOrPrivileges: mockActions.login, + esHasPrivilegesResponse: { + has_all_requested: false, + username: 'foo-username', + application: { + [application]: { + [GLOBAL_RESOURCE]: { + [mockActions.login]: false, + [mockActions.version]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - privileges: { - [mockActions.login]: false, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": false, + "privilege": "mock-action:login", + "resource": undefined, + }, + ], + "username": "foo-username", + } + `); }); - checkPrivilegesGloballyTest( - `throws error when checking for login and user has login but doesn't have version`, - { + test(`throws error when checking for login and user has login but doesn't have version`, async () => { + const result = await checkPrivilegesGloballyTest({ privilegeOrPrivileges: mockActions.login, esHasPrivilegesResponse: { has_all_requested: false, @@ -880,92 +964,121 @@ describe('#globally', () => { }, }, }, - expectErrorThrown: true, - } - ); - - checkPrivilegesGloballyTest(`throws error when Elasticsearch returns malformed response`, { - privilegeOrPrivileges: [ - `saved_object:${savedObjectTypes[0]}/get`, - `saved_object:${savedObjectTypes[1]}/get`, - ], - esHasPrivilegesResponse: { - has_all_requested: false, - username: 'foo-username', - application: { - [application]: { - [GLOBAL_RESOURCE]: { - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + }); + expect(result).toMatchInlineSnapshot( + `[Error: Multiple versions of Kibana are running against the same Elasticsearch cluster, unable to authorize user.]` + ); + }); + + test(`throws error when Elasticsearch returns malformed response`, async () => { + const result = await checkPrivilegesGloballyTest({ + privilegeOrPrivileges: [ + `saved_object:${savedObjectTypes[0]}/get`, + `saved_object:${savedObjectTypes[1]}/get`, + ], + esHasPrivilegesResponse: { + has_all_requested: false, + username: 'foo-username', + application: { + [application]: { + [GLOBAL_RESOURCE]: { + [`saved_object:${savedObjectTypes[0]}/get`]: false, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, }, }, }, - }, - expectErrorThrown: true, + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "*" fails because [child "mock-action:version" fails because ["mock-action:version" is required]]]]]` + ); }); - checkPrivilegesGloballyTest(`successful when checking for two actions and the user has both`, { - privilegeOrPrivileges: [ - `saved_object:${savedObjectTypes[0]}/get`, - `saved_object:${savedObjectTypes[1]}/get`, - ], - esHasPrivilegesResponse: { - has_all_requested: true, - username: 'foo-username', - application: { - [application]: { - [GLOBAL_RESOURCE]: { - [mockActions.login]: true, - [mockActions.version]: true, - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + test(`successful when checking for two actions and the user has both`, async () => { + const result = await checkPrivilegesGloballyTest({ + privilegeOrPrivileges: [ + `saved_object:${savedObjectTypes[0]}/get`, + `saved_object:${savedObjectTypes[1]}/get`, + ], + esHasPrivilegesResponse: { + has_all_requested: true, + username: 'foo-username', + application: { + [application]: { + [GLOBAL_RESOURCE]: { + [mockActions.login]: true, + [mockActions.version]: true, + [`saved_object:${savedObjectTypes[0]}/get`]: true, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: true, - username: 'foo-username', - privileges: { - [`saved_object:${savedObjectTypes[0]}/get`]: true, - [`saved_object:${savedObjectTypes[1]}/get`]: true, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": true, + "privileges": Array [ + Object { + "authorized": true, + "privilege": "saved_object:foo-type/get", + "resource": undefined, + }, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": undefined, + }, + ], + "username": "foo-username", + } + `); }); - checkPrivilegesGloballyTest(`failure when checking for two actions and the user has only one`, { - privilegeOrPrivileges: [ - `saved_object:${savedObjectTypes[0]}/get`, - `saved_object:${savedObjectTypes[1]}/get`, - ], - esHasPrivilegesResponse: { - has_all_requested: false, - username: 'foo-username', - application: { - [application]: { - [GLOBAL_RESOURCE]: { - [mockActions.login]: true, - [mockActions.version]: true, - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: true, + test(`failure when checking for two actions and the user has only one`, async () => { + const result = await checkPrivilegesGloballyTest({ + privilegeOrPrivileges: [ + `saved_object:${savedObjectTypes[0]}/get`, + `saved_object:${savedObjectTypes[1]}/get`, + ], + esHasPrivilegesResponse: { + has_all_requested: false, + username: 'foo-username', + application: { + [application]: { + [GLOBAL_RESOURCE]: { + [mockActions.login]: true, + [mockActions.version]: true, + [`saved_object:${savedObjectTypes[0]}/get`]: false, + [`saved_object:${savedObjectTypes[1]}/get`]: true, + }, }, }, }, - }, - expectedResult: { - hasAllRequested: false, - username: 'foo-username', - privileges: { - [`saved_object:${savedObjectTypes[0]}/get`]: false, - [`saved_object:${savedObjectTypes[1]}/get`]: true, - }, - }, + }); + expect(result).toMatchInlineSnapshot(` + Object { + "hasAllRequested": false, + "privileges": Array [ + Object { + "authorized": false, + "privilege": "saved_object:foo-type/get", + "resource": undefined, + }, + Object { + "authorized": true, + "privilege": "saved_object:bar-type/get", + "resource": undefined, + }, + ], + "username": "foo-username", + } + `); }); describe('with a malformed Elasticsearch response', () => { - checkPrivilegesGloballyTest( - `throws a validation error when an extra privilege is present in the response`, - { + test(`throws a validation error when an extra privilege is present in the response`, async () => { + const result = await checkPrivilegesGloballyTest({ privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { has_all_requested: false, @@ -981,13 +1094,14 @@ describe('#globally', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "*" fails because ["saved_object:bar-type/get" is not allowed]]]]` + ); + }); - checkPrivilegesGloballyTest( - `throws a validation error when privileges are missing in the response`, - { + test(`throws a validation error when privileges are missing in the response`, async () => { + const result = await checkPrivilegesGloballyTest({ privilegeOrPrivileges: [`saved_object:${savedObjectTypes[0]}/get`], esHasPrivilegesResponse: { has_all_requested: false, @@ -1001,8 +1115,10 @@ describe('#globally', () => { }, }, }, - expectErrorThrown: true, - } - ); + }); + expect(result).toMatchInlineSnapshot( + `[Error: Invalid response received from Elasticsearch has_privilege endpoint. ValidationError: child "application" fails because [child "kibana-our_application" fails because [child "*" fails because [child "saved_object:foo-type/get" fails because ["saved_object:foo-type/get" is required]]]]]` + ); + }); }); }); diff --git a/x-pack/plugins/security/server/authorization/check_privileges.ts b/x-pack/plugins/security/server/authorization/check_privileges.ts index 3ef7a8f29a0bf..177a49d6defe9 100644 --- a/x-pack/plugins/security/server/authorization/check_privileges.ts +++ b/x-pack/plugins/security/server/authorization/check_privileges.ts @@ -16,32 +16,17 @@ interface CheckPrivilegesActions { version: string; } -interface CheckPrivilegesAtResourcesResponse { +export interface CheckPrivilegesResponse { hasAllRequested: boolean; username: string; - resourcePrivileges: { - [resource: string]: { - [privilege: string]: boolean; - }; - }; -} - -export interface CheckPrivilegesAtResourceResponse { - hasAllRequested: boolean; - username: string; - privileges: { - [privilege: string]: boolean; - }; -} - -export interface CheckPrivilegesAtSpacesResponse { - hasAllRequested: boolean; - username: string; - spacePrivileges: { - [spaceId: string]: { - [privilege: string]: boolean; - }; - }; + privileges: Array<{ + /** + * If this attribute is undefined, this element is a privilege for the global resource. + */ + resource?: string; + privilege: string; + authorized: boolean; + }>; } export type CheckPrivilegesWithRequest = (request: KibanaRequest) => CheckPrivileges; @@ -50,12 +35,12 @@ export interface CheckPrivileges { atSpace( spaceId: string, privilegeOrPrivileges: string | string[] - ): Promise; + ): Promise; atSpaces( spaceIds: string[], privilegeOrPrivileges: string | string[] - ): Promise; - globally(privilegeOrPrivileges: string | string[]): Promise; + ): Promise; + globally(privilegeOrPrivileges: string | string[]): Promise; } export function checkPrivilegesWithRequestFactory( @@ -75,7 +60,7 @@ export function checkPrivilegesWithRequestFactory( const checkPrivilegesAtResources = async ( resources: string[], privilegeOrPrivileges: string | string[] - ): Promise => { + ): Promise => { const privileges = Array.isArray(privilegeOrPrivileges) ? privilegeOrPrivileges : [privilegeOrPrivileges]; @@ -106,55 +91,43 @@ export function checkPrivilegesWithRequestFactory( ); } + // we need to filter out the non requested privileges from the response + const resourcePrivileges = transform(applicationPrivilegesResponse, (result, value, key) => { + result[key!] = pick(value, privileges); + }) as HasPrivilegesResponseApplication; + const privilegeArray = Object.entries(resourcePrivileges) + .map(([key, val]) => { + // we need to turn the resource responses back into the space ids + const resource = + key !== GLOBAL_RESOURCE ? ResourceSerializer.deserializeSpaceResource(key!) : undefined; + return Object.entries(val).map(([privilege, authorized]) => ({ + resource, + privilege, + authorized, + })); + }) + .flat(); + return { hasAllRequested: hasPrivilegesResponse.has_all_requested, username: hasPrivilegesResponse.username, - // we need to filter out the non requested privileges from the response - resourcePrivileges: transform(applicationPrivilegesResponse, (result, value, key) => { - result[key!] = pick(value, privileges); - }), - }; - }; - - const checkPrivilegesAtResource = async ( - resource: string, - privilegeOrPrivileges: string | string[] - ) => { - const { hasAllRequested, username, resourcePrivileges } = await checkPrivilegesAtResources( - [resource], - privilegeOrPrivileges - ); - return { - hasAllRequested, - username, - privileges: resourcePrivileges[resource], + privileges: privilegeArray, }; }; return { async atSpace(spaceId: string, privilegeOrPrivileges: string | string[]) { const spaceResource = ResourceSerializer.serializeSpaceResource(spaceId); - return await checkPrivilegesAtResource(spaceResource, privilegeOrPrivileges); + return await checkPrivilegesAtResources([spaceResource], privilegeOrPrivileges); }, async atSpaces(spaceIds: string[], privilegeOrPrivileges: string | string[]) { const spaceResources = spaceIds.map(spaceId => ResourceSerializer.serializeSpaceResource(spaceId) ); - const { hasAllRequested, username, resourcePrivileges } = await checkPrivilegesAtResources( - spaceResources, - privilegeOrPrivileges - ); - return { - hasAllRequested, - username, - // we need to turn the resource responses back into the space ids - spacePrivileges: transform(resourcePrivileges, (result, value, key) => { - result[ResourceSerializer.deserializeSpaceResource(key!)] = value; - }), - }; + return await checkPrivilegesAtResources(spaceResources, privilegeOrPrivileges); }, async globally(privilegeOrPrivileges: string | string[]) { - return await checkPrivilegesAtResource(GLOBAL_RESOURCE, privilegeOrPrivileges); + return await checkPrivilegesAtResources([GLOBAL_RESOURCE], privilegeOrPrivileges); }, }; }; diff --git a/x-pack/plugins/security/server/authorization/check_privileges_dynamically.ts b/x-pack/plugins/security/server/authorization/check_privileges_dynamically.ts index 0377dd06eb669..6014bad739e77 100644 --- a/x-pack/plugins/security/server/authorization/check_privileges_dynamically.ts +++ b/x-pack/plugins/security/server/authorization/check_privileges_dynamically.ts @@ -6,11 +6,11 @@ import { KibanaRequest } from '../../../../../src/core/server'; import { SpacesService } from '../plugin'; -import { CheckPrivilegesAtResourceResponse, CheckPrivilegesWithRequest } from './check_privileges'; +import { CheckPrivilegesResponse, CheckPrivilegesWithRequest } from './check_privileges'; export type CheckPrivilegesDynamically = ( privilegeOrPrivileges: string | string[] -) => Promise; +) => Promise; export type CheckPrivilegesDynamicallyWithRequest = ( request: KibanaRequest diff --git a/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.test.ts b/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.test.ts index 4618e8e6641fc..43b3824500579 100644 --- a/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.test.ts +++ b/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.test.ts @@ -7,57 +7,113 @@ import { checkSavedObjectsPrivilegesWithRequestFactory } from './check_saved_objects_privileges'; import { httpServerMock } from '../../../../../src/core/server/mocks'; +import { CheckPrivileges, CheckPrivilegesWithRequest } from './check_privileges'; +import { SpacesService } from '../plugin'; -test(`checkPrivileges.atSpace when spaces is enabled`, async () => { - const expectedResult = Symbol(); - const spaceId = 'foo-space'; - const mockCheckPrivileges = { - atSpace: jest.fn().mockReturnValue(expectedResult), - }; - const mockCheckPrivilegesWithRequest = jest.fn().mockReturnValue(mockCheckPrivileges); - const request = httpServerMock.createKibanaRequest(); - const privilegeOrPrivileges = ['foo', 'bar']; - const mockSpacesService = { - getSpaceId: jest.fn(), - namespaceToSpaceId: jest.fn().mockReturnValue(spaceId), - }; +let mockCheckPrivileges: jest.Mocked; +let mockCheckPrivilegesWithRequest: jest.Mocked; +let mockSpacesService: jest.Mocked | undefined; +const request = httpServerMock.createKibanaRequest(); - const checkSavedObjectsPrivileges = checkSavedObjectsPrivilegesWithRequestFactory( +const createFactory = () => + checkSavedObjectsPrivilegesWithRequestFactory( mockCheckPrivilegesWithRequest, () => mockSpacesService )(request); - const namespace = 'foo'; - - const result = await checkSavedObjectsPrivileges(privilegeOrPrivileges, namespace); +beforeEach(() => { + mockCheckPrivileges = { + atSpace: jest.fn(), + atSpaces: jest.fn(), + globally: jest.fn(), + }; + mockCheckPrivilegesWithRequest = jest.fn().mockReturnValue(mockCheckPrivileges); - expect(result).toBe(expectedResult); - expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledWith(request); - expect(mockCheckPrivileges.atSpace).toHaveBeenCalledWith(spaceId, privilegeOrPrivileges); - expect(mockSpacesService.namespaceToSpaceId).toBeCalledWith(namespace); + mockSpacesService = { + getSpaceId: jest.fn(), + namespaceToSpaceId: jest.fn().mockImplementation((namespace: string) => `${namespace}-id`), + }; }); -test(`checkPrivileges.globally when spaces is disabled`, async () => { - const expectedResult = Symbol(); - const mockCheckPrivileges = { - globally: jest.fn().mockReturnValue(expectedResult), - }; - const mockCheckPrivilegesWithRequest = jest.fn().mockReturnValue(mockCheckPrivileges); +describe('#checkSavedObjectsPrivileges', () => { + const actions = ['foo', 'bar']; + const namespace1 = 'baz'; + const namespace2 = 'qux'; - const request = httpServerMock.createKibanaRequest(); + describe('when checking multiple namespaces', () => { + const namespaces = [namespace1, namespace2]; - const privilegeOrPrivileges = ['foo', 'bar']; + test(`throws an error when Spaces is disabled`, async () => { + mockSpacesService = undefined; + const checkSavedObjectsPrivileges = createFactory(); - const checkSavedObjectsPrivileges = checkSavedObjectsPrivilegesWithRequestFactory( - mockCheckPrivilegesWithRequest, - () => undefined - )(request); + await expect( + checkSavedObjectsPrivileges(actions, namespaces) + ).rejects.toThrowErrorMatchingInlineSnapshot( + `"Can't check saved object privileges for multiple namespaces if Spaces is disabled"` + ); + }); + + test(`throws an error when using an empty namespaces array`, async () => { + const checkSavedObjectsPrivileges = createFactory(); + + await expect( + checkSavedObjectsPrivileges(actions, []) + ).rejects.toThrowErrorMatchingInlineSnapshot( + `"Can't check saved object privileges for 0 namespaces"` + ); + }); + + test(`uses checkPrivileges.atSpaces when spaces is enabled`, async () => { + const expectedResult = Symbol(); + mockCheckPrivileges.atSpaces.mockReturnValue(expectedResult as any); + const checkSavedObjectsPrivileges = createFactory(); + + const result = await checkSavedObjectsPrivileges(actions, namespaces); + + expect(result).toBe(expectedResult); + expect(mockSpacesService!.namespaceToSpaceId).toHaveBeenCalledTimes(2); + expect(mockSpacesService!.namespaceToSpaceId).toHaveBeenNthCalledWith(1, namespace1); + expect(mockSpacesService!.namespaceToSpaceId).toHaveBeenNthCalledWith(2, namespace2); + expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledTimes(1); + expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledWith(request); + expect(mockCheckPrivileges.atSpaces).toHaveBeenCalledTimes(1); + const spaceIds = mockSpacesService!.namespaceToSpaceId.mock.results.map(x => x.value); + expect(mockCheckPrivileges.atSpaces).toHaveBeenCalledWith(spaceIds, actions); + }); + }); + + describe('when checking a single namespace', () => { + test(`uses checkPrivileges.atSpace when Spaces is enabled`, async () => { + const expectedResult = Symbol(); + mockCheckPrivileges.atSpace.mockReturnValue(expectedResult as any); + const checkSavedObjectsPrivileges = createFactory(); + + const result = await checkSavedObjectsPrivileges(actions, namespace1); + + expect(result).toBe(expectedResult); + expect(mockSpacesService!.namespaceToSpaceId).toHaveBeenCalledTimes(1); + expect(mockSpacesService!.namespaceToSpaceId).toHaveBeenCalledWith(namespace1); + expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledTimes(1); + expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledWith(request); + expect(mockCheckPrivileges.atSpace).toHaveBeenCalledTimes(1); + const spaceId = mockSpacesService!.namespaceToSpaceId.mock.results[0].value; + expect(mockCheckPrivileges.atSpace).toHaveBeenCalledWith(spaceId, actions); + }); - const namespace = 'foo'; + test(`uses checkPrivileges.globally when Spaces is disabled`, async () => { + const expectedResult = Symbol(); + mockCheckPrivileges.globally.mockReturnValue(expectedResult as any); + mockSpacesService = undefined; + const checkSavedObjectsPrivileges = createFactory(); - const result = await checkSavedObjectsPrivileges(privilegeOrPrivileges, namespace); + const result = await checkSavedObjectsPrivileges(actions, namespace1); - expect(result).toBe(expectedResult); - expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledWith(request); - expect(mockCheckPrivileges.globally).toHaveBeenCalledWith(privilegeOrPrivileges); + expect(result).toBe(expectedResult); + expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledTimes(1); + expect(mockCheckPrivilegesWithRequest).toHaveBeenCalledWith(request); + expect(mockCheckPrivileges.globally).toHaveBeenCalledTimes(1); + expect(mockCheckPrivileges.globally).toHaveBeenCalledWith(actions); + }); + }); }); diff --git a/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.ts b/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.ts index 02958fe265efa..43140143a1773 100644 --- a/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.ts +++ b/x-pack/plugins/security/server/authorization/check_saved_objects_privileges.ts @@ -6,32 +6,44 @@ import { KibanaRequest } from '../../../../../src/core/server'; import { SpacesService } from '../plugin'; -import { CheckPrivilegesAtResourceResponse, CheckPrivilegesWithRequest } from './check_privileges'; +import { CheckPrivilegesWithRequest, CheckPrivilegesResponse } from './check_privileges'; export type CheckSavedObjectsPrivilegesWithRequest = ( request: KibanaRequest ) => CheckSavedObjectsPrivileges; + export type CheckSavedObjectsPrivileges = ( actions: string | string[], - namespace?: string -) => Promise; + namespaceOrNamespaces?: string | string[] +) => Promise; export const checkSavedObjectsPrivilegesWithRequestFactory = ( checkPrivilegesWithRequest: CheckPrivilegesWithRequest, getSpacesService: () => SpacesService | undefined ): CheckSavedObjectsPrivilegesWithRequest => { - return function checkSavedObjectsPrivilegesWithRequest(request: KibanaRequest) { + return function checkSavedObjectsPrivilegesWithRequest( + request: KibanaRequest + ): CheckSavedObjectsPrivileges { return async function checkSavedObjectsPrivileges( actions: string | string[], - namespace?: string + namespaceOrNamespaces?: string | string[] ) { const spacesService = getSpacesService(); - return spacesService - ? await checkPrivilegesWithRequest(request).atSpace( - spacesService.namespaceToSpaceId(namespace), - actions - ) - : await checkPrivilegesWithRequest(request).globally(actions); + if (Array.isArray(namespaceOrNamespaces)) { + if (spacesService === undefined) { + throw new Error( + `Can't check saved object privileges for multiple namespaces if Spaces is disabled` + ); + } else if (!namespaceOrNamespaces.length) { + throw new Error(`Can't check saved object privileges for 0 namespaces`); + } + const spaceIds = namespaceOrNamespaces.map(x => spacesService.namespaceToSpaceId(x)); + return await checkPrivilegesWithRequest(request).atSpaces(spaceIds, actions); + } else if (spacesService) { + const spaceId = spacesService.namespaceToSpaceId(namespaceOrNamespaces); + return await checkPrivilegesWithRequest(request).atSpace(spaceId, actions); + } + return await checkPrivilegesWithRequest(request).globally(actions); }; }; }; diff --git a/x-pack/plugins/security/server/authorization/disable_ui_capabilities.test.ts b/x-pack/plugins/security/server/authorization/disable_ui_capabilities.test.ts index 912ae60e12065..ea97a1b3b590c 100644 --- a/x-pack/plugins/security/server/authorization/disable_ui_capabilities.test.ts +++ b/x-pack/plugins/security/server/authorization/disable_ui_capabilities.test.ts @@ -11,7 +11,9 @@ import { httpServerMock, loggingServiceMock } from '../../../../../src/core/serv import { authorizationMock } from './index.mock'; import { Feature } from '../../../features/server'; -type MockAuthzOptions = { rejectCheckPrivileges: any } | { resolveCheckPrivileges: any }; +type MockAuthzOptions = + | { rejectCheckPrivileges: any } + | { resolveCheckPrivileges: { privileges: Array<{ privilege: string; authorized: boolean }> } }; const actions = new Actions('1.0.0-zeta1'); const mockRequest = httpServerMock.createKibanaRequest(); @@ -26,7 +28,8 @@ const createMockAuthz = (options: MockAuthzOptions) => { throw options.rejectCheckPrivileges; } - expect(checkActions).toEqual(Object.keys(options.resolveCheckPrivileges.privileges)); + const expected = options.resolveCheckPrivileges.privileges.map(x => x.privilege); + expect(checkActions).toEqual(expected); return options.resolveCheckPrivileges; }); }); @@ -226,17 +229,17 @@ describe('usingPrivileges', () => { test(`disables ui capabilities when they don't have privileges`, async () => { const mockAuthz = createMockAuthz({ resolveCheckPrivileges: { - privileges: { - [actions.ui.get('navLinks', 'foo')]: true, - [actions.ui.get('navLinks', 'bar')]: false, - [actions.ui.get('navLinks', 'quz')]: false, - [actions.ui.get('management', 'kibana', 'indices')]: true, - [actions.ui.get('management', 'kibana', 'settings')]: false, - [actions.ui.get('fooFeature', 'foo')]: true, - [actions.ui.get('fooFeature', 'bar')]: false, - [actions.ui.get('barFeature', 'foo')]: true, - [actions.ui.get('barFeature', 'bar')]: false, - }, + privileges: [ + { privilege: actions.ui.get('navLinks', 'foo'), authorized: true }, + { privilege: actions.ui.get('navLinks', 'bar'), authorized: false }, + { privilege: actions.ui.get('navLinks', 'quz'), authorized: false }, + { privilege: actions.ui.get('management', 'kibana', 'indices'), authorized: true }, + { privilege: actions.ui.get('management', 'kibana', 'settings'), authorized: false }, + { privilege: actions.ui.get('fooFeature', 'foo'), authorized: true }, + { privilege: actions.ui.get('fooFeature', 'bar'), authorized: false }, + { privilege: actions.ui.get('barFeature', 'foo'), authorized: true }, + { privilege: actions.ui.get('barFeature', 'bar'), authorized: false }, + ], }, }); @@ -314,15 +317,15 @@ describe('usingPrivileges', () => { test(`doesn't re-enable disabled uiCapabilities`, async () => { const mockAuthz = createMockAuthz({ resolveCheckPrivileges: { - privileges: { - [actions.ui.get('navLinks', 'foo')]: true, - [actions.ui.get('navLinks', 'bar')]: true, - [actions.ui.get('management', 'kibana', 'indices')]: true, - [actions.ui.get('fooFeature', 'foo')]: true, - [actions.ui.get('fooFeature', 'bar')]: true, - [actions.ui.get('barFeature', 'foo')]: true, - [actions.ui.get('barFeature', 'bar')]: true, - }, + privileges: [ + { privilege: actions.ui.get('navLinks', 'foo'), authorized: true }, + { privilege: actions.ui.get('navLinks', 'bar'), authorized: true }, + { privilege: actions.ui.get('management', 'kibana', 'indices'), authorized: true }, + { privilege: actions.ui.get('fooFeature', 'foo'), authorized: true }, + { privilege: actions.ui.get('fooFeature', 'bar'), authorized: true }, + { privilege: actions.ui.get('barFeature', 'foo'), authorized: true }, + { privilege: actions.ui.get('barFeature', 'bar'), authorized: true }, + ], }, }); diff --git a/x-pack/plugins/security/server/authorization/disable_ui_capabilities.ts b/x-pack/plugins/security/server/authorization/disable_ui_capabilities.ts index be26f52fbf756..f0f1a42ad0bd5 100644 --- a/x-pack/plugins/security/server/authorization/disable_ui_capabilities.ts +++ b/x-pack/plugins/security/server/authorization/disable_ui_capabilities.ts @@ -9,7 +9,7 @@ import { UICapabilities } from 'ui/capabilities'; import { KibanaRequest, Logger } from '../../../../../src/core/server'; import { Feature } from '../../../features/server'; -import { CheckPrivilegesAtResourceResponse } from './check_privileges'; +import { CheckPrivilegesResponse } from './check_privileges'; import { Authorization } from './index'; export function disableUICapabilitiesFactory( @@ -77,7 +77,7 @@ export function disableUICapabilitiesFactory( [] ); - let checkPrivilegesResponse: CheckPrivilegesAtResourceResponse; + let checkPrivilegesResponse: CheckPrivilegesResponse; try { const checkPrivilegesDynamically = authz.checkPrivilegesDynamicallyWithRequest(request); checkPrivilegesResponse = await checkPrivilegesDynamically(uiActions); @@ -105,7 +105,9 @@ export function disableUICapabilitiesFactory( } const action = authz.actions.ui.get(featureId, ...uiCapabilityParts); - return checkPrivilegesResponse.privileges[action] === true; + return checkPrivilegesResponse.privileges.some( + x => x.privilege === action && x.authorized === true + ); }; return mapValues(uiCapabilities, (featureUICapabilities, featureId) => { diff --git a/x-pack/plugins/security/server/plugin.ts b/x-pack/plugins/security/server/plugin.ts index 032d231fe798f..68acf68f46109 100644 --- a/x-pack/plugins/security/server/plugin.ts +++ b/x-pack/plugins/security/server/plugin.ts @@ -149,6 +149,7 @@ export class Plugin { auditLogger: new SecurityAuditLogger(() => this.getLegacyAPI().auditLogger), authz, savedObjects: core.savedObjects, + getSpacesService: this.getSpacesService, }); core.capabilities.registerSwitcher(authz.disableUnauthorizedCapabilities); diff --git a/x-pack/plugins/security/server/saved_objects/index.ts b/x-pack/plugins/security/server/saved_objects/index.ts index 5954729562847..7dac745fcf84b 100644 --- a/x-pack/plugins/security/server/saved_objects/index.ts +++ b/x-pack/plugins/security/server/saved_objects/index.ts @@ -13,14 +13,21 @@ import { import { SecureSavedObjectsClientWrapper } from './secure_saved_objects_client_wrapper'; import { Authorization } from '../authorization'; import { SecurityAuditLogger } from '../audit'; +import { SpacesService } from '../plugin'; interface SetupSavedObjectsParams { auditLogger: SecurityAuditLogger; authz: Pick; savedObjects: CoreSetup['savedObjects']; + getSpacesService(): SpacesService | undefined; } -export function setupSavedObjects({ auditLogger, authz, savedObjects }: SetupSavedObjectsParams) { +export function setupSavedObjects({ + auditLogger, + authz, + savedObjects, + getSpacesService, +}: SetupSavedObjectsParams) { const getKibanaRequest = (request: KibanaRequest | LegacyRequest) => request instanceof KibanaRequest ? request : KibanaRequest.from(request); @@ -44,6 +51,7 @@ export function setupSavedObjects({ auditLogger, authz, savedObjects }: SetupSav kibanaRequest ), errors: SavedObjectsClient.errors, + getSpacesService, }) : client; }); diff --git a/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.test.ts b/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.test.ts index 3c04508e3a74a..3c4034e07f995 100644 --- a/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.test.ts +++ b/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.test.ts @@ -9,6 +9,11 @@ import { Actions } from '../authorization'; import { securityAuditLoggerMock } from '../audit/index.mock'; import { savedObjectsClientMock } from '../../../../../src/core/server/mocks'; import { SavedObjectsClientContract } from 'kibana/server'; +import { SavedObjectActions } from '../authorization/actions/saved_object'; + +let clientOpts: ReturnType; +let client: SecureSavedObjectsClientWrapper; +const USERNAME = Symbol(); const createSecureSavedObjectsClientWrapperOptions = () => { const actions = new Actions('some-version'); @@ -22,810 +27,677 @@ const createSecureSavedObjectsClientWrapperOptions = () => { const errors = ({ decorateForbiddenError: jest.fn().mockReturnValue(forbiddenError), decorateGeneralError: jest.fn().mockReturnValue(generalError), + isNotFoundError: jest.fn().mockReturnValue(false), } as unknown) as jest.Mocked; + const getSpacesService = jest.fn().mockReturnValue(true); return { actions, baseClient: savedObjectsClientMock.create(), checkSavedObjectsPrivilegesAsCurrentUser: jest.fn(), errors, + getSpacesService, auditLogger: securityAuditLoggerMock.create(), forbiddenError, generalError, }; }; -describe('#errors', () => { - test(`assigns errors from constructor to .errors`, () => { - const options = createSecureSavedObjectsClientWrapperOptions(); - const client = new SecureSavedObjectsClientWrapper(options); +const expectGeneralError = async (fn: Function, args: Record) => { + // mock the checkPrivileges.globally rejection + const rejection = new Error('An actual error would happen here'); + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue(rejection); + + await expect(fn.bind(client)(...Object.values(args))).rejects.toThrowError( + clientOpts.generalError + ); + expect(clientOpts.errors.decorateGeneralError).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); +}; + +/** + * Fails the first authorization check, passes any others + * Requires that function args are passed in as key/value pairs + * The argument properties must be in the correct order to be spread properly + */ +const expectForbiddenError = async (fn: Function, args: Record) => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure + ); + + await expect(fn.bind(client)(...Object.values(args))).rejects.toThrowError( + clientOpts.forbiddenError + ); + const getCalls = (clientOpts.actions.savedObject.get as jest.MockedFunction< + SavedObjectActions['get'] + >).mock.calls; + const actions = clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mock.calls[0][0]; + const spaceId = args.options?.namespace || 'default'; + + const ACTION = getCalls[0][1]; + const types = getCalls.map(x => x[0]); + const missing = [{ spaceId, privilege: actions[0] }]; // if there was more than one type, only the first type was unauthorized + const spaceIds = [spaceId]; + + expect(clientOpts.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( + USERNAME, + ACTION, + types, + spaceIds, + missing, + args + ); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); +}; + +const expectSuccess = async (fn: Function, args: Record) => { + const result = await fn.bind(client)(...Object.values(args)); + const getCalls = (clientOpts.actions.savedObject.get as jest.MockedFunction< + SavedObjectActions['get'] + >).mock.calls; + const ACTION = getCalls[0][1]; + const types = getCalls.map(x => x[0]); + const spaceIds = [args.options?.namespace || 'default']; + + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( + USERNAME, + ACTION, + types, + spaceIds, + args + ); + return result; +}; + +const expectPrivilegeCheck = async (fn: Function, args: Record) => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure + ); + + await expect(fn.bind(client)(...Object.values(args))).rejects.toThrow(); // test is simpler with error case + const getResults = (clientOpts.actions.savedObject.get as jest.MockedFunction< + SavedObjectActions['get'] + >).mock.results; + const actions = getResults.map(x => x.value); + + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledTimes(1); + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( + actions, + args.options?.namespace + ); +}; + +const expectObjectNamespaceFiltering = async (fn: Function, args: Record) => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementationOnce( + getMockCheckPrivilegesSuccess // privilege check for authorization + ); + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure // privilege check for namespace filtering + ); + + const authorizedNamespace = args.options.namespace || 'default'; + const namespaces = ['some-other-namespace', authorizedNamespace]; + const returnValue = { namespaces, foo: 'bar' }; + // we don't know which base client method will be called; mock them all + clientOpts.baseClient.create.mockReturnValue(returnValue as any); + clientOpts.baseClient.get.mockReturnValue(returnValue as any); + clientOpts.baseClient.update.mockReturnValue(returnValue as any); + + const result = await fn.bind(client)(...Object.values(args)); + expect(result).toEqual(expect.objectContaining({ namespaces: [authorizedNamespace, '?'] })); + + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledTimes(2); + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenLastCalledWith( + 'login:', + namespaces + ); +}; + +const expectObjectsNamespaceFiltering = async (fn: Function, args: Record) => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementationOnce( + getMockCheckPrivilegesSuccess // privilege check for authorization + ); + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure // privilege check for namespace filtering + ); + + const authorizedNamespace = args.options.namespace || 'default'; + const returnValue = { + saved_objects: [ + { namespaces: ['foo'] }, + { namespaces: [authorizedNamespace] }, + { namespaces: ['foo', authorizedNamespace] }, + ], + }; + + // we don't know which base client method will be called; mock them all + clientOpts.baseClient.bulkCreate.mockReturnValue(returnValue as any); + clientOpts.baseClient.bulkGet.mockReturnValue(returnValue as any); + clientOpts.baseClient.bulkUpdate.mockReturnValue(returnValue as any); + clientOpts.baseClient.find.mockReturnValue(returnValue as any); + + const result = await fn.bind(client)(...Object.values(args)); + expect(result).toEqual( + expect.objectContaining({ + saved_objects: [ + { namespaces: ['?'] }, + { namespaces: [authorizedNamespace] }, + { namespaces: [authorizedNamespace, '?'] }, + ], + }) + ); + + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledTimes(2); + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenLastCalledWith('login:', [ + 'foo', + authorizedNamespace, + ]); +}; + +function getMockCheckPrivilegesSuccess(actions: string | string[], namespaces?: string | string[]) { + const _namespaces = Array.isArray(namespaces) ? namespaces : [namespaces || 'default']; + const _actions = Array.isArray(actions) ? actions : [actions]; + return { + hasAllRequested: true, + username: USERNAME, + privileges: _namespaces + .map(resource => + _actions.map(action => ({ + resource, + privilege: action, + authorized: true, + })) + ) + .flat(), + }; +} + +/** + * Fails the authorization check for the first privilege, and passes any others + * This check may be for an action for two different types in the same namespace + * Or, it may be for an action for the same type in two different namespaces + * Either way, the first privilege check returned is false, and any others return true + */ +function getMockCheckPrivilegesFailure(actions: string | string[], namespaces?: string | string[]) { + const _namespaces = Array.isArray(namespaces) ? namespaces : [namespaces || 'default']; + const _actions = Array.isArray(actions) ? actions : [actions]; + return { + hasAllRequested: false, + username: USERNAME, + privileges: _namespaces + .map((resource, idxa) => + _actions.map((action, idxb) => ({ + resource, + privilege: action, + authorized: idxa > 0 || idxb > 0, + })) + ) + .flat(), + }; +} + +/** + * Before each test, create the Client with its Options + */ +beforeEach(() => { + clientOpts = createSecureSavedObjectsClientWrapperOptions(); + client = new SecureSavedObjectsClientWrapper(clientOpts); + + // succeed privilege checks by default + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesSuccess + ); +}); + +describe('#addToNamespaces', () => { + const type = 'foo'; + const id = `${type}-id`; + const newNs1 = 'foo-namespace'; + const newNs2 = 'bar-namespace'; + const namespaces = [newNs1, newNs2]; + const currentNs = 'default'; + const privilege1 = `mock-saved_object:${type}/create`; + const privilege2 = `mock-saved_object:${type}/update`; + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + await expectGeneralError(client.addToNamespaces, { type, id, namespaces }); + }); + + test(`throws decorated ForbiddenError when unauthorized to create in new space`, async () => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure + ); + + await expect(client.addToNamespaces(type, id, namespaces)).rejects.toThrowError( + clientOpts.forbiddenError + ); + + expect(clientOpts.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( + USERNAME, + 'addToNamespacesCreate', + [type], + namespaces.sort(), + [{ privilege: privilege1, spaceId: newNs1 }], + { id, type, namespaces, options: {} } + ); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); + }); + + test(`throws decorated ForbiddenError when unauthorized to update in current space`, async () => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementationOnce( + getMockCheckPrivilegesSuccess // create + ); + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure // update + ); + + await expect(client.addToNamespaces(type, id, namespaces)).rejects.toThrowError( + clientOpts.forbiddenError + ); + + expect(clientOpts.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledTimes(1); + expect( + clientOpts.auditLogger.savedObjectsAuthorizationFailure + ).toHaveBeenLastCalledWith( + USERNAME, + 'addToNamespacesUpdate', + [type], + [currentNs], + [{ privilege: privilege2, spaceId: currentNs }], + { id, type, namespaces, options: {} } + ); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledTimes(1); + }); + + test(`returns result of baseClient.addToNamespaces when authorized`, async () => { + const apiCallReturnValue = Symbol(); + clientOpts.baseClient.addToNamespaces.mockReturnValue(apiCallReturnValue as any); + + const result = await client.addToNamespaces(type, id, namespaces); + expect(result).toBe(apiCallReturnValue); + + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledTimes(2); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenNthCalledWith( + 1, + USERNAME, + 'addToNamespacesCreate', // action for privilege check is 'create', but auditAction is 'addToNamespacesCreate' + [type], + namespaces.sort(), + { type, id, namespaces, options: {} } + ); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenNthCalledWith( + 2, + USERNAME, + 'addToNamespacesUpdate', // action for privilege check is 'update', but auditAction is 'addToNamespacesUpdate' + [type], + [currentNs], + { type, id, namespaces, options: {} } + ); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementationOnce( + getMockCheckPrivilegesSuccess // create + ); + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure // update + ); + + await expect(client.addToNamespaces(type, id, namespaces)).rejects.toThrow(); // test is simpler with error case + + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledTimes(2); + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenNthCalledWith( + 1, + [privilege1], + namespaces + ); + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenNthCalledWith( + 2, + [privilege2], + undefined // default namespace + ); + }); +}); + +describe('#bulkCreate', () => { + const attributes = { some: 'attr' }; + const obj1 = Object.freeze({ type: 'foo', otherThing: 'sup', attributes }); + const obj2 = Object.freeze({ type: 'bar', otherThing: 'everyone', attributes }); + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + const objects = [obj1]; + await expectGeneralError(client.bulkCreate, { objects }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + const objects = [obj1, obj2]; + await expectForbiddenError(client.bulkCreate, { objects, options }); + }); + + test(`returns result of baseClient.bulkCreate when authorized`, async () => { + const apiCallReturnValue = { saved_objects: [], foo: 'bar' }; + clientOpts.baseClient.bulkCreate.mockReturnValue(apiCallReturnValue as any); + + const objects = [obj1, obj2]; + const result = await expectSuccess(client.bulkCreate, { objects, options }); + expect(result).toEqual(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + const objects = [obj1, obj2]; + await expectPrivilegeCheck(client.bulkCreate, { objects, options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + const objects = [obj1, obj2]; + await expectObjectsNamespaceFiltering(client.bulkCreate, { objects, options }); + }); +}); + +describe('#bulkGet', () => { + const obj1 = Object.freeze({ type: 'foo', id: 'foo-id' }); + const obj2 = Object.freeze({ type: 'bar', id: 'bar-id' }); + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + const objects = [obj1]; + await expectGeneralError(client.bulkGet, { objects }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + const objects = [obj1, obj2]; + await expectForbiddenError(client.bulkGet, { objects, options }); + }); + + test(`returns result of baseClient.bulkGet when authorized`, async () => { + const apiCallReturnValue = { saved_objects: [], foo: 'bar' }; + clientOpts.baseClient.bulkGet.mockReturnValue(apiCallReturnValue as any); + + const objects = [obj1, obj2]; + const result = await expectSuccess(client.bulkGet, { objects, options }); + expect(result).toEqual(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + const objects = [obj1, obj2]; + await expectPrivilegeCheck(client.bulkGet, { objects, options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + const objects = [obj1, obj2]; + await expectObjectsNamespaceFiltering(client.bulkGet, { objects, options }); + }); +}); + +describe('#bulkUpdate', () => { + const obj1 = Object.freeze({ type: 'foo', id: 'foo-id', attributes: { some: 'attr' } }); + const obj2 = Object.freeze({ type: 'bar', id: 'bar-id', attributes: { other: 'attr' } }); + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + const objects = [obj1]; + await expectGeneralError(client.bulkUpdate, { objects }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + const objects = [obj1, obj2]; + await expectForbiddenError(client.bulkUpdate, { objects, options }); + }); + + test(`returns result of baseClient.bulkUpdate when authorized`, async () => { + const apiCallReturnValue = { saved_objects: [], foo: 'bar' }; + clientOpts.baseClient.bulkUpdate.mockReturnValue(apiCallReturnValue as any); + + const objects = [obj1, obj2]; + const result = await expectSuccess(client.bulkUpdate, { objects, options }); + expect(result).toEqual(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + const objects = [obj1, obj2]; + await expectPrivilegeCheck(client.bulkUpdate, { objects, options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + const objects = [obj1, obj2]; + await expectObjectsNamespaceFiltering(client.bulkUpdate, { objects, options }); + }); +}); + +describe('#create', () => { + const type = 'foo'; + const attributes = { some_attr: 's' }; + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when checkPrivileges.globally rejects promise`, async () => { + await expectGeneralError(client.create, { type }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + await expectForbiddenError(client.create, { type, attributes, options }); + }); + + test(`returns result of baseClient.create when authorized`, async () => { + const apiCallReturnValue = Symbol(); + clientOpts.baseClient.create.mockResolvedValue(apiCallReturnValue as any); + + const result = await expectSuccess(client.create, { type, attributes, options }); + expect(result).toBe(apiCallReturnValue); + }); - expect(client.errors).toBe(options.errors); + test(`checks privileges for user, actions, and namespace`, async () => { + await expectPrivilegeCheck(client.create, { type, attributes, options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + await expectObjectNamespaceFiltering(client.create, { type, attributes, options }); }); }); -describe(`spaces disabled`, () => { - describe('#create', () => { - test(`throws decorated GeneralError when checkPrivileges.globally rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.create(type)).rejects.toThrowError(options.generalError); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'create')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type = 'foo'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { [options.actions.savedObject.get(type, 'create')]: false }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const attributes = { some_attr: 's' }; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.create(type, attributes, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'create')], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'create', - [type], - [options.actions.savedObject.get(type, 'create')], - { type, attributes, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.create when authorized`, async () => { - const type = 'foo'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { [options.actions.savedObject.get(type, 'create')]: true }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.create.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const attributes = { some_attr: 's' }; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.create(type, attributes, apiCallOptions)).resolves.toBe( - apiCallReturnValue - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'create')], - apiCallOptions.namespace - ); - expect(options.baseClient.create).toHaveBeenCalledWith(type, attributes, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'create', - [type], - { type, attributes, options: apiCallOptions } - ); - }); - }); - - describe('#bulkCreate', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect( - client.bulkCreate([{ type, attributes: {} }], apiCallOptions) - ).rejects.toThrowError(options.generalError); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'bulk_create')], - apiCallOptions.namespace - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type1 = 'foo'; - const type2 = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type1, 'bulk_create')]: false, - [options.actions.savedObject.get(type2, 'bulk_create')]: true, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const objects = [ - { type: type1, attributes: {} }, - { type: type2, attributes: {} }, - ]; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.bulkCreate(objects, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [ - options.actions.savedObject.get(type1, 'bulk_create'), - options.actions.savedObject.get(type2, 'bulk_create'), - ], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'bulk_create', - [type1, type2], - [options.actions.savedObject.get(type1, 'bulk_create')], - { objects, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.bulkCreate when authorized`, async () => { - const type1 = 'foo'; - const type2 = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { - [options.actions.savedObject.get(type1, 'bulk_create')]: true, - [options.actions.savedObject.get(type2, 'bulk_create')]: true, - }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.bulkCreate.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const objects = [ - { type: type1, otherThing: 'sup', attributes: {} }, - { type: type2, otherThing: 'everyone', attributes: {} }, - ]; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.bulkCreate(objects, apiCallOptions)).resolves.toBe(apiCallReturnValue); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [ - options.actions.savedObject.get(type1, 'bulk_create'), - options.actions.savedObject.get(type2, 'bulk_create'), - ], - apiCallOptions.namespace - ); - expect(options.baseClient.bulkCreate).toHaveBeenCalledWith(objects, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'bulk_create', - [type1, type2], - { objects, options: apiCallOptions } - ); - }); - }); - - describe('#delete', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.delete(type, 'bar')).rejects.toThrowError(options.generalError); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'delete')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type = 'foo'; - const id = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type, 'delete')]: false, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.delete(type, id, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'delete')], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'delete', - [type], - [options.actions.savedObject.get(type, 'delete')], - { type, id, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of internalRepository.delete when authorized`, async () => { - const type = 'foo'; - const id = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { [options.actions.savedObject.get(type, 'delete')]: true }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.delete.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.delete(type, id, apiCallOptions)).resolves.toBe(apiCallReturnValue); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'delete')], - apiCallOptions.namespace - ); - expect(options.baseClient.delete).toHaveBeenCalledWith(type, id, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'delete', - [type], - { type, id, options: apiCallOptions } - ); - }); - }); - - describe('#find', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.find({ type })).rejects.toThrowError(options.generalError); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'find')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when type's singular and unauthorized`, async () => { - const type = 'foo'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { [options.actions.savedObject.get(type, 'find')]: false }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ type, namespace: 'some-ns' }); - await expect(client.find(apiCallOptions)).rejects.toThrowError(options.forbiddenError); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'find')], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'find', - [type], - [options.actions.savedObject.get(type, 'find')], - { options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when type's an array and unauthorized`, async () => { - const type1 = 'foo'; - const type2 = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type1, 'find')]: false, - [options.actions.savedObject.get(type2, 'find')]: true, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ type: [type1, type2], namespace: 'some-ns' }); - await expect(client.find(apiCallOptions)).rejects.toThrowError(options.forbiddenError); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [ - options.actions.savedObject.get(type1, 'find'), - options.actions.savedObject.get(type2, 'find'), - ], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'find', - [type1, type2], - [options.actions.savedObject.get(type1, 'find')], - { options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.find when authorized`, async () => { - const type = 'foo'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { [options.actions.savedObject.get(type, 'find')]: true }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.find.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ type, namespace: 'some-ns' }); - await expect(client.find(apiCallOptions)).resolves.toBe(apiCallReturnValue); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'find')], - apiCallOptions.namespace - ); - expect(options.baseClient.find).toHaveBeenCalledWith(apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'find', - [type], - { options: apiCallOptions } - ); - }); - }); - - describe('#bulkGet', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.bulkGet([{ id: 'bar', type }])).rejects.toThrowError( - options.generalError - ); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'bulk_get')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type1 = 'foo'; - const type2 = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type1, 'bulk_get')]: false, - [options.actions.savedObject.get(type2, 'bulk_get')]: true, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const objects = [ - { type: type1, id: `bar-${type1}` }, - { type: type2, id: `bar-${type2}` }, - ]; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.bulkGet(objects, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [ - options.actions.savedObject.get(type1, 'bulk_get'), - options.actions.savedObject.get(type2, 'bulk_get'), - ], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'bulk_get', - [type1, type2], - [options.actions.savedObject.get(type1, 'bulk_get')], - { objects, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.bulkGet when authorized`, async () => { - const type1 = 'foo'; - const type2 = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { - [options.actions.savedObject.get(type1, 'bulk_get')]: true, - [options.actions.savedObject.get(type2, 'bulk_get')]: true, - }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.bulkGet.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const objects = [ - { type: type1, id: `id-${type1}` }, - { type: type2, id: `id-${type2}` }, - ]; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.bulkGet(objects, apiCallOptions)).resolves.toBe(apiCallReturnValue); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [ - options.actions.savedObject.get(type1, 'bulk_get'), - options.actions.savedObject.get(type2, 'bulk_get'), - ], - apiCallOptions.namespace - ); - expect(options.baseClient.bulkGet).toHaveBeenCalledWith(objects, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'bulk_get', - [type1, type2], - { objects, options: apiCallOptions } - ); - }); - }); - - describe('#get', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.get(type, 'bar')).rejects.toThrowError(options.generalError); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'get')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type = 'foo'; - const id = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type, 'get')]: false, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.get(type, id, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'get')], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'get', - [type], - [options.actions.savedObject.get(type, 'get')], - { type, id, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.get when authorized`, async () => { - const type = 'foo'; - const id = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { [options.actions.savedObject.get(type, 'get')]: true }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.get.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.get(type, id, apiCallOptions)).resolves.toBe(apiCallReturnValue); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'get')], - apiCallOptions.namespace - ); - expect(options.baseClient.get).toHaveBeenCalledWith(type, id, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'get', - [type], - { type, id, options: apiCallOptions } - ); - }); - }); - - describe('#update', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.update(type, 'bar', {})).rejects.toThrowError(options.generalError); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'update')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type = 'foo'; - const id = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type, 'update')]: false, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const attributes = { some: 'attr' }; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.update(type, id, attributes, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'update')], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'update', - [type], - [options.actions.savedObject.get(type, 'update')], - { type, id, attributes, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.update when authorized`, async () => { - const type = 'foo'; - const id = 'bar'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { [options.actions.savedObject.get(type, 'update')]: true }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.update.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const attributes = { some: 'attr' }; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.update(type, id, attributes, apiCallOptions)).resolves.toBe( - apiCallReturnValue - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'update')], - apiCallOptions.namespace - ); - expect(options.baseClient.update).toHaveBeenCalledWith(type, id, attributes, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'update', - [type], - { type, id, attributes, options: apiCallOptions } - ); - }); - }); - - describe('#bulkUpdate', () => { - test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { - const type = 'foo'; - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockRejectedValue( - new Error('An actual error would happen here') - ); - const client = new SecureSavedObjectsClientWrapper(options); - - await expect(client.bulkUpdate([{ id: 'bar', type, attributes: {} }])).rejects.toThrowError( - options.generalError - ); - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'bulk_update')], - undefined - ); - expect(options.errors.decorateGeneralError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`throws decorated ForbiddenError when unauthorized`, async () => { - const type = 'foo'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: false, - username, - privileges: { - [options.actions.savedObject.get(type, 'bulk_update')]: false, - }, - }); - - const client = new SecureSavedObjectsClientWrapper(options); - - const objects = [{ type, id: `bar-${type}`, attributes: {} }]; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.bulkUpdate(objects, apiCallOptions)).rejects.toThrowError( - options.forbiddenError - ); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'bulk_update')], - apiCallOptions.namespace - ); - expect(options.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); - expect(options.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( - username, - 'bulk_update', - [type], - [options.actions.savedObject.get(type, 'bulk_update')], - { objects, options: apiCallOptions } - ); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); - }); - - test(`returns result of baseClient.bulkUpdate when authorized`, async () => { - const type = 'foo'; - const username = Symbol(); - const options = createSecureSavedObjectsClientWrapperOptions(); - options.checkSavedObjectsPrivilegesAsCurrentUser.mockResolvedValue({ - hasAllRequested: true, - username, - privileges: { - [options.actions.savedObject.get(type, 'bulk_update')]: true, - }, - }); - - const apiCallReturnValue = Symbol(); - options.baseClient.bulkUpdate.mockReturnValue(apiCallReturnValue as any); - - const client = new SecureSavedObjectsClientWrapper(options); - - const objects = [{ type, id: `id-${type}`, attributes: {} }]; - const apiCallOptions = Object.freeze({ namespace: 'some-ns' }); - await expect(client.bulkUpdate(objects, apiCallOptions)).resolves.toBe(apiCallReturnValue); - - expect(options.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( - [options.actions.savedObject.get(type, 'bulk_update')], - apiCallOptions.namespace - ); - expect(options.baseClient.bulkUpdate).toHaveBeenCalledWith(objects, apiCallOptions); - expect(options.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); - expect(options.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( - username, - 'bulk_update', - [type], - { objects, options: apiCallOptions } - ); - }); +describe('#delete', () => { + const type = 'foo'; + const id = `${type}-id`; + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + await expectGeneralError(client.delete, { type, id }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + await expectForbiddenError(client.delete, { type, id, options }); + }); + + test(`returns result of internalRepository.delete when authorized`, async () => { + const apiCallReturnValue = Symbol(); + clientOpts.baseClient.delete.mockReturnValue(apiCallReturnValue as any); + + const result = await expectSuccess(client.delete, { type, id, options }); + expect(result).toBe(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + await expectPrivilegeCheck(client.delete, { type, id, options }); + }); +}); + +describe('#find', () => { + const type1 = 'foo'; + const type2 = 'bar'; + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + await expectGeneralError(client.find, { type: type1 }); + }); + + test(`throws decorated ForbiddenError when type's singular and unauthorized`, async () => { + const options = Object.freeze({ type: type1, namespace: 'some-ns' }); + await expectForbiddenError(client.find, { options }); + }); + + test(`throws decorated ForbiddenError when type's an array and unauthorized`, async () => { + const options = Object.freeze({ type: [type1, type2], namespace: 'some-ns' }); + await expectForbiddenError(client.find, { options }); + }); + + test(`returns result of baseClient.find when authorized`, async () => { + const apiCallReturnValue = { saved_objects: [], foo: 'bar' }; + clientOpts.baseClient.find.mockReturnValue(apiCallReturnValue as any); + + const options = Object.freeze({ type: type1, namespace: 'some-ns' }); + const result = await expectSuccess(client.find, { options }); + expect(result).toEqual(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + const options = Object.freeze({ type: [type1, type2], namespace: 'some-ns' }); + await expectPrivilegeCheck(client.find, { options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + const options = Object.freeze({ type: [type1, type2], namespace: 'some-ns' }); + await expectObjectsNamespaceFiltering(client.find, { options }); + }); +}); + +describe('#get', () => { + const type = 'foo'; + const id = `${type}-id`; + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + await expectGeneralError(client.get, { type, id }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + await expectForbiddenError(client.get, { type, id, options }); + }); + + test(`returns result of baseClient.get when authorized`, async () => { + const apiCallReturnValue = Symbol(); + clientOpts.baseClient.get.mockReturnValue(apiCallReturnValue as any); + + const result = await expectSuccess(client.get, { type, id, options }); + expect(result).toBe(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + await expectPrivilegeCheck(client.get, { type, id, options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + await expectObjectNamespaceFiltering(client.get, { type, id, options }); + }); +}); + +describe('#deleteFromNamespaces', () => { + const type = 'foo'; + const id = `${type}-id`; + const namespace1 = 'foo-namespace'; + const namespace2 = 'bar-namespace'; + const namespaces = [namespace1, namespace2]; + const privilege = `mock-saved_object:${type}/delete`; + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + await expectGeneralError(client.deleteFromNamespaces, { type, id, namespaces }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure + ); + + await expect(client.deleteFromNamespaces(type, id, namespaces)).rejects.toThrowError( + clientOpts.forbiddenError + ); + + expect(clientOpts.errors.decorateForbiddenError).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).toHaveBeenCalledWith( + USERNAME, + 'deleteFromNamespaces', // action for privilege check is 'delete', but auditAction is 'deleteFromNamespaces' + [type], + namespaces.sort(), + [{ privilege, spaceId: namespace1 }], + { type, id, namespaces, options: {} } + ); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).not.toHaveBeenCalled(); + }); + + test(`returns result of baseClient.deleteFromNamespaces when authorized`, async () => { + const apiCallReturnValue = Symbol(); + clientOpts.baseClient.deleteFromNamespaces.mockReturnValue(apiCallReturnValue as any); + + const result = await client.deleteFromNamespaces(type, id, namespaces); + expect(result).toBe(apiCallReturnValue); + + expect(clientOpts.auditLogger.savedObjectsAuthorizationFailure).not.toHaveBeenCalled(); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledTimes(1); + expect(clientOpts.auditLogger.savedObjectsAuthorizationSuccess).toHaveBeenCalledWith( + USERNAME, + 'deleteFromNamespaces', // action for privilege check is 'delete', but auditAction is 'deleteFromNamespaces' + [type], + namespaces.sort(), + { type, id, namespaces, options: {} } + ); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + clientOpts.checkSavedObjectsPrivilegesAsCurrentUser.mockImplementation( + getMockCheckPrivilegesFailure + ); + + await expect(client.deleteFromNamespaces(type, id, namespaces)).rejects.toThrow(); // test is simpler with error case + + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledTimes(1); + expect(clientOpts.checkSavedObjectsPrivilegesAsCurrentUser).toHaveBeenCalledWith( + [privilege], + namespaces + ); + }); +}); + +describe('#update', () => { + const type = 'foo'; + const id = `${type}-id`; + const attributes = { some: 'attr' }; + const options = Object.freeze({ namespace: 'some-ns' }); + + test(`throws decorated GeneralError when hasPrivileges rejects promise`, async () => { + await expectGeneralError(client.update, { type, id, attributes }); + }); + + test(`throws decorated ForbiddenError when unauthorized`, async () => { + await expectForbiddenError(client.update, { type, id, attributes, options }); + }); + + test(`returns result of baseClient.update when authorized`, async () => { + const apiCallReturnValue = Symbol(); + clientOpts.baseClient.update.mockReturnValue(apiCallReturnValue as any); + + const result = await expectSuccess(client.update, { type, id, attributes, options }); + expect(result).toBe(apiCallReturnValue); + }); + + test(`checks privileges for user, actions, and namespace`, async () => { + await expectPrivilegeCheck(client.update, { type, id, attributes, options }); + }); + + test(`filters namespaces that the user doesn't have access to`, async () => { + await expectObjectNamespaceFiltering(client.update, { type, id, attributes, options }); + }); +}); + +describe('other', () => { + test(`assigns errors from constructor to .errors`, () => { + expect(client.errors).toBe(clientOpts.errors); }); }); diff --git a/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.ts b/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.ts index 2209e7fb66fcb..29503d475be73 100644 --- a/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.ts +++ b/x-pack/plugins/security/server/saved_objects/secure_saved_objects_client_wrapper.ts @@ -13,9 +13,13 @@ import { SavedObjectsCreateOptions, SavedObjectsFindOptions, SavedObjectsUpdateOptions, + SavedObjectsAddToNamespacesOptions, + SavedObjectsDeleteFromNamespacesOptions, } from '../../../../../src/core/server'; import { SecurityAuditLogger } from '../audit'; import { Actions, CheckSavedObjectsPrivileges } from '../authorization'; +import { CheckPrivilegesResponse } from '../authorization/check_privileges'; +import { SpacesService } from '../plugin'; interface SecureSavedObjectsClientWrapperOptions { actions: Actions; @@ -23,6 +27,19 @@ interface SecureSavedObjectsClientWrapperOptions { baseClient: SavedObjectsClientContract; errors: SavedObjectsClientContract['errors']; checkSavedObjectsPrivilegesAsCurrentUser: CheckSavedObjectsPrivileges; + getSpacesService(): SpacesService | undefined; +} + +interface SavedObjectNamespaces { + namespaces?: string[]; +} + +interface SavedObjectsNamespaces { + saved_objects: SavedObjectNamespaces[]; +} + +function uniq(arr: T[]): T[] { + return Array.from(new Set(arr)); } export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContract { @@ -30,19 +47,23 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra private readonly auditLogger: PublicMethodsOf; private readonly baseClient: SavedObjectsClientContract; private readonly checkSavedObjectsPrivilegesAsCurrentUser: CheckSavedObjectsPrivileges; + private getSpacesService: () => SpacesService | undefined; public readonly errors: SavedObjectsClientContract['errors']; + constructor({ actions, auditLogger, baseClient, checkSavedObjectsPrivilegesAsCurrentUser, errors, + getSpacesService, }: SecureSavedObjectsClientWrapperOptions) { this.errors = errors; this.actions = actions; this.auditLogger = auditLogger; this.baseClient = baseClient; this.checkSavedObjectsPrivilegesAsCurrentUser = checkSavedObjectsPrivilegesAsCurrentUser; + this.getSpacesService = getSpacesService; } public async create( @@ -52,7 +73,8 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra ) { await this.ensureAuthorized(type, 'create', options.namespace, { type, attributes, options }); - return await this.baseClient.create(type, attributes, options); + const savedObject = await this.baseClient.create(type, attributes, options); + return await this.redactSavedObjectNamespaces(savedObject); } public async bulkCreate( @@ -66,7 +88,8 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra { objects, options } ); - return await this.baseClient.bulkCreate(objects, options); + const response = await this.baseClient.bulkCreate(objects, options); + return await this.redactSavedObjectsNamespaces(response); } public async delete(type: string, id: string, options: SavedObjectsBaseOptions = {}) { @@ -78,7 +101,8 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra public async find(options: SavedObjectsFindOptions) { await this.ensureAuthorized(options.type, 'find', options.namespace, { options }); - return this.baseClient.find(options); + const response = await this.baseClient.find(options); + return await this.redactSavedObjectsNamespaces(response); } public async bulkGet( @@ -90,13 +114,15 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra options, }); - return await this.baseClient.bulkGet(objects, options); + const response = await this.baseClient.bulkGet(objects, options); + return await this.redactSavedObjectsNamespaces(response); } public async get(type: string, id: string, options: SavedObjectsBaseOptions = {}) { await this.ensureAuthorized(type, 'get', options.namespace, { type, id, options }); - return await this.baseClient.get(type, id, options); + const savedObject = await this.baseClient.get(type, id, options); + return await this.redactSavedObjectNamespaces(savedObject); } public async update( @@ -105,14 +131,44 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra attributes: Partial, options: SavedObjectsUpdateOptions = {} ) { - await this.ensureAuthorized(type, 'update', options.namespace, { - type, - id, - attributes, - options, - }); + const args = { type, id, attributes, options }; + await this.ensureAuthorized(type, 'update', options.namespace, args); - return await this.baseClient.update(type, id, attributes, options); + const savedObject = await this.baseClient.update(type, id, attributes, options); + return await this.redactSavedObjectNamespaces(savedObject); + } + + public async addToNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsAddToNamespacesOptions = {} + ) { + const args = { type, id, namespaces, options }; + const { namespace } = options; + // To share an object, the user must have the "create" permission in each of the destination namespaces. + await this.ensureAuthorized(type, 'create', namespaces, args, 'addToNamespacesCreate'); + + // To share an object, the user must also have the "update" permission in one or more of the source namespaces. Because the + // `addToNamespaces` operation is scoped to the current namespace, we can just check if the user has the "update" permission in the + // current namespace. If the user has permission, but the saved object doesn't exist in this namespace, the base client operation will + // result in a 404 error. + await this.ensureAuthorized(type, 'update', namespace, args, 'addToNamespacesUpdate'); + + return await this.baseClient.addToNamespaces(type, id, namespaces, options); + } + + public async deleteFromNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsDeleteFromNamespacesOptions = {} + ) { + const args = { type, id, namespaces, options }; + // To un-share an object, the user must have the "delete" permission in each of the target namespaces. + await this.ensureAuthorized(type, 'delete', namespaces, args, 'deleteFromNamespaces'); + + return await this.baseClient.deleteFromNamespaces(type, id, namespaces, options); } public async bulkUpdate( @@ -126,12 +182,16 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra { objects, options } ); - return await this.baseClient.bulkUpdate(objects, options); + const response = await this.baseClient.bulkUpdate(objects, options); + return await this.redactSavedObjectsNamespaces(response); } - private async checkPrivileges(actions: string | string[], namespace?: string) { + private async checkPrivileges( + actions: string | string[], + namespaceOrNamespaces?: string | string[] + ) { try { - return await this.checkSavedObjectsPrivilegesAsCurrentUser(actions, namespace); + return await this.checkSavedObjectsPrivilegesAsCurrentUser(actions, namespaceOrNamespaces); } catch (error) { throw this.errors.decorateGeneralError(error, error.body && error.body.reason); } @@ -140,43 +200,133 @@ export class SecureSavedObjectsClientWrapper implements SavedObjectsClientContra private async ensureAuthorized( typeOrTypes: string | string[], action: string, - namespace?: string, - args?: Record + namespaceOrNamespaces?: string | string[], + args?: Record, + auditAction: string = action, + requiresAll = true ) { const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes]; const actionsToTypesMap = new Map( types.map(type => [this.actions.savedObject.get(type, action), type]) ); const actions = Array.from(actionsToTypesMap.keys()); - const { hasAllRequested, username, privileges } = await this.checkPrivileges( - actions, - namespace - ); + const result = await this.checkPrivileges(actions, namespaceOrNamespaces); + + const { hasAllRequested, username, privileges } = result; + const spaceIds = uniq( + privileges.map(({ resource }) => resource).filter(x => x !== undefined) + ).sort() as string[]; - if (hasAllRequested) { - this.auditLogger.savedObjectsAuthorizationSuccess(username, action, types, args); + const isAuthorized = + (requiresAll && hasAllRequested) || + (!requiresAll && privileges.some(({ authorized }) => authorized)); + if (isAuthorized) { + this.auditLogger.savedObjectsAuthorizationSuccess( + username, + auditAction, + types, + spaceIds, + args + ); } else { const missingPrivileges = this.getMissingPrivileges(privileges); this.auditLogger.savedObjectsAuthorizationFailure( username, - action, + auditAction, types, + spaceIds, missingPrivileges, args ); - const msg = `Unable to ${action} ${missingPrivileges - .map(privilege => actionsToTypesMap.get(privilege)) - .sort() - .join(',')}`; + const targetTypes = uniq( + missingPrivileges.map(({ privilege }) => actionsToTypesMap.get(privilege)).sort() + ).join(','); + const msg = `Unable to ${action} ${targetTypes}`; throw this.errors.decorateForbiddenError(new Error(msg)); } } - private getMissingPrivileges(privileges: Record) { - return Object.keys(privileges).filter(privilege => !privileges[privilege]); + private getMissingPrivileges(privileges: CheckPrivilegesResponse['privileges']) { + return privileges + .filter(({ authorized }) => !authorized) + .map(({ resource, privilege }) => ({ spaceId: resource, privilege })); } private getUniqueObjectTypes(objects: Array<{ type: string }>) { - return [...new Set(objects.map(o => o.type))]; + return uniq(objects.map(o => o.type)); + } + + private async getNamespacesPrivilegeMap(namespaces: string[]) { + const action = this.actions.login; + const checkPrivilegesResult = await this.checkPrivileges(action, namespaces); + // check if the user can log into each namespace + const map = checkPrivilegesResult.privileges.reduce( + (acc: Record, { resource, authorized }) => { + // there should never be a case where more than one privilege is returned for a given space + // if there is, fail-safe (authorized + unauthorized = unauthorized) + if (resource && (!authorized || !acc.hasOwnProperty(resource))) { + acc[resource] = authorized; + } + return acc; + }, + {} + ); + return map; + } + + private redactAndSortNamespaces(spaceIds: string[], privilegeMap: Record) { + const comparator = (a: string, b: string) => { + const _a = a.toLowerCase(); + const _b = b.toLowerCase(); + if (_a === '?') { + return 1; + } else if (_a < _b) { + return -1; + } else if (_a > _b) { + return 1; + } + return 0; + }; + return spaceIds.map(spaceId => (privilegeMap[spaceId] ? spaceId : '?')).sort(comparator); + } + + private async redactSavedObjectNamespaces( + savedObject: T + ): Promise { + if (this.getSpacesService() === undefined || savedObject.namespaces == null) { + return savedObject; + } + + const privilegeMap = await this.getNamespacesPrivilegeMap(savedObject.namespaces); + + return { + ...savedObject, + namespaces: this.redactAndSortNamespaces(savedObject.namespaces, privilegeMap), + }; + } + + private async redactSavedObjectsNamespaces( + response: T + ): Promise { + if (this.getSpacesService() === undefined) { + return response; + } + const { saved_objects: savedObjects } = response; + const namespaces = uniq(savedObjects.flatMap(savedObject => savedObject.namespaces || [])); + if (namespaces.length === 0) { + return response; + } + + const privilegeMap = await this.getNamespacesPrivilegeMap(namespaces); + + return { + ...response, + saved_objects: savedObjects.map(savedObject => ({ + ...savedObject, + namespaces: + savedObject.namespaces && + this.redactAndSortNamespaces(savedObject.namespaces, privilegeMap), + })), + }; } } diff --git a/x-pack/plugins/spaces/public/management/edit_space/delete_spaces_button.tsx b/x-pack/plugins/spaces/public/management/edit_space/delete_spaces_button.tsx index 28e45bc8cfd2a..ea63905e27b26 100644 --- a/x-pack/plugins/spaces/public/management/edit_space/delete_spaces_button.tsx +++ b/x-pack/plugins/spaces/public/management/edit_space/delete_spaces_button.tsx @@ -99,10 +99,14 @@ export class DeleteSpacesButton extends Component { public deleteSpaces = async () => { const { spacesManager, space } = this.props; + this.setState({ + showConfirmDeleteModal: false, + }); + try { await spacesManager.deleteSpace(space); } catch (error) { - const { message: errorMessage = '' } = error.data || {}; + const { message: errorMessage = '' } = error.data || error.body || {}; this.props.notifications.toasts.addDanger( i18n.translate('xpack.spaces.management.deleteSpacesButton.deleteSpaceErrorTitle', { @@ -110,12 +114,9 @@ export class DeleteSpacesButton extends Component { values: { errorMessage }, }) ); + return; } - this.setState({ - showConfirmDeleteModal: false, - }); - const message = i18n.translate( 'xpack.spaces.management.deleteSpacesButton.spaceSuccessfullyDeletedNotificationMessage', { diff --git a/x-pack/plugins/spaces/public/management/spaces_grid/spaces_grid_page.tsx b/x-pack/plugins/spaces/public/management/spaces_grid/spaces_grid_page.tsx index ff4be84207832..df5e6a2ca34af 100644 --- a/x-pack/plugins/spaces/public/management/spaces_grid/spaces_grid_page.tsx +++ b/x-pack/plugins/spaces/public/management/spaces_grid/spaces_grid_page.tsx @@ -176,10 +176,14 @@ export class SpacesGridPage extends Component { return; } + this.setState({ + showConfirmDeleteModal: false, + }); + try { await spacesManager.deleteSpace(space); } catch (error) { - const { message: errorMessage = '' } = error.data || {}; + const { message: errorMessage = '' } = error.data || error.body || {}; this.props.notifications.toasts.addDanger( i18n.translate('xpack.spaces.management.spacesGridPage.errorDeletingSpaceErrorMessage', { @@ -189,12 +193,9 @@ export class SpacesGridPage extends Component { }, }) ); + return; } - this.setState({ - showConfirmDeleteModal: false, - }); - this.loadGrid(); const message = i18n.translate( diff --git a/x-pack/plugins/spaces/server/lib/copy_to_spaces/copy_to_spaces.test.ts b/x-pack/plugins/spaces/server/lib/copy_to_spaces/copy_to_spaces.test.ts index 59e157c3fc2db..72faab0d2c892 100644 --- a/x-pack/plugins/spaces/server/lib/copy_to_spaces/copy_to_spaces.test.ts +++ b/x-pack/plugins/spaces/server/lib/copy_to_spaces/copy_to_spaces.test.ts @@ -188,11 +188,13 @@ describe('copySavedObjectsToSpaces', () => { }, ], "savedObjectsClient": Object { + "addToNamespaces": [MockFunction], "bulkCreate": [MockFunction], "bulkGet": [MockFunction], "bulkUpdate": [MockFunction], "create": [MockFunction], "delete": [MockFunction], + "deleteFromNamespaces": [MockFunction], "errors": [Function], "find": [MockFunction], "get": [MockFunction], @@ -252,11 +254,13 @@ describe('copySavedObjectsToSpaces', () => { "readable": false, }, "savedObjectsClient": Object { + "addToNamespaces": [MockFunction], "bulkCreate": [MockFunction], "bulkGet": [MockFunction], "bulkUpdate": [MockFunction], "create": [MockFunction], "delete": [MockFunction], + "deleteFromNamespaces": [MockFunction], "errors": [Function], "find": [MockFunction], "get": [MockFunction], @@ -315,11 +319,13 @@ describe('copySavedObjectsToSpaces', () => { "readable": false, }, "savedObjectsClient": Object { + "addToNamespaces": [MockFunction], "bulkCreate": [MockFunction], "bulkGet": [MockFunction], "bulkUpdate": [MockFunction], "create": [MockFunction], "delete": [MockFunction], + "deleteFromNamespaces": [MockFunction], "errors": [Function], "find": [MockFunction], "get": [MockFunction], diff --git a/x-pack/plugins/spaces/server/lib/copy_to_spaces/resolve_copy_conflicts.test.ts b/x-pack/plugins/spaces/server/lib/copy_to_spaces/resolve_copy_conflicts.test.ts index 7809f1f8be66f..aa1d5e9a47832 100644 --- a/x-pack/plugins/spaces/server/lib/copy_to_spaces/resolve_copy_conflicts.test.ts +++ b/x-pack/plugins/spaces/server/lib/copy_to_spaces/resolve_copy_conflicts.test.ts @@ -204,11 +204,13 @@ describe('resolveCopySavedObjectsToSpacesConflicts', () => { }, ], "savedObjectsClient": Object { + "addToNamespaces": [MockFunction], "bulkCreate": [MockFunction], "bulkGet": [MockFunction], "bulkUpdate": [MockFunction], "create": [MockFunction], "delete": [MockFunction], + "deleteFromNamespaces": [MockFunction], "errors": [Function], "find": [MockFunction], "get": [MockFunction], @@ -275,11 +277,13 @@ describe('resolveCopySavedObjectsToSpacesConflicts', () => { }, ], "savedObjectsClient": Object { + "addToNamespaces": [MockFunction], "bulkCreate": [MockFunction], "bulkGet": [MockFunction], "bulkUpdate": [MockFunction], "create": [MockFunction], "delete": [MockFunction], + "deleteFromNamespaces": [MockFunction], "errors": [Function], "find": [MockFunction], "get": [MockFunction], @@ -345,11 +349,13 @@ describe('resolveCopySavedObjectsToSpacesConflicts', () => { }, ], "savedObjectsClient": Object { + "addToNamespaces": [MockFunction], "bulkCreate": [MockFunction], "bulkGet": [MockFunction], "bulkUpdate": [MockFunction], "create": [MockFunction], "delete": [MockFunction], + "deleteFromNamespaces": [MockFunction], "errors": [Function], "find": [MockFunction], "get": [MockFunction], diff --git a/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.test.ts b/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.test.ts index 74e75fb8f12c7..c83830f6feace 100644 --- a/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.test.ts +++ b/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.test.ts @@ -250,14 +250,10 @@ describe('#getAll', () => { mockAuthorization.mode.useRbacForRequest.mockReturnValue(true); mockCheckPrivilegesAtSpaces.mockReturnValue({ username, - spacePrivileges: { - [savedObjects[0].id]: { - [privilege]: false, - }, - [savedObjects[1].id]: { - [privilege]: false, - }, - }, + privileges: [ + { resource: savedObjects[0].id, privilege, authorized: false }, + { resource: savedObjects[1].id, privilege, authorized: false }, + ], }); const maxSpaces = 1234; const mockConfig = createMockConfig({ @@ -314,14 +310,10 @@ describe('#getAll', () => { mockAuthorization.mode.useRbacForRequest.mockReturnValue(true); mockCheckPrivilegesAtSpaces.mockReturnValue({ username, - spacePrivileges: { - [savedObjects[0].id]: { - [privilege]: true, - }, - [savedObjects[1].id]: { - [privilege]: false, - }, - }, + privileges: [ + { resource: savedObjects[0].id, privilege, authorized: true }, + { resource: savedObjects[1].id, privilege, authorized: false }, + ], }); const mockInternalRepository = { find: jest.fn().mockReturnValue({ diff --git a/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.ts b/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.ts index 22c34c03368e3..0c066fb76994f 100644 --- a/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.ts +++ b/x-pack/plugins/spaces/server/lib/spaces_client/spaces_client.ts @@ -74,16 +74,14 @@ export class SpacesClient { const privilege = privilegeFactory(this.authorization!); - const { username, spacePrivileges } = await checkPrivileges.atSpaces(spaceIds, privilege); + const { username, privileges } = await checkPrivileges.atSpaces(spaceIds, privilege); - const authorized = Object.keys(spacePrivileges).filter(spaceId => { - return spacePrivileges[spaceId][privilege]; - }); + const authorized = privileges.filter(x => x.authorized).map(x => x.resource); this.debugLogger( `SpacesClient.getAll(), authorized for ${ authorized.length - } spaces, derived from ES privilege check: ${JSON.stringify(spacePrivileges)}` + } spaces, derived from ES privilege check: ${JSON.stringify(privileges)}` ); if (authorized.length === 0) { @@ -94,7 +92,7 @@ export class SpacesClient { throw Boom.forbidden(); } - this.auditLogger.spacesAuthorizationSuccess(username, 'getAll', authorized); + this.auditLogger.spacesAuthorizationSuccess(username, 'getAll', authorized as string[]); const filteredSpaces: Space[] = spaces.filter((space: any) => authorized.includes(space.id)); this.debugLogger( `SpacesClient.getAll(), using RBAC. returning spaces: ${filteredSpaces @@ -211,9 +209,9 @@ export class SpacesClient { throw Boom.badRequest('This Space cannot be deleted because it is reserved.'); } - await repository.delete('space', id); - await repository.deleteByNamespace(id); + + await repository.delete('space', id); } private useRbac(): boolean { diff --git a/x-pack/plugins/spaces/server/routes/api/external/delete.test.ts b/x-pack/plugins/spaces/server/routes/api/external/delete.test.ts index f2ba8785f5a3f..511e9676940d2 100644 --- a/x-pack/plugins/spaces/server/routes/api/external/delete.test.ts +++ b/x-pack/plugins/spaces/server/routes/api/external/delete.test.ts @@ -11,7 +11,13 @@ import { mockRouteContext, mockRouteContextWithInvalidLicense, } from '../__fixtures__'; -import { CoreSetup, IRouter, kibanaResponseFactory, RouteValidatorConfig } from 'src/core/server'; +import { + CoreSetup, + IRouter, + kibanaResponseFactory, + RouteValidatorConfig, + SavedObjectsErrorHelpers, +} from 'src/core/server'; import { loggingServiceMock, httpServiceMock, @@ -75,6 +81,7 @@ describe('Spaces Public API', () => { return { routeValidation: routeDefinition.validate as RouteValidatorConfig<{}, {}, {}>, routeHandler, + savedObjectsRepositoryMock, }; }; @@ -143,6 +150,27 @@ describe('Spaces Public API', () => { expect(status).toEqual(404); }); + it(`returns http/400 when scripts cannot be executed in Elasticsearch`, async () => { + const { routeHandler, savedObjectsRepositoryMock } = await setup(); + + const request = httpServerMock.createKibanaRequest({ + params: { + id: 'a-space', + }, + method: 'delete', + }); + // @ts-ignore + savedObjectsRepositoryMock.deleteByNamespace.mockRejectedValue( + SavedObjectsErrorHelpers.decorateEsCannotExecuteScriptError(new Error()) + ); + const response = await routeHandler(mockRouteContext, request, kibanaResponseFactory); + + const { status, payload } = response; + + expect(status).toEqual(400); + expect(payload.message).toEqual('Cannot execute script in Elasticsearch query'); + }); + it(`DELETE spaces/{id}' cannot delete reserved spaces`, async () => { const { routeHandler } = await setup(); diff --git a/x-pack/plugins/spaces/server/routes/api/external/delete.ts b/x-pack/plugins/spaces/server/routes/api/external/delete.ts index 4b7e6b00182ac..150f1d198cdf6 100644 --- a/x-pack/plugins/spaces/server/routes/api/external/delete.ts +++ b/x-pack/plugins/spaces/server/routes/api/external/delete.ts @@ -4,6 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ +import Boom from 'boom'; import { schema } from '@kbn/config-schema'; import { SavedObjectsErrorHelpers } from '../../../../../../../src/core/server'; import { wrapError } from '../../../lib/errors'; @@ -12,7 +13,7 @@ import { ExternalRouteDeps } from '.'; import { createLicensedRouteHandler } from '../../lib'; export function initDeleteSpacesApi(deps: ExternalRouteDeps) { - const { externalRouter, spacesService } = deps; + const { externalRouter, log, spacesService } = deps; externalRouter.delete( { @@ -33,6 +34,13 @@ export function initDeleteSpacesApi(deps: ExternalRouteDeps) { } catch (error) { if (SavedObjectsErrorHelpers.isNotFoundError(error)) { return response.notFound(); + } else if (SavedObjectsErrorHelpers.isEsCannotExecuteScriptError(error)) { + log.error( + `Failed to delete space '${id}', cannot execute script in Elasticsearch query: ${error.message}` + ); + return response.customError( + wrapError(Boom.badRequest('Cannot execute script in Elasticsearch query')) + ); } return response.customError(wrapError(error)); } diff --git a/x-pack/plugins/spaces/server/routes/api/external/index.ts b/x-pack/plugins/spaces/server/routes/api/external/index.ts index 1bdb7ceb8a3f7..079f690bfe546 100644 --- a/x-pack/plugins/spaces/server/routes/api/external/index.ts +++ b/x-pack/plugins/spaces/server/routes/api/external/index.ts @@ -12,6 +12,8 @@ import { initPostSpacesApi } from './post'; import { initPutSpacesApi } from './put'; import { SpacesServiceSetup } from '../../../spaces_service/spaces_service'; import { initCopyToSpacesApi } from './copy_to_space'; +import { initShareAddSpacesApi } from './share_add_spaces'; +import { initShareRemoveSpacesApi } from './share_remove_spaces'; export interface ExternalRouteDeps { externalRouter: IRouter; @@ -28,4 +30,6 @@ export function initExternalSpacesApi(deps: ExternalRouteDeps) { initPostSpacesApi(deps); initPutSpacesApi(deps); initCopyToSpacesApi(deps); + initShareAddSpacesApi(deps); + initShareRemoveSpacesApi(deps); } diff --git a/x-pack/plugins/spaces/server/routes/api/external/share_add_spaces.ts b/x-pack/plugins/spaces/server/routes/api/external/share_add_spaces.ts new file mode 100644 index 0000000000000..f40cc5cc50572 --- /dev/null +++ b/x-pack/plugins/spaces/server/routes/api/external/share_add_spaces.ts @@ -0,0 +1,62 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { wrapError } from '../../../lib/errors'; +import { ExternalRouteDeps } from '.'; +import { SPACE_ID_REGEX } from '../../../lib/space_schema'; +import { createLicensedRouteHandler } from '../../lib'; + +const uniq = (arr: T[]): T[] => Array.from(new Set(arr)); +export function initShareAddSpacesApi(deps: ExternalRouteDeps) { + const { externalRouter, getStartServices } = deps; + + externalRouter.post( + { + path: '/api/spaces/_share_saved_object_add', + validate: { + body: schema.object({ + spaces: schema.arrayOf( + schema.string({ + validate: value => { + if (!SPACE_ID_REGEX.test(value)) { + return `lower case, a-z, 0-9, "_", and "-" are allowed`; + } + }, + }), + { + validate: spaceIds => { + if (!spaceIds.length) { + return 'must specify one or more space ids'; + } else if (uniq(spaceIds).length !== spaceIds.length) { + return 'duplicate space ids are not allowed'; + } + }, + } + ), + object: schema.object({ + type: schema.string(), + id: schema.string(), + }), + }), + }, + }, + createLicensedRouteHandler(async (_context, request, response) => { + const [startServices] = await getStartServices(); + const scopedClient = startServices.savedObjects.getScopedClient(request); + + const spaces = request.body.spaces; + const { type, id } = request.body.object; + + try { + await scopedClient.addToNamespaces(type, id, spaces); + } catch (error) { + return response.customError(wrapError(error)); + } + return response.noContent(); + }) + ); +} diff --git a/x-pack/plugins/spaces/server/routes/api/external/share_remove_spaces.ts b/x-pack/plugins/spaces/server/routes/api/external/share_remove_spaces.ts new file mode 100644 index 0000000000000..5f58a5dfd5e5f --- /dev/null +++ b/x-pack/plugins/spaces/server/routes/api/external/share_remove_spaces.ts @@ -0,0 +1,62 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { schema } from '@kbn/config-schema'; +import { wrapError } from '../../../lib/errors'; +import { ExternalRouteDeps } from '.'; +import { SPACE_ID_REGEX } from '../../../lib/space_schema'; +import { createLicensedRouteHandler } from '../../lib'; + +const uniq = (arr: T[]): T[] => Array.from(new Set(arr)); +export function initShareRemoveSpacesApi(deps: ExternalRouteDeps) { + const { externalRouter, getStartServices } = deps; + + externalRouter.post( + { + path: '/api/spaces/_share_saved_object_remove', + validate: { + body: schema.object({ + spaces: schema.arrayOf( + schema.string({ + validate: value => { + if (!SPACE_ID_REGEX.test(value)) { + return `lower case, a-z, 0-9, "_", and "-" are allowed`; + } + }, + }), + { + validate: spaceIds => { + if (!spaceIds.length) { + return 'must specify one or more space ids'; + } else if (uniq(spaceIds).length !== spaceIds.length) { + return 'duplicate space ids are not allowed'; + } + }, + } + ), + object: schema.object({ + type: schema.string(), + id: schema.string(), + }), + }), + }, + }, + createLicensedRouteHandler(async (_context, request, response) => { + const [startServices] = await getStartServices(); + const scopedClient = startServices.savedObjects.getScopedClient(request); + + const spaces = request.body.spaces; + const { type, id } = request.body.object; + + try { + await scopedClient.deleteFromNamespaces(type, id, spaces); + } catch (error) { + return response.customError(wrapError(error)); + } + return response.noContent(); + }) + ); +} diff --git a/x-pack/plugins/spaces/server/saved_objects/__snapshots__/spaces_saved_objects_client.test.ts.snap b/x-pack/plugins/spaces/server/saved_objects/__snapshots__/spaces_saved_objects_client.test.ts.snap deleted file mode 100644 index 8b1a258138355..0000000000000 --- a/x-pack/plugins/spaces/server/saved_objects/__snapshots__/spaces_saved_objects_client.test.ts.snap +++ /dev/null @@ -1,29 +0,0 @@ -// Jest Snapshot v1, https://goo.gl/fbAQLP - -exports[`default space #bulkCreate throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`default space #bulkGet throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`default space #create throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`default space #delete throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`default space #find throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`default space #get throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`default space #update throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #bulkCreate throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #bulkGet throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #create throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #delete throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #find throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #get throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; - -exports[`space_1 space #update throws error if options.namespace is specified 1`] = `"Spaces currently determines the namespaces"`; diff --git a/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.test.ts b/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.test.ts index 2d6fe36792c40..f9961329c088b 100644 --- a/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.test.ts +++ b/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.test.ts @@ -50,42 +50,41 @@ const createMockResponse = () => ({ references: [], }); +const ERROR_NAMESPACE_SPECIFIED = 'Spaces currently determines the namespaces'; + [ { id: DEFAULT_SPACE_ID, expectedNamespace: undefined }, { id: 'space_1', expectedNamespace: 'space_1' }, ].forEach(currentSpace => { describe(`${currentSpace.id} space`, () => { + const createSpacesSavedObjectsClient = async () => { + const request = createMockRequest(); + const baseClient = createMockClient(); + const spacesService = await createSpacesService(currentSpace.id); + + const client = new SpacesSavedObjectsClient({ + request, + baseClient, + spacesService, + typeRegistry, + }); + return { client, baseClient }; + }; + describe('#get', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); - await expect( - client.get('foo', '', { namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + await expect(client.get('foo', '', { namespace: 'bar' })).rejects.toThrow( + ERROR_NAMESPACE_SPECIFIED + ); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); const expectedReturnValue = createMockResponse(); baseClient.get.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const type = Symbol(); const id = Symbol(); const options = Object.freeze({ foo: 'bar' }); @@ -102,37 +101,17 @@ const createMockResponse = () => ({ describe('#bulkGet', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); await expect( client.bulkGet([{ id: '', type: 'foo' }], { namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const expectedReturnValue = { - saved_objects: [createMockResponse()], - }; + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); + const expectedReturnValue = { saved_objects: [createMockResponse()] }; baseClient.bulkGet.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const objects = [{ type: 'foo' }]; const options = Object.freeze({ foo: 'bar' }); @@ -149,25 +128,15 @@ const createMockResponse = () => ({ describe('#find', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); - await expect( - client.find({ type: 'foo', namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + await expect(client.find({ type: 'foo', namespace: 'bar' })).rejects.toThrow( + ERROR_NAMESPACE_SPECIFIED + ); }); test(`passes options.type to baseClient if valid singular type specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); + const { client, baseClient } = await createSpacesSavedObjectsClient(); const expectedReturnValue = { saved_objects: [createMockResponse()], total: 1, @@ -175,16 +144,8 @@ const createMockResponse = () => ({ page: 0, }; baseClient.find.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const options = Object.freeze({ type: 'foo' }); - const actualReturnValue = await client.find(options); expect(actualReturnValue).toBe(expectedReturnValue); @@ -194,9 +155,8 @@ const createMockResponse = () => ({ }); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); const expectedReturnValue = { saved_objects: [createMockResponse()], total: 1, @@ -204,14 +164,6 @@ const createMockResponse = () => ({ page: 0, }; baseClient.find.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const options = Object.freeze({ type: ['foo', 'bar'] }); const actualReturnValue = await client.find(options); @@ -226,35 +178,17 @@ const createMockResponse = () => ({ describe('#create', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); - await expect( - client.create('foo', {}, { namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + await expect(client.create('foo', {}, { namespace: 'bar' })).rejects.toThrow( + ERROR_NAMESPACE_SPECIFIED + ); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); const expectedReturnValue = createMockResponse(); baseClient.create.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const type = Symbol(); const attributes = Symbol(); @@ -272,37 +206,17 @@ const createMockResponse = () => ({ describe('#bulkCreate', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); await expect( client.bulkCreate([{ id: '', type: 'foo', attributes: {} }], { namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const expectedReturnValue = { - saved_objects: [createMockResponse()], - }; + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); + const expectedReturnValue = { saved_objects: [createMockResponse()] }; baseClient.bulkCreate.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const objects = [{ type: 'foo' }]; const options = Object.freeze({ foo: 'bar' }); @@ -319,36 +233,18 @@ const createMockResponse = () => ({ describe('#update', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); await expect( // @ts-ignore client.update(null, null, null, { namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); const expectedReturnValue = createMockResponse(); baseClient.update.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const type = Symbol(); const id = Symbol(); @@ -366,21 +262,19 @@ const createMockResponse = () => ({ }); describe('#bulkUpdate', () => { - test(`supplements options with the spaces namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const expectedReturnValue = { - saved_objects: [createMockResponse()], - }; - baseClient.bulkUpdate.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); + test(`throws error if options.namespace is specified`, async () => { + const { client } = await createSpacesSavedObjectsClient(); - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + await expect( + // @ts-ignore + client.bulkUpdate(null, { namespace: 'bar' }) + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); + }); + + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); + const expectedReturnValue = { saved_objects: [createMockResponse()] }; + baseClient.bulkUpdate.mockReturnValue(Promise.resolve(expectedReturnValue)); const actualReturnValue = await client.bulkUpdate([ { id: 'id', type: 'foo', attributes: {}, references: [] }, @@ -403,36 +297,18 @@ const createMockResponse = () => ({ describe('#delete', () => { test(`throws error if options.namespace is specified`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); + const { client } = await createSpacesSavedObjectsClient(); await expect( // @ts-ignore client.delete(null, null, { namespace: 'bar' }) - ).rejects.toThrowErrorMatchingSnapshot(); + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); }); - test(`supplements options with undefined namespace`, async () => { - const request = createMockRequest(); - const baseClient = createMockClient(); + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); const expectedReturnValue = createMockResponse(); baseClient.delete.mockReturnValue(Promise.resolve(expectedReturnValue)); - const spacesService = await createSpacesService(currentSpace.id); - - const client = new SpacesSavedObjectsClient({ - request, - baseClient, - spacesService, - typeRegistry, - }); const type = Symbol(); const id = Symbol(); @@ -447,5 +323,65 @@ const createMockResponse = () => ({ }); }); }); + + describe('#addToNamespaces', () => { + test(`throws error if options.namespace is specified`, async () => { + const { client } = await createSpacesSavedObjectsClient(); + + await expect( + // @ts-ignore + client.addToNamespaces(null, null, null, { namespace: 'bar' }) + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); + }); + + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); + const expectedReturnValue = createMockResponse(); + baseClient.addToNamespaces.mockReturnValue(Promise.resolve(expectedReturnValue)); + + const type = Symbol(); + const id = Symbol(); + const namespaces = Symbol(); + const options = Object.freeze({ foo: 'bar' }); + // @ts-ignore + const actualReturnValue = await client.addToNamespaces(type, id, namespaces, options); + + expect(actualReturnValue).toBe(expectedReturnValue); + expect(baseClient.addToNamespaces).toHaveBeenCalledWith(type, id, namespaces, { + foo: 'bar', + namespace: currentSpace.expectedNamespace, + }); + }); + }); + + describe('#deleteFromNamespaces', () => { + test(`throws error if options.namespace is specified`, async () => { + const { client } = await createSpacesSavedObjectsClient(); + + await expect( + // @ts-ignore + client.deleteFromNamespaces(null, null, null, { namespace: 'bar' }) + ).rejects.toThrow(ERROR_NAMESPACE_SPECIFIED); + }); + + test(`supplements options with the current namespace`, async () => { + const { client, baseClient } = await createSpacesSavedObjectsClient(); + const expectedReturnValue = createMockResponse(); + baseClient.deleteFromNamespaces.mockReturnValue(Promise.resolve(expectedReturnValue)); + + const type = Symbol(); + const id = Symbol(); + const namespaces = Symbol(); + const options = Object.freeze({ foo: 'bar' }); + // @ts-ignore + const actualReturnValue = await client.deleteFromNamespaces(type, id, namespaces, options); + + expect(actualReturnValue).toBe(expectedReturnValue); + expect(baseClient.deleteFromNamespaces).toHaveBeenCalledWith(type, id, namespaces, { + foo: 'bar', + namespace: currentSpace.expectedNamespace, + }); + }); + }); }); }); diff --git a/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.ts b/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.ts index f216d5743cf89..e31bc7cef6900 100644 --- a/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.ts +++ b/x-pack/plugins/spaces/server/saved_objects/spaces_saved_objects_client.ts @@ -13,6 +13,8 @@ import { SavedObjectsCreateOptions, SavedObjectsFindOptions, SavedObjectsUpdateOptions, + SavedObjectsAddToNamespacesOptions, + SavedObjectsDeleteFromNamespacesOptions, ISavedObjectTypeRegistry, } from 'src/core/server'; import { SpacesServiceSetup } from '../spaces_service/spaces_service'; @@ -213,6 +215,50 @@ export class SpacesSavedObjectsClient implements SavedObjectsClientContract { }); } + /** + * Adds namespaces to a SavedObject + * + * @param type + * @param id + * @param namespaces + * @param options + */ + public async addToNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsAddToNamespacesOptions = {} + ) { + throwErrorIfNamespaceSpecified(options); + + return await this.client.addToNamespaces(type, id, namespaces, { + ...options, + namespace: spaceIdToNamespace(this.spaceId), + }); + } + + /** + * Removes namespaces from a SavedObject + * + * @param type + * @param id + * @param namespaces + * @param options + */ + public async deleteFromNamespaces( + type: string, + id: string, + namespaces: string[], + options: SavedObjectsDeleteFromNamespacesOptions = {} + ) { + throwErrorIfNamespaceSpecified(options); + + return await this.client.deleteFromNamespaces(type, id, namespaces, { + ...options, + namespace: spaceIdToNamespace(this.spaceId), + }); + } + /** * Updates an array of objects by id * diff --git a/x-pack/plugins/uptime/server/rest_api/types.ts b/x-pack/plugins/uptime/server/rest_api/types.ts index aecb099b7bed5..e05e7a4d7faf1 100644 --- a/x-pack/plugins/uptime/server/rest_api/types.ts +++ b/x-pack/plugins/uptime/server/rest_api/types.ts @@ -10,7 +10,7 @@ import { RouteConfig, RouteMethod, CallAPIOptions, - SavedObjectsClient, + SavedObjectsClientContract, RequestHandlerContext, KibanaRequest, KibanaResponseFactory, @@ -69,18 +69,7 @@ export interface UMRouteParams { options?: CallAPIOptions | undefined ) => Promise; dynamicSettings: DynamicSettings; - savedObjectsClient: Pick< - SavedObjectsClient, - | 'errors' - | 'create' - | 'bulkCreate' - | 'delete' - | 'find' - | 'bulkGet' - | 'get' - | 'update' - | 'bulkUpdate' - >; + savedObjectsClient: SavedObjectsClientContract; } /** diff --git a/x-pack/test/api_integration/apis/spaces/saved_objects.ts b/x-pack/test/api_integration/apis/spaces/saved_objects.ts index 05f14a50f2170..7584be7fd8498 100644 --- a/x-pack/test/api_integration/apis/spaces/saved_objects.ts +++ b/x-pack/test/api_integration/apis/spaces/saved_objects.ts @@ -89,7 +89,7 @@ export default function({ getService }: FtrProviderContext) { .expect(404) .then((response: Record) => { expect(response.body).to.eql({ - message: 'Not Found', + message: 'Saved object [space/default] not found', statusCode: 404, error: 'Not Found', }); diff --git a/x-pack/test/saved_object_api_integration/common/config.ts b/x-pack/test/saved_object_api_integration/common/config.ts index dda7934ce875a..eaf7230a832a8 100644 --- a/x-pack/test/saved_object_api_integration/common/config.ts +++ b/x-pack/test/saved_object_api_integration/common/config.ts @@ -56,8 +56,10 @@ export function createTestConfig(name: string, options: CreateTestConfigOptions) ...config.xpack.api.get('kbnTestServer.serverArgs'), '--optimize.enabled=false', '--server.xsrf.disableProtection=true', + `--plugin-path=${path.join(__dirname, 'fixtures', 'isolated_type_plugin')}`, `--plugin-path=${path.join(__dirname, 'fixtures', 'namespace_agnostic_type_plugin')}`, `--plugin-path=${path.join(__dirname, 'fixtures', 'hidden_type_plugin')}`, + `--plugin-path=${path.join(__dirname, 'fixtures', 'shared_type_plugin')}`, ...disabledPlugins.map(key => `--xpack.${key}.enabled=false`), ], }, diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json b/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json index 34361ad9df542..d2c14189e2529 100644 --- a/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json +++ b/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json @@ -53,7 +53,7 @@ { "type": "doc", "value": { - "id": "index-pattern:91200a00-9efd-11e7-acb3-3dab96693fab", + "id": "index-pattern:defaultspace-index-pattern-id", "index": ".kibana", "source": { "index-pattern": { @@ -76,7 +76,7 @@ "source": { "config": { "buildNum": 8467, - "defaultIndex": "91200a00-9efd-11e7-acb3-3dab96693fab" + "defaultIndex": "defaultspace-index-pattern-id" }, "type": "config", "updated_at": "2017-09-21T18:49:16.302Z" @@ -88,15 +88,15 @@ { "type": "doc", "value": { - "id": "visualization:dd7caf20-9efd-11e7-acb3-3dab96693fab", + "id": "isolatedtype:defaultspace-isolatedtype-id", "index": ".kibana", "source": { - "type": "visualization", + "type": "isolatedtype", "updated_at": "2017-09-21T18:51:23.794Z", - "visualization": { + "isolatedtype": { "description": "", "kibanaSavedObjectMeta": { - "searchSourceJSON": "{\"index\":\"91200a00-9efd-11e7-acb3-3dab96693fab\",\"filter\":[],\"query\":{\"query\":\"\",\"language\":\"lucene\"}}" + "searchSourceJSON": "{\"index\":\"defaultspace-index-pattern-id\",\"filter\":[],\"query\":{\"query\":\"\",\"language\":\"lucene\"}}" }, "title": "Count of requests", "uiStateJSON": "{\"spy\":{\"mode\":{\"name\":null,\"fill\":false}}}", @@ -111,7 +111,7 @@ { "type": "doc", "value": { - "id": "dashboard:be3733a0-9efe-11e7-acb3-3dab96693fab", + "id": "dashboard:defaultspace-dashboard-id", "index": ".kibana", "source": { "dashboard": { @@ -121,7 +121,7 @@ "searchSourceJSON": "{\"query\":{\"query\":\"\",\"language\":\"lucene\"},\"filter\":[],\"highlightAll\":true,\"version\":true}" }, "optionsJSON": "{}", - "panelsJSON": "[{\"size_x\":6,\"size_y\":3,\"panelIndex\":1,\"type\":\"visualization\",\"id\":\"dd7caf20-9efd-11e7-acb3-3dab96693fab\",\"col\":1,\"row\":1}]", + "panelsJSON": "[{\"size_x\":6,\"size_y\":3,\"panelIndex\":1,\"type\":\"isolatedtype\",\"id\":\"defaultspace-isolatedtype-id\",\"col\":1,\"row\":1}]", "refreshInterval": { "display": "Off", "pause": false, @@ -144,7 +144,7 @@ { "type": "doc", "value": { - "id": "space_1:index-pattern:space_1-91200a00-9efd-11e7-acb3-3dab96693fab", + "id": "space_1:index-pattern:space1-index-pattern-id", "index": ".kibana", "source": { "index-pattern": { @@ -168,7 +168,7 @@ "source": { "config": { "buildNum": 8467, - "defaultIndex": "91200a00-9efd-11e7-acb3-3dab96693fab" + "defaultIndex": "defaultspace-index-pattern-id" }, "namespace": "space_1", "type": "config", @@ -181,16 +181,16 @@ { "type": "doc", "value": { - "id": "space_1:visualization:space_1-dd7caf20-9efd-11e7-acb3-3dab96693fab", + "id": "space_1:isolatedtype:space1-isolatedtype-id", "index": ".kibana", "source": { "namespace": "space_1", - "type": "visualization", + "type": "isolatedtype", "updated_at": "2017-09-21T18:51:23.794Z", - "visualization": { + "isolatedtype": { "description": "", "kibanaSavedObjectMeta": { - "searchSourceJSON": "{\"index\":\"space_1-91200a00-9efd-11e7-acb3-3dab96693fab\",\"filter\":[],\"query\":{\"query\":\"\",\"language\":\"lucene\"}}" + "searchSourceJSON": "{\"index\":\"space1-index-pattern-id\",\"filter\":[],\"query\":{\"query\":\"\",\"language\":\"lucene\"}}" }, "title": "Count of requests", "uiStateJSON": "{\"spy\":{\"mode\":{\"name\":null,\"fill\":false}}}", @@ -205,7 +205,7 @@ { "type": "doc", "value": { - "id": "space_1:dashboard:space_1-be3733a0-9efe-11e7-acb3-3dab96693fab", + "id": "space_1:dashboard:space1-dashboard-id", "index": ".kibana", "source": { "dashboard": { @@ -215,7 +215,7 @@ "searchSourceJSON": "{\"query\":{\"query\":\"\",\"language\":\"lucene\"},\"filter\":[],\"highlightAll\":true,\"version\":true}" }, "optionsJSON": "{}", - "panelsJSON": "[{\"size_x\":6,\"size_y\":3,\"panelIndex\":1,\"type\":\"visualization\",\"id\":\"space_1-dd7caf20-9efd-11e7-acb3-3dab96693fab\",\"col\":1,\"row\":1}]", + "panelsJSON": "[{\"size_x\":6,\"size_y\":3,\"panelIndex\":1,\"type\":\"isolatedtype\",\"id\":\"space1-isolatedtype-id\",\"col\":1,\"row\":1}]", "refreshInterval": { "display": "Off", "pause": false, @@ -239,7 +239,7 @@ { "type": "doc", "value": { - "id": "space_2:index-pattern:space_2-91200a00-9efd-11e7-acb3-3dab96693fab", + "id": "space_2:index-pattern:space2-index-pattern-id", "index": ".kibana", "source": { "index-pattern": { @@ -263,7 +263,7 @@ "source": { "config": { "buildNum": 8467, - "defaultIndex": "91200a00-9efd-11e7-acb3-3dab96693fab" + "defaultIndex": "defaultspace-index-pattern-id" }, "namespace": "space_2", "type": "config", @@ -276,16 +276,16 @@ { "type": "doc", "value": { - "id": "space_2:visualization:space_2-dd7caf20-9efd-11e7-acb3-3dab96693fab", + "id": "space_2:isolatedtype:space2-isolatedtype-id", "index": ".kibana", "source": { "namespace": "space_2", - "type": "visualization", + "type": "isolatedtype", "updated_at": "2017-09-21T18:51:23.794Z", - "visualization": { + "isolatedtype": { "description": "", "kibanaSavedObjectMeta": { - "searchSourceJSON": "{\"index\":\"space_2-91200a00-9efd-11e7-acb3-3dab96693fab\",\"filter\":[],\"query\":{\"query\":\"\",\"language\":\"lucene\"}}" + "searchSourceJSON": "{\"index\":\"space2-index-pattern-id\",\"filter\":[],\"query\":{\"query\":\"\",\"language\":\"lucene\"}}" }, "title": "Count of requests", "uiStateJSON": "{\"spy\":{\"mode\":{\"name\":null,\"fill\":false}}}", @@ -300,7 +300,7 @@ { "type": "doc", "value": { - "id": "space_2:dashboard:space_2-be3733a0-9efe-11e7-acb3-3dab96693fab", + "id": "space_2:dashboard:space2-dashboard-id", "index": ".kibana", "source": { "dashboard": { @@ -310,7 +310,7 @@ "searchSourceJSON": "{\"query\":{\"query\":\"\",\"language\":\"lucene\"},\"filter\":[],\"highlightAll\":true,\"version\":true}" }, "optionsJSON": "{}", - "panelsJSON": "[{\"size_x\":6,\"size_y\":3,\"panelIndex\":1,\"type\":\"visualization\",\"id\":\"space_2-dd7caf20-9efd-11e7-acb3-3dab96693fab\",\"col\":1,\"row\":1}]", + "panelsJSON": "[{\"size_x\":6,\"size_y\":3,\"panelIndex\":1,\"type\":\"isolatedtype\",\"id\":\"space2-isolatedtype-id\",\"col\":1,\"row\":1}]", "refreshInterval": { "display": "Off", "pause": false, @@ -334,11 +334,11 @@ { "type": "doc", "value": { - "id": "globaltype:8121a00-8efd-21e7-1cb3-34ab966434445", + "id": "globaltype:globaltype-id", "index": ".kibana", "source": { "globaltype": { - "name": "My favorite global object" + "title": "My favorite global object" }, "type": "globaltype", "updated_at": "2017-09-21T18:59:16.270Z" @@ -346,3 +346,54 @@ "type": "doc" } } + +{ + "type": "doc", + "value": { + "id": "sharedtype:default_and_space_1", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the default and space_1 spaces" + }, + "type": "sharedtype", + "namespaces": ["default", "space_1"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:only_space_1", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object only in space_1" + }, + "type": "sharedtype", + "namespaces": ["space_1"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:only_space_2", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object only in space_2" + }, + "type": "sharedtype", + "namespaces": ["space_2"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json b/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json index c2489f2a906c8..7b5b1d86f6bcc 100644 --- a/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json +++ b/x-pack/test/saved_object_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json @@ -82,7 +82,7 @@ }, "globaltype": { "properties": { - "name": { + "title": { "fields": { "keyword": { "ignore_above": 2048, @@ -147,9 +147,41 @@ } } }, + "isolatedtype": { + "properties": { + "description": { + "type": "text" + }, + "kibanaSavedObjectMeta": { + "properties": { + "searchSourceJSON": { + "type": "text" + } + } + }, + "savedSearchId": { + "type": "keyword" + }, + "title": { + "type": "text" + }, + "uiStateJSON": { + "type": "text" + }, + "version": { + "type": "integer" + }, + "visState": { + "type": "text" + } + } + }, "namespace": { "type": "keyword" }, + "namespaces": { + "type": "keyword" + }, "search": { "properties": { "columns": { @@ -186,6 +218,19 @@ } } }, + "sharedtype": { + "properties": { + "title": { + "type": "text", + "fields": { + "keyword": { + "type": "keyword", + "ignore_above": 2048 + } + } + } + } + }, "space": { "properties": { "_reserved": { @@ -282,35 +327,6 @@ "type": "text" } } - }, - "visualization": { - "properties": { - "description": { - "type": "text" - }, - "kibanaSavedObjectMeta": { - "properties": { - "searchSourceJSON": { - "type": "text" - } - } - }, - "savedSearchId": { - "type": "keyword" - }, - "title": { - "type": "text" - }, - "uiStateJSON": { - "type": "text" - }, - "version": { - "type": "integer" - }, - "visState": { - "type": "text" - } - } } } }, @@ -322,4 +338,4 @@ } } } -} \ No newline at end of file +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/index.js b/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/index.js index ea32811794c47..5989db84e2290 100644 --- a/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/index.js +++ b/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/index.js @@ -21,5 +21,7 @@ export default function(kibana) { }, config() {}, + + init() {}, // need empty init for plugin to load }); } diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/mappings.json b/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/mappings.json index e4815273964a1..45f898e10e2ba 100644 --- a/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/mappings.json +++ b/x-pack/test/saved_object_api_integration/common/fixtures/hidden_type_plugin/mappings.json @@ -1,7 +1,7 @@ { "hiddentype": { "properties": { - "name": { + "title": { "type": "text", "fields": { "keyword": { diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/index.js b/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/index.js new file mode 100644 index 0000000000000..a406c6737da5f --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/index.js @@ -0,0 +1,26 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import mappings from './mappings.json'; + +export default function(kibana) { + return new kibana.Plugin({ + require: ['kibana', 'elasticsearch', 'xpack_main'], + name: 'isolated_type_plugin', + uiExports: { + savedObjectsManagement: { + isolatedtype: { + isImportableAndExportable: true, + }, + }, + mappings, + }, + + config() {}, + + init() {}, // need empty init for plugin to load + }); +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/mappings.json b/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/mappings.json new file mode 100644 index 0000000000000..141ebbc93c290 --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/mappings.json @@ -0,0 +1,31 @@ +{ + "isolatedtype": { + "properties": { + "description": { + "type": "text" + }, + "kibanaSavedObjectMeta": { + "properties": { + "searchSourceJSON": { + "type": "text" + } + } + }, + "savedSearchId": { + "type": "keyword" + }, + "title": { + "type": "text" + }, + "uiStateJSON": { + "type": "text" + }, + "version": { + "type": "integer" + }, + "visState": { + "type": "text" + } + } + } +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/package.json b/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/package.json new file mode 100644 index 0000000000000..665ecb1b31d7e --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/fixtures/isolated_type_plugin/package.json @@ -0,0 +1,7 @@ +{ + "name": "isolated_type_plugin", + "version": "0.0.0", + "kibana": { + "version": "kibana" + } +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/namespace_agnostic_type_plugin/mappings.json b/x-pack/test/saved_object_api_integration/common/fixtures/namespace_agnostic_type_plugin/mappings.json index b30a2c3877b88..64d309b4209a2 100644 --- a/x-pack/test/saved_object_api_integration/common/fixtures/namespace_agnostic_type_plugin/mappings.json +++ b/x-pack/test/saved_object_api_integration/common/fixtures/namespace_agnostic_type_plugin/mappings.json @@ -1,7 +1,7 @@ { "globaltype": { "properties": { - "name": { + "title": { "type": "text", "fields": { "keyword": { diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/index.js b/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/index.js new file mode 100644 index 0000000000000..91a24fb9f4f56 --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/index.js @@ -0,0 +1,27 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import mappings from './mappings.json'; + +export default function(kibana) { + return new kibana.Plugin({ + require: ['kibana', 'elasticsearch', 'xpack_main'], + name: 'shared_type_plugin', + uiExports: { + savedObjectsManagement: {}, + savedObjectSchemas: { + sharedtype: { + multiNamespace: true, + }, + }, + mappings, + }, + + config() {}, + + init() {}, // need empty init for plugin to load + }); +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/mappings.json b/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/mappings.json new file mode 100644 index 0000000000000..918958aec0d6d --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/mappings.json @@ -0,0 +1,15 @@ +{ + "sharedtype": { + "properties": { + "title": { + "type": "text", + "fields": { + "keyword": { + "type": "keyword", + "ignore_above": 2048 + } + } + } + } + } +} diff --git a/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/package.json b/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/package.json new file mode 100644 index 0000000000000..c52f4256c5c06 --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/fixtures/shared_type_plugin/package.json @@ -0,0 +1,7 @@ +{ + "name": "shared_type_plugin", + "version": "0.0.0", + "kibana": { + "version": "kibana" + } +} diff --git a/x-pack/test/saved_object_api_integration/common/lib/saved_object_test_cases.ts b/x-pack/test/saved_object_api_integration/common/lib/saved_object_test_cases.ts new file mode 100644 index 0000000000000..b32950538f8e5 --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/lib/saved_object_test_cases.ts @@ -0,0 +1,40 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export const SAVED_OBJECT_TEST_CASES = Object.freeze({ + SINGLE_NAMESPACE_DEFAULT_SPACE: Object.freeze({ + type: 'isolatedtype', + id: 'defaultspace-isolatedtype-id', + }), + SINGLE_NAMESPACE_SPACE_1: Object.freeze({ + type: 'isolatedtype', + id: 'space1-isolatedtype-id', + }), + SINGLE_NAMESPACE_SPACE_2: Object.freeze({ + type: 'isolatedtype', + id: 'space2-isolatedtype-id', + }), + MULTI_NAMESPACE_DEFAULT_AND_SPACE_1: Object.freeze({ + type: 'sharedtype', + id: 'default_and_space_1', + }), + MULTI_NAMESPACE_ONLY_SPACE_1: Object.freeze({ + type: 'sharedtype', + id: 'only_space_1', + }), + MULTI_NAMESPACE_ONLY_SPACE_2: Object.freeze({ + type: 'sharedtype', + id: 'only_space_2', + }), + NAMESPACE_AGNOSTIC: Object.freeze({ + type: 'globaltype', + id: 'globaltype-id', + }), + HIDDEN: Object.freeze({ + type: 'hiddentype', + id: 'any', + }), +}); diff --git a/x-pack/test/saved_object_api_integration/common/lib/saved_object_test_utils.ts b/x-pack/test/saved_object_api_integration/common/lib/saved_object_test_utils.ts new file mode 100644 index 0000000000000..5640dfefa4f8d --- /dev/null +++ b/x-pack/test/saved_object_api_integration/common/lib/saved_object_test_utils.ts @@ -0,0 +1,302 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import expect from '@kbn/expect'; +import { SavedObjectsErrorHelpers } from '../../../../../src/core/server'; +import { SAVED_OBJECT_TEST_CASES as CASES } from './saved_object_test_cases'; +import { SPACES } from './spaces'; +import { AUTHENTICATION } from './authentication'; +import { TestCase, TestUser, ExpectResponseBody } from './types'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { + NOT_A_KIBANA_USER, + SUPERUSER, + KIBANA_LEGACY_USER, + KIBANA_DUAL_PRIVILEGES_USER, + KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, + KIBANA_RBAC_USER, + KIBANA_RBAC_DASHBOARD_ONLY_USER, + KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, + KIBANA_RBAC_DEFAULT_SPACE_READ_USER, + KIBANA_RBAC_SPACE_1_ALL_USER, + KIBANA_RBAC_SPACE_1_READ_USER, +} = AUTHENTICATION; + +export function getUrlPrefix(spaceId: string) { + return spaceId && spaceId !== DEFAULT_SPACE_ID ? `/s/${spaceId}` : ``; +} + +export function getExpectedSpaceIdProperty(spaceId: string) { + if (spaceId === DEFAULT_SPACE_ID) { + return {}; + } + return { + spaceId, + }; +} + +export const getTestTitle = ( + testCaseOrCases: TestCase | TestCase[], + bulkStatusCode?: 200 | 403 // only used for bulk test suites; other suites specify forbidden/permitted in each test case +) => { + const testCases = Array.isArray(testCaseOrCases) ? testCaseOrCases : [testCaseOrCases]; + const stringify = (array: TestCase[]) => array.map(x => `${x.type}/${x.id}`).join(); + if (bulkStatusCode === 403 || (testCases.length === 1 && testCases[0].failure === 403)) { + return `forbidden [${stringify(testCases)}]`; + } + if (testCases.find(x => x.failure === 403)) { + throw new Error( + 'Cannot create test title for multiple forbidden test cases; specify individual tests for each of these test cases' + ); + } + // permitted + const list: string[] = []; + Object.entries({ + success: undefined, + 'bad request': 400, + 'not found': 404, + conflict: 409, + }).forEach(([descriptor, failure]) => { + const filtered = testCases.filter(x => x.failure === failure); + if (filtered.length) { + list.push(`${descriptor} [${stringify(filtered)}]`); + } + }); + return `${list.join(' and ')}`; +}; + +export const testCaseFailures = { + // test suites need explicit return types for number primitives + fail400: (condition?: boolean): { failure?: 400 } => + condition !== false ? { failure: 400 } : {}, + fail404: (condition?: boolean): { failure?: 404 } => + condition !== false ? { failure: 404 } : {}, + fail409: (condition?: boolean): { failure?: 409 } => + condition !== false ? { failure: 409 } : {}, +}; + +/** + * Test cases have additional properties that we don't want to send in HTTP Requests + */ +export const createRequest = ({ type, id }: TestCase) => ({ type, id }); + +const uniq = (arr: T[]): T[] => Array.from(new Set(arr)); +const isNamespaceAgnostic = (type: string) => type === 'globaltype'; +const isMultiNamespace = (type: string) => type === 'sharedtype'; +export const expectResponses = { + forbidden: (action: string) => (typeOrTypes: string | string[]): ExpectResponseBody => async ( + response: Record + ) => { + const types = Array.isArray(typeOrTypes) ? typeOrTypes : [typeOrTypes]; + const uniqueSorted = uniq(types).sort(); + expect(response.body).to.eql({ + statusCode: 403, + error: 'Forbidden', + message: `Unable to ${action} ${uniqueSorted.join()}`, + }); + }, + permitted: async (object: Record, testCase: TestCase) => { + const { type, id, failure } = testCase; + if (failure) { + let error: ReturnType; + if (failure === 400) { + error = SavedObjectsErrorHelpers.createUnsupportedTypeError(type); + } else if (failure === 404) { + error = SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); + } else if (failure === 409) { + error = SavedObjectsErrorHelpers.createConflictError(type, id); + } else { + throw new Error(`Encountered unexpected error code ${failure}`); + } + // should not call permitted with a 403 failure case + if (object.type && object.id) { + // bulk request error + expect(object.type).to.eql(type); + expect(object.id).to.eql(id); + expect(object.error).to.eql(error.output.payload); + } else { + // non-bulk request error + expect(object.error).to.eql(error.output.payload.error); + expect(object.statusCode).to.eql(error.output.payload.statusCode); + // ignore the error.message, because it can vary for decorated non-bulk errors (e.g., conflict) + } + } else { + // fall back to default behavior of testing the success outcome + expect(object.type).to.eql(type); + if (id) { + expect(object.id).to.eql(id); + } else { + // created an object without specifying the ID, so it was auto-generated + expect(object.id).to.match(/^[0-9a-f-]{36}$/); + } + expect(object).not.to.have.property('error'); + expect(object.updated_at).to.match(/^[\d-]{10}T[\d:\.]{12}Z$/); + // don't test attributes, version, or references + } + }, + /** + * Additional assertions that we use in `bulk_create` and `create` to ensure that + * newly-created (or overwritten) objects don't have unexpected properties + */ + successCreated: async (es: any, spaceId: string, type: string, id: string) => { + const isNamespaceUndefined = + spaceId === SPACES.DEFAULT.spaceId || isNamespaceAgnostic(type) || isMultiNamespace(type); + const expectedSpacePrefix = isNamespaceUndefined ? '' : `${spaceId}:`; + const savedObject = await es.get({ + id: `${expectedSpacePrefix}${type}:${id}`, + index: '.kibana', + }); + const { namespace: actualNamespace, namespaces: actualNamespaces } = savedObject._source; + if (isNamespaceUndefined) { + expect(actualNamespace).to.eql(undefined); + } else { + expect(actualNamespace).to.eql(spaceId); + } + if (isMultiNamespace(type)) { + if (id === CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1.id) { + expect(actualNamespaces).to.eql([DEFAULT_SPACE_ID, SPACE_1_ID]); + } else if (id === CASES.MULTI_NAMESPACE_ONLY_SPACE_1.id) { + expect(actualNamespaces).to.eql([SPACE_1_ID]); + } else if (id === CASES.MULTI_NAMESPACE_ONLY_SPACE_2.id) { + expect(actualNamespaces).to.eql([SPACE_2_ID]); + } else { + // newly created in this space + expect(actualNamespaces).to.eql([spaceId]); + } + } + return savedObject; + }, +}; + +/** + * Get test scenarios for each type of suite. + * @param modifier Use this to generate additional permutations of test scenarios. + * For instance, a modifier of ['foo', 'bar'] would return + * a `securityAndSpaces` of: [ + * { spaceId: DEFAULT_SPACE_ID, users: {...}, modifier: 'foo' }, + * { spaceId: DEFAULT_SPACE_ID, users: {...}, modifier: 'bar' }, + * { spaceId: SPACE_1_ID, users: {...}, modifier: 'foo' }, + * { spaceId: SPACE_1_ID, users: {...}, modifier: 'bar' }, + * ] + */ +export const getTestScenarios = (modifiers?: T[]) => { + const commonUsers = { + noAccess: { ...NOT_A_KIBANA_USER, description: 'user with no access' }, + superuser: { ...SUPERUSER, description: 'superuser' }, + legacyAll: { ...KIBANA_LEGACY_USER, description: 'legacy user' }, + allGlobally: { ...KIBANA_RBAC_USER, description: 'rbac user with all globally' }, + readGlobally: { + ...KIBANA_RBAC_DASHBOARD_ONLY_USER, + description: 'rbac user with read globally', + }, + dualAll: { ...KIBANA_DUAL_PRIVILEGES_USER, description: 'dual-privileges user' }, + dualRead: { + ...KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, + description: 'dual-privileges readonly user', + }, + }; + + interface Security { + modifier?: T; + users: Record< + | keyof typeof commonUsers + | 'allAtDefaultSpace' + | 'readAtDefaultSpace' + | 'allAtSpace1' + | 'readAtSpace1', + TestUser + >; + } + interface SecurityAndSpaces { + modifier?: T; + users: Record< + keyof typeof commonUsers | 'allAtSpace' | 'readAtSpace' | 'allAtOtherSpace', + TestUser + >; + spaceId: string; + } + interface Spaces { + modifier?: T; + spaceId: string; + } + + let spaces: Spaces[] = [DEFAULT_SPACE_ID, SPACE_1_ID, SPACE_2_ID].map(x => ({ spaceId: x })); + let security: Security[] = [ + { + users: { + ...commonUsers, + allAtDefaultSpace: { + ...KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, + description: 'rbac user with all at default space', + }, + readAtDefaultSpace: { + ...KIBANA_RBAC_DEFAULT_SPACE_READ_USER, + description: 'rbac user with read at default space', + }, + allAtSpace1: { + ...KIBANA_RBAC_SPACE_1_ALL_USER, + description: 'rbac user with all at space_1', + }, + readAtSpace1: { + ...KIBANA_RBAC_SPACE_1_READ_USER, + description: 'rbac user with read at space_1', + }, + }, + }, + ]; + let securityAndSpaces: SecurityAndSpaces[] = [ + { + spaceId: DEFAULT_SPACE_ID, + users: { + ...commonUsers, + allAtSpace: { + ...KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, + description: 'user with all at the space', + }, + readAtSpace: { + ...KIBANA_RBAC_DEFAULT_SPACE_READ_USER, + description: 'user with read at the space', + }, + allAtOtherSpace: { + ...KIBANA_RBAC_SPACE_1_ALL_USER, + description: 'user with all at other space', + }, + }, + }, + { + spaceId: SPACE_1_ID, + users: { + ...commonUsers, + allAtSpace: { ...KIBANA_RBAC_SPACE_1_ALL_USER, description: 'user with all at the space' }, + readAtSpace: { + ...KIBANA_RBAC_SPACE_1_READ_USER, + description: 'user with read at the space', + }, + allAtOtherSpace: { + ...KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, + description: 'user with all at other space', + }, + }, + }, + ]; + if (modifiers) { + const addModifier = (list: T[]) => + list.map(x => modifiers.map(modifier => ({ ...x, modifier }))).flat(); + spaces = addModifier(spaces); + security = addModifier(security); + securityAndSpaces = addModifier(securityAndSpaces); + } + return { + spaces, + security, + securityAndSpaces, + }; +}; diff --git a/x-pack/test/saved_object_api_integration/common/lib/space_test_utils.ts b/x-pack/test/saved_object_api_integration/common/lib/space_test_utils.ts deleted file mode 100644 index 1619d77761c84..0000000000000 --- a/x-pack/test/saved_object_api_integration/common/lib/space_test_utils.ts +++ /dev/null @@ -1,24 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; - -export function getUrlPrefix(spaceId: string) { - return spaceId && spaceId !== DEFAULT_SPACE_ID ? `/s/${spaceId}` : ``; -} - -export function getIdPrefix(spaceId: string) { - return spaceId === DEFAULT_SPACE_ID ? '' : `${spaceId}-`; -} - -export function getExpectedSpaceIdProperty(spaceId: string) { - if (spaceId === DEFAULT_SPACE_ID) { - return {}; - } - return { - spaceId, - }; -} diff --git a/x-pack/test/saved_object_api_integration/common/lib/types.ts b/x-pack/test/saved_object_api_integration/common/lib/types.ts index 487afff1494c0..f6e6d391ae905 100644 --- a/x-pack/test/saved_object_api_integration/common/lib/types.ts +++ b/x-pack/test/saved_object_api_integration/common/lib/types.ts @@ -4,9 +4,28 @@ * you may not use this file except in compliance with the Elastic License. */ -export type DescribeFn = (text: string, fn: () => void) => void; +export type ExpectResponseBody = (response: Record) => Promise; -export interface TestDefinitionAuthentication { - username?: string; - password?: string; +export interface TestDefinition { + title: string; + responseStatusCode: number; + responseBody: ExpectResponseBody; +} + +export interface TestSuite { + user?: TestUser; + spaceId?: string; + tests: T[]; +} + +export interface TestCase { + type: string; + id: string; + failure?: 400 | 403 | 404 | 409; +} + +export interface TestUser { + username: string; + password: string; + description: string; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/bulk_create.ts b/x-pack/test/saved_object_api_integration/common/suites/bulk_create.ts index b6f1bb956d72d..0dafe6b7b386d 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/bulk_create.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/bulk_create.ts @@ -6,224 +6,137 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface BulkCreateTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; -} - -interface BulkCreateCustomTest extends BulkCreateTest { - description: string; - requestBody: { - [key: string]: any; - }; -} - -interface BulkCreateTests { - default: BulkCreateTest; - includingSpace: BulkCreateTest; - custom?: BulkCreateCustomTest; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface BulkCreateTestDefinition extends TestDefinition { + request: Array<{ type: string; id: string }>; + overwrite: boolean; } - -interface BulkCreateTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - tests: BulkCreateTests; +export type BulkCreateTestSuite = TestSuite; +export interface BulkCreateTestCase extends TestCase { + failure?: 400 | 409; // only used for permitted response case } -const createBulkRequests = (spaceId: string) => [ - { - type: 'visualization', - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - attributes: { - title: 'An existing visualization', - }, - }, - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - attributes: { - title: 'A great new dashboard', - }, - }, - { - type: 'globaltype', - id: '05976c65-1145-4858-bbf0-d225cc78a06e', - attributes: { - name: 'A new globaltype object', - }, - }, - { - type: 'globaltype', - id: '8121a00-8efd-21e7-1cb3-34ab966434445', - attributes: { - name: 'An existing globaltype', - }, - }, -]; +const NEW_ATTRIBUTE_KEY = 'title'; // all type mappings include this attribute, for simplicity's sake +const NEW_ATTRIBUTE_VAL = `New attribute value ${Date.now()}`; -const isGlobalType = (type: string) => type === 'globaltype'; +const NEW_SINGLE_NAMESPACE_OBJ = Object.freeze({ type: 'dashboard', id: 'new-dashboard-id' }); +const NEW_MULTI_NAMESPACE_OBJ = Object.freeze({ type: 'sharedtype', id: 'new-sharedtype-id' }); +const NEW_NAMESPACE_AGNOSTIC_OBJ = Object.freeze({ type: 'globaltype', id: 'new-globaltype-id' }); +export const TEST_CASES = Object.freeze({ + ...CASES, + NEW_SINGLE_NAMESPACE_OBJ, + NEW_MULTI_NAMESPACE_OBJ, + NEW_NAMESPACE_AGNOSTIC_OBJ, +}); export function bulkCreateTestSuiteFactory(es: any, esArchiver: any, supertest: SuperTest) { - const createExpectResults = (spaceId = DEFAULT_SPACE_ID) => async (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - saved_objects: [ - { - type: 'visualization', - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - error: { - message: 'version conflict, document already exists', - statusCode: 409, - }, - }, - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - updated_at: resp.body.saved_objects[1].updated_at, - version: resp.body.saved_objects[1].version, - attributes: { - title: 'A great new dashboard', - }, - references: [], - }, - { - type: 'globaltype', - id: `05976c65-1145-4858-bbf0-d225cc78a06e`, - updated_at: resp.body.saved_objects[2].updated_at, - version: resp.body.saved_objects[2].version, - attributes: { - name: 'A new globaltype object', - }, - references: [], - }, - { - type: 'globaltype', - id: '8121a00-8efd-21e7-1cb3-34ab966434445', - error: { - message: 'version conflict, document already exists', - statusCode: 409, - }, - }, - ], - }); - - for (const savedObject of createBulkRequests(spaceId)) { - const expectedSpacePrefix = - spaceId === DEFAULT_SPACE_ID || isGlobalType(savedObject.type) ? '' : `${spaceId}:`; - - // query ES directory to ensure namespace was or wasn't specified - const { _source } = await es.get({ - id: `${expectedSpacePrefix}${savedObject.type}:${savedObject.id}`, - index: '.kibana', - }); - - const { namespace: actualNamespace } = _source; - - if (spaceId === DEFAULT_SPACE_ID || isGlobalType(savedObject.type)) { - expect(actualNamespace).to.eql(undefined); - } else { - expect(actualNamespace).to.eql(spaceId); + const expectForbidden = expectResponses.forbidden('bulk_create'); + const expectResponseBody = ( + testCases: BulkCreateTestCase | BulkCreateTestCase[], + statusCode: 200 | 403, + spaceId = SPACES.DEFAULT.spaceId + ): ExpectResponseBody => async (response: Record) => { + const testCaseArray = Array.isArray(testCases) ? testCases : [testCases]; + if (statusCode === 403) { + const types = testCaseArray.map(x => x.type); + await expectForbidden(types)(response); + } else { + // permitted + const savedObjects = response.body.saved_objects; + expect(savedObjects).length(testCaseArray.length); + for (let i = 0; i < savedObjects.length; i++) { + const object = savedObjects[i]; + const testCase = testCaseArray[i]; + await expectResponses.permitted(object, testCase); + if (!testCase.failure) { + expect(object.attributes[NEW_ATTRIBUTE_KEY]).to.eql(NEW_ATTRIBUTE_VAL); + await expectResponses.successCreated(es, spaceId, object.type, object.id); + } } } }; - - const expectBadRequestForHiddenType = (resp: { [key: string]: any }) => { - const spaceEntry = resp.body.saved_objects.find( - (entry: any) => entry.id === 'my-hiddentype' && entry.type === 'hiddentype' - ); - expect(spaceEntry).to.eql({ - id: 'my-hiddentype', - type: 'hiddentype', - error: { - message: "Unsupported saved object type: 'hiddentype': Bad Request", - statusCode: 400, - error: 'Bad Request', + const createTestDefinitions = ( + testCases: BulkCreateTestCase | BulkCreateTestCase[], + forbidden: boolean, + overwrite: boolean, + options?: { + spaceId?: string; + singleRequest?: boolean; + responseBodyOverride?: ExpectResponseBody; + } + ): BulkCreateTestDefinition[] => { + const cases = Array.isArray(testCases) ? testCases : [testCases]; + const responseStatusCode = forbidden ? 403 : 200; + if (!options?.singleRequest) { + // if we are testing cases that should result in a forbidden response, we can do each case individually + // this ensures that multiple test cases of a single type will each result in a forbidden error + return cases.map(x => ({ + title: getTestTitle(x, responseStatusCode), + request: [createRequest(x)], + responseStatusCode, + responseBody: + options?.responseBodyOverride || + expectResponseBody(x, responseStatusCode, options?.spaceId), + overwrite, + })); + } + // batch into a single request to save time during test execution + return [ + { + title: getTestTitle(cases, responseStatusCode), + request: cases.map(x => createRequest(x)), + responseStatusCode, + responseBody: + options?.responseBodyOverride || + expectResponseBody(cases, responseStatusCode, options?.spaceId), + overwrite, }, - }); + ]; }; - const expectedForbiddenTypes = ['dashboard', 'globaltype', 'visualization']; - const expectedForbiddenTypesWithHiddenType = [ - 'dashboard', - 'globaltype', - 'hiddentype', - 'visualization', - ]; - const createExpectRbacForbidden = (types: string[] = expectedForbiddenTypes) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to bulk_create ${types.join(',')}`, - }); - }; - - const makeBulkCreateTest = (describeFn: DescribeFn) => ( + const makeBulkCreateTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: BulkCreateTestDefinition + definition: BulkCreateTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.default.statusCode}`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_create`) - .auth(user.username, user.password) - .send(createBulkRequests(spaceId)) - .expect(tests.default.statusCode) - .then(tests.default.response); - }); - - it(`including a hiddentype saved object should return ${tests.includingSpace.statusCode}`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_create`) - .auth(user.username, user.password) - .send( - createBulkRequests(spaceId).concat([ - { - type: 'hiddentype', - id: `my-hiddentype`, - attributes: { - name: 'My awesome hiddentype', - }, - }, - ]) - ) - .expect(tests.includingSpace.statusCode) - .then(tests.includingSpace.response); - }); + const attrs = { attributes: { [NEW_ATTRIBUTE_KEY]: NEW_ATTRIBUTE_VAL } }; - if (tests.custom) { - it(tests.custom!.description, async () => { + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const requestBody = test.request.map(x => ({ ...x, ...attrs })); + const query = test.overwrite ? '?overwrite=true' : ''; await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_create`) - .auth(user.username, user.password) - .send(tests.custom!.requestBody) - .expect(tests.custom!.statusCode) - .then(tests.custom!.response); + .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_create${query}`) + .auth(user?.username, user?.password) + .send(requestBody) + .expect(test.responseStatusCode) + .then(test.responseBody); }); } }); }; - const bulkCreateTest = makeBulkCreateTest(describe); + const addTests = makeBulkCreateTest(describe); // @ts-ignore - bulkCreateTest.only = makeBulkCreateTest(describe.only); + addTests.only = makeBulkCreateTest(describe.only); return { - bulkCreateTest, - createExpectResults, - createExpectRbacForbidden, - expectBadRequestForHiddenType, - expectedForbiddenTypesWithHiddenType, + addTests, + createTestDefinitions, + expectForbidden, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/bulk_get.ts b/x-pack/test/saved_object_api_integration/common/suites/bulk_get.ts index 9c5cc375502d1..f03dac597294c 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/bulk_get.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/bulk_get.ts @@ -6,203 +6,110 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; -interface BulkGetTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; +export interface BulkGetTestDefinition extends TestDefinition { + request: Array<{ type: string; id: string }>; } - -interface BulkGetTests { - default: BulkGetTest; - includingHiddenType: BulkGetTest; -} - -interface BulkGetTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - otherSpaceId?: string; - tests: BulkGetTests; +export type BulkGetTestSuite = TestSuite; +export interface BulkGetTestCase extends TestCase { + failure?: 400 | 404; // only used for permitted response case } -const createBulkRequests = (spaceId: string) => [ - { - type: 'visualization', - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - }, - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}does not exist`, - }, - { - type: 'globaltype', - id: '8121a00-8efd-21e7-1cb3-34ab966434445', - }, -]; +const DOES_NOT_EXIST = Object.freeze({ type: 'dashboard', id: 'does-not-exist' }); +export const TEST_CASES = Object.freeze({ ...CASES, DOES_NOT_EXIST }); export function bulkGetTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectNotFoundResults = (spaceId: string) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - saved_objects: [ - { - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - type: 'visualization', - error: { - statusCode: 404, - message: 'Not found', - }, - }, - { - id: `${getIdPrefix(spaceId)}does not exist`, - type: 'dashboard', - error: { - statusCode: 404, - message: 'Not found', - }, - }, - { - id: `8121a00-8efd-21e7-1cb3-34ab966434445`, - type: 'globaltype', - updated_at: '2017-09-21T18:59:16.270Z', - version: resp.body.saved_objects[2].version, - attributes: { - name: 'My favorite global object', - }, - references: [], - }, - ], - }); + const expectForbidden = expectResponses.forbidden('bulk_get'); + const expectResponseBody = ( + testCases: BulkGetTestCase | BulkGetTestCase[], + statusCode: 200 | 403 + ): ExpectResponseBody => async (response: Record) => { + const testCaseArray = Array.isArray(testCases) ? testCases : [testCases]; + if (statusCode === 403) { + const types = testCaseArray.map(x => x.type); + await expectForbidden(types)(response); + } else { + // permitted + const savedObjects = response.body.saved_objects; + expect(savedObjects).length(testCaseArray.length); + for (let i = 0; i < savedObjects.length; i++) { + const object = savedObjects[i]; + const testCase = testCaseArray[i]; + await expectResponses.permitted(object, testCase); + } + } }; - - const expectBadRequestForHiddenType = (resp: { [key: string]: any }) => { - const spaceEntry = resp.body.saved_objects.find( - (entry: any) => entry.id === 'my-hiddentype' && entry.type === 'hiddentype' - ); - expect(spaceEntry).to.eql({ - id: 'my-hiddentype', - type: 'hiddentype', - error: { - message: "Unsupported saved object type: 'hiddentype': Bad Request", - statusCode: 400, - error: 'Bad Request', + const createTestDefinitions = ( + testCases: BulkGetTestCase | BulkGetTestCase[], + forbidden: boolean, + options?: { + singleRequest?: boolean; + responseBodyOverride?: ExpectResponseBody; + } + ): BulkGetTestDefinition[] => { + const cases = Array.isArray(testCases) ? testCases : [testCases]; + const responseStatusCode = forbidden ? 403 : 200; + if (!options?.singleRequest) { + // if we are testing cases that should result in a forbidden response, we can do each case individually + // this ensures that multiple test cases of a single type will each result in a forbidden error + return cases.map(x => ({ + title: getTestTitle(x, responseStatusCode), + request: [createRequest(x)], + responseStatusCode, + responseBody: options?.responseBodyOverride || expectResponseBody(x, responseStatusCode), + })); + } + // batch into a single request to save time during test execution + return [ + { + title: getTestTitle(cases, responseStatusCode), + request: cases.map(x => createRequest(x)), + responseStatusCode, + responseBody: + options?.responseBodyOverride || expectResponseBody(cases, responseStatusCode), }, - }); + ]; }; - const expectedForbiddenTypes = ['dashboard', 'globaltype', 'visualization']; - const expectedForbiddenTypesWithHiddenType = [ - 'dashboard', - 'globaltype', - 'hiddentype', - 'visualization', - ]; - const createExpectRbacForbidden = (types: string[] = expectedForbiddenTypes) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to bulk_get ${types.join(',')}`, - }); - }; - - const createExpectResults = (spaceId = DEFAULT_SPACE_ID) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - saved_objects: [ - { - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - type: 'visualization', - migrationVersion: resp.body.saved_objects[0].migrationVersion, - updated_at: '2017-09-21T18:51:23.794Z', - version: resp.body.saved_objects[0].version, - attributes: { - title: 'Count of requests', - description: '', - version: 1, - // cheat for some of the more complex attributes - visState: resp.body.saved_objects[0].attributes.visState, - uiStateJSON: resp.body.saved_objects[0].attributes.uiStateJSON, - kibanaSavedObjectMeta: resp.body.saved_objects[0].attributes.kibanaSavedObjectMeta, - }, - references: [ - { - name: 'kibanaSavedObjectMeta.searchSourceJSON.index', - type: 'index-pattern', - id: `${getIdPrefix(spaceId)}91200a00-9efd-11e7-acb3-3dab96693fab`, - }, - ], - }, - { - id: `${getIdPrefix(spaceId)}does not exist`, - type: 'dashboard', - error: { - statusCode: 404, - message: 'Not found', - }, - }, - { - id: `8121a00-8efd-21e7-1cb3-34ab966434445`, - type: 'globaltype', - updated_at: '2017-09-21T18:59:16.270Z', - version: resp.body.saved_objects[2].version, - attributes: { - name: 'My favorite global object', - }, - references: [], - }, - ], - }); - }; - - const makeBulkGetTest = (describeFn: DescribeFn) => ( + const makeBulkGetTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: BulkGetTestDefinition + definition: BulkGetTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, otherSpaceId, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.default.statusCode}`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_get`) - .auth(user.username, user.password) - .send(createBulkRequests(otherSpaceId || spaceId)) - .expect(tests.default.statusCode) - .then(tests.default.response); - }); - - it(`with a hiddentype saved object included should return ${tests.includingHiddenType.statusCode}`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_get`) - .auth(user.username, user.password) - .send( - createBulkRequests(otherSpaceId || spaceId).concat([ - { - type: 'hiddentype', - id: `my-hiddentype`, - }, - ]) - ) - .expect(tests.includingHiddenType.statusCode) - .then(tests.includingHiddenType.response); - }); + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + await supertest + .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_get`) + .auth(user?.username, user?.password) + .send(test.request) + .expect(test.responseStatusCode) + .then(test.responseBody); + }); + } }); }; - const bulkGetTest = makeBulkGetTest(describe); + const addTests = makeBulkGetTest(describe); // @ts-ignore - bulkGetTest.only = makeBulkGetTest(describe.only); + addTests.only = makeBulkGetTest(describe.only); return { - bulkGetTest, - createExpectNotFoundResults, - createExpectResults, - createExpectRbacForbidden, - expectBadRequestForHiddenType, - expectedForbiddenTypesWithHiddenType, + addTests, + createTestDefinitions, + expectForbidden, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/bulk_update.ts b/x-pack/test/saved_object_api_integration/common/suites/bulk_update.ts index d14c5ccbd1d0e..e0e2118300ef4 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/bulk_update.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/bulk_update.ts @@ -6,234 +6,119 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface BulkUpdateTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; -} - -interface BulkUpdateTests { - spaceAware: BulkUpdateTest; - notSpaceAware: BulkUpdateTest; - hiddenType: BulkUpdateTest; - doesntExist: BulkUpdateTest; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface BulkUpdateTestDefinition extends TestDefinition { + request: Array<{ type: string; id: string }>; } - -interface BulkUpdateTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - otherSpaceId?: string; - tests: BulkUpdateTests; +export type BulkUpdateTestSuite = TestSuite; +export interface BulkUpdateTestCase extends TestCase { + failure?: 404; // only used for permitted response case } -export function bulkUpdateTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectNotFound = (type: string, id: string, spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - const [, savedObject] = resp.body.saved_objects; - expect(savedObject.error).eql({ - statusCode: 404, - error: 'Not Found', - message: `Saved object [${type}/${getIdPrefix(spaceId)}${id}] not found`, - }); - }; - - const createExpectDoesntExistNotFound = (spaceId?: string) => { - return createExpectNotFound('visualization', 'not an id', spaceId); - }; - - const createExpectSpaceAwareNotFound = (spaceId?: string) => { - return createExpectNotFound('visualization', 'dd7caf20-9efd-11e7-acb3-3dab96693fab', spaceId); - }; - - const expectHiddenTypeNotFound = createExpectNotFound( - 'hiddentype', - 'hiddentype_1', - DEFAULT_SPACE_ID - ); - - const createExpectRbacForbidden = (types: string[]) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to bulk_update ${types.join()}`, - }); - }; - - const expectDoesntExistRbacForbidden = createExpectRbacForbidden(['globaltype', 'visualization']); +const NEW_ATTRIBUTE_KEY = 'title'; // all type mappings include this attribute, for simplicity's sake +const NEW_ATTRIBUTE_VAL = `Updated attribute value ${Date.now()}`; - const expectNotSpaceAwareRbacForbidden = createExpectRbacForbidden(['globaltype']); +const DOES_NOT_EXIST = Object.freeze({ type: 'dashboard', id: 'does-not-exist' }); +export const TEST_CASES = Object.freeze({ ...CASES, DOES_NOT_EXIST }); - const expectHiddenTypeRbacForbidden = createExpectRbacForbidden(['globaltype', 'hiddentype']); - const expectHiddenTypeRbacForbiddenWithGlobalAllowed = createExpectRbacForbidden(['hiddentype']); - - const expectSpaceAwareRbacForbidden = createExpectRbacForbidden(['globaltype', 'visualization']); - - const expectNotSpaceAwareResults = (resp: { [key: string]: any }) => { - const [, savedObject] = resp.body.saved_objects; - // loose uuid validation - expect(savedObject) - .to.have.property('id') - .match(/^[0-9a-f-]{36}$/); - - // loose ISO8601 UTC time with milliseconds validation - expect(savedObject) - .to.have.property('updated_at') - .match(/^[\d-]{10}T[\d:\.]{12}Z$/); - - expect(savedObject).to.eql({ - id: savedObject.id, - type: 'globaltype', - updated_at: savedObject.updated_at, - version: savedObject.version, - attributes: { - name: 'My second favorite', - }, - }); +export function bulkUpdateTestSuiteFactory(esArchiver: any, supertest: SuperTest) { + const expectForbidden = expectResponses.forbidden('bulk_update'); + const expectResponseBody = ( + testCases: BulkUpdateTestCase | BulkUpdateTestCase[], + statusCode: 200 | 403 + ): ExpectResponseBody => async (response: Record) => { + const testCaseArray = Array.isArray(testCases) ? testCases : [testCases]; + if (statusCode === 403) { + const types = testCaseArray.map(x => x.type); + await expectForbidden(types)(response); + } else { + // permitted + const savedObjects = response.body.saved_objects; + expect(savedObjects).length(testCaseArray.length); + for (let i = 0; i < savedObjects.length; i++) { + const object = savedObjects[i]; + const testCase = testCaseArray[i]; + await expectResponses.permitted(object, testCase); + if (!testCase.failure) { + expect(object.attributes[NEW_ATTRIBUTE_KEY]).to.eql(NEW_ATTRIBUTE_VAL); + } + } + } }; - - const expectSpaceAwareResults = (resp: { [key: string]: any }) => { - const [, savedObject] = resp.body.saved_objects; - // loose uuid validation ignoring prefix - expect(savedObject) - .to.have.property('id') - .match(/[0-9a-f-]{36}$/); - - // loose ISO8601 UTC time with milliseconds validation - expect(savedObject) - .to.have.property('updated_at') - .match(/^[\d-]{10}T[\d:\.]{12}Z$/); - - expect(savedObject).to.eql({ - id: savedObject.id, - type: 'visualization', - updated_at: savedObject.updated_at, - version: savedObject.version, - attributes: { - title: 'My second favorite vis', + const createTestDefinitions = ( + testCases: BulkUpdateTestCase | BulkUpdateTestCase[], + forbidden: boolean, + options?: { + singleRequest?: boolean; + responseBodyOverride?: ExpectResponseBody; + } + ): BulkUpdateTestDefinition[] => { + const cases = Array.isArray(testCases) ? testCases : [testCases]; + const responseStatusCode = forbidden ? 403 : 200; + if (!options?.singleRequest) { + // if we are testing cases that should result in a forbidden response, we can do each case individually + // this ensures that multiple test cases of a single type will each result in a forbidden error + return cases.map(x => ({ + title: getTestTitle(x, responseStatusCode), + request: [createRequest(x)], + responseStatusCode, + responseBody: options?.responseBodyOverride || expectResponseBody(x, responseStatusCode), + })); + } + // batch into a single request to save time during test execution + return [ + { + title: getTestTitle(cases, responseStatusCode), + request: cases.map(x => createRequest(x)), + responseStatusCode, + responseBody: + options?.responseBodyOverride || expectResponseBody(cases, responseStatusCode), }, - }); + ]; }; - const makeBulkUpdateTest = (describeFn: DescribeFn) => ( + const makeBulkUpdateTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: BulkUpdateTestDefinition + definition: BulkUpdateTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, otherSpaceId, tests } = definition; - - // We add this type into all bulk updates - // to ensure that having additional items in the bulk - // update doesn't change the expected outcome overall - let updateCount = 0; - const generateNonSpaceAwareGlobalSavedObject = () => ({ - type: 'globaltype', - id: `8121a00-8efd-21e7-1cb3-34ab966434445`, - attributes: { - name: `Update #${++updateCount}`, - }, - }); + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.spaceAware.statusCode} for a space-aware doc`, async () => { - await supertest - .put(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_update`) - .auth(user.username, user.password) - .send([ - generateNonSpaceAwareGlobalSavedObject(), - { - type: 'visualization', - id: `${getIdPrefix(otherSpaceId || spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - attributes: { - title: 'My second favorite vis', - }, - }, - generateNonSpaceAwareGlobalSavedObject(), - ]) - .expect(tests.spaceAware.statusCode) - .then(tests.spaceAware.response); - }); - - it(`should return ${tests.notSpaceAware.statusCode} for a non space-aware doc`, async () => { - await supertest - .put(`${getUrlPrefix(otherSpaceId || spaceId)}/api/saved_objects/_bulk_update`) - .auth(user.username, user.password) - .send([ - generateNonSpaceAwareGlobalSavedObject(), - { - type: 'globaltype', - id: `8121a00-8efd-21e7-1cb3-34ab966434445`, - attributes: { - name: 'My second favorite', - }, - }, - generateNonSpaceAwareGlobalSavedObject(), - ]) - .expect(tests.notSpaceAware.statusCode) - .then(tests.notSpaceAware.response); - }); - it(`should return ${tests.hiddenType.statusCode} for hiddentype doc`, async () => { - await supertest - .put(`${getUrlPrefix(otherSpaceId || spaceId)}/api/saved_objects/_bulk_update`) - .auth(user.username, user.password) - .send([ - generateNonSpaceAwareGlobalSavedObject(), - { - type: 'hiddentype', - id: 'hiddentype_1', - attributes: { - name: 'My favorite hidden type', - }, - }, - generateNonSpaceAwareGlobalSavedObject(), - ]) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); - }); + const attrs = { attributes: { [NEW_ATTRIBUTE_KEY]: NEW_ATTRIBUTE_VAL } }; - describe('unknown id', () => { - it(`should return ${tests.doesntExist.statusCode}`, async () => { + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const requestBody = test.request.map(x => ({ ...x, ...attrs })); await supertest .put(`${getUrlPrefix(spaceId)}/api/saved_objects/_bulk_update`) - .auth(user.username, user.password) - .send([ - generateNonSpaceAwareGlobalSavedObject(), - { - type: 'visualization', - id: `${getIdPrefix(spaceId)}not an id`, - attributes: { - title: 'My second favorite vis', - }, - }, - generateNonSpaceAwareGlobalSavedObject(), - ]) - .expect(tests.doesntExist.statusCode) - .then(tests.doesntExist.response); + .auth(user?.username, user?.password) + .send(requestBody) + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); + } }); }; - const bulkUpdateTest = makeBulkUpdateTest(describe); + const addTests = makeBulkUpdateTest(describe); // @ts-ignore - bulkUpdateTest.only = makeBulkUpdateTest(describe.only); + addTests.only = makeBulkUpdateTest(describe.only); return { - createExpectDoesntExistNotFound, - createExpectSpaceAwareNotFound, - expectSpaceNotFound: expectHiddenTypeNotFound, - expectDoesntExistRbacForbidden, - expectNotSpaceAwareRbacForbidden, - expectNotSpaceAwareResults, - expectSpaceAwareRbacForbidden, - expectSpaceAwareResults, - expectHiddenTypeRbacForbidden, - expectHiddenTypeRbacForbiddenWithGlobalAllowed, - bulkUpdateTest, + addTests, + createTestDefinitions, + expectForbidden, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/create.ts b/x-pack/test/saved_object_api_integration/common/suites/create.ts index 29960c513d40f..f657756be92cd 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/create.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/create.ts @@ -3,206 +3,117 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ + import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface CreateTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; -} - -interface CreateCustomTest extends CreateTest { - type: string; - description: string; - requestBody: any; -} - -interface CreateTests { - spaceAware: CreateTest; - notSpaceAware: CreateTest; - hiddenType: CreateTest; - custom?: CreateCustomTest; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface CreateTestDefinition extends TestDefinition { + request: { type: string; id: string }; + overwrite: boolean; } - -interface CreateTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - tests: CreateTests; +export type CreateTestSuite = TestSuite; +export interface CreateTestCase extends TestCase { + failure?: 400 | 403 | 409; } -const spaceAwareType = 'visualization'; -const notSpaceAwareType = 'globaltype'; +const NEW_ATTRIBUTE_KEY = 'title'; // all type mappings include this attribute, for simplicity's sake +const NEW_ATTRIBUTE_VAL = `New attribute value ${Date.now()}`; + +// ID intentionally left blank on NEW_SINGLE_NAMESPACE_OBJ to ensure we can create saved objects without specifying the ID +// we could create six separate test cases to test every permutation, but there's no real value in doing so +const NEW_SINGLE_NAMESPACE_OBJ = Object.freeze({ type: 'dashboard', id: '' }); +const NEW_MULTI_NAMESPACE_OBJ = Object.freeze({ type: 'sharedtype', id: 'new-sharedtype-id' }); +const NEW_NAMESPACE_AGNOSTIC_OBJ = Object.freeze({ type: 'globaltype', id: 'new-globaltype-id' }); +export const TEST_CASES = Object.freeze({ + ...CASES, + NEW_SINGLE_NAMESPACE_OBJ, + NEW_MULTI_NAMESPACE_OBJ, + NEW_NAMESPACE_AGNOSTIC_OBJ, +}); export function createTestSuiteFactory(es: any, esArchiver: any, supertest: SuperTest) { - const createExpectRbacForbidden = (type: string) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to create ${type}`, - }); - }; - - const expectBadRequestForHiddenType = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - message: "Unsupported saved object type: 'hiddentype': Bad Request", - statusCode: 400, - error: 'Bad Request', - }); - }; - - const createExpectSpaceAwareResults = (spaceId = DEFAULT_SPACE_ID) => async (resp: { - [key: string]: any; - }) => { - expect(resp.body) - .to.have.property('id') - .match(/^[0-9a-f-]{36}$/); - - // loose ISO8601 UTC time with milliseconds validation - expect(resp.body) - .to.have.property('updated_at') - .match(/^[\d-]{10}T[\d:\.]{12}Z$/); - - expect(resp.body).to.eql({ - id: resp.body.id, - migrationVersion: resp.body.migrationVersion, - type: spaceAwareType, - updated_at: resp.body.updated_at, - version: resp.body.version, - attributes: { - title: 'My favorite vis', - }, - references: [], - }); - - const expectedSpacePrefix = spaceId === DEFAULT_SPACE_ID ? '' : `${spaceId}:`; - - // query ES directory to ensure namespace was or wasn't specified - const { _source } = await es.get({ - id: `${expectedSpacePrefix}${spaceAwareType}:${resp.body.id}`, - index: '.kibana', - }); - - const { namespace: actualNamespace } = _source; - - if (spaceId === DEFAULT_SPACE_ID) { - expect(actualNamespace).to.eql(undefined); + const expectForbidden = expectResponses.forbidden('create'); + const expectResponseBody = ( + testCase: CreateTestCase, + spaceId = SPACES.DEFAULT.spaceId + ): ExpectResponseBody => async (response: Record) => { + if (testCase.failure === 403) { + await expectForbidden(testCase.type)(response); } else { - expect(actualNamespace).to.eql(spaceId); + // permitted + const object = response.body; + await expectResponses.permitted(object, testCase); + if (!testCase.failure) { + expect(object.attributes[NEW_ATTRIBUTE_KEY]).to.eql(NEW_ATTRIBUTE_VAL); + await expectResponses.successCreated(es, spaceId, object.type, object.id); + } } }; - - const expectNotSpaceAwareRbacForbidden = createExpectRbacForbidden(notSpaceAwareType); - - const expectNotSpaceAwareResults = async (resp: { [key: string]: any }) => { - expect(resp.body) - .to.have.property('id') - .match(/^[0-9a-f-]{36}$/); - - // loose ISO8601 UTC time with milliseconds validation - expect(resp.body) - .to.have.property('updated_at') - .match(/^[\d-]{10}T[\d:\.]{12}Z$/); - - expect(resp.body).to.eql({ - id: resp.body.id, - type: notSpaceAwareType, - updated_at: resp.body.updated_at, - version: resp.body.version, - attributes: { - name: `Can't be contained to a space`, - }, - references: [], - }); - - // query ES directory to ensure namespace wasn't specified - const { _source } = await es.get({ - id: `${notSpaceAwareType}:${resp.body.id}`, - index: '.kibana', - }); - - const { namespace: actualNamespace } = _source; - - expect(actualNamespace).to.eql(undefined); + const createTestDefinitions = ( + testCases: CreateTestCase | CreateTestCase[], + forbidden: boolean, + overwrite: boolean, + options?: { + spaceId?: string; + responseBodyOverride?: ExpectResponseBody; + } + ): CreateTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 200, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x, options?.spaceId), + overwrite, + })); }; - const expectSpaceAwareRbacForbidden = createExpectRbacForbidden(spaceAwareType); - - const expectHiddenTypeRbacForbidden = createExpectRbacForbidden('hiddentype'); - - const makeCreateTest = (describeFn: DescribeFn) => ( + const makeCreateTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: CreateTestDefinition + definition: CreateTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; + describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.spaceAware.statusCode} for a space-aware type`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/${spaceAwareType}`) - .auth(user.username, user.password) - .send({ - attributes: { - title: 'My favorite vis', - }, - }) - .expect(tests.spaceAware.statusCode) - .then(tests.spaceAware.response); - }); - - it(`should return ${tests.notSpaceAware.statusCode} for a non space-aware type`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/${notSpaceAwareType}`) - .auth(user.username, user.password) - .send({ - attributes: { - name: `Can't be contained to a space`, - }, - }) - .expect(tests.notSpaceAware.statusCode) - .then(tests.notSpaceAware.response); - }); - - it(`should return ${tests.hiddenType.statusCode} for the hiddentype`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/hiddentype`) - .auth(user.username, user.password) - .send({ - attributes: { - name: `Can't be created via the Saved Objects API`, - }, - }) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); - }); - if (tests.custom) { - it(tests.custom.description, async () => { + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const { type, id } = test.request; + const path = `${type}${id ? `/${id}` : ''}`; + const requestBody = { attributes: { [NEW_ATTRIBUTE_KEY]: NEW_ATTRIBUTE_VAL } }; + const query = test.overwrite ? '?overwrite=true' : ''; await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/${tests.custom!.type}`) - .auth(user.username, user.password) - .send(tests.custom!.requestBody) - .expect(tests.custom!.statusCode) - .then(tests.custom!.response); + .post(`${getUrlPrefix(spaceId)}/api/saved_objects/${path}${query}`) + .auth(user?.username, user?.password) + .send(requestBody) + .expect(test.responseStatusCode) + .then(test.responseBody); }); } }); }; - const createTest = makeCreateTest(describe); + const addTests = makeCreateTest(describe); // @ts-ignore - createTest.only = makeCreateTest(describe.only); + addTests.only = makeCreateTest(describe.only); return { - createExpectSpaceAwareResults, - createTest, - expectNotSpaceAwareRbacForbidden, - expectNotSpaceAwareResults, - expectSpaceAwareRbacForbidden, - expectBadRequestForHiddenType, - expectHiddenTypeRbacForbidden, + addTests, + createTestDefinitions, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/delete.ts b/x-pack/test/saved_object_api_integration/common/suites/delete.ts index d96ae5446d732..2222aa0c97267 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/delete.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/delete.ts @@ -4,147 +4,97 @@ * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface DeleteTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; +import expect from '@kbn/expect/expect.js'; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface DeleteTestDefinition extends TestDefinition { + request: { type: string; id: string }; } - -interface DeleteTests { - spaceAware: DeleteTest; - notSpaceAware: DeleteTest; - hiddenType: DeleteTest; - invalidId: DeleteTest; +export type DeleteTestSuite = TestSuite; +export interface DeleteTestCase extends TestCase { + failure?: 403 | 404; } -interface DeleteTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - otherSpaceId?: string; - tests: DeleteTests; -} +const DOES_NOT_EXIST = Object.freeze({ type: 'dashboard', id: 'does-not-exist' }); +export const TEST_CASES = Object.freeze({ ...CASES, DOES_NOT_EXIST }); export function deleteTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectNotFound = (spaceId: string, type: string, id: string) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - statusCode: 404, - error: 'Not Found', - message: `Saved object [${type}/${getIdPrefix(spaceId)}${id}] not found`, - }); - }; - - const createExpectRbacForbidden = (type: string) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to delete ${type}`, - }); - }; - - const expectGenericNotFound = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 404, - error: 'Not Found', - message: `Not Found`, - }); - }; - - const createExpectSpaceAwareNotFound = (spaceId: string = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - createExpectNotFound(spaceId, 'dashboard', 'be3733a0-9efe-11e7-acb3-3dab96693fab')(resp); - }; - - const createExpectUnknownDocNotFound = (spaceId: string = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - createExpectNotFound(spaceId, 'dashboard', `not-a-real-id`)(resp); + const expectForbidden = expectResponses.forbidden('delete'); + const expectResponseBody = (testCase: DeleteTestCase): ExpectResponseBody => async ( + response: Record + ) => { + if (testCase.failure === 403) { + await expectForbidden(testCase.type)(response); + } else { + // permitted + const object = response.body; + if (testCase.failure) { + await expectResponses.permitted(object, testCase); + } else { + // the success response for `delete` is an empty object + expect(object).to.eql({}); + } + } }; - - const expectEmpty = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({}); + const createTestDefinitions = ( + testCases: DeleteTestCase | DeleteTestCase[], + forbidden: boolean, + options?: { + spaceId?: string; + responseBodyOverride?: ExpectResponseBody; + } + ): DeleteTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 200, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); }; - const expectRbacInvalidIdForbidden = createExpectRbacForbidden('dashboard'); - - const expectRbacNotSpaceAwareForbidden = createExpectRbacForbidden('globaltype'); - - const expectRbacSpaceAwareForbidden = createExpectRbacForbidden('dashboard'); - - const expectRbacHiddenTypeForbidden = createExpectRbacForbidden('hiddentype'); - - const makeDeleteTest = (describeFn: DescribeFn) => ( + const makeDeleteTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: DeleteTestDefinition + definition: DeleteTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, otherSpaceId, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.spaceAware.statusCode} when deleting a space-aware doc`, async () => - await supertest - .delete( - `${getUrlPrefix(spaceId)}/api/saved_objects/dashboard/${getIdPrefix( - otherSpaceId || spaceId - )}be3733a0-9efe-11e7-acb3-3dab96693fab` - ) - .auth(user.username, user.password) - .expect(tests.spaceAware.statusCode) - .then(tests.spaceAware.response)); - - it(`should return ${tests.notSpaceAware.statusCode} when deleting a non-space-aware doc`, async () => - await supertest - .delete( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/globaltype/8121a00-8efd-21e7-1cb3-34ab966434445` - ) - .auth(user.username, user.password) - .expect(tests.notSpaceAware.statusCode) - .then(tests.notSpaceAware.response)); - - it(`should return ${tests.hiddenType.statusCode} when deleting a hiddentype doc`, async () => - await supertest - .delete(`${getUrlPrefix(spaceId)}/api/saved_objects/hiddentype/hiddentype_1`) - .auth(user.username, user.password) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response)); - - it(`should return ${tests.invalidId.statusCode} when deleting an unknown doc`, async () => - await supertest - .delete( - `${getUrlPrefix(spaceId)}/api/saved_objects/dashboard/${getIdPrefix( - otherSpaceId || spaceId - )}not-a-real-id` - ) - .auth(user.username, user.password) - .expect(tests.invalidId.statusCode) - .then(tests.invalidId.response)); + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const { type, id } = test.request; + await supertest + .delete(`${getUrlPrefix(spaceId)}/api/saved_objects/${type}/${id}`) + .auth(user?.username, user?.password) + .expect(test.responseStatusCode) + .then(test.responseBody); + }); + } }); }; - const deleteTest = makeDeleteTest(describe); + const addTests = makeDeleteTest(describe); // @ts-ignore - deleteTest.only = makeDeleteTest(describe.only); + addTests.only = makeDeleteTest(describe.only); return { - expectGenericNotFound, - createExpectSpaceAwareNotFound, - createExpectUnknownDocNotFound, - deleteTest, - expectEmpty, - expectRbacInvalidIdForbidden, - expectRbacNotSpaceAwareForbidden, - expectRbacSpaceAwareForbidden, - expectRbacHiddenTypeForbidden, + addTests, + createTestDefinitions, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/export.ts b/x-pack/test/saved_object_api_integration/common/suites/export.ts index e6853096962ec..ddd43d42410ae 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/export.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/export.ts @@ -5,164 +5,191 @@ */ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { expectResponses, getUrlPrefix } from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; -interface ExportTest { - statusCode: number; - description: string; - response: (resp: { [key: string]: any }) => void; -} +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; -interface ExportTests { - spaceAwareType: ExportTest; - hiddenType: ExportTest; - noTypeOrObjects: ExportTest; +export interface ExportTestDefinition extends TestDefinition { + request: ReturnType; } - -interface ExportTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - tests: ExportTests; +export type ExportTestSuite = TestSuite; +export interface ExportTestCase { + title: string; + type: string; + id?: string; + successResult?: TestCase | TestCase[]; + failure?: 400 | 403; } +export const getTestCases = (spaceId?: string) => ({ + singleNamespaceObject: { + title: 'single-namespace object', + ...(spaceId === SPACE_1_ID + ? CASES.SINGLE_NAMESPACE_SPACE_1 + : spaceId === SPACE_2_ID + ? CASES.SINGLE_NAMESPACE_SPACE_2 + : CASES.SINGLE_NAMESPACE_DEFAULT_SPACE), + } as ExportTestCase, + singleNamespaceType: { + // this test explicitly ensures that single-namespace objects from other spaces are not returned + title: 'single-namespace type', + type: 'isolatedtype', + successResult: + spaceId === SPACE_1_ID + ? CASES.SINGLE_NAMESPACE_SPACE_1 + : spaceId === SPACE_2_ID + ? CASES.SINGLE_NAMESPACE_SPACE_2 + : CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + } as ExportTestCase, + multiNamespaceObject: { + title: 'multi-namespace object', + ...(spaceId === SPACE_1_ID + ? CASES.MULTI_NAMESPACE_ONLY_SPACE_1 + : spaceId === SPACE_2_ID + ? CASES.MULTI_NAMESPACE_ONLY_SPACE_2 + : CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1), + failure: 400, // multi-namespace types cannot be exported yet + } as ExportTestCase, + multiNamespaceType: { + title: 'multi-namespace type', + type: 'sharedtype', + // successResult: + // spaceId === SPACE_1_ID + // ? [CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, CASES.MULTI_NAMESPACE_ONLY_SPACE_1] + // : spaceId === SPACE_2_ID + // ? CASES.MULTI_NAMESPACE_ONLY_SPACE_2 + // : CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + failure: 400, // multi-namespace types cannot be exported yet + } as ExportTestCase, + namespaceAgnosticObject: { + title: 'namespace-agnostic object', + ...CASES.NAMESPACE_AGNOSTIC, + } as ExportTestCase, + namespaceAgnosticType: { + title: 'namespace-agnostic type', + type: 'globaltype', + successResult: CASES.NAMESPACE_AGNOSTIC, + } as ExportTestCase, + hiddenObject: { title: 'hidden object', ...CASES.HIDDEN, failure: 400 } as ExportTestCase, + hiddenType: { title: 'hidden type', type: 'hiddentype', failure: 400 } as ExportTestCase, +}); +export const createRequest = ({ type, id }: ExportTestCase) => + id ? { objects: [{ type, id }] } : { type }; +const getTestTitle = ({ failure, title }: ExportTestCase) => { + let description = 'success'; + if (failure === 400) { + description = 'bad request'; + } else if (failure === 403) { + description = 'forbidden'; + } + return `${description} ["${title}"]`; +}; + export function exportTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectRbacForbidden = (type: string) => (resp: { [key: string]: any }) => { - // In export only, the API uses "bulk_get" or "find" depending on the parameters it receives. - // The best that could be done here is to have an if statement to ensure at least one of the - // two errors has been thrown. - if (resp.body.message.indexOf(`bulk_get`) !== -1) { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to bulk_get ${type}`, + const expectForbiddenBulkGet = expectResponses.forbidden('bulk_get'); + const expectForbiddenFind = expectResponses.forbidden('find'); + const expectResponseBody = (testCase: ExportTestCase): ExpectResponseBody => async ( + response: Record + ) => { + const { type, id, successResult = { type, id }, failure } = testCase; + if (failure === 403) { + // In export only, the API uses "bulk_get" or "find" depending on the parameters it receives. + // The best that could be done here is to have an if statement to ensure at least one of the + // two errors has been thrown. + if (id) { + await expectForbiddenBulkGet(type)(response); + } else { + await expectForbiddenFind(type)(response); + } + } else if (failure === 400) { + // 400 + expect(response.body.error).to.eql('Bad Request'); + expect(response.body.statusCode).to.eql(failure); + if (id) { + expect(response.body.message).to.eql( + `Trying to export object(s) with non-exportable types: ${type}:${id}` + ); + } else { + expect(response.body.message).to.eql(`Trying to export non-exportable type(s): ${type}`); + } + } else { + // 2xx + expect(response.body).not.to.have.property('error'); + const ndjson = response.text.split('\n'); + const savedObjectsArray = Array.isArray(successResult) ? successResult : [successResult]; + expect(ndjson.length).to.eql(savedObjectsArray.length + 1); + for (let i = 0; i < savedObjectsArray.length; i++) { + const object = JSON.parse(ndjson[i]); + const { type: expectedType, id: expectedId } = savedObjectsArray[i]; + expect(object.type).to.eql(expectedType); + expect(object.id).to.eql(expectedId); + expect(object.updated_at).to.match(/^[\d-]{10}T[\d:\.]{12}Z$/); + // don't test attributes, version, or references + } + const exportDetails = JSON.parse(ndjson[ndjson.length - 1]); + expect(exportDetails).to.eql({ + exportedCount: ndjson.length - 1, + missingRefCount: 0, + missingReferences: [], }); - return; } - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to find ${type}`, - }); }; - - const expectTypeOrObjectsRequired = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 400, - error: 'Bad Request', - message: '[request body]: expected a plain object value, but found [null] instead.', - }); - }; - - const expectInvalidTypeSpecified = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 400, - error: 'Bad Request', - message: `Trying to export object(s) with non-exportable types: hiddentype:hiddentype_1`, - }); - }; - - const createExpectVisualizationResults = (spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - const response = JSON.parse(resp.text); - expect(response).to.eql({ - type: 'visualization', - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - version: response.version, - attributes: response.attributes, - references: [ - { - name: 'kibanaSavedObjectMeta.searchSourceJSON.index', - type: 'index-pattern', - id: `${getIdPrefix(spaceId)}91200a00-9efd-11e7-acb3-3dab96693fab`, - }, - ], - migrationVersion: response.migrationVersion, - updated_at: '2017-09-21T18:51:23.794Z', - }); + const createTestDefinitions = ( + testCases: ExportTestCase | ExportTestCase[], + forbidden: boolean, + options?: { + responseBodyOverride?: ExpectResponseBody; + } + ): ExportTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 200, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); }; - const makeExportTest = (describeFn: DescribeFn) => ( + const makeExportTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: ExportTestDefinition + definition: ExportTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, tests } = definition; + const { user, spaceId = DEFAULT_SPACE_ID, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`space aware type should return ${tests.spaceAwareType.statusCode} with ${tests.spaceAwareType.description} when querying by type`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_export`) - .send({ - type: 'visualization', - excludeExportDetails: true, - }) - .auth(user.username, user.password) - .expect(tests.spaceAwareType.statusCode) - .then(tests.spaceAwareType.response); - }); - - it(`space aware type should return ${tests.spaceAwareType.statusCode} with ${tests.spaceAwareType.description} when querying by objects`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_export`) - .send({ - objects: [ - { - type: 'visualization', - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - }, - ], - excludeExportDetails: true, - }) - .auth(user.username, user.password) - .expect(tests.spaceAwareType.statusCode) - .then(tests.spaceAwareType.response); - }); - - describe('hidden type', () => { - it(`should return ${tests.hiddenType.statusCode} with ${tests.hiddenType.description}`, async () => { + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { await supertest .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_export`) - .send({ - objects: [ - { - type: 'hiddentype', - id: `hiddentype_1`, - }, - ], - excludeExportDetails: true, - }) - .auth(user.username, user.password) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); + .auth(user?.username, user?.password) + .send(test.request) + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); - - describe('no type or objects', () => { - it(`should return ${tests.noTypeOrObjects.statusCode} with ${tests.noTypeOrObjects.description}`, async () => { - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_export`) - .auth(user.username, user.password) - .expect(tests.noTypeOrObjects.statusCode) - .then(tests.noTypeOrObjects.response); - }); - }); + } }); }; - const exportTest = makeExportTest(describe); + const addTests = makeExportTest(describe); // @ts-ignore - exportTest.only = makeExportTest(describe.only); + addTests.only = makeExportTest(describe.only); return { - createExpectRbacForbidden, - expectTypeOrObjectsRequired, - expectInvalidTypeSpecified, - createExpectVisualizationResults, - exportTest, + addTests, + createTestDefinitions, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/find.ts b/x-pack/test/saved_object_api_integration/common/suites/find.ts index 5479960634ccb..75d6653365fdf 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/find.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/find.ts @@ -3,271 +3,190 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ + import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface FindTest { - statusCode: number; - description: string; - response: (resp: { [key: string]: any }) => void; +import querystring from 'querystring'; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { expectResponses, getUrlPrefix } from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; + +export interface FindTestDefinition extends TestDefinition { + request: { query: string }; } - -interface FindTests { - spaceAwareType: FindTest; - notSpaceAwareType: FindTest; - unknownType: FindTest; - pageBeyondTotal: FindTest; - unknownSearchField: FindTest; - hiddenType: FindTest; - noType: FindTest; - filterWithNotSpaceAwareType: FindTest; - filterWithHiddenType: FindTest; - filterWithUnknownType: FindTest; - filterWithNoType: FindTest; - filterWithUnAllowedType: FindTest; +export type FindTestSuite = TestSuite; +export interface FindTestCase { + title: string; + query: string; + successResult?: { + savedObjects?: TestCase | TestCase[]; + page?: number; + perPage?: number; + total?: number; + }; + failure?: 400 | 403; } -interface FindTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - tests: FindTests; -} +export const getTestCases = (spaceId?: string) => ({ + singleNamespaceType: { + title: 'find single-namespace type', + query: 'type=isolatedtype&fields=title', + successResult: { + savedObjects: + spaceId === SPACE_1_ID + ? CASES.SINGLE_NAMESPACE_SPACE_1 + : spaceId === SPACE_2_ID + ? CASES.SINGLE_NAMESPACE_SPACE_2 + : CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + }, + } as FindTestCase, + multiNamespaceType: { + title: 'find multi-namespace type', + query: 'type=sharedtype&fields=title', + successResult: { + savedObjects: + spaceId === SPACE_1_ID + ? [CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, CASES.MULTI_NAMESPACE_ONLY_SPACE_1] + : spaceId === SPACE_2_ID + ? CASES.MULTI_NAMESPACE_ONLY_SPACE_2 + : CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + }, + } as FindTestCase, + namespaceAgnosticType: { + title: 'find namespace-agnostic type', + query: 'type=globaltype&fields=title', + successResult: { savedObjects: CASES.NAMESPACE_AGNOSTIC }, + } as FindTestCase, + hiddenType: { title: 'find hidden type', query: 'type=hiddentype&fields=name' } as FindTestCase, + unknownType: { title: 'find unknown type', query: 'type=wigwags' } as FindTestCase, + pageBeyondTotal: { + title: 'find page beyond total', + query: 'type=isolatedtype&page=100&per_page=100', + successResult: { page: 100, perPage: 100, total: 1, savedObjects: [] }, + } as FindTestCase, + unknownSearchField: { + title: 'find unknown search field', + query: 'type=url&search_fields=a', + } as FindTestCase, + filterWithNamespaceAgnosticType: { + title: 'filter with namespace-agnostic type', + query: 'type=globaltype&filter=globaltype.attributes.title:*global*', + successResult: { savedObjects: CASES.NAMESPACE_AGNOSTIC }, + } as FindTestCase, + filterWithHiddenType: { + title: 'filter with hidden type', + query: `type=hiddentype&fields=name&filter=hiddentype.attributes.title:'hello'`, + } as FindTestCase, + filterWithUnknownType: { + title: 'filter with unknown type', + query: `type=wigwags&filter=wigwags.attributes.title:'unknown'`, + } as FindTestCase, + filterWithDisallowedType: { + title: 'filter with disallowed type', + query: `type=globaltype&filter=dashboard.title:'Requests'`, + failure: 400, + } as FindTestCase, +}); +export const createRequest = ({ query }: FindTestCase) => ({ query }); +const getTestTitle = ({ failure, title }: FindTestCase) => { + let description = 'success'; + if (failure === 400) { + description = 'bad request'; + } else if (failure === 403) { + description = 'forbidden'; + } + return `${description} ["${title}"]`; +}; export function findTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectEmpty = (page: number, perPage: number, total: number) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - page, - per_page: perPage, - total, - saved_objects: [], - }); - }; - - const createExpectRbacForbidden = (type?: string) => (resp: { [key: string]: any }) => { - const message = type ? `Unable to find ${type}` : `Not authorized to find saved_object`; - - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message, - }); - }; - - const expectNotSpaceAwareResults = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - page: 1, - per_page: 20, - total: 1, - saved_objects: [ - { - type: 'globaltype', - id: `8121a00-8efd-21e7-1cb3-34ab966434445`, - version: resp.body.saved_objects[0].version, - attributes: { - name: 'My favorite global object', - }, - references: [], - updated_at: '2017-09-21T18:59:16.270Z', - }, - ], - }); - }; - - const expectFilterWrongTypeError = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - error: 'Bad Request', - message: 'This type dashboard is not allowed: Bad Request', - statusCode: 400, - }); - }; - - const expectTypeRequired = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - error: 'Bad Request', - message: '[request query.type]: expected at least one defined value but got [undefined]', - statusCode: 400, - }); + const expectForbidden = expectResponses.forbidden('find'); + const expectResponseBody = (testCase: FindTestCase): ExpectResponseBody => async ( + response: Record + ) => { + const { failure, successResult = {}, query } = testCase; + const parsedQuery = querystring.parse(query); + if (failure === 403) { + const type = parsedQuery.type; + await expectForbidden(type)(response); + } else if (failure === 400) { + const type = (parsedQuery.filter as string).split('.')[0]; + expect(response.body.error).to.eql('Bad Request'); + expect(response.body.statusCode).to.eql(failure); + expect(response.body.message).to.eql(`This type ${type} is not allowed: Bad Request`); + } else { + // 2xx + expect(response.body).not.to.have.property('error'); + const { page = 1, perPage = 20, total, savedObjects = [] } = successResult; + const savedObjectsArray = Array.isArray(savedObjects) ? savedObjects : [savedObjects]; + expect(response.body.page).to.eql(page); + expect(response.body.per_page).to.eql(perPage); + expect(response.body.total).to.eql(total || savedObjectsArray.length); + for (let i = 0; i < savedObjectsArray.length; i++) { + const object = response.body.saved_objects[i]; + const { type: expectedType, id: expectedId } = savedObjectsArray[i]; + expect(object.type).to.eql(expectedType); + expect(object.id).to.eql(expectedId); + expect(object.updated_at).to.match(/^[\d-]{10}T[\d:\.]{12}Z$/); + // don't test attributes, version, or references + } + } }; - - const createExpectVisualizationResults = (spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - page: 1, - per_page: 20, - total: 1, - saved_objects: [ - { - type: 'visualization', - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - version: resp.body.saved_objects[0].version, - attributes: { - title: 'Count of requests', - }, - migrationVersion: resp.body.saved_objects[0].migrationVersion, - references: [ - { - id: `${getIdPrefix(spaceId)}91200a00-9efd-11e7-acb3-3dab96693fab`, - name: 'kibanaSavedObjectMeta.searchSourceJSON.index', - type: 'index-pattern', - }, - ], - updated_at: '2017-09-21T18:51:23.794Z', - }, - ], - }); + const createTestDefinitions = ( + testCases: FindTestCase | FindTestCase[], + forbidden: boolean, + options?: { + responseBodyOverride?: ExpectResponseBody; + } + ): FindTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 200, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); }; - const makeFindTest = (describeFn: DescribeFn) => ( + const makeFindTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: FindTestDefinition + definition: FindTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, tests } = definition; + const { user, spaceId = DEFAULT_SPACE_ID, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`space aware type should return ${tests.spaceAwareType.statusCode} with ${tests.spaceAwareType.description}`, async () => - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find?type=visualization&fields=title`) - .auth(user.username, user.password) - .expect(tests.spaceAwareType.statusCode) - .then(tests.spaceAwareType.response)); - - it(`not space aware type should return ${tests.notSpaceAwareType.statusCode} with ${tests.notSpaceAwareType.description}`, async () => - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find?type=globaltype&fields=name`) - .auth(user.username, user.password) - .expect(tests.notSpaceAwareType.statusCode) - .then(tests.notSpaceAwareType.response)); - - it(`finding a hiddentype should return ${tests.hiddenType.statusCode} with ${tests.hiddenType.description}`, async () => - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find?type=hiddentype&fields=name`) - .auth(user.username, user.password) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response)); - - describe('unknown type', () => { - it(`should return ${tests.unknownType.statusCode} with ${tests.unknownType.description}`, async () => - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find?type=wigwags`) - .auth(user.username, user.password) - .expect(tests.unknownType.statusCode) - .then(tests.unknownType.response)); - }); - - describe('page beyond total', () => { - it(`should return ${tests.pageBeyondTotal.statusCode} with ${tests.pageBeyondTotal.description}`, async () => - await supertest - .get( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/_find?type=visualization&page=100&per_page=100` - ) - .auth(user.username, user.password) - .expect(tests.pageBeyondTotal.statusCode) - .then(tests.pageBeyondTotal.response)); - }); - - describe('unknown search field', () => { - it(`should return ${tests.unknownSearchField.statusCode} with ${tests.unknownSearchField.description}`, async () => - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find?type=url&search_fields=a`) - .auth(user.username, user.password) - .expect(tests.unknownSearchField.statusCode) - .then(tests.unknownSearchField.response)); - }); - - describe('no type', () => { - it(`should return ${tests.noType.statusCode} with ${tests.noType.description}`, async () => - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find`) - .auth(user.username, user.password) - .expect(tests.noType.statusCode) - .then(tests.noType.response)); - }); - - describe('filter', () => { - it(`by wrong type should return ${tests.filterWithUnAllowedType.statusCode} with ${tests.filterWithUnAllowedType.description}`, async () => - await supertest - .get( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/_find?type=globaltype&filter=dashboard.title:'Requests'` - ) - .auth(user.username, user.password) - .expect(tests.filterWithUnAllowedType.statusCode) - .then(tests.filterWithUnAllowedType.response)); - - it(`not space aware type should return ${tests.filterWithNotSpaceAwareType.statusCode} with ${tests.filterWithNotSpaceAwareType.description}`, async () => + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const query = test.request.query ? `?${test.request.query}` : ''; await supertest - .get( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/_find?type=globaltype&filter=globaltype.attributes.name:*global*` - ) - .auth(user.username, user.password) - .expect(tests.filterWithNotSpaceAwareType.statusCode) - .then(tests.filterWithNotSpaceAwareType.response)); - - it(`finding a hiddentype should return ${tests.filterWithHiddenType.statusCode} with ${tests.filterWithHiddenType.description}`, async () => - await supertest - .get( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/_find?type=hiddentype&fields=name&filter=hiddentype.attributes.name:'hello'` - ) - .auth(user.username, user.password) - .expect(tests.filterWithHiddenType.statusCode) - .then(tests.filterWithHiddenType.response)); - - describe('unknown type', () => { - it(`should return ${tests.filterWithUnknownType.statusCode} with ${tests.filterWithUnknownType.description}`, async () => - await supertest - .get( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/_find?type=wigwags&filter=wigwags.attributes.title:'unknown'` - ) - .auth(user.username, user.password) - .expect(tests.filterWithUnknownType.statusCode) - .then(tests.filterWithUnknownType.response)); - }); - - describe('no type', () => { - it(`should return ${tests.filterWithNoType.statusCode} with ${tests.filterWithNoType.description}`, async () => - await supertest - .get( - `${getUrlPrefix( - spaceId - )}/api/saved_objects/_find?filter=global.attributes.name:*global*` - ) - .auth(user.username, user.password) - .expect(tests.filterWithNoType.statusCode) - .then(tests.filterWithNoType.response)); + .get(`${getUrlPrefix(spaceId)}/api/saved_objects/_find${query}`) + .auth(user?.username, user?.password) + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); + } }); }; - const findTest = makeFindTest(describe); + const addTests = makeFindTest(describe); // @ts-ignore - findTest.only = makeFindTest(describe.only); + addTests.only = makeFindTest(describe.only); return { - createExpectEmpty, - createExpectRbacForbidden, - createExpectVisualizationResults, - expectFilterWrongTypeError, - expectNotSpaceAwareResults, - expectTypeRequired, - findTest, + addTests, + createTestDefinitions, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/get.ts b/x-pack/test/saved_object_api_integration/common/suites/get.ts index c98209ca1e105..d8fa4d91276d7 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/get.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/get.ts @@ -3,193 +3,89 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface GetTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; -} - -interface GetTests { - spaceAware: GetTest; - notSpaceAware: GetTest; - hiddenType: GetTest; - doesntExist: GetTest; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface GetTestDefinition extends TestDefinition { + request: { type: string; id: string }; } +export type GetTestSuite = TestSuite; +export type GetTestCase = TestCase; -interface GetTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - otherSpaceId?: string; - tests: GetTests; -} - -const spaceAwareId = 'dd7caf20-9efd-11e7-acb3-3dab96693fab'; -const notSpaceAwareId = '8121a00-8efd-21e7-1cb3-34ab966434445'; -const doesntExistId = 'foobar'; +const DOES_NOT_EXIST = Object.freeze({ type: 'dashboard', id: 'does-not-exist' }); +export const TEST_CASES = Object.freeze({ ...CASES, DOES_NOT_EXIST }); export function getTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectDoesntExistNotFound = (spaceId = DEFAULT_SPACE_ID) => { - return createExpectNotFound('visualization', doesntExistId, spaceId); - }; - - const createExpectNotFound = (type: string, id: string, spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - error: 'Not Found', - message: `Saved object [${type}/${getIdPrefix(spaceId)}${id}] not found`, - statusCode: 404, - }); - }; - - const expectHiddenTypeNotFound = createExpectNotFound( - 'hiddentype', - 'hiddentype_1', - DEFAULT_SPACE_ID - ); - - const createExpectNotSpaceAwareRbacForbidden = () => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - error: 'Forbidden', - message: `Unable to get globaltype`, - statusCode: 403, - }); - }; - - const createExpectNotSpaceAwareResults = (spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - id: `${notSpaceAwareId}`, - type: 'globaltype', - updated_at: '2017-09-21T18:59:16.270Z', - version: resp.body.version, - attributes: { - name: 'My favorite global object', - }, - references: [], - }); - }; - - const createExpectRbacForbidden = (type: string) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - error: 'Forbidden', - message: `Unable to get ${type}`, - statusCode: 403, - }); + const expectForbidden = expectResponses.forbidden('get'); + const expectResponseBody = (testCase: GetTestCase): ExpectResponseBody => async ( + response: Record + ) => { + if (testCase.failure === 403) { + await expectForbidden(testCase.type)(response); + } else { + // permitted + const object = response.body; + await expectResponses.permitted(object, testCase); + } }; - - const createExpectSpaceAwareNotFound = (spaceId = DEFAULT_SPACE_ID) => { - return createExpectNotFound('visualization', spaceAwareId, spaceId); + const createTestDefinitions = ( + testCases: GetTestCase | GetTestCase[], + forbidden: boolean, + options?: { + spaceId?: string; + responseBodyOverride?: ExpectResponseBody; + } + ): GetTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 200, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); }; - const expectSpaceAwareRbacForbidden = createExpectRbacForbidden('visualization'); - const expectNotSpaceAwareRbacForbidden = createExpectRbacForbidden('globaltype'); - const expectHiddenTypeRbacForbidden = createExpectRbacForbidden('hiddentype'); - const expectDoesntExistRbacForbidden = createExpectRbacForbidden('visualization'); - - const createExpectSpaceAwareResults = (spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - id: `${getIdPrefix(spaceId)}dd7caf20-9efd-11e7-acb3-3dab96693fab`, - type: 'visualization', - migrationVersion: resp.body.migrationVersion, - updated_at: '2017-09-21T18:51:23.794Z', - version: resp.body.version, - attributes: { - title: 'Count of requests', - description: '', - version: 1, - // cheat for some of the more complex attributes - visState: resp.body.attributes.visState, - uiStateJSON: resp.body.attributes.uiStateJSON, - kibanaSavedObjectMeta: resp.body.attributes.kibanaSavedObjectMeta, - }, - references: [ - { - name: 'kibanaSavedObjectMeta.searchSourceJSON.index', - type: 'index-pattern', - id: `${getIdPrefix(spaceId)}91200a00-9efd-11e7-acb3-3dab96693fab`, - }, - ], - }); - }; - - const makeGetTest = (describeFn: DescribeFn) => ( + const makeGetTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: GetTestDefinition + definition: GetTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, otherSpaceId, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.spaceAware.statusCode} when getting a space aware doc`, async () => { - await supertest - .get( - `${getUrlPrefix(spaceId)}/api/saved_objects/visualization/${getIdPrefix( - otherSpaceId || spaceId - )}${spaceAwareId}` - ) - .auth(user.username, user.password) - .expect(tests.spaceAware.statusCode) - .then(tests.spaceAware.response); - }); - - it(`should return ${tests.notSpaceAware.statusCode} when getting a non-space-aware doc`, async () => { - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/globaltype/${notSpaceAwareId}`) - .auth(user.username, user.password) - .expect(tests.notSpaceAware.statusCode) - .then(tests.notSpaceAware.response); - }); - - it(`should return ${tests.hiddenType.statusCode} when getting a hiddentype doc`, async () => { - await supertest - .get(`${getUrlPrefix(spaceId)}/api/saved_objects/hiddentype/hiddentype_1`) - .auth(user.username, user.password) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); - }); - - describe('document does not exist', () => { - it(`should return ${tests.doesntExist.statusCode}`, async () => { + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const { type, id } = test.request; await supertest - .get( - `${getUrlPrefix(spaceId)}/api/saved_objects/visualization/${getIdPrefix( - otherSpaceId || spaceId - )}${doesntExistId}` - ) - .auth(user.username, user.password) - .expect(tests.doesntExist.statusCode) - .then(tests.doesntExist.response); + .get(`${getUrlPrefix(spaceId)}/api/saved_objects/${type}/${id}`) + .auth(user?.username, user?.password) + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); + } }); }; - const getTest = makeGetTest(describe); + const addTests = makeGetTest(describe); // @ts-ignore - getTest.only = makeGetTest(describe.only); + addTests.only = makeGetTest(describe.only); return { - createExpectDoesntExistNotFound, - createExpectNotSpaceAwareRbacForbidden, - createExpectNotSpaceAwareResults, - createExpectSpaceAwareNotFound, - createExpectSpaceAwareResults, - expectHiddenTypeNotFound, - expectSpaceAwareRbacForbidden, - expectNotSpaceAwareRbacForbidden, - expectDoesntExistRbacForbidden, - expectHiddenTypeRbacForbidden, - getTest, + addTests, + createTestDefinitions, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/import.ts b/x-pack/test/saved_object_api_integration/common/suites/import.ts index f6723c912f82e..2f631221c6955 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/import.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/import.ts @@ -6,195 +6,152 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface ImportTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface ImportTestDefinition extends TestDefinition { + request: Array<{ type: string; id: string }>; } - -interface ImportTests { - default: ImportTest; - hiddenType: ImportTest; - unknownType: ImportTest; +export type ImportTestSuite = TestSuite; +export interface ImportTestCase extends TestCase { + failure?: 400 | 409; // only used for permitted response case } -interface ImportTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - tests: ImportTests; -} +const NEW_ATTRIBUTE_KEY = 'title'; // all type mappings include this attribute, for simplicity's sake +const NEW_ATTRIBUTE_VAL = `New attribute value ${Date.now()}`; -const createImportData = (spaceId: string) => [ - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - attributes: { - title: 'A great new dashboard', - }, - }, - { - type: 'globaltype', - id: '05976c65-1145-4858-bbf0-d225cc78a06e', - attributes: { - name: 'A new globaltype object', - }, - }, -]; +const NEW_SINGLE_NAMESPACE_OBJ = Object.freeze({ type: 'dashboard', id: 'new-dashboard-id' }); +const NEW_MULTI_NAMESPACE_OBJ = Object.freeze({ type: 'sharedtype', id: 'new-sharedtype-id' }); +const NEW_NAMESPACE_AGNOSTIC_OBJ = Object.freeze({ type: 'globaltype', id: 'new-globaltype-id' }); +export const TEST_CASES = Object.freeze({ + ...CASES, + NEW_SINGLE_NAMESPACE_OBJ, + NEW_MULTI_NAMESPACE_OBJ, + NEW_NAMESPACE_AGNOSTIC_OBJ, +}); export function importTestSuiteFactory(es: any, esArchiver: any, supertest: SuperTest) { - const createExpectResults = (spaceId = DEFAULT_SPACE_ID) => async (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - success: true, - successCount: 2, - }); - }; - - const expectResultsWithUnsupportedHiddenType = async (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - success: false, - successCount: 2, - errors: [ - { - error: { - type: 'unsupported_type', - }, - id: '1', - type: 'hiddentype', - }, - ], - }); + const expectForbidden = expectResponses.forbidden('bulk_create'); + const expectResponseBody = ( + testCases: ImportTestCase | ImportTestCase[], + statusCode: 200 | 403, + spaceId = SPACES.DEFAULT.spaceId + ): ExpectResponseBody => async (response: Record) => { + const testCaseArray = Array.isArray(testCases) ? testCases : [testCases]; + if (statusCode === 403) { + const types = testCaseArray.map(x => x.type); + await expectForbidden(types)(response); + } else { + // permitted + const { success, successCount, errors } = response.body; + const expectedSuccesses = testCaseArray.filter(x => !x.failure); + const expectedFailures = testCaseArray.filter(x => x.failure); + expect(success).to.eql(expectedFailures.length === 0); + expect(successCount).to.eql(expectedSuccesses.length); + if (expectedFailures.length) { + expect(errors).to.have.length(expectedFailures.length); + } else { + expect(response.body).not.to.have.property('errors'); + } + for (let i = 0; i < expectedSuccesses.length; i++) { + const { type, id } = expectedSuccesses[i]; + const { _source } = await expectResponses.successCreated(es, spaceId, type, id); + expect(_source[type][NEW_ATTRIBUTE_KEY]).to.eql(NEW_ATTRIBUTE_VAL); + } + for (let i = 0; i < expectedFailures.length; i++) { + const { type, id, failure } = expectedFailures[i]; + // we don't know the order of the returned errors; search for each one + const object = (errors as Array>).find( + x => x.type === type && x.id === id + ); + expect(object).not.to.be(undefined); + if (failure === 400) { + expect(object!.error).to.eql({ type: 'unsupported_type' }); + } else { + // 409 + expect(object!.error).to.eql({ type: 'conflict' }); + } + } + } }; - - const expectUnknownTypeUnsupported = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - success: false, - successCount: 2, - errors: [ - { - id: '1', - type: 'wigwags', - title: 'Wigwags title', - error: { - type: 'unsupported_type', - }, - }, - ], - }); + const createTestDefinitions = ( + testCases: ImportTestCase | ImportTestCase[], + forbidden: boolean, + options?: { + spaceId?: string; + singleRequest?: boolean; + responseBodyOverride?: ExpectResponseBody; + } + ): ImportTestDefinition[] => { + const cases = Array.isArray(testCases) ? testCases : [testCases]; + const responseStatusCode = forbidden ? 403 : 200; + if (!options?.singleRequest) { + // if we are testing cases that should result in a forbidden response, we can do each case individually + // this ensures that multiple test cases of a single type will each result in a forbidden error + return cases.map(x => ({ + title: getTestTitle(x, responseStatusCode), + request: [createRequest(x)], + responseStatusCode, + responseBody: + options?.responseBodyOverride || + expectResponseBody(x, responseStatusCode, options?.spaceId), + })); + } + // batch into a single request to save time during test execution + return [ + { + title: getTestTitle(cases, responseStatusCode), + request: cases.map(x => createRequest(x)), + responseStatusCode, + responseBody: + options?.responseBodyOverride || + expectResponseBody(cases, responseStatusCode, options?.spaceId), + }, + ]; }; - const expectHiddenTypeUnsupported = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - success: false, - successCount: 2, - errors: [ - { - id: '1', - type: 'hiddentype', - error: { - type: 'unsupported_type', - }, - }, - ], - }); - }; - - const expectRbacForbidden = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to bulk_create dashboard,globaltype`, - }); - }; - - const makeImportTest = (describeFn: DescribeFn) => ( + const makeImportTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: ImportTestDefinition + definition: ImportTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.default.statusCode}`, async () => { - const data = createImportData(spaceId); - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_import`) - .auth(user.username, user.password) - .attach( - 'file', - Buffer.from(data.map(obj => JSON.stringify(obj)).join('\n'), 'utf8'), - 'export.ndjson' - ) - .expect(tests.default.statusCode) - .then(tests.default.response); - }); - - describe('hiddentype', () => { - it(`should return ${tests.hiddenType.statusCode}`, async () => { - const data = createImportData(spaceId); - data.push({ - type: 'hiddentype', - id: '1', - attributes: { - name: 'My Hidden Type', - }, - }); - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_import`) - .query({ overwrite: true }) - .auth(user.username, user.password) - .attach( - 'file', - Buffer.from(data.map(obj => JSON.stringify(obj)).join('\n'), 'utf8'), - 'export.ndjson' - ) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); - }); - }); + const attrs = { attributes: { [NEW_ATTRIBUTE_KEY]: NEW_ATTRIBUTE_VAL } }; - describe('unknown type', () => { - it(`should return ${tests.unknownType.statusCode}`, async () => { - const data = createImportData(spaceId); - data.push({ - type: 'wigwags', - id: '1', - attributes: { - title: 'Wigwags title', - }, - }); + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const requestBody = test.request + .map(obj => JSON.stringify({ ...obj, ...attrs })) + .join('\n'); await supertest .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_import`) - .query({ overwrite: true }) - .auth(user.username, user.password) - .attach( - 'file', - Buffer.from(data.map(obj => JSON.stringify(obj)).join('\n'), 'utf8'), - 'export.ndjson' - ) - .expect(tests.unknownType.statusCode) - .then(tests.unknownType.response); + .auth(user?.username, user?.password) + .attach('file', Buffer.from(requestBody, 'utf8'), 'export.ndjson') + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); + } }); }; - const importTest = makeImportTest(describe); + const addTests = makeImportTest(describe); // @ts-ignore - importTest.only = makeImportTest(describe.only); + addTests.only = makeImportTest(describe.only); return { - importTest, - createExpectResults, - expectResultsWithUnsupportedHiddenType, - expectRbacForbidden, - expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, + addTests, + createTestDefinitions, + expectForbidden, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/resolve_import_errors.ts b/x-pack/test/saved_object_api_integration/common/suites/resolve_import_errors.ts index 1b538b9b1b65d..47c4babc5fcf9 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/resolve_import_errors.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/resolve_import_errors.ts @@ -6,219 +6,165 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; -interface ResolveImportErrorsTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; +export interface ResolveImportErrorsTestDefinition extends TestDefinition { + request: Array<{ type: string; id: string }>; + overwrite: boolean; } - -interface ResolveImportErrorsTests { - default: ResolveImportErrorsTest; - hiddenType: ResolveImportErrorsTest; - unknownType: ResolveImportErrorsTest; +export type ResolveImportErrorsTestSuite = TestSuite; +export interface ResolveImportErrorsTestCase extends TestCase { + failure?: 400 | 409; // only used for permitted response case } -interface ResolveImportErrorsTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - tests: ResolveImportErrorsTests; -} +const NEW_ATTRIBUTE_KEY = 'title'; // all type mappings include this attribute, for simplicity's sake +const NEW_ATTRIBUTE_VAL = `New attribute value ${Date.now()}`; -const createImportData = (spaceId: string) => [ - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - attributes: { - title: 'A great new dashboard', - }, - }, - { - type: 'globaltype', - id: '05976c65-1145-4858-bbf0-d225cc78a06e', - attributes: { - name: 'A new globaltype object', - }, - }, -]; +const NEW_SINGLE_NAMESPACE_OBJ = Object.freeze({ type: 'dashboard', id: 'new-dashboard-id' }); +const NEW_MULTI_NAMESPACE_OBJ = Object.freeze({ type: 'sharedtype', id: 'new-sharedtype-id' }); +const NEW_NAMESPACE_AGNOSTIC_OBJ = Object.freeze({ type: 'globaltype', id: 'new-globaltype-id' }); +export const TEST_CASES = Object.freeze({ + ...CASES, + NEW_SINGLE_NAMESPACE_OBJ, + NEW_MULTI_NAMESPACE_OBJ, + NEW_NAMESPACE_AGNOSTIC_OBJ, +}); export function resolveImportErrorsTestSuiteFactory( es: any, esArchiver: any, supertest: SuperTest ) { - const createExpectResults = (spaceId = DEFAULT_SPACE_ID) => async (resp: { - [key: string]: any; - }) => { - expect(resp.body).to.eql({ - success: true, - successCount: 1, - }); - }; - - const expectUnknownTypeUnsupported = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - success: false, - successCount: 1, - errors: [ - { - id: '1', - type: 'wigwags', - title: 'Wigwags title', - error: { - type: 'unsupported_type', - }, - }, - ], - }); - }; - - const expectHiddenTypeUnsupported = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - success: false, - successCount: 1, - errors: [ - { - id: '1', - type: 'hiddentype', - error: { - type: 'unsupported_type', - }, - }, - ], - }); + const expectForbidden = expectResponses.forbidden('bulk_create'); + const expectResponseBody = ( + testCases: ResolveImportErrorsTestCase | ResolveImportErrorsTestCase[], + statusCode: 200 | 403, + spaceId = SPACES.DEFAULT.spaceId + ): ExpectResponseBody => async (response: Record) => { + const testCaseArray = Array.isArray(testCases) ? testCases : [testCases]; + if (statusCode === 403) { + const types = testCaseArray.map(x => x.type); + await expectForbidden(types)(response); + } else { + // permitted + const { success, successCount, errors } = response.body; + const expectedSuccesses = testCaseArray.filter(x => !x.failure); + const expectedFailures = testCaseArray.filter(x => x.failure); + expect(success).to.eql(expectedFailures.length === 0); + expect(successCount).to.eql(expectedSuccesses.length); + if (expectedFailures.length) { + expect(errors).to.have.length(expectedFailures.length); + } else { + expect(response.body).not.to.have.property('errors'); + } + for (let i = 0; i < expectedSuccesses.length; i++) { + const { type, id } = expectedSuccesses[i]; + const { _source } = await expectResponses.successCreated(es, spaceId, type, id); + expect(_source[type][NEW_ATTRIBUTE_KEY]).to.eql(NEW_ATTRIBUTE_VAL); + } + for (let i = 0; i < expectedFailures.length; i++) { + const { type, id, failure } = expectedFailures[i]; + // we don't know the order of the returned errors; search for each one + const object = (errors as Array>).find( + x => x.type === type && x.id === id + ); + expect(object).not.to.be(undefined); + if (failure === 400) { + expect(object!.error).to.eql({ type: 'unsupported_type' }); + } else { + // 409 + expect(object!.error).to.eql({ type: 'conflict' }); + } + } + } }; - - const expectRbacForbidden = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to bulk_create dashboard`, - }); + const createTestDefinitions = ( + testCases: ResolveImportErrorsTestCase | ResolveImportErrorsTestCase[], + forbidden: boolean, + overwrite: boolean, + options?: { + spaceId?: string; + singleRequest?: boolean; + responseBodyOverride?: ExpectResponseBody; + } + ): ResolveImportErrorsTestDefinition[] => { + const cases = Array.isArray(testCases) ? testCases : [testCases]; + const responseStatusCode = forbidden ? 403 : 200; + if (!options?.singleRequest) { + // if we are testing cases that should result in a forbidden response, we can do each case individually + // this ensures that multiple test cases of a single type will each result in a forbidden error + return cases.map(x => ({ + title: getTestTitle(x, responseStatusCode), + request: [createRequest(x)], + responseStatusCode, + responseBody: + options?.responseBodyOverride || + expectResponseBody(x, responseStatusCode, options?.spaceId), + overwrite, + })); + } + // batch into a single request to save time during test execution + return [ + { + title: getTestTitle(cases, responseStatusCode), + request: cases.map(x => createRequest(x)), + responseStatusCode, + responseBody: + options?.responseBodyOverride || + expectResponseBody(cases, responseStatusCode, options?.spaceId), + overwrite, + }, + ]; }; - const makeResolveImportErrorsTest = (describeFn: DescribeFn) => ( + const makeResolveImportErrorsTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: ResolveImportErrorsTestDefinition + definition: ResolveImportErrorsTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.default.statusCode}`, async () => { - const data = createImportData(spaceId); - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_resolve_import_errors`) - .auth(user.username, user.password) - .field( - 'retries', - JSON.stringify([ - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - overwrite: true, - }, - ]) - ) - .attach( - 'file', - Buffer.from(data.map(obj => JSON.stringify(obj)).join('\n'), 'utf8'), - 'export.ndjson' - ) - .expect(tests.default.statusCode) - .then(tests.default.response); - }); + const attrs = { attributes: { [NEW_ATTRIBUTE_KEY]: NEW_ATTRIBUTE_VAL } }; - describe('unknown type', () => { - it(`should return ${tests.unknownType.statusCode}`, async () => { - const data = createImportData(spaceId); - data.push({ - type: 'wigwags', - id: '1', - attributes: { - title: 'Wigwags title', - }, - }); - await supertest - .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_resolve_import_errors`) - .auth(user.username, user.password) - .field( - 'retries', - JSON.stringify([ - { - type: 'wigwags', - id: '1', - overwrite: true, - }, - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - overwrite: true, - }, - ]) - ) - .attach( - 'file', - Buffer.from(data.map(obj => JSON.stringify(obj)).join('\n'), 'utf8'), - 'export.ndjson' - ) - .expect(tests.unknownType.statusCode) - .then(tests.unknownType.response); - }); - }); - describe('hidden type', () => { - it(`should return ${tests.hiddenType.statusCode}`, async () => { - const data = createImportData(spaceId); - data.push({ - type: 'hiddentype', - id: '1', - attributes: { - name: 'My Hidden Type', - }, - }); + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const retryAttrs = test.overwrite ? { overwrite: true } : {}; + const retries = JSON.stringify( + test.request.map(({ type, id }) => ({ type, id, ...retryAttrs })) + ); + const requestBody = test.request + .map(obj => JSON.stringify({ ...obj, ...attrs })) + .join('\n'); await supertest .post(`${getUrlPrefix(spaceId)}/api/saved_objects/_resolve_import_errors`) - .auth(user.username, user.password) - .field( - 'retries', - JSON.stringify([ - { - type: 'hiddentype', - id: '1', - overwrite: true, - }, - { - type: 'dashboard', - id: `${getIdPrefix(spaceId)}a01b2f57-fcfd-4864-b735-09e28f0d815e`, - overwrite: true, - }, - ]) - ) - .attach( - 'file', - Buffer.from(data.map(obj => JSON.stringify(obj)).join('\n'), 'utf8'), - 'export.ndjson' - ) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); + .auth(user?.username, user?.password) + .field('retries', retries) + .attach('file', Buffer.from(requestBody, 'utf8'), 'export.ndjson') + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); + } }); }; - const resolveImportErrorsTest = makeResolveImportErrorsTest(describe); + const addTests = makeResolveImportErrorsTest(describe); // @ts-ignore - resolveImportErrorsTest.only = makeResolveImportErrorsTest(describe.only); + addTests.only = makeResolveImportErrorsTest(describe.only); return { - resolveImportErrorsTest, - createExpectResults, - expectRbacForbidden, - expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, + addTests, + createTestDefinitions, + expectForbidden, }; } diff --git a/x-pack/test/saved_object_api_integration/common/suites/update.ts b/x-pack/test/saved_object_api_integration/common/suites/update.ts index d6b7602c0114a..587e8cf320a4f 100644 --- a/x-pack/test/saved_object_api_integration/common/suites/update.ts +++ b/x-pack/test/saved_object_api_integration/common/suites/update.ts @@ -6,205 +6,97 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; -import { DEFAULT_SPACE_ID } from '../../../../plugins/spaces/common/constants'; -import { getIdPrefix, getUrlPrefix } from '../lib/space_test_utils'; -import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; - -interface UpdateTest { - statusCode: number; - response: (resp: { [key: string]: any }) => void; -} - -interface UpdateTests { - spaceAware: UpdateTest; - notSpaceAware: UpdateTest; - hiddenType: UpdateTest; - doesntExist: UpdateTest; +import { SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; +import { SPACES } from '../lib/spaces'; +import { + createRequest, + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../lib/saved_object_test_utils'; +import { ExpectResponseBody, TestCase, TestDefinition, TestSuite } from '../lib/types'; + +export interface UpdateTestDefinition extends TestDefinition { + request: { type: string; id: string }; } - -interface UpdateTestDefinition { - user?: TestDefinitionAuthentication; - spaceId?: string; - otherSpaceId?: string; - tests: UpdateTests; +export type UpdateTestSuite = TestSuite; +export interface UpdateTestCase extends TestCase { + failure?: 403 | 404; } -export function updateTestSuiteFactory(esArchiver: any, supertest: SuperTest) { - const createExpectNotFound = (type: string, id: string, spaceId = DEFAULT_SPACE_ID) => (resp: { - [key: string]: any; - }) => { - expect(resp.body).eql({ - statusCode: 404, - error: 'Not Found', - message: `Saved object [${type}/${getIdPrefix(spaceId)}${id}] not found`, - }); - }; - - const createExpectDoesntExistNotFound = (spaceId?: string) => { - return createExpectNotFound('visualization', 'not an id', spaceId); - }; - - const createExpectSpaceAwareNotFound = (spaceId?: string) => { - return createExpectNotFound('visualization', 'dd7caf20-9efd-11e7-acb3-3dab96693fab', spaceId); - }; - - const expectHiddenTypeNotFound = createExpectNotFound( - 'hiddentype', - 'hiddentype_1', - DEFAULT_SPACE_ID - ); - - const createExpectRbacForbidden = (type: string) => (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - statusCode: 403, - error: 'Forbidden', - message: `Unable to update ${type}`, - }); - }; +const NEW_ATTRIBUTE_KEY = 'title'; // all type mappings include this attribute, for simplicity's sake +const NEW_ATTRIBUTE_VAL = `Updated attribute value ${Date.now()}`; - const expectDoesntExistRbacForbidden = createExpectRbacForbidden('visualization'); +const DOES_NOT_EXIST = Object.freeze({ type: 'dashboard', id: 'does-not-exist' }); +export const TEST_CASES = Object.freeze({ ...CASES, DOES_NOT_EXIST }); - const expectNotSpaceAwareRbacForbidden = createExpectRbacForbidden('globaltype'); - - const expectHiddenTypeRbacForbidden = createExpectRbacForbidden('hiddentype'); - - const expectNotSpaceAwareResults = (resp: { [key: string]: any }) => { - // loose uuid validation - expect(resp.body) - .to.have.property('id') - .match(/^[0-9a-f-]{36}$/); - - // loose ISO8601 UTC time with milliseconds validation - expect(resp.body) - .to.have.property('updated_at') - .match(/^[\d-]{10}T[\d:\.]{12}Z$/); - - expect(resp.body).to.eql({ - id: resp.body.id, - type: 'globaltype', - updated_at: resp.body.updated_at, - version: resp.body.version, - attributes: { - name: 'My second favorite', - }, - }); +export function updateTestSuiteFactory(esArchiver: any, supertest: SuperTest) { + const expectForbidden = expectResponses.forbidden('update'); + const expectResponseBody = (testCase: UpdateTestCase): ExpectResponseBody => async ( + response: Record + ) => { + if (testCase.failure === 403) { + await expectForbidden(testCase.type)(response); + } else { + // permitted + const object = response.body; + await expectResponses.permitted(object, testCase); + if (!testCase.failure) { + expect(object.attributes[NEW_ATTRIBUTE_KEY]).to.eql(NEW_ATTRIBUTE_VAL); + } + } }; - - const expectSpaceAwareRbacForbidden = createExpectRbacForbidden('visualization'); - - const expectSpaceAwareResults = (resp: { [key: string]: any }) => { - // loose uuid validation ignoring prefix - expect(resp.body) - .to.have.property('id') - .match(/[0-9a-f-]{36}$/); - - // loose ISO8601 UTC time with milliseconds validation - expect(resp.body) - .to.have.property('updated_at') - .match(/^[\d-]{10}T[\d:\.]{12}Z$/); - - expect(resp.body).to.eql({ - id: resp.body.id, - type: 'visualization', - updated_at: resp.body.updated_at, - version: resp.body.version, - attributes: { - title: 'My second favorite vis', - }, - }); + const createTestDefinitions = ( + testCases: UpdateTestCase | UpdateTestCase[], + forbidden: boolean, + options?: { + responseBodyOverride?: ExpectResponseBody; + } + ): UpdateTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 200, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); }; - const makeUpdateTest = (describeFn: DescribeFn) => ( + const makeUpdateTest = (describeFn: Mocha.SuiteFunction) => ( description: string, - definition: UpdateTestDefinition + definition: UpdateTestSuite ) => { - const { user = {}, spaceId = DEFAULT_SPACE_ID, otherSpaceId, tests } = definition; + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; describeFn(description, () => { before(() => esArchiver.load('saved_objects/spaces')); after(() => esArchiver.unload('saved_objects/spaces')); - it(`should return ${tests.spaceAware.statusCode} for a space-aware doc`, async () => { - await supertest - .put( - `${getUrlPrefix(spaceId)}/api/saved_objects/visualization/${getIdPrefix( - otherSpaceId || spaceId - )}dd7caf20-9efd-11e7-acb3-3dab96693fab` - ) - .auth(user.username, user.password) - .send({ - attributes: { - title: 'My second favorite vis', - }, - }) - .expect(tests.spaceAware.statusCode) - .then(tests.spaceAware.response); - }); - - it(`should return ${tests.notSpaceAware.statusCode} for a non space-aware doc`, async () => { - await supertest - .put( - `${getUrlPrefix( - otherSpaceId || spaceId - )}/api/saved_objects/globaltype/8121a00-8efd-21e7-1cb3-34ab966434445` - ) - .auth(user.username, user.password) - .send({ - attributes: { - name: 'My second favorite', - }, - }) - .expect(tests.notSpaceAware.statusCode) - .then(tests.notSpaceAware.response); - }); - - it(`should return ${tests.hiddenType.statusCode} for hiddentype doc`, async () => { - await supertest - .put(`${getUrlPrefix(otherSpaceId || spaceId)}/api/saved_objects/hiddentype/hiddentype_1`) - .auth(user.username, user.password) - .send({ - attributes: { - name: 'My favorite hidden type', - }, - }) - .expect(tests.hiddenType.statusCode) - .then(tests.hiddenType.response); - }); - describe('unknown id', () => { - it(`should return ${tests.doesntExist.statusCode}`, async () => { + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const { type, id } = test.request; + const requestBody = { attributes: { [NEW_ATTRIBUTE_KEY]: NEW_ATTRIBUTE_VAL } }; await supertest - .put( - `${getUrlPrefix(spaceId)}/api/saved_objects/visualization/${getIdPrefix( - spaceId - )}not an id` - ) - .auth(user.username, user.password) - .send({ - attributes: { - title: 'My second favorite vis', - }, - }) - .expect(tests.doesntExist.statusCode) - .then(tests.doesntExist.response); + .put(`${getUrlPrefix(spaceId)}/api/saved_objects/${type}/${id}`) + .auth(user?.username, user?.password) + .send(requestBody) + .expect(test.responseStatusCode) + .then(test.responseBody); }); - }); + } }); }; - const updateTest = makeUpdateTest(describe); + const addTests = makeUpdateTest(describe); // @ts-ignore - updateTest.only = makeUpdateTest(describe.only); + addTests.only = makeUpdateTest(describe.only); return { - createExpectDoesntExistNotFound, - createExpectSpaceAwareNotFound, - expectSpaceNotFound: expectHiddenTypeNotFound, - expectDoesntExistRbacForbidden, - expectNotSpaceAwareRbacForbidden, - expectNotSpaceAwareResults, - expectSpaceAwareRbacForbidden, - expectSpaceAwareResults, - expectHiddenTypeRbacForbidden, - updateTest, + addTests, + createTestDefinitions, }; } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_create.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_create.ts index 7768665f3b941..70d3afbfc9af3 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_create.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_create.ts @@ -4,206 +4,104 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkCreateTestSuiteFactory } from '../../common/suites/bulk_create'; +import { + bulkCreateTestSuiteFactory, + TEST_CASES as CASES, + BulkCreateTestDefinition, +} from '../../common/suites/bulk_create'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean, spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { + ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + ...fail409(!overwrite && spaceId === DEFAULT_SPACE_ID), + }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(!overwrite && spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(!overwrite && spaceId === SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail409(!overwrite || (spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID)), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail409(!overwrite || spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail409(!overwrite || spaceId !== SPACE_2_ID) }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_MULTI_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail400() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - bulkCreateTest, - createExpectResults, - createExpectRbacForbidden, - expectBadRequestForHiddenType, - expectedForbiddenTypesWithHiddenType, - } = bulkCreateTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = bulkCreateTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = (overwrite: boolean, spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(overwrite, spaceId); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true, overwrite, { spaceId }), + authorized: [ + createTestDefinitions(normalTypes, false, overwrite, { spaceId, singleRequest: true }), + createTestDefinitions(hiddenType, true, overwrite, { spaceId }), + createTestDefinitions(allTypes, true, overwrite, { + spaceId, + singleRequest: true, + responseBodyOverride: expectForbidden(['hiddentype']), + }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, overwrite, { + spaceId, + singleRequest: true, + }), + }; + }; describe('_bulk_create', () => { - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - bulkCreateTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingSpace: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - }, - }); - - bulkCreateTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkCreateTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkCreateTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkCreateTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); + getTestScenarios([false, true]).securityAndSpaces.forEach( + ({ spaceId, users, modifier: overwrite }) => { + const suffix = ` within the ${spaceId} space${overwrite ? ' with overwrite enabled' : ''}`; + const { unauthorized, authorized, superuser } = createTests(overwrite!, spaceId); + const _addTests = (user: TestUser, tests: BulkCreateTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - bulkCreateTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - }); + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally, users.allAtSpace].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); + } + ); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_get.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_get.ts index ec5bce1707569..09ea867bff371 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_get.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_get.ts @@ -4,205 +4,91 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkGetTestSuiteFactory } from '../../common/suites/bulk_get'; +import { + bulkGetTestSuiteFactory, + TEST_CASES as CASES, + BulkGetTestDefinition, +} from '../../common/suites/bulk_get'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail400() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - const { - bulkGetTest, - createExpectResults, - createExpectRbacForbidden, - expectBadRequestForHiddenType, - expectedForbiddenTypesWithHiddenType, - } = bulkGetTestSuiteFactory(esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = bulkGetTestSuiteFactory( + esArchiver, + supertest + ); + const createTests = (spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(spaceId); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false, { singleRequest: true }), + createTestDefinitions(hiddenType, true), + createTestDefinitions(allTypes, true, { + singleRequest: true, + responseBodyOverride: expectForbidden(['hiddentype']), + }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, { singleRequest: true }), + }; + }; describe('_bulk_get', () => { - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - bulkGetTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkGetTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - }, - }); - - bulkGetTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkGetTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized, superuser } = createTests(spaceId); + const _addTests = (user: TestUser, tests: BulkGetTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - bulkGetTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, + [users.noAccess, users.legacyAll, users.allAtOtherSpace].forEach(user => { + _addTests(user, unauthorized); }); - - bulkGetTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, + [ + users.dualAll, + users.dualRead, + users.allGlobally, + users.readGlobally, + users.allAtSpace, + users.readAtSpace, + ].forEach(user => { + _addTests(user, authorized); }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_update.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_update.ts index 06240647b37a8..987209653b347 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_update.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/bulk_update.ts @@ -4,290 +4,91 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkUpdateTestSuiteFactory } from '../../common/suites/bulk_update'; +import { + bulkUpdateTestSuiteFactory, + TEST_CASES as CASES, + BulkUpdateTestDefinition, +} from '../../common/suites/bulk_update'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('bulkUpdate', () => { - const { - createExpectDoesntExistNotFound, - expectDoesntExistRbacForbidden, - expectNotSpaceAwareResults, - expectNotSpaceAwareRbacForbidden, - expectSpaceAwareRbacForbidden, - expectSpaceAwareResults, - expectSpaceNotFound, - expectHiddenTypeRbacForbidden, - expectHiddenTypeRbacForbiddenWithGlobalAllowed, - bulkUpdateTest, - } = bulkUpdateTestSuiteFactory(esArchiver, supertest); - - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - bulkUpdateTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 200, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - bulkUpdateTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbiddenWithGlobalAllowed, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions, expectForbidden } = bulkUpdateTestSuiteFactory( + esArchiver, + supertest + ); + const createTests = (spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(spaceId); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false, { singleRequest: true }), + createTestDefinitions(hiddenType, true), + createTestDefinitions(allTypes, true, { + singleRequest: true, + responseBodyOverride: expectForbidden(['hiddentype']), + }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, { singleRequest: true }), + }; + }; - bulkUpdateTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); + describe('_bulk_update', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized, superuser } = createTests(spaceId); + const _addTests = (user: TestUser, tests: BulkUpdateTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - bulkUpdateTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbiddenWithGlobalAllowed, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); }); - - bulkUpdateTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbiddenWithGlobalAllowed, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - bulkUpdateTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, + [users.dualAll, users.allGlobally, users.allAtSpace].forEach(user => { + _addTests(user, authorized); }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/create.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/create.ts index e4adaa580c1db..7278504b8f0e8 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/create.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/create.ts @@ -4,248 +4,91 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { createTestSuiteFactory } from '../../common/suites/create'; +import { + createTestSuiteFactory, + TEST_CASES as CASES, + CreateTestDefinition, +} from '../../common/suites/create'; -export default function({ getService }: FtrProviderContext) { - const supertestWithoutAuth = getService('supertestWithoutAuth'); - const es = getService('legacyEs'); - const esArchiver = getService('esArchiver'); - - const { - createTest, - createExpectSpaceAwareResults, - expectNotSpaceAwareResults, - expectNotSpaceAwareRbacForbidden, - expectSpaceAwareRbacForbidden, - expectBadRequestForHiddenType, - expectHiddenTypeRbacForbidden, - } = createTestSuiteFactory(es, esArchiver, supertestWithoutAuth); - - describe('create', () => { - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - createTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 400, - response: expectBadRequestForHiddenType, - }, - }, - }); +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; - createTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); +const createTestCases = (overwrite: boolean, spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { + ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + ...fail409(!overwrite && spaceId === DEFAULT_SPACE_ID), + }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(!overwrite && spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(!overwrite && spaceId === SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail409(!overwrite || (spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID)), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail409(!overwrite || spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail409(!overwrite || spaceId !== SPACE_2_ID) }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_MULTI_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail400() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; - createTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); +export default function({ getService }: FtrProviderContext) { + const supertest = getService('supertestWithoutAuth'); + const esArchiver = getService('esArchiver'); + const es = getService('legacyEs'); - createTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); + const { addTests, createTestDefinitions } = createTestSuiteFactory(es, esArchiver, supertest); + const createTests = (overwrite: boolean, spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(overwrite, spaceId); + return { + unauthorized: createTestDefinitions(allTypes, true, overwrite, { spaceId }), + authorized: [ + createTestDefinitions(normalTypes, false, overwrite, { spaceId }), + createTestDefinitions(hiddenType, true, overwrite, { spaceId }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, overwrite, { spaceId }), + }; + }; - createTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); + describe('_create', () => { + getTestScenarios([false, true]).securityAndSpaces.forEach( + ({ spaceId, users, modifier: overwrite }) => { + const suffix = ` within the ${spaceId} space${overwrite ? ' with overwrite enabled' : ''}`; + const { unauthorized, authorized, superuser } = createTests(overwrite!, spaceId); + const _addTests = (user: TestUser, tests: CreateTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - createTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - }); + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally, users.allAtSpace].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); + } + ); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/delete.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/delete.ts index bfd2112428db4..995b8fc2422d9 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/delete.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/delete.ts @@ -4,288 +4,83 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { deleteTestSuiteFactory } from '../../common/suites/delete'; +import { + deleteTestSuiteFactory, + TEST_CASES as CASES, + DeleteTestDefinition, +} from '../../common/suites/delete'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('delete', () => { - const { - createExpectUnknownDocNotFound, - deleteTest, - expectEmpty, - expectRbacSpaceAwareForbidden, - expectRbacNotSpaceAwareForbidden, - expectRbacInvalidIdForbidden, - expectGenericNotFound, - expectRbacHiddenTypeForbidden, - } = deleteTestSuiteFactory(esArchiver, supertest); - - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - deleteTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 404, - response: expectGenericNotFound, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(scenario.spaceId), - }, - }, - }); - - deleteTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(scenario.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = deleteTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(spaceId); + return { + unauthorized: createTestDefinitions(allTypes, true, { spaceId }), + authorized: [ + createTestDefinitions(normalTypes, false, { spaceId }), + createTestDefinitions(hiddenType, true, { spaceId }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, { spaceId }), + }; + }; - deleteTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); + describe('_delete', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized, superuser } = createTests(spaceId); + const _addTests = (user: TestUser, tests: DeleteTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - deleteTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(scenario.spaceId), - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); }); - - deleteTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(scenario.spaceId), - }, - }, - }); - - deleteTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacHiddenTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, + [users.dualAll, users.allGlobally, users.allAtSpace].forEach(user => { + _addTests(user, authorized); }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/export.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/export.ts index b64c3ed87c35d..6f2426e55c6a6 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/export.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/export.ts @@ -4,274 +4,70 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; -import { SPACES } from '../../common/lib/spaces'; +import { getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { exportTestSuiteFactory } from '../../common/suites/export'; +import { + exportTestSuiteFactory, + getTestCases, + ExportTestDefinition, +} from '../../common/suites/export'; + +const createTestCases = (spaceId: string) => { + const cases = getTestCases(spaceId); + const exportableTypes = [ + cases.singleNamespaceObject, + cases.singleNamespaceType, + cases.namespaceAgnosticObject, + cases.namespaceAgnosticType, + ]; + const nonExportableTypes = [ + cases.multiNamespaceObject, + cases.multiNamespaceType, + cases.hiddenObject, + cases.hiddenType, + ]; + const allTypes = exportableTypes.concat(nonExportableTypes); + return { exportableTypes, nonExportableTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('export', () => { - const { - createExpectRbacForbidden, - expectTypeOrObjectsRequired, - createExpectVisualizationResults, - expectInvalidTypeSpecified, - exportTest, - } = exportTestSuiteFactory(esArchiver, supertest); + const { addTests, createTestDefinitions } = exportTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const { exportableTypes, nonExportableTypes, allTypes } = createTestCases(spaceId); + return { + unauthorized: [ + createTestDefinitions(exportableTypes, true), + createTestDefinitions(nonExportableTypes, false), + ].flat(), + authorized: createTestDefinitions(allTypes, false), + }; + }; - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - exportTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); + describe('_export', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized } = createTests(spaceId); + const _addTests = (user: TestUser, tests: ExportTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - exportTest(`superuser with the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, + [users.noAccess, users.legacyAll, users.allAtOtherSpace].forEach(user => { + _addTests(user, unauthorized); }); - - exportTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest(`rbac user with all at the other space within ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, + [ + users.dualAll, + users.dualRead, + users.allGlobally, + users.readGlobally, + users.allAtSpace, + users.readAtSpace, + users.superuser, + ].forEach(user => { + _addTests(user, authorized); }); }); }); diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/find.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/find.ts index 366b8b44585cd..7c16c01d203c0 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/find.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/find.ts @@ -4,727 +4,71 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; -import { SPACES } from '../../common/lib/spaces'; +import { getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { findTestSuiteFactory } from '../../common/suites/find'; +import { findTestSuiteFactory, getTestCases, FindTestDefinition } from '../../common/suites/find'; + +const createTestCases = (spaceId: string) => { + const cases = getTestCases(spaceId); + const normalTypes = [ + cases.singleNamespaceType, + cases.multiNamespaceType, + cases.namespaceAgnosticType, + cases.pageBeyondTotal, + cases.unknownSearchField, + cases.filterWithNamespaceAgnosticType, + cases.filterWithDisallowedType, + ]; + const hiddenAndUnknownTypes = [ + cases.hiddenType, + cases.unknownType, + cases.filterWithHiddenType, + cases.filterWithUnknownType, + ]; + const allTypes = normalTypes.concat(hiddenAndUnknownTypes); + return { normalTypes, hiddenAndUnknownTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('find', () => { - const { - createExpectEmpty, - createExpectRbacForbidden, - createExpectVisualizationResults, - expectFilterWrongTypeError, - expectNotSpaceAwareResults, - expectTypeRequired, - findTest, - } = findTestSuiteFactory(esArchiver, supertest); + const { addTests, createTestDefinitions } = findTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const { normalTypes, hiddenAndUnknownTypes, allTypes } = createTestCases(spaceId); + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenAndUnknownTypes, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - findTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and find url message', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); + describe('_find', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized, superuser } = createTests(spaceId); + const _addTests = (user: TestUser, tests: FindTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - findTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - unknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithUnknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, + [users.noAccess, users.legacyAll, users.allAtOtherSpace].forEach(user => { + _addTests(user, unauthorized); }); - - findTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and find url message', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); - - findTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(scenario.spaceId), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and find url message', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, + [ + users.dualAll, + users.dualRead, + users.allGlobally, + users.readGlobally, + users.allAtSpace, + users.readAtSpace, + ].forEach(user => { + _addTests(user, authorized); }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/get.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/get.ts index 9667abcc5e57a..9e3203e147493 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/get.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/get.ts @@ -4,289 +4,84 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { getTestSuiteFactory } from '../../common/suites/get'; +import { + getTestSuiteFactory, + TEST_CASES as CASES, + GetTestDefinition, +} from '../../common/suites/get'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - const { - createExpectDoesntExistNotFound, - createExpectSpaceAwareResults, - createExpectNotSpaceAwareResults, - expectSpaceAwareRbacForbidden, - expectNotSpaceAwareRbacForbidden, - expectDoesntExistRbacForbidden, - expectHiddenTypeRbacForbidden, - expectHiddenTypeNotFound, - getTest, - } = getTestSuiteFactory(esArchiver, supertest); - - describe('get', () => { - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - getTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - getTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 404, - response: expectHiddenTypeNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - getTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - getTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = getTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(spaceId); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenType, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - getTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); + describe('_get', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized, superuser } = createTests(spaceId); + const _addTests = (user: TestUser, tests: GetTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - getTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, + [users.noAccess, users.legacyAll, users.allAtOtherSpace].forEach(user => { + _addTests(user, unauthorized); }); - - getTest(`rbac user with read globall within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - getTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - getTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(scenario.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - getTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, + [ + users.dualAll, + users.dualRead, + users.allGlobally, + users.readGlobally, + users.allAtSpace, + users.readAtSpace, + ].forEach(user => { + _addTests(user, authorized); }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/import.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/import.ts index 58859c292ce35..10c7f61dce5cc 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/import.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/import.ts @@ -4,245 +4,92 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { importTestSuiteFactory } from '../../common/suites/import'; +import { + importTestSuiteFactory, + TEST_CASES as CASES, + ImportTestDefinition, +} from '../../common/suites/import'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const importableTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail409(spaceId === DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(spaceId === SPACE_2_ID) }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409() }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const nonImportableTypes = [ + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail400() }, + { ...CASES.HIDDEN, ...fail400() }, + { ...CASES.NEW_MULTI_NAMESPACE_OBJ, ...fail400() }, + ]; + const allTypes = importableTypes.concat(nonImportableTypes); + return { importableTypes, nonImportableTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - importTest, - createExpectResults, - expectRbacForbidden, - expectUnknownTypeUnsupported: expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, - } = importTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = importTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = (spaceId: string) => { + const { importableTypes, nonImportableTypes, allTypes } = createTestCases(spaceId); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: [ + createTestDefinitions(importableTypes, true, { spaceId }), + createTestDefinitions(nonImportableTypes, false, { spaceId, singleRequest: true }), + createTestDefinitions(allTypes, true, { + spaceId, + singleRequest: true, + responseBodyOverride: expectForbidden(['dashboard', 'globaltype', 'isolatedtype']), + }), + ].flat(), + authorized: createTestDefinitions(allTypes, false, { spaceId, singleRequest: true }), + }; + }; describe('_import', () => { - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - importTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized } = createTests(spaceId); + const _addTests = (user: TestUser, tests: ImportTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - importTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); }); - - importTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, + [users.dualAll, users.allGlobally, users.allAtSpace, users.superuser].forEach(user => { + _addTests(user, authorized); }); }); }); diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/index.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/index.ts index bb42c5422ece5..46d7ab6425989 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/index.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/index.ts @@ -20,6 +20,7 @@ export default function({ getService, loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./bulk_create')); loadTestFile(require.resolve('./bulk_get')); + loadTestFile(require.resolve('./bulk_update')); loadTestFile(require.resolve('./create')); loadTestFile(require.resolve('./delete')); loadTestFile(require.resolve('./export')); @@ -28,6 +29,5 @@ export default function({ getService, loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./import')); loadTestFile(require.resolve('./resolve_import_errors')); loadTestFile(require.resolve('./update')); - loadTestFile(require.resolve('./bulk_update')); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/resolve_import_errors.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/resolve_import_errors.ts index 6c91fe6310170..8e8fe874b4317 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/resolve_import_errors.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/resolve_import_errors.ts @@ -4,258 +4,99 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { resolveImportErrorsTestSuiteFactory } from '../../common/suites/resolve_import_errors'; +import { + resolveImportErrorsTestSuiteFactory, + TEST_CASES as CASES, + ResolveImportErrorsTestDefinition, +} from '../../common/suites/resolve_import_errors'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean, spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const importableTypes = [ + { + ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + ...fail409(!overwrite && spaceId === DEFAULT_SPACE_ID), + }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(!overwrite && spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(!overwrite && spaceId === SPACE_2_ID) }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const nonImportableTypes = [ + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail400() }, + { ...CASES.HIDDEN, ...fail400() }, + { ...CASES.NEW_MULTI_NAMESPACE_OBJ, ...fail400() }, + ]; + const allTypes = importableTypes.concat(nonImportableTypes); + return { importableTypes, nonImportableTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - resolveImportErrorsTest, - createExpectResults, - expectRbacForbidden, - expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, - } = resolveImportErrorsTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = resolveImportErrorsTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = (overwrite: boolean, spaceId: string) => { + const { importableTypes, nonImportableTypes, allTypes } = createTestCases(overwrite, spaceId); + const singleRequest = true; + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: [ + createTestDefinitions(importableTypes, true, overwrite, { spaceId }), + createTestDefinitions(nonImportableTypes, false, overwrite, { spaceId, singleRequest }), + createTestDefinitions(allTypes, true, overwrite, { + spaceId, + singleRequest, + responseBodyOverride: expectForbidden(['dashboard', 'globaltype', 'isolatedtype']), + }), + ].flat(), + authorized: createTestDefinitions(allTypes, false, overwrite, { spaceId, singleRequest }), + }; + }; describe('_resolve_import_errors', () => { - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - resolveImportErrorsTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest( - `dual-privileges readonly user within the ${scenario.spaceId} space`, - { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - } - ); - - resolveImportErrorsTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest( - `rbac user with all at the space within the ${scenario.spaceId} space`, - { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectResults(scenario.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - } - ); - - resolveImportErrorsTest( - `rbac user with read at the space within the ${scenario.spaceId} space`, - { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - } - ); + getTestScenarios([false, true]).securityAndSpaces.forEach( + ({ spaceId, users, modifier: overwrite }) => { + const suffix = ` within the ${spaceId} space${overwrite ? ' with overwrite enabled' : ''}`; + const { unauthorized, authorized } = createTests(overwrite!, spaceId); + const _addTests = (user: TestUser, tests: ResolveImportErrorsTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - resolveImportErrorsTest( - `rbac user with all at other space within the ${scenario.spaceId} space`, - { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - } - ); - }); + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally, users.allAtSpace, users.superuser].forEach(user => { + _addTests(user, authorized); + }); + } + ); }); } diff --git a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/update.ts b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/update.ts index 8eb06e41e2a41..21f354d2a8e76 100644 --- a/x-pack/test/saved_object_api_integration/security_and_spaces/apis/update.ts +++ b/x-pack/test/saved_object_api_integration/security_and_spaces/apis/update.ts @@ -4,289 +4,83 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { updateTestSuiteFactory } from '../../common/suites/update'; +import { + updateTestSuiteFactory, + TEST_CASES as CASES, + UpdateTestDefinition, +} from '../../common/suites/update'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('update', () => { - const { - createExpectDoesntExistNotFound, - expectDoesntExistRbacForbidden, - expectNotSpaceAwareResults, - expectNotSpaceAwareRbacForbidden, - expectSpaceAwareRbacForbidden, - expectSpaceAwareResults, - expectSpaceNotFound, - expectHiddenTypeRbacForbidden, - updateTest, - } = updateTestSuiteFactory(esArchiver, supertest); - - [ - { - spaceId: SPACES.DEFAULT.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - }, - }, - { - spaceId: SPACES.SPACE_1.spaceId, - users: { - noAccess: AUTHENTICATION.NOT_A_KIBANA_USER, - superuser: AUTHENTICATION.SUPERUSER, - legacyAll: AUTHENTICATION.KIBANA_LEGACY_USER, - allGlobally: AUTHENTICATION.KIBANA_RBAC_USER, - readGlobally: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - dualAll: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - dualRead: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - allAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - readAtSpace: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - allAtOtherSpace: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - }, - }, - ].forEach(scenario => { - updateTest(`user with no access within the ${scenario.spaceId} space`, { - user: scenario.users.noAccess, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`superuser within the ${scenario.spaceId} space`, { - user: scenario.users.superuser, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 404, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - updateTest(`legacy user within the ${scenario.spaceId} space`, { - user: scenario.users.legacyAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`dual-privileges user within the ${scenario.spaceId} space`, { - user: scenario.users.dualAll, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = updateTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(spaceId); + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenType, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - updateTest(`dual-privileges readonly user within the ${scenario.spaceId} space`, { - user: scenario.users.dualRead, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); + describe('_update', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` within the ${spaceId} space`; + const { unauthorized, authorized, superuser } = createTests(spaceId); + const _addTests = (user: TestUser, tests: UpdateTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; - updateTest(`rbac user with all globally within the ${scenario.spaceId} space`, { - user: scenario.users.allGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); }); - - updateTest(`rbac user with read globally within the ${scenario.spaceId} space`, { - user: scenario.users.readGlobally, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`rbac user with all at the space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(scenario.spaceId), - }, - }, - }); - - updateTest(`rbac user with read at the space within the ${scenario.spaceId} space`, { - user: scenario.users.readAtSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`rbac user with all at other space within the ${scenario.spaceId} space`, { - user: scenario.users.allAtOtherSpace, - spaceId: scenario.spaceId, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, + [users.dualAll, users.allGlobally, users.allAtSpace].forEach(user => { + _addTests(user, authorized); }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/bulk_create.ts b/x-pack/test/saved_object_api_integration/security_only/apis/bulk_create.ts index 943a22c4399c7..5b3397c7909ae 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/bulk_create.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/bulk_create.ts @@ -4,176 +4,88 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkCreateTestSuiteFactory } from '../../common/suites/bulk_create'; +import { + bulkCreateTestSuiteFactory, + TEST_CASES as CASES, + BulkCreateTestDefinition, +} from '../../common/suites/bulk_create'; + +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail409(!overwrite) }, + CASES.SINGLE_NAMESPACE_SPACE_1, + CASES.SINGLE_NAMESPACE_SPACE_2, + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail409(!overwrite) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail409() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail409() }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_MULTI_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail400() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - bulkCreateTest, - createExpectResults, - createExpectRbacForbidden, - expectBadRequestForHiddenType, - expectedForbiddenTypesWithHiddenType: expectedForbiddenTypesWithHiddenType, - } = bulkCreateTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = bulkCreateTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = (overwrite: boolean) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(overwrite); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true, overwrite), + authorized: [ + createTestDefinitions(normalTypes, false, overwrite, { singleRequest: true }), + createTestDefinitions(hiddenType, true, overwrite), + createTestDefinitions(allTypes, true, overwrite, { + singleRequest: true, + responseBodyOverride: expectForbidden(['hiddentype']), + }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, overwrite, { singleRequest: true }), + }; + }; describe('_bulk_create', () => { - bulkCreateTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingSpace: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - }, - }); - - bulkCreateTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkCreateTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkCreateTest(`rbac readonly user`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkCreateTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); + getTestScenarios([false, true]).security.forEach(({ users, modifier: overwrite }) => { + const suffix = overwrite ? ' with overwrite enabled' : ''; + const { unauthorized, authorized, superuser } = createTests(overwrite!); + const _addTests = (user: TestUser, tests: BulkCreateTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, tests }); + }; - bulkCreateTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingSpace: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/bulk_get.ts b/x-pack/test/saved_object_api_integration/security_only/apis/bulk_get.ts index fde98694fe575..69494ed254669 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/bulk_get.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/bulk_get.ts @@ -4,175 +4,81 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkGetTestSuiteFactory } from '../../common/suites/bulk_get'; +import { + bulkGetTestSuiteFactory, + TEST_CASES as CASES, + BulkGetTestDefinition, +} from '../../common/suites/bulk_get'; + +const { fail400, fail404 } = testCaseFailures; + +const createTestCases = () => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404() }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404() }, + CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404() }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail400() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - const { - bulkGetTest, - createExpectResults, - createExpectRbacForbidden, - expectedForbiddenTypesWithHiddenType, - expectBadRequestForHiddenType, - } = bulkGetTestSuiteFactory(esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = bulkGetTestSuiteFactory( + esArchiver, + supertest + ); + const createTests = () => { + const { normalTypes, hiddenType, allTypes } = createTestCases(); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false, { singleRequest: true }), + createTestDefinitions(hiddenType, true), + createTestDefinitions(allTypes, true, { + singleRequest: true, + responseBodyOverride: expectForbidden(['hiddentype']), + }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, { singleRequest: true }), + }; + }; describe('_bulk_get', () => { - bulkGetTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkGetTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingHiddenType: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - }, - }); - - bulkGetTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkGetTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(['hiddentype']), - }, - }, - }); - - bulkGetTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkGetTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); - - bulkGetTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, - }); + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized, superuser } = createTests(); + const _addTests = (user: TestUser, tests: BulkGetTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - bulkGetTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - default: { - statusCode: 403, - response: createExpectRbacForbidden(), - }, - includingHiddenType: { - statusCode: 403, - response: createExpectRbacForbidden(expectedForbiddenTypesWithHiddenType), - }, - }, + [ + users.noAccess, + users.legacyAll, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.dualRead, users.allGlobally, users.readGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/bulk_update.ts b/x-pack/test/saved_object_api_integration/security_only/apis/bulk_update.ts index 6f4635f17cf8c..fb169f4c6fb86 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/bulk_update.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/bulk_update.ts @@ -4,268 +4,83 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkUpdateTestSuiteFactory } from '../../common/suites/bulk_update'; +import { + bulkUpdateTestSuiteFactory, + TEST_CASES as CASES, + BulkUpdateTestDefinition, +} from '../../common/suites/bulk_update'; + +const { fail404 } = testCaseFailures; + +const createTestCases = () => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404() }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404() }, + CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404() }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('bulkUpdate', () => { - const { - createExpectDoesntExistNotFound, - expectDoesntExistRbacForbidden, - expectNotSpaceAwareResults, - expectNotSpaceAwareRbacForbidden, - expectSpaceAwareRbacForbidden, - expectSpaceAwareResults, - expectSpaceNotFound, - expectHiddenTypeRbacForbidden, - expectHiddenTypeRbacForbiddenWithGlobalAllowed, - bulkUpdateTest, - } = bulkUpdateTestSuiteFactory(esArchiver, supertest); - - bulkUpdateTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 200, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(), - }, - }, - }); + const { addTests, createTestDefinitions, expectForbidden } = bulkUpdateTestSuiteFactory( + esArchiver, + supertest + ); + const createTests = () => { + const { normalTypes, hiddenType, allTypes } = createTestCases(); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false, { singleRequest: true }), + createTestDefinitions(hiddenType, true), + createTestDefinitions(allTypes, true, { + singleRequest: true, + responseBodyOverride: expectForbidden(['hiddentype']), + }), + ].flat(), + superuser: createTestDefinitions(allTypes, false, { singleRequest: true }), + }; + }; - bulkUpdateTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbiddenWithGlobalAllowed, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - bulkUpdateTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbiddenWithGlobalAllowed, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - bulkUpdateTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - bulkUpdateTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); + describe('_bulk_update', () => { + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized, superuser } = createTests(); + const _addTests = (user: TestUser, tests: BulkUpdateTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - bulkUpdateTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/create.ts b/x-pack/test/saved_object_api_integration/security_only/apis/create.ts index 60a9fa0a86aa6..dc8e564e42477 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/create.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/create.ts @@ -4,222 +4,79 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { createTestSuiteFactory } from '../../common/suites/create'; +import { + createTestSuiteFactory, + TEST_CASES as CASES, + CreateTestDefinition, +} from '../../common/suites/create'; -export default function({ getService }: FtrProviderContext) { - const supertestWithoutAuth = getService('supertestWithoutAuth'); - const es = getService('legacyEs'); - const esArchiver = getService('esArchiver'); - - const { - createTest, - createExpectSpaceAwareResults, - expectNotSpaceAwareResults, - expectNotSpaceAwareRbacForbidden, - expectSpaceAwareRbacForbidden, - expectBadRequestForHiddenType, - expectHiddenTypeRbacForbidden, - } = createTestSuiteFactory(es, esArchiver, supertestWithoutAuth); - - describe('create', () => { - createTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); +const { fail400, fail409 } = testCaseFailures; - createTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 400, - response: expectBadRequestForHiddenType, - }, - }, - }); - - createTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); +const createTestCases = (overwrite: boolean) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail409(!overwrite) }, + CASES.SINGLE_NAMESPACE_SPACE_1, + CASES.SINGLE_NAMESPACE_SPACE_2, + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail409(!overwrite) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail409() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail409() }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_MULTI_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail400() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; - createTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); - - createTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); +export default function({ getService }: FtrProviderContext) { + const supertest = getService('supertestWithoutAuth'); + const esArchiver = getService('esArchiver'); + const es = getService('legacyEs'); - createTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); + const { addTests, createTestDefinitions } = createTestSuiteFactory(es, esArchiver, supertest); + const createTests = (overwrite: boolean) => { + const { normalTypes, hiddenType, allTypes } = createTestCases(overwrite); + return { + unauthorized: createTestDefinitions(allTypes, true, overwrite), + authorized: [ + createTestDefinitions(normalTypes, false, overwrite), + createTestDefinitions(hiddenType, true, overwrite), + ].flat(), + superuser: createTestDefinitions(allTypes, false, overwrite), + }; + }; - createTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, - }); + describe('_create', () => { + getTestScenarios([false, true]).security.forEach(({ users, modifier: overwrite }) => { + const suffix = overwrite ? ' with overwrite enabled' : ''; + const { unauthorized, authorized, superuser } = createTests(overwrite!); + const _addTests = (user: TestUser, tests: CreateTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, tests }); + }; - createTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/delete.ts b/x-pack/test/saved_object_api_integration/security_only/apis/delete.ts index f775b5a365d6b..05939197be352 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/delete.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/delete.ts @@ -4,266 +4,75 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { deleteTestSuiteFactory } from '../../common/suites/delete'; +import { + deleteTestSuiteFactory, + TEST_CASES as CASES, + DeleteTestDefinition, +} from '../../common/suites/delete'; + +const { fail404 } = testCaseFailures; + +const createTestCases = () => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404() }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404() }, + CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404() }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('delete', () => { - const { - createExpectUnknownDocNotFound, - deleteTest, - expectEmpty, - expectRbacSpaceAwareForbidden, - expectRbacNotSpaceAwareForbidden, - expectRbacInvalidIdForbidden, - expectRbacHiddenTypeForbidden: expectRbacSpaceTypeForbidden, - expectGenericNotFound, - } = deleteTestSuiteFactory(esArchiver, supertest); - - deleteTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 404, - response: expectGenericNotFound, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(), - }, - }, - }); + const { addTests, createTestDefinitions } = deleteTestSuiteFactory(esArchiver, supertest); + const createTests = () => { + const { normalTypes, hiddenType, allTypes } = createTestCases(); + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenType, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - deleteTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(), - }, - }, - }); - - deleteTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(), - }, - }, - }); - - deleteTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); - - deleteTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, - }); + describe('_delete', () => { + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized, superuser } = createTests(); + const _addTests = (user: TestUser, tests: DeleteTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - deleteTest(`rbac user with readonly at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectRbacSpaceAwareForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectRbacNotSpaceAwareForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacSpaceTypeForbidden, - }, - invalidId: { - statusCode: 403, - response: expectRbacInvalidIdForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/export.ts b/x-pack/test/saved_object_api_integration/security_only/apis/export.ts index 2a2c3a9b90b08..0fae45a1897a7 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/export.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/export.ts @@ -4,252 +4,75 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { exportTestSuiteFactory } from '../../common/suites/export'; +import { + exportTestSuiteFactory, + getTestCases, + ExportTestDefinition, +} from '../../common/suites/export'; + +const createTestCases = () => { + const cases = getTestCases(); + const exportableTypes = [ + cases.singleNamespaceObject, + cases.singleNamespaceType, + cases.namespaceAgnosticObject, + cases.namespaceAgnosticType, + ]; + const nonExportableTypes = [ + cases.multiNamespaceObject, + cases.multiNamespaceType, + cases.hiddenObject, + cases.hiddenType, + ]; + const allTypes = exportableTypes.concat(nonExportableTypes); + return { exportableTypes, nonExportableTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('export', () => { - const { - createExpectRbacForbidden, - expectTypeOrObjectsRequired, - createExpectVisualizationResults, - expectInvalidTypeSpecified, - exportTest, - } = exportTestSuiteFactory(esArchiver, supertest); - - exportTest('user with no access', { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('superuser', { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('legacy user', { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('dual-privileges user', { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('dual-privileges readonly user', { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('rbac user with all globally', { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('rbac user with read globally', { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); + const { addTests, createTestDefinitions } = exportTestSuiteFactory(esArchiver, supertest); + const createTests = () => { + const { exportableTypes, nonExportableTypes, allTypes } = createTestCases(); + return { + unauthorized: [ + createTestDefinitions(exportableTypes, true), + createTestDefinitions(nonExportableTypes, false), + ].flat(), + authorized: createTestDefinitions(allTypes, false), + }; + }; - exportTest('rbac user with all at default space', { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('rbac user with read at default space', { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); - - exportTest('rbac user with all at space_1', { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); + describe('_export', () => { + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized } = createTests(); + const _addTests = (user: TestUser, tests: ExportTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - exportTest('rbac user with read at space_1', { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [ + users.dualAll, + users.dualRead, + users.allGlobally, + users.readGlobally, + users.superuser, + ].forEach(user => { + _addTests(user, authorized); + }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/find.ts b/x-pack/test/saved_object_api_integration/security_only/apis/find.ts index 64d85a199e7bc..97513783b94b9 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/find.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/find.ts @@ -4,749 +4,70 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { findTestSuiteFactory } from '../../common/suites/find'; +import { findTestSuiteFactory, getTestCases, FindTestDefinition } from '../../common/suites/find'; + +const createTestCases = () => { + const cases = getTestCases(); + const normalTypes = [ + cases.singleNamespaceType, + cases.multiNamespaceType, + cases.namespaceAgnosticType, + cases.pageBeyondTotal, + cases.unknownSearchField, + cases.filterWithNamespaceAgnosticType, + cases.filterWithDisallowedType, + ]; + const hiddenAndUnknownTypes = [ + cases.hiddenType, + cases.unknownType, + cases.filterWithHiddenType, + cases.filterWithUnknownType, + ]; + const allTypes = normalTypes.concat(hiddenAndUnknownTypes); + return { normalTypes, hiddenAndUnknownTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('find', () => { - const { - createExpectEmpty, - createExpectRbacForbidden, - createExpectVisualizationResults, - expectFilterWrongTypeError, - expectNotSpaceAwareResults, - expectTypeRequired, - findTest, - } = findTestSuiteFactory(esArchiver, supertest); - - findTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden login and find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and unknown search field', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden login and find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); - - findTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - unknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithUnknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAwareType: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden login and find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'forbidden login and find visualization message', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and unknown search field', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'forbidden login and find globaltype message', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden login and find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); - - findTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); - - findTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); + const { addTests, createTestDefinitions } = findTestSuiteFactory(esArchiver, supertest); + const createTests = () => { + const { normalTypes, hiddenAndUnknownTypes, allTypes } = createTestCases(); + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenAndUnknownTypes, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - findTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and unknown search field', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); - - findTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and unknown search field', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); - - findTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and unknown search field', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, - }); + describe('_find', () => { + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized, superuser } = createTests(); + const _addTests = (user: TestUser, tests: FindTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - findTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - notSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - hiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - unknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 403, - response: createExpectRbacForbidden('visualization'), - }, - unknownSearchField: { - description: 'forbidden login and unknown search field', - statusCode: 403, - response: createExpectRbacForbidden('url'), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the globaltype', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - filterWithHiddenType: { - description: 'forbidden find hiddentype message', - statusCode: 403, - response: createExpectRbacForbidden('hiddentype'), - }, - filterWithUnknownType: { - description: 'forbidden find wigwags message', - statusCode: 403, - response: createExpectRbacForbidden('wigwags'), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'forbidden', - statusCode: 403, - response: createExpectRbacForbidden('globaltype'), - }, - }, + [ + users.noAccess, + users.legacyAll, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.dualRead, users.allGlobally, users.readGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/get.ts b/x-pack/test/saved_object_api_integration/security_only/apis/get.ts index 2a31463fce8b2..7cd50fe4cea61 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/get.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/get.ts @@ -4,267 +4,73 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { getTestSuiteFactory } from '../../common/suites/get'; +import { + getTestSuiteFactory, + TEST_CASES as CASES, + GetTestDefinition, +} from '../../common/suites/get'; + +const { fail404 } = testCaseFailures; + +const createTestCases = () => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404() }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404() }, + CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404() }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - const { - createExpectDoesntExistNotFound, - createExpectSpaceAwareResults, - createExpectNotSpaceAwareResults, - expectSpaceAwareRbacForbidden, - expectNotSpaceAwareRbacForbidden, - expectDoesntExistRbacForbidden, - expectHiddenTypeRbacForbidden, - expectHiddenTypeNotFound, - getTest, - } = getTestSuiteFactory(esArchiver, supertest); - - describe('get', () => { - getTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - getTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(), - }, - hiddenType: { - statusCode: 404, - response: expectHiddenTypeNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); + const { addTests, createTestDefinitions } = getTestSuiteFactory(esArchiver, supertest); + const createTests = () => { + const { normalTypes, hiddenType, allTypes } = createTestCases(); + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenType, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - getTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - getTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - getTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - getTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - getTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(), - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - getTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - getTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - getTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); + describe('_get', () => { + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized, superuser } = createTests(); + const _addTests = (user: TestUser, tests: GetTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - getTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.dualRead, users.allGlobally, users.readGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/import.ts b/x-pack/test/saved_object_api_integration/security_only/apis/import.ts index 770410dcfed81..5a6e530b02939 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/import.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/import.ts @@ -4,223 +4,87 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { importTestSuiteFactory } from '../../common/suites/import'; +import { + importTestSuiteFactory, + TEST_CASES as CASES, + ImportTestDefinition, +} from '../../common/suites/import'; + +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = () => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const importableTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail409() }, + CASES.SINGLE_NAMESPACE_SPACE_1, + CASES.SINGLE_NAMESPACE_SPACE_2, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409() }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const nonImportableTypes = [ + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail400() }, + { ...CASES.HIDDEN, ...fail400() }, + { ...CASES.NEW_MULTI_NAMESPACE_OBJ, ...fail400() }, + ]; + const allTypes = importableTypes.concat(nonImportableTypes); + return { importableTypes, nonImportableTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - importTest, - createExpectResults, - expectRbacForbidden, - expectUnknownTypeUnsupported, - expectResultsWithUnsupportedHiddenType, - } = importTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = importTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = () => { + const { importableTypes, nonImportableTypes, allTypes } = createTestCases(); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: [ + createTestDefinitions(importableTypes, true), + createTestDefinitions(nonImportableTypes, false, { singleRequest: true }), + createTestDefinitions(allTypes, true, { + singleRequest: true, + responseBodyOverride: expectForbidden(['dashboard', 'globaltype', 'isolatedtype']), + }), + ].flat(), + authorized: createTestDefinitions(allTypes, false, { singleRequest: true }), + }; + }; describe('_import', () => { - importTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - hiddenType: { - // import filters out the space type, so the remaining objects will import successfully - statusCode: 200, - response: expectResultsWithUnsupportedHiddenType, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - hiddenType: { - // import filters out the space type, so the remaining objects will import successfully - statusCode: 200, - response: expectResultsWithUnsupportedHiddenType, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - hiddenType: { - // import filters out the space type, so the remaining objects will import successfully - statusCode: 200, - response: expectResultsWithUnsupportedHiddenType, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest(`rbac readonly user`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - importTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized } = createTests(); + const _addTests = (user: TestUser, tests: ImportTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - importTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally, users.superuser].forEach(user => { + _addTests(user, authorized); + }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/index.ts b/x-pack/test/saved_object_api_integration/security_only/apis/index.ts index bb637a9bc4c90..f581e18ff17af 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/index.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/index.ts @@ -20,6 +20,7 @@ export default function({ getService, loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./bulk_create')); loadTestFile(require.resolve('./bulk_get')); + loadTestFile(require.resolve('./bulk_update')); loadTestFile(require.resolve('./create')); loadTestFile(require.resolve('./delete')); loadTestFile(require.resolve('./export')); @@ -28,6 +29,5 @@ export default function({ getService, loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./import')); loadTestFile(require.resolve('./resolve_import_errors')); loadTestFile(require.resolve('./update')); - loadTestFile(require.resolve('./bulk_update')); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/resolve_import_errors.ts b/x-pack/test/saved_object_api_integration/security_only/apis/resolve_import_errors.ts index 59d50c16c259a..f945d2b64c432 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/resolve_import_errors.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/resolve_import_errors.ts @@ -4,221 +4,88 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { resolveImportErrorsTestSuiteFactory } from '../../common/suites/resolve_import_errors'; +import { + resolveImportErrorsTestSuiteFactory, + TEST_CASES as CASES, + ResolveImportErrorsTestDefinition, +} from '../../common/suites/resolve_import_errors'; + +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean) => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const importableTypes = [ + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail409(!overwrite) }, + CASES.SINGLE_NAMESPACE_SPACE_1, + CASES.SINGLE_NAMESPACE_SPACE_2, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, + ]; + const nonImportableTypes = [ + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail400() }, + { ...CASES.HIDDEN, ...fail400() }, + { ...CASES.NEW_MULTI_NAMESPACE_OBJ, ...fail400() }, + ]; + const allTypes = importableTypes.concat(nonImportableTypes); + return { importableTypes, nonImportableTypes, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - resolveImportErrorsTest, - createExpectResults, - - expectRbacForbidden, - expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, - } = resolveImportErrorsTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions, expectForbidden } = resolveImportErrorsTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = (overwrite: boolean) => { + const { importableTypes, nonImportableTypes, allTypes } = createTestCases(overwrite); + // use singleRequest to reduce execution time and/or test combined cases + return { + unauthorized: [ + createTestDefinitions(importableTypes, true, overwrite), + createTestDefinitions(nonImportableTypes, false, overwrite, { singleRequest: true }), + createTestDefinitions(allTypes, true, overwrite, { + singleRequest: true, + responseBodyOverride: expectForbidden(['dashboard', 'globaltype', 'isolatedtype']), + }), + ].flat(), + authorized: createTestDefinitions(allTypes, false, overwrite, { singleRequest: true }), + }; + }; describe('_resolve_import_errors', () => { - resolveImportErrorsTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - default: { - statusCode: 200, - response: createExpectResults(), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest(`rbac readonly user`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); - - resolveImportErrorsTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, - }); + getTestScenarios([false, true]).security.forEach(({ users, modifier: overwrite }) => { + const suffix = overwrite ? ' with overwrite enabled' : ''; + const { unauthorized, authorized } = createTests(overwrite!); + const _addTests = (user: TestUser, tests: ResolveImportErrorsTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, tests }); + }; - resolveImportErrorsTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - default: { - statusCode: 403, - response: expectRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectRbacForbidden, - }, - unknownType: { - statusCode: 403, - response: expectRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally, users.superuser].forEach(user => { + _addTests(user, authorized); + }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/security_only/apis/update.ts b/x-pack/test/saved_object_api_integration/security_only/apis/update.ts index 8564296bdf558..e1e3a5f8a7dc7 100644 --- a/x-pack/test/saved_object_api_integration/security_only/apis/update.ts +++ b/x-pack/test/saved_object_api_integration/security_only/apis/update.ts @@ -4,267 +4,75 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AUTHENTICATION } from '../../common/lib/authentication'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; +import { TestUser } from '../../common/lib/types'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { updateTestSuiteFactory } from '../../common/suites/update'; +import { + updateTestSuiteFactory, + TEST_CASES as CASES, + UpdateTestDefinition, +} from '../../common/suites/update'; + +const { fail404 } = testCaseFailures; + +const createTestCases = () => { + // for each permitted (non-403) outcome, if failure !== undefined then we expect + // to receive an error; otherwise, we expect to receive a success result + const normalTypes = [ + CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404() }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404() }, + CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404() }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, + ]; + const hiddenType = [{ ...CASES.HIDDEN, ...fail404() }]; + const allTypes = normalTypes.concat(hiddenType); + return { normalTypes, hiddenType, allTypes }; +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); - describe('update', () => { - const { - createExpectDoesntExistNotFound, - expectDoesntExistRbacForbidden, - expectNotSpaceAwareResults, - expectNotSpaceAwareRbacForbidden, - expectSpaceAwareRbacForbidden, - expectSpaceAwareResults, - expectSpaceNotFound, - expectHiddenTypeRbacForbidden, - updateTest, - } = updateTestSuiteFactory(esArchiver, supertest); - - updateTest(`user with no access`, { - user: AUTHENTICATION.NOT_A_KIBANA_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`superuser`, { - user: AUTHENTICATION.SUPERUSER, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 404, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); + const { addTests, createTestDefinitions } = updateTestSuiteFactory(esArchiver, supertest); + const createTests = () => { + const { normalTypes, hiddenType, allTypes } = createTestCases(); + return { + unauthorized: createTestDefinitions(allTypes, true), + authorized: [ + createTestDefinitions(normalTypes, false), + createTestDefinitions(hiddenType, true), + ].flat(), + superuser: createTestDefinitions(allTypes, false), + }; + }; - updateTest(`legacy user`, { - user: AUTHENTICATION.KIBANA_LEGACY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`dual-privileges user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_USER, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - updateTest(`dual-privileges readonly user`, { - user: AUTHENTICATION.KIBANA_DUAL_PRIVILEGES_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`rbac user with all globally`, { - user: AUTHENTICATION.KIBANA_RBAC_USER, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, - }); - - updateTest(`rbac user with read globally`, { - user: AUTHENTICATION.KIBANA_RBAC_DASHBOARD_ONLY_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`rbac user with all at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`rbac user with read at default space`, { - user: AUTHENTICATION.KIBANA_RBAC_DEFAULT_SPACE_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); - - updateTest(`rbac user with all at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_ALL_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, - }); + describe('_update', () => { + getTestScenarios().security.forEach(({ users }) => { + const { unauthorized, authorized, superuser } = createTests(); + const _addTests = (user: TestUser, tests: UpdateTestDefinition[]) => { + addTests(user.description, { user, tests }); + }; - updateTest(`rbac user with read at space_1`, { - user: AUTHENTICATION.KIBANA_RBAC_SPACE_1_READ_USER, - tests: { - spaceAware: { - statusCode: 403, - response: expectSpaceAwareRbacForbidden, - }, - notSpaceAware: { - statusCode: 403, - response: expectNotSpaceAwareRbacForbidden, - }, - hiddenType: { - statusCode: 403, - response: expectHiddenTypeRbacForbidden, - }, - doesntExist: { - statusCode: 403, - response: expectDoesntExistRbacForbidden, - }, - }, + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.allAtDefaultSpace, + users.readAtDefaultSpace, + users.allAtSpace1, + users.readAtSpace1, + ].forEach(user => { + _addTests(user, unauthorized); + }); + [users.dualAll, users.allGlobally].forEach(user => { + _addTests(user, authorized); + }); + _addTests(users.superuser, superuser); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_create.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_create.ts index 690e358b744d5..70d74822a8b0f 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_create.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_create.ts @@ -6,83 +6,72 @@ import expect from '@kbn/expect'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkCreateTestSuiteFactory } from '../../common/suites/bulk_create'; +import { bulkCreateTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/bulk_create'; -const expectNamespaceSpecifiedBadRequest = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - error: 'Bad Request', - message: '[request body.0.namespace]: definition for this key is missing', - statusCode: 400, - }); -}; +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean, spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { + ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + ...fail409(!overwrite && spaceId === DEFAULT_SPACE_ID), + }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(!overwrite && spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(!overwrite && spaceId === SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail409(!overwrite || (spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID)), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail409(!overwrite || spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail409(!overwrite || spaceId !== SPACE_2_ID) }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + { ...CASES.HIDDEN, ...fail400() }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_MULTI_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - bulkCreateTest, - createExpectResults, - expectBadRequestForHiddenType, - } = bulkCreateTestSuiteFactory(es, esArchiver, supertest); - - describe('_bulk_create', () => { - bulkCreateTest('in the current space (space_1)', { - ...SPACES.SPACE_1, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.SPACE_1.spaceId), - }, - includingSpace: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - custom: { - description: 'when a namespace is specified on the saved object', - requestBody: [ - { - type: 'visualization', - namespace: 'space_1', - attributes: { - title: 'something', - }, - }, - ], - statusCode: 400, - response: expectNamespaceSpecifiedBadRequest, + const { addTests, createTestDefinitions } = bulkCreateTestSuiteFactory(es, esArchiver, supertest); + const createTests = (overwrite: boolean, spaceId: string) => { + const testCases = createTestCases(overwrite, spaceId); + return createTestDefinitions(testCases, false, overwrite, { + spaceId, + singleRequest: true, + }).concat( + ['namespace', 'namespaces'].map(key => ({ + title: `(bad request) when ${key} is specified on the saved object`, + request: [{ type: 'isolatedtype', id: 'some-id', [key]: 'any-value' }] as any, + responseStatusCode: 400, + responseBody: async (response: Record) => { + expect(response.body).to.eql({ + statusCode: 400, + error: 'Bad Request', + message: `[request body.0.${key}]: definition for this key is missing`, + }); }, - }, - }); + overwrite, + })) + ); + }; - bulkCreateTest('in the default space', { - ...SPACES.DEFAULT, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.DEFAULT.spaceId), - }, - includingSpace: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - custom: { - description: 'when a namespace is specified on the saved object', - requestBody: [ - { - type: 'visualization', - namespace: 'space_1', - attributes: { - title: 'something', - }, - }, - ], - statusCode: 400, - response: expectNamespaceSpecifiedBadRequest, - }, - }, + describe('_bulk_create', () => { + getTestScenarios([false, true]).spaces.forEach(({ spaceId, modifier: overwrite }) => { + const suffix = overwrite ? ' with overwrite enabled' : ''; + const tests = createTests(overwrite!, spaceId); + addTests(`within the ${spaceId} space${suffix}`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_get.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_get.ts index bed29f8eb39a1..ad10719750585 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_get.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_get.ts @@ -5,48 +5,48 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkGetTestSuiteFactory } from '../../common/suites/bulk_get'; +import { bulkGetTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/bulk_get'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.HIDDEN, ...fail400() }, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - const { - bulkGetTest, - createExpectResults, - createExpectNotFoundResults, - expectBadRequestForHiddenType, - } = bulkGetTestSuiteFactory(esArchiver, supertest); + const { addTests, createTestDefinitions } = bulkGetTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false, { singleRequest: true }); + }; describe('_bulk_get', () => { - bulkGetTest(`objects within the current space (space_1)`, { - ...SPACES.SPACE_1, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.SPACE_1.spaceId), - }, - includingHiddenType: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - }, - }); - - bulkGetTest(`objects within another space`, { - ...SPACES.SPACE_1, - otherSpaceId: SPACES.SPACE_2.spaceId, - tests: { - default: { - statusCode: 200, - response: createExpectNotFoundResults(SPACES.SPACE_2.spaceId), - }, - includingHiddenType: { - statusCode: 200, - response: expectBadRequestForHiddenType, - }, - }, + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_update.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_update.ts index 0681908a765ce..be6ce9e30c56e 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_update.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/bulk_update.ts @@ -5,88 +5,48 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { bulkUpdateTestSuiteFactory } from '../../common/suites/bulk_update'; +import { bulkUpdateTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/bulk_update'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.HIDDEN, ...fail404() }, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - describe('bulkUpdate', () => { - const { - createExpectSpaceAwareNotFound, - expectSpaceAwareResults, - createExpectDoesntExistNotFound, - expectNotSpaceAwareResults, - expectSpaceNotFound, - bulkUpdateTest, - } = bulkUpdateTestSuiteFactory(esArchiver, supertest); - - bulkUpdateTest(`in the default space`, { - spaceId: SPACES.DEFAULT.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 200, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(SPACES.DEFAULT.spaceId), - }, - }, - }); - - bulkUpdateTest('in the current space (space_1)', { - spaceId: SPACES.SPACE_1.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 200, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(SPACES.SPACE_1.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = bulkUpdateTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false, { singleRequest: true }); + }; - bulkUpdateTest('objects that exist in another space (space_1)', { - spaceId: SPACES.DEFAULT.spaceId, - otherSpaceId: SPACES.SPACE_1.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareNotFound(SPACES.SPACE_1.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 200, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 200, - response: createExpectDoesntExistNotFound(), - }, - }, + describe('_bulk_update', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/create.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/create.ts index 3bd4019649363..d0c6a21e73971 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/create.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/create.ts @@ -4,90 +4,56 @@ * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { createTestSuiteFactory } from '../../common/suites/create'; +import { createTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/create'; -const expectNamespaceSpecifiedBadRequest = (resp: { [key: string]: any }) => { - expect(resp.body).to.eql({ - error: 'Bad Request', - message: '[request body.namespace]: definition for this key is missing', - statusCode: 400, - }); -}; +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean, spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { + ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + ...fail409(!overwrite && spaceId === DEFAULT_SPACE_ID), + }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(!overwrite && spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(!overwrite && spaceId === SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail409(!overwrite || (spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID)), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail409(!overwrite || spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail409(!overwrite || spaceId !== SPACE_2_ID) }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + { ...CASES.HIDDEN, ...fail400() }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + CASES.NEW_MULTI_NAMESPACE_OBJ, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, +]; export default function({ getService }: FtrProviderContext) { - const supertestWithoutAuth = getService('supertestWithoutAuth'); - const es = getService('legacyEs'); + const supertest = getService('supertestWithoutAuth'); const esArchiver = getService('esArchiver'); + const es = getService('legacyEs'); - const { - createTest, - createExpectSpaceAwareResults, - expectNotSpaceAwareResults, - expectBadRequestForHiddenType, - } = createTestSuiteFactory(es, esArchiver, supertestWithoutAuth); - - describe('create', () => { - createTest('in the current space (space_1)', { - ...SPACES.SPACE_1, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(SPACES.SPACE_1.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 400, - response: expectBadRequestForHiddenType, - }, - custom: { - description: 'when a namespace is specified on the saved object', - type: 'visualization', - requestBody: { - namespace: 'space_1', - attributes: { - title: 'something', - }, - }, - statusCode: 400, - response: expectNamespaceSpecifiedBadRequest, - }, - }, - }); + const { addTests, createTestDefinitions } = createTestSuiteFactory(es, esArchiver, supertest); + const createTests = (overwrite: boolean, spaceId: string) => { + const testCases = createTestCases(overwrite, spaceId); + return createTestDefinitions(testCases, false, overwrite, { spaceId }); + }; - createTest('in the default space', { - ...SPACES.DEFAULT, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(SPACES.DEFAULT.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 400, - response: expectBadRequestForHiddenType, - }, - custom: { - description: 'when a namespace is specified on the saved object', - type: 'visualization', - requestBody: { - namespace: 'space_1', - attributes: { - title: 'something', - }, - }, - statusCode: 400, - response: expectNamespaceSpecifiedBadRequest, - }, - }, + describe('_create', () => { + getTestScenarios([false, true]).spaces.forEach(({ spaceId, modifier: overwrite }) => { + const suffix = overwrite ? ' with overwrite enabled' : ''; + const tests = createTests(overwrite!, spaceId); + addTests(`within the ${spaceId} space${suffix}`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/delete.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/delete.ts index 437b3f95024c6..bb48e06d93a09 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/delete.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/delete.ts @@ -5,87 +5,48 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { deleteTestSuiteFactory } from '../../common/suites/delete'; +import { deleteTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/delete'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.HIDDEN, ...fail404() }, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - describe('delete', () => { - const { - createExpectSpaceAwareNotFound, - createExpectUnknownDocNotFound, - deleteTest, - expectEmpty, - expectGenericNotFound, - } = deleteTestSuiteFactory(esArchiver, supertest); - - deleteTest(`in the default space`, { - ...SPACES.DEFAULT, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 404, - response: expectGenericNotFound, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(SPACES.DEFAULT.spaceId), - }, - }, - }); - - deleteTest(`in the current space (space_1)`, { - ...SPACES.SPACE_1, - tests: { - spaceAware: { - statusCode: 200, - response: expectEmpty, - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 404, - response: expectGenericNotFound, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(SPACES.SPACE_1.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = deleteTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false, { spaceId }); + }; - deleteTest(`in another space (space_2)`, { - spaceId: SPACES.SPACE_1.spaceId, - otherSpaceId: SPACES.SPACE_2.spaceId, - tests: { - spaceAware: { - statusCode: 404, - response: createExpectSpaceAwareNotFound(SPACES.SPACE_2.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectEmpty, - }, - hiddenType: { - statusCode: 404, - response: expectGenericNotFound, - }, - invalidId: { - statusCode: 404, - response: createExpectUnknownDocNotFound(SPACES.SPACE_2.spaceId), - }, - }, + describe('_delete', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/export.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/export.ts index f4be02c05ac88..25d4fbfae990b 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/export.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/export.ts @@ -4,62 +4,29 @@ * you may not use this file except in compliance with the Elastic License. */ -import { SPACES } from '../../common/lib/spaces'; +import { getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { exportTestSuiteFactory } from '../../common/suites/export'; +import { exportTestSuiteFactory, getTestCases } from '../../common/suites/export'; + +const createTestCases = (spaceId: string) => { + const cases = getTestCases(spaceId); + return Object.values(cases); +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - const { - expectTypeOrObjectsRequired, - createExpectVisualizationResults, - expectInvalidTypeSpecified, - exportTest, - } = exportTestSuiteFactory(esArchiver, supertest); - - describe('export', () => { - exportTest('objects only within the current space (space_1)', { - ...SPACES.SPACE_1, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(SPACES.SPACE_1.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, - }); + const { addTests, createTestDefinitions } = exportTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false); + }; - exportTest('objects only within the current space (default)', { - ...SPACES.DEFAULT, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(SPACES.DEFAULT.spaceId), - }, - hiddenType: { - description: 'exporting space not allowed', - statusCode: 400, - response: expectInvalidTypeSpecified, - }, - noTypeOrObjects: { - description: 'bad request, type or object is required', - statusCode: 400, - response: expectTypeOrObjectsRequired, - }, - }, + describe('_export', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/find.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/find.ts index a07d3edf834e9..a15f7de404db8 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/find.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/find.ts @@ -4,154 +4,29 @@ * you may not use this file except in compliance with the Elastic License. */ -import { SPACES } from '../../common/lib/spaces'; +import { getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { findTestSuiteFactory } from '../../common/suites/find'; +import { findTestSuiteFactory, getTestCases } from '../../common/suites/find'; + +const createTestCases = (spaceId: string) => { + const cases = getTestCases(spaceId); + return Object.values(cases); +}; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - const { - createExpectEmpty, - createExpectVisualizationResults, - expectFilterWrongTypeError, - expectNotSpaceAwareResults, - expectTypeRequired, - findTest, - } = findTestSuiteFactory(esArchiver, supertest); - - describe('find', () => { - findTest(`objects only within the current space (space_1)`, { - ...SPACES.SPACE_1, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(SPACES.SPACE_1.spaceId), - }, - notSpaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - unknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithUnknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, - }); + const { addTests, createTestDefinitions } = findTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false); + }; - findTest(`objects only within the current space (default)`, { - ...SPACES.DEFAULT, - tests: { - spaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: createExpectVisualizationResults(SPACES.DEFAULT.spaceId), - }, - notSpaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - unknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - pageBeyondTotal: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(100, 100, 1), - }, - unknownSearchField: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - noType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithNotSpaceAwareType: { - description: 'only the visualization', - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - filterWithHiddenType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithUnknownType: { - description: 'empty result', - statusCode: 200, - response: createExpectEmpty(1, 20, 0), - }, - filterWithNoType: { - description: 'bad request, type is required', - statusCode: 400, - response: expectTypeRequired, - }, - filterWithUnAllowedType: { - description: 'Bad Request', - statusCode: 400, - response: expectFilterWrongTypeError, - }, - }, + describe('_find', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/get.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/get.ts index 592bedd92b4d7..512ae968dd0dd 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/get.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/get.ts @@ -5,88 +5,48 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { getTestSuiteFactory } from '../../common/suites/get'; +import { getTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/get'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.HIDDEN, ...fail404() }, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - const { - createExpectDoesntExistNotFound, - createExpectSpaceAwareNotFound, - createExpectSpaceAwareResults, - createExpectNotSpaceAwareResults, - expectHiddenTypeNotFound: expectHiddenTypeNotFound, - getTest, - } = getTestSuiteFactory(esArchiver, supertest); - - describe('get', () => { - getTest(`can access objects belonging to the current space (default)`, { - ...SPACES.DEFAULT, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(SPACES.DEFAULT.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(SPACES.DEFAULT.spaceId), - }, - hiddenType: { - statusCode: 404, - response: expectHiddenTypeNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(SPACES.DEFAULT.spaceId), - }, - }, - }); - - getTest(`can access objects belonging to the current space (space_1)`, { - ...SPACES.SPACE_1, - tests: { - spaceAware: { - statusCode: 200, - response: createExpectSpaceAwareResults(SPACES.SPACE_1.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(SPACES.SPACE_1.spaceId), - }, - hiddenType: { - statusCode: 404, - response: expectHiddenTypeNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(SPACES.SPACE_1.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = getTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false, { spaceId }); + }; - getTest(`can't access space aware objects belonging to another space (space_1)`, { - spaceId: SPACES.DEFAULT.spaceId, - otherSpaceId: SPACES.SPACE_1.spaceId, - tests: { - spaceAware: { - statusCode: 404, - response: createExpectSpaceAwareNotFound(SPACES.SPACE_1.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: createExpectNotSpaceAwareResults(SPACES.SPACE_1.spaceId), - }, - hiddenType: { - statusCode: 404, - response: expectHiddenTypeNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(SPACES.SPACE_1.spaceId), - }, - }, + describe('_get', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/import.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/import.ts index c78a0e1cc2cce..5fe4b08d91b54 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/import.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/import.ts @@ -5,56 +5,48 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { importTestSuiteFactory } from '../../common/suites/import'; +import { importTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/import'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail409(spaceId === DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(spaceId === SPACE_2_ID) }, + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail400() }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409() }, + { ...CASES.HIDDEN, ...fail400() }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + { ...CASES.NEW_MULTI_NAMESPACE_OBJ, ...fail400() }, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - importTest, - createExpectResults, - expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, - } = importTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions } = importTestSuiteFactory(es, esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false, { spaceId, singleRequest: true }); + }; describe('_import', () => { - importTest('in the current space (space_1)', { - ...SPACES.SPACE_1, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.SPACE_1.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - importTest('in the default space', { - ...SPACES.DEFAULT, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.DEFAULT.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/index.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/index.ts index bb481e0c98bc1..c2f8339d38c97 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/index.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/index.ts @@ -12,6 +12,7 @@ export default function({ loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./bulk_create')); loadTestFile(require.resolve('./bulk_get')); + loadTestFile(require.resolve('./bulk_update')); loadTestFile(require.resolve('./create')); loadTestFile(require.resolve('./delete')); loadTestFile(require.resolve('./export')); @@ -20,6 +21,5 @@ export default function({ loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./import')); loadTestFile(require.resolve('./resolve_import_errors')); loadTestFile(require.resolve('./update')); - loadTestFile(require.resolve('./bulk_update')); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/resolve_import_errors.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/resolve_import_errors.ts index 22a7ab81e5530..04f9ac8414afd 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/resolve_import_errors.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/resolve_import_errors.ts @@ -5,56 +5,59 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { resolveImportErrorsTestSuiteFactory } from '../../common/suites/resolve_import_errors'; +import { + resolveImportErrorsTestSuiteFactory, + TEST_CASES as CASES, +} from '../../common/suites/resolve_import_errors'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail400, fail409 } = testCaseFailures; + +const createTestCases = (overwrite: boolean, spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { + ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, + ...fail409(!overwrite && spaceId === DEFAULT_SPACE_ID), + }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail409(!overwrite && spaceId === SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail409(!overwrite && spaceId === SPACE_2_ID) }, + { ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail400() }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail400() }, + { ...CASES.NAMESPACE_AGNOSTIC, ...fail409(!overwrite) }, + { ...CASES.HIDDEN, ...fail400() }, + CASES.NEW_SINGLE_NAMESPACE_OBJ, + { ...CASES.NEW_MULTI_NAMESPACE_OBJ, ...fail400() }, + CASES.NEW_NAMESPACE_AGNOSTIC_OBJ, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); const es = getService('legacyEs'); - const { - resolveImportErrorsTest, - createExpectResults, - expectUnknownTypeUnsupported, - expectHiddenTypeUnsupported, - } = resolveImportErrorsTestSuiteFactory(es, esArchiver, supertest); + const { addTests, createTestDefinitions } = resolveImportErrorsTestSuiteFactory( + es, + esArchiver, + supertest + ); + const createTests = (overwrite: boolean, spaceId: string) => { + const testCases = createTestCases(overwrite, spaceId); + return createTestDefinitions(testCases, false, overwrite, { spaceId, singleRequest: true }); + }; describe('_resolve_import_errors', () => { - resolveImportErrorsTest('in the current space (space_1)', { - ...SPACES.SPACE_1, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.SPACE_1.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, - }); - - resolveImportErrorsTest('in the default space', { - ...SPACES.DEFAULT, - tests: { - default: { - statusCode: 200, - response: createExpectResults(SPACES.DEFAULT.spaceId), - }, - hiddenType: { - statusCode: 200, - response: expectHiddenTypeUnsupported, - }, - unknownType: { - statusCode: 200, - response: expectUnknownTypeUnsupported, - }, - }, + getTestScenarios([false, true]).spaces.forEach(({ spaceId, modifier: overwrite }) => { + const suffix = overwrite ? ' with overwrite enabled' : ''; + const tests = createTests(overwrite!, spaceId); + addTests(`within the ${spaceId} space${suffix}`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/saved_object_api_integration/spaces_only/apis/update.ts b/x-pack/test/saved_object_api_integration/spaces_only/apis/update.ts index 6ffbda511d871..381861e33b68d 100644 --- a/x-pack/test/saved_object_api_integration/spaces_only/apis/update.ts +++ b/x-pack/test/saved_object_api_integration/spaces_only/apis/update.ts @@ -5,88 +5,48 @@ */ import { SPACES } from '../../common/lib/spaces'; +import { testCaseFailures, getTestScenarios } from '../../common/lib/saved_object_test_utils'; import { FtrProviderContext } from '../../common/ftr_provider_context'; -import { updateTestSuiteFactory } from '../../common/suites/update'; +import { updateTestSuiteFactory, TEST_CASES as CASES } from '../../common/suites/update'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => [ + // for each outcome, if failure !== undefined then we expect to receive + // an error; otherwise, we expect to receive a success result + { ...CASES.SINGLE_NAMESPACE_DEFAULT_SPACE, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SINGLE_NAMESPACE_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + { + ...CASES.MULTI_NAMESPACE_DEFAULT_AND_SPACE_1, + ...fail404(spaceId !== DEFAULT_SPACE_ID && spaceId !== SPACE_1_ID), + }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_1, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.MULTI_NAMESPACE_ONLY_SPACE_2, ...fail404(spaceId !== SPACE_2_ID) }, + CASES.NAMESPACE_AGNOSTIC, + { ...CASES.HIDDEN, ...fail404() }, + { ...CASES.DOES_NOT_EXIST, ...fail404() }, +]; export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); - describe('update', () => { - const { - createExpectSpaceAwareNotFound, - expectSpaceAwareResults, - createExpectDoesntExistNotFound, - expectNotSpaceAwareResults, - expectSpaceNotFound, - updateTest, - } = updateTestSuiteFactory(esArchiver, supertest); - - updateTest(`in the default space`, { - spaceId: SPACES.DEFAULT.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 404, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(SPACES.DEFAULT.spaceId), - }, - }, - }); - - updateTest('in the current space (space_1)', { - spaceId: SPACES.SPACE_1.spaceId, - tests: { - spaceAware: { - statusCode: 200, - response: expectSpaceAwareResults, - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 404, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(SPACES.SPACE_1.spaceId), - }, - }, - }); + const { addTests, createTestDefinitions } = updateTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + return createTestDefinitions(testCases, false); + }; - updateTest('objects that exist in another space (space_1)', { - spaceId: SPACES.DEFAULT.spaceId, - otherSpaceId: SPACES.SPACE_1.spaceId, - tests: { - spaceAware: { - statusCode: 404, - response: createExpectSpaceAwareNotFound(SPACES.SPACE_1.spaceId), - }, - notSpaceAware: { - statusCode: 200, - response: expectNotSpaceAwareResults, - }, - hiddenType: { - statusCode: 404, - response: expectSpaceNotFound, - }, - doesntExist: { - statusCode: 404, - response: createExpectDoesntExistNotFound(), - }, - }, + describe('_update', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createTests(spaceId); + addTests(`within the ${spaceId} space`, { spaceId, tests }); }); }); } diff --git a/x-pack/test/spaces_api_integration/common/config.ts b/x-pack/test/spaces_api_integration/common/config.ts index dffc6c524cc6e..19743e09f9420 100644 --- a/x-pack/test/spaces_api_integration/common/config.ts +++ b/x-pack/test/spaces_api_integration/common/config.ts @@ -67,6 +67,7 @@ export function createTestConfig(name: string, options: CreateTestConfigOptions) // disable anonymouse access so that we're testing both on and off in different suites '--status.allowAnonymous=false', '--server.xsrf.disableProtection=true', + `--plugin-path=${path.join(__dirname, 'fixtures', 'shared_type_plugin')}`, ...disabledPlugins.map(key => `--xpack.${key}.enabled=false`), ], }, diff --git a/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json b/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json index 64c1be0b90071..9a8a0a1fdda14 100644 --- a/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json +++ b/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/data.json @@ -376,3 +376,123 @@ "type": "_doc" } } + +{ + "type": "doc", + "value": { + "id": "sharedtype:default_space_only", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the default space" + }, + "type": "sharedtype", + "namespaces": ["default"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:space_1_only", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the space_1 space" + }, + "type": "sharedtype", + "namespaces": ["space_1"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:space_2_only", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the space_2 space" + }, + "type": "sharedtype", + "namespaces": ["space_2"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:default_and_space_1", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the default and space_1 spaces" + }, + "type": "sharedtype", + "namespaces": ["default", "space_1"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:default_and_space_2", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the default and space_2 spaces" + }, + "type": "sharedtype", + "namespaces": ["default", "space_2"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:space_1_and_space_2", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the space_1 and space_2 spaces" + }, + "type": "sharedtype", + "namespaces": ["space_1", "space_2"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + +{ + "type": "doc", + "value": { + "id": "sharedtype:all_spaces", + "index": ".kibana", + "source": { + "sharedtype": { + "title": "A shared saved-object in the default, space_1, and space_2 spaces" + }, + "type": "sharedtype", + "namespaces": ["default", "space_1", "space_2"], + "updated_at": "2017-09-21T18:59:16.270Z" + }, + "type": "doc" + } +} + diff --git a/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json b/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json index 1440585b625b9..508de68c32f70 100644 --- a/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json +++ b/x-pack/test/spaces_api_integration/common/fixtures/es_archiver/saved_objects/spaces/mappings.json @@ -159,6 +159,9 @@ "namespace": { "type": "keyword" }, + "namespaces": { + "type": "keyword" + }, "search": { "properties": { "columns": { @@ -320,6 +323,19 @@ "type": "text" } } + }, + "sharedtype": { + "properties": { + "title": { + "type": "text", + "fields": { + "keyword": { + "type": "keyword", + "ignore_above": 2048 + } + } + } + } } } }, diff --git a/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/index.js b/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/index.js new file mode 100644 index 0000000000000..91a24fb9f4f56 --- /dev/null +++ b/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/index.js @@ -0,0 +1,27 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import mappings from './mappings.json'; + +export default function(kibana) { + return new kibana.Plugin({ + require: ['kibana', 'elasticsearch', 'xpack_main'], + name: 'shared_type_plugin', + uiExports: { + savedObjectsManagement: {}, + savedObjectSchemas: { + sharedtype: { + multiNamespace: true, + }, + }, + mappings, + }, + + config() {}, + + init() {}, // need empty init for plugin to load + }); +} diff --git a/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/mappings.json b/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/mappings.json new file mode 100644 index 0000000000000..918958aec0d6d --- /dev/null +++ b/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/mappings.json @@ -0,0 +1,15 @@ +{ + "sharedtype": { + "properties": { + "title": { + "type": "text", + "fields": { + "keyword": { + "type": "keyword", + "ignore_above": 2048 + } + } + } + } + } +} diff --git a/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/package.json b/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/package.json new file mode 100644 index 0000000000000..c52f4256c5c06 --- /dev/null +++ b/x-pack/test/spaces_api_integration/common/fixtures/shared_type_plugin/package.json @@ -0,0 +1,7 @@ +{ + "name": "shared_type_plugin", + "version": "0.0.0", + "kibana": { + "version": "kibana" + } +} diff --git a/x-pack/test/spaces_api_integration/common/lib/saved_object_test_cases.ts b/x-pack/test/spaces_api_integration/common/lib/saved_object_test_cases.ts new file mode 100644 index 0000000000000..67f5d737ba010 --- /dev/null +++ b/x-pack/test/spaces_api_integration/common/lib/saved_object_test_cases.ts @@ -0,0 +1,40 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export const MULTI_NAMESPACE_SAVED_OBJECT_TEST_CASES = Object.freeze({ + DEFAULT_SPACE_ONLY: Object.freeze({ + id: 'default_space_only', + existingNamespaces: ['default'], + }), + SPACE_1_ONLY: Object.freeze({ + id: 'space_1_only', + existingNamespaces: ['space_1'], + }), + SPACE_2_ONLY: Object.freeze({ + id: 'space_2_only', + existingNamespaces: ['space_2'], + }), + DEFAULT_AND_SPACE_1: Object.freeze({ + id: 'default_and_space_1', + existingNamespaces: ['default', 'space_1'], + }), + DEFAULT_AND_SPACE_2: Object.freeze({ + id: 'default_and_space_2', + existingNamespaces: ['default', 'space_2'], + }), + SPACE_1_AND_SPACE_2: Object.freeze({ + id: 'space_1_and_space_2', + existingNamespaces: ['space_1', 'space_2'], + }), + ALL_SPACES: Object.freeze({ + id: 'all_spaces', + existingNamespaces: ['default', 'space_1', 'space_2'], + }), + DOES_NOT_EXIST: Object.freeze({ + id: 'does_not_exist', + existingNamespaces: [] as string[], + }), +}); diff --git a/x-pack/test/spaces_api_integration/common/suites/delete.ts b/x-pack/test/spaces_api_integration/common/suites/delete.ts index 9036fcbf7a8dd..0d8728fdf622e 100644 --- a/x-pack/test/spaces_api_integration/common/suites/delete.ts +++ b/x-pack/test/spaces_api_integration/common/suites/delete.ts @@ -6,6 +6,7 @@ import expect from '@kbn/expect'; import { SuperTest } from 'supertest'; import { getUrlPrefix } from '../lib/space_test_utils'; +import { MULTI_NAMESPACE_SAVED_OBJECT_TEST_CASES as CASES } from '../lib/saved_object_test_cases'; import { DescribeFn, TestDefinitionAuthentication } from '../lib/types'; interface DeleteTest { @@ -128,6 +129,25 @@ export function deleteTestSuiteFactory(es: any, esArchiver: any, supertest: Supe ]; expect(buckets).to.eql(expectedBuckets); + + // There were seven multi-namespace objects. + // Since Space 2 was deleted, any multi-namespace objects that existed in that space + // are updated to remove it, and of those, any that don't exist in any space are deleted. + const multiNamespaceResponse = await es.search({ + index: '.kibana', + body: { query: { terms: { type: ['sharedtype'] } } }, + }); + const docs: [Record] = multiNamespaceResponse.hits.hits; + expect(docs).length(6); // just six results, since spaces_2_only got deleted + Object.values(CASES).forEach(({ id, existingNamespaces }) => { + const remainingNamespaces = existingNamespaces.filter(x => x !== 'space_2'); + const doc = docs.find(x => x._id === `sharedtype:${id}`); + if (remainingNamespaces.length > 0) { + expect(doc?._source?.namespaces).to.eql(remainingNamespaces); + } else { + expect(doc).to.be(undefined); + } + }); }; const expectNotFound = (resp: { [key: string]: any }) => { diff --git a/x-pack/test/spaces_api_integration/common/suites/share_add.ts b/x-pack/test/spaces_api_integration/common/suites/share_add.ts new file mode 100644 index 0000000000000..b9a012b606da3 --- /dev/null +++ b/x-pack/test/spaces_api_integration/common/suites/share_add.ts @@ -0,0 +1,118 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import expect from '@kbn/expect'; +import { SuperTest } from 'supertest'; +import { SavedObjectsErrorHelpers } from '../../../../../src/core/server'; +import { SPACES } from '../lib/spaces'; +import { + expectResponses, + getUrlPrefix, +} from '../../../saved_object_api_integration/common/lib/saved_object_test_utils'; +import { + ExpectResponseBody, + TestDefinition, + TestSuite, +} from '../../../saved_object_api_integration/common/lib/types'; + +export interface ShareAddTestDefinition extends TestDefinition { + request: { spaces: string[]; object: { type: string; id: string } }; +} +export type ShareAddTestSuite = TestSuite; +export interface ShareAddTestCase { + id: string; + namespaces: string[]; + failure?: 400 | 403 | 404; + fail400Param?: string; + fail403Param?: string; +} + +const TYPE = 'sharedtype'; +const createRequest = ({ id, namespaces }: ShareAddTestCase) => ({ + spaces: namespaces, + object: { type: TYPE, id }, +}); +const getTestTitle = ({ id, namespaces }: ShareAddTestCase) => + `{id: ${id}, namespaces: [${namespaces.join(',')}]}`; + +export function shareAddTestSuiteFactory(esArchiver: any, supertest: SuperTest) { + const expectResponseBody = (testCase: ShareAddTestCase): ExpectResponseBody => async ( + response: Record + ) => { + const { id, failure, fail400Param, fail403Param } = testCase; + const object = response.body; + if (failure === 403) { + await expectResponses.forbidden(fail403Param!)(TYPE)(response); + } else if (failure) { + let error: any; + if (failure === 400) { + error = SavedObjectsErrorHelpers.createBadRequestError( + `${id} already exists in the following namespace(s): ${fail400Param}` + ); + } else if (failure === 404) { + error = SavedObjectsErrorHelpers.createGenericNotFoundError(TYPE, id); + } + expect(object.error).to.eql(error.output.payload.error); + expect(object.statusCode).to.eql(error.output.payload.statusCode); + } else { + // success + expect(object).to.eql({}); + } + }; + const createTestDefinitions = ( + testCases: ShareAddTestCase | ShareAddTestCase[], + forbidden: boolean, + options?: { + responseBodyOverride?: ExpectResponseBody; + fail403Param?: string; + } + ): ShareAddTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403, fail403Param: options?.fail403Param })); + } + return cases.map(x => ({ + title: getTestTitle(x), + responseStatusCode: x.failure ?? 204, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); + }; + + const makeShareAddTest = (describeFn: Mocha.SuiteFunction) => ( + description: string, + definition: ShareAddTestSuite + ) => { + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; + + describeFn(description, () => { + before(() => esArchiver.load('saved_objects/spaces')); + after(() => esArchiver.unload('saved_objects/spaces')); + + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const requestBody = test.request; + await supertest + .post(`${getUrlPrefix(spaceId)}/api/spaces/_share_saved_object_add`) + .auth(user?.username, user?.password) + .send(requestBody) + .expect(test.responseStatusCode) + .then(test.responseBody); + }); + } + }); + }; + + const addTests = makeShareAddTest(describe); + // @ts-ignore + addTests.only = makeShareAddTest(describe.only); + + return { + addTests, + createTestDefinitions, + }; +} diff --git a/x-pack/test/spaces_api_integration/common/suites/share_remove.ts b/x-pack/test/spaces_api_integration/common/suites/share_remove.ts new file mode 100644 index 0000000000000..b5fcbe5a1cf2c --- /dev/null +++ b/x-pack/test/spaces_api_integration/common/suites/share_remove.ts @@ -0,0 +1,116 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import expect from '@kbn/expect'; +import { SuperTest } from 'supertest'; +import { SavedObjectsErrorHelpers } from '../../../../../src/core/server'; +import { SPACES } from '../lib/spaces'; +import { + expectResponses, + getUrlPrefix, + getTestTitle, +} from '../../../saved_object_api_integration/common/lib/saved_object_test_utils'; +import { + ExpectResponseBody, + TestDefinition, + TestSuite, +} from '../../../saved_object_api_integration/common/lib/types'; + +export interface ShareRemoveTestDefinition extends TestDefinition { + request: { spaces: string[]; object: { type: string; id: string } }; +} +export type ShareRemoveTestSuite = TestSuite; +export interface ShareRemoveTestCase { + id: string; + namespaces: string[]; + failure?: 400 | 403 | 404; + fail400Param?: string; +} + +const TYPE = 'sharedtype'; +const createRequest = ({ id, namespaces }: ShareRemoveTestCase) => ({ + spaces: namespaces, + object: { type: TYPE, id }, +}); + +export function shareRemoveTestSuiteFactory(esArchiver: any, supertest: SuperTest) { + const expectForbidden = expectResponses.forbidden('delete'); + const expectResponseBody = (testCase: ShareRemoveTestCase): ExpectResponseBody => async ( + response: Record + ) => { + const { id, failure, fail400Param } = testCase; + const object = response.body; + if (failure === 403) { + await expectForbidden(TYPE)(response); + } else if (failure) { + let error: any; + if (failure === 400) { + error = SavedObjectsErrorHelpers.createBadRequestError( + `${id} doesn't exist in the following namespace(s): ${fail400Param}` + ); + } else if (failure === 404) { + error = SavedObjectsErrorHelpers.createGenericNotFoundError(TYPE, id); + } + expect(object.error).to.eql(error.output.payload.error); + expect(object.statusCode).to.eql(error.output.payload.statusCode); + } else { + // success + expect(object).to.eql({}); + } + }; + const createTestDefinitions = ( + testCases: ShareRemoveTestCase | ShareRemoveTestCase[], + forbidden: boolean, + options?: { + responseBodyOverride?: ExpectResponseBody; + } + ): ShareRemoveTestDefinition[] => { + let cases = Array.isArray(testCases) ? testCases : [testCases]; + if (forbidden) { + // override the expected result in each test case + cases = cases.map(x => ({ ...x, failure: 403 })); + } + return cases.map(x => ({ + title: getTestTitle({ ...x, type: TYPE }), + responseStatusCode: x.failure ?? 204, + request: createRequest(x), + responseBody: options?.responseBodyOverride || expectResponseBody(x), + })); + }; + + const makeShareRemoveTest = (describeFn: Mocha.SuiteFunction) => ( + description: string, + definition: ShareRemoveTestSuite + ) => { + const { user, spaceId = SPACES.DEFAULT.spaceId, tests } = definition; + + describeFn(description, () => { + before(() => esArchiver.load('saved_objects/spaces')); + after(() => esArchiver.unload('saved_objects/spaces')); + + for (const test of tests) { + it(`should return ${test.responseStatusCode} ${test.title}`, async () => { + const requestBody = test.request; + await supertest + .post(`${getUrlPrefix(spaceId)}/api/spaces/_share_saved_object_remove`) + .auth(user?.username, user?.password) + .send(requestBody) + .expect(test.responseStatusCode) + .then(test.responseBody); + }); + } + }); + }; + + const addTests = makeShareRemoveTest(describe); + // @ts-ignore + addTests.only = makeShareRemoveTest(describe.only); + + return { + addTests, + createTestDefinitions, + }; +} diff --git a/x-pack/test/spaces_api_integration/security_and_spaces/apis/index.ts b/x-pack/test/spaces_api_integration/security_and_spaces/apis/index.ts index e918ab0b53841..8d85d95e6812f 100644 --- a/x-pack/test/spaces_api_integration/security_and_spaces/apis/index.ts +++ b/x-pack/test/spaces_api_integration/security_and_spaces/apis/index.ts @@ -25,6 +25,8 @@ export default function({ loadTestFile, getService }: TestInvoker) { loadTestFile(require.resolve('./delete')); loadTestFile(require.resolve('./get_all')); loadTestFile(require.resolve('./get')); + loadTestFile(require.resolve('./share_add')); + loadTestFile(require.resolve('./share_remove')); loadTestFile(require.resolve('./update')); }); } diff --git a/x-pack/test/spaces_api_integration/security_and_spaces/apis/share_add.ts b/x-pack/test/spaces_api_integration/security_and_spaces/apis/share_add.ts new file mode 100644 index 0000000000000..c7e65ac424776 --- /dev/null +++ b/x-pack/test/spaces_api_integration/security_and_spaces/apis/share_add.ts @@ -0,0 +1,124 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { SPACES } from '../../common/lib/spaces'; +import { + testCaseFailures, + getTestScenarios, +} from '../../../saved_object_api_integration/common/lib/saved_object_test_utils'; +import { TestUser } from '../../../saved_object_api_integration/common/lib/types'; +import { MULTI_NAMESPACE_SAVED_OBJECT_TEST_CASES as CASES } from '../../common/lib/saved_object_test_cases'; +import { TestInvoker } from '../../common/lib/types'; +import { shareAddTestSuiteFactory, ShareAddTestDefinition } from '../../common/suites/share_add'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + const namespaces = [spaceId]; + return [ + // Test cases to check adding the target namespace to different saved objects + { ...CASES.DEFAULT_SPACE_ONLY, namespaces, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SPACE_1_ONLY, namespaces, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SPACE_2_ONLY, namespaces, ...fail404(spaceId !== SPACE_2_ID) }, + { ...CASES.DEFAULT_AND_SPACE_1, namespaces, ...fail404(spaceId === SPACE_2_ID) }, + { ...CASES.DEFAULT_AND_SPACE_2, namespaces, ...fail404(spaceId === SPACE_1_ID) }, + { ...CASES.SPACE_1_AND_SPACE_2, namespaces, ...fail404(spaceId === DEFAULT_SPACE_ID) }, + { ...CASES.ALL_SPACES, namespaces }, + { ...CASES.DOES_NOT_EXIST, namespaces, ...fail404() }, + // Test cases to check adding multiple namespaces to different saved objects that exist in one space + // These are non-exhaustive, they only check cases for adding two additional namespaces to a saved object + // More permutations are covered in the corresponding spaces_only test suite + { + ...CASES.DEFAULT_SPACE_ONLY, + namespaces: [SPACE_1_ID, SPACE_2_ID], + ...fail404(spaceId !== DEFAULT_SPACE_ID), + }, + { + ...CASES.SPACE_1_ONLY, + namespaces: [DEFAULT_SPACE_ID, SPACE_2_ID], + ...fail404(spaceId !== SPACE_1_ID), + }, + { + ...CASES.SPACE_2_ONLY, + namespaces: [DEFAULT_SPACE_ID, SPACE_1_ID], + ...fail404(spaceId !== SPACE_2_ID), + }, + ]; +}; +const calculateSingleSpaceAuthZ = ( + testCases: ReturnType, + spaceId: string +) => { + const targetsOtherSpace = testCases.filter( + x => !x.namespaces.includes(spaceId) || x.namespaces.length > 1 + ); + const tmp = testCases.filter(x => !targetsOtherSpace.includes(x)); // doesn't target other space + const doesntExistInThisSpace = tmp.filter(x => !x.existingNamespaces.includes(spaceId)); + const existsInThisSpace = tmp.filter(x => x.existingNamespaces.includes(spaceId)); + return { targetsOtherSpace, doesntExistInThisSpace, existsInThisSpace }; +}; +// eslint-disable-next-line import/no-default-export +export default function({ getService }: TestInvoker) { + const supertest = getService('supertestWithoutAuth'); + const esArchiver = getService('esArchiver'); + + const { addTests, createTestDefinitions } = shareAddTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const testCases = createTestCases(spaceId); + const thisSpace = calculateSingleSpaceAuthZ(testCases, spaceId); + const otherSpaceId = spaceId === DEFAULT_SPACE_ID ? SPACE_1_ID : DEFAULT_SPACE_ID; + const otherSpace = calculateSingleSpaceAuthZ(testCases, otherSpaceId); + return { + unauthorized: createTestDefinitions(testCases, true, { fail403Param: 'create' }), + authorizedInSpace: [ + createTestDefinitions(thisSpace.targetsOtherSpace, true, { fail403Param: 'create' }), + createTestDefinitions(thisSpace.doesntExistInThisSpace, false), + createTestDefinitions(thisSpace.existsInThisSpace, false), + ].flat(), + authorizedInOtherSpace: [ + createTestDefinitions(otherSpace.targetsOtherSpace, true, { fail403Param: 'create' }), + // If the preflight GET request fails, it will return a 404 error; users who are authorized to create saved objects in the target + // space(s) but are not authorized to update saved objects in this space will see a 403 error instead of 404. This is a safeguard to + // prevent potential information disclosure of the spaces that a given saved object may exist in. + createTestDefinitions(otherSpace.doesntExistInThisSpace, true, { fail403Param: 'update' }), + createTestDefinitions(otherSpace.existsInThisSpace, false), + ].flat(), + authorized: createTestDefinitions(testCases, false), + }; + }; + + describe('_share_saved_object_add', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` targeting the ${spaceId} space`; + const { unauthorized, authorizedInSpace, authorizedInOtherSpace, authorized } = createTests( + spaceId + ); + const _addTests = (user: TestUser, tests: ShareAddTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; + + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + ].forEach(user => { + _addTests(user, unauthorized); + }); + _addTests(users.allAtSpace, authorizedInSpace); + _addTests(users.allAtOtherSpace, authorizedInOtherSpace); + [users.dualAll, users.allGlobally, users.superuser].forEach(user => { + _addTests(user, authorized); + }); + }); + }); +} diff --git a/x-pack/test/spaces_api_integration/security_and_spaces/apis/share_remove.ts b/x-pack/test/spaces_api_integration/security_and_spaces/apis/share_remove.ts new file mode 100644 index 0000000000000..3a8d42f620a3e --- /dev/null +++ b/x-pack/test/spaces_api_integration/security_and_spaces/apis/share_remove.ts @@ -0,0 +1,99 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { SPACES } from '../../common/lib/spaces'; +import { + testCaseFailures, + getTestScenarios, +} from '../../../saved_object_api_integration/common/lib/saved_object_test_utils'; +import { TestUser } from '../../../saved_object_api_integration/common/lib/types'; +import { MULTI_NAMESPACE_SAVED_OBJECT_TEST_CASES as CASES } from '../../common/lib/saved_object_test_cases'; +import { TestInvoker } from '../../common/lib/types'; +import { + shareRemoveTestSuiteFactory, + ShareRemoveTestCase, + ShareRemoveTestDefinition, +} from '../../common/suites/share_remove'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +const createTestCases = (spaceId: string) => { + // Test cases to check removing the target namespace from different saved objects + let namespaces = [spaceId]; + const singleSpace = [ + { id: CASES.DEFAULT_SPACE_ONLY.id, namespaces, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { id: CASES.SPACE_1_ONLY.id, namespaces, ...fail404(spaceId !== SPACE_1_ID) }, + { id: CASES.SPACE_2_ONLY.id, namespaces, ...fail404(spaceId !== SPACE_2_ID) }, + { id: CASES.DEFAULT_AND_SPACE_1.id, namespaces, ...fail404(spaceId === SPACE_2_ID) }, + { id: CASES.DEFAULT_AND_SPACE_2.id, namespaces, ...fail404(spaceId === SPACE_1_ID) }, + { id: CASES.SPACE_1_AND_SPACE_2.id, namespaces, ...fail404(spaceId === DEFAULT_SPACE_ID) }, + { id: CASES.ALL_SPACES.id, namespaces }, + { id: CASES.DOES_NOT_EXIST.id, namespaces, ...fail404() }, + ] as ShareRemoveTestCase[]; + + // Test cases to check removing all three namespaces from different saved objects that exist in two spaces + // These are non-exhaustive, they only check some cases -- each object will result in a 404, either because + // it never existed in the target namespace, or it was removed in one of the test cases above + // More permutations are covered in the corresponding spaces_only test suite + namespaces = [DEFAULT_SPACE_ID, SPACE_1_ID, SPACE_2_ID]; + const multipleSpaces = [ + { id: CASES.DEFAULT_AND_SPACE_1.id, namespaces, ...fail404() }, + { id: CASES.DEFAULT_AND_SPACE_2.id, namespaces, ...fail404() }, + { id: CASES.SPACE_1_AND_SPACE_2.id, namespaces, ...fail404() }, + ] as ShareRemoveTestCase[]; + + const allCases = singleSpace.concat(multipleSpaces); + return { singleSpace, multipleSpaces, allCases }; +}; + +// eslint-disable-next-line import/no-default-export +export default function({ getService }: TestInvoker) { + const supertest = getService('supertestWithoutAuth'); + const esArchiver = getService('esArchiver'); + + const { addTests, createTestDefinitions } = shareRemoveTestSuiteFactory(esArchiver, supertest); + const createTests = (spaceId: string) => { + const { singleSpace, multipleSpaces, allCases } = createTestCases(spaceId); + return { + unauthorized: createTestDefinitions(allCases, true), + authorizedThisSpace: [ + createTestDefinitions(singleSpace, false), + createTestDefinitions(multipleSpaces, true), + ].flat(), + authorizedGlobally: createTestDefinitions(allCases, false), + }; + }; + + describe('_share_saved_object_remove', () => { + getTestScenarios().securityAndSpaces.forEach(({ spaceId, users }) => { + const suffix = ` targeting the ${spaceId} space`; + const { unauthorized, authorizedThisSpace, authorizedGlobally } = createTests(spaceId); + const _addTests = (user: TestUser, tests: ShareRemoveTestDefinition[]) => { + addTests(`${user.description}${suffix}`, { user, spaceId, tests }); + }; + + [ + users.noAccess, + users.legacyAll, + users.dualRead, + users.readGlobally, + users.readAtSpace, + users.allAtOtherSpace, + ].forEach(user => { + _addTests(user, unauthorized); + }); + _addTests(users.allAtSpace, authorizedThisSpace); + [users.dualAll, users.allGlobally, users.superuser].forEach(user => { + _addTests(user, authorizedGlobally); + }); + }); + }); +} diff --git a/x-pack/test/spaces_api_integration/spaces_only/apis/index.ts b/x-pack/test/spaces_api_integration/spaces_only/apis/index.ts index 1182f6bdabcff..b02dc35b58b56 100644 --- a/x-pack/test/spaces_api_integration/spaces_only/apis/index.ts +++ b/x-pack/test/spaces_api_integration/spaces_only/apis/index.ts @@ -17,6 +17,8 @@ export default function spacesOnlyTestSuite({ loadTestFile }: TestInvoker) { loadTestFile(require.resolve('./delete')); loadTestFile(require.resolve('./get_all')); loadTestFile(require.resolve('./get')); + loadTestFile(require.resolve('./share_add')); + loadTestFile(require.resolve('./share_remove')); loadTestFile(require.resolve('./update')); }); } diff --git a/x-pack/test/spaces_api_integration/spaces_only/apis/share_add.ts b/x-pack/test/spaces_api_integration/spaces_only/apis/share_add.ts new file mode 100644 index 0000000000000..f1e603836fa21 --- /dev/null +++ b/x-pack/test/spaces_api_integration/spaces_only/apis/share_add.ts @@ -0,0 +1,84 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { SPACES } from '../../common/lib/spaces'; +import { + testCaseFailures, + getTestScenarios, +} from '../../../saved_object_api_integration/common/lib/saved_object_test_utils'; +import { TestInvoker } from '../../common/lib/types'; +import { MULTI_NAMESPACE_SAVED_OBJECT_TEST_CASES as CASES } from '../../common/lib/saved_object_test_cases'; +import { shareAddTestSuiteFactory } from '../../common/suites/share_add'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +/** + * Single-namespace test cases + * @param spaceId the namespace to add to each saved object + */ +const createSingleTestCases = (spaceId: string) => { + const namespaces = ['some-space-id']; + return [ + { ...CASES.DEFAULT_SPACE_ONLY, namespaces, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SPACE_1_ONLY, namespaces, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SPACE_2_ONLY, namespaces, ...fail404(spaceId !== SPACE_2_ID) }, + { ...CASES.DEFAULT_AND_SPACE_1, namespaces, ...fail404(spaceId === SPACE_2_ID) }, + { ...CASES.DEFAULT_AND_SPACE_2, namespaces, ...fail404(spaceId === SPACE_1_ID) }, + { ...CASES.SPACE_1_AND_SPACE_2, namespaces, ...fail404(spaceId === DEFAULT_SPACE_ID) }, + { ...CASES.ALL_SPACES, namespaces }, + { ...CASES.DOES_NOT_EXIST, namespaces, ...fail404() }, + ]; +}; +/** + * Multi-namespace test cases + * These are non-exhaustive, but they check different permutations of saved objects and spaces to add + */ +const createMultiTestCases = () => { + const allSpaces = [DEFAULT_SPACE_ID, SPACE_1_ID, SPACE_2_ID]; + let id = CASES.DEFAULT_SPACE_ONLY.id; + const one = [{ id, namespaces: allSpaces }]; + id = CASES.DEFAULT_AND_SPACE_1.id; + const two = [{ id, namespaces: allSpaces }]; + id = CASES.ALL_SPACES.id; + const three = [{ id, namespaces: allSpaces }]; + return { one, two, three }; +}; + +// eslint-disable-next-line import/no-default-export +export default function({ getService }: TestInvoker) { + const supertest = getService('supertest'); + const esArchiver = getService('esArchiver'); + + const { addTests, createTestDefinitions } = shareAddTestSuiteFactory(esArchiver, supertest); + const createSingleTests = (spaceId: string) => { + const testCases = createSingleTestCases(spaceId); + return createTestDefinitions(testCases, false); + }; + const createMultiTests = () => { + const testCases = createMultiTestCases(); + return { + one: createTestDefinitions(testCases.one, false), + two: createTestDefinitions(testCases.two, false), + three: createTestDefinitions(testCases.three, false), + }; + }; + + describe('_share_saved_object_add', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createSingleTests(spaceId); + addTests(`targeting the ${spaceId} space`, { spaceId, tests }); + }); + const { one, two, three } = createMultiTests(); + addTests('for a saved object in the default space', { tests: one }); + addTests('for a saved object in the default and space_1 spaces', { tests: two }); + addTests('for a saved object in the default, space_1, and space_2 spaces', { tests: three }); + }); +} diff --git a/x-pack/test/spaces_api_integration/spaces_only/apis/share_remove.ts b/x-pack/test/spaces_api_integration/spaces_only/apis/share_remove.ts new file mode 100644 index 0000000000000..15be72c9f09ac --- /dev/null +++ b/x-pack/test/spaces_api_integration/spaces_only/apis/share_remove.ts @@ -0,0 +1,99 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { SPACES } from '../../common/lib/spaces'; +import { + testCaseFailures, + getTestScenarios, +} from '../../../saved_object_api_integration/common/lib/saved_object_test_utils'; +import { TestInvoker } from '../../common/lib/types'; +import { MULTI_NAMESPACE_SAVED_OBJECT_TEST_CASES as CASES } from '../../common/lib/saved_object_test_cases'; +import { shareRemoveTestSuiteFactory } from '../../common/suites/share_remove'; + +const { + DEFAULT: { spaceId: DEFAULT_SPACE_ID }, + SPACE_1: { spaceId: SPACE_1_ID }, + SPACE_2: { spaceId: SPACE_2_ID }, +} = SPACES; +const { fail404 } = testCaseFailures; + +/** + * Single-namespace test cases + * @param spaceId the namespace to remove from each saved object + */ +const createSingleTestCases = (spaceId: string) => { + const namespaces = [spaceId]; + return [ + { ...CASES.DEFAULT_SPACE_ONLY, namespaces, ...fail404(spaceId !== DEFAULT_SPACE_ID) }, + { ...CASES.SPACE_1_ONLY, namespaces, ...fail404(spaceId !== SPACE_1_ID) }, + { ...CASES.SPACE_2_ONLY, namespaces, ...fail404(spaceId !== SPACE_2_ID) }, + { ...CASES.DEFAULT_AND_SPACE_1, namespaces, ...fail404(spaceId === SPACE_2_ID) }, + { ...CASES.DEFAULT_AND_SPACE_2, namespaces, ...fail404(spaceId === SPACE_1_ID) }, + { ...CASES.SPACE_1_AND_SPACE_2, namespaces, ...fail404(spaceId === DEFAULT_SPACE_ID) }, + { ...CASES.ALL_SPACES, namespaces }, + { ...CASES.DOES_NOT_EXIST, namespaces, ...fail404() }, + ]; +}; +/** + * Multi-namespace test cases + * These are non-exhaustive, but they check different permutations of saved objects and spaces to remove + */ +const createMultiTestCases = () => { + const nonExistentSpaceId = 'does_not_exist'; // space that doesn't exist + let id = CASES.DEFAULT_SPACE_ONLY.id; + const one = [ + { id, namespaces: [nonExistentSpaceId] }, + { id, namespaces: [DEFAULT_SPACE_ID, SPACE_1_ID, SPACE_2_ID] }, + { id, namespaces: [DEFAULT_SPACE_ID], ...fail404() }, // this saved object no longer exists + ]; + id = CASES.DEFAULT_AND_SPACE_1.id; + const two = [ + { id, namespaces: [DEFAULT_SPACE_ID, nonExistentSpaceId] }, + // this saved object will not be found in the context of the current namespace ('default') + { id, namespaces: [DEFAULT_SPACE_ID], ...fail404() }, // this object's namespaces no longer contains DEFAULT_SPACE_ID + { id, namespaces: [SPACE_1_ID], ...fail404() }, // this object's namespaces does contain SPACE_1_ID + ]; + id = CASES.ALL_SPACES.id; + const three = [ + { id, namespaces: [DEFAULT_SPACE_ID, SPACE_1_ID, nonExistentSpaceId] }, + // this saved object will not be found in the context of the current namespace ('default') + { id, namespaces: [DEFAULT_SPACE_ID], ...fail404() }, // this object's namespaces no longer contains DEFAULT_SPACE_ID + { id, namespaces: [SPACE_1_ID], ...fail404() }, // this object's namespaces no longer contains SPACE_1_ID + { id, namespaces: [SPACE_2_ID], ...fail404() }, // this object's namespaces does contain SPACE_2_ID + ]; + return { one, two, three }; +}; + +// eslint-disable-next-line import/no-default-export +export default function({ getService }: TestInvoker) { + const supertest = getService('supertest'); + const esArchiver = getService('esArchiver'); + + const { addTests, createTestDefinitions } = shareRemoveTestSuiteFactory(esArchiver, supertest); + const createSingleTests = (spaceId: string) => { + const testCases = createSingleTestCases(spaceId); + return createTestDefinitions(testCases, false); + }; + const createMultiTests = () => { + const testCases = createMultiTestCases(); + return { + one: createTestDefinitions(testCases.one, false), + two: createTestDefinitions(testCases.two, false), + three: createTestDefinitions(testCases.three, false), + }; + }; + + describe('_share_saved_object_remove', () => { + getTestScenarios().spaces.forEach(({ spaceId }) => { + const tests = createSingleTests(spaceId); + addTests(`targeting the ${spaceId} space`, { spaceId, tests }); + }); + const { one, two, three } = createMultiTests(); + addTests('for a saved object in the default space', { tests: one }); + addTests('for a saved object in the default and space_1 spaces', { tests: two }); + addTests('for a saved object in the default, space_1, and space_2 spaces', { tests: three }); + }); +} From 83b9417d4534f7c8d2c6daa9009bd20e1937cf16 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cau=C3=AA=20Marcondes?= <55978943+cauemarcondes@users.noreply.github.com> Date: Fri, 10 Apr 2020 08:28:06 +0100 Subject: [PATCH 024/102] [APM] Custom links submit button is off screen in IE11 (#63122) --- .../CustomLinkFlyout/DeleteButton.tsx | 2 + .../CustomLinkFlyout/FlyoutFooter.tsx | 38 ++++++++----------- 2 files changed, 18 insertions(+), 22 deletions(-) diff --git a/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/DeleteButton.tsx b/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/DeleteButton.tsx index 2b3a5cbe87992..87cb171518ea4 100644 --- a/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/DeleteButton.tsx +++ b/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/DeleteButton.tsx @@ -8,6 +8,7 @@ import { EuiButtonEmpty } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { NotificationsStart } from 'kibana/public'; import React, { useState } from 'react'; +import { px, unit } from '../../../../../../style/variables'; import { callApmApi } from '../../../../../../services/rest/createCallApmApi'; import { useApmPluginContext } from '../../../../../../hooks/useApmPluginContext'; @@ -31,6 +32,7 @@ export function DeleteButton({ onDelete, customLinkId }: Props) { setIsDeleting(false); onDelete(); }} + style={{ marginRight: px(unit) }} > {i18n.translate('xpack.apm.settings.customizeUI.customLink.delete', { defaultMessage: 'Delete' diff --git a/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/FlyoutFooter.tsx b/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/FlyoutFooter.tsx index cb27221309812..96505d639bcdd 100644 --- a/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/FlyoutFooter.tsx +++ b/x-pack/legacy/plugins/apm/public/components/app/Settings/CustomizeUI/CustomLink/CustomLinkFlyout/FlyoutFooter.tsx @@ -40,29 +40,23 @@ export const FlyoutFooter = ({ )} - - - {customLinkId && ( - - - + + {customLinkId && ( + + )} + + {i18n.translate( + 'xpack.apm.settings.customizeUI.customLink.flyout.save', + { + defaultMessage: 'Save' + } )} - - - {i18n.translate( - 'xpack.apm.settings.customizeUI.customLink.flyout.save', - { - defaultMessage: 'Save' - } - )} - - - + From 34b1d0a10d529da48f35106d6b82cf96498e6677 Mon Sep 17 00:00:00 2001 From: MadameSheema Date: Fri, 10 Apr 2020 11:28:59 +0200 Subject: [PATCH 025/102] [SIEM] Updates cypress readme with documentation about the test data. (#62747) * updates test data section * Update x-pack/legacy/plugins/siem/cypress/README.md Co-Authored-By: Ryland Herrick Co-authored-by: Ryland Herrick --- x-pack/legacy/plugins/siem/cypress/README.md | 132 +++++++++++++++---- 1 file changed, 107 insertions(+), 25 deletions(-) diff --git a/x-pack/legacy/plugins/siem/cypress/README.md b/x-pack/legacy/plugins/siem/cypress/README.md index 41137ce6d8a9d..a031fea172be5 100644 --- a/x-pack/legacy/plugins/siem/cypress/README.md +++ b/x-pack/legacy/plugins/siem/cypress/README.md @@ -111,6 +111,112 @@ elasticsearch: hosts: ['https://:9200'] ``` +## Running (Headless) Tests on the Command Line as a Jenkins execution (The preferred way) + +To run (headless) tests as a Jenkins execution. + +1. First bootstrap kibana changes from the Kibana root directory: + +```sh +yarn kbn bootstrap +``` + +2. Launch Cypress command line test runner: + +```sh +cd x-pack/legacy/plugins/siem +yarn cypress:run-as-ci +``` + +Note that with this type of execution you don't need to have running a kibana and elasticsearch instance. This is because + the command, as it would happen in the CI, will launch the instances. The elasticsearch instance will be fed with the data + placed in: `x-pack/test/siem_cypress/es_archives` + +As in this case we want to mimic a CI execution we want to execute the tests with the same set of data, this is why +in this case does not make sense to override Cypress environment variables. + +### Test data + +As said before when running the tests as Jenkins the tests are fed with the data placed in: `x-pack/test/siem_cypress/es_archives`. + +Currently there are two different ways of feeding data: +1. By default +2. Specifying a specific set of data for a specific test + +#### By default + +When a execution of the test is going to be done an empty kibana and a set of audibteat data are loaded (empty_kibana and auditbeat). With this data usually is enough to cover most of the scenarios that we are testing. + +#### Running tests with custom data + +Sometimes the default data is not enough and we need a specific set of data in order to being able to test the desired behaviour. + +In that case in the hooks of the test use the function `esArchiverLoad` to load the set of data neeed and `esArchiverUnload` to remove the changes done in the data. + +Example: + +```typescript +import { esArchiverLoad, esArchiverUnload } from '../tasks/es_archiver'; + +describe('This are going to be a set of tests', () => { + before(() => { + esArchiverLoad('name_of_the_data_set_you_want_to_load'); + }); + + after(() => { + esArchiverUnload('name_of_the_data_set_you_want_to_unload'); + }); + + it('Going to test something awesome', () => { + hereGoesYourAwesomeTestcode + }); +}); + +``` + +Note that loading and unloading data takes a signifcant amount of time so try to minimize the use of it when possible. + +### Current sets of data + +The current sets of data can be found in: `x-pack/test/siem_cypress/es_archives` folder. + +- auditbeat + - Auditbeat data generated in Sep, 2019 with the following hosts present: + - suricata-iowa + - siem-kibana + - siem-es + - jessie +- closed_signals + - Set of data with 108 closed signals linked to "Signals test" custom rule. +- custome_rules + - Set if data with just 4 custom activated rules. +- empty_kibana + - Empty kibana board. +- prebuilt_rules_loaded + - Elastic prebuilt loaded rules and deactivated. +- signals + - Set of data with 108 opened signals linked to "Signals test" custom rule. + +### How to generate new test data + +We are using es_archiver in order to generate the data that our Cypress tests needs. + +1. Setup if possible a clean instance of kibana and elasticsearch (if not, possible please try to clean the data that you are going to generate). +2. With the kibana and elasticsearch instance up and running, create the data that you need for your test. +3. When you are sure that you have all the data you need run the following command from: `x-pack/legacy/plugins/siem` + +```sh +node ../../../../scripts/es_archiver save --dir ../../../test/siem_cypress/es_archives --config ../../../../test/functional/config.js --es-url http://:@: +``` + +Example: +```sh +node ../../../../scripts/es_archiver save custom_rules ".kibana",".siem-signal*" --dir ../../../test/siem_cypress/es_archives --config ../../../../test/functional/config.js --es-url http://elastic:changeme@localhost:9220 +``` + +Note that the command is going to create the folder if does not exist in the directory with the imported data. + + ## Running Tests Interactively Use the Cypress interactive test runner to develop and debug specific tests @@ -210,30 +316,6 @@ cd x-pack/legacy/plugins/siem CYPRESS_baseUrl=http://localhost:5601 CYPRESS_ELASTICSEARCH_USERNAME=elastic CYPRESS_ELASTICSEARCH_PASSWORD= yarn cypress:run ``` -## Running (Headless) Tests on the Command Line as a Jenkins execution - -To run (headless) tests as a Jenkins execution. - -1. First bootstrap kibana changes from the Kibana root directory: - -```sh -yarn kbn bootstrap -``` - -2. Launch Cypress command line test runner: - -```sh -cd x-pack/legacy/plugins/siem -yarn cypress:run-as-ci -``` - -Note that with this type of execution you don't need to have running a kibana and elasticsearch instance. This is because - the command, as it would happen in the CI, will launch the instances. The elasticsearch instance will be fed with the data - placed in: `x-pack/test/siem_cypress/es_archives`. - -As in this case we want to mimic a CI execution we want to execute the tests with the same set of data, this is why -in this case does not make sense to override Cypress environment variables. - ## Reporting When Cypress tests are run on the command line via `yarn cypress:run`, @@ -280,4 +362,4 @@ target/kibana-siem/cypress/videos ## Linting -Optional linting rules for Cypress and linting setup can be found [here](https://github.com/cypress-io/eslint-plugin-cypress#usage) \ No newline at end of file +Optional linting rules for Cypress and linting setup can be found [here](https://github.com/cypress-io/eslint-plugin-cypress#usage) From 93971dbfab74b39335115e8236741329486c4b79 Mon Sep 17 00:00:00 2001 From: Jean-Louis Leysens Date: Fri, 10 Apr 2020 12:28:55 +0200 Subject: [PATCH 026/102] [Watcher] Preserve the watch active status after updates (#61999) * Preserve the watch active status after updates * Use route validation params to set isActive * Fix Jest test * Implement PR feedback - Make the isActive flag required on the save watch endpoint - Move the isActive state to base_watch and serialize from there. * Fix Jest tests Co-authored-by: Elastic Machine --- .../watch_create_json.test.ts | 3 ++ .../watch_create_threshold.test.tsx | 8 +++++ .../client_integration/watch_edit.test.ts | 2 ++ .../application/models/watch/base_watch.js | 2 ++ .../server/lib/elasticsearch_js_plugin.ts | 4 +++ .../routes/api/watch/register_save_route.ts | 29 ++++++++----------- 6 files changed, 31 insertions(+), 17 deletions(-) diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts index 2096c0dd61bd8..47de4548898cf 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts @@ -108,6 +108,7 @@ describe(' create route', () => { name: watch.name, type: watch.type, isNew: true, + isActive: true, actions: [ { id: DEFAULT_LOGGING_ACTION_ID, @@ -185,6 +186,7 @@ describe(' create route', () => { id, type, isNew: true, + isActive: true, actions: [], watch: defaultWatchJson, }; @@ -246,6 +248,7 @@ describe(' create route', () => { id, type, isNew: true, + isActive: true, actions: [], watch: defaultWatchJson, }; diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx index 943233d3c14ed..e5bdcbbfb82cf 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx @@ -244,6 +244,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'logging_1', @@ -314,6 +315,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'index_1', @@ -376,6 +378,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'slack_1', @@ -448,6 +451,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'email_1', @@ -540,6 +544,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'webhook_1', @@ -629,6 +634,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'jira_1', @@ -709,6 +715,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [ { id: 'pagerduty_1', @@ -772,6 +779,7 @@ describe(' create route', () => { name: WATCH_NAME, type: WATCH_TYPES.THRESHOLD, isNew: true, + isActive: true, actions: [], index: MATCH_INDICES, timeField: WATCH_TIME_FIELD, diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts b/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts index 51285a5786b00..ced06562b1d20 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts @@ -98,6 +98,7 @@ describe('', () => { name: EDITED_WATCH_NAME, type: watch.type, isNew: false, + isActive: true, actions: [ { id: DEFAULT_LOGGING_ACTION_ID, @@ -191,6 +192,7 @@ describe('', () => { name: EDITED_WATCH_NAME, type, isNew: false, + isActive: true, actions: [], timeField, triggerIntervalSize, diff --git a/x-pack/plugins/watcher/public/application/models/watch/base_watch.js b/x-pack/plugins/watcher/public/application/models/watch/base_watch.js index 3fe4fb006d241..af2e45b35501e 100644 --- a/x-pack/plugins/watcher/public/application/models/watch/base_watch.js +++ b/x-pack/plugins/watcher/public/application/models/watch/base_watch.js @@ -32,6 +32,7 @@ export class BaseWatch { this.isSystemWatch = Boolean(get(props, 'isSystemWatch')); this.watchStatus = WatchStatus.fromUpstreamJson(get(props, 'watchStatus')); this.watchErrors = WatchErrors.fromUpstreamJson(get(props, 'watchErrors')); + this.isActive = this.watchStatus.isActive ?? true; const actions = get(props, 'actions', []); this.actions = actions.map(Action.fromUpstreamJson); @@ -115,6 +116,7 @@ export class BaseWatch { name: this.name, type: this.type, isNew: this.isNew, + isActive: this.isActive, actions: map(this.actions, action => action.upstreamJson), }; } diff --git a/x-pack/plugins/watcher/server/lib/elasticsearch_js_plugin.ts b/x-pack/plugins/watcher/server/lib/elasticsearch_js_plugin.ts index 240e93e160fe0..3cb8dfb623fac 100644 --- a/x-pack/plugins/watcher/server/lib/elasticsearch_js_plugin.ts +++ b/x-pack/plugins/watcher/server/lib/elasticsearch_js_plugin.ts @@ -174,6 +174,10 @@ export const elasticsearchJsPlugin = (Client: any, config: any, components: any) name: 'master_timeout', type: 'duration', }, + active: { + name: 'active', + type: 'boolean', + }, }, url: { fmt: '/_watcher/watch/<%=id%>', diff --git a/x-pack/plugins/watcher/server/routes/api/watch/register_save_route.ts b/x-pack/plugins/watcher/server/routes/api/watch/register_save_route.ts index 61d167bb9bbcd..10ee0c4857862 100644 --- a/x-pack/plugins/watcher/server/routes/api/watch/register_save_route.ts +++ b/x-pack/plugins/watcher/server/routes/api/watch/register_save_route.ts @@ -5,7 +5,6 @@ */ import { schema } from '@kbn/config-schema'; -import { IScopedClusterClient } from 'kibana/server'; import { i18n } from '@kbn/i18n'; import { WATCH_TYPES } from '../../../../common/constants'; import { serializeJsonWatch, serializeThresholdWatch } from '../../../../common/lib/serialization'; @@ -21,23 +20,11 @@ const bodySchema = schema.object( { type: schema.string(), isNew: schema.boolean(), + isActive: schema.boolean(), }, { unknowns: 'allow' } ); -function fetchWatch(dataClient: IScopedClusterClient, watchId: string) { - return dataClient.callAsCurrentUser('watcher.getWatch', { - id: watchId, - }); -} - -function saveWatch(dataClient: IScopedClusterClient, id: string, body: any) { - return dataClient.callAsCurrentUser('watcher.putWatch', { - id, - body, - }); -} - export function registerSaveRoute(deps: RouteDependencies) { deps.router.put( { @@ -49,12 +36,16 @@ export function registerSaveRoute(deps: RouteDependencies) { }, licensePreRoutingFactory(deps, async (ctx, request, response) => { const { id } = request.params; - const { type, isNew, ...watchConfig } = request.body; + const { type, isNew, isActive, ...watchConfig } = request.body; + + const dataClient = ctx.watcher!.client; // For new watches, verify watch with the same ID doesn't already exist if (isNew) { try { - const existingWatch = await fetchWatch(ctx.watcher!.client, id); + const existingWatch = await dataClient.callAsCurrentUser('watcher.getWatch', { + id, + }); if (existingWatch.found) { return response.conflict({ body: { @@ -92,7 +83,11 @@ export function registerSaveRoute(deps: RouteDependencies) { try { // Create new watch return response.ok({ - body: await saveWatch(ctx.watcher!.client, id, serializedWatch), + body: await dataClient.callAsCurrentUser('watcher.putWatch', { + id, + active: isActive, + body: serializedWatch, + }), }); } catch (e) { // Case: Error from Elasticsearch JS client From d662cb5f4525e3a808900403f54f3c4f2c2c7097 Mon Sep 17 00:00:00 2001 From: Jean-Louis Leysens Date: Fri, 10 Apr 2020 12:58:18 +0200 Subject: [PATCH 027/102] [ESUI] Move XJson Mode to src/plugins/es_ui_shared (#62758) * Move XJson to x-pack/es_ui_shared Also convert files to TS and clean up use of @ts-ignore * Move console_lang to public * Proper use of mocks * Globally mock out .ace.worker.js modules Having worker code exported in `public` of es_ui_shared poisoned a lot of Jest tests with the need to mock out the ace worker. Instead of adding mocks everywhere we handle the importing in Jest by adding an entry to module mapper. * Remove manual imports of mocks * Delete es_ui_shared/public/mocks for now * Put useXJson code in single place * Import and instantiate xJsonMode * Remove language mocks imports Besides the fact that these paths are wrong these are no longer needed because we mock at use Jest module mapper Co-authored-by: Elastic Machine --- src/dev/jest/config.js | 1 + .../jest/mocks/ace_worker_module_mock.js} | 2 +- .../legacy/console_editor/editor_output.tsx | 2 +- .../send_request_to_es.ts | 2 +- .../__tests__/output_tokenization.test.js | 1 + .../mode/input_highlight_rules.js | 2 +- .../mode/output_highlight_rules.js | 2 +- .../models/legacy_core_editor/mode/script.js | 2 +- .../__tests__/sense_editor.test.js | 2 +- .../models/sense_editor/sense_editor.ts | 2 +- src/plugins/console/public/lib/utils/index.ts | 5 +-- .../console_lang/ace/modes/index.ts} | 2 +- .../elasticsearch_sql_highlight_rules.ts | 0 .../ace/modes/lexer_rules/index.ts} | 0 .../lexer_rules/script_highlight_rules.ts} | 4 +-- .../lexer_rules/x_json_highlight_rules.ts} | 12 +++---- .../console_lang/ace/modes/x_json/index.ts | 19 ++++++++++ .../ace/modes/x_json/worker/index.ts | 26 ++++++++++++++ .../ace/modes/x_json/worker/worker.d.ts | 25 +++++++++++++ .../modes/x_json/worker/x_json.ace.worker.js | 0 .../console_lang/ace/modes/x_json/x_json.ts} | 35 ++++++++++++++++--- .../{ => public}/console_lang/index.ts | 3 ++ .../{ => public}/console_lang/lib/index.ts | 0 .../json_xjson_translation_tools.test.ts | 0 .../__tests__/utils_string_collapsing.txt | 0 .../__tests__/utils_string_expanding.txt | 0 .../lib/json_xjson_translation_tools/index.ts | 0 src/plugins/es_ui_shared/public/index.ts | 11 ++++++ .../static/ace_x_json/hooks/index.ts | 20 +++++++++++ .../ace_x_json/hooks/use_x_json.ts} | 26 ++++++++------ x-pack/dev-tools/jest/create_jest_config.js | 1 + .../console_lang/ace/modes/index.ts | 7 ---- .../console_lang/ace/modes/x_json/index.ts | 7 ---- .../ace/modes/x_json/worker/index.ts | 13 ------- .../ace/modes/x_json/worker/worker.d.ts | 12 ------- .../console_lang/ace/modes/x_json/x_json.ts | 34 ------------------ .../es_ui_shared/console_lang/index.ts | 7 ---- .../es_ui_shared/console_lang/mocks.ts | 9 ----- .../components/custom_hooks/index.ts | 1 - .../custom_hooks/use_x_json_mode.ts | 26 -------------- .../create_analytics_advanced_editor.tsx | 5 ++- .../use_create_analytics_form/reducer.ts | 2 +- .../ml_job_editor/ml_job_editor.tsx | 5 ++- x-pack/plugins/ml/shared_imports.ts | 5 ++- .../public/application/editor/editor.test.tsx | 2 -- .../public/application/editor/init_editor.ts | 2 +- .../utils/check_for_json_errors.ts | 2 +- .../public/app/hooks/use_x_json_mode.ts | 20 ----------- .../step_define/step_define_form.tsx | 4 ++- .../transform/public/shared_imports.ts | 4 +-- .../builtin_action_types/es_index.tsx | 2 +- .../public/application/lib/use_x_json_mode.ts | 25 ------------- .../watch_create_json.test.ts | 2 -- .../watch_create_threshold.test.tsx | 2 -- .../client_integration/watch_edit.test.ts | 1 - .../client_integration/watch_list.test.ts | 1 - .../client_integration/watch_status.test.ts | 1 - .../json_watch_edit/json_watch_edit_form.tsx | 3 +- .../json_watch_edit_simulate.tsx | 2 +- .../json_watch_edit/use_x_json_mode.ts | 24 ------------- .../public/application/shared_imports.ts | 2 ++ 61 files changed, 193 insertions(+), 246 deletions(-) rename src/{plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts => dev/jest/mocks/ace_worker_module_mock.js} (94%) rename src/plugins/es_ui_shared/{console_lang/ace/modes/index.js => public/console_lang/ace/modes/index.ts} (94%) rename src/plugins/es_ui_shared/{ => public}/console_lang/ace/modes/lexer_rules/elasticsearch_sql_highlight_rules.ts (100%) rename src/plugins/es_ui_shared/{console_lang/ace/modes/lexer_rules/index.js => public/console_lang/ace/modes/lexer_rules/index.ts} (100%) rename src/plugins/es_ui_shared/{console_lang/ace/modes/lexer_rules/script_highlight_rules.js => public/console_lang/ace/modes/lexer_rules/script_highlight_rules.ts} (97%) rename src/plugins/es_ui_shared/{console_lang/ace/modes/lexer_rules/x_json_highlight_rules.js => public/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.ts} (94%) create mode 100644 src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/index.ts create mode 100644 src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/index.ts create mode 100644 src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/worker.d.ts rename x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.js => src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/x_json.ace.worker.js (100%) rename src/plugins/es_ui_shared/{console_lang/ace/modes/x_json/x_json_mode.ts => public/console_lang/ace/modes/x_json/x_json.ts} (61%) rename src/plugins/es_ui_shared/{ => public}/console_lang/index.ts (92%) rename src/plugins/es_ui_shared/{ => public}/console_lang/lib/index.ts (100%) rename src/plugins/es_ui_shared/{ => public}/console_lang/lib/json_xjson_translation_tools/__tests__/json_xjson_translation_tools.test.ts (100%) rename src/plugins/es_ui_shared/{ => public}/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_collapsing.txt (100%) rename src/plugins/es_ui_shared/{ => public}/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_expanding.txt (100%) rename src/plugins/es_ui_shared/{ => public}/console_lang/lib/json_xjson_translation_tools/index.ts (100%) create mode 100644 src/plugins/es_ui_shared/static/ace_x_json/hooks/index.ts rename src/plugins/es_ui_shared/{console_lang/ace/modes/index.d.ts => static/ace_x_json/hooks/use_x_json.ts} (60%) delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/ace/modes/index.ts delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/index.ts delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.d.ts delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json.ts delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/index.ts delete mode 100644 x-pack/plugins/es_ui_shared/console_lang/mocks.ts delete mode 100644 x-pack/plugins/ml/public/application/components/custom_hooks/use_x_json_mode.ts delete mode 100644 x-pack/plugins/transform/public/app/hooks/use_x_json_mode.ts delete mode 100644 x-pack/plugins/triggers_actions_ui/public/application/lib/use_x_json_mode.ts delete mode 100644 x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/use_x_json_mode.ts diff --git a/src/dev/jest/config.js b/src/dev/jest/config.js index a941735c7840e..7da14e0dfe51b 100644 --- a/src/dev/jest/config.js +++ b/src/dev/jest/config.js @@ -62,6 +62,7 @@ export default { '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$': '/src/dev/jest/mocks/file_mock.js', '\\.(css|less|scss)$': '/src/dev/jest/mocks/style_mock.js', + '\\.ace\\.worker.js$': '/src/dev/jest/mocks/ace_worker_module_mock.js', }, setupFiles: [ '/src/dev/jest/setup/babel_polyfill.js', diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts b/src/dev/jest/mocks/ace_worker_module_mock.js similarity index 94% rename from src/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts rename to src/dev/jest/mocks/ace_worker_module_mock.js index caa7b518b8b66..9d267f494f8bf 100644 --- a/src/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts +++ b/src/dev/jest/mocks/ace_worker_module_mock.js @@ -17,4 +17,4 @@ * under the License. */ -export { XJsonMode } from './x_json_mode'; +module.exports = ''; diff --git a/src/plugins/console/public/application/containers/editor/legacy/console_editor/editor_output.tsx b/src/plugins/console/public/application/containers/editor/legacy/console_editor/editor_output.tsx index 36d90bb6bff1a..8510aaebfaa1e 100644 --- a/src/plugins/console/public/application/containers/editor/legacy/console_editor/editor_output.tsx +++ b/src/plugins/console/public/application/containers/editor/legacy/console_editor/editor_output.tsx @@ -20,7 +20,7 @@ import { EuiScreenReaderOnly } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import React, { useEffect, useRef } from 'react'; -import { expandLiteralStrings } from '../../../../../../../es_ui_shared/console_lang/lib'; +import { expandLiteralStrings } from '../../../../../../../es_ui_shared/public'; import { useEditorReadContext, useRequestReadContext, diff --git a/src/plugins/console/public/application/hooks/use_send_current_request_to_es/send_request_to_es.ts b/src/plugins/console/public/application/hooks/use_send_current_request_to_es/send_request_to_es.ts index 102f90a9feb6f..cfbd5691bc22b 100644 --- a/src/plugins/console/public/application/hooks/use_send_current_request_to_es/send_request_to_es.ts +++ b/src/plugins/console/public/application/hooks/use_send_current_request_to_es/send_request_to_es.ts @@ -18,7 +18,7 @@ */ import { extractDeprecationMessages } from '../../../lib/utils'; -import { collapseLiteralStrings } from '../../../../../es_ui_shared/console_lang/lib'; +import { collapseLiteralStrings } from '../../../../../es_ui_shared/public'; // @ts-ignore import * as es from '../../../lib/es/es'; import { BaseResponseType } from '../../../types'; diff --git a/src/plugins/console/public/application/models/legacy_core_editor/__tests__/output_tokenization.test.js b/src/plugins/console/public/application/models/legacy_core_editor/__tests__/output_tokenization.test.js index 6a93d007a6cdc..5c86b0a1d2092 100644 --- a/src/plugins/console/public/application/models/legacy_core_editor/__tests__/output_tokenization.test.js +++ b/src/plugins/console/public/application/models/legacy_core_editor/__tests__/output_tokenization.test.js @@ -16,6 +16,7 @@ * specific language governing permissions and limitations * under the License. */ +import '../legacy_core_editor.test.mocks'; const $ = require('jquery'); import RowParser from '../../../../lib/row_parser'; import ace from 'brace'; diff --git a/src/plugins/console/public/application/models/legacy_core_editor/mode/input_highlight_rules.js b/src/plugins/console/public/application/models/legacy_core_editor/mode/input_highlight_rules.js index 2c1b30f806f95..29f192f4ea858 100644 --- a/src/plugins/console/public/application/models/legacy_core_editor/mode/input_highlight_rules.js +++ b/src/plugins/console/public/application/models/legacy_core_editor/mode/input_highlight_rules.js @@ -18,7 +18,7 @@ */ const ace = require('brace'); -import { addXJsonToRules } from '../../../../../../es_ui_shared/console_lang'; +import { addXJsonToRules } from '../../../../../../es_ui_shared/public'; export function addEOL(tokens, reg, nextIfEOL, normalNext) { if (typeof reg === 'object') { diff --git a/src/plugins/console/public/application/models/legacy_core_editor/mode/output_highlight_rules.js b/src/plugins/console/public/application/models/legacy_core_editor/mode/output_highlight_rules.js index e27222ebd65e9..c9d538ab6ceb1 100644 --- a/src/plugins/console/public/application/models/legacy_core_editor/mode/output_highlight_rules.js +++ b/src/plugins/console/public/application/models/legacy_core_editor/mode/output_highlight_rules.js @@ -19,7 +19,7 @@ const ace = require('brace'); import 'brace/mode/json'; -import { addXJsonToRules } from '../../../../../../es_ui_shared/console_lang'; +import { addXJsonToRules } from '../../../../../../es_ui_shared/public'; const oop = ace.acequire('ace/lib/oop'); const JsonHighlightRules = ace.acequire('ace/mode/json_highlight_rules').JsonHighlightRules; diff --git a/src/plugins/console/public/application/models/legacy_core_editor/mode/script.js b/src/plugins/console/public/application/models/legacy_core_editor/mode/script.js index 13ae329380221..89adea8921c07 100644 --- a/src/plugins/console/public/application/models/legacy_core_editor/mode/script.js +++ b/src/plugins/console/public/application/models/legacy_core_editor/mode/script.js @@ -18,7 +18,7 @@ */ import ace from 'brace'; -import { ScriptHighlightRules } from '../../../../../../es_ui_shared/console_lang'; +import { ScriptHighlightRules } from '../../../../../../es_ui_shared/public'; const oop = ace.acequire('ace/lib/oop'); const TextMode = ace.acequire('ace/mode/text').Mode; diff --git a/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js b/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js index 63f97345bc9ff..6afc03df13b4c 100644 --- a/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js +++ b/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js @@ -22,7 +22,7 @@ import $ from 'jquery'; import _ from 'lodash'; import { create } from '../create'; -import { collapseLiteralStrings } from '../../../../../../es_ui_shared/console_lang/lib'; +import { collapseLiteralStrings } from '../../../../../../es_ui_shared/public'; const editorInput1 = require('./editor_input1.txt'); describe('Editor', () => { diff --git a/src/plugins/console/public/application/models/sense_editor/sense_editor.ts b/src/plugins/console/public/application/models/sense_editor/sense_editor.ts index b1444bdf2bbab..9bcd3a6872196 100644 --- a/src/plugins/console/public/application/models/sense_editor/sense_editor.ts +++ b/src/plugins/console/public/application/models/sense_editor/sense_editor.ts @@ -19,7 +19,7 @@ import _ from 'lodash'; import RowParser from '../../../lib/row_parser'; -import { collapseLiteralStrings } from '../../../../../es_ui_shared/console_lang/lib'; +import { collapseLiteralStrings } from '../../../../../es_ui_shared/public'; import * as utils from '../../../lib/utils'; // @ts-ignore diff --git a/src/plugins/console/public/lib/utils/index.ts b/src/plugins/console/public/lib/utils/index.ts index f66c952dd3af7..0ebea0f9d4055 100644 --- a/src/plugins/console/public/lib/utils/index.ts +++ b/src/plugins/console/public/lib/utils/index.ts @@ -18,10 +18,7 @@ */ import _ from 'lodash'; -import { - expandLiteralStrings, - collapseLiteralStrings, -} from '../../../../es_ui_shared/console_lang/lib'; +import { expandLiteralStrings, collapseLiteralStrings } from '../../../../es_ui_shared/public'; export function textFromRequest(request: any) { let data = request.data; diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/index.js b/src/plugins/es_ui_shared/public/console_lang/ace/modes/index.ts similarity index 94% rename from src/plugins/es_ui_shared/console_lang/ace/modes/index.js rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/index.ts index 955f23116f659..f9e016c5078af 100644 --- a/src/plugins/es_ui_shared/console_lang/ace/modes/index.js +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/index.ts @@ -24,4 +24,4 @@ export { addXJsonToRules, } from './lexer_rules'; -export { XJsonMode, installXJsonMode } from './x_json'; +export { installXJsonMode, XJsonMode } from './x_json'; diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/elasticsearch_sql_highlight_rules.ts b/src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/elasticsearch_sql_highlight_rules.ts similarity index 100% rename from src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/elasticsearch_sql_highlight_rules.ts rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/elasticsearch_sql_highlight_rules.ts diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/index.js b/src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/index.ts similarity index 100% rename from src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/index.js rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/index.ts diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/script_highlight_rules.js b/src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/script_highlight_rules.ts similarity index 97% rename from src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/script_highlight_rules.js rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/script_highlight_rules.ts index b3999c76493c0..4b2e965276a3c 100644 --- a/src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/script_highlight_rules.js +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/script_highlight_rules.ts @@ -17,13 +17,13 @@ * under the License. */ -const ace = require('brace'); +import ace from 'brace'; const oop = ace.acequire('ace/lib/oop'); const { TextHighlightRules } = ace.acequire('ace/mode/text_highlight_rules'); const painlessKeywords = 'def|int|long|byte|String|float|double|char|null|if|else|while|do|for|continue|break|new|try|catch|throw|this|instanceof|return|ctx'; -export function ScriptHighlightRules() { +export function ScriptHighlightRules(this: any) { this.name = 'ScriptHighlightRules'; this.$rules = { start: [ diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.js b/src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.ts similarity index 94% rename from src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.js rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.ts index 14323b9320330..3663b92d92a6f 100644 --- a/src/plugins/es_ui_shared/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.js +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/lexer_rules/x_json_highlight_rules.ts @@ -22,14 +22,14 @@ import ace from 'brace'; import 'brace/mode/json'; import { ElasticsearchSqlHighlightRules } from './elasticsearch_sql_highlight_rules'; -const { ScriptHighlightRules } = require('./script_highlight_rules'); +import { ScriptHighlightRules } from './script_highlight_rules'; const { JsonHighlightRules } = ace.acequire('ace/mode/json_highlight_rules'); const oop = ace.acequire('ace/lib/oop'); -const jsonRules = function(root) { +const jsonRules = function(root: any) { root = root ? root : 'json'; - const rules = {}; + const rules: any = {}; const xJsonRules = [ { token: [ @@ -135,7 +135,7 @@ const jsonRules = function(root) { merge: false, push: true, }, - ].concat(xJsonRules); + ].concat(xJsonRules as any); rules.string_literal = [ { @@ -151,7 +151,7 @@ const jsonRules = function(root) { return rules; }; -export function XJsonHighlightRules() { +export function XJsonHighlightRules(this: any) { this.$rules = { ...jsonRules('start'), }; @@ -175,7 +175,7 @@ export function XJsonHighlightRules() { oop.inherits(XJsonHighlightRules, JsonHighlightRules); -export function addToRules(otherRules, embedUnder) { +export function addToRules(otherRules: any, embedUnder: any) { otherRules.$rules = _.defaultsDeep(otherRules.$rules, jsonRules(embedUnder)); otherRules.embedRules(ScriptHighlightRules, 'script-', [ { diff --git a/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/index.ts b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/index.ts new file mode 100644 index 0000000000000..6fd819bb4e9eb --- /dev/null +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/index.ts @@ -0,0 +1,19 @@ +/* + * 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. + */ +export { installXJsonMode, XJsonMode } from './x_json'; diff --git a/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/index.ts b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/index.ts new file mode 100644 index 0000000000000..0f884765be05e --- /dev/null +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/index.ts @@ -0,0 +1,26 @@ +/* + * 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. + */ + +// @ts-ignore +import src from '!!raw-loader!./x_json.ace.worker.js'; + +export const workerModule = { + id: 'ace/mode/json_worker', + src, +}; diff --git a/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/worker.d.ts b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/worker.d.ts new file mode 100644 index 0000000000000..d2363a2610689 --- /dev/null +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/worker.d.ts @@ -0,0 +1,25 @@ +/* + * 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. + */ + +// Satisfy TS's requirements that the module be declared per './index.ts'. +declare module '!!raw-loader!./worker.js' { + const content: string; + // eslint-disable-next-line import/no-default-export + export default content; +} diff --git a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.js b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/x_json.ace.worker.js similarity index 100% rename from x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.js rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/worker/x_json.ace.worker.js diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json_mode.ts b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/x_json.ts similarity index 61% rename from src/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json_mode.ts rename to src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/x_json.ts index 9f804c29a5d27..9fbfedba1d23f 100644 --- a/src/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json_mode.ts +++ b/src/plugins/es_ui_shared/public/console_lang/ace/modes/x_json/x_json.ts @@ -18,23 +18,50 @@ */ import ace from 'brace'; - import { XJsonHighlightRules } from '../index'; +import { workerModule } from './worker'; + +const { WorkerClient } = ace.acequire('ace/worker/worker_client'); const oop = ace.acequire('ace/lib/oop'); + const { Mode: JSONMode } = ace.acequire('ace/mode/json'); const { Tokenizer: AceTokenizer } = ace.acequire('ace/tokenizer'); const { MatchingBraceOutdent } = ace.acequire('ace/mode/matching_brace_outdent'); const { CstyleBehaviour } = ace.acequire('ace/mode/behaviour/cstyle'); const { FoldMode: CStyleFoldMode } = ace.acequire('ace/mode/folding/cstyle'); -export function XJsonMode(this: any) { - const ruleset: any = new XJsonHighlightRules(); +const XJsonMode: any = function XJsonMode(this: any) { + const ruleset: any = new (XJsonHighlightRules as any)(); ruleset.normalizeRules(); this.$tokenizer = new AceTokenizer(ruleset.getRules()); this.$outdent = new MatchingBraceOutdent(); this.$behaviour = new CstyleBehaviour(); this.foldingRules = new CStyleFoldMode(); -} +}; oop.inherits(XJsonMode, JSONMode); + +// Then clobber `createWorker` method to install our worker source. Per ace's wiki: https://github.com/ajaxorg/ace/wiki/Syntax-validation +(XJsonMode.prototype as any).createWorker = function(session: ace.IEditSession) { + const xJsonWorker = new WorkerClient(['ace'], workerModule, 'JsonWorker'); + + xJsonWorker.attachToDocument(session.getDocument()); + + xJsonWorker.on('annotate', function(e: { data: any }) { + session.setAnnotations(e.data); + }); + + xJsonWorker.on('terminate', function() { + session.clearAnnotations(); + }); + + return xJsonWorker; +}; + +export { XJsonMode }; + +export function installXJsonMode(editor: ace.Editor) { + const session = editor.getSession(); + session.setMode(new XJsonMode()); +} diff --git a/src/plugins/es_ui_shared/console_lang/index.ts b/src/plugins/es_ui_shared/public/console_lang/index.ts similarity index 92% rename from src/plugins/es_ui_shared/console_lang/index.ts rename to src/plugins/es_ui_shared/public/console_lang/index.ts index a4958911af412..7d83191569622 100644 --- a/src/plugins/es_ui_shared/console_lang/index.ts +++ b/src/plugins/es_ui_shared/public/console_lang/index.ts @@ -26,4 +26,7 @@ export { XJsonHighlightRules, addXJsonToRules, XJsonMode, + installXJsonMode, } from './ace/modes'; + +export { expandLiteralStrings, collapseLiteralStrings } from './lib'; diff --git a/src/plugins/es_ui_shared/console_lang/lib/index.ts b/src/plugins/es_ui_shared/public/console_lang/lib/index.ts similarity index 100% rename from src/plugins/es_ui_shared/console_lang/lib/index.ts rename to src/plugins/es_ui_shared/public/console_lang/lib/index.ts diff --git a/src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/__tests__/json_xjson_translation_tools.test.ts b/src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/__tests__/json_xjson_translation_tools.test.ts similarity index 100% rename from src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/__tests__/json_xjson_translation_tools.test.ts rename to src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/__tests__/json_xjson_translation_tools.test.ts diff --git a/src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_collapsing.txt b/src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_collapsing.txt similarity index 100% rename from src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_collapsing.txt rename to src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_collapsing.txt diff --git a/src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_expanding.txt b/src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_expanding.txt similarity index 100% rename from src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_expanding.txt rename to src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/__tests__/utils_string_expanding.txt diff --git a/src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/index.ts b/src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/index.ts similarity index 100% rename from src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools/index.ts rename to src/plugins/es_ui_shared/public/console_lang/lib/json_xjson_translation_tools/index.ts diff --git a/src/plugins/es_ui_shared/public/index.ts b/src/plugins/es_ui_shared/public/index.ts index 6db6248f4c68f..a0371bf351193 100644 --- a/src/plugins/es_ui_shared/public/index.ts +++ b/src/plugins/es_ui_shared/public/index.ts @@ -36,6 +36,17 @@ export { indices } from './indices'; export { useUIAceKeyboardMode } from './use_ui_ace_keyboard_mode'; +export { + installXJsonMode, + XJsonMode, + ElasticsearchSqlHighlightRules, + addXJsonToRules, + ScriptHighlightRules, + XJsonHighlightRules, + collapseLiteralStrings, + expandLiteralStrings, +} from './console_lang'; + /** dummy plugin, we just want esUiShared to have its own bundle */ export function plugin() { return new (class EsUiSharedPlugin { diff --git a/src/plugins/es_ui_shared/static/ace_x_json/hooks/index.ts b/src/plugins/es_ui_shared/static/ace_x_json/hooks/index.ts new file mode 100644 index 0000000000000..1d2c33a9f0f47 --- /dev/null +++ b/src/plugins/es_ui_shared/static/ace_x_json/hooks/index.ts @@ -0,0 +1,20 @@ +/* + * 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. + */ + +export { useXJsonMode } from './use_x_json'; diff --git a/src/plugins/es_ui_shared/console_lang/ace/modes/index.d.ts b/src/plugins/es_ui_shared/static/ace_x_json/hooks/use_x_json.ts similarity index 60% rename from src/plugins/es_ui_shared/console_lang/ace/modes/index.d.ts rename to src/plugins/es_ui_shared/static/ace_x_json/hooks/use_x_json.ts index 06c9f9a51ea68..2b0bf0c8a3a7c 100644 --- a/src/plugins/es_ui_shared/console_lang/ace/modes/index.d.ts +++ b/src/plugins/es_ui_shared/static/ace_x_json/hooks/use_x_json.ts @@ -17,16 +17,22 @@ * under the License. */ -import { Editor } from 'brace'; +import { useState } from 'react'; +import { XJsonMode, collapseLiteralStrings, expandLiteralStrings } from '../../../public'; -export declare const ElasticsearchSqlHighlightRules: FunctionConstructor; -export declare const ScriptHighlightRules: FunctionConstructor; -export declare const XJsonHighlightRules: FunctionConstructor; +const xJsonMode = new XJsonMode(); -export declare const XJsonMode: FunctionConstructor; +export const useXJsonMode = (json: Record | string | null) => { + const [xJson, setXJson] = useState(() => + json === null + ? '' + : expandLiteralStrings(typeof json === 'string' ? json : JSON.stringify(json, null, 2)) + ); -/** - * @param otherRules Another Ace ruleset - * @param embedUnder The state name under which the rules will be embedded. Defaults to "json". - */ -export declare const addXJsonToRules: (otherRules: any, embedUnder?: string) => void; + return { + xJson, + setXJson, + xJsonMode, + convertToJson: collapseLiteralStrings, + }; +}; diff --git a/x-pack/dev-tools/jest/create_jest_config.js b/x-pack/dev-tools/jest/create_jest_config.js index 1f4311ae9bcf6..3068cdd0daa5b 100644 --- a/x-pack/dev-tools/jest/create_jest_config.js +++ b/x-pack/dev-tools/jest/create_jest_config.js @@ -28,6 +28,7 @@ export function createJestConfig({ kibanaDirectory, xPackKibanaDirectory }) { '\\.(jpg|jpeg|png|gif|eot|otf|webp|svg|ttf|woff|woff2|mp4|webm|wav|mp3|m4a|aac|oga)$': fileMockPath, '\\.module.(css|scss)$': `${kibanaDirectory}/src/dev/jest/mocks/css_module_mock.js`, '\\.(css|less|scss)$': `${kibanaDirectory}/src/dev/jest/mocks/style_mock.js`, + '\\.ace\\.worker.js$': `${kibanaDirectory}/src/dev/jest/mocks/ace_worker_module_mock.js`, '^test_utils/enzyme_helpers': `${xPackKibanaDirectory}/test_utils/enzyme_helpers.tsx`, '^test_utils/find_test_subject': `${xPackKibanaDirectory}/test_utils/find_test_subject.ts`, '^test_utils/stub_web_worker': `${xPackKibanaDirectory}/test_utils/stub_web_worker.ts`, diff --git a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/index.ts b/x-pack/plugins/es_ui_shared/console_lang/ace/modes/index.ts deleted file mode 100644 index ae3c9962ecadb..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { installXJsonMode, XJsonMode } from './x_json'; diff --git a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts b/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts deleted file mode 100644 index ae3c9962ecadb..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { installXJsonMode, XJsonMode } from './x_json'; diff --git a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/index.ts b/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/index.ts deleted file mode 100644 index 0e40fd335dd31..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/index.ts +++ /dev/null @@ -1,13 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -// @ts-ignore -import src from '!!raw-loader!./worker.js'; - -export const workerModule = { - id: 'ace/mode/json_worker', - src, -}; diff --git a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.d.ts b/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.d.ts deleted file mode 100644 index 4ebad4f2ef91c..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/worker/worker.d.ts +++ /dev/null @@ -1,12 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -// Satisfy TS's requirements that the module be declared per './index.ts'. -declare module '!!raw-loader!./worker.js' { - const content: string; - // eslint-disable-next-line import/no-default-export - export default content; -} diff --git a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json.ts b/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json.ts deleted file mode 100644 index bfeca045bea02..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/ace/modes/x_json/x_json.ts +++ /dev/null @@ -1,34 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import ace from 'brace'; -import { XJsonMode } from '../../../../../../../src/plugins/es_ui_shared/console_lang'; -import { workerModule } from './worker'; -const { WorkerClient } = ace.acequire('ace/worker/worker_client'); - -// Then clobber `createWorker` method to install our worker source. Per ace's wiki: https://github.com/ajaxorg/ace/wiki/Syntax-validation -(XJsonMode.prototype as any).createWorker = function(session: ace.IEditSession) { - const xJsonWorker = new WorkerClient(['ace'], workerModule, 'JsonWorker'); - - xJsonWorker.attachToDocument(session.getDocument()); - - xJsonWorker.on('annotate', function(e: { data: any }) { - session.setAnnotations(e.data); - }); - - xJsonWorker.on('terminate', function() { - session.clearAnnotations(); - }); - - return xJsonWorker; -}; - -export { XJsonMode }; - -export function installXJsonMode(editor: ace.Editor) { - const session = editor.getSession(); - session.setMode(new (XJsonMode as any)()); -} diff --git a/x-pack/plugins/es_ui_shared/console_lang/index.ts b/x-pack/plugins/es_ui_shared/console_lang/index.ts deleted file mode 100644 index b5fe3a554e34d..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { XJsonMode, installXJsonMode } from './ace/modes'; diff --git a/x-pack/plugins/es_ui_shared/console_lang/mocks.ts b/x-pack/plugins/es_ui_shared/console_lang/mocks.ts deleted file mode 100644 index 68480282ddc03..0000000000000 --- a/x-pack/plugins/es_ui_shared/console_lang/mocks.ts +++ /dev/null @@ -1,9 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -jest.mock('./ace/modes/x_json/worker', () => ({ - workerModule: { id: 'ace/mode/json_worker', src: '' }, -})); diff --git a/x-pack/plugins/ml/public/application/components/custom_hooks/index.ts b/x-pack/plugins/ml/public/application/components/custom_hooks/index.ts index dfd74d8970cb4..ffead802bd6f9 100644 --- a/x-pack/plugins/ml/public/application/components/custom_hooks/index.ts +++ b/x-pack/plugins/ml/public/application/components/custom_hooks/index.ts @@ -5,4 +5,3 @@ */ export { usePartialState } from './use_partial_state'; -export { useXJsonMode, xJsonMode } from './use_x_json_mode'; diff --git a/x-pack/plugins/ml/public/application/components/custom_hooks/use_x_json_mode.ts b/x-pack/plugins/ml/public/application/components/custom_hooks/use_x_json_mode.ts deleted file mode 100644 index c979632db54d6..0000000000000 --- a/x-pack/plugins/ml/public/application/components/custom_hooks/use_x_json_mode.ts +++ /dev/null @@ -1,26 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { useState } from 'react'; -import { - collapseLiteralStrings, - expandLiteralStrings, - XJsonMode, -} from '../../../../shared_imports'; - -// @ts-ignore -export const xJsonMode = new XJsonMode(); - -export const useXJsonMode = (json: string) => { - const [xJson, setXJson] = useState(expandLiteralStrings(json)); - - return { - xJson, - setXJson, - xJsonMode, - convertToJson: collapseLiteralStrings, - }; -}; diff --git a/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/components/create_analytics_advanced_editor/create_analytics_advanced_editor.tsx b/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/components/create_analytics_advanced_editor/create_analytics_advanced_editor.tsx index a3e5da5e2d039..cef03cc0d0c76 100644 --- a/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/components/create_analytics_advanced_editor/create_analytics_advanced_editor.tsx +++ b/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/components/create_analytics_advanced_editor/create_analytics_advanced_editor.tsx @@ -18,8 +18,11 @@ import { import { i18n } from '@kbn/i18n'; +import { XJsonMode } from '../../../../../../../shared_imports'; + +const xJsonMode = new XJsonMode(); + import { CreateAnalyticsFormProps } from '../../hooks/use_create_analytics_form'; -import { xJsonMode } from '../../../../../components/custom_hooks'; export const CreateAnalyticsAdvancedEditor: FC = ({ actions, state }) => { const { setAdvancedEditorRawString, setFormState } = actions; diff --git a/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/hooks/use_create_analytics_form/reducer.ts b/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/hooks/use_create_analytics_form/reducer.ts index ded6e50947035..d55eb14a20e29 100644 --- a/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/hooks/use_create_analytics_form/reducer.ts +++ b/x-pack/plugins/ml/public/application/data_frame_analytics/pages/analytics_management/hooks/use_create_analytics_form/reducer.ts @@ -11,7 +11,7 @@ import numeral from '@elastic/numeral'; import { isEmpty } from 'lodash'; import { isValidIndexName } from '../../../../../../../common/util/es_utils'; -import { collapseLiteralStrings } from '../../../../../../../../../../src/plugins/es_ui_shared/console_lang/lib/json_xjson_translation_tools'; +import { collapseLiteralStrings } from '../../../../../../../../../../src/plugins/es_ui_shared/public'; import { Action, ACTION } from './actions'; import { getInitialState, getJobConfigFromFormState, State } from './state'; diff --git a/x-pack/plugins/ml/public/application/jobs/jobs_list/components/ml_job_editor/ml_job_editor.tsx b/x-pack/plugins/ml/public/application/jobs/jobs_list/components/ml_job_editor/ml_job_editor.tsx index 0633c62f754e0..c10212ee31564 100644 --- a/x-pack/plugins/ml/public/application/jobs/jobs_list/components/ml_job_editor/ml_job_editor.tsx +++ b/x-pack/plugins/ml/public/application/jobs/jobs_list/components/ml_job_editor/ml_job_editor.tsx @@ -7,10 +7,9 @@ import React, { FC } from 'react'; import { EuiCodeEditor, EuiCodeEditorProps } from '@elastic/eui'; -import { expandLiteralStrings } from '../../../../../../shared_imports'; -import { xJsonMode } from '../../../../components/custom_hooks'; +import { expandLiteralStrings, XJsonMode } from '../../../../../../shared_imports'; -export const ML_EDITOR_MODE = { TEXT: 'text', JSON: 'json', XJSON: xJsonMode }; +export const ML_EDITOR_MODE = { TEXT: 'text', JSON: 'json', XJSON: new XJsonMode() }; interface MlJobEditorProps { value: string; diff --git a/x-pack/plugins/ml/shared_imports.ts b/x-pack/plugins/ml/shared_imports.ts index 94ce8c82f1d95..a82ed5387818d 100644 --- a/x-pack/plugins/ml/shared_imports.ts +++ b/x-pack/plugins/ml/shared_imports.ts @@ -4,9 +4,8 @@ * you may not use this file except in compliance with the Elastic License. */ -export { XJsonMode } from '../../../src/plugins/es_ui_shared/console_lang/ace/modes/x_json'; - export { + XJsonMode, collapseLiteralStrings, expandLiteralStrings, -} from '../../../src/plugins/es_ui_shared/console_lang/lib'; +} from '../../../src/plugins/es_ui_shared/public'; diff --git a/x-pack/plugins/searchprofiler/public/application/editor/editor.test.tsx b/x-pack/plugins/searchprofiler/public/application/editor/editor.test.tsx index ad56b3957eb74..e56fc79156666 100644 --- a/x-pack/plugins/searchprofiler/public/application/editor/editor.test.tsx +++ b/x-pack/plugins/searchprofiler/public/application/editor/editor.test.tsx @@ -6,8 +6,6 @@ import 'brace'; import 'brace/mode/json'; -import '../../../../es_ui_shared/console_lang/mocks'; - import { registerTestBed } from '../../../../../test_utils'; import { Editor, Props } from '.'; diff --git a/x-pack/plugins/searchprofiler/public/application/editor/init_editor.ts b/x-pack/plugins/searchprofiler/public/application/editor/init_editor.ts index 6f19ce12eb639..3ad92531e4367 100644 --- a/x-pack/plugins/searchprofiler/public/application/editor/init_editor.ts +++ b/x-pack/plugins/searchprofiler/public/application/editor/init_editor.ts @@ -5,7 +5,7 @@ */ import ace from 'brace'; -import { installXJsonMode } from '../../../../es_ui_shared/console_lang'; +import { installXJsonMode } from '../../../../../../src/plugins/es_ui_shared/public'; export function initializeEditor({ el, diff --git a/x-pack/plugins/searchprofiler/public/application/utils/check_for_json_errors.ts b/x-pack/plugins/searchprofiler/public/application/utils/check_for_json_errors.ts index 99687de0f1440..58a62c4636c25 100644 --- a/x-pack/plugins/searchprofiler/public/application/utils/check_for_json_errors.ts +++ b/x-pack/plugins/searchprofiler/public/application/utils/check_for_json_errors.ts @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { collapseLiteralStrings } from '../../../../../../src/plugins/es_ui_shared/console_lang/lib'; +import { collapseLiteralStrings } from '../../../../../../src/plugins/es_ui_shared/public'; export function checkForParseErrors(json: string) { const sanitizedJson = collapseLiteralStrings(json); diff --git a/x-pack/plugins/transform/public/app/hooks/use_x_json_mode.ts b/x-pack/plugins/transform/public/app/hooks/use_x_json_mode.ts deleted file mode 100644 index 1017ce198ff29..0000000000000 --- a/x-pack/plugins/transform/public/app/hooks/use_x_json_mode.ts +++ /dev/null @@ -1,20 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import { useState } from 'react'; -import { collapseLiteralStrings, expandLiteralStrings, XJsonMode } from '../../shared_imports'; - -export const xJsonMode = new XJsonMode(); - -export const useXJsonMode = (json: string) => { - const [xJson, setXJson] = useState(expandLiteralStrings(json)); - - return { - xJson, - setXJson, - xJsonMode, - convertToJson: collapseLiteralStrings, - }; -}; diff --git a/x-pack/plugins/transform/public/app/sections/create_transform/components/step_define/step_define_form.tsx b/x-pack/plugins/transform/public/app/sections/create_transform/components/step_define/step_define_form.tsx index 5e0eb7ee08361..320e405b5d437 100644 --- a/x-pack/plugins/transform/public/app/sections/create_transform/components/step_define/step_define_form.tsx +++ b/x-pack/plugins/transform/public/app/sections/create_transform/components/step_define/step_define_form.tsx @@ -33,11 +33,12 @@ import { QueryStringInput, } from '../../../../../../../../../src/plugins/data/public'; +import { useXJsonMode } from '../../../../../../../../../src/plugins/es_ui_shared/static/ace_x_json/hooks'; + import { PivotPreview } from '../../../../components/pivot_preview'; import { useDocumentationLinks } from '../../../../hooks/use_documentation_links'; import { SavedSearchQuery, SearchItems } from '../../../../hooks/use_search_items'; -import { useXJsonMode, xJsonMode } from '../../../../hooks/use_x_json_mode'; import { useToastNotifications } from '../../../../app_dependencies'; import { TransformPivotConfig } from '../../../../common'; import { dictionaryToArray, Dictionary } from '../../../../../../common/types/common'; @@ -432,6 +433,7 @@ export const StepDefineForm: FC = React.memo(({ overrides = {}, onChange, convertToJson, setXJson: setAdvancedEditorConfig, xJson: advancedEditorConfig, + xJsonMode, } = useXJsonMode(stringifiedPivotConfig); useEffect(() => { diff --git a/x-pack/plugins/transform/public/shared_imports.ts b/x-pack/plugins/transform/public/shared_imports.ts index 8eb42ad677c0f..494b6db6aafe0 100644 --- a/x-pack/plugins/transform/public/shared_imports.ts +++ b/x-pack/plugins/transform/public/shared_imports.ts @@ -5,11 +5,11 @@ */ export { createSavedSearchesLoader } from '../../../../src/plugins/discover/public'; -export { XJsonMode } from '../../es_ui_shared/console_lang/ace/modes/x_json'; export { + XJsonMode, collapseLiteralStrings, expandLiteralStrings, -} from '../../../../src/plugins/es_ui_shared/console_lang/lib'; +} from '../../../../src/plugins/es_ui_shared/public'; export { UseRequestConfig, diff --git a/x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/es_index.tsx b/x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/es_index.tsx index 9bd6a39d216e3..15f68e6a9f441 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/es_index.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/components/builtin_action_types/es_index.tsx @@ -17,6 +17,7 @@ import { } from '@elastic/eui'; import { FormattedMessage } from '@kbn/i18n/react'; import { i18n } from '@kbn/i18n'; +import { useXJsonMode } from '../../../../../../../src/plugins/es_ui_shared/static/ace_x_json/hooks'; import { ActionTypeModel, ActionConnectorFieldsProps, @@ -31,7 +32,6 @@ import { getIndexOptions, getIndexPatterns, } from '../../../common/index_controls'; -import { useXJsonMode } from '../../lib/use_x_json_mode'; import { AddMessageVariables } from '../add_message_variables'; export function getActionType(): ActionTypeModel { diff --git a/x-pack/plugins/triggers_actions_ui/public/application/lib/use_x_json_mode.ts b/x-pack/plugins/triggers_actions_ui/public/application/lib/use_x_json_mode.ts deleted file mode 100644 index b677924724ffe..0000000000000 --- a/x-pack/plugins/triggers_actions_ui/public/application/lib/use_x_json_mode.ts +++ /dev/null @@ -1,25 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import { useState } from 'react'; -import { XJsonMode } from '../../../../../../src/plugins/es_ui_shared/console_lang/ace/modes/x_json'; -import { - collapseLiteralStrings, - expandLiteralStrings, -} from '../../../../../../src/plugins/es_ui_shared/console_lang/lib'; -// @ts-ignore -export const xJsonMode = new XJsonMode(); -export const useXJsonMode = (json: Record | null) => { - const [xJson, setXJson] = useState( - json === null ? '' : expandLiteralStrings(JSON.stringify(json, null, 2)) - ); - - return { - xJson, - setXJson, - xJsonMode, - convertToJson: collapseLiteralStrings, - }; -}; diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts index 47de4548898cf..a35dd1346dc90 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_json.test.ts @@ -4,8 +4,6 @@ * you may not use this file except in compliance with the Elastic License. */ -import '../../../es_ui_shared/console_lang/mocks'; - import { act } from 'react-dom/test-utils'; import { setupEnvironment, pageHelpers, nextTick, wrapBodyResponse } from './helpers'; import { WatchCreateJsonTestBed } from './helpers/watch_create_json.helpers'; diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx index e5bdcbbfb82cf..89cd5207fe250 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_create_threshold.test.tsx @@ -4,8 +4,6 @@ * you may not use this file except in compliance with the Elastic License. */ -import '../../../es_ui_shared/console_lang/mocks'; - import React from 'react'; import { act } from 'react-dom/test-utils'; import axiosXhrAdapter from 'axios/lib/adapters/xhr'; diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts b/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts index ced06562b1d20..18acf7339580c 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_edit.test.ts @@ -3,7 +3,6 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import '../../../es_ui_shared/console_lang/mocks'; import { act } from 'react-dom/test-utils'; import axiosXhrAdapter from 'axios/lib/adapters/xhr'; diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_list.test.ts b/x-pack/plugins/watcher/__jest__/client_integration/watch_list.test.ts index 3370e42b2417f..a0327c6dfa1db 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_list.test.ts +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_list.test.ts @@ -3,7 +3,6 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import '../../../es_ui_shared/console_lang/mocks'; import { act } from 'react-dom/test-utils'; import * as fixtures from '../../test/fixtures'; diff --git a/x-pack/plugins/watcher/__jest__/client_integration/watch_status.test.ts b/x-pack/plugins/watcher/__jest__/client_integration/watch_status.test.ts index 20b7b526705c0..e9cbb2c92491a 100644 --- a/x-pack/plugins/watcher/__jest__/client_integration/watch_status.test.ts +++ b/x-pack/plugins/watcher/__jest__/client_integration/watch_status.test.ts @@ -3,7 +3,6 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import '../../../es_ui_shared/console_lang/mocks'; import { act } from 'react-dom/test-utils'; import { setupEnvironment, pageHelpers, nextTick } from './helpers'; diff --git a/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_form.tsx b/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_form.tsx index b3a09d3bc0e65..b5835d862000f 100644 --- a/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_form.tsx +++ b/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_form.tsx @@ -23,14 +23,13 @@ import { FormattedMessage } from '@kbn/i18n/react'; import { serializeJsonWatch } from '../../../../../../common/lib/serialization'; import { ErrableFormRow, SectionError, Error as ServerError } from '../../../../components'; +import { useXJsonMode } from '../../../../shared_imports'; import { onWatchSave } from '../../watch_edit_actions'; import { WatchContext } from '../../watch_context'; import { goToWatchList } from '../../../../lib/navigation'; import { RequestFlyout } from '../request_flyout'; import { useAppContext } from '../../../../app_context'; -import { useXJsonMode } from './use_x_json_mode'; - export const JsonWatchEditForm = () => { const { links: { putWatchApiUrl }, diff --git a/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_simulate.tsx b/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_simulate.tsx index b9fce52b480ef..fa0b9b0a2566f 100644 --- a/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_simulate.tsx +++ b/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/json_watch_edit_simulate.tsx @@ -40,7 +40,7 @@ import { JsonWatchEditSimulateResults } from './json_watch_edit_simulate_results import { getTimeUnitLabel } from '../../../../lib/get_time_unit_label'; import { useAppContext } from '../../../../app_context'; -import { useXJsonMode } from './use_x_json_mode'; +import { useXJsonMode } from '../../../../shared_imports'; const actionModeOptions = Object.keys(ACTION_MODES).map(mode => ({ text: ACTION_MODES[mode], diff --git a/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/use_x_json_mode.ts b/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/use_x_json_mode.ts deleted file mode 100644 index 7aefb0554e0e8..0000000000000 --- a/x-pack/plugins/watcher/public/application/sections/watch_edit/components/json_watch_edit/use_x_json_mode.ts +++ /dev/null @@ -1,24 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import { useState } from 'react'; -import { XJsonMode } from '../../../../../../../es_ui_shared/console_lang'; -import { - collapseLiteralStrings, - expandLiteralStrings, -} from '../../../../../../../../../src/plugins/es_ui_shared/console_lang/lib'; - -export const xJsonMode = new XJsonMode(); - -export const useXJsonMode = (json: string) => { - const [xJson, setXJson] = useState(expandLiteralStrings(json)); - - return { - xJson, - setXJson, - xJsonMode, - convertToJson: collapseLiteralStrings, - }; -}; diff --git a/x-pack/plugins/watcher/public/application/shared_imports.ts b/x-pack/plugins/watcher/public/application/shared_imports.ts index cbc4dde7448ff..94ef7af1c28d1 100644 --- a/x-pack/plugins/watcher/public/application/shared_imports.ts +++ b/x-pack/plugins/watcher/public/application/shared_imports.ts @@ -11,3 +11,5 @@ export { sendRequest, useRequest, } from '../../../../../src/plugins/es_ui_shared/public/request/np_ready_request'; + +export { useXJsonMode } from '../../../../../src/plugins/es_ui_shared/static/ace_x_json/hooks'; From 77d22f55d9d952ed0d3b6ed6da25def23fcea4f0 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cau=C3=AA=20Marcondes?= <55978943+cauemarcondes@users.noreply.github.com> Date: Fri, 10 Apr 2020 13:54:48 +0100 Subject: [PATCH 028/102] [APM] Agent config select box doesn't work on IE (#63236) * adding value property to select options * fixing test --- .../SettingsPage/SettingFormRow.tsx | 7 +++++-- .../setting_definitions/__snapshots__/index.test.ts.snap | 4 ++++ .../setting_definitions/general_settings.ts | 8 ++++---- .../agent_configuration/setting_definitions/types.d.ts | 2 +- 4 files changed, 14 insertions(+), 7 deletions(-) diff --git a/x-pack/legacy/plugins/apm/public/components/app/Settings/AgentConfigurations/AgentConfigurationCreateEdit/SettingsPage/SettingFormRow.tsx b/x-pack/legacy/plugins/apm/public/components/app/Settings/AgentConfigurations/AgentConfigurationCreateEdit/SettingsPage/SettingFormRow.tsx index 30c772bf5f634..baab600145b81 100644 --- a/x-pack/legacy/plugins/apm/public/components/app/Settings/AgentConfigurations/AgentConfigurationCreateEdit/SettingsPage/SettingFormRow.tsx +++ b/x-pack/legacy/plugins/apm/public/components/app/Settings/AgentConfigurations/AgentConfigurationCreateEdit/SettingsPage/SettingFormRow.tsx @@ -73,7 +73,10 @@ function FormRow({ return ( onChange(setting.key, e.target.value)} /> @@ -105,7 +108,7 @@ function FormRow({ defaultMessage: 'Select unit' })} value={unit} - options={setting.units?.map(text => ({ text }))} + options={setting.units?.map(text => ({ text, value: text }))} onChange={e => onChange( setting.key, diff --git a/x-pack/plugins/apm/common/agent_configuration/setting_definitions/__snapshots__/index.test.ts.snap b/x-pack/plugins/apm/common/agent_configuration/setting_definitions/__snapshots__/index.test.ts.snap index 49840d2157af7..ea706be9f584a 100644 --- a/x-pack/plugins/apm/common/agent_configuration/setting_definitions/__snapshots__/index.test.ts.snap +++ b/x-pack/plugins/apm/common/agent_configuration/setting_definitions/__snapshots__/index.test.ts.snap @@ -29,15 +29,19 @@ Array [ "options": Array [ Object { "text": "off", + "value": "off", }, Object { "text": "errors", + "value": "errors", }, Object { "text": "transactions", + "value": "transactions", }, Object { "text": "all", + "value": "all", }, ], "type": "select", diff --git a/x-pack/plugins/apm/common/agent_configuration/setting_definitions/general_settings.ts b/x-pack/plugins/apm/common/agent_configuration/setting_definitions/general_settings.ts index e73aed35e87f9..7477238ba79ae 100644 --- a/x-pack/plugins/apm/common/agent_configuration/setting_definitions/general_settings.ts +++ b/x-pack/plugins/apm/common/agent_configuration/setting_definitions/general_settings.ts @@ -67,10 +67,10 @@ export const generalSettings: RawSettingDefinition[] = [ } ), options: [ - { text: 'off' }, - { text: 'errors' }, - { text: 'transactions' }, - { text: 'all' } + { text: 'off', value: 'off' }, + { text: 'errors', value: 'errors' }, + { text: 'transactions', value: 'transactions' }, + { text: 'all', value: 'all' } ], excludeAgents: ['js-base', 'rum-js'] }, diff --git a/x-pack/plugins/apm/common/agent_configuration/setting_definitions/types.d.ts b/x-pack/plugins/apm/common/agent_configuration/setting_definitions/types.d.ts index 282ced346dda0..815b8cb3d4e83 100644 --- a/x-pack/plugins/apm/common/agent_configuration/setting_definitions/types.d.ts +++ b/x-pack/plugins/apm/common/agent_configuration/setting_definitions/types.d.ts @@ -76,7 +76,7 @@ interface FloatSetting extends BaseSetting { interface SelectSetting extends BaseSetting { type: 'select'; - options: Array<{ text: string }>; + options: Array<{ text: string; value: string }>; } interface BooleanSetting extends BaseSetting { From e8491adbab145590e877e5af9b1efa009400bf46 Mon Sep 17 00:00:00 2001 From: Nathan L Smith Date: Fri, 10 Apr 2020 09:04:17 -0500 Subject: [PATCH 029/102] Use globe icon for "ext" span type on service map (#63205) Both "external" and "ext" can be returned and should have the same icon. --- .../apm/public/components/app/ServiceMap/Cytoscape.stories.tsx | 1 + .../legacy/plugins/apm/public/components/app/ServiceMap/icons.ts | 1 + 2 files changed, 2 insertions(+) diff --git a/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/Cytoscape.stories.tsx b/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/Cytoscape.stories.tsx index a8d3b843a1f3d..31c227d8bbcab 100644 --- a/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/Cytoscape.stories.tsx +++ b/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/Cytoscape.stories.tsx @@ -85,6 +85,7 @@ storiesOf('app/ServiceMap/Cytoscape', module) } }, { data: { id: 'external', 'span.type': 'external' } }, + { data: { id: 'ext', 'span.type': 'ext' } }, { data: { id: 'messaging', 'span.type': 'messaging' } }, { data: { diff --git a/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/icons.ts b/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/icons.ts index dd9b48d312725..095c2d9250e27 100644 --- a/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/icons.ts +++ b/x-pack/legacy/plugins/apm/public/components/app/ServiceMap/icons.ts @@ -32,6 +32,7 @@ export const defaultIcon = defaultIconImport; const icons: { [key: string]: string } = { cache: databaseIcon, db: databaseIcon, + ext: globeIcon, external: globeIcon, messaging: documentsIcon, resource: globeIcon From ed975d0169e6728db9d8c5cf98ca655293217192 Mon Sep 17 00:00:00 2001 From: DianaDerevyankina <54894989+DianaDerevyankina@users.noreply.github.com> Date: Fri, 10 Apr 2020 17:59:50 +0300 Subject: [PATCH 030/102] Move shared vislib components into Charts plugin (#62957) * Closes #56310 Move shared vislib components into Charts plugin * Fixed imports in tests * Changed i18n IDs to match charts namespace * Renamed ColorSchemaVislibParams to ColorSchemaParams, added enums and got rid of useValidation function * Renamed ColorSchemaVislibParams to ColorSchemaParams and got rid of useValidation function * Fixed merge conflict * Replaced enums with objects again --- .../public/components/region_map_options.tsx | 6 ++- .../public/components/tile_map_options.tsx | 2 +- .../components/wms_internal_options.tsx | 2 +- .../public/components/wms_options.tsx | 2 +- .../public/settings_options.tsx | 2 +- .../public/components/metric_vis_options.tsx | 4 +- .../vis_type_metric/public/metric_vis_fn.ts | 3 +- .../vis_type_metric/public/metric_vis_type.ts | 3 +- .../vis_type_metric/public/types.ts | 3 +- .../public/components/table_vis_options.tsx | 6 ++- .../public/components/tag_cloud_options.tsx | 2 +- .../vis_type_vislib/public/area.ts | 2 +- .../public/components/common/index.ts | 8 ---- .../components/options/gauge/labels_panel.tsx | 2 +- .../components/options/gauge/ranges_panel.tsx | 14 +++--- .../components/options/gauge/style_panel.tsx | 2 +- .../components/options/heatmap/index.tsx | 6 +-- .../options/heatmap/labels_panel.tsx | 2 +- .../metrics_axes/category_axis_panel.tsx | 2 +- .../options/metrics_axes/chart_options.tsx | 2 +- .../metrics_axes/custom_extents_options.tsx | 2 +- .../options/metrics_axes/label_options.tsx | 3 +- .../metrics_axes/line_options.test.tsx | 2 +- .../options/metrics_axes/line_options.tsx | 6 ++- .../components/options/metrics_axes/mocks.ts | 3 +- .../metrics_axes/value_axis_options.test.tsx | 2 +- .../metrics_axes/value_axis_options.tsx | 6 ++- .../options/metrics_axes/y_extents.test.tsx | 2 +- .../options/metrics_axes/y_extents.tsx | 2 +- .../public/components/options/pie.tsx | 3 +- .../options/point_series/grid_panel.tsx | 2 +- .../options/point_series/point_series.tsx | 3 +- .../options/point_series/threshold_panel.tsx | 12 ++++-- .../vis_type_vislib/public/gauge.ts | 13 ++++-- .../vis_type_vislib/public/goal.ts | 4 +- .../vis_type_vislib/public/heatmap.ts | 6 +-- .../vis_type_vislib/public/histogram.ts | 2 +- .../vis_type_vislib/public/horizontal_bar.ts | 2 +- .../vis_type_vislib/public/index.ts | 14 ------ .../vis_type_vislib/public/line.ts | 2 +- .../vis_type_vislib/public/types.ts | 25 +---------- .../public/utils/collections.ts | 16 +------ .../static/components}/basic_options.tsx | 4 +- .../public/static/components/collections.ts} | 26 +++++------ .../static/components}/color_ranges.tsx | 7 +-- .../static/components}/color_schema.tsx | 18 ++++---- .../charts/public/static/components/index.ts | 30 +++++++++++++ .../static/components}/number_input.tsx | 0 .../public/static/components}/range.tsx | 2 +- .../components}/required_number_input.tsx | 14 +++--- .../public/static/components}/select.tsx | 0 .../public/static/components}/switch.tsx | 0 .../public/static/components}/text_input.tsx | 0 .../charts/public/static/components/types.ts | 43 +++++++++++++++++++ src/plugins/charts/public/static/index.ts | 1 + .../translations/translations/ja-JP.json | 16 +++---- .../translations/translations/zh-CN.json | 16 +++---- 57 files changed, 215 insertions(+), 169 deletions(-) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/basic_options.tsx (90%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common/utils.ts => plugins/charts/public/static/components/collections.ts} (67%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/color_ranges.tsx (93%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/color_schema.tsx (82%) create mode 100644 src/plugins/charts/public/static/components/index.ts rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/number_input.tsx (100%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/range.tsx (96%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/required_number_input.tsx (87%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/select.tsx (100%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/switch.tsx (100%) rename src/{legacy/core_plugins/vis_type_vislib/public/components/common => plugins/charts/public/static/components}/text_input.tsx (100%) create mode 100644 src/plugins/charts/public/static/components/types.ts diff --git a/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx b/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx index 61cfbf00ded9e..187b27953830d 100644 --- a/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx +++ b/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx @@ -24,7 +24,11 @@ import { FormattedMessage } from '@kbn/i18n/react'; import { FileLayerField, VectorLayer, ServiceSettings } from 'ui/vis/map/service_settings'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; -import { NumberInputOption, SelectOption, SwitchOption } from '../../../vis_type_vislib/public'; +import { + NumberInputOption, + SelectOption, + SwitchOption, +} from '../../../../../plugins/charts/public'; import { WmsOptions } from '../../../tile_map/public/components/wms_options'; import { RegionMapVisParams } from '../types'; diff --git a/src/legacy/core_plugins/tile_map/public/components/tile_map_options.tsx b/src/legacy/core_plugins/tile_map/public/components/tile_map_options.tsx index 9169647aa2aef..9ca42fe3e4074 100644 --- a/src/legacy/core_plugins/tile_map/public/components/tile_map_options.tsx +++ b/src/legacy/core_plugins/tile_map/public/components/tile_map_options.tsx @@ -27,7 +27,7 @@ import { RangeOption, SelectOption, SwitchOption, -} from '../../../vis_type_vislib/public'; +} from '../../../../../plugins/charts/public'; import { WmsOptions } from './wms_options'; import { TileMapVisParams } from '../types'; import { MapTypes } from '../map_types'; diff --git a/src/legacy/core_plugins/tile_map/public/components/wms_internal_options.tsx b/src/legacy/core_plugins/tile_map/public/components/wms_internal_options.tsx index b81667400303d..47f5b8f31e62b 100644 --- a/src/legacy/core_plugins/tile_map/public/components/wms_internal_options.tsx +++ b/src/legacy/core_plugins/tile_map/public/components/wms_internal_options.tsx @@ -21,7 +21,7 @@ import React from 'react'; import { EuiLink, EuiSpacer, EuiText, EuiScreenReaderOnly } from '@elastic/eui'; import { FormattedMessage } from '@kbn/i18n/react'; -import { TextInputOption } from '../../../vis_type_vislib/public'; +import { TextInputOption } from '../../../../../plugins/charts/public'; import { WMSOptions } from '../types'; interface WmsInternalOptions { diff --git a/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx b/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx index 27127b781cd4d..b8535e72e8818 100644 --- a/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx +++ b/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx @@ -25,7 +25,7 @@ import { FormattedMessage } from '@kbn/i18n/react'; import { TmsLayer } from 'ui/vis/map/service_settings'; import { Vis } from '../../../../../plugins/visualizations/public'; import { RegionMapVisParams } from '../../../region_map/public/types'; -import { SelectOption, SwitchOption } from '../../../vis_type_vislib/public'; +import { SelectOption, SwitchOption } from '../../../../../plugins/charts/public'; import { WmsInternalOptions } from './wms_internal_options'; import { WMSOptions, TileMapVisParams } from '../types'; diff --git a/src/legacy/core_plugins/vis_type_markdown/public/settings_options.tsx b/src/legacy/core_plugins/vis_type_markdown/public/settings_options.tsx index 552fd63373554..16b2749c34e10 100644 --- a/src/legacy/core_plugins/vis_type_markdown/public/settings_options.tsx +++ b/src/legacy/core_plugins/vis_type_markdown/public/settings_options.tsx @@ -22,7 +22,7 @@ import { EuiPanel } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; -import { RangeOption, SwitchOption } from '../../vis_type_vislib/public'; +import { RangeOption, SwitchOption } from '../../../../plugins/charts/public'; import { MarkdownVisParams } from './types'; function SettingsOptions({ stateParams, setValue }: VisOptionsProps) { diff --git a/src/legacy/core_plugins/vis_type_metric/public/components/metric_vis_options.tsx b/src/legacy/core_plugins/vis_type_metric/public/components/metric_vis_options.tsx index 5c3032511f09a..56af0ee91878f 100644 --- a/src/legacy/core_plugins/vis_type_metric/public/components/metric_vis_options.tsx +++ b/src/legacy/core_plugins/vis_type_metric/public/components/metric_vis_options.tsx @@ -37,9 +37,9 @@ import { SwitchOption, RangeOption, SetColorSchemaOptionsValue, -} from '../../../vis_type_vislib/public'; + SetColorRangeValue, +} from '../../../../../plugins/charts/public'; import { MetricVisParam, VisParams } from '../types'; -import { SetColorRangeValue } from '../../../vis_type_vislib/public/components/common/color_ranges'; function MetricVisOptions({ stateParams, diff --git a/src/legacy/core_plugins/vis_type_metric/public/metric_vis_fn.ts b/src/legacy/core_plugins/vis_type_metric/public/metric_vis_fn.ts index 03b412c6fff15..52784da1bd73b 100644 --- a/src/legacy/core_plugins/vis_type_metric/public/metric_vis_fn.ts +++ b/src/legacy/core_plugins/vis_type_metric/public/metric_vis_fn.ts @@ -26,9 +26,8 @@ import { Render, Style, } from '../../../../plugins/expressions/public'; -import { ColorModes } from '../../vis_type_vislib/public'; import { visType, DimensionsVisParam, VisParams } from './types'; -import { ColorSchemas, vislibColorMaps } from '../../../../plugins/charts/public'; +import { ColorSchemas, vislibColorMaps, ColorModes } from '../../../../plugins/charts/public'; export type Input = KibanaDatatable; diff --git a/src/legacy/core_plugins/vis_type_metric/public/metric_vis_type.ts b/src/legacy/core_plugins/vis_type_metric/public/metric_vis_type.ts index 3bbb8964122e5..ab31c56921412 100644 --- a/src/legacy/core_plugins/vis_type_metric/public/metric_vis_type.ts +++ b/src/legacy/core_plugins/vis_type_metric/public/metric_vis_type.ts @@ -21,8 +21,7 @@ import { i18n } from '@kbn/i18n'; import { MetricVisComponent } from './components/metric_vis_component'; import { MetricVisOptions } from './components/metric_vis_options'; -import { ColorModes } from '../../vis_type_vislib/public'; -import { ColorSchemas, colorSchemas } from '../../../../plugins/charts/public'; +import { ColorSchemas, colorSchemas, ColorModes } from '../../../../plugins/charts/public'; import { AggGroupNames } from '../../../../plugins/data/public'; import { Schemas } from '../../../../plugins/vis_default_editor/public'; diff --git a/src/legacy/core_plugins/vis_type_metric/public/types.ts b/src/legacy/core_plugins/vis_type_metric/public/types.ts index cae18dd8a2ab1..cdf62cba934d7 100644 --- a/src/legacy/core_plugins/vis_type_metric/public/types.ts +++ b/src/legacy/core_plugins/vis_type_metric/public/types.ts @@ -19,8 +19,7 @@ import { Range } from '../../../../plugins/expressions/public'; import { SchemaConfig } from '../../../../plugins/visualizations/public'; -import { ColorModes, Labels, Style } from '../../vis_type_vislib/public'; -import { ColorSchemas } from '../../../../plugins/charts/public'; +import { ColorModes, ColorSchemas, Labels, Style } from '../../../../plugins/charts/public'; export const visType = 'metric'; diff --git a/src/legacy/core_plugins/vis_type_table/public/components/table_vis_options.tsx b/src/legacy/core_plugins/vis_type_table/public/components/table_vis_options.tsx index d01ab31e0a843..265528f33f9cd 100644 --- a/src/legacy/core_plugins/vis_type_table/public/components/table_vis_options.tsx +++ b/src/legacy/core_plugins/vis_type_table/public/components/table_vis_options.tsx @@ -25,7 +25,11 @@ import { FormattedMessage } from '@kbn/i18n/react'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; import { search } from '../../../../../plugins/data/public'; -import { NumberInputOption, SwitchOption, SelectOption } from '../../../vis_type_vislib/public'; +import { + SwitchOption, + SelectOption, + NumberInputOption, +} from '../../../../../plugins/charts/public'; import { TableVisParams } from '../types'; import { totalAggregations } from './utils'; diff --git a/src/legacy/core_plugins/vis_type_tagcloud/public/components/tag_cloud_options.tsx b/src/legacy/core_plugins/vis_type_tagcloud/public/components/tag_cloud_options.tsx index 80e4e1de7ddab..7a64549edd747 100644 --- a/src/legacy/core_plugins/vis_type_tagcloud/public/components/tag_cloud_options.tsx +++ b/src/legacy/core_plugins/vis_type_tagcloud/public/components/tag_cloud_options.tsx @@ -22,7 +22,7 @@ import { EuiPanel } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; import { ValidatedDualRange } from '../../../../../../src/plugins/kibana_react/public'; -import { SelectOption, SwitchOption } from '../../../vis_type_vislib/public'; +import { SelectOption, SwitchOption } from '../../../../../plugins/charts/public'; import { TagCloudVisParams } from '../types'; function TagCloudOptions({ stateParams, setValue, vis }: VisOptionsProps) { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/area.ts b/src/legacy/core_plugins/vis_type_vislib/public/area.ts index 68decacaaa040..8a196da64fc4b 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/area.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/area.ts @@ -33,13 +33,13 @@ import { AxisTypes, ScaleTypes, AxisModes, - Rotates, ThresholdLineStyles, getConfigCollections, } from './utils/collections'; import { getAreaOptionTabs, countLabel } from './utils/common_config'; import { createVislibVisController } from './vis_controller'; import { VisTypeVislibDependencies } from './plugin'; +import { Rotates } from '../../../../plugins/charts/public'; export const createAreaVisTypeDefinition = (deps: VisTypeVislibDependencies) => ({ name: 'area', diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/index.ts b/src/legacy/core_plugins/vis_type_vislib/public/components/common/index.ts index 05972d101f576..f0bec3167cb7c 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/common/index.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/common/index.ts @@ -17,13 +17,5 @@ * under the License. */ -export { BasicOptions } from './basic_options'; -export { ColorRanges } from './color_ranges'; -export { ColorSchemaOptions, SetColorSchemaOptionsValue } from './color_schema'; -export { NumberInputOption } from './number_input'; -export { RangeOption } from './range'; -export { SelectOption } from './select'; -export { SwitchOption } from './switch'; -export { TextInputOption } from './text_input'; export { TruncateLabelsOption } from './truncate_labels'; export { ValidationWrapper, ValidationVisOptionsProps } from './validation_wrapper'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/labels_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/labels_panel.tsx index b9bae1cad35e7..3fca9dc8adc08 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/labels_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/labels_panel.tsx @@ -22,7 +22,7 @@ import { EuiPanel, EuiSpacer, EuiTitle } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { SwitchOption, TextInputOption } from '../../common'; +import { SwitchOption, TextInputOption } from '../../../../../../../plugins/charts/public'; import { GaugeOptionsInternalProps } from '.'; function LabelsPanel({ stateParams, setValue, setGaugeValue }: GaugeOptionsInternalProps) { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/ranges_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/ranges_panel.tsx index 7de64e5888096..433cc4edeb47b 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/ranges_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/ranges_panel.tsx @@ -22,12 +22,16 @@ import { EuiPanel, EuiSpacer, EuiTitle } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { ColorRanges, ColorSchemaOptions, SwitchOption } from '../../common'; +import { + ColorRanges, + ColorSchemaOptions, + ColorSchemaParams, + SetColorRangeValue, + SwitchOption, + ColorSchemas, +} from '../../../../../../../plugins/charts/public'; import { GaugeOptionsInternalProps } from '.'; -import { ColorSchemaVislibParams } from '../../../types'; import { Gauge } from '../../../gauge'; -import { SetColorRangeValue } from '../../common/color_ranges'; -import { ColorSchemas } from '../../../../../../../plugins/charts/public'; function RangesPanel({ setGaugeValue, @@ -39,7 +43,7 @@ function RangesPanel({ vis, }: GaugeOptionsInternalProps) { const setColorSchemaOptions = useCallback( - (paramName: T, value: ColorSchemaVislibParams[T]) => { + (paramName: T, value: ColorSchemaParams[T]) => { setGaugeValue(paramName, value as Gauge[T]); // set outline if color schema is changed to greys // if outline wasn't set explicitly yet diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/style_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/style_panel.tsx index 9254c3c18347c..48711de7d171a 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/style_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/gauge/style_panel.tsx @@ -22,7 +22,7 @@ import { EuiPanel, EuiSpacer, EuiTitle } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { SelectOption } from '../../common'; +import { SelectOption } from '../../../../../../../plugins/charts/public'; import { GaugeOptionsInternalProps } from '.'; import { AggGroupNames } from '../../../../../../../plugins/data/public'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/index.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/index.tsx index 715b5902b69da..dc207ad89286f 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/index.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/index.tsx @@ -31,12 +31,12 @@ import { NumberInputOption, SelectOption, SwitchOption, -} from '../../common'; -import { SetColorSchemaOptionsValue } from '../../common/color_schema'; + SetColorSchemaOptionsValue, + SetColorRangeValue, +} from '../../../../../../../plugins/charts/public'; import { HeatmapVisParams } from '../../../heatmap'; import { ValueAxis } from '../../../types'; import { LabelsPanel } from './labels_panel'; -import { SetColorRangeValue } from '../../common/color_ranges'; function HeatmapOptions(props: VisOptionsProps) { const { stateParams, vis, uiState, setValue, setValidity, setTouched } = props; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/labels_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/labels_panel.tsx index 38811bd836459..3d1629740df2c 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/labels_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/heatmap/labels_panel.tsx @@ -26,7 +26,7 @@ import { FormattedMessage } from '@kbn/i18n/react'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; import { ValueAxis } from '../../../types'; import { HeatmapVisParams } from '../../../heatmap'; -import { SwitchOption } from '../../common'; +import { SwitchOption } from '../../../../../../../plugins/charts/public'; const VERTICAL_ROTATION = 270; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/category_axis_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/category_axis_panel.tsx index 915885388640c..246c20a14807c 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/category_axis_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/category_axis_panel.tsx @@ -25,7 +25,7 @@ import { FormattedMessage } from '@kbn/i18n/react'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; import { Axis } from '../../../types'; -import { SelectOption, SwitchOption } from '../../common'; +import { SelectOption, SwitchOption } from '../../../../../../../plugins/charts/public'; import { LabelOptions, SetAxisLabel } from './label_options'; import { Positions } from '../../../utils/collections'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/chart_options.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/chart_options.tsx index ec7a325ba43d1..89aab3a19c589 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/chart_options.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/chart_options.tsx @@ -25,7 +25,7 @@ import { EuiFlexGroup, EuiFlexItem, EuiSpacer } from '@elastic/eui'; import { Vis } from '../../../../../../../plugins/visualizations/public'; import { SeriesParam, ValueAxis } from '../../../types'; import { ChartTypes } from '../../../utils/collections'; -import { SelectOption } from '../../common'; +import { SelectOption } from '../../../../../../../plugins/charts/public'; import { LineOptions } from './line_options'; import { SetParamByIndex, ChangeValueAxis } from './'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/custom_extents_options.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/custom_extents_options.tsx index 53b2ffa55a941..a3a97df9e35ae 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/custom_extents_options.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/custom_extents_options.tsx @@ -21,7 +21,7 @@ import React, { useCallback, useEffect } from 'react'; import { i18n } from '@kbn/i18n'; import { ValueAxis } from '../../../types'; -import { NumberInputOption, SwitchOption } from '../../common'; +import { NumberInputOption, SwitchOption } from '../../../../../../../plugins/charts/public'; import { YExtents } from './y_extents'; import { SetScale } from './value_axis_options'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/label_options.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/label_options.tsx index b6b54193e9f4a..bc687e56646f6 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/label_options.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/label_options.tsx @@ -24,8 +24,9 @@ import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; import { Axis } from '../../../types'; -import { SelectOption, SwitchOption, TruncateLabelsOption } from '../../common'; +import { TruncateLabelsOption } from '../../common'; import { getRotateOptions } from '../../../utils/collections'; +import { SelectOption, SwitchOption } from '../../../../../../../plugins/charts/public'; export type SetAxisLabel = ( paramName: T, diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.test.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.test.tsx index 1d29d39bfcb7f..5354bc9c033e6 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.test.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.test.tsx @@ -20,7 +20,7 @@ import React from 'react'; import { shallow } from 'enzyme'; import { LineOptions, LineOptionsParams } from './line_options'; -import { NumberInputOption } from '../../common'; +import { NumberInputOption } from '../../../../../../../plugins/charts/public'; import { seriesParam, vis } from './mocks'; jest.mock('ui/new_platform'); diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.tsx index 01a69a6fac70b..76f95bd93caf8 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/line_options.tsx @@ -24,7 +24,11 @@ import { EuiFlexGroup, EuiFlexItem, EuiSpacer } from '@elastic/eui'; import { Vis } from '../../../../../../../plugins/visualizations/public'; import { SeriesParam } from '../../../types'; -import { NumberInputOption, SelectOption, SwitchOption } from '../../common'; +import { + NumberInputOption, + SelectOption, + SwitchOption, +} from '../../../../../../../plugins/charts/public'; import { SetChart } from './chart_options'; export interface LineOptionsParams { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/mocks.ts b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/mocks.ts index 0d9fa8c25a4f7..a296281375dac 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/mocks.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/mocks.ts @@ -18,7 +18,7 @@ */ import { Vis } from '../../../../../../../plugins/visualizations/public'; -import { Axis, ValueAxis, SeriesParam, Style } from '../../../types'; +import { Axis, ValueAxis, SeriesParam } from '../../../types'; import { ChartTypes, ChartModes, @@ -31,6 +31,7 @@ import { getPositions, getInterpolationModes, } from '../../../utils/collections'; +import { Style } from '../../../../../../../plugins/charts/public'; const defaultValueAxisId = 'ValueAxis-1'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.test.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.test.tsx index 955867e66d09f..876a6917ee0b4 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.test.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.test.tsx @@ -21,7 +21,7 @@ import React from 'react'; import { shallow } from 'enzyme'; import { ValueAxisOptions, ValueAxisOptionsParams } from './value_axis_options'; import { ValueAxis } from '../../../types'; -import { TextInputOption } from '../../common'; +import { TextInputOption } from '../../../../../../../plugins/charts/public'; import { LabelOptions } from './label_options'; import { ScaleTypes, Positions } from '../../../utils/collections'; import { valueAxis, vis } from './mocks'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.tsx index 8f0327e78c7ab..1b89a766d0591 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/value_axis_options.tsx @@ -24,7 +24,11 @@ import { EuiSpacer, EuiAccordion, EuiHorizontalRule } from '@elastic/eui'; import { Vis } from '../../../../../../../plugins/visualizations/public'; import { ValueAxis } from '../../../types'; import { Positions } from '../../../utils/collections'; -import { SelectOption, SwitchOption, TextInputOption } from '../../common'; +import { + SelectOption, + SwitchOption, + TextInputOption, +} from '../../../../../../../plugins/charts/public'; import { LabelOptions, SetAxisLabel } from './label_options'; import { CustomExtentsOptions } from './custom_extents_options'; import { isAxisHorizontal } from './utils'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.test.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.test.tsx index 17c47b35b20dc..b5ed475ca8e31 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.test.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.test.tsx @@ -21,7 +21,7 @@ import React from 'react'; import { mount, shallow } from 'enzyme'; import { YExtents, YExtentsProps } from './y_extents'; import { ScaleTypes } from '../../../utils/collections'; -import { NumberInputOption } from '../../common'; +import { NumberInputOption } from '../../../../../../../plugins/charts/public'; jest.mock('ui/new_platform'); diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.tsx index c0db58a612e71..faeb6069b5126 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/metrics_axes/y_extents.tsx @@ -23,7 +23,7 @@ import { i18n } from '@kbn/i18n'; import { Scale } from '../../../types'; import { ScaleTypes } from '../../../utils/collections'; -import { NumberInputOption } from '../../common'; +import { NumberInputOption } from '../../../../../../../plugins/charts/public'; import { SetScale } from './value_axis_options'; const rangeError = i18n.translate('visTypeVislib.controls.pointSeries.valueAxes.minErrorMessage', { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/pie.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/pie.tsx index 4c0be456aad64..f6be9cd0bd8fe 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/pie.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/pie.tsx @@ -23,7 +23,8 @@ import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; -import { BasicOptions, TruncateLabelsOption, SwitchOption } from '../common'; +import { TruncateLabelsOption } from '../common'; +import { BasicOptions, SwitchOption } from '../../../../../../plugins/charts/public'; import { PieVisParams } from '../../pie'; function PieOptions(props: VisOptionsProps) { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/grid_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/grid_panel.tsx index bb2b3f8fddb49..392d180d2c5f2 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/grid_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/grid_panel.tsx @@ -23,7 +23,7 @@ import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; -import { SelectOption, SwitchOption } from '../../common'; +import { SelectOption, SwitchOption } from '../../../../../../../plugins/charts/public'; import { BasicVislibParams, ValueAxis } from '../../../types'; function GridPanel({ stateParams, setValue, hasHistogramAgg }: VisOptionsProps) { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/point_series.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/point_series.tsx index b9872ab94bd0b..903c1917751d9 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/point_series.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/point_series.tsx @@ -21,7 +21,8 @@ import { EuiPanel, EuiTitle, EuiSpacer } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { BasicOptions, SwitchOption, ValidationVisOptionsProps } from '../../common'; +import { ValidationVisOptionsProps } from '../../common'; +import { BasicOptions, SwitchOption } from '../../../../../../../plugins/charts/public'; import { GridPanel } from './grid_panel'; import { ThresholdPanel } from './threshold_panel'; import { BasicVislibParams } from '../../../types'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/threshold_panel.tsx b/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/threshold_panel.tsx index 7866ad74ede7f..12f058ec7dd1f 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/threshold_panel.tsx +++ b/src/legacy/core_plugins/vis_type_vislib/public/components/options/point_series/threshold_panel.tsx @@ -21,8 +21,12 @@ import { EuiPanel, EuiTitle, EuiColorPicker, EuiFormRow, EuiSpacer } from '@elas import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { SelectOption, SwitchOption, ValidationVisOptionsProps } from '../../common'; -import { NumberInputOption } from '../../common/required_number_input'; +import { ValidationVisOptionsProps } from '../../common'; +import { + SelectOption, + SwitchOption, + RequiredNumberInputOption, +} from '../../../../../../../plugins/charts/public'; import { BasicVislibParams } from '../../../types'; function ThresholdPanel({ @@ -73,7 +77,7 @@ function ThresholdPanel({ {stateParams.thresholdLine.show && ( <> - - ({ name: 'histogram', diff --git a/src/legacy/core_plugins/vis_type_vislib/public/horizontal_bar.ts b/src/legacy/core_plugins/vis_type_vislib/public/horizontal_bar.ts index dc47252ccd44f..6f73271726660 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/horizontal_bar.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/horizontal_bar.ts @@ -32,13 +32,13 @@ import { AxisTypes, ScaleTypes, AxisModes, - Rotates, ThresholdLineStyles, getConfigCollections, } from './utils/collections'; import { getAreaOptionTabs, countLabel } from './utils/common_config'; import { createVislibVisController } from './vis_controller'; import { VisTypeVislibDependencies } from './plugin'; +import { Rotates } from '../../../../plugins/charts/public'; export const createHorizontalBarVisTypeDefinition = (deps: VisTypeVislibDependencies) => ({ name: 'horizontal_bar', diff --git a/src/legacy/core_plugins/vis_type_vislib/public/index.ts b/src/legacy/core_plugins/vis_type_vislib/public/index.ts index 1f773c4efcb02..4d7091ffb204b 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/index.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/index.ts @@ -24,18 +24,4 @@ export function plugin(initializerContext: PluginInitializerContext) { return new Plugin(initializerContext); } -export { - BasicOptions, - RangeOption, - ColorRanges, - SelectOption, - SetColorSchemaOptionsValue, - ColorSchemaOptions, - NumberInputOption, - SwitchOption, - TextInputOption, -} from './components'; - -export { ColorModes } from './utils/collections'; - export * from './types'; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/line.ts b/src/legacy/core_plugins/vis_type_vislib/public/line.ts index 885ab295d11e1..1f9a8d77398e6 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/line.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/line.ts @@ -32,7 +32,6 @@ import { AxisTypes, ScaleTypes, AxisModes, - Rotates, ThresholdLineStyles, InterpolationModes, getConfigCollections, @@ -40,6 +39,7 @@ import { import { getAreaOptionTabs, countLabel } from './utils/common_config'; import { createVislibVisController } from './vis_controller'; import { VisTypeVislibDependencies } from './plugin'; +import { Rotates } from '../../../../plugins/charts/public'; export const createLineVisTypeDefinition = (deps: VisTypeVislibDependencies) => ({ name: 'line', diff --git a/src/legacy/core_plugins/vis_type_vislib/public/types.ts b/src/legacy/core_plugins/vis_type_vislib/public/types.ts index f33b42483c53e..25c6ae5439fe8 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/types.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/types.ts @@ -25,39 +25,16 @@ import { AxisModes, AxisTypes, InterpolationModes, - Rotates, ScaleTypes, ThresholdLineStyles, } from './utils/collections'; -import { ColorSchemas } from '../../../../plugins/charts/public'; +import { Labels, Style } from '../../../../plugins/charts/public'; export interface CommonVislibParams { addTooltip: boolean; legendPosition: Positions; } -export interface ColorSchemaVislibParams { - colorSchema: ColorSchemas; - invertColors: boolean; -} - -export interface Labels { - color?: string; - filter?: boolean; - overwriteColor?: boolean; - rotate?: Rotates; - show: boolean; - truncate?: number | null; -} - -export interface Style { - bgFill: string; - bgColor: boolean; - labelColor: boolean; - subText: string; - fontSize: number; -} - export interface Scale { boundsMargin?: number | ''; defaultYExtents?: boolean; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/utils/collections.ts b/src/legacy/core_plugins/vis_type_vislib/public/utils/collections.ts index f32b765cd6e57..2024c43dd1c8b 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/utils/collections.ts +++ b/src/legacy/core_plugins/vis_type_vislib/public/utils/collections.ts @@ -20,7 +20,7 @@ import { i18n } from '@kbn/i18n'; import { $Values } from '@kbn/utility-types'; -import { colorSchemas } from '../../../../../plugins/charts/public'; +import { colorSchemas, Rotates } from '../../../../../plugins/charts/public'; export const Positions = Object.freeze({ RIGHT: 'right' as 'right', @@ -203,13 +203,6 @@ const getAxisModes = () => [ }, ]; -export const Rotates = Object.freeze({ - HORIZONTAL: 0, - VERTICAL: 90, - ANGLED: 75, -}); -export type Rotates = $Values; - export const ThresholdLineStyles = Object.freeze({ FULL: 'full' as 'full', DASHED: 'dashed' as 'dashed', @@ -265,13 +258,6 @@ export const GaugeTypes = Object.freeze({ }); export type GaugeTypes = $Values; -export const ColorModes = Object.freeze({ - BACKGROUND: 'Background' as 'Background', - LABELS: 'Labels' as 'Labels', - NONE: 'None' as 'None', -}); -export type ColorModes = $Values; - const getGaugeTypes = () => [ { text: i18n.translate('visTypeVislib.gauge.gaugeTypes.arcText', { diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/basic_options.tsx b/src/plugins/charts/public/static/components/basic_options.tsx similarity index 90% rename from src/legacy/core_plugins/vis_type_vislib/public/components/common/basic_options.tsx rename to src/plugins/charts/public/static/components/basic_options.tsx index baf3e8ecd1b28..cac4c8d70d796 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/common/basic_options.tsx +++ b/src/plugins/charts/public/static/components/basic_options.tsx @@ -37,7 +37,7 @@ function BasicOptions({ return ( <> ({ setValue={setValue} /> ( - setValidity: (paramName: ParamName, isValid: boolean) => void, - paramName: ParamName, - isValid: boolean -) { - useEffect(() => { - setValidity(paramName, isValid); +export const ColorModes = Object.freeze({ + BACKGROUND: 'Background' as 'Background', + LABELS: 'Labels' as 'Labels', + NONE: 'None' as 'None', +}); +export type ColorModes = $Values; - return () => setValidity(paramName, true); - }, [isValid, paramName, setValidity]); -} - -export { useValidation }; +export const Rotates = Object.freeze({ + HORIZONTAL: 0, + VERTICAL: 90, + ANGLED: 75, +}); +export type Rotates = $Values; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/color_ranges.tsx b/src/plugins/charts/public/static/components/color_ranges.tsx similarity index 93% rename from src/legacy/core_plugins/vis_type_vislib/public/components/common/color_ranges.tsx rename to src/plugins/charts/public/static/components/color_ranges.tsx index 84c70f10b12da..a9b05d7d91c7c 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/common/color_ranges.tsx +++ b/src/plugins/charts/public/static/components/color_ranges.tsx @@ -22,10 +22,7 @@ import { last } from 'lodash'; import { i18n } from '@kbn/i18n'; -import { - RangeValues, - RangesParamEditor, -} from '../../../../../../plugins/vis_default_editor/public'; +import { RangeValues, RangesParamEditor } from '../../../../vis_default_editor/public'; export type SetColorRangeValue = (paramName: string, value: RangeValues[]) => void; @@ -74,7 +71,7 @@ function ColorRanges({ return ( ( +export type SetColorSchemaOptionsValue = ( paramName: T, - value: ColorSchemaVislibParams[T] + value: ColorSchemaParams[T] ) => void; -interface ColorSchemaOptionsProps extends ColorSchemaVislibParams { +interface ColorSchemaOptionsProps extends ColorSchemaParams { disabled?: boolean; colorSchemas: ColorSchema[]; uiState: VisOptionsProps['uiState']; @@ -67,7 +67,7 @@ function ColorSchemaOptions({ }} > @@ -80,11 +80,11 @@ function ColorSchemaOptions({ disabled={disabled} helpText={ showHelpText && - i18n.translate('visTypeVislib.controls.colorSchema.howToChangeColorsDescription', { + i18n.translate('charts.controls.colorSchema.howToChangeColorsDescription', { defaultMessage: 'Individual colors can be changed in the legend.', }) } - label={i18n.translate('visTypeVislib.controls.colorSchema.colorSchemaLabel', { + label={i18n.translate('charts.controls.colorSchema.colorSchemaLabel', { defaultMessage: 'Color schema', })} labelAppend={isCustomColors && resetColorsButton} @@ -96,7 +96,7 @@ function ColorSchemaOptions({ ({ const [stateValue, setStateValue] = useState(value); const [isValidState, setIsValidState] = useState(true); - const error = i18n.translate('visTypeVislib.controls.rangeErrorMessage', { + const error = i18n.translate('charts.controls.rangeErrorMessage', { defaultMessage: 'Values must be on or between {min} and {max}', values: { min, max }, }); diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/required_number_input.tsx b/src/plugins/charts/public/static/components/required_number_input.tsx similarity index 87% rename from src/legacy/core_plugins/vis_type_vislib/public/components/common/required_number_input.tsx rename to src/plugins/charts/public/static/components/required_number_input.tsx index 7b62016c4e502..7594c775b07ad 100644 --- a/src/legacy/core_plugins/vis_type_vislib/public/components/common/required_number_input.tsx +++ b/src/plugins/charts/public/static/components/required_number_input.tsx @@ -17,9 +17,8 @@ * under the License. */ -import React, { ReactNode, useCallback, ChangeEvent } from 'react'; +import React, { ReactNode, useCallback, ChangeEvent, useEffect } from 'react'; import { EuiFormRow, EuiFieldNumber } from '@elastic/eui'; -import { useValidation } from './utils'; interface NumberInputOptionProps { disabled?: boolean; @@ -42,7 +41,7 @@ interface NumberInputOptionProps { * * @param {number} props.value Should be numeric only */ -function NumberInputOption({ +function RequiredNumberInputOption({ disabled, error, isInvalid, @@ -57,7 +56,12 @@ function NumberInputOption({ 'data-test-subj': dataTestSubj, }: NumberInputOptionProps) { const isValid = value !== null; - useValidation(setValidity, paramName, isValid); + + useEffect(() => { + setValidity(paramName, isValid); + + return () => setValidity(paramName, true); + }, [isValid, paramName, setValidity]); const onChange = useCallback( (ev: ChangeEvent) => @@ -84,4 +88,4 @@ function NumberInputOption({ ); } -export { NumberInputOption }; +export { RequiredNumberInputOption }; diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/select.tsx b/src/plugins/charts/public/static/components/select.tsx similarity index 100% rename from src/legacy/core_plugins/vis_type_vislib/public/components/common/select.tsx rename to src/plugins/charts/public/static/components/select.tsx diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/switch.tsx b/src/plugins/charts/public/static/components/switch.tsx similarity index 100% rename from src/legacy/core_plugins/vis_type_vislib/public/components/common/switch.tsx rename to src/plugins/charts/public/static/components/switch.tsx diff --git a/src/legacy/core_plugins/vis_type_vislib/public/components/common/text_input.tsx b/src/plugins/charts/public/static/components/text_input.tsx similarity index 100% rename from src/legacy/core_plugins/vis_type_vislib/public/components/common/text_input.tsx rename to src/plugins/charts/public/static/components/text_input.tsx diff --git a/src/plugins/charts/public/static/components/types.ts b/src/plugins/charts/public/static/components/types.ts new file mode 100644 index 0000000000000..196eb60b06aec --- /dev/null +++ b/src/plugins/charts/public/static/components/types.ts @@ -0,0 +1,43 @@ +/* + * 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. + */ + +import { ColorSchemas } from '../color_maps'; +import { Rotates } from './collections'; + +export interface ColorSchemaParams { + colorSchema: ColorSchemas; + invertColors: boolean; +} + +export interface Labels { + color?: string; + filter?: boolean; + overwriteColor?: boolean; + rotate?: Rotates; + show: boolean; + truncate?: number | null; +} + +export interface Style { + bgFill: string; + bgColor: boolean; + labelColor: boolean; + subText: string; + fontSize: number; +} diff --git a/src/plugins/charts/public/static/index.ts b/src/plugins/charts/public/static/index.ts index bee58e4f1e3e1..6fc097d05467f 100644 --- a/src/plugins/charts/public/static/index.ts +++ b/src/plugins/charts/public/static/index.ts @@ -18,3 +18,4 @@ */ export * from './color_maps'; +export * from './components'; diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index c07ec68e99b4f..09903c34e2e5e 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -130,6 +130,14 @@ "charts.colormaps.greysText": "グレー", "charts.colormaps.redsText": "赤", "charts.colormaps.yellowToRedText": "黄色から赤", + "charts.controls.colorRanges.errorText": "各範囲は前の範囲よりも大きくなければなりません。", + "charts.controls.colorSchema.colorSchemaLabel": "配色", + "charts.controls.colorSchema.howToChangeColorsDescription": "それぞれの色は凡例で変更できます。", + "charts.controls.colorSchema.resetColorsButtonLabel": "色をリセット", + "charts.controls.colorSchema.reverseColorSchemaLabel": "図表を反転", + "charts.controls.rangeErrorMessage": "値は {min} と {max} の間でなければなりません", + "charts.controls.vislibBasicOptions.legendPositionLabel": "凡例位置", + "charts.controls.vislibBasicOptions.showTooltipLabel": "ツールヒントを表示", "common.ui.errorAutoCreateIndex.breadcrumbs.errorText": "エラー", "common.ui.errorAutoCreateIndex.errorDescription": "Elasticsearch クラスターの {autoCreateIndexActionConfig} 設定が原因で、Kibana が保存されたオブジェクトを格納するインデックスを自動的に作成できないようです。Kibana は、保存されたオブジェクトインデックスが適切なマッピング/スキーマを使用し Kibana から Elasticsearch へのポーリングの回数を減らすための最適な手段であるため、この Elasticsearch の機能を使用します。", "common.ui.errorAutoCreateIndex.errorDisclaimer": "申し訳ございませんが、この問題が解決されるまで Kibana で何も保存することができません。", @@ -3831,11 +3839,6 @@ "visTypeVislib.chartTypes.areaText": "エリア", "visTypeVislib.chartTypes.barText": "バー", "visTypeVislib.chartTypes.lineText": "折れ線", - "visTypeVislib.controls.colorRanges.errorText": "各範囲は前の範囲よりも大きくなければなりません。", - "visTypeVislib.controls.colorSchema.colorSchemaLabel": "配色", - "visTypeVislib.controls.colorSchema.howToChangeColorsDescription": "それぞれの色は凡例で変更できます。", - "visTypeVislib.controls.colorSchema.resetColorsButtonLabel": "色をリセット", - "visTypeVislib.controls.colorSchema.reverseColorSchemaLabel": "図表を反転", "visTypeVislib.controls.gaugeOptions.alignmentLabel": "アラインメント", "visTypeVislib.controls.gaugeOptions.autoExtendRangeLabel": "範囲を自動拡張", "visTypeVislib.controls.gaugeOptions.displayWarningsLabel": "警告を表示", @@ -3902,10 +3905,7 @@ "visTypeVislib.controls.pointSeries.valueAxes.toggleCustomExtendsAriaLabel": "カスタム範囲を切り替える", "visTypeVislib.controls.pointSeries.valueAxes.toggleOptionsAriaLabel": "{axisName} オプションを切り替える", "visTypeVislib.controls.pointSeries.valueAxes.yAxisTitle": "Y 軸", - "visTypeVislib.controls.rangeErrorMessage": "値は {min} と {max} の間でなければなりません", "visTypeVislib.controls.truncateLabel": "切り捨て", - "visTypeVislib.controls.vislibBasicOptions.legendPositionLabel": "凡例位置", - "visTypeVislib.controls.vislibBasicOptions.showTooltipLabel": "ツールヒントを表示", "visTypeVislib.editors.heatmap.basicSettingsTitle": "基本設定", "visTypeVislib.editors.heatmap.heatmapSettingsTitle": "ヒートマップ設定", "visTypeVislib.editors.heatmap.highlightLabel": "ハイライト範囲", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index de8aaa75632ee..cc1b7d7980a0b 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -130,6 +130,14 @@ "charts.colormaps.greysText": "灰色", "charts.colormaps.redsText": "红色", "charts.colormaps.yellowToRedText": "黄到红", + "charts.controls.colorRanges.errorText": "每个范围应大于前一范围。", + "charts.controls.colorSchema.colorSchemaLabel": "颜色模式", + "charts.controls.colorSchema.howToChangeColorsDescription": "可以更改图例中的各个颜色。", + "charts.controls.colorSchema.resetColorsButtonLabel": "重置颜色", + "charts.controls.colorSchema.reverseColorSchemaLabel": "反转模式", + "charts.controls.rangeErrorMessage": "值必须是在 {min} 到 {max} 的范围内", + "charts.controls.vislibBasicOptions.legendPositionLabel": "图例位置", + "charts.controls.vislibBasicOptions.showTooltipLabel": "显示工具提示", "common.ui.errorAutoCreateIndex.breadcrumbs.errorText": "错误", "common.ui.errorAutoCreateIndex.errorDescription": "似乎 Elasticsearch 集群的 {autoCreateIndexActionConfig} 设置使 Kibana 无法自动创建用于存储已保存对象的索引。Kibana 将使用此 Elasticsearch 功能，因为这是确保已保存对象索引使用正确映射/架构的最好方式，而且其允许 Kibana 较少地轮询 Elasticsearch。", "common.ui.errorAutoCreateIndex.errorDisclaimer": "但是，只有解决了此问题后，您才能在 Kibana 保存内容。", @@ -3832,11 +3840,6 @@ "visTypeVislib.chartTypes.areaText": "面积图", "visTypeVislib.chartTypes.barText": "条形图", "visTypeVislib.chartTypes.lineText": "折线图", - "visTypeVislib.controls.colorRanges.errorText": "每个范围应大于前一范围。", - "visTypeVislib.controls.colorSchema.colorSchemaLabel": "颜色模式", - "visTypeVislib.controls.colorSchema.howToChangeColorsDescription": "可以更改图例中的各个颜色。", - "visTypeVislib.controls.colorSchema.resetColorsButtonLabel": "重置颜色", - "visTypeVislib.controls.colorSchema.reverseColorSchemaLabel": "反转模式", "visTypeVislib.controls.gaugeOptions.alignmentLabel": "对齐方式", "visTypeVislib.controls.gaugeOptions.autoExtendRangeLabel": "自动扩展范围", "visTypeVislib.controls.gaugeOptions.displayWarningsLabel": "显示警告", @@ -3903,10 +3906,7 @@ "visTypeVislib.controls.pointSeries.valueAxes.toggleCustomExtendsAriaLabel": "切换定制范围", "visTypeVislib.controls.pointSeries.valueAxes.toggleOptionsAriaLabel": "切换 {axisName} 选项", "visTypeVislib.controls.pointSeries.valueAxes.yAxisTitle": "Y 轴", - "visTypeVislib.controls.rangeErrorMessage": "值必须是在 {min} 到 {max} 的范围内", "visTypeVislib.controls.truncateLabel": "截断", - "visTypeVislib.controls.vislibBasicOptions.legendPositionLabel": "图例位置", - "visTypeVislib.controls.vislibBasicOptions.showTooltipLabel": "显示工具提示", "visTypeVislib.editors.heatmap.basicSettingsTitle": "基本设置", "visTypeVislib.editors.heatmap.heatmapSettingsTitle": "热图设置", "visTypeVislib.editors.heatmap.highlightLabel": "高亮范围", From 36acb373876f3c6ea5077caae81d3a1cad239dfd Mon Sep 17 00:00:00 2001 From: Brian Seeders Date: Fri, 10 Apr 2020 11:18:12 -0400 Subject: [PATCH 031/102] Make uptime alert flyout test a little more resilient (#62702) --- .../apps/uptime/alert_flyout.ts | 40 ++++++++++--------- 1 file changed, 21 insertions(+), 19 deletions(-) diff --git a/x-pack/test/functional_with_es_ssl/apps/uptime/alert_flyout.ts b/x-pack/test/functional_with_es_ssl/apps/uptime/alert_flyout.ts index 2a0358160da51..3e5a8c57c4c7e 100644 --- a/x-pack/test/functional_with_es_ssl/apps/uptime/alert_flyout.ts +++ b/x-pack/test/functional_with_es_ssl/apps/uptime/alert_flyout.ts @@ -33,7 +33,7 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { // put the fetch code in a retry block with a timeout. let alert: any; await retry.tryForTime(15000, async () => { - const apiResponse = await supertest.get('/api/alert/_find'); + const apiResponse = await supertest.get('/api/alert/_find?search=uptime-test'); const alertsFromThisTest = apiResponse.body.data.filter( ({ name }: { name: string }) => name === 'uptime-test' ); @@ -54,25 +54,27 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { tags, } = alert; - // we're not testing the flyout's ability to associate alerts with action connectors - expect(actions).to.eql([]); + try { + // we're not testing the flyout's ability to associate alerts with action connectors + expect(actions).to.eql([]); - expect(alertTypeId).to.eql('xpack.uptime.alerts.monitorStatus'); - expect(consumer).to.eql('uptime'); - expect(interval).to.eql('11m'); - expect(tags).to.eql(['uptime', 'another']); - expect(numTimes).to.be(3); - expect(timerange.from).to.be('now-1h'); - expect(timerange.to).to.be('now'); - expect(locations).to.eql(['mpls']); - expect(filters).to.eql( - '{"bool":{"should":[{"match_phrase":{"monitor.id":"0001-up"}}],"minimum_should_match":1}}' - ); - - await supertest - .delete(`/api/alert/${id}`) - .set('kbn-xsrf', 'true') - .expect(204); + expect(alertTypeId).to.eql('xpack.uptime.alerts.monitorStatus'); + expect(consumer).to.eql('uptime'); + expect(interval).to.eql('11m'); + expect(tags).to.eql(['uptime', 'another']); + expect(numTimes).to.be(3); + expect(timerange.from).to.be('now-1h'); + expect(timerange.to).to.be('now'); + expect(locations).to.eql(['mpls']); + expect(filters).to.eql( + '{"bool":{"should":[{"match_phrase":{"monitor.id":"0001-up"}}],"minimum_should_match":1}}' + ); + } finally { + await supertest + .delete(`/api/alert/${id}`) + .set('kbn-xsrf', 'true') + .expect(204); + } }); }); }; From 55a3cc45835ccf267c06c2d0d62000027d2bf006 Mon Sep 17 00:00:00 2001 From: Steph Milovic Date: Fri, 10 Apr 2020 09:55:38 -0600 Subject: [PATCH 032/102] [SIEM] [Cases] Unit tests for case UI components (#63005) --- .../components/filter_popover/index.tsx | 1 + .../components/header_page/editable_title.tsx | 9 +- .../siem/public/containers/case/api.ts | 4 +- .../case/configure/use_configure.tsx | 4 +- .../plugins/siem/public/pages/case/case.tsx | 9 +- .../siem/public/pages/case/case_details.tsx | 6 +- .../case/components/__mock__/case_data.tsx | 226 ++++++++++++ .../pages/case/components/__mock__/form.ts | 37 ++ .../pages/case/components/__mock__/router.ts | 39 +++ .../components/add_comment/index.test.tsx | 144 ++++++++ .../case/components/add_comment/index.tsx | 6 +- .../components/all_cases/__mock__/index.tsx | 115 ------ .../components/all_cases/columns.test.tsx | 48 +++ .../case/components/all_cases/columns.tsx | 14 +- .../case/components/all_cases/index.test.tsx | 66 +++- .../all_cases/table_filters.test.tsx | 121 +++++++ .../components/all_cases/table_filters.tsx | 7 +- .../case/components/all_cases/translations.ts | 4 + .../pages/case/components/callout/helpers.tsx | 4 +- .../case/components/callout/index.test.tsx | 71 ++++ .../pages/case/components/callout/index.tsx | 10 +- .../case/components/case_status/index.tsx | 2 +- .../components/case_view/__mock__/index.tsx | 93 ----- .../components/case_view/actions.test.tsx | 10 +- .../case/components/case_view/actions.tsx | 1 - .../case/components/case_view/index.test.tsx | 320 +++++++++++++---- .../pages/case/components/case_view/index.tsx | 8 +- .../case/components/create/index.test.tsx | 121 +++++++ .../pages/case/components/create/index.tsx | 7 +- .../case/components/tag_list/index.test.tsx | 138 ++++++++ .../pages/case/components/tag_list/index.tsx | 17 +- .../use_push_to_service/index.test.tsx | 192 ++++++++++ .../components/use_push_to_service/index.tsx | 5 +- .../user_action_tree/helpers.test.tsx | 143 ++++++++ .../components/user_action_tree/helpers.tsx | 12 +- .../user_action_tree/index.test.tsx | 331 ++++++++++++++++++ .../components/user_action_tree/index.tsx | 10 +- .../user_action_tree/user_action_item.tsx | 15 +- .../user_action_tree/user_action_markdown.tsx | 20 +- .../user_action_title.test.tsx | 57 +++ .../user_action_tree/user_action_title.tsx | 16 +- .../siem/public/pages/case/translations.ts | 4 + .../scripts/generate_case_and_comment_data.sh | 6 +- .../case/server/scripts/generate_case_data.sh | 4 +- 44 files changed, 2117 insertions(+), 360 deletions(-) create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/form.ts create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/router.ts create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.test.tsx delete mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/__mock__/index.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.test.tsx delete mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/case_view/__mock__/index.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/create/index.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx diff --git a/x-pack/legacy/plugins/siem/public/components/filter_popover/index.tsx b/x-pack/legacy/plugins/siem/public/components/filter_popover/index.tsx index 3c01ec18a879f..fca6396a53745 100644 --- a/x-pack/legacy/plugins/siem/public/components/filter_popover/index.tsx +++ b/x-pack/legacy/plugins/siem/public/components/filter_popover/index.tsx @@ -89,6 +89,7 @@ export const FilterPopoverComponent = ({ {options.map((option, index) => ( diff --git a/x-pack/legacy/plugins/siem/public/components/header_page/editable_title.tsx b/x-pack/legacy/plugins/siem/public/components/header_page/editable_title.tsx index 165be00384779..0c6f7258d09dc 100644 --- a/x-pack/legacy/plugins/siem/public/components/header_page/editable_title.tsx +++ b/x-pack/legacy/plugins/siem/public/components/header_page/editable_title.tsx @@ -60,12 +60,9 @@ const EditableTitleComponent: React.FC = ({ }, [changedTitle, title]); const handleOnChange = useCallback( - (e: ChangeEvent) => { - onTitleChange(e.target.value); - }, - [onTitleChange] + (e: ChangeEvent) => onTitleChange(e.target.value), + [] ); - return editMode ? ( @@ -107,7 +104,7 @@ const EditableTitleComponent: React.FC = ({ </EuiFlexItem> <EuiFlexItem grow={false}> - {isLoading && <MySpinner />} + {isLoading && <MySpinner data-test-subj="editable-title-loading" />} {!isLoading && ( <MyEuiButtonIcon isDisabled={disabled} diff --git a/x-pack/legacy/plugins/siem/public/containers/case/api.ts b/x-pack/legacy/plugins/siem/public/containers/case/api.ts index 69e1602b3d981..12b4c80a2dd89 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/api.ts +++ b/x-pack/legacy/plugins/siem/public/containers/case/api.ts @@ -204,13 +204,13 @@ export const patchComment = async ( return convertToCamelCase<CaseResponse, Case>(decodeCaseResponse(response)); }; -export const deleteCases = async (caseIds: string[], signal: AbortSignal): Promise<boolean> => { +export const deleteCases = async (caseIds: string[], signal: AbortSignal): Promise<string> => { const response = await KibanaServices.get().http.fetch<string>(CASES_URL, { method: 'DELETE', query: { ids: JSON.stringify(caseIds) }, signal, }); - return response === 'true' ? true : false; + return response; }; export const pushCase = async ( diff --git a/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx index 7f57149d4e56d..1c03a09a8c2ea 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/configure/use_configure.tsx @@ -55,7 +55,6 @@ export const useCaseConfigure = ({ setLoading(true); const res = await getCaseConfigure({ signal: abortCtrl.signal }); if (!didCancel) { - setLoading(false); if (res != null) { setConnector(res.connectorId, res.connectorName); if (setClosureType != null) { @@ -73,6 +72,7 @@ export const useCaseConfigure = ({ } } } + setLoading(false); } } catch (error) { if (!didCancel) { @@ -117,7 +117,6 @@ export const useCaseConfigure = ({ abortCtrl.signal ); if (!didCancel) { - setPersistLoading(false); setConnector(res.connectorId); if (setClosureType) { setClosureType(res.closureType); @@ -131,6 +130,7 @@ export const useCaseConfigure = ({ } displaySuccessToast(i18n.SUCCESS_CONFIGURE, dispatchToaster); + setPersistLoading(false); } } catch (error) { if (!didCancel) { diff --git a/x-pack/legacy/plugins/siem/public/pages/case/case.tsx b/x-pack/legacy/plugins/siem/public/pages/case/case.tsx index 2ae35796387b8..aefb0a93366b8 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/case.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/case.tsx @@ -11,11 +11,9 @@ import { useGetUserSavedObjectPermissions } from '../../lib/kibana'; import { SpyRoute } from '../../utils/route/spy_routes'; import { AllCases } from './components/all_cases'; -import { getSavedObjectReadOnly, CaseCallOut } from './components/callout'; +import { savedObjectReadOnly, CaseCallOut } from './components/callout'; import { CaseSavedObjectNoPermissions } from './saved_object_no_permissions'; -const infoReadSavedObject = getSavedObjectReadOnly(); - export const CasesPage = React.memo(() => { const userPermissions = useGetUserSavedObjectPermissions(); @@ -24,10 +22,11 @@ export const CasesPage = React.memo(() => { <WrapperPage> {userPermissions != null && !userPermissions?.crud && userPermissions?.read && ( <CaseCallOut - title={infoReadSavedObject.title} - message={infoReadSavedObject.description} + title={savedObjectReadOnly.title} + message={savedObjectReadOnly.description} /> )} + <CaseCallOut title={savedObjectReadOnly.title} message={savedObjectReadOnly.description} /> <AllCases userCanCrud={userPermissions?.crud ?? false} /> </WrapperPage> <SpyRoute /> diff --git a/x-pack/legacy/plugins/siem/public/pages/case/case_details.tsx b/x-pack/legacy/plugins/siem/public/pages/case/case_details.tsx index cbc7bbc62fbf9..4bb8afa7f8d42 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/case_details.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/case_details.tsx @@ -13,9 +13,7 @@ import { SpyRoute } from '../../utils/route/spy_routes'; import { getCaseUrl } from '../../components/link_to'; import { navTabs } from '../home/home_navigations'; import { CaseView } from './components/case_view'; -import { getSavedObjectReadOnly, CaseCallOut } from './components/callout'; - -const infoReadSavedObject = getSavedObjectReadOnly(); +import { savedObjectReadOnly, CaseCallOut } from './components/callout'; export const CaseDetailsPage = React.memo(() => { const userPermissions = useGetUserSavedObjectPermissions(); @@ -29,7 +27,7 @@ export const CaseDetailsPage = React.memo(() => { return caseId != null ? ( <> {userPermissions != null && !userPermissions?.crud && userPermissions?.read && ( - <CaseCallOut title={infoReadSavedObject.title} message={infoReadSavedObject.description} /> + <CaseCallOut title={savedObjectReadOnly.title} message={savedObjectReadOnly.description} /> )} <CaseView caseId={caseId} userCanCrud={userPermissions?.crud ?? false} /> <SpyRoute /> diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx new file mode 100644 index 0000000000000..64c6276fc1be2 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx @@ -0,0 +1,226 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { CaseProps } from '../case_view'; +import { Case, Comment, SortFieldCase } from '../../../../containers/case/types'; +import { UseGetCasesState } from '../../../../containers/case/use_get_cases'; +import { UserAction, UserActionField } from '../../../../../../../../plugins/case/common/api/cases'; + +const updateCase = jest.fn(); +const fetchCase = jest.fn(); + +const basicCaseId = 'basic-case-id'; +const basicCommentId = 'basic-comment-id'; +const basicCreatedAt = '2020-02-20T23:06:33.798Z'; +const elasticUser = { + fullName: 'Leslie Knope', + username: 'lknope', + email: 'leslie.knope@elastic.co', +}; + +export const basicComment: Comment = { + comment: 'Solve this fast!', + id: basicCommentId, + createdAt: basicCreatedAt, + createdBy: elasticUser, + pushedAt: null, + pushedBy: null, + updatedAt: '2020-02-20T23:06:33.798Z', + updatedBy: { + username: 'elastic', + }, + version: 'WzQ3LDFc', +}; + +export const basicCase: Case = { + closedAt: null, + closedBy: null, + id: basicCaseId, + comments: [basicComment], + createdAt: '2020-02-13T19:44:23.627Z', + createdBy: elasticUser, + description: 'Security banana Issue', + externalService: null, + status: 'open', + tags: ['defacement'], + title: 'Another horrible breach!!', + totalComment: 1, + updatedAt: '2020-02-19T15:02:57.995Z', + updatedBy: { + username: 'elastic', + }, + version: 'WzQ3LDFd', +}; + +export const caseProps: CaseProps = { + caseId: basicCaseId, + userCanCrud: true, + caseData: basicCase, + fetchCase, + updateCase, +}; + +export const caseClosedProps: CaseProps = { + ...caseProps, + caseData: { + ...caseProps.caseData, + closedAt: '2020-02-20T23:06:33.798Z', + closedBy: { + username: 'elastic', + }, + status: 'closed', + }, +}; + +export const basicCaseClosed: Case = { + ...caseClosedProps.caseData, +}; + +const basicAction = { + actionAt: basicCreatedAt, + actionBy: elasticUser, + oldValue: null, + newValue: 'what a cool value', + caseId: basicCaseId, + commentId: null, +}; +export const caseUserActions = [ + { + ...basicAction, + actionBy: elasticUser, + actionField: ['comment'], + action: 'create', + actionId: 'tt', + }, +]; + +export const useGetCasesMockState: UseGetCasesState = { + data: { + countClosedCases: 0, + countOpenCases: 5, + cases: [ + basicCase, + { + closedAt: null, + closedBy: null, + id: '362a5c10-4e99-11ea-9290-35d05cb55c15', + createdAt: '2020-02-13T19:44:13.328Z', + createdBy: { username: 'elastic' }, + comments: [], + description: 'Security banana Issue', + externalService: { + pushedAt: '2020-02-13T19:45:01.901Z', + pushedBy: 'elastic', + connectorId: 'string', + connectorName: 'string', + externalId: 'string', + externalTitle: 'string', + externalUrl: 'string', + }, + status: 'open', + tags: ['phishing'], + title: 'Bad email', + totalComment: 0, + updatedAt: '2020-02-13T15:45:01.901Z', + updatedBy: { username: 'elastic' }, + version: 'WzQ3LDFd', + }, + { + closedAt: null, + closedBy: null, + id: '34f8b9e0-4e99-11ea-9290-35d05cb55c15', + createdAt: '2020-02-13T19:44:11.328Z', + createdBy: { username: 'elastic' }, + comments: [], + description: 'Security banana Issue', + externalService: { + pushedAt: '2020-02-13T19:45:01.901Z', + pushedBy: 'elastic', + connectorId: 'string', + connectorName: 'string', + externalId: 'string', + externalTitle: 'string', + externalUrl: 'string', + }, + status: 'open', + tags: ['phishing'], + title: 'Bad email', + totalComment: 0, + updatedAt: '2020-02-14T19:45:01.901Z', + updatedBy: { username: 'elastic' }, + version: 'WzQ3LDFd', + }, + { + closedAt: '2020-02-13T19:44:13.328Z', + closedBy: { username: 'elastic' }, + id: '31890e90-4e99-11ea-9290-35d05cb55c15', + createdAt: '2020-02-13T19:44:05.563Z', + createdBy: { username: 'elastic' }, + comments: [], + description: 'Security banana Issue', + externalService: null, + status: 'closed', + tags: ['phishing'], + title: 'Uh oh', + totalComment: 0, + updatedAt: null, + updatedBy: null, + version: 'WzQ3LDFd', + }, + { + closedAt: null, + closedBy: null, + id: '2f5b3210-4e99-11ea-9290-35d05cb55c15', + createdAt: '2020-02-13T19:44:01.901Z', + createdBy: { username: 'elastic' }, + comments: [], + description: 'Security banana Issue', + externalService: null, + status: 'open', + tags: ['phishing'], + title: 'Uh oh', + totalComment: 0, + updatedAt: null, + updatedBy: null, + version: 'WzQ3LDFd', + }, + ], + page: 1, + perPage: 5, + total: 10, + }, + loading: [], + selectedCases: [], + isError: false, + queryParams: { + page: 1, + perPage: 5, + sortField: SortFieldCase.createdAt, + sortOrder: 'desc', + }, + filterOptions: { search: '', reporters: [], tags: [], status: 'open' }, +}; + +const basicPush = { + connector_id: 'connector_id', + connector_name: 'connector name', + external_id: 'external_id', + external_title: 'external title', + external_url: 'basicPush.com', + pushed_at: basicCreatedAt, + pushed_by: elasticUser, +}; +export const getUserAction = (af: UserActionField, a: UserAction) => ({ + ...basicAction, + actionId: `${af[0]}-${a}`, + actionField: af, + action: a, + commentId: af[0] === 'comment' ? basicCommentId : null, + newValue: + a === 'push-to-service' && af[0] === 'pushed' + ? JSON.stringify(basicPush) + : basicAction.newValue, +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/form.ts b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/form.ts new file mode 100644 index 0000000000000..9d2ac29bc47d7 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/form.ts @@ -0,0 +1,37 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +export const mockFormHook = { + isSubmitted: false, + isSubmitting: false, + isValid: true, + submit: jest.fn(), + subscribe: jest.fn(), + setFieldValue: jest.fn(), + setFieldErrors: jest.fn(), + getFields: jest.fn(), + getFormData: jest.fn(), + getFieldDefaultValue: jest.fn(), + /* Returns a list of all errors in the form */ + getErrors: jest.fn(), + reset: jest.fn(), + __options: {}, + __formData$: {}, + __addField: jest.fn(), + __removeField: jest.fn(), + __validateFields: jest.fn(), + __updateFormDataAt: jest.fn(), + __readFieldConfigFromSchema: jest.fn(), +}; +// eslint-disable-next-line @typescript-eslint/no-explicit-any +export const getFormMock = (sampleData: any) => ({ + ...mockFormHook, + submit: () => + Promise.resolve({ + data: sampleData, + isValid: true, + }), + getFormData: () => sampleData, +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/router.ts b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/router.ts new file mode 100644 index 0000000000000..a20ab00852a36 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/router.ts @@ -0,0 +1,39 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { Router } from 'react-router-dom'; +// eslint-disable-next-line @kbn/eslint/module_migration +import routeData from 'react-router'; +type Action = 'PUSH' | 'POP' | 'REPLACE'; +const pop: Action = 'POP'; +const location = { + pathname: '/network', + search: '', + state: '', + hash: '', +}; +export const mockHistory = { + length: 2, + location, + action: pop, + push: jest.fn(), + replace: jest.fn(), + go: jest.fn(), + goBack: jest.fn(), + goForward: jest.fn(), + block: jest.fn(), + createHref: jest.fn(), + listen: jest.fn(), +}; + +export const mockLocation = { + pathname: '/welcome', + hash: '', + search: '', + state: '', +}; + +export { Router, routeData }; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.test.tsx new file mode 100644 index 0000000000000..74f6411f17fa0 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.test.tsx @@ -0,0 +1,144 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { AddComment } from './'; +import { TestProviders } from '../../../../mock'; +import { getFormMock } from '../__mock__/form'; +import { Router, routeData, mockHistory, mockLocation } from '../__mock__/router'; + +import { useInsertTimeline } from '../../../../components/timeline/insert_timeline_popover/use_insert_timeline'; +import { usePostComment } from '../../../../containers/case/use_post_comment'; +import { useForm } from '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks/use_form'; +import { wait } from '../../../../lib/helpers'; +jest.mock( + '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks/use_form' +); +jest.mock('../../../../components/timeline/insert_timeline_popover/use_insert_timeline'); +jest.mock('../../../../containers/case/use_post_comment'); + +export const useFormMock = useForm as jest.Mock; + +const useInsertTimelineMock = useInsertTimeline as jest.Mock; +const usePostCommentMock = usePostComment as jest.Mock; + +const onCommentSaving = jest.fn(); +const onCommentPosted = jest.fn(); +const postComment = jest.fn(); +const handleCursorChange = jest.fn(); +const handleOnTimelineChange = jest.fn(); + +const addCommentProps = { + caseId: '1234', + disabled: false, + insertQuote: null, + onCommentSaving, + onCommentPosted, + showLoading: false, +}; + +const defaultInsertTimeline = { + cursorPosition: { + start: 0, + end: 0, + }, + handleCursorChange, + handleOnTimelineChange, +}; + +const defaultPostCommment = { + isLoading: false, + isError: false, + postComment, +}; +const sampleData = { + comment: 'what a cool comment', +}; +describe('AddComment ', () => { + const formHookMock = getFormMock(sampleData); + + beforeEach(() => { + jest.resetAllMocks(); + useInsertTimelineMock.mockImplementation(() => defaultInsertTimeline); + usePostCommentMock.mockImplementation(() => defaultPostCommment); + useFormMock.mockImplementation(() => ({ form: formHookMock })); + jest.spyOn(routeData, 'useLocation').mockReturnValue(mockLocation); + }); + + it('should post comment on submit click', async () => { + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <AddComment {...addCommentProps} /> + </Router> + </TestProviders> + ); + expect(wrapper.find(`[data-test-subj="add-comment"]`).exists()).toBeTruthy(); + expect(wrapper.find(`[data-test-subj="loading-spinner"]`).exists()).toBeFalsy(); + + wrapper + .find(`[data-test-subj="submit-comment"]`) + .first() + .simulate('click'); + await wait(); + expect(onCommentSaving).toBeCalled(); + expect(postComment).toBeCalledWith(sampleData, onCommentPosted); + expect(formHookMock.reset).toBeCalled(); + }); + + it('should render spinner and disable submit when loading', () => { + usePostCommentMock.mockImplementation(() => ({ ...defaultPostCommment, isLoading: true })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <AddComment {...{ ...addCommentProps, showLoading: true }} /> + </Router> + </TestProviders> + ); + expect(wrapper.find(`[data-test-subj="loading-spinner"]`).exists()).toBeTruthy(); + expect( + wrapper + .find(`[data-test-subj="submit-comment"]`) + .first() + .prop('isDisabled') + ).toBeTruthy(); + }); + + it('should disable submit button when disabled prop passed', () => { + usePostCommentMock.mockImplementation(() => ({ ...defaultPostCommment, isLoading: true })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <AddComment {...{ ...addCommentProps, disabled: true }} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="submit-comment"]`) + .first() + .prop('isDisabled') + ).toBeTruthy(); + }); + + it('should insert a quote if one is available', () => { + const sampleQuote = 'what a cool quote'; + mount( + <TestProviders> + <Router history={mockHistory}> + <AddComment {...{ ...addCommentProps, insertQuote: sampleQuote }} /> + </Router> + </TestProviders> + ); + + expect(formHookMock.setFieldValue).toBeCalledWith( + 'comment', + `${sampleData.comment}\n\n${sampleQuote}` + ); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.tsx index ecc57c50e28eb..eaba708948a99 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/add_comment/index.tsx @@ -71,10 +71,9 @@ export const AddComment = React.memo<AddCommentProps>( form.reset(); } }, [form, onCommentPosted, onCommentSaving]); - return ( <span id="add-comment-permLink"> - {isLoading && showLoading && <MySpinner size="xl" />} + {isLoading && showLoading && <MySpinner data-test-subj="loading-spinner" size="xl" />} <Form form={form}> <UseField path="comment" @@ -82,11 +81,12 @@ export const AddComment = React.memo<AddCommentProps>( componentProps={{ idAria: 'caseComment', isDisabled: isLoading, - dataTestSubj: 'caseComment', + dataTestSubj: 'add-comment', placeholder: i18n.ADD_COMMENT_HELP_TEXT, onCursorPositionUpdate: handleCursorChange, bottomRightContent: ( <EuiButton + data-test-subj="submit-comment" iconType="plusInCircle" isDisabled={isLoading || disabled} isLoading={isLoading} diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/__mock__/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/__mock__/index.tsx deleted file mode 100644 index d4ec32dfd070b..0000000000000 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/__mock__/index.tsx +++ /dev/null @@ -1,115 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { SortFieldCase } from '../../../../../containers/case/types'; -import { UseGetCasesState } from '../../../../../containers/case/use_get_cases'; - -export const useGetCasesMockState: UseGetCasesState = { - data: { - countClosedCases: 0, - countOpenCases: 5, - cases: [ - { - closedAt: null, - closedBy: null, - id: '3c4ddcc0-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:23.627Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['defacement'], - title: 'Another horrible breach', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - { - closedAt: null, - closedBy: null, - id: '362a5c10-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:13.328Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['phishing'], - title: 'Bad email', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - { - closedAt: null, - closedBy: null, - id: '34f8b9e0-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:11.328Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['phishing'], - title: 'Bad email', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - { - closedAt: '2020-02-13T19:44:13.328Z', - closedBy: { username: 'elastic' }, - id: '31890e90-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:05.563Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'closed', - tags: ['phishing'], - title: 'Uh oh', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - { - closedAt: null, - closedBy: null, - id: '2f5b3210-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:01.901Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['phishing'], - title: 'Uh oh', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - ], - page: 1, - perPage: 5, - total: 10, - }, - loading: [], - selectedCases: [], - isError: false, - queryParams: { - page: 1, - perPage: 5, - sortField: SortFieldCase.createdAt, - sortOrder: 'desc', - }, - filterOptions: { search: '', reporters: [], tags: [], status: 'open' }, -}; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx new file mode 100644 index 0000000000000..e008b94ab9e16 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx @@ -0,0 +1,48 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { ServiceNowColumn } from './columns'; + +import { useGetCasesMockState } from '../__mock__/case_data'; + +describe('ServiceNowColumn ', () => { + it('Not pushed render', () => { + const wrapper = mount( + <ServiceNowColumn {...{ theCase: useGetCasesMockState.data.cases[0] }} /> + ); + expect( + wrapper + .find(`[data-test-subj="case-table-column-external-notPushed"]`) + .last() + .exists() + ).toBeTruthy(); + }); + it('Up to date', () => { + const wrapper = mount( + <ServiceNowColumn {...{ theCase: useGetCasesMockState.data.cases[1] }} /> + ); + expect( + wrapper + .find(`[data-test-subj="case-table-column-external-upToDate"]`) + .last() + .exists() + ).toBeTruthy(); + }); + it('Needs update', () => { + const wrapper = mount( + <ServiceNowColumn {...{ theCase: useGetCasesMockState.data.cases[2] }} /> + ); + expect( + wrapper + .find(`[data-test-subj="case-table-column-external-requiresUpdate"]`) + .last() + .exists() + ).toBeTruthy(); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.tsx index 0e12f78e29bc2..e48e5cb0c5959 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.tsx @@ -114,7 +114,9 @@ export const getCasesColumns = ( name: i18n.COMMENTS, sortable: true, render: (totalComment: Case['totalComment']) => - renderStringField(`${totalComment}`, `case-table-column-commentCount`), + totalComment != null + ? renderStringField(`${totalComment}`, `case-table-column-commentCount`) + : getEmptyTagValue(), }, filterStatus === 'open' ? { @@ -150,7 +152,7 @@ export const getCasesColumns = ( }, }, { - name: 'ServiceNow Incident', + name: i18n.SERVICENOW_INCIDENT, render: (theCase: Case) => { if (theCase.id != null) { return <ServiceNowColumn theCase={theCase} />; @@ -159,7 +161,7 @@ export const getCasesColumns = ( }, }, { - name: 'Actions', + name: i18n.ACTIONS, actions, }, ]; @@ -168,7 +170,7 @@ interface Props { theCase: Case; } -const ServiceNowColumn: React.FC<Props> = ({ theCase }) => { +export const ServiceNowColumn: React.FC<Props> = ({ theCase }) => { const handleRenderDataToPush = useCallback(() => { const lastCaseUpdate = theCase.updatedAt != null ? new Date(theCase.updatedAt) : null; const lastCasePush = @@ -190,7 +192,9 @@ const ServiceNowColumn: React.FC<Props> = ({ theCase }) => { > {theCase.externalService?.externalTitle} </EuiLink> - {hasDataToPush ? i18n.REQUIRES_UPDATE : i18n.UP_TO_DATE} + {hasDataToPush + ? renderStringField(i18n.REQUIRES_UPDATE, `case-table-column-external-requiresUpdate`) + : renderStringField(i18n.UP_TO_DATE, `case-table-column-external-upToDate`)} </p> ); }, [theCase]); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx index a6da45a8c5bb1..f65736e7cd109 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx @@ -9,11 +9,15 @@ import { mount } from 'enzyme'; import moment from 'moment-timezone'; import { AllCases } from './'; import { TestProviders } from '../../../../mock'; -import { useGetCasesMockState } from './__mock__'; +import { useGetCasesMockState } from '../__mock__/case_data'; +import * as i18n from './translations'; + +import { getEmptyTagValue } from '../../../../components/empty_value'; import { useDeleteCases } from '../../../../containers/case/use_delete_cases'; import { useGetCases } from '../../../../containers/case/use_get_cases'; import { useGetCasesStatus } from '../../../../containers/case/use_get_cases_status'; import { useUpdateCases } from '../../../../containers/case/use_bulk_update_case'; +import { getCasesColumns } from './columns'; jest.mock('../../../../containers/case/use_bulk_update_case'); jest.mock('../../../../containers/case/use_delete_cases'); jest.mock('../../../../containers/case/use_get_cases'); @@ -35,6 +39,7 @@ describe('AllCases', () => { const setSelectedCases = jest.fn(); const updateBulkStatus = jest.fn(); const fetchCasesStatus = jest.fn(); + const emptyTag = getEmptyTagValue().props.children; const defaultGetCases = { ...useGetCasesMockState, @@ -115,7 +120,7 @@ describe('AllCases', () => { .find(`[data-test-subj="case-table-column-createdBy"]`) .first() .text() - ).toEqual(useGetCasesMockState.data.cases[0].createdBy.username); + ).toEqual(useGetCasesMockState.data.cases[0].createdBy.fullName); expect( wrapper .find(`[data-test-subj="case-table-column-createdAt"]`) @@ -129,6 +134,39 @@ describe('AllCases', () => { .text() ).toEqual('Showing 10 cases'); }); + it('should render empty fields', () => { + useGetCasesMock.mockImplementation(() => ({ + ...defaultGetCases, + data: { + ...defaultGetCases.data, + cases: [ + { + ...defaultGetCases.data.cases[0], + id: null, + createdAt: null, + createdBy: null, + tags: null, + title: null, + totalComment: null, + }, + ], + }, + })); + const wrapper = mount( + <TestProviders> + <AllCases userCanCrud={true} /> + </TestProviders> + ); + const checkIt = (columnName: string, key: number) => { + const column = wrapper.find('[data-test-subj="cases-table"] tbody .euiTableRowCell').at(key); + if (columnName === i18n.ACTIONS) { + return; + } + expect(column.find('.euiTableRowCell--hideForDesktop').text()).toEqual(columnName); + expect(column.find('span').text()).toEqual(emptyTag); + }; + getCasesColumns([], 'open').map((i, key) => i.name != null && checkIt(`${i.name}`, key)); + }); it('should tableHeaderSortButton AllCases', () => { const wrapper = mount( <TestProviders> @@ -165,6 +203,30 @@ describe('AllCases', () => { version: firstCase.version, }); }); + it('opens case when row action icon clicked', () => { + useGetCasesMock.mockImplementation(() => ({ + ...defaultGetCases, + filterOptions: { ...defaultGetCases.filterOptions, status: 'closed' }, + })); + + const wrapper = mount( + <TestProviders> + <AllCases userCanCrud={true} /> + </TestProviders> + ); + wrapper + .find('[data-test-subj="action-open"]') + .first() + .simulate('click'); + const firstCase = useGetCasesMockState.data.cases[0]; + expect(dispatchUpdateCaseProperty).toBeCalledWith({ + caseId: firstCase.id, + updateKey: 'status', + updateValue: 'open', + refetchCasesStatus: fetchCasesStatus, + version: firstCase.version, + }); + }); it('Bulk delete', () => { useGetCasesMock.mockImplementation(() => ({ ...defaultGetCases, diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.test.tsx new file mode 100644 index 0000000000000..615d052347203 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.test.tsx @@ -0,0 +1,121 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { CasesTableFilters } from './table_filters'; +import { TestProviders } from '../../../../mock'; + +import { useGetTags } from '../../../../containers/case/use_get_tags'; +import { useGetReporters } from '../../../../containers/case/use_get_reporters'; +import { DEFAULT_FILTER_OPTIONS } from '../../../../containers/case/use_get_cases'; +jest.mock('../../../../components/timeline/insert_timeline_popover/use_insert_timeline'); +jest.mock('../../../../containers/case/use_get_reporters'); +jest.mock('../../../../containers/case/use_get_tags'); + +const onFilterChanged = jest.fn(); +const fetchReporters = jest.fn(); + +const props = { + countClosedCases: 1234, + countOpenCases: 99, + onFilterChanged, + initial: DEFAULT_FILTER_OPTIONS, +}; +describe('CasesTableFilters ', () => { + beforeEach(() => { + jest.resetAllMocks(); + (useGetTags as jest.Mock).mockReturnValue({ tags: ['coke', 'pepsi'] }); + (useGetReporters as jest.Mock).mockReturnValue({ + reporters: ['casetester'], + respReporters: [{ username: 'casetester' }], + isLoading: true, + isError: false, + fetchReporters, + }); + }); + it('should render the initial case count', () => { + const wrapper = mount( + <TestProviders> + <CasesTableFilters {...props} /> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="open-case-count"]`) + .last() + .text() + ).toEqual('Open cases (99)'); + expect( + wrapper + .find(`[data-test-subj="closed-case-count"]`) + .last() + .text() + ).toEqual('Closed cases (1234)'); + }); + it('should call onFilterChange when tags change', () => { + const wrapper = mount( + <TestProviders> + <CasesTableFilters {...props} /> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="options-filter-popover-button-Tags"]`) + .last() + .simulate('click'); + wrapper + .find(`[data-test-subj="options-filter-popover-item-0"]`) + .last() + .simulate('click'); + + expect(onFilterChanged).toBeCalledWith({ tags: ['coke'] }); + }); + it('should call onFilterChange when reporters change', () => { + const wrapper = mount( + <TestProviders> + <CasesTableFilters {...props} /> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="options-filter-popover-button-Reporter"]`) + .last() + .simulate('click'); + + wrapper + .find(`[data-test-subj="options-filter-popover-item-0"]`) + .last() + .simulate('click'); + + expect(onFilterChanged).toBeCalledWith({ reporters: [{ username: 'casetester' }] }); + }); + it('should call onFilterChange when search changes', () => { + const wrapper = mount( + <TestProviders> + <CasesTableFilters {...props} /> + </TestProviders> + ); + + wrapper + .find(`[data-test-subj="search-cases"]`) + .last() + .simulate('keyup', { keyCode: 13, target: { value: 'My search' } }); + expect(onFilterChanged).toBeCalledWith({ search: 'My search' }); + }); + it('should call onFilterChange when status toggled', () => { + const wrapper = mount( + <TestProviders> + <CasesTableFilters {...props} /> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="closed-case-count"]`) + .last() + .simulate('click'); + + expect(onFilterChanged).toBeCalledWith({ status: 'closed' }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.tsx index a344dd7891010..da477a56c0a22 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/table_filters.tsx @@ -42,7 +42,7 @@ const CasesTableFiltersComponent = ({ onFilterChanged, initial = defaultInitial, }: CasesTableFiltersProps) => { - const [selectedReporters, setselectedReporters] = useState( + const [selectedReporters, setSelectedReporters] = useState( initial.reporters.map(r => r.full_name ?? r.username ?? '') ); const [search, setSearch] = useState(initial.search); @@ -54,7 +54,7 @@ const CasesTableFiltersComponent = ({ const handleSelectedReporters = useCallback( newReporters => { if (!isEqual(newReporters, selectedReporters)) { - setselectedReporters(newReporters); + setSelectedReporters(newReporters); const reportersObj = respReporters.filter( r => newReporters.includes(r.username) || newReporters.includes(r.full_name) ); @@ -97,6 +97,7 @@ const CasesTableFiltersComponent = ({ <EuiFlexItem grow={true}> <EuiFieldSearch aria-label={i18n.SEARCH_CASES} + data-test-subj="search-cases" fullWidth incremental={false} placeholder={i18n.SEARCH_PLACEHOLDER} @@ -107,6 +108,7 @@ const CasesTableFiltersComponent = ({ <EuiFlexItem grow={false}> <EuiFilterGroup> <EuiFilterButton + data-test-subj="open-case-count" withNext hasActiveFilters={showOpenCases} onClick={handleToggleFilter.bind(null, true)} @@ -115,6 +117,7 @@ const CasesTableFiltersComponent = ({ {countOpenCases != null ? ` (${countOpenCases})` : ''} </EuiFilterButton> <EuiFilterButton + data-test-subj="closed-case-count" hasActiveFilters={!showOpenCases} onClick={handleToggleFilter.bind(null, false)} > diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/translations.ts b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/translations.ts index 1bee96bc23fff..d3dcfa50ecfa5 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/translations.ts +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/translations.ts @@ -46,6 +46,10 @@ export const BULK_ACTIONS = i18n.translate('xpack.siem.case.caseTable.bulkAction defaultMessage: 'Bulk actions', }); +export const SERVICENOW_INCIDENT = i18n.translate('xpack.siem.case.caseTable.snIncident', { + defaultMessage: 'ServiceNow Incident', +}); + export const SEARCH_PLACEHOLDER = i18n.translate('xpack.siem.case.caseTable.searchPlaceholder', { defaultMessage: 'e.g. case name', }); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/callout/helpers.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/callout/helpers.tsx index 929e8640dceb6..3237104274473 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/callout/helpers.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/callout/helpers.tsx @@ -6,7 +6,7 @@ import * as i18n from './translations'; -export const getSavedObjectReadOnly = () => ({ +export const savedObjectReadOnly = { title: i18n.READ_ONLY_SAVED_OBJECT_TITLE, description: i18n.READ_ONLY_SAVED_OBJECT_MSG, -}); +}; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.test.tsx new file mode 100644 index 0000000000000..126ea13e96af6 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.test.tsx @@ -0,0 +1,71 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { CaseCallOut } from './'; + +const defaultProps = { + title: 'hey title', +}; + +describe('CaseCallOut ', () => { + it('Renders single message callout', () => { + const props = { + ...defaultProps, + message: 'we have one message', + }; + const wrapper = mount(<CaseCallOut {...props} />); + expect( + wrapper + .find(`[data-test-subj="callout-message"]`) + .last() + .exists() + ).toBeTruthy(); + expect( + wrapper + .find(`[data-test-subj="callout-messages"]`) + .last() + .exists() + ).toBeFalsy(); + }); + it('Renders multi message callout', () => { + const props = { + ...defaultProps, + messages: [ + { ...defaultProps, description: <p>{'we have two messages'}</p> }, + { ...defaultProps, description: <p>{'for real'}</p> }, + ], + }; + const wrapper = mount(<CaseCallOut {...props} />); + expect( + wrapper + .find(`[data-test-subj="callout-message"]`) + .last() + .exists() + ).toBeFalsy(); + expect( + wrapper + .find(`[data-test-subj="callout-messages"]`) + .last() + .exists() + ).toBeTruthy(); + }); + it('Dismisses callout', () => { + const props = { + ...defaultProps, + message: 'we have one message', + }; + const wrapper = mount(<CaseCallOut {...props} />); + expect(wrapper.find(`[data-test-subj="case-call-out"]`).exists()).toBeTruthy(); + wrapper + .find(`[data-test-subj="callout-dismiss"]`) + .last() + .simulate('click'); + expect(wrapper.find(`[data-test-subj="case-call-out"]`).exists()).toBeFalsy(); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.tsx index 30a95db2d82a5..0fc93af7f318d 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/callout/index.tsx @@ -24,10 +24,12 @@ const CaseCallOutComponent = ({ title, message, messages }: CaseCallOutProps) => return showCallOut ? ( <> - <EuiCallOut title={title} color="primary" iconType="gear"> - {!isEmpty(messages) && <EuiDescriptionList listItems={messages} />} - {!isEmpty(message) && <p>{message}</p>} - <EuiButton color="primary" onClick={handleCallOut}> + <EuiCallOut title={title} color="primary" iconType="gear" data-test-subj="case-call-out"> + {!isEmpty(messages) && ( + <EuiDescriptionList data-test-subj="callout-messages" listItems={messages} /> + )} + {!isEmpty(message) && <p data-test-subj="callout-message">{message}</p>} + <EuiButton data-test-subj="callout-dismiss" color="primary" onClick={handleCallOut}> {i18n.DISMISS_CALLOUT} </EuiButton> </EuiCallOut> diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_status/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_status/index.tsx index 2b16dfa150d61..718eb95767f2e 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_status/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_status/index.tsx @@ -84,7 +84,7 @@ const CaseStatusComp: React.FC<CaseStatusProps> = ({ <EuiFlexItem grow={false}> <EuiFlexGroup gutterSize="l" alignItems="center"> <EuiFlexItem> - <EuiButtonEmpty iconType="refresh" onClick={onRefresh}> + <EuiButtonEmpty data-test-subj="case-refresh" iconType="refresh" onClick={onRefresh}> {i18n.CASE_REFRESH} </EuiButtonEmpty> </EuiFlexItem> diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/__mock__/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/__mock__/index.tsx deleted file mode 100644 index 0e57326707e97..0000000000000 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/__mock__/index.tsx +++ /dev/null @@ -1,93 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { CaseProps } from '../index'; -import { Case } from '../../../../../containers/case/types'; - -const updateCase = jest.fn(); -const fetchCase = jest.fn(); - -export const caseProps: CaseProps = { - caseId: '3c4ddcc0-4e99-11ea-9290-35d05cb55c15', - userCanCrud: true, - caseData: { - closedAt: null, - closedBy: null, - id: '3c4ddcc0-4e99-11ea-9290-35d05cb55c15', - comments: [ - { - comment: 'Solve this fast!', - id: 'a357c6a0-5435-11ea-b427-fb51a1fcb7b8', - createdAt: '2020-02-20T23:06:33.798Z', - createdBy: { - fullName: 'Steph Milovic', - username: 'smilovic', - email: 'notmyrealemailfool@elastic.co', - }, - pushedAt: null, - pushedBy: null, - updatedAt: '2020-02-20T23:06:33.798Z', - updatedBy: { - username: 'elastic', - }, - version: 'WzQ3LDFd', - }, - ], - createdAt: '2020-02-13T19:44:23.627Z', - createdBy: { fullName: null, email: 'testemail@elastic.co', username: 'elastic' }, - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['defacement'], - title: 'Another horrible breach!!', - totalComment: 1, - updatedAt: '2020-02-19T15:02:57.995Z', - updatedBy: { - username: 'elastic', - }, - version: 'WzQ3LDFd', - }, - fetchCase, - updateCase, -}; - -export const caseClosedProps: CaseProps = { - ...caseProps, - caseData: { - ...caseProps.caseData, - closedAt: '2020-02-20T23:06:33.798Z', - closedBy: { - username: 'elastic', - }, - status: 'closed', - }, -}; - -export const data: Case = { - ...caseProps.caseData, -}; - -export const dataClosed: Case = { - ...caseClosedProps.caseData, -}; - -export const caseUserActions = [ - { - actionField: ['comment'], - action: 'create', - actionAt: '2020-03-20T17:10:09.814Z', - actionBy: { - fullName: 'Steph Milovic', - username: 'smilovic', - email: 'notmyrealemailfool@elastic.co', - }, - newValue: 'Solve this fast!', - oldValue: null, - actionId: '3c4ddcc0-4e99-11ea-9290-35d05cb55c15', - caseId: '9b833a50-6acd-11ea-8fad-af86b1071bd9', - commentId: 'a357c6a0-5435-11ea-b427-fb51a1fcb7b8', - }, -]; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx index 49f5f44cba271..8a25a2121104d 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx @@ -9,7 +9,7 @@ import { mount } from 'enzyme'; import { useDeleteCases } from '../../../../containers/case/use_delete_cases'; import { TestProviders } from '../../../../mock'; -import { data } from './__mock__'; +import { basicCase } from '../__mock__/case_data'; import { CaseViewActions } from './actions'; jest.mock('../../../../containers/case/use_delete_cases'); const useDeleteCasesMock = useDeleteCases as jest.Mock; @@ -34,7 +34,7 @@ describe('CaseView actions', () => { it('clicking trash toggles modal', () => { const wrapper = mount( <TestProviders> - <CaseViewActions caseData={data} /> + <CaseViewActions caseData={basicCase} /> </TestProviders> ); @@ -54,12 +54,14 @@ describe('CaseView actions', () => { })); const wrapper = mount( <TestProviders> - <CaseViewActions caseData={data} /> + <CaseViewActions caseData={basicCase} /> </TestProviders> ); expect(wrapper.find('[data-test-subj="confirm-delete-case-modal"]').exists()).toBeTruthy(); wrapper.find('button[data-test-subj="confirmModalConfirmButton"]').simulate('click'); - expect(handleOnDeleteConfirm.mock.calls[0][0]).toEqual([{ id: data.id, title: data.title }]); + expect(handleOnDeleteConfirm.mock.calls[0][0]).toEqual([ + { id: basicCase.id, title: basicCase.title }, + ]); }); }); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.tsx index 0b08b866df964..216180eb2cf0a 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.tsx @@ -40,7 +40,6 @@ const CaseViewActionsComponent: React.FC<CaseViewActions> = ({ caseData, disable ), [isDisplayConfirmDeleteModal, caseData] ); - // TO DO refactor each of these const's into their own components const propertyActions = useMemo( () => [ { diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx index 3f5b3a3127177..3721a5a727ca5 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx @@ -5,56 +5,43 @@ */ import React from 'react'; -import { Router } from 'react-router-dom'; import { mount } from 'enzyme'; -/* eslint-disable @kbn/eslint/module_migration */ -import routeData from 'react-router'; -/* eslint-enable @kbn/eslint/module_migration */ -import { CaseComponent } from './'; -import { caseProps, caseClosedProps, data, dataClosed, caseUserActions } from './__mock__'; + +import { Router, routeData, mockHistory, mockLocation } from '../__mock__/router'; +import { CaseComponent, CaseView } from './'; +import { + basicCaseClosed, + caseClosedProps, + caseProps, + caseUserActions, +} from '../__mock__/case_data'; import { TestProviders } from '../../../../mock'; import { useUpdateCase } from '../../../../containers/case/use_update_case'; +import { useGetCase } from '../../../../containers/case/use_get_case'; import { useGetCaseUserActions } from '../../../../containers/case/use_get_case_user_actions'; import { wait } from '../../../../lib/helpers'; import { usePushToService } from '../use_push_to_service'; jest.mock('../../../../containers/case/use_update_case'); jest.mock('../../../../containers/case/use_get_case_user_actions'); +jest.mock('../../../../containers/case/use_get_case'); jest.mock('../use_push_to_service'); const useUpdateCaseMock = useUpdateCase as jest.Mock; const useGetCaseUserActionsMock = useGetCaseUserActions as jest.Mock; const usePushToServiceMock = usePushToService as jest.Mock; -type Action = 'PUSH' | 'POP' | 'REPLACE'; -const pop: Action = 'POP'; -const location = { - pathname: '/network', - search: '', - state: '', - hash: '', -}; -const mockHistory = { - length: 2, - location, - action: pop, - push: jest.fn(), - replace: jest.fn(), - go: jest.fn(), - goBack: jest.fn(), - goForward: jest.fn(), - block: jest.fn(), - createHref: jest.fn(), - listen: jest.fn(), -}; - -const mockLocation = { - pathname: '/welcome', - hash: '', - search: '', - state: '', -}; describe('CaseView ', () => { const updateCaseProperty = jest.fn(); const fetchCaseUserActions = jest.fn(); + const fetchCase = jest.fn(); + const updateCase = jest.fn(); + const data = caseProps.caseData; + const defaultGetCase = { + isLoading: false, + isError: false, + data, + updateCase, + fetchCase, + }; /* eslint-disable no-console */ // Silence until enzyme fixed to use ReactTestUtils.act() const originalError = console.error; @@ -84,17 +71,23 @@ describe('CaseView ', () => { participants: [data.createdBy], }; - const defaultUsePushToServiceMock = { - pushButton: <>{'Hello Button'}</>, - pushCallouts: null, - }; - beforeEach(() => { jest.resetAllMocks(); useUpdateCaseMock.mockImplementation(() => defaultUpdateCaseState); jest.spyOn(routeData, 'useLocation').mockReturnValue(mockLocation); useGetCaseUserActionsMock.mockImplementation(() => defaultUseGetCaseUserActions); - usePushToServiceMock.mockImplementation(() => defaultUsePushToServiceMock); + usePushToServiceMock.mockImplementation(({ updateCase: updateCaseMockCall }) => ({ + pushButton: ( + <button + data-test-subj="mock-button" + onClick={() => updateCaseMockCall(caseProps.caseData)} + type="button" + > + {'Hello Button'} + </button> + ), + pushCallouts: null, + })); }); it('should render CaseComponent', async () => { @@ -120,7 +113,7 @@ describe('CaseView ', () => { ).toEqual(data.status); expect( wrapper - .find(`[data-test-subj="case-view-tag-list"] .euiBadge__text`) + .find(`[data-test-subj="case-view-tag-list"] [data-test-subj="case-tag"]`) .first() .text() ).toEqual(data.tags[0]); @@ -139,7 +132,7 @@ describe('CaseView ', () => { ).toEqual(data.createdAt); expect( wrapper - .find(`[data-test-subj="case-view-description"]`) + .find(`[data-test-subj="description-action"] [data-test-subj="user-action-markdown"]`) .first() .prop('raw') ).toEqual(data.description); @@ -148,7 +141,7 @@ describe('CaseView ', () => { it('should show closed indicators in header when case is closed', async () => { useUpdateCaseMock.mockImplementation(() => ({ ...defaultUpdateCaseState, - caseData: dataClosed, + caseData: basicCaseClosed, })); const wrapper = mount( <TestProviders> @@ -164,13 +157,13 @@ describe('CaseView ', () => { .find(`[data-test-subj="case-view-closedAt"]`) .first() .prop('value') - ).toEqual(dataClosed.closedAt); + ).toEqual(basicCaseClosed.closedAt); expect( wrapper .find(`[data-test-subj="case-view-status"]`) .first() .text() - ).toEqual(dataClosed.status); + ).toEqual(basicCaseClosed.status); }); it('should dispatch update state when button is toggled', async () => { @@ -188,7 +181,12 @@ describe('CaseView ', () => { expect(updateCaseProperty).toHaveBeenCalled(); }); - it('should render comments', async () => { + it('should display EditableTitle isLoading', () => { + useUpdateCaseMock.mockImplementation(() => ({ + ...defaultUpdateCaseState, + isLoading: true, + updateKey: 'title', + })); const wrapper = mount( <TestProviders> <Router history={mockHistory}> @@ -196,32 +194,230 @@ describe('CaseView ', () => { </Router> </TestProviders> ); - await wait(); expect( wrapper - .find( - `div[data-test-subj="user-action-${data.comments[0].id}-avatar"] [data-test-subj="user-action-avatar"]` - ) + .find('[data-test-subj="editable-title-loading"]') + .first() + .exists() + ).toBeTruthy(); + expect( + wrapper + .find('[data-test-subj="editable-title-edit-icon"]') .first() - .prop('name') - ).toEqual(data.comments[0].createdBy.fullName); + .exists() + ).toBeFalsy(); + }); + it('should display Toggle Status isLoading', () => { + useUpdateCaseMock.mockImplementation(() => ({ + ...defaultUpdateCaseState, + isLoading: true, + updateKey: 'status', + })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseComponent {...caseProps} /> + </Router> + </TestProviders> + ); expect( wrapper - .find( - `div[data-test-subj="user-action-${data.comments[0].id}"] [data-test-subj="user-action-title"] strong` - ) + .find('[data-test-subj="toggle-case-status"]') .first() - .text() - ).toEqual(data.comments[0].createdBy.username); + .prop('isLoading') + ).toBeTruthy(); + }); + it('should display description isLoading', () => { + useUpdateCaseMock.mockImplementation(() => ({ + ...defaultUpdateCaseState, + isLoading: true, + updateKey: 'description', + })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseComponent {...caseProps} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find('[data-test-subj="description-action"] [data-test-subj="user-action-title-loading"]') + .first() + .exists() + ).toBeTruthy(); + expect( + wrapper + .find('[data-test-subj="description-action"] [data-test-subj="property-actions"]') + .first() + .exists() + ).toBeFalsy(); + }); + + it('should display tags isLoading', () => { + useUpdateCaseMock.mockImplementation(() => ({ + ...defaultUpdateCaseState, + isLoading: true, + updateKey: 'tags', + })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseComponent {...caseProps} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find('[data-test-subj="case-view-tag-list"] [data-test-subj="tag-list-loading"]') + .first() + .exists() + ).toBeTruthy(); expect( wrapper - .find( - `div[data-test-subj="user-action-${data.comments[0].id}"] [data-test-subj="markdown"]` - ) + .find('[data-test-subj="tag-list-edit"]') .first() - .prop('source') - ).toEqual(data.comments[0].comment); + .exists() + ).toBeFalsy(); + }); + + it('should update title', () => { + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseComponent {...caseProps} /> + </Router> + </TestProviders> + ); + const newTitle = 'The new title'; + wrapper + .find(`[data-test-subj="editable-title-edit-icon"]`) + .first() + .simulate('click'); + wrapper.update(); + wrapper + .find(`[data-test-subj="editable-title-input-field"]`) + .last() + .simulate('change', { target: { value: newTitle } }); + + wrapper.update(); + wrapper + .find(`[data-test-subj="editable-title-submit-btn"]`) + .first() + .simulate('click'); + + wrapper.update(); + const updateObject = updateCaseProperty.mock.calls[0][0]; + expect(updateObject.updateKey).toEqual('title'); + expect(updateObject.updateValue).toEqual(newTitle); + }); + + it('should push updates on button click', async () => { + useGetCaseUserActionsMock.mockImplementation(() => ({ + ...defaultUseGetCaseUserActions, + hasDataToPush: true, + })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseComponent {...{ ...caseProps, updateCase }} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find('[data-test-subj="has-data-to-push-button"]') + .first() + .exists() + ).toBeTruthy(); + wrapper + .find('[data-test-subj="mock-button"]') + .first() + .simulate('click'); + wrapper.update(); + await wait(); + expect(updateCase).toBeCalledWith(caseProps.caseData); + expect(fetchCaseUserActions).toBeCalledWith(caseProps.caseData.id); + }); + + it('should return null if error', () => { + (useGetCase as jest.Mock).mockImplementation(() => ({ + ...defaultGetCase, + isError: true, + })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseView + {...{ + caseId: '1234', + userCanCrud: true, + }} + /> + </Router> + </TestProviders> + ); + expect(wrapper).toEqual({}); + }); + + it('should return spinner if loading', () => { + (useGetCase as jest.Mock).mockImplementation(() => ({ + ...defaultGetCase, + isLoading: true, + })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseView + {...{ + caseId: '1234', + userCanCrud: true, + }} + /> + </Router> + </TestProviders> + ); + expect(wrapper.find('[data-test-subj="case-view-loading"]').exists()).toBeTruthy(); + }); + + it('should return case view when data is there', () => { + (useGetCase as jest.Mock).mockImplementation(() => defaultGetCase); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseView + {...{ + caseId: '1234', + userCanCrud: true, + }} + /> + </Router> + </TestProviders> + ); + expect(wrapper.find('[data-test-subj="case-view-title"]').exists()).toBeTruthy(); + }); + + it('should refresh data on refresh', () => { + (useGetCase as jest.Mock).mockImplementation(() => defaultGetCase); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <CaseView + {...{ + caseId: '1234', + userCanCrud: true, + }} + /> + </Router> + </TestProviders> + ); + wrapper + .find('[data-test-subj="case-refresh"]') + .first() + .simulate('click'); + expect(fetchCaseUserActions).toBeCalledWith(caseProps.caseData.id); + expect(fetchCase).toBeCalled(); }); }); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.tsx index 947da51365d66..3cf0405f40637 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.tsx @@ -271,7 +271,11 @@ export const CaseComponent = React.memo<CaseProps>( onChange={toggleStatusCase} /> </EuiFlexItem> - {hasDataToPush && <EuiFlexItem grow={false}>{pushButton}</EuiFlexItem>} + {hasDataToPush && ( + <EuiFlexItem data-test-subj="has-data-to-push-button" grow={false}> + {pushButton} + </EuiFlexItem> + )} </EuiFlexGroup> </> )} @@ -316,7 +320,7 @@ export const CaseView = React.memo(({ caseId, userCanCrud }: Props) => { return ( <MyEuiFlexGroup justifyContent="center" alignItems="center"> <EuiFlexItem grow={false}> - <EuiLoadingSpinner size="xl" /> + <EuiLoadingSpinner data-test-subj="case-view-loading" size="xl" /> </EuiFlexItem> </MyEuiFlexGroup> ); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.test.tsx new file mode 100644 index 0000000000000..d480744fc932a --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.test.tsx @@ -0,0 +1,121 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { Create } from './'; +import { TestProviders } from '../../../../mock'; +import { getFormMock } from '../__mock__/form'; +import { Router, routeData, mockHistory, mockLocation } from '../__mock__/router'; + +import { useInsertTimeline } from '../../../../components/timeline/insert_timeline_popover/use_insert_timeline'; +import { usePostCase } from '../../../../containers/case/use_post_case'; +jest.mock('../../../../components/timeline/insert_timeline_popover/use_insert_timeline'); +jest.mock('../../../../containers/case/use_post_case'); +import { useForm } from '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks'; +import { wait } from '../../../../lib/helpers'; +import { SiemPageName } from '../../../home/types'; +jest.mock( + '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks/use_form' +); + +export const useFormMock = useForm as jest.Mock; + +const useInsertTimelineMock = useInsertTimeline as jest.Mock; +const usePostCaseMock = usePostCase as jest.Mock; + +const postCase = jest.fn(); +const handleCursorChange = jest.fn(); +const handleOnTimelineChange = jest.fn(); + +const defaultInsertTimeline = { + cursorPosition: { + start: 0, + end: 0, + }, + handleCursorChange, + handleOnTimelineChange, +}; +const sampleData = { + description: 'what a great description', + tags: ['coke', 'pepsi'], + title: 'what a cool title', +}; +const defaultPostCase = { + isLoading: false, + isError: false, + caseData: null, + postCase, +}; +describe('Create case', () => { + const formHookMock = getFormMock(sampleData); + + beforeEach(() => { + jest.resetAllMocks(); + useInsertTimelineMock.mockImplementation(() => defaultInsertTimeline); + usePostCaseMock.mockImplementation(() => defaultPostCase); + useFormMock.mockImplementation(() => ({ form: formHookMock })); + jest.spyOn(routeData, 'useLocation').mockReturnValue(mockLocation); + }); + + it('should post case on submit click', async () => { + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <Create /> + </Router> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="create-case-submit"]`) + .first() + .simulate('click'); + await wait(); + expect(postCase).toBeCalledWith(sampleData); + }); + + it('should redirect to all cases on cancel click', () => { + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <Create /> + </Router> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="create-case-cancel"]`) + .first() + .simulate('click'); + expect(mockHistory.replace.mock.calls[0][0].pathname).toEqual(`/${SiemPageName.case}`); + }); + it('should redirect to new case when caseData is there', () => { + const sampleId = '777777'; + usePostCaseMock.mockImplementation(() => ({ ...defaultPostCase, caseData: { id: sampleId } })); + mount( + <TestProviders> + <Router history={mockHistory}> + <Create /> + </Router> + </TestProviders> + ); + expect(mockHistory.replace.mock.calls[0][0].pathname).toEqual( + `/${SiemPageName.case}/${sampleId}` + ); + }); + + it('should render spinner when loading', () => { + usePostCaseMock.mockImplementation(() => ({ ...defaultPostCase, isLoading: true })); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <Create /> + </Router> + </TestProviders> + ); + expect(wrapper.find(`[data-test-subj="create-case-loading-spinner"]`).exists()).toBeTruthy(); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.tsx index 740909db408ec..53b792bb9b5eb 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/create/index.tsx @@ -73,7 +73,7 @@ export const Create = React.memo(() => { const handleSetIsCancel = useCallback(() => { setIsCancel(true); - }, [isCancel]); + }, []); if (caseData != null && caseData.id) { return <Redirect to={`/${SiemPageName.case}/${caseData.id}`} />; @@ -85,7 +85,7 @@ export const Create = React.memo(() => { return ( <EuiPanel> - {isLoading && <MySpinner size="xl" />} + {isLoading && <MySpinner data-test-subj="create-case-loading-spinner" size="xl" />} <Form form={form}> <CommonUseField path="title" @@ -107,7 +107,7 @@ export const Create = React.memo(() => { euiFieldProps: { fullWidth: true, placeholder: '', - isDisabled: isLoading, + disabled: isLoading, }, }} /> @@ -151,6 +151,7 @@ export const Create = React.memo(() => { </EuiFlexItem> <EuiFlexItem grow={false}> <EuiButton + data-test-subj="create-case-submit" fill iconType="plusInCircle" isDisabled={isLoading} diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.test.tsx new file mode 100644 index 0000000000000..8ad2f8f8cb737 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.test.tsx @@ -0,0 +1,138 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { TagList } from './'; +import { getFormMock } from '../__mock__/form'; +import { TestProviders } from '../../../../mock'; +import { wait } from '../../../../lib/helpers'; +import { useForm } from '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks'; +import { act } from 'react-dom/test-utils'; + +jest.mock( + '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks/use_form' +); +const onSubmit = jest.fn(); +const defaultProps = { + disabled: false, + isLoading: false, + onSubmit, + tags: [], +}; + +describe('TagList ', () => { + const sampleTags = ['coke', 'pepsi']; + const formHookMock = getFormMock({ tags: sampleTags }); + beforeEach(() => { + jest.resetAllMocks(); + (useForm as jest.Mock).mockImplementation(() => ({ form: formHookMock })); + }); + it('Renders no tags, and then edit', () => { + const wrapper = mount( + <TestProviders> + <TagList {...defaultProps} /> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="no-tags"]`) + .last() + .exists() + ).toBeTruthy(); + wrapper + .find(`[data-test-subj="tag-list-edit-button"]`) + .last() + .simulate('click'); + expect( + wrapper + .find(`[data-test-subj="no-tags"]`) + .last() + .exists() + ).toBeFalsy(); + expect( + wrapper + .find(`[data-test-subj="edit-tags"]`) + .last() + .exists() + ).toBeTruthy(); + }); + it('Edit tag on submit', async () => { + const wrapper = mount( + <TestProviders> + <TagList {...defaultProps} /> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="tag-list-edit-button"]`) + .last() + .simulate('click'); + await act(async () => { + wrapper + .find(`[data-test-subj="edit-tags-submit"]`) + .last() + .simulate('click'); + await wait(); + expect(onSubmit).toBeCalledWith(sampleTags); + }); + }); + it('Cancels on cancel', async () => { + const props = { + ...defaultProps, + tags: ['pepsi'], + }; + const wrapper = mount( + <TestProviders> + <TagList {...props} /> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="case-tag"]`) + .last() + .exists() + ).toBeTruthy(); + wrapper + .find(`[data-test-subj="tag-list-edit-button"]`) + .last() + .simulate('click'); + await act(async () => { + expect( + wrapper + .find(`[data-test-subj="case-tag"]`) + .last() + .exists() + ).toBeFalsy(); + wrapper + .find(`[data-test-subj="edit-tags-cancel"]`) + .last() + .simulate('click'); + await wait(); + wrapper.update(); + expect( + wrapper + .find(`[data-test-subj="case-tag"]`) + .last() + .exists() + ).toBeTruthy(); + }); + }); + it('Renders disabled button', () => { + const props = { ...defaultProps, disabled: true }; + const wrapper = mount( + <TestProviders> + <TagList {...props} /> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="tag-list-edit-button"]`) + .last() + .prop('disabled') + ).toBeTruthy(); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.tsx index f7d890ca60b16..9bac000b93235 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/tag_list/index.tsx @@ -61,10 +61,11 @@ export const TagList = React.memo( <EuiFlexItem grow={false}> <h4>{i18n.TAGS}</h4> </EuiFlexItem> - {isLoading && <EuiLoadingSpinner />} + {isLoading && <EuiLoadingSpinner data-test-subj="tag-list-loading" />} {!isLoading && ( - <EuiFlexItem grow={false}> + <EuiFlexItem data-test-subj="tag-list-edit" grow={false}> <EuiButtonIcon + data-test-subj="tag-list-edit-button" isDisabled={disabled} aria-label={i18n.EDIT_TAGS_ARIA} iconType={'pencil'} @@ -74,17 +75,19 @@ export const TagList = React.memo( )} </EuiFlexGroup> <EuiHorizontalRule margin="xs" /> - <MyFlexGroup gutterSize="xs"> - {tags.length === 0 && !isEditTags && <p>{i18n.NO_TAGS}</p>} + <MyFlexGroup gutterSize="xs" data-test-subj="grr"> + {tags.length === 0 && !isEditTags && <p data-test-subj="no-tags">{i18n.NO_TAGS}</p>} {tags.length > 0 && !isEditTags && tags.map((tag, key) => ( <EuiFlexItem grow={false} key={`${tag}${key}`}> - <EuiBadge color="hollow">{tag}</EuiBadge> + <EuiBadge data-test-subj="case-tag" color="hollow"> + {tag} + </EuiBadge> </EuiFlexItem> ))} {isEditTags && ( - <EuiFlexGroup direction="column"> + <EuiFlexGroup data-test-subj="edit-tags" direction="column"> <EuiFlexItem> <Form form={form}> <CommonUseField @@ -105,6 +108,7 @@ export const TagList = React.memo( <EuiFlexItem grow={false}> <EuiButton color="secondary" + data-test-subj="edit-tags-submit" fill iconType="save" onClick={onSubmitTags} @@ -115,6 +119,7 @@ export const TagList = React.memo( </EuiFlexItem> <EuiFlexItem grow={false}> <EuiButtonEmpty + data-test-subj="edit-tags-cancel" iconType="cross" onClick={setIsEditTags.bind(null, false)} size="s" diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.test.tsx new file mode 100644 index 0000000000000..77215e2318ded --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.test.tsx @@ -0,0 +1,192 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +/* eslint-disable react/display-name */ +import React from 'react'; +import { renderHook, act } from '@testing-library/react-hooks'; +import { usePushToService, ReturnUsePushToService, UsePushToService } from './'; +import { TestProviders } from '../../../../mock'; +import { usePostPushToService } from '../../../../containers/case/use_post_push_to_service'; +import { ClosureType } from '../../../../../../../../plugins/case/common/api/cases'; +import * as i18n from './translations'; +import { useGetActionLicense } from '../../../../containers/case/use_get_action_license'; +import { getKibanaConfigError, getLicenseError } from './helpers'; +import * as api from '../../../../containers/case/configure/api'; +jest.mock('../../../../containers/case/use_get_action_license'); +jest.mock('../../../../containers/case/use_post_push_to_service'); +jest.mock('../../../../containers/case/configure/api'); + +describe('usePushToService', () => { + const caseId = '12345'; + const updateCase = jest.fn(); + const postPushToService = jest.fn(); + const mockPostPush = { + isLoading: false, + postPushToService, + }; + const closureType: ClosureType = 'close-by-user'; + const mockConnector = { + connectorId: 'c00l', + connectorName: 'name', + }; + const mockCaseConfigure = { + ...mockConnector, + createdAt: 'string', + createdBy: {}, + closureType, + updatedAt: 'string', + updatedBy: {}, + version: 'string', + }; + const getConfigureMock = jest.spyOn(api, 'getCaseConfigure'); + const actionLicense = { + id: '.servicenow', + name: 'ServiceNow', + minimumLicenseRequired: 'platinum', + enabled: true, + enabledInConfig: true, + enabledInLicense: true, + }; + beforeEach(() => { + jest.resetAllMocks(); + (usePostPushToService as jest.Mock).mockImplementation(() => mockPostPush); + (useGetActionLicense as jest.Mock).mockImplementation(() => ({ + isLoading: false, + actionLicense, + })); + getConfigureMock.mockImplementation(() => Promise.resolve(mockCaseConfigure)); + }); + it('push case button posts the push with correct args', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<UsePushToService, ReturnUsePushToService>( + () => + usePushToService({ + caseId, + caseStatus: 'open', + isNew: false, + updateCase, + userCanCrud: true, + }), + { + wrapper: ({ children }) => <TestProviders> {children}</TestProviders>, + } + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(getConfigureMock).toBeCalled(); + result.current.pushButton.props.children.props.onClick(); + expect(postPushToService).toBeCalledWith({ ...mockConnector, caseId, updateCase }); + expect(result.current.pushCallouts).toBeNull(); + }); + }); + it('Displays message when user does not have premium license', async () => { + (useGetActionLicense as jest.Mock).mockImplementation(() => ({ + isLoading: false, + actionLicense: { + ...actionLicense, + enabledInLicense: false, + }, + })); + await act(async () => { + const { result, waitForNextUpdate } = renderHook<UsePushToService, ReturnUsePushToService>( + () => + usePushToService({ + caseId, + caseStatus: 'open', + isNew: false, + updateCase, + userCanCrud: true, + }), + { + wrapper: ({ children }) => <TestProviders> {children}</TestProviders>, + } + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + const errorsMsg = result.current.pushCallouts?.props.messages; + expect(errorsMsg).toHaveLength(1); + expect(errorsMsg[0].title).toEqual(getLicenseError().title); + }); + }); + it('Displays message when user does not have case enabled in config', async () => { + (useGetActionLicense as jest.Mock).mockImplementation(() => ({ + isLoading: false, + actionLicense: { + ...actionLicense, + enabledInConfig: false, + }, + })); + await act(async () => { + const { result, waitForNextUpdate } = renderHook<UsePushToService, ReturnUsePushToService>( + () => + usePushToService({ + caseId, + caseStatus: 'open', + isNew: false, + updateCase, + userCanCrud: true, + }), + { + wrapper: ({ children }) => <TestProviders> {children}</TestProviders>, + } + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + const errorsMsg = result.current.pushCallouts?.props.messages; + expect(errorsMsg).toHaveLength(1); + expect(errorsMsg[0].title).toEqual(getKibanaConfigError().title); + }); + }); + it('Displays message when user does not have a connector configured', async () => { + getConfigureMock.mockImplementation(() => + Promise.resolve({ + ...mockCaseConfigure, + connectorId: 'none', + }) + ); + await act(async () => { + const { result, waitForNextUpdate } = renderHook<UsePushToService, ReturnUsePushToService>( + () => + usePushToService({ + caseId, + caseStatus: 'open', + isNew: false, + updateCase, + userCanCrud: true, + }), + { + wrapper: ({ children }) => <TestProviders> {children}</TestProviders>, + } + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + const errorsMsg = result.current.pushCallouts?.props.messages; + expect(errorsMsg).toHaveLength(1); + expect(errorsMsg[0].title).toEqual(i18n.PUSH_DISABLE_BY_NO_CASE_CONFIG_TITLE); + }); + }); + it('Displays message when case is closed', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<UsePushToService, ReturnUsePushToService>( + () => + usePushToService({ + caseId, + caseStatus: 'closed', + isNew: false, + updateCase, + userCanCrud: true, + }), + { + wrapper: ({ children }) => <TestProviders> {children}</TestProviders>, + } + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + const errorsMsg = result.current.pushCallouts?.props.messages; + expect(errorsMsg).toHaveLength(1); + expect(errorsMsg[0].title).toEqual(i18n.PUSH_DISABLE_BECAUSE_CASE_CLOSED_TITLE); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.tsx index 4f370ec978906..5092cba6872e3 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/use_push_to_service/index.tsx @@ -19,7 +19,7 @@ import { CaseCallOut } from '../callout'; import { getLicenseError, getKibanaConfigError } from './helpers'; import * as i18n from './translations'; -interface UsePushToService { +export interface UsePushToService { caseId: string; caseStatus: string; isNew: boolean; @@ -32,7 +32,7 @@ interface Connector { connectorName: string; } -interface ReturnUsePushToService { +export interface ReturnUsePushToService { pushButton: JSX.Element; pushCallouts: JSX.Element | null; } @@ -122,6 +122,7 @@ export const usePushToService = ({ const pushToServiceButton = useMemo( () => ( <EuiButton + data-test-subj="push-to-service-now" fill iconType="importAction" onClick={handlePushToService} diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx new file mode 100644 index 0000000000000..5c342538f0feb --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx @@ -0,0 +1,143 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { getUserAction } from '../__mock__/case_data'; +import { getLabelTitle } from './helpers'; +import * as i18n from '../case_view/translations'; +import { mount } from 'enzyme'; + +describe('User action tree helpers', () => { + it('label title generated for update tags', () => { + const action = getUserAction(['title'], 'update'); + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'tags', + firstIndexPushToService: 0, + index: 0, + }); + + const wrapper = mount(<>{result}</>); + expect( + wrapper + .find(`[data-test-subj="ua-tags-label"]`) + .first() + .text() + ).toEqual(` ${i18n.TAGS.toLowerCase()}`); + + expect( + wrapper + .find(`[data-test-subj="ua-tag"]`) + .first() + .text() + ).toEqual(action.newValue); + }); + it('label title generated for update title', () => { + const action = getUserAction(['title'], 'update'); + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'title', + firstIndexPushToService: 0, + index: 0, + }); + + expect(result).toEqual( + `${i18n.CHANGED_FIELD.toLowerCase()} ${i18n.CASE_NAME.toLowerCase()} ${i18n.TO} "${ + action.newValue + }"` + ); + }); + it('label title generated for update description', () => { + const action = getUserAction(['description'], 'update'); + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'description', + firstIndexPushToService: 0, + index: 0, + }); + + expect(result).toEqual(`${i18n.EDITED_FIELD} ${i18n.DESCRIPTION.toLowerCase()}`); + }); + it('label title generated for update status to open', () => { + const action = { ...getUserAction(['status'], 'update'), newValue: 'open' }; + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'status', + firstIndexPushToService: 0, + index: 0, + }); + + expect(result).toEqual(`${i18n.REOPENED_CASE.toLowerCase()} ${i18n.CASE}`); + }); + it('label title generated for update status to closed', () => { + const action = { ...getUserAction(['status'], 'update'), newValue: 'closed' }; + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'status', + firstIndexPushToService: 0, + index: 0, + }); + + expect(result).toEqual(`${i18n.CLOSED_CASE.toLowerCase()} ${i18n.CASE}`); + }); + it('label title generated for update comment', () => { + const action = getUserAction(['comment'], 'update'); + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'comment', + firstIndexPushToService: 0, + index: 0, + }); + + expect(result).toEqual(`${i18n.EDITED_FIELD} ${i18n.COMMENT.toLowerCase()}`); + }); + it('label title generated for pushed incident', () => { + const action = getUserAction(['pushed'], 'push-to-service'); + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'pushed', + firstIndexPushToService: 0, + index: 0, + }); + + const wrapper = mount(<>{result}</>); + expect( + wrapper + .find(`[data-test-subj="pushed-label"]`) + .first() + .text() + ).toEqual(i18n.PUSHED_NEW_INCIDENT); + expect( + wrapper + .find(`[data-test-subj="pushed-value"]`) + .first() + .prop('href') + ).toEqual(JSON.parse(action.newValue).external_url); + }); + it('label title generated for needs update incident', () => { + const action = getUserAction(['pushed'], 'push-to-service'); + const result: string | JSX.Element = getLabelTitle({ + action, + field: 'pushed', + firstIndexPushToService: 0, + index: 1, + }); + + const wrapper = mount(<>{result}</>); + expect( + wrapper + .find(`[data-test-subj="pushed-label"]`) + .first() + .text() + ).toEqual(i18n.UPDATE_INCIDENT); + expect( + wrapper + .find(`[data-test-subj="pushed-value"]`) + .first() + .prop('href') + ).toEqual(JSON.parse(action.newValue).external_url); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.tsx index 008f4d7048f56..d6016e540bdc0 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.tsx @@ -41,14 +41,16 @@ export const getLabelTitle = ({ action, field, firstIndexPushToService, index }: const getTagsLabelTitle = (action: CaseUserActions) => ( <EuiFlexGroup alignItems="baseline" gutterSize="xs" component="span"> - <EuiFlexItem> + <EuiFlexItem data-test-subj="ua-tags-label"> {action.action === 'add' && i18n.ADDED_FIELD} {action.action === 'delete' && i18n.REMOVED_FIELD} {i18n.TAGS.toLowerCase()} </EuiFlexItem> {action.newValue != null && action.newValue.split(',').map(tag => ( <EuiFlexItem grow={false} key={tag}> - <EuiBadge color="default">{tag}</EuiBadge> + <EuiBadge data-test-subj={`ua-tag`} color="default"> + {tag} + </EuiBadge> </EuiFlexItem> ))} </EuiFlexGroup> @@ -61,12 +63,12 @@ const getPushedServiceLabelTitle = ( ) => { const pushedVal = JSON.parse(action.newValue ?? '') as CaseFullExternalService; return ( - <EuiFlexGroup alignItems="baseline" gutterSize="xs"> - <EuiFlexItem> + <EuiFlexGroup alignItems="baseline" gutterSize="xs" data-test-subj="pushed-service-label-title"> + <EuiFlexItem data-test-subj="pushed-label"> {firstIndexPushToService === index ? i18n.PUSHED_NEW_INCIDENT : i18n.UPDATE_INCIDENT} </EuiFlexItem> <EuiFlexItem grow={false}> - <EuiLink href={pushedVal?.external_url} target="_blank"> + <EuiLink data-test-subj="pushed-value" href={pushedVal?.external_url} target="_blank"> {pushedVal?.connector_name} {pushedVal?.external_title} </EuiLink> </EuiFlexItem> diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx new file mode 100644 index 0000000000000..0d8cd729b4a1d --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx @@ -0,0 +1,331 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; + +import { Router, routeData, mockHistory, mockLocation } from '../__mock__/router'; +import { getFormMock } from '../__mock__/form'; +import { useUpdateComment } from '../../../../containers/case/use_update_comment'; +import { basicCase, getUserAction } from '../__mock__/case_data'; +import { UserActionTree } from './'; +import { TestProviders } from '../../../../mock'; +import { useFormMock } from '../create/index.test'; +import { wait } from '../../../../lib/helpers'; +import { act } from 'react-dom/test-utils'; +jest.mock( + '../../../../../../../../../src/plugins/es_ui_shared/static/forms/hook_form_lib/hooks/use_form' +); + +const fetchUserActions = jest.fn(); +const onUpdateField = jest.fn(); +const updateCase = jest.fn(); +const defaultProps = { + data: basicCase, + caseUserActions: [], + firstIndexPushToService: -1, + isLoadingDescription: false, + isLoadingUserActions: false, + lastIndexPushToService: -1, + userCanCrud: true, + fetchUserActions, + onUpdateField, + updateCase, +}; +const useUpdateCommentMock = useUpdateComment as jest.Mock; +jest.mock('../../../../containers/case/use_update_comment'); + +const patchComment = jest.fn(); +describe('UserActionTree ', () => { + const sampleData = { + content: 'what a great comment update', + }; + beforeEach(() => { + jest.clearAllMocks(); + jest.resetAllMocks(); + useUpdateCommentMock.mockImplementation(() => ({ + isLoadingIds: [], + patchComment, + })); + const formHookMock = getFormMock(sampleData); + useFormMock.mockImplementation(() => ({ form: formHookMock })); + jest.spyOn(routeData, 'useLocation').mockReturnValue(mockLocation); + }); + + it('Loading spinner when user actions loading and displays fullName/username', () => { + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...{ ...defaultProps, isLoadingUserActions: true }} /> + </Router> + </TestProviders> + ); + expect(wrapper.find(`[data-test-subj="user-actions-loading"]`).exists()).toBeTruthy(); + + expect( + wrapper + .find(`[data-test-subj="user-action-avatar"]`) + .first() + .prop('name') + ).toEqual(defaultProps.data.createdBy.fullName); + expect( + wrapper + .find(`[data-test-subj="user-action-title"] strong`) + .first() + .text() + ).toEqual(defaultProps.data.createdBy.username); + }); + it('Renders service now update line with top and bottom when push is required', () => { + const ourActions = [ + getUserAction(['comment'], 'push-to-service'), + getUserAction(['comment'], 'update'), + ]; + const props = { + ...defaultProps, + caseUserActions: ourActions, + lastIndexPushToService: 0, + }; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + expect(wrapper.find(`[data-test-subj="show-top-footer"]`).exists()).toBeTruthy(); + expect(wrapper.find(`[data-test-subj="show-bottom-footer"]`).exists()).toBeTruthy(); + }); + it('Renders service now update line with top only when push is up to date', () => { + const ourActions = [getUserAction(['comment'], 'push-to-service')]; + const props = { + ...defaultProps, + caseUserActions: ourActions, + lastIndexPushToService: 0, + }; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + expect(wrapper.find(`[data-test-subj="show-top-footer"]`).exists()).toBeTruthy(); + expect(wrapper.find(`[data-test-subj="show-bottom-footer"]`).exists()).toBeFalsy(); + }); + + it('Outlines comment when update move to link is clicked', () => { + const ourActions = [getUserAction(['comment'], 'create'), getUserAction(['comment'], 'update')]; + const props = { + ...defaultProps, + caseUserActions: ourActions, + }; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="comment-create-action"]`) + .first() + .prop('idToOutline') + ).toEqual(''); + wrapper + .find(`[data-test-subj="comment-update-action"] [data-test-subj="move-to-link"]`) + .first() + .simulate('click'); + expect( + wrapper + .find(`[data-test-subj="comment-create-action"]`) + .first() + .prop('idToOutline') + ).toEqual(ourActions[0].commentId); + }); + + it('Switches to markdown when edit is clicked and back to panel when canceled', () => { + const ourActions = [getUserAction(['comment'], 'create')]; + const props = { + ...defaultProps, + caseUserActions: ourActions, + }; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find( + `[data-test-subj="user-action-${props.data.comments[0].id}"] [data-test-subj="user-action-markdown-form"]` + ) + .exists() + ).toEqual(false); + wrapper + .find(`[data-test-subj="comment-create-action"] [data-test-subj="property-actions-ellipses"]`) + .first() + .simulate('click'); + wrapper + .find(`[data-test-subj="comment-create-action"] [data-test-subj="property-actions-pencil"]`) + .first() + .simulate('click'); + expect( + wrapper + .find( + `[data-test-subj="user-action-${props.data.comments[0].id}"] [data-test-subj="user-action-markdown-form"]` + ) + .exists() + ).toEqual(true); + wrapper + .find( + `[data-test-subj="user-action-${props.data.comments[0].id}"] [data-test-subj="user-action-cancel-markdown"]` + ) + .first() + .simulate('click'); + expect( + wrapper + .find( + `[data-test-subj="user-action-${props.data.comments[0].id}"] [data-test-subj="user-action-markdown-form"]` + ) + .exists() + ).toEqual(false); + }); + + it('calls update comment when comment markdown is saved', async () => { + const ourActions = [getUserAction(['comment'], 'create')]; + const props = { + ...defaultProps, + caseUserActions: ourActions, + }; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="comment-create-action"] [data-test-subj="property-actions-ellipses"]`) + .first() + .simulate('click'); + wrapper + .find(`[data-test-subj="comment-create-action"] [data-test-subj="property-actions-pencil"]`) + .first() + .simulate('click'); + wrapper + .find( + `[data-test-subj="user-action-${props.data.comments[0].id}"] [data-test-subj="user-action-save-markdown"]` + ) + .first() + .simulate('click'); + await act(async () => { + await wait(); + wrapper.update(); + expect( + wrapper + .find( + `[data-test-subj="user-action-${props.data.comments[0].id}"] [data-test-subj="user-action-markdown-form"]` + ) + .exists() + ).toEqual(false); + expect(patchComment).toBeCalledWith({ + commentUpdate: sampleData.content, + caseId: props.data.id, + commentId: props.data.comments[0].id, + fetchUserActions, + updateCase, + version: props.data.comments[0].version, + }); + }); + }); + + it('calls update description when description markdown is saved', async () => { + const props = defaultProps; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="description-action"] [data-test-subj="property-actions-ellipses"]`) + .first() + .simulate('click'); + wrapper + .find(`[data-test-subj="description-action"] [data-test-subj="property-actions-pencil"]`) + .first() + .simulate('click'); + wrapper + .find( + `[data-test-subj="user-action-description"] [data-test-subj="user-action-save-markdown"]` + ) + .first() + .simulate('click'); + await act(async () => { + await wait(); + expect( + wrapper + .find( + `[data-test-subj="user-action-${props.data.id}"] [data-test-subj="user-action-markdown-form"]` + ) + .exists() + ).toEqual(false); + expect(onUpdateField).toBeCalledWith('description', sampleData.content); + }); + }); + + it('quotes', async () => { + const commentData = { + comment: '', + }; + const formHookMock = getFormMock(commentData); + const setFieldValue = jest.fn(); + useFormMock.mockImplementation(() => ({ form: { ...formHookMock, setFieldValue } })); + const props = defaultProps; + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="description-action"] [data-test-subj="property-actions-ellipses"]`) + .first() + .simulate('click'); + wrapper + .find(`[data-test-subj="description-action"] [data-test-subj="property-actions-quote"]`) + .first() + .simulate('click'); + expect(setFieldValue).toBeCalledWith('comment', `> ${props.data.description} \n`); + }); + it('Outlines comment when url param is provided', () => { + const commentId = 'neat-comment-id'; + const ourActions = [getUserAction(['comment'], 'create')]; + const props = { + ...defaultProps, + caseUserActions: ourActions, + }; + jest.spyOn(routeData, 'useParams').mockReturnValue({ commentId }); + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTree {...props} /> + </Router> + </TestProviders> + ); + expect( + wrapper + .find(`[data-test-subj="comment-create-action"]`) + .first() + .prop('idToOutline') + ).toEqual(commentId); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx index 0892d5dcb3ee7..f8f3f0651fa3c 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx @@ -60,7 +60,6 @@ export const UserActionTree = React.memo( const currentUser = useCurrentUser(); const [manageMarkdownEditIds, setManangeMardownEditIds] = useState<string[]>([]); const [insertQuote, setInsertQuote] = useState<string | null>(null); - const handleManageMarkdownEditId = useCallback( (id: string) => { if (!manageMarkdownEditIds.includes(id)) { @@ -74,7 +73,6 @@ export const UserActionTree = React.memo( const handleSaveComment = useCallback( ({ id, version }: { id: string; version: string }, content: string) => { - handleManageMarkdownEditId(id); patchComment({ caseId: caseData.id, commentId: id, @@ -135,7 +133,6 @@ export const UserActionTree = React.memo( content={caseData.description} isEditable={manageMarkdownEditIds.includes(DESCRIPTION_ID)} onSaveContent={(content: string) => { - handleManageMarkdownEditId(DESCRIPTION_ID); onUpdateField(DESCRIPTION_ID, content); }} onChangeEditable={handleManageMarkdownEditId} @@ -166,11 +163,11 @@ export const UserActionTree = React.memo( } } }, [commentId, initLoading, isLoadingUserActions, isLoadingIds]); - return ( <> <UserActionItem createdAt={caseData.createdAt} + data-test-subj="description-action" disabled={!userCanCrud} id={DESCRIPTION_ID} isEditable={manageMarkdownEditIds.includes(DESCRIPTION_ID)} @@ -193,6 +190,7 @@ export const UserActionTree = React.memo( <UserActionItem key={action.actionId} createdAt={comment.createdAt} + data-test-subj={`comment-create-action`} disabled={!userCanCrud} id={comment.id} idToOutline={selectedOutlineCommentId} @@ -236,6 +234,7 @@ export const UserActionTree = React.memo( <UserActionItem key={action.actionId} createdAt={action.actionAt} + data-test-subj={`${action.actionField[0]}-${action.action}-action`} disabled={!userCanCrud} id={action.actionId} isEditable={false} @@ -263,11 +262,12 @@ export const UserActionTree = React.memo( {(isLoadingUserActions || isLoadingIds.includes(NEW_ID)) && ( <MyEuiFlexGroup justifyContent="center" alignItems="center"> <EuiFlexItem grow={false}> - <EuiLoadingSpinner size="l" /> + <EuiLoadingSpinner data-test-subj="user-actions-loading" size="l" /> </EuiFlexItem> </MyEuiFlexGroup> )} <UserActionItem + data-test-subj={`add-comment`} createdAt={new Date().toISOString()} disabled={!userCanCrud} id={NEW_ID} diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_item.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_item.tsx index bcb4edd6129a6..0acd0623f9413 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_item.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_item.tsx @@ -21,6 +21,7 @@ import * as i18n from './translations'; interface UserActionItemProps { createdAt: string; + 'data-test-subj'?: string; disabled: boolean; id: string; isEditable: boolean; @@ -112,6 +113,7 @@ const PushedInfoContainer = styled.div` export const UserActionItem = ({ createdAt, disabled, + 'data-test-subj': dataTestSubj, id, idToOutline, isEditable, @@ -130,7 +132,7 @@ export const UserActionItem = ({ username, updatedAt, }: UserActionItemProps) => ( - <UserActionItemContainer gutterSize={'none'} direction="column"> + <UserActionItemContainer data-test-subj={dataTestSubj} gutterSize={'none'} direction="column"> <EuiFlexItem> <EuiFlexGroup gutterSize={'none'}> <EuiFlexItem data-test-subj={`user-action-${id}-avatar`} grow={false}> @@ -145,24 +147,25 @@ export const UserActionItem = ({ {!isEditable && ( <MyEuiPanel className="userAction__panel" + data-test-subj={`user-action-panel`} paddingSize="none" showoutline={id === idToOutline ? 'true' : 'false'} > <UserActionTitle createdAt={createdAt} disabled={disabled} + fullName={fullName} id={id} isLoading={isLoading} labelEditAction={labelEditAction} labelQuoteAction={labelQuoteAction} labelTitle={labelTitle ?? <></>} linkId={linkId} - fullName={fullName} - username={username} - updatedAt={updatedAt} onEdit={onEdit} onQuote={onQuote} outlineComment={outlineComment} + updatedAt={updatedAt} + username={username} /> {markdown} </MyEuiPanel> @@ -171,7 +174,7 @@ export const UserActionItem = ({ </EuiFlexGroup> </EuiFlexItem> {showTopFooter && ( - <PushedContainer> + <PushedContainer data-test-subj="show-top-footer"> <PushedInfoContainer> <EuiText size="xs" color="subdued"> {i18n.ALREADY_PUSHED_TO_SERVICE} @@ -179,7 +182,7 @@ export const UserActionItem = ({ </PushedInfoContainer> <EuiHorizontalRule /> {showBottomFooter && ( - <PushedInfoContainer> + <PushedInfoContainer data-test-subj="show-bottom-footer"> <EuiText size="xs" color="subdued"> {i18n.REQUIRED_UPDATE_TO_SERVICE} </EuiText> diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_markdown.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_markdown.tsx index e8503bf43375c..827fe2df120ab 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_markdown.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_markdown.tsx @@ -62,12 +62,24 @@ export const UserActionMarkdown = ({ return ( <EuiFlexGroup gutterSize="s" alignItems="center"> <EuiFlexItem grow={false}> - <EuiButtonEmpty size="s" onClick={cancelAction} iconType="cross"> + <EuiButtonEmpty + data-test-subj="user-action-cancel-markdown" + size="s" + onClick={cancelAction} + iconType="cross" + > {i18n.CANCEL} </EuiButtonEmpty> </EuiFlexItem> <EuiFlexItem grow={false}> - <EuiButton color="secondary" fill iconType="save" onClick={saveAction} size="s"> + <EuiButton + data-test-subj="user-action-save-markdown" + color="secondary" + fill + iconType="save" + onClick={saveAction} + size="s" + > {i18n.SAVE} </EuiButton> </EuiFlexItem> @@ -77,7 +89,7 @@ export const UserActionMarkdown = ({ [handleCancelAction, handleSaveAction] ); return isEditable ? ( - <Form form={form}> + <Form form={form} data-test-subj="user-action-markdown-form"> <UseField path="content" component={MarkdownEditorForm} @@ -99,7 +111,7 @@ export const UserActionMarkdown = ({ </Form> ) : ( <ContentWrapper> - <Markdown raw={content} data-test-subj="case-view-description" /> + <Markdown raw={content} data-test-subj="user-action-markdown" /> </ContentWrapper> ); }; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx new file mode 100644 index 0000000000000..e2189367068ca --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx @@ -0,0 +1,57 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { mount } from 'enzyme'; +import copy from 'copy-to-clipboard'; +import { Router, routeData, mockHistory } from '../__mock__/router'; +import { caseUserActions as basicUserActions } from '../__mock__/case_data'; +import { UserActionTitle } from './user_action_title'; +import { TestProviders } from '../../../../mock'; + +const outlineComment = jest.fn(); +const onEdit = jest.fn(); +const onQuote = jest.fn(); + +jest.mock('copy-to-clipboard'); +const defaultProps = { + createdAt: basicUserActions[0].actionAt, + disabled: false, + fullName: basicUserActions[0].actionBy.fullName, + id: basicUserActions[0].actionId, + isLoading: false, + labelEditAction: 'labelEditAction', + labelQuoteAction: 'labelQuoteAction', + labelTitle: <>{'cool'}</>, + linkId: basicUserActions[0].commentId, + onEdit, + onQuote, + outlineComment, + updatedAt: basicUserActions[0].actionAt, + username: basicUserActions[0].actionBy.username, +}; + +describe('UserActionTitle ', () => { + beforeEach(() => { + jest.resetAllMocks(); + jest.spyOn(routeData, 'useParams').mockReturnValue({ commentId: '123' }); + }); + + it('Calls copy when copy link is clicked', async () => { + const wrapper = mount( + <TestProviders> + <Router history={mockHistory}> + <UserActionTitle {...defaultProps} /> + </Router> + </TestProviders> + ); + wrapper + .find(`[data-test-subj="copy-link"]`) + .first() + .simulate('click'); + expect(copy).toBeCalledTimes(1); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx index 9ccf921c87602..a1edbab7e1fa2 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx @@ -52,18 +52,18 @@ interface UserActionTitleProps { export const UserActionTitle = ({ createdAt, disabled, + fullName, id, isLoading, labelEditAction, labelQuoteAction, labelTitle, linkId, - fullName, - username, - updatedAt, onEdit, onQuote, outlineComment, + updatedAt, + username, }: UserActionTitleProps) => { const { detailName: caseId } = useParams(); const urlSearch = useGetUrlSearch(navTabs.case); @@ -94,10 +94,7 @@ export const UserActionTitle = ({ const handleAnchorLink = useCallback(() => { copy( - `${window.location.origin}${window.location.pathname}#${SiemPageName.case}/${caseId}/${id}${urlSearch}`, - { - debug: true, - } + `${window.location.origin}${window.location.pathname}#${SiemPageName.case}/${caseId}/${id}${urlSearch}` ); }, [caseId, id, urlSearch]); @@ -106,7 +103,6 @@ export const UserActionTitle = ({ outlineComment(linkId); } }, [linkId, outlineComment]); - return ( <EuiText size="s" className="userAction__title" data-test-subj={`user-action-title`}> <EuiFlexGroup @@ -155,6 +151,7 @@ export const UserActionTitle = ({ <EuiToolTip position="top" content={<p>{i18n.MOVE_TO_ORIGINAL_COMMENT}</p>}> <EuiButtonIcon aria-label={i18n.MOVE_TO_ORIGINAL_COMMENT} + data-test-subj={`move-to-link`} onClick={handleMoveToLink} iconType="arrowUp" /> @@ -165,6 +162,7 @@ export const UserActionTitle = ({ <EuiToolTip position="top" content={<p>{i18n.COPY_REFERENCE_LINK}</p>}> <EuiButtonIcon aria-label={i18n.COPY_REFERENCE_LINK} + data-test-subj={`copy-link`} onClick={handleAnchorLink} iconType="link" id={`${id}-permLink`} @@ -173,7 +171,7 @@ export const UserActionTitle = ({ </EuiFlexItem> {propertyActions.length > 0 && ( <EuiFlexItem grow={false}> - {isLoading && <MySpinner />} + {isLoading && <MySpinner data-test-subj="user-action-title-loading" />} {!isLoading && <PropertyActions propertyActions={propertyActions} />} </EuiFlexItem> )} diff --git a/x-pack/legacy/plugins/siem/public/pages/case/translations.ts b/x-pack/legacy/plugins/siem/public/pages/case/translations.ts index 0d1e6d1435ca3..097b8220156e2 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/translations.ts +++ b/x-pack/legacy/plugins/siem/public/pages/case/translations.ts @@ -131,6 +131,10 @@ export const TAGS = i18n.translate('xpack.siem.case.caseView.tags', { defaultMessage: 'Tags', }); +export const ACTIONS = i18n.translate('xpack.siem.case.allCases.actions', { + defaultMessage: 'Actions', +}); + export const NO_TAGS_AVAILABLE = i18n.translate('xpack.siem.case.allCases.noTagsAvailable', { defaultMessage: 'No tags available', }); diff --git a/x-pack/plugins/case/server/scripts/generate_case_and_comment_data.sh b/x-pack/plugins/case/server/scripts/generate_case_and_comment_data.sh index 9b6f472d798e0..7ec7dc5a70e92 100755 --- a/x-pack/plugins/case/server/scripts/generate_case_and_comment_data.sh +++ b/x-pack/plugins/case/server/scripts/generate_case_and_comment_data.sh @@ -22,9 +22,9 @@ POSTED_COMMENT="$(curl -s -k \ -u ${ELASTICSEARCH_USERNAME}:${ELASTICSEARCH_PASSWORD} \ -X POST "${KIBANA_URL}${SPACE_URL}/api/cases/$CASE_ID/comments" \ -d @${COMMENT} \ - | jq '{ commentId: .id, commentVersion: .version }' -)" + | jq '{ commentId: .comments[0].id, commentVersion: .comments[0].version }' \ +-j)" POSTED_CASE=$(./get_case.sh $CASE_ID | jq '{ caseId: .id, caseVersion: .version }' -j) echo ${POSTED_COMMENT} ${POSTED_CASE} \ - | jq -s add; \ No newline at end of file +| jq -s add; diff --git a/x-pack/plugins/case/server/scripts/generate_case_data.sh b/x-pack/plugins/case/server/scripts/generate_case_data.sh index f8f6142a5d733..d3a4d3833ad2e 100755 --- a/x-pack/plugins/case/server/scripts/generate_case_data.sh +++ b/x-pack/plugins/case/server/scripts/generate_case_data.sh @@ -11,6 +11,6 @@ # ./generate_case_data.sh set -e -./check_env_variables.sh -./post_case.sh | jq '{ id: .id, version: .version }' -j; + ./check_env_variables.sh + ./post_case.sh | jq '{ id: .id, version: .version }'; From d5d610f168895ba373dec0db3d0caa64bf6a4b47 Mon Sep 17 00:00:00 2001 From: Robert Austin <robert.austin@elastic.co> Date: Fri, 10 Apr 2020 12:19:29 -0400 Subject: [PATCH 033/102] Endpoint: Remove unused `lib` module (#63248) --- .../public/applications/endpoint/lib/index.ts | 7 - .../applications/endpoint/lib/saga.test.ts | 114 ------------- .../public/applications/endpoint/lib/saga.ts | 159 ------------------ 3 files changed, 280 deletions(-) delete mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/lib/index.ts delete mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.test.ts delete mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.ts diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/lib/index.ts b/x-pack/plugins/endpoint/public/applications/endpoint/lib/index.ts deleted file mode 100644 index ba2e1ce8f9fe6..0000000000000 --- a/x-pack/plugins/endpoint/public/applications/endpoint/lib/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export * from './saga'; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.test.ts b/x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.test.ts deleted file mode 100644 index 7c06681184085..0000000000000 --- a/x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.test.ts +++ /dev/null @@ -1,114 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { createSagaMiddleware, SagaContext, SagaMiddleware } from './index'; -import { applyMiddleware, createStore, Reducer, Store } from 'redux'; - -describe('saga', () => { - const INCREMENT_COUNTER = 'INCREMENT'; - const DELAYED_INCREMENT_COUNTER = 'DELAYED INCREMENT COUNTER'; - const STOP_SAGA_PROCESSING = 'BREAK ASYNC ITERATOR'; - - const sleep = (ms = 100) => new Promise(resolve => setTimeout(resolve, ms)); - let store: Store; - let reducerA: Reducer; - let sideAffect: (a: unknown, s: unknown) => void; - let sagaExe: (sagaContext: SagaContext) => Promise<void>; - let sagaExeReduxMiddleware: SagaMiddleware; - - beforeEach(() => { - reducerA = jest.fn((prevState = { count: 0 }, { type }) => { - switch (type) { - case INCREMENT_COUNTER: - return { ...prevState, count: prevState.count + 1 }; - default: - return prevState; - } - }); - - sideAffect = jest.fn(); - - sagaExe = jest.fn(async ({ actionsAndState, dispatch }: SagaContext) => { - for await (const { action, state } of actionsAndState()) { - expect(action).toBeDefined(); - expect(state).toBeDefined(); - - if (action.type === STOP_SAGA_PROCESSING) { - break; - } - - sideAffect(action, state); - - if (action.type === DELAYED_INCREMENT_COUNTER) { - await sleep(1); - dispatch({ - type: INCREMENT_COUNTER, - }); - } - } - }); - - sagaExeReduxMiddleware = createSagaMiddleware(sagaExe); - store = createStore(reducerA, applyMiddleware(sagaExeReduxMiddleware)); - }); - - afterEach(() => { - sagaExeReduxMiddleware.stop(); - }); - - test('it does nothing if saga is not started', () => { - expect(sagaExe).not.toHaveBeenCalled(); - }); - - test('it can dispatch store actions once running', async () => { - sagaExeReduxMiddleware.start(); - expect(store.getState()).toEqual({ count: 0 }); - expect(sagaExe).toHaveBeenCalled(); - - store.dispatch({ type: DELAYED_INCREMENT_COUNTER }); - expect(store.getState()).toEqual({ count: 0 }); - - await sleep(); - - expect(sideAffect).toHaveBeenCalled(); - expect(store.getState()).toEqual({ count: 1 }); - }); - - test('it stops processing if break out of loop', async () => { - sagaExeReduxMiddleware.start(); - store.dispatch({ type: DELAYED_INCREMENT_COUNTER }); - await sleep(); - - expect(store.getState()).toEqual({ count: 1 }); - expect(sideAffect).toHaveBeenCalledTimes(2); - - store.dispatch({ type: STOP_SAGA_PROCESSING }); - await sleep(); - - store.dispatch({ type: DELAYED_INCREMENT_COUNTER }); - await sleep(); - - expect(store.getState()).toEqual({ count: 1 }); - expect(sideAffect).toHaveBeenCalledTimes(2); - }); - - test('it stops saga middleware when stop() is called', async () => { - sagaExeReduxMiddleware.start(); - store.dispatch({ type: DELAYED_INCREMENT_COUNTER }); - await sleep(); - - expect(store.getState()).toEqual({ count: 1 }); - expect(sideAffect).toHaveBeenCalledTimes(2); - - sagaExeReduxMiddleware.stop(); - - store.dispatch({ type: DELAYED_INCREMENT_COUNTER }); - await sleep(); - - expect(store.getState()).toEqual({ count: 1 }); - expect(sideAffect).toHaveBeenCalledTimes(2); - }); -}); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.ts b/x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.ts deleted file mode 100644 index 2a79827847f2e..0000000000000 --- a/x-pack/plugins/endpoint/public/applications/endpoint/lib/saga.ts +++ /dev/null @@ -1,159 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { AnyAction, Dispatch, Middleware, MiddlewareAPI } from 'redux'; -import { GlobalState } from '../types'; - -interface QueuedAction<TAction = AnyAction> { - /** - * The Redux action that was dispatched - */ - action: TAction; - /** - * The Global state at the time the action was dispatched - */ - state: GlobalState; -} - -interface IteratorInstance { - queue: QueuedAction[]; - nextResolve: null | ((inst: QueuedAction) => void); -} - -type Saga = (storeContext: SagaContext) => Promise<void>; - -type StoreActionsAndState<TAction = AnyAction> = AsyncIterableIterator<QueuedAction<TAction>>; - -export interface SagaContext<TAction extends AnyAction = AnyAction> { - /** - * A generator function that will `yield` `Promise`s that resolve with a `QueuedAction` - */ - actionsAndState: () => StoreActionsAndState<TAction>; - dispatch: Dispatch<TAction>; -} - -export interface SagaMiddleware extends Middleware { - /** - * Start the saga. Should be called after the `store` has been created - */ - start: () => void; - - /** - * Stop the saga by exiting the internal generator `for await...of` loop. - */ - stop: () => void; -} - -const noop = () => {}; -const STOP = Symbol('STOP'); - -/** - * Creates Saga Middleware for use with Redux. - * - * @param {Saga} saga The `saga` should initialize a long-running `for await...of` loop against - * the return value of the `actionsAndState()` method provided by the `SagaContext`. - * - * @return {SagaMiddleware} - * - * @example - * - * type TPossibleActions = { type: 'add', payload: any[] }; - * //... - * const endpointsSaga = async ({ actionsAndState, dispatch }: SagaContext<TPossibleActions>) => { - * for await (const { action, state } of actionsAndState()) { - * if (action.type === "userRequestedResource") { - * const resourceData = await doApiFetch('of/some/resource'); - * dispatch({ - * type: 'add', - * payload: [ resourceData ] - * }); - * } - * } - * } - * const endpointsSagaMiddleware = createSagaMiddleware(endpointsSaga); - * //.... - * const store = createStore(reducers, [ endpointsSagaMiddleware ]); - */ -export function createSagaMiddleware(saga: Saga): SagaMiddleware { - const iteratorInstances = new Set<IteratorInstance>(); - let runSaga: () => void = noop; - let stopSaga: () => void = noop; - let runningPromise: Promise<symbol>; - - async function* getActionsAndStateIterator(): StoreActionsAndState { - const instance: IteratorInstance = { queue: [], nextResolve: null }; - iteratorInstances.add(instance); - - try { - while (true) { - const actionAndState = await Promise.race([nextActionAndState(), runningPromise]); - - if (actionAndState === STOP) { - break; - } - - yield actionAndState as QueuedAction; - } - } finally { - // If the consumer stops consuming this (e.g. `break` or `return` is called in the `for await` - // then this `finally` block will run and unregister this instance and reset `runSaga` - iteratorInstances.delete(instance); - runSaga = stopSaga = noop; - } - - function nextActionAndState() { - if (instance.queue.length) { - return Promise.resolve(instance.queue.shift() as QueuedAction); - } else { - return new Promise<QueuedAction>(function(resolve) { - instance.nextResolve = resolve; - }); - } - } - } - - function enqueue(value: QueuedAction) { - for (const iteratorInstance of iteratorInstances) { - iteratorInstance.queue.push(value); - if (iteratorInstance.nextResolve !== null) { - iteratorInstance.nextResolve(iteratorInstance.queue.shift() as QueuedAction); - iteratorInstance.nextResolve = null; - } - } - } - - function middleware({ getState, dispatch }: MiddlewareAPI) { - if (runSaga === noop) { - runSaga = saga.bind<null, SagaContext, any[], Promise<void>>(null, { - actionsAndState: getActionsAndStateIterator, - dispatch, - }); - } - return (next: Dispatch<AnyAction>) => (action: AnyAction) => { - // Call the next dispatch method in the middleware chain. - const returnValue = next(action); - - enqueue({ - action, - state: getState(), - }); - - // This will likely be the action itself, unless a middleware further in chain changed it. - return returnValue; - }; - } - - middleware.start = () => { - runningPromise = new Promise(resolve => (stopSaga = () => resolve(STOP))); - runSaga(); - }; - - middleware.stop = () => { - stopSaga(); - }; - - return middleware; -} From f96f928e6990d64cd7abdb4bedadc1d84557d39c Mon Sep 17 00:00:00 2001 From: Wylie Conlon <william.conlon@elastic.co> Date: Fri, 10 Apr 2020 12:29:26 -0400 Subject: [PATCH 034/102] [Lens] Fix error in query from generated suggestion (#63018) * [Lens] Fix error in query from generated suggestion * Update from review comments * Fix test Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../indexpattern_suggestions.test.tsx | 4 ++-- .../indexpattern_suggestions.ts | 15 +++++++-------- .../operations/definitions/terms.test.tsx | 2 +- .../operations/definitions/terms.tsx | 2 +- 4 files changed, 11 insertions(+), 12 deletions(-) diff --git a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.test.tsx b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.test.tsx index e36622f876acd..fe14e5de5c1e3 100644 --- a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.test.tsx +++ b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.test.tsx @@ -824,10 +824,10 @@ describe('IndexPattern Data Source suggestions', () => { state: expect.objectContaining({ layers: expect.objectContaining({ currentLayer: expect.objectContaining({ - columnOrder: ['cola', 'id1'], + columnOrder: ['cola', 'colb'], columns: { cola: initialState.layers.currentLayer.columns.cola, - id1: expect.objectContaining({ + colb: expect.objectContaining({ operationType: 'avg', sourceField: 'memory', }), diff --git a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.ts b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.ts index 96127caa67bb4..d339171a5ae1f 100644 --- a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.ts +++ b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/indexpattern_suggestions.ts @@ -15,8 +15,8 @@ import { operationDefinitionMap, IndexPatternColumn, } from './operations'; -import { hasField } from './utils'; import { operationDefinitions } from './operations/definitions'; +import { hasField } from './utils'; import { IndexPattern, IndexPatternPrivateState, @@ -196,7 +196,7 @@ function addFieldAsMetricOperation( suggestedPriority: undefined, field, }); - const newColumnId = generateId(); + const addedColumnId = generateId(); const [, metrics] = separateBucketColumns(layer); @@ -206,20 +206,19 @@ function addFieldAsMetricOperation( indexPatternId: indexPattern.id, columns: { ...layer.columns, - [newColumnId]: newColumn, + [addedColumnId]: newColumn, }, - columnOrder: [...layer.columnOrder, newColumnId], + columnOrder: [...layer.columnOrder, addedColumnId], }; } - // If only one metric, replace instead of add - const newColumns = { ...layer.columns, [newColumnId]: newColumn }; - delete newColumns[metrics[0]]; + // Replacing old column with new column, keeping the old ID + const newColumns = { ...layer.columns, [metrics[0]]: newColumn }; return { indexPatternId: indexPattern.id, columns: newColumns, - columnOrder: [...layer.columnOrder.filter(c => c !== metrics[0]), newColumnId], + columnOrder: layer.columnOrder, // Order is kept by replacing }; } diff --git a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.test.tsx b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.test.tsx index 226246714f18d..fc0c9746b2f98 100644 --- a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.test.tsx +++ b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.test.tsx @@ -274,7 +274,7 @@ describe('terms', () => { expect(updatedColumn).toBe(initialColumn); }); - it('should switch to alphabetical ordering if the order column is removed', () => { + it('should switch to alphabetical ordering if there are no columns to order by', () => { const termsColumn = termsOperation.onOtherColumnChanged!( { label: 'Top value of category', diff --git a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.tsx b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.tsx index cd0dcc0b7e9ce..387b197c9235c 100644 --- a/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.tsx +++ b/x-pack/legacy/plugins/lens/public/indexpattern_datasource/operations/definitions/terms.tsx @@ -135,7 +135,7 @@ export const termsOperation: OperationDefinition<TermsIndexPatternColumn> = { } return currentColumn; }, - paramEditor: ({ state, setState, currentColumn, columnId: currentColumnId, layerId }) => { + paramEditor: ({ state, setState, currentColumn, layerId }) => { const SEPARATOR = '$$$'; function toValue(orderBy: TermsIndexPatternColumn['params']['orderBy']) { if (orderBy.type === 'alphabetical') { From 9d2ecc7c06d16ece27449fe2907801024dd438ec Mon Sep 17 00:00:00 2001 From: Brent Kimmel <bkimmel@users.noreply.github.com> Date: Fri, 10 Apr 2020 12:38:26 -0400 Subject: [PATCH 035/102] Resolver/node svg 2 html (#62958) * Remove some SVG in Resolver nodes and replace with HTML --- .../public/embeddables/resolver/view/defs.tsx | 44 +--- .../resolver/view/process_event_dot.tsx | 199 ++++++++++-------- 2 files changed, 113 insertions(+), 130 deletions(-) diff --git a/x-pack/plugins/endpoint/public/embeddables/resolver/view/defs.tsx b/x-pack/plugins/endpoint/public/embeddables/resolver/view/defs.tsx index 8ee9bfafc630e..de9c3c7e8f8f3 100644 --- a/x-pack/plugins/endpoint/public/embeddables/resolver/view/defs.tsx +++ b/x-pack/plugins/endpoint/public/embeddables/resolver/view/defs.tsx @@ -5,7 +5,7 @@ */ import React, { memo } from 'react'; -import { saturate, lighten } from 'polished'; +import { saturate } from 'polished'; import { htmlIdGenerator, @@ -79,8 +79,6 @@ const idGenerator = htmlIdGenerator(); * Ids of paint servers to be referenced by fill and stroke attributes */ export const PaintServerIds = { - runningProcess: idGenerator('psRunningProcess'), - runningTrigger: idGenerator('psRunningTrigger'), runningProcessCube: idGenerator('psRunningProcessCube'), runningTriggerCube: idGenerator('psRunningTriggerCube'), terminatedProcessCube: idGenerator('psTerminatedProcessCube'), @@ -93,46 +91,6 @@ export const PaintServerIds = { */ const PaintServers = memo(() => ( <> - <linearGradient - id={PaintServerIds.runningProcess} - x1="0" - y1="0" - x2="1" - y2="0" - spreadMethod="reflect" - gradientUnits="objectBoundingBox" - > - <stop - offset="0%" - stopColor={saturate(0.7, lighten(0.05, NamedColors.runningProcessStart))} - stopOpacity="1" - /> - <stop - offset="100%" - stopColor={saturate(0.7, lighten(0.05, NamedColors.runningProcessEnd))} - stopOpacity="1" - /> - </linearGradient> - <linearGradient - id={PaintServerIds.runningTrigger} - x1="0" - y1="0" - x2="1" - y2="0" - spreadMethod="reflect" - gradientUnits="objectBoundingBox" - > - <stop - offset="0%" - stopColor={saturate(0.7, lighten(0.05, NamedColors.runningTriggerStart))} - stopOpacity="1" - /> - <stop - offset="100%" - stopColor={saturate(0.7, lighten(0.05, NamedColors.runningTriggerEnd))} - stopOpacity="1" - /> - </linearGradient> <linearGradient id={PaintServerIds.terminatedProcessCube} x1="-381.23752" diff --git a/x-pack/plugins/endpoint/public/embeddables/resolver/view/process_event_dot.tsx b/x-pack/plugins/endpoint/public/embeddables/resolver/view/process_event_dot.tsx index 2e3981de74d34..10e331ffff02d 100644 --- a/x-pack/plugins/endpoint/public/embeddables/resolver/view/process_event_dot.tsx +++ b/x-pack/plugins/endpoint/public/embeddables/resolver/view/process_event_dot.tsx @@ -11,7 +11,7 @@ import { htmlIdGenerator, EuiKeyboardAccessible } from '@elastic/eui'; import { useSelector } from 'react-redux'; import { applyMatrix3 } from '../lib/vector2'; import { Vector2, Matrix3, AdjacentProcessMap, ResolverProcessType } from '../types'; -import { SymbolIds, NamedColors, PaintServerIds } from './defs'; +import { SymbolIds, NamedColors } from './defs'; import { ResolverEvent } from '../../../../common/types'; import { useResolverDispatch } from './use_resolver_dispatch'; import * as eventModel from '../../../../common/models/event'; @@ -21,7 +21,7 @@ import * as selectors from '../store/selectors'; const nodeAssets = { runningProcessCube: { cubeSymbol: `#${SymbolIds.runningProcessCube}`, - labelFill: `url(#${PaintServerIds.runningProcess})`, + labelBackground: NamedColors.fullLabelBackground, descriptionFill: NamedColors.empty, descriptionText: i18n.translate('xpack.endpoint.resolver.runningProcess', { defaultMessage: 'Running Process', @@ -29,7 +29,7 @@ const nodeAssets = { }, runningTriggerCube: { cubeSymbol: `#${SymbolIds.runningTriggerCube}`, - labelFill: `url(#${PaintServerIds.runningTrigger})`, + labelBackground: NamedColors.fullLabelBackground, descriptionFill: NamedColors.empty, descriptionText: i18n.translate('xpack.endpoint.resolver.runningTrigger', { defaultMessage: 'Running Trigger', @@ -37,7 +37,7 @@ const nodeAssets = { }, terminatedProcessCube: { cubeSymbol: `#${SymbolIds.terminatedProcessCube}`, - labelFill: NamedColors.fullLabelBackground, + labelBackground: NamedColors.fullLabelBackground, descriptionFill: NamedColors.empty, descriptionText: i18n.translate('xpack.endpoint.resolver.terminatedProcess', { defaultMessage: 'Terminated Process', @@ -45,7 +45,7 @@ const nodeAssets = { }, terminatedTriggerCube: { cubeSymbol: `#${SymbolIds.terminatedTriggerCube}`, - labelFill: NamedColors.fullLabelBackground, + labelBackground: NamedColors.fullLabelBackground, descriptionFill: NamedColors.empty, descriptionText: i18n.translate('xpack.endpoint.resolver.terminatedTrigger', { defaultMessage: 'Terminated Trigger', @@ -114,14 +114,21 @@ export const ProcessEventDot = styled( [left, magFactorX, top] ); + /** + * Type in non-SVG components scales as follows: + * (These values were adjusted to match the proportions in the comps provided by UX/Design) + * 18.75 : The smallest readable font size at which labels/descriptions can be read. Font size will not scale below this. + * 12.5 : A 'slope' at which the font size will scale w.r.t. to zoom level otherwise + */ + const minimumFontSize = 18.75; + const slopeOfFontScale = 12.5; + const fontSizeAdjustmentForScale = magFactorX > 1 ? slopeOfFontScale * (magFactorX - 1) : 0; + const scaledTypeSize = minimumFontSize + fontSizeAdjustmentForScale; + const markerBaseSize = 15; const markerSize = markerBaseSize; const markerPositionOffset = -markerBaseSize / 2; - const labelYOffset = markerPositionOffset + 0.25 * markerSize - 0.5; - - const labelYHeight = markerSize / 1.7647; - /** * An element that should be animated when the node is clicked. */ @@ -136,9 +143,7 @@ export const ProcessEventDot = styled( }) | null; } = React.createRef(); - const { cubeSymbol, labelFill, descriptionFill, descriptionText } = nodeAssets[ - nodeType(event) - ]; + const { cubeSymbol, labelBackground, descriptionText } = nodeAssets[nodeType(event)]; const resolverNodeIdGenerator = useMemo(() => htmlIdGenerator('resolverNode'), []); const nodeId = useMemo(() => resolverNodeIdGenerator(selfId), [ @@ -154,7 +159,7 @@ export const ProcessEventDot = styled( const dispatch = useResolverDispatch(); const handleFocus = useCallback( - (focusEvent: React.FocusEvent<SVGSVGElement>) => { + (focusEvent: React.FocusEvent<HTMLDivElement>) => { dispatch({ type: 'userFocusedOnResolverNode', payload: { @@ -166,7 +171,7 @@ export const ProcessEventDot = styled( ); const handleClick = useCallback( - (clickEvent: React.MouseEvent<SVGSVGElement, MouseEvent>) => { + (clickEvent: React.MouseEvent<HTMLDivElement, MouseEvent>) => { if (animationTarget.current !== null) { (animationTarget.current as any).beginElement(); } @@ -179,14 +184,15 @@ export const ProcessEventDot = styled( }, [animationTarget, dispatch, nodeId] ); - + /* eslint-disable jsx-a11y/click-events-have-key-events */ + /** + * Key event handling (e.g. 'Enter'/'Space') is provisioned by the `EuiKeyboardAccessible` component + */ return ( <EuiKeyboardAccessible> - <svg + <div data-test-subj={'resolverNode'} className={className + ' kbn-resetFocusState'} - viewBox="-15 -15 90 30" - preserveAspectRatio="xMidYMid meet" role="treeitem" aria-level={adjacentNodeMap.level} aria-flowto={ @@ -203,81 +209,100 @@ export const ProcessEventDot = styled( onFocus={handleFocus} tabIndex={-1} > - <g> - <use - xlinkHref={`#${SymbolIds.processCubeActiveBacking}`} - x={-11.35} - y={-11.35} - width={markerSize * 1.5} - height={markerSize * 1.5} - className="backing" - /> - <rect x="7" y="-12.75" width="15" height="10" fill={NamedColors.resolverBackground} /> - <use - role="presentation" - xlinkHref={cubeSymbol} - x={markerPositionOffset} - y={markerPositionOffset} - width={markerSize} - height={markerSize} - opacity="1" - className="cube" - > - <animateTransform - attributeType="XML" - attributeName="transform" - type="scale" - values="1 1; 1 .83; 1 .8; 1 .83; 1 1" - dur="0.2s" - begin="click" - repeatCount="1" - className="squish" - ref={animationTarget} + <svg + viewBox="-15 -15 90 30" + preserveAspectRatio="xMidYMid meet" + style={{ + display: 'block', + width: '100%', + height: '100%', + position: 'absolute', + top: '0', + left: '0', + }} + > + <g> + <use + xlinkHref={`#${SymbolIds.processCubeActiveBacking}`} + x={-11.35} + y={-11.35} + width={markerSize * 1.5} + height={markerSize * 1.5} + className="backing" /> - </use> - <use - role="presentation" - xlinkHref={`#${SymbolIds.processNodeLabel}`} - x={markerPositionOffset + markerSize - 0.5} - y={labelYOffset} - width={(markerSize / 1.7647) * 5} - height={markerSize / 1.7647} - opacity="1" - fill={labelFill} - /> - <text - x={markerPositionOffset + 0.7 * markerSize + 50 / 2} - y={labelYOffset + labelYHeight / 2} - textAnchor="middle" - dominantBaseline="middle" - fontSize="3.75" - fontWeight="bold" - fill={NamedColors.empty} - paintOrder="stroke" - tabIndex={-1} - style={{ letterSpacing: '-0.02px' }} - id={labelId} - > - {eventModel.eventName(event)} - </text> - <text - x={markerPositionOffset + markerSize} - y={labelYOffset - 1} - textAnchor="start" - dominantBaseline="middle" - fontSize="2.67" - fill={descriptionFill} + <use + role="presentation" + xlinkHref={cubeSymbol} + x={markerPositionOffset} + y={markerPositionOffset} + width={markerSize} + height={markerSize} + opacity="1" + className="cube" + > + <animateTransform + attributeType="XML" + attributeName="transform" + type="scale" + values="1 1; 1 .83; 1 .8; 1 .83; 1 1" + dur="0.2s" + begin="click" + repeatCount="1" + className="squish" + ref={animationTarget} + /> + </use> + </g> + </svg> + <div + style={{ + left: '25%', + top: '30%', + position: 'absolute', + width: '50%', + color: 'white', + fontSize: `${scaledTypeSize}px`, + lineHeight: '140%', + }} + > + <div id={descriptionId} - paintOrder="stroke" - fontWeight="bold" - style={{ textTransform: 'uppercase', letterSpacing: '-0.01px' }} + style={{ + textTransform: 'uppercase', + letterSpacing: '-0.01px', + backgroundColor: NamedColors.resolverBackground, + lineHeight: '1.2', + fontWeight: 'bold', + fontSize: '.5em', + width: '100%', + margin: '0 0 .05em 0', + textAlign: 'left', + padding: '0', + }} > {descriptionText} - </text> - </g> - </svg> + </div> + <div + data-test-subject="nodeLabel" + id={labelId} + style={{ + backgroundColor: labelBackground, + padding: '.15em 0', + textAlign: 'center', + maxWidth: '100%', + overflow: 'hidden', + whiteSpace: 'nowrap', + textOverflow: 'ellipsis', + contain: 'content', + }} + > + {eventModel.eventName(event)} + </div> + </div> + </div> </EuiKeyboardAccessible> ); + /* eslint-enable jsx-a11y/click-events-have-key-events */ } ) )` From aed5253b53fdf53781b6220dbe937510cb7ed378 Mon Sep 17 00:00:00 2001 From: Tim Sullivan <tsullivan@users.noreply.github.com> Date: Fri, 10 Apr 2020 09:57:59 -0700 Subject: [PATCH 036/102] [Reporting] convert all server unit tests to TypeScript (#62873) * [Reporting] convert all server unit tests to TypeScript * fix ts * revert unrelated change --- ...{index.test.js.snap => index.test.ts.snap} | 0 ...xecute_job.test.js => execute_job.test.ts} | 227 ++++++++++-------- .../{index.test.js => index.test.ts} | 61 +++-- .../{index.test.js => index.test.ts} | 52 ++-- .../{index.test.js => index.test.ts} | 2 +- .../routes/{jobs.test.js => jobs.test.ts} | 36 +-- ...t.js => reporting_usage_collector.test.ts} | 58 +++-- .../create_mock_browserdriverfactory.ts | 2 +- x-pack/legacy/plugins/reporting/types.d.ts | 2 +- 9 files changed, 273 insertions(+), 167 deletions(-) rename x-pack/legacy/plugins/reporting/__snapshots__/{index.test.js.snap => index.test.ts.snap} (100%) rename x-pack/legacy/plugins/reporting/export_types/csv/server/{execute_job.test.js => execute_job.test.ts} (88%) rename x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/{index.test.js => index.test.ts} (58%) rename x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/{index.test.js => index.test.ts} (57%) rename x-pack/legacy/plugins/reporting/{index.test.js => index.test.ts} (94%) rename x-pack/legacy/plugins/reporting/server/routes/{jobs.test.js => jobs.test.ts} (91%) rename x-pack/legacy/plugins/reporting/server/usage/{reporting_usage_collector.test.js => reporting_usage_collector.test.ts} (90%) diff --git a/x-pack/legacy/plugins/reporting/__snapshots__/index.test.js.snap b/x-pack/legacy/plugins/reporting/__snapshots__/index.test.ts.snap similarity index 100% rename from x-pack/legacy/plugins/reporting/__snapshots__/index.test.js.snap rename to x-pack/legacy/plugins/reporting/__snapshots__/index.test.ts.snap diff --git a/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js b/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.ts similarity index 88% rename from x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js rename to x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.ts index 4870e1e35cdaf..f0afade8629ab 100644 --- a/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.js +++ b/x-pack/legacy/plugins/reporting/export_types/csv/server/execute_job.test.ts @@ -4,6 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ +// @ts-ignore import Puid from 'puid'; import sinon from 'sinon'; import nodeCrypto from '@elastic/node-crypto'; @@ -13,36 +14,40 @@ import { createMockReportingCore } from '../../../test_helpers'; import { LevelLogger } from '../../../server/lib/level_logger'; import { setFieldFormats } from '../../../server/services'; import { executeJobFactory } from './execute_job'; +import { JobDocPayloadDiscoverCsv } from '../types'; import { CSV_BOM_CHARS } from '../../../common/constants'; -const delay = ms => new Promise(resolve => setTimeout(() => resolve(), ms)); +const delay = (ms: number) => new Promise(resolve => setTimeout(() => resolve(), ms)); const puid = new Puid(); const getRandomScrollId = () => { return puid.generate(); }; +const getJobDocPayload = (baseObj: any) => baseObj as JobDocPayloadDiscoverCsv; + describe('CSV Execute Job', function() { const encryptionKey = 'testEncryptionKey'; const headers = { sid: 'test', }; const mockLogger = new LevelLogger({ - get: () => ({ - debug: jest.fn(), - warn: jest.fn(), - error: jest.fn(), - }), + get: () => + ({ + debug: jest.fn(), + warn: jest.fn(), + error: jest.fn(), + } as any), }); - let defaultElasticsearchResponse; - let encryptedHeaders; + let defaultElasticsearchResponse: any; + let encryptedHeaders: any; - let clusterStub; - let configGetStub; - let mockReportingConfig; - let mockReportingPlugin; - let callAsCurrentUserStub; - let cancellationToken; + let clusterStub: any; + let configGetStub: any; + let mockReportingConfig: any; + let mockReportingPlugin: any; + let callAsCurrentUserStub: any; + let cancellationToken: any; const mockElasticsearch = { dataClient: { @@ -78,7 +83,7 @@ describe('CSV Execute Job', function() { _scroll_id: 'defaultScrollId', }; clusterStub = { - callAsCurrentUser: function() {}, + callAsCurrentUser() {}, }; callAsCurrentUserStub = sinon @@ -89,17 +94,19 @@ describe('CSV Execute Job', function() { mockUiSettingsClient.get.withArgs('csv:quoteValues').returns(true); setFieldFormats({ - fieldFormatServiceFactory: function() { + fieldFormatServiceFactory() { const uiConfigMock = {}; - uiConfigMock['format:defaultTypeMap'] = { + (uiConfigMock as any)['format:defaultTypeMap'] = { _default_: { id: 'string', params: {} }, }; const fieldFormatsRegistry = new fieldFormats.FieldFormatsRegistry(); - fieldFormatsRegistry.init(key => uiConfigMock[key], {}, [fieldFormats.StringFormat]); + fieldFormatsRegistry.init(key => (uiConfigMock as any)[key], {}, [ + fieldFormats.StringFormat, + ]); - return fieldFormatsRegistry; + return Promise.resolve(fieldFormatsRegistry); }, }); }); @@ -109,7 +116,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); await executeJob( 'job456', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); expect(callAsCurrentUserStub.called).toBe(true); @@ -123,14 +134,14 @@ describe('CSV Execute Job', function() { }; const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const job = { + const job = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index, body, }, - }; + }); await executeJob('job777', job, cancellationToken); @@ -152,7 +163,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); await executeJob( 'job456', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); @@ -166,7 +181,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); await executeJob( 'job456', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); @@ -196,7 +215,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); await executeJob( 'job456', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); @@ -231,7 +254,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); await executeJob( 'job456', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); @@ -257,12 +284,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: undefined, searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot(`[TypeError: Cannot read property 'indexOf' of undefined]`); @@ -284,12 +311,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { csv_contains_formulas: csvContainsFormulas } = await executeJob( 'job123', jobParams, @@ -309,12 +336,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['=SUM(A1:A2)', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { csv_contains_formulas: csvContainsFormulas } = await executeJob( 'job123', jobParams, @@ -334,12 +361,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { csv_contains_formulas: csvContainsFormulas } = await executeJob( 'job123', jobParams, @@ -359,12 +386,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { csv_contains_formulas: csvContainsFormulas } = await executeJob( 'job123', jobParams, @@ -386,12 +413,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); expect(content).toEqual(`${CSV_BOM_CHARS}one,two\none,bar\n`); @@ -407,12 +434,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); expect(content).toEqual('one,two\none,bar\n'); @@ -423,11 +450,11 @@ describe('CSV Execute Job', function() { it('should reject Promise if search call errors out', async function() { callAsCurrentUserStub.rejects(new Error()); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot(`[Error]`); @@ -442,11 +469,11 @@ describe('CSV Execute Job', function() { }); callAsCurrentUserStub.onSecondCall().rejects(new Error()); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot(`[Error]`); @@ -463,11 +490,11 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot( @@ -484,11 +511,11 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot( @@ -512,11 +539,11 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot( @@ -540,11 +567,11 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null }, - }; + }); await expect( executeJob('job123', jobParams, cancellationToken) ).rejects.toMatchInlineSnapshot( @@ -578,7 +605,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); executeJob( 'job345', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); @@ -593,13 +624,17 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); executeJob( 'job345', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); cancellationToken.cancel(); for (let i = 0; i < callAsCurrentUserStub.callCount; ++i) { - expect(callAsCurrentUserStub.getCall(i).args[1]).to.not.be('clearScroll'); + expect(callAsCurrentUserStub.getCall(i).args[1]).not.toBe('clearScroll'); // dead code? } }); @@ -607,7 +642,11 @@ describe('CSV Execute Job', function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); executeJob( 'job345', - { headers: encryptedHeaders, fields: [], searchRequest: { index: null, body: null } }, + getJobDocPayload({ + headers: encryptedHeaders, + fields: [], + searchRequest: { index: null, body: null }, + }), cancellationToken ); await delay(100); @@ -623,11 +662,11 @@ describe('CSV Execute Job', function() { describe('csv content', function() { it('should write column headers to output, even if there are no results', async function() { const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); expect(content).toBe(`one,two\n`); }); @@ -635,11 +674,11 @@ describe('CSV Execute Job', function() { it('should use custom uiSettings csv:separator for header', async function() { mockUiSettingsClient.get.withArgs('csv:separator').returns(';'); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); expect(content).toBe(`one;two\n`); }); @@ -647,11 +686,11 @@ describe('CSV Execute Job', function() { it('should escape column headers if uiSettings csv:quoteValues is true', async function() { mockUiSettingsClient.get.withArgs('csv:quoteValues').returns(true); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one and a half', 'two', 'three-and-four', 'five & six'], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); expect(content).toBe(`"one and a half",two,"three-and-four","five & six"\n`); }); @@ -659,11 +698,11 @@ describe('CSV Execute Job', function() { it(`shouldn't escape column headers if uiSettings csv:quoteValues is false`, async function() { mockUiSettingsClient.get.withArgs('csv:quoteValues').returns(false); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one and a half', 'two', 'three-and-four', 'five & six'], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); expect(content).toBe(`one and a half,two,three-and-four,five & six\n`); }); @@ -677,11 +716,11 @@ describe('CSV Execute Job', function() { _scroll_id: 'scrollId', }); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); const lines = content.split('\n'); const headerLine = lines[0]; @@ -697,12 +736,12 @@ describe('CSV Execute Job', function() { _scroll_id: 'scrollId', }); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); const lines = content.split('\n'); const valuesLine = lines[1]; @@ -724,12 +763,12 @@ describe('CSV Execute Job', function() { _scroll_id: 'scrollId', }); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); const lines = content.split('\n'); @@ -746,7 +785,7 @@ describe('CSV Execute Job', function() { _scroll_id: 'scrollId', }); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], @@ -760,7 +799,7 @@ describe('CSV Execute Job', function() { fieldFormatMap: '{"one":{"id":"string","params":{"transform": "upper"}}}', }, }, - }; + }); const { content } = await executeJob('job123', jobParams, cancellationToken); const lines = content.split('\n'); @@ -774,18 +813,18 @@ describe('CSV Execute Job', function() { // tests use these 'simple' characters to make the math easier describe('when only the headers exceed the maxSizeBytes', function() { - let content; - let maxSizeReached; + let content: string; + let maxSizeReached: boolean; beforeEach(async function() { configGetStub.withArgs('csv', 'maxSizeBytes').returns(1); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], searchRequest: { index: null, body: null }, - }; + }); ({ content, max_size_reached: maxSizeReached } = await executeJob( 'job123', @@ -804,18 +843,18 @@ describe('CSV Execute Job', function() { }); describe('when headers are equal to maxSizeBytes', function() { - let content; - let maxSizeReached; + let content: string; + let maxSizeReached: boolean; beforeEach(async function() { configGetStub.withArgs('csv', 'maxSizeBytes').returns(9); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], searchRequest: { index: null, body: null }, - }; + }); ({ content, max_size_reached: maxSizeReached } = await executeJob( 'job123', @@ -834,8 +873,8 @@ describe('CSV Execute Job', function() { }); describe('when the data exceeds the maxSizeBytes', function() { - let content; - let maxSizeReached; + let content: string; + let maxSizeReached: boolean; beforeEach(async function() { configGetStub.withArgs('csv', 'maxSizeBytes').returns(9); @@ -848,12 +887,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); ({ content, max_size_reached: maxSizeReached } = await executeJob( 'job123', @@ -872,8 +911,8 @@ describe('CSV Execute Job', function() { }); describe('when headers and data equal the maxSizeBytes', function() { - let content; - let maxSizeReached; + let content: string; + let maxSizeReached: boolean; beforeEach(async function() { mockReportingPlugin.getUiSettingsServiceFactory = () => mockUiSettingsClient; @@ -887,12 +926,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); ({ content, max_size_reached: maxSizeReached } = await executeJob( 'job123', @@ -924,12 +963,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); await executeJob('job123', jobParams, cancellationToken); @@ -950,12 +989,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); await executeJob('job123', jobParams, cancellationToken); @@ -976,12 +1015,12 @@ describe('CSV Execute Job', function() { }); const executeJob = await executeJobFactory(mockReportingPlugin, mockLogger); - const jobParams = { + const jobParams = getJobDocPayload({ headers: encryptedHeaders, fields: ['one', 'two'], conflictedTypesFields: [], searchRequest: { index: null, body: null }, - }; + }); await executeJob('job123', jobParams, cancellationToken); diff --git a/x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/index.test.js b/x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/index.test.ts similarity index 58% rename from x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/index.test.js rename to x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/index.test.ts index cb63e7dad2fdf..c9cba64a732b6 100644 --- a/x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/index.test.js +++ b/x-pack/legacy/plugins/reporting/export_types/png/server/execute_job/index.test.ts @@ -5,19 +5,22 @@ */ import * as Rx from 'rxjs'; -import { createMockReportingCore } from '../../../../test_helpers'; +import { createMockReportingCore, createMockBrowserDriverFactory } from '../../../../test_helpers'; import { cryptoFactory } from '../../../../server/lib/crypto'; import { executeJobFactory } from './index'; import { generatePngObservableFactory } from '../lib/generate_png'; +import { CancellationToken } from '../../../../common/cancellation_token'; import { LevelLogger } from '../../../../server/lib'; +import { ReportingCore, CaptureConfig } from '../../../../server/types'; +import { JobDocPayloadPNG } from '../../types'; jest.mock('../lib/generate_png', () => ({ generatePngObservableFactory: jest.fn() })); -let mockReporting; +let mockReporting: ReportingCore; -const cancellationToken = { +const cancellationToken = ({ on: jest.fn(), -}; +} as unknown) as CancellationToken; const mockLoggerFactory = { get: jest.fn().mockImplementation(() => ({ @@ -28,12 +31,16 @@ const mockLoggerFactory = { }; const getMockLogger = () => new LevelLogger(mockLoggerFactory); +const captureConfig = {} as CaptureConfig; + const mockEncryptionKey = 'abcabcsecuresecret'; -const encryptHeaders = async headers => { +const encryptHeaders = async (headers: Record<string, string>) => { const crypto = cryptoFactory(mockEncryptionKey); return await crypto.encrypt(headers); }; +const getJobDocPayload = (baseObj: any) => baseObj as JobDocPayloadPNG; + beforeEach(async () => { const kbnConfig = { 'server.basePath': '/sbp', @@ -45,8 +52,8 @@ beforeEach(async () => { 'kibanaServer.protocol': 'http', }; const mockReportingConfig = { - get: (...keys) => reportingConfig[keys.join('.')], - kbnConfig: { get: (...keys) => kbnConfig[keys.join('.')] }, + get: (...keys: string[]) => (reportingConfig as any)[keys.join('.')], + kbnConfig: { get: (...keys: string[]) => (kbnConfig as any)[keys.join('.')] }, }; mockReporting = await createMockReportingCore(mockReportingConfig); @@ -60,22 +67,30 @@ beforeEach(async () => { mockGetElasticsearch.mockImplementation(() => Promise.resolve(mockElasticsearch)); mockReporting.getElasticsearchService = mockGetElasticsearch; - generatePngObservableFactory.mockReturnValue(jest.fn()); + (generatePngObservableFactory as jest.Mock).mockReturnValue(jest.fn()); }); -afterEach(() => generatePngObservableFactory.mockReset()); +afterEach(() => (generatePngObservableFactory as jest.Mock).mockReset()); test(`passes browserTimezone to generatePng`, async () => { const encryptedHeaders = await encryptHeaders({}); + const mockBrowserDriverFactory = await createMockBrowserDriverFactory(getMockLogger()); - const generatePngObservable = generatePngObservableFactory(); - generatePngObservable.mockReturnValue(Rx.of(Buffer.from(''))); + const generatePngObservable = generatePngObservableFactory( + captureConfig, + mockBrowserDriverFactory + ); + (generatePngObservable as jest.Mock).mockReturnValue(Rx.of(Buffer.from(''))); const executeJob = await executeJobFactory(mockReporting, getMockLogger()); const browserTimezone = 'UTC'; await executeJob( 'pngJobId', - { relativeUrl: '/app/kibana#/something', browserTimezone, headers: encryptedHeaders }, + getJobDocPayload({ + relativeUrl: '/app/kibana#/something', + browserTimezone, + headers: encryptedHeaders, + }), cancellationToken ); @@ -92,12 +107,17 @@ test(`returns content_type of application/png`, async () => { const executeJob = await executeJobFactory(mockReporting, getMockLogger()); const encryptedHeaders = await encryptHeaders({}); - const generatePngObservable = generatePngObservableFactory(); - generatePngObservable.mockReturnValue(Rx.of(Buffer.from(''))); + const mockBrowserDriverFactory = await createMockBrowserDriverFactory(getMockLogger()); + + const generatePngObservable = generatePngObservableFactory( + captureConfig, + mockBrowserDriverFactory + ); + (generatePngObservable as jest.Mock).mockReturnValue(Rx.of(Buffer.from(''))); const { content_type: contentType } = await executeJob( 'pngJobId', - { relativeUrl: '/app/kibana#/something', timeRange: {}, headers: encryptedHeaders }, + getJobDocPayload({ relativeUrl: '/app/kibana#/something', headers: encryptedHeaders }), cancellationToken ); expect(contentType).toBe('image/png'); @@ -106,14 +126,19 @@ test(`returns content_type of application/png`, async () => { test(`returns content of generatePng getBuffer base64 encoded`, async () => { const testContent = 'test content'; - const generatePngObservable = generatePngObservableFactory(); - generatePngObservable.mockReturnValue(Rx.of({ buffer: Buffer.from(testContent) })); + const mockBrowserDriverFactory = await createMockBrowserDriverFactory(getMockLogger()); + + const generatePngObservable = generatePngObservableFactory( + captureConfig, + mockBrowserDriverFactory + ); + (generatePngObservable as jest.Mock).mockReturnValue(Rx.of({ buffer: Buffer.from(testContent) })); const executeJob = await executeJobFactory(mockReporting, getMockLogger()); const encryptedHeaders = await encryptHeaders({}); const { content } = await executeJob( 'pngJobId', - { relativeUrl: '/app/kibana#/something', timeRange: {}, headers: encryptedHeaders }, + getJobDocPayload({ relativeUrl: '/app/kibana#/something', headers: encryptedHeaders }), cancellationToken ); diff --git a/x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/index.test.js b/x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/index.test.ts similarity index 57% rename from x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/index.test.js rename to x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/index.test.ts index c6f07f8ad2d34..c3c0d38584bc1 100644 --- a/x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/index.test.js +++ b/x-pack/legacy/plugins/reporting/export_types/printable_pdf/server/execute_job/index.test.ts @@ -5,19 +5,24 @@ */ import * as Rx from 'rxjs'; -import { createMockReportingCore } from '../../../../test_helpers'; +import { createMockReportingCore, createMockBrowserDriverFactory } from '../../../../test_helpers'; import { cryptoFactory } from '../../../../server/lib/crypto'; -import { executeJobFactory } from './index'; -import { generatePdfObservableFactory } from '../lib/generate_pdf'; import { LevelLogger } from '../../../../server/lib'; +import { CancellationToken } from '../../../../types'; +import { ReportingCore, CaptureConfig } from '../../../../server/types'; +import { generatePdfObservableFactory } from '../lib/generate_pdf'; +import { JobDocPayloadPDF } from '../../types'; +import { executeJobFactory } from './index'; jest.mock('../lib/generate_pdf', () => ({ generatePdfObservableFactory: jest.fn() })); -let mockReporting; +let mockReporting: ReportingCore; -const cancellationToken = { +const cancellationToken = ({ on: jest.fn(), -}; +} as unknown) as CancellationToken; + +const captureConfig = {} as CaptureConfig; const mockLoggerFactory = { get: jest.fn().mockImplementation(() => ({ @@ -29,11 +34,13 @@ const mockLoggerFactory = { const getMockLogger = () => new LevelLogger(mockLoggerFactory); const mockEncryptionKey = 'testencryptionkey'; -const encryptHeaders = async headers => { +const encryptHeaders = async (headers: Record<string, string>) => { const crypto = cryptoFactory(mockEncryptionKey); return await crypto.encrypt(headers); }; +const getJobDocPayload = (baseObj: any) => baseObj as JobDocPayloadPDF; + beforeEach(async () => { const kbnConfig = { 'server.basePath': '/sbp', @@ -45,8 +52,8 @@ beforeEach(async () => { 'kibanaServer.protocol': 'http', }; const mockReportingConfig = { - get: (...keys) => reportingConfig[keys.join('.')], - kbnConfig: { get: (...keys) => kbnConfig[keys.join('.')] }, + get: (...keys: string[]) => (reportingConfig as any)[keys.join('.')], + kbnConfig: { get: (...keys: string[]) => (kbnConfig as any)[keys.join('.')] }, }; mockReporting = await createMockReportingCore(mockReportingConfig); @@ -60,21 +67,26 @@ beforeEach(async () => { mockGetElasticsearch.mockImplementation(() => Promise.resolve(mockElasticsearch)); mockReporting.getElasticsearchService = mockGetElasticsearch; - generatePdfObservableFactory.mockReturnValue(jest.fn()); + (generatePdfObservableFactory as jest.Mock).mockReturnValue(jest.fn()); }); -afterEach(() => generatePdfObservableFactory.mockReset()); +afterEach(() => (generatePdfObservableFactory as jest.Mock).mockReset()); test(`returns content_type of application/pdf`, async () => { - const executeJob = await executeJobFactory(mockReporting, getMockLogger()); + const logger = getMockLogger(); + const executeJob = await executeJobFactory(mockReporting, logger); + const mockBrowserDriverFactory = await createMockBrowserDriverFactory(logger); const encryptedHeaders = await encryptHeaders({}); - const generatePdfObservable = generatePdfObservableFactory(); - generatePdfObservable.mockReturnValue(Rx.of(Buffer.from(''))); + const generatePdfObservable = generatePdfObservableFactory( + captureConfig, + mockBrowserDriverFactory + ); + (generatePdfObservable as jest.Mock).mockReturnValue(Rx.of(Buffer.from(''))); const { content_type: contentType } = await executeJob( 'pdfJobId', - { relativeUrls: [], timeRange: {}, headers: encryptedHeaders }, + getJobDocPayload({ relativeUrls: [], headers: encryptedHeaders }), cancellationToken ); expect(contentType).toBe('application/pdf'); @@ -82,15 +94,19 @@ test(`returns content_type of application/pdf`, async () => { test(`returns content of generatePdf getBuffer base64 encoded`, async () => { const testContent = 'test content'; + const mockBrowserDriverFactory = await createMockBrowserDriverFactory(getMockLogger()); - const generatePdfObservable = generatePdfObservableFactory(); - generatePdfObservable.mockReturnValue(Rx.of({ buffer: Buffer.from(testContent) })); + const generatePdfObservable = generatePdfObservableFactory( + captureConfig, + mockBrowserDriverFactory + ); + (generatePdfObservable as jest.Mock).mockReturnValue(Rx.of({ buffer: Buffer.from(testContent) })); const executeJob = await executeJobFactory(mockReporting, getMockLogger()); const encryptedHeaders = await encryptHeaders({}); const { content } = await executeJob( 'pdfJobId', - { relativeUrls: [], timeRange: {}, headers: encryptedHeaders }, + getJobDocPayload({ relativeUrls: [], headers: encryptedHeaders }), cancellationToken ); diff --git a/x-pack/legacy/plugins/reporting/index.test.js b/x-pack/legacy/plugins/reporting/index.test.ts similarity index 94% rename from x-pack/legacy/plugins/reporting/index.test.js rename to x-pack/legacy/plugins/reporting/index.test.ts index 0d9a717bd7d81..8148adab67874 100644 --- a/x-pack/legacy/plugins/reporting/index.test.js +++ b/x-pack/legacy/plugins/reporting/index.test.ts @@ -27,7 +27,7 @@ const describeWithContext = describe.each([ describeWithContext('config schema with context %j', context => { it('produces correct config', async () => { const schema = await getConfigSchema(reporting); - const value = await schema.validate({}, { context }); + const value: any = await schema.validate({}, { context }); value.capture.browser.chromium.disableSandbox = '<platform dependent>'; await expect(value).toMatchSnapshot(); }); diff --git a/x-pack/legacy/plugins/reporting/server/routes/jobs.test.js b/x-pack/legacy/plugins/reporting/server/routes/jobs.test.ts similarity index 91% rename from x-pack/legacy/plugins/reporting/server/routes/jobs.test.js rename to x-pack/legacy/plugins/reporting/server/routes/jobs.test.ts index 9f0de844df369..5c58a7dfa0110 100644 --- a/x-pack/legacy/plugins/reporting/server/routes/jobs.test.js +++ b/x-pack/legacy/plugins/reporting/server/routes/jobs.test.ts @@ -6,7 +6,10 @@ import Hapi from 'hapi'; import { createMockReportingCore } from '../../test_helpers'; +import { ExportTypeDefinition } from '../../types'; import { ExportTypesRegistry } from '../lib/export_types_registry'; +import { LevelLogger } from '../lib/level_logger'; +import { ReportingConfig, ReportingCore, ReportingSetupDeps } from '../types'; jest.mock('./lib/authorized_user_pre_routing', () => ({ authorizedUserPreRoutingFactory: () => () => ({}), @@ -19,14 +22,14 @@ jest.mock('./lib/reporting_feature_pre_routing', () => ({ import { registerJobInfoRoutes } from './jobs'; -let mockServer; -let exportTypesRegistry; -let mockReportingPlugin; -let mockReportingConfig; -const mockLogger = { +let mockServer: any; +let exportTypesRegistry: ExportTypesRegistry; +let mockReportingPlugin: ReportingCore; +let mockReportingConfig: ReportingConfig; +const mockLogger = ({ error: jest.fn(), debug: jest.fn(), -}; +} as unknown) as LevelLogger; beforeEach(async () => { mockServer = new Hapi.Server({ debug: false, port: 8080, routes: { log: { collect: true } } }); @@ -35,38 +38,39 @@ beforeEach(async () => { id: 'unencoded', jobType: 'unencodedJobType', jobContentExtension: 'csv', - }); + } as ExportTypeDefinition<unknown, unknown, unknown, unknown>); exportTypesRegistry.register({ id: 'base64Encoded', jobType: 'base64EncodedJobType', jobContentEncoding: 'base64', jobContentExtension: 'pdf', - }); + } as ExportTypeDefinition<unknown, unknown, unknown, unknown>); mockReportingConfig = { get: jest.fn(), kbnConfig: { get: jest.fn() } }; mockReportingPlugin = await createMockReportingCore(mockReportingConfig); mockReportingPlugin.getExportTypesRegistry = () => exportTypesRegistry; }); -const mockPlugins = { +const mockPlugins = ({ elasticsearch: { adminClient: { callAsInternalUser: jest.fn() }, }, security: null, -}; +} as unknown) as ReportingSetupDeps; -const getHits = (...sources) => { +const getHits = (...sources: any) => { return { hits: { - hits: sources.map(source => ({ _source: source })), + hits: sources.map((source: object) => ({ _source: source })), }, }; }; -const getErrorsFromRequest = request => - request.logs.filter(log => log.tags.includes('error')).map(log => log.error); +const getErrorsFromRequest = (request: any) => + request.logs.filter((log: any) => log.tags.includes('error')).map((log: any) => log.error); test(`returns 404 if job not found`, async () => { + // @ts-ignore mockPlugins.elasticsearch.adminClient = { callAsInternalUser: jest.fn().mockReturnValue(Promise.resolve(getHits())), }; @@ -84,6 +88,7 @@ test(`returns 404 if job not found`, async () => { }); test(`returns 401 if not valid job type`, async () => { + // @ts-ignore mockPlugins.elasticsearch.adminClient = { callAsInternalUser: jest .fn() @@ -103,6 +108,7 @@ test(`returns 401 if not valid job type`, async () => { describe(`when job is incomplete`, () => { const getIncompleteResponse = async () => { + // @ts-ignore mockPlugins.elasticsearch.adminClient = { callAsInternalUser: jest .fn() @@ -149,6 +155,7 @@ describe(`when job is failed`, () => { status: 'failed', output: { content: 'job failure message' }, }); + // @ts-ignore mockPlugins.elasticsearch.adminClient = { callAsInternalUser: jest.fn().mockReturnValue(Promise.resolve(hits)), }; @@ -194,6 +201,7 @@ describe(`when job is completed`, () => { title, }, }); + // @ts-ignore mockPlugins.elasticsearch.adminClient = { callAsInternalUser: jest.fn().mockReturnValue(Promise.resolve(hits)), }; diff --git a/x-pack/legacy/plugins/reporting/server/usage/reporting_usage_collector.test.js b/x-pack/legacy/plugins/reporting/server/usage/reporting_usage_collector.test.ts similarity index 90% rename from x-pack/legacy/plugins/reporting/server/usage/reporting_usage_collector.test.js rename to x-pack/legacy/plugins/reporting/server/usage/reporting_usage_collector.test.ts index 929109e66914d..dbc674ce36ec8 100644 --- a/x-pack/legacy/plugins/reporting/server/usage/reporting_usage_collector.test.js +++ b/x-pack/legacy/plugins/reporting/server/usage/reporting_usage_collector.test.ts @@ -11,18 +11,21 @@ import { registerReportingUsageCollector, getReportingUsageCollector, } from './reporting_usage_collector'; +import { ReportingConfig } from '../types'; const exportTypesRegistry = getExportTypesRegistry(); function getMockUsageCollection() { class MockUsageCollector { - constructor(_server, { fetch }) { + // @ts-ignore fetch is not used + private fetch: any; + constructor(_server: any, { fetch }: any) { this.fetch = fetch; } } return { - makeUsageCollector: options => { - return new MockUsageCollector(this, options); + makeUsageCollector: (options: any) => { + return new MockUsageCollector(null, options); }, registerCollector: sinon.stub(), }; @@ -51,7 +54,7 @@ function getPluginsMock( xpack_main: mockXpackMain, }, }, - }; + } as any; } const getMockReportingConfig = () => ({ @@ -61,13 +64,13 @@ const getMockReportingConfig = () => ({ const getResponseMock = (customization = {}) => customization; describe('license checks', () => { - let mockConfig; + let mockConfig: ReportingConfig; beforeAll(async () => { mockConfig = getMockReportingConfig(); }); describe('with a basic license', () => { - let usageStats; + let usageStats: any; beforeAll(async () => { const plugins = getPluginsMock({ license: 'basic' }); const callClusterMock = jest.fn(() => Promise.resolve(getResponseMock())); @@ -75,9 +78,12 @@ describe('license checks', () => { mockConfig, plugins.usageCollection, plugins.__LEGACY.plugins.xpack_main.info, - exportTypesRegistry + exportTypesRegistry, + function isReady() { + return Promise.resolve(true); + } ); - usageStats = await fetch(callClusterMock, exportTypesRegistry); + usageStats = await fetch(callClusterMock as any); }); test('sets enables to true', async () => { @@ -94,7 +100,7 @@ describe('license checks', () => { }); describe('with no license', () => { - let usageStats; + let usageStats: any; beforeAll(async () => { const plugins = getPluginsMock({ license: 'none' }); const callClusterMock = jest.fn(() => Promise.resolve(getResponseMock())); @@ -102,9 +108,12 @@ describe('license checks', () => { mockConfig, plugins.usageCollection, plugins.__LEGACY.plugins.xpack_main.info, - exportTypesRegistry + exportTypesRegistry, + function isReady() { + return Promise.resolve(true); + } ); - usageStats = await fetch(callClusterMock, exportTypesRegistry); + usageStats = await fetch(callClusterMock as any); }); test('sets enables to true', async () => { @@ -121,7 +130,7 @@ describe('license checks', () => { }); describe('with platinum license', () => { - let usageStats; + let usageStats: any; beforeAll(async () => { const plugins = getPluginsMock({ license: 'platinum' }); const callClusterMock = jest.fn(() => Promise.resolve(getResponseMock())); @@ -129,9 +138,12 @@ describe('license checks', () => { mockConfig, plugins.usageCollection, plugins.__LEGACY.plugins.xpack_main.info, - exportTypesRegistry + exportTypesRegistry, + function isReady() { + return Promise.resolve(true); + } ); - usageStats = await fetch(callClusterMock, exportTypesRegistry); + usageStats = await fetch(callClusterMock as any); }); test('sets enables to true', async () => { @@ -148,7 +160,7 @@ describe('license checks', () => { }); describe('with no usage data', () => { - let usageStats; + let usageStats: any; beforeAll(async () => { const plugins = getPluginsMock({ license: 'basic' }); const callClusterMock = jest.fn(() => Promise.resolve({})); @@ -156,9 +168,12 @@ describe('license checks', () => { mockConfig, plugins.usageCollection, plugins.__LEGACY.plugins.xpack_main.info, - exportTypesRegistry + exportTypesRegistry, + function isReady() { + return Promise.resolve(true); + } ); - usageStats = await fetch(callClusterMock, exportTypesRegistry); + usageStats = await fetch(callClusterMock as any); }); test('sets enables to true', async () => { @@ -179,7 +194,10 @@ describe('data modeling', () => { mockConfig, plugins.usageCollection, plugins.__LEGACY.plugins.xpack_main.info, - exportTypesRegistry + exportTypesRegistry, + function isReady() { + return Promise.resolve(true); + } ); const callClusterMock = jest.fn(() => Promise.resolve( @@ -303,7 +321,7 @@ describe('data modeling', () => { ) ); - const usageStats = await fetch(callClusterMock); + const usageStats = await fetch(callClusterMock as any); expect(usageStats).toMatchInlineSnapshot(` Object { "PNG": Object { @@ -406,7 +424,7 @@ describe('Ready for collection observable', () => { const makeCollectorSpy = sinon.spy(); usageCollection.makeUsageCollector = makeCollectorSpy; - const plugins = getPluginsMock({ usageCollection }); + const plugins = getPluginsMock({ usageCollection } as any); registerReportingUsageCollector(mockReporting, plugins); const [args] = makeCollectorSpy.firstCall.args; diff --git a/x-pack/legacy/plugins/reporting/test_helpers/create_mock_browserdriverfactory.ts b/x-pack/legacy/plugins/reporting/test_helpers/create_mock_browserdriverfactory.ts index 930aa7601b8cb..6e95bed2ecf92 100644 --- a/x-pack/legacy/plugins/reporting/test_helpers/create_mock_browserdriverfactory.ts +++ b/x-pack/legacy/plugins/reporting/test_helpers/create_mock_browserdriverfactory.ts @@ -92,7 +92,7 @@ const defaultOpts: CreateMockBrowserDriverFactoryOpts = { export const createMockBrowserDriverFactory = async ( logger: Logger, - opts: Partial<CreateMockBrowserDriverFactoryOpts> + opts: Partial<CreateMockBrowserDriverFactoryOpts> = {} ): Promise<HeadlessChromiumDriverFactory> => { const captureConfig = { timeouts: { openUrl: 30000, waitForElements: 30000, renderComplete: 30000 }, diff --git a/x-pack/legacy/plugins/reporting/types.d.ts b/x-pack/legacy/plugins/reporting/types.d.ts index 7334a859005e0..eec7da7dc6733 100644 --- a/x-pack/legacy/plugins/reporting/types.d.ts +++ b/x-pack/legacy/plugins/reporting/types.d.ts @@ -186,7 +186,7 @@ export type ESQueueWorkerExecuteFn<JobDocPayloadType> = ( jobId: string, job: JobDocPayloadType, cancellationToken?: CancellationToken -) => void; +) => Promise<any>; /* * ImmediateExecuteFn receives the job doc payload because the payload was From d8a295dcbc272cfb7479169e2f99c4665c811816 Mon Sep 17 00:00:00 2001 From: Ryland Herrick <ryalnd@gmail.com> Date: Fri, 10 Apr 2020 14:00:11 -0500 Subject: [PATCH 037/102] [SIEM] Link ML Rule card CTA to license_management (#63210) * Link ML Rule card CTA to license_management Taking the user directly to the license management page within kibana (where they could immediately start a trial subscription) is much more actionable than taking them to the subscriptions marketing page. * Revert translation key change Neither of these is totally accurate, and there've already been translations written for the old one. --- .../components/select_rule_type/index.tsx | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/x-pack/legacy/plugins/siem/public/pages/detection_engine/rules/components/select_rule_type/index.tsx b/x-pack/legacy/plugins/siem/public/pages/detection_engine/rules/components/select_rule_type/index.tsx index 9d3b37f1788fa..6f3d299da8d45 100644 --- a/x-pack/legacy/plugins/siem/public/pages/detection_engine/rules/components/select_rule_type/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/detection_engine/rules/components/select_rule_type/index.tsx @@ -19,9 +19,16 @@ import { import { isMlRule } from '../../../../../../common/detection_engine/ml_helpers'; import { RuleType } from '../../../../../../common/detection_engine/types'; import { FieldHook } from '../../../../../shared_imports'; +import { useKibana } from '../../../../../lib/kibana'; import * as i18n from './translations'; -const MlCardDescription = ({ hasValidLicense = false }: { hasValidLicense?: boolean }) => ( +const MlCardDescription = ({ + subscriptionUrl, + hasValidLicense = false, +}: { + subscriptionUrl: string; + hasValidLicense?: boolean; +}) => ( <EuiText size="s"> {hasValidLicense ? ( i18n.ML_TYPE_DESCRIPTION @@ -31,7 +38,7 @@ const MlCardDescription = ({ hasValidLicense = false }: { hasValidLicense?: bool defaultMessage="Access to ML requires a {subscriptionsLink}." values={{ subscriptionsLink: ( - <EuiLink href="https://www.elastic.co/subscriptions" target="_blank"> + <EuiLink href={subscriptionUrl} target="_blank"> <FormattedMessage id="xpack.siem.components.stepDefineRule.ruleTypeField.subscriptionsLink" defaultMessage="Platinum subscription" @@ -69,6 +76,9 @@ export const SelectRuleType: React.FC<SelectRuleTypeProps> = ({ const setMl = useCallback(() => setType('machine_learning'), [setType]); const setQuery = useCallback(() => setType('query'), [setType]); const mlCardDisabled = isReadOnly || !hasValidLicense || !isMlAdmin; + const licensingUrl = useKibana().services.application.getUrlForApp('kibana', { + path: '#/management/elasticsearch/license_management', + }); return ( <EuiFormRow @@ -95,7 +105,9 @@ export const SelectRuleType: React.FC<SelectRuleTypeProps> = ({ <EuiCard data-test-subj="machineLearningRuleType" title={i18n.ML_TYPE_TITLE} - description={<MlCardDescription hasValidLicense={hasValidLicense} />} + description={ + <MlCardDescription subscriptionUrl={licensingUrl} hasValidLicense={hasValidLicense} /> + } icon={<EuiIcon size="l" type="machineLearningApp" />} isDisabled={mlCardDisabled} selectable={{ From 8a283de3c5884e21c245b1136f39132eeb2d976f Mon Sep 17 00:00:00 2001 From: CJ Cenizal <cj@cenizal.com> Date: Fri, 10 Apr 2020 12:05:20 -0700 Subject: [PATCH 038/102] Correctly type ILM's optional dependencies as optional (#63255) And guard against their absence. --- .../public/application/services/ui_metric.ts | 8 +++++--- x-pack/plugins/index_lifecycle_management/public/types.ts | 2 +- .../plugins/index_lifecycle_management/server/plugin.ts | 2 +- x-pack/plugins/index_lifecycle_management/server/types.ts | 2 +- 4 files changed, 8 insertions(+), 6 deletions(-) diff --git a/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts b/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts index ca6c0b44d5804..ca987441c7ce9 100644 --- a/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts +++ b/x-pack/plugins/index_lifecycle_management/public/application/services/ui_metric.ts @@ -23,10 +23,12 @@ import { import { defaultColdPhase, defaultWarmPhase, defaultHotPhase } from '../store/defaults'; -export let trackUiMetric: (metricType: UiStatsMetricType, eventName: string) => void; +export let trackUiMetric = (metricType: UiStatsMetricType, eventName: string) => {}; -export function init(usageCollection: UsageCollectionSetup): void { - trackUiMetric = usageCollection.reportUiStats.bind(usageCollection, UIM_APP_NAME); +export function init(usageCollection?: UsageCollectionSetup): void { + if (usageCollection) { + trackUiMetric = usageCollection.reportUiStats.bind(usageCollection, UIM_APP_NAME); + } } export function getUiMetricsForPhases(phases: any): any { diff --git a/x-pack/plugins/index_lifecycle_management/public/types.ts b/x-pack/plugins/index_lifecycle_management/public/types.ts index f9e0abae56cb4..178884a7ee679 100644 --- a/x-pack/plugins/index_lifecycle_management/public/types.ts +++ b/x-pack/plugins/index_lifecycle_management/public/types.ts @@ -9,7 +9,7 @@ import { ManagementSetup } from '../../../../src/plugins/management/public'; import { IndexManagementPluginSetup } from '../../index_management/public'; export interface PluginsDependencies { - usageCollection: UsageCollectionSetup; + usageCollection?: UsageCollectionSetup; management: ManagementSetup; indexManagement?: IndexManagementPluginSetup; } diff --git a/x-pack/plugins/index_lifecycle_management/server/plugin.ts b/x-pack/plugins/index_lifecycle_management/server/plugin.ts index 48c50f9a48ee5..faeac67f62a21 100644 --- a/x-pack/plugins/index_lifecycle_management/server/plugin.ts +++ b/x-pack/plugins/index_lifecycle_management/server/plugin.ts @@ -75,7 +75,7 @@ export class IndexLifecycleManagementServerPlugin implements Plugin<void, void, }); if (config.ui.enabled) { - if (indexManagement.indexDataEnricher) { + if (indexManagement && indexManagement.indexDataEnricher) { indexManagement.indexDataEnricher.add(indexLifecycleDataEnricher); } } diff --git a/x-pack/plugins/index_lifecycle_management/server/types.ts b/x-pack/plugins/index_lifecycle_management/server/types.ts index 7f64c1a47197a..734d05a82000e 100644 --- a/x-pack/plugins/index_lifecycle_management/server/types.ts +++ b/x-pack/plugins/index_lifecycle_management/server/types.ts @@ -14,7 +14,7 @@ import { isEsError } from './lib/is_es_error'; export interface Dependencies { licensing: LicensingPluginSetup; - indexManagement: IndexManagementPluginSetup; + indexManagement?: IndexManagementPluginSetup; } export interface RouteDependencies { From ed5dd0a32542f9f24656dd3aa9c642362d40801b Mon Sep 17 00:00:00 2001 From: Ahmad Bamieh <ahmadbamieh@gmail.com> Date: Fri, 10 Apr 2020 22:18:11 +0300 Subject: [PATCH 039/102] [Telemetry] use prod keys (#63263) --- package.json | 2 +- .../server/encryption/encrypt.test.mocks.ts | 27 +++++++++++++++++++ .../server/encryption/encrypt.test.ts | 27 ++++++++++++------- .../server/encryption/encrypt.ts | 2 +- .../server/plugin.ts | 5 ++-- yarn.lock | 8 +++--- 6 files changed, 54 insertions(+), 17 deletions(-) create mode 100644 src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.mocks.ts diff --git a/package.json b/package.json index ec72d5b660345..a5d46e7f2bf40 100644 --- a/package.json +++ b/package.json @@ -126,7 +126,7 @@ "@elastic/filesaver": "1.1.2", "@elastic/good": "8.1.1-kibana2", "@elastic/numeral": "2.4.0", - "@elastic/request-crypto": "1.1.2", + "@elastic/request-crypto": "1.1.4", "@elastic/ui-ace": "0.2.3", "@hapi/good-squeeze": "5.2.1", "@hapi/wreck": "^15.0.2", diff --git a/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.mocks.ts b/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.mocks.ts new file mode 100644 index 0000000000000..9a7cb8ba28d04 --- /dev/null +++ b/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.mocks.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. + */ + +export const mockEncrypt = jest.fn(); +export const createRequestEncryptor = jest.fn().mockResolvedValue({ + encrypt: mockEncrypt, +}); + +jest.doMock('@elastic/request-crypto', () => ({ + createRequestEncryptor, +})); diff --git a/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.ts b/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.ts index 4a4ba7aa1f321..c04625eb1dd42 100644 --- a/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.ts +++ b/src/plugins/telemetry_collection_manager/server/encryption/encrypt.test.ts @@ -16,16 +16,9 @@ * specific language governing permissions and limitations * under the License. */ - +import { createRequestEncryptor, mockEncrypt } from './encrypt.test.mocks'; import { telemetryJWKS } from './telemetry_jwks'; import { encryptTelemetry, getKID } from './encrypt'; -import { createRequestEncryptor } from '@elastic/request-crypto'; - -jest.mock('@elastic/request-crypto', () => ({ - createRequestEncryptor: jest.fn().mockResolvedValue({ - encrypt: jest.fn(), - }), -})); describe('getKID', () => { it(`returns 'kibana_dev' kid for development`, async () => { @@ -42,9 +35,25 @@ describe('getKID', () => { }); describe('encryptTelemetry', () => { + afterEach(() => { + mockEncrypt.mockReset(); + }); + it('encrypts payload', async () => { const payload = { some: 'value' }; - await encryptTelemetry(payload, true); + await encryptTelemetry(payload, { isProd: true }); expect(createRequestEncryptor).toBeCalledWith(telemetryJWKS); }); + + it('uses kibana kid on { isProd: true }', async () => { + const payload = { some: 'value' }; + await encryptTelemetry(payload, { isProd: true }); + expect(mockEncrypt).toBeCalledWith('kibana', payload); + }); + + it('uses kibana_dev kid on { isProd: false }', async () => { + const payload = { some: 'value' }; + await encryptTelemetry(payload, { isProd: false }); + expect(mockEncrypt).toBeCalledWith('kibana_dev', payload); + }); }); diff --git a/src/plugins/telemetry_collection_manager/server/encryption/encrypt.ts b/src/plugins/telemetry_collection_manager/server/encryption/encrypt.ts index c20f4b768b7dc..44f053064cfcb 100644 --- a/src/plugins/telemetry_collection_manager/server/encryption/encrypt.ts +++ b/src/plugins/telemetry_collection_manager/server/encryption/encrypt.ts @@ -24,7 +24,7 @@ export function getKID(isProd = false): string { return isProd ? 'kibana' : 'kibana_dev'; } -export async function encryptTelemetry(payload: any, isProd = false): Promise<string[]> { +export async function encryptTelemetry(payload: any, { isProd = false } = {}): Promise<string[]> { const kid = getKID(isProd); const encryptor = await createRequestEncryptor(telemetryJWKS); const clusters = [].concat(payload); diff --git a/src/plugins/telemetry_collection_manager/server/plugin.ts b/src/plugins/telemetry_collection_manager/server/plugin.ts index 7e8dff9e0aec1..f2f20e215c535 100644 --- a/src/plugins/telemetry_collection_manager/server/plugin.ts +++ b/src/plugins/telemetry_collection_manager/server/plugin.ts @@ -158,7 +158,7 @@ export class TelemetryCollectionManagerPlugin if (config.unencrypted) { return optInStats; } - return encryptTelemetry(optInStats, this.isDev); + return encryptTelemetry(optInStats, { isProd: !this.isDev }); } } catch (err) { this.logger.debug(`Failed to collect any opt in stats with registered collections.`); @@ -205,7 +205,8 @@ export class TelemetryCollectionManagerPlugin if (config.unencrypted) { return usageData; } - return encryptTelemetry(usageData, this.isDev); + + return encryptTelemetry(usageData, { isProd: !this.isDev }); } } catch (err) { this.logger.debug( diff --git a/yarn.lock b/yarn.lock index 11abd95498c8d..42f891aa24e25 100644 --- a/yarn.lock +++ b/yarn.lock @@ -1401,10 +1401,10 @@ resolved "https://registry.yarnpkg.com/@elastic/numeral/-/numeral-2.4.0.tgz#883197b7f4bf3c2dd994f53b274769ddfa2bf79a" integrity sha512-uGBKGCNghTgUZPHClji/00v+AKt5nidPTGOIbcT+lbTPVxNB6QPpPLGWtXyrg3QZAxobPM/LAZB1mAqtJeq44Q== -"@elastic/request-crypto@1.1.2": - version "1.1.2" - resolved "https://registry.yarnpkg.com/@elastic/request-crypto/-/request-crypto-1.1.2.tgz#2e323550f546f6286994126d462a9ea480a3bfb1" - integrity sha512-i73wjj1Qi8dGJIy170Z8xyJ760mFNjTbdmcp/nEczqWD0miNW6I5wZ5MNrv7M6CXn2m1wMXiT6qzDYd93Hv1Dw== +"@elastic/request-crypto@1.1.4": + version "1.1.4" + resolved "https://registry.yarnpkg.com/@elastic/request-crypto/-/request-crypto-1.1.4.tgz#2189d5fea65f7afe1de9f5fa3d0dd420e93e3124" + integrity sha512-D5CzSGKkM6BdrVB/HRRTheMsNQOcd2FMUup0O/1hIGUBE8zHh2AYbmSNSpD6LyQAgY39mGkARUi/x+SO0ccVvg== dependencies: "@elastic/node-crypto" "1.1.1" "@types/node-jose" "1.1.0" From eb3fe8eb50be7876128bc592f9ce913259be3ee4 Mon Sep 17 00:00:00 2001 From: Dmitry Lemeshko <dzmitry.lemechko@elastic.co> Date: Fri, 10 Apr 2020 23:05:20 +0300 Subject: [PATCH 040/102] update chromedriver dependency to 81.0.0 (#63266) --- package.json | 2 +- yarn.lock | 38 ++++++++++++++++++++++++++++---------- 2 files changed, 29 insertions(+), 11 deletions(-) diff --git a/package.json b/package.json index a5d46e7f2bf40..2bad3116c9ef2 100644 --- a/package.json +++ b/package.json @@ -401,7 +401,7 @@ "chai": "3.5.0", "chance": "1.0.18", "cheerio": "0.22.0", - "chromedriver": "^80.0.1", + "chromedriver": "^81.0.0", "classnames": "2.2.6", "dedent": "^0.7.0", "delete-empty": "^2.0.0", diff --git a/yarn.lock b/yarn.lock index 42f891aa24e25..8ca25cc18a8a2 100644 --- a/yarn.lock +++ b/yarn.lock @@ -5061,6 +5061,13 @@ dependencies: "@types/yargs-parser" "*" +"@types/yauzl@^2.9.1": + version "2.9.1" + resolved "https://registry.yarnpkg.com/@types/yauzl/-/yauzl-2.9.1.tgz#d10f69f9f522eef3cf98e30afb684a1e1ec923af" + integrity sha512-A1b8SU4D10uoPjwb0lnHmmu8wZhR9d+9o2PKBQT2jU5YPTKsxac6M2qGAdY7VcL+dHHhARVUDmeg0rOrcd9EjA== + dependencies: + "@types/node" "*" + "@types/zen-observable@^0.8.0": version "0.8.0" resolved "https://registry.yarnpkg.com/@types/zen-observable/-/zen-observable-0.8.0.tgz#8b63ab7f1aa5321248aad5ac890a485656dcea4d" @@ -8723,16 +8730,16 @@ chrome-trace-event@^1.0.2: dependencies: tslib "^1.9.0" -chromedriver@^80.0.1: - version "80.0.1" - resolved "https://registry.yarnpkg.com/chromedriver/-/chromedriver-80.0.1.tgz#35c1642e2d864b9e8262f291003e455b0e422917" - integrity sha512-VfRtZUpBUIjeypS+xM40+VD9g4Drv7L2VibG/4+0zX3mMx4KayN6gfKETycPfO6JwQXTLSxEr58fRcrsa8r5xQ== +chromedriver@^81.0.0: + version "81.0.0" + resolved "https://registry.yarnpkg.com/chromedriver/-/chromedriver-81.0.0.tgz#690ba333aedf2b4c4933b6590c3242d3e5f28f3c" + integrity sha512-BA++IQ7O1FzHmNpzMlOfLiSBvPZ946uuhtJjZHEIr/Gb+Ha9jiuGbHiT45l6O3XGbQ8BAwvbmdisjl4rTxro4A== dependencies: "@testim/chrome-version" "^1.0.7" axios "^0.19.2" del "^5.1.0" - extract-zip "^1.6.7" - mkdirp "^1.0.3" + extract-zip "^2.0.0" + mkdirp "^1.0.4" tcp-port-used "^1.0.1" ci-info@^1.0.0: @@ -13161,6 +13168,17 @@ extract-zip@^1.6.6, extract-zip@^1.6.7, extract-zip@^1.7.0: mkdirp "^0.5.4" yauzl "^2.10.0" +extract-zip@^2.0.0: + version "2.0.0" + resolved "https://registry.yarnpkg.com/extract-zip/-/extract-zip-2.0.0.tgz#f53b71d44f4ff5a4527a2259ade000fb8b303492" + integrity sha512-i42GQ498yibjdvIhivUsRslx608whtGoFIhF26Z7O4MYncBxp8CwalOs1lnHy21A9sIohWO2+uiE4SRtC9JXDg== + dependencies: + debug "^4.1.1" + get-stream "^5.1.0" + yauzl "^2.10.0" + optionalDependencies: + "@types/yauzl" "^2.9.1" + extsprintf@1.3.0: version "1.3.0" resolved "https://registry.yarnpkg.com/extsprintf/-/extsprintf-1.3.0.tgz#96918440e3041a7a414f8c52e3c574eb3c3e1e05" @@ -20622,10 +20640,10 @@ mkdirp@0.5.x, "mkdirp@>=0.5 0", mkdirp@^0.5.0, mkdirp@^0.5.1, mkdirp@^0.5.4, mkd dependencies: minimist "^1.2.5" -mkdirp@^1.0.3: - version "1.0.3" - resolved "https://registry.yarnpkg.com/mkdirp/-/mkdirp-1.0.3.tgz#4cf2e30ad45959dddea53ad97d518b6c8205e1ea" - integrity sha512-6uCP4Qc0sWsgMLy1EOqqS/3rjDHOEnsStVr/4vtAIK2Y5i2kA7lFFejYrpIyiN9w0pYf4ckeCYT9f1r1P9KX5g== +mkdirp@^1.0.4: + version "1.0.4" + resolved "https://registry.yarnpkg.com/mkdirp/-/mkdirp-1.0.4.tgz#3eb5ed62622756d79a5f0e2a221dfebad75c2f7e" + integrity sha512-vVqVZQyf3WLx2Shd0qJ9xuvqgAyKPLAiqITEtqW0oIUjzo3PePDd6fW9iFz30ef7Ysp/oiWqbhszeGWW2T6Gzw== mocha-junit-reporter@^1.23.1: version "1.23.1" From 6393e08ce3ba7cee6f138f2dac6db3a37f6953dc Mon Sep 17 00:00:00 2001 From: Candace Park <56409205+parkiino@users.noreply.github.com> Date: Fri, 10 Apr 2020 17:20:40 -0400 Subject: [PATCH 041/102] task/mac-eventing-form (#62999) adds mac events form for endpoint policy details Co-authored-by: oatkiller <robert.austin@elastic.co> --- .../applications/endpoint/models/policy.ts | 4 + .../endpoint/models/policy_details_config.ts | 30 +++++ .../store/policy_details/index.test.ts | 31 ++++- .../endpoint/store/policy_details/reducer.ts | 12 +- .../store/policy_details/selectors.ts | 30 +++-- .../public/applications/endpoint/types.ts | 70 ++++++------ .../endpoint/view/policy/policy_details.tsx | 6 +- .../policy/policy_forms/eventing/checkbox.tsx | 53 --------- .../policy/policy_forms/events/checkbox.tsx | 49 ++++++++ .../view/policy/policy_forms/events/index.tsx | 8 ++ .../view/policy/policy_forms/events/mac.tsx | 106 ++++++++++++++++++ .../{eventing => events}/windows.tsx | 59 +++++----- 12 files changed, 325 insertions(+), 133 deletions(-) delete mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/checkbox.tsx create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/checkbox.tsx create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/mac.tsx rename x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/{eventing => events}/windows.tsx (61%) diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts b/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts index 9ac53f9be609f..30f45e54c2005 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts @@ -42,6 +42,8 @@ export const generatePolicy = (): PolicyConfig => { mac: { events: { process: true, + file: true, + network: true, }, malware: { mode: ProtectionModes.detect, @@ -67,6 +69,8 @@ export const generatePolicy = (): PolicyConfig => { linux: { events: { process: true, + file: true, + network: true, }, logging: { stdout: 'debug', diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/models/policy_details_config.ts b/x-pack/plugins/endpoint/public/applications/endpoint/models/policy_details_config.ts index 1145d1d19242a..bf96942e83a91 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/models/policy_details_config.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/models/policy_details_config.ts @@ -43,3 +43,33 @@ export function clone(policyDetailsConfig: UIPolicyConfig): UIPolicyConfig { */ return clonedConfig as UIPolicyConfig; } + +/** + * Returns value from `configuration` + */ +export const getIn = (a: UIPolicyConfig) => <Key extends keyof UIPolicyConfig>(key: Key) => < + subKey extends keyof UIPolicyConfig[Key] +>( + subKey: subKey +) => <LeafKey extends keyof UIPolicyConfig[Key][subKey]>( + leafKey: LeafKey +): UIPolicyConfig[Key][subKey][LeafKey] => { + return a[key][subKey][leafKey]; +}; + +/** + * Returns cloned `configuration` with `value` set by the `keyPath`. + */ +export const setIn = (a: UIPolicyConfig) => <Key extends keyof UIPolicyConfig>(key: Key) => < + subKey extends keyof UIPolicyConfig[Key] +>( + subKey: subKey +) => <LeafKey extends keyof UIPolicyConfig[Key][subKey]>(leafKey: LeafKey) => < + V extends UIPolicyConfig[Key][subKey][LeafKey] +>( + v: V +): UIPolicyConfig => { + const c = clone(a); + c[key][subKey][leafKey] = v; + return c; +}; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts index cf14092953227..e09a62b235e35 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts @@ -7,7 +7,7 @@ import { PolicyDetailsState } from '../../types'; import { createStore, Dispatch, Store } from 'redux'; import { policyDetailsReducer, PolicyDetailsAction } from './index'; -import { policyConfig, windowsEventing } from './selectors'; +import { policyConfig } from './selectors'; import { clone } from '../../models/policy_details_config'; import { generatePolicy } from '../../models/policy'; @@ -55,7 +55,7 @@ describe('policy details: ', () => { }); }); - describe('when the user has enabled windows process eventing', () => { + describe('when the user has enabled windows process events', () => { beforeEach(() => { const config = policyConfig(getState()); if (!config) { @@ -71,8 +71,31 @@ describe('policy details: ', () => { }); }); - it('windows process eventing is enabled', async () => { - expect(windowsEventing(getState())!.process).toEqual(true); + it('windows process events is enabled', () => { + const config = policyConfig(getState()); + expect(config!.windows.events.process).toEqual(true); + }); + }); + + describe('when the user has enabled mac file events', () => { + beforeEach(() => { + const config = policyConfig(getState()); + if (!config) { + throw new Error(); + } + + const newPayload1 = clone(config); + newPayload1.mac.events.file = true; + + dispatch({ + type: 'userChangedPolicyConfig', + payload: { policyConfig: newPayload1 }, + }); + }); + + it('mac file events is enabled', () => { + const config = policyConfig(getState()); + expect(config!.mac.events.file).toEqual(true); }); }); }); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/reducer.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/reducer.ts index fb3e26157ef32..fb0f371cdae0d 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/reducer.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/reducer.ts @@ -5,7 +5,7 @@ */ import { Reducer } from 'redux'; -import { PolicyData, PolicyDetailsState, UIPolicyConfig } from '../../types'; +import { PolicyDetailsState, UIPolicyConfig } from '../../types'; import { AppAction } from '../action'; import { fullPolicy, isOnPolicyDetailsPage } from './selectors'; @@ -89,10 +89,12 @@ export const policyDetailsReducer: Reducer<PolicyDetailsState, AppAction> = ( } if (action.type === 'userChangedPolicyConfig') { - const newState = { ...state, policyItem: { ...(state.policyItem as PolicyData) } }; - const newPolicy = (newState.policyItem.inputs[0].config.policy.value = { - ...fullPolicy(state), - }); + if (!state.policyItem) { + return state; + } + const newState = { ...state, policyItem: { ...state.policyItem } }; + const newPolicy: any = { ...fullPolicy(state) }; + newState.policyItem.inputs[0].config.policy.value = newPolicy; Object.entries(action.payload.policyConfig).forEach(([section, newSettings]) => { newPolicy[section as keyof UIPolicyConfig] = { diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts index 0d505931c9ec5..4b4dc9d9bee43 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts @@ -79,14 +79,8 @@ export const policyConfig: (s: PolicyDetailsState) => UIPolicyConfig = createSel } ); -/** Returns an object of all the windows eventing configuration */ -export const windowsEventing = (state: PolicyDetailsState) => { - const config = policyConfig(state); - return config && config.windows.events; -}; - /** Returns the total number of possible windows eventing configurations */ -export const totalWindowsEventing = (state: PolicyDetailsState): number => { +export const totalWindowsEvents = (state: PolicyDetailsState): number => { const config = policyConfig(state); if (config) { return Object.keys(config.windows.events).length; @@ -95,7 +89,7 @@ export const totalWindowsEventing = (state: PolicyDetailsState): number => { }; /** Returns the number of selected windows eventing configurations */ -export const selectedWindowsEventing = (state: PolicyDetailsState): number => { +export const selectedWindowsEvents = (state: PolicyDetailsState): number => { const config = policyConfig(state); if (config) { return Object.values(config.windows.events).reduce((count, event) => { @@ -105,6 +99,26 @@ export const selectedWindowsEventing = (state: PolicyDetailsState): number => { return 0; }; +/** Returns the total number of possible mac eventing configurations */ +export const totalMacEvents = (state: PolicyDetailsState): number => { + const config = policyConfig(state); + if (config) { + return Object.keys(config.mac.events).length; + } + return 0; +}; + +/** Returns the number of selected mac eventing configurations */ +export const selectedMacEvents = (state: PolicyDetailsState): number => { + const config = policyConfig(state); + if (config) { + return Object.values(config.mac.events).reduce((count, event) => { + return event === true ? count + 1 : count; + }, 0); + } + return 0; +}; + /** is there an api call in flight */ export const isLoading = (state: PolicyDetailsState) => state.isLoading; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts index d4f6d2457254e..dda50847169e7 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts @@ -118,34 +118,21 @@ export interface PolicyDetailsState { * Endpoint Policy configuration */ export interface PolicyConfig { - windows: { - events: { - process: boolean; - network: boolean; - }; - /** malware mode can be off, detect, prevent or prevent and notify user */ - malware: MalwareFields; + windows: UIPolicyConfig['windows'] & { logging: { stdout: string; file: string; }; advanced: PolicyConfigAdvancedOptions; }; - mac: { - events: { - process: boolean; - }; - malware: MalwareFields; + mac: UIPolicyConfig['mac'] & { logging: { stdout: string; file: string; }; advanced: PolicyConfigAdvancedOptions; }; - linux: { - events: { - process: boolean; - }; + linux: UIPolicyConfig['linux'] & { logging: { stdout: string; file: string; @@ -168,29 +155,39 @@ interface PolicyConfigAdvancedOptions { }; } -/** - * Windows-specific policy configuration that is supported via the UI - */ -type WindowsPolicyConfig = Pick<PolicyConfig['windows'], 'events' | 'malware'>; - -/** - * Mac-specific policy configuration that is supported via the UI - */ -type MacPolicyConfig = Pick<PolicyConfig['mac'], 'malware' | 'events'>; - -/** - * Linux-specific policy configuration that is supported via the UI - */ -type LinuxPolicyConfig = Pick<PolicyConfig['linux'], 'events'>; - /** * The set of Policy configuration settings that are show/edited via the UI */ -export interface UIPolicyConfig { - windows: WindowsPolicyConfig; - mac: MacPolicyConfig; - linux: LinuxPolicyConfig; -} +/* eslint-disable @typescript-eslint/consistent-type-definitions */ +export type UIPolicyConfig = { + windows: { + events: { + process: boolean; + network: boolean; + }; + /** malware mode can be off, detect, prevent or prevent and notify user */ + malware: MalwareFields; + }; + mac: { + events: { + file: boolean; + process: boolean; + network: boolean; + }; + malware: MalwareFields; + }; + + /** + * Linux-specific policy configuration that is supported via the UI + */ + linux: { + events: { + file: boolean; + process: boolean; + network: boolean; + }; + }; +}; /** OS used in Policy */ export enum OS { @@ -203,6 +200,7 @@ export enum OS { export enum EventingFields { process = 'process', network = 'network', + file = 'file', } /** diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx index bc56e5e6f6329..1e723e32615eb 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx @@ -29,12 +29,12 @@ import { isLoading, apiError, } from '../../store/policy_details/selectors'; -import { WindowsEventing } from './policy_forms/eventing/windows'; import { PageView, PageViewHeaderTitle } from '../../components/page_view'; import { AppAction } from '../../types'; import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; import { AgentsSummary } from './agents_summary'; import { VerticalDivider } from './vertical_divider'; +import { WindowsEvents, MacEvents } from './policy_forms/events'; import { MalwareProtections } from './policy_forms/protections/malware'; export const PolicyDetails = React.memo(() => { @@ -206,7 +206,9 @@ export const PolicyDetails = React.memo(() => { </h4> </EuiText> <EuiSpacer size="xs" /> - <WindowsEventing /> + <WindowsEvents /> + <EuiSpacer size="l" /> + <MacEvents /> </PageView> </> ); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/checkbox.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/checkbox.tsx deleted file mode 100644 index 8b7fb89ed1646..0000000000000 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/checkbox.tsx +++ /dev/null @@ -1,53 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React, { useCallback } from 'react'; -import { EuiCheckbox } from '@elastic/eui'; -import { useDispatch } from 'react-redux'; -import { usePolicyDetailsSelector } from '../../policy_hooks'; -import { policyConfig, windowsEventing } from '../../../../store/policy_details/selectors'; -import { PolicyDetailsAction } from '../../../../store/policy_details'; -import { OS, EventingFields } from '../../../../types'; -import { clone } from '../../../../models/policy_details_config'; - -export const EventingCheckbox: React.FC<{ - id: string; - name: string; - os: OS; - protectionField: EventingFields; -}> = React.memo(({ id, name, os, protectionField }) => { - const policyDetailsConfig = usePolicyDetailsSelector(policyConfig); - const eventing = usePolicyDetailsSelector(windowsEventing); - const dispatch = useDispatch<(action: PolicyDetailsAction) => void>(); - - const handleRadioChange = useCallback( - (event: React.ChangeEvent<HTMLInputElement>) => { - if (policyDetailsConfig) { - const newPayload = clone(policyDetailsConfig); - if (os === OS.linux || os === OS.mac) { - newPayload[os].events.process = event.target.checked; - } else { - newPayload[os].events[protectionField] = event.target.checked; - } - - dispatch({ - type: 'userChangedPolicyConfig', - payload: { policyConfig: newPayload }, - }); - } - }, - [dispatch, os, policyDetailsConfig, protectionField] - ); - - return ( - <EuiCheckbox - id={id} - label={name} - checked={eventing && eventing[protectionField]} - onChange={handleRadioChange} - /> - ); -}); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/checkbox.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/checkbox.tsx new file mode 100644 index 0000000000000..bec6b33b85c7f --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/checkbox.tsx @@ -0,0 +1,49 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React, { useCallback, useMemo } from 'react'; +import { EuiCheckbox } from '@elastic/eui'; +import { useDispatch } from 'react-redux'; +import { htmlIdGenerator } from '@elastic/eui'; +import { usePolicyDetailsSelector } from '../../policy_hooks'; +import { policyConfig } from '../../../../store/policy_details/selectors'; +import { PolicyDetailsAction } from '../../../../store/policy_details'; +import { UIPolicyConfig } from '../../../../types'; + +export const EventsCheckbox = React.memo(function({ + name, + setter, + getter, +}: { + name: string; + setter: (config: UIPolicyConfig, checked: boolean) => UIPolicyConfig; + getter: (config: UIPolicyConfig) => boolean; +}) { + const policyDetailsConfig = usePolicyDetailsSelector(policyConfig); + const selected = getter(policyDetailsConfig); + const dispatch = useDispatch<(action: PolicyDetailsAction) => void>(); + + const handleCheckboxChange = useCallback( + (event: React.ChangeEvent<HTMLInputElement>) => { + if (policyDetailsConfig) { + dispatch({ + type: 'userChangedPolicyConfig', + payload: { policyConfig: setter(policyDetailsConfig, event.target.checked) }, + }); + } + }, + [dispatch, policyDetailsConfig, setter] + ); + + return ( + <EuiCheckbox + id={useMemo(() => htmlIdGenerator()(), [])} + label={name} + checked={selected} + onChange={handleCheckboxChange} + /> + ); +}); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx new file mode 100644 index 0000000000000..44716d8183041 --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx @@ -0,0 +1,8 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export { WindowsEvents } from './windows'; +export { MacEvents } from './mac'; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/mac.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/mac.tsx new file mode 100644 index 0000000000000..3b69c21d2b150 --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/mac.tsx @@ -0,0 +1,106 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React, { useMemo } from 'react'; +import { i18n } from '@kbn/i18n'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { EuiTitle, EuiText, EuiSpacer } from '@elastic/eui'; +import { EventsCheckbox } from './checkbox'; +import { OS, UIPolicyConfig } from '../../../../types'; +import { usePolicyDetailsSelector } from '../../policy_hooks'; +import { selectedMacEvents, totalMacEvents } from '../../../../store/policy_details/selectors'; +import { ConfigForm } from '../config_form'; +import { getIn, setIn } from '../../../../models/policy_details_config'; + +export const MacEvents = React.memo(() => { + const selected = usePolicyDetailsSelector(selectedMacEvents); + const total = usePolicyDetailsSelector(totalMacEvents); + + const checkboxes: Array<{ + name: string; + os: 'mac'; + protectionField: keyof UIPolicyConfig['mac']['events']; + }> = useMemo( + () => [ + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.mac.events.file', { + defaultMessage: 'File', + }), + os: OS.mac, + protectionField: 'file', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.mac.events.process', { + defaultMessage: 'Process', + }), + os: OS.mac, + protectionField: 'process', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.mac.events.network', { + defaultMessage: 'Network', + }), + os: OS.mac, + protectionField: 'network', + }, + ], + [] + ); + + const renderCheckboxes = () => { + return ( + <> + <EuiTitle size="xxs"> + <h5> + <FormattedMessage + id="xpack.endpoint.policyDetailsConfig.eventingEvents" + defaultMessage="Events" + /> + </h5> + </EuiTitle> + <EuiSpacer size="s" /> + {checkboxes.map((item, index) => { + return ( + <EventsCheckbox + name={item.name} + key={index} + setter={(config, checked) => + setIn(config)(item.os)('events')(item.protectionField)(checked) + } + getter={config => getIn(config)(item.os)('events')(item.protectionField)} + /> + ); + })} + </> + ); + }; + + const collectionsEnabled = () => { + return ( + <EuiText size="s" color="subdued"> + <FormattedMessage + id="xpack.endpoint.policy.details.eventCollectionsEnabled" + defaultMessage="{selected} / {total} event collections enabled" + values={{ selected, total }} + /> + </EuiText> + ); + }; + + return ( + <ConfigForm + type={i18n.translate('xpack.endpoint.policy.details.eventCollection', { + defaultMessage: 'Event Collection', + })} + supportedOss={[ + i18n.translate('xpack.endpoint.policy.details.mac', { defaultMessage: 'Mac' }), + ]} + id="macEventingForm" + rightCorner={collectionsEnabled()} + children={renderCheckboxes()} + /> + ); +}); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/windows.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx similarity index 61% rename from x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/windows.tsx rename to x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx index 7bec2c4c742d2..63a140912437d 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/eventing/windows.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx @@ -8,40 +8,45 @@ import React, { useMemo } from 'react'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; import { EuiTitle, EuiText, EuiSpacer } from '@elastic/eui'; -import { EventingCheckbox } from './checkbox'; -import { OS, EventingFields } from '../../../../types'; +import { EventsCheckbox } from './checkbox'; +import { OS, UIPolicyConfig } from '../../../../types'; import { usePolicyDetailsSelector } from '../../policy_hooks'; import { - selectedWindowsEventing, - totalWindowsEventing, + selectedWindowsEvents, + totalWindowsEvents, } from '../../../../store/policy_details/selectors'; import { ConfigForm } from '../config_form'; +import { setIn, getIn } from '../../../../models/policy_details_config'; -export const WindowsEventing = React.memo(() => { - const selected = usePolicyDetailsSelector(selectedWindowsEventing); - const total = usePolicyDetailsSelector(totalWindowsEventing); +export const WindowsEvents = React.memo(() => { + const selected = usePolicyDetailsSelector(selectedWindowsEvents); + const total = usePolicyDetailsSelector(totalWindowsEvents); - const checkboxes = useMemo( + const checkboxes: Array<{ + name: string; + os: 'windows'; + protectionField: keyof UIPolicyConfig['windows']['events']; + }> = useMemo( () => [ { - name: i18n.translate('xpack.endpoint.policyDetailsConfig.eventingProcess', { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.process', { defaultMessage: 'Process', }), os: OS.windows, - protectionField: EventingFields.process, + protectionField: 'process', }, { - name: i18n.translate('xpack.endpoint.policyDetailsConfig.eventingNetwork', { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.network', { defaultMessage: 'Network', }), os: OS.windows, - protectionField: EventingFields.network, + protectionField: 'network', }, ], [] ); - const renderCheckboxes = () => { + const renderCheckboxes = useMemo(() => { return ( <> <EuiTitle size="xxs"> @@ -55,20 +60,21 @@ export const WindowsEventing = React.memo(() => { <EuiSpacer size="s" /> {checkboxes.map((item, index) => { return ( - <EventingCheckbox - id={`eventing${item.name}`} + <EventsCheckbox name={item.name} key={index} - os={item.os} - protectionField={item.protectionField} + setter={(config, checked) => + setIn(config)(item.os)('events')(item.protectionField)(checked) + } + getter={config => getIn(config)(item.os)('events')(item.protectionField)} /> ); })} </> ); - }; + }, [checkboxes]); - const collectionsEnabled = () => { + const collectionsEnabled = useMemo(() => { return ( <EuiText size="s" color="subdued"> <FormattedMessage @@ -78,19 +84,22 @@ export const WindowsEventing = React.memo(() => { /> </EuiText> ); - }; + }, [selected, total]); return ( <ConfigForm type={i18n.translate('xpack.endpoint.policy.details.eventCollection', { defaultMessage: 'Event Collection', })} - supportedOss={[ - i18n.translate('xpack.endpoint.policy.details.windows', { defaultMessage: 'Windows' }), - ]} + supportedOss={useMemo( + () => [ + i18n.translate('xpack.endpoint.policy.details.windows', { defaultMessage: 'Windows' }), + ], + [] + )} id="windowsEventingForm" - rightCorner={collectionsEnabled()} - children={renderCheckboxes()} + rightCorner={collectionsEnabled} + children={renderCheckboxes} /> ); }); From 39fbc5e103a50a2d9ef929b05696d478c1090269 Mon Sep 17 00:00:00 2001 From: The SpaceCake Project <randomuserid@users.noreply.github.com> Date: Fri, 10 Apr 2020 17:50:23 -0400 Subject: [PATCH 042/102] bc6 rule import april 9 (#63152) * bc6 rule import april 9 Increased the lookback of the ML rules * re-import with LF chars Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../prepackaged_rules/linux_anomalous_network_activity.json | 2 +- .../linux_anomalous_network_port_activity.json | 2 +- .../prepackaged_rules/linux_anomalous_network_service.json | 2 +- .../prepackaged_rules/linux_anomalous_network_url_activity.json | 2 +- .../prepackaged_rules/linux_anomalous_process_all_hosts.json | 2 +- .../rules/prepackaged_rules/linux_anomalous_user_name.json | 2 +- .../rules/prepackaged_rules/packetbeat_dns_tunneling.json | 2 +- .../rules/prepackaged_rules/packetbeat_rare_dns_question.json | 2 +- .../rules/prepackaged_rules/packetbeat_rare_server_domain.json | 2 +- .../rules/prepackaged_rules/packetbeat_rare_urls.json | 2 +- .../rules/prepackaged_rules/packetbeat_rare_user_agent.json | 2 +- .../rules/prepackaged_rules/rare_process_by_host_linux.json | 2 +- .../rules/prepackaged_rules/rare_process_by_host_windows.json | 2 +- .../rules/prepackaged_rules/suspicious_login_activity.json | 2 +- .../prepackaged_rules/windows_anomalous_network_activity.json | 2 +- .../prepackaged_rules/windows_anomalous_path_activity.json | 2 +- .../prepackaged_rules/windows_anomalous_process_all_hosts.json | 2 +- .../prepackaged_rules/windows_anomalous_process_creation.json | 2 +- .../rules/prepackaged_rules/windows_anomalous_script.json | 2 +- .../rules/prepackaged_rules/windows_anomalous_service.json | 2 +- .../rules/prepackaged_rules/windows_anomalous_user_name.json | 2 +- .../rules/prepackaged_rules/windows_rare_user_runas_event.json | 2 +- .../windows_rare_user_type10_remote_login.json | 2 +- 23 files changed, 23 insertions(+), 23 deletions(-) diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json index 1123c1161c4ce..fe248a6c1e23e 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that rarely uses the network could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "linux_anomalous_network_activity_ecs", "name": "Unusual Linux Network Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_port_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_port_activity.json index 19dd643945b17..d435d4c10f05c 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_port_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_port_activity.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that rarely uses the network could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "linux_anomalous_network_port_activity_ecs", "name": "Unusual Linux Network Port Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_service.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_service.json index e2e5803618d06..0b82ce99d0b7f 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_service.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_service.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that rarely uses the network could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "linux_anomalous_network_service", "name": "Unusual Linux Network Service", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_url_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_url_activity.json index 40dd2e76c7214..26af34e18a4c8 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_url_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_url_activity.json @@ -4,7 +4,7 @@ "false_positives": [ "A new and unusual program or artifact download in the course of software upgrades, debugging, or troubleshooting could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "linux_anomalous_network_url_activity_ecs", "name": "Unusual Linux Web Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json index 6bac2f25fd7de..d15c4fc794378 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "linux_anomalous_process_all_hosts_ecs", "name": "Anomalous Process For a Linux Population", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json index 8b7e6c89482f7..2f33948b0a93e 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json @@ -4,7 +4,7 @@ "false_positives": [ "Uncommon user activity can be due to an engineer logging onto a server instance in order to perform manual troubleshooting or reconfiguration." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "linux_anomalous_user_name_ecs", "name": "Unusual Linux Username", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_dns_tunneling.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_dns_tunneling.json index c70725dcb645a..765515ffda27c 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_dns_tunneling.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_dns_tunneling.json @@ -4,7 +4,7 @@ "false_positives": [ "DNS domains that use large numbers of child domains, such as software or content distribution networks, can trigger this signal and such parent domains can be excluded." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "packetbeat_dns_tunneling", "name": "DNS Tunneling", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_dns_question.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_dns_question.json index 3ed40ddf27864..79c30c5b38378 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_dns_question.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_dns_question.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal. Network activity that occurs rarely, in small quantities, can trigger this signal. Possible examples are browsing technical support or vendor networks sparsely. A user who visits a new or unique web destination may trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "packetbeat_rare_dns_question", "name": "Unusual DNS Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_server_domain.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_server_domain.json index c49bc95be75d2..7b14ad62f6c93 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_server_domain.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_server_domain.json @@ -4,7 +4,7 @@ "false_positives": [ "Web activity that occurs rarely in small quantities can trigger this signal. Possible examples are browsing technical support or vendor URLs that are used very sparsely. A user who visits a new and unique web destination may trigger this signal when the activity is sparse. Web applications that generate URLs unique to a transaction may trigger this when they are used sparsely. Web domains can be excluded in cases such as these." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "packetbeat_rare_server_domain", "name": "Unusual Network Destination Domain Name", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_urls.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_urls.json index 02a4a5f729a16..76767545e794a 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_urls.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_urls.json @@ -4,7 +4,7 @@ "false_positives": [ "Web activity that occurs rarely in small quantities can trigger this signal. Possible examples are browsing technical support or vendor URLs that are used very sparsely. A user who visits a new and unique web destination may trigger this signal when the activity is sparse. Web applications that generate URLs unique to a transaction may trigger this when they are used sparsely. Web domains can be excluded in cases such as these." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "packetbeat_rare_urls", "name": "Unusual Web Request", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_user_agent.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_user_agent.json index 76ed6b263a704..1dc49203f31c1 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_user_agent.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/packetbeat_rare_user_agent.json @@ -4,7 +4,7 @@ "false_positives": [ "Web activity that is uncommon, like security scans, may trigger this signal and may need to be excluded. A new or rarely used program that calls web services may trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "packetbeat_rare_user_agent", "name": "Unusual Web User Agent", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json index 048f93e170656..f071677ae8d33 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "rare_process_by_host_linux_ecs", "name": "Unusual Process For a Linux Host", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json index 7bc46cdc04dd2..5e0050c6c25ec 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "rare_process_by_host_windows_ecs", "name": "Unusual Process For a Windows Host", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/suspicious_login_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/suspicious_login_activity.json index 915bc1bcfc051..4b94fdc6da147 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/suspicious_login_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/suspicious_login_activity.json @@ -4,7 +4,7 @@ "false_positives": [ "Security audits may trigger this signal. Conditions that generate bursts of failed logins, such as misconfigured applications or account lockouts could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "suspicious_login_activity_ecs", "name": "Unusual Login Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json index 72671760c9c8d..ca18fe95b1fc1 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that rarely uses the network could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_network_activity_ecs", "name": "Unusual Windows Network Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_path_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_path_activity.json index 082fce438ca9e..8a88607b9d5c9 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_path_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_path_activity.json @@ -4,7 +4,7 @@ "false_positives": [ "A new and unusual program or artifact download in the course of software upgrades, debugging, or troubleshooting could trigger this signal. Users downloading and running programs from unusual locations, such as temporary directories, browser caches, or profile paths could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_path_activity_ecs", "name": "Unusual Windows Path Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json index 93469b5a06223..1229c4a52b97d 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_process_all_hosts_ecs", "name": "Anomalous Process For a Windows Population", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_creation.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_creation.json index 1b80e443baae6..98a078ccea4a4 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_creation.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_creation.json @@ -4,7 +4,7 @@ "false_positives": [ "Users running scripts in the course of technical support operations of software upgrades could trigger this signal. A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_process_creation", "name": "Anomalous Windows Process Creation", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_script.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_script.json index 4de5443bcaf3f..564ca1782526f 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_script.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_script.json @@ -4,7 +4,7 @@ "false_positives": [ "Certain kinds of security testing may trigger this signal. PowerShell scripts that use high levels of obfuscation or have unusual script block payloads may trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_script", "name": "Suspicious Powershell Script", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_service.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_service.json index 7e0641fee68c2..afef569f4ebb4 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_service.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_service.json @@ -4,7 +4,7 @@ "false_positives": [ "A newly installed program or one that runs rarely as part of a monthly or quarterly workflow could trigger this signal." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_service", "name": "Unusual Windows Service", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json index 217404b6eb474..703dc1a1dc633 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json @@ -4,7 +4,7 @@ "false_positives": [ "Uncommon user activity can be due to an administrator or help desk technician logging onto a workstation or server in order to perform manual troubleshooting or reconfiguration." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_anomalous_user_name_ecs", "name": "Unusual Windows Username", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_runas_event.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_runas_event.json index 3dca119b5a28e..febaa57443f76 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_runas_event.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_runas_event.json @@ -4,7 +4,7 @@ "false_positives": [ "Uncommon user privilege elevation activity can be due to an administrator, help desk technician, or a user performing manual troubleshooting or reconfiguration." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_rare_user_runas_event", "name": "Unusual Windows User Privilege Elevation Activity", diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json index 09ff2a0cedf41..946cdb95b8e70 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json @@ -4,7 +4,7 @@ "false_positives": [ "Uncommon username activity can be due to an engineer logging onto a server instance in order to perform manual troubleshooting or reconfiguration." ], - "from": "now-16m", + "from": "now-45m", "interval": "15m", "machine_learning_job_id": "windows_rare_user_type10_remote_login", "name": "Unusual Windows Remote User", From fbd15ec8675029a398381ef063fa8a817e21146c Mon Sep 17 00:00:00 2001 From: Yuliia Naumenko <jo.naumenko@gmail.com> Date: Fri, 10 Apr 2020 14:55:03 -0700 Subject: [PATCH 043/102] Added UI for pre-configured connectors. (#63074) * Added UI for pre-configured connectors. * fixed due to comments * Fixed jest tests * Fixed due to comments and added some functional tests * test fix * Fixed failed checks * Fixed functional tests failing --- .../translations/translations/ja-JP.json | 1 - .../translations/translations/zh-CN.json | 1 - .../components/add_message_variables.tsx | 3 +- .../action_connector_form/action_form.tsx | 15 +- .../connector_edit_flyout.test.tsx | 56 +++++++ .../connector_edit_flyout.tsx | 137 +++++++++++++----- .../actions_connectors_list.test.tsx | 16 +- .../components/actions_connectors_list.tsx | 78 +++++++--- .../apps/triggers_actions_ui/alerts.ts | 22 ++- .../apps/triggers_actions_ui/connectors.ts | 25 ++++ x-pack/test/functional_with_es_ssl/config.ts | 10 ++ 11 files changed, 286 insertions(+), 78 deletions(-) diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index 09903c34e2e5e..fe0c58e83e544 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -16102,7 +16102,6 @@ "xpack.triggersActionsUI.sections.builtinActionTypes.emailAction.userTextFieldLabel": "ユーザー名", "xpack.triggersActionsUI.sections.editConnectorForm.betaBadgeTooltipContent": "{pluginName} はベータ段階で、変更される可能性があります。デザインとコードはオフィシャル GA 機能よりも完成度が低く、現状のまま保証なしで提供されています。ベータ機能にはオフィシャル GA 機能の SLA が適用されません。", "xpack.triggersActionsUI.sections.editConnectorForm.cancelButtonLabel": "キャンセル", - "xpack.triggersActionsUI.sections.editConnectorForm.flyoutTitle": "コネクターを編集", "xpack.triggersActionsUI.sections.editConnectorForm.saveButtonLabel": "保存", "xpack.triggersActionsUI.sections.editConnectorForm.updateErrorNotificationText": "コネクターを更新できません。", "xpack.triggersActionsUI.sections.editConnectorForm.updateSuccessNotificationText": "「{connectorName}」を更新しました", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index cc1b7d7980a0b..fd2a92c2c402f 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -16107,7 +16107,6 @@ "xpack.triggersActionsUI.sections.builtinActionTypes.emailAction.userTextFieldLabel": "用户名", "xpack.triggersActionsUI.sections.editConnectorForm.betaBadgeTooltipContent": "{pluginName} 为公测版，可能会进行更改。设计和代码相对于正式发行版功能还不够成熟，将按原样提供，且不提供任何保证。公测版功能不受正式发行版功能支持 SLA 的约束。", "xpack.triggersActionsUI.sections.editConnectorForm.cancelButtonLabel": "取消", - "xpack.triggersActionsUI.sections.editConnectorForm.flyoutTitle": "编辑连接器", "xpack.triggersActionsUI.sections.editConnectorForm.saveButtonLabel": "保存", "xpack.triggersActionsUI.sections.editConnectorForm.updateErrorNotificationText": "无法更新连接器。", "xpack.triggersActionsUI.sections.editConnectorForm.updateSuccessNotificationText": "已更新“{connectorName}”", diff --git a/x-pack/plugins/triggers_actions_ui/public/application/components/add_message_variables.tsx b/x-pack/plugins/triggers_actions_ui/public/application/components/add_message_variables.tsx index ab9b5c2586c17..957c79a5c5123 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/components/add_message_variables.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/components/add_message_variables.tsx @@ -22,9 +22,10 @@ export const AddMessageVariables: React.FunctionComponent<Props> = ({ const [isVariablesPopoverOpen, setIsVariablesPopoverOpen] = useState<boolean>(false); const getMessageVariables = () => - messageVariables?.map((variable: string) => ( + messageVariables?.map((variable: string, i: number) => ( <EuiContextMenuItem key={variable} + data-test-subj={`variableMenuButton-${i}`} icon="empty" onClick={() => { onSelectEventHandler(variable); diff --git a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx index 6b011ac84bc6f..5890d9fe07f0e 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx @@ -141,15 +141,22 @@ export const ActionForm = ({ }); } } + const preconfiguredMessage = i18n.translate( + 'xpack.triggersActionsUI.sections.actionForm.preconfiguredTitleMessage', + { + defaultMessage: '(pre-configured)', + } + ); const getSelectedOptions = (actionItemId: string) => { const val = connectors.find(connector => connector.id === actionItemId); if (!val) { return []; } + const optionTitle = `${val.name} ${val.isPreconfigured ? preconfiguredMessage : ''}`; return [ { - label: val.name, - value: val.name, + label: optionTitle, + value: optionTitle, id: actionItemId, }, ]; @@ -264,7 +271,9 @@ export const ActionForm = ({ defaultMessage="{actionConnectorName}" id="xpack.triggersActionsUI.sections.alertForm.selectAlertActionTypeEditTitle" values={{ - actionConnectorName: actionConnector.name, + actionConnectorName: `${actionConnector.name} ${ + actionConnector.isPreconfigured ? preconfiguredMessage : '' + }`, }} /> </EuiFlexItem> diff --git a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.test.tsx b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.test.tsx index 2c063ea6b4fa6..6659888797679 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.test.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.test.tsx @@ -95,4 +95,60 @@ describe('connector_edit_flyout', () => { expect(connectorNameField.exists()).toBeTruthy(); expect(connectorNameField.first().prop('value')).toBe('action-connector'); }); + + test('if pre-configured connector rendered correct in the edit form', () => { + const connector = { + secrets: {}, + id: 'test', + actionTypeId: 'test-action-type-id', + actionType: 'test-action-type-name', + name: 'pre-configured-connector', + isPreconfigured: true, + referencedByCount: 0, + config: {}, + }; + + const actionType = { + id: 'test-action-type-id', + iconClass: 'test', + selectMessage: 'test', + validateConnector: (): ValidationResult => { + return { errors: {} }; + }, + validateParams: (): ValidationResult => { + const validationResult = { errors: {} }; + return validationResult; + }, + actionConnectorFields: null, + actionParamsFields: null, + }; + actionTypeRegistry.get.mockReturnValue(actionType); + actionTypeRegistry.has.mockReturnValue(true); + + const wrapper = mountWithIntl( + <AppContextProvider appDeps={deps}> + <ActionsConnectorsContextProvider + value={{ + http: deps.http, + toastNotifications: deps.toastNotifications, + capabilities: deps.capabilities, + actionTypeRegistry: deps.actionTypeRegistry, + reloadConnectors: () => { + return new Promise<void>(() => {}); + }, + }} + > + <ConnectorEditFlyout + initialConnector={connector} + editFlyoutVisible={true} + setEditFlyoutVisibility={state => {}} + /> + </ActionsConnectorsContextProvider> + </AppContextProvider> + ); + + const preconfiguredBadge = wrapper.find('[data-test-subj="preconfiguredBadge"]'); + expect(preconfiguredBadge.exists()).toBeTruthy(); + expect(wrapper.find('[data-test-subj="saveEditedActionButton"]').exists()).toBeFalsy(); + }); }); diff --git a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.tsx b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.tsx index ed8811d26331b..a81d6c285f460 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/connector_edit_flyout.tsx @@ -3,7 +3,7 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import React, { useCallback, useReducer, useState } from 'react'; +import React, { useCallback, useReducer, useState, Fragment } from 'react'; import { FormattedMessage } from '@kbn/i18n/react'; import { EuiTitle, @@ -17,6 +17,8 @@ import { EuiButtonEmpty, EuiButton, EuiBetaBadge, + EuiText, + EuiLink, } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { ActionConnectorForm, validateBaseProperties } from './action_connector_form'; @@ -91,8 +93,77 @@ export const ConnectorEditFlyout = ({ return undefined; }); + const flyoutTitle = connector.isPreconfigured ? ( + <Fragment> + <EuiTitle size="s"> + <h3 id="flyoutTitle"> + <FormattedMessage + defaultMessage="{connectorName}" + id="xpack.triggersActionsUI.sections.preconfiguredConnectorForm.flyoutTitle" + values={{ connectorName: initialConnector.name }} + /> +   + <EuiBetaBadge + label="Pre-configured" + data-test-subj="preconfiguredBadge" + tooltipContent={i18n.translate( + 'xpack.triggersActionsUI.sections.preconfiguredConnectorForm.tooltipContent', + { + defaultMessage: 'This connector is preconfigured and cannot be edited', + } + )} + /> +   + <EuiBetaBadge + label="Beta" + tooltipContent={i18n.translate( + 'xpack.triggersActionsUI.sections.preconfiguredConnectorForm.betaBadgeTooltipContent', + { + defaultMessage: + '{pluginName} is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.', + values: { + pluginName: PLUGIN.getI18nName(i18n), + }, + } + )} + /> + </h3> + </EuiTitle> + <EuiText size="s"> + <FormattedMessage + defaultMessage="{actionDescription}" + id="xpack.triggersActionsUI.sections.editConnectorForm.actionTypeDescription" + values={{ actionDescription: actionTypeModel.selectMessage }} + /> + </EuiText> + </Fragment> + ) : ( + <EuiTitle size="s"> + <h3 id="flyoutTitle"> + <FormattedMessage + defaultMessage="Edit connector" + id="xpack.triggersActionsUI.sections.editConnectorForm.flyoutPreconfiguredTitle" + /> +   + <EuiBetaBadge + label="Beta" + tooltipContent={i18n.translate( + 'xpack.triggersActionsUI.sections.editConnectorForm.betaBadgeTooltipContent', + { + defaultMessage: + '{pluginName} is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.', + values: { + pluginName: PLUGIN.getI18nName(i18n), + }, + } + )} + /> + </h3> + </EuiTitle> + ); + return ( - <EuiFlyout onClose={closeFlyout} aria-labelledby="flyoutActionAddTitle" size="m"> + <EuiFlyout onClose={closeFlyout} aria-labelledby="flyoutActionEditTitle" size="m"> <EuiFlyoutHeader hasBorder> <EuiFlexGroup gutterSize="s" alignItems="center"> {actionTypeModel ? ( @@ -100,41 +171,37 @@ export const ConnectorEditFlyout = ({ <EuiIcon type={actionTypeModel.iconClass} size="m" /> </EuiFlexItem> ) : null} - <EuiFlexItem> - <EuiTitle size="s"> - <h3 id="flyoutTitle"> - <FormattedMessage - defaultMessage="Edit connector" - id="xpack.triggersActionsUI.sections.editConnectorForm.flyoutTitle" - /> -   - <EuiBetaBadge - label="Beta" - tooltipContent={i18n.translate( - 'xpack.triggersActionsUI.sections.editConnectorForm.betaBadgeTooltipContent', - { - defaultMessage: - '{pluginName} is in beta and is subject to change. The design and code is less mature than official GA features and is being provided as-is with no warranties. Beta features are not subject to the support SLA of official GA features.', - values: { - pluginName: PLUGIN.getI18nName(i18n), - }, - } - )} - /> - </h3> - </EuiTitle> - </EuiFlexItem> + <EuiFlexItem>{flyoutTitle}</EuiFlexItem> </EuiFlexGroup> </EuiFlyoutHeader> <EuiFlyoutBody> - <ActionConnectorForm - connector={connector} - errors={errors} - actionTypeName={connector.actionType} - dispatch={dispatch} - actionTypeRegistry={actionTypeRegistry} - http={http} - /> + {!connector.isPreconfigured ? ( + <ActionConnectorForm + connector={connector} + errors={errors} + actionTypeName={connector.actionType} + dispatch={dispatch} + actionTypeRegistry={actionTypeRegistry} + http={http} + /> + ) : ( + <Fragment> + <EuiText> + {i18n.translate( + 'xpack.triggersActionsUI.sections.editConnectorForm.descriptionText', + { + defaultMessage: 'This connector is readonly.', + } + )} + </EuiText> + <EuiLink href="https://www.elastic.co/guide" target="_blank"> + <FormattedMessage + id="xpack.triggersActionsUI.sections.editConnectorForm.preconfiguredHelpLabel" + defaultMessage="Learn more about pre-configured connectors." + /> + </EuiLink> + </Fragment> + )} </EuiFlyoutBody> <EuiFlyoutFooter> <EuiFlexGroup justifyContent="spaceBetween"> @@ -148,7 +215,7 @@ export const ConnectorEditFlyout = ({ )} </EuiButtonEmpty> </EuiFlexItem> - {canSave && actionTypeModel ? ( + {canSave && actionTypeModel && !connector.isPreconfigured ? ( <EuiFlexItem grow={false}> <EuiButton fill diff --git a/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.test.tsx b/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.test.tsx index 4fa1e7e4c6e4d..01d21e954bbf3 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.test.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.test.tsx @@ -111,6 +111,7 @@ describe('actions_connectors_list component with items', () => { id: '1', actionTypeId: 'test', description: 'My test', + isPreconfigured: false, referencedByCount: 1, config: {}, }, @@ -119,6 +120,15 @@ describe('actions_connectors_list component with items', () => { actionTypeId: 'test2', description: 'My test 2', referencedByCount: 1, + isPreconfigured: false, + config: {}, + }, + { + id: '3', + actionTypeId: 'test2', + description: 'My preconfigured test 2', + referencedByCount: 1, + isPreconfigured: true, config: {}, }, ]); @@ -185,7 +195,11 @@ describe('actions_connectors_list component with items', () => { it('renders table of connectors', () => { expect(wrapper.find('EuiInMemoryTable')).toHaveLength(1); - expect(wrapper.find('EuiTableRow')).toHaveLength(2); + expect(wrapper.find('EuiTableRow')).toHaveLength(3); + }); + + it('renders table with preconfigured connectors', () => { + expect(wrapper.find('[data-test-subj="preConfiguredTitleMessage"]')).toHaveLength(2); }); test('if select item for edit should render ConnectorEditFlyout', () => { diff --git a/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.tsx b/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.tsx index 47e058f473946..043a644489d82 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/sections/actions_connectors_list/components/actions_connectors_list.tsx @@ -15,6 +15,9 @@ import { EuiIconTip, EuiFlexGroup, EuiFlexItem, + EuiBetaBadge, + EuiToolTip, + EuiButtonIcon, } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; @@ -200,31 +203,58 @@ export const ActionsConnectorsList: React.FunctionComponent = () => { }, }, { - field: '', + field: 'isPreconfigured', name: '', - actions: [ - { - enabled: () => canDelete, - 'data-test-subj': 'deleteConnector', - name: i18n.translate( - 'xpack.triggersActionsUI.sections.actionsConnectorsList.connectorsListTable.columns.actions.deleteActionName', - { defaultMessage: 'Delete' } - ), - description: canDelete - ? i18n.translate( - 'xpack.triggersActionsUI.sections.actionsConnectorsList.connectorsListTable.columns.actions.deleteActionDescription', - { defaultMessage: 'Delete this connector' } - ) - : i18n.translate( - 'xpack.triggersActionsUI.sections.actionsConnectorsList.connectorsListTable.columns.actions.deleteActionDisabledDescription', - { defaultMessage: 'Unable to delete connectors' } - ), - type: 'icon', - icon: 'trash', - color: 'danger', - onClick: (item: ActionConnectorTableItem) => setConnectorsToDelete([item.id]), - }, - ], + render: (value: number, item: ActionConnectorTableItem) => { + if (item.isPreconfigured) { + return ( + <EuiFlexGroup justifyContent="flexEnd" alignItems="flexEnd"> + <EuiFlexItem grow={false}> + <EuiBetaBadge + data-test-subj="preConfiguredTitleMessage" + label={i18n.translate( + 'xpack.triggersActionsUI.sections.alertForm.preconfiguredTitleMessage', + { + defaultMessage: 'Pre-configured', + } + )} + tooltipContent="This connector can't be deleted." + /> + </EuiFlexItem> + </EuiFlexGroup> + ); + } + return ( + <EuiFlexGroup justifyContent="flexEnd" alignItems="flexEnd"> + <EuiFlexItem grow={false}> + <EuiToolTip + content={ + canDelete + ? i18n.translate( + 'xpack.triggersActionsUI.sections.actionsConnectorsList.connectorsListTable.columns.actions.deleteActionDescription', + { defaultMessage: 'Delete this connector' } + ) + : i18n.translate( + 'xpack.triggersActionsUI.sections.actionsConnectorsList.connectorsListTable.columns.actions.deleteActionDisabledDescription', + { defaultMessage: 'Unable to delete connectors' } + ) + } + > + <EuiButtonIcon + isDisabled={!canDelete} + data-test-subj="deleteConnector" + aria-label={i18n.translate( + 'xpack.triggersActionsUI.sections.actionsConnectorsList.connectorsListTable.columns.actions.deleteActionName', + { defaultMessage: 'Delete' } + )} + onClick={() => setConnectorsToDelete([item.id])} + iconType={'trash'} + /> + </EuiToolTip> + </EuiFlexItem> + </EuiFlexGroup> + ); + }, }, ]; diff --git a/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/alerts.ts b/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/alerts.ts index 029af1ea06e4f..c94e7116c5cea 100644 --- a/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/alerts.ts +++ b/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/alerts.ts @@ -65,23 +65,21 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { // need this two out of popup clicks to close them await nameInput.click(); + // test for normal connector + await testSubjects.click('.webhook-ActionTypeSelectOption'); + const webhookBodyInput = await find.byCssSelector('.ace_text-input'); + await webhookBodyInput.focus(); + await webhookBodyInput.type('{\\"test\\":1}'); + + await testSubjects.click('addAlertActionButton'); + // pre-configured connector is loaded an displayed correctly await testSubjects.click('.slack-ActionTypeSelectOption'); - await testSubjects.click('createActionConnectorButton'); - const connectorNameInput = await testSubjects.find('nameInput'); - await connectorNameInput.click(); - await connectorNameInput.clearValue(); - const connectorName = generateUniqueKey(); - await connectorNameInput.type(connectorName); - const slackWebhookUrlInput = await testSubjects.find('slackWebhookUrlInput'); - await slackWebhookUrlInput.click(); - await slackWebhookUrlInput.clearValue(); - await slackWebhookUrlInput.type('https://test'); - await find.clickByCssSelector('[data-test-subj="saveActionButtonModal"]:not(disabled)'); + expect(await (await find.byCssSelector('#my-slack1')).isDisplayed()).to.be(true); const loggingMessageInput = await testSubjects.find('slackMessageTextArea'); await loggingMessageInput.click(); await loggingMessageInput.clearValue(); await loggingMessageInput.type('test message'); - await testSubjects.click('slackAddVariableButton'); + await testSubjects.click('messageAddVariableButton'); const variableMenuButton = await testSubjects.find('variableMenuButton-0'); await variableMenuButton.click(); await testSubjects.click('saveAlertButton'); diff --git a/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts b/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts index b5bcd33c3b9ab..0e6f991be24d0 100644 --- a/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts +++ b/x-pack/test/functional_with_es_ssl/apps/triggers_actions_ui/connectors.ts @@ -184,5 +184,30 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { const searchResultsAfterDelete = await pageObjects.triggersActionsUI.getConnectorsList(); expect(searchResultsAfterDelete.length).to.eql(0); }); + + it('should not be able to delete a pre-configured connector', async () => { + const preconfiguredConnectorName = 'xyz'; + await pageObjects.triggersActionsUI.searchConnectors(preconfiguredConnectorName); + + const searchResults = await pageObjects.triggersActionsUI.getConnectorsList(); + expect(searchResults.length).to.eql(1); + + expect(await testSubjects.exists('deleteConnector')).to.be(false); + expect(await testSubjects.exists('preConfiguredTitleMessage')).to.be(true); + }); + + it('should not be able to edit a pre-configured connector', async () => { + const preconfiguredConnectorName = 'xyz'; + + await pageObjects.triggersActionsUI.searchConnectors(preconfiguredConnectorName); + + const searchResultsBeforeEdit = await pageObjects.triggersActionsUI.getConnectorsList(); + expect(searchResultsBeforeEdit.length).to.eql(1); + + await find.clickByCssSelector('[data-test-subj="connectorsTableCell-name"] button'); + + expect(await testSubjects.exists('preconfiguredBadge')).to.be(true); + expect(await testSubjects.exists('saveEditedActionButton')).to.be(false); + }); }); }; diff --git a/x-pack/test/functional_with_es_ssl/config.ts b/x-pack/test/functional_with_es_ssl/config.ts index 538817bd9d14c..a620b1d953376 100644 --- a/x-pack/test/functional_with_es_ssl/config.ts +++ b/x-pack/test/functional_with_es_ssl/config.ts @@ -52,6 +52,16 @@ export default async function({ readConfigFile }: FtrConfigProviderContext) { `--plugin-path=${join(__dirname, 'fixtures', 'plugins', 'alerts')}`, '--xpack.actions.enabled=true', '--xpack.alerting.enabled=true', + `--xpack.actions.preconfigured=${JSON.stringify([ + { + id: 'my-slack1', + actionTypeId: '.slack', + name: 'Slack#xyz', + config: { + webhookUrl: 'https://hooks.slack.com/services/abcd/efgh/ijklmnopqrstuvwxyz', + }, + }, + ])}`, ], }, }; From cc85573c8adec5ad5f3828688136c190b8d79e8b Mon Sep 17 00:00:00 2001 From: Brandon Kobel <brandon.kobel@elastic.co> Date: Fri, 10 Apr 2020 16:01:30 -0700 Subject: [PATCH 044/102] TaskManager tasks scheduled without attempting to run (#62078) * TaskManager tasks scheduled without attempting to run * Removing unused import Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- x-pack/plugins/task_manager/server/task_manager.ts | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/x-pack/plugins/task_manager/server/task_manager.ts b/x-pack/plugins/task_manager/server/task_manager.ts index c3f24a4aae88a..a7c67d190e72e 100644 --- a/x-pack/plugins/task_manager/server/task_manager.ts +++ b/x-pack/plugins/task_manager/server/task_manager.ts @@ -9,7 +9,7 @@ import { filter } from 'rxjs/operators'; import { performance } from 'perf_hooks'; import { pipe } from 'fp-ts/lib/pipeable'; -import { Option, none, some, map as mapOptional } from 'fp-ts/lib/Option'; +import { Option, some, map as mapOptional } from 'fp-ts/lib/Option'; import { SavedObjectsSerializer, IScopedClusterClient, @@ -156,8 +156,8 @@ export class TaskManager { this.events$.next(event); }; - private attemptToRun(task: Option<string> = none) { - this.claimRequests$.next(task); + private attemptToRun(task: string) { + this.claimRequests$.next(some(task)); } private createTaskRunnerForTask = (instance: ConcreteTaskInstance) => { @@ -280,9 +280,7 @@ export class TaskManager { ...options, taskInstance: ensureDeprecatedFieldsAreCorrected(taskInstance, this.logger), }); - const result = await this.store.schedule(modifiedTask); - this.attemptToRun(); - return result; + return await this.store.schedule(modifiedTask); } /** @@ -298,7 +296,7 @@ export class TaskManager { .then(resolve) .catch(reject); - this.attemptToRun(some(taskId)); + this.attemptToRun(taskId); }); } From 53ee20b306556b9cecc7f94533481c43eed25b35 Mon Sep 17 00:00:00 2001 From: Yuliia Naumenko <jo.naumenko@gmail.com> Date: Fri, 10 Apr 2020 19:18:19 -0700 Subject: [PATCH 045/102] Changed alerting wrong param name for help xpack.encrypted_saved_objects.encryptionKey to xpack.encryptedSavedObjects.encryptionKey (#63307) --- docs/settings/alert-action-settings.asciidoc | 4 ++-- docs/user/alerting/index.asciidoc | 2 +- rfcs/text/0002_encrypted_attributes.md | 2 +- .../public/application/components/health_check.test.tsx | 2 +- .../public/application/components/health_check.tsx | 2 +- 5 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/settings/alert-action-settings.asciidoc b/docs/settings/alert-action-settings.asciidoc index d7f1ec637d1df..d4dbe9407b7a9 100644 --- a/docs/settings/alert-action-settings.asciidoc +++ b/docs/settings/alert-action-settings.asciidoc @@ -9,7 +9,7 @@ Alerts and actions are enabled by default in {kib}, but require you configure th . <<using-kibana-with-security,Set up {kib} to work with {stack} {security-features}>>. . <<configuring-tls-kib-es,Set up TLS encryption between {kib} and {es}>>. -. <<general-alert-action-settings,Specify a value for `xpack.encrypted_saved_objects.encryptionKey`>>. +. <<general-alert-action-settings,Specify a value for `xpack.encryptedSavedObjects.encryptionKey`>>. You can configure the following settings in the `kibana.yml` file. @@ -18,7 +18,7 @@ You can configure the following settings in the `kibana.yml` file. [[general-alert-action-settings]] ==== General settings -`xpack.encrypted_saved_objects.encryptionKey`:: +`xpack.encryptedSavedObjects.encryptionKey`:: A string of 32 or more characters used to encrypt sensitive properties on alerts and actions before they're stored in {es}. Third party credentials — such as the username and password used to connect to an SMTP service — are an example of encrypted properties. + diff --git a/docs/user/alerting/index.asciidoc b/docs/user/alerting/index.asciidoc index c7cf1186a44be..f556cf71bf06c 100644 --- a/docs/user/alerting/index.asciidoc +++ b/docs/user/alerting/index.asciidoc @@ -157,7 +157,7 @@ Pre-packaged *alert types* simplify setup, hide the details complex domain-speci If you are using an *on-premises* Elastic Stack deployment with <<using-kibana-with-security, *security*>>: * TLS must be configured for communication <<configuring-tls-kib-es, between {es} and {kib}>>. {kib} alerting uses <<api-keys, API keys>> to secure background alert checks and actions, and API keys require {ref}/configuring-tls.html#tls-http[TLS on the HTTP interface]. -* In the kibana.yml configuration file, add the <<alert-action-settings-kb,`xpack.encrypted_saved_objects.encryptionKey` setting>> +* In the kibana.yml configuration file, add the <<alert-action-settings-kb,`xpack.encryptedSavedObjects.encryptionKey` setting>> [float] [[alerting-security]] diff --git a/rfcs/text/0002_encrypted_attributes.md b/rfcs/text/0002_encrypted_attributes.md index aa7307edb66bd..c6553c177d995 100644 --- a/rfcs/text/0002_encrypted_attributes.md +++ b/rfcs/text/0002_encrypted_attributes.md @@ -166,7 +166,7 @@ take a look at the source code of this library to know how encryption is perform parameters are used, but in short it's AES Encryption with AES-256-GCM that uses random initialization vector and salt. As with encryption key for Kibana's session cookie, master encryption key used by `encrypted_saved_objects` plugin can be -defined as a configuration value (`xpack.encrypted_saved_objects.encryptionKey`) via `kibana.yml`, but it's **highly +defined as a configuration value (`xpack.encryptedSavedObjects.encryptionKey`) via `kibana.yml`, but it's **highly recommended** to define this key in the [Kibana Keystore](https://www.elastic.co/guide/en/kibana/current/secure-settings.html) instead. The master key should be cryptographically safe and be equal or greater than 32 bytes. diff --git a/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx b/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx index 9c51139993b3f..3fbcd13e98f5d 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.test.tsx @@ -92,7 +92,7 @@ describe('health check', () => { const description = queryByRole(/banner/i); expect(description!.textContent).toMatchInlineSnapshot( - `"To create an alert, set a value for xpack.encrypted_saved_objects.encryptionKey in your kibana.yml file. Learn how."` + `"To create an alert, set a value for xpack.encryptedSavedObjects.encryptionKey in your kibana.yml file. Learn how."` ); const action = queryByText(/Learn/i); diff --git a/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.tsx b/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.tsx index c967cf5de0771..afd5e08f52f25 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/components/health_check.tsx @@ -132,7 +132,7 @@ const EncryptionError = ({ defaultMessage: 'To create an alert, set a value for ', } )} - <EuiCode>{'xpack.encrypted_saved_objects.encryptionKey'}</EuiCode> + <EuiCode>{'xpack.encryptedSavedObjects.encryptionKey'}</EuiCode> {i18n.translate( 'xpack.triggersActionsUI.components.healthCheck.encryptionErrorAfterKey', { From bd159c7d59979d66c09c94402daf2c30373ee9f9 Mon Sep 17 00:00:00 2001 From: Pierre Gayvallet <pierre.gayvallet@elastic.co> Date: Sat, 11 Apr 2020 09:27:45 +0200 Subject: [PATCH 046/102] fix ScopedHistory.createHref to prepend location with scoped history basePath (#62407) * fix createHref to prepend with scoped history basePath + add option to exclude it. * fix prependBasePath behavior * fix test plugins urls * add pathname to endpoint url builder methods * Revert "add pathname to endpoint url builder methods" This reverts commit 7604932b * adapt createHref instead of prependBasePath * use object options for createHref * update generated doc --- ...in-core-public.scopedhistory.createhref.md | 6 +++-- ...kibana-plugin-core-public.scopedhistory.md | 2 +- .../public/application/scoped_history.test.ts | 25 +++++++++++++++++-- src/core/public/application/scoped_history.ts | 20 ++++++++++++--- src/core/public/public.api.md | 4 ++- .../core_plugin_a/public/application.tsx | 2 +- .../core_plugin_b/public/application.tsx | 2 +- 7 files changed, 50 insertions(+), 11 deletions(-) diff --git a/docs/development/core/public/kibana-plugin-core-public.scopedhistory.createhref.md b/docs/development/core/public/kibana-plugin-core-public.scopedhistory.createhref.md index 7058656d09947..6bbab43ff6ffc 100644 --- a/docs/development/core/public/kibana-plugin-core-public.scopedhistory.createhref.md +++ b/docs/development/core/public/kibana-plugin-core-public.scopedhistory.createhref.md @@ -4,10 +4,12 @@ ## ScopedHistory.createHref property -Creates an href (string) to the location. +Creates an href (string) to the location. If `prependBasePath` is true (default), it will prepend the location's path with the scoped history basePath. <b>Signature:</b> ```typescript -createHref: (location: LocationDescriptorObject<HistoryLocationState>) => string; +createHref: (location: LocationDescriptorObject<HistoryLocationState>, { prependBasePath }?: { + prependBasePath?: boolean | undefined; + }) => string; ``` diff --git a/docs/development/core/public/kibana-plugin-core-public.scopedhistory.md b/docs/development/core/public/kibana-plugin-core-public.scopedhistory.md index 5ea47d2090d71..fa29b32c0bafc 100644 --- a/docs/development/core/public/kibana-plugin-core-public.scopedhistory.md +++ b/docs/development/core/public/kibana-plugin-core-public.scopedhistory.md @@ -28,7 +28,7 @@ export declare class ScopedHistory<HistoryLocationState = unknown> implements Hi | --- | --- | --- | --- | | [action](./kibana-plugin-core-public.scopedhistory.action.md) | | <code>Action</code> | The last action dispatched on the history stack. | | [block](./kibana-plugin-core-public.scopedhistory.block.md) | | <code>(prompt?: string | boolean | History.TransitionPromptHook<HistoryLocationState> | undefined) => UnregisterCallback</code> | Not supported. Use [AppMountParameters.onAppLeave](./kibana-plugin-core-public.appmountparameters.onappleave.md)<!-- -->. | -| [createHref](./kibana-plugin-core-public.scopedhistory.createhref.md) | | <code>(location: LocationDescriptorObject<HistoryLocationState>) => string</code> | Creates an href (string) to the location. | +| [createHref](./kibana-plugin-core-public.scopedhistory.createhref.md) | | <code>(location: LocationDescriptorObject<HistoryLocationState>, { prependBasePath }?: {</code><br/><code> prependBasePath?: boolean | undefined;</code><br/><code> }) => string</code> | Creates an href (string) to the location. If <code>prependBasePath</code> is true (default), it will prepend the location's path with the scoped history basePath. | | [createSubHistory](./kibana-plugin-core-public.scopedhistory.createsubhistory.md) | | <code><SubHistoryLocationState = unknown>(basePath: string) => ScopedHistory<SubHistoryLocationState></code> | Creates a <code>ScopedHistory</code> for a subpath of this <code>ScopedHistory</code>. Useful for applications that may have sub-apps that do not need access to the containing application's history. | | [go](./kibana-plugin-core-public.scopedhistory.go.md) | | <code>(n: number) => void</code> | Send the user forward or backwards in the history stack. | | [goBack](./kibana-plugin-core-public.scopedhistory.goback.md) | | <code>() => void</code> | Send the user one location back in the history stack. Equivalent to calling [ScopedHistory.go(-1)](./kibana-plugin-core-public.scopedhistory.go.md)<!-- -->. If no more entries are available backwards, this is a no-op. | diff --git a/src/core/public/application/scoped_history.test.ts b/src/core/public/application/scoped_history.test.ts index c01eb50830516..a56cffef1e2f2 100644 --- a/src/core/public/application/scoped_history.test.ts +++ b/src/core/public/application/scoped_history.test.ts @@ -268,11 +268,32 @@ describe('ScopedHistory', () => { const gh = createMemoryHistory(); gh.push('/app/wow'); const h = new ScopedHistory(gh, '/app/wow'); - expect(h.createHref({ pathname: '' })).toEqual(`/`); + expect(h.createHref({ pathname: '' })).toEqual(`/app/wow`); + expect(h.createHref({})).toEqual(`/app/wow`); expect(h.createHref({ pathname: '/new-page', search: '?alpha=true' })).toEqual( - `/new-page?alpha=true` + `/app/wow/new-page?alpha=true` ); }); + + it('behave correctly with slash-ending basePath', () => { + const gh = createMemoryHistory(); + gh.push('/app/wow/'); + const h = new ScopedHistory(gh, '/app/wow/'); + expect(h.createHref({ pathname: '' })).toEqual(`/app/wow/`); + expect(h.createHref({ pathname: '/new-page', search: '?alpha=true' })).toEqual( + `/app/wow/new-page?alpha=true` + ); + }); + + it('skips the scoped history path when `prependBasePath` is false', () => { + const gh = createMemoryHistory(); + gh.push('/app/wow'); + const h = new ScopedHistory(gh, '/app/wow'); + expect(h.createHref({ pathname: '' }, { prependBasePath: false })).toEqual(`/`); + expect( + h.createHref({ pathname: '/new-page', search: '?alpha=true' }, { prependBasePath: false }) + ).toEqual(`/new-page?alpha=true`); + }); }); describe('action', () => { diff --git a/src/core/public/application/scoped_history.ts b/src/core/public/application/scoped_history.ts index c5febc7604feb..9fa8f0b7f8148 100644 --- a/src/core/public/application/scoped_history.ts +++ b/src/core/public/application/scoped_history.ts @@ -219,11 +219,26 @@ export class ScopedHistory<HistoryLocationState = unknown> /** * Creates an href (string) to the location. + * If `prependBasePath` is true (default), it will prepend the location's path with the scoped history basePath. * * @param location + * @param prependBasePath */ - public createHref = (location: LocationDescriptorObject<HistoryLocationState>): Href => { + public createHref = ( + location: LocationDescriptorObject<HistoryLocationState>, + { prependBasePath = true }: { prependBasePath?: boolean } = {} + ): Href => { this.verifyActive(); + if (prependBasePath) { + location = this.prependBasePath(location); + if (location.pathname === undefined) { + // we always want to create an url relative to the basePath + // so if pathname is not present, we use the history's basePath as default + // we are doing that here because `prependBasePath` should not + // alter pathname for other method calls + location.pathname = this.basePath; + } + } return this.parentHistory.createHref(location); }; @@ -254,8 +269,7 @@ export class ScopedHistory<HistoryLocationState = unknown> * Prepends the base path to string. */ private prependBasePathToString(path: string): string { - path = path.startsWith('/') ? path.slice(1) : path; - return path.length ? `${this.basePath}/${path}` : this.basePath; + return path.length ? `${this.basePath}/${path}`.replace(/\/{2,}/g, '/') : this.basePath; } /** diff --git a/src/core/public/public.api.md b/src/core/public/public.api.md index a5aa37becabc2..6d95d1bc7069c 100644 --- a/src/core/public/public.api.md +++ b/src/core/public/public.api.md @@ -1196,7 +1196,9 @@ export class ScopedHistory<HistoryLocationState = unknown> implements History<Hi constructor(parentHistory: History, basePath: string); get action(): Action; block: (prompt?: string | boolean | History.TransitionPromptHook<HistoryLocationState> | undefined) => UnregisterCallback; - createHref: (location: LocationDescriptorObject<HistoryLocationState>) => string; + createHref: (location: LocationDescriptorObject<HistoryLocationState>, { prependBasePath }?: { + prependBasePath?: boolean | undefined; + }) => string; createSubHistory: <SubHistoryLocationState = unknown>(basePath: string) => ScopedHistory<SubHistoryLocationState>; go: (n: number) => void; goBack: () => void; diff --git a/test/plugin_functional/plugins/core_plugin_a/public/application.tsx b/test/plugin_functional/plugins/core_plugin_a/public/application.tsx index abea970749cbc..159bb54f50903 100644 --- a/test/plugin_functional/plugins/core_plugin_a/public/application.tsx +++ b/test/plugin_functional/plugins/core_plugin_a/public/application.tsx @@ -95,7 +95,7 @@ const Nav = withRouter(({ history, navigateToApp }: NavProps) => ( { id: 'home', name: 'Home', - onClick: () => history.push('/'), + onClick: () => history.push(''), 'data-test-subj': 'fooNavHome', }, { diff --git a/test/plugin_functional/plugins/core_plugin_b/public/application.tsx b/test/plugin_functional/plugins/core_plugin_b/public/application.tsx index 447307920c04c..01a63f9782563 100644 --- a/test/plugin_functional/plugins/core_plugin_b/public/application.tsx +++ b/test/plugin_functional/plugins/core_plugin_b/public/application.tsx @@ -102,7 +102,7 @@ const Nav = withRouter(({ history, navigateToApp }: NavProps) => ( { id: 'home', name: 'Home', - onClick: () => navigateToApp('bar', { path: '/' }), + onClick: () => navigateToApp('bar', { path: '' }), 'data-test-subj': 'barNavHome', }, { From 2be6b7fdcecbe2848cc1da23eb98af756f513d6b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Cau=C3=AA=20Marcondes?= <55978943+cauemarcondes@users.noreply.github.com> Date: Sat, 11 Apr 2020 10:06:39 +0100 Subject: [PATCH 047/102] fixing custom link popover size and hiding scroll (#63240) --- .../TransactionActionMenu/CustomLink/CustomLinkPopover.tsx | 1 + .../shared/TransactionActionMenu/TransactionActionMenu.tsx | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/CustomLink/CustomLinkPopover.tsx b/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/CustomLink/CustomLinkPopover.tsx index a20bc7e21cfc5..3aed1b7ac2953 100644 --- a/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/CustomLink/CustomLinkPopover.tsx +++ b/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/CustomLink/CustomLinkPopover.tsx @@ -19,6 +19,7 @@ import { ManageCustomLink } from './ManageCustomLink'; import { px } from '../../../../style/variables'; const ScrollableContainer = styled.div` + -ms-overflow-style: none; max-height: ${px(535)}; overflow: scroll; `; diff --git a/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/TransactionActionMenu.tsx b/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/TransactionActionMenu.tsx index e3fbcf8485d54..7ebfe26b83630 100644 --- a/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/TransactionActionMenu.tsx +++ b/x-pack/legacy/plugins/apm/public/components/shared/TransactionActionMenu/TransactionActionMenu.tsx @@ -124,7 +124,7 @@ export const TransactionActionMenu: FunctionComponent<Props> = ({ <ActionMenuButton onClick={() => setIsActionPopoverOpen(true)} /> } > - <div style={{ maxHeight: px(600) }}> + <div style={{ maxHeight: px(600), width: px(335) }}> {isCustomLinksPopoverOpen ? ( <CustomLinkPopover customLinks={customLinks.slice(3, customLinks.length)} From 1199c8c8b0c988d9013149b586bb9a5c941f1072 Mon Sep 17 00:00:00 2001 From: Anton Dosov <anton.dosov@elastic.co> Date: Sun, 12 Apr 2020 17:06:03 +0200 Subject: [PATCH 048/102] Bugfix dashboard unpins filters (#62301) Fixes following cases: Saving dashboard with pinned filter unpins it. Do not save pinned filters with dashboard see #62301 (comment) When navigating with global filter to dashboard with same saved filter, filter becomes unpinned When navigating from listing to dashboard with saved filter, back button didn't work Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../application/dashboard_app_controller.tsx | 14 +++++-- .../application/dashboard_state_manager.ts | 7 ++-- .../public/application/lib/filter_utils.ts | 2 +- .../application/lib/update_saved_dashboard.ts | 7 ++++ .../filter_manager/filter_manager.test.ts | 11 +++--- .../query/filter_manager/filter_manager.ts | 17 ++------- .../data/public/ui/filter_bar/filter_item.tsx | 3 +- .../apps/dashboard/dashboard_filter_bar.js | 38 +++++++++++++++++++ test/functional/services/filter_bar.ts | 15 +++++++- 9 files changed, 85 insertions(+), 29 deletions(-) diff --git a/src/plugins/dashboard/public/application/dashboard_app_controller.tsx b/src/plugins/dashboard/public/application/dashboard_app_controller.tsx index d1c7d2d9eba3e..babd1fac274eb 100644 --- a/src/plugins/dashboard/public/application/dashboard_app_controller.tsx +++ b/src/plugins/dashboard/public/application/dashboard_app_controller.tsx @@ -143,6 +143,7 @@ export class DashboardAppController { }); // sync initial app filters from state to filterManager + // if there is an existing similar global filter, then leave it as global filterManager.setAppFilters(_.cloneDeep(dashboardStateManager.appState.filters)); // setup syncing of app filters between appState and filterManager const stopSyncingAppFilters = connectToQueryState( @@ -150,7 +151,11 @@ export class DashboardAppController { { set: ({ filters }) => dashboardStateManager.setFilters(filters || []), get: () => ({ filters: dashboardStateManager.appState.filters }), - state$: dashboardStateManager.appState$.pipe(map(state => ({ filters: state.filters }))), + state$: dashboardStateManager.appState$.pipe( + map(state => ({ + filters: state.filters, + })) + ), }, { filters: esFilters.FilterStateStore.APP_STATE, @@ -170,13 +175,16 @@ export class DashboardAppController { } // starts syncing `_g` portion of url with query services - // note: dashboard_state_manager.ts syncs `_a` portion of url // it is important to start this syncing after `dashboardStateManager.syncTimefilterWithDashboard(timefilter);` above is run, - // otherwise it will case redundant browser history record + // otherwise it will case redundant browser history records const { stop: stopSyncingQueryServiceStateWithUrl } = syncQueryStateWithUrl( queryService, kbnUrlStateStorage ); + + // starts syncing `_a` portion of url + dashboardStateManager.startStateSyncing(); + $scope.showSaveQuery = dashboardCapabilities.saveQuery as boolean; const getShouldShowEditHelp = () => diff --git a/src/plugins/dashboard/public/application/dashboard_state_manager.ts b/src/plugins/dashboard/public/application/dashboard_state_manager.ts index 6025f535ae761..13ba3c6d0b60d 100644 --- a/src/plugins/dashboard/public/application/dashboard_state_manager.ts +++ b/src/plugins/dashboard/public/application/dashboard_state_manager.ts @@ -164,9 +164,6 @@ export class DashboardStateManager { this.changeListeners.forEach(listener => listener({ dirty: this.isDirty })); }); - // make sure url ('_a') matches initial state - this.kbnUrlStateStorage.set(this.STATE_STORAGE_KEY, initialState, { replace: true }); - // setup state syncing utils. state container will be synced with url into `this.STATE_STORAGE_KEY` query param this.stateSyncRef = syncState<DashboardAppState>({ storageKey: this.STATE_STORAGE_KEY, @@ -201,8 +198,10 @@ export class DashboardStateManager { }, stateStorage: this.kbnUrlStateStorage, }); + } - // actually start syncing state with container + public startStateSyncing() { + this.saveState({ replace: true }); this.stateSyncRef.start(); } diff --git a/src/plugins/dashboard/public/application/lib/filter_utils.ts b/src/plugins/dashboard/public/application/lib/filter_utils.ts index 1ec231db0c3d2..775bf90643a21 100644 --- a/src/plugins/dashboard/public/application/lib/filter_utils.ts +++ b/src/plugins/dashboard/public/application/lib/filter_utils.ts @@ -19,7 +19,7 @@ import _ from 'lodash'; import moment, { Moment } from 'moment'; -import { Filter } from 'src/plugins/data/public'; +import { Filter } from '../../../../data/public'; /** * @typedef {Object} QueryFilter diff --git a/src/plugins/dashboard/public/application/lib/update_saved_dashboard.ts b/src/plugins/dashboard/public/application/lib/update_saved_dashboard.ts index 53dc7d9b460de..fc519327b41ee 100644 --- a/src/plugins/dashboard/public/application/lib/update_saved_dashboard.ts +++ b/src/plugins/dashboard/public/application/lib/update_saved_dashboard.ts @@ -22,6 +22,7 @@ import { RefreshInterval, TimefilterContract } from 'src/plugins/data/public'; import { FilterUtils } from './filter_utils'; import { SavedObjectDashboard } from '../../saved_dashboards'; import { DashboardAppState } from '../../types'; +import { esFilters } from '../../../../data/public'; export function updateSavedDashboard( savedDashboard: SavedObjectDashboard, @@ -48,4 +49,10 @@ export function updateSavedDashboard( 'value', ]); savedDashboard.refreshInterval = savedDashboard.timeRestore ? timeRestoreObj : undefined; + + // save only unpinned filters + const unpinnedFilters = savedDashboard + .getFilters() + .filter(filter => !esFilters.isFilterPinned(filter)); + savedDashboard.searchSource.setField('filter', unpinnedFilters); } diff --git a/src/plugins/data/public/query/filter_manager/filter_manager.test.ts b/src/plugins/data/public/query/filter_manager/filter_manager.test.ts index ce574ace45705..3b4ca08cbbf14 100644 --- a/src/plugins/data/public/query/filter_manager/filter_manager.test.ts +++ b/src/plugins/data/public/query/filter_manager/filter_manager.test.ts @@ -204,18 +204,19 @@ describe('filter_manager', () => { ).toBe(3); }); - test('should set app filters and remove any duplicated global filters', async function() { - filterManager.addFilters(readyFilters, true); + test('should set app filters and merge them with duplicate global filters', async function() { + const [filter, ...otherFilters] = readyFilters; + filterManager.addFilters(otherFilters, true); const appFilter1 = _.cloneDeep(readyFilters[1]); const appFilter2 = _.cloneDeep(readyFilters[2]); - filterManager.setAppFilters([appFilter1, appFilter2]); + filterManager.setAppFilters([filter, appFilter1, appFilter2]); const newGlobalFilters = filterManager.getGlobalFilters(); const newAppFilters = filterManager.getAppFilters(); - expect(newGlobalFilters).toHaveLength(1); - expect(newAppFilters).toHaveLength(2); + expect(newGlobalFilters).toHaveLength(2); + expect(newAppFilters).toHaveLength(1); }); test('should set global filters and remove any duplicated app filters', async function() { diff --git a/src/plugins/data/public/query/filter_manager/filter_manager.ts b/src/plugins/data/public/query/filter_manager/filter_manager.ts index fba1866ebd615..e206286bce147 100644 --- a/src/plugins/data/public/query/filter_manager/filter_manager.ts +++ b/src/plugins/data/public/query/filter_manager/filter_manager.ts @@ -177,13 +177,9 @@ export class FilterManager { public setGlobalFilters(newGlobalFilters: Filter[]) { newGlobalFilters = mapAndFlattenFilters(newGlobalFilters); FilterManager.setFiltersStore(newGlobalFilters, FilterStateStore.GLOBAL_STATE, true); - const { appFilters: currentAppFilters } = this.getPartitionedFilters(); - // remove duplicates from current app filters, to make sure global will take precedence - const filteredAppFilters = currentAppFilters.filter( - appFilter => !newGlobalFilters.find(globalFilter => compareFilters(globalFilter, appFilter)) - ); + const { appFilters } = this.getPartitionedFilters(); const newFilters = this.mergeIncomingFilters({ - appFilters: filteredAppFilters, + appFilters, globalFilters: newGlobalFilters, }); @@ -198,14 +194,9 @@ export class FilterManager { public setAppFilters(newAppFilters: Filter[]) { newAppFilters = mapAndFlattenFilters(newAppFilters); FilterManager.setFiltersStore(newAppFilters, FilterStateStore.APP_STATE, true); - const { globalFilters: currentGlobalFilters } = this.getPartitionedFilters(); - // remove duplicates from current global filters, to make sure app will take precedence - const filteredGlobalFilters = currentGlobalFilters.filter( - globalFilter => !newAppFilters.find(appFilter => compareFilters(appFilter, globalFilter)) - ); - + const { globalFilters } = this.getPartitionedFilters(); const newFilters = this.mergeIncomingFilters({ - globalFilters: filteredGlobalFilters, + globalFilters, appFilters: newAppFilters, }); this.handleStateUpdate(newFilters); diff --git a/src/plugins/data/public/ui/filter_bar/filter_item.tsx b/src/plugins/data/public/ui/filter_bar/filter_item.tsx index 6b5fd41dc06ea..528ec4800e7b9 100644 --- a/src/plugins/data/public/ui/filter_bar/filter_item.tsx +++ b/src/plugins/data/public/ui/filter_bar/filter_item.tsx @@ -88,6 +88,7 @@ class FilterItemUI extends Component<Props, State> { const dataTestSubjDisabled = `filter-${ this.props.filter.meta.disabled ? 'disabled' : 'enabled' }`; + const dataTestSubjPinned = `filter-${isFilterPinned(filter) ? 'pinned' : 'unpinned'}`; const classes = classNames( 'globalFilterItem', @@ -107,7 +108,7 @@ class FilterItemUI extends Component<Props, State> { className={classes} iconOnClick={() => this.props.onRemove()} onClick={this.handleBadgeClick} - data-test-subj={`filter ${dataTestSubjDisabled} ${dataTestSubjKey} ${dataTestSubjValue}`} + data-test-subj={`filter ${dataTestSubjDisabled} ${dataTestSubjKey} ${dataTestSubjValue} ${dataTestSubjPinned}`} /> ); diff --git a/test/functional/apps/dashboard/dashboard_filter_bar.js b/test/functional/apps/dashboard/dashboard_filter_bar.js index 6d2a30fa85325..f6089871010c3 100644 --- a/test/functional/apps/dashboard/dashboard_filter_bar.js +++ b/test/functional/apps/dashboard/dashboard_filter_bar.js @@ -27,6 +27,7 @@ export default function({ getService, getPageObjects }) { const pieChart = getService('pieChart'); const esArchiver = getService('esArchiver'); const kibanaServer = getService('kibanaServer'); + const browser = getService('browser'); const PageObjects = getPageObjects(['common', 'dashboard', 'header', 'visualize', 'timePicker']); describe('dashboard filter bar', () => { @@ -126,9 +127,46 @@ export default function({ getService, getPageObjects }) { const filterCount = await filterBar.getFilterCount(); expect(filterCount).to.equal(1); + await pieChart.expectPieSliceCount(1); + }); + it("restoring filters doesn't break back button", async () => { + await browser.goBack(); + await PageObjects.dashboard.expectExistsDashboardLandingPage(); + await browser.goForward(); + await PageObjects.header.waitUntilLoadingHasFinished(); + await PageObjects.dashboard.waitForRenderComplete(); await pieChart.expectPieSliceCount(1); }); + + it("saving with pinned filter doesn't unpin them", async () => { + const filterKey = 'bytes'; + await filterBar.toggleFilterPinned(filterKey); + await PageObjects.dashboard.switchToEditMode(); + await PageObjects.dashboard.saveDashboard('saved with pinned filters', { + saveAsNew: true, + }); + expect(await filterBar.isFilterPinned(filterKey)).to.be(true); + await pieChart.expectPieSliceCount(1); + }); + + it("navigating to a dashboard with global filter doesn't unpin it if same filter is saved with dashboard", async () => { + await PageObjects.dashboard.preserveCrossAppState(); + await PageObjects.dashboard.gotoDashboardLandingPage(); + await PageObjects.dashboard.loadSavedDashboard('with filters'); + await PageObjects.header.waitUntilLoadingHasFinished(); + expect(await filterBar.isFilterPinned('bytes')).to.be(true); + await pieChart.expectPieSliceCount(1); + }); + + it("pinned filters aren't saved", async () => { + await filterBar.removeFilter('bytes'); + await PageObjects.dashboard.gotoDashboardLandingPage(); + await PageObjects.dashboard.loadSavedDashboard('saved with pinned filters'); + await PageObjects.header.waitUntilLoadingHasFinished(); + expect(await filterBar.getFilterCount()).to.be(0); + await pieChart.expectPieSliceCount(5); + }); }); describe('saved search filtering', function() { diff --git a/test/functional/services/filter_bar.ts b/test/functional/services/filter_bar.ts index 9d494b1e6d950..a463a593e9e04 100644 --- a/test/functional/services/filter_bar.ts +++ b/test/functional/services/filter_bar.ts @@ -32,10 +32,16 @@ export function FilterBarProvider({ getService, getPageObjects }: FtrProviderCon * @param value filter value * @param enabled filter status */ - public async hasFilter(key: string, value: string, enabled: boolean = true): Promise<boolean> { + public async hasFilter( + key: string, + value: string, + enabled: boolean = true, + pinned: boolean = false + ): Promise<boolean> { const filterActivationState = enabled ? 'enabled' : 'disabled'; + const filterPinnedState = pinned ? 'pinned' : 'unpinned'; return testSubjects.exists( - `filter filter-${filterActivationState} filter-key-${key} filter-value-${value}`, + `filter filter-${filterActivationState} filter-key-${key} filter-value-${value} filter-${filterPinnedState}`, { allowHidden: true, } @@ -80,6 +86,11 @@ export function FilterBarProvider({ getService, getPageObjects }: FtrProviderCon await PageObjects.header.awaitGlobalLoadingIndicatorHidden(); } + public async isFilterPinned(key: string): Promise<boolean> { + const filter = await testSubjects.find(`~filter & ~filter-key-${key}`); + return (await filter.getAttribute('data-test-subj')).includes('filter-pinned'); + } + public async getFilterCount(): Promise<number> { const filters = await testSubjects.findAll('~filter'); return filters.length; From 358d13919bc597d13e6a98ec97fae2615093027e Mon Sep 17 00:00:00 2001 From: Pierre Gayvallet <pierre.gayvallet@elastic.co> Date: Mon, 13 Apr 2020 13:28:09 +0200 Subject: [PATCH 049/102] Migrate SO management section to NP (#61700) * move libs to new plugin * adapt libs to use NP apis * add required plugins * add get_allowed_types route * move object_view components * add service registry * migrate table header component * migrate table component * migrate saved_objects_table component * remove migrated legacy files * fix re-export from legacy management + section label * migrate services registration * adapt management section mock * fix imports * migrate flyout component * migrate relationships component * migrate saved_objects_table tests * migrate breadcrumb * add redirect if unauthorized check * migrate translations to new savedObjectsManagement prefix * remove obsolete translations * convert action registry to service pattern * wire extra actions * remove importAndExportableTypes from injected vars * handle newIndexPatternUrl * remove duplicate dashboard dependency * remove old TODO * remove old TODO * properly mock lodash in tests * add async management section loading * expose createSavedSearchesLoader from discover plugin contract * address most review comments * fix merge conflicts --- src/core/public/mocks.ts | 6 +- .../server/saved_objects/service/index.ts | 1 - src/core/server/server.api.md | 2 - src/legacy/core_plugins/kibana/inject_vars.js | 3 - .../core_plugins/kibana/public/index.ts | 2 +- .../management/saved_object_registry.ts | 64 +-- .../public/management/sections/index.js | 1 - .../management/sections/objects/_objects.html | 5 - .../management/sections/objects/_objects.js | 104 ----- .../management/sections/objects/_view.html | 5 - .../management/sections/objects/_view.js | 85 ---- .../sections/objects/breadcrumbs.js | 50 --- .../objects/components/objects_table/index.js | 20 - .../saved_objects/saved_objects_mixin.js | 5 - src/plugins/data/public/mocks.ts | 1 + src/plugins/discover/public/mocks.ts | 3 + src/plugins/discover/public/plugin.ts | 12 + src/plugins/management/public/mocks/index.ts | 13 +- .../saved_objects_management/common/index.ts} | 2 +- .../saved_objects_management/common}/types.ts | 30 +- .../saved_objects_management/kibana.json | 3 +- .../saved_objects_management/public/index.ts | 6 +- .../public}/lib/case_conversion.test.ts | 0 .../public}/lib/case_conversion.ts | 0 .../public}/lib/create_field_list.test.ts | 4 +- .../public}/lib/create_field_list.ts | 8 +- .../lib/extract_export_details.test.ts | 0 .../public}/lib/extract_export_details.ts | 0 .../lib/fetch_export_by_type_and_search.ts | 7 +- .../public}/lib/fetch_export_objects.ts | 7 +- .../public}/lib/find_objects.ts | 29 +- .../public/lib/get_allowed_types.ts | 31 ++ .../public}/lib/get_default_title.ts | 0 .../public}/lib/get_relationships.test.ts | 37 +- .../public}/lib/get_relationships.ts | 32 +- .../public}/lib/get_saved_object_counts.ts | 17 +- .../public}/lib/get_saved_object_label.ts | 0 .../public}/lib/import_file.ts | 14 +- .../public}/lib/import_legacy_file.test.ts | 0 .../public}/lib/import_legacy_file.ts | 0 .../public}/lib/in_app_url.test.ts | 2 +- .../public}/lib/in_app_url.ts | 0 .../public}/lib/index.ts | 2 + .../public}/lib/log_legacy_import.ts | 9 +- .../public}/lib/numeric.ts | 0 .../public}/lib/parse_query.test.ts | 2 +- .../public}/lib/parse_query.ts | 15 +- .../lib/process_import_response.test.ts | 0 .../public}/lib/process_import_response.ts | 0 .../public}/lib/resolve_import_errors.test.ts | 35 +- .../public}/lib/resolve_import_errors.ts | 12 +- .../public}/lib/resolve_saved_objects.test.ts | 7 +- .../public}/lib/resolve_saved_objects.ts | 26 +- .../public/management_section/index.ts} | 2 +- .../management_section/mount_section.tsx | 211 +++++++++ .../__snapshots__/header.test.tsx.snap | 6 +- .../__snapshots__/intro.test.tsx.snap | 6 +- .../not_found_errors.test.tsx.snap | 30 +- .../object_view/components}/field.test.tsx | 0 .../object_view/components}/field.tsx | 4 +- .../object_view/components}/form.tsx | 18 +- .../object_view/components}/header.test.tsx | 0 .../object_view/components}/header.tsx | 8 +- .../object_view/components}/index.ts | 0 .../object_view/components}/intro.test.tsx | 0 .../object_view/components}/intro.tsx | 4 +- .../components}/not_found_errors.test.tsx | 0 .../components}/not_found_errors.tsx | 10 +- .../management_section/object_view/index.ts} | 2 +- .../object_view}/saved_object_view.tsx | 18 +- .../saved_objects_table.test.tsx.snap} | 116 ++++- .../__snapshots__/flyout.test.tsx.snap} | 84 ++-- .../__snapshots__/header.test.tsx.snap} | 10 +- .../relationships.test.tsx.snap} | 2 +- .../__snapshots__/table.test.tsx.snap} | 24 +- .../components/flyout.test.mocks.ts | 44 ++ .../objects_table/components/flyout.test.tsx} | 183 ++++---- .../objects_table/components/flyout.tsx} | 260 ++++++----- .../objects_table/components/header.test.tsx} | 3 +- .../objects_table/components/header.tsx} | 31 +- .../objects_table/components/index.ts | 23 + .../components/relationships.test.tsx} | 44 +- .../components/relationships.tsx} | 89 ++-- .../objects_table/components/table.test.tsx} | 31 +- .../objects_table/components/table.tsx} | 154 ++++--- .../objects_table/index.ts} | 2 +- .../saved_objects_table.test.mocks.ts | 67 +++ .../saved_objects_table.test.tsx} | 419 ++++++++---------- .../objects_table/saved_objects_table.tsx} | 260 ++++++----- .../public/management_section/types.ts | 38 ++ .../saved_objects_management/public/mocks.ts | 12 +- .../public/plugin.test.ts | 10 +- .../saved_objects_management/public/plugin.ts | 71 ++- .../public/register_services.ts | 59 +++ .../public/services/action_service.mock.ts | 57 +++ ...egistry.test.ts => action_service.test.ts} | 30 +- .../{action_registry.ts => action_service.ts} | 48 +- .../public/services/index.ts | 14 +- ...istry.mock.ts => service_registry.mock.ts} | 13 +- .../public/services/service_registry.ts | 49 ++ .../services/{action_types.ts => types.ts} | 0 .../saved_objects_management/public/types.ts | 20 + .../server/routes/get_allowed_types.ts} | 34 +- .../server/routes/index.test.ts | 8 +- .../server/routes/index.ts | 2 + .../saved_objects_management/server/types.ts | 30 +- ...opy_saved_objects_to_space_service.test.ts | 4 +- .../copy_saved_objects_to_space_service.ts | 2 +- .../translations/translations/ja-JP.json | 245 +++++----- .../translations/translations/zh-CN.json | 243 +++++----- 110 files changed, 2184 insertions(+), 1689 deletions(-) delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.html delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.js delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/objects/_view.html delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/objects/_view.js delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/objects/breadcrumbs.js delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/index.js rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/index.js => plugins/saved_objects_management/common/index.ts} (89%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/common}/types.ts (74%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/case_conversion.test.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/case_conversion.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/create_field_list.test.ts (96%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/create_field_list.ts (92%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/extract_export_details.test.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/extract_export_details.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/fetch_export_by_type_and_search.ts (89%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/fetch_export_objects.ts (89%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/find_objects.ts (57%) create mode 100644 src/plugins/saved_objects_management/public/lib/get_allowed_types.ts rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/get_default_title.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/get_relationships.test.ts (67%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/get_relationships.ts (67%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/get_saved_object_counts.ts (72%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/get_saved_object_label.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/import_file.ts (75%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/import_legacy_file.test.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/import_legacy_file.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/in_app_url.test.ts (98%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/in_app_url.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/index.ts (94%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/log_legacy_import.ts (81%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/numeric.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/parse_query.test.ts (92%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/parse_query.ts (77%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/process_import_response.test.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/process_import_response.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/resolve_import_errors.test.ts (90%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/resolve_import_errors.ts (95%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/resolve_saved_objects.test.ts (98%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public}/lib/resolve_saved_objects.ts (94%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/index.js => plugins/saved_objects_management/public/management_section/index.ts} (93%) create mode 100644 src/plugins/saved_objects_management/public/management_section/mount_section.tsx rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/__snapshots__/header.test.tsx.snap (96%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/__snapshots__/intro.test.tsx.snap (90%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/__snapshots__/not_found_errors.test.tsx.snap (89%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/field.test.tsx (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/field.tsx (97%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/form.tsx (89%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/header.test.tsx (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/header.tsx (92%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/index.ts (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/intro.test.tsx (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/intro.tsx (92%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/not_found_errors.test.tsx (100%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/object_view => plugins/saved_objects_management/public/management_section/object_view/components}/not_found_errors.tsx (87%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/index.js => plugins/saved_objects_management/public/management_section/object_view/index.ts} (93%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects => plugins/saved_objects_management/public/management_section/object_view}/saved_object_view.tsx (89%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/__snapshots__/objects_table.test.js.snap => plugins/saved_objects_management/public/management_section/objects_table/__snapshots__/saved_objects_table.test.tsx.snap} (73%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/__snapshots__/flyout.test.js.snap => plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/flyout.test.tsx.snap} (85%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/__snapshots__/header.test.js.snap => plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/header.test.tsx.snap} (88%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/__snapshots__/relationships.test.js.snap => plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/relationships.test.tsx.snap} (99%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/__snapshots__/table.test.js.snap => plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/table.test.tsx.snap} (93%) create mode 100644 src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.mocks.ts rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/flyout.test.js => plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.tsx} (75%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/flyout.js => plugins/saved_objects_management/public/management_section/objects_table/components/flyout.tsx} (77%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/header.test.js => plugins/saved_objects_management/public/management_section/objects_table/components/header.test.tsx} (96%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/header.js => plugins/saved_objects_management/public/management_section/objects_table/components/header.tsx} (83%) create mode 100644 src/plugins/saved_objects_management/public/management_section/objects_table/components/index.ts rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/relationships.test.js => plugins/saved_objects_management/public/management_section/objects_table/components/relationships.test.tsx} (88%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/relationships.js => plugins/saved_objects_management/public/management_section/objects_table/components/relationships.tsx} (75%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/table.test.js => plugins/saved_objects_management/public/management_section/objects_table/components/table.test.tsx} (87%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/table.js => plugins/saved_objects_management/public/management_section/objects_table/components/table.tsx} (71%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/index.js => plugins/saved_objects_management/public/management_section/objects_table/index.ts} (93%) create mode 100644 src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.mocks.ts rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/objects_table.test.js => plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.tsx} (58%) rename src/{legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/objects_table.js => plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.tsx} (73%) create mode 100644 src/plugins/saved_objects_management/public/management_section/types.ts create mode 100644 src/plugins/saved_objects_management/public/register_services.ts create mode 100644 src/plugins/saved_objects_management/public/services/action_service.mock.ts rename src/plugins/saved_objects_management/public/services/{action_registry.test.ts => action_service.test.ts} (69%) rename src/plugins/saved_objects_management/public/services/{action_registry.ts => action_service.ts} (56%) rename src/plugins/saved_objects_management/public/services/{action_registry.mock.ts => service_registry.mock.ts} (79%) create mode 100644 src/plugins/saved_objects_management/public/services/service_registry.ts rename src/plugins/saved_objects_management/public/services/{action_types.ts => types.ts} (100%) create mode 100644 src/plugins/saved_objects_management/public/types.ts rename src/{legacy/core_plugins/kibana/public/management/sections/objects/index.js => plugins/saved_objects_management/server/routes/get_allowed_types.ts} (61%) diff --git a/src/core/public/mocks.ts b/src/core/public/mocks.ts index 0c4930592b233..959ffaa7e7e08 100644 --- a/src/core/public/mocks.ts +++ b/src/core/public/mocks.ts @@ -48,6 +48,7 @@ export { overlayServiceMock } from './overlays/overlay_service.mock'; export { uiSettingsServiceMock } from './ui_settings/ui_settings_service.mock'; export { savedObjectsServiceMock } from './saved_objects/saved_objects_service.mock'; export { scopedHistoryMock } from './application/scoped_history.mock'; +export { applicationServiceMock } from './application/application_service.mock'; function createCoreSetupMock({ basePath = '', @@ -62,9 +63,8 @@ function createCoreSetupMock({ application: applicationServiceMock.createSetupContract(), context: contextServiceMock.createSetupContract(), fatalErrors: fatalErrorsServiceMock.createSetupContract(), - getStartServices: jest.fn<Promise<[ReturnType<typeof createCoreStartMock>, object, any]>, []>( - () => - Promise.resolve([createCoreStartMock({ basePath }), pluginStartDeps, pluginStartContract]) + getStartServices: jest.fn<Promise<[ReturnType<typeof createCoreStartMock>, any, any]>, []>(() => + Promise.resolve([createCoreStartMock({ basePath }), pluginStartDeps, pluginStartContract]) ), http: httpServiceMock.createSetupContract({ basePath }), notifications: notificationServiceMock.createSetupContract(), diff --git a/src/core/server/saved_objects/service/index.ts b/src/core/server/saved_objects/service/index.ts index f44824238aa21..9f625b4732e26 100644 --- a/src/core/server/saved_objects/service/index.ts +++ b/src/core/server/saved_objects/service/index.ts @@ -36,7 +36,6 @@ export interface SavedObjectsLegacyService { getScopedSavedObjectsClient: SavedObjectsClientProvider['getClient']; SavedObjectsClient: typeof SavedObjectsClient; types: string[]; - importAndExportableTypes: string[]; schema: SavedObjectsSchema; getSavedObjectsRepository(...rest: any[]): any; importExport: { diff --git a/src/core/server/server.api.md b/src/core/server/server.api.md index a35bca7375286..37051da4b17da 100644 --- a/src/core/server/server.api.md +++ b/src/core/server/server.api.md @@ -2084,8 +2084,6 @@ export interface SavedObjectsLegacyService { // (undocumented) getScopedSavedObjectsClient: SavedObjectsClientProvider['getClient']; // (undocumented) - importAndExportableTypes: string[]; - // (undocumented) importExport: { objectLimit: number; importSavedObjects(options: SavedObjectsImportOptions): Promise<SavedObjectsImportResponse>; diff --git a/src/legacy/core_plugins/kibana/inject_vars.js b/src/legacy/core_plugins/kibana/inject_vars.js index 76d1704907ab5..c3b906ee842e3 100644 --- a/src/legacy/core_plugins/kibana/inject_vars.js +++ b/src/legacy/core_plugins/kibana/inject_vars.js @@ -20,10 +20,7 @@ export function injectVars(server) { const serverConfig = server.config(); - const { importAndExportableTypes } = server.savedObjects; - return { - importAndExportableTypes, autocompleteTerminateAfter: serverConfig.get('kibana.autocompleteTerminateAfter'), autocompleteTimeout: serverConfig.get('kibana.autocompleteTimeout'), }; diff --git a/src/legacy/core_plugins/kibana/public/index.ts b/src/legacy/core_plugins/kibana/public/index.ts index a4fffc6eec26d..be22652ab2c1c 100644 --- a/src/legacy/core_plugins/kibana/public/index.ts +++ b/src/legacy/core_plugins/kibana/public/index.ts @@ -20,4 +20,4 @@ export { ProcessedImportResponse, processImportResponse, -} from './management/sections/objects/lib/process_import_response'; +} from '../../../../plugins/saved_objects_management/public/lib'; diff --git a/src/legacy/core_plugins/kibana/public/management/saved_object_registry.ts b/src/legacy/core_plugins/kibana/public/management/saved_object_registry.ts index 705be68a141e7..587a372f91555 100644 --- a/src/legacy/core_plugins/kibana/public/management/saved_object_registry.ts +++ b/src/legacy/core_plugins/kibana/public/management/saved_object_registry.ts @@ -17,66 +17,8 @@ * under the License. */ -import _ from 'lodash'; -import { i18n } from '@kbn/i18n'; -import { npStart } from 'ui/new_platform'; -import { SavedObjectLoader } from '../../../../../plugins/saved_objects/public'; -import { createSavedSearchesLoader } from '../../../../../plugins/discover/public'; +import { npSetup } from 'ui/new_platform'; -/** - * This registry is used for the editing mode of Saved Searches, Visualizations, - * Dashboard and Time Lion saved objects. - */ -interface SavedObjectRegistryEntry { - id: string; - service: SavedObjectLoader; - title: string; -} - -export interface ISavedObjectsManagementRegistry { - register(service: SavedObjectRegistryEntry): void; - all(): SavedObjectRegistryEntry[]; - get(id: string): SavedObjectRegistryEntry | undefined; -} - -const registry: SavedObjectRegistryEntry[] = []; - -export const savedObjectManagementRegistry: ISavedObjectsManagementRegistry = { - register: (service: SavedObjectRegistryEntry) => { - registry.push(service); - }, - all: () => { - return registry; - }, - get: (id: string) => { - return _.find(registry, { id }); - }, -}; - -const services = { - savedObjectsClient: npStart.core.savedObjects.client, - indexPatterns: npStart.plugins.data.indexPatterns, - search: npStart.plugins.data.search, - chrome: npStart.core.chrome, - overlays: npStart.core.overlays, -}; - -savedObjectManagementRegistry.register({ - id: 'savedVisualizations', - service: npStart.plugins.visualizations.savedVisualizationsLoader, - title: 'visualizations', -}); - -savedObjectManagementRegistry.register({ - id: 'savedDashboards', - service: npStart.plugins.dashboard.getSavedDashboardLoader(), - title: i18n.translate('kbn.dashboard.savedDashboardsTitle', { - defaultMessage: 'dashboards', - }), -}); +const registry = npSetup.plugins.savedObjectsManagement?.serviceRegistry; -savedObjectManagementRegistry.register({ - id: 'savedSearches', - service: createSavedSearchesLoader(services), - title: 'searches', -}); +export const savedObjectManagementRegistry = registry!; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index.js index 54717ad003ade..adc1741f57263 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index.js @@ -17,5 +17,4 @@ * under the License. */ -import './objects'; import './index_patterns'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.html b/src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.html deleted file mode 100644 index 090fb7b636685..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.html +++ /dev/null @@ -1,5 +0,0 @@ -<kbn-management-app section="kibana/objects"> - <kbn-management-objects> - <div id="reactSavedObjectsTable"></div> - </kbn-management-objects> -</kbn-management-app> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.js b/src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.js deleted file mode 100644 index c5901ca6ee6bf..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/_objects.js +++ /dev/null @@ -1,104 +0,0 @@ -/* - * 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. - */ - -import { savedObjectManagementRegistry } from '../../saved_object_registry'; -import objectIndexHTML from './_objects.html'; -import uiRoutes from 'ui/routes'; -import chrome from 'ui/chrome'; -import { uiModules } from 'ui/modules'; -import React from 'react'; -import { render, unmountComponentAtNode } from 'react-dom'; -import { ObjectsTable } from './components/objects_table'; -import { I18nContext } from 'ui/i18n'; -import { get } from 'lodash'; -import { npStart } from 'ui/new_platform'; -import { getIndexBreadcrumbs } from './breadcrumbs'; - -const REACT_OBJECTS_TABLE_DOM_ELEMENT_ID = 'reactSavedObjectsTable'; - -function updateObjectsTable($scope, $injector) { - const indexPatterns = npStart.plugins.data.indexPatterns; - const $http = $injector.get('$http'); - const kbnUrl = $injector.get('kbnUrl'); - const config = $injector.get('config'); - - const savedObjectsClient = npStart.core.savedObjects.client; - const services = savedObjectManagementRegistry.all().map(obj => obj.service); - const uiCapabilites = npStart.core.application.capabilities; - - $scope.$$postDigest(() => { - const node = document.getElementById(REACT_OBJECTS_TABLE_DOM_ELEMENT_ID); - if (!node) { - return; - } - - render( - <I18nContext> - <ObjectsTable - savedObjectsClient={savedObjectsClient} - confirmModalPromise={npStart.core.overlays.openConfirm} - services={services} - indexPatterns={indexPatterns} - $http={$http} - perPageConfig={config.get('savedObjects:perPage')} - basePath={chrome.getBasePath()} - newIndexPatternUrl={kbnUrl.eval('#/management/kibana/index_pattern')} - uiCapabilities={uiCapabilites} - goInspectObject={object => { - if (object.meta.editUrl) { - kbnUrl.change(object.meta.editUrl); - $scope.$apply(); - } - }} - canGoInApp={object => { - const { inAppUrl } = object.meta; - return inAppUrl && get(uiCapabilites, inAppUrl.uiCapabilitiesPath); - }} - /> - </I18nContext>, - node - ); - }); -} - -function destroyObjectsTable() { - const node = document.getElementById(REACT_OBJECTS_TABLE_DOM_ELEMENT_ID); - node && unmountComponentAtNode(node); -} - -uiRoutes - .when('/management/kibana/objects', { - template: objectIndexHTML, - k7Breadcrumbs: getIndexBreadcrumbs, - requireUICapability: 'management.kibana.objects', - }) - .when('/management/kibana/objects/:service', { - redirectTo: '/management/kibana/objects', - }); - -uiModules.get('apps/management').directive('kbnManagementObjects', function() { - return { - restrict: 'E', - controllerAs: 'managementObjectsController', - controller: function($scope, $injector) { - updateObjectsTable($scope, $injector); - $scope.$on('$destroy', destroyObjectsTable); - }, - }; -}); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/_view.html b/src/legacy/core_plugins/kibana/public/management/sections/objects/_view.html deleted file mode 100644 index 8bce0aabcd64a..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/_view.html +++ /dev/null @@ -1,5 +0,0 @@ -<kbn-management-app section="kibana/objects" data-test-subj="savedObjectsEdit"> - <kbn-management-objects-view> - <div id="reactSavedObjectsView"></div> - </kbn-management-objects-view> -</kbn-management-app> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/_view.js b/src/legacy/core_plugins/kibana/public/management/sections/objects/_view.js deleted file mode 100644 index a847055b40015..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/_view.js +++ /dev/null @@ -1,85 +0,0 @@ -/* - * 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. - */ - -import React from 'react'; -import { render, unmountComponentAtNode } from 'react-dom'; -import 'angular'; -import 'angular-elastic/elastic'; -import uiRoutes from 'ui/routes'; -import { uiModules } from 'ui/modules'; -import { I18nContext } from 'ui/i18n'; -import { npStart } from 'ui/new_platform'; -import objectViewHTML from './_view.html'; -import { getViewBreadcrumbs } from './breadcrumbs'; -import { savedObjectManagementRegistry } from '../../saved_object_registry'; -import { SavedObjectEdition } from './saved_object_view'; - -const REACT_OBJECTS_VIEW_DOM_ELEMENT_ID = 'reactSavedObjectsView'; - -uiRoutes.when('/management/kibana/objects/:service/:id', { - template: objectViewHTML, - k7Breadcrumbs: getViewBreadcrumbs, - requireUICapability: 'management.kibana.objects', -}); - -function createReactView($scope, $routeParams) { - const { service: serviceName, id: objectId, notFound } = $routeParams; - - const { savedObjects, overlays, notifications, application } = npStart.core; - - $scope.$$postDigest(() => { - const node = document.getElementById(REACT_OBJECTS_VIEW_DOM_ELEMENT_ID); - if (!node) { - return; - } - - render( - <I18nContext> - <SavedObjectEdition - id={objectId} - serviceName={serviceName} - serviceRegistry={savedObjectManagementRegistry} - savedObjectsClient={savedObjects.client} - overlays={overlays} - notifications={notifications} - capabilities={application.capabilities} - notFoundType={notFound} - /> - </I18nContext>, - node - ); - }); -} - -function destroyReactView() { - const node = document.getElementById(REACT_OBJECTS_VIEW_DOM_ELEMENT_ID); - node && unmountComponentAtNode(node); -} - -uiModules - .get('apps/management', ['monospaced.elastic']) - .directive('kbnManagementObjectsView', function() { - return { - restrict: 'E', - controller: function($scope, $routeParams) { - createReactView($scope, $routeParams); - $scope.$on('$destroy', destroyReactView); - }, - }; - }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/breadcrumbs.js b/src/legacy/core_plugins/kibana/public/management/sections/objects/breadcrumbs.js deleted file mode 100644 index e9082bfeb680d..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/breadcrumbs.js +++ /dev/null @@ -1,50 +0,0 @@ -/* - * 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. - */ - -import { MANAGEMENT_BREADCRUMB } from 'ui/management'; -import { i18n } from '@kbn/i18n'; - -import { savedObjectManagementRegistry } from '../../saved_object_registry'; - -export function getIndexBreadcrumbs() { - return [ - MANAGEMENT_BREADCRUMB, - { - text: i18n.translate('kbn.management.savedObjects.indexBreadcrumb', { - defaultMessage: 'Saved objects', - }), - href: '#/management/kibana/objects', - }, - ]; -} - -export function getViewBreadcrumbs($routeParams) { - const serviceObj = savedObjectManagementRegistry.get($routeParams.service); - const { service } = serviceObj; - - return [ - ...getIndexBreadcrumbs(), - { - text: i18n.translate('kbn.management.savedObjects.editBreadcrumb', { - defaultMessage: 'Edit {savedObjectType}', - values: { savedObjectType: service.type }, - }), - }, - ]; -} diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/index.js b/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/index.js deleted file mode 100644 index 601dea544361c..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/index.js +++ /dev/null @@ -1,20 +0,0 @@ -/* - * 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. - */ - -export { ObjectsTable } from './objects_table'; diff --git a/src/legacy/server/saved_objects/saved_objects_mixin.js b/src/legacy/server/saved_objects/saved_objects_mixin.js index bcf766231dc9c..3e71e1989ae7a 100644 --- a/src/legacy/server/saved_objects/saved_objects_mixin.js +++ b/src/legacy/server/saved_objects/saved_objects_mixin.js @@ -78,13 +78,8 @@ export function savedObjectsMixin(kbnServer, server) { const provider = kbnServer.newPlatform.__internals.savedObjectsClientProvider; - const importAndExportableTypes = typeRegistry - .getImportableAndExportableTypes() - .map(type => type.name); - const service = { types: visibleTypes, - importAndExportableTypes, SavedObjectsClient, SavedObjectsRepository, getSavedObjectsRepository: createRepository, diff --git a/src/plugins/data/public/mocks.ts b/src/plugins/data/public/mocks.ts index ea1c27550867e..2d43cae79ac98 100644 --- a/src/plugins/data/public/mocks.ts +++ b/src/plugins/data/public/mocks.ts @@ -62,6 +62,7 @@ const createStartContract = (): Start => { }, }), get: jest.fn().mockReturnValue(Promise.resolve({})), + clearCache: jest.fn(), } as unknown) as IndexPatternsContract, }; }; diff --git a/src/plugins/discover/public/mocks.ts b/src/plugins/discover/public/mocks.ts index bb05e3d412001..218c59b5db07b 100644 --- a/src/plugins/discover/public/mocks.ts +++ b/src/plugins/discover/public/mocks.ts @@ -37,6 +37,9 @@ const createStartContract = (): Start => { docViews: { DocViewer: jest.fn(() => null), }, + savedSearches: { + createLoader: jest.fn(), + }, }; return startContract; }; diff --git a/src/plugins/discover/public/plugin.ts b/src/plugins/discover/public/plugin.ts index d2797586bfdfb..aa54823e6ec4d 100644 --- a/src/plugins/discover/public/plugin.ts +++ b/src/plugins/discover/public/plugin.ts @@ -21,12 +21,14 @@ import React from 'react'; import { i18n } from '@kbn/i18n'; import { auto } from 'angular'; import { CoreSetup, Plugin } from 'kibana/public'; +import { SavedObjectLoader, SavedObjectKibanaServices } from '../../saved_objects/public'; import { DocViewInput, DocViewInputFn, DocViewRenderProps } from './doc_views/doc_views_types'; import { DocViewsRegistry } from './doc_views/doc_views_registry'; import { DocViewTable } from './components/table/table'; import { JsonCodeBlock } from './components/json_code_block/json_code_block'; import { DocViewer } from './components/doc_viewer/doc_viewer'; import { setDocViewsRegistry } from './services'; +import { createSavedSearchesLoader } from './saved_searches'; import './index.scss'; @@ -62,6 +64,13 @@ export interface DiscoverStart { */ DocViewer: React.ComponentType<DocViewRenderProps>; }; + savedSearches: { + /** + * Create a {@link SavedObjectLoader | loader} to handle the saved searches type. + * @param services + */ + createLoader(services: SavedObjectKibanaServices): SavedObjectLoader; + }; } /** @@ -105,6 +114,9 @@ export class DiscoverPlugin implements Plugin<DiscoverSetup, DiscoverStart> { docViews: { DocViewer, }, + savedSearches: { + createLoader: createSavedSearchesLoader, + }, }; } } diff --git a/src/plugins/management/public/mocks/index.ts b/src/plugins/management/public/mocks/index.ts index 6099a2cc32afc..82789d3c3f55f 100644 --- a/src/plugins/management/public/mocks/index.ts +++ b/src/plugins/management/public/mocks/index.ts @@ -18,12 +18,21 @@ */ import { ManagementSetup, ManagementStart } from '../types'; +import { ManagementSection } from '../management_section'; + +const createManagementSectionMock = (): jest.Mocked<PublicMethodsOf<ManagementSection>> => { + return { + registerApp: jest.fn(), + getApp: jest.fn(), + getAppsEnabled: jest.fn().mockReturnValue([]), + }; +}; const createSetupContract = (): DeeplyMockedKeys<ManagementSetup> => ({ sections: { register: jest.fn(), - getSection: jest.fn(), - getAllSections: jest.fn(), + getSection: jest.fn().mockReturnValue(createManagementSectionMock()), + getAllSections: jest.fn().mockReturnValue([]), }, }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/index.js b/src/plugins/saved_objects_management/common/index.ts similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/index.js rename to src/plugins/saved_objects_management/common/index.ts index ac1e7bac06c87..67c3ae6d934ab 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/index.js +++ b/src/plugins/saved_objects_management/common/index.ts @@ -17,4 +17,4 @@ * under the License. */ -export { Header } from './header'; +export { SavedObjectRelation, SavedObjectWithMetadata, SavedObjectMetadata } from './types'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/types.ts b/src/plugins/saved_objects_management/common/types.ts similarity index 74% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/types.ts rename to src/plugins/saved_objects_management/common/types.ts index 6a89142bc9798..be52d8e6486e2 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/types.ts +++ b/src/plugins/saved_objects_management/common/types.ts @@ -17,8 +17,12 @@ * under the License. */ -import { SavedObject, SavedObjectReference } from 'src/core/public'; +import { SavedObject } from 'src/core/types'; +/** + * The metadata injected into a {@link SavedObject | saved object} when returning + * {@link SavedObjectWithMetadata | enhanced objects} from the plugin API endpoints. + */ export interface SavedObjectMetadata { icon?: string; title?: string; @@ -26,31 +30,19 @@ export interface SavedObjectMetadata { inAppUrl?: { path: string; uiCapabilitiesPath: string }; } +/** + * A {@link SavedObject | saved object} enhanced with meta properties used by the client-side plugin. + */ export type SavedObjectWithMetadata<T = unknown> = SavedObject<T> & { meta: SavedObjectMetadata; }; +/** + * Represents a relation between two {@link SavedObject | saved object} + */ export interface SavedObjectRelation { id: string; type: string; relationship: 'child' | 'parent'; meta: SavedObjectMetadata; } - -export interface ObjectField { - type: FieldType; - name: string; - value: any; -} - -export type FieldType = 'text' | 'number' | 'boolean' | 'array' | 'json'; - -export interface FieldState { - value?: any; - invalid?: boolean; -} - -export interface SubmittedFormData { - attributes: any; - references: SavedObjectReference[]; -} diff --git a/src/plugins/saved_objects_management/kibana.json b/src/plugins/saved_objects_management/kibana.json index e1f14b0e3c59d..22135ce4558ae 100644 --- a/src/plugins/saved_objects_management/kibana.json +++ b/src/plugins/saved_objects_management/kibana.json @@ -3,5 +3,6 @@ "version": "kibana", "server": true, "ui": true, - "requiredPlugins": ["home"] + "requiredPlugins": ["home", "management", "data"], + "optionalPlugins": ["dashboard", "visualizations", "discover"] } diff --git a/src/plugins/saved_objects_management/public/index.ts b/src/plugins/saved_objects_management/public/index.ts index 7fb2f137d7d84..b20b320bc6645 100644 --- a/src/plugins/saved_objects_management/public/index.ts +++ b/src/plugins/saved_objects_management/public/index.ts @@ -22,10 +22,14 @@ import { SavedObjectsManagementPlugin } from './plugin'; export { SavedObjectsManagementPluginSetup, SavedObjectsManagementPluginStart } from './plugin'; export { - ISavedObjectsManagementActionRegistry, + SavedObjectsManagementActionServiceSetup, + SavedObjectsManagementActionServiceStart, SavedObjectsManagementAction, SavedObjectsManagementRecord, + ISavedObjectsManagementServiceRegistry, + SavedObjectsManagementServiceRegistryEntry, } from './services'; +export { SavedObjectRelation, SavedObjectWithMetadata, SavedObjectMetadata } from './types'; export function plugin(initializerContext: PluginInitializerContext) { return new SavedObjectsManagementPlugin(); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/case_conversion.test.ts b/src/plugins/saved_objects_management/public/lib/case_conversion.test.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/case_conversion.test.ts rename to src/plugins/saved_objects_management/public/lib/case_conversion.test.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/case_conversion.ts b/src/plugins/saved_objects_management/public/lib/case_conversion.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/case_conversion.ts rename to src/plugins/saved_objects_management/public/lib/case_conversion.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/create_field_list.test.ts b/src/plugins/saved_objects_management/public/lib/create_field_list.test.ts similarity index 96% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/create_field_list.test.ts rename to src/plugins/saved_objects_management/public/lib/create_field_list.test.ts index 345716f91ea88..e7d6754ac4d05 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/create_field_list.test.ts +++ b/src/plugins/saved_objects_management/public/lib/create_field_list.test.ts @@ -17,8 +17,8 @@ * under the License. */ -import { SimpleSavedObject, SavedObjectReference } from '../../../../../../../../core/public'; -import { savedObjectsServiceMock } from '../../../../../../../../core/public/mocks'; +import { SimpleSavedObject, SavedObjectReference } from '../../../../core/public'; +import { savedObjectsServiceMock } from '../../../../core/public/mocks'; import { createFieldList } from './create_field_list'; const savedObjectClientMock = savedObjectsServiceMock.createStartContract().client; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/create_field_list.ts b/src/plugins/saved_objects_management/public/lib/create_field_list.ts similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/create_field_list.ts rename to src/plugins/saved_objects_management/public/lib/create_field_list.ts index 88a1184d5d70f..5d87c11a87198 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/create_field_list.ts +++ b/src/plugins/saved_objects_management/public/lib/create_field_list.ts @@ -18,10 +18,10 @@ */ import { forOwn, indexBy, isNumber, isBoolean, isPlainObject, isString } from 'lodash'; -import { SimpleSavedObject } from '../../../../../../../../core/public'; -import { castEsToKbnFieldTypeName } from '../../../../../../../../plugins/data/public'; -import { ObjectField } from '../types'; -import { SavedObjectLoader } from '../../../../../../../../plugins/saved_objects/public'; +import { SimpleSavedObject } from '../../../../core/public'; +import { castEsToKbnFieldTypeName } from '../../../data/public'; +import { ObjectField } from '../management_section/types'; +import { SavedObjectLoader } from '../../../saved_objects/public'; const maxRecursiveIterations = 20; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/extract_export_details.test.ts b/src/plugins/saved_objects_management/public/lib/extract_export_details.test.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/extract_export_details.test.ts rename to src/plugins/saved_objects_management/public/lib/extract_export_details.test.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/extract_export_details.ts b/src/plugins/saved_objects_management/public/lib/extract_export_details.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/extract_export_details.ts rename to src/plugins/saved_objects_management/public/lib/extract_export_details.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/fetch_export_by_type_and_search.ts b/src/plugins/saved_objects_management/public/lib/fetch_export_by_type_and_search.ts similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/fetch_export_by_type_and_search.ts rename to src/plugins/saved_objects_management/public/lib/fetch_export_by_type_and_search.ts index d3e527b9f96b7..e0f005fab2a3b 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/fetch_export_by_type_and_search.ts +++ b/src/plugins/saved_objects_management/public/lib/fetch_export_by_type_and_search.ts @@ -17,16 +17,15 @@ * under the License. */ -import { kfetch } from 'ui/kfetch'; +import { HttpStart } from 'src/core/public'; export async function fetchExportByTypeAndSearch( + http: HttpStart, types: string[], search: string | undefined, includeReferencesDeep: boolean = false ): Promise<Blob> { - return await kfetch({ - method: 'POST', - pathname: '/api/saved_objects/_export', + return http.post('/api/saved_objects/_export', { body: JSON.stringify({ type: types, search, diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/fetch_export_objects.ts b/src/plugins/saved_objects_management/public/lib/fetch_export_objects.ts similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/fetch_export_objects.ts rename to src/plugins/saved_objects_management/public/lib/fetch_export_objects.ts index 744f8ef38af47..745d3758371a3 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/fetch_export_objects.ts +++ b/src/plugins/saved_objects_management/public/lib/fetch_export_objects.ts @@ -17,15 +17,14 @@ * under the License. */ -import { kfetch } from 'ui/kfetch'; +import { HttpStart } from 'src/core/public'; export async function fetchExportObjects( + http: HttpStart, objects: any[], includeReferencesDeep: boolean = false ): Promise<Blob> { - return await kfetch({ - method: 'POST', - pathname: '/api/saved_objects/_export', + return http.post('/api/saved_objects/_export', { body: JSON.stringify({ objects, includeReferencesDeep, diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/find_objects.ts b/src/plugins/saved_objects_management/public/lib/find_objects.ts similarity index 57% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/find_objects.ts rename to src/plugins/saved_objects_management/public/lib/find_objects.ts index 24e08f0524f62..5a77d3ae2f663 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/find_objects.ts +++ b/src/plugins/saved_objects_management/public/lib/find_objects.ts @@ -17,16 +17,27 @@ * under the License. */ -import { kfetch } from 'ui/kfetch'; -import { SavedObjectsFindOptions } from 'src/core/public'; +import { HttpStart, SavedObjectsFindOptions } from 'src/core/public'; import { keysToCamelCaseShallow } from './case_conversion'; +import { SavedObjectWithMetadata } from '../types'; -export async function findObjects(findOptions: SavedObjectsFindOptions) { - const response = await kfetch({ - method: 'GET', - pathname: '/api/kibana/management/saved_objects/_find', - query: findOptions as Record<string, any>, - }); +interface SavedObjectsFindResponse { + total: number; + page: number; + perPage: number; + savedObjects: SavedObjectWithMetadata[]; +} + +export async function findObjects( + http: HttpStart, + findOptions: SavedObjectsFindOptions +): Promise<SavedObjectsFindResponse> { + const response = await http.get<Record<string, any>>( + '/api/kibana/management/saved_objects/_find', + { + query: findOptions as Record<string, any>, + } + ); - return keysToCamelCaseShallow(response); + return keysToCamelCaseShallow(response) as SavedObjectsFindResponse; } diff --git a/src/plugins/saved_objects_management/public/lib/get_allowed_types.ts b/src/plugins/saved_objects_management/public/lib/get_allowed_types.ts new file mode 100644 index 0000000000000..7d952ebf2ca14 --- /dev/null +++ b/src/plugins/saved_objects_management/public/lib/get_allowed_types.ts @@ -0,0 +1,31 @@ +/* + * 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. + */ + +import { HttpStart } from 'src/core/public'; + +interface GetAllowedTypesResponse { + types: string[]; +} + +export async function getAllowedTypes(http: HttpStart) { + const response = await http.get<GetAllowedTypesResponse>( + '/api/kibana/management/saved_objects/_allowed_types' + ); + return response.types; +} diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_default_title.ts b/src/plugins/saved_objects_management/public/lib/get_default_title.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_default_title.ts rename to src/plugins/saved_objects_management/public/lib/get_default_title.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_relationships.test.ts b/src/plugins/saved_objects_management/public/lib/get_relationships.test.ts similarity index 67% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_relationships.test.ts rename to src/plugins/saved_objects_management/public/lib/get_relationships.test.ts index b45b51b4de293..d79447378dde5 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_relationships.test.ts +++ b/src/plugins/saved_objects_management/public/lib/get_relationships.test.ts @@ -17,44 +17,43 @@ * under the License. */ +import { httpServiceMock } from '../../../../core/public/mocks'; import { getRelationships } from './get_relationships'; describe('getRelationships', () => { - it('should make an http request', async () => { - const $http = jest.fn() as any; - const basePath = 'test'; + let httpMock: ReturnType<typeof httpServiceMock.createSetupContract>; - await getRelationships('dashboard', '1', ['search', 'index-pattern'], $http, basePath); - expect($http.mock.calls.length).toBe(1); + beforeEach(() => { + httpMock = httpServiceMock.createSetupContract(); + }); + + it('should make an http request', async () => { + await getRelationships(httpMock, 'dashboard', '1', ['search', 'index-pattern']); + expect(httpMock.get).toHaveBeenCalledTimes(1); }); it('should handle successful responses', async () => { - const $http = jest.fn().mockImplementation(() => ({ data: [1, 2] })) as any; - const basePath = 'test'; - - const response = await getRelationships( - 'dashboard', - '1', - ['search', 'index-pattern'], - $http, - basePath - ); + httpMock.get.mockResolvedValue([1, 2]); + + const response = await getRelationships(httpMock, 'dashboard', '1', [ + 'search', + 'index-pattern', + ]); expect(response).toEqual([1, 2]); }); it('should handle errors', async () => { - const $http = jest.fn().mockImplementation(() => { + httpMock.get.mockImplementation(() => { const err = new Error(); (err as any).data = { error: 'Test error', statusCode: 500, }; throw err; - }) as any; - const basePath = 'test'; + }); await expect( - getRelationships('dashboard', '1', ['search', 'index-pattern'], $http, basePath) + getRelationships(httpMock, 'dashboard', '1', ['search', 'index-pattern']) ).rejects.toThrowErrorMatchingInlineSnapshot(`"Test error"`); }); }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_relationships.ts b/src/plugins/saved_objects_management/public/lib/get_relationships.ts similarity index 67% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_relationships.ts rename to src/plugins/saved_objects_management/public/lib/get_relationships.ts index 07bdf2db68fa2..bf2e651aa6593 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_relationships.ts +++ b/src/plugins/saved_objects_management/public/lib/get_relationships.ts @@ -17,36 +17,30 @@ * under the License. */ -import { IHttpService } from 'angular'; +import { HttpStart } from 'src/core/public'; import { get } from 'lodash'; import { SavedObjectRelation } from '../types'; export async function getRelationships( + http: HttpStart, type: string, id: string, - savedObjectTypes: string[], - $http: IHttpService, - basePath: string + savedObjectTypes: string[] ): Promise<SavedObjectRelation[]> { - const url = `${basePath}/api/kibana/management/saved_objects/relationships/${encodeURIComponent( + const url = `/api/kibana/management/saved_objects/relationships/${encodeURIComponent( type )}/${encodeURIComponent(id)}`; - const options = { - method: 'GET', - url, - params: { - savedObjectTypes, - }, - }; - try { - const response = await $http<SavedObjectRelation[]>(options); - return response?.data; - } catch (resp) { - const respBody = get(resp, 'data', {}) as any; - const err = new Error(respBody.message || respBody.error || `${resp.status} Response`); + return await http.get<SavedObjectRelation[]>(url, { + query: { + savedObjectTypes, + }, + }); + } catch (respError) { + const respBody = get(respError, 'data', {}) as any; + const err = new Error(respBody.message || respBody.error || `${respError.status} Response`); - (err as any).statusCode = respBody.statusCode || resp.status; + (err as any).statusCode = respBody.statusCode || respError.status; (err as any).body = respBody; throw err; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_saved_object_counts.ts b/src/plugins/saved_objects_management/public/lib/get_saved_object_counts.ts similarity index 72% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_saved_object_counts.ts rename to src/plugins/saved_objects_management/public/lib/get_saved_object_counts.ts index d4dda1190bc43..dcf59142e73e3 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_saved_object_counts.ts +++ b/src/plugins/saved_objects_management/public/lib/get_saved_object_counts.ts @@ -17,18 +17,15 @@ * under the License. */ -import { IHttpService } from 'angular'; -import chrome from 'ui/chrome'; +import { HttpStart } from 'src/core/public'; -const apiBase = chrome.addBasePath('/api/kibana/management/saved_objects/scroll'); export async function getSavedObjectCounts( - $http: IHttpService, + http: HttpStart, typesToInclude: string[], - searchString: string + searchString?: string ): Promise<Record<string, number>> { - const results = await $http.post<Record<string, number>>(`${apiBase}/counts`, { - typesToInclude, - searchString, - }); - return results.data; + return await http.post<Record<string, number>>( + `/api/kibana/management/saved_objects/scroll/counts`, + { body: JSON.stringify({ typesToInclude, searchString }) } + ); } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_saved_object_label.ts b/src/plugins/saved_objects_management/public/lib/get_saved_object_label.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/get_saved_object_label.ts rename to src/plugins/saved_objects_management/public/lib/get_saved_object_label.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_file.ts b/src/plugins/saved_objects_management/public/lib/import_file.ts similarity index 75% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_file.ts rename to src/plugins/saved_objects_management/public/lib/import_file.ts index 9bd5fbeed3a4c..96263452253ba 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_file.ts +++ b/src/plugins/saved_objects_management/public/lib/import_file.ts @@ -17,14 +17,18 @@ * under the License. */ -import { kfetch } from 'ui/kfetch'; +import { HttpStart, SavedObjectsImportError } from 'src/core/public'; -export async function importFile(file: Blob, overwriteAll: boolean = false) { +interface ImportResponse { + success: boolean; + successCount: number; + errors?: SavedObjectsImportError[]; +} + +export async function importFile(http: HttpStart, file: File, overwriteAll: boolean = false) { const formData = new FormData(); formData.append('file', file); - return await kfetch({ - method: 'POST', - pathname: '/api/saved_objects/_import', + return await http.post<ImportResponse>('/api/saved_objects/_import', { body: formData, headers: { // Important to be undefined, it forces proper headers to be set for FormData diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_legacy_file.test.ts b/src/plugins/saved_objects_management/public/lib/import_legacy_file.test.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_legacy_file.test.ts rename to src/plugins/saved_objects_management/public/lib/import_legacy_file.test.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_legacy_file.ts b/src/plugins/saved_objects_management/public/lib/import_legacy_file.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/import_legacy_file.ts rename to src/plugins/saved_objects_management/public/lib/import_legacy_file.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/in_app_url.test.ts b/src/plugins/saved_objects_management/public/lib/in_app_url.test.ts similarity index 98% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/in_app_url.test.ts rename to src/plugins/saved_objects_management/public/lib/in_app_url.test.ts index c0d6716391a1f..09e08e6ec333b 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/in_app_url.test.ts +++ b/src/plugins/saved_objects_management/public/lib/in_app_url.test.ts @@ -17,7 +17,7 @@ * under the License. */ -import { Capabilities } from '../../../../../../../../core/public'; +import { Capabilities } from '../../../../core/public'; import { canViewInApp } from './in_app_url'; const createCapabilities = (sections: Record<string, any>): Capabilities => { diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/in_app_url.ts b/src/plugins/saved_objects_management/public/lib/in_app_url.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/in_app_url.ts rename to src/plugins/saved_objects_management/public/lib/in_app_url.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/index.ts b/src/plugins/saved_objects_management/public/lib/index.ts similarity index 94% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/index.ts rename to src/plugins/saved_objects_management/public/lib/index.ts index ecdfa6549a54e..7021744095651 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/index.ts +++ b/src/plugins/saved_objects_management/public/lib/index.ts @@ -43,3 +43,5 @@ export { export { getDefaultTitle } from './get_default_title'; export { findObjects } from './find_objects'; export { extractExportDetails, SavedObjectsExportResultDetails } from './extract_export_details'; +export { createFieldList } from './create_field_list'; +export { getAllowedTypes } from './get_allowed_types'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/log_legacy_import.ts b/src/plugins/saved_objects_management/public/lib/log_legacy_import.ts similarity index 81% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/log_legacy_import.ts rename to src/plugins/saved_objects_management/public/lib/log_legacy_import.ts index 9bbafe3e69c98..9ec3c85b91c22 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/log_legacy_import.ts +++ b/src/plugins/saved_objects_management/public/lib/log_legacy_import.ts @@ -17,11 +17,8 @@ * under the License. */ -import { kfetch } from 'ui/kfetch'; +import { HttpStart } from 'src/core/public'; -export async function logLegacyImport() { - return await kfetch({ - method: 'POST', - pathname: '/api/saved_objects/_log_legacy_import', - }); +export async function logLegacyImport(http: HttpStart) { + return http.post('/api/saved_objects/_log_legacy_import'); } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/numeric.ts b/src/plugins/saved_objects_management/public/lib/numeric.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/numeric.ts rename to src/plugins/saved_objects_management/public/lib/numeric.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/parse_query.test.ts b/src/plugins/saved_objects_management/public/lib/parse_query.test.ts similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/parse_query.test.ts rename to src/plugins/saved_objects_management/public/lib/parse_query.test.ts index 77b34eccd9c6f..f62234eaf4e94 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/parse_query.test.ts +++ b/src/plugins/saved_objects_management/public/lib/parse_query.test.ts @@ -25,6 +25,6 @@ describe('getQueryText', () => { getTermClauses: () => [{ value: 'foo' }, { value: 'bar' }], getFieldClauses: () => [{ value: 'lala' }, { value: 'lolo' }], }; - expect(parseQuery({ ast })).toEqual({ queryText: 'foo bar', visibleTypes: 'lala' }); + expect(parseQuery({ ast } as any)).toEqual({ queryText: 'foo bar', visibleTypes: 'lala' }); }); }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/parse_query.ts b/src/plugins/saved_objects_management/public/lib/parse_query.ts similarity index 77% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/parse_query.ts rename to src/plugins/saved_objects_management/public/lib/parse_query.ts index 9b33deedafd95..f5b7b69ea049c 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/parse_query.ts +++ b/src/plugins/saved_objects_management/public/lib/parse_query.ts @@ -17,9 +17,16 @@ * under the License. */ -export function parseQuery(query: any) { - let queryText; - let visibleTypes; +import { Query } from '@elastic/eui'; + +interface ParsedQuery { + queryText?: string; + visibleTypes?: string[]; +} + +export function parseQuery(query: Query): ParsedQuery { + let queryText: string | undefined; + let visibleTypes: string[] | undefined; if (query) { if (query.ast.getTermClauses().length) { @@ -29,7 +36,7 @@ export function parseQuery(query: any) { .join(' '); } if (query.ast.getFieldClauses('type')) { - visibleTypes = query.ast.getFieldClauses('type')[0].value; + visibleTypes = query.ast.getFieldClauses('type')[0].value as string[]; } } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/process_import_response.test.ts b/src/plugins/saved_objects_management/public/lib/process_import_response.test.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/process_import_response.test.ts rename to src/plugins/saved_objects_management/public/lib/process_import_response.test.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/process_import_response.ts b/src/plugins/saved_objects_management/public/lib/process_import_response.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/process_import_response.ts rename to src/plugins/saved_objects_management/public/lib/process_import_response.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_import_errors.test.ts b/src/plugins/saved_objects_management/public/lib/resolve_import_errors.test.ts similarity index 90% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_import_errors.test.ts rename to src/plugins/saved_objects_management/public/lib/resolve_import_errors.test.ts index b94b0a9d1291f..86eebad7ae787 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_import_errors.test.ts +++ b/src/plugins/saved_objects_management/public/lib/resolve_import_errors.test.ts @@ -17,14 +17,10 @@ * under the License. */ -jest.mock('ui/kfetch', () => ({ kfetch: jest.fn() })); - import { SavedObjectsImportUnknownError } from 'src/core/public'; -import { kfetch } from 'ui/kfetch'; +import { httpServiceMock } from '../../../../core/public/mocks'; import { resolveImportErrors } from './resolve_import_errors'; -const kfetchMock = kfetch as jest.Mock; - function getFormData(form: Map<string, any>) { const formData: Record<string, any> = {}; for (const [key, val] of form.entries()) { @@ -39,13 +35,20 @@ function getFormData(form: Map<string, any>) { describe('resolveImportErrors', () => { const getConflictResolutions = jest.fn(); + let httpMock: ReturnType<typeof httpServiceMock.createSetupContract>; beforeEach(() => { + httpMock = httpServiceMock.createSetupContract(); jest.resetAllMocks(); }); + const extractBodyFromCall = (index: number): Map<string, any> => { + return (httpMock.post.mock.calls[index] as any)[1].body; + }; + test('works with empty import failures', async () => { const result = await resolveImportErrors({ + http: httpMock, getConflictResolutions, state: { importCount: 0, @@ -62,6 +65,7 @@ Object { test(`doesn't retry if only unknown failures are passed in`, async () => { const result = await resolveImportErrors({ + http: httpMock, getConflictResolutions, state: { importCount: 0, @@ -98,7 +102,7 @@ Object { }); test('resolves conflicts', async () => { - kfetchMock.mockResolvedValueOnce({ + httpMock.post.mockResolvedValueOnce({ success: true, successCount: 1, }); @@ -107,6 +111,7 @@ Object { 'a:2': false, }); const result = await resolveImportErrors({ + http: httpMock, getConflictResolutions, state: { importCount: 0, @@ -139,7 +144,8 @@ Object { "status": "success", } `); - const formData = getFormData(kfetchMock.mock.calls[0][0].body); + + const formData = getFormData(extractBodyFromCall(0)); expect(formData).toMatchInlineSnapshot(` Object { "file": "undefined", @@ -156,12 +162,13 @@ Object { }); test('resolves missing references', async () => { - kfetchMock.mockResolvedValueOnce({ + httpMock.post.mockResolvedValueOnce({ success: true, successCount: 2, }); getConflictResolutions.mockResolvedValueOnce({}); const result = await resolveImportErrors({ + http: httpMock, getConflictResolutions, state: { importCount: 0, @@ -203,7 +210,7 @@ Object { "status": "success", } `); - const formData = getFormData(kfetchMock.mock.calls[0][0].body); + const formData = getFormData(extractBodyFromCall(0)); expect(formData).toMatchInlineSnapshot(` Object { "file": "undefined", @@ -232,6 +239,7 @@ Object { test(`doesn't resolve missing references if newIndexPatternId isn't defined`, async () => { getConflictResolutions.mockResolvedValueOnce({}); const result = await resolveImportErrors({ + http: httpMock, getConflictResolutions, state: { importCount: 0, @@ -276,7 +284,7 @@ Object { }); test('handles missing references then conflicts on the same errored objects', async () => { - kfetchMock.mockResolvedValueOnce({ + httpMock.post.mockResolvedValueOnce({ success: false, successCount: 0, errors: [ @@ -289,7 +297,7 @@ Object { }, ], }); - kfetchMock.mockResolvedValueOnce({ + httpMock.post.mockResolvedValueOnce({ success: true, successCount: 1, }); @@ -298,6 +306,7 @@ Object { 'a:1': true, }); const result = await resolveImportErrors({ + http: httpMock, getConflictResolutions, state: { importCount: 0, @@ -334,7 +343,7 @@ Object { "status": "success", } `); - const formData1 = getFormData(kfetchMock.mock.calls[0][0].body); + const formData1 = getFormData(extractBodyFromCall(0)); expect(formData1).toMatchInlineSnapshot(` Object { "file": "undefined", @@ -354,7 +363,7 @@ Object { ], } `); - const formData2 = getFormData(kfetchMock.mock.calls[1][0].body); + const formData2 = getFormData(extractBodyFromCall(1)); expect(formData2).toMatchInlineSnapshot(` Object { "file": "undefined", diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_import_errors.ts b/src/plugins/saved_objects_management/public/lib/resolve_import_errors.ts similarity index 95% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_import_errors.ts rename to src/plugins/saved_objects_management/public/lib/resolve_import_errors.ts index dcc282402147d..0aea7114bad1c 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_import_errors.ts +++ b/src/plugins/saved_objects_management/public/lib/resolve_import_errors.ts @@ -17,7 +17,7 @@ * under the License. */ -import { kfetch } from 'ui/kfetch'; +import { HttpStart } from 'src/core/public'; import { FailedImport } from './process_import_response'; interface RetryObject { @@ -27,13 +27,11 @@ interface RetryObject { replaceReferences?: any[]; } -async function callResolveImportErrorsApi(file: File, retries: any) { +async function callResolveImportErrorsApi(http: HttpStart, file: File, retries: any) { const formData = new FormData(); formData.append('file', file); formData.append('retries', JSON.stringify(retries)); - return await kfetch({ - method: 'POST', - pathname: '/api/saved_objects/_resolve_import_errors', + return http.post<any>('/api/saved_objects/_resolve_import_errors', { headers: { // Important to be undefined, it forces proper headers to be set for FormData 'Content-Type': undefined, @@ -100,9 +98,11 @@ function mapImportFailureToRetryObject({ } export async function resolveImportErrors({ + http, getConflictResolutions, state, }: { + http: HttpStart; getConflictResolutions: (objects: any[]) => Promise<Record<string, boolean>>; state: { importCount: number; failedImports?: FailedImport[] } & Record<string, any>; }) { @@ -170,7 +170,7 @@ export async function resolveImportErrors({ } // Call API - const response = await callResolveImportErrorsApi(file, retries); + const response = await callResolveImportErrorsApi(http, file, retries); successImportCount += response.successCount; importFailures = []; for (const { error, ...obj } of response.errors || []) { diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_saved_objects.test.ts b/src/plugins/saved_objects_management/public/lib/resolve_saved_objects.test.ts similarity index 98% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_saved_objects.test.ts rename to src/plugins/saved_objects_management/public/lib/resolve_saved_objects.test.ts index dc6d2643145ff..23c2b75169555 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_saved_objects.test.ts +++ b/src/plugins/saved_objects_management/public/lib/resolve_saved_objects.test.ts @@ -23,11 +23,8 @@ import { saveObjects, saveObject, } from './resolve_saved_objects'; -import { - SavedObject, - SavedObjectLoader, -} from '../../../../../../../../plugins/saved_objects/public'; -import { IndexPatternsContract } from '../../../../../../../../plugins/data/public'; +import { SavedObject, SavedObjectLoader } from '../../../saved_objects/public'; +import { IndexPatternsContract } from '../../../data/public'; class SavedObjectNotFound extends Error { constructor(options: Record<string, any>) { diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_saved_objects.ts b/src/plugins/saved_objects_management/public/lib/resolve_saved_objects.ts similarity index 94% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_saved_objects.ts rename to src/plugins/saved_objects_management/public/lib/resolve_saved_objects.ts index d9473367f7502..15e03ed39d88c 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/lib/resolve_saved_objects.ts +++ b/src/plugins/saved_objects_management/public/lib/resolve_saved_objects.ts @@ -20,15 +20,8 @@ import { i18n } from '@kbn/i18n'; import { cloneDeep } from 'lodash'; import { OverlayStart, SavedObjectReference } from 'src/core/public'; -import { - SavedObject, - SavedObjectLoader, -} from '../../../../../../../../plugins/saved_objects/public'; -import { - IndexPatternsContract, - IIndexPattern, - createSearchSource, -} from '../../../../../../../../plugins/data/public'; +import { SavedObject, SavedObjectLoader } from '../../../saved_objects/public'; +import { IndexPatternsContract, IIndexPattern, createSearchSource } from '../../../data/public'; type SavedObjectsRawDoc = Record<string, any>; @@ -55,7 +48,7 @@ function addJsonFieldToIndexPattern( target[fieldName] = JSON.parse(sourceString); } catch (error) { throw new Error( - i18n.translate('kbn.management.objects.parsingFieldErrorMessage', { + i18n.translate('savedObjectsManagement.parsingFieldErrorMessage', { defaultMessage: 'Error encountered parsing {fieldName} for index pattern {indexName}: {errorMessage}', values: { @@ -103,18 +96,21 @@ async function importIndexPattern( if (!newId) { // We can override and we want to prompt for confirmation const isConfirmed = await openConfirm( - i18n.translate('kbn.management.indexPattern.confirmOverwriteLabel', { + i18n.translate('savedObjectsManagement.indexPattern.confirmOverwriteLabel', { values: { title }, defaultMessage: "Are you sure you want to overwrite '{title}'?", }), { - title: i18n.translate('kbn.management.indexPattern.confirmOverwriteTitle', { + title: i18n.translate('savedObjectsManagement.indexPattern.confirmOverwriteTitle', { defaultMessage: 'Overwrite {type}?', values: { type }, }), - confirmButtonText: i18n.translate('kbn.management.indexPattern.confirmOverwriteButton', { - defaultMessage: 'Overwrite', - }), + confirmButtonText: i18n.translate( + 'savedObjectsManagement.indexPattern.confirmOverwriteButton', + { + defaultMessage: 'Overwrite', + } + ), } ); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/index.js b/src/plugins/saved_objects_management/public/management_section/index.ts similarity index 93% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/index.js rename to src/plugins/saved_objects_management/public/management_section/index.ts index 522b1ce83a6b6..1bccb2102f3b4 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/index.js +++ b/src/plugins/saved_objects_management/public/management_section/index.ts @@ -17,4 +17,4 @@ * under the License. */ -export { Relationships } from './relationships'; +export { mountManagementSection } from './mount_section'; diff --git a/src/plugins/saved_objects_management/public/management_section/mount_section.tsx b/src/plugins/saved_objects_management/public/management_section/mount_section.tsx new file mode 100644 index 0000000000000..6f03f97079bb6 --- /dev/null +++ b/src/plugins/saved_objects_management/public/management_section/mount_section.tsx @@ -0,0 +1,211 @@ +/* + * 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. + */ + +import React, { useEffect } from 'react'; +import ReactDOM from 'react-dom'; +import { HashRouter, Switch, Route, useParams, useLocation } from 'react-router-dom'; +import { parse } from 'query-string'; +import { get } from 'lodash'; +import { i18n } from '@kbn/i18n'; +import { I18nProvider } from '@kbn/i18n/react'; +import { CoreSetup, CoreStart, ChromeBreadcrumb, Capabilities } from 'src/core/public'; +import { ManagementAppMountParams } from '../../../management/public'; +import { DataPublicPluginStart } from '../../../data/public'; +import { StartDependencies, SavedObjectsManagementPluginStart } from '../plugin'; +import { + ISavedObjectsManagementServiceRegistry, + SavedObjectsManagementActionServiceStart, +} from '../services'; +import { SavedObjectsTable } from './objects_table'; +import { SavedObjectEdition } from './object_view'; +import { getAllowedTypes } from './../lib'; + +interface MountParams { + core: CoreSetup<StartDependencies, SavedObjectsManagementPluginStart>; + serviceRegistry: ISavedObjectsManagementServiceRegistry; + mountParams: ManagementAppMountParams; +} + +let allowedObjectTypes: string[] | undefined; + +export const mountManagementSection = async ({ + core, + mountParams, + serviceRegistry, +}: MountParams) => { + const [coreStart, { data }, pluginStart] = await core.getStartServices(); + const { element, basePath, setBreadcrumbs } = mountParams; + if (allowedObjectTypes === undefined) { + allowedObjectTypes = await getAllowedTypes(coreStart.http); + } + + const capabilities = coreStart.application.capabilities; + + ReactDOM.render( + <I18nProvider> + <HashRouter basename={basePath}> + <Switch> + <Route path={'/:service/:id'} exact={true}> + <RedirectToHomeIfUnauthorized capabilities={capabilities}> + <SavedObjectsEditionPage + coreStart={coreStart} + serviceRegistry={serviceRegistry} + setBreadcrumbs={setBreadcrumbs} + /> + </RedirectToHomeIfUnauthorized> + </Route> + <Route path={'/'} exact={false}> + <RedirectToHomeIfUnauthorized capabilities={capabilities}> + <SavedObjectsTablePage + coreStart={coreStart} + dataStart={data} + serviceRegistry={serviceRegistry} + actionRegistry={pluginStart.actions} + allowedTypes={allowedObjectTypes} + setBreadcrumbs={setBreadcrumbs} + /> + </RedirectToHomeIfUnauthorized> + </Route> + </Switch> + </HashRouter> + </I18nProvider>, + element + ); + + return () => { + ReactDOM.unmountComponentAtNode(element); + }; +}; + +const RedirectToHomeIfUnauthorized: React.FunctionComponent<{ + capabilities: Capabilities; +}> = ({ children, capabilities }) => { + const allowed = capabilities?.management?.kibana?.objects ?? false; + if (!allowed) { + window.location.hash = '/home'; + return null; + } + return children! as React.ReactElement; +}; + +const SavedObjectsEditionPage = ({ + coreStart, + serviceRegistry, + setBreadcrumbs, +}: { + coreStart: CoreStart; + serviceRegistry: ISavedObjectsManagementServiceRegistry; + setBreadcrumbs: (crumbs: ChromeBreadcrumb[]) => void; +}) => { + const { service: serviceName, id } = useParams<{ service: string; id: string }>(); + const capabilities = coreStart.application.capabilities; + + const { search } = useLocation(); + const query = parse(search); + const service = serviceRegistry.get(serviceName); + + useEffect(() => { + setBreadcrumbs([ + { + text: i18n.translate('savedObjectsManagement.breadcrumb.index', { + defaultMessage: 'Saved objects', + }), + href: '#/management/kibana/objects', + }, + { + text: i18n.translate('savedObjectsManagement.breadcrumb.edit', { + defaultMessage: 'Edit {savedObjectType}', + values: { savedObjectType: service?.service.type ?? 'object' }, + }), + }, + ]); + }, [setBreadcrumbs, service]); + + return ( + <SavedObjectEdition + id={id} + serviceName={serviceName} + serviceRegistry={serviceRegistry} + savedObjectsClient={coreStart.savedObjects.client} + overlays={coreStart.overlays} + notifications={coreStart.notifications} + capabilities={capabilities} + notFoundType={query.notFound as string} + /> + ); +}; + +const SavedObjectsTablePage = ({ + coreStart, + dataStart, + allowedTypes, + serviceRegistry, + actionRegistry, + setBreadcrumbs, +}: { + coreStart: CoreStart; + dataStart: DataPublicPluginStart; + allowedTypes: string[]; + serviceRegistry: ISavedObjectsManagementServiceRegistry; + actionRegistry: SavedObjectsManagementActionServiceStart; + setBreadcrumbs: (crumbs: ChromeBreadcrumb[]) => void; +}) => { + const capabilities = coreStart.application.capabilities; + const itemsPerPage = coreStart.uiSettings.get<number>('savedObjects:perPage', 50); + + useEffect(() => { + setBreadcrumbs([ + { + text: i18n.translate('savedObjectsManagement.breadcrumb.index', { + defaultMessage: 'Saved objects', + }), + href: '#/management/kibana/objects', + }, + ]); + }, [setBreadcrumbs]); + + return ( + <SavedObjectsTable + allowedTypes={allowedTypes} + serviceRegistry={serviceRegistry} + actionRegistry={actionRegistry} + savedObjectsClient={coreStart.savedObjects.client} + indexPatterns={dataStart.indexPatterns} + http={coreStart.http} + overlays={coreStart.overlays} + notifications={coreStart.notifications} + applications={coreStart.application} + perPageConfig={itemsPerPage} + goInspectObject={savedObject => { + const { editUrl } = savedObject.meta; + if (editUrl) { + // previously, kbnUrl.change(object.meta.editUrl); was used. + // using direct access to location.hash seems the only option for now, + // as using react-router-dom will prefix the url with the router's basename + // which should be ignored there. + window.location.hash = editUrl; + } + }} + canGoInApp={savedObject => { + const { inAppUrl } = savedObject.meta; + return inAppUrl ? get(capabilities, inAppUrl.uiCapabilitiesPath) : false; + }} + /> + ); +}; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/header.test.tsx.snap b/src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/header.test.tsx.snap similarity index 96% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/header.test.tsx.snap rename to src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/header.test.tsx.snap index 7e1f7ea12b014..d56776c2be9d7 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/header.test.tsx.snap +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/header.test.tsx.snap @@ -23,7 +23,7 @@ exports[`Intro component renders correctly 1`] = ` > <FormattedMessage defaultMessage="Edit {title}" - id="kbn.management.objects.view.editItemTitle" + id="savedObjectsManagement.view.editItemTitle" values={ Object { "title": "search", @@ -85,7 +85,7 @@ exports[`Intro component renders correctly 1`] = ` > <FormattedMessage defaultMessage="View {title}" - id="kbn.management.objects.view.viewItemButtonLabel" + id="savedObjectsManagement.view.viewItemButtonLabel" values={ Object { "title": "search", @@ -140,7 +140,7 @@ exports[`Intro component renders correctly 1`] = ` > <FormattedMessage defaultMessage="Delete {title}" - id="kbn.management.objects.view.deleteItemButtonLabel" + id="savedObjectsManagement.view.deleteItemButtonLabel" values={ Object { "title": "search", diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/intro.test.tsx.snap b/src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/intro.test.tsx.snap similarity index 90% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/intro.test.tsx.snap rename to src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/intro.test.tsx.snap index 812031b4b363c..ff179401e6f71 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/intro.test.tsx.snap +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/intro.test.tsx.snap @@ -8,7 +8,7 @@ exports[`Intro component renders correctly 1`] = ` title={ <FormattedMessage defaultMessage="Proceed with caution!" - id="kbn.management.objects.view.howToModifyObjectTitle" + id="savedObjectsManagement.view.howToModifyObjectTitle" values={Object {}} /> } @@ -37,7 +37,7 @@ exports[`Intro component renders correctly 1`] = ` > <FormattedMessage defaultMessage="Proceed with caution!" - id="kbn.management.objects.view.howToModifyObjectTitle" + id="savedObjectsManagement.view.howToModifyObjectTitle" values={Object {}} > Proceed with caution! @@ -53,7 +53,7 @@ exports[`Intro component renders correctly 1`] = ` <div> <FormattedMessage defaultMessage="Modifying objects is for advanced users only. Object properties are not validated and invalid objects could cause errors, data loss, or worse. Unless someone with intimate knowledge of the code told you to be in here, you probably shouldn’t be." - id="kbn.management.objects.view.howToModifyObjectDescription" + id="savedObjectsManagement.view.howToModifyObjectDescription" values={Object {}} > Modifying objects is for advanced users only. Object properties are not validated and invalid objects could cause errors, data loss, or worse. Unless someone with intimate knowledge of the code told you to be in here, you probably shouldn’t be. diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/not_found_errors.test.tsx.snap b/src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/not_found_errors.test.tsx.snap similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/not_found_errors.test.tsx.snap rename to src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/not_found_errors.test.tsx.snap index ac565a000813e..d5372fd5b18d9 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/__snapshots__/not_found_errors.test.tsx.snap +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/__snapshots__/not_found_errors.test.tsx.snap @@ -10,7 +10,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern type 1`] = title={ <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} /> } @@ -39,7 +39,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern type 1`] = > <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} > There is a problem with this saved object @@ -55,7 +55,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern type 1`] = <div> <FormattedMessage defaultMessage="The index pattern associated with this object no longer exists." - id="kbn.management.objects.view.indexPatternDoesNotExistErrorMessage" + id="savedObjectsManagement.view.indexPatternDoesNotExistErrorMessage" values={Object {}} > The index pattern associated with this object no longer exists. @@ -64,7 +64,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern type 1`] = <div> <FormattedMessage defaultMessage="If you know what this error means, go ahead and fix it — otherwise click the delete button above." - id="kbn.management.objects.view.howToFixErrorDescription" + id="savedObjectsManagement.view.howToFixErrorDescription" values={Object {}} > If you know what this error means, go ahead and fix it — otherwise click the delete button above. @@ -87,7 +87,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern-field type title={ <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} /> } @@ -116,7 +116,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern-field type > <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} > There is a problem with this saved object @@ -132,7 +132,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern-field type <div> <FormattedMessage defaultMessage="A field associated with this object no longer exists in the index pattern." - id="kbn.management.objects.view.fieldDoesNotExistErrorMessage" + id="savedObjectsManagement.view.fieldDoesNotExistErrorMessage" values={Object {}} > A field associated with this object no longer exists in the index pattern. @@ -141,7 +141,7 @@ exports[`NotFoundErrors component renders correctly for index-pattern-field type <div> <FormattedMessage defaultMessage="If you know what this error means, go ahead and fix it — otherwise click the delete button above." - id="kbn.management.objects.view.howToFixErrorDescription" + id="savedObjectsManagement.view.howToFixErrorDescription" values={Object {}} > If you know what this error means, go ahead and fix it — otherwise click the delete button above. @@ -164,7 +164,7 @@ exports[`NotFoundErrors component renders correctly for search type 1`] = ` title={ <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} /> } @@ -193,7 +193,7 @@ exports[`NotFoundErrors component renders correctly for search type 1`] = ` > <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} > There is a problem with this saved object @@ -209,7 +209,7 @@ exports[`NotFoundErrors component renders correctly for search type 1`] = ` <div> <FormattedMessage defaultMessage="The saved search associated with this object no longer exists." - id="kbn.management.objects.view.savedSearchDoesNotExistErrorMessage" + id="savedObjectsManagement.view.savedSearchDoesNotExistErrorMessage" values={Object {}} > The saved search associated with this object no longer exists. @@ -218,7 +218,7 @@ exports[`NotFoundErrors component renders correctly for search type 1`] = ` <div> <FormattedMessage defaultMessage="If you know what this error means, go ahead and fix it — otherwise click the delete button above." - id="kbn.management.objects.view.howToFixErrorDescription" + id="savedObjectsManagement.view.howToFixErrorDescription" values={Object {}} > If you know what this error means, go ahead and fix it — otherwise click the delete button above. @@ -241,7 +241,7 @@ exports[`NotFoundErrors component renders correctly for unknown type 1`] = ` title={ <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} /> } @@ -270,7 +270,7 @@ exports[`NotFoundErrors component renders correctly for unknown type 1`] = ` > <FormattedMessage defaultMessage="There is a problem with this saved object" - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" values={Object {}} > There is a problem with this saved object @@ -287,7 +287,7 @@ exports[`NotFoundErrors component renders correctly for unknown type 1`] = ` <div> <FormattedMessage defaultMessage="If you know what this error means, go ahead and fix it — otherwise click the delete button above." - id="kbn.management.objects.view.howToFixErrorDescription" + id="savedObjectsManagement.view.howToFixErrorDescription" values={Object {}} > If you know what this error means, go ahead and fix it — otherwise click the delete button above. diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/field.test.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/field.test.tsx similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/field.test.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/field.test.tsx diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/field.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/field.tsx similarity index 97% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/field.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/field.tsx index 1ed0b57e400b8..1b69eb4240d68 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/field.tsx +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/field.tsx @@ -104,9 +104,9 @@ export class Field extends PureComponent<FieldProps> { id={this.fieldId} label={ !!currentValue ? ( - <FormattedMessage id="kbn.management.objects.field.onLabel" defaultMessage="On" /> + <FormattedMessage id="savedObjectsManagement.field.onLabel" defaultMessage="On" /> ) : ( - <FormattedMessage id="kbn.management.objects.field.offLabel" defaultMessage="Off" /> + <FormattedMessage id="savedObjectsManagement.field.offLabel" defaultMessage="Off" /> ) } checked={!!currentValue} diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/form.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/form.tsx similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/form.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/form.tsx index 7270d41eef529..04be7ee3ce207 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/form.tsx +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/form.tsx @@ -29,15 +29,11 @@ import { import { cloneDeep, set } from 'lodash'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { - SimpleSavedObject, - SavedObjectsClientContract, -} from '../../../../../../../../../core/public'; - -import { SavedObjectLoader } from '../../../../../../../../../plugins/saved_objects/public'; +import { SimpleSavedObject, SavedObjectsClientContract } from '../../../../../../core/public'; +import { SavedObjectLoader } from '../../../../../saved_objects/public'; import { Field } from './field'; import { ObjectField, FieldState, SubmittedFormData } from '../../types'; -import { createFieldList } from '../../lib/create_field_list'; +import { createFieldList } from '../../../lib'; interface FormProps { object: SimpleSavedObject; @@ -96,7 +92,7 @@ export class Form extends Component<FormProps, FormState> { <EuiFlexItem grow={false}> <EuiButton fill={true} - aria-label={i18n.translate('kbn.management.objects.view.saveButtonAriaLabel', { + aria-label={i18n.translate('savedObjectsManagement.view.saveButtonAriaLabel', { defaultMessage: 'Save { title } object', values: { title: service.type, @@ -107,7 +103,7 @@ export class Form extends Component<FormProps, FormState> { data-test-subj="savedObjectEditSave" > <FormattedMessage - id="kbn.management.objects.view.saveButtonLabel" + id="savedObjectsManagement.view.saveButtonLabel" defaultMessage="Save { title } object" values={{ title: service.type }} /> @@ -117,14 +113,14 @@ export class Form extends Component<FormProps, FormState> { <EuiFlexItem grow={false}> <EuiButtonEmpty - aria-label={i18n.translate('kbn.management.objects.view.cancelButtonAriaLabel', { + aria-label={i18n.translate('savedObjectsManagement.view.cancelButtonAriaLabel', { defaultMessage: 'Cancel', })} onClick={this.onCancel} data-test-subj="savedObjectEditCancel" > <FormattedMessage - id="kbn.management.objects.view.cancelButtonLabel" + id="savedObjectsManagement.view.cancelButtonLabel" defaultMessage="Cancel" /> </EuiButtonEmpty> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/header.test.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/header.test.tsx similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/header.test.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/header.test.tsx diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/header.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/header.tsx similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/header.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/header.tsx index 641493e0cbaa8..305d953c4990b 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/header.tsx +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/header.tsx @@ -52,7 +52,7 @@ export const Header = ({ {canEdit ? ( <h1> <FormattedMessage - id="kbn.management.objects.view.editItemTitle" + id="savedObjectsManagement.view.editItemTitle" defaultMessage="Edit {title}" values={{ title: type }} /> @@ -60,7 +60,7 @@ export const Header = ({ ) : ( <h1> <FormattedMessage - id="kbn.management.objects.view.viewItemTitle" + id="savedObjectsManagement.view.viewItemTitle" defaultMessage="View {title}" values={{ title: type }} /> @@ -79,7 +79,7 @@ export const Header = ({ data-test-subj="savedObjectEditViewInApp" > <FormattedMessage - id="kbn.management.objects.view.viewItemButtonLabel" + id="savedObjectsManagement.view.viewItemButtonLabel" defaultMessage="View {title}" values={{ title: type }} /> @@ -96,7 +96,7 @@ export const Header = ({ data-test-subj="savedObjectEditDelete" > <FormattedMessage - id="kbn.management.objects.view.deleteItemButtonLabel" + id="savedObjectsManagement.view.deleteItemButtonLabel" defaultMessage="Delete {title}" values={{ title: type }} /> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/index.ts b/src/plugins/saved_objects_management/public/management_section/object_view/components/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/index.ts rename to src/plugins/saved_objects_management/public/management_section/object_view/components/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/intro.test.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/intro.test.tsx similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/intro.test.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/intro.test.tsx diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/intro.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/intro.tsx similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/intro.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/intro.tsx index 098ad71345d49..920a5fcbcb02e 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/intro.tsx +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/intro.tsx @@ -26,7 +26,7 @@ export const Intro = () => { <EuiCallOut title={ <FormattedMessage - id="kbn.management.objects.view.howToModifyObjectTitle" + id="savedObjectsManagement.view.howToModifyObjectTitle" defaultMessage="Proceed with caution!" /> } @@ -35,7 +35,7 @@ export const Intro = () => { > <div> <FormattedMessage - id="kbn.management.objects.view.howToModifyObjectDescription" + id="savedObjectsManagement.view.howToModifyObjectDescription" defaultMessage="Modifying objects is for advanced users only. Object properties are not validated and invalid objects could cause errors, data loss, or worse. Unless someone with intimate knowledge of the code told you to be in here, you probably shouldn’t be." /> </div> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/not_found_errors.test.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/not_found_errors.test.tsx similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/not_found_errors.test.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/not_found_errors.test.tsx diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/not_found_errors.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/components/not_found_errors.tsx similarity index 87% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/not_found_errors.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/components/not_found_errors.tsx index c3d18855f6c9a..1a63f7eaf4819 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/object_view/not_found_errors.tsx +++ b/src/plugins/saved_objects_management/public/management_section/object_view/components/not_found_errors.tsx @@ -31,21 +31,21 @@ export const NotFoundErrors = ({ type }: NotFoundErrors) => { case 'search': return ( <FormattedMessage - id="kbn.management.objects.view.savedSearchDoesNotExistErrorMessage" + id="savedObjectsManagement.view.savedSearchDoesNotExistErrorMessage" defaultMessage="The saved search associated with this object no longer exists." /> ); case 'index-pattern': return ( <FormattedMessage - id="kbn.management.objects.view.indexPatternDoesNotExistErrorMessage" + id="savedObjectsManagement.view.indexPatternDoesNotExistErrorMessage" defaultMessage="The index pattern associated with this object no longer exists." /> ); case 'index-pattern-field': return ( <FormattedMessage - id="kbn.management.objects.view.fieldDoesNotExistErrorMessage" + id="savedObjectsManagement.view.fieldDoesNotExistErrorMessage" defaultMessage="A field associated with this object no longer exists in the index pattern." /> ); @@ -58,7 +58,7 @@ export const NotFoundErrors = ({ type }: NotFoundErrors) => { <EuiCallOut title={ <FormattedMessage - id="kbn.management.objects.view.savedObjectProblemErrorMessage" + id="savedObjectsManagement.view.savedObjectProblemErrorMessage" defaultMessage="There is a problem with this saved object" /> } @@ -68,7 +68,7 @@ export const NotFoundErrors = ({ type }: NotFoundErrors) => { <div>{getMessage()}</div> <div> <FormattedMessage - id="kbn.management.objects.view.howToFixErrorDescription" + id="savedObjectsManagement.view.howToFixErrorDescription" defaultMessage="If you know what this error means, go ahead and fix it — otherwise click the delete button above." /> </div> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/index.js b/src/plugins/saved_objects_management/public/management_section/object_view/index.ts similarity index 93% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/index.js rename to src/plugins/saved_objects_management/public/management_section/object_view/index.ts index cdeebdbf7b63a..a823923536d31 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/index.js +++ b/src/plugins/saved_objects_management/public/management_section/object_view/index.ts @@ -17,4 +17,4 @@ * under the License. */ -export { Flyout } from './flyout'; +export { SavedObjectEdition } from './saved_object_view'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/saved_object_view.tsx b/src/plugins/saved_objects_management/public/management_section/object_view/saved_object_view.tsx similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/saved_object_view.tsx rename to src/plugins/saved_objects_management/public/management_section/object_view/saved_object_view.tsx index 4984fe3e6d6b8..f714970a5cac3 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/saved_object_view.tsx +++ b/src/plugins/saved_objects_management/public/management_section/object_view/saved_object_view.tsx @@ -26,16 +26,16 @@ import { OverlayStart, NotificationsStart, SimpleSavedObject, -} from '../../../../../../../core/public'; -import { ISavedObjectsManagementRegistry } from '../../saved_object_registry'; -import { Header, NotFoundErrors, Intro, Form } from './components/object_view'; -import { canViewInApp } from './lib/in_app_url'; -import { SubmittedFormData } from './types'; +} from '../../../../../core/public'; +import { ISavedObjectsManagementServiceRegistry } from '../../services'; +import { Header, NotFoundErrors, Intro, Form } from './components'; +import { canViewInApp } from '../../lib'; +import { SubmittedFormData } from '../types'; interface SavedObjectEditionProps { id: string; serviceName: string; - serviceRegistry: ISavedObjectsManagementRegistry; + serviceRegistry: ISavedObjectsManagementServiceRegistry; capabilities: Capabilities; overlays: OverlayStart; notifications: NotificationsStart; @@ -135,17 +135,17 @@ export class SavedObjectEdition extends Component< const { type, object } = this.state; const confirmed = await overlays.openConfirm( - i18n.translate('kbn.management.objects.confirmModalOptions.modalDescription', { + i18n.translate('savedObjectsManagement.deleteConfirm.modalDescription', { defaultMessage: 'This action permanently removes the object from Kibana.', }), { confirmButtonText: i18n.translate( - 'kbn.management.objects.confirmModalOptions.deleteButtonLabel', + 'savedObjectsManagement.deleteConfirm.modalDeleteButtonLabel', { defaultMessage: 'Delete', } ), - title: i18n.translate('kbn.management.objects.confirmModalOptions.modalTitle', { + title: i18n.translate('savedObjectsManagement.deleteConfirm.modalTitle', { defaultMessage: `Delete '{title}'?`, values: { title: object?.attributes?.title || 'saved Kibana object', diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/__snapshots__/objects_table.test.js.snap b/src/plugins/saved_objects_management/public/management_section/objects_table/__snapshots__/saved_objects_table.test.tsx.snap similarity index 73% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/__snapshots__/objects_table.test.js.snap rename to src/plugins/saved_objects_management/public/management_section/objects_table/__snapshots__/saved_objects_table.test.tsx.snap index 2c0a5d8f6b8f1..fe64df6ff51d1 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/__snapshots__/objects_table.test.js.snap +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/__snapshots__/saved_objects_table.test.tsx.snap @@ -1,19 +1,19 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP -exports[`ObjectsTable delete should show a confirm modal 1`] = ` +exports[`SavedObjectsTable delete should show a confirm modal 1`] = ` <EuiConfirmModal buttonColor="danger" cancelButtonText={ <FormattedMessage defaultMessage="Cancel" - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel" values={Object {}} /> } confirmButtonText={ <FormattedMessage defaultMessage="Delete" - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel" values={Object {}} /> } @@ -23,7 +23,7 @@ exports[`ObjectsTable delete should show a confirm modal 1`] = ` title={ <FormattedMessage defaultMessage="Delete saved objects" - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModalTitle" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModalTitle" values={Object {}} /> } @@ -31,7 +31,7 @@ exports[`ObjectsTable delete should show a confirm modal 1`] = ` <p> <FormattedMessage defaultMessage="This action will delete the following saved objects:" - id="kbn.management.objects.deleteSavedObjectsConfirmModalDescription" + id="savedObjectsManagement.deleteSavedObjectsConfirmModalDescription" values={Object {}} /> </p> @@ -58,12 +58,10 @@ exports[`ObjectsTable delete should show a confirm modal 1`] = ` Array [ Object { "id": "1", - "title": "Title 1", "type": "index-pattern", }, Object { "id": "3", - "title": "Title 2", "type": "dashboard", }, ] @@ -76,7 +74,7 @@ exports[`ObjectsTable delete should show a confirm modal 1`] = ` </EuiConfirmModal> `; -exports[`ObjectsTable export should allow the user to choose when exporting all 1`] = ` +exports[`SavedObjectsTable export should allow the user to choose when exporting all 1`] = ` <EuiModal onClose={[Function]} > @@ -84,7 +82,7 @@ exports[`ObjectsTable export should allow the user to choose when exporting all <EuiModalHeaderTitle> <FormattedMessage defaultMessage="Export {filteredItemCount, plural, one{# object} other {# objects}}" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModalTitle" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModalTitle" values={ Object { "filteredItemCount": 4, @@ -103,7 +101,7 @@ exports[`ObjectsTable export should allow the user to choose when exporting all label={ <FormattedMessage defaultMessage="Select which types to export" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModalDescription" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModalDescription" values={Object {}} /> } @@ -149,7 +147,7 @@ exports[`ObjectsTable export should allow the user to choose when exporting all label={ <FormattedMessage defaultMessage="Include related objects" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" values={Object {}} /> } @@ -173,7 +171,7 @@ exports[`ObjectsTable export should allow the user to choose when exporting all > <FormattedMessage defaultMessage="Cancel" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.cancelButtonLabel" values={Object {}} /> </EuiButtonEmpty> @@ -187,7 +185,7 @@ exports[`ObjectsTable export should allow the user to choose when exporting all > <FormattedMessage defaultMessage="Export all" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel" values={Object {}} /> </EuiButton> @@ -199,23 +197,87 @@ exports[`ObjectsTable export should allow the user to choose when exporting all </EuiModal> `; -exports[`ObjectsTable import should show the flyout 1`] = ` +exports[`SavedObjectsTable import should show the flyout 1`] = ` <Flyout + allowedTypes={ + Array [ + "index-pattern", + "visualization", + "dashboard", + "search", + ] + } close={[Function]} - confirmModalPromise={[MockFunction]} done={[Function]} + http={ + Object { + "addLoadingCountSource": [MockFunction], + "anonymousPaths": Object { + "isAnonymous": [MockFunction], + "register": [MockFunction], + }, + "basePath": BasePath { + "basePath": "", + "get": [Function], + "prepend": [Function], + "remove": [Function], + "serverBasePath": "", + }, + "delete": [MockFunction], + "fetch": [MockFunction], + "get": [MockFunction], + "getLoadingCount$": [MockFunction], + "head": [MockFunction], + "intercept": [MockFunction], + "options": [MockFunction], + "patch": [MockFunction], + "post": [MockFunction], + "put": [MockFunction], + } + } indexPatterns={ Object { "clearCache": [MockFunction], + "get": [MockFunction], + "make": [Function], + } + } + overlays={ + Object { + "banners": Object { + "add": [MockFunction], + "get$": [MockFunction], + "getComponent": [MockFunction], + "remove": [MockFunction], + "replace": [MockFunction], + }, + "openConfirm": [MockFunction], + "openFlyout": [MockFunction], + "openModal": [MockFunction], + } + } + serviceRegistry={ + Object { + "all": [MockFunction], + "get": [MockFunction], + "register": [MockFunction], } } - newIndexPatternUrl="" - services={Array []} /> `; -exports[`ObjectsTable relationships should show the flyout 1`] = ` +exports[`SavedObjectsTable relationships should show the flyout 1`] = ` <Relationships + basePath={ + BasePath { + "basePath": "", + "get": [Function], + "prepend": [Function], + "remove": [Function], + "serverBasePath": "", + } + } + canGoInApp={[Function]} close={[Function]} getRelationships={[Function]} goInspectObject={[Function]} @@ -237,7 +299,7 @@ exports[`ObjectsTable relationships should show the flyout 1`] = ` /> `; -exports[`ObjectsTable should render normally 1`] = ` +exports[`SavedObjectsTable should render normally 1`] = ` <EuiPageContent horizontalPosition="center" > @@ -251,7 +313,23 @@ exports[`ObjectsTable should render normally 1`] = ` size="xs" /> <Table + actionRegistry={ + Object { + "getAll": [MockFunction], + "has": [MockFunction], + } + } + basePath={ + BasePath { + "basePath": "", + "get": [Function], + "prepend": [Function], + "remove": [Function], + "serverBasePath": "", + } + } canDelete={false} + canGoInApp={[Function]} filterOptions={ Array [ Object { diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/__snapshots__/flyout.test.js.snap b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/flyout.test.tsx.snap similarity index 85% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/__snapshots__/flyout.test.js.snap rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/flyout.test.tsx.snap index 34ce8394232ed..4721d166c65e5 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/__snapshots__/flyout.test.js.snap +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/flyout.test.tsx.snap @@ -18,7 +18,7 @@ exports[`Flyout conflicts should allow conflict resolution 1`] = ` <h2> <FormattedMessage defaultMessage="Import saved objects" - id="kbn.management.objects.objectsTable.flyout.importSavedObjectTitle" + id="savedObjectsManagement.objectsTable.flyout.importSavedObjectTitle" values={Object {}} /> </h2> @@ -36,7 +36,7 @@ exports[`Flyout conflicts should allow conflict resolution 1`] = ` title={ <FormattedMessage defaultMessage="Index Pattern Conflicts" - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsTitle" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsTitle" values={Object {}} /> } @@ -44,7 +44,7 @@ exports[`Flyout conflicts should allow conflict resolution 1`] = ` <p> <FormattedMessage defaultMessage="The following saved objects use index patterns that do not exist. Please select the index patterns you'd like re-associated with them. You can {indexPatternLink} if necessary." - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsDescription" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsDescription" values={ Object { "indexPatternLink": <ForwardRef @@ -52,7 +52,7 @@ exports[`Flyout conflicts should allow conflict resolution 1`] = ` > <FormattedMessage defaultMessage="create a new index pattern" - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsCalloutLinkText" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsCalloutLinkText" values={Object {}} /> </ForwardRef>, @@ -131,7 +131,7 @@ exports[`Flyout conflicts should allow conflict resolution 1`] = ` > <FormattedMessage defaultMessage="Cancel" - id="kbn.management.objects.objectsTable.flyout.import.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.import.cancelButtonLabel" values={Object {}} /> </EuiButtonEmpty> @@ -148,7 +148,7 @@ exports[`Flyout conflicts should allow conflict resolution 1`] = ` > <FormattedMessage defaultMessage="Confirm all changes" - id="kbn.management.objects.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel" values={Object {}} /> </EuiButton> @@ -164,6 +164,30 @@ exports[`Flyout conflicts should allow conflict resolution 2`] = ` Array [ Object { "getConflictResolutions": [Function], + "http": Object { + "addLoadingCountSource": [MockFunction], + "anonymousPaths": Object { + "isAnonymous": [MockFunction], + "register": [MockFunction], + }, + "basePath": BasePath { + "basePath": "", + "get": [Function], + "prepend": [Function], + "remove": [Function], + "serverBasePath": "", + }, + "delete": [MockFunction], + "fetch": [MockFunction], + "get": [MockFunction], + "getLoadingCount$": [MockFunction], + "head": [MockFunction], + "intercept": [MockFunction], + "options": [MockFunction], + "patch": [MockFunction], + "post": [MockFunction], + "put": [MockFunction], + }, "state": Object { "conflictedIndexPatterns": undefined, "conflictedSavedObjectsLinkedToSavedSearches": undefined, @@ -243,7 +267,7 @@ exports[`Flyout conflicts should handle errors 1`] = ` title={ <FormattedMessage defaultMessage="Import failed" - id="kbn.management.objects.objectsTable.flyout.importFailedTitle" + id="savedObjectsManagement.objectsTable.flyout.importFailedTitle" values={Object {}} /> } @@ -251,7 +275,7 @@ exports[`Flyout conflicts should handle errors 1`] = ` <p> <FormattedMessage defaultMessage="Failed to import {failedImportCount} of {totalImportCount} objects. Import failed" - id="kbn.management.objects.objectsTable.flyout.importFailedDescription" + id="savedObjectsManagement.objectsTable.flyout.importFailedDescription" values={ Object { "failedImportCount": 1, @@ -272,7 +296,7 @@ exports[`Flyout errors should display unsupported type errors properly 1`] = ` title={ <FormattedMessage defaultMessage="Import failed" - id="kbn.management.objects.objectsTable.flyout.importFailedTitle" + id="savedObjectsManagement.objectsTable.flyout.importFailedTitle" values={Object {}} /> } @@ -280,7 +304,7 @@ exports[`Flyout errors should display unsupported type errors properly 1`] = ` <p> <FormattedMessage defaultMessage="Failed to import {failedImportCount} of {totalImportCount} objects. Import failed" - id="kbn.management.objects.objectsTable.flyout.importFailedDescription" + id="savedObjectsManagement.objectsTable.flyout.importFailedDescription" values={ Object { "failedImportCount": 1, @@ -313,7 +337,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` <h2> <FormattedMessage defaultMessage="Import saved objects" - id="kbn.management.objects.objectsTable.flyout.importSavedObjectTitle" + id="savedObjectsManagement.objectsTable.flyout.importSavedObjectTitle" values={Object {}} /> </h2> @@ -331,7 +355,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` title={ <FormattedMessage defaultMessage="Support for JSON files is going away" - id="kbn.management.objects.objectsTable.flyout.legacyFileUsedTitle" + id="savedObjectsManagement.objectsTable.flyout.legacyFileUsedTitle" values={Object {}} /> } @@ -339,7 +363,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` <p> <FormattedMessage defaultMessage="Use our updated export to generate NDJSON files, and you'll be all set." - id="kbn.management.objects.objectsTable.flyout.legacyFileUsedBody" + id="savedObjectsManagement.objectsTable.flyout.legacyFileUsedBody" values={Object {}} /> </p> @@ -356,7 +380,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` title={ <FormattedMessage defaultMessage="Index Pattern Conflicts" - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsTitle" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsTitle" values={Object {}} /> } @@ -364,7 +388,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` <p> <FormattedMessage defaultMessage="The following saved objects use index patterns that do not exist. Please select the index patterns you'd like re-associated with them. You can {indexPatternLink} if necessary." - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsDescription" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsDescription" values={ Object { "indexPatternLink": <ForwardRef @@ -372,7 +396,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` > <FormattedMessage defaultMessage="create a new index pattern" - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsCalloutLinkText" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsCalloutLinkText" values={Object {}} /> </ForwardRef>, @@ -462,7 +486,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` > <FormattedMessage defaultMessage="Cancel" - id="kbn.management.objects.objectsTable.flyout.import.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.import.cancelButtonLabel" values={Object {}} /> </EuiButtonEmpty> @@ -479,7 +503,7 @@ exports[`Flyout legacy conflicts should allow conflict resolution 1`] = ` > <FormattedMessage defaultMessage="Confirm all changes" - id="kbn.management.objects.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel" values={Object {}} /> </EuiButton> @@ -498,7 +522,7 @@ Array [ title={ <FormattedMessage defaultMessage="Support for JSON files is going away" - id="kbn.management.objects.objectsTable.flyout.legacyFileUsedTitle" + id="savedObjectsManagement.objectsTable.flyout.legacyFileUsedTitle" values={Object {}} /> } @@ -506,7 +530,7 @@ Array [ <p> <FormattedMessage defaultMessage="Use our updated export to generate NDJSON files, and you'll be all set." - id="kbn.management.objects.objectsTable.flyout.legacyFileUsedBody" + id="savedObjectsManagement.objectsTable.flyout.legacyFileUsedBody" values={Object {}} /> </p> @@ -518,7 +542,7 @@ Array [ title={ <FormattedMessage defaultMessage="Index Pattern Conflicts" - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsTitle" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsTitle" values={Object {}} /> } @@ -526,7 +550,7 @@ Array [ <p> <FormattedMessage defaultMessage="The following saved objects use index patterns that do not exist. Please select the index patterns you'd like re-associated with them. You can {indexPatternLink} if necessary." - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsDescription" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsDescription" values={ Object { "indexPatternLink": <ForwardRef @@ -534,7 +558,7 @@ Array [ > <FormattedMessage defaultMessage="create a new index pattern" - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsCalloutLinkText" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsCalloutLinkText" values={Object {}} /> </ForwardRef>, @@ -548,7 +572,7 @@ Array [ title={ <FormattedMessage defaultMessage="Sorry, there was an error" - id="kbn.management.objects.objectsTable.flyout.errorCalloutTitle" + id="savedObjectsManagement.objectsTable.flyout.errorCalloutTitle" values={Object {}} /> } @@ -578,7 +602,7 @@ exports[`Flyout should render import step 1`] = ` <h2> <FormattedMessage defaultMessage="Import saved objects" - id="kbn.management.objects.objectsTable.flyout.importSavedObjectTitle" + id="savedObjectsManagement.objectsTable.flyout.importSavedObjectTitle" values={Object {}} /> </h2> @@ -595,7 +619,7 @@ exports[`Flyout should render import step 1`] = ` label={ <FormattedMessage defaultMessage="Please select a file to import" - id="kbn.management.objects.objectsTable.flyout.selectFileToImportFormRowLabel" + id="savedObjectsManagement.objectsTable.flyout.selectFileToImportFormRowLabel" values={Object {}} /> } @@ -607,7 +631,7 @@ exports[`Flyout should render import step 1`] = ` initialPromptText={ <FormattedMessage defaultMessage="Import" - id="kbn.management.objects.objectsTable.flyout.importPromptText" + id="savedObjectsManagement.objectsTable.flyout.importPromptText" values={Object {}} /> } @@ -628,7 +652,7 @@ exports[`Flyout should render import step 1`] = ` label={ <FormattedMessage defaultMessage="Automatically overwrite all saved objects?" - id="kbn.management.objects.objectsTable.flyout.overwriteSavedObjectsLabel" + id="savedObjectsManagement.objectsTable.flyout.overwriteSavedObjectsLabel" values={Object {}} /> } @@ -651,7 +675,7 @@ exports[`Flyout should render import step 1`] = ` > <FormattedMessage defaultMessage="Cancel" - id="kbn.management.objects.objectsTable.flyout.import.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.import.cancelButtonLabel" values={Object {}} /> </EuiButtonEmpty> @@ -668,7 +692,7 @@ exports[`Flyout should render import step 1`] = ` > <FormattedMessage defaultMessage="Import" - id="kbn.management.objects.objectsTable.flyout.import.confirmButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.import.confirmButtonLabel" values={Object {}} /> </EuiButton> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/__snapshots__/header.test.js.snap b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/header.test.tsx.snap similarity index 88% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/__snapshots__/header.test.js.snap rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/header.test.tsx.snap index 51bd51a5e2e58..642a5030e4ec0 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/__snapshots__/header.test.js.snap +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/header.test.tsx.snap @@ -13,7 +13,7 @@ exports[`Header should render normally 1`] = ` <h1> <FormattedMessage defaultMessage="Saved Objects" - id="kbn.management.objects.objectsTable.header.savedObjectsTitle" + id="savedObjectsManagement.objectsTable.header.savedObjectsTitle" values={Object {}} /> </h1> @@ -38,7 +38,7 @@ exports[`Header should render normally 1`] = ` > <FormattedMessage defaultMessage="Export {filteredCount, plural, one{# object} other {# objects}}" - id="kbn.management.objects.objectsTable.header.exportButtonLabel" + id="savedObjectsManagement.objectsTable.header.exportButtonLabel" values={ Object { "filteredCount": 2, @@ -58,7 +58,7 @@ exports[`Header should render normally 1`] = ` > <FormattedMessage defaultMessage="Import" - id="kbn.management.objects.objectsTable.header.importButtonLabel" + id="savedObjectsManagement.objectsTable.header.importButtonLabel" values={Object {}} /> </EuiButtonEmpty> @@ -73,7 +73,7 @@ exports[`Header should render normally 1`] = ` > <FormattedMessage defaultMessage="Refresh" - id="kbn.management.objects.objectsTable.header.refreshButtonLabel" + id="savedObjectsManagement.objectsTable.header.refreshButtonLabel" values={Object {}} /> </EuiButtonEmpty> @@ -93,7 +93,7 @@ exports[`Header should render normally 1`] = ` > <FormattedMessage defaultMessage="From here you can delete saved objects, such as saved searches. You can also edit the raw data of saved objects. Typically objects are only modified via their associated application, which is probably what you should use instead of this screen." - id="kbn.management.objects.objectsTable.howToDeleteSavedObjectsDescription" + id="savedObjectsManagement.objectsTable.howToDeleteSavedObjectsDescription" values={Object {}} /> </EuiTextColor> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/__snapshots__/relationships.test.js.snap b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/relationships.test.tsx.snap similarity index 99% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/__snapshots__/relationships.test.js.snap rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/relationships.test.tsx.snap index 728944f3ccbfe..a8bb691cd54e9 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/__snapshots__/relationships.test.js.snap +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/relationships.test.tsx.snap @@ -202,7 +202,7 @@ exports[`Relationships should render errors 1`] = ` title={ <FormattedMessage defaultMessage="Error" - id="kbn.management.objects.objectsTable.relationships.renderErrorMessage" + id="savedObjectsManagement.objectsTable.relationships.renderErrorMessage" values={Object {}} /> } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/__snapshots__/table.test.js.snap b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/table.test.tsx.snap similarity index 93% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/__snapshots__/table.test.js.snap rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/table.test.tsx.snap index a4dcfb9c38184..d09dd6f8b868b 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/__snapshots__/table.test.js.snap +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/__snapshots__/table.test.tsx.snap @@ -36,7 +36,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` > <FormattedMessage defaultMessage="Delete" - id="kbn.management.objects.objectsTable.table.deleteButtonLabel" + id="savedObjectsManagement.objectsTable.table.deleteButtonLabel" values={Object {}} /> </EuiButton>, @@ -51,7 +51,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` > <FormattedMessage defaultMessage="Export" - id="kbn.management.objects.objectsTable.table.exportPopoverButtonLabel" + id="savedObjectsManagement.objectsTable.table.exportPopoverButtonLabel" values={Object {}} /> </EuiButton> @@ -72,7 +72,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` label={ <FormattedMessage defaultMessage="Options" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportOptionsLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportOptionsLabel" values={Object {}} /> } @@ -83,7 +83,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` label={ <FormattedMessage defaultMessage="Include related objects" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" values={Object {}} /> } @@ -106,7 +106,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` > <FormattedMessage defaultMessage="Export" - id="kbn.management.objects.objectsTable.table.exportButtonLabel" + id="savedObjectsManagement.objectsTable.table.exportButtonLabel" values={Object {}} /> </EuiButton> @@ -171,6 +171,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` items={ Array [ Object { + "attributes": Object {}, "id": "1", "meta": Object { "editUrl": "#/management/kibana/index_patterns/1", @@ -181,6 +182,7 @@ exports[`Table prevents saved objects from being deleted 1`] = ` }, "title": "MyIndexPattern*", }, + "references": Array [], "type": "index-pattern", }, ] @@ -249,7 +251,7 @@ exports[`Table should render normally 1`] = ` > <FormattedMessage defaultMessage="Delete" - id="kbn.management.objects.objectsTable.table.deleteButtonLabel" + id="savedObjectsManagement.objectsTable.table.deleteButtonLabel" values={Object {}} /> </EuiButton>, @@ -264,7 +266,7 @@ exports[`Table should render normally 1`] = ` > <FormattedMessage defaultMessage="Export" - id="kbn.management.objects.objectsTable.table.exportPopoverButtonLabel" + id="savedObjectsManagement.objectsTable.table.exportPopoverButtonLabel" values={Object {}} /> </EuiButton> @@ -285,7 +287,7 @@ exports[`Table should render normally 1`] = ` label={ <FormattedMessage defaultMessage="Options" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportOptionsLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportOptionsLabel" values={Object {}} /> } @@ -296,7 +298,7 @@ exports[`Table should render normally 1`] = ` label={ <FormattedMessage defaultMessage="Include related objects" - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" values={Object {}} /> } @@ -319,7 +321,7 @@ exports[`Table should render normally 1`] = ` > <FormattedMessage defaultMessage="Export" - id="kbn.management.objects.objectsTable.table.exportButtonLabel" + id="savedObjectsManagement.objectsTable.table.exportButtonLabel" values={Object {}} /> </EuiButton> @@ -384,6 +386,7 @@ exports[`Table should render normally 1`] = ` items={ Array [ Object { + "attributes": Object {}, "id": "1", "meta": Object { "editUrl": "#/management/kibana/index_patterns/1", @@ -394,6 +397,7 @@ exports[`Table should render normally 1`] = ` }, "title": "MyIndexPattern*", }, + "references": Array [], "type": "index-pattern", }, ] diff --git a/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.mocks.ts b/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.mocks.ts new file mode 100644 index 0000000000000..b5361d212954f --- /dev/null +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.mocks.ts @@ -0,0 +1,44 @@ +/* + * 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. + */ + +export const importFileMock = jest.fn(); +jest.doMock('../../../lib/import_file', () => ({ + importFile: importFileMock, +})); + +export const resolveImportErrorsMock = jest.fn(); +jest.doMock('../../../lib/resolve_import_errors', () => ({ + resolveImportErrors: resolveImportErrorsMock, +})); + +export const importLegacyFileMock = jest.fn(); +jest.doMock('../../../lib/import_legacy_file', () => ({ + importLegacyFile: importLegacyFileMock, +})); + +export const resolveSavedObjectsMock = jest.fn(); +export const resolveSavedSearchesMock = jest.fn(); +export const resolveIndexPatternConflictsMock = jest.fn(); +export const saveObjectsMock = jest.fn(); +jest.doMock('../../../lib/resolve_saved_objects', () => ({ + resolveSavedObjects: resolveSavedObjectsMock, + resolveSavedSearches: resolveSavedSearchesMock, + resolveIndexPatternConflicts: resolveIndexPatternConflictsMock, + saveObjects: saveObjectsMock, +})); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/flyout.test.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.tsx similarity index 75% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/flyout.test.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.tsx index 0d16e0ae35dd6..5d713ff044f24 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/__jest__/flyout.test.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.test.tsx @@ -17,68 +17,62 @@ * under the License. */ +import { + importFileMock, + importLegacyFileMock, + resolveImportErrorsMock, + resolveIndexPatternConflictsMock, + resolveSavedObjectsMock, + resolveSavedSearchesMock, + saveObjectsMock, +} from './flyout.test.mocks'; + import React from 'react'; import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; -import { mockManagementPlugin } from '../../../../../../../../../../../../plugins/index_pattern_management/public/mocks'; -import { Flyout } from '../flyout'; - -jest.mock('ui/kfetch', () => ({ kfetch: jest.fn() })); - -jest.mock('../../../../../lib/import_file', () => ({ - importFile: jest.fn(), -})); - -jest.mock('../../../../../lib/resolve_import_errors', () => ({ - resolveImportErrors: jest.fn(), -})); - -jest.mock('ui/chrome', () => ({ - addBasePath: () => {}, - getInjected: () => ['index-pattern', 'visualization', 'dashboard', 'search'], -})); - -jest.mock('../../../../../lib/import_legacy_file', () => ({ - importLegacyFile: jest.fn(), -})); - -jest.mock('../../../../../lib/resolve_saved_objects', () => ({ - resolveSavedObjects: jest.fn(), - resolveSavedSearches: jest.fn(), - resolveIndexPatternConflicts: jest.fn(), - saveObjects: jest.fn(), -})); - -jest.mock('../../../../../../../../../../../../plugins/index_pattern_management/public', () => ({ - setup: mockManagementPlugin.createSetupContract(), - start: mockManagementPlugin.createStartContract(), -})); - -jest.mock('ui/notify', () => ({})); - -const defaultProps = { - close: jest.fn(), - done: jest.fn(), - services: [], - newIndexPatternUrl: '', - getConflictResolutions: jest.fn(), - confirmModalPromise: jest.fn(), - indexPatterns: { - getFields: jest.fn().mockImplementation(() => [{ id: '1' }, { id: '2' }]), - }, -}; - -const mockFile = { +import { coreMock } from '../../../../../../core/public/mocks'; +import { serviceRegistryMock } from '../../../services/service_registry.mock'; +import { Flyout, FlyoutProps, FlyoutState } from './flyout'; +import { ShallowWrapper } from 'enzyme'; + +const mockFile = ({ name: 'foo.ndjson', path: '/home/foo.ndjson', -}; -const legacyMockFile = { +} as unknown) as File; +const legacyMockFile = ({ name: 'foo.json', path: '/home/foo.json', -}; +} as unknown) as File; describe('Flyout', () => { + let defaultProps: FlyoutProps; + + const shallowRender = (props: FlyoutProps) => { + return (shallowWithI18nProvider(<Flyout {...props} />) as unknown) as ShallowWrapper< + FlyoutProps, + FlyoutState, + Flyout + >; + }; + + beforeEach(() => { + const { http, overlays } = coreMock.createStart(); + + defaultProps = { + close: jest.fn(), + done: jest.fn(), + newIndexPatternUrl: '', + indexPatterns: { + getFields: jest.fn().mockImplementation(() => [{ id: '1' }, { id: '2' }]), + } as any, + overlays, + http, + allowedTypes: ['search', 'index-pattern', 'visualization'], + serviceRegistry: serviceRegistryMock.create(), + }; + }); + it('should render import step', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -89,7 +83,7 @@ describe('Flyout', () => { }); it('should toggle the overwrite all control', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -102,7 +96,7 @@ describe('Flyout', () => { }); it('should allow picking a file', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -115,7 +109,7 @@ describe('Flyout', () => { }); it('should allow removing a file', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await Promise.resolve(); @@ -130,22 +124,21 @@ describe('Flyout', () => { }); it('should handle invalid files', async () => { - const { importLegacyFile } = require('../../../../../lib/import_legacy_file'); - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); // Ensure the state changes are reflected component.update(); - importLegacyFile.mockImplementation(() => { + importLegacyFileMock.mockImplementation(() => { throw new Error('foobar'); }); await component.instance().legacyImport(); expect(component.state('error')).toBe('The file could not be processed.'); - importLegacyFile.mockImplementation(() => ({ + importLegacyFileMock.mockImplementation(() => ({ invalid: true, })); @@ -156,11 +149,8 @@ describe('Flyout', () => { }); describe('conflicts', () => { - const { importFile } = require('../../../../../lib/import_file'); - const { resolveImportErrors } = require('../../../../../lib/resolve_import_errors'); - beforeEach(() => { - importFile.mockImplementation(() => ({ + importFileMock.mockImplementation(() => ({ success: false, successCount: 0, errors: [ @@ -180,7 +170,7 @@ describe('Flyout', () => { }, ], })); - resolveImportErrors.mockImplementation(() => ({ + resolveImportErrorsMock.mockImplementation(() => ({ status: 'success', importCount: 1, failedImports: [], @@ -188,7 +178,7 @@ describe('Flyout', () => { }); it('should figure out unmatchedReferences', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -198,7 +188,7 @@ describe('Flyout', () => { component.setState({ file: mockFile, isLegacyFile: false }); await component.instance().import(); - expect(importFile).toHaveBeenCalledWith(mockFile, true); + expect(importFileMock).toHaveBeenCalledWith(defaultProps.http, mockFile, true); expect(component.state()).toMatchObject({ conflictedIndexPatterns: undefined, conflictedSavedObjectsLinkedToSavedSearches: undefined, @@ -223,7 +213,7 @@ describe('Flyout', () => { }); it('should allow conflict resolution', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -239,7 +229,7 @@ describe('Flyout', () => { // Ensure we can change the resolution component.instance().onIndexChanged('MyIndexPattern*', { target: { value: '2' } }); - expect(component.state('unmatchedReferences')[0].newIndexPatternId).toBe('2'); + expect(component.state('unmatchedReferences')![0].newIndexPatternId).toBe('2'); // Let's resolve now await component @@ -247,18 +237,18 @@ describe('Flyout', () => { .simulate('click'); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); - expect(resolveImportErrors).toMatchSnapshot(); + expect(resolveImportErrorsMock).toMatchSnapshot(); }); it('should handle errors', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); // Ensure the state changes are reflected component.update(); - resolveImportErrors.mockImplementation(() => ({ + resolveImportErrorsMock.mockImplementation(() => ({ status: 'success', importCount: 0, failedImports: [ @@ -303,18 +293,15 @@ describe('Flyout', () => { }); describe('errors', () => { - const { importFile } = require('../../../../../lib/import_file'); - const { resolveImportErrors } = require('../../../../../lib/resolve_import_errors'); - it('should display unsupported type errors properly', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await Promise.resolve(); // Ensure the state changes are reflected component.update(); - importFile.mockImplementation(() => ({ + importFileMock.mockImplementation(() => ({ success: false, successCount: 0, errors: [ @@ -328,7 +315,7 @@ describe('Flyout', () => { }, ], })); - resolveImportErrors.mockImplementation(() => ({ + resolveImportErrorsMock.mockImplementation(() => ({ status: 'success', importCount: 0, failedImports: [ @@ -372,14 +359,6 @@ describe('Flyout', () => { }); describe('legacy conflicts', () => { - const { importLegacyFile } = require('../../../../../lib/import_legacy_file'); - const { - resolveSavedObjects, - resolveSavedSearches, - resolveIndexPatternConflicts, - saveObjects, - } = require('../../../../../lib/resolve_saved_objects'); - const mockData = [ { _id: '1', @@ -406,7 +385,7 @@ describe('Flyout', () => { }, obj: { searchSource: { - getOwnField: field => { + getOwnField: (field: string) => { if (field === 'index') { return 'MyIndexPattern*'; } @@ -426,8 +405,8 @@ describe('Flyout', () => { const mockConflictedSearchDocs = [3]; beforeEach(() => { - importLegacyFile.mockImplementation(() => mockData); - resolveSavedObjects.mockImplementation(() => ({ + importLegacyFileMock.mockImplementation(() => mockData); + resolveSavedObjectsMock.mockImplementation(() => ({ conflictedIndexPatterns: mockConflictedIndexPatterns, conflictedSavedObjectsLinkedToSavedSearches: mockConflictedSavedObjectsLinkedToSavedSearches, conflictedSearchDocs: mockConflictedSearchDocs, @@ -437,7 +416,7 @@ describe('Flyout', () => { }); it('should figure out unmatchedReferences', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -447,14 +426,14 @@ describe('Flyout', () => { component.setState({ file: legacyMockFile, isLegacyFile: true }); await component.instance().legacyImport(); - expect(importLegacyFile).toHaveBeenCalledWith(legacyMockFile); + expect(importLegacyFileMock).toHaveBeenCalledWith(legacyMockFile); // Remove the last element from data since it should be filtered out - expect(resolveSavedObjects).toHaveBeenCalledWith( + expect(resolveSavedObjectsMock).toHaveBeenCalledWith( mockData.slice(0, 2).map(doc => ({ ...doc, _migrationVersion: {} })), true, - defaultProps.services, + defaultProps.serviceRegistry.all().map(s => s.service), defaultProps.indexPatterns, - defaultProps.confirmModalPromise + defaultProps.overlays.openConfirm ); expect(component.state()).toMatchObject({ @@ -492,7 +471,7 @@ describe('Flyout', () => { }); it('should allow conflict resolution', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -508,7 +487,7 @@ describe('Flyout', () => { // Ensure we can change the resolution component.instance().onIndexChanged('MyIndexPattern*', { target: { value: '2' } }); - expect(component.state('unmatchedReferences')[0].newIndexPatternId).toBe('2'); + expect(component.state('unmatchedReferences')![0].newIndexPatternId).toBe('2'); // Let's resolve now await component @@ -516,33 +495,33 @@ describe('Flyout', () => { .simulate('click'); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); - expect(resolveIndexPatternConflicts).toHaveBeenCalledWith( + expect(resolveIndexPatternConflictsMock).toHaveBeenCalledWith( component.instance().resolutions, mockConflictedIndexPatterns, true, defaultProps.indexPatterns ); - expect(saveObjects).toHaveBeenCalledWith( + expect(saveObjectsMock).toHaveBeenCalledWith( mockConflictedSavedObjectsLinkedToSavedSearches, true ); - expect(resolveSavedSearches).toHaveBeenCalledWith( + expect(resolveSavedSearchesMock).toHaveBeenCalledWith( mockConflictedSearchDocs, - defaultProps.services, + defaultProps.serviceRegistry.all().map(s => s.service), defaultProps.indexPatterns, true ); }); it('should handle errors', async () => { - const component = shallowWithI18nProvider(<Flyout {...defaultProps} />); + const component = shallowRender(defaultProps); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); // Ensure the state changes are reflected component.update(); - resolveIndexPatternConflicts.mockImplementation(() => { + resolveIndexPatternConflictsMock.mockImplementation(() => { throw new Error('foobar'); }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/flyout.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.tsx similarity index 77% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/flyout.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.tsx index da2221bb54203..45788dcb601ae 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/flyout/flyout.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/flyout.tsx @@ -18,7 +18,6 @@ */ import React, { Component, Fragment } from 'react'; -import PropTypes from 'prop-types'; import { take, get as getField } from 'lodash'; import { EuiFlyout, @@ -32,6 +31,7 @@ import { EuiForm, EuiFormRow, EuiSwitch, + // @ts-ignore EuiFilePicker, EuiInMemoryTable, EuiSelect, @@ -47,34 +47,62 @@ import { } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; - +import { OverlayStart, HttpStart } from 'src/core/public'; +import { IndexPatternsContract, IIndexPattern } from '../../../../../data/public'; import { importFile, importLegacyFile, resolveImportErrors, logLegacyImport, getDefaultTitle, -} from '../../../../lib'; -import { processImportResponse } from '../../../../lib/process_import_response'; + processImportResponse, + ProcessedImportResponse, +} from '../../../lib'; import { resolveSavedObjects, resolveSavedSearches, resolveIndexPatternConflicts, saveObjects, -} from '../../../../lib/resolve_saved_objects'; -import { POSSIBLE_TYPES } from '../../objects_table'; - -export class Flyout extends Component { - static propTypes = { - close: PropTypes.func.isRequired, - done: PropTypes.func.isRequired, - services: PropTypes.array.isRequired, - newIndexPatternUrl: PropTypes.string.isRequired, - indexPatterns: PropTypes.object.isRequired, - confirmModalPromise: PropTypes.func.isRequired, - }; +} from '../../../lib/resolve_saved_objects'; +import { ISavedObjectsManagementServiceRegistry } from '../../../services'; + +export interface FlyoutProps { + serviceRegistry: ISavedObjectsManagementServiceRegistry; + allowedTypes: string[]; + close: () => void; + done: () => void; + newIndexPatternUrl: string; + indexPatterns: IndexPatternsContract; + overlays: OverlayStart; + http: HttpStart; +} + +export interface FlyoutState { + conflictedIndexPatterns?: any[]; + conflictedSavedObjectsLinkedToSavedSearches?: any[]; + conflictedSearchDocs?: any[]; + unmatchedReferences?: ProcessedImportResponse['unmatchedReferences']; + failedImports?: ProcessedImportResponse['failedImports']; + conflictingRecord?: ConflictingRecord; + error?: string; + file?: File; + importCount: number; + indexPatterns?: IIndexPattern[]; + isOverwriteAllChecked: boolean; + loadingMessage?: string; + isLegacyFile: boolean; + status: string; +} + +interface ConflictingRecord { + id: string; + type: string; + title: string; + done: (success: boolean) => void; +} - constructor(props) { +export class Flyout extends Component<FlyoutProps, FlyoutState> { + constructor(props: FlyoutProps) { super(props); this.state = { @@ -100,7 +128,7 @@ export class Flyout extends Component { fetchIndexPatterns = async () => { const indexPatterns = await this.props.indexPatterns.getFields(['id', 'title']); - this.setState({ indexPatterns }); + this.setState({ indexPatterns } as any); }; changeOverwriteAll = () => { @@ -109,11 +137,12 @@ export class Flyout extends Component { })); }; - setImportFile = ([file]) => { - if (!file) { + setImportFile = (files: FileList | null) => { + if (!files || !files[0]) { this.setState({ file: undefined, isLegacyFile: false }); return; } + const file = files[0]; this.setState({ file, isLegacyFile: /\.json$/i.test(file.name) || file.type === 'application/json', @@ -126,30 +155,29 @@ export class Flyout extends Component { * Does the initial import of a file, resolveImportErrors then handles errors and retries */ import = async () => { + const { http } = this.props; const { file, isOverwriteAllChecked } = this.state; this.setState({ status: 'loading', error: undefined }); // Import the file - let response; try { - response = await importFile(file, isOverwriteAllChecked); + const response = await importFile(http, file!, isOverwriteAllChecked); + this.setState(processImportResponse(response), () => { + // Resolve import errors right away if there's no index patterns to match + // This will ask about overwriting each object, etc + if (this.state.unmatchedReferences?.length === 0) { + this.resolveImportErrors(); + } + }); } catch (e) { this.setState({ status: 'error', - error: i18n.translate('kbn.management.objects.objectsTable.flyout.importFileErrorMessage', { + error: i18n.translate('savedObjectsManagement.objectsTable.flyout.importFileErrorMessage', { defaultMessage: 'The file could not be processed.', }), }); return; } - - this.setState(processImportResponse(response), () => { - // Resolve import errors right away if there's no index patterns to match - // This will ask about overwriting each object, etc - if (this.state.unmatchedReferences.length === 0) { - this.resolveImportErrors(); - } - }); }; /** @@ -160,10 +188,10 @@ export class Flyout extends Component { * @param {array} objects List of objects to request the user if they wish to overwrite it * @return {Promise<array>} An object with the key being "type:id" and value the resolution chosen by the user */ - getConflictResolutions = async objects => { - const resolutions = {}; + getConflictResolutions = async (objects: any[]) => { + const resolutions: Record<string, boolean> = {}; for (const { type, id, title } of objects) { - const overwrite = await new Promise(resolve => { + const overwrite = await new Promise<boolean>(resolve => { this.setState({ conflictingRecord: { id, @@ -193,6 +221,7 @@ export class Flyout extends Component { try { const updatedState = await resolveImportErrors({ + http: this.props.http, state: this.state, getConflictResolutions: this.getConflictResolutions, }); @@ -201,7 +230,7 @@ export class Flyout extends Component { this.setState({ status: 'error', error: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.resolveImportErrorsFileErrorMessage', + 'savedObjectsManagement.objectsTable.flyout.resolveImportErrorsFileErrorMessage', { defaultMessage: 'The file could not be processed.' } ), }); @@ -209,22 +238,22 @@ export class Flyout extends Component { }; legacyImport = async () => { - const { services, indexPatterns, confirmModalPromise } = this.props; + const { serviceRegistry, indexPatterns, overlays, http, allowedTypes } = this.props; const { file, isOverwriteAllChecked } = this.state; this.setState({ status: 'loading', error: undefined }); // Log warning on server, don't wait for response - logLegacyImport(); + logLegacyImport(http); let contents; try { - contents = await importLegacyFile(file); + contents = await importLegacyFile(file!); } catch (e) { this.setState({ status: 'error', error: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.importLegacyFileErrorMessage', + 'savedObjectsManagement.objectsTable.flyout.importLegacyFileErrorMessage', { defaultMessage: 'The file could not be processed.' } ), }); @@ -235,7 +264,7 @@ export class Flyout extends Component { this.setState({ status: 'error', error: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.invalidFormatOfImportedFileErrorMessage', + 'savedObjectsManagement.objectsTable.flyout.invalidFormatOfImportedFileErrorMessage', { defaultMessage: 'Saved objects file format is invalid and cannot be imported.' } ), }); @@ -243,7 +272,7 @@ export class Flyout extends Component { } contents = contents - .filter(content => POSSIBLE_TYPES.includes(content._type)) + .filter(content => allowedTypes.includes(content._type)) .map(doc => ({ ...doc, // The server assumes that documents with no migrationVersion are up to date. @@ -263,18 +292,18 @@ export class Flyout extends Component { } = await resolveSavedObjects( contents, isOverwriteAllChecked, - services, + serviceRegistry.all().map(e => e.service), indexPatterns, - confirmModalPromise + overlays.openConfirm ); - const byId = {}; + const byId: Record<string, any[]> = {}; conflictedIndexPatterns .map(({ doc, obj }) => { return { doc, obj: obj._serialize() }; }) .forEach(({ doc, obj }) => - obj.references.forEach(ref => { + obj.references.forEach((ref: Record<string, any>) => { byId[ref.id] = byId[ref.id] != null ? byId[ref.id].concat({ doc, obj }) : [{ doc, obj }]; }) ); @@ -291,7 +320,7 @@ export class Flyout extends Component { }); return accum; }, - [] + [] as any[] ); this.setState({ @@ -305,12 +334,12 @@ export class Flyout extends Component { }); }; - get hasUnmatchedReferences() { + public get hasUnmatchedReferences() { return this.state.unmatchedReferences && this.state.unmatchedReferences.length > 0; } - get resolutions() { - return this.state.unmatchedReferences.reduce( + public get resolutions() { + return this.state.unmatchedReferences!.reduce( (accum, { existingIndexPatternId, newIndexPatternId }) => { if (newIndexPatternId) { accum.push({ @@ -320,7 +349,7 @@ export class Flyout extends Component { } return accum; }, - [] + [] as Array<{ oldId: string; newId: string }> ); } @@ -333,7 +362,7 @@ export class Flyout extends Component { failedImports, } = this.state; - const { services, indexPatterns } = this.props; + const { serviceRegistry, indexPatterns } = this.props; this.setState({ error: undefined, @@ -350,48 +379,48 @@ export class Flyout extends Component { // Do not Promise.all these calls as the order matters this.setState({ loadingMessage: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmLegacyImport.resolvingConflictsLoadingMessage', + 'savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.resolvingConflictsLoadingMessage', { defaultMessage: 'Resolving conflicts…' } ), }); if (resolutions.length) { importCount += await resolveIndexPatternConflicts( resolutions, - conflictedIndexPatterns, + conflictedIndexPatterns!, isOverwriteAllChecked, - this.props.indexPatterns + indexPatterns ); } this.setState({ loadingMessage: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmLegacyImport.savingConflictsLoadingMessage', + 'savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.savingConflictsLoadingMessage', { defaultMessage: 'Saving conflicts…' } ), }); importCount += await saveObjects( - conflictedSavedObjectsLinkedToSavedSearches, + conflictedSavedObjectsLinkedToSavedSearches!, isOverwriteAllChecked ); this.setState({ loadingMessage: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmLegacyImport.savedSearchAreLinkedProperlyLoadingMessage', + 'savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.savedSearchAreLinkedProperlyLoadingMessage', { defaultMessage: 'Ensure saved searches are linked properly…' } ), }); importCount += await resolveSavedSearches( - conflictedSearchDocs, - services, + conflictedSearchDocs!, + serviceRegistry.all().map(e => e.service), indexPatterns, isOverwriteAllChecked ); this.setState({ loadingMessage: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmLegacyImport.retryingFailedObjectsLoadingMessage', + 'savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.retryingFailedObjectsLoadingMessage', { defaultMessage: 'Retrying failed objects…' } ), }); importCount += await saveObjects( - failedImports.map(({ obj }) => obj), + failedImports!.map(({ obj }) => obj) as any[], isOverwriteAllChecked ); } catch (e) { @@ -407,26 +436,26 @@ export class Flyout extends Component { this.setState({ status: 'success', importCount }); }; - onIndexChanged = (id, e) => { + onIndexChanged = (id: string, e: any) => { const value = e.target.value; this.setState(state => { - const conflictIndex = state.unmatchedReferences.findIndex( + const conflictIndex = state.unmatchedReferences?.findIndex( conflict => conflict.existingIndexPatternId === id ); - if (conflictIndex === -1) { + if (conflictIndex === undefined || conflictIndex === -1) { return state; } return { unmatchedReferences: [ - ...state.unmatchedReferences.slice(0, conflictIndex), + ...state.unmatchedReferences!.slice(0, conflictIndex), { - ...state.unmatchedReferences[conflictIndex], + ...state.unmatchedReferences![conflictIndex], newIndexPatternId: value, }, - ...state.unmatchedReferences.slice(conflictIndex + 1), + ...state.unmatchedReferences!.slice(conflictIndex + 1), ], - }; + } as any; }); }; @@ -441,11 +470,11 @@ export class Flyout extends Component { { field: 'existingIndexPatternId', name: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnIdName', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnIdName', { defaultMessage: 'ID' } ), description: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnIdDescription', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnIdDescription', { defaultMessage: 'ID of the index pattern' } ), sortable: true, @@ -453,28 +482,28 @@ export class Flyout extends Component { { field: 'list', name: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnCountName', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnCountName', { defaultMessage: 'Count' } ), description: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnCountDescription', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnCountDescription', { defaultMessage: 'How many affected objects' } ), - render: list => { + render: (list: any[]) => { return <Fragment>{list.length}</Fragment>; }, }, { field: 'list', name: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsName', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsName', { defaultMessage: 'Sample of affected objects' } ), description: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsDescription', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsDescription', { defaultMessage: 'Sample of affected objects' } ), - render: list => { + render: (list: any[]) => { return ( <ul style={{ listStyle: 'none' }}> {take(list, 3).map((obj, key) => ( @@ -487,15 +516,18 @@ export class Flyout extends Component { { field: 'existingIndexPatternId', name: i18n.translate( - 'kbn.management.objects.objectsTable.flyout.renderConflicts.columnNewIndexPatternName', + 'savedObjectsManagement.objectsTable.flyout.renderConflicts.columnNewIndexPatternName', { defaultMessage: 'New index pattern' } ), - render: id => { - const options = this.state.indexPatterns.map(indexPattern => ({ - text: indexPattern.title, - value: indexPattern.id, - ['data-test-subj']: `indexPatternOption-${indexPattern.title}`, - })); + render: (id: string) => { + const options = this.state.indexPatterns!.map( + indexPattern => + ({ + text: indexPattern.title, + value: indexPattern.id, + 'data-test-subj': `indexPatternOption-${indexPattern.title}`, + } as { text: string; value: string; 'data-test-subj'?: string }) + ); options.unshift({ text: '-- Skip Import --', @@ -518,7 +550,11 @@ export class Flyout extends Component { }; return ( - <EuiInMemoryTable items={unmatchedReferences} columns={columns} pagination={pagination} /> + <EuiInMemoryTable + items={unmatchedReferences as any[]} + columns={columns} + pagination={pagination} + /> ); } @@ -534,7 +570,7 @@ export class Flyout extends Component { <EuiCallOut title={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.errorCalloutTitle" + id="savedObjectsManagement.objectsTable.flyout.errorCalloutTitle" defaultMessage="Sorry, there was an error" /> } @@ -581,7 +617,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsFailedWarning" title={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importFailedTitle" + id="savedObjectsManagement.objectsTable.flyout.importFailedTitle" defaultMessage="Import failed" /> } @@ -590,7 +626,7 @@ export class Flyout extends Component { > <p> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importFailedDescription" + id="savedObjectsManagement.objectsTable.flyout.importFailedDescription" defaultMessage="Failed to import {failedImportCount} of {totalImportCount} objects. Import failed" values={{ failedImportCount: failedImports.length, @@ -604,7 +640,7 @@ export class Flyout extends Component { if (error.type === 'missing_references') { return error.references.map(reference => { return i18n.translate( - 'kbn.management.objects.objectsTable.flyout.importFailedMissingReference', + 'savedObjectsManagement.objectsTable.flyout.importFailedMissingReference', { defaultMessage: '{type} [id={id}] could not locate {refType} [id={refId}]', values: { @@ -618,7 +654,7 @@ export class Flyout extends Component { }); } else if (error.type === 'unsupported_type') { return i18n.translate( - 'kbn.management.objects.objectsTable.flyout.importFailedUnsupportedType', + 'savedObjectsManagement.objectsTable.flyout.importFailedUnsupportedType', { defaultMessage: '{type} [id={id}] unsupported type', values: { @@ -628,7 +664,7 @@ export class Flyout extends Component { } ); } - return getField(error, 'body.message', error.message || ''); + return getField(error, 'body.message', (error as any).message ?? ''); }) .join(' ')} </p> @@ -643,7 +679,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsSuccessNoneImported" title={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importSuccessfulCallout.noObjectsImportedTitle" + id="savedObjectsManagement.objectsTable.flyout.importSuccessfulCallout.noObjectsImportedTitle" defaultMessage="No objects imported" /> } @@ -657,7 +693,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsSuccess" title={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importSuccessfulTitle" + id="savedObjectsManagement.objectsTable.flyout.importSuccessfulTitle" defaultMessage="Import successful" /> } @@ -666,7 +702,7 @@ export class Flyout extends Component { > <p> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importSuccessfulDescription" + id="savedObjectsManagement.objectsTable.flyout.importSuccessfulDescription" defaultMessage="Successfully imported {importCount} objects." values={{ importCount }} /> @@ -684,7 +720,7 @@ export class Flyout extends Component { <EuiFormRow label={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.selectFileToImportFormRowLabel" + id="savedObjectsManagement.objectsTable.flyout.selectFileToImportFormRowLabel" defaultMessage="Please select a file to import" /> } @@ -692,7 +728,7 @@ export class Flyout extends Component { <EuiFilePicker initialPromptText={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importPromptText" + id="savedObjectsManagement.objectsTable.flyout.importPromptText" defaultMessage="Import" /> } @@ -704,7 +740,7 @@ export class Flyout extends Component { name="overwriteAll" label={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.overwriteSavedObjectsLabel" + id="savedObjectsManagement.objectsTable.flyout.overwriteSavedObjectsLabel" defaultMessage="Automatically overwrite all saved objects?" /> } @@ -727,7 +763,7 @@ export class Flyout extends Component { confirmButton = ( <EuiButton onClick={done} size="s" fill data-test-subj="importSavedObjectsDoneBtn"> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importSuccessful.confirmButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmButtonLabel" defaultMessage="Done" /> </EuiButton> @@ -742,7 +778,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsConfirmBtn" > <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel" defaultMessage="Confirm all changes" /> </EuiButton> @@ -757,7 +793,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsImportBtn" > <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.import.confirmButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.import.confirmButtonLabel" defaultMessage="Import" /> </EuiButton> @@ -769,7 +805,7 @@ export class Flyout extends Component { <EuiFlexItem grow={false}> <EuiButtonEmpty onClick={close} size="s"> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.import.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.flyout.import.cancelButtonLabel" defaultMessage="Cancel" /> </EuiButtonEmpty> @@ -791,7 +827,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsLegacyWarning" title={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.legacyFileUsedTitle" + id="savedObjectsManagement.objectsTable.flyout.legacyFileUsedTitle" defaultMessage="Support for JSON files is going away" /> } @@ -800,7 +836,7 @@ export class Flyout extends Component { > <p> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.legacyFileUsedBody" + id="savedObjectsManagement.objectsTable.flyout.legacyFileUsedBody" defaultMessage="Use our updated export to generate NDJSON files, and you'll be all set." /> </p> @@ -815,7 +851,7 @@ export class Flyout extends Component { data-test-subj="importSavedObjectsConflictsWarning" title={ <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsTitle" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsTitle" defaultMessage="Index Pattern Conflicts" /> } @@ -824,7 +860,7 @@ export class Flyout extends Component { > <p> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsDescription" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsDescription" defaultMessage="The following saved objects use index patterns that do not exist. Please select the index patterns you'd like re-associated with them. You can {indexPatternLink} if necessary." @@ -832,7 +868,7 @@ export class Flyout extends Component { indexPatternLink: ( <EuiLink href={this.props.newIndexPatternUrl}> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.indexPatternConflictsCalloutLinkText" + id="savedObjectsManagement.objectsTable.flyout.indexPatternConflictsCalloutLinkText" defaultMessage="create a new index pattern" /> </EuiLink> @@ -867,11 +903,11 @@ export class Flyout extends Component { } overwriteConfirmed() { - this.state.conflictingRecord.done(true); + this.state.conflictingRecord!.done(true); } overwriteSkipped() { - this.state.conflictingRecord.done(false); + this.state.conflictingRecord!.done(false); } render() { @@ -883,18 +919,18 @@ export class Flyout extends Component { <EuiOverlayMask> <EuiConfirmModal title={i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmOverwriteTitle', + 'savedObjectsManagement.objectsTable.flyout.confirmOverwriteTitle', { defaultMessage: 'Overwrite {type}?', values: { type: this.state.conflictingRecord.type }, } )} cancelButtonText={i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmOverwriteCancelButtonText', + 'savedObjectsManagement.objectsTable.flyout.confirmOverwriteCancelButtonText', { defaultMessage: 'Cancel' } )} confirmButtonText={i18n.translate( - 'kbn.management.objects.objectsTable.flyout.confirmOverwriteOverwriteButtonText', + 'savedObjectsManagement.objectsTable.flyout.confirmOverwriteOverwriteButtonText', { defaultMessage: 'Overwrite' } )} buttonColor="danger" @@ -904,7 +940,7 @@ export class Flyout extends Component { > <p> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.confirmOverwriteBody" + id="savedObjectsManagement.objectsTable.flyout.confirmOverwriteBody" defaultMessage="Are you sure you want to overwrite {title}?" values={{ title: @@ -924,7 +960,7 @@ export class Flyout extends Component { <EuiTitle size="m"> <h2> <FormattedMessage - id="kbn.management.objects.objectsTable.flyout.importSavedObjectTitle" + id="savedObjectsManagement.objectsTable.flyout.importSavedObjectTitle" defaultMessage="Import saved objects" /> </h2> diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/header.test.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/header.test.tsx similarity index 96% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/header.test.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/header.test.tsx index 1f501b5751224..891190d0bb24b 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/__jest__/header.test.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/header.test.tsx @@ -19,8 +19,7 @@ import React from 'react'; import { shallow } from 'enzyme'; - -import { Header } from '../header'; +import { Header } from './header'; describe('Header', () => { it('should render normally', () => { diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/header.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/header.tsx similarity index 83% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/header.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/header.tsx index 0bec8a0cf2daf..7a9584f08d632 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/header/header.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/header.tsx @@ -18,8 +18,6 @@ */ import React, { Fragment } from 'react'; -import PropTypes from 'prop-types'; - import { EuiSpacer, EuiTitle, @@ -31,14 +29,24 @@ import { } from '@elastic/eui'; import { FormattedMessage } from '@kbn/i18n/react'; -export const Header = ({ onExportAll, onImport, onRefresh, filteredCount }) => ( +export const Header = ({ + onExportAll, + onImport, + onRefresh, + filteredCount, +}: { + onExportAll: () => void; + onImport: () => void; + onRefresh: () => void; + filteredCount: number; +}) => ( <Fragment> <EuiFlexGroup justifyContent="spaceBetween" alignItems="baseline"> <EuiFlexItem grow={false}> <EuiTitle> <h1> <FormattedMessage - id="kbn.management.objects.objectsTable.header.savedObjectsTitle" + id="savedObjectsManagement.objectsTable.header.savedObjectsTitle" defaultMessage="Saved Objects" /> </h1> @@ -55,7 +63,7 @@ export const Header = ({ onExportAll, onImport, onRefresh, filteredCount }) => ( onClick={onExportAll} > <FormattedMessage - id="kbn.management.objects.objectsTable.header.exportButtonLabel" + id="savedObjectsManagement.objectsTable.header.exportButtonLabel" defaultMessage="Export {filteredCount, plural, one{# object} other {# objects}}" values={{ filteredCount, @@ -71,7 +79,7 @@ export const Header = ({ onExportAll, onImport, onRefresh, filteredCount }) => ( onClick={onImport} > <FormattedMessage - id="kbn.management.objects.objectsTable.header.importButtonLabel" + id="savedObjectsManagement.objectsTable.header.importButtonLabel" defaultMessage="Import" /> </EuiButtonEmpty> @@ -79,7 +87,7 @@ export const Header = ({ onExportAll, onImport, onRefresh, filteredCount }) => ( <EuiFlexItem grow={false}> <EuiButtonEmpty size="s" iconType="refresh" onClick={onRefresh}> <FormattedMessage - id="kbn.management.objects.objectsTable.header.refreshButtonLabel" + id="savedObjectsManagement.objectsTable.header.refreshButtonLabel" defaultMessage="Refresh" /> </EuiButtonEmpty> @@ -92,7 +100,7 @@ export const Header = ({ onExportAll, onImport, onRefresh, filteredCount }) => ( <p> <EuiTextColor color="subdued"> <FormattedMessage - id="kbn.management.objects.objectsTable.howToDeleteSavedObjectsDescription" + id="savedObjectsManagement.objectsTable.howToDeleteSavedObjectsDescription" defaultMessage="From here you can delete saved objects, such as saved searches. You can also edit the raw data of saved objects. Typically objects are only modified via their associated application, @@ -104,10 +112,3 @@ export const Header = ({ onExportAll, onImport, onRefresh, filteredCount }) => ( <EuiSpacer size="m" /> </Fragment> ); - -Header.propTypes = { - onExportAll: PropTypes.func.isRequired, - onImport: PropTypes.func.isRequired, - onRefresh: PropTypes.func.isRequired, - filteredCount: PropTypes.number.isRequired, -}; diff --git a/src/plugins/saved_objects_management/public/management_section/objects_table/components/index.ts b/src/plugins/saved_objects_management/public/management_section/objects_table/components/index.ts new file mode 100644 index 0000000000000..9c8736a9011eb --- /dev/null +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/index.ts @@ -0,0 +1,23 @@ +/* + * 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. + */ + +export { Header } from './header'; +export { Table } from './table'; +export { Flyout } from './flyout'; +export { Relationships } from './relationships'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/relationships.test.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/relationships.test.tsx similarity index 88% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/relationships.test.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/relationships.test.tsx index 479726e8785d8..347f2d977015c 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/__jest__/relationships.test.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/relationships.test.tsx @@ -19,27 +19,23 @@ import React from 'react'; import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; +import { httpServiceMock } from '../../../../../../core/public/mocks'; +import { Relationships, RelationshipsProps } from './relationships'; -jest.mock('ui/kfetch', () => ({ kfetch: jest.fn() })); - -jest.mock('ui/chrome', () => ({ - addBasePath: () => '', -})); - -jest.mock('../../../../../lib/fetch_export_by_type_and_search', () => ({ +jest.mock('../../../lib/fetch_export_by_type_and_search', () => ({ fetchExportByTypeAndSearch: jest.fn(), })); -jest.mock('../../../../../lib/fetch_export_objects', () => ({ +jest.mock('../../../lib/fetch_export_objects', () => ({ fetchExportObjects: jest.fn(), })); -import { Relationships } from '../relationships'; - describe('Relationships', () => { it('should render index patterns normally', async () => { - const props = { + const props: RelationshipsProps = { goInspectObject: () => {}, + canGoInApp: () => true, + basePath: httpServiceMock.createSetupContract().basePath, getRelationships: jest.fn().mockImplementation(() => [ { type: 'search', @@ -73,6 +69,8 @@ describe('Relationships', () => { savedObject: { id: '1', type: 'index-pattern', + attributes: {}, + references: [], meta: { title: 'MyIndexPattern*', icon: 'indexPatternApp', @@ -101,8 +99,10 @@ describe('Relationships', () => { }); it('should render searches normally', async () => { - const props = { + const props: RelationshipsProps = { goInspectObject: () => {}, + canGoInApp: () => true, + basePath: httpServiceMock.createSetupContract().basePath, getRelationships: jest.fn().mockImplementation(() => [ { type: 'index-pattern', @@ -136,6 +136,8 @@ describe('Relationships', () => { savedObject: { id: '1', type: 'search', + attributes: {}, + references: [], meta: { title: 'MySearch', icon: 'search', @@ -164,8 +166,10 @@ describe('Relationships', () => { }); it('should render visualizations normally', async () => { - const props = { + const props: RelationshipsProps = { goInspectObject: () => {}, + canGoInApp: () => true, + basePath: httpServiceMock.createSetupContract().basePath, getRelationships: jest.fn().mockImplementation(() => [ { type: 'dashboard', @@ -199,6 +203,8 @@ describe('Relationships', () => { savedObject: { id: '1', type: 'visualization', + attributes: {}, + references: [], meta: { title: 'MyViz', icon: 'visualizeApp', @@ -227,8 +233,10 @@ describe('Relationships', () => { }); it('should render dashboards normally', async () => { - const props = { + const props: RelationshipsProps = { goInspectObject: () => {}, + canGoInApp: () => true, + basePath: httpServiceMock.createSetupContract().basePath, getRelationships: jest.fn().mockImplementation(() => [ { type: 'visualization', @@ -262,6 +270,8 @@ describe('Relationships', () => { savedObject: { id: '1', type: 'dashboard', + attributes: {}, + references: [], meta: { title: 'MyDashboard', icon: 'dashboardApp', @@ -290,14 +300,18 @@ describe('Relationships', () => { }); it('should render errors', async () => { - const props = { + const props: RelationshipsProps = { goInspectObject: () => {}, + canGoInApp: () => true, + basePath: httpServiceMock.createSetupContract().basePath, getRelationships: jest.fn().mockImplementation(() => { throw new Error('foo'); }), savedObject: { id: '1', type: 'dashboard', + attributes: {}, + references: [], meta: { title: 'MyDashboard', icon: 'dashboardApp', diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/relationships.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/relationships.tsx similarity index 75% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/relationships.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/relationships.tsx index ce3415ad2f0e7..ddb262138d565 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/relationships/relationships.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/relationships.tsx @@ -18,8 +18,6 @@ */ import React, { Component } from 'react'; -import PropTypes from 'prop-types'; - import { EuiTitle, EuiFlyout, @@ -34,25 +32,34 @@ import { EuiText, EuiSpacer, } from '@elastic/eui'; -import chrome from 'ui/chrome'; +import { FilterConfig } from '@elastic/eui/src/components/search_bar/filters/filters'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { getDefaultTitle, getSavedObjectLabel } from '../../../../lib'; +import { IBasePath } from 'src/core/public'; +import { getDefaultTitle, getSavedObjectLabel } from '../../../lib'; +import { SavedObjectWithMetadata, SavedObjectRelation } from '../../../types'; + +export interface RelationshipsProps { + basePath: IBasePath; + getRelationships: (type: string, id: string) => Promise<SavedObjectRelation[]>; + savedObject: SavedObjectWithMetadata; + close: () => void; + goInspectObject: (obj: SavedObjectWithMetadata) => void; + canGoInApp: (obj: SavedObjectWithMetadata) => boolean; +} -export class Relationships extends Component { - static propTypes = { - getRelationships: PropTypes.func.isRequired, - savedObject: PropTypes.object.isRequired, - close: PropTypes.func.isRequired, - goInspectObject: PropTypes.func.isRequired, - canGoInApp: PropTypes.func.isRequired, - }; +export interface RelationshipsState { + relationships: SavedObjectRelation[]; + isLoading: boolean; + error?: string; +} - constructor(props) { +export class Relationships extends Component<RelationshipsProps, RelationshipsState> { + constructor(props: RelationshipsProps) { super(props); this.state = { - relationships: undefined, + relationships: [], isLoading: false, error: undefined, }; @@ -62,7 +69,7 @@ export class Relationships extends Component { this.getRelationshipData(); } - UNSAFE_componentWillReceiveProps(nextProps) { + UNSAFE_componentWillReceiveProps(nextProps: RelationshipsProps) { if (nextProps.savedObject.id !== this.props.savedObject.id) { this.getRelationshipData(); } @@ -92,7 +99,7 @@ export class Relationships extends Component { <EuiCallOut title={ <FormattedMessage - id="kbn.management.objects.objectsTable.relationships.renderErrorMessage" + id="savedObjectsManagement.objectsTable.relationships.renderErrorMessage" defaultMessage="Error" /> } @@ -104,7 +111,7 @@ export class Relationships extends Component { } renderRelationships() { - const { goInspectObject, savedObject } = this.props; + const { goInspectObject, savedObject, basePath } = this.props; const { relationships, isLoading, error } = this.state; if (error) { @@ -118,17 +125,17 @@ export class Relationships extends Component { const columns = [ { field: 'type', - name: i18n.translate('kbn.management.objects.objectsTable.relationships.columnTypeName', { + name: i18n.translate('savedObjectsManagement.objectsTable.relationships.columnTypeName', { defaultMessage: 'Type', }), width: '50px', align: 'center', description: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.columnTypeDescription', + 'savedObjectsManagement.objectsTable.relationships.columnTypeDescription', { defaultMessage: 'Type of the saved object' } ), sortable: false, - render: (type, object) => { + render: (type: string, object: SavedObjectWithMetadata) => { return ( <EuiToolTip position="top" content={getSavedObjectLabel(type)}> <EuiIcon @@ -144,19 +151,19 @@ export class Relationships extends Component { { field: 'relationship', name: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.columnRelationshipName', + 'savedObjectsManagement.objectsTable.relationships.columnRelationshipName', { defaultMessage: 'Direct relationship' } ), dataType: 'string', sortable: false, width: '125px', 'data-test-subj': 'directRelationship', - render: relationship => { + render: (relationship: string) => { if (relationship === 'parent') { return ( <EuiText size="s"> <FormattedMessage - id="kbn.management.objects.objectsTable.relationships.columnRelationship.parentAsValue" + id="savedObjectsManagement.objectsTable.relationships.columnRelationship.parentAsValue" defaultMessage="Parent" /> </EuiText> @@ -166,7 +173,7 @@ export class Relationships extends Component { return ( <EuiText size="s"> <FormattedMessage - id="kbn.management.objects.objectsTable.relationships.columnRelationship.childAsValue" + id="savedObjectsManagement.objectsTable.relationships.columnRelationship.childAsValue" defaultMessage="Child" /> </EuiText> @@ -176,17 +183,17 @@ export class Relationships extends Component { }, { field: 'meta.title', - name: i18n.translate('kbn.management.objects.objectsTable.relationships.columnTitleName', { + name: i18n.translate('savedObjectsManagement.objectsTable.relationships.columnTitleName', { defaultMessage: 'Title', }), description: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.columnTitleDescription', + 'savedObjectsManagement.objectsTable.relationships.columnTitleDescription', { defaultMessage: 'Title of the saved object' } ), dataType: 'string', sortable: false, - render: (title, object) => { - const { path } = object.meta.inAppUrl || {}; + render: (title: string, object: SavedObjectWithMetadata) => { + const { path = '' } = object.meta.inAppUrl || {}; const canGoInApp = this.props.canGoInApp(object); if (!canGoInApp) { return ( @@ -196,7 +203,7 @@ export class Relationships extends Component { ); } return ( - <EuiLink href={chrome.addBasePath(path)} data-test-subj="relationshipsTitle"> + <EuiLink href={basePath.prepend(path)} data-test-subj="relationshipsTitle"> {title || getDefaultTitle(object)} </EuiLink> ); @@ -204,24 +211,24 @@ export class Relationships extends Component { }, { name: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.columnActionsName', + 'savedObjectsManagement.objectsTable.relationships.columnActionsName', { defaultMessage: 'Actions' } ), actions: [ { name: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.columnActions.inspectActionName', + 'savedObjectsManagement.objectsTable.relationships.columnActions.inspectActionName', { defaultMessage: 'Inspect' } ), description: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.columnActions.inspectActionDescription', + 'savedObjectsManagement.objectsTable.relationships.columnActions.inspectActionDescription', { defaultMessage: 'Inspect this saved object' } ), type: 'icon', icon: 'inspect', 'data-test-subj': 'relationshipsTableAction-inspect', - onClick: object => goInspectObject(object), - available: object => !!object.meta.editUrl, + onClick: (object: SavedObjectWithMetadata) => goInspectObject(object), + available: (object: SavedObjectWithMetadata) => !!object.meta.editUrl, }, ], }, @@ -244,7 +251,7 @@ export class Relationships extends Component { type: 'field_value_selection', field: 'relationship', name: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.search.filters.relationship.name', + 'savedObjectsManagement.objectsTable.relationships.search.filters.relationship.name', { defaultMessage: 'Direct relationship' } ), multiSelect: 'or', @@ -253,7 +260,7 @@ export class Relationships extends Component { value: 'parent', name: 'parent', view: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.search.filters.relationship.parentAsValue.view', + 'savedObjectsManagement.objectsTable.relationships.search.filters.relationship.parentAsValue.view', { defaultMessage: 'Parent' } ), }, @@ -261,7 +268,7 @@ export class Relationships extends Component { value: 'child', name: 'child', view: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.search.filters.relationship.childAsValue.view', + 'savedObjectsManagement.objectsTable.relationships.search.filters.relationship.childAsValue.view', { defaultMessage: 'Child' } ), }, @@ -271,13 +278,13 @@ export class Relationships extends Component { type: 'field_value_selection', field: 'type', name: i18n.translate( - 'kbn.management.objects.objectsTable.relationships.search.filters.type.name', + 'savedObjectsManagement.objectsTable.relationships.search.filters.type.name', { defaultMessage: 'Type' } ), multiSelect: 'or', options: [...filterTypesMap.values()], }, - ], + ] as FilterConfig[], }; return ( @@ -285,7 +292,7 @@ export class Relationships extends Component { <EuiCallOut> <p> {i18n.translate( - 'kbn.management.objects.objectsTable.relationships.relationshipsTitle', + 'savedObjectsManagement.objectsTable.relationships.relationshipsTitle', { defaultMessage: 'Here are the saved objects related to {title}. ' + @@ -301,7 +308,7 @@ export class Relationships extends Component { <EuiSpacer /> <EuiInMemoryTable items={relationships} - columns={columns} + columns={columns as any} pagination={true} search={search} rowProps={() => ({ diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/table.test.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/table.test.tsx similarity index 87% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/table.test.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/table.test.tsx index 9b3e2314c9f84..356f227773610 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/__jest__/table.test.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/table.test.tsx @@ -19,27 +19,22 @@ import React from 'react'; import { shallowWithI18nProvider, mountWithI18nProvider } from 'test_utils/enzyme_helpers'; +// @ts-ignore import { findTestSubject } from '@elastic/eui/lib/test'; -import { keyCodes } from '@elastic/eui/lib/services'; -import { npSetup as mockNpSetup } from '../../../../../../../../../../../ui/public/new_platform/__mocks__'; +import { keyCodes } from '@elastic/eui'; +import { httpServiceMock } from '../../../../../../core/public/mocks'; +import { actionServiceMock } from '../../../services/action_service.mock'; +import { Table, TableProps } from './table'; -jest.mock('ui/kfetch', () => ({ kfetch: jest.fn() })); - -jest.mock('ui/chrome', () => ({ - addBasePath: () => '', -})); - -jest.mock('ui/new_platform', () => ({ - npSetup: mockNpSetup, -})); - -import { Table } from '../table'; - -const defaultProps = { +const defaultProps: TableProps = { + basePath: httpServiceMock.createSetupContract().basePath, + actionRegistry: actionServiceMock.createStart(), selectedSavedObjects: [ { id: '1', type: 'index-pattern', + attributes: {}, + references: [], meta: { title: `MyIndexPattern*`, icon: 'indexPatternApp', @@ -58,13 +53,15 @@ const defaultProps = { onDelete: () => {}, onExport: () => {}, goInspectObject: () => {}, - canGoInApp: () => {}, + canGoInApp: () => true, pageIndex: 1, pageSize: 2, items: [ { id: '1', type: 'index-pattern', + attributes: {}, + references: [], meta: { title: `MyIndexPattern*`, icon: 'indexPatternApp', @@ -120,7 +117,7 @@ describe('Table', () => { { type: 'visualization' }, { type: 'search' }, { type: 'index-pattern' }, - ]; + ] as any; const customizedProps = { ...defaultProps, selectedSavedObjects, canDelete: false }; const component = shallowWithI18nProvider(<Table {...customizedProps} />); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/table.js b/src/plugins/saved_objects_management/public/management_section/objects_table/components/table.tsx similarity index 71% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/table.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/components/table.tsx index 132fa1e691c1c..5b574e4b3d331 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/table.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/components/table.tsx @@ -17,12 +17,10 @@ * under the License. */ -import chrome from 'ui/chrome'; -import { npSetup } from 'ui/new_platform'; +import { IBasePath } from 'src/core/public'; import React, { PureComponent, Fragment } from 'react'; -import PropTypes from 'prop-types'; - import { + // @ts-ignore EuiSearchBar, EuiBasicTable, EuiButton, @@ -35,54 +33,64 @@ import { EuiSwitch, EuiFormRow, EuiText, + EuiTableFieldDataColumnType, + EuiTableActionsColumnType, } from '@elastic/eui'; -import { getDefaultTitle, getSavedObjectLabel } from '../../../../lib'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; +import { getDefaultTitle, getSavedObjectLabel } from '../../../lib'; +import { SavedObjectWithMetadata } from '../../../types'; +import { + SavedObjectsManagementActionServiceStart, + SavedObjectsManagementAction, +} from '../../../services'; -export class Table extends PureComponent { - static propTypes = { - selectedSavedObjects: PropTypes.array.isRequired, - selectionConfig: PropTypes.shape({ - selectable: PropTypes.func, - selectableMessage: PropTypes.func, - onSelectionChange: PropTypes.func.isRequired, - }).isRequired, - filterOptions: PropTypes.array.isRequired, - canDelete: PropTypes.bool.isRequired, - onDelete: PropTypes.func.isRequired, - onExport: PropTypes.func.isRequired, - goInspectObject: PropTypes.func.isRequired, - - pageIndex: PropTypes.number.isRequired, - pageSize: PropTypes.number.isRequired, - items: PropTypes.array.isRequired, - itemId: PropTypes.oneOfType([ - PropTypes.string, // the name of the item id property - PropTypes.func, // (item) => string - ]), - totalItemCount: PropTypes.number.isRequired, - onQueryChange: PropTypes.func.isRequired, - onTableChange: PropTypes.func.isRequired, - isSearching: PropTypes.bool.isRequired, - - onShowRelationships: PropTypes.func.isRequired, +export interface TableProps { + basePath: IBasePath; + actionRegistry: SavedObjectsManagementActionServiceStart; + selectedSavedObjects: SavedObjectWithMetadata[]; + selectionConfig: { + onSelectionChange: (selection: SavedObjectWithMetadata[]) => void; }; + filterOptions: any[]; + canDelete: boolean; + onDelete: () => void; + onExport: (includeReferencesDeep: boolean) => void; + goInspectObject: (obj: SavedObjectWithMetadata) => void; + pageIndex: number; + pageSize: number; + items: SavedObjectWithMetadata[]; + itemId: string | (() => string); + totalItemCount: number; + onQueryChange: (query: any) => void; + onTableChange: (table: any) => void; + isSearching: boolean; + onShowRelationships: (object: SavedObjectWithMetadata) => void; + canGoInApp: (obj: SavedObjectWithMetadata) => boolean; +} + +interface TableState { + isSearchTextValid: boolean; + parseErrorMessage: any; + isExportPopoverOpen: boolean; + isIncludeReferencesDeepChecked: boolean; + activeAction?: SavedObjectsManagementAction; +} - state = { +export class Table extends PureComponent<TableProps, TableState> { + state: TableState = { isSearchTextValid: true, parseErrorMessage: null, isExportPopoverOpen: false, isIncludeReferencesDeepChecked: true, - activeAction: null, + activeAction: undefined, }; - constructor(props) { + constructor(props: TableProps) { super(props); - this.extraActions = npSetup.plugins.savedObjectsManagement.actionRegistry.getAll(); } - onChange = ({ query, error }) => { + onChange = ({ query, error }: any) => { if (error) { this.setState({ isSearchTextValid: false, @@ -136,12 +144,14 @@ export class Table extends PureComponent { onTableChange, goInspectObject, onShowRelationships, + basePath, + actionRegistry, } = this.props; const pagination = { - pageIndex: pageIndex, - pageSize: pageSize, - totalItemCount: totalItemCount, + pageIndex, + pageSize, + totalItemCount, pageSizeOptions: [5, 10, 20, 50], }; @@ -149,7 +159,7 @@ export class Table extends PureComponent { { type: 'field_value_selection', field: 'type', - name: i18n.translate('kbn.management.objects.objectsTable.table.typeFilterName', { + name: i18n.translate('savedObjectsManagement.objectsTable.table.typeFilterName', { defaultMessage: 'Type', }), multiSelect: 'or', @@ -168,18 +178,18 @@ export class Table extends PureComponent { const columns = [ { field: 'type', - name: i18n.translate('kbn.management.objects.objectsTable.table.columnTypeName', { + name: i18n.translate('savedObjectsManagement.objectsTable.table.columnTypeName', { defaultMessage: 'Type', }), width: '50px', align: 'center', description: i18n.translate( - 'kbn.management.objects.objectsTable.table.columnTypeDescription', + 'savedObjectsManagement.objectsTable.table.columnTypeDescription', { defaultMessage: 'Type of the saved object' } ), sortable: false, 'data-test-subj': 'savedObjectsTableRowType', - render: (type, object) => { + render: (type: string, object: SavedObjectWithMetadata) => { return ( <EuiToolTip position="top" content={getSavedObjectLabel(type)}> <EuiIcon @@ -191,42 +201,42 @@ export class Table extends PureComponent { </EuiToolTip> ); }, - }, + } as EuiTableFieldDataColumnType<SavedObjectWithMetadata<any>>, { field: 'meta.title', - name: i18n.translate('kbn.management.objects.objectsTable.table.columnTitleName', { + name: i18n.translate('savedObjectsManagement.objectsTable.table.columnTitleName', { defaultMessage: 'Title', }), description: i18n.translate( - 'kbn.management.objects.objectsTable.table.columnTitleDescription', + 'savedObjectsManagement.objectsTable.table.columnTitleDescription', { defaultMessage: 'Title of the saved object' } ), dataType: 'string', sortable: false, 'data-test-subj': 'savedObjectsTableRowTitle', - render: (title, object) => { - const { path } = object.meta.inAppUrl || {}; + render: (title: string, object: SavedObjectWithMetadata) => { + const { path = '' } = object.meta.inAppUrl || {}; const canGoInApp = this.props.canGoInApp(object); if (!canGoInApp) { return <EuiText size="s">{title || getDefaultTitle(object)}</EuiText>; } return ( - <EuiLink href={chrome.addBasePath(path)}>{title || getDefaultTitle(object)}</EuiLink> + <EuiLink href={basePath.prepend(path)}>{title || getDefaultTitle(object)}</EuiLink> ); }, - }, + } as EuiTableFieldDataColumnType<SavedObjectWithMetadata<any>>, { - name: i18n.translate('kbn.management.objects.objectsTable.table.columnActionsName', { + name: i18n.translate('savedObjectsManagement.objectsTable.table.columnActionsName', { defaultMessage: 'Actions', }), actions: [ { name: i18n.translate( - 'kbn.management.objects.objectsTable.table.columnActions.inspectActionName', + 'savedObjectsManagement.objectsTable.table.columnActions.inspectActionName', { defaultMessage: 'Inspect' } ), description: i18n.translate( - 'kbn.management.objects.objectsTable.table.columnActions.inspectActionDescription', + 'savedObjectsManagement.objectsTable.table.columnActions.inspectActionDescription', { defaultMessage: 'Inspect this saved object' } ), type: 'icon', @@ -237,11 +247,11 @@ export class Table extends PureComponent { }, { name: i18n.translate( - 'kbn.management.objects.objectsTable.table.columnActions.viewRelationshipsActionName', + 'savedObjectsManagement.objectsTable.table.columnActions.viewRelationshipsActionName', { defaultMessage: 'Relationships' } ), description: i18n.translate( - 'kbn.management.objects.objectsTable.table.columnActions.viewRelationshipsActionDescription', + 'savedObjectsManagement.objectsTable.table.columnActions.viewRelationshipsActionDescription', { defaultMessage: 'View the relationships this saved object has to other saved objects', @@ -252,33 +262,35 @@ export class Table extends PureComponent { onClick: object => onShowRelationships(object), 'data-test-subj': 'savedObjectsTableAction-relationships', }, - ...this.extraActions.map(action => { + ...actionRegistry.getAll().map(action => { return { ...action.euiAction, 'data-test-subj': `savedObjectsTableAction-${action.id}`, - onClick: object => { + onClick: (object: SavedObjectWithMetadata) => { this.setState({ activeAction: action, }); action.registerOnFinishCallback(() => { this.setState({ - activeAction: null, + activeAction: undefined, }); }); - action.euiAction.onClick(object); + if (action.euiAction.onClick) { + action.euiAction.onClick(object as any); + } }, }; }), ], - }, + } as EuiTableActionsColumnType<SavedObjectWithMetadata>, ]; let queryParseError; if (!this.state.isSearchTextValid) { const parseErrorMsg = i18n.translate( - 'kbn.management.objects.objectsTable.searchBar.unableToParseQueryErrorMessage', + 'savedObjectsManagement.objectsTable.searchBar.unableToParseQueryErrorMessage', { defaultMessage: 'Unable to parse query' } ); queryParseError = ( @@ -294,20 +306,20 @@ export class Table extends PureComponent { isDisabled={selectedSavedObjects.length === 0} > <FormattedMessage - id="kbn.management.objects.objectsTable.table.exportPopoverButtonLabel" + id="savedObjectsManagement.objectsTable.table.exportPopoverButtonLabel" defaultMessage="Export" /> </EuiButton> ); - const activeActionContents = this.state.activeAction ? this.state.activeAction.render() : null; + const activeActionContents = this.state.activeAction?.render() ?? null; return ( <Fragment> {activeActionContents} <EuiSearchBar box={{ 'data-test-subj': 'savedObjectSearchBar' }} - filters={filters} + filters={filters as any} onChange={this.onChange} toolsRight={[ <EuiButton @@ -319,14 +331,14 @@ export class Table extends PureComponent { title={ this.props.canDelete ? undefined - : i18n.translate('kbn.management.objects.objectsTable.table.deleteButtonTitle', { + : i18n.translate('savedObjectsManagement.objectsTable.table.deleteButtonTitle', { defaultMessage: 'Unable to delete saved objects', }) } data-test-subj="savedObjectsManagementDelete" > <FormattedMessage - id="kbn.management.objects.objectsTable.table.deleteButtonLabel" + id="savedObjectsManagement.objectsTable.table.deleteButtonLabel" defaultMessage="Delete" /> </EuiButton>, @@ -339,7 +351,7 @@ export class Table extends PureComponent { <EuiFormRow label={ <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportOptionsLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportOptionsLabel" defaultMessage="Options" /> } @@ -348,7 +360,7 @@ export class Table extends PureComponent { name="includeReferencesDeep" label={ <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" defaultMessage="Include related objects" /> } @@ -359,7 +371,7 @@ export class Table extends PureComponent { <EuiFormRow> <EuiButton key="exportSO" iconType="exportAction" onClick={this.onExportClick} fill> <FormattedMessage - id="kbn.management.objects.objectsTable.table.exportButtonLabel" + id="savedObjectsManagement.objectsTable.table.exportButtonLabel" defaultMessage="Export" /> </EuiButton> @@ -374,7 +386,7 @@ export class Table extends PureComponent { loading={isSearching} itemId={itemId} items={items} - columns={columns} + columns={columns as any} pagination={pagination} selection={selection} onChange={onTableChange} diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/index.js b/src/plugins/saved_objects_management/public/management_section/objects_table/index.ts similarity index 93% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/index.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/index.ts index e1195c6edfe31..8777b15389690 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/components/table/index.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/index.ts @@ -17,4 +17,4 @@ * under the License. */ -export { Table } from './table'; +export { SavedObjectsTable } from './saved_objects_table'; diff --git a/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.mocks.ts b/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.mocks.ts new file mode 100644 index 0000000000000..6b4659a6b5a13 --- /dev/null +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.mocks.ts @@ -0,0 +1,67 @@ +/* + * 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. + */ + +export const saveAsMock = jest.fn(); +jest.doMock('@elastic/filesaver', () => ({ + saveAs: saveAsMock, +})); + +jest.doMock('lodash', () => ({ + ...jest.requireActual('lodash'), + debounce: (func: Function) => { + function debounced(this: any, ...args: any[]) { + return func.apply(this, args); + } + return debounced; + }, +})); + +export const findObjectsMock = jest.fn(); +jest.doMock('../../lib/find_objects', () => ({ + findObjects: findObjectsMock, +})); + +export const fetchExportObjectsMock = jest.fn(); +jest.doMock('../../lib/fetch_export_objects', () => ({ + fetchExportObjects: fetchExportObjectsMock, +})); + +export const fetchExportByTypeAndSearchMock = jest.fn(); +jest.doMock('../../lib/fetch_export_by_type_and_search', () => ({ + fetchExportByTypeAndSearch: fetchExportByTypeAndSearchMock, +})); + +export const extractExportDetailsMock = jest.fn(); +jest.doMock('../../lib/extract_export_details', () => ({ + extractExportDetails: extractExportDetailsMock, +})); + +jest.doMock('./components/header', () => ({ + Header: () => 'Header', +})); + +export const getSavedObjectCountsMock = jest.fn(); +jest.doMock('../../lib/get_saved_object_counts', () => ({ + getSavedObjectCounts: getSavedObjectCountsMock, +})); + +export const getRelationshipsMock = jest.fn(); +jest.doMock('../../lib/get_relationships', () => ({ + getRelationships: getRelationshipsMock, +})); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/objects_table.test.js b/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.tsx similarity index 58% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/objects_table.test.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.tsx index 7b9c17640a0f3..342fdc4784b09 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/__jest__/objects_table.test.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.test.tsx @@ -17,69 +17,39 @@ * under the License. */ +import { + extractExportDetailsMock, + fetchExportByTypeAndSearchMock, + fetchExportObjectsMock, + findObjectsMock, + getRelationshipsMock, + getSavedObjectCountsMock, + saveAsMock, +} from './saved_objects_table.test.mocks'; + import React from 'react'; -import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; -import { mockManagementPlugin } from '../../../../../../../../../../plugins/index_pattern_management/public/mocks'; import { Query } from '@elastic/eui'; - -import { ObjectsTable, POSSIBLE_TYPES } from '../objects_table'; -import { Flyout } from '../components/flyout/'; -import { Relationships } from '../components/relationships/'; -import { findObjects } from '../../../lib'; -import { extractExportDetails } from '../../../lib/extract_export_details'; - -jest.mock('ui/kfetch', () => ({ kfetch: jest.fn() })); - -jest.mock('../../../../../../../../../../plugins/index_pattern_management/public', () => ({ - setup: mockManagementPlugin.createSetupContract(), - start: mockManagementPlugin.createStartContract(), -})); - -jest.mock('../../../lib/find_objects', () => ({ - findObjects: jest.fn(), -})); - -jest.mock('../components/header', () => ({ - Header: () => 'Header', -})); - -jest.mock('ui/chrome', () => ({ - addBasePath: () => '', - getInjected: () => ['index-pattern', 'visualization', 'dashboard', 'search'], -})); - -jest.mock('../../../lib/fetch_export_objects', () => ({ - fetchExportObjects: jest.fn(), -})); - -jest.mock('../../../lib/fetch_export_by_type_and_search', () => ({ - fetchExportByTypeAndSearch: jest.fn(), -})); - -jest.mock('../../../lib/extract_export_details', () => ({ - extractExportDetails: jest.fn(), -})); - -jest.mock('../../../lib/get_saved_object_counts', () => ({ - getSavedObjectCounts: jest.fn().mockImplementation(() => { - return { - 'index-pattern': 0, - visualization: 0, - dashboard: 0, - search: 0, - }; - }), -})); - -jest.mock('@elastic/filesaver', () => ({ - saveAs: jest.fn(), -})); - -jest.mock('../../../lib/get_relationships', () => ({ - getRelationships: jest.fn(), -})); - -jest.mock('ui/notify', () => ({})); +import { ShallowWrapper } from 'enzyme'; +import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; +import { + httpServiceMock, + overlayServiceMock, + notificationServiceMock, + savedObjectsServiceMock, + applicationServiceMock, +} from '../../../../../core/public/mocks'; +import { dataPluginMock } from '../../../../data/public/mocks'; +import { serviceRegistryMock } from '../../services/service_registry.mock'; +import { actionServiceMock } from '../../services/action_service.mock'; +import { + SavedObjectsTable, + SavedObjectsTableProps, + SavedObjectsTableState, +} from './saved_objects_table'; +import { Flyout, Relationships } from './components'; +import { SavedObjectWithMetadata } from '../../types'; + +const allowedTypes = ['index-pattern', 'visualization', 'dashboard', 'search']; const allSavedObjects = [ { @@ -112,122 +82,128 @@ const allSavedObjects = [ }, ]; -const $http = () => {}; -$http.post = jest.fn().mockImplementation(() => []); -const defaultProps = { - goInspectObject: () => {}, - confirmModalPromise: jest.fn(), - savedObjectsClient: { - find: jest.fn(), - bulkGet: jest.fn(), - }, - indexPatterns: { - clearCache: jest.fn(), - }, - $http, - basePath: '', - newIndexPatternUrl: '', - kbnIndex: '', - services: [], - uiCapabilities: { - savedObjectsManagement: { - read: true, - edit: false, - delete: false, - }, - }, - canDelete: true, -}; - -beforeEach(() => { - findObjects.mockImplementation(() => ({ - total: 4, - savedObjects: [ - { - id: '1', - type: 'index-pattern', - meta: { - title: `MyIndexPattern*`, - icon: 'indexPatternApp', - editUrl: '#/management/kibana/index_patterns/1', - inAppUrl: { - path: '/management/kibana/index_patterns/1', - uiCapabilitiesPath: 'management.kibana.index_patterns', +describe('SavedObjectsTable', () => { + let defaultProps: SavedObjectsTableProps; + let http: ReturnType<typeof httpServiceMock.createStartContract>; + let overlays: ReturnType<typeof overlayServiceMock.createStartContract>; + let notifications: ReturnType<typeof notificationServiceMock.createStartContract>; + let savedObjects: ReturnType<typeof savedObjectsServiceMock.createStartContract>; + + const shallowRender = (overrides: Partial<SavedObjectsTableProps> = {}) => { + return (shallowWithI18nProvider( + <SavedObjectsTable {...defaultProps} {...overrides} /> + ) as unknown) as ShallowWrapper< + SavedObjectsTableProps, + SavedObjectsTableState, + SavedObjectsTable + >; + }; + + beforeEach(() => { + extractExportDetailsMock.mockReset(); + + http = httpServiceMock.createStartContract(); + overlays = overlayServiceMock.createStartContract(); + notifications = notificationServiceMock.createStartContract(); + savedObjects = savedObjectsServiceMock.createStartContract(); + + const applications = applicationServiceMock.createStartContract(); + applications.capabilities = { + navLinks: {}, + management: {}, + catalogue: {}, + savedObjectsManagement: { + read: true, + edit: false, + delete: false, + }, + }; + + http.post.mockResolvedValue([]); + + getSavedObjectCountsMock.mockReturnValue({ + 'index-pattern': 0, + visualization: 0, + dashboard: 0, + search: 0, + }); + + defaultProps = { + allowedTypes, + serviceRegistry: serviceRegistryMock.create(), + actionRegistry: actionServiceMock.createStart(), + savedObjectsClient: savedObjects.client, + indexPatterns: dataPluginMock.createStartContract().indexPatterns, + http, + overlays, + notifications, + applications, + perPageConfig: 15, + goInspectObject: () => {}, + canGoInApp: () => true, + }; + + findObjectsMock.mockImplementation(() => ({ + total: 4, + savedObjects: [ + { + id: '1', + type: 'index-pattern', + meta: { + title: `MyIndexPattern*`, + icon: 'indexPatternApp', + editUrl: '#/management/kibana/index_patterns/1', + inAppUrl: { + path: '/management/kibana/index_patterns/1', + uiCapabilitiesPath: 'management.kibana.index_patterns', + }, }, }, - }, - { - id: '2', - type: 'search', - meta: { - title: `MySearch`, - icon: 'search', - editUrl: '#/management/kibana/objects/savedSearches/2', - inAppUrl: { - path: '/discover/2', - uiCapabilitiesPath: 'discover.show', + { + id: '2', + type: 'search', + meta: { + title: `MySearch`, + icon: 'search', + editUrl: '#/management/kibana/objects/savedSearches/2', + inAppUrl: { + path: '/discover/2', + uiCapabilitiesPath: 'discover.show', + }, }, }, - }, - { - id: '3', - type: 'dashboard', - meta: { - title: `MyDashboard`, - icon: 'dashboardApp', - editUrl: '#/management/kibana/objects/savedDashboards/3', - inAppUrl: { - path: '/dashboard/3', - uiCapabilitiesPath: 'dashboard.show', + { + id: '3', + type: 'dashboard', + meta: { + title: `MyDashboard`, + icon: 'dashboardApp', + editUrl: '#/management/kibana/objects/savedDashboards/3', + inAppUrl: { + path: '/dashboard/3', + uiCapabilitiesPath: 'dashboard.show', + }, }, }, - }, - { - id: '4', - type: 'visualization', - meta: { - title: `MyViz`, - icon: 'visualizeApp', - editUrl: '#/management/kibana/objects/savedVisualizations/4', - inAppUrl: { - path: '/visualize/edit/4', - uiCapabilitiesPath: 'visualize.show', + { + id: '4', + type: 'visualization', + meta: { + title: `MyViz`, + icon: 'visualizeApp', + editUrl: '#/management/kibana/objects/savedVisualizations/4', + inAppUrl: { + path: '/visualize/edit/4', + uiCapabilitiesPath: 'visualize.show', + }, }, }, - }, - ], - })); -}); - -let addDangerMock; -let addSuccessMock; -let addWarningMock; - -describe('ObjectsTable', () => { - beforeEach(() => { - defaultProps.savedObjectsClient.find.mockClear(); - extractExportDetails.mockReset(); - // mock _.debounce to fire immediately with no internal timer - require('lodash').debounce = func => { - function debounced(...args) { - return func.apply(this, args); - } - return debounced; - }; - addDangerMock = jest.fn(); - addSuccessMock = jest.fn(); - addWarningMock = jest.fn(); - require('ui/notify').toastNotifications = { - addDanger: addDangerMock, - addSuccess: addSuccessMock, - addWarning: addWarningMock, - }; + ], + })); }); it('should render normally', async () => { - const component = shallowWithI18nProvider( - <ObjectsTable {...defaultProps} perPageConfig={15} /> - ); + const component = shallowRender({ perPageConfig: 15 }); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -238,19 +214,17 @@ describe('ObjectsTable', () => { }); it('should add danger toast when find fails', async () => { - findObjects.mockImplementation(() => { + findObjectsMock.mockImplementation(() => { throw new Error('Simulated find error'); }); - const component = shallowWithI18nProvider( - <ObjectsTable {...defaultProps} perPageConfig={15} /> - ); + const component = shallowRender({ perPageConfig: 15 }); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); // Ensure the state changes are reflected component.update(); - expect(addDangerMock).toHaveBeenCalled(); + expect(notifications.toasts.addDanger).toHaveBeenCalled(); }); describe('export', () => { @@ -258,7 +232,7 @@ describe('ObjectsTable', () => { const mockSelectedSavedObjects = [ { id: '1', type: 'index-pattern' }, { id: '3', type: 'dashboard' }, - ]; + ] as SavedObjectWithMetadata[]; const mockSavedObjects = mockSelectedSavedObjects.map(obj => ({ _id: obj.id, @@ -272,11 +246,7 @@ describe('ObjectsTable', () => { })), }; - const { fetchExportObjects } = require('../../../lib/fetch_export_objects'); - - const component = shallowWithI18nProvider( - <ObjectsTable {...defaultProps} savedObjectsClient={mockSavedObjectsClient} /> - ); + const component = shallowRender({ savedObjectsClient: mockSavedObjectsClient }); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -288,8 +258,8 @@ describe('ObjectsTable', () => { await component.instance().onExport(true); - expect(fetchExportObjects).toHaveBeenCalledWith(mockSelectedSavedObjects, true); - expect(addSuccessMock).toHaveBeenCalledWith({ + expect(fetchExportObjectsMock).toHaveBeenCalledWith(http, mockSelectedSavedObjects, true); + expect(notifications.toasts.addSuccess).toHaveBeenCalledWith({ title: 'Your file is downloading in the background', }); }); @@ -298,7 +268,7 @@ describe('ObjectsTable', () => { const mockSelectedSavedObjects = [ { id: '1', type: 'index-pattern' }, { id: '3', type: 'dashboard' }, - ]; + ] as SavedObjectWithMetadata[]; const mockSavedObjects = mockSelectedSavedObjects.map(obj => ({ _id: obj.id, @@ -312,16 +282,13 @@ describe('ObjectsTable', () => { })), }; - const { fetchExportObjects } = require('../../../lib/fetch_export_objects'); - extractExportDetails.mockImplementation(() => ({ + extractExportDetailsMock.mockImplementation(() => ({ exportedCount: 2, missingRefCount: 1, missingReferences: [{ id: '7', type: 'visualisation' }], })); - const component = shallowWithI18nProvider( - <ObjectsTable {...defaultProps} savedObjectsClient={mockSavedObjectsClient} /> - ); + const component = shallowRender({ savedObjectsClient: mockSavedObjectsClient }); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -333,8 +300,8 @@ describe('ObjectsTable', () => { await component.instance().onExport(true); - expect(fetchExportObjects).toHaveBeenCalledWith(mockSelectedSavedObjects, true); - expect(addWarningMock).toHaveBeenCalledWith({ + expect(fetchExportObjectsMock).toHaveBeenCalledWith(http, mockSelectedSavedObjects, true); + expect(notifications.toasts.addWarning).toHaveBeenCalledWith({ title: 'Your file is downloading in the background. ' + 'Some related objects could not be found. ' + @@ -343,25 +310,21 @@ describe('ObjectsTable', () => { }); it('should allow the user to choose when exporting all', async () => { - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); // Ensure the state changes are reflected component.update(); - component.find('Header').prop('onExportAll')(); + (component.find('Header') as any).prop('onExportAll')(); component.update(); expect(component.find('EuiModal')).toMatchSnapshot(); }); it('should export all', async () => { - const { - fetchExportByTypeAndSearch, - } = require('../../../lib/fetch_export_by_type_and_search'); - const { saveAs } = require('@elastic/filesaver'); - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -370,23 +333,24 @@ describe('ObjectsTable', () => { // Set up mocks const blob = new Blob([JSON.stringify(allSavedObjects)], { type: 'application/ndjson' }); - fetchExportByTypeAndSearch.mockImplementation(() => blob); + fetchExportByTypeAndSearchMock.mockImplementation(() => blob); await component.instance().onExportAll(); - expect(fetchExportByTypeAndSearch).toHaveBeenCalledWith(POSSIBLE_TYPES, undefined, true); - expect(saveAs).toHaveBeenCalledWith(blob, 'export.ndjson'); - expect(addSuccessMock).toHaveBeenCalledWith({ + expect(fetchExportByTypeAndSearchMock).toHaveBeenCalledWith( + http, + allowedTypes, + undefined, + true + ); + expect(saveAsMock).toHaveBeenCalledWith(blob, 'export.ndjson'); + expect(notifications.toasts.addSuccess).toHaveBeenCalledWith({ title: 'Your file is downloading in the background', }); }); it('should export all, accounting for the current search criteria', async () => { - const { - fetchExportByTypeAndSearch, - } = require('../../../lib/fetch_export_by_type_and_search'); - const { saveAs } = require('@elastic/filesaver'); - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); component.instance().onQueryChange({ query: Query.parse('test'), @@ -399,13 +363,18 @@ describe('ObjectsTable', () => { // Set up mocks const blob = new Blob([JSON.stringify(allSavedObjects)], { type: 'application/ndjson' }); - fetchExportByTypeAndSearch.mockImplementation(() => blob); + fetchExportByTypeAndSearchMock.mockImplementation(() => blob); await component.instance().onExportAll(); - expect(fetchExportByTypeAndSearch).toHaveBeenCalledWith(POSSIBLE_TYPES, 'test*', true); - expect(saveAs).toHaveBeenCalledWith(blob, 'export.ndjson'); - expect(addSuccessMock).toHaveBeenCalledWith({ + expect(fetchExportByTypeAndSearchMock).toHaveBeenCalledWith( + http, + allowedTypes, + 'test*', + true + ); + expect(saveAsMock).toHaveBeenCalledWith(blob, 'export.ndjson'); + expect(notifications.toasts.addSuccess).toHaveBeenCalledWith({ title: 'Your file is downloading in the background', }); }); @@ -413,7 +382,7 @@ describe('ObjectsTable', () => { describe('import', () => { it('should show the flyout', async () => { - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -427,7 +396,7 @@ describe('ObjectsTable', () => { }); it('should hide the flyout', async () => { - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -443,9 +412,7 @@ describe('ObjectsTable', () => { describe('relationships', () => { it('should fetch relationships', async () => { - const { getRelationships } = require('../../../lib/get_relationships'); - - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -454,17 +421,11 @@ describe('ObjectsTable', () => { await component.instance().getRelationships('search', '1'); const savedObjectTypes = ['index-pattern', 'visualization', 'dashboard', 'search']; - expect(getRelationships).toHaveBeenCalledWith( - 'search', - '1', - savedObjectTypes, - defaultProps.$http, - defaultProps.basePath - ); + expect(getRelationshipsMock).toHaveBeenCalledWith(http, 'search', '1', savedObjectTypes); }); it('should show the flyout', async () => { - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -483,7 +444,7 @@ describe('ObjectsTable', () => { uiCapabilitiesPath: 'discover.show', }, }, - }); + } as SavedObjectWithMetadata); component.update(); expect(component.find(Relationships)).toMatchSnapshot(); @@ -503,7 +464,7 @@ describe('ObjectsTable', () => { }); it('should hide the flyout', async () => { - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -522,12 +483,12 @@ describe('ObjectsTable', () => { describe('delete', () => { it('should show a confirm modal', async () => { - const component = shallowWithI18nProvider(<ObjectsTable {...defaultProps} />); + const component = shallowRender(); const mockSelectedSavedObjects = [ - { id: '1', type: 'index-pattern', title: 'Title 1' }, - { id: '3', type: 'dashboard', title: 'Title 2' }, - ]; + { id: '1', type: 'index-pattern' }, + { id: '3', type: 'dashboard' }, + ] as SavedObjectWithMetadata[]; // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); @@ -546,7 +507,7 @@ describe('ObjectsTable', () => { const mockSelectedSavedObjects = [ { id: '1', type: 'index-pattern' }, { id: '3', type: 'dashboard' }, - ]; + ] as SavedObjectWithMetadata[]; const mockSavedObjects = mockSelectedSavedObjects.map(obj => ({ id: obj.id, @@ -562,9 +523,7 @@ describe('ObjectsTable', () => { delete: jest.fn(), }; - const component = shallowWithI18nProvider( - <ObjectsTable {...defaultProps} savedObjectsClient={mockSavedObjectsClient} /> - ); + const component = shallowRender({ savedObjectsClient: mockSavedObjectsClient }); // Ensure all promises resolve await new Promise(resolve => process.nextTick(resolve)); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/objects_table.js b/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.tsx similarity index 73% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/objects_table.js rename to src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.tsx index 188762f165b24..c76fea5a0fb29 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/components/objects_table/objects_table.js +++ b/src/plugins/saved_objects_management/public/management_section/objects_table/saved_objects_table.tsx @@ -17,17 +17,10 @@ * under the License. */ -import chrome from 'ui/chrome'; -import { saveAs } from '@elastic/filesaver'; import React, { Component } from 'react'; -import PropTypes from 'prop-types'; import { debounce } from 'lodash'; -import { Header } from './components/header'; -import { Flyout } from './components/flyout'; -import { Relationships } from './components/relationships'; -import { Table } from './components/table'; -import { toastNotifications } from 'ui/notify'; - +// @ts-ignore +import { saveAs } from '@elastic/filesaver'; import { EuiSpacer, Query, @@ -54,7 +47,15 @@ import { } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; - +import { + SavedObjectsClientContract, + SavedObjectsFindOptions, + HttpStart, + OverlayStart, + NotificationsStart, + ApplicationStart, +} from 'src/core/public'; +import { IndexPatternsContract } from '../../../../data/public'; import { parseQuery, getSavedObjectCounts, @@ -63,39 +64,72 @@ import { fetchExportObjects, fetchExportByTypeAndSearch, findObjects, + extractExportDetails, + SavedObjectsExportResultDetails, } from '../../lib'; -import { extractExportDetails } from '../../lib/extract_export_details'; - -export const POSSIBLE_TYPES = chrome.getInjected('importAndExportableTypes'); - -export class ObjectsTable extends Component { - static propTypes = { - savedObjectsClient: PropTypes.object.isRequired, - indexPatterns: PropTypes.object.isRequired, - $http: PropTypes.func.isRequired, - basePath: PropTypes.string.isRequired, - perPageConfig: PropTypes.number, - newIndexPatternUrl: PropTypes.string.isRequired, - confirmModalPromise: PropTypes.func.isRequired, - services: PropTypes.array.isRequired, - uiCapabilities: PropTypes.object.isRequired, - goInspectObject: PropTypes.func.isRequired, - canGoInApp: PropTypes.func.isRequired, - }; +import { SavedObjectWithMetadata } from '../../types'; +import { + ISavedObjectsManagementServiceRegistry, + SavedObjectsManagementActionServiceStart, +} from '../../services'; +import { Header, Table, Flyout, Relationships } from './components'; + +interface ExportAllOption { + id: string; + label: string; +} - constructor(props) { +export interface SavedObjectsTableProps { + allowedTypes: string[]; + serviceRegistry: ISavedObjectsManagementServiceRegistry; + actionRegistry: SavedObjectsManagementActionServiceStart; + savedObjectsClient: SavedObjectsClientContract; + indexPatterns: IndexPatternsContract; + http: HttpStart; + overlays: OverlayStart; + notifications: NotificationsStart; + applications: ApplicationStart; + perPageConfig: number; + goInspectObject: (obj: SavedObjectWithMetadata) => void; + canGoInApp: (obj: SavedObjectWithMetadata) => boolean; +} + +export interface SavedObjectsTableState { + totalCount: number; + page: number; + perPage: number; + savedObjects: SavedObjectWithMetadata[]; + savedObjectCounts: Record<string, number>; + activeQuery: Query; + selectedSavedObjects: SavedObjectWithMetadata[]; + isShowingImportFlyout: boolean; + isSearching: boolean; + filteredItemCount: number; + isShowingRelationships: boolean; + relationshipObject?: SavedObjectWithMetadata; + isShowingDeleteConfirmModal: boolean; + isShowingExportAllOptionsModal: boolean; + isDeleting: boolean; + exportAllOptions: ExportAllOption[]; + exportAllSelectedOptions: Record<string, boolean>; + isIncludeReferencesDeepChecked: boolean; +} + +export class SavedObjectsTable extends Component<SavedObjectsTableProps, SavedObjectsTableState> { + private _isMounted = false; + + constructor(props: SavedObjectsTableProps) { super(props); - this.savedObjectTypes = POSSIBLE_TYPES; this.state = { totalCount: 0, page: 0, perPage: props.perPageConfig || 50, savedObjects: [], - savedObjectCounts: this.savedObjectTypes.reduce((typeToCountMap, type) => { + savedObjectCounts: props.allowedTypes.reduce((typeToCountMap, type) => { typeToCountMap[type] = 0; return typeToCountMap; - }, {}), + }, {} as Record<string, number>), activeQuery: Query.parse(''), selectedSavedObjects: [], isShowingImportFlyout: false, @@ -124,21 +158,20 @@ export class ObjectsTable extends Component { } fetchCounts = async () => { + const { allowedTypes } = this.props; const { queryText, visibleTypes } = parseQuery(this.state.activeQuery); - const filteredTypes = this.savedObjectTypes.filter( - type => !visibleTypes || visibleTypes.includes(type) - ); + const filteredTypes = allowedTypes.filter(type => !visibleTypes || visibleTypes.includes(type)); // These are the saved objects visible in the table. const filteredSavedObjectCounts = await getSavedObjectCounts( - this.props.$http, + this.props.http, filteredTypes, queryText ); - const exportAllOptions = []; - const exportAllSelectedOptions = {}; + const exportAllOptions: ExportAllOption[] = []; + const exportAllSelectedOptions: Record<string, boolean> = {}; Object.keys(filteredSavedObjectCounts).forEach(id => { // Add this type as a bulk-export option. @@ -147,17 +180,13 @@ export class ObjectsTable extends Component { label: `${id} (${filteredSavedObjectCounts[id] || 0})`, }); - // Select it by defayult. + // Select it by default. exportAllSelectedOptions[id] = true; }); // Fetch all the saved objects that exist so we can accurately populate the counts within // the table filter dropdown. - const savedObjectCounts = await getSavedObjectCounts( - this.props.$http, - this.savedObjectTypes, - queryText - ); + const savedObjectCounts = await getSavedObjectCounts(this.props.http, allowedTypes, queryText); this.setState(state => ({ ...state, @@ -178,66 +207,64 @@ export class ObjectsTable extends Component { debouncedFetch = debounce(async () => { const { activeQuery: query, page, perPage } = this.state; + const { notifications, http, allowedTypes } = this.props; const { queryText, visibleTypes } = parseQuery(query); // "searchFields" is missing from the "findOptions" but gets injected via the API. // The API extracts the fields from each uiExports.savedObjectsManagement "defaultSearchField" attribute - const findOptions = { + const findOptions: SavedObjectsFindOptions = { search: queryText ? `${queryText}*` : undefined, perPage, page: page + 1, fields: ['id'], - type: this.savedObjectTypes.filter(type => !visibleTypes || visibleTypes.includes(type)), + type: allowedTypes.filter(type => !visibleTypes || visibleTypes.includes(type)), }; if (findOptions.type.length > 1) { findOptions.sortField = 'type'; } - let resp; try { - resp = await findObjects(findOptions); + const resp = await findObjects(http, findOptions); + if (!this._isMounted) { + return; + } + + this.setState(({ activeQuery }) => { + // ignore results for old requests + if (activeQuery.text !== query.text) { + return null; + } + + return { + savedObjects: resp.savedObjects, + filteredItemCount: resp.total, + isSearching: false, + }; + }); } catch (error) { if (this._isMounted) { this.setState({ isSearching: false, }); } - toastNotifications.addDanger({ + notifications.toasts.addDanger({ title: i18n.translate( - 'kbn.management.objects.objectsTable.unableFindSavedObjectsNotificationMessage', + 'savedObjectsManagement.objectsTable.unableFindSavedObjectsNotificationMessage', { defaultMessage: 'Unable find saved objects' } ), text: `${error}`, }); - return; - } - - if (!this._isMounted) { - return; } - - this.setState(({ activeQuery }) => { - // ignore results for old requests - if (activeQuery.text !== query.text) { - return {}; - } - - return { - savedObjects: resp.savedObjects, - filteredItemCount: resp.total, - isSearching: false, - }; - }); }, 300); refreshData = async () => { await Promise.all([this.fetchSavedObjects(), this.fetchCounts()]); }; - onSelectionChanged = selection => { + onSelectionChanged = (selection: SavedObjectWithMetadata[]) => { this.setState({ selectedSavedObjects: selection }); }; - onQueryChange = ({ query }) => { + onQueryChange = ({ query }: { query: Query }) => { // TODO: Use isSameQuery to compare new query with state.activeQuery to avoid re-fetching the // same data we already have. this.setState( @@ -253,7 +280,7 @@ export class ObjectsTable extends Component { ); }; - onTableChange = async table => { + onTableChange = async (table: any) => { const { index: page, size: perPage } = table.page || {}; this.setState( @@ -266,7 +293,7 @@ export class ObjectsTable extends Component { ); }; - onShowRelationships = object => { + onShowRelationships = (object: SavedObjectWithMetadata) => { this.setState({ isShowingRelationships: true, relationshipObject: object, @@ -280,16 +307,17 @@ export class ObjectsTable extends Component { }); }; - onExport = async includeReferencesDeep => { + onExport = async (includeReferencesDeep: boolean) => { const { selectedSavedObjects } = this.state; + const { notifications, http } = this.props; const objectsToExport = selectedSavedObjects.map(obj => ({ id: obj.id, type: obj.type })); let blob; try { - blob = await fetchExportObjects(objectsToExport, includeReferencesDeep); + blob = await fetchExportObjects(http, objectsToExport, includeReferencesDeep); } catch (e) { - toastNotifications.addDanger({ - title: i18n.translate('kbn.management.objects.objectsTable.export.dangerNotification', { + notifications.toasts.addDanger({ + title: i18n.translate('savedObjectsManagement.objectsTable.export.dangerNotification', { defaultMessage: 'Unable to generate export', }), }); @@ -304,24 +332,26 @@ export class ObjectsTable extends Component { onExportAll = async () => { const { exportAllSelectedOptions, isIncludeReferencesDeepChecked, activeQuery } = this.state; + const { notifications, http } = this.props; const { queryText } = parseQuery(activeQuery); const exportTypes = Object.entries(exportAllSelectedOptions).reduce((accum, [id, selected]) => { if (selected) { accum.push(id); } return accum; - }, []); + }, [] as string[]); let blob; try { blob = await fetchExportByTypeAndSearch( + http, exportTypes, queryText ? `${queryText}*` : undefined, isIncludeReferencesDeepChecked ); } catch (e) { - toastNotifications.addDanger({ - title: i18n.translate('kbn.management.objects.objectsTable.export.dangerNotification', { + notifications.toasts.addDanger({ + title: i18n.translate('savedObjectsManagement.objectsTable.export.dangerNotification', { defaultMessage: 'Unable to generate export', }), }); @@ -335,11 +365,12 @@ export class ObjectsTable extends Component { this.setState({ isShowingExportAllOptionsModal: false }); }; - showExportSuccessMessage = exportDetails => { + showExportSuccessMessage = (exportDetails: SavedObjectsExportResultDetails | undefined) => { + const { notifications } = this.props; if (exportDetails && exportDetails.missingReferences.length > 0) { - toastNotifications.addWarning({ + notifications.toasts.addWarning({ title: i18n.translate( - 'kbn.management.objects.objectsTable.export.successWithMissingRefsNotification', + 'savedObjectsManagement.objectsTable.export.successWithMissingRefsNotification', { defaultMessage: 'Your file is downloading in the background. ' + @@ -349,8 +380,8 @@ export class ObjectsTable extends Component { ), }); } else { - toastNotifications.addSuccess({ - title: i18n.translate('kbn.management.objects.objectsTable.export.successNotification', { + notifications.toasts.addSuccess({ + title: i18n.translate('savedObjectsManagement.objectsTable.export.successNotification', { defaultMessage: 'Your file is downloading in the background', }), }); @@ -412,30 +443,30 @@ export class ObjectsTable extends Component { }); }; - getRelationships = async (type, id) => { - return await getRelationships( - type, - id, - this.savedObjectTypes, - this.props.$http, - this.props.basePath - ); + getRelationships = async (type: string, id: string) => { + const { allowedTypes, http } = this.props; + return await getRelationships(http, type, id, allowedTypes); }; renderFlyout() { if (!this.state.isShowingImportFlyout) { return null; } + const { applications } = this.props; + const newIndexPatternUrl = applications.getUrlForApp('kibana', { + path: '#/management/kibana/index_pattern', + }); return ( <Flyout close={this.hideImportFlyout} done={this.finishImport} - services={this.props.services} + http={this.props.http} + serviceRegistry={this.props.serviceRegistry} indexPatterns={this.props.indexPatterns} - newIndexPatternUrl={this.props.newIndexPatternUrl} - savedObjectTypes={this.props.savedObjectTypes} - confirmModalPromise={this.props.confirmModalPromise} + newIndexPatternUrl={newIndexPatternUrl} + allowedTypes={this.props.allowedTypes} + overlays={this.props.overlays} /> ); } @@ -447,10 +478,10 @@ export class ObjectsTable extends Component { return ( <Relationships - savedObject={this.state.relationshipObject} + basePath={this.props.http.basePath} + savedObject={this.state.relationshipObject!} getRelationships={this.getRelationships} close={this.onHideRelationships} - getDashboardUrl={this.props.getDashboardUrl} goInspectObject={this.props.goInspectObject} canGoInApp={this.props.canGoInApp} /> @@ -482,7 +513,7 @@ export class ObjectsTable extends Component { <EuiConfirmModal title={ <FormattedMessage - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModalTitle" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModalTitle" defaultMessage="Delete saved objects" /> } @@ -491,19 +522,19 @@ export class ObjectsTable extends Component { buttonColor="danger" cancelButtonText={ <FormattedMessage - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel" defaultMessage="Cancel" /> } confirmButtonText={ isDeleting ? ( <FormattedMessage - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteProcessButtonLabel" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteProcessButtonLabel" defaultMessage="Deleting…" /> ) : ( <FormattedMessage - id="kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel" + id="savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel" defaultMessage="Delete" /> ) @@ -512,7 +543,7 @@ export class ObjectsTable extends Component { > <p> <FormattedMessage - id="kbn.management.objects.deleteSavedObjectsConfirmModalDescription" + id="savedObjectsManagement.deleteSavedObjectsConfirmModalDescription" defaultMessage="This action will delete the following saved objects:" /> </p> @@ -522,7 +553,7 @@ export class ObjectsTable extends Component { { field: 'type', name: i18n.translate( - 'kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.typeColumnName', + 'savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.typeColumnName', { defaultMessage: 'Type' } ), width: '50px', @@ -535,14 +566,14 @@ export class ObjectsTable extends Component { { field: 'id', name: i18n.translate( - 'kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.idColumnName', + 'savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.idColumnName', { defaultMessage: 'Id' } ), }, { field: 'meta.title', name: i18n.translate( - 'kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.titleColumnName', + 'savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.titleColumnName', { defaultMessage: 'Title' } ), }, @@ -586,7 +617,7 @@ export class ObjectsTable extends Component { <EuiModalHeader> <EuiModalHeaderTitle> <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModalTitle" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModalTitle" defaultMessage="Export {filteredItemCount, plural, one{# object} other {# objects}}" values={{ filteredItemCount, @@ -598,7 +629,7 @@ export class ObjectsTable extends Component { <EuiFormRow label={ <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModalDescription" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModalDescription" defaultMessage="Select which types to export" /> } @@ -626,7 +657,7 @@ export class ObjectsTable extends Component { name="includeReferencesDeep" label={ <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel" defaultMessage="Include related objects" /> } @@ -641,7 +672,7 @@ export class ObjectsTable extends Component { <EuiFlexItem grow={false}> <EuiButtonEmpty onClick={this.closeExportAllModal}> <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.cancelButtonLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.cancelButtonLabel" defaultMessage="Cancel" /> </EuiButtonEmpty> @@ -649,7 +680,7 @@ export class ObjectsTable extends Component { <EuiFlexItem grow={false}> <EuiButton fill onClick={this.onExportAll}> <FormattedMessage - id="kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel" + id="savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel" defaultMessage="Export all" /> </EuiButton> @@ -673,12 +704,13 @@ export class ObjectsTable extends Component { isSearching, savedObjectCounts, } = this.state; + const { http, allowedTypes, applications } = this.props; const selectionConfig = { onSelectionChange: this.onSelectionChanged, }; - const filterOptions = this.savedObjectTypes.map(type => ({ + const filterOptions = allowedTypes.map(type => ({ value: type, name: type, view: `${type} (${savedObjectCounts[type] || 0})`, @@ -698,14 +730,16 @@ export class ObjectsTable extends Component { /> <EuiSpacer size="xs" /> <Table + basePath={http.basePath} itemId={'id'} + actionRegistry={this.props.actionRegistry} selectionConfig={selectionConfig} selectedSavedObjects={selectedSavedObjects} onQueryChange={this.onQueryChange} onTableChange={this.onTableChange} filterOptions={filterOptions} onExport={this.onExport} - canDelete={this.props.uiCapabilities.savedObjectsManagement.delete} + canDelete={applications.capabilities.savedObjectsManagement.delete as boolean} onDelete={this.onDelete} goInspectObject={this.props.goInspectObject} pageIndex={page} diff --git a/src/plugins/saved_objects_management/public/management_section/types.ts b/src/plugins/saved_objects_management/public/management_section/types.ts new file mode 100644 index 0000000000000..541746534b84a --- /dev/null +++ b/src/plugins/saved_objects_management/public/management_section/types.ts @@ -0,0 +1,38 @@ +/* + * 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. + */ + +import { SavedObjectReference } from '../../../../core/types'; + +export interface ObjectField { + type: FieldType; + name: string; + value: any; +} + +export type FieldType = 'text' | 'number' | 'boolean' | 'array' | 'json'; + +export interface FieldState { + value?: any; + invalid?: boolean; +} + +export interface SubmittedFormData { + attributes: any; + references: SavedObjectReference[]; +} diff --git a/src/plugins/saved_objects_management/public/mocks.ts b/src/plugins/saved_objects_management/public/mocks.ts index 8cf23afe87907..1de3de8e85302 100644 --- a/src/plugins/saved_objects_management/public/mocks.ts +++ b/src/plugins/saved_objects_management/public/mocks.ts @@ -17,23 +17,27 @@ * under the License. */ -import { actionRegistryMock } from './services/action_registry.mock'; +import { actionServiceMock } from './services/action_service.mock'; +import { serviceRegistryMock } from './services/service_registry.mock'; import { SavedObjectsManagementPluginSetup, SavedObjectsManagementPluginStart } from './plugin'; const createSetupContractMock = (): jest.Mocked<SavedObjectsManagementPluginSetup> => { const mock = { - actionRegistry: actionRegistryMock.create(), + actions: actionServiceMock.createSetup(), + serviceRegistry: serviceRegistryMock.create(), }; return mock; }; const createStartContractMock = (): jest.Mocked<SavedObjectsManagementPluginStart> => { - const mock = {}; + const mock = { + actions: actionServiceMock.createStart(), + }; return mock; }; export const savedObjectsManagementPluginMock = { - createActionRegistry: actionRegistryMock.create, + createServiceRegistry: serviceRegistryMock.create, createSetupContract: createSetupContractMock, createStartContract: createStartContractMock, }; diff --git a/src/plugins/saved_objects_management/public/plugin.test.ts b/src/plugins/saved_objects_management/public/plugin.test.ts index 1cafbb235ad5b..09080f46a6869 100644 --- a/src/plugins/saved_objects_management/public/plugin.test.ts +++ b/src/plugins/saved_objects_management/public/plugin.test.ts @@ -20,6 +20,9 @@ import { coreMock } from '../../../core/public/mocks'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { homePluginMock } from '../../home/public/mocks'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { managementPluginMock } from '../../management/public/mocks'; +import { dataPluginMock } from '../../data/public/mocks'; import { SavedObjectsManagementPlugin } from './plugin'; describe('SavedObjectsManagementPlugin', () => { @@ -31,10 +34,13 @@ describe('SavedObjectsManagementPlugin', () => { describe('#setup', () => { it('registers the saved_objects feature to the home plugin', async () => { - const coreSetup = coreMock.createSetup(); + const coreSetup = coreMock.createSetup({ + pluginStartDeps: { data: dataPluginMock.createStartContract() }, + }); const homeSetup = homePluginMock.createSetupContract(); + const managementSetup = managementPluginMock.createSetupContract(); - await plugin.setup(coreSetup, { home: homeSetup }); + await plugin.setup(coreSetup, { home: homeSetup, management: managementSetup }); expect(homeSetup.featureCatalogue.register).toHaveBeenCalledTimes(1); expect(homeSetup.featureCatalogue.register).toHaveBeenCalledWith( diff --git a/src/plugins/saved_objects_management/public/plugin.ts b/src/plugins/saved_objects_management/public/plugin.ts index 3f2e9c166058e..c8dede3da9263 100644 --- a/src/plugins/saved_objects_management/public/plugin.ts +++ b/src/plugins/saved_objects_management/public/plugin.ts @@ -19,37 +19,59 @@ import { i18n } from '@kbn/i18n'; import { CoreSetup, CoreStart, Plugin } from 'src/core/public'; +import { ManagementSetup } from '../../management/public'; +import { DataPublicPluginStart } from '../../data/public'; +import { DashboardStart } from '../../dashboard/public'; +import { DiscoverStart } from '../../discover/public'; import { HomePublicPluginSetup, FeatureCatalogueCategory } from '../../home/public'; +import { VisualizationsStart } from '../../visualizations/public'; import { - SavedObjectsManagementActionRegistry, - ISavedObjectsManagementActionRegistry, + SavedObjectsManagementActionService, + SavedObjectsManagementActionServiceSetup, + SavedObjectsManagementActionServiceStart, + SavedObjectsManagementServiceRegistry, + ISavedObjectsManagementServiceRegistry, } from './services'; +import { registerServices } from './register_services'; export interface SavedObjectsManagementPluginSetup { - actionRegistry: ISavedObjectsManagementActionRegistry; + actions: SavedObjectsManagementActionServiceSetup; + serviceRegistry: ISavedObjectsManagementServiceRegistry; } -// eslint-disable-next-line @typescript-eslint/no-empty-interface -export interface SavedObjectsManagementPluginStart {} +export interface SavedObjectsManagementPluginStart { + actions: SavedObjectsManagementActionServiceStart; +} export interface SetupDependencies { + management: ManagementSetup; home: HomePublicPluginSetup; } +export interface StartDependencies { + data: DataPublicPluginStart; + dashboard?: DashboardStart; + visualizations?: VisualizationsStart; + discover?: DiscoverStart; +} + export class SavedObjectsManagementPlugin implements Plugin< SavedObjectsManagementPluginSetup, SavedObjectsManagementPluginStart, SetupDependencies, - {} + StartDependencies > { - private actionRegistry = new SavedObjectsManagementActionRegistry(); + private actionService = new SavedObjectsManagementActionService(); + private serviceRegistry = new SavedObjectsManagementServiceRegistry(); public setup( - core: CoreSetup<{}>, - { home }: SetupDependencies + core: CoreSetup<StartDependencies, SavedObjectsManagementPluginStart>, + { home, management }: SetupDependencies ): SavedObjectsManagementPluginSetup { + const actionSetup = this.actionService.setup(); + home.featureCatalogue.register({ id: 'saved_objects', title: i18n.translate('savedObjectsManagement.objects.savedObjectsTitle', { @@ -65,12 +87,39 @@ export class SavedObjectsManagementPlugin category: FeatureCatalogueCategory.ADMIN, }); + const kibanaSection = management.sections.getSection('kibana'); + if (!kibanaSection) { + throw new Error('`kibana` management section not found.'); + } + kibanaSection.registerApp({ + id: 'objects', + title: i18n.translate('savedObjectsManagement.managementSectionLabel', { + defaultMessage: 'Saved Objects', + }), + order: 10, + mount: async mountParams => { + const { mountManagementSection } = await import('./management_section'); + return mountManagementSection({ + core, + serviceRegistry: this.serviceRegistry, + mountParams, + }); + }, + }); + + // depends on `getStartServices`, should not be awaited + registerServices(this.serviceRegistry, core.getStartServices); + return { - actionRegistry: this.actionRegistry, + actions: actionSetup, + serviceRegistry: this.serviceRegistry, }; } public start(core: CoreStart) { - return {}; + const actionStart = this.actionService.start(); + return { + actions: actionStart, + }; } } diff --git a/src/plugins/saved_objects_management/public/register_services.ts b/src/plugins/saved_objects_management/public/register_services.ts new file mode 100644 index 0000000000000..a34b632b78f6c --- /dev/null +++ b/src/plugins/saved_objects_management/public/register_services.ts @@ -0,0 +1,59 @@ +/* + * 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. + */ + +import { StartServicesAccessor } from '../../../core/public'; +import { SavedObjectsManagementPluginStart, StartDependencies } from './plugin'; +import { ISavedObjectsManagementServiceRegistry } from './services'; + +export const registerServices = async ( + registry: ISavedObjectsManagementServiceRegistry, + getStartServices: StartServicesAccessor<StartDependencies, SavedObjectsManagementPluginStart> +) => { + const [coreStart, { dashboard, data, visualizations, discover }] = await getStartServices(); + + if (dashboard) { + registry.register({ + id: 'savedDashboards', + title: 'dashboards', + service: dashboard.getSavedDashboardLoader(), + }); + } + + if (visualizations) { + registry.register({ + id: 'savedVisualizations', + title: 'visualizations', + service: visualizations.savedVisualizationsLoader, + }); + } + + if (discover) { + registry.register({ + id: 'savedSearches', + title: 'searches', + service: discover.savedSearches.createLoader({ + savedObjectsClient: coreStart.savedObjects.client, + indexPatterns: data.indexPatterns, + search: data.search, + chrome: coreStart.chrome, + overlays: coreStart.overlays, + }), + }); + } +}; diff --git a/src/plugins/saved_objects_management/public/services/action_service.mock.ts b/src/plugins/saved_objects_management/public/services/action_service.mock.ts new file mode 100644 index 0000000000000..97c95a589b925 --- /dev/null +++ b/src/plugins/saved_objects_management/public/services/action_service.mock.ts @@ -0,0 +1,57 @@ +/* + * 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. + */ + +import { + SavedObjectsManagementActionService, + SavedObjectsManagementActionServiceSetup, + SavedObjectsManagementActionServiceStart, +} from './action_service'; + +const createSetupMock = (): jest.Mocked<SavedObjectsManagementActionServiceSetup> => { + const mock = { + register: jest.fn(), + }; + return mock; +}; + +const createStartMock = (): jest.Mocked<SavedObjectsManagementActionServiceStart> => { + const mock = { + has: jest.fn(), + getAll: jest.fn(), + }; + + mock.has.mockReturnValue(true); + mock.getAll.mockReturnValue([]); + + return mock; +}; + +const createServiceMock = (): jest.Mocked<PublicMethodsOf<SavedObjectsManagementActionService>> => { + const mock = { + setup: jest.fn().mockReturnValue(createSetupMock()), + start: jest.fn().mockReturnValue(createStartMock()), + }; + return mock; +}; + +export const actionServiceMock = { + create: createServiceMock, + createSetup: createSetupMock, + createStart: createStartMock, +}; diff --git a/src/plugins/saved_objects_management/public/services/action_registry.test.ts b/src/plugins/saved_objects_management/public/services/action_service.test.ts similarity index 69% rename from src/plugins/saved_objects_management/public/services/action_registry.test.ts rename to src/plugins/saved_objects_management/public/services/action_service.test.ts index eb3bda00f4196..107554589f83d 100644 --- a/src/plugins/saved_objects_management/public/services/action_registry.test.ts +++ b/src/plugins/saved_objects_management/public/services/action_service.test.ts @@ -17,8 +17,11 @@ * under the License. */ -import { SavedObjectsManagementActionRegistry } from './action_registry'; -import { SavedObjectsManagementAction } from './action_types'; +import { + SavedObjectsManagementActionService, + SavedObjectsManagementActionServiceSetup, +} from './action_service'; +import { SavedObjectsManagementAction } from './types'; class DummyAction extends SavedObjectsManagementAction { constructor(public id: string) { @@ -36,27 +39,30 @@ class DummyAction extends SavedObjectsManagementAction { } describe('SavedObjectsManagementActionRegistry', () => { - let registry: SavedObjectsManagementActionRegistry; + let service: SavedObjectsManagementActionService; + let setup: SavedObjectsManagementActionServiceSetup; const createAction = (id: string): SavedObjectsManagementAction => { return new DummyAction(id); }; beforeEach(() => { - registry = new SavedObjectsManagementActionRegistry(); + service = new SavedObjectsManagementActionService(); + setup = service.setup(); }); describe('#register', () => { it('allows actions to be registered and retrieved', () => { const action = createAction('foo'); - registry.register(action); - expect(registry.getAll()).toContain(action); + setup.register(action); + const start = service.start(); + expect(start.getAll()).toContain(action); }); it('does not allow actions with duplicate ids to be registered', () => { const action = createAction('my-action'); - registry.register(action); - expect(() => registry.register(action)).toThrowErrorMatchingInlineSnapshot( + setup.register(action); + expect(() => setup.register(action)).toThrowErrorMatchingInlineSnapshot( `"Saved Objects Management Action with id 'my-action' already exists"` ); }); @@ -65,12 +71,14 @@ describe('SavedObjectsManagementActionRegistry', () => { describe('#has', () => { it('returns true when an action with a matching ID exists', () => { const action = createAction('existing-action'); - registry.register(action); - expect(registry.has('existing-action')).toEqual(true); + setup.register(action); + const start = service.start(); + expect(start.has('existing-action')).toEqual(true); }); it(`returns false when an action doesn't exist`, () => { - expect(registry.has('missing-action')).toEqual(false); + const start = service.start(); + expect(start.has('missing-action')).toEqual(false); }); }); }); diff --git a/src/plugins/saved_objects_management/public/services/action_registry.ts b/src/plugins/saved_objects_management/public/services/action_service.ts similarity index 56% rename from src/plugins/saved_objects_management/public/services/action_registry.ts rename to src/plugins/saved_objects_management/public/services/action_service.ts index 8bf77231dd73f..2b0b4cf5431e5 100644 --- a/src/plugins/saved_objects_management/public/services/action_registry.ts +++ b/src/plugins/saved_objects_management/public/services/action_service.ts @@ -17,36 +17,44 @@ * under the License. */ -import { SavedObjectsManagementAction } from './action_types'; - -export type ISavedObjectsManagementActionRegistry = PublicMethodsOf< - SavedObjectsManagementActionRegistry ->; - -export class SavedObjectsManagementActionRegistry { - private readonly actions = new Map<string, SavedObjectsManagementAction>(); +import { SavedObjectsManagementAction } from './types'; +export interface SavedObjectsManagementActionServiceSetup { /** * register given action in the registry. */ - register(action: SavedObjectsManagementAction) { - if (this.actions.has(action.id)) { - throw new Error(`Saved Objects Management Action with id '${action.id}' already exists`); - } - this.actions.set(action.id, action); - } + register: (action: SavedObjectsManagementAction) => void; +} +export interface SavedObjectsManagementActionServiceStart { /** * return true if the registry contains given action, false otherwise. */ - has(actionId: string) { - return this.actions.has(actionId); - } - + has: (actionId: string) => boolean; /** * return all {@link SavedObjectsManagementAction | actions} currently registered. */ - getAll() { - return [...this.actions.values()]; + getAll: () => SavedObjectsManagementAction[]; +} + +export class SavedObjectsManagementActionService { + private readonly actions = new Map<string, SavedObjectsManagementAction>(); + + setup(): SavedObjectsManagementActionServiceSetup { + return { + register: action => { + if (this.actions.has(action.id)) { + throw new Error(`Saved Objects Management Action with id '${action.id}' already exists`); + } + this.actions.set(action.id, action); + }, + }; + } + + start(): SavedObjectsManagementActionServiceStart { + return { + has: actionId => this.actions.has(actionId), + getAll: () => [...this.actions.values()], + }; } } diff --git a/src/plugins/saved_objects_management/public/services/index.ts b/src/plugins/saved_objects_management/public/services/index.ts index d6353576b8e11..a59ad9012c402 100644 --- a/src/plugins/saved_objects_management/public/services/index.ts +++ b/src/plugins/saved_objects_management/public/services/index.ts @@ -18,7 +18,13 @@ */ export { - SavedObjectsManagementActionRegistry, - ISavedObjectsManagementActionRegistry, -} from './action_registry'; -export { SavedObjectsManagementAction, SavedObjectsManagementRecord } from './action_types'; + SavedObjectsManagementActionService, + SavedObjectsManagementActionServiceStart, + SavedObjectsManagementActionServiceSetup, +} from './action_service'; +export { + SavedObjectsManagementServiceRegistry, + ISavedObjectsManagementServiceRegistry, + SavedObjectsManagementServiceRegistryEntry, +} from './service_registry'; +export { SavedObjectsManagementAction, SavedObjectsManagementRecord } from './types'; diff --git a/src/plugins/saved_objects_management/public/services/action_registry.mock.ts b/src/plugins/saved_objects_management/public/services/service_registry.mock.ts similarity index 79% rename from src/plugins/saved_objects_management/public/services/action_registry.mock.ts rename to src/plugins/saved_objects_management/public/services/service_registry.mock.ts index a9093ad42d0ac..2e671c781928f 100644 --- a/src/plugins/saved_objects_management/public/services/action_registry.mock.ts +++ b/src/plugins/saved_objects_management/public/services/service_registry.mock.ts @@ -17,21 +17,20 @@ * under the License. */ -import { ISavedObjectsManagementActionRegistry } from './action_registry'; +import { ISavedObjectsManagementServiceRegistry } from './service_registry'; -const createRegistryMock = (): jest.Mocked<ISavedObjectsManagementActionRegistry> => { +const createRegistryMock = (): jest.Mocked<ISavedObjectsManagementServiceRegistry> => { const mock = { register: jest.fn(), - has: jest.fn(), - getAll: jest.fn(), + all: jest.fn(), + get: jest.fn(), }; - mock.has.mockReturnValue(true); - mock.getAll.mockReturnValue([]); + mock.all.mockReturnValue([]); return mock; }; -export const actionRegistryMock = { +export const serviceRegistryMock = { create: createRegistryMock, }; diff --git a/src/plugins/saved_objects_management/public/services/service_registry.ts b/src/plugins/saved_objects_management/public/services/service_registry.ts new file mode 100644 index 0000000000000..2d6ec0b92047a --- /dev/null +++ b/src/plugins/saved_objects_management/public/services/service_registry.ts @@ -0,0 +1,49 @@ +/* + * 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. + */ + +import { SavedObjectLoader } from '../../../saved_objects/public'; + +export interface SavedObjectsManagementServiceRegistryEntry { + id: string; + service: SavedObjectLoader; + title: string; +} + +export type ISavedObjectsManagementServiceRegistry = PublicMethodsOf< + SavedObjectsManagementServiceRegistry +>; + +export class SavedObjectsManagementServiceRegistry { + private readonly registry = new Map<string, SavedObjectsManagementServiceRegistryEntry>(); + + public register(entry: SavedObjectsManagementServiceRegistryEntry) { + if (this.registry.has(entry.id)) { + throw new Error(''); + } + this.registry.set(entry.id, entry); + } + + public all(): SavedObjectsManagementServiceRegistryEntry[] { + return [...this.registry.values()]; + } + + public get(id: string): SavedObjectsManagementServiceRegistryEntry | undefined { + return this.registry.get(id); + } +} diff --git a/src/plugins/saved_objects_management/public/services/action_types.ts b/src/plugins/saved_objects_management/public/services/types.ts similarity index 100% rename from src/plugins/saved_objects_management/public/services/action_types.ts rename to src/plugins/saved_objects_management/public/services/types.ts diff --git a/src/plugins/saved_objects_management/public/types.ts b/src/plugins/saved_objects_management/public/types.ts new file mode 100644 index 0000000000000..e91b5d253b55f --- /dev/null +++ b/src/plugins/saved_objects_management/public/types.ts @@ -0,0 +1,20 @@ +/* + * 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. + */ + +export { SavedObjectMetadata, SavedObjectWithMetadata, SavedObjectRelation } from '../common'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/objects/index.js b/src/plugins/saved_objects_management/server/routes/get_allowed_types.ts similarity index 61% rename from src/legacy/core_plugins/kibana/public/management/sections/objects/index.js rename to src/plugins/saved_objects_management/server/routes/get_allowed_types.ts index 3965c42ac088d..ab5bec6678946 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/objects/index.js +++ b/src/plugins/saved_objects_management/server/routes/get_allowed_types.ts @@ -17,20 +17,24 @@ * under the License. */ -import { i18n } from '@kbn/i18n'; -import { management } from 'ui/management'; -import './_view'; -import './_objects'; -import 'ace'; -import { uiModules } from 'ui/modules'; +import { IRouter } from 'src/core/server'; -// add the module deps to this module -uiModules.get('apps/management'); +export const registerGetAllowedTypesRoute = (router: IRouter) => { + router.get( + { + path: '/api/kibana/management/saved_objects/_allowed_types', + validate: false, + }, + async (context, req, res) => { + const allowedTypes = context.core.savedObjects.typeRegistry + .getImportableAndExportableTypes() + .map(type => type.name); -management.getSection('kibana').register('objects', { - display: i18n.translate('kbn.management.objects.savedObjectsSectionLabel', { - defaultMessage: 'Saved Objects', - }), - order: 10, - url: '#/management/kibana/objects', -}); + return res.ok({ + body: { + types: allowedTypes, + }, + }); + } + ); +}; diff --git a/src/plugins/saved_objects_management/server/routes/index.test.ts b/src/plugins/saved_objects_management/server/routes/index.test.ts index f183972953dce..237760444f04e 100644 --- a/src/plugins/saved_objects_management/server/routes/index.test.ts +++ b/src/plugins/saved_objects_management/server/routes/index.test.ts @@ -34,7 +34,7 @@ describe('registerRoutes', () => { }); expect(httpSetup.createRouter).toHaveBeenCalledTimes(1); - expect(router.get).toHaveBeenCalledTimes(2); + expect(router.get).toHaveBeenCalledTimes(3); expect(router.post).toHaveBeenCalledTimes(2); expect(router.get).toHaveBeenCalledWith( @@ -49,6 +49,12 @@ describe('registerRoutes', () => { }), expect.any(Function) ); + expect(router.get).toHaveBeenCalledWith( + expect.objectContaining({ + path: '/api/kibana/management/saved_objects/_allowed_types', + }), + expect.any(Function) + ); expect(router.post).toHaveBeenCalledWith( expect.objectContaining({ path: '/api/kibana/management/saved_objects/scroll/counts', diff --git a/src/plugins/saved_objects_management/server/routes/index.ts b/src/plugins/saved_objects_management/server/routes/index.ts index 2c6adb71ed3ce..0929de56b215e 100644 --- a/src/plugins/saved_objects_management/server/routes/index.ts +++ b/src/plugins/saved_objects_management/server/routes/index.ts @@ -23,6 +23,7 @@ import { registerFindRoute } from './find'; import { registerScrollForCountRoute } from './scroll_count'; import { registerScrollForExportRoute } from './scroll_export'; import { registerRelationshipsRoute } from './relationships'; +import { registerGetAllowedTypesRoute } from './get_allowed_types'; interface RegisterRouteOptions { http: HttpServiceSetup; @@ -35,4 +36,5 @@ export function registerRoutes({ http, managementServicePromise }: RegisterRoute registerScrollForCountRoute(router); registerScrollForExportRoute(router); registerRelationshipsRoute(router, managementServicePromise); + registerGetAllowedTypesRoute(router); } diff --git a/src/plugins/saved_objects_management/server/types.ts b/src/plugins/saved_objects_management/server/types.ts index 5c4763d357e87..bd17d6a19ae70 100644 --- a/src/plugins/saved_objects_management/server/types.ts +++ b/src/plugins/saved_objects_management/server/types.ts @@ -17,38 +17,10 @@ * under the License. */ -import { SavedObject } from 'src/core/server'; - // eslint-disable-next-line @typescript-eslint/no-empty-interface export interface SavedObjectsManagementPluginSetup {} // eslint-disable-next-line @typescript-eslint/no-empty-interface export interface SavedObjectsManagementPluginStart {} -/** - * The metadata injected into a {@link SavedObject | saved object} when returning - * {@link SavedObjectWithMetadata | enhanced objects} from the plugin API endpoints. - */ -export interface SavedObjectMetadata { - icon?: string; - title?: string; - editUrl?: string; - inAppUrl?: { path: string; uiCapabilitiesPath: string }; -} - -/** - * A {@link SavedObject | saved object} enhanced with meta properties used by the client-side plugin. - */ -export type SavedObjectWithMetadata<T = unknown> = SavedObject<T> & { - meta: SavedObjectMetadata; -}; - -/** - * Represents a relation between two {@link SavedObject | saved object} - */ -export interface SavedObjectRelation { - id: string; - type: string; - relationship: 'child' | 'parent'; - meta: SavedObjectMetadata; -} +export { SavedObjectMetadata, SavedObjectWithMetadata, SavedObjectRelation } from '../common'; diff --git a/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.test.ts b/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.test.ts index 7d680f0ee0ed6..4e61756d933c9 100644 --- a/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.test.ts +++ b/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.test.ts @@ -22,8 +22,8 @@ describe('CopySavedObjectsToSpaceService', () => { const service = new CopySavedObjectsToSpaceService(); service.setup(deps); - expect(deps.savedObjectsManagementSetup.actionRegistry.register).toHaveBeenCalledTimes(1); - expect(deps.savedObjectsManagementSetup.actionRegistry.register).toHaveBeenCalledWith( + expect(deps.savedObjectsManagementSetup.actions.register).toHaveBeenCalledTimes(1); + expect(deps.savedObjectsManagementSetup.actions.register).toHaveBeenCalledWith( expect.any(CopyToSpaceSavedObjectsManagementAction) ); }); diff --git a/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.ts b/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.ts index d564514beebff..93d0f92744d41 100644 --- a/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.ts +++ b/x-pack/plugins/spaces/public/copy_saved_objects_to_space/copy_saved_objects_to_space_service.ts @@ -18,6 +18,6 @@ interface SetupDeps { export class CopySavedObjectsToSpaceService { public setup({ spacesManager, savedObjectsManagementSetup, notificationsSetup }: SetupDeps) { const action = new CopyToSpaceSavedObjectsManagementAction(spacesManager, notificationsSetup); - savedObjectsManagementSetup.actionRegistry.register(action); + savedObjectsManagementSetup.actions.register(action); } } diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index fe0c58e83e544..e579830bad203 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -2011,7 +2011,6 @@ "kbn.dashboard.listing.table.descriptionColumnName": "説明", "kbn.dashboard.panel.unableToMigratePanelDataForSixOneZeroErrorMessage": "「6.1.0」のダッシュボードの互換性のため、パネルデータを移行できませんでした。パネルには想定された列または行フィールドがありません", "kbn.dashboard.panel.unableToMigratePanelDataForSixThreeZeroErrorMessage": "「6.3.0」のダッシュボードの互換性のため、パネルデータを移行できませんでした。パネルに必要なフィールドがありません: {key}", - "kbn.dashboard.savedDashboardsTitle": "ダッシュボード", "kbn.dashboardTitle": "ダッシュボード", "kbn.devToolsTitle": "開発ツール", "kbn.discover.backToTopLinkText": "最上部へ戻る。", @@ -2281,9 +2280,6 @@ "kbn.management.editIndexPattern.timeFilterLabel.mappingAPILink": "マッピング API", "kbn.management.editIndexPattern.timeFilterLabel.timeFilterDetail": "このページは {indexPatternTitle} インデックス内のすべてのフィールドと、Elasticsearch に記録された各フィールドのコアタイプを一覧表示します。フィールドタイプを変更するには Elasticsearch を使用します", "kbn.management.editIndexPatternLiveRegionAriaLabel": "インデックスパターン", - "kbn.management.indexPattern.confirmOverwriteButton": "上書き", - "kbn.management.indexPattern.confirmOverwriteLabel": "「{title}」に上書きしてよろしいですか？", - "kbn.management.indexPattern.confirmOverwriteTitle": "{type} を上書きしますか？", "kbn.management.indexPattern.goToPatternButtonLabel": "既存のパターンに移動", "kbn.management.indexPattern.sectionsHeader": "インデックスパターン", "kbn.management.indexPattern.titleExistsLabel": "「{title}」というタイトルのインデックスパターンが既に存在します。", @@ -2306,125 +2302,128 @@ "kbn.management.indexPatternTable.title": "インデックスパターン", "kbn.management.landing.header": "Kibana {version} 管理", "kbn.management.landing.subhead": "インデックス、インデックスパターン、保存されたオブジェクト、Kibana の設定、その他を管理します。", - "kbn.management.landing.text": "アプリの一覧は左側のメニューにあります。", - "kbn.management.objects.confirmModalOptions.deleteButtonLabel": "削除", - "kbn.management.objects.confirmModalOptions.modalDescription": "このアクションはオブジェクトを Kibana から永久に削除します。", - "kbn.management.objects.confirmModalOptions.modalTitle": "「{title}」を削除しますか？", - "kbn.management.objects.deleteSavedObjectsConfirmModalDescription": "この操作は次の保存されたオブジェクトを削除します:", - "kbn.management.objects.field.offLabel": "オフ", - "kbn.management.objects.field.onLabel": "オン", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel": "キャンセル", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel": "削除", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteProcessButtonLabel": "削除中…", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.idColumnName": "ID", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.titleColumnName": "タイトル", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.typeColumnName": "タイプ", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModalTitle": "保存されたオブジェクトの削除", - "kbn.management.objects.objectsTable.export.dangerNotification": "エクスポートを生成できません", - "kbn.management.objects.objectsTable.export.successNotification": "ファイルはバックグラウンドでダウンロード中です", - "kbn.management.objects.objectsTable.export.successWithMissingRefsNotification": "ファイルはバックグラウンドでダウンロード中です。一部の関連オブジェクトが見つかりませんでした。足りないオブジェクトの一覧は、エクスポートされたファイルの最後の行をご覧ください。", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.cancelButtonLabel": "キャンセル", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel": "すべてエクスポート:", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportOptionsLabel": "オプション", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel": "関連オブジェクトを含める", - "kbn.management.objects.objectsTable.exportObjectsConfirmModalDescription": "エクスポートするタイプを選択してください", - "kbn.management.objects.objectsTable.exportObjectsConfirmModalTitle": "{filteredItemCount, plural, one{# オブジェクト} other {# オブジェクト}}をエクスポート", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.resolvingConflictsLoadingMessage": "矛盾を解決中…", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.retryingFailedObjectsLoadingMessage": "失敗したオブジェクトを再試行中…", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.savedSearchAreLinkedProperlyLoadingMessage": "保存された検索が正しくリンクされていることを確認してください…", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.savingConflictsLoadingMessage": "矛盾を保存中…", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteBody": "{title} を上書きしてよろしいですか？", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteCancelButtonText": "キャンセル", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteOverwriteButtonText": "上書き", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteTitle": "{type} を上書きしますか？", - "kbn.management.objects.objectsTable.flyout.errorCalloutTitle": "申し訳ございませんが、エラーが発生しました", - "kbn.management.objects.objectsTable.flyout.import.cancelButtonLabel": "キャンセル", - "kbn.management.objects.objectsTable.flyout.import.confirmButtonLabel": "インポート", - "kbn.management.objects.objectsTable.flyout.importFailedDescription": "{totalImportCount} 個中 {failedImportCount} 個のオブジェクトのインポートに失敗しました。インポート失敗", - "kbn.management.objects.objectsTable.flyout.importFailedMissingReference": "{type} [id={id}] は {refType} [id={refId}] を見つけられませんでした", - "kbn.management.objects.objectsTable.flyout.importFailedTitle": "インポート失敗", - "kbn.management.objects.objectsTable.flyout.importFailedUnsupportedType": "{type} [id={id}] サポートされていないタイプ", - "kbn.management.objects.objectsTable.flyout.importFileErrorMessage": "ファイルを処理できませんでした。", - "kbn.management.objects.objectsTable.flyout.importLegacyFileErrorMessage": "ファイルを処理できませんでした。", - "kbn.management.objects.objectsTable.flyout.importPromptText": "インポート", - "kbn.management.objects.objectsTable.flyout.importSavedObjectTitle": "保存されたオブジェクトのインポート", - "kbn.management.objects.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel": "すべての変更を確定", - "kbn.management.objects.objectsTable.flyout.importSuccessful.confirmButtonLabel": "完了", - "kbn.management.objects.objectsTable.flyout.importSuccessfulCallout.noObjectsImportedTitle": "オブジェクトがインポートされませんでした", - "kbn.management.objects.objectsTable.flyout.importSuccessfulDescription": "{importCount} 個のオブジェクトがインポートされました。", - "kbn.management.objects.objectsTable.flyout.importSuccessfulTitle": "インポート成功", - "kbn.management.objects.objectsTable.flyout.indexPatternConflictsCalloutLinkText": "新規インデックスパターンを作成", - "kbn.management.objects.objectsTable.flyout.indexPatternConflictsDescription": "次の保存されたオブジェクトは、存在しないインデックスパターンを使用しています。別のデックスパターンを選択してください。必要に応じて {indexPatternLink} できます。", - "kbn.management.objects.objectsTable.flyout.indexPatternConflictsTitle": "インデックスパターンの矛盾", - "kbn.management.objects.objectsTable.flyout.invalidFormatOfImportedFileErrorMessage": "保存されたオブジェクトのファイル形式が無効なため、インポートできません。", - "kbn.management.objects.objectsTable.flyout.legacyFileUsedBody": "最新のレポートで NDJSON ファイルを作成すれば完了です。", - "kbn.management.objects.objectsTable.flyout.legacyFileUsedTitle": "JSON ファイルのサポートが終了します", - "kbn.management.objects.objectsTable.flyout.overwriteSavedObjectsLabel": "すべての保存されたオブジェクトを自動的に上書きしますか？", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnCountDescription": "影響されるオブジェクトの数です", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnCountName": "カウント", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnIdDescription": "インデックスパターンの ID です", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnIdName": "ID", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnNewIndexPatternName": "新規インデックスパターン", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsDescription": "影響されるオブジェクトのサンプルです", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsName": "影響されるオブジェクトのサンプル", - "kbn.management.objects.objectsTable.flyout.resolveImportErrorsFileErrorMessage": "ファイルを処理できませんでした。", - "kbn.management.objects.objectsTable.flyout.selectFileToImportFormRowLabel": "インポートするファイルを選択してください", - "kbn.management.objects.objectsTable.header.exportButtonLabel": "{filteredCount, plural, one{# オブジェクト} other {# オブジェクト}}をエクスポート", - "kbn.management.objects.objectsTable.header.importButtonLabel": "インポート", - "kbn.management.objects.objectsTable.header.refreshButtonLabel": "更新", - "kbn.management.objects.objectsTable.header.savedObjectsTitle": "保存されたオブジェクト", - "kbn.management.objects.objectsTable.howToDeleteSavedObjectsDescription": "ここから保存された検索などの保存されたオブジェクトを削除できます。保存されたオブジェクトの生データを編集することもできます。通常、オブジェクトは関連アプリケーションでのみ編集され、こｎ画面で編集するよりもそちらのほうが賢明です。", - "kbn.management.objects.objectsTable.relationships.columnActions.inspectActionDescription": "この保存されたオブジェクトを確認してください", - "kbn.management.objects.objectsTable.relationships.columnActions.inspectActionName": "検査", - "kbn.management.objects.objectsTable.relationships.columnActionsName": "アクション", - "kbn.management.objects.objectsTable.relationships.columnRelationship.childAsValue": "子", - "kbn.management.objects.objectsTable.relationships.columnRelationship.parentAsValue": "ペアレント", - "kbn.management.objects.objectsTable.relationships.columnRelationshipName": "直接関係", - "kbn.management.objects.objectsTable.relationships.columnTitleDescription": "保存されたオブジェクトのタイトルです", - "kbn.management.objects.objectsTable.relationships.columnTitleName": "タイトル", - "kbn.management.objects.objectsTable.relationships.columnTypeDescription": "保存されたオブジェクトのタイプです", - "kbn.management.objects.objectsTable.relationships.columnTypeName": "タイプ", - "kbn.management.objects.objectsTable.relationships.relationshipsTitle": "{title} に関連する保存されたオブジェクトはこちらです。この {type} を削除すると、親オブジェクトに影響がありますが、子オブジェクトには影響はありません。", - "kbn.management.objects.objectsTable.relationships.renderErrorMessage": "エラー", - "kbn.management.objects.objectsTable.relationships.search.filters.relationship.childAsValue.view": "子", - "kbn.management.objects.objectsTable.relationships.search.filters.relationship.name": "直接関係", - "kbn.management.objects.objectsTable.relationships.search.filters.relationship.parentAsValue.view": "親", - "kbn.management.objects.objectsTable.relationships.search.filters.type.name": "タイプ", - "kbn.management.objects.objectsTable.searchBar.unableToParseQueryErrorMessage": "クエリをパースできません", - "kbn.management.objects.objectsTable.table.columnActions.inspectActionDescription": "この保存されたオブジェクトを確認してください", - "kbn.management.objects.objectsTable.table.columnActions.inspectActionName": "検査", - "kbn.management.objects.objectsTable.table.columnActions.viewRelationshipsActionDescription": "この保存されたオブジェクトと他の保存されたオブジェクトとの関係性を表示します", - "kbn.management.objects.objectsTable.table.columnActions.viewRelationshipsActionName": "関係性", - "kbn.management.objects.objectsTable.table.columnActionsName": "アクション", - "kbn.management.objects.objectsTable.table.columnTitleDescription": "保存されたオブジェクトのタイトルです", - "kbn.management.objects.objectsTable.table.columnTitleName": "タイトル", - "kbn.management.objects.objectsTable.table.columnTypeDescription": "保存されたオブジェクトのタイプです", - "kbn.management.objects.objectsTable.table.columnTypeName": "タイプ", - "kbn.management.objects.objectsTable.table.deleteButtonLabel": "削除", - "kbn.management.objects.objectsTable.table.deleteButtonTitle": "保存されたオブジェクトを削除できません", - "kbn.management.objects.objectsTable.table.exportButtonLabel": "エクスポート", - "kbn.management.objects.objectsTable.table.exportPopoverButtonLabel": "エクスポート", - "kbn.management.objects.objectsTable.table.typeFilterName": "タイプ", - "kbn.management.objects.objectsTable.unableFindSavedObjectsNotificationMessage": "保存されたオブジェクトが見つかりません", - "kbn.management.objects.parsingFieldErrorMessage": "{fieldName} をインデックスパターン {indexName} 用にパース中にエラーが発生しました: {errorMessage}", - "kbn.management.objects.savedObjectsSectionLabel": "保存されたオブジェクト", - "kbn.management.objects.view.cancelButtonAriaLabel": "キャンセル", - "kbn.management.objects.view.cancelButtonLabel": "キャンセル", - "kbn.management.objects.view.deleteItemButtonLabel": "{title} を削除", - "kbn.management.objects.view.editItemTitle": "{title} の編集", - "kbn.management.objects.view.fieldDoesNotExistErrorMessage": "このオブジェクトに関連付けられたフィールドは、現在このインデックスパターンに存在しません。", - "kbn.management.objects.view.howToFixErrorDescription": "このエラーの原因がわかる場合は修正してください。わからない場合は上の削除ボタンをクリックしてください。", - "kbn.management.objects.view.howToModifyObjectDescription": "オブジェクトの編集は上級ユーザー向けです。オブジェクトのプロパティが検証されておらず、無効なオブジェクトはエラー、データ損失、またはそれ以上の問題の原因となります。コードを熟知した人に指示されていない限り、この設定は変更しない方が無難です。", - "kbn.management.objects.view.howToModifyObjectTitle": "十分ご注意ください！", - "kbn.management.objects.view.indexPatternDoesNotExistErrorMessage": "このオブジェクトに関連付けられたインデックスパターンは現在存在しません。", - "kbn.management.objects.view.saveButtonAriaLabel": "{ title } オブジェクトを保存", - "kbn.management.objects.view.saveButtonLabel": "{ title } オブジェクトを保存", - "kbn.management.objects.view.savedObjectProblemErrorMessage": "この保存されたオブジェクトに問題があります", - "kbn.management.objects.view.savedSearchDoesNotExistErrorMessage": "このオブジェクトに関連付けられた保存された検索は現在存在しません。", - "kbn.management.objects.view.viewItemButtonLabel": "{title} を表示", - "kbn.management.objects.view.viewItemTitle": "{title} を表示", - "kbn.management.savedObjects.editBreadcrumb": "{savedObjectType} を編集", - "kbn.management.savedObjects.indexBreadcrumb": "保存されたオブジェクト", + "kbn.management.landing.text": "すべてのツールの一覧は、左のメニューにあります。", + "savedObjectsManagement.indexPattern.confirmOverwriteButton": "上書き", + "savedObjectsManagement.indexPattern.confirmOverwriteLabel": "「{title}」に上書きしてよろしいですか？", + "savedObjectsManagement.indexPattern.confirmOverwriteTitle": "{type} を上書きしますか？", + "savedObjectsManagement.deleteConfirm.modalDeleteButtonLabel": "削除", + "savedObjectsManagement.deleteConfirm.modalDescription": "このアクションはオブジェクトを Kibana から永久に削除します。", + "savedObjectsManagement.deleteConfirm.modalTitle": "「{title}」を削除しますか？", + "savedObjectsManagement.deleteSavedObjectsConfirmModalDescription": "この操作は次の保存されたオブジェクトを削除します:", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel": "キャンセル", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel": "削除", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteProcessButtonLabel": "削除中…", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.idColumnName": "ID", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.titleColumnName": "タイトル", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.typeColumnName": "タイプ", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModalTitle": "保存されたオブジェクトの削除", + "savedObjectsManagement.objectsTable.export.dangerNotification": "エクスポートを生成できません", + "savedObjectsManagement.objectsTable.export.successNotification": "ファイルはバックグラウンドでダウンロード中です", + "savedObjectsManagement.objectsTable.export.successWithMissingRefsNotification": "ファイルはバックグラウンドでダウンロード中です。一部の関連オブジェクトが見つかりませんでした。足りないオブジェクトの一覧は、エクスポートされたファイルの最後の行をご覧ください。", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.cancelButtonLabel": "キャンセル", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel": "すべてエクスポート:", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportOptionsLabel": "オプション", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel": "関連オブジェクトを含める", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModalDescription": "エクスポートするタイプを選択してください", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModalTitle": "{filteredItemCount, plural, one{# オブジェクト} other {# オブジェクト}}をエクスポート", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.resolvingConflictsLoadingMessage": "矛盾を解決中…", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.retryingFailedObjectsLoadingMessage": "失敗したオブジェクトを再試行中…", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.savedSearchAreLinkedProperlyLoadingMessage": "保存された検索が正しくリンクされていることを確認してください…", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.savingConflictsLoadingMessage": "矛盾を保存中…", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteBody": "{title} を上書きしてよろしいですか？", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteCancelButtonText": "キャンセル", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteOverwriteButtonText": "上書き", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteTitle": "{type} を上書きしますか？", + "savedObjectsManagement.objectsTable.flyout.errorCalloutTitle": "申し訳ございませんが、エラーが発生しました", + "savedObjectsManagement.objectsTable.flyout.import.cancelButtonLabel": "キャンセル", + "savedObjectsManagement.objectsTable.flyout.import.confirmButtonLabel": "インポート", + "savedObjectsManagement.objectsTable.flyout.importFailedDescription": "{totalImportCount} 個中 {failedImportCount} 個のオブジェクトのインポートに失敗しました。インポート失敗", + "savedObjectsManagement.objectsTable.flyout.importFailedMissingReference": "{type} [id={id}] は {refType} [id={refId}] を見つけられませんでした", + "savedObjectsManagement.objectsTable.flyout.importFailedTitle": "インポート失敗", + "savedObjectsManagement.objectsTable.flyout.importFailedUnsupportedType": "{type} [id={id}] サポートされていないタイプ", + "savedObjectsManagement.objectsTable.flyout.importFileErrorMessage": "ファイルを処理できませんでした。", + "savedObjectsManagement.objectsTable.flyout.importLegacyFileErrorMessage": "ファイルを処理できませんでした。", + "savedObjectsManagement.objectsTable.flyout.importPromptText": "インポート", + "savedObjectsManagement.objectsTable.flyout.importSavedObjectTitle": "保存されたオブジェクトのインポート", + "savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel": "すべての変更を確定", + "savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmButtonLabel": "完了", + "savedObjectsManagement.objectsTable.flyout.importSuccessfulCallout.noObjectsImportedTitle": "オブジェクトがインポートされませんでした", + "savedObjectsManagement.objectsTable.flyout.importSuccessfulDescription": "{importCount} 個のオブジェクトがインポートされました。", + "savedObjectsManagement.objectsTable.flyout.importSuccessfulTitle": "インポート成功", + "savedObjectsManagement.objectsTable.flyout.indexPatternConflictsCalloutLinkText": "新規インデックスパターンを作成", + "savedObjectsManagement.objectsTable.flyout.indexPatternConflictsDescription": "次の保存されたオブジェクトは、存在しないインデックスパターンを使用しています。別のデックスパターンを選択してください。必要に応じて {indexPatternLink} できます。", + "savedObjectsManagement.objectsTable.flyout.indexPatternConflictsTitle": "インデックスパターンの矛盾", + "savedObjectsManagement.objectsTable.flyout.invalidFormatOfImportedFileErrorMessage": "保存されたオブジェクトのファイル形式が無効なため、インポートできません。", + "savedObjectsManagement.objectsTable.flyout.legacyFileUsedBody": "最新のレポートで NDJSON ファイルを作成すれば完了です。", + "savedObjectsManagement.objectsTable.flyout.legacyFileUsedTitle": "JSON ファイルのサポートが終了します", + "savedObjectsManagement.objectsTable.flyout.overwriteSavedObjectsLabel": "すべての保存されたオブジェクトを自動的に上書きしますか？", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnCountDescription": "影響されるオブジェクトの数です", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnCountName": "カウント", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnIdDescription": "インデックスパターンの ID です", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnIdName": "ID", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnNewIndexPatternName": "新規インデックスパターン", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsDescription": "影響されるオブジェクトのサンプルです", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsName": "影響されるオブジェクトのサンプル", + "savedObjectsManagement.objectsTable.flyout.resolveImportErrorsFileErrorMessage": "ファイルを処理できませんでした。", + "savedObjectsManagement.objectsTable.flyout.selectFileToImportFormRowLabel": "インポートするファイルを選択してください", + "savedObjectsManagement.objectsTable.header.exportButtonLabel": "{filteredCount, plural, one{# オブジェクト} other {# オブジェクト}}をエクスポート", + "savedObjectsManagement.objectsTable.header.importButtonLabel": "インポート", + "savedObjectsManagement.objectsTable.header.refreshButtonLabel": "更新", + "savedObjectsManagement.objectsTable.header.savedObjectsTitle": "保存されたオブジェクト", + "savedObjectsManagement.objectsTable.howToDeleteSavedObjectsDescription": "ここから保存された検索などの保存されたオブジェクトを削除できます。保存されたオブジェクトの生データを編集することもできます。通常、オブジェクトは関連アプリケーションでのみ編集され、こｎ画面で編集するよりもそちらのほうが賢明です。", + "savedObjectsManagement.objectsTable.relationships.columnActions.inspectActionDescription": "この保存されたオブジェクトを確認してください", + "savedObjectsManagement.objectsTable.relationships.columnActions.inspectActionName": "検査", + "savedObjectsManagement.objectsTable.relationships.columnActionsName": "アクション", + "savedObjectsManagement.objectsTable.relationships.columnRelationship.childAsValue": "子", + "savedObjectsManagement.objectsTable.relationships.columnRelationship.parentAsValue": "ペアレント", + "savedObjectsManagement.objectsTable.relationships.columnRelationshipName": "直接関係", + "savedObjectsManagement.objectsTable.relationships.columnTitleDescription": "保存されたオブジェクトのタイトルです", + "savedObjectsManagement.objectsTable.relationships.columnTitleName": "タイトル", + "savedObjectsManagement.objectsTable.relationships.columnTypeDescription": "保存されたオブジェクトのタイプです", + "savedObjectsManagement.objectsTable.relationships.columnTypeName": "タイプ", + "savedObjectsManagement.objectsTable.relationships.relationshipsTitle": "{title} に関連する保存されたオブジェクトはこちらです。この {type} を削除すると、親オブジェクトに影響がありますが、子オブジェクトには影響はありません。", + "savedObjectsManagement.objectsTable.relationships.renderErrorMessage": "エラー", + "savedObjectsManagement.objectsTable.relationships.search.filters.relationship.childAsValue.view": "子", + "savedObjectsManagement.objectsTable.relationships.search.filters.relationship.name": "直接関係", + "savedObjectsManagement.objectsTable.relationships.search.filters.relationship.parentAsValue.view": "親", + "savedObjectsManagement.objectsTable.relationships.search.filters.type.name": "タイプ", + "savedObjectsManagement.objectsTable.searchBar.unableToParseQueryErrorMessage": "クエリをパースできません", + "savedObjectsManagement.objectsTable.table.columnActions.inspectActionDescription": "この保存されたオブジェクトを確認してください", + "savedObjectsManagement.objectsTable.table.columnActions.inspectActionName": "検査", + "savedObjectsManagement.objectsTable.table.columnActions.viewRelationshipsActionDescription": "この保存されたオブジェクトと他の保存されたオブジェクトとの関係性を表示します", + "savedObjectsManagement.objectsTable.table.columnActions.viewRelationshipsActionName": "関係性", + "savedObjectsManagement.objectsTable.table.columnActionsName": "アクション", + "savedObjectsManagement.objectsTable.table.columnTitleDescription": "保存されたオブジェクトのタイトルです", + "savedObjectsManagement.objectsTable.table.columnTitleName": "タイトル", + "savedObjectsManagement.objectsTable.table.columnTypeDescription": "保存されたオブジェクトのタイプです", + "savedObjectsManagement.objectsTable.table.columnTypeName": "タイプ", + "savedObjectsManagement.objectsTable.table.deleteButtonLabel": "削除", + "savedObjectsManagement.objectsTable.table.deleteButtonTitle": "保存されたオブジェクトを削除できません", + "savedObjectsManagement.objectsTable.table.exportButtonLabel": "エクスポート", + "savedObjectsManagement.objectsTable.table.exportPopoverButtonLabel": "エクスポート", + "savedObjectsManagement.objectsTable.table.typeFilterName": "タイプ", + "savedObjectsManagement.objectsTable.unableFindSavedObjectsNotificationMessage": "保存されたオブジェクトが見つかりません", + "savedObjectsManagement.parsingFieldErrorMessage": "{fieldName} をインデックスパターン {indexName} 用にパース中にエラーが発生しました: {errorMessage}", + "savedObjectsManagement.managementSectionLabel": "保存されたオブジェクト", + "savedObjectsManagement.view.cancelButtonAriaLabel": "キャンセル", + "savedObjectsManagement.view.cancelButtonLabel": "キャンセル", + "savedObjectsManagement.view.deleteItemButtonLabel": "{title} を削除", + "savedObjectsManagement.view.editItemTitle": "{title} の編集", + "savedObjectsManagement.view.fieldDoesNotExistErrorMessage": "このオブジェクトに関連付けられたフィールドは、現在このインデックスパターンに存在しません。", + "savedObjectsManagement.view.howToFixErrorDescription": "このエラーの原因がわかる場合は修正してください。わからない場合は上の削除ボタンをクリックしてください。", + "savedObjectsManagement.view.howToModifyObjectDescription": " オブジェクトの編集は上級ユーザー向けです。オブジェクトのプロパティが検証されておらず、無効なオブジェクトはエラー、データ損失、またはそれ以上の問題の原因となります。コードを熟知した人に指示されていない限り、この設定は変更しない方が無難です。", + "savedObjectsManagement.view.howToModifyObjectTitle": "十分ご注意ください！", + "savedObjectsManagement.view.indexPatternDoesNotExistErrorMessage": "このオブジェクトに関連付けられたインデックスパターンは現在存在しません。", + "savedObjectsManagement.view.saveButtonAriaLabel": "{ title } オブジェクトを保存", + "savedObjectsManagement.view.saveButtonLabel": "{ title } オブジェクトを保存", + "savedObjectsManagement.view.savedObjectProblemErrorMessage": "この保存されたオブジェクトに問題があります", + "savedObjectsManagement.view.savedSearchDoesNotExistErrorMessage": "このオブジェクトに関連付けられた保存された検索は現在存在しません。", + "savedObjectsManagement.view.viewItemButtonLabel": "{title} を表示", + "savedObjectsManagement.view.viewItemTitle": "{title} を表示", + "savedObjectsManagement.breadcrumb.edit": "{savedObjectType} を編集", + "savedObjectsManagement.breadcrumb.index": "保存されたオブジェクト", + "savedObjectsManagement.field.offLabel": "オフ", + "savedObjectsManagement.field.onLabel": "オン", "kbn.managementTitle": "管理", "kbn.topNavMenu.openInspectorButtonLabel": "検査", "kbn.topNavMenu.refreshButtonLabel": "更新", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index fd2a92c2c402f..75f48fb11823a 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -2012,7 +2012,6 @@ "kbn.dashboard.listing.table.descriptionColumnName": "描述", "kbn.dashboard.panel.unableToMigratePanelDataForSixOneZeroErrorMessage": "无法迁移用于“6.1.0”向后兼容的面板数据，面板不包含所需的列和/或行字段", "kbn.dashboard.panel.unableToMigratePanelDataForSixThreeZeroErrorMessage": "无法迁移用于“6.3.0”向后兼容的面板数据，面板不包含预期字段：{key}", - "kbn.dashboard.savedDashboardsTitle": "仪表板", "kbn.dashboardTitle": "仪表板", "kbn.devToolsTitle": "开发工具", "kbn.discover.backToTopLinkText": "返至顶部。", @@ -2282,9 +2281,6 @@ "kbn.management.editIndexPattern.timeFilterLabel.mappingAPILink": "映射 API", "kbn.management.editIndexPattern.timeFilterLabel.timeFilterDetail": "此页根据 Elasticsearch 的记录列出“{indexPatternTitle}”索引中的每个字段以及字段的关联核心类型。要更改字段类型，请使用 Elasticsearch", "kbn.management.editIndexPatternLiveRegionAriaLabel": "索引模式", - "kbn.management.indexPattern.confirmOverwriteButton": "覆盖", - "kbn.management.indexPattern.confirmOverwriteLabel": "确定要覆盖 “{title}”？", - "kbn.management.indexPattern.confirmOverwriteTitle": "覆盖“{type}”？", "kbn.management.indexPattern.goToPatternButtonLabel": "前往现有模式", "kbn.management.indexPattern.sectionsHeader": "索引模式", "kbn.management.indexPattern.titleExistsLabel": "具有标题 “{title}” 的索引模式已存在。", @@ -2308,124 +2304,127 @@ "kbn.management.landing.header": "Kibana {version} 管理", "kbn.management.landing.subhead": "管理您的索引、索引模式、已保存对象、Kibana 设置等等。", "kbn.management.landing.text": "应用的完整列表位于左侧菜单中。", - "kbn.management.objects.confirmModalOptions.deleteButtonLabel": "删除", - "kbn.management.objects.confirmModalOptions.modalDescription": "此操作会将对象从 Kibana 永久移除。", - "kbn.management.objects.confirmModalOptions.modalTitle": "删除“{title}”？", - "kbn.management.objects.deleteSavedObjectsConfirmModalDescription": "此操作将删除以下已保存对象：", - "kbn.management.objects.field.offLabel": "关闭", - "kbn.management.objects.field.onLabel": "开启", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel": "取消", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel": "删除", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.deleteProcessButtonLabel": "正在删除……", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.idColumnName": "ID", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.titleColumnName": "标题", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModal.typeColumnName": "类型", - "kbn.management.objects.objectsTable.deleteSavedObjectsConfirmModalTitle": "删除已保存对象", - "kbn.management.objects.objectsTable.export.dangerNotification": "无法生成报告", - "kbn.management.objects.objectsTable.export.successNotification": "您的文件正在后台下载", - "kbn.management.objects.objectsTable.export.successWithMissingRefsNotification": "您的文件正在后台下载。找不到某些相关对象。有关缺失对象列表，请查看导出文件的最后一行。", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.cancelButtonLabel": "取消", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel": "全部导出", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.exportOptionsLabel": "选项", - "kbn.management.objects.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel": "包括相关对象", - "kbn.management.objects.objectsTable.exportObjectsConfirmModalDescription": "选择要导出的类型。", - "kbn.management.objects.objectsTable.exportObjectsConfirmModalTitle": "导出 {filteredItemCount, plural, one{# 个对象} other {# 个对象}}", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.resolvingConflictsLoadingMessage": "正在解决冲突……", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.retryingFailedObjectsLoadingMessage": "正在重试失败的对象……", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.savedSearchAreLinkedProperlyLoadingMessage": "确保已保存搜索已正确链接……", - "kbn.management.objects.objectsTable.flyout.confirmLegacyImport.savingConflictsLoadingMessage": "正在保存冲突……", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteBody": "确定要覆盖 “{title}”？", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteCancelButtonText": "取消", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteOverwriteButtonText": "覆盖", - "kbn.management.objects.objectsTable.flyout.confirmOverwriteTitle": "覆盖“{type}”？", - "kbn.management.objects.objectsTable.flyout.errorCalloutTitle": "抱歉，出现了错误", - "kbn.management.objects.objectsTable.flyout.import.cancelButtonLabel": "取消", - "kbn.management.objects.objectsTable.flyout.import.confirmButtonLabel": "导入", - "kbn.management.objects.objectsTable.flyout.importFailedDescription": "无法导入 {failedImportCount} 个对象，共 {totalImportCount} 个。导入失败", - "kbn.management.objects.objectsTable.flyout.importFailedMissingReference": "{type} [id={id}] 无法找到 {refType} [id={refId}]", - "kbn.management.objects.objectsTable.flyout.importFailedTitle": "导入失败", - "kbn.management.objects.objectsTable.flyout.importFailedUnsupportedType": "{type} [id={id}] 不受支持的类型", - "kbn.management.objects.objectsTable.flyout.importFileErrorMessage": "无法处理该文件。", - "kbn.management.objects.objectsTable.flyout.importLegacyFileErrorMessage": "无法处理该文件。", - "kbn.management.objects.objectsTable.flyout.importPromptText": "导入", - "kbn.management.objects.objectsTable.flyout.importSavedObjectTitle": "导入已保存对象", - "kbn.management.objects.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel": "确认所有更改", - "kbn.management.objects.objectsTable.flyout.importSuccessful.confirmButtonLabel": "完成", - "kbn.management.objects.objectsTable.flyout.importSuccessfulCallout.noObjectsImportedTitle": "未导入任何对象", - "kbn.management.objects.objectsTable.flyout.importSuccessfulDescription": "已成功导入 {importCount} 个对象。", - "kbn.management.objects.objectsTable.flyout.importSuccessfulTitle": "导入成功", - "kbn.management.objects.objectsTable.flyout.indexPatternConflictsCalloutLinkText": "创建新的索引模式", - "kbn.management.objects.objectsTable.flyout.indexPatternConflictsDescription": "以下已保存对象使用不存在的索引模式。请选择要重新关联的索引模式。必要时，您可以{indexPatternLink}。", - "kbn.management.objects.objectsTable.flyout.indexPatternConflictsTitle": "索引模式冲突", - "kbn.management.objects.objectsTable.flyout.invalidFormatOfImportedFileErrorMessage": "已保存对象文件格式无效，无法导入。", - "kbn.management.objects.objectsTable.flyout.legacyFileUsedBody": "只需使用更新的导出功能生成 NDJSON 文件，便万事俱备。", - "kbn.management.objects.objectsTable.flyout.legacyFileUsedTitle": "将不再支持 JSON 文件", - "kbn.management.objects.objectsTable.flyout.overwriteSavedObjectsLabel": "自动覆盖所有已保存对象？", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnCountDescription": "受影响对象数目", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnCountName": "计数", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnIdDescription": "索引模式的 ID", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnIdName": "ID", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnNewIndexPatternName": "新建索引模式", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsDescription": "受影响对象样例", - "kbn.management.objects.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsName": "受影响对象样例", - "kbn.management.objects.objectsTable.flyout.resolveImportErrorsFileErrorMessage": "无法处理该文件。", - "kbn.management.objects.objectsTable.flyout.selectFileToImportFormRowLabel": "请选择要导入的文件", - "kbn.management.objects.objectsTable.header.exportButtonLabel": "导出 {filteredCount, plural, one{# 个对象} other {# 个对象}}", - "kbn.management.objects.objectsTable.header.importButtonLabel": "导入", - "kbn.management.objects.objectsTable.header.refreshButtonLabel": "刷新", - "kbn.management.objects.objectsTable.header.savedObjectsTitle": "已保存对象", - "kbn.management.objects.objectsTable.howToDeleteSavedObjectsDescription": "从这里您可以删除已保存对象，如已保存搜索。还可以编辑已保存对象的原始数据。通常，对象只能通过其关联的应用程序进行修改；或许您应该遵循这一原则，而非使用此屏幕进行修改。", - "kbn.management.objects.objectsTable.relationships.columnActions.inspectActionDescription": "检查此已保存对象", - "kbn.management.objects.objectsTable.relationships.columnActions.inspectActionName": "检查", - "kbn.management.objects.objectsTable.relationships.columnActionsName": "操作", - "kbn.management.objects.objectsTable.relationships.columnRelationship.childAsValue": "子项", - "kbn.management.objects.objectsTable.relationships.columnRelationship.parentAsValue": "父项", - "kbn.management.objects.objectsTable.relationships.columnRelationshipName": "直接关系", - "kbn.management.objects.objectsTable.relationships.columnTitleDescription": "已保存对象的标题", - "kbn.management.objects.objectsTable.relationships.columnTitleName": "标题", - "kbn.management.objects.objectsTable.relationships.columnTypeDescription": "已保存对象的类型", - "kbn.management.objects.objectsTable.relationships.columnTypeName": "类型", - "kbn.management.objects.objectsTable.relationships.relationshipsTitle": "以下是与 {title} 相关的已保存对象。删除此{type}将影响其父级对象，但不会影响其子级对象。", - "kbn.management.objects.objectsTable.relationships.renderErrorMessage": "错误", - "kbn.management.objects.objectsTable.relationships.search.filters.relationship.childAsValue.view": "子项", - "kbn.management.objects.objectsTable.relationships.search.filters.relationship.name": "直接关系", - "kbn.management.objects.objectsTable.relationships.search.filters.relationship.parentAsValue.view": "父项", - "kbn.management.objects.objectsTable.relationships.search.filters.type.name": "类型", - "kbn.management.objects.objectsTable.searchBar.unableToParseQueryErrorMessage": "无法解析查询", - "kbn.management.objects.objectsTable.table.columnActions.inspectActionDescription": "检查此已保存对象", - "kbn.management.objects.objectsTable.table.columnActions.inspectActionName": "检查", - "kbn.management.objects.objectsTable.table.columnActions.viewRelationshipsActionDescription": "查看此已保存对象与其他已保存对象的关系", - "kbn.management.objects.objectsTable.table.columnActions.viewRelationshipsActionName": "关系", - "kbn.management.objects.objectsTable.table.columnActionsName": "操作", - "kbn.management.objects.objectsTable.table.columnTitleDescription": "已保存对象的标题", - "kbn.management.objects.objectsTable.table.columnTitleName": "标题", - "kbn.management.objects.objectsTable.table.columnTypeDescription": "已保存对象的类型", - "kbn.management.objects.objectsTable.table.columnTypeName": "类型", - "kbn.management.objects.objectsTable.table.deleteButtonLabel": "删除", - "kbn.management.objects.objectsTable.table.deleteButtonTitle": "无法删除已保存对象", - "kbn.management.objects.objectsTable.table.exportButtonLabel": "导出", - "kbn.management.objects.objectsTable.table.exportPopoverButtonLabel": "导出", - "kbn.management.objects.objectsTable.table.typeFilterName": "类型", - "kbn.management.objects.objectsTable.unableFindSavedObjectsNotificationMessage": "找不到已保存对象", - "kbn.management.objects.parsingFieldErrorMessage": "为索引模式 “{indexName}” 解析 “{fieldName}” 时发生错误：{errorMessage}", - "kbn.management.objects.savedObjectsSectionLabel": "已保存对象", - "kbn.management.objects.view.cancelButtonAriaLabel": "取消", - "kbn.management.objects.view.cancelButtonLabel": "取消", - "kbn.management.objects.view.deleteItemButtonLabel": "删除“{title}”", - "kbn.management.objects.view.editItemTitle": "编辑“{title}", - "kbn.management.objects.view.fieldDoesNotExistErrorMessage": "与此对象关联的字段在该索引模式中已不存在。", - "kbn.management.objects.view.howToFixErrorDescription": "如果您清楚此错误的含义，请修复该错误 — 否则单击上面的删除按钮。", - "kbn.management.objects.view.howToModifyObjectDescription": "修改对象仅适用于高级用户。对象属性未得到验证，无效的对象可能会导致错误、数据丢失或更坏的情况发生。除非熟悉该代码的人让您来这里，否则您可能不应该来这里。", - "kbn.management.objects.view.howToModifyObjectTitle": "谨慎操作！", - "kbn.management.objects.view.indexPatternDoesNotExistErrorMessage": "与此对象关联的索引模式已不存在。", - "kbn.management.objects.view.saveButtonAriaLabel": "保存 { title } 对象", - "kbn.management.objects.view.saveButtonLabel": "保存 { title } 对象", - "kbn.management.objects.view.savedObjectProblemErrorMessage": "此已保存对象有问题", - "kbn.management.objects.view.savedSearchDoesNotExistErrorMessage": "与此对象关联的已保存搜索已不存在。", - "kbn.management.objects.view.viewItemButtonLabel": "查看“{title}”", - "kbn.management.objects.view.viewItemTitle": "查看“{title}”", - "kbn.management.savedObjects.editBreadcrumb": "编辑 {savedObjectType}", - "kbn.management.savedObjects.indexBreadcrumb": "已保存对象", + "savedObjectsManagement.indexPattern.confirmOverwriteButton": "覆盖", + "savedObjectsManagement.indexPattern.confirmOverwriteLabel": "确定要覆盖 “{title}”？", + "savedObjectsManagement.indexPattern.confirmOverwriteTitle": "覆盖“{type}”？", + "savedObjectsManagement.deleteConfirm.modalDeleteButtonLabel": "删除", + "savedObjectsManagement.deleteConfirm.modalDescription": "此操作会将对象从 Kibana 永久移除。", + "savedObjectsManagement.deleteConfirm.modalTitle": "删除“{title}”？", + "savedObjectsManagement.deleteSavedObjectsConfirmModalDescription": "此操作将删除以下已保存对象：", + "savedObjectsManagement.field.offLabel": "关闭", + "savedObjectsManagement.field.onLabel": "开启", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.cancelButtonLabel": "取消", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteButtonLabel": "删除", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.deleteProcessButtonLabel": "正在删除……", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.idColumnName": "ID", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.titleColumnName": "标题", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModal.typeColumnName": "类型", + "savedObjectsManagement.objectsTable.deleteSavedObjectsConfirmModalTitle": "删除已保存对象", + "savedObjectsManagement.objectsTable.export.dangerNotification": "无法生成报告", + "savedObjectsManagement.objectsTable.export.successNotification": "您的文件正在后台下载", + "savedObjectsManagement.objectsTable.export.successWithMissingRefsNotification": "您的文件正在后台下载。找不到某些相关对象。有关缺失对象列表，请查看导出文件的最后一行。", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.cancelButtonLabel": "取消", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportAllButtonLabel": "全部导出", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.exportOptionsLabel": "选项", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModal.includeReferencesDeepLabel": "包括相关对象", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModalDescription": "选择要导出的类型。", + "savedObjectsManagement.objectsTable.exportObjectsConfirmModalTitle": "导出 {filteredItemCount, plural, one{# 个对象} other {# 个对象}}", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.resolvingConflictsLoadingMessage": "正在解决冲突……", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.retryingFailedObjectsLoadingMessage": "正在重试失败的对象……", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.savedSearchAreLinkedProperlyLoadingMessage": "确保已保存搜索已正确链接……", + "savedObjectsManagement.objectsTable.flyout.confirmLegacyImport.savingConflictsLoadingMessage": "正在保存冲突……", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteBody": "确定要覆盖 “{title}”？", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteCancelButtonText": "取消", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteOverwriteButtonText": "覆盖", + "savedObjectsManagement.objectsTable.flyout.confirmOverwriteTitle": "覆盖“{type}”？", + "savedObjectsManagement.objectsTable.flyout.errorCalloutTitle": "抱歉，出现了错误", + "savedObjectsManagement.objectsTable.flyout.import.cancelButtonLabel": "取消", + "savedObjectsManagement.objectsTable.flyout.import.confirmButtonLabel": "导入", + "savedObjectsManagement.objectsTable.flyout.importFailedDescription": "无法导入 {failedImportCount} 个对象，共 {totalImportCount} 个。导入失败", + "savedObjectsManagement.objectsTable.flyout.importFailedMissingReference": "{type} [id={id}] 无法找到 {refType} [id={refId}]", + "savedObjectsManagement.objectsTable.flyout.importFailedTitle": "导入失败", + "savedObjectsManagement.objectsTable.flyout.importFailedUnsupportedType": "{type} [id={id}] 不受支持的类型", + "savedObjectsManagement.objectsTable.flyout.importFileErrorMessage": "无法处理该文件。", + "savedObjectsManagement.objectsTable.flyout.importLegacyFileErrorMessage": "无法处理该文件。", + "savedObjectsManagement.objectsTable.flyout.importPromptText": "导入", + "savedObjectsManagement.objectsTable.flyout.importSavedObjectTitle": "导入已保存对象", + "savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmAllChangesButtonLabel": "确认所有更改", + "savedObjectsManagement.objectsTable.flyout.importSuccessful.confirmButtonLabel": "完成", + "savedObjectsManagement.objectsTable.flyout.importSuccessfulCallout.noObjectsImportedTitle": "未导入任何对象", + "savedObjectsManagement.objectsTable.flyout.importSuccessfulDescription": "已成功导入 {importCount} 个对象。", + "savedObjectsManagement.objectsTable.flyout.importSuccessfulTitle": "导入成功", + "savedObjectsManagement.objectsTable.flyout.indexPatternConflictsCalloutLinkText": "创建新的索引模式", + "savedObjectsManagement.objectsTable.flyout.indexPatternConflictsDescription": "以下已保存对象使用不存在的索引模式。请选择要重新关联的索引模式。必要时，您可以{indexPatternLink}。", + "savedObjectsManagement.objectsTable.flyout.indexPatternConflictsTitle": "索引模式冲突", + "savedObjectsManagement.objectsTable.flyout.invalidFormatOfImportedFileErrorMessage": "已保存对象文件格式无效，无法导入。", + "savedObjectsManagement.objectsTable.flyout.legacyFileUsedBody": "只需使用更新的导出功能生成 NDJSON 文件，便万事俱备。", + "savedObjectsManagement.objectsTable.flyout.legacyFileUsedTitle": "将不再支持 JSON 文件", + "savedObjectsManagement.objectsTable.flyout.overwriteSavedObjectsLabel": "自动覆盖所有已保存对象？", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnCountDescription": "受影响对象数目", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnCountName": "计数", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnIdDescription": "索引模式的 ID", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnIdName": "ID", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnNewIndexPatternName": "新建索引模式", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsDescription": "受影响对象样例", + "savedObjectsManagement.objectsTable.flyout.renderConflicts.columnSampleOfAffectedObjectsName": "受影响对象样例", + "savedObjectsManagement.objectsTable.flyout.resolveImportErrorsFileErrorMessage": "无法处理该文件。", + "savedObjectsManagement.objectsTable.flyout.selectFileToImportFormRowLabel": "请选择要导入的文件", + "savedObjectsManagement.objectsTable.header.exportButtonLabel": "导出 {filteredCount, plural, one{# 个对象} other {# 个对象}}", + "savedObjectsManagement.objectsTable.header.importButtonLabel": "导入", + "savedObjectsManagement.objectsTable.header.refreshButtonLabel": "刷新", + "savedObjectsManagement.objectsTable.header.savedObjectsTitle": "已保存对象", + "savedObjectsManagement.objectsTable.howToDeleteSavedObjectsDescription": "从这里您可以删除已保存对象，如已保存搜索。还可以编辑已保存对象的原始数据。通常，对象只能通过其关联的应用程序进行修改；或许您应该遵循这一原则，而非使用此屏幕进行修改。", + "savedObjectsManagement.objectsTable.relationships.columnActions.inspectActionDescription": "检查此已保存对象", + "savedObjectsManagement.objectsTable.relationships.columnActions.inspectActionName": "检查", + "savedObjectsManagement.objectsTable.relationships.columnActionsName": "操作", + "savedObjectsManagement.objectsTable.relationships.columnRelationship.childAsValue": "子项", + "savedObjectsManagement.objectsTable.relationships.columnRelationship.parentAsValue": "父项", + "savedObjectsManagement.objectsTable.relationships.columnRelationshipName": "直接关系", + "savedObjectsManagement.objectsTable.relationships.columnTitleDescription": "已保存对象的标题", + "savedObjectsManagement.objectsTable.relationships.columnTitleName": "标题", + "savedObjectsManagement.objectsTable.relationships.columnTypeDescription": "已保存对象的类型", + "savedObjectsManagement.objectsTable.relationships.columnTypeName": "类型", + "savedObjectsManagement.objectsTable.relationships.relationshipsTitle": "以下是与 {title} 相关的已保存对象。删除此{type}将影响其父级对象，但不会影响其子级对象。", + "savedObjectsManagement.objectsTable.relationships.renderErrorMessage": "错误", + "savedObjectsManagement.objectsTable.relationships.search.filters.relationship.childAsValue.view": "子项", + "savedObjectsManagement.objectsTable.relationships.search.filters.relationship.name": "直接关系", + "savedObjectsManagement.objectsTable.relationships.search.filters.relationship.parentAsValue.view": "父项", + "savedObjectsManagement.objectsTable.relationships.search.filters.type.name": "类型", + "savedObjectsManagement.objectsTable.searchBar.unableToParseQueryErrorMessage": "无法解析查询", + "savedObjectsManagement.objectsTable.table.columnActions.inspectActionDescription": "检查此已保存对象", + "savedObjectsManagement.objectsTable.table.columnActions.inspectActionName": "检查", + "savedObjectsManagement.objectsTable.table.columnActions.viewRelationshipsActionDescription": "查看此已保存对象与其他已保存对象的关系", + "savedObjectsManagement.objectsTable.table.columnActions.viewRelationshipsActionName": "关系", + "savedObjectsManagement.objectsTable.table.columnActionsName": "操作", + "savedObjectsManagement.objectsTable.table.columnTitleDescription": "已保存对象的标题", + "savedObjectsManagement.objectsTable.table.columnTitleName": "标题", + "savedObjectsManagement.objectsTable.table.columnTypeDescription": "已保存对象的类型", + "savedObjectsManagement.objectsTable.table.columnTypeName": "类型", + "savedObjectsManagement.objectsTable.table.deleteButtonLabel": "删除", + "savedObjectsManagement.objectsTable.table.deleteButtonTitle": "无法删除已保存对象", + "savedObjectsManagement.objectsTable.table.exportButtonLabel": "导出", + "savedObjectsManagement.objectsTable.table.exportPopoverButtonLabel": "导出", + "savedObjectsManagement.objectsTable.table.typeFilterName": "类型", + "savedObjectsManagement.objectsTable.unableFindSavedObjectsNotificationMessage": "找不到已保存对象", + "savedObjectsManagement.parsingFieldErrorMessage": "为索引模式 “{indexName}” 解析 “{fieldName}” 时发生错误：{errorMessage}", + "savedObjectsManagement.managementSectionLabel": "已保存对象", + "savedObjectsManagement.view.cancelButtonAriaLabel": "取消", + "savedObjectsManagement.view.cancelButtonLabel": "取消", + "savedObjectsManagement.view.deleteItemButtonLabel": "删除“{title}”", + "savedObjectsManagement.view.editItemTitle": "编辑“{title}", + "savedObjectsManagement.view.fieldDoesNotExistErrorMessage": "与此对象关联的字段在该索引模式中已不存在。", + "savedObjectsManagement.view.howToFixErrorDescription": "如果您清楚此错误的含义，请修复该错误 — 否则单击上面的删除按钮。", + "savedObjectsManagement.view.howToModifyObjectDescription": " 修改对象仅适用于高级用户。对象属性未得到验证，无效的对象可能会导致错误、数据丢失或更坏的情况发生。除非熟悉该代码的人让您来这里，否则您可能不应该来这里。", + "savedObjectsManagement.view.howToModifyObjectTitle": "谨慎操作！", + "savedObjectsManagement.view.indexPatternDoesNotExistErrorMessage": "与此对象关联的索引模式已不存在。", + "savedObjectsManagement.view.saveButtonAriaLabel": "保存 { title } 对象", + "savedObjectsManagement.view.saveButtonLabel": "保存 { title } 对象", + "savedObjectsManagement.view.savedObjectProblemErrorMessage": "此已保存对象有问题", + "savedObjectsManagement.view.savedSearchDoesNotExistErrorMessage": "与此对象关联的已保存搜索已不存在。", + "savedObjectsManagement.view.viewItemButtonLabel": "查看“{title}”", + "savedObjectsManagement.view.viewItemTitle": "查看“{title}”", + "savedObjectsManagement.breadcrumb.edit": "编辑 {savedObjectType}", + "savedObjectsManagement.breadcrumb.index": "已保存对象", "kbn.managementTitle": "管理", "kbn.topNavMenu.openInspectorButtonLabel": "检查", "kbn.topNavMenu.refreshButtonLabel": "刷新", From 61271c0652a8393f9af6972a46b31759d8b81c7d Mon Sep 17 00:00:00 2001 From: Shahzad <shahzad.muhammad@elastic.co> Date: Mon, 13 Apr 2020 13:44:10 +0200 Subject: [PATCH 050/102] [Uptime] Simplify monitor param usage (#63121) * add useMonitorId hook * update url param hook * update type Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../connected/charts/monitor_duration.tsx | 5 ++-- .../connected/charts/ping_histogram.tsx | 5 ++-- .../connected/charts/snapshot_container.tsx | 5 ++-- .../monitor/list_drawer_container.tsx | 5 ++-- .../monitor/status_bar_container.tsx | 5 ++-- .../monitor/status_details_container.tsx | 5 ++-- .../monitor_list_drawer/most_recent_error.tsx | 5 ++-- .../monitor_details/ml/manage_ml_job.tsx | 10 +++---- .../ml/ml_flyout_container.tsx | 10 +++---- .../monitor_details/ml/ml_integeration.tsx | 6 ++--- .../contexts/uptime_settings_context.tsx | 6 ++--- .../hooks/__tests__/use_url_params.test.tsx | 3 ++- .../uptime/public/hooks/use_monitor.ts | 14 ++++++++++ .../uptime/public/hooks/use_telemetry.ts | 10 ++++--- .../uptime/public/hooks/use_url_params.ts | 27 +++++++++---------- .../plugins/uptime/public/pages/monitor.tsx | 6 ++--- .../plugins/uptime/public/pages/overview.tsx | 5 ++-- 17 files changed, 66 insertions(+), 66 deletions(-) create mode 100644 x-pack/legacy/plugins/uptime/public/hooks/use_monitor.ts diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/charts/monitor_duration.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/charts/monitor_duration.tsx index 7d1cb08cb8b1c..40480905350af 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/charts/monitor_duration.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/charts/monitor_duration.tsx @@ -6,7 +6,7 @@ import React, { useContext, useEffect } from 'react'; import { useDispatch, useSelector } from 'react-redux'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; import { getAnomalyRecordsAction, getMLCapabilitiesAction, @@ -28,13 +28,12 @@ interface Props { } export const DurationChart: React.FC<Props> = ({ monitorId }: Props) => { - const [getUrlParams] = useUrlParams(); const { dateRangeStart, dateRangeEnd, absoluteDateRangeStart, absoluteDateRangeEnd, - } = getUrlParams(); + } = useGetUrlParams(); const { durationLines, loading } = useSelector(selectDurationLines); diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx index 50f91be4ff09f..6428ddfd10f8c 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx @@ -15,7 +15,7 @@ import { getPingHistogram } from '../../../state/actions'; import { selectPingHistogram } from '../../../state/selectors'; import { withResponsiveWrapper, ResponsiveWrapperProps } from '../../higher_order'; import { GetPingHistogramParams, HistogramResult } from '../../../../common/types'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; type Props = ResponsiveWrapperProps & Pick<PingHistogramComponentProps, 'height' | 'data' | 'loading'> & @@ -30,14 +30,13 @@ const PingHistogramContainer: React.FC<Props> = ({ loading, esKuery, }) => { - const [getUrlParams] = useUrlParams(); const { absoluteDateRangeStart, absoluteDateRangeEnd, dateRangeStart: dateStart, dateRangeEnd: dateEnd, statusFilter, - } = getUrlParams(); + } = useGetUrlParams(); useEffect(() => { loadData({ monitorId, dateStart, dateEnd, statusFilter, filters: esKuery }); diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/charts/snapshot_container.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/charts/snapshot_container.tsx index ac8ff13d1edce..39ead242527f8 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/charts/snapshot_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/charts/snapshot_container.tsx @@ -6,7 +6,7 @@ import React, { useEffect } from 'react'; import { connect } from 'react-redux'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; import { AppState } from '../../../state'; import { getSnapshotCountAction } from '../../../state/actions'; import { SnapshotComponent } from '../../functional/snapshot'; @@ -54,8 +54,7 @@ export const Container: React.FC<Props> = ({ esKuery, loadSnapshotCount, }: Props) => { - const [getUrlParams] = useUrlParams(); - const { dateRangeStart, dateRangeEnd, statusFilter } = getUrlParams(); + const { dateRangeStart, dateRangeEnd, statusFilter } = useGetUrlParams(); useEffect(() => { loadSnapshotCount({ dateRangeStart, dateRangeEnd, filters: esKuery, statusFilter }); diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/list_drawer_container.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/list_drawer_container.tsx index ceeaa7026059f..70da62d5833af 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/list_drawer_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/list_drawer_container.tsx @@ -11,7 +11,7 @@ import { monitorDetailsSelector } from '../../../state/selectors'; import { MonitorDetailsActionPayload } from '../../../state/actions/types'; import { getMonitorDetailsAction } from '../../../state/actions/monitor'; import { MonitorListDrawerComponent } from '../../functional/monitor_list/monitor_list_drawer/monitor_list_drawer'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; import { MonitorSummary } from '../../../../common/graphql/types'; import { MonitorDetails } from '../../../../common/runtime_types/monitor'; @@ -24,8 +24,7 @@ interface ContainerProps { const Container: React.FC<ContainerProps> = ({ summary, loadMonitorDetails, monitorDetails }) => { const monitorId = summary?.monitor_id; - const [getUrlParams] = useUrlParams(); - const { dateRangeStart: dateStart, dateRangeEnd: dateEnd } = getUrlParams(); + const { dateRangeStart: dateStart, dateRangeEnd: dateEnd } = useGetUrlParams(); useEffect(() => { loadMonitorDetails({ diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx index dd6f7a89cf9a3..00cfd02d8dc32 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx @@ -11,7 +11,7 @@ import { AppState } from '../../../state'; import { monitorLocationsSelector, monitorStatusSelector } from '../../../state/selectors'; import { MonitorStatusBarComponent } from '../../functional/monitor_status_details/monitor_status_bar'; import { getMonitorStatusAction } from '../../../state/actions'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; import { Ping } from '../../../../common/graphql/types'; import { MonitorLocations } from '../../../../common/runtime_types/monitor'; import { UptimeRefreshContext } from '../../../contexts'; @@ -39,8 +39,7 @@ const Container: React.FC<Props> = ({ }: Props) => { const { lastRefresh } = useContext(UptimeRefreshContext); - const [getUrlParams] = useUrlParams(); - const { dateRangeStart: dateStart, dateRangeEnd: dateEnd } = getUrlParams(); + const { dateRangeStart: dateStart, dateRangeEnd: dateEnd } = useGetUrlParams(); useEffect(() => { loadMonitorStatus({ dateStart, dateEnd, monitorId }); diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_details_container.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_details_container.tsx index 3ced251dfab8c..9d2e48830fbfe 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_details_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_details_container.tsx @@ -7,7 +7,7 @@ import React, { useContext, useEffect } from 'react'; import { connect } from 'react-redux'; import { Dispatch } from 'redux'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; import { AppState } from '../../../state'; import { monitorLocationsSelector } from '../../../state/selectors'; import { getMonitorLocationsAction, MonitorLocationsPayload } from '../../../state/actions/monitor'; @@ -36,8 +36,7 @@ export const Container: React.FC<Props> = ({ }: Props) => { const { lastRefresh } = useContext(UptimeRefreshContext); - const [getUrlParams] = useUrlParams(); - const { dateRangeStart: dateStart, dateRangeEnd: dateEnd } = getUrlParams(); + const { dateRangeStart: dateStart, dateRangeEnd: dateEnd } = useGetUrlParams(); useEffect(() => { loadMonitorLocations({ dateStart, dateEnd, monitorId }); diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_list/monitor_list_drawer/most_recent_error.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_list/monitor_list_drawer/most_recent_error.tsx index 036882b49359f..1963a9c852b11 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_list/monitor_list_drawer/most_recent_error.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_list/monitor_list_drawer/most_recent_error.tsx @@ -8,7 +8,7 @@ import { EuiText, EuiSpacer } from '@elastic/eui'; import moment from 'moment'; import { i18n } from '@kbn/i18n'; import { MonitorPageLink } from '../monitor_page_link'; -import { useUrlParams } from '../../../../hooks'; +import { useGetUrlParams } from '../../../../hooks'; import { stringifyUrlParams } from '../../../../lib/helper/stringify_url_params'; import { MonitorError } from '../../../../../common/runtime_types'; @@ -30,8 +30,7 @@ interface MostRecentErrorProps { } export const MostRecentError = ({ error, monitorId, timestamp }: MostRecentErrorProps) => { - const [getUrlParams] = useUrlParams(); - const { absoluteDateRangeStart, absoluteDateRangeEnd, ...params } = getUrlParams(); + const { absoluteDateRangeStart, absoluteDateRangeEnd, ...params } = useGetUrlParams(); params.selectedPingStatus = 'down'; const linkParameters = stringifyUrlParams(params, true); diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx index 29f003437f7cb..1abda87abf73a 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx @@ -7,13 +7,13 @@ import React, { useContext, useState } from 'react'; import { EuiButtonEmpty, EuiContextMenu, EuiIcon, EuiPopover } from '@elastic/eui'; -import { useParams } from 'react-router-dom'; import { useSelector } from 'react-redux'; import { canDeleteMLJobSelector } from '../../../state/selectors'; import { UptimeSettingsContext } from '../../../contexts'; import * as labels from './translations'; import { getMLJobLinkHref } from './ml_job_link'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; +import { useMonitorId } from '../../../hooks/use_monitor'; interface Props { hasMLJob: boolean; @@ -28,11 +28,9 @@ export const ManageMLJobComponent = ({ hasMLJob, onEnableJob, onJobDelete }: Pro const canDeleteMLJob = useSelector(canDeleteMLJobSelector); - const [getUrlParams] = useUrlParams(); - const { dateRangeStart, dateRangeEnd } = getUrlParams(); + const { dateRangeStart, dateRangeEnd } = useGetUrlParams(); - let { monitorId } = useParams(); - monitorId = atob(monitorId || ''); + const monitorId = useMonitorId(); const button = ( <EuiButtonEmpty diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx index 9eed24e2810d8..6953618d92213 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx @@ -6,7 +6,6 @@ import React, { useContext, useEffect, useState } from 'react'; import { useDispatch, useSelector } from 'react-redux'; -import { useParams } from 'react-router-dom'; import { canCreateMLJobSelector, hasMLJobSelector, @@ -24,8 +23,9 @@ import { import { MLFlyoutView } from './ml_flyout'; import { ML_JOB_ID } from '../../../../common/constants'; import { UptimeRefreshContext, UptimeSettingsContext } from '../../../contexts'; -import { useUrlParams } from '../../../hooks'; +import { useGetUrlParams } from '../../../hooks'; import { getDynamicSettings } from '../../../state/actions/dynamic_settings'; +import { useMonitorId } from '../../../hooks/use_monitor'; interface Props { onClose: () => void; @@ -77,8 +77,7 @@ export const MachineLearningFlyout: React.FC<Props> = ({ onClose }) => { const { refreshApp } = useContext(UptimeRefreshContext); - let { monitorId } = useParams(); - monitorId = atob(monitorId || ''); + const monitorId = useMonitorId(); const canCreateMLJob = useSelector(canCreateMLJobSelector) && heartbeatIndices !== ''; @@ -93,8 +92,7 @@ export const MachineLearningFlyout: React.FC<Props> = ({ onClose }) => { const [isCreatingJob, setIsCreatingJob] = useState(false); - const [getUrlParams] = useUrlParams(); - const { dateRangeStart, dateRangeEnd } = getUrlParams(); + const { dateRangeStart, dateRangeEnd } = useGetUrlParams(); useEffect(() => { if (isCreatingJob && !isMLJobCreating) { diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx index a27796167091e..e65a2510ea6f2 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx @@ -5,8 +5,6 @@ */ import React, { useContext, useEffect, useState } from 'react'; - -import { useParams } from 'react-router-dom'; import { useDispatch, useSelector } from 'react-redux'; import { MachineLearningFlyout } from './ml_flyout_container'; import { @@ -23,6 +21,7 @@ import * as labels from './translations'; import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; import { ManageMLJobComponent } from './manage_ml_job'; import { JobStat } from '../../../../../../../plugins/ml/common/types/data_recognizer'; +import { useMonitorId } from '../../../hooks/use_monitor'; export const MLIntegrationComponent = () => { const [isMlFlyoutOpen, setIsMlFlyoutOpen] = useState(false); @@ -32,8 +31,7 @@ export const MLIntegrationComponent = () => { const { notifications } = useKibana(); - let { monitorId } = useParams(); - monitorId = atob(monitorId || ''); + const monitorId = useMonitorId(); const dispatch = useDispatch(); diff --git a/x-pack/legacy/plugins/uptime/public/contexts/uptime_settings_context.tsx b/x-pack/legacy/plugins/uptime/public/contexts/uptime_settings_context.tsx index 44a87d310c9c7..c5a0ec4831798 100644 --- a/x-pack/legacy/plugins/uptime/public/contexts/uptime_settings_context.tsx +++ b/x-pack/legacy/plugins/uptime/public/contexts/uptime_settings_context.tsx @@ -8,7 +8,7 @@ import React, { createContext, useMemo } from 'react'; import { UptimeAppProps } from '../uptime_app'; import { CLIENT_DEFAULTS, CONTEXT_DEFAULTS } from '../../common/constants'; import { CommonlyUsedRange } from '../components/functional/uptime_date_picker'; -import { useUrlParams } from '../hooks'; +import { useGetUrlParams } from '../hooks'; import { ILicense } from '../../../../../plugins/licensing/common/types'; export interface UptimeSettingsContextValues { @@ -50,9 +50,7 @@ export const UptimeSettingsContextProvider: React.FC<UptimeAppProps> = ({ childr plugins, } = props; - const [getUrlParams] = useUrlParams(); - - const { dateRangeStart, dateRangeEnd } = getUrlParams(); + const { dateRangeStart, dateRangeEnd } = useGetUrlParams(); let license: ILicense | null = null; diff --git a/x-pack/legacy/plugins/uptime/public/hooks/__tests__/use_url_params.test.tsx b/x-pack/legacy/plugins/uptime/public/hooks/__tests__/use_url_params.test.tsx index a8999a50927d2..deb1f163c1326 100644 --- a/x-pack/legacy/plugins/uptime/public/hooks/__tests__/use_url_params.test.tsx +++ b/x-pack/legacy/plugins/uptime/public/hooks/__tests__/use_url_params.test.tsx @@ -19,6 +19,7 @@ interface MockUrlParamsComponentProps { const UseUrlParamsTestComponent = ({ hook, updateParams }: MockUrlParamsComponentProps) => { const [params, setParams] = useState({}); const [getUrlParams, updateUrlParams] = hook(); + const queryParams = getUrlParams(); return ( <Fragment> {Object.keys(params).length > 0 ? <div>{JSON.stringify(params)}</div> : null} @@ -30,7 +31,7 @@ const UseUrlParamsTestComponent = ({ hook, updateParams }: MockUrlParamsComponen > Set url params </button> - <button id="getUrlParams" onClick={() => setParams(getUrlParams())}> + <button id="getUrlParams" onClick={() => setParams(queryParams)}> Get url params </button> </Fragment> diff --git a/x-pack/legacy/plugins/uptime/public/hooks/use_monitor.ts b/x-pack/legacy/plugins/uptime/public/hooks/use_monitor.ts new file mode 100644 index 0000000000000..8080ce2696a3c --- /dev/null +++ b/x-pack/legacy/plugins/uptime/public/hooks/use_monitor.ts @@ -0,0 +1,14 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { useParams } from 'react-router-dom'; + +export const useMonitorId = (): string => { + const { monitorId } = useParams(); + + // decode 64 base string, it was decoded to make it a valid url, since monitor id can be a url + return atob(monitorId || ''); +}; diff --git a/x-pack/legacy/plugins/uptime/public/hooks/use_telemetry.ts b/x-pack/legacy/plugins/uptime/public/hooks/use_telemetry.ts index 13fe523332ae5..a2012b8ac5636 100644 --- a/x-pack/legacy/plugins/uptime/public/hooks/use_telemetry.ts +++ b/x-pack/legacy/plugins/uptime/public/hooks/use_telemetry.ts @@ -5,7 +5,7 @@ */ import { useEffect } from 'react'; -import { useUrlParams } from './use_url_params'; +import { useGetUrlParams } from './use_url_params'; import { apiService } from '../state/api/utils'; import { API_URLS } from '../../common/constants'; @@ -17,8 +17,12 @@ export enum UptimePage { } export const useUptimeTelemetry = (page?: UptimePage) => { - const [getUrlParams] = useUrlParams(); - const { dateRangeStart, dateRangeEnd, autorefreshInterval, autorefreshIsPaused } = getUrlParams(); + const { + dateRangeStart, + dateRangeEnd, + autorefreshInterval, + autorefreshIsPaused, + } = useGetUrlParams(); useEffect(() => { if (!apiService.http) throw new Error('Core http services are not defined'); diff --git a/x-pack/legacy/plugins/uptime/public/hooks/use_url_params.ts b/x-pack/legacy/plugins/uptime/public/hooks/use_url_params.ts index 20063b2c1bc93..8b13e9e480559 100644 --- a/x-pack/legacy/plugins/uptime/public/hooks/use_url_params.ts +++ b/x-pack/legacy/plugins/uptime/public/hooks/use_url_params.ts @@ -15,27 +15,26 @@ export type UpdateUrlParams = (updatedParams: { export type UptimeUrlParamsHook = () => [GetUrlParams, UpdateUrlParams]; -export const useUrlParams: UptimeUrlParamsHook = () => { +const getParsedParams = (search: string) => { + return search ? parse(search[0] === '?' ? search.slice(1) : search, { sort: false }) : {}; +}; + +export const useGetUrlParams: GetUrlParams = () => { const location = useLocation(); - const history = useHistory(); - const getUrlParams: GetUrlParams = () => { - let search: string | undefined; - if (location) { - search = location.search; - } + const params = getParsedParams(location?.search); - const params = search - ? parse(search[0] === '?' ? search.slice(1) : search, { sort: false }) - : {}; + return getSupportedUrlParams(params); +}; - return getSupportedUrlParams(params); - }; +export const useUrlParams: UptimeUrlParamsHook = () => { + const location = useLocation(); + const history = useHistory(); const updateUrlParams: UpdateUrlParams = updatedParams => { if (!history || !location) return; const { pathname, search } = location; - const currentParams = parse(search[0] === '?' ? search.slice(1) : search, { sort: false }); + const currentParams = getParsedParams(search); const mergedParams = { ...currentParams, ...updatedParams, @@ -60,5 +59,5 @@ export const useUrlParams: UptimeUrlParamsHook = () => { }); }; - return [getUrlParams, updateUrlParams]; + return [useGetUrlParams, updateUrlParams]; }; diff --git a/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx b/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx index 21124b7323d68..5016ccebbab54 100644 --- a/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx +++ b/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx @@ -6,7 +6,6 @@ import { EuiSpacer } from '@elastic/eui'; import React, { useContext, useState } from 'react'; -import { useParams } from 'react-router-dom'; import { useSelector } from 'react-redux'; import { MonitorCharts, PingList } from '../components/functional'; import { UptimeRefreshContext } from '../contexts'; @@ -16,11 +15,10 @@ import { MonitorStatusDetails } from '../components/connected'; import { monitorStatusSelector } from '../state/selectors'; import { PageHeader } from './page_header'; import { useBreadcrumbs } from '../hooks/use_breadcrumbs'; +import { useMonitorId } from '../hooks/use_monitor'; export const MonitorPage: React.FC = () => { - // decode 64 base string, it was decoded to make it a valid url, since monitor id can be a url - let { monitorId } = useParams(); - monitorId = atob(monitorId || ''); + const monitorId = useMonitorId(); const [pingListPageCount, setPingListPageCount] = useState<number>(10); const { refreshApp } = useContext(UptimeRefreshContext); diff --git a/x-pack/legacy/plugins/uptime/public/pages/overview.tsx b/x-pack/legacy/plugins/uptime/public/pages/overview.tsx index 943dbd6bd57ba..5550facaf42e9 100644 --- a/x-pack/legacy/plugins/uptime/public/pages/overview.tsx +++ b/x-pack/legacy/plugins/uptime/public/pages/overview.tsx @@ -13,7 +13,7 @@ import { OverviewPageParsingErrorCallout, StatusPanel, } from '../components/functional'; -import { useUrlParams, useUptimeTelemetry, UptimePage } from '../hooks'; +import { useUptimeTelemetry, UptimePage, useGetUrlParams } from '../hooks'; import { stringifyUrlParams } from '../lib/helper/stringify_url_params'; import { useTrackPageview } from '../../../../../plugins/observability/public'; import { DataPublicPluginSetup, IIndexPattern } from '../../../../../../src/plugins/data/public'; @@ -55,12 +55,11 @@ const getMonitorListPageSizeValue = () => { export const OverviewPageComponent = ({ autocomplete, indexPattern, setEsKueryFilters }: Props) => { const { colors } = useContext(UptimeThemeContext); - const [getUrlParams] = useUrlParams(); // TODO: this is temporary until we migrate the monitor list to our Redux implementation const [monitorListPageSize, setMonitorListPageSize] = useState<number>( getMonitorListPageSizeValue() ); - const { absoluteDateRangeStart, absoluteDateRangeEnd, ...params } = getUrlParams(); + const { absoluteDateRangeStart, absoluteDateRangeEnd, ...params } = useGetUrlParams(); const { dateRangeStart, dateRangeEnd, From c7f61f956a581bf39be01f9e0c263577c2165b6b Mon Sep 17 00:00:00 2001 From: Shahzad <shahzad.muhammad@elastic.co> Date: Mon, 13 Apr 2020 13:49:46 +0200 Subject: [PATCH 051/102] [Uptime] Update Ml functional test (#62562) * update test * added test * updated type * updated test * updated test * update test Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../connected/empty_state/empty_state.tsx | 6 +- .../confirm_delete.test.tsx.snap | 2 + .../__snapshots__/license_info.test.tsx.snap | 2 + .../__snapshots__/ml_flyout.test.tsx.snap | 5 ++ .../ml_integerations.test.tsx.snap | 1 + .../__snapshots__/ml_manage_job.test.tsx.snap | 1 + .../monitor_details/ml/confirm_delete.tsx | 1 + .../monitor_details/ml/license_info.tsx | 1 + .../monitor_details/ml/manage_ml_job.tsx | 8 ++- .../monitor_details/ml/ml_flyout.tsx | 3 +- .../ml/ml_flyout_container.tsx | 6 +- .../monitor_details/ml/ml_integeration.tsx | 2 +- .../plugins/uptime/public/pages/settings.tsx | 2 +- x-pack/test/functional/apps/uptime/index.ts | 5 +- .../test/functional/apps/uptime/ml_anomaly.ts | 51 ++++++++++++++++ x-pack/test/functional/apps/uptime/monitor.ts | 7 +-- .../test/functional/apps/uptime/overview.ts | 24 ++++---- .../functional/page_objects/uptime_page.ts | 39 ++++++------ .../test/functional/services/uptime/common.ts | 15 +++++ .../functional/services/uptime/ml_anomaly.ts | 59 +++++++++++++++++++ .../functional/services/uptime/navigation.ts | 52 +++++++++++----- .../test/functional/services/uptime/uptime.ts | 3 + 22 files changed, 235 insertions(+), 60 deletions(-) create mode 100644 x-pack/test/functional/apps/uptime/ml_anomaly.ts create mode 100644 x-pack/test/functional/services/uptime/ml_anomaly.ts diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/empty_state/empty_state.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/empty_state/empty_state.tsx index b383a696095a3..55c92e70b6066 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/empty_state/empty_state.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/empty_state/empty_state.tsx @@ -4,20 +4,22 @@ * you may not use this file except in compliance with the Elastic License. */ -import React, { useEffect } from 'react'; +import React, { useContext, useEffect } from 'react'; import { useDispatch, useSelector } from 'react-redux'; import { indexStatusAction } from '../../../state/actions'; import { indexStatusSelector } from '../../../state/selectors'; import { EmptyStateComponent } from '../../functional/empty_state/empty_state'; +import { UptimeRefreshContext } from '../../../contexts'; export const EmptyState: React.FC = ({ children }) => { const { data, loading, error } = useSelector(indexStatusSelector); + const { lastRefresh } = useContext(UptimeRefreshContext); const dispatch = useDispatch(); useEffect(() => { dispatch(indexStatusAction.get()); - }, [dispatch]); + }, [dispatch, lastRefresh]); return ( <EmptyStateComponent diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/confirm_delete.test.tsx.snap b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/confirm_delete.test.tsx.snap index 24ef7eda0d129..d83e45fea1aec 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/confirm_delete.test.tsx.snap +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/confirm_delete.test.tsx.snap @@ -6,6 +6,7 @@ exports[`ML Confirm Job Delete shallow renders without errors 1`] = ` buttonColor="danger" cancelButtonText="Cancel" confirmButtonText="Delete" + data-test-subj="uptimeMLJobDeleteConfirmModel" defaultFocusedButton="confirm" onCancel={[MockFunction]} onConfirm={[MockFunction]} @@ -35,6 +36,7 @@ exports[`ML Confirm Job Delete shallow renders without errors while loading 1`] buttonColor="danger" cancelButtonText="Cancel" confirmButtonText="Delete" + data-test-subj="uptimeMLJobDeleteConfirmModel" defaultFocusedButton="confirm" onCancel={[MockFunction]} onConfirm={[MockFunction]} diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/license_info.test.tsx.snap b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/license_info.test.tsx.snap index 2457488c4facc..fb40a42e47f75 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/license_info.test.tsx.snap +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/license_info.test.tsx.snap @@ -4,6 +4,7 @@ exports[`ShowLicenseInfo renders without errors 1`] = ` Array [ <div class="euiCallOut euiCallOut--primary license-info-trial" + data-test-subj="uptimeMLLicenseInfo" > <div class="euiCallOutHeader" @@ -54,6 +55,7 @@ exports[`ShowLicenseInfo shallow renders without errors 1`] = ` <EuiCallOut className="license-info-trial" color="primary" + data-test-subj="uptimeMLLicenseInfo" iconType="help" title="Start free 14-day trial" > diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_flyout.test.tsx.snap b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_flyout.test.tsx.snap index ead27425c26f3..a83a1d99d7bb0 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_flyout.test.tsx.snap +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_flyout.test.tsx.snap @@ -3,6 +3,7 @@ exports[`ML Flyout component renders without errors 1`] = ` <EuiFlyout closeButtonAriaLabel="Closes this dialog" + data-test-subj="uptimeMLFlyout" hideCloseButton={false} maxWidth={false} onClose={[Function]} @@ -69,6 +70,7 @@ exports[`ML Flyout component renders without errors 1`] = ` grow={false} > <EuiButton + data-test-subj="uptimeMLCreateJobBtn" disabled={true} fill={true} isLoading={false} @@ -99,6 +101,7 @@ exports[`ML Flyout component shows license info if no ml available 1`] = ` > <div class="euiFlyout euiFlyout--small" + data-test-subj="uptimeMLFlyout" role="dialog" tabindex="0" > @@ -137,6 +140,7 @@ exports[`ML Flyout component shows license info if no ml available 1`] = ` > <div class="euiCallOut euiCallOut--primary license-info-trial" + data-test-subj="uptimeMLLicenseInfo" > <div class="euiCallOutHeader" @@ -240,6 +244,7 @@ exports[`ML Flyout component shows license info if no ml available 1`] = ` > <button class="euiButton euiButton--primary euiButton--fill" + data-test-subj="uptimeMLCreateJobBtn" disabled="" type="button" > diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_integerations.test.tsx.snap b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_integerations.test.tsx.snap index ac4630f4e69a8..fa9b59e13c34e 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_integerations.test.tsx.snap +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_integerations.test.tsx.snap @@ -9,6 +9,7 @@ exports[`ML Integrations renders without errors 1`] = ` > <button class="euiButtonEmpty euiButtonEmpty--primary" + data-test-subj="uptimeEnableAnomalyBtn" type="button" > <span diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_manage_job.test.tsx.snap b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_manage_job.test.tsx.snap index 6eb2930c4875a..91bd9fa3d86b5 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_manage_job.test.tsx.snap +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/__tests__/__snapshots__/ml_manage_job.test.tsx.snap @@ -9,6 +9,7 @@ exports[`Manage ML Job renders without errors 1`] = ` > <button class="euiButtonEmpty euiButtonEmpty--primary euiButtonEmpty--iconRight" + data-test-subj="uptimeManageMLJobBtn" type="button" > <span diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/confirm_delete.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/confirm_delete.tsx index 6754676765fb6..628f943ef2e08 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/confirm_delete.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/confirm_delete.tsx @@ -25,6 +25,7 @@ export const ConfirmJobDeletion: React.FC<Props> = ({ loading, onConfirm, onCanc confirmButtonText="Delete" buttonColor="danger" defaultFocusedButton="confirm" + data-test-subj="uptimeMLJobDeleteConfirmModel" > {!loading ? ( <p> diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/license_info.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/license_info.tsx index 92badb4043ed6..fae81177a728c 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/license_info.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/license_info.tsx @@ -13,6 +13,7 @@ export const ShowLicenseInfo = () => { return ( <> <EuiCallOut + data-test-subj="uptimeMLLicenseInfo" className="license-info-trial" title={labels.START_TRAIL} color="primary" diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx index 1abda87abf73a..ec3e8bb2b9f68 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/manage_ml_job.tsx @@ -34,6 +34,7 @@ export const ManageMLJobComponent = ({ hasMLJob, onEnableJob, onJobDelete }: Pro const button = ( <EuiButtonEmpty + data-test-subj={hasMLJob ? 'uptimeManageMLJobBtn' : 'uptimeEnableAnomalyBtn'} iconType={hasMLJob ? 'arrowDown' : 'machineLearningApp'} iconSide={hasMLJob ? 'right' : 'left'} onClick={hasMLJob ? () => setIsPopOverOpen(true) : onEnableJob} @@ -60,6 +61,7 @@ export const ManageMLJobComponent = ({ hasMLJob, onEnableJob, onJobDelete }: Pro }, { name: labels.DISABLE_ANOMALY_DETECTION, + 'data-test-subj': 'uptimeDeleteMLJobBtn', icon: <EuiIcon type="trash" size="m" />, onClick: () => { setIsPopOverOpen(false); @@ -72,7 +74,11 @@ export const ManageMLJobComponent = ({ hasMLJob, onEnableJob, onJobDelete }: Pro return ( <EuiPopover button={button} isOpen={isPopOverOpen} closePopover={() => setIsPopOverOpen(false)}> - <EuiContextMenu initialPanelId={0} panels={panels} /> + <EuiContextMenu + initialPanelId={0} + panels={panels} + data-test-subj="uptimeManageMLContextMenu" + /> </EuiPopover> ); }; diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout.tsx index fdecfbf20810c..8c3f814e841f7 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout.tsx @@ -39,7 +39,7 @@ export function MLFlyoutView({ isCreatingJob, onClickCreate, onClose, canCreateM const hasPlatinumLicense = license?.getFeature('ml')?.isAvailable; return ( - <EuiFlyout onClose={onClose} size="s"> + <EuiFlyout onClose={onClose} size="s" data-test-subj="uptimeMLFlyout"> <EuiFlyoutHeader> <EuiTitle> <h2>{labels.ENABLE_ANOMALY_DETECTION}</h2> @@ -76,6 +76,7 @@ export function MLFlyoutView({ isCreatingJob, onClickCreate, onClose, canCreateM </EuiFlexItem> <EuiFlexItem grow={false}> <EuiButton + data-test-subj="uptimeMLCreateJobBtn" onClick={() => onClickCreate()} fill isLoading={isCreatingJob} diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx index 6953618d92213..a13de192cc443 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_flyout_container.tsx @@ -41,7 +41,9 @@ const showMLJobNotification = ( ) => { if (success) { notifications.toasts.success({ - title: <p>{labels.JOB_CREATED_SUCCESS_TITLE}</p>, + title: ( + <p data-test-subj="uptimeMLJobSuccessfullyCreated">{labels.JOB_CREATED_SUCCESS_TITLE}</p> + ), body: ( <p> {labels.JOB_CREATED_SUCCESS_MESSAGE} @@ -54,7 +56,7 @@ const showMLJobNotification = ( }); } else { notifications.toasts.danger({ - title: <p>{labels.JOB_CREATION_FAILED}</p>, + title: <p data-test-subj="uptimeMLJobCreationFailed">{labels.JOB_CREATION_FAILED}</p>, body: message ?? <p>{labels.JOB_CREATION_FAILED_MESSAGE}</p>, toastLifeTimeMs: 10000, }); diff --git a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx index e65a2510ea6f2..e053ca733cb8c 100644 --- a/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/monitor_details/ml/ml_integeration.tsx @@ -57,7 +57,7 @@ export const MLIntegrationComponent = () => { if (isConfirmDeleteJobOpen && jobDeletionSuccess?.[getMLJobId(monitorId as string)]?.deleted) { setIsConfirmDeleteJobOpen(false); notifications.toasts.success({ - title: <p>{labels.JOB_DELETION}</p>, + title: <p data-test-subj="uptimeMLJobSuccessfullyDeleted">{labels.JOB_DELETION}</p>, body: <p>{labels.JOB_DELETION_SUCCESS}</p>, toastLifeTimeMs: 3000, }); diff --git a/x-pack/legacy/plugins/uptime/public/pages/settings.tsx b/x-pack/legacy/plugins/uptime/public/pages/settings.tsx index d3e17a15ee0e0..765b0e3c664bc 100644 --- a/x-pack/legacy/plugins/uptime/public/pages/settings.tsx +++ b/x-pack/legacy/plugins/uptime/public/pages/settings.tsx @@ -112,7 +112,7 @@ export const SettingsPageComponent = ({ return ( <> - <Link to={OVERVIEW_ROUTE}> + <Link to={OVERVIEW_ROUTE} data-test-subj="uptimeSettingsToOverviewLink"> <EuiButtonEmpty size="s" color="primary" iconType="arrowLeft"> {i18n.translate('xpack.uptime.settings.returnToOverviewLinkLabel', { defaultMessage: 'Return to overview', diff --git a/x-pack/test/functional/apps/uptime/index.ts b/x-pack/test/functional/apps/uptime/index.ts index 3789351263b98..f47214dc2ad2f 100644 --- a/x-pack/test/functional/apps/uptime/index.ts +++ b/x-pack/test/functional/apps/uptime/index.ts @@ -16,6 +16,7 @@ export default ({ loadTestFile, getService }: FtrProviderContext) => { const esArchiver = getService('esArchiver'); const kibanaServer = getService('kibanaServer'); const server = getService('kibanaServer'); + const uptime = getService('uptime'); describe('Uptime app', function() { this.tags('ciGroup6'); @@ -58,12 +59,14 @@ export default ({ loadTestFile, getService }: FtrProviderContext) => { await esArchiver.unload(ARCHIVE); await esArchiver.load(ARCHIVE); await kibanaServer.uiSettings.replace({ 'dateFormat:tz': 'UTC' }); + await uptime.navigation.goToUptime(); }); after(async () => await esArchiver.unload(ARCHIVE)); - loadTestFile(require.resolve('./feature_controls')); loadTestFile(require.resolve('./overview')); loadTestFile(require.resolve('./monitor')); + loadTestFile(require.resolve('./ml_anomaly')); + loadTestFile(require.resolve('./feature_controls')); }); }); }; diff --git a/x-pack/test/functional/apps/uptime/ml_anomaly.ts b/x-pack/test/functional/apps/uptime/ml_anomaly.ts new file mode 100644 index 0000000000000..bcd165cc1afb7 --- /dev/null +++ b/x-pack/test/functional/apps/uptime/ml_anomaly.ts @@ -0,0 +1,51 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import expect from '@kbn/expect'; +import { FtrProviderContext } from '../../ftr_provider_context'; + +export default ({ getService }: FtrProviderContext) => { + const uptime = getService('uptime'); + const log = getService('log'); + + describe('uptime ml anomaly', function() { + this.tags(['skipFirefox']); + const dateStart = 'Sep 10, 2019 @ 12:40:08.078'; + const dateEnd = 'Sep 11, 2019 @ 19:40:08.078'; + const monitorId = '0000-intermittent'; + + before(async () => { + if (!(await uptime.navigation.checkIfOnMonitorPage(monitorId))) { + await uptime.navigation.loadDataAndGoToMonitorPage(dateStart, dateEnd, monitorId); + } + if (await uptime.ml.alreadyHasJob()) { + log.info('Jon already exists so lets delete it to start fresh.'); + await uptime.ml.deleteMLJob(); + } + }); + + it('can open ml flyout', async () => { + await uptime.ml.openMLFlyout(); + }); + + it('has permission to create job', async () => { + expect(uptime.ml.canCreateJob()).to.eql(true); + expect(uptime.ml.hasNoLicenseInfo()).to.eql(false); + }); + + it('can create job successfully', async () => { + await uptime.ml.createMLJob(); + // await uptime.navigation.refreshApp(); + }); + + it('can open ML Manage Menu', async () => { + await uptime.ml.openMLManageMenu(); + }); + + it('can delete job successfully', async () => { + await uptime.ml.deleteMLJob(); + }); + }); +}; diff --git a/x-pack/test/functional/apps/uptime/monitor.ts b/x-pack/test/functional/apps/uptime/monitor.ts index e15750eb6157b..90ad1836c69d3 100644 --- a/x-pack/test/functional/apps/uptime/monitor.ts +++ b/x-pack/test/functional/apps/uptime/monitor.ts @@ -17,19 +17,14 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { const dateStart = 'Sep 10, 2019 @ 12:40:08.078'; const dateEnd = 'Sep 11, 2019 @ 19:40:08.078'; const monitorId = '0000-intermittent'; - const monitorName = '0000-intermittent'; before(async () => { await esArchiver.loadIfNeeded(archive); await uptimeService.navigation.goToUptime(); }); - after(async () => { - await esArchiver.unload(archive); - }); - it('loads and displays uptime data based on date range', async () => { - await uptime.loadDataAndGoToMonitorPage(dateStart, dateEnd, monitorId, monitorName); + await uptime.loadDataAndGoToMonitorPage(dateStart, dateEnd, monitorId); }); }); }; diff --git a/x-pack/test/functional/apps/uptime/overview.ts b/x-pack/test/functional/apps/uptime/overview.ts index 8195e6bbb6035..d0dfca64634f6 100644 --- a/x-pack/test/functional/apps/uptime/overview.ts +++ b/x-pack/test/functional/apps/uptime/overview.ts @@ -14,6 +14,13 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { describe('overview page', function() { const DEFAULT_DATE_START = 'Sep 10, 2019 @ 12:40:08.078'; const DEFAULT_DATE_END = 'Sep 11, 2019 @ 19:40:08.078'; + + beforeEach(async () => { + await uptime.goToRoot(); + await uptime.setDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); + await uptime.resetFilters(); + }); + it('loads and displays uptime data based on date range', async () => { await uptime.goToUptimeOverviewAndLoadData( DEFAULT_DATE_START, @@ -22,13 +29,7 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { ); }); - it('runs filter query without issues', async () => { - await uptime.inputFilterQuery('monitor.status:up and monitor.id:"0000-intermittent"'); - await uptime.pageHasExpectedIds(['0000-intermittent']); - }); - it('applies filters for multiple fields', async () => { - await uptime.goToUptimePageAndSetDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); await uptime.selectFilterItems({ location: ['mpls'], port: ['5678'], @@ -49,7 +50,6 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { }); it('pagination is cleared when filter criteria changes', async () => { - await uptime.goToUptimePageAndSetDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); await uptime.changePage('next'); await uptime.pageHasExpectedIds([ '0010-down', @@ -83,7 +83,6 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { }); it('clears pagination parameters when size changes', async () => { - await uptime.goToUptimePageAndSetDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); await uptime.changePage('next'); await uptime.pageUrlContains('pagination'); await uptime.setMonitorListPageSize(50); @@ -92,7 +91,6 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { }); it('pagination size updates to reflect current selection', async () => { - await uptime.goToUptimePageAndSetDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); await uptime.pageHasExpectedIds([ '0000-intermittent', '0001-up', @@ -162,7 +160,6 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { describe('snapshot counts', () => { it('updates the snapshot count when status filter is set to down', async () => { - await uptime.goToUptimePageAndSetDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); await uptime.setStatusFilter('down'); await retry.tryForTime(12000, async () => { @@ -172,13 +169,18 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { }); it('updates the snapshot count when status filter is set to up', async () => { - await uptime.goToUptimePageAndSetDateRange(DEFAULT_DATE_START, DEFAULT_DATE_END); await uptime.setStatusFilter('up'); await retry.tryForTime(12000, async () => { const counts = await uptime.getSnapshotCount(); expect(counts).to.eql({ up: '93', down: '0' }); }); }); + + it('runs filter query without issues', async () => { + await uptime.inputFilterQuery('monitor.status:up and monitor.id:"0000-intermittent"'); + await uptime.pageHasExpectedIds(['0000-intermittent']); + await uptime.resetFilters(); + }); }); }); }; diff --git a/x-pack/test/functional/page_objects/uptime_page.ts b/x-pack/test/functional/page_objects/uptime_page.ts index 39c3c46adddbb..7157bbfb3811b 100644 --- a/x-pack/test/functional/page_objects/uptime_page.ts +++ b/x-pack/test/functional/page_objects/uptime_page.ts @@ -14,37 +14,33 @@ export function UptimePageProvider({ getPageObjects, getService }: FtrProviderCo return new (class UptimePage { public async goToRoot() { - await pageObjects.common.navigateToApp('uptime'); + await navigation.goToUptime(); } - public async goToUptimePageAndSetDateRange( - datePickerStartValue: string, - datePickerEndValue: string - ) { - await pageObjects.common.navigateToApp('uptime'); - await pageObjects.timePicker.setAbsoluteRange(datePickerStartValue, datePickerEndValue); + public async setDateRange(start: string, end: string) { + const { start: prevStart, end: prevEnd } = await pageObjects.timePicker.getTimeConfig(); + if (start !== prevStart || prevEnd !== end) { + await pageObjects.timePicker.setAbsoluteRange(start, end); + } else { + await navigation.refreshApp(); + } } public async goToUptimeOverviewAndLoadData( - datePickerStartValue: string, - datePickerEndValue: string, + dateStart: string, + dateEnd: string, monitorIdToCheck?: string ) { - await pageObjects.common.navigateToApp('uptime'); - await pageObjects.timePicker.setAbsoluteRange(datePickerStartValue, datePickerEndValue); + await navigation.goToUptime(); + await this.setDateRange(dateStart, dateEnd); if (monitorIdToCheck) { await commonService.monitorIdExists(monitorIdToCheck); } } - public async loadDataAndGoToMonitorPage( - datePickerStartValue: string, - datePickerEndValue: string, - monitorId: string, - monitorName?: string - ) { - await pageObjects.timePicker.setAbsoluteRange(datePickerStartValue, datePickerEndValue); - await navigation.goToMonitor(monitorId, monitorName); + public async loadDataAndGoToMonitorPage(dateStart: string, dateEnd: string, monitorId: string) { + await this.setDateRange(dateStart, dateEnd); + await navigation.goToMonitor(monitorId); } public async inputFilterQuery(filterQuery: string) { @@ -140,5 +136,10 @@ export function UptimePageProvider({ getPageObjects, getService }: FtrProviderCo await commonService.openPageSizeSelectPopover(); return commonService.clickPageSizeSelectPopoverItem(size); } + + public async resetFilters() { + await this.inputFilterQuery(''); + await commonService.resetStatusFilter(); + } })(); } diff --git a/x-pack/test/functional/services/uptime/common.ts b/x-pack/test/functional/services/uptime/common.ts index ed465eee343f9..b5be1e29a0e8c 100644 --- a/x-pack/test/functional/services/uptime/common.ts +++ b/x-pack/test/functional/services/uptime/common.ts @@ -10,6 +10,7 @@ export function UptimeCommonProvider({ getService }: FtrProviderContext) { const testSubjects = getService('testSubjects'); const browser = getService('browser'); const retry = getService('retry'); + const find = getService('find'); return { async assertExists(key: string) { @@ -52,6 +53,20 @@ export function UptimeCommonProvider({ getService }: FtrProviderContext) { async setStatusFilterDown() { await testSubjects.click('xpack.uptime.filterBar.filterStatusDown'); }, + async resetStatusFilter() { + const upFilter = await find.byCssSelector( + '[data-test-subj="xpack.uptime.filterBar.filterStatusUp"]' + ); + if (await upFilter.elementHasClass('euiFilterButton-hasActiveFilters')) { + this.setStatusFilterUp(); + } + const downFilter = await find.byCssSelector( + '[data-test-subj="xpack.uptime.filterBar.filterStatusDown"]' + ); + if (await downFilter.elementHasClass('euiFilterButton-hasActiveFilters')) { + this.setStatusFilterDown(); + } + }, async selectFilterItem(filterType: string, option: string) { const popoverId = `filter-popover_${filterType}`; const optionId = `filter-popover-item_${option}`; diff --git a/x-pack/test/functional/services/uptime/ml_anomaly.ts b/x-pack/test/functional/services/uptime/ml_anomaly.ts new file mode 100644 index 0000000000000..e15f47ddd9709 --- /dev/null +++ b/x-pack/test/functional/services/uptime/ml_anomaly.ts @@ -0,0 +1,59 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { FtrProviderContext } from '../../ftr_provider_context'; + +export function UptimeMLAnomalyProvider({ getService }: FtrProviderContext) { + const testSubjects = getService('testSubjects'); + const retry = getService('retry'); + const log = getService('log'); + + return { + async openMLFlyout() { + return retry.tryForTime(15000, async () => { + await testSubjects.click('uptimeEnableAnomalyBtn'); + await testSubjects.existOrFail('uptimeMLFlyout'); + }); + }, + + async openMLManageMenu() { + return retry.tryForTime(30000, async () => { + await testSubjects.click('uptimeManageMLJobBtn'); + await testSubjects.existOrFail('uptimeManageMLContextMenu'); + }); + }, + + async alreadyHasJob() { + return await testSubjects.exists('uptimeManageMLJobBtn'); + }, + + async createMLJob() { + await testSubjects.click('uptimeMLCreateJobBtn'); + return retry.tryForTime(10000, async () => { + await testSubjects.existOrFail('uptimeMLJobSuccessfullyCreated'); + log.info('Job successfully created'); + }); + }, + + async deleteMLJob() { + await testSubjects.click('uptimeDeleteMLJobBtn'); + return retry.tryForTime(10000, async () => { + await testSubjects.click('uptimeMLJobDeleteConfirmModel > confirmModalConfirmButton'); + await testSubjects.existOrFail('uptimeMLJobSuccessfullyDeleted'); + log.info('Job successfully deleted'); + }); + }, + + async canCreateJob() { + const createJobBtn = await testSubjects.find('uptimeMLCreateJobBtn'); + return !!(await createJobBtn.getAttribute('disabled')); + }, + + async hasNoLicenseInfo() { + return await testSubjects.missingOrFail('uptimeMLLicenseInfo', { timeout: 1000 }); + }, + }; +} diff --git a/x-pack/test/functional/services/uptime/navigation.ts b/x-pack/test/functional/services/uptime/navigation.ts index 15ee869da1e6a..36a5d7c9702f8 100644 --- a/x-pack/test/functional/services/uptime/navigation.ts +++ b/x-pack/test/functional/services/uptime/navigation.ts @@ -9,17 +9,27 @@ import { FtrProviderContext } from '../../ftr_provider_context'; export function UptimeNavigationProvider({ getService, getPageObjects }: FtrProviderContext) { const retry = getService('retry'); const testSubjects = getService('testSubjects'); - const PageObjects = getPageObjects(['common', 'header']); + const PageObjects = getPageObjects(['common', 'timePicker', 'header']); const goToUptimeRoot = async () => { - await retry.tryForTime(30 * 1000, async () => { - await PageObjects.common.navigateToApp('uptime'); - await PageObjects.header.waitUntilLoadingHasFinished(); - await testSubjects.existOrFail('uptimeOverviewPage', { timeout: 2000 }); + // Check if are already on overview uptime page, we don't need to repeat the step + await retry.tryForTime(60 * 1000, async () => { + if (await testSubjects.exists('uptimeSettingsToOverviewLink', { timeout: 0 })) { + await testSubjects.click('uptimeSettingsToOverviewLink'); + await testSubjects.existOrFail('uptimeOverviewPage', { timeout: 2000 }); + } else if (!(await testSubjects.exists('uptimeOverviewPage', { timeout: 0 }))) { + await PageObjects.common.navigateToApp('uptime'); + await PageObjects.header.waitUntilLoadingHasFinished(); + await testSubjects.existOrFail('uptimeOverviewPage', { timeout: 2000 }); + } }); }; return { + async refreshApp() { + await testSubjects.click('superDatePickerApplyTimeButton'); + }, + async goToUptime() { await goToUptimeRoot(); }, @@ -30,17 +40,29 @@ export function UptimeNavigationProvider({ getService, getPageObjects }: FtrProv await testSubjects.existOrFail('uptimeSettingsPage', { timeout: 2000 }); }, - goToMonitor: async (monitorId: string, monitorName?: string) => { - await testSubjects.click(`monitor-page-link-${monitorId}`, 5000); - if ( - monitorName && - (await testSubjects.getVisibleText('monitor-page-title')) !== monitorName - ) { - throw new Error('Expected monitor name not found'); + checkIfOnMonitorPage: async (monitorId: string) => { + const monitorPage = await testSubjects.exists('uptimeMonitorPage', { timeout: 1000 }); + if (monitorId && monitorPage) { + const thisMonitorPage = + (await testSubjects.getVisibleText('monitor-page-title')) === monitorId; + return monitorPage && thisMonitorPage; + } else { + return monitorPage; + } + }, + + goToMonitor: async (monitorId: string) => { + if (!(await testSubjects.exists('uptimeMonitorPage', { timeout: 0 }))) { + await testSubjects.click(`monitor-page-link-${monitorId}`); + await testSubjects.existOrFail('uptimeMonitorPage', { + timeout: 30000, + }); } - await testSubjects.existOrFail('uptimeMonitorPage', { - timeout: 30000, - }); + }, + + async loadDataAndGoToMonitorPage(dateStart: string, dateEnd: string, monitorId: string) { + await PageObjects.timePicker.setAbsoluteRange(dateStart, dateEnd); + await this.goToMonitor(monitorId); }, }; } diff --git a/x-pack/test/functional/services/uptime/uptime.ts b/x-pack/test/functional/services/uptime/uptime.ts index c96bd0e0c4675..601feb6b0646e 100644 --- a/x-pack/test/functional/services/uptime/uptime.ts +++ b/x-pack/test/functional/services/uptime/uptime.ts @@ -11,6 +11,7 @@ import { UptimeCommonProvider } from './common'; import { UptimeMonitorProvider } from './monitor'; import { UptimeNavigationProvider } from './navigation'; import { UptimeAlertsProvider } from './alerts'; +import { UptimeMLAnomalyProvider } from './ml_anomaly'; export function UptimeProvider(context: FtrProviderContext) { const common = UptimeCommonProvider(context); @@ -18,6 +19,7 @@ export function UptimeProvider(context: FtrProviderContext) { const monitor = UptimeMonitorProvider(context); const navigation = UptimeNavigationProvider(context); const alerts = UptimeAlertsProvider(context); + const ml = UptimeMLAnomalyProvider(context); return { common, @@ -25,5 +27,6 @@ export function UptimeProvider(context: FtrProviderContext) { monitor, navigation, alerts, + ml, }; } From 36b4ad98883442c329f455d0d6ddd54ebf5e1b86 Mon Sep 17 00:00:00 2001 From: Dario Gieselaar <dario.gieselaar@elastic.co> Date: Mon, 13 Apr 2020 14:06:20 +0200 Subject: [PATCH 052/102] [APM] Separate count/retainment telemetry requests (#63225) Separate count/retainment telemetry requests to make them less prone to timing out. Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../collect_data_telemetry/tasks.ts | 40 ++++++++++++++----- 1 file changed, 29 insertions(+), 11 deletions(-) diff --git a/x-pack/plugins/apm/server/lib/apm_telemetry/collect_data_telemetry/tasks.ts b/x-pack/plugins/apm/server/lib/apm_telemetry/collect_data_telemetry/tasks.ts index 85f233de2086d..e9801272cd57b 100644 --- a/x-pack/plugins/apm/server/lib/apm_telemetry/collect_data_telemetry/tasks.ts +++ b/x-pack/plugins/apm/server/lib/apm_telemetry/collect_data_telemetry/tasks.ts @@ -61,10 +61,10 @@ export const tasks: TelemetryTask[] = [ return prevJob.then(async data => { const { processorEvent, timeRange } = current; - const response = await search({ + const totalHitsResponse = await search({ index: indicesByProcessorEvent[processorEvent], body: { - size: 1, + size: 0, query: { bool: { filter: [ @@ -83,25 +83,43 @@ export const tasks: TelemetryTask[] = [ ] } }, - sort: { - '@timestamp': 'asc' - }, - _source: ['@timestamp'], track_total_hits: true } }); - const event = response.hits.hits[0]?._source as { - '@timestamp': number; - }; + const retainmentResponse = + timeRange === 'all' + ? await search({ + index: indicesByProcessorEvent[processorEvent], + body: { + query: { + bool: { + filter: [ + { term: { [PROCESSOR_EVENT]: processorEvent } } + ] + } + }, + sort: { + '@timestamp': 'asc' + }, + _source: ['@timestamp'] + } + }) + : null; + + const event = retainmentResponse?.hits.hits[0]?._source as + | { + '@timestamp': number; + } + | undefined; return merge({}, data, { counts: { [processorEvent]: { - [timeRange]: response.hits.total.value + [timeRange]: totalHitsResponse.hits.total.value } }, - ...(timeRange === 'all' && event + ...(event ? { retainment: { [processorEvent]: { From bbd501ea517225c551decd2f649255e7ff098c00 Mon Sep 17 00:00:00 2001 From: Thomas Neirynck <thomas@elastic.co> Date: Mon, 13 Apr 2020 09:24:16 -0400 Subject: [PATCH 053/102] [Maps] Cleanup sources (#63175) - Introduces additional TS typing for sources - Organizes sources in sub-directories by type - migrates XYZTMSSource to TS --- .../server/maps_telemetry/maps_telemetry.ts | 2 + .../descriptor_types/descriptor_types.d.ts | 26 ++- .../public/layers/blended_vector_layer.ts | 6 +- x-pack/plugins/maps/public/layers/layer.d.ts | 1 + .../public/layers/layer_wizard_registry.ts | 20 +- .../{ => es_agg_source}/es_agg_source.d.ts | 10 +- .../{ => es_agg_source}/es_agg_source.js | 6 +- .../{ => es_agg_source}/es_agg_source.test.ts | 10 +- .../layers/sources/es_agg_source/index.ts | 7 + .../sources/{ => es_source}/es_source.d.ts | 8 +- .../sources/{ => es_source}/es_source.js | 14 +- .../public/layers/sources/es_source/index.ts | 7 + .../{ => es_term_source}/es_term_source.d.ts | 4 +- .../{ => es_term_source}/es_term_source.js | 8 +- .../es_term_source.test.js | 2 +- .../layers/sources/es_term_source/index.ts | 7 + .../maps/public/layers/sources/source.d.ts | 22 ++- .../public/layers/sources/source_registry.ts | 3 +- .../public/layers/sources/tms_source/index.ts | 7 + .../sources/{ => tms_source}/tms_source.d.ts | 3 +- .../sources/{ => tms_source}/tms_source.js | 2 +- .../layers/sources/vector_source/index.ts | 7 + .../{ => vector_source}/vector_source.d.ts | 6 +- .../{ => vector_source}/vector_source.js | 10 +- .../public/layers/sources/xyz_tms_source.d.ts | 11 -- .../public/layers/sources/xyz_tms_source.js | 187 ------------------ .../layers/sources/xyz_tms_source/index.ts | 8 + .../sources/xyz_tms_source/layer_wizard.tsx | 27 +++ .../sources/xyz_tms_source/xyz_tms_editor.tsx | 122 ++++++++++++ .../xyz_tms_source.test.ts | 12 +- .../sources/xyz_tms_source/xyz_tms_source.ts | 87 ++++++++ .../plugins/maps/public/layers/tile_layer.js | 4 +- .../maps/public/layers/tile_layer.test.ts | 2 +- .../maps/public/layers/vector_layer.d.ts | 4 +- 34 files changed, 392 insertions(+), 270 deletions(-) rename x-pack/plugins/maps/public/layers/sources/{ => es_agg_source}/es_agg_source.d.ts (73%) rename x-pack/plugins/maps/public/layers/sources/{ => es_agg_source}/es_agg_source.js (95%) rename x-pack/plugins/maps/public/layers/sources/{ => es_agg_source}/es_agg_source.test.ts (89%) create mode 100644 x-pack/plugins/maps/public/layers/sources/es_agg_source/index.ts rename x-pack/plugins/maps/public/layers/sources/{ => es_source}/es_source.d.ts (78%) rename x-pack/plugins/maps/public/layers/sources/{ => es_source}/es_source.js (95%) create mode 100644 x-pack/plugins/maps/public/layers/sources/es_source/index.ts rename x-pack/plugins/maps/public/layers/sources/{ => es_term_source}/es_term_source.d.ts (77%) rename x-pack/plugins/maps/public/layers/sources/{ => es_term_source}/es_term_source.js (95%) rename x-pack/plugins/maps/public/layers/sources/{ => es_term_source}/es_term_source.test.js (98%) create mode 100644 x-pack/plugins/maps/public/layers/sources/es_term_source/index.ts create mode 100644 x-pack/plugins/maps/public/layers/sources/tms_source/index.ts rename x-pack/plugins/maps/public/layers/sources/{ => tms_source}/tms_source.d.ts (80%) rename x-pack/plugins/maps/public/layers/sources/{ => tms_source}/tms_source.js (94%) create mode 100644 x-pack/plugins/maps/public/layers/sources/vector_source/index.ts rename x-pack/plugins/maps/public/layers/sources/{ => vector_source}/vector_source.d.ts (91%) rename x-pack/plugins/maps/public/layers/sources/{ => vector_source}/vector_source.js (93%) delete mode 100644 x-pack/plugins/maps/public/layers/sources/xyz_tms_source.d.ts delete mode 100644 x-pack/plugins/maps/public/layers/sources/xyz_tms_source.js create mode 100644 x-pack/plugins/maps/public/layers/sources/xyz_tms_source/index.ts create mode 100644 x-pack/plugins/maps/public/layers/sources/xyz_tms_source/layer_wizard.tsx create mode 100644 x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_editor.tsx rename x-pack/plugins/maps/public/layers/sources/{ => xyz_tms_source}/xyz_tms_source.test.ts (71%) create mode 100644 x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts diff --git a/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts b/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts index 5657e14622e9b..0300f22eeeb82 100644 --- a/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts +++ b/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts @@ -87,6 +87,8 @@ export function buildMapsTelemetry({ const mapsCount = layerLists.length; const dataSourcesCount = layerLists.map(lList => { + // todo: not every source-descriptor has an id + // @ts-ignore const sourceIdList = lList.map((layer: LayerDescriptor) => layer.sourceDescriptor.id); return _.uniq(sourceIdList).length; }); diff --git a/x-pack/plugins/maps/common/descriptor_types/descriptor_types.d.ts b/x-pack/plugins/maps/common/descriptor_types/descriptor_types.d.ts index fb49e1aaebe1c..ff285877750c5 100644 --- a/x-pack/plugins/maps/common/descriptor_types/descriptor_types.d.ts +++ b/x-pack/plugins/maps/common/descriptor_types/descriptor_types.d.ts @@ -9,6 +9,11 @@ import { AGG_TYPE, GRID_RESOLUTION, RENDER_AS, SORT_ORDER, SCALING_TYPES } from import { VectorStyleDescriptor } from './style_property_descriptor_types'; import { DataRequestDescriptor } from './data_request_descriptor_types'; +export type AttributionDescriptor = { + attributionText?: string; + attributionUrl?: string; +}; + export type AbstractSourceDescriptor = { id?: string; type: string; @@ -84,17 +89,26 @@ export type WMSSourceDescriptor = { attributionUrl: string; }; -export type XYZTMSSourceDescriptor = { - id: string; - type: string; - urlTemplate: string; -}; +export type XYZTMSSourceDescriptor = AbstractSourceDescriptor & + AttributionDescriptor & { + urlTemplate: string; + }; export type JoinDescriptor = { leftField: string; right: ESTermSourceDescriptor; }; +export type SourceDescriptor = + | XYZTMSSourceDescriptor + | WMSSourceDescriptor + | KibanaTilemapSourceDescriptor + | KibanaRegionmapSourceDescriptor + | ESTermSourceDescriptor + | ESSearchSourceDescriptor + | ESGeoGridSourceDescriptor + | EMSFileSourceDescriptor; + export type LayerDescriptor = { __dataRequests?: DataRequestDescriptor[]; __isInErrorState?: boolean; @@ -104,7 +118,7 @@ export type LayerDescriptor = { label?: string; minZoom?: number; maxZoom?: number; - sourceDescriptor: AbstractSourceDescriptor; + sourceDescriptor: SourceDescriptor; type?: string; visible?: boolean; }; diff --git a/x-pack/plugins/maps/public/layers/blended_vector_layer.ts b/x-pack/plugins/maps/public/layers/blended_vector_layer.ts index f5526ad703dd2..80bf0299380d9 100644 --- a/x-pack/plugins/maps/public/layers/blended_vector_layer.ts +++ b/x-pack/plugins/maps/public/layers/blended_vector_layer.ts @@ -34,6 +34,7 @@ import { VectorStyleDescriptor, SizeDynamicOptions, DynamicStylePropertyOptions, + VectorLayerDescriptor, } from '../../common/descriptor_types'; const ACTIVE_COUNT_DATA_ID = 'ACTIVE_COUNT_DATA_ID'; @@ -147,7 +148,10 @@ function getClusterStyleDescriptor( export class BlendedVectorLayer extends VectorLayer implements IVectorLayer { static type = LAYER_TYPE.BLENDED_VECTOR; - static createDescriptor(options: VectorLayerArguments, mapColors: string[]) { + static createDescriptor( + options: VectorLayerDescriptor, + mapColors: string[] + ): VectorLayerDescriptor { const layerDescriptor = VectorLayer.createDescriptor(options, mapColors); layerDescriptor.type = BlendedVectorLayer.type; return layerDescriptor; diff --git a/x-pack/plugins/maps/public/layers/layer.d.ts b/x-pack/plugins/maps/public/layers/layer.d.ts index de59642ede8ab..8fb69734d3d06 100644 --- a/x-pack/plugins/maps/public/layers/layer.d.ts +++ b/x-pack/plugins/maps/public/layers/layer.d.ts @@ -25,6 +25,7 @@ export interface ILayerArguments { } export class AbstractLayer implements ILayer { + static createDescriptor(options: Partial<LayerDescriptor>, mapColors?: string[]): LayerDescriptor; constructor(layerArguments: ILayerArguments); getBounds(mapFilters: MapFilters): Promise<MapExtent>; getDataRequest(id: string): DataRequest | undefined; diff --git a/x-pack/plugins/maps/public/layers/layer_wizard_registry.ts b/x-pack/plugins/maps/public/layers/layer_wizard_registry.ts index 3ef4701269994..cb87aeaa9da3f 100644 --- a/x-pack/plugins/maps/public/layers/layer_wizard_registry.ts +++ b/x-pack/plugins/maps/public/layers/layer_wizard_registry.ts @@ -5,17 +5,21 @@ */ /* eslint-disable @typescript-eslint/consistent-type-definitions */ -type LayerWizard = { +import { ReactElement } from 'react'; +import { ISource } from './sources/source'; + +export type PreviewSourceHandler = (source: ISource | null) => void; + +export type RenderWizardArguments = { + onPreviewSource: PreviewSourceHandler; + inspectorAdapters: object; +}; + +export type LayerWizard = { description: string; icon: string; isIndexingSource?: boolean; - renderWizard({ - onPreviewSource, - inspectorAdapters, - }: { - onPreviewSource: () => void; - inspectorAdapters: unknown; - }): unknown; + renderWizard(renderWizardArguments: RenderWizardArguments): ReactElement<any>; title: string; }; diff --git a/x-pack/plugins/maps/public/layers/sources/es_agg_source.d.ts b/x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.d.ts similarity index 73% rename from x-pack/plugins/maps/public/layers/sources/es_agg_source.d.ts rename to x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.d.ts index 99ee1ec652b54..a93f9121d1e62 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_agg_source.d.ts +++ b/x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.d.ts @@ -4,11 +4,11 @@ * you may not use this file except in compliance with the Elastic License. */ -import { IESSource } from './es_source'; -import { AbstractESSource } from './es_source'; -import { AGG_TYPE } from '../../../common/constants'; -import { IESAggField } from '../fields/es_agg_field'; -import { AbstractESAggSourceDescriptor } from '../../../common/descriptor_types'; +import { IESSource } from '../es_source'; +import { AbstractESSource } from '../es_source'; +import { AGG_TYPE } from '../../../../common/constants'; +import { IESAggField } from '../../fields/es_agg_field'; +import { AbstractESAggSourceDescriptor } from '../../../../common/descriptor_types'; export interface IESAggSource extends IESSource { getAggKey(aggType: AGG_TYPE, fieldName: string): string; diff --git a/x-pack/plugins/maps/public/layers/sources/es_agg_source.js b/x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.js similarity index 95% rename from x-pack/plugins/maps/public/layers/sources/es_agg_source.js rename to x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.js index 9f4b89cadc777..c6197f137f212 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_agg_source.js +++ b/x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.js @@ -5,15 +5,15 @@ */ import { i18n } from '@kbn/i18n'; -import { AbstractESSource } from './es_source'; -import { esAggFieldsFactory } from '../fields/es_agg_field'; +import { AbstractESSource } from '../es_source'; +import { esAggFieldsFactory } from '../../fields/es_agg_field'; import { AGG_TYPE, COUNT_PROP_LABEL, COUNT_PROP_NAME, FIELD_ORIGIN, -} from '../../../common/constants'; +} from '../../../../common/constants'; export const AGG_DELIMITER = '_of_'; diff --git a/x-pack/plugins/maps/public/layers/sources/es_agg_source.test.ts b/x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.test.ts similarity index 89% rename from x-pack/plugins/maps/public/layers/sources/es_agg_source.test.ts rename to x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.test.ts index 848091586eb9c..87abbedfdf50e 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_agg_source.test.ts +++ b/x-pack/plugins/maps/public/layers/sources/es_agg_source/es_agg_source.test.ts @@ -4,12 +4,12 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AbstractESAggSource } from './es_agg_source'; -import { IField } from '../fields/field'; -import { IESAggField } from '../fields/es_agg_field'; +import { AbstractESAggSource } from '../es_agg_source'; +import { IField } from '../../fields/field'; +import { IESAggField } from '../../fields/es_agg_field'; import _ from 'lodash'; -import { AGG_TYPE } from '../../../common/constants'; -import { AggDescriptor } from '../../../common/descriptor_types'; +import { AGG_TYPE } from '../../../../common/constants'; +import { AggDescriptor } from '../../../../common/descriptor_types'; jest.mock('ui/new_platform'); diff --git a/x-pack/plugins/maps/public/layers/sources/es_agg_source/index.ts b/x-pack/plugins/maps/public/layers/sources/es_agg_source/index.ts new file mode 100644 index 0000000000000..cbf4eceefd432 --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/es_agg_source/index.ts @@ -0,0 +1,7 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export * from './es_agg_source'; diff --git a/x-pack/plugins/maps/public/layers/sources/es_source.d.ts b/x-pack/plugins/maps/public/layers/sources/es_source/es_source.d.ts similarity index 78% rename from x-pack/plugins/maps/public/layers/sources/es_source.d.ts rename to x-pack/plugins/maps/public/layers/sources/es_source/es_source.d.ts index 65851d0e7bd38..092dc3bf0d5a8 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_source.d.ts +++ b/x-pack/plugins/maps/public/layers/sources/es_source/es_source.d.ts @@ -4,10 +4,10 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AbstractVectorSource } from './vector_source'; -import { IVectorSource } from './vector_source'; -import { IndexPattern, SearchSource } from '../../../../../../src/plugins/data/public'; -import { VectorSourceRequestMeta } from '../../../common/descriptor_types'; +import { AbstractVectorSource } from '../vector_source'; +import { IVectorSource } from '../vector_source'; +import { IndexPattern, SearchSource } from '../../../../../../../src/plugins/data/public'; +import { VectorSourceRequestMeta } from '../../../../common/descriptor_types'; export interface IESSource extends IVectorSource { getId(): string; diff --git a/x-pack/plugins/maps/public/layers/sources/es_source.js b/x-pack/plugins/maps/public/layers/sources/es_source/es_source.js similarity index 95% rename from x-pack/plugins/maps/public/layers/sources/es_source.js rename to x-pack/plugins/maps/public/layers/sources/es_source/es_source.js index d90a802a38344..3402e367cbd73 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_source.js +++ b/x-pack/plugins/maps/public/layers/sources/es_source/es_source.js @@ -4,23 +4,23 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AbstractVectorSource } from './vector_source'; +import { AbstractVectorSource } from '../vector_source'; import { getAutocompleteService, fetchSearchSourceAndRecordWithInspector, getIndexPatternService, SearchSource, getTimeFilter, -} from '../../kibana_services'; -import { createExtentFilter } from '../../elasticsearch_geo_utils'; +} from '../../../kibana_services'; +import { createExtentFilter } from '../../../elasticsearch_geo_utils'; import _ from 'lodash'; import { i18n } from '@kbn/i18n'; import uuid from 'uuid/v4'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths -import { copyPersistentState } from '../../reducers/util'; -import { ES_GEO_FIELD_TYPE } from '../../../common/constants'; -import { DataRequestAbortError } from '../util/data_request'; -import { expandToTileBoundaries } from './es_geo_grid_source/geo_tile_utils'; +import { copyPersistentState } from '../../../reducers/util'; +import { ES_GEO_FIELD_TYPE } from '../../../../common/constants'; +import { DataRequestAbortError } from '../../util/data_request'; +import { expandToTileBoundaries } from '../es_geo_grid_source/geo_tile_utils'; export class AbstractESSource extends AbstractVectorSource { constructor(descriptor, inspectorAdapters) { diff --git a/x-pack/plugins/maps/public/layers/sources/es_source/index.ts b/x-pack/plugins/maps/public/layers/sources/es_source/index.ts new file mode 100644 index 0000000000000..227a4dd634457 --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/es_source/index.ts @@ -0,0 +1,7 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export * from './es_source'; diff --git a/x-pack/plugins/maps/public/layers/sources/es_term_source.d.ts b/x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.d.ts similarity index 77% rename from x-pack/plugins/maps/public/layers/sources/es_term_source.d.ts rename to x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.d.ts index 44cdc851b4fc7..701bd5e2c8b5e 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_term_source.d.ts +++ b/x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.d.ts @@ -4,8 +4,8 @@ * you may not use this file except in compliance with the Elastic License. */ -import { IField } from '../fields/field'; -import { IESAggSource } from './es_agg_source'; +import { IField } from '../../fields/field'; +import { IESAggSource } from '../es_agg_source'; export interface IESTermSource extends IESAggSource { getTermField(): IField; diff --git a/x-pack/plugins/maps/public/layers/sources/es_term_source.js b/x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.js similarity index 95% rename from x-pack/plugins/maps/public/layers/sources/es_term_source.js rename to x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.js index 3ce0fb58aba19..826197cc4fec7 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_term_source.js +++ b/x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.js @@ -7,10 +7,10 @@ import _ from 'lodash'; import { i18n } from '@kbn/i18n'; -import { DEFAULT_MAX_BUCKETS_LIMIT, FIELD_ORIGIN, AGG_TYPE } from '../../../common/constants'; -import { ESDocField } from '../fields/es_doc_field'; -import { AbstractESAggSource, AGG_DELIMITER } from './es_agg_source'; -import { getField, addFieldToDSL, extractPropertiesFromBucket } from '../util/es_agg_utils'; +import { DEFAULT_MAX_BUCKETS_LIMIT, FIELD_ORIGIN, AGG_TYPE } from '../../../../common/constants'; +import { ESDocField } from '../../fields/es_doc_field'; +import { AbstractESAggSource, AGG_DELIMITER } from '../es_agg_source'; +import { getField, addFieldToDSL, extractPropertiesFromBucket } from '../../util/es_agg_utils'; const TERMS_AGG_NAME = 'join'; diff --git a/x-pack/plugins/maps/public/layers/sources/es_term_source.test.js b/x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.test.js similarity index 98% rename from x-pack/plugins/maps/public/layers/sources/es_term_source.test.js rename to x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.test.js index 14ffd068df465..b6cd3b670d3ce 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_term_source.test.js +++ b/x-pack/plugins/maps/public/layers/sources/es_term_source/es_term_source.test.js @@ -7,7 +7,7 @@ import { ESTermSource, extractPropertiesMap } from './es_term_source'; jest.mock('ui/new_platform'); -jest.mock('../vector_layer', () => {}); +jest.mock('../../vector_layer', () => {}); const indexPatternTitle = 'myIndex'; const termFieldName = 'myTermField'; diff --git a/x-pack/plugins/maps/public/layers/sources/es_term_source/index.ts b/x-pack/plugins/maps/public/layers/sources/es_term_source/index.ts new file mode 100644 index 0000000000000..6fad8384c690d --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/es_term_source/index.ts @@ -0,0 +1,7 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export * from './es_term_source'; diff --git a/x-pack/plugins/maps/public/layers/sources/source.d.ts b/x-pack/plugins/maps/public/layers/sources/source.d.ts index e1706ad7b7d77..a1581b826d9a6 100644 --- a/x-pack/plugins/maps/public/layers/sources/source.d.ts +++ b/x-pack/plugins/maps/public/layers/sources/source.d.ts @@ -3,10 +3,21 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ +/* eslint-disable @typescript-eslint/consistent-type-definitions */ -import { AbstractSourceDescriptor } from '../../../common/descriptor_types'; +import { AbstractSourceDescriptor, LayerDescriptor } from '../../../common/descriptor_types'; import { ILayer } from '../layer'; +export type ImmutableSourceProperty = { + label: string; + value: string; +}; + +export type Attribution = { + url: string; + label: string; +}; + export interface ISource { createDefaultLayer(): ILayer; destroy(): void; @@ -18,13 +29,16 @@ export interface ISource { isQueryAware(): boolean; isRefreshTimerAware(): Promise<boolean>; isTimeAware(): Promise<boolean>; + getImmutableProperties(): Promise<ImmutableSourceProperty[]>; + getAttributions(): Promise<Attribution[]>; } export class AbstractSource implements ISource { - constructor(sourceDescriptor: AbstractSourceDescriptor, inspectorAdapters: object); + readonly _descriptor: AbstractSourceDescriptor; + constructor(sourceDescriptor: AbstractSourceDescriptor, inspectorAdapters?: object); destroy(): void; - createDefaultLayer(): ILayer; + createDefaultLayer(options?: LayerDescriptor, mapColors?: string[]): ILayer; getDisplayName(): Promise<string>; getInspectorAdapters(): object; isFieldAware(): boolean; @@ -33,4 +47,6 @@ export class AbstractSource implements ISource { isQueryAware(): boolean; isRefreshTimerAware(): Promise<boolean>; isTimeAware(): Promise<boolean>; + getImmutableProperties(): Promise<ImmutableSourceProperty[]>; + getAttributions(): Promise<Attribution[]>; } diff --git a/x-pack/plugins/maps/public/layers/sources/source_registry.ts b/x-pack/plugins/maps/public/layers/sources/source_registry.ts index 518cab68b601b..d16b16af74e9d 100644 --- a/x-pack/plugins/maps/public/layers/sources/source_registry.ts +++ b/x-pack/plugins/maps/public/layers/sources/source_registry.ts @@ -5,12 +5,11 @@ */ /* eslint-disable @typescript-eslint/consistent-type-definitions */ -import { AbstractSourceDescriptor } from '../../../common/descriptor_types'; import { ISource } from './source'; type SourceRegistryEntry = { ConstructorFunction: new ( - sourceDescriptor: AbstractSourceDescriptor, + sourceDescriptor: any, // this is the source-descriptor that corresponds specifically to the particular ISource instance inspectorAdapters: unknown ) => ISource; type: string; diff --git a/x-pack/plugins/maps/public/layers/sources/tms_source/index.ts b/x-pack/plugins/maps/public/layers/sources/tms_source/index.ts new file mode 100644 index 0000000000000..f6bb1c6bc34ec --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/tms_source/index.ts @@ -0,0 +1,7 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export * from './tms_source'; diff --git a/x-pack/plugins/maps/public/layers/sources/tms_source.d.ts b/x-pack/plugins/maps/public/layers/sources/tms_source/tms_source.d.ts similarity index 80% rename from x-pack/plugins/maps/public/layers/sources/tms_source.d.ts rename to x-pack/plugins/maps/public/layers/sources/tms_source/tms_source.d.ts index 90b6f28e050fd..b31138f4cdb86 100644 --- a/x-pack/plugins/maps/public/layers/sources/tms_source.d.ts +++ b/x-pack/plugins/maps/public/layers/sources/tms_source/tms_source.d.ts @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AbstractSource, ISource } from './source'; +import { AbstractSource, Attribution, ISource } from '../source'; export interface ITMSSource extends ISource { getUrlTemplate(): Promise<string>; @@ -12,4 +12,5 @@ export interface ITMSSource extends ISource { export class AbstractTMSSource extends AbstractSource implements ITMSSource { getUrlTemplate(): Promise<string>; + getAttributions(): Promise<Attribution[]>; } diff --git a/x-pack/plugins/maps/public/layers/sources/tms_source.js b/x-pack/plugins/maps/public/layers/sources/tms_source/tms_source.js similarity index 94% rename from x-pack/plugins/maps/public/layers/sources/tms_source.js rename to x-pack/plugins/maps/public/layers/sources/tms_source/tms_source.js index f2ec9f2a29378..13b8da11633bc 100644 --- a/x-pack/plugins/maps/public/layers/sources/tms_source.js +++ b/x-pack/plugins/maps/public/layers/sources/tms_source/tms_source.js @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { AbstractSource } from './source'; +import { AbstractSource } from '../source'; export class AbstractTMSSource extends AbstractSource { async getUrlTemplate() { diff --git a/x-pack/plugins/maps/public/layers/sources/vector_source/index.ts b/x-pack/plugins/maps/public/layers/sources/vector_source/index.ts new file mode 100644 index 0000000000000..62e801d027634 --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/vector_source/index.ts @@ -0,0 +1,7 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export * from './vector_source'; diff --git a/x-pack/plugins/maps/public/layers/sources/vector_source.d.ts b/x-pack/plugins/maps/public/layers/sources/vector_source/vector_source.d.ts similarity index 91% rename from x-pack/plugins/maps/public/layers/sources/vector_source.d.ts rename to x-pack/plugins/maps/public/layers/sources/vector_source/vector_source.d.ts index d597e64277186..63429830d9f4f 100644 --- a/x-pack/plugins/maps/public/layers/sources/vector_source.d.ts +++ b/x-pack/plugins/maps/public/layers/sources/vector_source/vector_source.d.ts @@ -6,14 +6,14 @@ /* eslint-disable @typescript-eslint/consistent-type-definitions */ import { FeatureCollection } from 'geojson'; -import { AbstractSource, ISource } from './source'; -import { IField } from '../fields/field'; +import { AbstractSource, ISource } from '../source'; +import { IField } from '../../fields/field'; import { ESSearchSourceResponseMeta, MapExtent, VectorSourceRequestMeta, VectorSourceSyncMeta, -} from '../../../common/descriptor_types'; +} from '../../../../common/descriptor_types'; export type GeoJsonFetchMeta = ESSearchSourceResponseMeta; diff --git a/x-pack/plugins/maps/public/layers/sources/vector_source.js b/x-pack/plugins/maps/public/layers/sources/vector_source/vector_source.js similarity index 93% rename from x-pack/plugins/maps/public/layers/sources/vector_source.js rename to x-pack/plugins/maps/public/layers/sources/vector_source/vector_source.js index 7f97b1b21d189..bb37175b48655 100644 --- a/x-pack/plugins/maps/public/layers/sources/vector_source.js +++ b/x-pack/plugins/maps/public/layers/sources/vector_source/vector_source.js @@ -4,14 +4,14 @@ * you may not use this file except in compliance with the Elastic License. */ -import { VectorLayer } from '../vector_layer'; -import { TooltipProperty } from '../tooltips/tooltip_property'; -import { VectorStyle } from '../styles/vector/vector_style'; -import { AbstractSource } from './source'; +import { VectorLayer } from '../../vector_layer'; +import { TooltipProperty } from '../../tooltips/tooltip_property'; +import { VectorStyle } from '../../styles/vector/vector_style'; +import { AbstractSource } from './../source'; import * as topojson from 'topojson-client'; import _ from 'lodash'; import { i18n } from '@kbn/i18n'; -import { VECTOR_SHAPE_TYPES } from './vector_feature_types'; +import { VECTOR_SHAPE_TYPES } from './../vector_feature_types'; export class AbstractVectorSource extends AbstractSource { static async getGeoJson({ format, featureCollectionPath, fetchUrl }) { diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.d.ts b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.d.ts deleted file mode 100644 index 579c9debeab3e..0000000000000 --- a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.d.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import { AbstractTMSSource } from './tms_source'; -import { XYZTMSSourceDescriptor } from '../../../common/descriptor_types'; - -export class XYZTMSSource extends AbstractTMSSource { - constructor(sourceDescriptor: XYZTMSSourceDescriptor, inspectorAdapters: unknown); -} diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.js b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.js deleted file mode 100644 index d53fbffd21512..0000000000000 --- a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.js +++ /dev/null @@ -1,187 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React, { Fragment } from 'react'; -import { EuiFieldText, EuiFormRow } from '@elastic/eui'; - -import { AbstractTMSSource } from './tms_source'; -import { TileLayer } from '../tile_layer'; -import { i18n } from '@kbn/i18n'; -import { getDataSourceLabel, getUrlLabel } from '../../../common/i18n_getters'; -import _ from 'lodash'; -import { EMS_XYZ } from '../../../common/constants'; -import { registerSource } from './source_registry'; - -const sourceTitle = i18n.translate('xpack.maps.source.ems_xyzTitle', { - defaultMessage: 'Tile Map Service', -}); - -export class XYZTMSSource extends AbstractTMSSource { - static type = EMS_XYZ; - - static createDescriptor({ urlTemplate, attributionText, attributionUrl }) { - return { - type: XYZTMSSource.type, - urlTemplate, - attributionText, - attributionUrl, - }; - } - - async getImmutableProperties() { - return [ - { label: getDataSourceLabel(), value: sourceTitle }, - { label: getUrlLabel(), value: this._descriptor.urlTemplate }, - ]; - } - - _createDefaultLayerDescriptor(options) { - return TileLayer.createDescriptor({ - sourceDescriptor: this._descriptor, - ...options, - }); - } - - createDefaultLayer(options) { - return new TileLayer({ - layerDescriptor: this._createDefaultLayerDescriptor(options), - source: this, - }); - } - - async getDisplayName() { - return this._descriptor.urlTemplate; - } - - getAttributions() { - const { attributionText, attributionUrl } = this._descriptor; - const attributionComplete = !!attributionText && !!attributionUrl; - - return attributionComplete - ? [ - { - url: attributionUrl, - label: attributionText, - }, - ] - : []; - } - - getUrlTemplate() { - return this._descriptor.urlTemplate; - } -} - -class XYZTMSEditor extends React.Component { - state = { - tmsInput: '', - tmsCanPreview: false, - attributionText: '', - attributionUrl: '', - }; - - _sourceConfigChange = _.debounce(updatedSourceConfig => { - if (this.state.tmsCanPreview) { - this.props.onSourceConfigChange(updatedSourceConfig); - } - }, 2000); - - _handleTMSInputChange(e) { - const url = e.target.value; - - const canPreview = - url.indexOf('{x}') >= 0 && url.indexOf('{y}') >= 0 && url.indexOf('{z}') >= 0; - this.setState( - { - tmsInput: url, - tmsCanPreview: canPreview, - }, - () => this._sourceConfigChange({ urlTemplate: url }) - ); - } - - _handleTMSAttributionChange(attributionUpdate) { - this.setState(attributionUpdate, () => { - const { attributionText, attributionUrl, tmsInput } = this.state; - - if (tmsInput && attributionText && attributionUrl) { - this._sourceConfigChange({ - urlTemplate: tmsInput, - attributionText, - attributionUrl, - }); - } - }); - } - - render() { - const { attributionText, attributionUrl } = this.state; - - return ( - <Fragment> - <EuiFormRow label="Url"> - <EuiFieldText - placeholder={'https://a.tile.openstreetmap.org/{z}/{x}/{y}.png'} - onChange={e => this._handleTMSInputChange(e)} - /> - </EuiFormRow> - <EuiFormRow - label="Attribution text" - isInvalid={attributionUrl !== '' && attributionText === ''} - error={[ - i18n.translate('xpack.maps.xyztmssource.attributionText', { - defaultMessage: 'Attribution url must have accompanying text', - }), - ]} - > - <EuiFieldText - placeholder={'© OpenStreetMap contributors'} - onChange={({ target }) => - this._handleTMSAttributionChange({ attributionText: target.value }) - } - /> - </EuiFormRow> - <EuiFormRow - label="Attribution link" - isInvalid={attributionText !== '' && attributionUrl === ''} - error={[ - i18n.translate('xpack.maps.xyztmssource.attributionLink', { - defaultMessage: 'Attribution text must have an accompanying link', - }), - ]} - > - <EuiFieldText - placeholder={'https://www.openstreetmap.org/copyright'} - onChange={({ target }) => - this._handleTMSAttributionChange({ attributionUrl: target.value }) - } - /> - </EuiFormRow> - </Fragment> - ); - } -} - -registerSource({ - ConstructorFunction: XYZTMSSource, - type: EMS_XYZ, -}); - -export const tmsLayerWizardConfig = { - description: i18n.translate('xpack.maps.source.ems_xyzDescription', { - defaultMessage: 'Tile map service configured in interface', - }), - icon: 'grid', - renderWizard: ({ onPreviewSource, inspectorAdapters }) => { - const onSourceConfigChange = sourceConfig => { - const sourceDescriptor = XYZTMSSource.createDescriptor(sourceConfig); - const source = new XYZTMSSource(sourceDescriptor, inspectorAdapters); - onPreviewSource(source); - }; - return <XYZTMSEditor onSourceConfigChange={onSourceConfigChange} />; - }, - title: sourceTitle, -}; diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/index.ts b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/index.ts new file mode 100644 index 0000000000000..c1116ad47a375 --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/index.ts @@ -0,0 +1,8 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export * from './xyz_tms_source'; +export * from './layer_wizard'; diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/layer_wizard.tsx b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/layer_wizard.tsx new file mode 100644 index 0000000000000..8b1ed588c8dd1 --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/layer_wizard.tsx @@ -0,0 +1,27 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { i18n } from '@kbn/i18n'; +import React from 'react'; +import { XYZTMSEditor, XYZTMSSourceConfig } from './xyz_tms_editor'; +import { XYZTMSSource, sourceTitle } from './xyz_tms_source'; +import { LayerWizard, RenderWizardArguments } from '../../layer_wizard_registry'; + +export const tmsLayerWizardConfig: LayerWizard = { + description: i18n.translate('xpack.maps.source.ems_xyzDescription', { + defaultMessage: 'Tile map service configured in interface', + }), + icon: 'grid', + renderWizard: ({ onPreviewSource }: RenderWizardArguments) => { + const onSourceConfigChange = (sourceConfig: XYZTMSSourceConfig) => { + const sourceDescriptor = XYZTMSSource.createDescriptor(sourceConfig); + const source = new XYZTMSSource(sourceDescriptor); + onPreviewSource(source); + }; + return <XYZTMSEditor onSourceConfigChange={onSourceConfigChange} />; + }, + title: sourceTitle, +}; diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_editor.tsx b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_editor.tsx new file mode 100644 index 0000000000000..0ee0fbb23bcff --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_editor.tsx @@ -0,0 +1,122 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +/* eslint-disable @typescript-eslint/consistent-type-definitions */ + +import React, { Fragment, Component, ChangeEvent } from 'react'; +import _ from 'lodash'; +import { EuiFormRow, EuiFieldText } from '@elastic/eui'; +import { i18n } from '@kbn/i18n'; +import { AttributionDescriptor } from '../../../../common/descriptor_types'; + +export type XYZTMSSourceConfig = AttributionDescriptor & { + urlTemplate: string; +}; + +export interface Props { + onSourceConfigChange: (sourceConfig: XYZTMSSourceConfig) => void; +} + +interface State { + tmsInput: string; + tmsCanPreview: boolean; + attributionText: string; + attributionUrl: string; +} + +export class XYZTMSEditor extends Component<Props, State> { + state = { + tmsInput: '', + tmsCanPreview: false, + attributionText: '', + attributionUrl: '', + }; + + _sourceConfigChange = _.debounce((updatedSourceConfig: XYZTMSSourceConfig) => { + if (this.state.tmsCanPreview) { + this.props.onSourceConfigChange(updatedSourceConfig); + } + }, 2000); + + _handleTMSInputChange(e: ChangeEvent<HTMLInputElement>) { + const url = e.target.value; + + const canPreview = + url.indexOf('{x}') >= 0 && url.indexOf('{y}') >= 0 && url.indexOf('{z}') >= 0; + this.setState( + { + tmsInput: url, + tmsCanPreview: canPreview, + }, + () => this._sourceConfigChange({ urlTemplate: url }) + ); + } + + _handleTMSAttributionChange(attributionUpdate: AttributionDescriptor) { + this.setState( + { + attributionUrl: attributionUpdate.attributionUrl || '', + attributionText: attributionUpdate.attributionText || '', + }, + () => { + const { attributionText, attributionUrl, tmsInput } = this.state; + + if (tmsInput && attributionText && attributionUrl) { + this._sourceConfigChange({ + urlTemplate: tmsInput, + attributionText, + attributionUrl, + }); + } + } + ); + } + + render() { + const { attributionText, attributionUrl } = this.state; + return ( + <Fragment> + <EuiFormRow label="Url"> + <EuiFieldText + placeholder={'https://a.tile.openstreetmap.org/{z}/{x}/{y}.png'} + onChange={e => this._handleTMSInputChange(e)} + /> + </EuiFormRow> + <EuiFormRow + label="Attribution text" + isInvalid={attributionUrl !== '' && attributionText === ''} + error={[ + i18n.translate('xpack.maps.xyztmssource.attributionText', { + defaultMessage: 'Attribution url must have accompanying text', + }), + ]} + > + <EuiFieldText + placeholder={'© OpenStreetMap contributors'} + onChange={({ target }: ChangeEvent<HTMLInputElement>) => + this._handleTMSAttributionChange({ attributionText: target.value }) + } + /> + </EuiFormRow> + <EuiFormRow + label="Attribution link" + isInvalid={attributionText !== '' && attributionUrl === ''} + error={[ + i18n.translate('xpack.maps.xyztmssource.attributionLink', { + defaultMessage: 'Attribution text must have an accompanying link', + }), + ]} + > + <EuiFieldText + placeholder={'https://www.openstreetmap.org/copyright'} + onChange={({ target }: ChangeEvent<HTMLInputElement>) => + this._handleTMSAttributionChange({ attributionUrl: target.value }) + } + /> + </EuiFormRow> + </Fragment> + ); + } +} diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.test.ts b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts similarity index 71% rename from x-pack/plugins/maps/public/layers/sources/xyz_tms_source.test.ts rename to x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts index e5ab5e57122ba..8a5cfb01e5821 100644 --- a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source.test.ts +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts @@ -5,10 +5,10 @@ */ import { XYZTMSSource } from './xyz_tms_source'; -import { ILayer } from '../layer'; -import { TileLayer } from '../tile_layer'; -import { EMS_XYZ } from '../../../common/constants'; -import { XYZTMSSourceDescriptor } from '../../../common/descriptor_types'; +import { ILayer } from '../../layer'; +import { TileLayer } from '../../tile_layer'; +import { EMS_XYZ } from '../../../../common/constants'; +import { XYZTMSSourceDescriptor } from '../../../../common/descriptor_types'; const descriptor: XYZTMSSourceDescriptor = { type: EMS_XYZ, @@ -17,13 +17,13 @@ const descriptor: XYZTMSSourceDescriptor = { }; describe('xyz Tilemap Source', () => { it('should create a tile-layer', () => { - const source = new XYZTMSSource(descriptor, null); + const source = new XYZTMSSource(descriptor); const layer: ILayer = source.createDefaultLayer(); expect(layer instanceof TileLayer).toEqual(true); }); it('should echo url template for url template', async () => { - const source = new XYZTMSSource(descriptor, null); + const source = new XYZTMSSource(descriptor); const template = await source.getUrlTemplate(); expect(template).toEqual(descriptor.urlTemplate); }); diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts new file mode 100644 index 0000000000000..dd96c31573316 --- /dev/null +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts @@ -0,0 +1,87 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { i18n } from '@kbn/i18n'; +import { TileLayer } from '../../tile_layer'; +import { getDataSourceLabel, getUrlLabel } from '../../../../common/i18n_getters'; +import { EMS_XYZ } from '../../../../common/constants'; +import { registerSource } from '../source_registry'; +import { AbstractTMSSource } from '../tms_source'; +import { LayerDescriptor, XYZTMSSourceDescriptor } from '../../../../common/descriptor_types'; +import { Attribution, ImmutableSourceProperty } from '../source'; +import { XYZTMSSourceConfig } from './xyz_tms_editor'; + +export const sourceTitle = i18n.translate('xpack.maps.source.ems_xyzTitle', { + defaultMessage: 'Tile Map Service', +}); + +export class XYZTMSSource extends AbstractTMSSource { + static type = EMS_XYZ; + + readonly _descriptor: XYZTMSSourceDescriptor; + + static createDescriptor({ + urlTemplate, + attributionText, + attributionUrl, + }: XYZTMSSourceConfig): XYZTMSSourceDescriptor { + return { + type: XYZTMSSource.type, + urlTemplate, + attributionText, + attributionUrl, + }; + } + + constructor(sourceDescriptor: XYZTMSSourceDescriptor) { + super(sourceDescriptor); + this._descriptor = sourceDescriptor; + } + + async getImmutableProperties(): Promise<ImmutableSourceProperty[]> { + return [ + { label: getDataSourceLabel(), value: sourceTitle }, + { label: getUrlLabel(), value: this._descriptor.urlTemplate }, + ]; + } + + createDefaultLayer(options?: LayerDescriptor): TileLayer { + const layerDescriptor: LayerDescriptor = TileLayer.createDescriptor({ + sourceDescriptor: this._descriptor, + ...options, + }); + return new TileLayer({ + layerDescriptor, + source: this, + }); + } + + async getDisplayName(): Promise<string> { + return this._descriptor.urlTemplate; + } + + async getAttributions(): Promise<Attribution[]> { + const { attributionText, attributionUrl } = this._descriptor; + const attributionComplete = !!attributionText && !!attributionUrl; + return attributionComplete + ? [ + { + url: attributionUrl as string, + label: attributionText as string, + }, + ] + : []; + } + + async getUrlTemplate(): Promise<string> { + return this._descriptor.urlTemplate; + } +} + +registerSource({ + ConstructorFunction: XYZTMSSource, + type: EMS_XYZ, +}); diff --git a/x-pack/plugins/maps/public/layers/tile_layer.js b/x-pack/plugins/maps/public/layers/tile_layer.js index aa2619e96f834..2ac60e12d137a 100644 --- a/x-pack/plugins/maps/public/layers/tile_layer.js +++ b/x-pack/plugins/maps/public/layers/tile_layer.js @@ -11,8 +11,8 @@ import { SOURCE_DATA_ID_ORIGIN, LAYER_TYPE } from '../../common/constants'; export class TileLayer extends AbstractLayer { static type = LAYER_TYPE.TILE; - static createDescriptor(options) { - const tileLayerDescriptor = super.createDescriptor(options); + static createDescriptor(options, mapColors) { + const tileLayerDescriptor = super.createDescriptor(options, mapColors); tileLayerDescriptor.type = TileLayer.type; tileLayerDescriptor.alpha = _.get(options, 'alpha', 1); return tileLayerDescriptor; diff --git a/x-pack/plugins/maps/public/layers/tile_layer.test.ts b/x-pack/plugins/maps/public/layers/tile_layer.test.ts index 1cb99dcbc1a70..43465eac7f3ce 100644 --- a/x-pack/plugins/maps/public/layers/tile_layer.test.ts +++ b/x-pack/plugins/maps/public/layers/tile_layer.test.ts @@ -17,7 +17,7 @@ const sourceDescriptor: XYZTMSSourceDescriptor = { }; class MockTileSource extends AbstractTMSSource implements ITMSSource { - private readonly _descriptor: XYZTMSSourceDescriptor; + readonly _descriptor: XYZTMSSourceDescriptor; constructor(descriptor: XYZTMSSourceDescriptor) { super(descriptor, {}); this._descriptor = descriptor; diff --git a/x-pack/plugins/maps/public/layers/vector_layer.d.ts b/x-pack/plugins/maps/public/layers/vector_layer.d.ts index 70fd9927b7732..88b1a1ce8535e 100644 --- a/x-pack/plugins/maps/public/layers/vector_layer.d.ts +++ b/x-pack/plugins/maps/public/layers/vector_layer.d.ts @@ -32,8 +32,8 @@ export interface IVectorLayer extends ILayer { export class VectorLayer extends AbstractLayer implements IVectorLayer { static createDescriptor( - options: VectorLayerArguments, - mapColors: string[] + options: Partial<VectorLayerDescriptor>, + mapColors?: string[] ): VectorLayerDescriptor; protected readonly _source: IVectorSource; From e74d360adb1acfa2b4316d75d9ca5da56c9437e4 Mon Sep 17 00:00:00 2001 From: MadameSheema <snootchie.boochies@gmail.com> Date: Mon, 13 Apr 2020 15:38:32 +0200 Subject: [PATCH 054/102] fixes test flakiness (#63331) --- .../signal_detection_rules.spec.ts | 31 ++++++++++++++++--- 1 file changed, 26 insertions(+), 5 deletions(-) diff --git a/x-pack/legacy/plugins/siem/cypress/integration/signal_detection_rules.spec.ts b/x-pack/legacy/plugins/siem/cypress/integration/signal_detection_rules.spec.ts index 2d2db9e70255b..ce6a49b675ef1 100644 --- a/x-pack/legacy/plugins/siem/cypress/integration/signal_detection_rules.spec.ts +++ b/x-pack/legacy/plugins/siem/cypress/integration/signal_detection_rules.spec.ts @@ -7,11 +7,16 @@ import { FIFTH_RULE, FIRST_RULE, RULE_NAME, + RULE_SWITCH, SECOND_RULE, SEVENTH_RULE, } from '../screens/signal_detection_rules'; -import { goToManageSignalDetectionRules } from '../tasks/detections'; +import { + goToManageSignalDetectionRules, + waitForSignalsPanelToBeLoaded, + waitForSignalsIndexToBeCreated, +} from '../tasks/detections'; import { esArchiverLoad, esArchiverUnload } from '../tasks/es_archiver'; import { loginAndWaitForPageWithoutDateRange } from '../tasks/login'; import { @@ -32,8 +37,10 @@ describe('Signal detection rules', () => { esArchiverUnload('prebuilt_rules_loaded'); }); - it.skip('Sorts by activated rules', () => { + it('Sorts by activated rules', () => { loginAndWaitForPageWithoutDateRange(DETECTIONS); + waitForSignalsPanelToBeLoaded(); + waitForSignalsIndexToBeCreated(); goToManageSignalDetectionRules(); waitForLoadElasticPrebuiltDetectionRulesTableToBeLoaded(); cy.get(RULE_NAME) @@ -52,10 +59,24 @@ describe('Signal detection rules', () => { cy.get(RULE_NAME) .eq(FIRST_RULE) - .should('have.text', fifthRuleName); - cy.get(RULE_NAME) + .invoke('text') + .then(firstRuleName => { + cy.get(RULE_NAME) + .eq(SECOND_RULE) + .invoke('text') + .then(secondRuleName => { + const expectedRulesNames = `${firstRuleName} ${secondRuleName}`; + cy.wrap(expectedRulesNames).should('include', fifthRuleName); + cy.wrap(expectedRulesNames).should('include', seventhRuleName); + }); + }); + + cy.get(RULE_SWITCH) + .eq(FIRST_RULE) + .should('have.attr', 'role', 'switch'); + cy.get(RULE_SWITCH) .eq(SECOND_RULE) - .should('have.text', seventhRuleName); + .should('have.attr', 'role', 'switch'); }); }); }); From c604eb9e63dcb7fe89b25bb4bc3b4a1b23e221d2 Mon Sep 17 00:00:00 2001 From: Nathan Reese <reese.nathan@gmail.com> Date: Mon, 13 Apr 2020 08:00:15 -0600 Subject: [PATCH 055/102] [Maps] fix regression in loading left join fields (#63325) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../maps/public/connected_components/layer_panel/index.js | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/x-pack/legacy/plugins/maps/public/connected_components/layer_panel/index.js b/x-pack/legacy/plugins/maps/public/connected_components/layer_panel/index.js index b3ad3d1df68ce..256f52112ba97 100644 --- a/x-pack/legacy/plugins/maps/public/connected_components/layer_panel/index.js +++ b/x-pack/legacy/plugins/maps/public/connected_components/layer_panel/index.js @@ -12,7 +12,7 @@ import { fitToLayerExtent, updateSourceProp } from '../../actions/map_actions'; function mapStateToProps(state = {}) { const selectedLayer = getSelectedLayer(state); return { - key: selectedLayer ? selectedLayer.getId() : '', + key: selectedLayer ? `${selectedLayer.getId()}${selectedLayer.isJoinable()}` : '', selectedLayer, }; } From 8cef9457c1f4d07bdf19fbc4679768f261699311 Mon Sep 17 00:00:00 2001 From: Nicolas Chaulet <nicolas.chaulet@elastic.co> Date: Mon, 13 Apr 2020 10:39:40 -0400 Subject: [PATCH 056/102] [Ingest] Update Create datasource UI to fit in one page (#62858) --- .../enrollment_instructions/shell/index.tsx | 2 +- .../ingest_manager/components/header.tsx | 37 +- .../components/confirm_modal.tsx | 72 ++++ .../components/index.ts | 1 + .../components/layout.tsx | 175 +++++---- .../components/navigation.tsx | 85 ----- .../create_datasource_page/constants.ts | 7 - .../create_datasource_page/index.tsx | 348 +++++++++--------- .../step_configure_datasource.tsx | 188 +--------- .../step_define_datasource.tsx | 165 +++++++++ .../create_datasource_page/step_review.tsx | 202 ---------- .../step_select_config.tsx | 78 +--- .../step_select_package.tsx | 54 +-- .../agent_enrollment_flyout/instructions.tsx | 2 +- .../sections/fleet/agent_list_page/index.tsx | 4 +- .../translations/translations/ja-JP.json | 20 - .../translations/translations/zh-CN.json | 20 - 17 files changed, 550 insertions(+), 910 deletions(-) create mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/confirm_modal.tsx delete mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx create mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_define_datasource.tsx delete mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_review.tsx diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/enrollment_instructions/shell/index.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/enrollment_instructions/shell/index.tsx index e6990927b926e..cb65e31fb74b5 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/enrollment_instructions/shell/index.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/enrollment_instructions/shell/index.tsx @@ -43,7 +43,7 @@ export const ShellEnrollmentInstructions: React.FunctionComponent<Props> = ({ // apiKey.api_key // } sh -c "$(curl ${kibanaUrl}/api/ingest_manager/fleet/install/${currentPlatform})"`; - const quickInstallInstructions = `./agent enroll ${kibanaUrl} ${apiKey.api_key}`; + const quickInstallInstructions = `./elastic-agent enroll ${kibanaUrl} ${apiKey.api_key}`; return ( <> diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/header.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/header.tsx index e1f29fdbeb323..1aab6d901a992 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/header.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/components/header.tsx @@ -7,14 +7,15 @@ import React, { memo } from 'react'; import styled from 'styled-components'; import { EuiFlexGroup, EuiFlexItem, EuiTabs, EuiTab, EuiSpacer } from '@elastic/eui'; import { Props as EuiTabProps } from '@elastic/eui/src/components/tabs/tab'; +import { EuiFlexItemProps } from '@elastic/eui/src/components/flex/flex_item'; const Container = styled.div` border-bottom: ${props => props.theme.eui.euiBorderThin}; background-color: ${props => props.theme.eui.euiPageBackgroundColor}; `; -const Wrapper = styled.div` - max-width: 1200px; +const Wrapper = styled.div<{ maxWidth?: number }>` + max-width: ${props => props.maxWidth || 1200}px; margin-left: auto; margin-right: auto; padding-top: ${props => props.theme.eui.paddingSizes.xl}; @@ -30,22 +31,36 @@ const Tabs = styled(EuiTabs)` `; export interface HeaderProps { + restrictHeaderWidth?: number; leftColumn?: JSX.Element; rightColumn?: JSX.Element; + rightColumnGrow?: EuiFlexItemProps['grow']; tabs?: EuiTabProps[]; } -const HeaderColumns: React.FC<Omit<HeaderProps, 'tabs'>> = memo(({ leftColumn, rightColumn }) => ( - <EuiFlexGroup alignItems="center"> - {leftColumn ? <EuiFlexItem>{leftColumn}</EuiFlexItem> : null} - {rightColumn ? <EuiFlexItem>{rightColumn}</EuiFlexItem> : null} - </EuiFlexGroup> -)); +const HeaderColumns: React.FC<Omit<HeaderProps, 'tabs'>> = memo( + ({ leftColumn, rightColumn, rightColumnGrow }) => ( + <EuiFlexGroup alignItems="center"> + {leftColumn ? <EuiFlexItem>{leftColumn}</EuiFlexItem> : null} + {rightColumn ? <EuiFlexItem grow={rightColumnGrow}>{rightColumn}</EuiFlexItem> : null} + </EuiFlexGroup> + ) +); -export const Header: React.FC<HeaderProps> = ({ leftColumn, rightColumn, tabs }) => ( +export const Header: React.FC<HeaderProps> = ({ + leftColumn, + rightColumn, + rightColumnGrow, + tabs, + restrictHeaderWidth, +}) => ( <Container> - <Wrapper> - <HeaderColumns leftColumn={leftColumn} rightColumn={rightColumn} /> + <Wrapper maxWidth={restrictHeaderWidth}> + <HeaderColumns + leftColumn={leftColumn} + rightColumn={rightColumn} + rightColumnGrow={rightColumnGrow} + /> <EuiFlexGroup> {tabs ? ( <EuiFlexItem> diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/confirm_modal.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/confirm_modal.tsx new file mode 100644 index 0000000000000..aa7eab8f5be8d --- /dev/null +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/confirm_modal.tsx @@ -0,0 +1,72 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { EuiCallOut, EuiOverlayMask, EuiConfirmModal, EuiSpacer } from '@elastic/eui'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { i18n } from '@kbn/i18n'; +import { AgentConfig } from '../../../../types'; + +export const ConfirmCreateDatasourceModal: React.FunctionComponent<{ + onConfirm: () => void; + onCancel: () => void; + agentCount: number; + agentConfig: AgentConfig; +}> = ({ onConfirm, onCancel, agentCount, agentConfig }) => { + return ( + <EuiOverlayMask> + <EuiConfirmModal + title={ + <FormattedMessage + id="xpack.ingestManager.createDatasource.confirmModalTitle" + defaultMessage="Save and deploy changes" + /> + } + onCancel={onCancel} + onConfirm={onConfirm} + cancelButtonText={ + <FormattedMessage + id="xpack.ingestManager.deleteApiKeys.confirmModal.cancelButtonLabel" + defaultMessage="Cancel" + /> + } + confirmButtonText={ + <FormattedMessage + id="xpack.ingestManager.createDatasource.confirmModalConfirmButtonLabel" + defaultMessage="Save and deploy changes" + /> + } + buttonColor="primary" + > + <EuiCallOut + iconType="iInCircle" + title={i18n.translate('xpack.ingestManager.createDatasource.confirmModalCalloutTitle', { + defaultMessage: + 'This action will update {agentCount, plural, one {# agent} other {# agents}}', + values: { + agentCount, + }, + })} + > + <FormattedMessage + id="xpack.ingestManager.createDatasource.confirmModalCalloutDescription" + defaultMessage="Fleet has detected that the selected agent configuration, {configName}, is already in use by + some of your agents. As a result of this action, Fleet will deploy updates to all agents + that use this configuration." + values={{ + configName: <b>{agentConfig.name}</b>, + }} + /> + </EuiCallOut> + <EuiSpacer size="l" /> + <FormattedMessage + id="xpack.ingestManager.createDatasource.confirmModalDescription" + defaultMessage="This action can not be undone. Are you sure you wish to continue?" + /> + </EuiConfirmModal> + </EuiOverlayMask> + ); +}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/index.ts b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/index.ts index 3bfca75668911..aa564690a6092 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/index.ts +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/index.ts @@ -5,4 +5,5 @@ */ export { CreateDatasourcePageLayout } from './layout'; export { DatasourceInputPanel } from './datasource_input_panel'; +export { ConfirmCreateDatasourceModal } from './confirm_modal'; export { DatasourceInputVarField } from './datasource_input_var_field'; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx index dd242f366e8c0..73a7ba8ec119d 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/layout.tsx @@ -19,108 +19,107 @@ import { WithHeaderLayout } from '../../../../layouts'; import { AgentConfig, PackageInfo } from '../../../../types'; import { PackageIcon } from '../../../../components/package_icon'; import { CreateDatasourceFrom, CreateDatasourceStep } from '../types'; -import { CreateDatasourceStepsNavigation } from './navigation'; export const CreateDatasourcePageLayout: React.FunctionComponent<{ from: CreateDatasourceFrom; basePath: string; cancelUrl: string; maxStep: CreateDatasourceStep | ''; - currentStep: CreateDatasourceStep; agentConfig?: AgentConfig; packageInfo?: PackageInfo; - restrictWidth?: number; -}> = ({ - from, - basePath, - cancelUrl, - maxStep, - currentStep, - agentConfig, - packageInfo, - restrictWidth, - children, -}) => { - return ( - <WithHeaderLayout - restrictWidth={restrictWidth} - leftColumn={ - <EuiFlexGroup direction="column" gutterSize="s" alignItems="flexStart"> - <EuiFlexItem> - <EuiButtonEmpty size="s" iconType="cross" flush="left" href={cancelUrl}> +}> = ({ from, basePath, cancelUrl, maxStep, agentConfig, packageInfo, children }) => { + const leftColumn = ( + <EuiFlexGroup direction="column" gutterSize="s" alignItems="flexStart"> + <EuiFlexItem> + <EuiButtonEmpty size="s" iconType="arrowLeft" flush="left" href={cancelUrl}> + <FormattedMessage + id="xpack.ingestManager.createDatasource.cancelLinkText" + defaultMessage="Cancel" + /> + </EuiButtonEmpty> + </EuiFlexItem> + <EuiFlexItem> + <EuiText> + <h1> + <FormattedMessage + id="xpack.ingestManager.createDatasource.pageTitle" + defaultMessage="Add data source" + /> + </h1> + </EuiText> + </EuiFlexItem> + <EuiFlexItem> + <EuiSpacer size="s" /> + <EuiText color="subdued" size="s"> + {from === 'config' ? ( + <FormattedMessage + id="xpack.ingestManager.createDatasource.pageDescriptionfromConfig" + defaultMessage="Follow the instructions below to add an integration to this agent configuration." + /> + ) : ( + <FormattedMessage + id="xpack.ingestManager.createDatasource.pageDescriptionfromPackage" + defaultMessage="Follow the instructions below to add this integration to an agent configuration." + /> + )} + </EuiText> + </EuiFlexItem> + </EuiFlexGroup> + ); + const rightColumn = ( + <EuiFlexGroup justifyContent="flexEnd" direction={'row'} gutterSize="xl"> + <EuiFlexItem grow={false}> + <EuiSpacer size="s" /> + {agentConfig && from === 'config' ? ( + <EuiDescriptionList style={{ textAlign: 'right' }} textStyle="reverse"> + <EuiDescriptionListTitle> + <FormattedMessage + id="xpack.ingestManager.createDatasource.agentConfigurationNameLabel" + defaultMessage="Configuration" + /> + </EuiDescriptionListTitle> + <EuiDescriptionListDescription> + {agentConfig?.name || '-'} + </EuiDescriptionListDescription> + </EuiDescriptionList> + ) : null} + {packageInfo && from === 'package' ? ( + <EuiDescriptionList style={{ textAlign: 'right' }} textStyle="reverse"> + <EuiDescriptionListTitle> <FormattedMessage - id="xpack.ingestManager.createDatasource.cancelLinkText" - defaultMessage="Cancel" + id="xpack.ingestManager.createDatasource.packageNameLabel" + defaultMessage="Integration" /> - </EuiButtonEmpty> - </EuiFlexItem> - <EuiFlexItem> - <EuiText> - <h1> - <FormattedMessage - id="xpack.ingestManager.createDatasource.pageTitle" - defaultMessage="Create data source" - /> - </h1> - </EuiText> - </EuiFlexItem> - <EuiFlexItem> - <EuiSpacer size="s" /> - <EuiFlexGroup direction={from === 'config' ? 'row' : 'rowReverse'} gutterSize="xl"> - {agentConfig || from === 'config' ? ( + </EuiDescriptionListTitle> + <EuiDescriptionListDescription> + <EuiFlexGroup justifyContent="flexEnd" alignItems="center" gutterSize="s"> <EuiFlexItem grow={false}> - <EuiDescriptionList textStyle="reverse"> - <EuiDescriptionListTitle> - <FormattedMessage - id="xpack.ingestManager.createDatasource.agentConfigurationNameLabel" - defaultMessage="Configuration" - /> - </EuiDescriptionListTitle> - <EuiDescriptionListDescription> - {agentConfig?.name || '-'} - </EuiDescriptionListDescription> - </EuiDescriptionList> + <PackageIcon + packageName={packageInfo?.name || ''} + version={packageInfo?.version || ''} + icons={packageInfo?.icons} + size="m" + /> </EuiFlexItem> - ) : null} - {packageInfo || from === 'package' ? ( <EuiFlexItem grow={false}> - <EuiDescriptionList textStyle="reverse"> - <EuiDescriptionListTitle> - <FormattedMessage - id="xpack.ingestManager.createDatasource.packageNameLabel" - defaultMessage="Integration" - /> - </EuiDescriptionListTitle> - <EuiDescriptionListDescription> - <EuiFlexGroup alignItems="center" gutterSize="s"> - <EuiFlexItem grow={false}> - <PackageIcon - packageName={packageInfo?.name || ''} - version={packageInfo?.version || ''} - icons={packageInfo?.icons} - size="m" - /> - </EuiFlexItem> - <EuiFlexItem grow={false}> - {packageInfo?.title || packageInfo?.name || '-'} - </EuiFlexItem> - </EuiFlexGroup> - </EuiDescriptionListDescription> - </EuiDescriptionList> + {packageInfo?.title || packageInfo?.name || '-'} </EuiFlexItem> - ) : null} - </EuiFlexGroup> - </EuiFlexItem> - </EuiFlexGroup> - } - rightColumn={ - <CreateDatasourceStepsNavigation - from={from} - basePath={basePath} - maxStep={maxStep} - currentStep={currentStep} - /> - } + </EuiFlexGroup> + </EuiDescriptionListDescription> + </EuiDescriptionList> + ) : null} + </EuiFlexItem> + </EuiFlexGroup> + ); + + const maxWidth = 770; + return ( + <WithHeaderLayout + restrictHeaderWidth={maxWidth} + restrictWidth={maxWidth} + leftColumn={leftColumn} + rightColumn={rightColumn} + rightColumnGrow={false} > {children} </WithHeaderLayout> diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx deleted file mode 100644 index 7dae981e65c30..0000000000000 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/components/navigation.tsx +++ /dev/null @@ -1,85 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import React from 'react'; -import styled from 'styled-components'; -import { useHistory } from 'react-router-dom'; -import { i18n } from '@kbn/i18n'; -import { EuiStepsHorizontal } from '@elastic/eui'; -import { CreateDatasourceFrom, CreateDatasourceStep } from '../types'; -import { WeightedCreateDatasourceSteps, CREATE_DATASOURCE_STEP_PATHS } from '../constants'; - -const StepsHorizontal = styled(EuiStepsHorizontal)` - background: none; -`; - -export const CreateDatasourceStepsNavigation: React.FunctionComponent<{ - from: CreateDatasourceFrom; - basePath: string; - maxStep: CreateDatasourceStep | ''; - currentStep: CreateDatasourceStep; -}> = ({ from, basePath, maxStep, currentStep }) => { - const history = useHistory(); - - const steps = [ - from === 'config' - ? { - title: i18n.translate('xpack.ingestManager.createDatasource.stepSelectPackageLabel', { - defaultMessage: 'Select integration', - }), - isSelected: currentStep === 'selectPackage', - isComplete: - WeightedCreateDatasourceSteps.indexOf('selectPackage') <= - WeightedCreateDatasourceSteps.indexOf(maxStep), - onClick: () => { - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.selectPackage}`); - }, - } - : { - title: i18n.translate('xpack.ingestManager.createDatasource.stepSelectConfigLabel', { - defaultMessage: 'Select configuration', - }), - isSelected: currentStep === 'selectConfig', - isComplete: - WeightedCreateDatasourceSteps.indexOf('selectConfig') <= - WeightedCreateDatasourceSteps.indexOf(maxStep), - onClick: () => { - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.selectConfig}`); - }, - }, - { - title: i18n.translate('xpack.ingestManager.createDatasource.stepConfigureDatasourceLabel', { - defaultMessage: 'Configure data source', - }), - isSelected: currentStep === 'configure', - isComplete: - WeightedCreateDatasourceSteps.indexOf('configure') <= - WeightedCreateDatasourceSteps.indexOf(maxStep), - disabled: - WeightedCreateDatasourceSteps.indexOf(maxStep) < - WeightedCreateDatasourceSteps.indexOf('configure') - 1, - onClick: () => { - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.configure}`); - }, - }, - { - title: i18n.translate('xpack.ingestManager.createDatasource.stepReviewLabel', { - defaultMessage: 'Review', - }), - isSelected: currentStep === 'review', - isComplete: - WeightedCreateDatasourceSteps.indexOf('review') <= - WeightedCreateDatasourceSteps.indexOf(maxStep), - disabled: - WeightedCreateDatasourceSteps.indexOf(maxStep) < - WeightedCreateDatasourceSteps.indexOf('review') - 1, - onClick: () => { - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.review}`); - }, - }, - ]; - - return <StepsHorizontal steps={steps} />; -}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/constants.ts b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/constants.ts index eea18179560a1..49223a8eb4531 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/constants.ts +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/constants.ts @@ -9,10 +9,3 @@ export const WeightedCreateDatasourceSteps = [ 'configure', 'review', ]; - -export const CREATE_DATASOURCE_STEP_PATHS = { - selectConfig: '/select-config', - selectPackage: '/select-package', - configure: '/configure', - review: '/review', -}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx index 461bb750ca6f5..1ad579d591b21 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/index.tsx @@ -3,45 +3,74 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import React, { useState } from 'react'; -import { - useRouteMatch, - HashRouter as Router, - Switch, - Route, - Redirect, - useHistory, -} from 'react-router-dom'; +import React, { useState, useEffect } from 'react'; +import { useRouteMatch, useHistory } from 'react-router-dom'; +import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { EuiButtonEmpty } from '@elastic/eui'; +import { + EuiButtonEmpty, + EuiButton, + EuiSteps, + EuiBottomBar, + EuiFlexGroup, + EuiFlexItem, + EuiSpacer, +} from '@elastic/eui'; +import { EuiStepProps } from '@elastic/eui/src/components/steps/step'; import { AGENT_CONFIG_DETAILS_PATH } from '../../../constants'; import { AgentConfig, PackageInfo, NewDatasource } from '../../../types'; -import { useLink, sendCreateDatasource } from '../../../hooks'; +import { + useLink, + sendCreateDatasource, + useCore, + useConfig, + sendGetAgentStatus, +} from '../../../hooks'; import { useLinks as useEPMLinks } from '../../epm/hooks'; -import { CreateDatasourcePageLayout } from './components'; +import { CreateDatasourcePageLayout, ConfirmCreateDatasourceModal } from './components'; import { CreateDatasourceFrom, CreateDatasourceStep } from './types'; -import { CREATE_DATASOURCE_STEP_PATHS } from './constants'; -import { DatasourceValidationResults, validateDatasource } from './services'; +import { DatasourceValidationResults, validateDatasource, validationHasErrors } from './services'; import { StepSelectPackage } from './step_select_package'; import { StepSelectConfig } from './step_select_config'; import { StepConfigureDatasource } from './step_configure_datasource'; -import { StepReviewDatasource } from './step_review'; + +import { StepDefineDatasource } from './step_define_datasource'; export const CreateDatasourcePage: React.FunctionComponent = () => { + const { notifications } = useCore(); + const { + fleet: { enabled: isFleetEnabled }, + } = useConfig(); const { params: { configId, pkgkey }, - path: matchPath, url: basePath, } = useRouteMatch(); const history = useHistory(); const from: CreateDatasourceFrom = configId ? 'config' : 'package'; const [maxStep, setMaxStep] = useState<CreateDatasourceStep | ''>(''); - const [isSaving, setIsSaving] = useState<boolean>(false); // Agent config and package info states const [agentConfig, setAgentConfig] = useState<AgentConfig>(); const [packageInfo, setPackageInfo] = useState<PackageInfo>(); + const agentConfigId = agentConfig?.id; + // Retrieve agent count + useEffect(() => { + const getAgentCount = async () => { + if (agentConfigId) { + const { data } = await sendGetAgentStatus({ configId: agentConfigId }); + if (data?.results.total) { + setAgentCount(data.results.total); + } + } + }; + + if (isFleetEnabled && agentConfigId) { + getAgentCount(); + } + }, [agentConfigId, isFleetEnabled]); + const [agentCount, setAgentCount] = useState<number>(0); + // New datasource state const [datasource, setDatasource] = useState<NewDatasource>({ name: '', @@ -60,6 +89,7 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { if (updatedPackageInfo) { setPackageInfo(updatedPackageInfo); } else { + setFormState('INVALID'); setPackageInfo(undefined); setMaxStep(''); } @@ -73,6 +103,7 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { if (updatedAgentConfig) { setAgentConfig(updatedAgentConfig); } else { + setFormState('INVALID'); setAgentConfig(undefined); setMaxStep(''); } @@ -81,6 +112,8 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { console.debug('Agent config updated', updatedAgentConfig); }; + const hasErrors = validationResults ? validationHasErrors(validationResults) : false; + // Update datasource method const updateDatasource = (updatedFields: Partial<NewDatasource>) => { const newDatasource = { @@ -88,9 +121,18 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { ...updatedFields, }; setDatasource(newDatasource); + // eslint-disable-next-line no-console console.debug('Datasource updated', newDatasource); - updateDatasourceValidation(newDatasource); + const newValidationResults = updateDatasourceValidation(newDatasource); + const hasPackage = newDatasource.package; + const hasValidationErrors = newValidationResults + ? validationHasErrors(newValidationResults) + : false; + const hasAgentConfig = newDatasource.config_id && newDatasource.config_id !== ''; + if (hasPackage && hasAgentConfig && !hasValidationErrors) { + setFormState('VALID'); + } }; const updateDatasourceValidation = (newDatasource?: NewDatasource) => { @@ -99,6 +141,8 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { setValidationResults(newValidationResult); // eslint-disable-next-line no-console console.debug('Datasource validation results', newValidationResult); + + return newValidationResult; } }; @@ -112,34 +156,37 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { }); const cancelUrl = from === 'config' ? CONFIG_URL : PACKAGE_URL; - // Redirect to first step - const redirectToFirstStep = - from === 'config' ? ( - <Redirect to={`${basePath}${CREATE_DATASOURCE_STEP_PATHS.selectPackage}`} /> - ) : ( - <Redirect to={`${basePath}${CREATE_DATASOURCE_STEP_PATHS.selectConfig}`} /> - ); - - // Url to first and second steps - const SELECT_PACKAGE_URL = useLink(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.selectPackage}`); - const SELECT_CONFIG_URL = useLink(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.selectConfig}`); - const CONFIGURE_DATASOURCE_URL = useLink(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.configure}`); - const firstStepUrl = from === 'config' ? SELECT_PACKAGE_URL : SELECT_CONFIG_URL; - const secondStepUrl = CONFIGURE_DATASOURCE_URL; - - // Redirect to second step - const redirectToSecondStep = ( - <Redirect to={`${basePath}${CREATE_DATASOURCE_STEP_PATHS.configure}`} /> - ); - // Save datasource + const [formState, setFormState] = useState< + 'VALID' | 'INVALID' | 'CONFIRM' | 'LOADING' | 'SUBMITTED' + >('INVALID'); const saveDatasource = async () => { - setIsSaving(true); + setFormState('LOADING'); const result = await sendCreateDatasource(datasource); - setIsSaving(false); + setFormState('SUBMITTED'); return result; }; + const onSubmit = async () => { + if (formState === 'VALID' && hasErrors) { + setFormState('INVALID'); + return; + } + if (agentCount !== 0 && formState !== 'CONFIRM') { + setFormState('CONFIRM'); + return; + } + const { error } = await saveDatasource(); + if (!error) { + history.push(`${AGENT_CONFIG_DETAILS_PATH}${agentConfig ? agentConfig.id : configId}`); + } else { + notifications.toasts.addError(error, { + title: 'Error', + }); + setFormState('VALID'); + } + }; + const layoutProps = { from, basePath, @@ -147,135 +194,108 @@ export const CreateDatasourcePage: React.FunctionComponent = () => { maxStep, agentConfig, packageInfo, - restrictWidth: 770, }; - return ( - <Router> - <Switch> - {/* Redirect to first step from `/` */} - {from === 'config' ? ( - <Redirect - exact - from={`${matchPath}`} - to={`${matchPath}${CREATE_DATASOURCE_STEP_PATHS.selectPackage}`} + const steps: EuiStepProps[] = [ + from === 'package' + ? { + title: i18n.translate('xpack.ingestManager.createDatasource.stepSelectAgentConfigTitle', { + defaultMessage: 'Select an agent configuration', + }), + children: ( + <StepSelectConfig + pkgkey={pkgkey} + updatePackageInfo={updatePackageInfo} + agentConfig={agentConfig} + updateAgentConfig={updateAgentConfig} + /> + ), + } + : { + title: i18n.translate('xpack.ingestManager.createDatasource.stepSelectPackageTitle', { + defaultMessage: 'Select an integration', + }), + children: ( + <StepSelectPackage + agentConfigId={configId} + updateAgentConfig={updateAgentConfig} + packageInfo={packageInfo} + updatePackageInfo={updatePackageInfo} + /> + ), + }, + { + title: i18n.translate('xpack.ingestManager.createDatasource.stepDefineDatasourceTitle', { + defaultMessage: 'Define your data source', + }), + status: !packageInfo || !agentConfig ? 'disabled' : undefined, + children: + agentConfig && packageInfo ? ( + <StepDefineDatasource + agentConfig={agentConfig} + packageInfo={packageInfo} + datasource={datasource} + updateDatasource={updateDatasource} /> - ) : ( - <Redirect - exact - from={`${matchPath}`} - to={`${matchPath}${CREATE_DATASOURCE_STEP_PATHS.selectConfig}`} + ) : null, + }, + { + title: i18n.translate('xpack.ingestManager.createDatasource.stepConfgiureDatasourceTitle', { + defaultMessage: 'Select the data you want to collect', + }), + status: !packageInfo || !agentConfig ? 'disabled' : undefined, + children: + agentConfig && packageInfo ? ( + <StepConfigureDatasource + agentConfig={agentConfig} + packageInfo={packageInfo} + datasource={datasource} + updateDatasource={updateDatasource} + validationResults={validationResults!} + submitAttempted={formState === 'INVALID'} /> - )} - - {/* First step, either render select package or select config depending on entry */} - {from === 'config' ? ( - <Route path={`${matchPath}${CREATE_DATASOURCE_STEP_PATHS.selectPackage}`}> - <CreateDatasourcePageLayout {...layoutProps} currentStep="selectPackage"> - <StepSelectPackage - agentConfigId={configId} - updateAgentConfig={updateAgentConfig} - packageInfo={packageInfo} - updatePackageInfo={updatePackageInfo} - cancelUrl={cancelUrl} - onNext={() => { - setMaxStep('selectPackage'); - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.configure}`); - }} - /> - </CreateDatasourcePageLayout> - </Route> - ) : ( - <Route path={`${matchPath}${CREATE_DATASOURCE_STEP_PATHS.selectConfig}`}> - <CreateDatasourcePageLayout {...layoutProps} currentStep="selectConfig"> - <StepSelectConfig - pkgkey={pkgkey} - updatePackageInfo={updatePackageInfo} - agentConfig={agentConfig} - updateAgentConfig={updateAgentConfig} - cancelUrl={cancelUrl} - onNext={() => { - setMaxStep('selectConfig'); - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.configure}`); - }} - /> - </CreateDatasourcePageLayout> - </Route> - )} - - {/* Second step to configure data source, redirect to first step if agent config */} - {/* or package info isn't defined (i.e. after full page reload) */} - <Route path={`${matchPath}${CREATE_DATASOURCE_STEP_PATHS.configure}`}> - <CreateDatasourcePageLayout {...layoutProps} currentStep="configure"> - {!agentConfig || !packageInfo ? ( - redirectToFirstStep - ) : ( - <StepConfigureDatasource - agentConfig={agentConfig} - packageInfo={packageInfo} - datasource={datasource} - updateDatasource={updateDatasource} - validationResults={validationResults!} - backLink={ - <EuiButtonEmpty href={firstStepUrl} iconType="arrowLeft" iconSide="left"> - {from === 'config' ? ( - <FormattedMessage - id="xpack.ingestManager.createDatasource.changePackageLinkText" - defaultMessage="Change integration" - /> - ) : ( - <FormattedMessage - id="xpack.ingestManager.createDatasource.changeConfigLinkText" - defaultMessage="Change configuration" - /> - )} - </EuiButtonEmpty> - } - cancelUrl={cancelUrl} - onNext={() => { - setMaxStep('configure'); - history.push(`${basePath}${CREATE_DATASOURCE_STEP_PATHS.review}`); - }} + ) : null, + }, + ]; + return ( + <CreateDatasourcePageLayout {...layoutProps}> + {formState === 'CONFIRM' && agentConfig && ( + <ConfirmCreateDatasourceModal + agentCount={agentCount} + agentConfig={agentConfig} + onConfirm={onSubmit} + onCancel={() => setFormState('VALID')} + /> + )} + <EuiSteps steps={steps} /> + <EuiSpacer size="l" /> + <EuiBottomBar css={{ zIndex: 5 }} paddingSize="s"> + <EuiFlexGroup gutterSize="s" justifyContent="flexEnd"> + <EuiFlexItem grow={false}> + <EuiButtonEmpty color="ghost" href={cancelUrl}> + <FormattedMessage + id="xpack.ingestManager.createDatasource.cancelButton" + defaultMessage="Cancel" /> - )} - </CreateDatasourcePageLayout> - </Route> - - {/* Third step to review, redirect to second step if data source name is missing */} - {/* (i.e. after full page reload) */} - <Route path={`${matchPath}${CREATE_DATASOURCE_STEP_PATHS.review}`}> - <CreateDatasourcePageLayout {...layoutProps} currentStep="review"> - {!agentConfig || !datasource.name ? ( - redirectToSecondStep - ) : ( - <StepReviewDatasource - agentConfig={agentConfig} - datasource={datasource} - cancelUrl={cancelUrl} - isSubmitLoading={isSaving} - backLink={ - <EuiButtonEmpty href={secondStepUrl} iconType="arrowLeft" iconSide="left"> - <FormattedMessage - id="xpack.ingestManager.createDatasource.editDatasourceLinkText" - defaultMessage="Edit data source" - /> - </EuiButtonEmpty> - } - onSubmit={async () => { - const { error } = await saveDatasource(); - if (!error) { - history.push( - `${AGENT_CONFIG_DETAILS_PATH}${agentConfig ? agentConfig.id : configId}` - ); - } else { - // TODO: Handle save datasource error - } - }} + </EuiButtonEmpty> + </EuiFlexItem> + <EuiFlexItem grow={false}> + <EuiButton + onClick={onSubmit} + isLoading={formState === 'LOADING'} + disabled={formState !== 'VALID'} + iconType="save" + color="primary" + fill + > + <FormattedMessage + id="xpack.ingestManager.createDatasource.saveButton" + defaultMessage="Save data source" /> - )} - </CreateDatasourcePageLayout> - </Route> - </Switch> - </Router> + </EuiButton> + </EuiFlexItem> + </EuiFlexGroup> + </EuiBottomBar> + </CreateDatasourcePageLayout> ); }; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_configure_datasource.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_configure_datasource.tsx index 105d6c66a5704..843891b63ca01 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_configure_datasource.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_configure_datasource.tsx @@ -3,23 +3,18 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import React, { useEffect, useState, Fragment } from 'react'; -import { i18n } from '@kbn/i18n'; +import React, { useEffect } from 'react'; import { FormattedMessage } from '@kbn/i18n/react'; import { - EuiSteps, EuiPanel, EuiFlexGroup, EuiFlexItem, - EuiFormRow, - EuiButtonEmpty, EuiSpacer, EuiEmptyPrompt, EuiText, - EuiButton, - EuiComboBox, EuiCallOut, } from '@elastic/eui'; +import { i18n } from '@kbn/i18n'; import { AgentConfig, PackageInfo, @@ -30,7 +25,7 @@ import { import { Loading } from '../../../components'; import { packageToConfigDatasourceInputs } from '../../../services'; import { DatasourceValidationResults, validationHasErrors } from './services'; -import { DatasourceInputPanel, DatasourceInputVarField } from './components'; +import { DatasourceInputPanel } from './components'; export const StepConfigureDatasource: React.FunctionComponent<{ agentConfig: AgentConfig; @@ -38,24 +33,17 @@ export const StepConfigureDatasource: React.FunctionComponent<{ datasource: NewDatasource; updateDatasource: (fields: Partial<NewDatasource>) => void; validationResults: DatasourceValidationResults; - backLink: JSX.Element; - cancelUrl: string; - onNext: () => void; + submitAttempted: boolean; }> = ({ agentConfig, packageInfo, datasource, updateDatasource, validationResults, - backLink, - cancelUrl, - onNext, + submitAttempted, }) => { // Form show/hide states - const [isShowingAdvancedDefine, setIsShowingAdvancedDefine] = useState<boolean>(false); - // Form submit state - const [submitAttempted, setSubmitAttempted] = useState<boolean>(false); const hasErrors = validationResults ? validationHasErrors(validationResults) : false; // Update datasource's package and config info @@ -95,107 +83,6 @@ export const StepConfigureDatasource: React.FunctionComponent<{ } }, [datasource.package, datasource.config_id, agentConfig, packageInfo, updateDatasource]); - // Step A, define datasource - const renderDefineDatasource = () => ( - <EuiPanel> - <EuiFlexGroup> - <EuiFlexItem grow={1}> - <DatasourceInputVarField - varDef={{ - name: 'name', - title: i18n.translate( - 'xpack.ingestManager.createDatasource.stepConfigure.datasourceNameInputLabel', - { - defaultMessage: 'Data source name', - } - ), - type: 'text', - required: true, - }} - value={datasource.name} - onChange={(newValue: any) => { - updateDatasource({ - name: newValue, - }); - }} - errors={validationResults!.name} - forceShowErrors={submitAttempted} - /> - </EuiFlexItem> - <EuiFlexItem grow={1}> - <DatasourceInputVarField - varDef={{ - name: 'description', - title: i18n.translate( - 'xpack.ingestManager.createDatasource.stepConfigure.datasourceDescriptionInputLabel', - { - defaultMessage: 'Description', - } - ), - type: 'text', - required: false, - }} - value={datasource.description} - onChange={(newValue: any) => { - updateDatasource({ - description: newValue, - }); - }} - errors={validationResults!.description} - forceShowErrors={submitAttempted} - /> - </EuiFlexItem> - </EuiFlexGroup> - <EuiSpacer size="m" /> - <EuiButtonEmpty - flush="left" - size="xs" - iconType={isShowingAdvancedDefine ? 'arrowUp' : 'arrowDown'} - onClick={() => setIsShowingAdvancedDefine(!isShowingAdvancedDefine)} - > - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepConfigure.advancedOptionsToggleLinkText" - defaultMessage="Advanced options" - /> - </EuiButtonEmpty> - {/* Todo: Populate list of existing namespaces */} - {isShowingAdvancedDefine ? ( - <Fragment> - <EuiSpacer size="m" /> - <EuiFlexGroup> - <EuiFlexItem grow={1}> - <EuiFormRow - label={ - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepConfigure.datasourceNamespaceInputLabel" - defaultMessage="Namespace" - /> - } - > - <EuiComboBox - noSuggestions - singleSelection={true} - selectedOptions={datasource.namespace ? [{ label: datasource.namespace }] : []} - onCreateOption={(newNamespace: string) => { - updateDatasource({ - namespace: newNamespace, - }); - }} - onChange={(newNamespaces: Array<{ label: string }>) => { - updateDatasource({ - namespace: newNamespaces.length ? newNamespaces[0].label : '', - }); - }} - /> - </EuiFormRow> - </EuiFlexItem> - <EuiFlexItem grow={1} /> - </EuiFlexGroup> - </Fragment> - ) : null} - </EuiPanel> - ); - // Step B, configure inputs (and their streams) // Assume packages only export one datasource for now const renderConfigureInputs = () => @@ -252,41 +139,10 @@ export const StepConfigureDatasource: React.FunctionComponent<{ return validationResults ? ( <EuiFlexGroup direction="column" gutterSize="none"> - <EuiFlexItem> - <EuiFlexGroup direction="column" gutterSize="none"> - <EuiFlexItem> - <EuiFlexGroup justifyContent="flexEnd"> - <EuiFlexItem grow={false}>{backLink}</EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - <EuiFlexItem> - <EuiSteps - steps={[ - { - title: i18n.translate( - 'xpack.ingestManager.createDatasource.stepConfigure.defineDatasourceTitle', - { - defaultMessage: 'Define your datasource', - } - ), - children: renderDefineDatasource(), - }, - { - title: i18n.translate( - 'xpack.ingestManager.createDatasource.stepConfigure.chooseDataTitle', - { - defaultMessage: 'Choose the data you want to collect', - } - ), - children: renderConfigureInputs(), - }, - ]} - /> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> + <EuiFlexItem>{renderConfigureInputs()}</EuiFlexItem> {hasErrors && submitAttempted ? ( <EuiFlexItem> + <EuiSpacer size="m" /> <EuiCallOut title={i18n.translate( 'xpack.ingestManager.createDatasource.stepConfigure.validationErrorTitle', @@ -306,36 +162,6 @@ export const StepConfigureDatasource: React.FunctionComponent<{ <EuiSpacer size="m" /> </EuiFlexItem> ) : null} - <EuiFlexItem> - <EuiFlexGroup justifyContent="flexEnd"> - <EuiFlexItem grow={false}> - <EuiButtonEmpty href={cancelUrl}> - <FormattedMessage - id="xpack.ingestManager.createDatasource.cancelLinkText" - defaultMessage="Cancel" - /> - </EuiButtonEmpty> - </EuiFlexItem> - <EuiFlexItem grow={false}> - <EuiButton - fill - iconType="arrowRight" - iconSide="right" - onClick={() => { - setSubmitAttempted(true); - if (!hasErrors) { - onNext(); - } - }} - > - <FormattedMessage - id="xpack.ingestManager.createDatasource.continueButtonText" - defaultMessage="Continue" - /> - </EuiButton> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> </EuiFlexGroup> ) : ( <Loading /> diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_define_datasource.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_define_datasource.tsx new file mode 100644 index 0000000000000..792389381eaf0 --- /dev/null +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_define_datasource.tsx @@ -0,0 +1,165 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import React, { useEffect, useState, Fragment } from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { + EuiFlexGrid, + EuiFlexItem, + EuiFormRow, + EuiFieldText, + EuiButtonEmpty, + EuiSpacer, + EuiText, + EuiComboBox, +} from '@elastic/eui'; +import { AgentConfig, PackageInfo, Datasource, NewDatasource } from '../../../types'; +import { packageToConfigDatasourceInputs } from '../../../services'; + +export const StepDefineDatasource: React.FunctionComponent<{ + agentConfig: AgentConfig; + packageInfo: PackageInfo; + datasource: NewDatasource; + updateDatasource: (fields: Partial<NewDatasource>) => void; +}> = ({ agentConfig, packageInfo, datasource, updateDatasource }) => { + // Form show/hide states + const [isShowingAdvancedDefine, setIsShowingAdvancedDefine] = useState<boolean>(false); + + // Update datasource's package and config info + useEffect(() => { + const dsPackage = datasource.package; + const currentPkgKey = dsPackage ? `${dsPackage.name}-${dsPackage.version}` : ''; + const pkgKey = `${packageInfo.name}-${packageInfo.version}`; + + // If package has changed, create shell datasource with input&stream values based on package info + if (currentPkgKey !== pkgKey) { + // Existing datasources on the agent config using the package name, retrieve highest number appended to datasource name + const dsPackageNamePattern = new RegExp(`${packageInfo.name}-(\\d+)`); + const dsWithMatchingNames = (agentConfig.datasources as Datasource[]) + .filter(ds => Boolean(ds.name.match(dsPackageNamePattern))) + .map(ds => parseInt(ds.name.match(dsPackageNamePattern)![1], 10)) + .sort(); + + updateDatasource({ + name: `${packageInfo.name}-${ + dsWithMatchingNames.length ? dsWithMatchingNames[dsWithMatchingNames.length - 1] + 1 : 1 + }`, + package: { + name: packageInfo.name, + title: packageInfo.title, + version: packageInfo.version, + }, + inputs: packageToConfigDatasourceInputs(packageInfo), + }); + } + + // If agent config has changed, update datasource's config ID and namespace + if (datasource.config_id !== agentConfig.id) { + updateDatasource({ + config_id: agentConfig.id, + namespace: agentConfig.namespace, + }); + } + }, [datasource.package, datasource.config_id, agentConfig, packageInfo, updateDatasource]); + + return ( + <> + <EuiFlexGrid columns={2}> + <EuiFlexItem> + <EuiFormRow + label={ + <FormattedMessage + id="xpack.ingestManager.createDatasource.stepConfigure.datasourceNameInputLabel" + defaultMessage="Data source name" + /> + } + > + <EuiFieldText + value={datasource.name} + onChange={e => + updateDatasource({ + name: e.target.value, + }) + } + /> + </EuiFormRow> + </EuiFlexItem> + <EuiFlexItem> + <EuiFormRow + label={ + <FormattedMessage + id="xpack.ingestManager.createDatasource.stepConfigure.datasourceDescriptionInputLabel" + defaultMessage="Description" + /> + } + labelAppend={ + <EuiText size="xs" color="subdued"> + <FormattedMessage + id="xpack.ingestManager.createDatasource.stepConfigure.inputVarFieldOptionalLabel" + defaultMessage="Optional" + /> + </EuiText> + } + > + <EuiFieldText + value={datasource.description} + onChange={e => + updateDatasource({ + description: e.target.value, + }) + } + /> + </EuiFormRow> + </EuiFlexItem> + </EuiFlexGrid> + <EuiSpacer size="m" /> + <EuiButtonEmpty + flush="left" + size="xs" + iconType={isShowingAdvancedDefine ? 'arrowUp' : 'arrowDown'} + onClick={() => setIsShowingAdvancedDefine(!isShowingAdvancedDefine)} + > + <FormattedMessage + id="xpack.ingestManager.createDatasource.stepConfigure.advancedOptionsToggleLinkText" + defaultMessage="Advanced options" + /> + </EuiButtonEmpty> + {/* Todo: Populate list of existing namespaces */} + {isShowingAdvancedDefine ? ( + <Fragment> + <EuiSpacer size="m" /> + <EuiFlexGrid columns={2}> + <EuiFlexItem> + <EuiFormRow + label={ + <FormattedMessage + id="xpack.ingestManager.createDatasource.stepConfigure.datasourceNamespaceInputLabel" + defaultMessage="Namespace" + /> + } + > + <EuiComboBox + noSuggestions + singleSelection={true} + selectedOptions={datasource.namespace ? [{ label: datasource.namespace }] : []} + onCreateOption={(newNamespace: string) => { + updateDatasource({ + namespace: newNamespace, + }); + }} + onChange={(newNamespaces: Array<{ label: string }>) => { + updateDatasource({ + namespace: newNamespaces.length ? newNamespaces[0].label : '', + }); + }} + /> + </EuiFormRow> + </EuiFlexItem> + </EuiFlexGrid> + </Fragment> + ) : null} + </> + ); +}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_review.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_review.tsx deleted file mode 100644 index 20af5954c1436..0000000000000 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_review.tsx +++ /dev/null @@ -1,202 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import React, { Fragment, useState, useEffect } from 'react'; -import { i18n } from '@kbn/i18n'; -import { FormattedMessage } from '@kbn/i18n/react'; -import { - EuiFlexGroup, - EuiFlexItem, - EuiButtonEmpty, - EuiButton, - EuiTitle, - EuiCallOut, - EuiText, - EuiCheckbox, - EuiTabbedContent, - EuiCodeBlock, - EuiSpacer, -} from '@elastic/eui'; -import { dump } from 'js-yaml'; -import { NewDatasource, AgentConfig } from '../../../types'; -import { useConfig, sendGetAgentStatus } from '../../../hooks'; -import { storedDatasourceToAgentDatasource } from '../../../services'; - -const KEYS_TO_SINK = ['inputs', 'streams']; - -export const StepReviewDatasource: React.FunctionComponent<{ - agentConfig: AgentConfig; - datasource: NewDatasource; - backLink: JSX.Element; - cancelUrl: string; - onSubmit: () => void; - isSubmitLoading: boolean; -}> = ({ agentConfig, datasource, backLink, cancelUrl, onSubmit, isSubmitLoading }) => { - // Agent count info states - const [agentCount, setAgentCount] = useState<number>(0); - const [agentCountChecked, setAgentCountChecked] = useState<boolean>(false); - - // Config information - const { - fleet: { enabled: isFleetEnabled }, - } = useConfig(); - - // Retrieve agent count - useEffect(() => { - const getAgentCount = async () => { - const { data } = await sendGetAgentStatus({ configId: agentConfig.id }); - if (data?.results.total) { - setAgentCount(data.results.total); - } - }; - - if (isFleetEnabled) { - getAgentCount(); - } - }, [agentConfig.id, isFleetEnabled]); - - const showAgentDisclaimer = isFleetEnabled && agentCount; - const fullAgentDatasource = storedDatasourceToAgentDatasource(datasource); - - return ( - <EuiFlexGroup direction="column"> - <EuiFlexItem> - <EuiFlexGroup justifyContent="spaceBetween"> - <EuiFlexItem grow={false}> - <EuiTitle size="s"> - <h3> - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepReview.reviewTitle" - defaultMessage="Review changes" - /> - </h3> - </EuiTitle> - </EuiFlexItem> - <EuiFlexItem grow={false}>{backLink}</EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - - {/* Agents affected warning */} - {showAgentDisclaimer ? ( - <EuiFlexItem> - <EuiCallOut - title={ - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepReview.agentsAffectedCalloutTitle" - defaultMessage="This action will affect {count, plural, one {# agent} other {# agents}}" - values={{ - count: agentCount, - }} - /> - } - > - <EuiText> - <p> - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepReview.agentsAffectedCalloutText" - defaultMessage="Fleet has detected that the selected agent configuration, {configName} is already in use by some your agents. As a result of this action, Fleet will update all agents that are enrolled with this configuration." - values={{ - configName: <strong>{agentConfig.name}</strong>, - }} - /> - </p> - </EuiText> - </EuiCallOut> - </EuiFlexItem> - ) : null} - - {/* Preview and YAML view */} - {/* TODO: Implement preview tab */} - <EuiFlexItem> - <EuiTabbedContent - tabs={[ - { - id: 'yaml', - name: i18n.translate('xpack.ingestManager.agentConfigInfo.yamlTabName', { - defaultMessage: 'YAML', - }), - content: ( - <Fragment> - <EuiSpacer size="s" /> - <EuiCodeBlock language="yaml" isCopyable overflowHeight={450}> - {dump(fullAgentDatasource, { - sortKeys: (a: string, b: string) => { - // Make YAML output prettier by sinking certain fields - if (KEYS_TO_SINK.indexOf(a) > -1) { - return 1; - } - if (KEYS_TO_SINK.indexOf(b) > -1) { - return -1; - } - return 0; - }, - })} - </EuiCodeBlock> - </Fragment> - ), - }, - ]} - /> - </EuiFlexItem> - - {/* Confirm agents affected */} - {showAgentDisclaimer ? ( - <EuiFlexItem> - <EuiFlexGroup direction="column" gutterSize="s"> - <EuiFlexItem> - <EuiTitle size="xs"> - <h4> - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepReview.confirmAgentDisclaimerTitle" - defaultMessage="Confirm your decision" - /> - </h4> - </EuiTitle> - </EuiFlexItem> - <EuiFlexItem> - <EuiCheckbox - id="CreateDatasourceAgentDisclaimer" - label={ - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepReview.confirmAgentDisclaimerText" - defaultMessage="I understand that this action will update all agents that are enrolled with this configuration." - /> - } - checked={agentCountChecked} - onChange={e => setAgentCountChecked(e.target.checked)} - /> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - ) : null} - - <EuiFlexItem> - <EuiFlexGroup justifyContent="flexEnd"> - <EuiFlexItem grow={false}> - <EuiButtonEmpty href={cancelUrl}> - <FormattedMessage - id="xpack.ingestManager.createDatasource.cancelLinkText" - defaultMessage="Cancel" - /> - </EuiButtonEmpty> - </EuiFlexItem> - <EuiFlexItem grow={false}> - <EuiButton - fill - onClick={() => onSubmit()} - isLoading={isSubmitLoading} - disabled={isSubmitLoading || Boolean(showAgentDisclaimer && !agentCountChecked)} - > - <FormattedMessage - id="xpack.ingestManager.createDatasource.addDatasourceButtonText" - defaultMessage="Add datasource to configuration" - /> - </EuiButton> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - </EuiFlexGroup> - ); -}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_config.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_config.tsx index 2ddfc170069a1..6cbe56e628903 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_config.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_config.tsx @@ -6,19 +6,8 @@ import React, { useEffect, useState, Fragment } from 'react'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { - EuiButtonEmpty, - EuiButton, - EuiFlexGroup, - EuiFlexItem, - EuiTitle, - EuiSelectable, - EuiSpacer, - EuiTextColor, -} from '@elastic/eui'; +import { EuiFlexGroup, EuiFlexItem, EuiSelectable, EuiSpacer, EuiTextColor } from '@elastic/eui'; import { Error } from '../../../components'; -import { AGENT_CONFIG_PATH } from '../../../constants'; -import { useCapabilities, useLink } from '../../../hooks'; import { AgentConfig, PackageInfo, GetAgentConfigsResponseItem } from '../../../types'; import { useGetPackageInfoByKey, useGetAgentConfigs, sendGetOneAgentConfig } from '../../../hooks'; @@ -27,20 +16,13 @@ export const StepSelectConfig: React.FunctionComponent<{ updatePackageInfo: (packageInfo: PackageInfo | undefined) => void; agentConfig: AgentConfig | undefined; updateAgentConfig: (config: AgentConfig | undefined) => void; - cancelUrl: string; - onNext: () => void; -}> = ({ pkgkey, updatePackageInfo, agentConfig, updateAgentConfig, cancelUrl, onNext }) => { - const hasWriteCapabilites = useCapabilities().write; +}> = ({ pkgkey, updatePackageInfo, agentConfig, updateAgentConfig }) => { // Selected config state const [selectedConfigId, setSelectedConfigId] = useState<string | undefined>( agentConfig ? agentConfig.id : undefined ); - const [selectedConfigLoading, setSelectedConfigLoading] = useState<boolean>(false); const [selectedConfigError, setSelectedConfigError] = useState<Error>(); - // Todo: replace with create agent config flyout - const CREATE_NEW_CONFIG_URI = useLink(AGENT_CONFIG_PATH); - // Fetch package info const { data: packageInfoData, error: packageInfoError } = useGetPackageInfoByKey(pkgkey); @@ -70,9 +52,7 @@ export const StepSelectConfig: React.FunctionComponent<{ useEffect(() => { const fetchAgentConfigInfo = async () => { if (selectedConfigId) { - setSelectedConfigLoading(true); const { data, error } = await sendGetOneAgentConfig(selectedConfigId); - setSelectedConfigLoading(false); if (error) { setSelectedConfigError(error); updateAgentConfig(undefined); @@ -122,33 +102,6 @@ export const StepSelectConfig: React.FunctionComponent<{ return ( <EuiFlexGroup direction="column"> - <EuiFlexItem> - <EuiFlexGroup justifyContent="spaceBetween" alignItems="center"> - <EuiFlexItem grow={false}> - <EuiTitle size="s"> - <h3> - <FormattedMessage - id="xpack.ingestManager.createDatasource.StepSelectConfig.selectAgentConfigTitle" - defaultMessage="Select an agent configuration" - /> - </h3> - </EuiTitle> - </EuiFlexItem> - <EuiFlexItem grow={false}> - <EuiButtonEmpty - isDisabled={!hasWriteCapabilites} - iconType="plusInCircle" - href={CREATE_NEW_CONFIG_URI} - size="s" - > - <FormattedMessage - id="xpack.ingestManager.createDatasource.StepSelectConfig.createNewConfigButtonText" - defaultMessage="Create new configuration" - /> - </EuiButtonEmpty> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> <EuiFlexItem> <EuiSelectable searchable @@ -227,33 +180,6 @@ export const StepSelectConfig: React.FunctionComponent<{ /> </EuiFlexItem> ) : null} - <EuiFlexItem> - <EuiFlexGroup justifyContent="flexEnd"> - <EuiFlexItem grow={false}> - <EuiButtonEmpty href={cancelUrl}> - <FormattedMessage - id="xpack.ingestManager.createDatasource.cancelLinkText" - defaultMessage="Cancel" - /> - </EuiButtonEmpty> - </EuiFlexItem> - <EuiFlexItem grow={false}> - <EuiButton - fill - iconType="arrowRight" - iconSide="right" - isLoading={selectedConfigLoading} - disabled={!selectedConfigId || !!selectedConfigError || selectedConfigLoading} - onClick={() => onNext()} - > - <FormattedMessage - id="xpack.ingestManager.createDatasource.continueButtonText" - defaultMessage="Continue" - /> - </EuiButton> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> </EuiFlexGroup> ); }; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_package.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_package.tsx index 496e1d3c0fd7b..8dabb3bc98110 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_package.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/agent_config/create_datasource_page/step_select_package.tsx @@ -6,15 +6,7 @@ import React, { useEffect, useState, Fragment } from 'react'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { - EuiButtonEmpty, - EuiButton, - EuiFlexGroup, - EuiFlexItem, - EuiTitle, - EuiSelectable, - EuiSpacer, -} from '@elastic/eui'; +import { EuiFlexGroup, EuiFlexItem, EuiSelectable, EuiSpacer } from '@elastic/eui'; import { Error } from '../../../components'; import { AgentConfig, PackageInfo } from '../../../types'; import { useGetOneAgentConfig, useGetPackages, sendGetPackageInfoByKey } from '../../../hooks'; @@ -25,14 +17,11 @@ export const StepSelectPackage: React.FunctionComponent<{ updateAgentConfig: (config: AgentConfig | undefined) => void; packageInfo?: PackageInfo; updatePackageInfo: (packageInfo: PackageInfo | undefined) => void; - cancelUrl: string; - onNext: () => void; -}> = ({ agentConfigId, updateAgentConfig, packageInfo, updatePackageInfo, cancelUrl, onNext }) => { +}> = ({ agentConfigId, updateAgentConfig, packageInfo, updatePackageInfo }) => { // Selected package state const [selectedPkgKey, setSelectedPkgKey] = useState<string | undefined>( packageInfo ? `${packageInfo.name}-${packageInfo.version}` : undefined ); - const [selectedPkgLoading, setSelectedPkgLoading] = useState<boolean>(false); const [selectedPkgError, setSelectedPkgError] = useState<Error>(); // Fetch agent config info @@ -57,9 +46,7 @@ export const StepSelectPackage: React.FunctionComponent<{ useEffect(() => { const fetchPackageInfo = async () => { if (selectedPkgKey) { - setSelectedPkgLoading(true); const { data, error } = await sendGetPackageInfoByKey(selectedPkgKey); - setSelectedPkgLoading(false); if (error) { setSelectedPkgError(error); updatePackageInfo(undefined); @@ -109,16 +96,6 @@ export const StepSelectPackage: React.FunctionComponent<{ return ( <EuiFlexGroup direction="column"> - <EuiFlexItem> - <EuiTitle size="s"> - <h3> - <FormattedMessage - id="xpack.ingestManager.createDatasource.stepSelectPackage.selectPackageTitle" - defaultMessage="Select integration" - /> - </h3> - </EuiTitle> - </EuiFlexItem> <EuiFlexItem> <EuiSelectable searchable @@ -186,33 +163,6 @@ export const StepSelectPackage: React.FunctionComponent<{ /> </EuiFlexItem> ) : null} - <EuiFlexItem> - <EuiFlexGroup justifyContent="flexEnd"> - <EuiFlexItem grow={false}> - <EuiButtonEmpty href={cancelUrl}> - <FormattedMessage - id="xpack.ingestManager.createDatasource.cancelLinkText" - defaultMessage="Cancel" - /> - </EuiButtonEmpty> - </EuiFlexItem> - <EuiFlexItem grow={false}> - <EuiButton - fill - iconType="arrowRight" - iconSide="right" - isLoading={selectedPkgLoading} - disabled={!selectedPkgKey || !!selectedPkgError || selectedPkgLoading} - onClick={() => onNext()} - > - <FormattedMessage - id="xpack.ingestManager.createDatasource.continueButtonText" - defaultMessage="Continue" - /> - </EuiButton> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> </EuiFlexGroup> ); }; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/components/agent_enrollment_flyout/instructions.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/components/agent_enrollment_flyout/instructions.tsx index 1bc20c2baf660..a0244c601cd96 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/components/agent_enrollment_flyout/instructions.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/components/agent_enrollment_flyout/instructions.tsx @@ -86,7 +86,7 @@ export const EnrollmentInstructions: React.FunctionComponent<Props> = ({ selecte steps={[ { title: i18n.translate('xpack.ingestManager.agentEnrollment.stepSetupAgents', { - defaultMessage: 'Setup Beats agent', + defaultMessage: 'Setup Elastic agent', }), children: ( <ShellEnrollmentInstructions diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/index.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/index.tsx index 22314b6231d1e..d363c472f2305 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/index.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/fleet/agent_list_page/index.tsx @@ -364,7 +364,7 @@ export const AgentListPage: React.FunctionComponent<{}> = () => { <h2> <FormattedMessage id="xpack.ingestManager.agentList.noAgentsPrompt" - defaultMessage="No agents installed" + defaultMessage="No agents enrolled" /> </h2> } @@ -373,7 +373,7 @@ export const AgentListPage: React.FunctionComponent<{}> = () => { <EuiButton fill iconType="plusInCircle" onClick={() => setIsEnrollmentFlyoutOpen(true)}> <FormattedMessage id="xpack.ingestManager.agentList.addButton" - defaultMessage="Install new agent" + defaultMessage="Enroll new agent" /> </EuiButton> ) : null diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index e579830bad203..3cebde793a085 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -8283,7 +8283,6 @@ "xpack.ingestManager.agentConfigForm.systemMonitoringFieldLabel": "オプション", "xpack.ingestManager.agentConfigForm.systemMonitoringText": "システムメトリックを収集", "xpack.ingestManager.agentConfigForm.systemMonitoringTooltipText": "このオプションを有効にすると、システムメトリックと情報を収集するデータソースで構成をブートストラップできます。", - "xpack.ingestManager.agentConfigInfo.yamlTabName": "YAML", "xpack.ingestManager.agentConfigList.actionsColumnTitle": "アクション", "xpack.ingestManager.agentConfigList.actionsMenuText": "開く", "xpack.ingestManager.agentConfigList.addButton": "エージェント構成を作成", @@ -8421,21 +8420,14 @@ "xpack.ingestManager.createAgentConfig.flyoutTitleDescription": "エージェント構成は、エージェントのグループ全体にわたる設定を管理する目的で使用されます。エージェント構成にデータソースを追加すると、エージェントで収集するデータを指定できます。エージェント構成の編集時には、フリートを使用して、指定したエージェントのグループに更新をデプロイできます。", "xpack.ingestManager.createAgentConfig.submitButtonLabel": "エージェント構成を作成", "xpack.ingestManager.createAgentConfig.successNotificationTitle": "エージェント構成「{name}」を作成しました", - "xpack.ingestManager.createDatasource.addDatasourceButtonText": "データソースに構成を追加", "xpack.ingestManager.createDatasource.agentConfigurationNameLabel": "構成", "xpack.ingestManager.createDatasource.cancelLinkText": "キャンセル", - "xpack.ingestManager.createDatasource.changeConfigLinkText": "構成を変更", - "xpack.ingestManager.createDatasource.changePackageLinkText": "パッケージを変更", - "xpack.ingestManager.createDatasource.continueButtonText": "続行", - "xpack.ingestManager.createDatasource.editDatasourceLinkText": "データソースを編集", "xpack.ingestManager.createDatasource.packageNameLabel": "パッケージ", "xpack.ingestManager.createDatasource.pageTitle": "データソースを作成", "xpack.ingestManager.createDatasource.stepConfigure.advancedOptionsToggleLinkText": "高度なオプション", - "xpack.ingestManager.createDatasource.stepConfigure.chooseDataTitle": "収集したいデータを選択してください", "xpack.ingestManager.createDatasource.stepConfigure.datasourceDescriptionInputLabel": "説明", "xpack.ingestManager.createDatasource.stepConfigure.datasourceNameInputLabel": "データソース名", "xpack.ingestManager.createDatasource.stepConfigure.datasourceNamespaceInputLabel": "名前空間", - "xpack.ingestManager.createDatasource.stepConfigure.defineDatasourceTitle": "データソースを定義する", "xpack.ingestManager.createDatasource.stepConfigure.hideStreamsAriaLabel": "{type} ストリームを隠す", "xpack.ingestManager.createDatasource.stepConfigure.inputSettingsDescription": "次の設定はすべてのストリームに適用されます。", "xpack.ingestManager.createDatasource.stepConfigure.inputSettingsTitle": "設定", @@ -8444,27 +8436,15 @@ "xpack.ingestManager.createDatasource.stepConfigure.showStreamsAriaLabel": "{type} ストリームを表示", "xpack.ingestManager.createDatasource.stepConfigure.streamsEnabledCountText": "{count} / {total, plural, one {# ストリーム} other {# ストリーム}}が有効です", "xpack.ingestManager.createDatasource.stepConfigure.toggleAdvancedOptionsButtonText": "高度なオプション", - "xpack.ingestManager.createDatasource.stepConfigureDatasourceLabel": "構成データソース", - "xpack.ingestManager.createDatasource.stepReview.agentsAffectedCalloutText": "選択されたエージェント構成 {configName} が一部のエージェントで既に使用されていることをフリートが検出しました。このアクションの結果として、フリートはこの構成に登録されているすべてのエージェントを更新します。", - "xpack.ingestManager.createDatasource.stepReview.agentsAffectedCalloutTitle": "このアクションは {count, plural, one {# エージェント} other {# エージェント}}に影響します", - "xpack.ingestManager.createDatasource.stepReview.confirmAgentDisclaimerText": "このアクションによって、この構成に登録されているすべてのエージェントが更新されることを理解しています。", - "xpack.ingestManager.createDatasource.stepReview.confirmAgentDisclaimerTitle": "意思決定を確認", - "xpack.ingestManager.createDatasource.stepReview.reviewTitle": "変更の見直し", - "xpack.ingestManager.createDatasource.stepReviewLabel": "見直し", "xpack.ingestManager.createDatasource.StepSelectConfig.agentConfigAgentsCountText": "{count, plural, one {# エージェント} other {# エージェント}}", - "xpack.ingestManager.createDatasource.StepSelectConfig.createNewConfigButtonText": "新しい構成を作成", "xpack.ingestManager.createDatasource.StepSelectConfig.errorLoadingAgentConfigsTitle": "エージェント構成の読み込みエラー", "xpack.ingestManager.createDatasource.StepSelectConfig.errorLoadingPackageTitle": "パッケージ情報の読み込みエラー", "xpack.ingestManager.createDatasource.StepSelectConfig.errorLoadingSelectedAgentConfigTitle": "選択したエージェント構成の読み込みエラー", "xpack.ingestManager.createDatasource.StepSelectConfig.filterAgentConfigsInputPlaceholder": "エージェント構成の検索", - "xpack.ingestManager.createDatasource.StepSelectConfig.selectAgentConfigTitle": "エージェント構成を選択する", - "xpack.ingestManager.createDatasource.stepSelectConfigLabel": "構成を選択", "xpack.ingestManager.createDatasource.stepSelectPackage.errorLoadingConfigTitle": "エージェント構成情報の読み込みエラー", "xpack.ingestManager.createDatasource.stepSelectPackage.errorLoadingPackagesTitle": "パッケージの読み込みエラー", "xpack.ingestManager.createDatasource.stepSelectPackage.errorLoadingSelectedPackageTitle": "選択したパッケージの読み込みエラー", "xpack.ingestManager.createDatasource.stepSelectPackage.filterPackagesInputPlaceholder": "パッケージの検索", - "xpack.ingestManager.createDatasource.stepSelectPackage.selectPackageTitle": "パッケージを選択する", - "xpack.ingestManager.createDatasource.stepSelectPackageLabel": "パッケージを選択", "xpack.ingestManager.deleteAgentConfigs.confirmModal.affectedAgentsMessage": "{agentsCount, plural, one {# エージェントを} other {# エージェントを}}{agentConfigsCount, plural, one {このエージェント構成に} other {これらのエージェント構成に}}割り当てました。 {agentsCount, plural, one {このエージェント} other {これらのエージェント}}の登録が解除されます。", "xpack.ingestManager.deleteAgentConfigs.confirmModal.cancelButtonLabel": "キャンセル", "xpack.ingestManager.deleteAgentConfigs.confirmModal.confirmAndReassignButtonLabel": "{agentConfigsCount, plural, one {エージェント構成} other {エージェント構成}} and unenroll {agentsCount, plural, one {エージェント} other {エージェント}} を削除", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index 75f48fb11823a..1daf66117e948 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -8286,7 +8286,6 @@ "xpack.ingestManager.agentConfigForm.systemMonitoringFieldLabel": "可选", "xpack.ingestManager.agentConfigForm.systemMonitoringText": "收集系统指标", "xpack.ingestManager.agentConfigForm.systemMonitoringTooltipText": "启用此选项可使用收集系统指标和信息的数据源启动您的配置。", - "xpack.ingestManager.agentConfigInfo.yamlTabName": "YAML", "xpack.ingestManager.agentConfigList.actionsColumnTitle": "操作", "xpack.ingestManager.agentConfigList.actionsMenuText": "打开", "xpack.ingestManager.agentConfigList.addButton": "创建代理配置", @@ -8424,21 +8423,14 @@ "xpack.ingestManager.createAgentConfig.flyoutTitleDescription": "代理配置用于管理整个代理组的设置。您可以将数据源添加到代理配置以指定代理收集的数据。编辑代理配置时，可以使用 Fleet 将更新部署到指定的代理组。", "xpack.ingestManager.createAgentConfig.submitButtonLabel": "创建代理配置", "xpack.ingestManager.createAgentConfig.successNotificationTitle": "代理配置“{name}”已创建", - "xpack.ingestManager.createDatasource.addDatasourceButtonText": "将数据源添加到配置", "xpack.ingestManager.createDatasource.agentConfigurationNameLabel": "配置", "xpack.ingestManager.createDatasource.cancelLinkText": "取消", - "xpack.ingestManager.createDatasource.changeConfigLinkText": "更改配置", - "xpack.ingestManager.createDatasource.changePackageLinkText": "更改软件包", - "xpack.ingestManager.createDatasource.continueButtonText": "继续", - "xpack.ingestManager.createDatasource.editDatasourceLinkText": "编辑数据源", "xpack.ingestManager.createDatasource.packageNameLabel": "软件包", "xpack.ingestManager.createDatasource.pageTitle": "创建数据源", "xpack.ingestManager.createDatasource.stepConfigure.advancedOptionsToggleLinkText": "高级选项", - "xpack.ingestManager.createDatasource.stepConfigure.chooseDataTitle": "选择要收集的数据", "xpack.ingestManager.createDatasource.stepConfigure.datasourceDescriptionInputLabel": "描述", "xpack.ingestManager.createDatasource.stepConfigure.datasourceNameInputLabel": "数据源名称", "xpack.ingestManager.createDatasource.stepConfigure.datasourceNamespaceInputLabel": "命名空间", - "xpack.ingestManager.createDatasource.stepConfigure.defineDatasourceTitle": "定义您的数据源", "xpack.ingestManager.createDatasource.stepConfigure.hideStreamsAriaLabel": "隐藏 {type} 流", "xpack.ingestManager.createDatasource.stepConfigure.inputSettingsDescription": "以下设置适用于所有流。", "xpack.ingestManager.createDatasource.stepConfigure.inputSettingsTitle": "设置", @@ -8447,27 +8439,15 @@ "xpack.ingestManager.createDatasource.stepConfigure.showStreamsAriaLabel": "显示 {type} 流", "xpack.ingestManager.createDatasource.stepConfigure.streamsEnabledCountText": "{count} / {total, plural, one {# 个流} other {# 个流}}已启用", "xpack.ingestManager.createDatasource.stepConfigure.toggleAdvancedOptionsButtonText": "高级选项", - "xpack.ingestManager.createDatasource.stepConfigureDatasourceLabel": "配置数据源", - "xpack.ingestManager.createDatasource.stepReview.agentsAffectedCalloutText": "Fleet 检测到所选代理配置 {configName} 已由您的部分代理使用。此操作的结果是，Fleet 将更新用此配置进行注册的所有代理。", - "xpack.ingestManager.createDatasource.stepReview.agentsAffectedCalloutTitle": "此操作将影响 {count, plural, one {# 个代理} other {# 个代理}}", - "xpack.ingestManager.createDatasource.stepReview.confirmAgentDisclaimerText": "我理解此操作将更新注册到此配置的所有代理。", - "xpack.ingestManager.createDatasource.stepReview.confirmAgentDisclaimerTitle": "确认您的决定", - "xpack.ingestManager.createDatasource.stepReview.reviewTitle": "复查更改", - "xpack.ingestManager.createDatasource.stepReviewLabel": "复查", "xpack.ingestManager.createDatasource.StepSelectConfig.agentConfigAgentsCountText": "{count, plural, one {# 个代理} other {# 个代理}}", - "xpack.ingestManager.createDatasource.StepSelectConfig.createNewConfigButtonText": "创建新配置", "xpack.ingestManager.createDatasource.StepSelectConfig.errorLoadingAgentConfigsTitle": "加载代理配置时出错", "xpack.ingestManager.createDatasource.StepSelectConfig.errorLoadingPackageTitle": "加载软件包信息时出错", "xpack.ingestManager.createDatasource.StepSelectConfig.errorLoadingSelectedAgentConfigTitle": "加载选定代理配置时出错", "xpack.ingestManager.createDatasource.StepSelectConfig.filterAgentConfigsInputPlaceholder": "搜索代理配置", - "xpack.ingestManager.createDatasource.StepSelectConfig.selectAgentConfigTitle": "选择代理配置", - "xpack.ingestManager.createDatasource.stepSelectConfigLabel": "选择配置", "xpack.ingestManager.createDatasource.stepSelectPackage.errorLoadingConfigTitle": "加载代理配置信息时出错", "xpack.ingestManager.createDatasource.stepSelectPackage.errorLoadingPackagesTitle": "加载软件包时出错", "xpack.ingestManager.createDatasource.stepSelectPackage.errorLoadingSelectedPackageTitle": "加载选定软件包时出错", "xpack.ingestManager.createDatasource.stepSelectPackage.filterPackagesInputPlaceholder": "搜索软件包", - "xpack.ingestManager.createDatasource.stepSelectPackage.selectPackageTitle": "选择软件包", - "xpack.ingestManager.createDatasource.stepSelectPackageLabel": "选择软件包", "xpack.ingestManager.deleteAgentConfigs.confirmModal.affectedAgentsMessage": "{agentsCount, plural, one {# 个代理} other {# 个代理}}已分配{agentConfigsCount, plural, one {给此代理配置} other {给这些代理配置}}。将取消注册{agentsCount, plural, one {此代理} other {这些代理}}。", "xpack.ingestManager.deleteAgentConfigs.confirmModal.cancelButtonLabel": "取消", "xpack.ingestManager.deleteAgentConfigs.confirmModal.confirmAndReassignButtonLabel": "删除{agentConfigsCount, plural, one {代理配置} other {代理配置}}并取消注册{agentsCount, plural, one {代理} other {代理}}", From d00c90510d11e4575a3453b3437221b341a7478f Mon Sep 17 00:00:00 2001 From: Robert Austin <robert.austin@elastic.co> Date: Mon, 13 Apr 2020 11:33:14 -0400 Subject: [PATCH 057/102] Endpoint: Move files, add README, replace implicit `any` with stricter types. Reorganize types. (#63262) * Removed `FIXME` comments and references to private repos. Please use Github issues to track work * Added a README describing the modules in `applications/endpoint` * Removed dead code * Moved `AppRoot` component to its own module * Moved `applications/endpoint/services` under `store` * Moved some exported types to `applications/endpoint/types` * Moved all React code to `view` * Added types in some places that were implicitly `any` * Moved `PageId` type from common directory (where it could be shared with the server) to the public directory --- .../plugins/endpoint/common/generate_data.ts | 1 - x-pack/plugins/endpoint/common/types.ts | 5 -- .../public/applications/endpoint/README.md | 28 +++++++++ .../endpoint/components/truncate_text.ts | 13 ---- .../public/applications/endpoint/index.tsx | 51 +--------------- .../endpoint/store/alerts/index.ts | 1 - .../store/policy_details/middleware.ts | 14 +++-- .../endpoint/store/policy_list/middleware.ts | 4 +- .../policy_list}/services/ingest.test.ts | 2 +- .../policy_list}/services/ingest.ts | 32 +++------- .../endpoint/store/routing/action.ts | 4 +- .../public/applications/endpoint/types.ts | 27 ++++++++- .../applications/endpoint/view/app_root.tsx | 59 +++++++++++++++++++ .../__snapshots__/link_to_app.test.tsx.snap | 0 .../__snapshots__/page_view.test.tsx.snap | 0 .../components/header_navigation.tsx} | 7 ++- .../components/link_to_app.test.tsx | 17 ++++-- .../{ => view}/components/link_to_app.tsx | 2 +- .../{ => view}/components/page_view.test.tsx | 2 +- .../{ => view}/components/page_view.tsx | 0 .../use_navigate_to_app_event_handler.ts | 2 +- .../endpoint/view/hosts/details.tsx | 2 +- .../endpoint/view/hosts/index.test.tsx | 1 - .../endpoint/view/policy/policy_details.tsx | 5 +- .../endpoint/view/policy/policy_list.tsx | 4 +- .../applications/endpoint/view/use_page_id.ts | 2 +- 26 files changed, 161 insertions(+), 124 deletions(-) create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/README.md delete mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/components/truncate_text.ts rename x-pack/plugins/endpoint/public/applications/endpoint/{ => store/policy_list}/services/ingest.test.ts (95%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => store/policy_list}/services/ingest.ts (77%) create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/app_root.tsx rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/components/__snapshots__/link_to_app.test.tsx.snap (100%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/components/__snapshots__/page_view.test.tsx.snap (100%) rename x-pack/plugins/endpoint/public/applications/endpoint/{components/header_nav.tsx => view/components/header_navigation.tsx} (90%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/components/link_to_app.test.tsx (86%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/components/link_to_app.tsx (96%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/components/page_view.test.tsx (96%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/components/page_view.tsx (100%) rename x-pack/plugins/endpoint/public/applications/endpoint/{ => view}/hooks/use_navigate_to_app_event_handler.ts (96%) diff --git a/x-pack/plugins/endpoint/common/generate_data.ts b/x-pack/plugins/endpoint/common/generate_data.ts index 7c24bd9d77148..3f783d90e577d 100644 --- a/x-pack/plugins/endpoint/common/generate_data.ts +++ b/x-pack/plugins/endpoint/common/generate_data.ts @@ -7,7 +7,6 @@ import uuid from 'uuid'; import seedrandom from 'seedrandom'; import { AlertEvent, EndpointEvent, HostMetadata, OSFields, HostFields } from './types'; -// FIXME: move types/model to top-level // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { PolicyData } from '../public/applications/endpoint/types'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths diff --git a/x-pack/plugins/endpoint/common/types.ts b/x-pack/plugins/endpoint/common/types.ts index a614526d92a3f..403ca9832e191 100644 --- a/x-pack/plugins/endpoint/common/types.ts +++ b/x-pack/plugins/endpoint/common/types.ts @@ -375,11 +375,6 @@ export interface EndpointEvent { export type ResolverEvent = EndpointEvent | LegacyEndpointEvent; -/** - * The PageId type is used for the payload when firing userNavigatedToPage actions - */ -export type PageId = 'alertsPage' | 'managementPage' | 'policyListPage'; - /** * Takes a @kbn/config-schema 'schema' type and returns a type that represents valid inputs. * Similar to `TypeOf`, but allows strings as input for `schema.number()` (which is inline diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/README.md b/x-pack/plugins/endpoint/public/applications/endpoint/README.md new file mode 100644 index 0000000000000..25bfd615d1d2c --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/README.md @@ -0,0 +1,28 @@ +# Endpoint application +This application provides the user interface for the Elastic Endpoint + +# Architecture +The application consists of a _view_ written in React and a _model_ written in Redux. + +# Modules +We structure the modules to match the architecture. `view` contains the _view_ (all React) code. `store` contains the _model_. + +This section covers the conventions of each top level module. + +# `mocks` +This contains helper code for unit tests. + +## `models` +This contains domain models. By convention, each submodule here contains methods for a single type. Domain model classes would also live here. + +## `store` +This contains the _model_ of the application. All Redux and Redux middleware code (including API interactions) happen here. This module also contains the types and interfaces defining Redux actions. Each action type or interface should be commented and if it has fields, each field should be commented. Comments should be of `tsdoc` style. + +## `view` +This contains the code which renders elements to the DOM. All React code goes here. + +## `index.tsx` +This exports `renderApp` which instantiates the React view with the _model_. + +## `types.ts` +This contains the types and interfaces. All `export`ed types or interfaces (except ones defining Redux actions, which live in `store`) should be here. Each type or interface should have a `tsdoc` style comment. Interfaces should have `tsdoc` comments on each field and types which have fields should do the same. diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/truncate_text.ts b/x-pack/plugins/endpoint/public/applications/endpoint/components/truncate_text.ts deleted file mode 100644 index 83f4bc1e79317..0000000000000 --- a/x-pack/plugins/endpoint/public/applications/endpoint/components/truncate_text.ts +++ /dev/null @@ -1,13 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import styled from 'styled-components'; - -export const TruncateText = styled.div` - overflow: hidden; - white-space: nowrap; - text-overflow: ellipsis; -`; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/index.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/index.tsx index 82ac95160519c..a1999c056bf59 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/index.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/index.tsx @@ -6,19 +6,10 @@ import * as React from 'react'; import ReactDOM from 'react-dom'; -import { CoreStart, AppMountParameters, ScopedHistory } from 'kibana/public'; -import { FormattedMessage } from '@kbn/i18n/react'; -import { Route, Switch } from 'react-router-dom'; -import { Store } from 'redux'; +import { CoreStart, AppMountParameters } from 'kibana/public'; import { EndpointPluginStartDependencies } from '../../plugin'; import { appStoreFactory } from './store'; -import { AlertIndex } from './view/alerts'; -import { HostList } from './view/hosts'; -import { PolicyList } from './view/policy'; -import { PolicyDetails } from './view/policy'; -import { HeaderNavigation } from './components/header_nav'; -import { AppRootProvider } from './view/app_root_provider'; -import { Setup } from './view/setup'; +import { AppRoot } from './view/app_root'; /** * This module will be loaded asynchronously to reduce the bundle size of your plugin's main bundle. @@ -37,41 +28,3 @@ export function renderApp( ReactDOM.unmountComponentAtNode(element); }; } - -interface RouterProps { - history: ScopedHistory; - store: Store; - coreStart: CoreStart; - depsStart: EndpointPluginStartDependencies; -} - -const AppRoot: React.FunctionComponent<RouterProps> = React.memo( - ({ history, store, coreStart, depsStart }) => { - return ( - <AppRootProvider store={store} history={history} coreStart={coreStart} depsStart={depsStart}> - <Setup ingestManager={depsStart.ingestManager} notifications={coreStart.notifications} /> - <HeaderNavigation /> - <Switch> - <Route - exact - path="/" - render={() => ( - <h1 data-test-subj="welcomeTitle"> - <FormattedMessage id="xpack.endpoint.welcomeTitle" defaultMessage="Hello World" /> - </h1> - )} - /> - <Route path="/hosts" component={HostList} /> - <Route path="/alerts" component={AlertIndex} /> - <Route path="/policy" exact component={PolicyList} /> - <Route path="/policy/:id" exact component={PolicyDetails} /> - <Route - render={() => ( - <FormattedMessage id="xpack.endpoint.notFound" defaultMessage="Page Not Found" /> - )} - /> - </Switch> - </AppRootProvider> - ); - } -); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/alerts/index.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/alerts/index.ts index f63910a1c305e..5545218d9abd6 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/alerts/index.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/alerts/index.ts @@ -6,4 +6,3 @@ export { alertListReducer } from './reducer'; export { AlertAction } from './action'; -export * from '../../types'; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts index 18248e272aada..a00ce255cbac4 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts @@ -4,15 +4,19 @@ * you may not use this file except in compliance with the Elastic License. */ -import { MiddlewareFactory, PolicyData, PolicyDetailsState } from '../../types'; +import { + MiddlewareFactory, + PolicyData, + PolicyDetailsState, + UpdateDatasourceResponse, +} from '../../types'; import { policyIdFromParams, isOnPolicyDetailsPage, policyDetails } from './selectors'; +import { generatePolicy } from '../../models/policy'; import { sendGetDatasource, sendGetFleetAgentStatusForConfig, sendPutDatasource, - UpdateDatasourceResponse, -} from '../../services/ingest'; -import { generatePolicy } from '../../models/policy'; +} from '../policy_list/services/ingest'; export const policyDetailsMiddlewareFactory: MiddlewareFactory<PolicyDetailsState> = coreStart => { const http = coreStart.http; @@ -35,7 +39,6 @@ export const policyDetailsMiddlewareFactory: MiddlewareFactory<PolicyDetailsStat return; } - // FIXME: remove this code once the Default Policy is available in the endpoint package - see: https://github.com/elastic/endpoint-app-team/issues/295 // Until we get the Default configuration into the Endpoint package so that the datasource has // the expected data structure, we will add it here manually. if (!policyItem.inputs.length) { @@ -62,7 +65,6 @@ export const policyDetailsMiddlewareFactory: MiddlewareFactory<PolicyDetailsStat // Agent summary is secondary data, so its ok for it to come after the details // page is populated with the main content - // FIXME: need to only do this IF fleet is enabled - see: https://github.com/elastic/endpoint-app-team/issues/296 if (policyItem.config_id) { const { results } = await sendGetFleetAgentStatusForConfig(http, policyItem.config_id); dispatch({ diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts index ebfee5dbe6a7e..adc176740fb4b 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts @@ -4,8 +4,8 @@ * you may not use this file except in compliance with the Elastic License. */ -import { MiddlewareFactory, PolicyListState } from '../../types'; -import { GetDatasourcesResponse, sendGetEndpointSpecificDatasources } from '../../services/ingest'; +import { MiddlewareFactory, PolicyListState, GetDatasourcesResponse } from '../../types'; +import { sendGetEndpointSpecificDatasources } from './services/ingest'; export const policyListMiddlewareFactory: MiddlewareFactory<PolicyListState> = coreStart => { const http = coreStart.http; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/services/ingest.test.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.test.ts similarity index 95% rename from x-pack/plugins/endpoint/public/applications/endpoint/services/ingest.test.ts rename to x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.test.ts index a2c1dfbe09a48..c2865d36c95f2 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/services/ingest.test.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.test.ts @@ -4,8 +4,8 @@ * you may not use this file except in compliance with the Elastic License. */ -import { httpServiceMock } from '../../../../../../../src/core/public/mocks'; import { sendGetDatasource, sendGetEndpointSpecificDatasources } from './ingest'; +import { httpServiceMock } from '../../../../../../../../../src/core/public/mocks'; describe('ingest service', () => { let http: ReturnType<typeof httpServiceMock.createStartContract>; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/services/ingest.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts similarity index 77% rename from x-pack/plugins/endpoint/public/applications/endpoint/services/ingest.ts rename to x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts index 583ebc55d896b..16c885f26f0a4 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/services/ingest.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts @@ -6,37 +6,21 @@ import { HttpFetchOptions, HttpStart } from 'kibana/public'; import { - CreateDatasourceResponse, - GetAgentStatusResponse, GetDatasourcesRequest, -} from '../../../../../ingest_manager/common/types/rest_spec'; -import { NewPolicyData, PolicyData } from '../types'; + GetAgentStatusResponse, +} from '../../../../../../../ingest_manager/common'; +import { + NewPolicyData, + GetDatasourcesResponse, + GetDatasourceResponse, + UpdateDatasourceResponse, +} from '../../../types'; const INGEST_API_ROOT = `/api/ingest_manager`; const INGEST_API_DATASOURCES = `${INGEST_API_ROOT}/datasources`; const INGEST_API_FLEET = `${INGEST_API_ROOT}/fleet`; const INGEST_API_FLEET_AGENT_STATUS = `${INGEST_API_FLEET}/agent-status`; -// FIXME: Import from ingest after - https://github.com/elastic/kibana/issues/60677 -export interface GetDatasourcesResponse { - items: PolicyData[]; - total: number; - page: number; - perPage: number; - success: boolean; -} - -// FIXME: Import from Ingest after - https://github.com/elastic/kibana/issues/60677 -export interface GetDatasourceResponse { - item: PolicyData; - success: boolean; -} - -// FIXME: Import from Ingest after - https://github.com/elastic/kibana/issues/60677 -export type UpdateDatasourceResponse = CreateDatasourceResponse & { - item: PolicyData; -}; - /** * Retrieves a list of endpoint specific datasources (those created with a `package.name` of * `endpoint`) from Ingest diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts index c7e9970e58c30..f22272bc68233 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts @@ -4,8 +4,8 @@ * you may not use this file except in compliance with the Elastic License. */ -import { PageId, Immutable } from '../../../../../common/types'; -import { EndpointAppLocation } from '../alerts'; +import { Immutable } from '../../../../../common/types'; +import { EndpointAppLocation, PageId } from '../../types'; interface UserNavigatedToPage { readonly type: 'userNavigatedToPage'; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts index dda50847169e7..f9ad8f6708f6b 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts @@ -18,7 +18,10 @@ import { EndpointPluginStartDependencies } from '../../plugin'; import { AppAction } from './store/action'; import { CoreStart } from '../../../../../../src/core/public'; import { Datasource, NewDatasource } from '../../../../ingest_manager/common/types/models'; -import { GetAgentStatusResponse } from '../../../../ingest_manager/common/types/rest_spec'; +import { + GetAgentStatusResponse, + CreateDatasourceResponse, +} from '../../../../ingest_manager/common/types/rest_spec'; export { AppAction }; export type MiddlewareFactory<S = GlobalState> = ( @@ -317,3 +320,25 @@ export interface AlertingIndexUIQueryParams { date_range?: string; filters?: string; } + +export interface GetDatasourcesResponse { + items: PolicyData[]; + total: number; + page: number; + perPage: number; + success: boolean; +} + +export interface GetDatasourceResponse { + item: PolicyData; + success: boolean; +} + +export type UpdateDatasourceResponse = CreateDatasourceResponse & { + item: PolicyData; +}; + +/** + * The PageId type is used for the payload when firing userNavigatedToPage actions + */ +export type PageId = 'alertsPage' | 'managementPage' | 'policyListPage'; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/app_root.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/app_root.tsx new file mode 100644 index 0000000000000..f9634c63deefb --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/app_root.tsx @@ -0,0 +1,59 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import * as React from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { Route, Switch } from 'react-router-dom'; +import { Store } from 'redux'; +import { AlertIndex } from './alerts'; +import { HostList } from './hosts'; +import { PolicyList } from './policy'; +import { PolicyDetails } from './policy'; +import { HeaderNavigation } from './components/header_navigation'; +import { AppRootProvider } from './app_root_provider'; +import { Setup } from './setup'; +import { EndpointPluginStartDependencies } from '../../../plugin'; +import { ScopedHistory, CoreStart } from '../../../../../../../src/core/public'; + +interface RouterProps { + history: ScopedHistory; + store: Store; + coreStart: CoreStart; + depsStart: EndpointPluginStartDependencies; +} + +/** + * The root of the Endpoint application react view. + */ +export const AppRoot: React.FunctionComponent<RouterProps> = React.memo( + ({ history, store, coreStart, depsStart }) => { + return ( + <AppRootProvider store={store} history={history} coreStart={coreStart} depsStart={depsStart}> + <Setup ingestManager={depsStart.ingestManager} notifications={coreStart.notifications} /> + <HeaderNavigation /> + <Switch> + <Route + exact + path="/" + render={() => ( + <h1 data-test-subj="welcomeTitle"> + <FormattedMessage id="xpack.endpoint.welcomeTitle" defaultMessage="Hello World" /> + </h1> + )} + /> + <Route path="/hosts" component={HostList} /> + <Route path="/alerts" component={AlertIndex} /> + <Route path="/policy" exact component={PolicyList} /> + <Route path="/policy/:id" exact component={PolicyDetails} /> + <Route + render={() => ( + <FormattedMessage id="xpack.endpoint.notFound" defaultMessage="Page Not Found" /> + )} + /> + </Switch> + </AppRootProvider> + ); + } +); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/__snapshots__/link_to_app.test.tsx.snap b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/__snapshots__/link_to_app.test.tsx.snap similarity index 100% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/__snapshots__/link_to_app.test.tsx.snap rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/__snapshots__/link_to_app.test.tsx.snap diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/__snapshots__/page_view.test.tsx.snap b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/__snapshots__/page_view.test.tsx.snap similarity index 100% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/__snapshots__/page_view.test.tsx.snap rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/__snapshots__/page_view.test.tsx.snap diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/header_nav.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/header_navigation.tsx similarity index 90% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/header_nav.tsx rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/header_navigation.tsx index 3fb06d6b4a56e..6c294d9c86548 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/components/header_nav.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/header_navigation.tsx @@ -8,15 +8,16 @@ import React, { MouseEvent, useMemo } from 'react'; import { i18n } from '@kbn/i18n'; import { EuiTabs, EuiTab } from '@elastic/eui'; import { useHistory, useLocation } from 'react-router-dom'; -import { useKibana } from '../../../../../../../src/plugins/kibana_react/public'; +import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; +import { Immutable } from '../../../../../common/types'; -export interface NavTabs { +interface NavTabs { name: string; id: string; href: string; } -export const navTabs: NavTabs[] = [ +const navTabs: Immutable<NavTabs[]> = [ { id: 'home', name: i18n.translate('xpack.endpoint.headerNav.home', { diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.test.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/link_to_app.test.tsx similarity index 86% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.test.tsx rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/link_to_app.test.tsx index 902c215434aac..d0a8f9690dafb 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.test.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/link_to_app.test.tsx @@ -7,9 +7,14 @@ import React from 'react'; import { mount } from 'enzyme'; import { LinkToApp } from './link_to_app'; -import { KibanaContextProvider } from '../../../../../../../src/plugins/kibana_react/public'; -import { coreMock } from '../../../../../../../src/core/public/mocks'; import { CoreStart } from 'kibana/public'; +import { KibanaContextProvider } from '../../../../../../../../src/plugins/kibana_react/public'; +import { coreMock } from '../../../../../../../../src/core/public/mocks'; + +type LinkToAppOnClickMock<Return = void> = jest.Mock< + Return, + [React.MouseEvent<HTMLAnchorElement, MouseEvent>] +>; describe('LinkToApp component', () => { let fakeCoreStart: jest.Mocked<CoreStart>; @@ -38,7 +43,8 @@ describe('LinkToApp component', () => { ).toMatchSnapshot(); }); it('should support onClick prop', () => { - const spyOnClickHandler = jest.fn(); + // Take `_event` (even though it is not used) so that `jest.fn` will have a type that expects to be called with an event + const spyOnClickHandler: LinkToAppOnClickMock = jest.fn(_event => {}); const renderResult = render( <LinkToApp appId="ingestManager" href="/app/ingest" onClick={spyOnClickHandler}> link @@ -91,7 +97,8 @@ describe('LinkToApp component', () => { }); }); it('should still preventDefault if onClick callback throws', () => { - const spyOnClickHandler = jest.fn(ev => { + // Take `_event` (even though it is not used) so that `jest.fn` will have a type that expects to be called with an event + const spyOnClickHandler: LinkToAppOnClickMock<never> = jest.fn(_event => { throw new Error('test'); }); const renderResult = render( @@ -104,7 +111,7 @@ describe('LinkToApp component', () => { expect(clickEventArg.isDefaultPrevented()).toBe(true); }); it('should not navigate if onClick callback prevents defalut', () => { - const spyOnClickHandler = jest.fn(ev => { + const spyOnClickHandler: LinkToAppOnClickMock = jest.fn(ev => { ev.preventDefault(); }); const renderResult = render( diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/link_to_app.tsx similarity index 96% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/link_to_app.tsx index 858dac864b58a..6a3cf5e78f4bf 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/link_to_app.tsx @@ -9,7 +9,7 @@ import { EuiLink } from '@elastic/eui'; import { EuiLinkProps } from '@elastic/eui'; import { useNavigateToAppEventHandler } from '../hooks/use_navigate_to_app_event_handler'; -export type LinkToAppProps = EuiLinkProps & { +type LinkToAppProps = EuiLinkProps & { /** the app id - normally the value of the `id` in that plugin's `kibana.json` */ appId: string; /** Any app specific path (route) */ diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/page_view.test.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/page_view.test.tsx similarity index 96% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/page_view.test.tsx rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/page_view.test.tsx index 0d4d26737d355..4007477a088fa 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/components/page_view.test.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/page_view.test.tsx @@ -7,7 +7,7 @@ import React from 'react'; import { mount } from 'enzyme'; import { PageView } from './page_view'; -import { EuiThemeProvider } from '../../../../../../legacy/common/eui_styled_components'; +import { EuiThemeProvider } from '../../../../../../../legacy/common/eui_styled_components'; describe('PageView component', () => { const render = (ui: Parameters<typeof mount>[0]) => diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/page_view.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/components/page_view.tsx similarity index 100% rename from x-pack/plugins/endpoint/public/applications/endpoint/components/page_view.tsx rename to x-pack/plugins/endpoint/public/applications/endpoint/view/components/page_view.tsx diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/hooks/use_navigate_to_app_event_handler.ts b/x-pack/plugins/endpoint/public/applications/endpoint/view/hooks/use_navigate_to_app_event_handler.ts similarity index 96% rename from x-pack/plugins/endpoint/public/applications/endpoint/hooks/use_navigate_to_app_event_handler.ts rename to x-pack/plugins/endpoint/public/applications/endpoint/view/hooks/use_navigate_to_app_event_handler.ts index 5fbfa5e0e58a8..ec9a8691c481e 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/hooks/use_navigate_to_app_event_handler.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/hooks/use_navigate_to_app_event_handler.ts @@ -6,7 +6,7 @@ import { MouseEventHandler, useCallback } from 'react'; import { ApplicationStart } from 'kibana/public'; -import { useKibana } from '../../../../../../../src/plugins/kibana_react/public'; +import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; type NavigateToAppHandlerProps = Parameters<ApplicationStart['navigateToApp']>; type EventHandlerCallback = MouseEventHandler<HTMLButtonElement | HTMLAnchorElement>; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx index 90829f7ad4cbe..f51349b24933a 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx @@ -28,7 +28,7 @@ import { useHostListSelector } from './hooks'; import { urlFromQueryParams } from './url_from_query_params'; import { FormattedDateAndTime } from '../formatted_date_time'; import { uiQueryParams, detailsData, detailsError } from './../../store/hosts/selectors'; -import { LinkToApp } from '../../components/link_to_app'; +import { LinkToApp } from '../components/link_to_app'; const HostIds = styled(EuiListGroupItem)` margin-top: 0; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx index c3ff41268e3db..d2d0ad40b025f 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/index.test.tsx @@ -151,7 +151,6 @@ describe('when on the hosts page', () => { }); it('should navigate to logs without full page refresh', async () => { - // FIXME: this is not working :( expect(coreStart.application.navigateToApp.mock.calls).toHaveLength(1); }); }); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx index 1e723e32615eb..267077da6598c 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx @@ -29,7 +29,7 @@ import { isLoading, apiError, } from '../../store/policy_details/selectors'; -import { PageView, PageViewHeaderTitle } from '../../components/page_view'; +import { PageView, PageViewHeaderTitle } from '../components/page_view'; import { AppAction } from '../../types'; import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; import { AgentsSummary } from './agents_summary'; @@ -82,7 +82,7 @@ export const PolicyDetails = React.memo(() => { } }, [notifications.toasts, policyItem, policyName, policyUpdateStatus]); - const handleBackToListOnClick = useCallback( + const handleBackToListOnClick: React.MouseEventHandler = useCallback( ev => { ev.preventDefault(); history.push(`/policy`); @@ -161,7 +161,6 @@ export const PolicyDetails = React.memo(() => { fill={true} iconType="save" data-test-subj="policyDetailsSaveButton" - // FIXME: need to disable if User has no write permissions to ingest - see: https://github.com/elastic/endpoint-app-team/issues/296 onClick={handleSaveOnClick} isLoading={isPolicyLoading} > diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx index 5ee1539ce9788..06ba74aa46732 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx @@ -23,8 +23,8 @@ import { usePolicyListSelector } from './policy_hooks'; import { PolicyListAction } from '../../store/policy_list'; import { PolicyData } from '../../types'; import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; -import { PageView } from '../../components/page_view'; -import { LinkToApp } from '../../components/link_to_app'; +import { PageView } from '../components/page_view'; +import { LinkToApp } from '../components/link_to_app'; interface TableChangeCallbackArguments { page: { index: number; size: number }; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts b/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts index 49c39064c8d9a..85ed8a39fb386 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts @@ -6,8 +6,8 @@ import { useEffect } from 'react'; import { useDispatch } from 'react-redux'; -import { PageId } from '../../../../common/types'; import { RoutingAction } from '../store/routing'; +import { PageId } from '../types'; /** * Dispatches a 'userNavigatedToPage' action with the given 'pageId' as the action payload. From d5fc944b4bccdd987f05e5fcdcc5d8289eecfd92 Mon Sep 17 00:00:00 2001 From: Alexey Antonov <alexwizp@gmail.com> Date: Mon, 13 Apr 2020 18:59:48 +0300 Subject: [PATCH 058/102] Index pattern management UI -> TypeScript (source_filters_table) (#62925) * [WIP] Index pattern management UI -> TypeScript (source_filters_table) --- .../source_filters_table.test.tsx.snap} | 73 ++------ .../add_filter.test.tsx.snap} | 0 .../components/add_filter/add_filter.js | 73 -------- ...add_filter.test.js => add_filter.test.tsx} | 21 +-- .../components/add_filter/add_filter.tsx | 63 +++++++ .../add_filter/{index.js => index.ts} | 0 .../confirmation_modal.test.tsx.snap | 37 ++++ .../confirmation_modal.test.tsx | 37 ++++ .../confirmation_modal/confirmation_modal.tsx | 76 ++++++++ .../components/confirmation_modal/index.ts | 20 +++ .../header.test.tsx.snap} | 4 +- .../header.test.js => header.test.tsx} | 2 +- .../header/{header.js => header.tsx} | 5 +- .../components/header/{index.js => index.ts} | 0 .../source_filters_table/components/index.ts | 23 +++ .../table.test.tsx.snap} | 37 ++-- .../components/table/{index.js => index.ts} | 0 .../table.test.js => table.test.tsx} | 146 ++++++++------- .../components/table/{table.js => table.tsx} | 169 ++++++++++-------- .../{index.js => index.ts} | 0 ....test.js => source_filters_table.test.tsx} | 82 +++++---- ...ters_table.js => source_filters_table.tsx} | 138 ++++++-------- .../source_filters_table/types.ts | 24 +++ 23 files changed, 617 insertions(+), 413 deletions(-) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/{__jest__/__snapshots__/source_filters_table.test.js.snap => __snapshots__/source_filters_table.test.tsx.snap} (82%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/{__jest__/__snapshots__/add_filter.test.js.snap => __snapshots__/add_filter.test.tsx.snap} (100%) delete mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.js rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/{__jest__/add_filter.test.js => add_filter.test.tsx} (66%) create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.tsx rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/{index.js => index.ts} (100%) create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.test.tsx create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.tsx create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/index.ts rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/{__jest__/__snapshots__/header.test.js.snap => __snapshots__/header.test.tsx.snap} (98%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/{__jest__/header.test.js => header.test.tsx} (95%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/{header.js => header.tsx} (99%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/{index.js => index.ts} (100%) create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/index.ts rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/{__jest__/__snapshots__/table.test.js.snap => __snapshots__/table.test.tsx.snap} (77%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/{index.js => index.ts} (100%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/{__jest__/table.test.js => table.test.tsx} (69%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/{table.js => table.tsx} (54%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/{index.js => index.ts} (100%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/{__jest__/source_filters_table.test.js => source_filters_table.test.tsx} (64%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/{source_filters_table.js => source_filters_table.tsx} (56%) create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/types.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__jest__/__snapshots__/source_filters_table.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__snapshots__/source_filters_table.test.tsx.snap similarity index 82% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__jest__/__snapshots__/source_filters_table.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__snapshots__/source_filters_table.test.tsx.snap index 52fccb8607a83..a7b73624c4665 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__jest__/__snapshots__/source_filters_table.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__snapshots__/source_filters_table.test.tsx.snap @@ -1,7 +1,7 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP exports[`SourceFiltersTable should add a filter 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -50,11 +50,11 @@ exports[`SourceFiltersTable should add a filter 1`] = ` } saveFilter={[Function]} /> -</div> +</Fragment> `; exports[`SourceFiltersTable should filter based on the query bar 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -91,11 +91,11 @@ exports[`SourceFiltersTable should filter based on the query bar 1`] = ` } saveFilter={[Function]} /> -</div> +</Fragment> `; exports[`SourceFiltersTable should remove a filter 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -120,10 +120,6 @@ exports[`SourceFiltersTable should remove a filter 1`] = ` ], }, "sourceFilters": Array [ - Object { - "clientId": 1, - "value": "tim*", - }, Object { "clientId": 2, "value": "na*", @@ -136,21 +132,17 @@ exports[`SourceFiltersTable should remove a filter 1`] = ` Array [ Object { "clientId": 3, - "value": "tim*", - }, - Object { - "clientId": 4, "value": "na*", }, ] } saveFilter={[Function]} /> -</div> +</Fragment> `; exports[`SourceFiltersTable should render normally 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -195,11 +187,11 @@ exports[`SourceFiltersTable should render normally 1`] = ` } saveFilter={[Function]} /> -</div> +</Fragment> `; exports[`SourceFiltersTable should should a loading indicator when saving 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -230,11 +222,11 @@ exports[`SourceFiltersTable should should a loading indicator when saving 1`] = } saveFilter={[Function]} /> -</div> +</Fragment> `; exports[`SourceFiltersTable should show a delete modal 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -265,43 +257,16 @@ exports[`SourceFiltersTable should show a delete modal 1`] = ` } saveFilter={[Function]} /> - <eui-overlay-mask> - <eui-confirm-modal - buttonColor="danger" - cancelButtonText={ - <FormattedMessage - defaultMessage="Cancel" - id="kbn.management.editIndexPattern.source.deleteFilter.cancelButtonLabel" - values={Object {}} - /> - } - confirmButtonText={ - <FormattedMessage - defaultMessage="Delete" - id="kbn.management.editIndexPattern.source.deleteFilter.deleteButtonLabel" - values={Object {}} - /> - } - onCancel={[Function]} - onConfirm={[Function]} - title={ - <FormattedMessage - defaultMessage="Delete source filter '{value}'?" - id="kbn.management.editIndexPattern.source.deleteSourceFilterLabel" - values={ - Object { - "value": "tim*", - } - } - /> - } - /> - </eui-overlay-mask> -</div> + <DeleteFilterConfirmationModal + filterToDeleteValue="tim*" + onCancelConfirmationModal={[Function]} + onDeleteFilter={[Function]} + /> +</Fragment> `; exports[`SourceFiltersTable should update a filter 1`] = ` -<div> +<Fragment> <header /> <AddFilter onAddFilter={[Function]} @@ -344,5 +309,5 @@ exports[`SourceFiltersTable should update a filter 1`] = ` } saveFilter={[Function]} /> -</div> +</Fragment> `; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__jest__/__snapshots__/add_filter.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__snapshots__/add_filter.test.tsx.snap similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__jest__/__snapshots__/add_filter.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__snapshots__/add_filter.test.tsx.snap diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.js deleted file mode 100644 index 2124b76b3a915..0000000000000 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.js +++ /dev/null @@ -1,73 +0,0 @@ -/* - * 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. - */ - -import React, { Component } from 'react'; -import PropTypes from 'prop-types'; - -import { EuiFlexGroup, EuiFlexItem, EuiFieldText, EuiButton } from '@elastic/eui'; - -import { i18n } from '@kbn/i18n'; -import { FormattedMessage } from '@kbn/i18n/react'; - -export class AddFilter extends Component { - static propTypes = { - onAddFilter: PropTypes.func.isRequired, - }; - - constructor(props) { - super(props); - this.state = { - filter: '', - }; - } - - onAddFilter = () => { - this.props.onAddFilter(this.state.filter); - this.setState({ filter: '' }); - }; - - render() { - const { filter } = this.state; - const placeholder = i18n.translate('kbn.management.editIndexPattern.sourcePlaceholder', { - defaultMessage: - "source filter, accepts wildcards (e.g., `user*` to filter fields starting with 'user')", - }); - - return ( - <EuiFlexGroup> - <EuiFlexItem grow={10}> - <EuiFieldText - fullWidth - value={filter} - onChange={e => this.setState({ filter: e.target.value.trim() })} - placeholder={placeholder} - /> - </EuiFlexItem> - <EuiFlexItem> - <EuiButton isDisabled={filter.length === 0} onClick={this.onAddFilter}> - <FormattedMessage - id="kbn.management.editIndexPattern.source.addButtonLabel" - defaultMessage="Add" - /> - </EuiButton> - </EuiFlexItem> - </EuiFlexGroup> - ); - } -} diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__jest__/add_filter.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.test.tsx similarity index 66% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__jest__/add_filter.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.test.tsx index 915d9490db045..1ebaa3eaf89f8 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/__jest__/add_filter.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.test.tsx @@ -18,33 +18,30 @@ */ import React from 'react'; -import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; +import { shallow } from 'enzyme'; -import { AddFilter } from '../add_filter'; +import { AddFilter } from './add_filter'; describe('AddFilter', () => { - it('should render normally', async () => { - const component = shallowWithI18nProvider(<AddFilter onAddFilter={() => {}} />); + test('should render normally', () => { + const component = shallow(<AddFilter onAddFilter={() => {}} />); expect(component).toMatchSnapshot(); }); - it('should allow adding a filter', async () => { + test('should allow adding a filter', async () => { const onAddFilter = jest.fn(); - const component = shallowWithI18nProvider(<AddFilter onAddFilter={onAddFilter} />); + const component = shallow(<AddFilter onAddFilter={onAddFilter} />); - // Set a value in the input field - component.setState({ filter: 'tim*' }); - - // Click the button + component.find('EuiFieldText').simulate('change', { target: { value: 'tim*' } }); component.find('EuiButton').simulate('click'); component.update(); expect(onAddFilter).toBeCalledWith('tim*'); }); - it('should ignore strings with just spaces', async () => { - const component = shallowWithI18nProvider(<AddFilter onAddFilter={() => {}} />); + test('should ignore strings with just spaces', () => { + const component = shallow(<AddFilter onAddFilter={() => {}} />); // Set a value in the input field component.find('EuiFieldText').simulate('keypress', ' '); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.tsx b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.tsx new file mode 100644 index 0000000000000..d0f397637de33 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/add_filter.tsx @@ -0,0 +1,63 @@ +/* + * 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. + */ + +import React, { useState, useCallback } from 'react'; + +import { i18n } from '@kbn/i18n'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { EuiFlexGroup, EuiFlexItem, EuiFieldText, EuiButton } from '@elastic/eui'; + +interface AddFilterProps { + onAddFilter: (filter: string) => void; +} + +const sourcePlaceholder = i18n.translate('kbn.management.editIndexPattern.sourcePlaceholder', { + defaultMessage: + "source filter, accepts wildcards (e.g., `user*` to filter fields starting with 'user')", +}); + +export const AddFilter = ({ onAddFilter }: AddFilterProps) => { + const [filter, setFilter] = useState<string>(''); + + const onAddButtonClick = useCallback(() => { + onAddFilter(filter); + setFilter(''); + }, [filter, onAddFilter]); + + return ( + <EuiFlexGroup> + <EuiFlexItem grow={10}> + <EuiFieldText + fullWidth + value={filter} + onChange={e => setFilter(e.target.value.trim())} + placeholder={sourcePlaceholder} + /> + </EuiFlexItem> + <EuiFlexItem> + <EuiButton isDisabled={filter.length === 0} onClick={onAddButtonClick}> + <FormattedMessage + id="kbn.management.editIndexPattern.source.addButtonLabel" + defaultMessage="Add" + /> + </EuiButton> + </EuiFlexItem> + </EuiFlexGroup> + ); +}; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/add_filter/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap new file mode 100644 index 0000000000000..62376b498d887 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap @@ -0,0 +1,37 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`Header should render normally 1`] = ` +<EuiOverlayMask> + <EuiConfirmModal + buttonColor="danger" + cancelButtonText={ + <FormattedMessage + defaultMessage="Cancel" + id="kbn.management.editIndexPattern.source.deleteFilter.cancelButtonLabel" + values={Object {}} + /> + } + confirmButtonText={ + <FormattedMessage + defaultMessage="Delete" + id="kbn.management.editIndexPattern.source.deleteFilter.deleteButtonLabel" + values={Object {}} + /> + } + defaultFocusedButton="confirm" + onCancel={[Function]} + onConfirm={[Function]} + title={ + <FormattedMessage + defaultMessage="Delete source filter '{value}'?" + id="kbn.management.editIndexPattern.source.deleteSourceFilterLabel" + values={ + Object { + "value": "test", + } + } + /> + } + /> +</EuiOverlayMask> +`; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.test.tsx b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.test.tsx new file mode 100644 index 0000000000000..ac7237095e4b3 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.test.tsx @@ -0,0 +1,37 @@ +/* + * 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. + */ + +import React from 'react'; +import { shallow } from 'enzyme'; + +import { DeleteFilterConfirmationModal } from './confirmation_modal'; + +describe('Header', () => { + test('should render normally', () => { + const component = shallow( + <DeleteFilterConfirmationModal + filterToDeleteValue={'test'} + onCancelConfirmationModal={() => {}} + onDeleteFilter={() => {}} + /> + ); + + expect(component).toMatchSnapshot(); + }); +}); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.tsx b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.tsx new file mode 100644 index 0000000000000..dabfb6d8f275a --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/confirmation_modal.tsx @@ -0,0 +1,76 @@ +/* + * 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. + */ + +import React from 'react'; +import PropTypes from 'prop-types'; + +import { FormattedMessage } from '@kbn/i18n/react'; +import { EuiOverlayMask, EuiConfirmModal, EUI_MODAL_CONFIRM_BUTTON } from '@elastic/eui'; + +interface DeleteFilterConfirmationModalProps { + filterToDeleteValue: string; + onCancelConfirmationModal: ( + event?: React.KeyboardEvent<HTMLDivElement> | React.MouseEvent<HTMLButtonElement> + ) => void; + onDeleteFilter: (event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void; +} + +export const DeleteFilterConfirmationModal = ({ + filterToDeleteValue, + onCancelConfirmationModal, + onDeleteFilter, +}: DeleteFilterConfirmationModalProps) => { + return ( + <EuiOverlayMask> + <EuiConfirmModal + title={ + <FormattedMessage + id="kbn.management.editIndexPattern.source.deleteSourceFilterLabel" + defaultMessage="Delete source filter '{value}'?" + values={{ + value: filterToDeleteValue, + }} + /> + } + onCancel={onCancelConfirmationModal} + onConfirm={onDeleteFilter} + cancelButtonText={ + <FormattedMessage + id="kbn.management.editIndexPattern.source.deleteFilter.cancelButtonLabel" + defaultMessage="Cancel" + /> + } + buttonColor="danger" + confirmButtonText={ + <FormattedMessage + id="kbn.management.editIndexPattern.source.deleteFilter.deleteButtonLabel" + defaultMessage="Delete" + /> + } + defaultFocusedButton={EUI_MODAL_CONFIRM_BUTTON} + /> + </EuiOverlayMask> + ); +}; + +DeleteFilterConfirmationModal.propTypes = { + filterToDeleteValue: PropTypes.string.isRequired, + onCancelConfirmationModal: PropTypes.func.isRequired, + onDeleteFilter: PropTypes.func.isRequired, +}; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/index.ts b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/index.ts new file mode 100644 index 0000000000000..e48e38b7c3dcb --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/confirmation_modal/index.ts @@ -0,0 +1,20 @@ +/* + * 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. + */ + +export { DeleteFilterConfirmationModal } from './confirmation_modal'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__jest__/__snapshots__/header.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__snapshots__/header.test.tsx.snap similarity index 98% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__jest__/__snapshots__/header.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__snapshots__/header.test.tsx.snap index a5be141a18c89..cde0de79caacd 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__jest__/__snapshots__/header.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__snapshots__/header.test.tsx.snap @@ -1,7 +1,7 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP exports[`Header should render normally 1`] = ` -<div> +<Fragment> <EuiTitle size="s" > @@ -32,5 +32,5 @@ exports[`Header should render normally 1`] = ` <EuiSpacer size="s" /> -</div> +</Fragment> `; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__jest__/header.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.test.tsx similarity index 95% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__jest__/header.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.test.tsx index 058bf99fe26fa..869bdeb55cf02 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/__jest__/header.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.test.tsx @@ -23,7 +23,7 @@ import { shallow } from 'enzyme'; import { Header } from '../header'; describe('Header', () => { - it('should render normally', async () => { + test('should render normally', () => { const component = shallow(<Header />); expect(component).toMatchSnapshot(); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.tsx similarity index 99% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.tsx index 8822ca6236250..7b37f75043dd5 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/header.tsx @@ -20,11 +20,10 @@ import React from 'react'; import { EuiTitle, EuiText, EuiSpacer } from '@elastic/eui'; - import { FormattedMessage } from '@kbn/i18n/react'; export const Header = () => ( - <div> + <> <EuiTitle size="s"> <h3> <FormattedMessage @@ -52,5 +51,5 @@ export const Header = () => ( </p> </EuiText> <EuiSpacer size="s" /> - </div> + </> ); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/header/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/index.ts b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/index.ts new file mode 100644 index 0000000000000..87ac13ad15f50 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/index.ts @@ -0,0 +1,23 @@ +/* + * 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. + */ + +export { AddFilter } from './add_filter'; +export { DeleteFilterConfirmationModal } from './confirmation_modal'; +export { Header } from './header'; +export { Table } from './table'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__jest__/__snapshots__/table.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__snapshots__/table.test.tsx.snap similarity index 77% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__jest__/__snapshots__/table.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__snapshots__/table.test.tsx.snap index a0853b8628cc9..c70d0871bb854 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__jest__/__snapshots__/table.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__snapshots__/table.test.tsx.snap @@ -3,14 +3,15 @@ exports[`Table editing should show a save button 1`] = ` <div> <EuiButtonIcon - aria-label="Save" - iconType="checkInCircleFilled" + aria-label="Edit" + iconType="pencil" onClick={[Function]} size="s" /> <EuiButtonIcon - aria-label="Cancel" - iconType="cross" + aria-label="Delete" + color="danger" + iconType="trash" onClick={[Function]} size="s" /> @@ -18,27 +19,20 @@ exports[`Table editing should show a save button 1`] = ` `; exports[`Table editing should show an input field 1`] = ` -<EuiFormControlLayout - fullWidth={false} -> - <EuiValidatableControl> - <input - autoFocus={true} - className="euiFieldText" - onChange={[Function]} - onKeyDown={[Function]} - type="text" - value="tim*" - /> - </EuiValidatableControl> -</EuiFormControlLayout> +<span> + tim* +</span> `; exports[`Table editing should update the matches dynamically as input value is changed 1`] = ` <div> - <span> - time, value - </span> + <em> + <FormattedMessage + defaultMessage="The source filter doesn't match any known fields." + id="kbn.management.editIndexPattern.source.table.notMatchedLabel" + values={Object {}} + /> + </em> </div> `; @@ -79,6 +73,7 @@ exports[`Table should render normally 1`] = ` items={ Array [ Object { + "clientId": "", "value": "tim*", }, ] diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__jest__/table.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.test.tsx similarity index 69% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__jest__/table.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.test.tsx index 7fba1fcfe4876..4705ecd2d1685 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/__jest__/table.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.test.tsx @@ -17,25 +17,40 @@ * under the License. */ -import React from 'react'; -import { shallow } from 'enzyme'; -import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; - -import { Table } from '../table'; -import { keyCodes } from '@elastic/eui'; - -const indexPattern = {}; -const items = [{ value: 'tim*' }]; +import React, { ReactElement } from 'react'; +import { shallow, ShallowWrapper } from 'enzyme'; + +import { Table, TableProps, TableState } from './table'; +import { EuiTableFieldDataColumnType, keyCodes } from '@elastic/eui'; +import { IIndexPattern } from '../../../../../../../../../../../plugins/data/public'; +import { SourceFiltersTableFilter } from '../../types'; + +const indexPattern = {} as IIndexPattern; +const items: SourceFiltersTableFilter[] = [{ value: 'tim*', clientId: '' }]; + +const getIndexPatternMock = (mockedFields: any = {}) => ({ ...mockedFields } as IIndexPattern); + +const getTableColumnRender = ( + component: ShallowWrapper<TableProps, TableState, Table>, + index: number = 0 +) => { + const columns = component.prop<Array<EuiTableFieldDataColumnType<SourceFiltersTableFilter>>>( + 'columns' + ); + return { + render: columns[index].render as (...args: any) => ReactElement, + }; +}; describe('Table', () => { - it('should render normally', async () => { - const component = shallowWithI18nProvider( + test('should render normally', () => { + const component = shallow( <Table indexPattern={indexPattern} items={items} deleteFilter={() => {}} fieldWildcardMatcher={() => {}} - saveFilter={() => {}} + saveFilter={() => undefined} isSaving={true} /> ); @@ -43,31 +58,33 @@ describe('Table', () => { expect(component).toMatchSnapshot(); }); - it('should render filter matches', async () => { - const component = shallowWithI18nProvider( + test('should render filter matches', () => { + const component = shallow<Table>( <Table - indexPattern={{ + indexPattern={getIndexPatternMock({ getNonScriptedFields: () => [{ name: 'time' }, { name: 'value' }], - }} + })} items={items} deleteFilter={() => {}} - fieldWildcardMatcher={filter => field => field.includes(filter[0])} - saveFilter={() => {}} + fieldWildcardMatcher={(filter: string) => (field: string) => field.includes(filter[0])} + saveFilter={() => undefined} isSaving={false} /> ); - const matchesTableCell = shallow(component.prop('columns')[1].render('tim', { clientId: 1 })); + const matchesTableCell = shallow( + getTableColumnRender(component, 1).render('tim', { clientId: 1 }) + ); expect(matchesTableCell).toMatchSnapshot(); }); describe('editing', () => { const saveFilter = jest.fn(); - const clientId = 1; - let component; + const clientId = '1'; + let component: ShallowWrapper<TableProps, TableState, Table>; beforeEach(() => { - component = shallowWithI18nProvider( + component = shallow<Table>( <Table indexPattern={indexPattern} items={items} @@ -79,11 +96,12 @@ describe('Table', () => { ); }); - it('should show an input field', () => { + test('should show an input field', () => { // Start the editing process + const editingComponent = shallow( // Wrap in a div because: https://github.com/airbnb/enzyme/issues/1213 - <div>{component.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> + <div>{getTableColumnRender(component, 2).render({ clientId, value: 'tim*' })}</div> ); editingComponent .find('EuiButtonIcon') @@ -92,19 +110,19 @@ describe('Table', () => { // Ensure the state change propagates component.update(); - // Ensure the table cell switches to an input - const filterNameTableCell = shallow( - component.prop('columns')[0].render('tim*', { clientId }) - ); + const cell = getTableColumnRender(component).render('tim*', { clientId }); + const filterNameTableCell = shallow(cell); + expect(filterNameTableCell).toMatchSnapshot(); }); - it('should show a save button', () => { + test('should show a save button', () => { // Start the editing process const editingComponent = shallow( // Fixes: Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> + <div>{getTableColumnRender(component, 2).render({ clientId, value: 'tim*' })}</div> ); + editingComponent .find('EuiButtonIcon') .at(1) @@ -116,22 +134,20 @@ describe('Table', () => { // Verify save button const saveTableCell = shallow( // Fixes Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> + <div>{getTableColumnRender(component, 2).render({ clientId, value: 'tim*' })}</div> ); expect(saveTableCell).toMatchSnapshot(); }); - it('should update the matches dynamically as input value is changed', () => { - const localComponent = shallowWithI18nProvider( + test('should update the matches dynamically as input value is changed', () => { + const localComponent = shallow( <Table - indexPattern={{ + indexPattern={getIndexPatternMock({ getNonScriptedFields: () => [{ name: 'time' }, { name: 'value' }], - }} + })} items={items} deleteFilter={() => {}} - fieldWildcardMatcher={query => () => { - return query.includes('time*'); - }} + fieldWildcardMatcher={(query: string) => () => query.includes('time*')} saveFilter={saveFilter} isSaving={false} /> @@ -142,6 +158,7 @@ describe('Table', () => { // Fixes: Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. <div>{localComponent.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> ); + editingComponent .find('EuiButtonIcon') .at(1) @@ -161,7 +178,7 @@ describe('Table', () => { expect(matchesTableCell).toMatchSnapshot(); }); - it('should exit on save', () => { + test('should exit on save', () => { // Change the value to something else component.setState({ editingFilterId: clientId, @@ -171,34 +188,37 @@ describe('Table', () => { // Click the save button const editingComponent = shallow( // Fixes Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> + <div>{getTableColumnRender(component, 2).render({ clientId, value: 'tim*' })}</div> ); + editingComponent .find('EuiButtonIcon') .at(0) .simulate('click'); + editingComponent.update(); + // Ensure we call saveFilter properly expect(saveFilter).toBeCalledWith({ - filterId: clientId, - newFilterValue: 'ti*', + clientId, + value: 'ti*', }); // Ensure the state is properly reset - expect(component.state('editingFilterId')).toBe(null); + expect(component.state('editingFilterId')).toBe(''); }); }); - it('should allow deletes', () => { + test('should allow deletes', () => { const deleteFilter = jest.fn(); - const component = shallowWithI18nProvider( + const component = shallow( <Table indexPattern={indexPattern} items={items} deleteFilter={deleteFilter} fieldWildcardMatcher={() => {}} - saveFilter={() => {}} + saveFilter={() => undefined} isSaving={false} /> ); @@ -210,16 +230,15 @@ describe('Table', () => { ); deleteCellComponent .find('EuiButtonIcon') - .at(0) + .at(1) .simulate('click'); expect(deleteFilter).toBeCalled(); }); - it('should save when in edit mode and the enter key is pressed', () => { + test('should save when in edit mode and the enter key is pressed', () => { const saveFilter = jest.fn(); - const clientId = 1; - const component = shallowWithI18nProvider( + const component = shallow( <Table indexPattern={indexPattern} items={items} @@ -233,19 +252,19 @@ describe('Table', () => { // Start the editing process const editingComponent = shallow( // Fixes Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> + <div>{component.prop('columns')[2].render({ clientId: 1, value: 'tim*' })}</div> ); editingComponent .find('EuiButtonIcon') - .at(1) + .at(0) .simulate('click'); - // Ensure the state change propagates + component.update(); // Get the rendered input cell const filterNameTableCell = shallow( // Fixes Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[0].render('tim*', { clientId })}</div> + <div>{component.prop('columns')[0].render('tim*', { clientId: 1 })}</div> ); // Press the enter key @@ -253,14 +272,13 @@ describe('Table', () => { expect(saveFilter).toBeCalled(); // It should reset - expect(component.state('editingFilterId')).toBe(null); + expect(component.state('editingFilterId')).toBe(''); }); - it('should cancel when in edit mode and the esc key is pressed', () => { + test('should cancel when in edit mode and the esc key is pressed', () => { const saveFilter = jest.fn(); - const clientId = 1; - const component = shallowWithI18nProvider( + const component = shallow( <Table indexPattern={indexPattern} items={items} @@ -274,26 +292,28 @@ describe('Table', () => { // Start the editing process const editingComponent = shallow( // Fixes Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[2].render({ clientId, value: 'tim*' })}</div> + <div>{component.prop('columns')[2].render({ clientId: 1, value: 'tim*' })}</div> ); + editingComponent .find('EuiButtonIcon') - .at(1) + .at(0) .simulate('click'); + // Ensure the state change propagates component.update(); // Get the rendered input cell const filterNameTableCell = shallow( // Fixes Invariant Violation: ReactShallowRenderer render(): Shallow rendering works only with custom components, but the provided element type was `symbol`. - <div>{component.prop('columns')[0].render('tim*', { clientId })}</div> + <div>{component.prop('columns')[0].render('tim*', { clientId: 1 })}</div> ); - // Press the enter key + // Press the ESCAPE key filterNameTableCell.find('EuiFieldText').simulate('keydown', { keyCode: keyCodes.ESCAPE }); expect(saveFilter).not.toBeCalled(); // It should reset - expect(component.state('editingFilterId')).toBe(null); + expect(component.state('editingFilterId')).toBe(''); }); }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.tsx similarity index 54% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.tsx index f16663e1cd41a..db2b74bbc9824 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/components/table/table.tsx @@ -17,48 +17,94 @@ * under the License. */ -import React, { Component, Fragment } from 'react'; -import PropTypes from 'prop-types'; +import React, { Component } from 'react'; import { + keyCodes, + EuiBasicTableColumn, EuiInMemoryTable, EuiFieldText, EuiButtonIcon, - keyCodes, RIGHT_ALIGNMENT, } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; +import { SourceFiltersTableFilter } from '../../types'; -export class Table extends Component { - static propTypes = { - indexPattern: PropTypes.object.isRequired, - items: PropTypes.array.isRequired, - deleteFilter: PropTypes.func.isRequired, - fieldWildcardMatcher: PropTypes.func.isRequired, - saveFilter: PropTypes.func.isRequired, - isSaving: PropTypes.bool.isRequired, - }; +import { IIndexPattern } from '../../../../../../../../../../../plugins/data/public'; + +const filterHeader = i18n.translate('kbn.management.editIndexPattern.source.table.filterHeader', { + defaultMessage: 'Filter', +}); + +const filterDescription = i18n.translate( + 'kbn.management.editIndexPattern.source.table.filterDescription', + { defaultMessage: 'Filter name' } +); + +const matchesHeader = i18n.translate('kbn.management.editIndexPattern.source.table.matchesHeader', { + defaultMessage: 'Matches', +}); + +const matchesDescription = i18n.translate( + 'kbn.management.editIndexPattern.source.table.matchesDescription', + { defaultMessage: 'Language used for the field' } +); + +const editAria = i18n.translate('kbn.management.editIndexPattern.source.table.editAria', { + defaultMessage: 'Edit', +}); + +const saveAria = i18n.translate('kbn.management.editIndexPattern.source.table.saveAria', { + defaultMessage: 'Save', +}); + +const deleteAria = i18n.translate('kbn.management.editIndexPattern.source.table.deleteAria', { + defaultMessage: 'Delete', +}); + +const cancelAria = i18n.translate('kbn.management.editIndexPattern.source.table.cancelAria', { + defaultMessage: 'Cancel', +}); + +export interface TableProps { + indexPattern: IIndexPattern; + items: SourceFiltersTableFilter[]; + deleteFilter: Function; + fieldWildcardMatcher: Function; + saveFilter: (filter: SourceFiltersTableFilter) => any; + isSaving: boolean; +} + +export interface TableState { + editingFilterId: string | number; + editingFilterValue: string; +} - constructor(props) { +export class Table extends Component<TableProps, TableState> { + constructor(props: TableProps) { super(props); this.state = { - editingFilterId: null, - editingFilterValue: null, + editingFilterId: '', + editingFilterValue: '', }; } - startEditingFilter = (id, value) => - this.setState({ editingFilterId: id, editingFilterValue: value }); - stopEditingFilter = () => this.setState({ editingFilterId: null }); - onEditingFilterChange = e => this.setState({ editingFilterValue: e.target.value }); + startEditingFilter = ( + editingFilterId: TableState['editingFilterId'], + editingFilterValue: TableState['editingFilterValue'] + ) => this.setState({ editingFilterId, editingFilterValue }); + + stopEditingFilter = () => this.setState({ editingFilterId: '' }); + onEditingFilterChange = (e: React.ChangeEvent<HTMLInputElement>) => + this.setState({ editingFilterValue: e.target.value }); - onEditFieldKeyDown = ({ keyCode }) => { - if (keyCodes.ENTER === keyCode) { + onEditFieldKeyDown = ({ keyCode }: React.KeyboardEvent<HTMLInputElement>) => { + if (keyCodes.ENTER === keyCode && this.state.editingFilterId && this.state.editingFilterValue) { this.props.saveFilter({ - filterId: this.state.editingFilterId, - newFilterValue: this.state.editingFilterValue, + clientId: this.state.editingFilterId, + value: this.state.editingFilterValue, }); this.stopEditingFilter(); } @@ -67,23 +113,18 @@ export class Table extends Component { } }; - getColumns() { + getColumns(): Array<EuiBasicTableColumn<SourceFiltersTableFilter>> { const { deleteFilter, fieldWildcardMatcher, indexPattern, saveFilter } = this.props; return [ { field: 'value', - name: i18n.translate('kbn.management.editIndexPattern.source.table.filterHeader', { - defaultMessage: 'Filter', - }), - description: i18n.translate( - 'kbn.management.editIndexPattern.source.table.filterDescription', - { defaultMessage: 'Filter name' } - ), + name: filterHeader, + description: filterDescription, dataType: 'string', sortable: true, render: (value, filter) => { - if (this.state.editingFilterId === filter.clientId) { + if (this.state.editingFilterId && this.state.editingFilterId === filter.clientId) { return ( <EuiFieldText autoFocus @@ -99,24 +140,20 @@ export class Table extends Component { }, { field: 'value', - name: i18n.translate('kbn.management.editIndexPattern.source.table.matchesHeader', { - defaultMessage: 'Matches', - }), - description: i18n.translate( - 'kbn.management.editIndexPattern.source.table.matchesDescription', - { defaultMessage: 'Language used for the field' } - ), + name: matchesHeader, + description: matchesDescription, dataType: 'string', sortable: true, render: (value, filter) => { - const realtimeValue = - this.state.editingFilterId === filter.clientId ? this.state.editingFilterValue : value; - const matcher = fieldWildcardMatcher([realtimeValue]); + const wildcardMatcher = fieldWildcardMatcher([ + this.state.editingFilterId === filter.clientId ? this.state.editingFilterValue : value, + ]); const matches = indexPattern .getNonScriptedFields() - .map(f => f.name) - .filter(matcher) + .map((currentFilter: any) => currentFilter.name) + .filter(wildcardMatcher) .sort(); + if (matches.length) { return <span>{matches.join(', ')}</span>; } @@ -135,24 +172,21 @@ export class Table extends Component { name: '', align: RIGHT_ALIGNMENT, width: '100', - render: filter => { + render: (filter: SourceFiltersTableFilter) => { if (this.state.editingFilterId === filter.clientId) { return ( - <Fragment> + <> <EuiButtonIcon size="s" onClick={() => { saveFilter({ - filterId: this.state.editingFilterId, - newFilterValue: this.state.editingFilterValue, + clientId: this.state.editingFilterId, + value: this.state.editingFilterValue, }); this.stopEditingFilter(); }} iconType="checkInCircleFilled" - aria-label={i18n.translate( - 'kbn.management.editIndexPattern.source.table.saveAria', - { defaultMessage: 'Save' } - )} + aria-label={saveAria} /> <EuiButtonIcon size="s" @@ -160,37 +194,28 @@ export class Table extends Component { this.stopEditingFilter(); }} iconType="cross" - aria-label={i18n.translate( - 'kbn.management.editIndexPattern.source.table.cancelAria', - { defaultMessage: 'Cancel' } - )} + aria-label={cancelAria} /> - </Fragment> + </> ); } return ( - <Fragment> + <> <EuiButtonIcon size="s" - color="danger" - onClick={() => deleteFilter(filter)} - iconType="trash" - aria-label={i18n.translate( - 'kbn.management.editIndexPattern.source.table.deleteAria', - { defaultMessage: 'Delete' } - )} + onClick={() => this.startEditingFilter(filter.clientId, filter.value)} + iconType="pencil" + aria-label={editAria} /> <EuiButtonIcon size="s" - onClick={() => this.startEditingFilter(filter.clientId, filter.value)} - iconType="pencil" - aria-label={i18n.translate( - 'kbn.management.editIndexPattern.source.table.editAria', - { defaultMessage: 'Edit' } - )} + color="danger" + onClick={() => deleteFilter(filter)} + iconType="trash" + aria-label={deleteAria} /> - </Fragment> + </> ); }, }, diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__jest__/source_filters_table.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.test.tsx similarity index 64% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__jest__/source_filters_table.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.test.tsx index a39958a77abbf..1b68dd13566d3 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/__jest__/source_filters_table.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.test.tsx @@ -20,13 +20,13 @@ import React from 'react'; import { shallow } from 'enzyme'; -import { SourceFiltersTable } from '../source_filters_table'; +import { SourceFiltersTable } from './source_filters_table'; +import { IIndexPattern } from '../../../../../../../../../plugins/data/public'; jest.mock('@elastic/eui', () => ({ EuiButton: 'eui-button', EuiTitle: 'eui-title', EuiText: 'eui-text', - EuiButton: 'eui-button', EuiHorizontalRule: 'eui-horizontal-rule', EuiSpacer: 'eui-spacer', EuiCallOut: 'eui-call-out', @@ -39,42 +39,54 @@ jest.mock('@elastic/eui', () => ({ default: () => {}, }, })); -jest.mock('../components/header', () => ({ Header: 'header' })); -jest.mock('../components/table', () => ({ + +jest.mock('./components/header', () => ({ Header: 'header' })); +jest.mock('./components/table', () => ({ // Note: this seems to fix React complaining about non lowercase attributes Table: () => { return 'table'; }, })); -const indexPattern = { - sourceFilters: [{ value: 'time*' }, { value: 'nam*' }, { value: 'age*' }], -}; +const getIndexPatternMock = (mockedFields: any = {}) => + ({ + sourceFilters: [{ value: 'time*' }, { value: 'nam*' }, { value: 'age*' }], + ...mockedFields, + } as IIndexPattern); describe('SourceFiltersTable', () => { - it('should render normally', async () => { + test('should render normally', () => { const component = shallow( - <SourceFiltersTable indexPattern={indexPattern} fieldWildcardMatcher={() => {}} /> + <SourceFiltersTable + indexPattern={getIndexPatternMock()} + fieldWildcardMatcher={() => {}} + filterFilter={''} + /> ); expect(component).toMatchSnapshot(); }); - it('should filter based on the query bar', async () => { + test('should filter based on the query bar', () => { const component = shallow( - <SourceFiltersTable indexPattern={indexPattern} fieldWildcardMatcher={() => {}} /> + <SourceFiltersTable + indexPattern={getIndexPatternMock()} + fieldWildcardMatcher={() => {}} + filterFilter={''} + /> ); component.setProps({ filterFilter: 'ti' }); expect(component).toMatchSnapshot(); }); - it('should should a loading indicator when saving', async () => { + test('should should a loading indicator when saving', () => { const component = shallow( <SourceFiltersTable - indexPattern={{ + indexPattern={getIndexPatternMock({ sourceFilters: [{ value: 'tim*' }], - }} + })} + filterFilter={''} fieldWildcardMatcher={() => {}} /> ); @@ -83,34 +95,36 @@ describe('SourceFiltersTable', () => { expect(component).toMatchSnapshot(); }); - it('should show a delete modal', async () => { - const component = shallow( + test('should show a delete modal', () => { + const component = shallow<SourceFiltersTable>( <SourceFiltersTable - indexPattern={{ + indexPattern={getIndexPatternMock({ sourceFilters: [{ value: 'tim*' }], - }} + })} + filterFilter={''} fieldWildcardMatcher={() => {}} /> ); - component.instance().startDeleteFilter({ value: 'tim*' }); + component.instance().startDeleteFilter({ value: 'tim*', clientId: 1 }); component.update(); // We are not calling `.setState` directly so we need to re-render expect(component).toMatchSnapshot(); }); - it('should remove a filter', async () => { + test('should remove a filter', async () => { const save = jest.fn(); - const component = shallow( + const component = shallow<SourceFiltersTable>( <SourceFiltersTable - indexPattern={{ + indexPattern={getIndexPatternMock({ save, sourceFilters: [{ value: 'tim*' }, { value: 'na*' }], - }} + })} + filterFilter={''} fieldWildcardMatcher={() => {}} /> ); - component.instance().startDeleteFilter({ value: 'tim*' }); + component.instance().startDeleteFilter({ value: 'tim*', clientId: 1 }); component.update(); // We are not calling `.setState` directly so we need to re-render await component.instance().deleteFilter(); component.update(); // We are not calling `.setState` directly so we need to re-render @@ -119,14 +133,15 @@ describe('SourceFiltersTable', () => { expect(component).toMatchSnapshot(); }); - it('should add a filter', async () => { + test('should add a filter', async () => { const save = jest.fn(); - const component = shallow( + const component = shallow<SourceFiltersTable>( <SourceFiltersTable - indexPattern={{ + indexPattern={getIndexPatternMock({ save, sourceFilters: [{ value: 'tim*' }], - }} + })} + filterFilter={''} fieldWildcardMatcher={() => {}} /> ); @@ -138,19 +153,20 @@ describe('SourceFiltersTable', () => { expect(component).toMatchSnapshot(); }); - it('should update a filter', async () => { + test('should update a filter', async () => { const save = jest.fn(); - const component = shallow( + const component = shallow<SourceFiltersTable>( <SourceFiltersTable - indexPattern={{ + indexPattern={getIndexPatternMock({ save, sourceFilters: [{ value: 'tim*' }], - }} + })} + filterFilter={''} fieldWildcardMatcher={() => {}} /> ); - await component.instance().saveFilter({ oldFilterValue: 'tim*', newFilterValue: 'ti*' }); + await component.instance().saveFilter({ clientId: 'tim*', value: 'ti*' }); component.update(); // We are not calling `.setState` directly so we need to re-render expect(save).toBeCalled(); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.tsx similarity index 56% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.tsx index 3b485573f3821..dcf8ae9e1323f 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/source_filters_table.tsx @@ -18,33 +18,40 @@ */ import React, { Component } from 'react'; -import PropTypes from 'prop-types'; import { createSelector } from 'reselect'; -import { EuiSpacer, EuiOverlayMask, EuiConfirmModal, EUI_MODAL_CONFIRM_BUTTON } from '@elastic/eui'; +import { EuiSpacer } from '@elastic/eui'; +import { AddFilter, Table, Header, DeleteFilterConfirmationModal } from './components'; +import { IIndexPattern } from '../../../../../../../../../plugins/data/public'; +import { SourceFiltersTableFilter } from './types'; -import { Table } from './components/table'; -import { Header } from './components/header'; -import { AddFilter } from './components/add_filter'; -import { FormattedMessage } from '@kbn/i18n/react'; +export interface SourceFiltersTableProps { + indexPattern: IIndexPattern; + filterFilter: string; + fieldWildcardMatcher: Function; + onAddOrRemoveFilter?: Function; +} -export class SourceFiltersTable extends Component { - static propTypes = { - indexPattern: PropTypes.object.isRequired, - filterFilter: PropTypes.string, - fieldWildcardMatcher: PropTypes.func.isRequired, - onAddOrRemoveFilter: PropTypes.func, - }; +export interface SourceFiltersTableState { + filterToDelete: any; + isDeleteConfirmationModalVisible: boolean; + isSaving: boolean; + filters: SourceFiltersTableFilter[]; +} - constructor(props) { +export class SourceFiltersTable extends Component< + SourceFiltersTableProps, + SourceFiltersTableState +> { + // Source filters do not have any unique ids, only the value is stored. + // To ensure we can create a consistent and expected UX when managing + // source filters, we are assigning a unique id to each filter on the + // client side only + private clientSideId: number = 0; + + constructor(props: SourceFiltersTableProps) { super(props); - // Source filters do not have any unique ids, only the value is stored. - // To ensure we can create a consistent and expected UX when managing - // source filters, we are assigning a unique id to each filter on the - // client side only - this.clientSideId = 0; - this.state = { filterToDelete: undefined, isDeleteConfirmationModalVisible: false, @@ -58,9 +65,9 @@ export class SourceFiltersTable extends Component { } updateFilters = () => { - const sourceFilters = this.props.indexPattern.sourceFilters || []; - const filters = sourceFilters.map(filter => ({ - ...filter, + const sourceFilters = this.props.indexPattern.sourceFilters; + const filters = (sourceFilters || []).map((sourceFilter: any) => ({ + ...sourceFilter, clientId: ++this.clientSideId, })); @@ -68,8 +75,8 @@ export class SourceFiltersTable extends Component { }; getFilteredFilters = createSelector( - state => state.filters, - (state, props) => props.filterFilter, + (state: SourceFiltersTableState) => state.filters, + (state: SourceFiltersTableState, props: SourceFiltersTableProps) => props.filterFilter, (filters, filterFilter) => { if (filterFilter) { const filterFilterToLowercase = filterFilter.toLowerCase(); @@ -82,7 +89,7 @@ export class SourceFiltersTable extends Component { } ); - startDeleteFilter = filter => { + startDeleteFilter = (filter: SourceFiltersTableFilter) => { this.setState({ filterToDelete: filter, isDeleteConfirmationModalVisible: true, @@ -106,35 +113,44 @@ export class SourceFiltersTable extends Component { this.setState({ isSaving: true }); await indexPattern.save(); - onAddOrRemoveFilter && onAddOrRemoveFilter(); + + if (onAddOrRemoveFilter) { + onAddOrRemoveFilter(); + } + this.updateFilters(); this.setState({ isSaving: false }); this.hideDeleteConfirmationModal(); }; - onAddFilter = async value => { + onAddFilter = async (value: string) => { const { indexPattern, onAddOrRemoveFilter } = this.props; indexPattern.sourceFilters = [...(indexPattern.sourceFilters || []), { value }]; this.setState({ isSaving: true }); await indexPattern.save(); - onAddOrRemoveFilter && onAddOrRemoveFilter(); + + if (onAddOrRemoveFilter) { + onAddOrRemoveFilter(); + } + this.updateFilters(); this.setState({ isSaving: false }); }; - saveFilter = async ({ filterId, newFilterValue }) => { + saveFilter = async ({ clientId, value }: SourceFiltersTableFilter) => { const { indexPattern } = this.props; const { filters } = this.state; indexPattern.sourceFilters = filters.map(filter => { - if (filter.clientId === filterId) { + if (filter.clientId === clientId) { return { - value: newFilterValue, - clientId: filter.clientId, + value, + clientId, }; } + return filter; }); @@ -144,55 +160,13 @@ export class SourceFiltersTable extends Component { this.setState({ isSaving: false }); }; - renderDeleteConfirmationModal() { - const { filterToDelete } = this.state; - - if (!filterToDelete) { - return null; - } - - return ( - <EuiOverlayMask> - <EuiConfirmModal - title={ - <FormattedMessage - id="kbn.management.editIndexPattern.source.deleteSourceFilterLabel" - defaultMessage="Delete source filter '{value}'?" - values={{ - value: filterToDelete.value, - }} - /> - } - onCancel={this.hideDeleteConfirmationModal} - onConfirm={this.deleteFilter} - cancelButtonText={ - <FormattedMessage - id="kbn.management.editIndexPattern.source.deleteFilter.cancelButtonLabel" - defaultMessage="Cancel" - /> - } - buttonColor="danger" - confirmButtonText={ - <FormattedMessage - id="kbn.management.editIndexPattern.source.deleteFilter.deleteButtonLabel" - defaultMessage="Delete" - /> - } - defaultFocusedButton={EUI_MODAL_CONFIRM_BUTTON} - /> - </EuiOverlayMask> - ); - } - render() { const { indexPattern, fieldWildcardMatcher } = this.props; - - const { isSaving } = this.state; - + const { isSaving, filterToDelete } = this.state; const filteredFilters = this.getFilteredFilters(this.state, this.props); return ( - <div> + <> <Header /> <AddFilter onAddFilter={this.onAddFilter} /> <EuiSpacer size="l" /> @@ -205,8 +179,14 @@ export class SourceFiltersTable extends Component { saveFilter={this.saveFilter} /> - {this.renderDeleteConfirmationModal()} - </div> + {filterToDelete && ( + <DeleteFilterConfirmationModal + filterToDeleteValue={filterToDelete.value} + onCancelConfirmationModal={this.hideDeleteConfirmationModal} + onDeleteFilter={this.deleteFilter} + /> + )} + </> ); } } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/types.ts b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/types.ts new file mode 100644 index 0000000000000..ee3689f017471 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/source_filters_table/types.ts @@ -0,0 +1,24 @@ +/* + * 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. + */ + +/** @internal **/ +export interface SourceFiltersTableFilter { + value: string; + clientId: string | number; +} From 7ea3f12e31f198d6e79907f26518bbab612266b9 Mon Sep 17 00:00:00 2001 From: Alexey Antonov <alexwizp@gmail.com> Date: Mon, 13 Apr 2020 19:02:22 +0300 Subject: [PATCH 059/102] Index pattern management UI -> TypeScript (scripted_fields_table) (#63247) * Index pattern management UI -> TypeScript (scripted_fields_table) --- .../scripted_field_table.test.tsx.snap} | 40 +++--- .../call_outs.test.tsx.snap} | 4 +- .../call_outs.test.js => call_outs.test.tsx} | 4 +- .../call_outs/{call_outs.js => call_outs.tsx} | 12 +- .../call_outs/{index.js => index.ts} | 0 .../confirmation_modal.test.tsx.snap | 14 ++ .../confirmation_modal.test.tsx | 37 ++++++ .../confirmation_modal/confirmation_modal.tsx | 63 +++++++++ .../components/confirmation_modal/index.ts | 20 +++ .../header.test.tsx.snap} | 0 .../header.test.js => header.test.tsx} | 4 +- .../header/{header.js => header.tsx} | 12 +- .../components/header/{index.js => index.ts} | 0 .../components/{index.js => index.ts} | 1 + .../table.test.tsx.snap} | 7 +- .../components/table/{index.js => index.ts} | 0 .../table.test.js => table.test.tsx} | 49 +++---- .../components/table/{table.js => table.tsx} | 35 +++-- .../{index.js => index.ts} | 0 ....test.js => scripted_field_table.test.tsx} | 67 ++++++---- ...lds_table.js => scripted_fields_table.tsx} | 122 ++++++++---------- .../scripted_fields_table/types.ts | 25 ++++ .../{index.js => index.ts} | 12 +- 23 files changed, 346 insertions(+), 182 deletions(-) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/{__jest__/__snapshots__/scripted_field_table.test.js.snap => __snapshots__/scripted_field_table.test.tsx.snap} (89%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/{__jest__/__snapshots__/call_outs.test.js.snap => __snapshots__/call_outs.test.tsx.snap} (98%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/{__jest__/call_outs.test.js => call_outs.test.tsx} (92%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/{call_outs.js => call_outs.tsx} (94%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/{index.js => index.ts} (100%) create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.test.tsx create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.tsx create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/index.ts rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/{__jest__/__snapshots__/header.test.js.snap => __snapshots__/header.test.tsx.snap} (100%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/{__jest__/header.test.js => header.test.tsx} (92%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/{header.js => header.tsx} (92%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/{index.js => index.ts} (100%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/{index.js => index.ts} (92%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/{__jest__/__snapshots__/table.test.js.snap => __snapshots__/table.test.tsx.snap} (93%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/{index.js => index.ts} (100%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/{__jest__/table.test.js => table.test.tsx} (71%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/{table.js => table.tsx} (84%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/{index.js => index.ts} (100%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/{__jest__/scripted_field_table.test.js => scripted_field_table.test.tsx} (75%) rename src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/{scripted_fields_table.js => scripted_fields_table.tsx} (60%) create mode 100644 src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/types.ts rename src/legacy/ui/public/scripting_languages/{index.js => index.ts} (83%) diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__jest__/__snapshots__/scripted_field_table.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__snapshots__/scripted_field_table.test.tsx.snap similarity index 89% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__jest__/__snapshots__/scripted_field_table.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__snapshots__/scripted_field_table.test.tsx.snap index a53f4d7f609cb..569b75c848c52 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__jest__/__snapshots__/scripted_field_table.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__snapshots__/scripted_field_table.test.tsx.snap @@ -1,7 +1,7 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP exports[`ScriptedFieldsTable should filter based on the lang filter 1`] = ` -<div> +<Fragment> <header addScriptedFieldUrl="#" /> @@ -39,11 +39,11 @@ exports[`ScriptedFieldsTable should filter based on the lang filter 1`] = ` ] } /> -</div> +</Fragment> `; exports[`ScriptedFieldsTable should filter based on the query bar 1`] = ` -<div> +<Fragment> <header addScriptedFieldUrl="#" /> @@ -72,11 +72,11 @@ exports[`ScriptedFieldsTable should filter based on the query bar 1`] = ` ] } /> -</div> +</Fragment> `; exports[`ScriptedFieldsTable should hide the table if there are no scripted fields 1`] = ` -<div> +<Fragment> <header addScriptedFieldUrl="#" /> @@ -97,11 +97,11 @@ exports[`ScriptedFieldsTable should hide the table if there are no scripted fiel } items={Array []} /> -</div> +</Fragment> `; exports[`ScriptedFieldsTable should render normally 1`] = ` -<div> +<Fragment> <header addScriptedFieldUrl="#" /> @@ -135,11 +135,11 @@ exports[`ScriptedFieldsTable should render normally 1`] = ` ] } /> -</div> +</Fragment> `; exports[`ScriptedFieldsTable should show a delete modal 1`] = ` -<div> +<Fragment> <header addScriptedFieldUrl="#" /> @@ -173,14 +173,16 @@ exports[`ScriptedFieldsTable should show a delete modal 1`] = ` ] } /> - <eui-overlay-mask> - <eui-confirm-modal - cancelButtonText="Cancel" - confirmButtonText="Delete" - onCancel={[Function]} - onConfirm={[Function]} - title="Delete scripted field 'ScriptedField'?" - /> - </eui-overlay-mask> -</div> + <DeleteScritpedFieldConfirmationModal + deleteField={[Function]} + field={ + Object { + "lang": "", + "name": "ScriptedField", + "script": "", + } + } + hideDeleteConfirmationModal={[Function]} + /> +</Fragment> `; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__jest__/__snapshots__/call_outs.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__snapshots__/call_outs.test.tsx.snap similarity index 98% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__jest__/__snapshots__/call_outs.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__snapshots__/call_outs.test.tsx.snap index e6f0d6cd819e3..4dfda1b9339b1 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__jest__/__snapshots__/call_outs.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__snapshots__/call_outs.test.tsx.snap @@ -1,7 +1,7 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP exports[`CallOuts should render normally 1`] = ` -<div> +<Fragment> <EuiCallOut color="danger" iconType="cross" @@ -37,7 +37,7 @@ exports[`CallOuts should render normally 1`] = ` <EuiSpacer size="m" /> -</div> +</Fragment> `; exports[`CallOuts should render without any call outs 1`] = `""`; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__jest__/call_outs.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.test.tsx similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__jest__/call_outs.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.test.tsx index 12e0ee8839967..407928931191d 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/__jest__/call_outs.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.test.tsx @@ -23,7 +23,7 @@ import { shallow } from 'enzyme'; import { CallOuts } from '../call_outs'; describe('CallOuts', () => { - it('should render normally', async () => { + test('should render normally', () => { const component = shallow( <CallOuts deprecatedLangsInUse={['php']} @@ -34,7 +34,7 @@ describe('CallOuts', () => { expect(component).toMatchSnapshot(); }); - it('should render without any call outs', async () => { + test('should render without any call outs', () => { const component = shallow( <CallOuts deprecatedLangsInUse={[]} painlessDocLink="http://www.elastic.co/painlessDocs" /> ); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.tsx similarity index 94% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.tsx index 0c321c8ba8b01..8e38b569a32fa 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/call_outs.tsx @@ -20,16 +20,20 @@ import React from 'react'; import { EuiCallOut, EuiLink, EuiSpacer } from '@elastic/eui'; - import { FormattedMessage } from '@kbn/i18n/react'; -export const CallOuts = ({ deprecatedLangsInUse, painlessDocLink }) => { +interface CallOutsProps { + deprecatedLangsInUse: string[]; + painlessDocLink: string; +} + +export const CallOuts = ({ deprecatedLangsInUse, painlessDocLink }: CallOutsProps) => { if (!deprecatedLangsInUse.length) { return null; } return ( - <div> + <> <EuiCallOut title={ <FormattedMessage @@ -60,6 +64,6 @@ export const CallOuts = ({ deprecatedLangsInUse, painlessDocLink }) => { </p> </EuiCallOut> <EuiSpacer size="m" /> - </div> + </> ); }; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/call_outs/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap new file mode 100644 index 0000000000000..2b320782cb163 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/__snapshots__/confirmation_modal.test.tsx.snap @@ -0,0 +1,14 @@ +// Jest Snapshot v1, https://goo.gl/fbAQLP + +exports[`DeleteScritpedFieldConfirmationModal should render normally 1`] = ` +<EuiOverlayMask> + <EuiConfirmModal + cancelButtonText="Cancel" + confirmButtonText="Delete" + defaultFocusedButton="confirm" + onCancel={[Function]} + onConfirm={[Function]} + title="Delete scripted field ''?" + /> +</EuiOverlayMask> +`; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.test.tsx b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.test.tsx new file mode 100644 index 0000000000000..f3594e7507a6a --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.test.tsx @@ -0,0 +1,37 @@ +/* + * 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. + */ + +import React from 'react'; +import { shallow } from 'enzyme'; + +import { DeleteScritpedFieldConfirmationModal } from './confirmation_modal'; + +describe('DeleteScritpedFieldConfirmationModal', () => { + test('should render normally', () => { + const component = shallow( + <DeleteScritpedFieldConfirmationModal + field={{ name: '', script: '', lang: '' }} + deleteField={() => {}} + hideDeleteConfirmationModal={() => {}} + /> + ); + + expect(component).toMatchSnapshot(); + }); +}); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.tsx b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.tsx new file mode 100644 index 0000000000000..1e82174f863b0 --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/confirmation_modal.tsx @@ -0,0 +1,63 @@ +/* + * 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. + */ +import React from 'react'; +import { i18n } from '@kbn/i18n'; +import { EUI_MODAL_CONFIRM_BUTTON, EuiConfirmModal, EuiOverlayMask } from '@elastic/eui'; + +import { ScriptedFieldItem } from '../../types'; + +interface DeleteScritpedFieldConfirmationModalProps { + field: ScriptedFieldItem; + hideDeleteConfirmationModal: ( + event?: React.KeyboardEvent<HTMLDivElement> | React.MouseEvent<HTMLButtonElement> + ) => void; + deleteField: (event: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void; +} + +export const DeleteScritpedFieldConfirmationModal = ({ + field, + hideDeleteConfirmationModal, + deleteField, +}: DeleteScritpedFieldConfirmationModalProps) => { + const title = i18n.translate('kbn.management.editIndexPattern.scripted.deleteFieldLabel', { + defaultMessage: "Delete scripted field '{fieldName}'?", + values: { fieldName: field.name }, + }); + const cancelButtonText = i18n.translate( + 'kbn.management.editIndexPattern.scripted.deleteField.cancelButton', + { defaultMessage: 'Cancel' } + ); + const confirmButtonText = i18n.translate( + 'kbn.management.editIndexPattern.scripted.deleteField.deleteButton', + { defaultMessage: 'Delete' } + ); + + return ( + <EuiOverlayMask> + <EuiConfirmModal + title={title} + onCancel={hideDeleteConfirmationModal} + onConfirm={deleteField} + cancelButtonText={cancelButtonText} + confirmButtonText={confirmButtonText} + defaultFocusedButton={EUI_MODAL_CONFIRM_BUTTON} + /> + </EuiOverlayMask> + ); +}; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/index.ts b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/index.ts new file mode 100644 index 0000000000000..b87b572333e6f --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/confirmation_modal/index.ts @@ -0,0 +1,20 @@ +/* + * 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. + */ + +export { DeleteScritpedFieldConfirmationModal } from './confirmation_modal'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__jest__/__snapshots__/header.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__snapshots__/header.test.tsx.snap similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__jest__/__snapshots__/header.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__snapshots__/header.test.tsx.snap diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__jest__/header.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.test.tsx similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__jest__/header.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.test.tsx index 3e377ccfbdd41..19479de8f2aa4 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/__jest__/header.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.test.tsx @@ -20,10 +20,10 @@ import React from 'react'; import { shallow } from 'enzyme'; -import { Header } from '../header'; +import { Header } from './header'; describe('Header', () => { - it('should render normally', async () => { + test('should render normally', () => { const component = shallow(<Header addScriptedFieldUrl="" />); expect(component).toMatchSnapshot(); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.tsx similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.tsx index 97c235d82f870..b8f832dad72af 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/header.tsx @@ -18,13 +18,15 @@ */ import React from 'react'; -import PropTypes from 'prop-types'; - import { EuiButton, EuiFlexGroup, EuiFlexItem, EuiText, EuiTitle } from '@elastic/eui'; import { FormattedMessage } from '@kbn/i18n/react'; -export const Header = ({ addScriptedFieldUrl }) => ( +interface HeaderProps { + addScriptedFieldUrl: string; +} + +export const Header = ({ addScriptedFieldUrl }: HeaderProps) => ( <EuiFlexGroup alignItems="center"> <EuiFlexItem> <EuiTitle size="s"> @@ -56,7 +58,3 @@ export const Header = ({ addScriptedFieldUrl }) => ( </EuiFlexItem> </EuiFlexGroup> ); - -Header.propTypes = { - addScriptedFieldUrl: PropTypes.string.isRequired, -}; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/header/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/index.ts similarity index 92% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/index.ts index 5c0bb41eab765..7d74776fb2bca 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/index.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/index.ts @@ -20,3 +20,4 @@ export { Table } from './table'; export { Header } from './header'; export { CallOuts } from './call_outs'; +export { DeleteScritpedFieldConfirmationModal } from './confirmation_modal'; diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__jest__/__snapshots__/table.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__snapshots__/table.test.tsx.snap similarity index 93% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__jest__/__snapshots__/table.test.js.snap rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__snapshots__/table.test.tsx.snap index 2da4d84463b29..8439887dd468a 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__jest__/__snapshots__/table.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__snapshots__/table.test.tsx.snap @@ -41,6 +41,7 @@ exports[`Table should render normally 1`] = ` "icon": "pencil", "name": "Edit", "onClick": [Function], + "type": "icon", }, Object { "color": "danger", @@ -48,6 +49,7 @@ exports[`Table should render normally 1`] = ` "icon": "trash", "name": "Delete", "onClick": [Function], + "type": "icon", }, ], "name": "", @@ -58,8 +60,9 @@ exports[`Table should render normally 1`] = ` items={ Array [ Object { - "id": 1, - "name": "Elastic", + "lang": "Elastic", + "name": "1", + "script": "", }, ] } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__jest__/table.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.test.tsx similarity index 71% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__jest__/table.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.test.tsx index 4545bfa8f64db..13b3875f58687 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/__jest__/table.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.test.tsx @@ -19,45 +19,50 @@ import React from 'react'; import { shallow } from 'enzyme'; -import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; import { Table } from '../table'; +import { ScriptedFieldItem } from '../../types'; +import { IIndexPattern } from '../../../../../../../../../../../plugins/data/public'; -const indexPattern = { - fieldFormatMap: { - Elastic: { - type: { - title: 'string', - }, - }, - }, -}; +const getIndexPatternMock = (mockedFields: any = {}) => ({ ...mockedFields } as IIndexPattern); -const items = [{ id: 1, name: 'Elastic' }]; +const items: ScriptedFieldItem[] = [{ name: '1', lang: 'Elastic', script: '' }]; describe('Table', () => { - it('should render normally', async () => { - const component = shallowWithI18nProvider( + let indexPattern: IIndexPattern; + + beforeEach(() => { + indexPattern = getIndexPatternMock({ + fieldFormatMap: { + Elastic: { + type: { + title: 'string', + }, + }, + }, + }); + }); + + test('should render normally', () => { + const component = shallow<Table>( <Table indexPattern={indexPattern} items={items} editField={() => {}} deleteField={() => {}} - onChange={() => {}} /> ); expect(component).toMatchSnapshot(); }); - it('should render the format', async () => { - const component = shallowWithI18nProvider( + test('should render the format', () => { + const component = shallow( <Table indexPattern={indexPattern} items={items} editField={() => {}} deleteField={() => {}} - onChange={() => {}} /> ); @@ -65,16 +70,15 @@ describe('Table', () => { expect(formatTableCell).toMatchSnapshot(); }); - it('should allow edits', () => { + test('should allow edits', () => { const editField = jest.fn(); - const component = shallowWithI18nProvider( + const component = shallow( <Table indexPattern={indexPattern} items={items} editField={editField} deleteField={() => {}} - onChange={() => {}} /> ); @@ -83,16 +87,15 @@ describe('Table', () => { expect(editField).toBeCalled(); }); - it('should allow deletes', () => { + test('should allow deletes', () => { const deleteField = jest.fn(); - const component = shallowWithI18nProvider( + const component = shallow( <Table indexPattern={indexPattern} items={items} editField={() => {}} deleteField={deleteField} - onChange={() => {}} /> ); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.tsx similarity index 84% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.tsx index 5e05dd95827c7..14aed11b32203 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/components/table/table.tsx @@ -18,27 +18,24 @@ */ import React, { PureComponent } from 'react'; -import PropTypes from 'prop-types'; - -import { EuiInMemoryTable } from '@elastic/eui'; - +import { get } from 'lodash'; import { i18n } from '@kbn/i18n'; +import { EuiInMemoryTable, EuiBasicTableColumn } from '@elastic/eui'; -export class Table extends PureComponent { - static propTypes = { - indexPattern: PropTypes.object.isRequired, - items: PropTypes.array.isRequired, - editField: PropTypes.func.isRequired, - deleteField: PropTypes.func.isRequired, - }; +import { ScriptedFieldItem } from '../../types'; +import { IIndexPattern } from '../../../../../../../../../../../plugins/data/public'; - renderFormatCell = value => { - const { indexPattern } = this.props; +interface TableProps { + indexPattern: IIndexPattern; + items: ScriptedFieldItem[]; + editField: (field: ScriptedFieldItem) => void; + deleteField: (field: ScriptedFieldItem) => void; +} - const title = - indexPattern.fieldFormatMap[value] && indexPattern.fieldFormatMap[value].type - ? indexPattern.fieldFormatMap[value].type.title - : ''; +export class Table extends PureComponent<TableProps> { + renderFormatCell = (value: string) => { + const { indexPattern } = this.props; + const title = get(indexPattern, ['fieldFormatMap', value, 'type', 'title'], ''); return <span>{title}</span>; }; @@ -46,7 +43,7 @@ export class Table extends PureComponent { render() { const { items, editField, deleteField } = this.props; - const columns = [ + const columns: Array<EuiBasicTableColumn<ScriptedFieldItem>> = [ { field: 'displayName', name: i18n.translate('kbn.management.editIndexPattern.scripted.table.nameHeader', { @@ -101,6 +98,7 @@ export class Table extends PureComponent { name: '', actions: [ { + type: 'icon', name: i18n.translate('kbn.management.editIndexPattern.scripted.table.editHeader', { defaultMessage: 'Edit', }), @@ -112,6 +110,7 @@ export class Table extends PureComponent { onClick: editField, }, { + type: 'icon', name: i18n.translate('kbn.management.editIndexPattern.scripted.table.deleteHeader', { defaultMessage: 'Delete', }), diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/index.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/index.ts similarity index 100% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/index.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/index.ts diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__jest__/scripted_field_table.test.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_field_table.test.tsx similarity index 75% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__jest__/scripted_field_table.test.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_field_table.test.tsx index 5be963ad94b7d..914d80f9f61d7 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/__jest__/scripted_field_table.test.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_field_table.test.tsx @@ -18,9 +18,10 @@ */ import React from 'react'; -import { shallowWithI18nProvider } from 'test_utils/enzyme_helpers'; +import { shallow } from 'enzyme'; import { ScriptedFieldsTable } from '../scripted_fields_table'; +import { IIndexPattern } from '../../../../../../../../../plugins/data/common/index_patterns'; jest.mock('@elastic/eui', () => ({ EuiTitle: 'eui-title', @@ -36,18 +37,20 @@ jest.mock('@elastic/eui', () => ({ default: () => {}, }, })); -jest.mock('../components/header', () => ({ Header: 'header' })); -jest.mock('../components/call_outs', () => ({ CallOuts: 'call-outs' })); -jest.mock('../components/table', () => ({ +jest.mock('./components/header', () => ({ Header: 'header' })); +jest.mock('./components/call_outs', () => ({ CallOuts: 'call-outs' })); +jest.mock('./components/table', () => ({ // Note: this seems to fix React complaining about non lowercase attributes Table: () => { return 'table'; }, })); + jest.mock('ui/scripting_languages', () => ({ getSupportedScriptingLanguages: () => ['painless'], getDeprecatedScriptingLanguages: () => [], })); + jest.mock('ui/documentation_links', () => ({ documentationLinks: { scriptedFields: { @@ -61,16 +64,22 @@ const helpers = { getRouteHref: () => '#', }; -const indexPattern = { - getScriptedFields: () => [ - { name: 'ScriptedField', lang: 'painless', script: 'x++' }, - { name: 'JustATest', lang: 'painless', script: 'z++' }, - ], -}; +const getIndexPatternMock = (mockedFields: any = {}) => ({ ...mockedFields } as IIndexPattern); describe('ScriptedFieldsTable', () => { - it('should render normally', async () => { - const component = shallowWithI18nProvider( + let indexPattern: IIndexPattern; + + beforeEach(() => { + indexPattern = getIndexPatternMock({ + getScriptedFields: () => [ + { name: 'ScriptedField', lang: 'painless', script: 'x++' }, + { name: 'JustATest', lang: 'painless', script: 'z++' }, + ], + }); + }); + + test('should render normally', async () => { + const component = shallow<ScriptedFieldsTable>( <ScriptedFieldsTable indexPattern={indexPattern} helpers={helpers} /> ); @@ -82,8 +91,8 @@ describe('ScriptedFieldsTable', () => { expect(component).toMatchSnapshot(); }); - it('should filter based on the query bar', async () => { - const component = shallowWithI18nProvider( + test('should filter based on the query bar', async () => { + const component = shallow( <ScriptedFieldsTable indexPattern={indexPattern} helpers={helpers} /> ); @@ -98,16 +107,16 @@ describe('ScriptedFieldsTable', () => { expect(component).toMatchSnapshot(); }); - it('should filter based on the lang filter', async () => { - const component = shallowWithI18nProvider( + test('should filter based on the lang filter', async () => { + const component = shallow<ScriptedFieldsTable>( <ScriptedFieldsTable - indexPattern={{ + indexPattern={getIndexPatternMock({ getScriptedFields: () => [ { name: 'ScriptedField', lang: 'painless', script: 'x++' }, { name: 'JustATest', lang: 'painless', script: 'z++' }, { name: 'Bad', lang: 'somethingElse', script: 'z++' }, ], - }} + })} helpers={helpers} /> ); @@ -123,12 +132,12 @@ describe('ScriptedFieldsTable', () => { expect(component).toMatchSnapshot(); }); - it('should hide the table if there are no scripted fields', async () => { - const component = shallowWithI18nProvider( + test('should hide the table if there are no scripted fields', async () => { + const component = shallow( <ScriptedFieldsTable - indexPattern={{ + indexPattern={getIndexPatternMock({ getScriptedFields: () => [], - }} + })} helpers={helpers} /> ); @@ -141,22 +150,22 @@ describe('ScriptedFieldsTable', () => { expect(component).toMatchSnapshot(); }); - it('should show a delete modal', async () => { - const component = shallowWithI18nProvider( + test('should show a delete modal', async () => { + const component = shallow<ScriptedFieldsTable>( <ScriptedFieldsTable indexPattern={indexPattern} helpers={helpers} /> ); await component.update(); // Fire `componentWillMount()` - component.instance().startDeleteField({ name: 'ScriptedField' }); + component.instance().startDeleteField({ name: 'ScriptedField', lang: '', script: '' }); await component.update(); // Ensure the modal is visible expect(component).toMatchSnapshot(); }); - it('should delete a field', async () => { + test('should delete a field', async () => { const removeScriptedField = jest.fn(); - const component = shallowWithI18nProvider( + const component = shallow<ScriptedFieldsTable>( <ScriptedFieldsTable indexPattern={{ ...indexPattern, @@ -167,10 +176,12 @@ describe('ScriptedFieldsTable', () => { ); await component.update(); // Fire `componentWillMount()` - component.instance().startDeleteField({ name: 'ScriptedField' }); + component.instance().startDeleteField({ name: 'ScriptedField', lang: '', script: '' }); + await component.update(); await component.instance().deleteField(); await component.update(); + expect(removeScriptedField).toBeCalled(); }); }); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx similarity index 60% rename from src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.js rename to src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx index 69343a5175a25..ba044296a693a 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx @@ -18,31 +18,42 @@ */ import React, { Component } from 'react'; -import PropTypes from 'prop-types'; import { getSupportedScriptingLanguages, getDeprecatedScriptingLanguages, } from 'ui/scripting_languages'; import { documentationLinks } from 'ui/documentation_links'; -import { EuiSpacer, EuiOverlayMask, EuiConfirmModal, EUI_MODAL_CONFIRM_BUTTON } from '@elastic/eui'; -import { i18n } from '@kbn/i18n'; - -import { Table, Header, CallOuts } from './components'; - -export class ScriptedFieldsTable extends Component { - static propTypes = { - indexPattern: PropTypes.object.isRequired, - fieldFilter: PropTypes.string, - scriptedFieldLanguageFilter: PropTypes.string, - helpers: PropTypes.shape({ - redirectToRoute: PropTypes.func.isRequired, - getRouteHref: PropTypes.func.isRequired, - }), - onRemoveField: PropTypes.func, +import { EuiSpacer } from '@elastic/eui'; + +import { Table, Header, CallOuts, DeleteScritpedFieldConfirmationModal } from './components'; +import { ScriptedFieldItem } from './types'; + +import { IIndexPattern } from '../../../../../../../../../plugins/data/public'; + +interface ScriptedFieldsTableProps { + indexPattern: IIndexPattern; + fieldFilter?: string; + scriptedFieldLanguageFilter?: string; + helpers: { + redirectToRoute: Function; + getRouteHref: Function; }; + onRemoveField?: () => void; +} - constructor(props) { +interface ScriptedFieldsTableState { + deprecatedLangsInUse: string[]; + fieldToDelete: ScriptedFieldItem | undefined; + isDeleteConfirmationModalVisible: boolean; + fields: ScriptedFieldItem[]; +} + +export class ScriptedFieldsTable extends Component< + ScriptedFieldsTableProps, + ScriptedFieldsTableState +> { + constructor(props: ScriptedFieldsTableProps) { super(props); this.state = { @@ -64,7 +75,8 @@ export class ScriptedFieldsTable extends Component { const deprecatedLangs = getDeprecatedScriptingLanguages(); const supportedLangs = getSupportedScriptingLanguages(); - for (const { lang } of fields) { + for (const field of fields) { + const lang: string = field.lang; if (deprecatedLangs.includes(lang) || !supportedLangs.includes(lang)) { deprecatedLangsInUse.push(lang); } @@ -91,7 +103,8 @@ export class ScriptedFieldsTable extends Component { let filteredFields = languageFilteredFields; if (fieldFilter) { - const normalizedFieldFilter = this.props.fieldFilter.toLowerCase(); + const normalizedFieldFilter = fieldFilter.toLowerCase(); + filteredFields = languageFilteredFields.filter(field => field.name.toLowerCase().includes(normalizedFieldFilter) ); @@ -100,18 +113,7 @@ export class ScriptedFieldsTable extends Component { return filteredFields; }; - renderCallOuts() { - const { deprecatedLangsInUse } = this.state; - - return ( - <CallOuts - deprecatedLangsInUse={deprecatedLangsInUse} - painlessDocLink={documentationLinks.scriptedFields.painless} - /> - ); - } - - startDeleteField = field => { + startDeleteField = (field: ScriptedFieldItem) => { this.setState({ fieldToDelete: field, isDeleteConfirmationModalVisible: true }); }; @@ -124,55 +126,29 @@ export class ScriptedFieldsTable extends Component { const { fieldToDelete } = this.state; indexPattern.removeScriptedField(fieldToDelete); - onRemoveField && onRemoveField(); - this.fetchFields(); - this.hideDeleteConfirmationModal(); - }; - renderDeleteConfirmationModal() { - const { fieldToDelete } = this.state; - - if (!fieldToDelete) { - return null; + if (onRemoveField) { + onRemoveField(); } - const title = i18n.translate('kbn.management.editIndexPattern.scripted.deleteFieldLabel', { - defaultMessage: "Delete scripted field '{fieldName}'?", - values: { fieldName: fieldToDelete.name }, - }); - const cancelButtonText = i18n.translate( - 'kbn.management.editIndexPattern.scripted.deleteField.cancelButton', - { defaultMessage: 'Cancel' } - ); - const confirmButtonText = i18n.translate( - 'kbn.management.editIndexPattern.scripted.deleteField.deleteButton', - { defaultMessage: 'Delete' } - ); - - return ( - <EuiOverlayMask> - <EuiConfirmModal - title={title} - onCancel={this.hideDeleteConfirmationModal} - onConfirm={this.deleteField} - cancelButtonText={cancelButtonText} - confirmButtonText={confirmButtonText} - defaultFocusedButton={EUI_MODAL_CONFIRM_BUTTON} - /> - </EuiOverlayMask> - ); - } + this.fetchFields(); + this.hideDeleteConfirmationModal(); + }; render() { const { helpers, indexPattern } = this.props; + const { fieldToDelete, deprecatedLangsInUse } = this.state; const items = this.getFilteredItems(); return ( - <div> + <> <Header addScriptedFieldUrl={helpers.getRouteHref(indexPattern, 'addField')} /> - {this.renderCallOuts()} + <CallOuts + deprecatedLangsInUse={deprecatedLangsInUse} + painlessDocLink={documentationLinks.scriptedFields.painless} + /> <EuiSpacer size="l" /> @@ -183,8 +159,14 @@ export class ScriptedFieldsTable extends Component { deleteField={this.startDeleteField} /> - {this.renderDeleteConfirmationModal()} - </div> + {fieldToDelete && ( + <DeleteScritpedFieldConfirmationModal + deleteField={this.deleteField} + field={fieldToDelete} + hideDeleteConfirmationModal={this.hideDeleteConfirmationModal} + /> + )} + </> ); } } diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/types.ts b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/types.ts new file mode 100644 index 0000000000000..c1227393c561f --- /dev/null +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/types.ts @@ -0,0 +1,25 @@ +/* + * 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. + */ + +/** @internal **/ +export interface ScriptedFieldItem { + name: string; + lang: string; + script: string; +} diff --git a/src/legacy/ui/public/scripting_languages/index.js b/src/legacy/ui/public/scripting_languages/index.ts similarity index 83% rename from src/legacy/ui/public/scripting_languages/index.js rename to src/legacy/ui/public/scripting_languages/index.ts index 2f43a44d66068..283a3273a2a5d 100644 --- a/src/legacy/ui/public/scripting_languages/index.js +++ b/src/legacy/ui/public/scripting_languages/index.ts @@ -17,23 +17,25 @@ * under the License. */ +import { IHttpService } from 'angular'; +import { i18n } from '@kbn/i18n'; + import chrome from '../chrome'; import { toastNotifications } from '../notify'; -import { i18n } from '@kbn/i18n'; -export function getSupportedScriptingLanguages() { +export function getSupportedScriptingLanguages(): string[] { return ['painless']; } -export function getDeprecatedScriptingLanguages() { +export function getDeprecatedScriptingLanguages(): string[] { return []; } -export function GetEnabledScriptingLanguagesProvider($http) { +export function GetEnabledScriptingLanguagesProvider($http: IHttpService) { return () => { return $http .get(chrome.addBasePath('/api/kibana/scripts/languages')) - .then(res => res.data) + .then((res: any) => res.data) .catch(() => { toastNotifications.addDanger( i18n.translate('common.ui.scriptingLanguages.errorFetchingToastDescription', { From 52747c9c1775c0e961a06ff808f8fac6fb189743 Mon Sep 17 00:00:00 2001 From: Brandon Kobel <brandon.kobel@elastic.co> Date: Mon, 13 Apr 2020 09:02:48 -0700 Subject: [PATCH 060/102] Only fetching TaskManager's available tasks once per call to fillPool (#61991) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../task_manager/server/lib/fill_pool.test.ts | 4 +- .../task_manager/server/lib/fill_pool.ts | 49 +++++++++---------- 2 files changed, 24 insertions(+), 29 deletions(-) diff --git a/x-pack/plugins/task_manager/server/lib/fill_pool.test.ts b/x-pack/plugins/task_manager/server/lib/fill_pool.test.ts index 3863fdaf9da62..ebb72c3ed36d6 100644 --- a/x-pack/plugins/task_manager/server/lib/fill_pool.test.ts +++ b/x-pack/plugins/task_manager/server/lib/fill_pool.test.ts @@ -10,7 +10,7 @@ import { fillPool } from './fill_pool'; import { TaskPoolRunResult } from '../task_pool'; describe('fillPool', () => { - test('stops filling when there are no more tasks in the store', async () => { + test('stops filling when pool runs all claimed tasks, even if there is more capacity', async () => { const tasks = [ [1, 2, 3], [4, 5], @@ -22,7 +22,7 @@ describe('fillPool', () => { await fillPool(fetchAvailableTasks, converter, run); - expect(_.flattenDeep(run.args)).toEqual([1, 2, 3, 4, 5]); + expect(_.flattenDeep(run.args)).toEqual([1, 2, 3]); }); test('stops filling when the pool has no more capacity', async () => { diff --git a/x-pack/plugins/task_manager/server/lib/fill_pool.ts b/x-pack/plugins/task_manager/server/lib/fill_pool.ts index 60470b22c00a9..9e4894587203d 100644 --- a/x-pack/plugins/task_manager/server/lib/fill_pool.ts +++ b/x-pack/plugins/task_manager/server/lib/fill_pool.ts @@ -5,12 +5,12 @@ */ import { performance } from 'perf_hooks'; -import { after } from 'lodash'; import { TaskPoolRunResult } from '../task_pool'; export enum FillPoolResult { NoTasksClaimed = 'NoTasksClaimed', RanOutOfCapacity = 'RanOutOfCapacity', + PoolFilled = 'PoolFilled', } type BatchRun<T> = (tasks: T[]) => Promise<TaskPoolRunResult>; @@ -35,33 +35,28 @@ export async function fillPool<TRecord, TRunner>( run: BatchRun<TRunner> ): Promise<FillPoolResult> { performance.mark('fillPool.start'); - const markClaimedTasksOnRerunCycle = after(2, () => - performance.mark('fillPool.claimedOnRerunCycle') - ); - while (true) { - const instances = await fetchAvailableTasks(); + const instances = await fetchAvailableTasks(); - if (!instances.length) { - performance.mark('fillPool.bailNoTasks'); - performance.measure( - 'fillPool.activityDurationUntilNoTasks', - 'fillPool.start', - 'fillPool.bailNoTasks' - ); - return FillPoolResult.NoTasksClaimed; - } - markClaimedTasksOnRerunCycle(); - const tasks = instances.map(converter); + if (!instances.length) { + performance.mark('fillPool.bailNoTasks'); + performance.measure( + 'fillPool.activityDurationUntilNoTasks', + 'fillPool.start', + 'fillPool.bailNoTasks' + ); + return FillPoolResult.NoTasksClaimed; + } + const tasks = instances.map(converter); - if ((await run(tasks)) === TaskPoolRunResult.RanOutOfCapacity) { - performance.mark('fillPool.bailExhaustedCapacity'); - performance.measure( - 'fillPool.activityDurationUntilExhaustedCapacity', - 'fillPool.start', - 'fillPool.bailExhaustedCapacity' - ); - return FillPoolResult.RanOutOfCapacity; - } - performance.mark('fillPool.cycle'); + if ((await run(tasks)) === TaskPoolRunResult.RanOutOfCapacity) { + performance.mark('fillPool.bailExhaustedCapacity'); + performance.measure( + 'fillPool.activityDurationUntilExhaustedCapacity', + 'fillPool.start', + 'fillPool.bailExhaustedCapacity' + ); + return FillPoolResult.RanOutOfCapacity; } + performance.mark('fillPool.cycle'); + return FillPoolResult.PoolFilled; } From 0c09a7756fb76f26b3da81b58af00b4555d0a213 Mon Sep 17 00:00:00 2001 From: Yuliia Naumenko <jo.naumenko@gmail.com> Date: Mon, 13 Apr 2020 09:47:03 -0700 Subject: [PATCH 061/102] Added connectors loading spinner to show the actions forms only when connectors is loaded (#63211) * Added connectors loading spinner to show the actions forms only when connectors is loaded * Added warning message for actions with removed connectors * Fixed loading connectors spinner --- .../action_connector_form/action_form.tsx | 180 +++++++++++------- 1 file changed, 106 insertions(+), 74 deletions(-) diff --git a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx index 5890d9fe07f0e..87a8d572fda0f 100644 --- a/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx +++ b/x-pack/plugins/triggers_actions_ui/public/application/sections/action_connector_form/action_form.tsx @@ -24,6 +24,7 @@ import { EuiToolTip, EuiIconTip, EuiLink, + EuiCallOut, } from '@elastic/eui'; import { HttpSetup, ToastsApi } from 'kibana/public'; import { loadActionTypes, loadAllActions } from '../../lib/action_connector_api'; @@ -85,8 +86,10 @@ export const ActionForm = ({ ); const [isAddActionPanelOpen, setIsAddActionPanelOpen] = useState<boolean>(true); const [connectors, setConnectors] = useState<ActionConnector[]>([]); + const [isLoadingConnectors, setIsLoadingConnectors] = useState<boolean>(false); const [isLoadingActionTypes, setIsLoadingActionTypes] = useState<boolean>(false); const [actionTypesIndex, setActionTypesIndex] = useState<ActionTypeIndex | undefined>(undefined); + const [emptyActionsIds, setEmptyActionsIds] = useState<string[]>([]); // load action types useEffect(() => { @@ -128,6 +131,7 @@ export const ActionForm = ({ async function loadConnectors() { try { + setIsLoadingConnectors(true); const actionsResponse = await loadAllActions({ http }); setConnectors(actionsResponse); } catch (e) { @@ -139,6 +143,8 @@ export const ActionForm = ({ } ), }); + } finally { + setIsLoadingConnectors(false); } } const preconfiguredMessage = i18n.translate( @@ -387,13 +393,25 @@ export const ActionForm = ({ > <EuiEmptyPrompt title={ - <FormattedMessage - id="xpack.triggersActionsUI.sections.alertForm.emptyConnectorsLabel" - defaultMessage="No {actionTypeName} connectors." - values={{ - actionTypeName, - }} - /> + emptyActionsIds.find((emptyId: string) => actionItem.id === emptyId) ? ( + <FormattedMessage + id="xpack.triggersActionsUI.sections.alertForm.emptyConnectorsLabel" + defaultMessage="No {actionTypeName} connectors." + values={{ + actionTypeName, + }} + /> + ) : ( + <EuiCallOut + title={i18n.translate( + 'xpack.triggersActionsUI.sections.alertForm.unableToLoadConnectorTitle', + { + defaultMessage: 'Unable to load connector.', + } + )} + color="warning" + /> + ) } actions={[ <EuiButton @@ -448,6 +466,7 @@ export const ActionForm = ({ params: {}, }); setActionIdByIndex(actions.length.toString(), actions.length - 1); + setEmptyActionsIds([...emptyActionsIds, actions.length.toString()]); } } @@ -492,81 +511,94 @@ export const ActionForm = ({ }); } - return ( - <Fragment> - {actions.map((actionItem: AlertAction, index: number) => { - const actionConnector = connectors.find(field => field.id === actionItem.id); - // connectors doesn't exists - if (!actionConnector) { - return getAddConnectorsForm(actionItem, index); - } + const alertActionsList = actions.map((actionItem: AlertAction, index: number) => { + const actionConnector = connectors.find(field => field.id === actionItem.id); + // connectors doesn't exists + if (!actionConnector) { + return getAddConnectorsForm(actionItem, index); + } + + const actionErrors: { errors: IErrorObject } = actionTypeRegistry + .get(actionItem.actionTypeId) + ?.validateParams(actionItem.params); - const actionErrors: { errors: IErrorObject } = actionTypeRegistry - .get(actionItem.actionTypeId) - ?.validateParams(actionItem.params); + return getActionTypeForm(actionItem, actionConnector, actionErrors, index); + }); - return getActionTypeForm(actionItem, actionConnector, actionErrors, index); - })} - <EuiSpacer size="m" /> - {isAddActionPanelOpen === false ? ( - <EuiButton - iconType="plusInCircle" - data-test-subj="addAlertActionButton" - onClick={() => setIsAddActionPanelOpen(true)} - > + return ( + <Fragment> + {isLoadingConnectors ? ( + <SectionLoading> <FormattedMessage - id="xpack.triggersActionsUI.sections.alertForm.addActionButtonLabel" - defaultMessage="Add action" + id="xpack.triggersActionsUI.sections.alertForm.loadingConnectorsDescription" + defaultMessage="Loading connectors…" /> - </EuiButton> - ) : null} - {isAddActionPanelOpen ? ( + </SectionLoading> + ) : ( <Fragment> - <EuiFlexGroup id="alertActionTypeTitle" justifyContent="spaceBetween"> - <EuiFlexItem grow={false}> - <EuiTitle size="xs"> - <h5> - <FormattedMessage - defaultMessage="Actions: Select an action type" - id="xpack.triggersActionsUI.sections.alertForm.selectAlertActionTypeTitle" - /> - </h5> - </EuiTitle> - </EuiFlexItem> - {hasDisabledByLicenseActionTypes && ( - <EuiFlexItem grow={false}> - <EuiTitle size="xs"> - <h5> - <EuiLink - href={VIEW_LICENSE_OPTIONS_LINK} - target="_blank" - className="actActionForm__getMoreActionsLink" - > + {alertActionsList} + <EuiSpacer size="m" /> + {isAddActionPanelOpen === false ? ( + <EuiButton + iconType="plusInCircle" + data-test-subj="addAlertActionButton" + onClick={() => setIsAddActionPanelOpen(true)} + > + <FormattedMessage + id="xpack.triggersActionsUI.sections.alertForm.addActionButtonLabel" + defaultMessage="Add action" + /> + </EuiButton> + ) : null} + {isAddActionPanelOpen ? ( + <Fragment> + <EuiFlexGroup id="alertActionTypeTitle" justifyContent="spaceBetween"> + <EuiFlexItem grow={false}> + <EuiTitle size="xs"> + <h5> <FormattedMessage - defaultMessage="Get more actions" - id="xpack.triggersActionsUI.sections.actionForm.getMoreActionsTitle" + defaultMessage="Actions: Select an action type" + id="xpack.triggersActionsUI.sections.alertForm.selectAlertActionTypeTitle" /> - </EuiLink> - </h5> - </EuiTitle> - </EuiFlexItem> - )} - </EuiFlexGroup> - <EuiSpacer /> - <EuiFlexGroup gutterSize="s" wrap> - {isLoadingActionTypes ? ( - <SectionLoading> - <FormattedMessage - id="xpack.triggersActionsUI.sections.alertForm.loadingActionTypesDescription" - defaultMessage="Loading action types…" - /> - </SectionLoading> - ) : ( - actionTypeNodes - )} - </EuiFlexGroup> + </h5> + </EuiTitle> + </EuiFlexItem> + {hasDisabledByLicenseActionTypes && ( + <EuiFlexItem grow={false}> + <EuiTitle size="xs"> + <h5> + <EuiLink + href={VIEW_LICENSE_OPTIONS_LINK} + target="_blank" + className="actActionForm__getMoreActionsLink" + > + <FormattedMessage + defaultMessage="Get more actions" + id="xpack.triggersActionsUI.sections.actionForm.getMoreActionsTitle" + /> + </EuiLink> + </h5> + </EuiTitle> + </EuiFlexItem> + )} + </EuiFlexGroup> + <EuiSpacer /> + <EuiFlexGroup gutterSize="s" wrap> + {isLoadingActionTypes ? ( + <SectionLoading> + <FormattedMessage + id="xpack.triggersActionsUI.sections.alertForm.loadingActionTypesDescription" + defaultMessage="Loading action types…" + /> + </SectionLoading> + ) : ( + actionTypeNodes + )} + </EuiFlexGroup> + </Fragment> + ) : null} </Fragment> - ) : null} + )} {actionTypesIndex && activeActionItem ? ( <ConnectorAddModal key={activeActionItem.index} From 69b436e820c7bb1dc5598051bb917c2e314e5fb8 Mon Sep 17 00:00:00 2001 From: Nathan Reese <reese.nathan@gmail.com> Date: Mon, 13 Apr 2020 11:22:11 -0600 Subject: [PATCH 062/102] [Maps] turn on blended layer for geojson upload (#63200) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../client_file_source/geojson_file_source.js | 21 +++++++++---------- 1 file changed, 10 insertions(+), 11 deletions(-) diff --git a/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js b/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js index 1003f8329da22..df11fe9f32770 100644 --- a/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js +++ b/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js @@ -10,11 +10,11 @@ import { ES_GEO_FIELD_TYPE, GEOJSON_FILE, DEFAULT_MAX_RESULT_WINDOW, + SCALING_TYPES, } from '../../../../common/constants'; import { ClientFileCreateSourceEditor } from './create_client_file_source_editor'; import { ESSearchSource } from '../es_search_source'; import uuid from 'uuid/v4'; -import _ from 'lodash'; import { i18n } from '@kbn/i18n'; import { registerSource } from '../source_registry'; @@ -91,23 +91,22 @@ const viewIndexedData = ( importErrorHandler(indexResponses); return; } - const { fields, id } = indexPatternResp; - const geoFieldArr = fields.filter(field => - Object.values(ES_GEO_FIELD_TYPE).includes(field.type) - ); - const geoField = _.get(geoFieldArr, '[0].name'); - const indexPatternId = id; + const { fields, id: indexPatternId } = indexPatternResp; + const geoField = fields.find(field => Object.values(ES_GEO_FIELD_TYPE).includes(field.type)); if (!indexPatternId || !geoField) { addAndViewSource(null); } else { - // Only turn on bounds filter for large doc counts - const filterByMapBounds = indexDataResp.docCount > DEFAULT_MAX_RESULT_WINDOW; const source = new ESSearchSource( { id: uuid(), indexPatternId, - geoField, - filterByMapBounds, + geoField: geoField.name, + // Only turn on bounds filter for large doc counts + filterByMapBounds: indexDataResp.docCount > DEFAULT_MAX_RESULT_WINDOW, + scalingType: + geoField.type === ES_GEO_FIELD_TYPE.GEO_POINT + ? SCALING_TYPES.CLUSTERS + : SCALING_TYPES.LIMIT, }, inspectorAdapters ); From 5559b09dccbf682686a48d7bfc3b4123e3aa245c Mon Sep 17 00:00:00 2001 From: Ryland Herrick <ryalnd@gmail.com> Date: Mon, 13 Apr 2020 12:24:09 -0500 Subject: [PATCH 063/102] Consistent terminology around cypress test data (#63279) * Uses "data" or "test data" when referring to the general idea * Uses "archive" when referring to the specific data/implementation * Adds a few grammar/spelling tweaks --- x-pack/legacy/plugins/siem/cypress/README.md | 32 +++++++------------- 1 file changed, 11 insertions(+), 21 deletions(-) diff --git a/x-pack/legacy/plugins/siem/cypress/README.md b/x-pack/legacy/plugins/siem/cypress/README.md index a031fea172be5..89bafce9c9dc8 100644 --- a/x-pack/legacy/plugins/siem/cypress/README.md +++ b/x-pack/legacy/plugins/siem/cypress/README.md @@ -129,31 +129,21 @@ yarn cypress:run-as-ci ``` Note that with this type of execution you don't need to have running a kibana and elasticsearch instance. This is because - the command, as it would happen in the CI, will launch the instances. The elasticsearch instance will be fed with the data - placed in: `x-pack/test/siem_cypress/es_archives` + the command, as it would happen in the CI, will launch the instances. The elasticsearch instance will be fed data + found in: `x-pack/test/siem_cypress/es_archives` As in this case we want to mimic a CI execution we want to execute the tests with the same set of data, this is why in this case does not make sense to override Cypress environment variables. ### Test data -As said before when running the tests as Jenkins the tests are fed with the data placed in: `x-pack/test/siem_cypress/es_archives`. +As mentioned above, when running the tests as Jenkins the tests are populated with data ("archives") found in: `x-pack/test/siem_cypress/es_archives`. -Currently there are two different ways of feeding data: -1. By default -2. Specifying a specific set of data for a specific test +By default, each test is populated with some base data: an empty kibana index and a set of auditbeat data (the `empty_kibana` and `auditbeat` archives, respectively). This is usually enough to cover most of the scenarios that we are testing. -#### By default +#### Running tests with additional archives -When a execution of the test is going to be done an empty kibana and a set of audibteat data are loaded (empty_kibana and auditbeat). With this data usually is enough to cover most of the scenarios that we are testing. - -#### Running tests with custom data - -Sometimes the default data is not enough and we need a specific set of data in order to being able to test the desired behaviour. - -In that case in the hooks of the test use the function `esArchiverLoad` to load the set of data neeed and `esArchiverUnload` to remove the changes done in the data. - -Example: +When the base data is insufficient, one can specify additional archives. Use `esArchiverLoad` to load the necessary archive, and `esArchiverUnload` to remove the archive from elasticsearch: ```typescript import { esArchiverLoad, esArchiverUnload } from '../tasks/es_archiver'; @@ -174,11 +164,11 @@ describe('This are going to be a set of tests', () => { ``` -Note that loading and unloading data takes a signifcant amount of time so try to minimize the use of it when possible. +Note that loading and unloading data take a significant amount of time, so try to minimize their use. -### Current sets of data +### Current archives -The current sets of data can be found in: `x-pack/test/siem_cypress/es_archives` folder. +The current archives can be found in `x-pack/test/siem_cypress/es_archives/`. - auditbeat - Auditbeat data generated in Sep, 2019 with the following hosts present: @@ -197,9 +187,9 @@ The current sets of data can be found in: `x-pack/test/siem_cypress/es_archives` - signals - Set of data with 108 opened signals linked to "Signals test" custom rule. -### How to generate new test data +### How to generate a new archive -We are using es_archiver in order to generate the data that our Cypress tests needs. +We are using es_archiver in order to manage the data that our Cypress tests needs. 1. Setup if possible a clean instance of kibana and elasticsearch (if not, possible please try to clean the data that you are going to generate). 2. With the kibana and elasticsearch instance up and running, create the data that you need for your test. From a58cc5da12a250610aae1cee078124ee350fd29b Mon Sep 17 00:00:00 2001 From: patrykkopycinski <patryk.kopycinski@elastic.co> Date: Mon, 13 Apr 2020 19:40:48 +0200 Subject: [PATCH 064/102] [SIEM] Fix AlertsTable id (#63368) --- .../siem/public/components/alerts_viewer/alerts_table.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/x-pack/legacy/plugins/siem/public/components/alerts_viewer/alerts_table.tsx b/x-pack/legacy/plugins/siem/public/components/alerts_viewer/alerts_table.tsx index 05d8f97bb8849..dd608babef48f 100644 --- a/x-pack/legacy/plugins/siem/public/components/alerts_viewer/alerts_table.tsx +++ b/x-pack/legacy/plugins/siem/public/components/alerts_viewer/alerts_table.tsx @@ -17,7 +17,7 @@ export interface OwnProps { start: number; } -const ALERTS_TABLE_ID = 'timeline-alerts-table'; +const ALERTS_TABLE_ID = 'alerts-table'; const defaultAlertsFilters: Filter[] = [ { meta: { From 1084b1c7b9ec09c98baa74ad56db3f5d2a394826 Mon Sep 17 00:00:00 2001 From: Maggie Ghamry <46542915+maggieghamry@users.noreply.github.com> Date: Mon, 13 Apr 2020 13:41:12 -0400 Subject: [PATCH 065/102] Update to pagination for workpad and templates (#62050) Added logic to hide pagination if no Canvas workpads exists, and disable the previous/next arrows if there is only one page, for both workapds and templates --- .../components/workpad_loader/workpad_loader.js | 16 +++++++++++----- .../workpad_templates/workpad_templates.js | 12 +++++++----- 2 files changed, 18 insertions(+), 10 deletions(-) diff --git a/x-pack/legacy/plugins/canvas/public/components/workpad_loader/workpad_loader.js b/x-pack/legacy/plugins/canvas/public/components/workpad_loader/workpad_loader.js index 9b30b3e1ec7ca..30d4ded8571c5 100644 --- a/x-pack/legacy/plugins/canvas/public/components/workpad_loader/workpad_loader.js +++ b/x-pack/legacy/plugins/canvas/public/components/workpad_loader/workpad_loader.js @@ -266,11 +266,17 @@ export class WorkpadLoader extends React.PureComponent { data-test-subj="canvasWorkpadLoaderTable" /> <EuiSpacer /> - <EuiFlexGroup gutterSize="none" justifyContent="flexEnd"> - <EuiFlexItem grow={false}> - <EuiPagination activePage={pageNumber} onPageClick={setPage} pageCount={totalPages} /> - </EuiFlexItem> - </EuiFlexGroup> + {rows.length > 0 && ( + <EuiFlexGroup gutterSize="none" justifyContent="flexEnd"> + <EuiFlexItem grow={false}> + <EuiPagination + activePage={pageNumber} + onPageClick={setPage} + pageCount={totalPages} + /> + </EuiFlexItem> + </EuiFlexGroup> + )} </WorkpadDropzone> </Fragment> ); diff --git a/x-pack/legacy/plugins/canvas/public/components/workpad_templates/workpad_templates.js b/x-pack/legacy/plugins/canvas/public/components/workpad_templates/workpad_templates.js index c80db544bf370..a9a157f5675f8 100644 --- a/x-pack/legacy/plugins/canvas/public/components/workpad_templates/workpad_templates.js +++ b/x-pack/legacy/plugins/canvas/public/components/workpad_templates/workpad_templates.js @@ -113,11 +113,13 @@ export class WorkpadTemplates extends React.PureComponent { className="canvasWorkpad__dropzoneTable canvasWorkpad__dropzoneTable--tags" /> <EuiSpacer /> - <EuiFlexGroup gutterSize="none" justifyContent="flexEnd"> - <EuiFlexItem grow={false}> - <EuiPagination activePage={pageNumber} onPageClick={setPage} pageCount={totalPages} /> - </EuiFlexItem> - </EuiFlexGroup> + {rows.length > 0 && ( + <EuiFlexGroup gutterSize="none" justifyContent="flexEnd"> + <EuiFlexItem grow={false}> + <EuiPagination activePage={pageNumber} onPageClick={setPage} pageCount={totalPages} /> + </EuiFlexItem> + </EuiFlexGroup> + )} </Fragment> ); }; From 19fcc6111a1ce526c0c4157de6de36b40f4d634d Mon Sep 17 00:00:00 2001 From: Corey Robertson <corey.robertson@elastic.co> Date: Mon, 13 Apr 2020 14:21:02 -0400 Subject: [PATCH 066/102] Use MapInput type from Maps plugin (#61539) --- .../functions/common/saved_map.ts | 29 +++---------------- .../input_type_to_expression/map.test.ts | 10 +++---- .../input_type_to_expression/map.ts | 4 +-- 3 files changed, 11 insertions(+), 32 deletions(-) diff --git a/x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/saved_map.ts b/x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/saved_map.ts index 4b045b0c5edcf..cba19ce7da80f 100644 --- a/x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/saved_map.ts +++ b/x-pack/legacy/plugins/canvas/canvas_plugin_src/functions/common/saved_map.ts @@ -5,8 +5,6 @@ */ import { ExpressionFunctionDefinition } from 'src/plugins/expressions/common'; -import { TimeRange, Filter as DataFilter } from 'src/plugins/data/public'; -import { EmbeddableInput } from 'src/plugins/embeddable/public'; import { getQueryFilters } from '../../../public/lib/build_embeddable_filters'; import { Filter, MapCenter, TimeRange as TimeRangeArg } from '../../../types'; import { @@ -15,6 +13,7 @@ import { EmbeddableExpression, } from '../../expression_types'; import { getFunctionHelp } from '../../../i18n'; +import { MapEmbeddableInput } from '../../../../../plugins/maps/public'; interface Arguments { id: string; @@ -24,32 +23,12 @@ interface Arguments { timerange: TimeRangeArg | null; } -// Map embeddable is missing proper typings, so type is just to document what we -// are expecting to pass to the embeddable -export type SavedMapInput = EmbeddableInput & { - id: string; - isLayerTOCOpen: boolean; - timeRange?: TimeRange; - refreshConfig: { - isPaused: boolean; - interval: number; - }; - hideFilterActions: true; - filters: DataFilter[]; - mapCenter?: { - lat: number; - lon: number; - zoom: number; - }; - hiddenLayers?: string[]; -}; - const defaultTimeRange = { from: 'now-15m', to: 'now', }; -type Output = EmbeddableExpression<SavedMapInput>; +type Output = EmbeddableExpression<MapEmbeddableInput>; export function savedMap(): ExpressionFunctionDefinition< 'savedMap', @@ -108,8 +87,8 @@ export function savedMap(): ExpressionFunctionDefinition< filters: getQueryFilters(filters), timeRange: args.timerange || defaultTimeRange, refreshConfig: { - isPaused: false, - interval: 0, + pause: false, + value: 0, }, mapCenter: center, diff --git a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.test.ts b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.test.ts index 4c294fb37c2db..f9ff94ee7d8f1 100644 --- a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.test.ts +++ b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.test.ts @@ -5,7 +5,7 @@ */ import { toExpression } from './map'; -import { SavedMapInput } from '../../../functions/common/saved_map'; +import { MapEmbeddableInput } from '../../../../../maps/public'; import { fromExpression, Ast } from '@kbn/interpreter/common'; const baseSavedMapInput = { @@ -13,15 +13,15 @@ const baseSavedMapInput = { filters: [], isLayerTOCOpen: false, refreshConfig: { - isPaused: true, - interval: 0, + pause: true, + value: 0, }, hideFilterActions: true as true, }; describe('toExpression', () => { it('converts to a savedMap expression', () => { - const input: SavedMapInput = { + const input: MapEmbeddableInput = { ...baseSavedMapInput, }; @@ -39,7 +39,7 @@ describe('toExpression', () => { }); it('includes optional input values', () => { - const input: SavedMapInput = { + const input: MapEmbeddableInput = { ...baseSavedMapInput, mapCenter: { lat: 1, diff --git a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.ts b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.ts index e3f9eca61ae28..e0cb71c17774c 100644 --- a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.ts +++ b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/input_type_to_expression/map.ts @@ -4,9 +4,9 @@ * you may not use this file except in compliance with the Elastic License. */ -import { SavedMapInput } from '../../../functions/common/saved_map'; +import { MapEmbeddableInput } from '../../../../../maps/public'; -export function toExpression(input: SavedMapInput): string { +export function toExpression(input: MapEmbeddableInput): string { const expressionParts = [] as string[]; expressionParts.push('savedMap'); From e27526fd92eaa0094b70ddb2119a326543475c2c Mon Sep 17 00:00:00 2001 From: Corey Robertson <corey.robertson@elastic.co> Date: Mon, 13 Apr 2020 15:29:24 -0400 Subject: [PATCH 067/102] Move away from npStart for embeddables in canvas (#62680) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../canvas/canvas_plugin_src/plugin.ts | 28 +++- .../renderers/embeddable/embeddable.tsx | 143 +++++++++--------- .../canvas_plugin_src/renderers/index.js | 5 +- .../components/embeddable_flyout/flyout.tsx | 7 +- .../components/embeddable_flyout/index.tsx | 1 + x-pack/legacy/plugins/canvas/public/legacy.ts | 2 + .../legacy/plugins/canvas/public/plugin.tsx | 18 ++- 7 files changed, 114 insertions(+), 90 deletions(-) diff --git a/x-pack/legacy/plugins/canvas/canvas_plugin_src/plugin.ts b/x-pack/legacy/plugins/canvas/canvas_plugin_src/plugin.ts index 7cd1efe9e27c8..a654c6b28b350 100644 --- a/x-pack/legacy/plugins/canvas/canvas_plugin_src/plugin.ts +++ b/x-pack/legacy/plugins/canvas/canvas_plugin_src/plugin.ts @@ -6,11 +6,14 @@ import { CoreSetup, CoreStart, Plugin } from 'src/core/public'; import { CanvasSetup } from '../public'; +import { EmbeddableStart } from '../../../../../src/plugins/embeddable/public'; +import { UiActionsStart } from '../../../../../src/plugins/ui_actions/public'; +import { Start as InspectorStart } from '../../../../../src/plugins/inspector/public'; import { functions } from './functions/browser'; import { typeFunctions } from './expression_types'; // @ts-ignore: untyped local -import { renderFunctions } from './renderers'; +import { renderFunctions, renderFunctionFactories } from './renderers'; import { elementSpecs } from './elements'; // @ts-ignore Untyped Local @@ -30,13 +33,26 @@ interface SetupDeps { canvas: CanvasSetup; } +export interface StartDeps { + embeddable: EmbeddableStart; + uiActions: UiActionsStart; + inspector: InspectorStart; +} + /** @internal */ -export class CanvasSrcPlugin implements Plugin<{}, {}, SetupDeps, {}> { - public setup(core: CoreSetup, plugins: SetupDeps) { +export class CanvasSrcPlugin implements Plugin<void, void, SetupDeps, StartDeps> { + public setup(core: CoreSetup<StartDeps>, plugins: SetupDeps) { plugins.canvas.addFunctions(functions); plugins.canvas.addTypes(typeFunctions); + plugins.canvas.addRenderers(renderFunctions); + core.getStartServices().then(([coreStart, depsStart]) => { + plugins.canvas.addRenderers( + renderFunctionFactories.map((factory: any) => factory(coreStart, depsStart)) + ); + }); + plugins.canvas.addElements(elementSpecs); plugins.canvas.addDatasourceUIs(datasourceSpecs); plugins.canvas.addModelUIs(modelSpecs); @@ -45,11 +61,7 @@ export class CanvasSrcPlugin implements Plugin<{}, {}, SetupDeps, {}> { plugins.canvas.addTagUIs(tagSpecs); plugins.canvas.addTemplates(templateSpecs); plugins.canvas.addTransformUIs(transformSpecs); - - return {}; } - public start(core: CoreStart, plugins: {}) { - return {}; - } + public start(core: CoreStart, plugins: StartDeps) {} } diff --git a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/embeddable.tsx b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/embeddable.tsx index 817be6e144fc8..a1096d50c1653 100644 --- a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/embeddable.tsx +++ b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/embeddable/embeddable.tsx @@ -7,7 +7,8 @@ import React from 'react'; import ReactDOM from 'react-dom'; import { I18nContext } from 'ui/i18n'; -import { npStart } from 'ui/new_platform'; +import { CoreStart } from '../../../../../../../src/core/public'; +import { StartDeps } from '../../plugin'; import { IEmbeddable, EmbeddableFactory, @@ -28,86 +29,88 @@ const embeddablesRegistry: { [key: string]: IEmbeddable; } = {}; -const renderEmbeddable = (embeddableObject: IEmbeddable, domNode: HTMLElement) => { - return ( - <div - className={CANVAS_EMBEDDABLE_CLASSNAME} - style={{ width: domNode.offsetWidth, height: domNode.offsetHeight, cursor: 'auto' }} - > - <I18nContext> - <EmbeddablePanel - embeddable={embeddableObject} - getActions={npStart.plugins.uiActions.getTriggerCompatibleActions} - getEmbeddableFactory={npStart.plugins.embeddable.getEmbeddableFactory} - getAllEmbeddableFactories={npStart.plugins.embeddable.getEmbeddableFactories} - notifications={npStart.core.notifications} - overlays={npStart.core.overlays} - inspector={npStart.plugins.inspector} - SavedObjectFinder={getSavedObjectFinder( - npStart.core.savedObjects, - npStart.core.uiSettings - )} - /> - </I18nContext> - </div> - ); +const renderEmbeddableFactory = (core: CoreStart, plugins: StartDeps) => { + return (embeddableObject: IEmbeddable, domNode: HTMLElement) => { + return ( + <div + className={CANVAS_EMBEDDABLE_CLASSNAME} + style={{ width: domNode.offsetWidth, height: domNode.offsetHeight, cursor: 'auto' }} + > + <I18nContext> + <EmbeddablePanel + embeddable={embeddableObject} + getActions={plugins.uiActions.getTriggerCompatibleActions} + getEmbeddableFactory={plugins.embeddable.getEmbeddableFactory} + getAllEmbeddableFactories={plugins.embeddable.getEmbeddableFactories} + notifications={core.notifications} + overlays={core.overlays} + inspector={plugins.inspector} + SavedObjectFinder={getSavedObjectFinder(core.savedObjects, core.uiSettings)} + /> + </I18nContext> + </div> + ); + }; }; -const embeddable = () => ({ - name: 'embeddable', - displayName: strings.getDisplayName(), - help: strings.getHelpDescription(), - reuseDomNode: true, - render: async ( - domNode: HTMLElement, - { input, embeddableType }: EmbeddableExpression<EmbeddableInput>, - handlers: RendererHandlers - ) => { - const uniqueId = handlers.getElementId(); - - if (!embeddablesRegistry[uniqueId]) { - const factory = Array.from(npStart.plugins.embeddable.getEmbeddableFactories()).find( - embeddableFactory => embeddableFactory.type === embeddableType - ) as EmbeddableFactory<EmbeddableInput>; - - if (!factory) { - handlers.done(); - throw new EmbeddableFactoryNotFoundError(embeddableType); - } - - const embeddableObject = await factory.createFromSavedObject(input.id, input); +export const embeddableRendererFactory = (core: CoreStart, plugins: StartDeps) => { + const renderEmbeddable = renderEmbeddableFactory(core, plugins); + return () => ({ + name: 'embeddable', + displayName: strings.getDisplayName(), + help: strings.getHelpDescription(), + reuseDomNode: true, + render: async ( + domNode: HTMLElement, + { input, embeddableType }: EmbeddableExpression<EmbeddableInput>, + handlers: RendererHandlers + ) => { + const uniqueId = handlers.getElementId(); + + if (!embeddablesRegistry[uniqueId]) { + const factory = Array.from(plugins.embeddable.getEmbeddableFactories()).find( + embeddableFactory => embeddableFactory.type === embeddableType + ) as EmbeddableFactory<EmbeddableInput>; + + if (!factory) { + handlers.done(); + throw new EmbeddableFactoryNotFoundError(embeddableType); + } - embeddablesRegistry[uniqueId] = embeddableObject; - ReactDOM.unmountComponentAtNode(domNode); + const embeddableObject = await factory.createFromSavedObject(input.id, input); - const subscription = embeddableObject.getInput$().subscribe(function(updatedInput) { - const updatedExpression = embeddableInputToExpression(updatedInput, embeddableType); + embeddablesRegistry[uniqueId] = embeddableObject; + ReactDOM.unmountComponentAtNode(domNode); - if (updatedExpression) { - handlers.onEmbeddableInputChange(updatedExpression); - } - }); + const subscription = embeddableObject.getInput$().subscribe(function(updatedInput) { + const updatedExpression = embeddableInputToExpression(updatedInput, embeddableType); - ReactDOM.render(renderEmbeddable(embeddableObject, domNode), domNode, () => handlers.done()); + if (updatedExpression) { + handlers.onEmbeddableInputChange(updatedExpression); + } + }); - handlers.onResize(() => { ReactDOM.render(renderEmbeddable(embeddableObject, domNode), domNode, () => handlers.done() ); - }); - handlers.onDestroy(() => { - subscription.unsubscribe(); - handlers.onEmbeddableDestroyed(); + handlers.onResize(() => { + ReactDOM.render(renderEmbeddable(embeddableObject, domNode), domNode, () => + handlers.done() + ); + }); - delete embeddablesRegistry[uniqueId]; + handlers.onDestroy(() => { + subscription.unsubscribe(); + handlers.onEmbeddableDestroyed(); - return ReactDOM.unmountComponentAtNode(domNode); - }); - } else { - embeddablesRegistry[uniqueId].updateInput(input); - } - }, -}); + delete embeddablesRegistry[uniqueId]; -export { embeddable }; + return ReactDOM.unmountComponentAtNode(domNode); + }); + } else { + embeddablesRegistry[uniqueId].updateInput(input); + } + }, + }); +}; diff --git a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/index.js b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/index.js index 48364be06e539..84f92f5149893 100644 --- a/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/index.js +++ b/x-pack/legacy/plugins/canvas/canvas_plugin_src/renderers/index.js @@ -7,7 +7,7 @@ import { advancedFilter } from './advanced_filter'; import { debug } from './debug'; import { dropdownFilter } from './dropdown_filter'; -import { embeddable } from './embeddable/embeddable'; +import { embeddableRendererFactory } from './embeddable/embeddable'; import { error } from './error'; import { image } from './image'; import { markdown } from './markdown'; @@ -26,7 +26,6 @@ export const renderFunctions = [ advancedFilter, debug, dropdownFilter, - embeddable, error, image, markdown, @@ -41,3 +40,5 @@ export const renderFunctions = [ text, timeFilter, ]; + +export const renderFunctionFactories = [embeddableRendererFactory]; diff --git a/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/flyout.tsx b/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/flyout.tsx index 08cd3084c35cf..4916a27fcbe60 100644 --- a/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/flyout.tsx +++ b/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/flyout.tsx @@ -5,7 +5,6 @@ */ import React from 'react'; -import { npStart } from 'ui/new_platform'; import { EuiFlyout, EuiFlyoutHeader, EuiFlyoutBody, EuiTitle } from '@elastic/eui'; import { SavedObjectFinderUi, @@ -13,6 +12,7 @@ import { } from '../../../../../../../src/plugins/saved_objects/public/'; import { ComponentStrings } from '../../../i18n'; import { CoreStart } from '../../../../../../../src/core/public'; +import { CanvasStartDeps } from '../../plugin'; const { AddEmbeddableFlyout: strings } = ComponentStrings; @@ -22,11 +22,12 @@ export interface Props { availableEmbeddables: string[]; savedObjects: CoreStart['savedObjects']; uiSettings: CoreStart['uiSettings']; + getEmbeddableFactories: CanvasStartDeps['embeddable']['getEmbeddableFactories']; } export class AddEmbeddableFlyout extends React.Component<Props> { onAddPanel = (id: string, savedObjectType: string, name: string) => { - const embeddableFactories = npStart.plugins.embeddable.getEmbeddableFactories(); + const embeddableFactories = this.props.getEmbeddableFactories(); // Find the embeddable type from the saved object type const found = Array.from(embeddableFactories).find(embeddableFactory => { @@ -42,7 +43,7 @@ export class AddEmbeddableFlyout extends React.Component<Props> { }; render() { - const embeddableFactories = npStart.plugins.embeddable.getEmbeddableFactories(); + const embeddableFactories = this.props.getEmbeddableFactories(); const availableSavedObjects = Array.from(embeddableFactories) .filter(factory => { diff --git a/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/index.tsx b/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/index.tsx index a86784d374f49..c13cbfd042237 100644 --- a/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/index.tsx +++ b/x-pack/legacy/plugins/canvas/public/components/embeddable_flyout/index.tsx @@ -105,6 +105,7 @@ export class EmbeddableFlyoutPortal extends React.Component<Props & WithKibanaPr availableEmbeddables={Object.keys(allowedEmbeddables)} savedObjects={this.props.kibana.services.savedObjects} uiSettings={this.props.kibana.services.uiSettings} + getEmbeddableFactories={this.props.kibana.services.embeddable.getEmbeddableFactories} />, this.el ); diff --git a/x-pack/legacy/plugins/canvas/public/legacy.ts b/x-pack/legacy/plugins/canvas/public/legacy.ts index a6caa1985325e..4af7c9b2bd057 100644 --- a/x-pack/legacy/plugins/canvas/public/legacy.ts +++ b/x-pack/legacy/plugins/canvas/public/legacy.ts @@ -26,7 +26,9 @@ const shimSetupPlugins: CanvasSetupDeps = { }; const shimStartPlugins: CanvasStartDeps = { ...npStart.plugins, + embeddable: npStart.plugins.embeddable, expressions: npStart.plugins.expressions, + inspector: npStart.plugins.inspector, uiActions: npStart.plugins.uiActions, __LEGACY: { // ToDo: Copy directly into canvas diff --git a/x-pack/legacy/plugins/canvas/public/plugin.tsx b/x-pack/legacy/plugins/canvas/public/plugin.tsx index d9e5e6b4b084b..3ea3ce625ca71 100644 --- a/x-pack/legacy/plugins/canvas/public/plugin.tsx +++ b/x-pack/legacy/plugins/canvas/public/plugin.tsx @@ -11,6 +11,8 @@ import { initLoadingIndicator } from './lib/loading_indicator'; import { featureCatalogueEntry } from './feature_catalogue_entry'; import { ExpressionsSetup, ExpressionsStart } from '../../../../../src/plugins/expressions/public'; import { UiActionsStart } from '../../../../../src/plugins/ui_actions/public'; +import { EmbeddableStart } from '../../../../../src/plugins/embeddable/public'; +import { Start as InspectorStart } from '../../../../../src/plugins/inspector/public'; // @ts-ignore untyped local import { argTypeSpecs } from './expression_types/arg_types'; import { transitions } from './transitions'; @@ -31,7 +33,9 @@ export interface CanvasSetupDeps { } export interface CanvasStartDeps { + embeddable: EmbeddableStart; expressions: ExpressionsStart; + inspector: InspectorStart; uiActions: UiActionsStart; __LEGACY: { absoluteToParsedUrl: (url: string, basePath: string) => any; @@ -48,14 +52,19 @@ export interface CanvasStartDeps { // These interfaces are empty for now but will be populate as we need to export // things for other plugins to use at startup or runtime export type CanvasSetup = CanvasApi; -export interface CanvasStart {} // eslint-disable-line @typescript-eslint/no-empty-interface +export type CanvasStart = void; /** @internal */ export class CanvasPlugin implements Plugin<CanvasSetup, CanvasStart, CanvasSetupDeps, CanvasStartDeps> { + // TODO: Do we want to completely move canvas_plugin_src into it's own plugin? + private srcPlugin = new CanvasSrcPlugin(); + public setup(core: CoreSetup<CanvasStartDeps>, plugins: CanvasSetupDeps) { const { api: canvasApi, registries } = getPluginApi(plugins.expressions); + this.srcPlugin.setup(core, { canvas: canvasApi }); + core.application.register({ id: 'canvas', title: 'Canvas App', @@ -84,10 +93,6 @@ export class CanvasPlugin canvasApi.addElements(legacyRegistries.elements.getOriginalFns()); canvasApi.addTypes(legacyRegistries.types.getOriginalFns()); - // TODO: Do we want to completely move canvas_plugin_src into it's own plugin? - const srcPlugin = new CanvasSrcPlugin(); - srcPlugin.setup(core, { canvas: canvasApi }); - // Register core canvas stuff canvasApi.addFunctions(initFunctions({ typesRegistry: plugins.expressions.__LEGACY.types })); canvasApi.addArgumentUIs(argTypeSpecs); @@ -99,8 +104,7 @@ export class CanvasPlugin } public start(core: CoreStart, plugins: CanvasStartDeps) { + this.srcPlugin.start(core, plugins); initLoadingIndicator(core.http.addLoadingCountSource); - - return {}; } } From 301b795db6b988adb5875ef4a9d96fdb20c66ed5 Mon Sep 17 00:00:00 2001 From: Nathan Reese <reese.nathan@gmail.com> Date: Mon, 13 Apr 2020 13:30:18 -0600 Subject: [PATCH 068/102] [Maps] update geospatial filters to use geo_shape query for geo_point fields (#62966) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../map/mb/draw_control/draw_control.js | 19 ++-- .../maps/public/elasticsearch_geo_utils.js | 99 ++++++------------- 2 files changed, 34 insertions(+), 84 deletions(-) diff --git a/x-pack/legacy/plugins/maps/public/connected_components/map/mb/draw_control/draw_control.js b/x-pack/legacy/plugins/maps/public/connected_components/map/mb/draw_control/draw_control.js index df2988d399c5b..cc0e665525036 100644 --- a/x-pack/legacy/plugins/maps/public/connected_components/map/mb/draw_control/draw_control.js +++ b/x-pack/legacy/plugins/maps/public/connected_components/map/mb/draw_control/draw_control.js @@ -12,7 +12,6 @@ import DrawRectangle from 'mapbox-gl-draw-rectangle-mode'; import { DrawCircle } from './draw_circle'; import { createDistanceFilterWithMeta, - createSpatialFilterWithBoundingBox, createSpatialFilterWithGeometry, getBoundingBoxGeometry, roundCoordinates, @@ -84,23 +83,17 @@ export class DrawControl extends React.Component { roundCoordinates(geometry.coordinates); try { - const options = { + const filter = createSpatialFilterWithGeometry({ + geometry: + this.props.drawState.drawType === DRAW_TYPE.BOUNDS + ? getBoundingBoxGeometry(geometry) + : geometry, indexPatternId: this.props.drawState.indexPatternId, geoFieldName: this.props.drawState.geoFieldName, geoFieldType: this.props.drawState.geoFieldType, geometryLabel: this.props.drawState.geometryLabel, relation: this.props.drawState.relation, - }; - const filter = - this.props.drawState.drawType === DRAW_TYPE.BOUNDS - ? createSpatialFilterWithBoundingBox({ - ...options, - geometry: getBoundingBoxGeometry(geometry), - }) - : createSpatialFilterWithGeometry({ - ...options, - geometry, - }); + }); this.props.addFilters([filter]); } catch (error) { // TODO notify user why filter was not created diff --git a/x-pack/plugins/maps/public/elasticsearch_geo_utils.js b/x-pack/plugins/maps/public/elasticsearch_geo_utils.js index 79467e26ec3fa..617cf537fd5c3 100644 --- a/x-pack/plugins/maps/public/elasticsearch_geo_utils.js +++ b/x-pack/plugins/maps/public/elasticsearch_geo_utils.js @@ -231,28 +231,16 @@ function createGeoBoundBoxFilter(geometry, geoFieldName, filterProps = {}) { }; } -function createGeoPolygonFilter(polygonCoordinates, geoFieldName, filterProps = {}) { - return { - geo_polygon: { - ignore_unmapped: true, - [geoFieldName]: { - points: polygonCoordinates[POLYGON_COORDINATES_EXTERIOR_INDEX].map(coordinatePair => { - return { - lon: coordinatePair[LON_INDEX], - lat: coordinatePair[LAT_INDEX], - }; - }), - }, - }, - ...filterProps, - }; -} - export function createExtentFilter(mapExtent, geoFieldName, geoFieldType) { ensureGeoField(geoFieldType); const safePolygon = convertMapExtentToPolygon(mapExtent); + // Extent filters are used to dynamically filter data for the current map view port. + // Continue to use geo_bounding_box queries for extent filters + // 1) geo_bounding_box queries are faster than polygon queries + // 2) geo_shape benefits of pre-indexed shapes and + // compatability across multi-indices with geo_point and geo_shape do not apply to this use case. if (geoFieldType === ES_GEO_FIELD_TYPE.GEO_POINT) { return createGeoBoundBoxFilter(safePolygon, geoFieldName); } @@ -267,15 +255,7 @@ export function createExtentFilter(mapExtent, geoFieldName, geoFieldType) { }; } -export function createSpatialFilterWithBoundingBox(options) { - return createGeometryFilterWithMeta({ ...options, isBoundingBox: true }); -} - -export function createSpatialFilterWithGeometry(options) { - return createGeometryFilterWithMeta(options); -} - -function createGeometryFilterWithMeta({ +export function createSpatialFilterWithGeometry({ preIndexedShape, geometry, geometryLabel, @@ -283,16 +263,16 @@ function createGeometryFilterWithMeta({ geoFieldName, geoFieldType, relation = ES_SPATIAL_RELATIONS.INTERSECTS, - isBoundingBox = false, }) { ensureGeoField(geoFieldType); - const relationLabel = - geoFieldType === ES_GEO_FIELD_TYPE.GEO_POINT - ? i18n.translate('xpack.maps.es_geo_utils.shapeFilter.geoPointRelationLabel', { - defaultMessage: 'in', - }) - : getEsSpatialRelationLabel(relation); + const isGeoPoint = geoFieldType === ES_GEO_FIELD_TYPE.GEO_POINT; + + const relationLabel = isGeoPoint + ? i18n.translate('xpack.maps.es_geo_utils.shapeFilter.geoPointRelationLabel', { + defaultMessage: 'in', + }) + : getEsSpatialRelationLabel(relation); const meta = { type: SPATIAL_FILTER_TYPE, negate: false, @@ -301,47 +281,24 @@ function createGeometryFilterWithMeta({ alias: `${geoFieldName} ${relationLabel} ${geometryLabel}`, }; - if (geoFieldType === ES_GEO_FIELD_TYPE.GEO_SHAPE) { - const shapeQuery = { - relation, - }; - - if (preIndexedShape) { - shapeQuery.indexed_shape = preIndexedShape; - } else { - shapeQuery.shape = geometry; - } - - return { - meta, - geo_shape: { - ignore_unmapped: true, - [geoFieldName]: shapeQuery, - }, - }; - } - - // geo_points supports limited geometry types - ensureGeometryType(geometry.type, [GEO_JSON_TYPE.POLYGON, GEO_JSON_TYPE.MULTI_POLYGON]); - - if (geometry.type === GEO_JSON_TYPE.MULTI_POLYGON) { - return { - meta, - query: { - bool: { - should: geometry.coordinates.map(polygonCoordinates => { - return createGeoPolygonFilter(polygonCoordinates, geoFieldName); - }), - }, - }, - }; - } + const shapeQuery = { + // geo_shape query with geo_point field only supports intersects relation + relation: isGeoPoint ? ES_SPATIAL_RELATIONS.INTERSECTS : relation, + }; - if (isBoundingBox) { - return createGeoBoundBoxFilter(geometry, geoFieldName, { meta }); + if (preIndexedShape) { + shapeQuery.indexed_shape = preIndexedShape; + } else { + shapeQuery.shape = geometry; } - return createGeoPolygonFilter(geometry.coordinates, geoFieldName, { meta }); + return { + meta, + geo_shape: { + ignore_unmapped: true, + [geoFieldName]: shapeQuery, + }, + }; } export function createDistanceFilterWithMeta({ From a6ecd4c2783c81090072936c142faf6a0dc1bfe0 Mon Sep 17 00:00:00 2001 From: Thomas Neirynck <thomas@elastic.co> Date: Mon, 13 Apr 2020 15:33:43 -0400 Subject: [PATCH 069/102] [Maps] Add SOURCE_TYPES enumeration (#62975) --- .../ems_raster_tile_to_ems_vector_tile.js | 4 ++-- .../migrations/move_apply_global_query.js | 6 +++-- .../maps/common/migrations/references.js | 8 +++++-- .../maps/common/migrations/references.test.js | 14 +++++------ .../maps/common/migrations/scaling_type.ts | 4 ++-- .../migrations/top_hits_time_to_sort.js | 4 ++-- .../server/maps_telemetry/maps_telemetry.ts | 4 ++-- .../components/embeddables/map_config.ts | 5 ++-- x-pack/plugins/maps/common/constants.ts | 23 ++++++++++--------- .../public/layers/blended_vector_layer.ts | 8 +++++-- .../client_file_source/geojson_file_source.js | 6 ++--- .../ems_file_source/ems_file_source.js | 6 ++--- .../sources/ems_tms_source/ems_tms_source.js | 6 ++--- .../es_geo_grid_source/es_geo_grid_source.js | 8 +++---- .../es_geo_grid_source.test.ts | 4 ++-- .../es_pew_pew_source/es_pew_pew_source.js | 6 ++--- .../es_search_source/es_search_source.js | 8 +++---- .../es_search_source/es_search_source.test.ts | 4 ++-- .../kibana_regionmap_source.js | 6 ++--- .../kibana_tilemap_source.js | 6 ++--- .../layers/sources/wms_source/wms_source.js | 6 ++--- .../xyz_tms_source/xyz_tms_source.test.ts | 4 ++-- .../sources/xyz_tms_source/xyz_tms_source.ts | 6 ++--- .../maps/public/layers/tile_layer.test.ts | 4 ++-- 24 files changed, 86 insertions(+), 74 deletions(-) diff --git a/x-pack/legacy/plugins/maps/common/migrations/ems_raster_tile_to_ems_vector_tile.js b/x-pack/legacy/plugins/maps/common/migrations/ems_raster_tile_to_ems_vector_tile.js index 94f4018bbdbb7..091cfd8605cb6 100644 --- a/x-pack/legacy/plugins/maps/common/migrations/ems_raster_tile_to_ems_vector_tile.js +++ b/x-pack/legacy/plugins/maps/common/migrations/ems_raster_tile_to_ems_vector_tile.js @@ -5,11 +5,11 @@ */ import _ from 'lodash'; -import { EMS_TMS, LAYER_TYPE } from '../constants'; +import { SOURCE_TYPES, LAYER_TYPE } from '../constants'; function isEmsTileSource(layerDescriptor) { const sourceType = _.get(layerDescriptor, 'sourceDescriptor.type'); - return sourceType === EMS_TMS; + return sourceType === SOURCE_TYPES.EMS_TMS; } function isTileLayer(layerDescriptor) { diff --git a/x-pack/legacy/plugins/maps/common/migrations/move_apply_global_query.js b/x-pack/legacy/plugins/maps/common/migrations/move_apply_global_query.js index 490e760d8c003..0d6b0052d2b0d 100644 --- a/x-pack/legacy/plugins/maps/common/migrations/move_apply_global_query.js +++ b/x-pack/legacy/plugins/maps/common/migrations/move_apply_global_query.js @@ -5,11 +5,13 @@ */ import _ from 'lodash'; -import { ES_GEO_GRID, ES_PEW_PEW, ES_SEARCH } from '../constants'; +import { SOURCE_TYPES } from '../constants'; function isEsSource(layerDescriptor) { const sourceType = _.get(layerDescriptor, 'sourceDescriptor.type'); - return [ES_GEO_GRID, ES_PEW_PEW, ES_SEARCH].includes(sourceType); + return [SOURCE_TYPES.ES_GEO_GRID, SOURCE_TYPES.ES_PEW_PEW, SOURCE_TYPES.ES_SEARCH].includes( + sourceType + ); } // Migration to move applyGlobalQuery from layer to sources. diff --git a/x-pack/legacy/plugins/maps/common/migrations/references.js b/x-pack/legacy/plugins/maps/common/migrations/references.js index a96af700da37c..3980705fd7cfa 100644 --- a/x-pack/legacy/plugins/maps/common/migrations/references.js +++ b/x-pack/legacy/plugins/maps/common/migrations/references.js @@ -7,11 +7,15 @@ // Can not use public Layer classes to extract references since this logic must run in both client and server. import _ from 'lodash'; -import { ES_GEO_GRID, ES_SEARCH, ES_PEW_PEW } from '../constants'; +import { SOURCE_TYPES } from '../constants'; function doesSourceUseIndexPattern(layerDescriptor) { const sourceType = _.get(layerDescriptor, 'sourceDescriptor.type'); - return sourceType === ES_GEO_GRID || sourceType === ES_SEARCH || sourceType === ES_PEW_PEW; + return ( + sourceType === SOURCE_TYPES.ES_GEO_GRID || + sourceType === SOURCE_TYPES.ES_SEARCH || + sourceType === SOURCE_TYPES.ES_PEW_PEW + ); } export function extractReferences({ attributes, references = [] }) { diff --git a/x-pack/legacy/plugins/maps/common/migrations/references.test.js b/x-pack/legacy/plugins/maps/common/migrations/references.test.js index 40f6fd72a48d7..50a45c81339dc 100644 --- a/x-pack/legacy/plugins/maps/common/migrations/references.test.js +++ b/x-pack/legacy/plugins/maps/common/migrations/references.test.js @@ -5,16 +5,16 @@ */ import { extractReferences, injectReferences } from './references'; -import { ES_GEO_GRID, ES_SEARCH, ES_PEW_PEW } from '../constants'; +import { SOURCE_TYPES } from '../constants'; const layerListJSON = { esSearchSource: { - withIndexPatternId: `[{\"sourceDescriptor\":{\"type\":\"${ES_SEARCH}\",\"indexPatternId\":\"c698b940-e149-11e8-a35a-370a8516603a\"}}]`, - withIndexPatternRef: `[{\"sourceDescriptor\":{\"type\":\"${ES_SEARCH}\",\"indexPatternRefName\":\"layer_0_source_index_pattern\"}}]`, + withIndexPatternId: `[{\"sourceDescriptor\":{\"type\":\"${SOURCE_TYPES.ES_SEARCH}\",\"indexPatternId\":\"c698b940-e149-11e8-a35a-370a8516603a\"}}]`, + withIndexPatternRef: `[{\"sourceDescriptor\":{\"type\":\"${SOURCE_TYPES.ES_SEARCH}\",\"indexPatternRefName\":\"layer_0_source_index_pattern\"}}]`, }, esGeoGridSource: { - withIndexPatternId: `[{\"sourceDescriptor\":{\"type\":\"${ES_GEO_GRID}\",\"indexPatternId\":\"c698b940-e149-11e8-a35a-370a8516603a\"}}]`, - withIndexPatternRef: `[{\"sourceDescriptor\":{\"type\":\"${ES_GEO_GRID}\",\"indexPatternRefName\":\"layer_0_source_index_pattern\"}}]`, + withIndexPatternId: `[{\"sourceDescriptor\":{\"type\":\"${SOURCE_TYPES.ES_GEO_GRID}\",\"indexPatternId\":\"c698b940-e149-11e8-a35a-370a8516603a\"}}]`, + withIndexPatternRef: `[{\"sourceDescriptor\":{\"type\":\"${SOURCE_TYPES.ES_GEO_GRID}\",\"indexPatternRefName\":\"layer_0_source_index_pattern\"}}]`, }, join: { withIndexPatternId: @@ -23,8 +23,8 @@ const layerListJSON = { '[{"joins":[{"right":{"indexPatternRefName":"layer_0_join_0_index_pattern"}}]}]', }, pewPewSource: { - withIndexPatternId: `[{\"sourceDescriptor\":{\"type\":\"${ES_PEW_PEW}\",\"indexPatternId\":\"c698b940-e149-11e8-a35a-370a8516603a\"}}]`, - withIndexPatternRef: `[{\"sourceDescriptor\":{\"type\":\"${ES_PEW_PEW}\",\"indexPatternRefName\":\"layer_0_source_index_pattern\"}}]`, + withIndexPatternId: `[{\"sourceDescriptor\":{\"type\":\"${SOURCE_TYPES.ES_PEW_PEW}\",\"indexPatternId\":\"c698b940-e149-11e8-a35a-370a8516603a\"}}]`, + withIndexPatternRef: `[{\"sourceDescriptor\":{\"type\":\"${SOURCE_TYPES.ES_PEW_PEW}\",\"indexPatternRefName\":\"layer_0_source_index_pattern\"}}]`, }, }; diff --git a/x-pack/legacy/plugins/maps/common/migrations/scaling_type.ts b/x-pack/legacy/plugins/maps/common/migrations/scaling_type.ts index 5823ddd6b42e3..551975fbacea5 100644 --- a/x-pack/legacy/plugins/maps/common/migrations/scaling_type.ts +++ b/x-pack/legacy/plugins/maps/common/migrations/scaling_type.ts @@ -5,13 +5,13 @@ */ import _ from 'lodash'; -import { ES_SEARCH, SCALING_TYPES } from '../constants'; +import { SOURCE_TYPES, SCALING_TYPES } from '../constants'; import { LayerDescriptor, ESSearchSourceDescriptor } from '../descriptor_types'; import { MapSavedObjectAttributes } from '../../../../../plugins/maps/common/map_saved_object_type'; function isEsDocumentSource(layerDescriptor: LayerDescriptor) { const sourceType = _.get(layerDescriptor, 'sourceDescriptor.type'); - return sourceType === ES_SEARCH; + return sourceType === SOURCE_TYPES.ES_SEARCH; } export function migrateUseTopHitsToScalingType({ diff --git a/x-pack/legacy/plugins/maps/common/migrations/top_hits_time_to_sort.js b/x-pack/legacy/plugins/maps/common/migrations/top_hits_time_to_sort.js index 7392dfa71bf3a..055c867486f6c 100644 --- a/x-pack/legacy/plugins/maps/common/migrations/top_hits_time_to_sort.js +++ b/x-pack/legacy/plugins/maps/common/migrations/top_hits_time_to_sort.js @@ -5,11 +5,11 @@ */ import _ from 'lodash'; -import { ES_SEARCH, SORT_ORDER } from '../constants'; +import { SOURCE_TYPES, SORT_ORDER } from '../constants'; function isEsDocumentSource(layerDescriptor) { const sourceType = _.get(layerDescriptor, 'sourceDescriptor.type'); - return sourceType === ES_SEARCH; + return sourceType === SOURCE_TYPES.ES_SEARCH; } export function topHitsTimeToSort({ attributes }) { diff --git a/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts b/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts index 0300f22eeeb82..27c0211446e85 100644 --- a/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts +++ b/x-pack/legacy/plugins/maps/server/maps_telemetry/maps_telemetry.ts @@ -12,7 +12,7 @@ import { } from 'src/core/server'; import { IFieldType, IIndexPattern } from 'src/plugins/data/public'; import { - EMS_FILE, + SOURCE_TYPES, ES_GEO_FIELD_TYPE, MAP_SAVED_OBJECT_TYPE, TELEMETRY_TYPE, @@ -100,7 +100,7 @@ export function buildMapsTelemetry({ const emsLayersCount = layerLists.map(lList => _(lList) .countBy((layer: LayerDescriptor) => { - const isEmsFile = _.get(layer, 'sourceDescriptor.type') === EMS_FILE; + const isEmsFile = _.get(layer, 'sourceDescriptor.type') === SOURCE_TYPES.EMS_FILE; return isEmsFile && _.get(layer, 'sourceDescriptor.id'); }) .pick((val, key) => key !== 'false') diff --git a/x-pack/legacy/plugins/siem/public/components/embeddables/map_config.ts b/x-pack/legacy/plugins/siem/public/components/embeddables/map_config.ts index e8b267122f86f..8c96e0b75a136 100644 --- a/x-pack/legacy/plugins/siem/public/components/embeddables/map_config.ts +++ b/x-pack/legacy/plugins/siem/public/components/embeddables/map_config.ts @@ -13,6 +13,7 @@ import { LayerMappingDetails, } from './types'; import * as i18n from './translations'; +import { SOURCE_TYPES } from '../../../../../../plugins/maps/common/constants'; const euiVisColorPalette = euiPaletteColorBlind(); // Update field mappings to modify what fields will be returned to map tooltip @@ -101,7 +102,7 @@ export const lmc: LayerMappingCollection = { export const getLayerList = (indexPatternIds: IndexPatternMapping[]) => { return [ { - sourceDescriptor: { type: 'EMS_TMS', isAutoSelect: true }, + sourceDescriptor: { type: SOURCE_TYPES.EMS_TMS, isAutoSelect: true }, id: uuid.v4(), label: null, minZoom: 0, @@ -260,7 +261,7 @@ export const getLineLayer = ( layerDetails: LayerMapping ) => ({ sourceDescriptor: { - type: 'ES_PEW_PEW', + type: SOURCE_TYPES.ES_PEW_PEW, applyGlobalQuery: true, id: uuid.v4(), indexPatternId, diff --git a/x-pack/plugins/maps/common/constants.ts b/x-pack/plugins/maps/common/constants.ts index f3997f741a1bf..1468bf7fdc1f2 100644 --- a/x-pack/plugins/maps/common/constants.ts +++ b/x-pack/plugins/maps/common/constants.ts @@ -56,15 +56,18 @@ export enum SORT_ORDER { DESC = 'desc', } -export const EMS_TMS = 'EMS_TMS'; -export const EMS_FILE = 'EMS_FILE'; -export const ES_GEO_GRID = 'ES_GEO_GRID'; -export const ES_SEARCH = 'ES_SEARCH'; -export const ES_PEW_PEW = 'ES_PEW_PEW'; -export const EMS_XYZ = 'EMS_XYZ'; // identifies a custom TMS source. Name is a little unfortunate. -export const WMS = 'WMS'; -export const KIBANA_TILEMAP = 'KIBANA_TILEMAP'; -export const REGIONMAP_FILE = 'REGIONMAP_FILE'; +export enum SOURCE_TYPES { + EMS_TMS = 'EMS_TMS', + EMS_FILE = 'EMS_FILE', + ES_GEO_GRID = 'ES_GEO_GRID', + ES_SEARCH = 'ES_SEARCH', + ES_PEW_PEW = 'ES_PEW_PEW', + EMS_XYZ = 'EMS_XYZ', // identifies a custom TMS source. Name is a little unfortunate. + WMS = 'WMS', + KIBANA_TILEMAP = 'KIBANA_TILEMAP', + REGIONMAP_FILE = 'REGIONMAP_FILE', + GEOJSON_FILE = 'GEOJSON_FILE', +} export enum FIELD_ORIGIN { SOURCE = 'source', @@ -77,8 +80,6 @@ export const SOURCE_META_ID_ORIGIN = `${SOURCE_DATA_ID_ORIGIN}_${META_ID_ORIGIN_ export const FORMATTERS_ID_ORIGIN_SUFFIX = 'formatters'; export const SOURCE_FORMATTERS_ID_ORIGIN = `${SOURCE_DATA_ID_ORIGIN}_${FORMATTERS_ID_ORIGIN_SUFFIX}`; -export const GEOJSON_FILE = 'GEOJSON_FILE'; - export const MIN_ZOOM = 0; export const MAX_ZOOM = 24; diff --git a/x-pack/plugins/maps/public/layers/blended_vector_layer.ts b/x-pack/plugins/maps/public/layers/blended_vector_layer.ts index 80bf0299380d9..9a9ea2968ceeb 100644 --- a/x-pack/plugins/maps/public/layers/blended_vector_layer.ts +++ b/x-pack/plugins/maps/public/layers/blended_vector_layer.ts @@ -11,9 +11,9 @@ import { getDefaultDynamicProperties } from './styles/vector/vector_style_defaul import { IDynamicStyleProperty } from './styles/vector/properties/dynamic_style_property'; import { IStyleProperty } from './styles/vector/properties/style_property'; import { + SOURCE_TYPES, COUNT_PROP_LABEL, COUNT_PROP_NAME, - ES_GEO_GRID, LAYER_TYPE, AGG_TYPE, RENDER_AS, @@ -180,7 +180,11 @@ export class BlendedVectorLayer extends VectorLayer implements IVectorLayer { const sourceDataRequest = this.getSourceDataRequest(); if (sourceDataRequest) { const requestMeta = sourceDataRequest.getMeta(); - if (requestMeta && requestMeta.sourceType && requestMeta.sourceType === ES_GEO_GRID) { + if ( + requestMeta && + requestMeta.sourceType && + requestMeta.sourceType === SOURCE_TYPES.ES_GEO_GRID + ) { isClustered = true; } } diff --git a/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js b/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js index df11fe9f32770..137513ad7c612 100644 --- a/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js +++ b/x-pack/plugins/maps/public/layers/sources/client_file_source/geojson_file_source.js @@ -8,7 +8,7 @@ import { AbstractVectorSource } from '../vector_source'; import React from 'react'; import { ES_GEO_FIELD_TYPE, - GEOJSON_FILE, + SOURCE_TYPES, DEFAULT_MAX_RESULT_WINDOW, SCALING_TYPES, } from '../../../../common/constants'; @@ -19,7 +19,7 @@ import { i18n } from '@kbn/i18n'; import { registerSource } from '../source_registry'; export class GeojsonFileSource extends AbstractVectorSource { - static type = GEOJSON_FILE; + static type = SOURCE_TYPES.GEOJSON_FILE; static isIndexingSource = true; @@ -130,7 +130,7 @@ const previewGeojsonFile = (onPreviewSource, inspectorAdapters) => { registerSource({ ConstructorFunction: GeojsonFileSource, - type: GEOJSON_FILE, + type: SOURCE_TYPES.GEOJSON_FILE, }); export const uploadLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/ems_file_source/ems_file_source.js b/x-pack/plugins/maps/public/layers/sources/ems_file_source/ems_file_source.js index d3ccc0cb55821..e8af17b911939 100644 --- a/x-pack/plugins/maps/public/layers/sources/ems_file_source/ems_file_source.js +++ b/x-pack/plugins/maps/public/layers/sources/ems_file_source/ems_file_source.js @@ -7,7 +7,7 @@ import { AbstractVectorSource } from '../vector_source'; import { VECTOR_SHAPE_TYPES } from '../vector_feature_types'; import React from 'react'; -import { EMS_FILE, FIELD_ORIGIN } from '../../../../common/constants'; +import { SOURCE_TYPES, FIELD_ORIGIN } from '../../../../common/constants'; import { getEMSClient } from '../../../meta'; import { EMSFileCreateSourceEditor } from './create_source_editor'; import { i18n } from '@kbn/i18n'; @@ -21,7 +21,7 @@ const sourceTitle = i18n.translate('xpack.maps.source.emsFileTitle', { }); export class EMSFileSource extends AbstractVectorSource { - static type = EMS_FILE; + static type = SOURCE_TYPES.EMS_FILE; static createDescriptor({ id, tooltipProperties = [] }) { return { @@ -159,7 +159,7 @@ export class EMSFileSource extends AbstractVectorSource { registerSource({ ConstructorFunction: EMSFileSource, - type: EMS_FILE, + type: SOURCE_TYPES.EMS_FILE, }); export const emsBoundariesLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/ems_tms_source/ems_tms_source.js b/x-pack/plugins/maps/public/layers/sources/ems_tms_source/ems_tms_source.js index 1da3680dfdc86..79121c4cdb31f 100644 --- a/x-pack/plugins/maps/public/layers/sources/ems_tms_source/ems_tms_source.js +++ b/x-pack/plugins/maps/public/layers/sources/ems_tms_source/ems_tms_source.js @@ -14,7 +14,7 @@ import { TileServiceSelect } from './tile_service_select'; import { UpdateSourceEditor } from './update_source_editor'; import { i18n } from '@kbn/i18n'; import { getDataSourceLabel } from '../../../../common/i18n_getters'; -import { EMS_TMS } from '../../../../common/constants'; +import { SOURCE_TYPES } from '../../../../common/constants'; import { getInjectedVarFunc, getUiSettings } from '../../../kibana_services'; import { registerSource } from '../source_registry'; @@ -23,7 +23,7 @@ const sourceTitle = i18n.translate('xpack.maps.source.emsTileTitle', { }); export class EMSTMSSource extends AbstractTMSSource { - static type = EMS_TMS; + static type = SOURCE_TYPES.EMS_TMS; static createDescriptor(sourceConfig) { return { @@ -148,7 +148,7 @@ export class EMSTMSSource extends AbstractTMSSource { registerSource({ ConstructorFunction: EMSTMSSource, - type: EMS_TMS, + type: SOURCE_TYPES.EMS_TMS, }); export const emsBaseMapLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.js b/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.js index 04f944396ab35..b9ef13e520bf8 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.js +++ b/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.js @@ -17,8 +17,8 @@ import { COLOR_GRADIENTS } from '../../styles/color_utils'; import { CreateSourceEditor } from './create_source_editor'; import { UpdateSourceEditor } from './update_source_editor'; import { + SOURCE_TYPES, DEFAULT_MAX_BUCKETS_LIMIT, - ES_GEO_GRID, COUNT_PROP_NAME, COLOR_MAP_TYPE, RENDER_AS, @@ -45,7 +45,7 @@ const heatmapTitle = i18n.translate('xpack.maps.source.esGridHeatmapTitle', { }); export class ESGeoGridSource extends AbstractESAggSource { - static type = ES_GEO_GRID; + static type = SOURCE_TYPES.ES_GEO_GRID; static createDescriptor({ indexPatternId, geoField, requestType, resolution }) { return { @@ -311,7 +311,7 @@ export class ESGeoGridSource extends AbstractESAggSource { }, meta: { areResultsTrimmed: false, - sourceType: ES_GEO_GRID, + sourceType: SOURCE_TYPES.ES_GEO_GRID, }, }; } @@ -420,7 +420,7 @@ export class ESGeoGridSource extends AbstractESAggSource { registerSource({ ConstructorFunction: ESGeoGridSource, - type: ES_GEO_GRID, + type: SOURCE_TYPES.ES_GEO_GRID, }); export const clustersLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.test.ts b/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.test.ts index 727435c3cbfef..e35bb998ce7db 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.test.ts +++ b/x-pack/plugins/maps/public/layers/sources/es_geo_grid_source/es_geo_grid_source.test.ts @@ -7,7 +7,7 @@ jest.mock('../../../kibana_services', () => {}); jest.mock('ui/new_platform'); import { ESGeoGridSource } from './es_geo_grid_source'; -import { ES_GEO_GRID, GRID_RESOLUTION, RENDER_AS } from '../../../../common/constants'; +import { GRID_RESOLUTION, RENDER_AS, SOURCE_TYPES } from '../../../../common/constants'; describe('ESGeoGridSource', () => { const geogridSource = new ESGeoGridSource( @@ -17,7 +17,7 @@ describe('ESGeoGridSource', () => { geoField: 'bar', metrics: [], resolution: GRID_RESOLUTION.COARSE, - type: ES_GEO_GRID, + type: SOURCE_TYPES.ES_GEO_GRID, requestType: RENDER_AS.HEATMAP, }, {} diff --git a/x-pack/plugins/maps/public/layers/sources/es_pew_pew_source/es_pew_pew_source.js b/x-pack/plugins/maps/public/layers/sources/es_pew_pew_source/es_pew_pew_source.js index ea3a2d2fe634d..57e5afb99404b 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_pew_pew_source/es_pew_pew_source.js +++ b/x-pack/plugins/maps/public/layers/sources/es_pew_pew_source/es_pew_pew_source.js @@ -16,7 +16,7 @@ import { getDefaultDynamicProperties } from '../../styles/vector/vector_style_de import { i18n } from '@kbn/i18n'; import { FIELD_ORIGIN, - ES_PEW_PEW, + SOURCE_TYPES, COUNT_PROP_NAME, VECTOR_STYLES, } from '../../../../common/constants'; @@ -35,7 +35,7 @@ const sourceTitle = i18n.translate('xpack.maps.source.pewPewTitle', { }); export class ESPewPewSource extends AbstractESAggSource { - static type = ES_PEW_PEW; + static type = SOURCE_TYPES.ES_PEW_PEW; static createDescriptor({ indexPatternId, sourceGeoField, destGeoField }) { return { @@ -232,7 +232,7 @@ export class ESPewPewSource extends AbstractESAggSource { registerSource({ ConstructorFunction: ESPewPewSource, - type: ES_PEW_PEW, + type: SOURCE_TYPES.ES_PEW_PEW, }); export const point2PointLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.js b/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.js index ce9932bd15cea..96679f0e85941 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.js +++ b/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.js @@ -17,7 +17,7 @@ import { hitsToGeoJson } from '../../../elasticsearch_geo_utils'; import { CreateSourceEditor } from './create_source_editor'; import { UpdateSourceEditor } from './update_source_editor'; import { - ES_SEARCH, + SOURCE_TYPES, ES_GEO_FIELD_TYPE, DEFAULT_MAX_BUCKETS_LIMIT, SORT_ORDER, @@ -69,7 +69,7 @@ function getDocValueAndSourceFields(indexPattern, fieldNames) { } export class ESSearchSource extends AbstractESSource { - static type = ES_SEARCH; + static type = SOURCE_TYPES.ES_SEARCH; constructor(descriptor, inspectorAdapters) { super( @@ -404,7 +404,7 @@ export class ESSearchSource extends AbstractESSource { return { data: featureCollection, - meta: { ...meta, sourceType: ES_SEARCH }, + meta: { ...meta, sourceType: SOURCE_TYPES.ES_SEARCH }, }; } @@ -570,7 +570,7 @@ export class ESSearchSource extends AbstractESSource { registerSource({ ConstructorFunction: ESSearchSource, - type: ES_SEARCH, + type: SOURCE_TYPES.ES_SEARCH, }); export const esDocumentsLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.test.ts b/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.test.ts index 2197e24aedb59..66cc2ddd85404 100644 --- a/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.test.ts +++ b/x-pack/plugins/maps/public/layers/sources/es_search_source/es_search_source.test.ts @@ -8,11 +8,11 @@ jest.mock('../../../kibana_services'); import { ESSearchSource } from './es_search_source'; import { VectorLayer } from '../../vector_layer'; -import { ES_SEARCH, SCALING_TYPES } from '../../../../common/constants'; +import { SCALING_TYPES, SOURCE_TYPES } from '../../../../common/constants'; import { ESSearchSourceDescriptor } from '../../../../common/descriptor_types'; const descriptor: ESSearchSourceDescriptor = { - type: ES_SEARCH, + type: SOURCE_TYPES.ES_SEARCH, id: '1234', indexPatternId: 'myIndexPattern', geoField: 'myLocation', diff --git a/x-pack/plugins/maps/public/layers/sources/kibana_regionmap_source/kibana_regionmap_source.js b/x-pack/plugins/maps/public/layers/sources/kibana_regionmap_source/kibana_regionmap_source.js index 7f4bcfa41f7c4..be333f8ee85a4 100644 --- a/x-pack/plugins/maps/public/layers/sources/kibana_regionmap_source/kibana_regionmap_source.js +++ b/x-pack/plugins/maps/public/layers/sources/kibana_regionmap_source/kibana_regionmap_source.js @@ -10,7 +10,7 @@ import { CreateSourceEditor } from './create_source_editor'; import { getKibanaRegionList } from '../../../meta'; import { i18n } from '@kbn/i18n'; import { getDataSourceLabel } from '../../../../common/i18n_getters'; -import { FIELD_ORIGIN, REGIONMAP_FILE } from '../../../../common/constants'; +import { FIELD_ORIGIN, SOURCE_TYPES } from '../../../../common/constants'; import { KibanaRegionField } from '../../fields/kibana_region_field'; import { registerSource } from '../source_registry'; @@ -19,7 +19,7 @@ const sourceTitle = i18n.translate('xpack.maps.source.kbnRegionMapTitle', { }); export class KibanaRegionmapSource extends AbstractVectorSource { - static type = REGIONMAP_FILE; + static type = SOURCE_TYPES.REGIONMAP_FILE; static createDescriptor({ name }) { return { @@ -99,7 +99,7 @@ export class KibanaRegionmapSource extends AbstractVectorSource { registerSource({ ConstructorFunction: KibanaRegionmapSource, - type: REGIONMAP_FILE, + type: SOURCE_TYPES.REGIONMAP_FILE, }); export const kibanaRegionMapLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/kibana_tilemap_source/kibana_tilemap_source.js b/x-pack/plugins/maps/public/layers/sources/kibana_tilemap_source/kibana_tilemap_source.js index b21bb6bdbbad4..bbb653eff32e2 100644 --- a/x-pack/plugins/maps/public/layers/sources/kibana_tilemap_source/kibana_tilemap_source.js +++ b/x-pack/plugins/maps/public/layers/sources/kibana_tilemap_source/kibana_tilemap_source.js @@ -11,7 +11,7 @@ import { getKibanaTileMap } from '../../../meta'; import { i18n } from '@kbn/i18n'; import { getDataSourceLabel } from '../../../../common/i18n_getters'; import _ from 'lodash'; -import { KIBANA_TILEMAP } from '../../../../common/constants'; +import { SOURCE_TYPES } from '../../../../common/constants'; import { registerSource } from '../source_registry'; const sourceTitle = i18n.translate('xpack.maps.source.kbnTMSTitle', { @@ -19,7 +19,7 @@ const sourceTitle = i18n.translate('xpack.maps.source.kbnTMSTitle', { }); export class KibanaTilemapSource extends AbstractTMSSource { - static type = KIBANA_TILEMAP; + static type = SOURCE_TYPES.KIBANA_TILEMAP; static createDescriptor() { return { @@ -86,7 +86,7 @@ export class KibanaTilemapSource extends AbstractTMSSource { registerSource({ ConstructorFunction: KibanaTilemapSource, - type: KIBANA_TILEMAP, + type: SOURCE_TYPES.KIBANA_TILEMAP, }); export const kibanaBasemapLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/wms_source/wms_source.js b/x-pack/plugins/maps/public/layers/sources/wms_source/wms_source.js index 749560a2bb4b1..33f764784124e 100644 --- a/x-pack/plugins/maps/public/layers/sources/wms_source/wms_source.js +++ b/x-pack/plugins/maps/public/layers/sources/wms_source/wms_source.js @@ -12,7 +12,7 @@ import { WMSCreateSourceEditor } from './wms_create_source_editor'; import { i18n } from '@kbn/i18n'; import { getDataSourceLabel, getUrlLabel } from '../../../../common/i18n_getters'; import { WmsClient } from './wms_client'; -import { WMS } from '../../../../common/constants'; +import { SOURCE_TYPES } from '../../../../common/constants'; import { registerSource } from '../source_registry'; const sourceTitle = i18n.translate('xpack.maps.source.wmsTitle', { @@ -20,7 +20,7 @@ const sourceTitle = i18n.translate('xpack.maps.source.wmsTitle', { }); export class WMSSource extends AbstractTMSSource { - static type = WMS; + static type = SOURCE_TYPES.WMS; static createDescriptor({ serviceUrl, layers, styles, attributionText, attributionUrl }) { return { @@ -92,7 +92,7 @@ export class WMSSource extends AbstractTMSSource { registerSource({ ConstructorFunction: WMSSource, - type: WMS, + type: SOURCE_TYPES.WMS, }); export const wmsLayerWizardConfig = { diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts index 8a5cfb01e5821..4031a18bff7cb 100644 --- a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.test.ts @@ -7,11 +7,11 @@ import { XYZTMSSource } from './xyz_tms_source'; import { ILayer } from '../../layer'; import { TileLayer } from '../../tile_layer'; -import { EMS_XYZ } from '../../../../common/constants'; +import { SOURCE_TYPES } from '../../../../common/constants'; import { XYZTMSSourceDescriptor } from '../../../../common/descriptor_types'; const descriptor: XYZTMSSourceDescriptor = { - type: EMS_XYZ, + type: SOURCE_TYPES.EMS_XYZ, urlTemplate: 'https://example.com/{x}/{y}/{z}.png', id: 'foobar', }; diff --git a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts index dd96c31573316..8b64480f92961 100644 --- a/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts +++ b/x-pack/plugins/maps/public/layers/sources/xyz_tms_source/xyz_tms_source.ts @@ -7,7 +7,7 @@ import { i18n } from '@kbn/i18n'; import { TileLayer } from '../../tile_layer'; import { getDataSourceLabel, getUrlLabel } from '../../../../common/i18n_getters'; -import { EMS_XYZ } from '../../../../common/constants'; +import { SOURCE_TYPES } from '../../../../common/constants'; import { registerSource } from '../source_registry'; import { AbstractTMSSource } from '../tms_source'; import { LayerDescriptor, XYZTMSSourceDescriptor } from '../../../../common/descriptor_types'; @@ -19,7 +19,7 @@ export const sourceTitle = i18n.translate('xpack.maps.source.ems_xyzTitle', { }); export class XYZTMSSource extends AbstractTMSSource { - static type = EMS_XYZ; + static type = SOURCE_TYPES.EMS_XYZ; readonly _descriptor: XYZTMSSourceDescriptor; @@ -83,5 +83,5 @@ export class XYZTMSSource extends AbstractTMSSource { registerSource({ ConstructorFunction: XYZTMSSource, - type: EMS_XYZ, + type: SOURCE_TYPES.EMS_XYZ, }); diff --git a/x-pack/plugins/maps/public/layers/tile_layer.test.ts b/x-pack/plugins/maps/public/layers/tile_layer.test.ts index 43465eac7f3ce..f8c2fd9db60fa 100644 --- a/x-pack/plugins/maps/public/layers/tile_layer.test.ts +++ b/x-pack/plugins/maps/public/layers/tile_layer.test.ts @@ -5,13 +5,13 @@ */ import { TileLayer } from './tile_layer'; -import { EMS_XYZ } from '../../common/constants'; +import { SOURCE_TYPES } from '../../common/constants'; import { XYZTMSSourceDescriptor } from '../../common/descriptor_types'; import { ITMSSource, AbstractTMSSource } from './sources/tms_source'; import { ILayer } from './layer'; const sourceDescriptor: XYZTMSSourceDescriptor = { - type: EMS_XYZ, + type: SOURCE_TYPES.EMS_XYZ, urlTemplate: 'https://example.com/{x}/{y}/{z}.png', id: 'foobar', }; From 9b25fe1ebdf03df51cde86a7f8c1dbf789e97877 Mon Sep 17 00:00:00 2001 From: Melori Arellano <melori@elastic.co> Date: Mon, 13 Apr 2020 13:57:50 -0600 Subject: [PATCH 070/102] [DOCS] Add ILM tutorial (#59502) * Add tutorial for ILM with filebeat * Change screenshots and add additional steps * Update screenshots, add numbered steps, and other minor edits * Incorporate feedback: update links, formatting, and minor edits * Move tip inline with list * Apply suggestions from code review Co-Authored-By: James Rodewig <james.rodewig@elastic.co> * Move TIP inline . . . again * Put TIP inline Co-authored-by: James Rodewig <james.rodewig@elastic.co> --- docs/images/tutorial-ilm-custom-policy.png | Bin 0 -> 482469 bytes .../tutorial-ilm-delete-phase-creation.png | Bin 0 -> 71022 bytes docs/images/tutorial-ilm-delete-rollover.png | Bin 0 -> 123735 bytes .../tutorial-ilm-hotphaserollover-default.png | Bin 0 -> 252951 bytes ...ilm-modify-default-warm-phase-rollover.png | Bin 0 -> 455134 bytes .../example-index-lifecycle-policy.asciidoc | 186 ++++++++++++++++-- 6 files changed, 171 insertions(+), 15 deletions(-) create mode 100644 docs/images/tutorial-ilm-custom-policy.png create mode 100644 docs/images/tutorial-ilm-delete-phase-creation.png create mode 100644 docs/images/tutorial-ilm-delete-rollover.png create mode 100644 docs/images/tutorial-ilm-hotphaserollover-default.png create mode 100644 docs/images/tutorial-ilm-modify-default-warm-phase-rollover.png diff --git a/docs/images/tutorial-ilm-custom-policy.png b/docs/images/tutorial-ilm-custom-policy.png new file mode 100644 index 0000000000000000000000000000000000000000..03b67829f605ca339df644110f9cf57838c58fb7 GIT binary patch literal 482469 zcmeFYcU)6V_b(biKt+lL5D-DCNK>kG5v4cj9Rxz}y#)kR6r?u+DN2*xTYvx}HT2#> z?<Jv!BqZEC&-?z)@0@ebJ&*VQH~H-B$;_;o*)wa+`mVKRf7Vo2Aiqg}6952^D=EIx z0swB{lf<gmN$@uZ>q1Td;FhYroSdeToE)>JhpUaf6A%DU{G6;$YM|XmlVz->WEXl} z@kZ-st!speH@?57ihJ@&S&{Gtd-wYsO9dKgljcuh<fhc_qji94y@@)$NLU>YjgH<_ zm#)*#79|2x&_>`EW^+--cIdLu+6I0L5Fi|s#=|s8n)AZwvBsxcz-Sc}+xUkBx2OQr z_X#K=FCMM^?&$$MCPIYt@9hEJv{p10H9`)qDlD1raa{v2A5q!fpbjJagd}>Gdfoc? zCE%0O&xTB+$J#5mK1HuTeentS<Xdh>{*!O{9l8z~dDr-UHv^c*FM|9j0N_E*;U{<2 zUp$0mP&KQ3xWfequ>KT&%@RVj`uI}>^*vR+w|1o8sv*mLC{o)gX3p$v!B4_XKR-O+ zc+-1~8owI$xOC;})u*^{dl$`-qQL&s<D++Tny8r32YV`Cl^V-6W|8+7Wv_nLN8Hbk zOn%cxA2?x>v-~Tafa5p(Ww3$J?@cNN#S<&5T6C$C(ltuU=W-+V2`|kOeD+_)vq-*y z8nR}8qY`~rvtbhB<3wa$eqK^7Q#7EmX@_!+eBDBT)9+f%)A>{cu$W*`Qs(&$refea zzLP5~@>Q+sD}#gut3Joi)rRn|yb1Cj9WJWAIQhQ{n=;eOx!+66eOJY=%E(0bv3lg# z1nE52a><%#XyY5U4K~WdPxsa=Njz>x{`w`{WaZ3aUoB$3pH=!)NLHd=A%&@;uBY$E zrDF0TiKXD{H$QxMq>HK470G2DvT}dX82kO%cJo-F$8ohI>cy?)u&3>W$}`pN)^TKP z&M-CDVQK*<;bG{5b--=6aR(ClyyC#T!?f#>9obZ$-&wku`~>S?i_F2T<>;Mw5zX!{ zvYdUAJiNb3NJW0U;+h|j<TYY^)9;#af@=$zMJcMX2o0HZ&*6|Sc|&nneM-XfdFA(0 z%X`nlw!dVo$oc^u5@kQC^j~#aaAlqwK7Zfy-scz5FX5M@D^qMrpD#-cy5CXsGJPL> zz6br{PTIQ@9kCi3$0)F-x^Sy;h4niV#lu@tfpWb13=L0wr`q~FpN8{0l-K1pYHRjW zDPQl}*^3ABffvJhiX(#!nbb-R!*w?(&VvrJF|RW}95Q0-*z2k0BQm>VtZb{~4DMRI zRj9JrC-gD+K)N-;diH?+FeN93lk!**a?~@8*3s2kF+(hF;AH1XZ@wPa!LTl?r>Lc> zc>MmrL$QE*&6B0`H0VBb95&7fnDl*Bqt<F&+(vo*WWg2|)R;n)kHummr1yR-5mheH z^PR*Di}yg?B;EyL(>4h6TNHCUbtxyOl_<*}Yg^oK3cWkfd-viUfQs-}haDAZ!VCJZ z*Y|ino)}UTgr!+Ld`v`bL1#cd6&h_pHbW46El~FE^J_8T=I#D&H%y2cRxWq04ZooD zBS%wRd-TZbedt#fy-!lBk$x;rY}aonSjJsrBkz0VLB;jsl?}^D{7q}(YKqw}6OUvb zk;bp}8s;%JeOOQc$F;>HAAcOvWSt=NexZ=#loT$XtF(Phh%_^dCO3ckPVLRI*S_DQ zx7|-A1IQ0vWPfkH-|qF4!zQ}vt<#sNuD3e|A{;$7RvQNFdQrj_yocG4FmDUkjKsH3 zf^IZ$k}bD;SzpKwxh|Z7o<S&<LPb|OkGL;DEu>eka_$b?D8Cj$82dCPPVTGnV^*Cz z^|vXg)H^08l>F4#?xej^_`z=yZU5V3_13E8YQU<?>N87;qeoS#uUOI&Oq4?Np5MvV zQGCK$#(u!U$ZpEvov@hT-K%G<;c-nYlZQPuj=N8yPoX!pPoo!f4-_fYm3>FywpM|5 zidMar(PLV!%p~bzg2{M#MYSKBT3c^Qev(gUPe@Fpii?YjhzE;Xd9#UodKY`0Z+{zY zsyK<UQS|)oZcit~?tH^p;^6)P%>jF+x^GUz$oS5OQ}$DF^bNEW+Sv3X+|4wrT+=tk zrOqW64uow5+>;8FidlTsYT2sX3JRb-1D|oBDbOY$2+j%XfDK2Bo(7WNCwWNXPC`r) zMealYP1w&tQNZizEzx`QDfBMSB;Q`dg+6nlGx_-LS$0*jd*rD7D<Kb|Rk{s&-TPR( z37ZKkCp*cp=Usm3?sZ3R*C;r;y)2Huq6YE@S_k$9ka9d9-9CQ$$U{H&bp1F^ltWJK zrRpn=4UT5D^0XFFVA{uw%``qyXMtA7j~Pv0qlGgZ>O1z643V0--wEW1<)9I8Ms$Xl z1KcvpLb@|33PpTkMy3*_NS4-R6m^#dmZA!!f|@{eQxtfbOYiH+>fI^P)l(?LS<uxy zFAdV8-eW82nOhL=H?nV?1rLIUyGJ=@3x3-)44N7j^UjOR`y@M;ILBrt!|pey`JDN* z&1&z@o?Bvs&kGNho<A4Q6X$WW^YGiXTkZAa@hSCfS$pMs(<gmZXU}UgZF|6H$kPlF z)JN=n<a4`Or`g2owJFGiy?oDfKH~OA6nP>=38PPE^k%m^w?~O@v&=U!NgKbu!-ADz zg_&qYrmCRdJGZkJT45)!2Jq7P)6@G0Z&pWFj~WW23fpVuPKs$^+`k-S^lPT0;>%fI zvx<Ic*%>^1xYpX<Jc-GTt%zMH>?njz4~dR9bR$XTKQRuQ4M?vk9Fm=7toimLGTUN9 zzF(PLwGl259uxYINHT6bR~B;E`xy}`5_;J_7|JMHnlq52Cd=3{)p5Bzw@mt|{?V^E z=SLdPhrXE%@eQ45A~pTDLq|kSLf|~`s;4|W0;Q6rybDhy#ez&PTCZn(`t}L^DN7O2 zOBdhs<NBM?H_%*{LmoduGsX(rTEw<tu7>>hkGr|kuVp^De~#~|{UY1*<zbD-K&Ao4 zz}`vw!KbyZvM<dHi2E|^xUH(+RYz7OJ<{rjieJ;*#N*?ibGh5D?&Xc-<tsHLW+o)} zm2m}d(Q$cmxoUN4>F4=;VR+^;)p%lWW1mpF>7^B*jIKXjJX%@Pk3|d|4n2l8N_V*b zs=Z;$nXWdF?dO-U$cD=UrM(}R7|2Xxx^TZV3U;O8FX1RrXs0f{EqV9jb^RO7uR?!N z|KOYro#n31-n_P1I<RwxG>W?mcBkArbN#i84!nCo)Zg8I{seuZed0?SM<zf<p-i6d zKbDxt%c+sEz~`Bq+$Uaep<yVMukes}so=%EyY~h^$RD-`%kJb|s{6M+{`nKUeK3(! zgejm?O;m4w3In2l>}W)?MuvP19i|$v%e0sBTpYmEJg*TMmbbATbjh@mDD+a_TIg+( z*nG3KF^H-A-D>^1uLM<eVyw)oyp<w-$#>k07Jv!(&qfmykcsg9rd6h?=RG#6^%*Vn zc#CSfiHz)zq>Lht8U`VbK$A$UN_A>2@0lU^EuDLs*X-Fw2h_Lpsll6;)s_Bd+zk3v zddU?5bpd0$HOZ{pqUGPq-<0qCj4X06b8PULoul0Qy;rUqp@%4cR$-`fV$<q|-5`I& zKrdqCR627JoM=5hI2fP7;K=B}-9XiF&)L647`V5?G$S+NEI6-Mb+G2Ma~{KZLqdHD zH8pu4wA57luuOl-_n?2qd#9(8DT85wUIbwSFP|Yge~i35(%#gVM#>|cVLgk}l}o`P zg9P27$MSjZ0ahA`jYYX)Wlh-S?eH>Q0$$SKhq#k-xv7X^N(LsgfcF7;r;1mjtGTT` z);-|Ztp_19;zeiYpWQjjvmOLiALyJG3AVku^jH<zIvo`ZwWY{BlL<V0fH4{O&pwH! zZQ*}#F^QQba+Y?ErUmhfm>)M!j7b+`dpDM$Jr(awQ5#PXyC}!1>A4C{^EQ9hHTfR3 zmBGS>W7pP;vh4=QyeEPRp0qUCX6!$FX?B1ZYD2&ecb*5y?BhO=ex`JhxhENPu6VR9 zXS-vCUhC)7)7Z@lkd~UD9`)XdJqq!XPL$f)<HL+E52tUb4<oOrkEcImxl3j8uk)j? z%r3`HH_r80&Fjv)k&A(*hhT&n%6Pm%VzFu|GdLTKQ(Bs!%%jw0%9N=Oio|&pw&k>$ zcc-3ADiGWf5t3kd*VaJvLWAg?`;9E7Zb!JkgRGFRwlLw<4M%vG!x2Fa0Ys<A8~zM% z-oE*i)}ymPyqNO?U;^q`Y5zL@V54Z|M+XDtigU=73K>9=7Z8+$L?X)&h^t0wl0dR| zR@y>Hm1L?Fn1%MIo2G)dhltJl+5q8RAr=8N0eX1zA_ZumWTU1Ac!Ez~2M`n70TAI+ z1o$t2fF3~ncNzdtCSdp<X)S`s|E@y_07TdWuKl}?5&r(yCk}t%ssDW^O85vM#s9m5 zzuxB%{#WfAfE=R#N)xN%%K)<4a!N}0yS9}F5a{A*=jvtk0a%OAxZ$Q~=m`MOu>W-t zC~2`B0sw^G_BsY$25PF}R<6!`Z>?P|fqZ_>Zhy4{kn|JBC!K*_Z<+m^om@P{{iIm_ zt|5+3|CP<p!u)p?FGndB12s)%Iad!LvoN0!-%}Rpo6OA2k{;GJ;##ld|4oknC&gmt z<>e;M&+qH&%jYY|=jvh0|4d9wjQ^<szkmQQz6P(Szl+yfKVBD4)_*nfU+ugCdRlqd zyLs8Wx-kFM?psS&Z!akpmcKgsAD@4X)63rGzk71={P$zwACUjA68>j=Px=2(WI#Xr z{|~aiO8!Om_jCQLJITKq6W8#t2jU0(*RZ6YN&elz|C0CL!~0i#Eug2XllNcMbzSVe zqy_#>^1o&OPgH;PEw1Yc^pJCPcE)!l{om^<$^ZW<{ND*R?frmG2CwY#l%9VLQ9xK2 z-{s$A|9jE@k<{?NNuLQn{a;A`r=ow8O7j1;F#pp+{fi6!&c(BV^i4_r|G`qyH{V1; zMgf2q0Hs&5I(`KEFw!914OIIPX+m7(%Xe&S`;~<}Z|>>1MdiYa>&kLJH9KV1!F8SY z7SX;4-L4Nm!afBu2O?UP2yZ+hzzv^dVHN{D662WVv_cS9*@08dL&$Hh4nWew##S4< zExa#f0R-2mUi`^Vr~_Br*KbM8TDkI1{mF<U_u-4aH4JKAQA1srzL;;*G5e09f$8}J zPrhbMR^6#1r+^0O)m8MPxyFz5)SV7Sb%4_4jt9Tbw0VP9Ebr?=+6)qJB8$;qxc8a8 z-Z~Dm>69rqyO^O(g8OoB3|lD}&He^0Nr0F9lI*U6+b?b=KTw$0*FvP4ET(~ahHVwT z06{ZRI<w8Stlg2>A;6ww=|yF39g&y&=nD6cs?mmO{XQudL`y>hR?o(4C!bOHJZ86W z>;@w5X7XTLg1$w>aQ~(iPyr{QG_uBjRXVVpifr*T`j~C#7t*XS|2;D~b8yHD-&bmD z;=%K~whw#_TzYg-nMM6reIQT93tjXR-yaf3d4fNGwW;j?=DO7IHqEy+=_Awb+i*Uf zD}dDN`8!V6+shkQn6S5%`M!ZqW=^{LhadD-`P^^zSw|P|%h2~Xf4}gQaMC(rbnU5v znQtRz&LxQ)9f1vKU#^VU4BalKdCy^LB>1FaKhpmy;aRX!#=)pZMP~5tHeVk|wQZZ! znv3hav-_MbvYOX(ZV|J@b<jXkSLZnYoNlil*FkkPlsv8G-<jfD-csMT+oa6Vq=ryt z2Q^_zUuHhhnSFcJx{RoJVx@QfEyz51G73itHLCh0B4PQ`I88Clotv&g6?+q1o|kdc z=wM-7H?ujTE2c5@LV7i}Va10#J@EBb!}q=2H<SCN`|m?~5l)?qi&s7^3IvvuGQJlJ zCDLA9!oDk5eaX+gA>1FI>?hefD-@pZm+EXR8Hc4)hrs)hImK4G`DVJiGp71=W?e7m z-GEVS9PI4Qazw=}?*N3?ng8Uc9nKc_^{auWZ#t#t{||n4rcx~ZZlAW_bF4@_8xe+O z?lNTaPTYGMw5a~O@cpqj$U!IsmhGGQN;)X>B6xMrK}wXXgq9&BDvNCMfeWIi##66< zhr3a8*JwX0mzH%J>xXN}_Vjz;YUAy&t%Gd|Vr;A13zmi~9Zr>}^2wU}3{7*lG7ZdU z*OVca&dV-PBnrTah`sk)J9|B@&=T#ArtO{MEzP+F{quPXljaa^V0KL=d3lo*EE-4? z)lf}u)I0|1chnD%j?ZGjqMmgkX(wVKL{+5sgrbMU?ACT?lY0?a@K?LZ4M(0;W&FWI zM+fzKoI$(`u}c+pdp(pqM2N!+9C*n{hWY^WENqEUB2vmKWYD#<&AhxI_&tW#ba?Vp z0NN4m<hGopwEf(u3u$lM+_U_0)<3zNHqhq#iHm6E4Ko6SH3)6Hu}8XgEqlci2La71 zHup+Uw^%{i#txKYS1^>wyYP8)BxpvYF~sW2;8LddbXaU}(7s_~!N!@ZaBk-NxsN@O zr+0}cCr_F?zJ;+~iB6f5#qJGvxpp34>v|h;Pgi#-VS2-_T?eH^mtvX59Z=ZAsiEeS z`n#8c9X>zg(3x%_8<S+B$5@mI&gkNK&`|8#tzXWaTL%edo`w6J(={TppK-jN5gXA! z+8~J#SnO@-imlZzDs7!dYh88GF}EkUu{(Py(#A(EL9IEaP7i$+hhfuI_VY61SYgLC zBx^HpQxB{@dp>1oJ><>-=~)g~f2<`e(y;y6K&D(~N!*7rzvq0~nE~FJO_?1v?;8Oz z4;ifA%oQYicNvO!TFVRLXiUuk?L&gj++c@aeWZe%FpzRnGQ@mU^0LW5#}G=|X(@8b zeR6eJp}cFF|7>8jr`C!aQZeE^&DUsi;vTqIw$Nl8t%=dX;L@EzM^<xHu3HU0%1D^s zchAuPAF<0UjI`4p=Img#L9d6l*`}-EMvUdjQBOT@1=G@Exg%4&7^!ECG>D;jeT$)t zruN3<ja>z_#}*di+{u1_`eV%<5Kl)uh6lTHMdx6PZSCHqnczjt4A=b-S$V^9kQvIv zxnS!jBk)7;Nd3t97Z!C?7K7-i|1RfCRlcSEUOGrZf_f3Di|547xWs1m>AK)oqh&vs zh8v<86-ttWpT{q<p5=~L`izDvGMeiSV_aZdA<KKD^M@GfJ?4dq$&)VR+a3s0$e{X8 zlfcRO*)L<qyAL~Ku-@}$SL%1lt)|yh{G@$&CnDyNXKQ;XaQ)eI(EQ=^j*AXwQ~<=; zjn{_>Qc-<ypuFS$L_8*2&QEpvbMSk-I9W`0S}E-AaZUg7rd~2H4Ze726%xS$vZJh0 z*uxw;bBo8+Mbo|B?G`5+6l>HAaFQuE_4K_xH&>o@(%Iwl(mRNuWcNyxtktBTV%aRr z9#vIp=BJLELDJ#HSuYF{hOGvD=!toDk#PtjDYNp%y8AJhPn$<E$vj8Emwa;DvLUTY zbFY``SN(g?RcO6mp2(gRX;XIWAqca!+~#gVCR%trH#2#NI)orNf8MRRm5uZy+ilc1 zU{ThDFVyMP)?6I*OVpdSrZVyWq;;h}m`Z=uQ@?U4vj&pEfzR&Vb97|?+RViHoL2aW z)H}1&1FN&}D$5>7gayMuvr}_5)*#cO(ajvvdPcLK`fwO&HQjlz-}vK>!y5RD>sH0Q zzy9|hG5umpE_?i>prlM+|FzvFflWyEMHv&f52Q9byLrh-stqxpf|R(sGpu{&`Nh@N z`_hCJ1OD9VTjg0#%OLvG$~Nrk{0NJ#7s<-bD4`ZRKdJPD3{KVS4X55jpAJG>L`TWy zWS!dfPik<Tpq}#v^n-p7q{{u5Rrfi5g^g}VDi8M!MeGrK_siINmtCMc-s}vISrJe7 zmoQ1w)^Y`2P0e9`*H@u1(wBO+1(`|M`Fp1bMB8c5T5OPc#}c(Dk;1C!zG`WVD`TK! zRRD04u55ii0&^^dawhgRVS>asTdj3%0=J-!h~e3($g3sfFVHppOIt&YrHIKxjBH59 zfuZ@zi91MP3$cfacVd``j@}t2#*$96h9I!)^WarX6vMDNpD<^LfX`KxEpYnsG8~jq zoxFVozw@9QgbtxVjjy2IW5yTj<gSKs$Ah($(`*Y7XAE%87DP|2r{2qhFoLl0@53`# z5^Rz*h3=RA6gbC3TSlU8wI^=z(pzE;*=a1{+BGctJQ9{w;kf0z6j`xX@u5LB+JI3a zrjA?6H)IgGHBYi-Md9;c=E8YD-IalXRU~U_il7sryx-^*vJ!8FS%F|BbcdcFiQ<(g z@@;DXr%V_E%7iJ)&XAcZ+Y|J9Abf`38NFmY?q?|bmAb*)0`c-x8bclOzyK@=r{%x} z{2ZRiDUVq0G^cbmb%lHEH_d#nSmS#g!+Om{{QOODX3mG~n#mi=PRcl=(@6LQ&THD6 zK|E%$4Z&^4G%$@m#3n-?daYM9tAn<D1ayL$M~V)EPQ7-TFpwZn$bN&5bnwzp*RWvF z(D_=_+1vb}C<}F5I%0mer{QG!v?W8&-?=oCTK~}uZyl2uwG?d$ZJ;a5mZiaWoaLFy z@Nn_AuxQs|OKEUvQmg)wxu4^i9FpF>rXH?bv_$92(WnV8WNPyYsS2!<hr}F2?0txJ zmeCp(!7+LHh&$|1^grlXbPa)FlB8p1FHY*c!(VF{nCpeDfMkM)eApY!!2C-Qcy{NO zg^eK}z`1`?V{T2yo^8NgPc{c}4yDq8e+EJRf-0K4*Gx!q9G+=&eEw790w4rlb4U^E zyzz$^9FNt1iV%JdcCL01wBm^T^KRY{qyVC{D#QPj;>ForiyM`@$bqlV{t$!#2;UG8 zzWZ@+|BoQs-}8mNb{$Y0Jp6@@^-oaVUnEr2%z($r9Ta~&rb&%=fSmt4#vjbD=6_b> zPeuJdO!Wu+^mmp2Fx7u{s(<8_|LBc>oT7j4O#e}Te=JUKLVs^Rl)%qhyU%r}*=nGK z(YRM2vBSjAs#epHhyU#J%t^nwpF;3rgZPdUG<ANXu3@XD738FXaX?G!%-g3T2mH;N z;qK*w+;P;7Q+?gh?9DEk@{u<uN)5H?Csg7Gx{DINDq1!?zV+7_{_m)(-St(@M-uf* zjr@bk`J%^%R*uubtiu`euPh?SO2^u>yP%%=HfjPR`)&))+ioYDyjl%Dy!Ml&Rcvfj z*J{bVbYB0X`?k2X-6f6Sv8brN$USN$a;yw@eYKi{LopjCr~XZs4jB|`FE6K(d2W#~ zWOu5J^=x<YZj?_kkLq{Do*^hS(ZFtkhEd`*y^vy=SJ0D7al#KDJ|vV3^T-N*pE*%i zR86WSAs3=zS(#27akZWxf8ABBMfC1E4t2)VC>0(?-f?1=khO~ou6i<4ab@zA;2#&U zlKYwu6p+)C?WYX6T2W9c*HuYKNU$DiK^>1^eN|HVGJ$w_PVb}{>_ZlE0P|f+w9O7N zOt-dabb3KX%bVgEk;TrL=@;fSdM^CLUIy5&)3kr=n5PTf)Y8&o`M?lqy#zW>f%3Kb z=}X@2o{=XAgy+gfr(l?ZbgFAI6py;2we-VVU0P8AN*Wrz1hUk?4|Cn$e?Gijx%`}r zkBe`XjlpZSBJcOLty?1%+!h_KALx^)lZxL<;J_z9uYbn!p^U7R#w37^t*ySj3drL= z@3B17j1&R;Rll@nYm&48oi~TEpd;t$n>TN+?^U!V#70mimKN}ukbHejwyBITgROsJ zrAQ6%-qX8JwHp4aKqLDRs|;2X>~+95Zab8i@I!KEv~@4$c3~<bU#0yxN1C8*%&n_s zXZu-j*~FMdQkq~P)O*^jwX^3(XEot@v%;*@wR*dl8eZ_d`^5h&8_Nysn!!&p&1aW; zSxKAeYVBcKckU*7wS5diO-@$_oH_VHTHX<bxb#oh3k3hN?i+A;WN&YuU?ihkol%#7 zfLtlr41H~yJf{KFT5c$#;LQlr*1SBUF{2uQ@Q~A^hz9|c5<NZe$C|8QNs~3aZ0V-r z?kM@pX8ZKa3UL1O^#1h(77BmMuc>ztKQ}{UB%7$Hxwy|R%N6*_zi)WhcMDV*EAc7l z!jo)sICV5T<cU4`E);xumeA(X3NP&6ev{pskgvk++~#v&gc_FPSH@6e!e&r=Q%aw0 zzV0lx8v8vz_vH@db+Lb*p%o7iWbnT66gFRG(`)^Q!IVt)zc_%MlM_m3OA()3GBpz> zl8~NWJo+MP;n<8?_F|(sh1Ynqc%oQWMPzU6Rfec*N*)`Og{_+B4nSvAz*4W!0u;(n z^0rfGHqTkVqA&Gstc?8bM7eV+*LCJYhC7vQ+~>$&S0EHQOuXR_EJe-ezh&<I`)gvW zhjQ#82OdgOFS35HK(|>0-u`0a;+kED#8EOBpEF?+g8LHk1zZ-c`4-t(x!3l8RKzd^ zKPWMLm(s+40_tWiseK(%3Q|(~tePdzRmc70$yEFIS6qvg@)S~e`^V-h=jF1*OuA*X zOP8tjQHa8pwPQ3N!lbc`*b<u#43w|fU#vfa6pxwf?!NCSbHEl)oq+W7gLQW=aKRGu z%dX0!AISx5&s7IGQV=+Ki?exuqDJk1<cb{e8*K2H#5#*_ASA3ujhCI>@a9djd>btg zYP}}jWBYByc7hrCZ^$R4p%~A&Mwrd6L8V2g<Z*A*Sh2SRt&la=fNM^Z&3WECDdJ&} z!H_iOR^O0=R&ndYPd)`I!5e*r+0kP(TzvDI9%am)Bkyn+`JUr7bd~7NvBkNS=S=nN zrnRa46cxFpva%}AxVi+tE{|M1v9O^8_tX?&PS92Tx8%vAwK?JJ(cYo?8NGd)J9iww z%*0Dmgz5WWN~6k?6uLgVQ{5;~!nTJ&*v$c&GU(HvDJaKK@eya<2q~$IW)fkNp>^Cv zj1Lz!Ha-uK@qrB)XTI{BSSyZkrIEeiv;S}(WpHIYF%Ws?yk)uscFnKGVb2bOME3-d zW^+XoUY_b+!z^P(<eNTF%;UD<Wq;B$=d93hWVHoP;6r2XmEdq+p2~(3J>}Wm%U@d! zQ;2ei%}Kxxs?a)<uS;LE((HUbByL~ABFAYaC*&?m+tR!s=M_&G<vg;@@qDPls7VWs zLLMA<JM#B0Vo7=ruE6@~qOLnBU&$KgvySYe{_lG7@6z@ds+j}AcR|Z9u@mUACQKGO z|4N)|w)QpH$Awcv^1N~(;Dj8Akhn8Z=`i`EwO*cH*ohmeU+zP|bp8Rt%Qf}9^}88& zN}c0WiZhd#l`QcU@^@~vLhNEfYMXkbN@TwN5{R9*EVN{0%Z8LDt}+O9lTLWo6LnNr zRc*1tk|qtRx3;xa-qYjF^GsFuxOf|(tiJc4$h<9!jPH5_5_6YREurUOh;q7(?T#ON z`q5)0zN`6s`h_^=@dAy+t*pQ|5cH-*S}|y=)`=tHfu!b;^xmz$zP@-38LX-_lT<g% z95Un^3x}=eCC2y?NZ|EcqVLC6POI)9UO}6|go%JN_CmFo2O$fi9_=`cQs+l<*f*Aj za%fpu!ZY(AE=0&vlg*)Qeia)2#4IVW%Ct+S5YgD9v3yV4B2$U{F=o1@>?JhDq&1+f z<$Nxq95Kg*=h-n?Qi`NdB1$(|+C&bul!hgLeZ-luVXa%$M1{VFxR)Jg;Q0=(!UOlO zLeA;DTyy15x=3v=0P)G(`hB!k-Mxn^tP2--WRe6AFqaD0e*_9ROMrkdiU9!uT(KAK z`%=|7o}4HA{2Dex>AXzA7x5&Syc4#9rg{}d+|Kj033_El{bnF!k{pGYA|7ST7pFB; zRZW$fa(iwLB*#iWd}I~!kUxrsKbe|aPdUQJ`P8r>!375HB_Q3eK<IHJTgucLTNyE{ z!^VeS&oHQM{`Gm+khob-8)z+E4O@-7l|2lcyx(N&Dz-loewI0y0`}emZ|dIQJ6_u# zD1(I)OR9Z)st#{FLvL$-_&_{XF2`w)hl+tTI70<)9rqq&c4{j3$=2ZHyABrnvAoaL zqR#MuO50Ymt8;@x4XB>j@qwt7bt`Vj*dqIvtMJc~NbMZ@e}p-BTqvPx(Le?`Hs78f zGq=4wy4SSZ56zb=bQvubrBO^sOQR#7Iy7H5uIzk3?pCQ~N#`$Q!OF@C1Ns@(J2fTU zOKo%<7c#I~0wE`vBaMKBkEcov*LDq39zbsidZMkxu39`{5Yt0X%t}x8`cN}2w}XJc z3GKaG=s5DGc%n$#cylO|b*)<?&NeGps~r5&dI?LBB;nd-NOEf%F^5^cwKV<X1KGw3 zDI(eDK%%dDql8Vy_rvAJe$9F-axt|=XhgwbD$!<8AkR!W!RfIHX9Fyth9ul;5)d<W zJgL95eWaE!^;~7D+~|qikeEIixug&-1xeP{km?#Nvp<<~!IkKh$N8UZ_MQw&b2*E9 zrB0jss|O%=cL?2io^Q6xhMQnX$TJjM!QO0-p2<pIxHYz1{1QAymQ*AdyR^y;(RtL* z*)|5~Vh@py9a^rfXXbRzR^^Jc+p6xZSBx>oU`zlbWc)3ULvSbAc`goC-l~bO$g2%% zY?4*e#B~|7-Q-MtVbLD&rme;oIsM)Bwys@a-rYFKAy^^fv<7sd{f9W8;P}rsxo4<W zo4ULu2+>A-1bqBm4qT5H{S6ixe6h?#R*lwF3%)8;5h|Nt@ttj<7abETnV!iGNm*f) z?+d3~*ef^1#O`ghoP1QSDNxG=T}V4SBHp3C(4FL)c=aU<zzZwRoFc7lfZLLL$_XUl zYG0q5Nl!M>Y*u)wT?HR_3!Hv?G*%6a5;*aqX2BXgUEr>O@X?yNWl5L{a_Od9izI=) zckP%p%P%Eef+o(_wbfG@%A4iEUOOzpJhGbPOXC&IYO1OU@!3J^9HT$o!8R4jQ%)~5 zpey0AqdECD^l^#&!aU4{-z>||@ACN=3ky~DL;{_a6&0s8T5bA@I3Ml|kxL#@p{AuM z9ditwk%4asOhTG>#p%vwuZwLjcM98;$KP}O$OGljm0Nli7>q;CcvGP&A=r^4@5^So zawc=mplHxPs%X3!Q_NC1PYggQ8P})ErXT%|B+k2c?;aS-FT9=aJnutKbx##W`jyA1 z#XuV6l{BRk|I+lhB&SkQohhi1#D=Xe^9rn?C7i4IQkjVE=%~<ReVH}ybremx45pHQ znfKi`!(gpdS9ftqhom0G1ECS#j17v@H8pZev7`5E-f30!W4Y5=e46cHPfX-<s7t*3 ztI=a3g&*$OQAH5nE;DU?c|Py@j*nMl><nmy5;M-eaiaqyG*!w&;~$@#%rz`|Qfg8Z zssRHdy`~-QnLpL3jH=4(QOtyd_?l>^UM9RJ8B?txH3Vqljg9r9!t7*Y*QPh<gYl(0 z*v~XIhwVFBCDZF*9!@Fmp{Ay$u|i*d^6TmR+6Ah~os=><U@w?l&9YF+OH&u#!^b{! zuJjJ)x#+XKe($SBj_bYtyPxfzrevs6%kX4G0bh>YP>Hgct#)%yFfKSiDIN|J5K($T zW1SZa)(L$R5*&(l0?5nlA4fA3_VEU2Bywt`G{ez_wfF(Q?Y!VBHK~(F?@yY43=w+y z(Es8#d0c;rl+ao%(Eo_wep3_5MLK2DZsnK%ScyI*otQ@wnc_{PGbV++oA4{V`HG+k zTW_2v*Tbj9EjCX4#Bh1|=HOGEIP>jI2Ldf(Vq(7Vcw)!Fug~O&!r<c;wO<5eUrga8 z8nPKycfLKU0!EBN&E#owYOQw!3<W%k1BZDqli*7yB*pv%exS*La9pYZP4-38TuseZ z!1!Q8@3@8(SKvWw?0Sh+=3JfkrJALzDmg=*vR>jX!!~IsF<&&jn3h@K2C@GYmeRTs z=kgx&r2(ef<HO|N<ambtw*Jwi*``ite50Y%V8rCj=tsM!u@ZFXN?WJ4z#}Nk@Woeb zmT}cB<GM577Beh5eWkF@7&lyfHBn|fObl?Isq6r{(F>fu6x-ci%Tv;;-y0_kOi0`l zW8H(cX$1S#)V#>Q#%QkZ;EC{XKa$s9+MQVv#+X)Gf@TGeRF+U*bm1&a|L7*b!yl*c zb{9IpIuTX6FlEY`yZHhwtxAB6AZk4^-lHF(5kmq%1=i)HTtUvjd`pumsR$$frjpd& zm57JMD(4eP5-!b#ZBDLyFyXk>vIet6V`0Y_YKERjVupLWv^b`a<1}j_d%oA`u3$^c zIIcV(lzF>-H+m{RiRYpx%#mj2j^XRq3|%RyMop5vB!b)Roxp{4Iswn_2BYSbTKnlK zP{&fUhPl{wyR3kEP5FM6g0E=SnQd2!NwwAwXmr_hJ1bPxx<dx$O;?>RUg0itwOo#g zEh&fS?b`d?=XSwmc(9A|n~!-fB3fk@>Sk*Yi^qf0=4cKVN95!SA{nPeHGy$hQ(<<n ze7LoAN=n(h{ZqwI)hr>1PKJ7BbF&!lczXd}O+iasZzU#bh|3214vg}VMGjUJcWpWh zj|#w@MgV0tYU3N7E1kg8pBljSVA9^LT*!!Hmpg1SE+!M)zu!bA6bCf-KN+01&gDxy z|3dP}uriU@{5PqZ(`?J@a7ksMPX!-sw8Y27Y#aci+rtVeyAmb#DuW^unnZzm_7-YV z_KQEF7rdYcE{0EyAM&=`OBuxAE!<=YM2jiUJBPtJN!n{?Cl^)a!{vdeqdaOw$CF<z zZq*pISf`!B9GUzNCR2qS-)J}C&>@PQwL-{&eNYWvm6|s%GX-XEZdY5=MKkpOR?NmC z8Q8)}D3X*C3;QUSKx+c81}DX7Mo!K{%%?5N<UJ5lSMDmlX=Sai&n5LrM{a4!4JB&G z2QddC_xMjX`4euL;@~|@`<W9wiaTZOA>BF+uCq}_Leu$^4%6-(HVO~L47!6*$)`)c z*;*%F$-XNQQu@aAh?DqiyYtLgSZ`*tm#515Y{#eAC0b0TL*{rl@u{CivkgsMZ5i>c z!7SlU;C_`S7d-$-7i3g7<c^5u-4eD!>!jt;rKIqgvN1$O0$0NP!4uP|^meH%Y8iEL zLWA-^y4IV*Iga@@BMvZdG>>7mVvTlLiV=OzR6U54_Ng@%Q<a#Iu+Vt^U>`Qn+dI*o zPs6v}v#XXVV7OJUyj9uNDo1{5>R24AaOU+{+Bobf4&=jl68Z;*#S3=AW*{Ig+f!M& z`kN=5`1m4M!(l4fhrV}2(aawu=D$BmYC?^92@65B1))5AhXi^)mHJ{pm~(e%=&Y>T zVAxvC0goYAN8A^F&)IQW)ZXGR=gv=pSFOTiLnLXE-Z8i60`T^dVl~uKCDzopbC6!A zs)EO~UP}<0*Z=-VrfHu!)y$)c<eiW=-Aj?ZV;QJWAT&2tsvK%7RVYiC2`sb8u+M{f zNgXbC9*=}0n+Dj*$44T%sAgIX+*DJ`rL4OLnyTMo9mvH|4N!G$bHU`G;~iU%Bog}> zNHV?frH8!n?-W(zTEEXw>C;Z+Qh&54j3qqw`2w+4scEx3u1F;Xbb))?XYZ&IU6wSI zezeuiP~jWOPe#j=B1a*mY37HcBe(mRt9RqLGgig{Fle6lnXfLXl;AeawHo_QdjGXE z(e?Y}fZ~8{jcpFr<`e>UQBjReeghWlgy#Tl_MV5W+`2}HxapYCTAY}Hd_HG(fP5CN zjgzfVO~JI@0kU6%0Qe&_8?0w4m-_5Op6iA`4YR%buw(Ia0C-^f;>LKMW5Yv%w+k9$ zffWRNBV5|4?`r^2Ky>+nCxS@eGThhnT^un1J3D)$MdI|5AC%YICiK-gk8?TAy_2Cz zq-op$*qc~<!G`<+9q06tTjB%X{b%4)W7BEZ&k#A9b?<&IP8B28L62Iy&wQey?Zmqe zJWt;UDAp)7NjqMnvv8slGe$eZTV5v=A<nOn<C<3cON4rN*+Ay>_Eg#lPzu4ob0@K* z+DBt7CGkAd7NtbqMa7)ieyT$fzCTZ=RMqwH8>zsUB=Rzf@1k%?n#dYGAePSfWc&>C zi;TaCeTYYJkcPa{u*x!j0og8hY))RhJ6aQqSH^njBE#`y{18=XKP0cIB{xQ&oUnS! zx<gEFu72-vz3OcB2Gklo(RV!iX$9Tv|DCLT){?ILbP-hLQ)8o=m}(v*Z{~M?b!p!K zyLv~o(Rf!QzBA^zeE7AK^~PKZk1bx6udOHMLAW%$cp+sjllaI*U*Ju3XMx@E+vSVf zuH8@tCI~kr?25_vayfUnS2p4Sy!u^}*mkomBAeJw>Rhw()`Aq}Hl~CQdMxz9eP-UZ zHxSXnC4;?hO<$vaKDAZrdW8jEg_1TQODZedTUA^D(tqM9`}yN<jn_7!F}{CaVf$Do zRt6n6G1{I)PXE;km_qXEba!_Az!=ujB8m4SGHb^GH~OH)oSfUVSiBS4li*%Y=3yX8 zIs7?~L<BXoWz2V2nlG*!QrRHj3zuwwmG<C|oaZF`sPj0DS9lffj7ODuHYKRvllIBu zL&R5je;{=I2O0ked*58+2`(4Z?2|B;6B>l<^qV!&`q?3v!7f(=mqh)}rN4EI@F02@ z^eUQ{OW3<RNX*V6r0EJ0qT)Fiwl0YCLM#pvpW@#`np$OY`XW+hY*&zqSg6)guy6m& zi&<Ck@zFL_F3U2G<WbwI5AZH06RO^q=EUNzH6h{6CI$57Z3?kcLcLsS>XN{pwNB-- zy24@lz;F^19@A<aqF2?y?(aTrlvK5+`#2kIS38>bk&7;_KL`hoT;6&`6f)Pyo|qMM z?4M~|K+@0SMPOi?g|aoR-+yY#SEf|zVK>ZET{C7HHxw<p$fDN<gw7<m>Uqb)1AFBt zWlEv>u>BO7`5Z)aa$jONd*Oa-rI?Y(W8(tH-6Z#fxNil90lQEw@>=i}F2cGuu4duV zq_bBcB8E{&dr;-LXZ-51w^v`W_g;AZp3TrVE-VJY06O<ap#;vivd_>YeFN9SLWX3n zSiBoGQwzxi%u&J4eKl`gCAmqr6a1X#eBy?s$q2Q~{Lj31@J<Xbitz%qMCg@I5mXaM zpgmYEXmU8bl^yaOI&#KO{n!d*JTC?Ij?ZubzX97->SWm@piw=p>oBDB^{||Y_A5Sg z)Bb*0(>!8lL9Av{(vODb&}aP_XYaRJ!HpHg!@;~8YcMURlv&#vlEPU@-V58&U&J0O zO}1dL@aargW)NK&f%LiOG>m<$2APGcMNdw>t7+M;I!JPQ;+__!9I4{<xl*LsVe+M@ ze9w?+?imCd@P*_q;{mSQfUkm${8vU%he9H!nwz({*Ded@Kt?fAsCkB)Uz+<0a<XY> z+-3!u8Sd#^N;JOmk8M;{09${hgrA(v{K;A9O5srE4+B#Um&(%%$Li?(;O2T~*sVLK z(939sC>U;g)Evye1#<f}SLe8qufOQkaXUlAHDQvQ7WzzqiLQ2>IcAB`Gs$Md&|;5B zshJ{ky@}Q=_43ji4nBLEW-K4_teer8<RR1Ji7G1vS{)178xapZ;#9MxO?&)xV;)Ev zfX`-(ha}gA`7U}k!Ac<uQ@oz+W4hto<&f110mn@t`#2->@N3E@S0dA8)W(n}`Rb99 zxEZ3cB5eiQORF{GCGWi{Z^MuKjXI;9wY55_hU;^V6{#KJv2GnQe2%e0J#+Q0OX}rK z=$mzhKU5wGk1W%iEIckr;ZK@(X&NQIx^NH62ftE(zVf{3q@EjyTQHn6kEAd(-W)c6 z97W6T)0vv4P^9FH&B-G1Qu}sTW8!the%t`%qb9>u`F{+luBrAK(pRn`v6@sb+Q|9< zw5=9!UwuXUPG|8k%`2eTTaP*K#P4zujmu0Su2XHWY+_2rkOlX2Y(d4qr0Of0eXIP+ zO3hRs?#PG6Hklc&kT($AE<+Qh-1s!j3%_@RHHV~-4`}_YKzPe>Iet=R<-&?xPLOj} zSg>BebIJ*{bqs@mc+6^Ni2d2@Y@XCqdVGRd(Oj-!PCV-zF}u|!c>D6(C49zeqi%XJ z?r4p(H(B3=hWv50SQ`=-p{E<(JcT!Sy6G=ZYDmbUldwpp<uHAxVA<?YS$X-7m#E>8 z6suSXSq?|}+yHd2Aqurs#mAa*h4tX{9gQH~pBQ_Qp523E&ISoAM9(ROyEvivjMbsa z#)Iizduk!6$=oSTJWA(Iyce9JzGatdyHJzE*hz+fMe~id_@(~dXEJ@JSN<bd+zg7F zUt)>)CRWHjMiMunf__NcmZ9*#yY$QbvrL16?9gzE+xRKp*N>v*#Y2-Fu&P14@sx8# zFi|N3*7WOE%C#Eb9ur>7%&EQhI+^LzP`@+=&RHk?^$-tP+&g4^K<{iG1sqMjJ^m2$ zY_}wP<4eu3H-Tcx!FJRrt0_~x<e!AF0HMyeXPk-NU8+q?FQ*Y;m`crS`IG7CdETmU zgG4-Zik4%;!U)p@judELC48l_E}jj!!kUbPgT!QVuB6K)$o8vBMFb0Cyh9%b-y)m1 zj~nGon5<2fsB@YX5G?>w9kcWDs)gIlLHjtfn6Gfi%;Q1*?9agUD$5R1nw<6e_!oB= zL?tA8H4~Gpp?t*VyA>u){l11ajwi+tFUTb(h9Ms>4sbBB=*2#V^m2i!#Yd9N3H2%f zV?1lj^8uiAbzrsFOe{ZL8lB5@*lVZ0r(`~JuFD-`_;8W$Vyu-j&*OgOnoTv>6yXDU zTcISn8ruHIvW4&xlfH;(E6+;H;XZ+u8Nbb~5T3xOWSYSYDBg{0C-U`k!eZn1^$KHt za(ZANgDb9KLeMLjm5Jt-uxIx@|7A$CGVsPRXnqP_Xj_rxF{ad`B)b^7?O}PI#XEIN zMsHv~O9@QEc{Y#tv?5x*A4B+Jy{9vMxBWo{0kG1bHX0ou`|Ir2HKk6e$$cr8)t1Ap zjnA)J)U4Hhw67m+ui~u^Zsq0XI3E3^;pN{19L1HIUtKx{qIU}W4jLBOdK}-yw+8O) zbR^hJO@*!Df(P+0i;12v%D9x8Tu!UxyDk|NFl3mI*p5`tt*_Unti?!7f!&~qhH=v~ zRcqGYNbVcT=-KMi1j1?F*J*}328msau%6-~^U873X2FwZ;NR0azV^xKE>rJhnmGfP zoNrXPw%s5^@uB90J<i3p9M7|+5@5Ayx1`a}n@%GgL8)+%L-7_v$x2GEV0HdN`nD&u z-+{i5f@Y!lEc0vJdNtu}9o`~s43=gRdl`&gF-FGNMe=0&hT8PpTx2Y9%Zsr`dTan` z8_^&%oLAq(JChGHX)fUX&1TT3*POrEh-5dxMQ<P@><<i>cK&~Hbm|Jty4$ZK1xK0~ ze=Xyhk%`g$=beketn@-}4b=)%(>CF-FvZA75ydr|gS<DnAK%2*)_&CD7wiGiA&87Q zRKG5Vk(4G7=LVgwJS{S>D9>Z#godF!g+{gv28-`rvo~NQJ3my>H>^~HiF=zYhqmec zkR_y9ek;S^)yHJ)vjY!&m^8pK2u$W{*id<X{de}sJlmj&RlY{{B2K3$2jF_A_5Q5V z#B$u(-gGl7Q|-O-J*1;u+^;O`d8#*R&#UPNn_;8hhtsM2iPNe6drJlC2h7}Gc(Fj) z#~;9T?5XvIZ0sEUElq+Ol!aGHe|guYlPSH9uttyHQ~Fi2PnISn-D~z#^Xe-tH1p>~ zUoLcwC@5F+85ZQLY^l3AVlOaNck2;DJHc|MHhhmi#_fk?OqH6hsiTgtQ(>XI+nx=` zk;pSE0)caNLqLqwJU-;mKb~G>`zwhqy^n+I&PBcpTK&R;J}_257^D7!<o2uy@6RIV zX7%IkPK~}ePrR9p59RRu97NY4=VO8LG$!k1mo59~J4}8*8s4hR7*>6G*=Mwbc1ILA zv&!JUO+p6-lEm%Rgu~S#LZiUWZjCfvXexh$N^|YkSl~icew*~=p_Hi4-nV-2zHw!c z;aWExeWgfmW`((o?#DfZQ@PEA^2C;<tT<B(vfc(&geXUDPbyrI<TWojH~W&^5kFcV zH#yJTG7p{yUQ{j7AsnNfE-g)iOAKm63`1xp?qWAaOflFhanf6oy}*Mi5kcD_w=;)H z<&@bPo8Ddxnd<Q=Epfa0Du2(dMk`F^yPWd?K7M}vsS4=y7fpXOk7K{Zprm!a4LQcs zWQaevxu5h;LLby**LFOfKyW3dM;+8OcH=b)l%kYmLr0+xWTF|li7025cuRy{5^=l= zV}7?Y&H){4Sa@hk-$!rM-mObZ8NY`+@}139U@D3?FqeLKRP?~>P?r8wTO(DHehb~e zoK-v5=du*$#uN7oa@ep;z|FV(3o<)xsq)FN@*OZLO%fQ1KijO0kAHBEdtthMYM5l! zcB=_%K7Ji3l*9a55Z+jw%)=yInVZi?RL7fNKytfua4<2e70Knj1Vn!tfc?1pZLNTi zR<kadtEp6_JX_HujMshR2SdM?+1XuT;l#vb8?_p5!@^Uo?v1mAp9FH8S2#-afVBIp z-+rUt!7n=}`NnAcNq1R6no4a$rKxsu?)vw}RI4i#+?O*yJJ?bt^Iz1Q52Q;OhYuI@ z@6UQ#!(03X+{bj%p2Gw2FBYDB(*j-deIS;fa;|QQo{m~yjp7^et!^ka%-~kb5RG49 z3gJVLV=DAYxk4_->0D6de+A_B^vX;M=*V7FTOxj3nO0gsA6R!0>X-6!SG3_$zR;h2 zF#gD6GHp6RxySnKnNq><*GF}ZlU|0=`$ioJC^+`~%m=2IdOYUqk85cX0PV7w`jmX% zpL8{+eVi*=g7B#}PA`3%OG3Yp$UZEEZM;O4ejn2m6q;=vNE22eS~&)`5m6+38Q|cv z7=X{W-bDvF-zYZ&p~3UdIJ2c52ZhkAYr`>&M~k&ZzXywQ`BX&IQ@Jvpfr<w*1);>} zGg@z#LXdTP@ZCKZcVsnlLSOGUCeYzS|BWtN6U_wRt(s~>OkGZ44%Ow|P>Vk}>s}d6 z*z63@ypRs!$XZxfz;8mLOF?^t?|1@-St()sFywZA$E}Wo2Ofu^eA<zS&M*#q)IhU* z{BBAzelrm{?(L-Pb#7Q(FaClOxENc6Tn<B_zFU`f)F71eM$8?@8{F2%>wU+Etg+C& ziq?DJZ~G}wWwkO+(D}kVF<a^6i!U!tZAw~}qcl4itM|emJlPu{WVh@RSos~}GnvIy zlS1O9n{P0cvDg~e?}$Grq~>i{mo6NxszmeUO@ZCzM`91dqJ-wyfui;f(m4Z~G<KEL zeg&rJxRZ*OH_B5ypD0W@h2;ds8Nj!+K*-%ff`<&k*E#tUUUL}ng4ZyTm{P%YyxToN z-z@kI{%}ljs6(AMsvfMR^{t3NDP#TMEdqKnEJf|?yP-SXTh%5ZkB^!bsOWU16xQHU zc%!cY>~o@ktkr<LSn2u~wPT?#M~4>F<3<b0Nx;G`Gws9>1D}Eq0fPcmhFn-kqqf9G zXLl8I+6FWQeCvhCC*UFKIBIyKE;XB9*hbq_94dpc*XB@3<S^vRahR>{DmTN2NxYR> znEm)KDGZ)w8^cwyz1_@lE2+D|C8X!+2FzMl1f-3CoLK4m912XHEw%mjte!$ty{WRK zjGJ)VgY-$bPBEWUqunSWa&7OoE3b+UYE<D!SWNyO&&yH0$f<32VFawVwG0mprKs>V zslr>4E;|!V&CTK2!Ss9e-1_Bi^G4}!dq|0E9VW*zYxq$IJ=JAGu8RYiHNd<Cp^^4} zfx&c3l^2Fo^3i!hv=4;5`>!?ayXq@`<dd@L8typform6NlQAt&y?A3(@4_t=a6T$h zhv#Er4Bn@0Mq}8eX`eZ6CSv!Zmyc`y;c%r&0kw=GRnT{_43^<XxPZ$l;BgguO(`22 z8~BTCy=#a02DOS-Eo&rkph0);>gpYTOy*mUV<k?oi-b3v!+Xx!aWln8Je9ZF4S$Y7 zA~2xnQKEyWm#l2Qx;(|D1TfSdxg!B9(bvGopt*nON_g$FL~D%;&A(w~Y;GbmdRD`k z6=VblpHMU%uBxoBlJQeD2&FHUm>TD*yfwTLX2SE8;|&eJNwMus7^*nrTF9N_lkgXf z#SQb2bRWt-7gVeN@dYc=9-ys~CODrm{lu8YkvTdUT|~Z)4=^URB6kpT1-91xzlcwS z6<v!;$Jy%#X3=MhDQ`>kJQ&GOYHS^#eTGwo%nXV1qhMXGsjb`LvGEa17qKNSDglNx zIh;&^FH%`c*rftaJ)op>jo!kYUy~<G^m@%dn*E#&NB=+Uy;VR|{r)#fij)!x0@5H2 z($XN^-KlgpNSB~A3^CH(-Q6fLgwj34&@pt!yPosz_uTAfpZ%Qw?KxL-0kdM(Z++_% zKikV<_f%5)=btBKn>|}4LgqO*gUcmZA<4Es|53iu#GgAv4rI>GkxfvTcO4f#icwQz zwpGB^EeH~cBw(3Y&2U`4SqI@6`rF2&du`!>bNZm2Pp2Z1b!F-9mnvR+C6)y~SFA_1 z=0NlF@ytCX6X?WS3VIJdcKQ44PG}Gn1f$u7SM>~}Gn4SbWUE&ExVup%KC}HFFMw=O zaPR`fhW{fwhemMvV-Y7eeO^WVkTorfe&a-74g&yUix=27Wu~f{>m##MEkC|=xaVY; zF)1&71u5nX@W(m-WRFMPgHQ0jwk{IYr~PW>4wypP&I;v+#dN5G-So>4dFw1u#YFC~ z-p~w?-U(PQHb%pC>Z&S&gglo{*iznGN9apc=JM%5Q&Lh~<_o}s{&(2FX<=K#zyO9a zR_NBL<Q)()OT2s~01iiz66qo&<O<3(E_4^B@a8G0(~`v?Fmn94Sr2ssmx;|vJFUxs zbI7ufL2ehxO1s9u=3AW(LBo~GBvw9)g3`m`U7Iwe`45-rglsQ9?l8NK#ksQ0P_(VE z29B4HbSIAu&#q?T_Cdk8<Q;4xzE2h9x*c+<X69|oawJ^z2m5T&kOgkrC1_CZM~E3L zB=yv6W@I<@Q;7ueZtbV#5zUZ5UnvGmoZ1ojKju%3crr7k?lErrEAsD@-Y`uTDtSN> zEA(0>me1zJ*_`In?Z)gE8e{q0cII?n2;IvtOelz~G=#0hve4=j%MVYNWtGB{EwCnC zU;Pt|yHV1l=><Y9Ne$bd3Nv%dmI`yflB^kt8C%iO?Yyoyw$6Jwn|B2^JSh?kdR=-k zd=}Lf7qYJI58wljxJn|wXD@{nGH<&E3<|RnTcgd-ci2HQqF~{Pz}!}MwR|09fpRYU zg(-U$obF(xa>0l5Iu6e*3G2nqgmR;VGDHH*e2)$(myOY;VMOBgPl)0rB_&4#NZjSu zUOG<C5JhA9{jRswRH}tNT$p@9Nia5jMz0f-mV3=NPKea*>*nPq4_nQ8-nnj%O<F!h z?OP^vM((?wnf0{mPULxtcmYI;0@HyQ*6$;ke#m}cn^`4icVoW`mYel5a+(g+W7cF| zT-W2CcX#LebeFE(h-ibT+gU|D=BTwMJs*kArg>f9%TF$&0=5VfQ@eF;;Vu5B8!w@Q zb>m$WK$c2@_$Oq%zW3L$Ncna9IGQFP&f2^xxI3*LGLC`CouK+tjFz=t3O*`AxE%k? zTSSZ5XJ(A`QXn%w#g%|1m5uymfbs+}&kRDQrc1AEk=3s%haNQ>f++lZhU(oR3&X8Z zq(D1=Y7r7jx-6I0w-0R_o0GWYt-JmJD6;#zqz)5{@sFKIIPt5C2~1^(h-1f!VHeDC zRt7HY!xymsft^7Ye4JW>sPBG3G=p9nJ`W`$DOW%rdlEx_tZeyQ9!1Re5jg?R4ZT~d z)@n@<TVgLaz*NnEd^EMmsls)kKH(1j0EX3D?;|~DL5@cyd%audwbt^K;4Jb$F_7h( ziuKm58bB~}4A+dd8bAC4OiRTc)#DC<f;{nexiu%>X|d_%!_`W%R>h(%&Y0fKYTw%F z#Vl0LL(BWz=l1e&v5jrq&m>fcs0&)CsC1lt9{F(o3)?K}*-KiQcg=Rf7ke|w;rIhX z>;svr!CvLL<cpVdiYd(D4AET2CUrB$bPsn|35yOLvbRSqmMP3^{_O?wU|sd5rMShl zK6JZ@RqVgmT&{?~^t*{M$$rQX%g^qQX!+H*4qBgsKk{{x<>1fJLsseYl~ZTvn$Vm! zOakUOPw0ceLIeDOLs<8CJe2T36PW+WU1iRlnyr2AVfF~9vls_W-8SSQ+O6?7I>Nud z_8GYMY1FOz!!^BmbTA+X?erPS7DL`_cl|bqM(#@wHagV?E848((h{T8gAJZyyCAfL z#yd!XwN!|r=;+*eKyXsGkvAQ6o1D97yz~E&!lIiDPGch9gL@7r85TI_Nf9f63xiy5 z+quPKSQgEn92+mV)s?h7aPlpCJ~p1uFcduioQ}Gzw{ANoH<$bDr^E8&#btxt$S<A8 zO*SJoftahhfi*jmjLpQjKoLz`V4Ie=+2z>IEMmixqiy7?Rfk*v$@DoqL~>*PJ(wgz z5$D06?>5itb98qOg&Hz4&#i7XTU^N9Or~r%Q{;}uD|`fy4lo+Ij}+@$@36AFxxOoi z$%BB!nQ>K0l*M=|gXf9|FdNJThP1weYp**wEAjpj*&va+`fSoCk#nap{j>-7aIq-? zk=V_&Am-VA`7Eug@WX*CgHD$bGKI|$9(Ln=(UU0QTNTx(<Y}|+N3@~f&`54^X%?{c zMqaFNJk{vEdXtj<tle+KJK04Z`=w5DAmbHqc#au7eD<%i@G4;|(_&7h4B!(7`gsvx z9NhDEjU2KPpOwW1^?M50A4tZ?>qn8}D$f0@&xSUw{H7>pTSg_v!7qD_*<HIiTRt}- z!_D1oK9er#vcMp13%EtZ8UvMyY<PJ*P_+)GHrz}AHO)<*bx|v`DgnxRRvT)~Tx<tt znO4P2L3?KsOiy<6nX8VFkMzO7rR8X59#O$o8?#Vnm*TCG?uaZk_SfBPG5dfIhg^Ky zOK0X2{S3r!)U`2qU-9AljF+34b35xFs)Xbp7=Q$?dL#L_8;;sh$8-Y!Sags*griVy zZf-)}j=GuYT6?(H+$qb*OhLg0h7)$>B>oFivMwu<0h7?P*0F&~eG6*HkAxpTV96$R z1r1694+^>+HlfV=trG8)GwHFX_fE?mbL9JJ<qWagy>5P5n(fR7#JN7XwBB!|LJXi< zPcZdIie>H}b{)@78?2`FkRjf!wtNfQEWAe4U?VPxUp7)?m@l}R^cp~UVtQKapzktI zGgDydSYf4PHht##`0`KRNSzZc9&KnE4^jijU%dHJeSc>BvYB1@<{G)>VBHl)u5Adg z`2;lqx+H%IlwuHX+CG-dLGa0QfO{4BzpDojf*7A`L?Te!;jJY5*sM_LC=GD*&Vga* z+!xXzqI)~F@{t51NeRk=Gv<OdcP|3MkFHqchn)w=3XJF2-0XuXqOvRfbR7#MAp{Q0 zB$I@gadSEbxj_iwN2wXgvm=aJ2a*2!P&Bve8m&qL+Nb7A;@w;bPsOAOt(-zPn$%nh zF12v{Px<5z+D}-Yxg}lPhbn9<JH-Af!EI-^WFNfU&0U={)1B^XZm~kLE1VukJK#`c zpU(Xm+h1=CjVeF&g*m*zoIw}yd^-3Ra9&e*Jv8aV_%sVy5WKv`cX>o59RBS(o=`V- z8@c4YNXik=^KmxI-AEm3e|8+C3cRZcGZlKfNmO8#0k#keKi!fFg4xFn?-YLX+{Sq- zA@3tf0OPE_&zCRKt$~v3KO0%NAs2xHXSF6sr{26jV@s50YcnAGvh#^B&g^j5=beYY zGy&wX&f>zR<q-~+-#Ay8b>C(+q)u@QR*>}<Oshj><hGwN;CDMXP=<VicW(F-F4kMq zv2_TKm>-85MID$~aK)pMdFjOnti9T{Lo`o2zq;}q$YRzua18+(cj^VRl_kDgpNb&g z)Pkbo;%-z--DgyHOrKn<uc-L=B$b2@l`BWfQ^XeCGP-o{JeM-FNXdDwt!}ovLMSL~ z-}`vjl{fNlTN-^)e@6PHI7ai8ADY2{?|+j;{WbDbK@G~t`dEOGP+T7IQp2hM5yxJ@ zZQ4$R$>3e4V(VM5-=9nnXuWl3x(p1NT1V#e?K;BrF$5JUW$;gQ=xci}a3I{U?c!fx z-U1I?{!VH6XEJf!XZ!o+`FUM60a{&f;6kw&#s2ce%Wnb99o|<ltg|pBsRb6jdYMO# zbKg;niD7e_8j2hg(pWrv`rqX;r2OsxiQ8`h)!X3is;t24tb1j4c-)vy+t{@tis+#P zR)1I=L{96?@O)}-t|qUlQN4*E{qxUcx8X56dZ2a}<5Z3Y#gGalk`$keRePEb-UK8> zy(1{Mz?4cd-WthdiWR(%Yn!WfZj5@o=NzTy7F80uct!Yroz=?q>BZPImQX;~79*ib za#y7&abZC#V}tFi^CAppM)=Bov4U4VWa_ro?ndsf#xX`@cbwy(i)}a%@qyc<(oGa} z@i0F)z8M=JxO{N}i;{I{n_amZUhRA7c_(n!w`C&lYi?#Stc=gH^DEcRP4@k0Wxcbh z>iJ{eS#@A)E;b45FWLZ<)DuM60=c}i>k+HaYl^=kzZV&0Or(=fW}fNJ{@h?yCZ^_| zUeVBmKt=+2)S83Fiag%1x$KdT{a)>+J!%13yw(vBWuYrQH!B~)2yXo!X{Inc_==x- z`Pkx?NnLedzY|U@dEev8Tle!5m+!2qjV_xQx;4HjkdGGfK?OF?DE1eFTYS5<-BdjO z5rZIDv;hNQZ=s+LYoV)4@CLS#x?7avUt>%od;8PN!J)EEGb^Q_{q99)W)p1^v#T<) zZk<Jit$ukAUxQmoA$M8w;BHX{4Jp5y(`cXZ>7ts5uI{{=<BT8!{Tu};x6@`08r%~S zXXt-Zz{(kEZm8Q}ljM7M=;;D~csaxieWWK{XaFs>yA!*q@E_;4-#ieER~U6@>Ft5^ zVueq$M^d@<V}vd}YiEsoS^-B_I)y|5;0GgmI=iY=`t&Kj-YS#juc24_`2++MAKxiI zNZg{JJVdNeYh<&l=9;3*0t-I-HoT=s>vB3o*P6|Nd7LWXnCW}GChY>T_mub6!$~wn zWO$tfeR?!&IU8GCZZm^;ndf`D2YpB=REW<Jf6ToCuW{ViO$8=gtppgew%qd%O$639 zwA|djC>pwU78x=RXq#XO*dD0PE+%nk)^%vz_1;}Bs(OZ4F_E2!NA#up(dA-#c9^|O zKyRVZKCj2F!JVi*^z;-`HCWNKM5CD2l>BPcA_1f(|4x}0egxV3i8gWL?D1=+_V8L% zc)zPw^i5qub_y{uz1h#0j;6L`4S8a2rCIZy;42zDYS^9*^zmvDZAV8X?qU`wV=!SS z54t8vY@4G)3v|**I2A@-?g#A`+TwNm(=!zP1T6a2Jat;E!pzSNF%~qZW){@{$vT-! z6>a#gP{TIQVk!*`o(vE|mg89B&1faTPpRyF5zoX8DCg(rkJ6u9prjJQ_bmjiQFFB5 zdr9D>twcoY0pIx(6<i()?7YFwn-}Xn94GaTDTf$V_Am_9=2+!%+5VAQ`C|LSZGS=2 z&Z|&kv=x*vsi(xZX$GYCf_&?+WMIU-3(|CF#KNe4^g{@QF0_;;*V+$fGAwEvWHk5H zUU>ErMMu_T7l#oK*6JbWFIahGl}r}4bf<RuT*g-#whfl-HM{L{Y}?Ii>PZC$#0VXk z@xkK64c>t<kl!)Jw9OZ$)nrGnba)TD&l<DTSt=$>-Cl61yqh20&5dM@d#9NC9rc^; zs%}-L(B^_|Wqe~ro%v913u~MFZqMi6Gmce8La<s$Wt_D-oz1bbIC#0(3(|Nxz6hVW zqNlr6Dk$Pj=6t-TD={n!!&I>br2vx^7Ei;hsvsF*t6xaJnfs<&wqL|M2;B`Ui}<t6 z>k_qU7^bGdMYw<1K>coI@d0W!ycBhE*&AYil#1GtUpRvq9N-_2djAMZFnoISEIju+ zXs7ncd@N$j`;k}Wc(+z-F8>>B|Ij%dUA4V<-D&65<0J&_vS(t{EHSlzcq8`254LZI zM*P|q{3m$CG!=53&^z*|xXHqb`jOpYc?#}0DeOsu?EZQNe6y-fpVspCmz%9GchE(Q zY#nDgI62*RD>IMOCJS{_f70npFqP?&7zUTN2*3w0n#cvO-+NuJ4fF@IGMmtL$cE|L zlxU?TSEfd%{P;m3n;H*;u;-bt27Mb0d=!TPfPSJDOIllC0k)($nCsM(TS0!3Hp0eM zROY~_Zv)(v^&_zuV&$Ini};OZE`)x%0!-}ASk-ARCTFW+46@<*)ACL>_}Ri#gqaFM zRcA)sU1`RQ0w;y}9!TM*nn7)e0W@L(?70%$L@<&`3pVy@IG8VLO3$5lTJYRqzPp4P z56l&(WXN$nXL>#(GgB@AXkbn=EFSsxer&)peU9)jBf<m5l6wkNrPPOhM+t??qQ`$S z7319;?Hijvb=2bEAa2Xfe}?@zjKIxe92Q%YRVgpalJpn#&HMZyufewYicR)`rMS;B zwx*z*`FN|mE=&f*dUJl*1l_yS)sDue?y)G?c3pN407oxu^`IS1()OjwLI_5=-xSAV zp3mnKg#~xw=OJ2qI2<TLZO=8tZ+y=QL6iIgqszi0Q+t-?=0l5)om8`io+0h`6PRiu zEaE^vSO)iN#pJ2G8uj;mAA$OLG^0yp%PMfP1ZdG5+SmA-UZojc!7bcy{!t<kHEDWP z?13ms@SY=JjO&5nkcfHumDxPKAFYR(7`7I($*<wTabaiur$2R;FPlinud^dDTe73h z#ssA6I?V>r>2$&p@u1}+9^L*SFiPybL1QpHSqDSAdNtW;J{uyU3(&Y@^NLuS3mDCZ zK;{6tlCP#|FIyK8fm-i-dvaI6Iu30!F4?#aaVMtGZ1#xveVESODd-LE-Fal2uPI0_ zH?!tRg=YDJUOD=zj*)qXLSP!I0iG)tj(iU<i{t>}6a?i-Cv9m-P`BfAP1FpzF|$cw zZLJ<SxbF1lj;e!z_4)_HkNZ+hjy>!I-={kL1X?7)!^1<?EVGXf#GVzovHFf}%cxk( z9(Nh1XLIDa(>(H^w5E*X9&T&mbN5L_UMrq#Kt6Ghw+5Ho*RFTnh~|Zy(7k0_ZgqD@ z6zXIvbA(rP2mpGoc!0tmi$%<(vf_JYUs4W5M1D3j|J1Jdf`5m?I!8=qO_(VaZ5#KW z*pixD;TGo@UxJMUEU!}ZTR7+2y%Kz%9%5OUqRfqIc4x~|C`bi7elxQY>0=um2Vn!q zDtLF&a`4?@S>ZFqL@TYd+tzk<_(})Uh{ML>LjF62^x_^yPT02dhWW}pDk}~(H@9Xg zukAaZ^BvX<0rx~esumv2`KcGBhBmpp19cS`8XAJlZQgb?0Ya0ZL<aRGH6^V9q_2Q7 zW1C}Kf=RR5^h~G2CMm71K~Y8~k+roxfkpOpW)-x_PI|*_jF$E%F|(R_h$PRhnmIQ2 zkNh-<KR(&7rW9Vs%#joUUZ+3o%y)`PN=iw{lD>sxXPs)CkL_n;`V%$kyiMmxsC7%( zM3y7wwZs5dS^}(?_LowwNWNk^Ii0718=`1yorlPhA>io(vC%d3Ia>Q{`d7h0z^YeF z<j2)q92REz8Z2WxieV0^yYWG9I@z`}nqid<0hN<OqNY@{vV^FO2VzsQvZ}^ia}_cL zb${)994;7?6pZs!h#~JzwB*^&)=4Xu=r_gOmtV!Dwas*-Z5b3P8D7}|J_00%v&o02 z^7ErV_|&&XGq$k^So987%6fZ0%Fd2RDAv^$B#aFuzugB4WeB60YeOLUT{xS6r^m`| zM%B2}N;@zVT>IEmp3359DdxnY-w;>WYG(wD+Lz(6(^un=%O<S@&FY-9S;sitGwo(( z=`G0{cT}ETA5}of39FZh?X>JVih4u(-&;}>?dKY82-y`m*MZT873!)!<g2S8tTR@Z zKd?!7ngj7M1p)2kPt<gsJ0~0|$p>rJHys*0fqCn<nr&*C;$GW~`}Vf>jUFsZRWIoo z*bsJR7LR^M@oR%?8GmPk1xL3`<zsazqESb#*Y8dTH0K@cGxggDpq^js^f5+*eVCof z!&p1aiK2<E5Pq;cS(w*7>(w#Q^`iAxC@YI677I+`slF=A&K4c%`BhK509Y8v@o8)> z*EX&p<gBlM)~$LV*yV6Tw@FLXfZW{LDe$n}v0s(GO7q}Cu*!UfFpZHcUM8o%cOV!9 zm}luC2R4#nwVYXqj{gJ2NmrO?gDw(tlqn+4$xkFgUlXPKhU1#)8c{UNxaWid#=6HL za44EKm)#G7quxWuKmIJ`1D13V<VEL#kSuvcLvK0Pw!~e5$FCRmS9q)icd>@yD^~;^ zaFv9L<tD>Agx76FP9;`RP8p>K-?oo3n9pJ#u0OjUSlXV|w=RBOyYslxmK1NZ6afR{ z3WG)lXe@N$?ULXqOQo>@Jiym)u~jrj#!sN}s?h)8_Glo+ucpS&MAi2hjWJz&!;Ria zB|*AbO2m3(*Q0z^Nk;(zisoKH1o_tu!*?bDyfzx_-)+H)5kdc;I`n82ZNNe(l|$&C zfidHl`rIA^l!ZiG;{%8%d8>MobEz7gKUToO_F62{Vrz{}qLFY}Ef1?Gt;0~o@PfvL z_uLRvzP)60-k*`F)6e{3y~<HuKm>fvcPrfI7kc$@QDN`*5OMn=({S^}iK)g+RTmkw zvexuT1_Z(@P?7_^vS%)ta4ju2u6%Mqyt6gy(Ydghjc}_yghSZKGm`(wgDm{(25z}~ zdQG)y-_sgoJq)9khU|`|Z;b8vSYD)+%LkbAl(J!hD_9buOKXb``?eV|)EVHdm@eV_ zbF+1mGvKO?rcMBK%($|Dcza)Cc(!c^B@9?Lj)YGdUtQSm?}v?RHp1^N^vmE^4~^}@ zYWsyU8(|mAwB-4kMnYqh|HT9a==Sd&(Qy#YyDkJh&)RNib8y;jSlERC)~GZd9=_RT zs(Y;}C*p3deJP&*%*g=R=$L*@>*h4NvFB^15=-}9zn@KPj##!E`=N_>ev7}rP9kf5 zWrRnNn7*?bQ>GL9;JO-RsPx?XCDzUd0@>dqrX?3@G~yvO&+o%!Yrp+he$~AeU{-fq zA-KD|Dx9DWDgeZ*pyZkE(O<z*^iL#67kf034=Vp)B>~P9vzRyt_4}g%3DgcN?YfTw zcKNReS>u0VZu5r#T%*T#EX}*3*|~zepR%qEc-L t@YYzZ@L<f9YI%`0Gsp&&~jx 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/ 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%0Ajk^cTBDf5MIV^*xGnX-IyK;!to& z^WC=w>}R0+W1JUKyrk_dSNj{a(Gj*hIIQE-|H$FwK8#Df@b+$MyXwPN-_<rrBE#<T z32AfaYO(TcSzG&cAfM!PgFawFJeF<5q}^073_o4XA-iCXdkGfs{~{K1g#eXTHPWv} z96+&OEM+JIbqoFO=aKu&d~Pr=0X_5I$-2-b(-1#_tmEBjFpYm~0YY>x%euIE75nEc zzt?<I<-U)NvfjAYvb%OXu@LZ>u=VU9m<ZK=TIje+!9K8*(@wA!{wm{af|BC}foz#a z!?3dh@c1;f(`rzWpPmZgV?i4F$We3;FW(u+#<<NS5X&Sr2sx~WWff(RWOy2Kg~(wl z(A<~^e);oPNRlpDv$O0@CC`wpe)N^2=jf&PR5<t;`ugP^X8OGE8w_597O&)sbLTIW zhJx@5h6K``#n^Z$+EU(&YMLJn;}CpYvDkpEF!4?BOyRiFyQ!PO5f5uf`}IS{)tLB~ z0e(Jbz%_=M!yD=c<Lv@?ug$<><T!v|r6jsU6l$GP<Y`}UZn21vzdzZY>vnFrc-69( zK9uFXoMQSBxXWKhVsyrQGF^~hg70AwVfFo1krd>8J_e(JVe$cD3r#@)l*QMGd$0!Z z^Pm&>OOa-lN~7J}Q50}THl`cLGmHj1_JPC#hOY%7HlWLaj~#38rs|55DeiJIT9rH6 zD{z(@6FjW|I|?!qWzROC%*S5!zZ5eD-RcpIMRqEyxRE6rDk>(I8>H?VVs=U6Ydtgu zt_ru@27=D^e(h>WceOqC{^5n%X>Wy@f{tapwC9P!lEEG*eyBhw&|?-CF5h#OEU>(S z<nCYZ??tvTvtF8+-IR`)Rek5Iff?yrSG%32#QG)0Rsm}TK4U;vWVJFg@w*@yesz^K z1Gc_4*Hhh{$tN(vFkgf7@8bq{bOF_k=XhtKB14b)8b%>Ydw%%4hw-BFSE5sP5=i=; z-rBML&uhDUA$qWn?YNfTxM82$N0N`3Y!~2cET1ob@X^eM(x|#PjZs0Cr4O$q>E@p- zhTe75o_*ITFrh-048tEf;^UEm9TGx^UTD;|IJXlnHJS$LePu{VNQr0%l=jLrEGTtq zKY*@v-5CviUHN0l`^Jic_-Cfrri-Vo7ZZp4g0R(~c+0Oao~%?3NY2DFZ6zh{y=gC_ z(6i|GUQ8{k>5vLFJEWRdj3mvUYqrE|34dA_HIr#wL2?Ompug^>F<Ko~^PigrGu524 zAh(pkE9v@@Ni-Gfnqi30F+Xp+I6yzOgB(D>n8SAz2r;#m9r8W$@M16!IFhVUZ!B-1 z@jmgm5;WdB#{B7X&l$_t$POL5V|Kg%uZ6TD`>ROI#v1I>#*R-};}bmcO+a)LmnVMb zLIKwP=L=_aqw7r?yWM8WQfJ=R-+|Kcs!NcDjiGMDXBr4;4(bxY;Fptt>=tcnb2Z7K z8F6mR7C1ZYR!&hI6)@iGryj{}7_zd?IPhr9-jDXamNsO9$Su!651|$)3n|1#ZC1lC zrwd1yBxRQ&xZ+H#F5?^r44m38<kHQQ)=#}Rlp1>MoAm;AP8xf&y1#aSA0fEcqTp{v zdyOk$cjJE9C1;2TW%79p-+$z<H^kO%=blX+cLo}Ga_k;&-S4|8=snXpJ#l4kGaL<| z839+qp-E8L3+d&`2KW$Kuts`ev>|f%*r_%4d$l6?`1EQ5w(jwjZ_^vJ>h6-{tvWF; zC|8qRxpUm@hZ15;W8Deaxja4)TnK~n9!G+GO>+9Jtg~D(b#c-GjIu&G127U8(W@Xm zu*KU-Y0lUsWnq{<F#zs#ya3&hNNRVkG;`rNqOFsi0b2XdRxpKQlz?(y&hB@W2^hWl z-kf05YRizr<gHFOG5C3Z=aTKXEAnFXCyEGuC=FP~Na9Ljs8!8nh{<4cC$xWkN15mB z^eVxl3(jB?z7sa)C&k#k9^HyuxAC`*s_TEZ8JgsRIZJ-!q$&FQQ5A#PW<LY}v3D62 zW+Qhh$Yv8$s@&x}IfyG0@485Uz<T&tljR{OZ7k&+|JSM<5t+>O(LE39KO#GIs;#i_ z`D>@*$yjw@ZxyHcMyZDvv;TMRREw?LY;w%zTw{&Z`K#Ckgp53*3isz0!$=v3EtDCr zEtn$AQY!Uh$t~{k_mG4VF0uFTjYUVP@CF>~a%|;dS(CRCUkJGrQ8K!SZn}Vjf)sdy znc2CxC`2d8*~^O5Xyy7aMcVlBkE9mxi+)WOGQZdL4fpb8nm&lAv0YU9_U&6egj|&P z{`)u(Ig{v0|3r-U2Hd4y21T^{+M$Um_F>l~fuaa{0*I->P%mEF0nsTQP<I_3HxR+0 zOt}rdHxSbJ)mC&UK85Am3=G}#G(=}(bEZX)zm=h2?y>9W^PB|qIg)w}FuWY}+6=$* zTUTiGs~~6+AS8Nw?g_Ln=D{kh;x#{U{G+4Rva$u*cd?8yv$6zao^QsxAfEEYb)YlG zX#AT5425}M?XOy=OfivOPnT89%fMQYu+mHJ2#J#uDqCQ8<yWv5sqmBuvEeH2KRo+2 zNyq5KStI{K;DKWM)g!e^k&BE516(}a;FU+VD<AxMW7B<$AKhaV*N^$=P_UKHxRgxE zcPH;jSWZ3`9Nz9l>%L^2)E8g1?*|t!ydmiXX8Q@wJBOum$0hIdkbz4|2Gn^c$v~Dr zBjh{Q;C<k%mkW+`D}=T;*SO?|pQHq7+Hf~chuwx7Z*y@C?BTwjT~A=rW08L9)GgDA z`bLk#>OZa?9L^-PyId)N9A_4bIcW46MP4(B-`dJB=GuO#t`5%J<>e59g`*DO?LNb# z<^g`#7V{PDn>D(E2H4WGfTiYXKW{<67P;7xsNWa8(QgDxG2;GvR6bLL(AAE6d<M=U zA|idRM(h2tZa0kXxP8%;Ep%t-(X190NZyOmd310rW2cX`oh2GyUf=ya*}3QmYdr=w z66+sG>T5y`q+Xx`QG5YIqPx+QDjFJ|rhc4*k*YtdZk-OYoaAyQg5q)^t@`0WF~Gd# ztpj^S4GWv%)VQ`z5moH5+?DRr1INw&>bpDOTOe+dpgO|!{$`KpT_fmU$TK@JY~Kaf zoY-@TAeP#T`-!W1=fSn2Ik}P#H{^&t^bd#2<+Du=Zw2VhvHYqqyeG!~;Ab%DS7hI8 z+VyM-&`?zZRCHOOy-phDR~qiqh4!>{<^TxiJq4jy@(eSE#w?9jN#~ecA}Sh{yMY=f zSI^-L11X5rvwrj{&rQcT+FUD8*;h71dV(U$^fcImsP!5zFQ@x_G<sP?D84=I`s6I` zMWF>wKhGWL&an66)KNr}JsQ|+EcIkmu0UPcDn_&tdAXyy7<cJ7hA~KXmr(#J#5_!5 zsWDFP9{872=y6_F_>RX6P*^J9m8lnT-Q<Kg>&^|AUjSxdhIAt@X$~#11%6+~0q!G7 z<A(g>3R(?izdAktJii=!H1g6Zi7bEA8NZ!IPHh<yD|h5wM1|ei^qhF~LTXNCxl>?+ zwAtl}waFjli}J!aMFm(9xEnMtRj&hqBnmhp3T-**iSJ@w^y&0O2Sgw$(G%^tmpjO~ zgmzkVx7$pSQ`jR*FCl>=2h4W#yWz)dD56xwY~`9SFFq_iUt2K<XAJV)9`=$feO4Vt z<8h!OP2_W)%0gVUsr@;6Y+Z061?u5(>OAtDmx7f!NAf{%Wj|XRtKxO@jw)(&itw!a z_`A2;9`*FNk*0nK1(-oLz7D!{3PFd?6zQ4nEX9>IkgcVL2b|S8%|Yl^fAr0o$sE*w z=XUBFM310?*WvzO`dQiIVh5I=?d1ihe!p<7JPhBVLC*J(jd!NvIgy0juOWSQdZ=RV zleH>q9!0O$IA-bPkSF#qY#=HHxyM)4j+VP|j{Lk{E@nnDW<nzwXjli528gAXYh=)5 zv)wYOpM|TwBzM!K@9UBLxi_awr&1>kZ46F*3_^B0UQefJ)D8VaZGvv~f3LE<Zj0Vn z^={l5ZyR&`xAHRkcq}>3gM4LIV#emnG1g9wM5H0N**~zdm0I={riYjNrSpt(I}@3i z*9-fMXDyLyZ>~(c&TOtKH*S(9OUnM4w{#RSulNhBhmOf!NExi<XkcrqVJL(+6=pBi zfCcWN!g0CQLW0mBY9GhL0Xbv1$k>JG+~w^#t;mb3BQCFFV#dJ+>Uu`~(QvpbF?u6Z z0D^P#perD)_xOz$i3Jh-f{c3jjO@mHNwe#dA>zHT`dAlc8>d5bu&>;`nZwgAzuJWn z3bdR5#CFI|Eh#*t^Xa+!`%!GT{2Tdu6O^#9{$~>}@@{qIxcVzw5x_PDI?PFp;mpLk zbx41P$9Q7>#U2aU=HBKU3-Jwz{(+`(Sdxb9^0#+>vZzCwp1z$I7Q~*k&2>Hmf+_q) z7B20m1e5ox#5CK{z$??!CCnC3i{?^5M6K{{1HcOsnZkO;-bQ`#6I$Bladeu;u;}~R z6|c;Tammp+lanpuyM&Jsha`WEm7GX@JpsC&cF9wBo&;)Yo5T_4&VD~TYGBz&C8ZMl z>8lqFGG+<TdJyXC@GZZMv5FLlh1$@tKHBN5u_sQWX?0m)eEOa51|lzos4glu_nla- z?6TTwyjfu^kXg!aWsqQOXZKfk=G{u|;uBapT8|bL^W1MJYcZp7;gOcj!eBaoDjt?U zFzECn=nEJ0?dys^Mt75S{3GRL#wlV5oT=={><?UN8JuaIbgsh`P@OG)0ey_x=fCiK z=XtG=Cx6=GR1*5n^JM~XI`>yr?(6Ja4D7u@D$3)HKENp|$NFB0#pL?rF!24ydD%~A zd66kyGtcVq&&osjIIg<5Z|_aVrRs;vRh*>=o=bz*pShpgNo7X@hq{3C<<#5<?vjH+ z3SnEUx0ho!7)B<br^;d+Vs^vLw_5gLP=|e5#<9qlS{cwV*{17M_shEGEQ9dT;nm3) zxdrz5+04(kQJ<F_vwikRLUu~4a1~uxRSgqH#66=<m1YIPuwc=yYAUJaf56&Ly{O== zU}LY&6MJ?O)5hh;JEOz3Ci$Ez&U?UNKN=I^yCZQ-dgs{|ZR@eos~CjSti6E+{SFan zXA1U15jpM7Cd|-Spl6-W_RuRwk$i^D53+%jyaEm3r^6#|i|%`nu{h-AVc!b;N0Vfn z)|OvnISeA^4Z8j=2tM=Q*g2Rjxwg2I<m_j5w3cHJRJV3Hhe+uD+nX!Sh<(%4>E~mA zLEKrXw!kGv9ww*z+;p-EHBPG;e_@i$iUL%&+n-*|cH3OH%1BN0Az<e<_E6qq^o0+C zfejYE6FSrdhman3aV^+c`voB4AtvYPaMdMs>-)#un6R?KV(Za@=qH4_Uz*F<u)Uwq zGL$4I{J85v+AfNh>>X?q1?fg#`uJx<hT$kH5Yq1=l3uE2T2lfQRW`ZgVeM~iWVRR2 zFv4coX76nw1<6!qADho<8BU=w6U(IWW;Eb9N<U>g_8R$#LhjHT2o!tleyfDXCy2EA zZ8D7k>yQwqIv~ZV(Q<~-<=OsnLia_h8Gd_IP%qKu)@t1_Z&0+6%e{-Yt49YCJM{aK zH8H1Y^Fw5>;vttl(qTzVdg1~#q(i<kW}B4;o0vu3@~JE6z#GTi-VAd@so^kp0K?qj zMjb`A$}IbspNz{BUt%Z;^iIQiQ^T0#b>>9^*AFG@rgl=;A$&Ez61t?1$+RwyJ$y6P z=T5B5O#+sdCSZ4<r``~?I!Ck3cuXj#w0SHkbRqG4^SHU~ln_ReQ>#|DQ&n!ivFgt{ zG$)#=znA0!KfbCLfKR}V`&~_yPrEh};1(c@4B2I-ZkwgsL!Ym_x;=suS44#5d>KZR zW^HHV<j5Mx;2u-_hKoqRg~WyEL|lSX{zxy3FjWzp@00__1h5guwHs$bMdg_49@n=7 znP8R<brRB3ZXAyA4>Tpi-genCH-oUfW$k(o67rjqs=6s_ubRmEs6lQXPF}EANP8aq zn^gPzHWT1LS<;g)lRc$34X>X)3m!>B1<Ih-=v9;&o7las2L?u~PU@)7Hrx!nlNmT= ztzRDaPZPU{oh={RNO^AeOj_T25cX$-@)!H^=Z~3&IFwjfhS%F@-iKAb8-}2Z>4x&M zJj&e4?Xn8UgyxIDgV3N<+K5015Sj`&uj;hB%TSt4!*6OU5Tu6NRiL8>HDm~RdKH~D z_30r&zGXR?G|nQjcL$Lfh&H-4ZFl#fn(lw&u>XbR&LjVb#YseM6WKAq?n?VMH8ul0 zf8B+vt7#fZZcdnzG}(QLMA)?XY_h(2Lw>nu9l!p*&P-3w1;aDfwcSFM-@_?6KNsIw z<QcmRRO6@3Dshg|=&v9D{NIW6|Gf!WCcKAOm%e35N?iZnYP9~PluMJaM`=W-kRYPt zC5LN>U?po}D-2J*huzX@OY3h4A?}$x<A*q0WyQZly8r#7YctiBe>2(Z^*;#XzuD|_ zJ}7*sA5(htpDu$S7mpdAS$tjSI)lL4wid+=c|whx8%-pp<!hsp&m5NNl^stq%G%pi zefgV*9VN#h!Ul%%el5h1eg7h}|Ng%#kn%M_RjvD?h~w`c>U;|C70>qWFR}(0>f4>N zveM4ET)VpkR2)@1@&z)tQdEw}9<*_1#g_a!pvb7TPF=hh+n;r0a%t$>{Lnq{rP^x} zyJg>Oxi;L)$Zpz0jr7bQ3Jq9zn_m0Z_b77$Gd3jiQ}vR5FW<llj@MecR-RYyb7jtL zAq>2g9t`JIuS}L<X^sgvsr6E?5Ti^2b!RLeO2|$)`Kf1q2|Eh(loUHxnc#l|1iVx$ z3WvjHEZ<2H@suCDjujDM0wUTD3JbxV*V`MuptqU{=;a3R9OFr6PnEezmjChSJ<xfu zLd*UL0(^TnO<hUOM8<jUH}@78NALn`ih?EiuffLu8iP8P73=#aKi-LxziaHG8h=~G ztw`e(F#n$7G|$No9B()hH%~U`C*?D{DlsYO@tH=DUGGr4wJQ3B5#J)C)yPJ$Rm1C0 zuv5GPrAWS026C>dx{_}Cb@2k(ugB6SkK3B88?uf)_h%b!>~dR3cN-^xW^r|Oi#6Y7 zZ!aIG`yH<q0ISL>>SZ)2*VcDiXijPmaT9kPwS5eob!&L`Z5IvuAH=L|&E}tu99}jx z<=6f|ZiJQiA+9JKkii2IqKz6#;~EY52w#LK(0ul6e~2x<{{*p`o7Zr6PU)}t;vWNU zJQ>fj<;Q2hf2yd;yukaC`Z)Sm*v;Y`q1tEG%sl{2fs>;_h+@t%-z&N(9{ZvA5CsxX z#?l?wg`_Z3#iZrhXF<jJI9lB)l_;BL&!SUTm!~@O$5swb!*9(8R-3QK`R$ht*}jvF z9NH7Y@VaID__^!FuI)X#MY}iZnASI~?$JcIKk5;;5;SEut4#KueKFKz<e1st-`kj} zKl>_zY!od`wbl&tgT{a>O-1Hi=hK585nmpqK{NtJ4kf0_0kD~PYyWlc;NAKA!G<We zk!PS@SnO{2MFQA&G5=x$6=yrtFs=EUSF<_l1D?Ezq89M?R&u3`b-Y^d(+hf2`bmQQ zr}+1YN(Cdl?^4lO$p|I!mMA`46JY>o1mY_`JP~>SrLOM*UHXa_0i%1fXTua`N5q7b z@%dO6Jrk&X!Cj9OERf8qT47${#31*MalpU;VM=(b;VjqF^BS*{tkf)kM{Ia`S?SXD z&Nd6@FK366$ds%H`v7-hO<~q@beIO`+mccjFs4q!@$Fk+9>u7D6x*B@CC+LzlU*YN z>Ptr<ICm~eu%g>KSfcP@zmd9+W#ikOCMFsLgZLZA(^C?qc&SCJ@9fgo`Ca+8pJ;;E zz8i|}viJ5&?u(i>D`enPtd-|h&k1Q!@iL&Foao7HY8jJ`$&lZ?VawEe`ch<OHKO2Q zufe_Ti|RVkijA+N$Hire=(V@CKlgOQ!64E%hEH}q`mf#z1vTkR3D2^W8Th<vwJBi8 za$&i2c>cX=Vc0r4+_kv4Y-W4=fiWzm?xBjt+Y2A6J8!}~DoQIncj&2T9NT=p%5Md? z1$TP0Xn8O|+xjR4UFLr_i&`)in2$cTLBG>xX#X+j^R4r9BXsR`D%gI#cox2;%5_lU zBo64cnRYg9RacE_kly_zSqATXHcc+mYgzHK+_E&k+=Kl$w%6pDJkFPjRZgD&WQzM) zR(j>AOItCfQ>NZJXJk&-;&%0LjKzJVU6Rjy^5pILFOamU&vj8+oa3CFCDj_b`_)CM zH1p9dgCj&N&wnKW0wkKl7lq0zN3w-FBmym%PIPN+9TT$7R^Fiwli{<yR>y#)!8Rn> zojYaTzgSR6lV`hf5VvfnSyRBIKX}UD>jJCAdsE)1&N)Y>`fJCg6ZexL6|hU(Fj%g| z{-YXgw%sA^YvBoXuV(5n`4np-VDhYEv?t7nP6e=}K3rKbH_DK1Ar?DYZNyIx=)SaR zt`374PEte%>pR$46trCoh@wtw6o!@!9ICxv0?)>IQQKwMz@?sRe$~%s?CZD0lF93Q z8v#W!O^qGdb79q~Gq8`>B}m1Xn>$Z#&khT=Wfd_B1eJsoZ~VZgF(mB~ZojNO6!m{i z#_?eLwzH}ldF$0m$u#nN+&d6@MiYoQ2?V>E1e%;4Jjh5{TI_rDzSaZ36w#IAYY!t8 zon>nvtp`=o?Su#kk~1n62IX<n9kqFXxw|j$ziR=AR_nFK{z^8_AmT<`n(>3%$OF-f zQ?khQ7IwP)ff18xDC9hcXLq17z8)sP^lQ_Qj6dKEwSj!8SuTTyPXd;&g+ND1i^$zg zp^OQhIew-T8&5OQg|L&6D#e{UyUD$v-Og!6U86aBILV7zP$3cw<G*iPLN4gNI{I!m zcJ2m4<sNp)BF{Y4>qBOpb@41FHF8X>$oRSI+HU+q%a?Vn1$gJJ$jbSFOQ98Xi4LCX zJ5FN8k7pC9)(xF5n)Z6>bFvzGvyJos(O`=J%gH5KuKw$zqui9lYyefjNdkH?#uSN` zVwdVnG?Q93RsN0R-y*_9t{%4(=l)ZmW1ouEOLG#VO-jZm=MPMlIY+AJtK@uRha29+ z;Gv%Rm+<-6my=xC=d@jn+!wvf-0e6e3!yGJ7(8B7PMMvIMs~Bs%@sdQ6Lr^3k!h}; z@;|&*zuK*awoe0~taVhVT+4h$#t&sxgTP&GuwCkIb@Df|xq?ae^6eT^QDK4J*jg~S z6A+M$5a6xd#}uYj`fFJ?WG+wcWhK}N0A#G&ue?&xG?&K6GdS!Mg?IUSr07clXTxU5 zxb5{B<rA;+YPLm$(s2A*uASJY*~EH$r_sw`<QDD|C)b=9-6torR%vcv2eZ%(xwZvH zAMf~)^u@`-oD92w4_|&Jc(?2(Xdvf6%OWk-uL9s6;g$?U`76eKi~)|pG6y}kpLosP z7Zw__RYy2zlyiY|ocZf>FbfLr%RV0A&zfqO#vP>~@I7MbdN~r;pyYKS!EParFX8Wn z{ni@)#r=ap_p>eD)b@Jt#E;d1t*gLaV2*E{LPo6*o3I(IhIs{9X7(~a+AL;dAQllG zGh%$BwkIz`;RSmssf=FwtnKf-7FZfK!}{a_8=Ic9q<T<&>DJ>`>40eTF;l}_-OD+k zcRO{)o$ATF*j{i^@w{{T#4_Yy_ARepjNjdLUw~tpUrl+Btby)NJhd}ZshM)za6Qvd zk8owiMphx8XKVf?1^w*9(DZG@#n~~!DBh`#BL4{jyKFg8<}UIw3>SI1hDJI@l<z5i zuJMWpYyGmtEKP~-wi?<!J3dP*=$qeQ^U-%1-XY^5ou4EpM<3tC9eEtyUGH)5och+s zn%}s|FVTMlSc=RxO26^1e;mJ}j}zEH6~RkxxicX)0}IaCttWi;1d-d)XXLD&ey8^Y zt1GbWu}dxbpgap%O9P!B+snbWco}qO<iusHyt>G2*&%gguol1KfiqS3rvBNiK1#Mr zUgii0L0fAE%AC(DwNNhw8?r{+GW>KRZUjbu6k(>GxymuMM}utS^?#5s8V6N&XZB|d zdl^9x9})4<4e<feL${G5HTncV2>9$H`e(8lay~2=x!q+VS{DGedC0VL5nAh!?ZNzg zF0e}1%<p}Zfm`yTWO+P#rBE{^u*!_O+1F36MCPIs2>RJ3BN~A4-^odhtJZo>=_OfH zr*9NdUGZ(-b`0$rHu3?=7$%KsDU}3aqi^0WskfYwecOE$vYRf<3r(k>j9vnoUO!%D z^b%aYjf|)@TaX!1A|6)yTqcg{Pxr~FwJ-8>992ibigf4L2$GbX%eg9~PF^l{avfYw zrZ2x+lfL*O4ere!`^?gWJnn2l4x@~A=~mvkS3X2_=BRn#U}l!Y;8fa2T7a)nfp-AY zeK?@2a3<Jr=Nz&;qu(HhK4gkW#1%1TX0Iw88yQ)BdXQIlo!^EWzey($&<t!SQlvw| z1U8*(^~9*>tjI5YkMkhNk)3|#6Wz>pq-?7ydJ+ah&>bUZMGh>5v4%_9bHh1XXDMjU zOqz1nAJMG#Ku-I8LEA=2h}J_tli3Pxf?iXUYcv|wx`>QT6@`gtqvo)7AJu#dm*4J$ z>%sO}s9QXBU0RNR<cijrrQBIWikTJHGg<Cm<Kh{+KCuq>v&)s(dGnjm)|~i9H1|>) z{F`C=k0f`V{EIyM?X~cY3;bOvCV66P>`|*Twfac%n)4|ssX0qaE5LfEA?O6{2V71r zP{*UXquFOdLk8~jE}7ww8mP!}i*pIGidqx`eU@n`9ruRMLE5{N$iBbdSeh7&x?}^N z2Mz%DwoG$@oh4L$@^@+)o98wI+=Hlm&tG|`y+oE@vV)v9u#Ku(e(aT(-NBPD{=n`; zY5j1o86Qt2;C$X1<buFP{V01X`tavQkw!c<4}UpWd1=}4n`bI)<TUnPc-0$On`gvz z6|HlOZGK<<4)ZKzVZ36~*Q{bAx`>J@niNL);z|>BtmlEFeQg`$9RN?$1PEw^pk?oh zMHyyLx^eQN)}&VinRD>*B%?tLHimC&5Ty5lWmA`GCKTtZeM#D_Q4_V-EcaKtX6>An zSoJ+?9~#4L)><D`>prA0Q+leS`>yPC@Rd-o6?<H+M!fY<Am;!F5Z>3NZ~ip(DaB}0 zK-qPb-+mr8aBMoC#D_ce@`T>jh@~u@Omy9ceRg?4Xz4OARmEAZcm4?hKG0RMT0~6r z)`gb`+T1y?p_n<tM5w(OJO>F_G;g_Bqu>|*%+uTG@>ynKldTRqbWr@BoMo32%W^(Y z=1jmHIA0v-px=;tFfQD&(UQ7AjhZmg1}w%eHIQr^yzNo{^qYaO@{p3?CU@lJu2LZe z7yiuw7_e9g$CS3q)mRy*13MerUsk$WPm2ka-zXd)-+m)JryH{Q_A4!(!<2-~?jDcw z{Pg6Q8+0{QIHYheP%PtAM-5y=YmsG`xKsP9YGf}d4oScf*5j%{og~}|Qvdk+4!oO% z_rVj+;_laPAil5n-xIiM?V^K4W~lkzq%`0>q4xZ0#S4$yBiR>SheZS!mKqSX4$<~C z7k(K`e=M4_MO#=`IABZms^QoAWfLGp`%702fFSz%sFZ?0!(%pzg8f@DPHxRdQ2<{} zJn78b*G%h{ov2m*_;pYB=ZlOEhXm2UxQ$bl+8YC1^W<p)zf-OxD!klsyKeu_L4sfb z%p~&0(wW&1SIf9*iV(&-n@k}qM1wHUBcpd2!g)nhH{&QxwoRJgT?*V4r=q3|k`77D z=Y2n&3OlIA9}X{aKPZ2Y+wytbuVsL+i&?n&y`>z-_3A=v`9hhs7k^M=*{=u$UpYyg zW>uY=S(8z!R3EZRrAX_Fs_xKHjGDE|sPN1a5eM~b3DyeyD+qxh3o@~=y|E;*^-D3u zWWR+{#=UW<T^`qIGlWp#5ACd=i!z*GdKPjQ>)bSNhm7*ZStVFTXPkJ1cIaH_Rt-WG z;>AM(ETh6{(zLu*4Vs%~k@RKn<nUjW0^BW<lbNO8P__;VGs$w7x@pDtv569_W#220 z@(BMCW=SVrC6WGs6!yuq<U855Qk+FrCV7a+M==?x&U^cnZVIXSv2il_COL`Bx)?si zHUs$yhU_AedadPji}qO5YdvjNY=Y=*#{8^1W5`OVz2Wkkoj_LuRl(0L;?mHqK=K@O zbGqnlfZXmzA&0()4oO$+^xV`-@01{NZPjv%M#Jl$l{5-vYGW_!^rGJa<fNfLJ8CD2 zUi$ki!4jA<<bZv)jTP{X_<qNIX{=6!2BQoCi-)qkkQ8N^hvyzy)vNH?BEmZ(DlSRr z-Xk12e=_<?CMYSYjtNOj1w*xGs>a0E6B9MAXqGZsK7N~cUTX_yY2@7AY}M|~e@FG) zQ5NvP>9HDZ%(&x-k;UUi%>45|Q91uWS2B73Kv;QeYA`i@zf+c-4EEr|W&;xGD*B*Q zI+dvED|9k)SKUk9B0+;%c}0?8EiF5Z5S&kIs%!X$E_~&5lS81aS}$d<_Ui5I7c9Kf z%RXSOW{IHE>Mg&ux}r*Zfn|?a*<7Z``B_2*{ef6EX?<wT$Q>ET>&G>|DhcQvcSppW z6M2~Yho86c4+qaf_EPRaM?w`GC&$gcI2&5V+$q0neJkI#QrhY}-_WZnn@1kHq%73h z3<{s__h>w0HqWDH|M;pYPnSYf*D&u?Ejk!$BO+PnR(5dE14R36KgLu;RIG+&Bn?wN zf>ob}Xe2M5_Lgx5ICj2W;Z&DG=Q&>klRf9wkGVxvGWj&OluVyD!qgMQjG5%yB%tC+ zs|evQzr*>q9%2)IkR*IH{aa&&=~VwD&kTwPCSVU`O-Z+H+57=P2ItC<kCqsHO9|5D z%F9j7X7@T8c%@c{H&s-%4vXilU#^^Yp%S9pm6|*P;3)*1BGPW>zD|tY%5m_#IbZ;l zJoNG6!JF82?buz{cuCEzDO_`J$sBUJC4})^T@_EoE04oYs{+wAF{_v@QO9cdKxA_x z@%#<$j|;2B=%HfcQ!Ko?xC%zMB7-Hly&W*q@@stP=H#XmlbAW5vTFO>;^q#o;;<xr z>R7uyf14-xMFeJU%RPao6@uLFU6d2MbV^Dc0UDa?=>h(xvZ1@|K?OOEb-O3lWr|L< zB2&RMlxMCF8xy&AM<UwxxOWtPW5%05{}BrizuEk~&{lSt$s>4hCY~|-M^I0SPvDtu zEf(5I_E3^zZP>EUm(vh$Q|ER4cmVQM%O&|hlic3s|8>!S?m)EWZj|lz>SCdqZ4s}h zNrAle)QG5)6xN|e{fGi*B~yS?b1c)R#loa6-0-rzy3WKWlnMLa8{a`?CHh1e%j%!q zC74XUx8KU-QRK*qRiJM_bj|H43%0A-u)(+JN=&jSQVuGgHz2})5-77DS$to$x%-)x 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%0AtjdC=Yawo!&?AoSq<_WoT!*B){*CHr#gKBZB) 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�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%0DH-hF}t}(70MP^-9;d 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 CFT!;I literal 0 HcmV?d00001 diff --git a/docs/images/tutorial-ilm-delete-phase-creation.png b/docs/images/tutorial-ilm-delete-phase-creation.png new file mode 100644 index 0000000000000000000000000000000000000000..91a55733c284e9782c21b802b96da6adf696682b GIT binary patch literal 71022 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%0D%&VtwN{!(}%v>Y78`( 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%0A%ddlZuGX_hJd~KH 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 literal 0 HcmV?d00001 diff --git a/docs/images/tutorial-ilm-delete-rollover.png b/docs/images/tutorial-ilm-delete-rollover.png new file mode 100644 index 0000000000000000000000000000000000000000..ba021ecc2ac5c5cb302fbecafbbb9abc49fecd3c GIT binary patch literal 123735 zcmeFZbzED`)-W1qfdWM;KucTPy=aRTcPS9uU4pxpwm1|GDaBobyBBu}5G1&}yWTwK zoL9d0e)oO)|2@fXXHRC<S|fYSEKNd`6eMx5h_L_w0FJbjm@)u>i7cY9JV8g^5Jb$T z0Kii@OHolJX;D!!B}Y3mOAxY3Dg>;Kp`p@Cn4+yLZQ=h!3bQFh`7x>#X1X|j6hp9# z6e=cl*Y`9dNkRghhTyL_x&#iRRe*A}@hX<kxhf_?RW*1g5R}&_jiT$b=CyINJ}+cG zben5pw*M61$>p8EL^^?y_DPFQG5D!zgsiN2GzrR6d;q~K6ujn7<SQNB-2l2r2Y!7! zJAltkCAImr&3g|eMr1GP9|Opa@Xav^zM=+SJo*B8Vsb132nOZVBx}*BEIkd5SY`VZ zY|4<7`8%5-Df>6jDlzLZOGg8MZ0yq80~b&~s5H#*eDxE_Tq1shY`}ARfTv0Dx5q}! z_{(&`K?E=5)C?^!lFFMGd#^Ce;bgR_sT{#vb$J1AX+HNHUyVHsJKoyS_o(Au+JA|l ziI=3#a}0E8NZ|RX6<~?)CR<^&LdO055-OHg9rP+Y6#TiD*lS!TZL#ea3Qfnph_41` z$2z{G)QPci<#iEA`Z1o-2hkDB7!kb~*Ikil3jWXinv|(Y_&i@K)^vWjf*$D?pBI)3 z<qycNTU^<NiZ`O%t9LGEsRri*48|#>WtckZ@!!xNKhNai{wZJf^9`Q?r8-UCa?Q7& z%rO#yR+nYrAP=#xa6PrOS3N|GFJ#@zv~+-U3ZbxZ3<UjR;R=s`?PsbrD!jwsmn%l- zj?Y5d+PLbBZ73|ux%GEbir6@X`Kl%3NlU7_doymO!1L%v9O9odT$uz5@D-$Rgh(hE z!xdp2A?EAHlHJzJzr#K~UHr<{iYhZz-f9wsO=UADKX(Ypp+!CPf4d5JW<O?yE|FE> zm35f#B=mPGe#jRid!4*`^~a%U_bX{?C(e(ix92I&g82_$Eu-S&952~rd&W7BXk)oQ z=8Cav#5O3pD$T!co^VK`ktqC(dsu#o&J?oL!DjUG{nyR##3f;O0Li0N@=}jw(5xNV z%<%d5?(eQ`kJ`9IFqYs{(jm8n8eLy-dq~p<KkW2}J7Dx|MFcJTN4;ZTk(+&5yF{5z zic9iTz)O@_{Y?#n8@#30iR~M!RdH2jt%_0~zRZ)(t)1w4miqZ`Oa-C7nxyhYn%{tH zxaZz`sW;-u0f+DIs;H~+5kbjaKa9=GL^WO*7)q9z?V`GB1Ym58P@cUdK8#QML5p`R z)qK=Fd94amUeY_5U%MAZU|@-lsoqd7D#Xh}WF0#Km~dyW#F<i5*}Px%kIjv}15CJy zRmeA)6tv(yIhi$|^RA75lzn%17bLiovGAyLftcmw$1rbqzdhd<ue*db)a*v7%yuB& z#H2J{F`bG5CdmKAK+lWIF93Yhw%-=`7%`uSe?Hk^3Ov!o&H0*OKtlJ3z~Hq84%|P& z0DB6>_pz7oiw}=~eA93Bu*cMSRI_xu^?3Lbo;%Jp{$p}-=kNYMDb#`mmP6esKvYjK zC5@sUQ{nWAIpWi2h?!BGL}QttmE%r_kCO|LV??j?XlA{u3z(Ixk7|j&pbLa4QI4a! ze3DE9#eI{=l-_*IiIM!3Ff)7ec_kK9+$}v~)8Ulg6KC&JYI@VFR%bREvxquFP<U9U z;g$wBO}Clxng+F67?%O_VQTYN7lXMezNBCdd%}J64f~fV;n;`tmmu%=&A1ExJj=94 zjF&!*7!P7;F9tA+AN!$3vi*n>{V797srtP787{uU?}>3~cX_Jk31X5NtU3{v9XiWT zmyMP^mu;8d8}S{HmqElR5@K|u{j)wiPgRv-poCKIQM{wprE!Uwk8$ZyGf{MW{4tq{ z8WP3W%hxN}1L;-l@p<VJD$tqwT=JQ6j!L|8wXzl+5q)x;U;)ZRG_jO?#=7#x=fXUk zag}ktaR@IjFE_6*udxdiuairG^Z91dXkE$44>KvJbO+1VoYXd$Hhg=p_6YZ=lNH?3 zf=0%+0#2z<d9N|A1+KMq1NZH9Q;L<`e%MyoX6~ELZFs&E@DlhjFV<w#B-7;MNpx0! zMt_Zat>e>t54y9u`*zK9>V@+Podn$h9SuDU$CWsV%iT(f-I?tv&r9NXV%zuphL=(P z??JD10>8XZEdx7*j#`RwI&v<*ULyv+y0aKJ8#e}7@WVcIy8m*hIx<|rrRj1uIR1Gx zkUh{eurqKW$`oiH7#zq%3}ah8j^d#al^2l{qgkVAkS|VX<S|VMOk7W3;jv+FvJOnF z`x(KNXjT1tH%{|HDKi~K6iu{0X#d@H;zz4}qZ9+dcJHt&v=cpS*)S>Wgifun7ld>1 za{c)II{m<SNv4LPS8Bp)&kKQSlF)mD*A*X%ywwPHs0zDhW_kOxESsk52kVEsMro#V zI?QSYb+rqa5!?t@uuY*&WHNZ}RYQX7nQP0m%I@^J(GAym?%u+O54>5tO!gLz?%Nj2 zJx)xnMQ)8NVs2Qjzm`>ZoF@`C2V94o^bWjx(OiyPpEam9=s1h(`sh#>@8}|eo&{dv z#Nrmdb8U}U?{Z*tEOcuSO8Ure=H7dlvotI@6(L1h=H0RNEOoYN?qsf}e&L+$^wr+y z<<aG%n%uD5){2>v0-`y_HtQei6_a7n#gyWdJmHO7gNGz5O|1<RH<^(ok+ZqKbNeTU zc*bhFF3=Id?}qgT1Xm;vvCk4$+<Fd@TO$3^AM_qtP-jt(QC-pb->rR+;k4Sx3-ago zzil1#e<xg&HjpMS{O&jW_wC}$A_jRid0UhXx#EYRB%L9ap%bMGC67)25gr}CeWv{~ zHYO(aBK{)gSvLNU-ny4fPZEQZg0F*9qz-ysM|WpD`8@i$KhyS*$sJYiU5R<+!KP-W zqQqFni_A%Jp<suQ=<dpJ;qGvf3dezDjT;S1kjmTOl}>1Q!<&OwLe%#gWgTTl#)aL2 z3WriZ6YP1Tqd(9)m@n^Sjbvp@*Tg2rfP10zp7gKjUFhwU+m+R`T*KeIw}sc9SejYJ zRIWQKd&*o_pUxjGt*A#H3>*&8_16mic4(`_G^hO~KalF~9y3pMpXHPAePDbbIf3-j z;a1Dnj*zvGrckn#py(O@i@+!9m<?k783Y-$)Be+p<*DnB*NX<Wo@0bDcFsL7Hc4I; zw^iNmn&t6u@IahgpQxO;5k+CMW8=!;WP8A3W0`3c6K7eRz~ElqoJ&Pbfow?<=7pS3 zFJHVI43Ic%^%dUAx>fLKq07sw-`pFI%fHEaEf=fMz&2-kow21DN*U_+(|;I$z#`dF zz-fNqrs6{d_ppSS`JipGF<-8;!p3Y*9pC!rjkUp>s*WZT@!rC#{1a^%W|@t6!CRK& zhHLgYc8}=@G!$%ZmJT8r!fNJYtxDI?Tt~yJI;@M(zEHd{w6I~HgCn1bi#yqJNG0=` zX1(EShXm*8v$fy-ZbfVwpBtB#`rb3XQ7=;imv~lr!nP~Gl#D#Z>BXOmxAH>st@NyG zT&HL7b~<*7fkA2q#qUcrRZq;C?C;ia$lnliYk`WUE`4K7#s&wY6W>_Bvtq2luX$<X z(a2@Gvqd^3G;YIzP%GP8aosxq@eY$u0e%Ia*yCKNt0aM{!`=4!rd+nVOGy*o%o1}S znC%x&JvyhmxII!?SDd_%IIx-Po}VmT@bw!+>GD68$a3&BR*bF9&-@6jyIb7+24zNJ z#_%P%KRFkL2NmGGA=UHz?wNHe^)R}e+0<>)T_3se)^Cb8|Li=(fwnm1tylS;>S;bl zi`cE>GUvwWD2Kl}Zt|Is*Wue6oiUHplL(?l*0+}vH<OQS1Z^USd|0{lj~m8ef(3Uy zYm5EeCEs<g)))@9udK@^XG&=GTRbRNB)a9726JnU?V2v3n>Eb{rvv=`xP^%pZI9tw zy}g5>mV^Dntq<NpyY~SYA$YbzFZsRCrH(d5&9{uNSNdqx6t`161qH?lMqRcdkNlhk zV+D40SZ>A^hktD-3|~AD98U(MI0z)OuCiV~=-t9j*Ur@`^{dXiF6O;-59<%)ue8T% z_~y$Nl6_OJ@1+;U@v`uMq{%|n-l6x-xh-ie`dyHd2}zWv+?;%GzO>Xl`lR^iivwl~ zX_xiBhm|m=n+g}|1E%%<SF0nGG?Zr5ZkPS{fb-UMHX_IN9Nq%j0Kj;^b*ZIz^xj(j zQpWE$cuO{Z53<+*DQ19o+{MKO^x)v3mH^!g`-`y(=Y=d7e`(G@B^XPW<Jl0Jes2rl zo3o#RC!wbr(!7W_)sQxmmj^H)%TEAkD9-_p{<1xgZvYB00PP=T06+%i&3~4aQRw~! zg9-oySppva3q}ih|LYZnypY)cx<85u1YjV)Jx5;O(@_5d8WWKA=s(IREXX#1u!^X( zH1e)u>}YCg>ttc)yvQq1fULl@m(p|s00^o7x=^H*sSW`ERA)<74QCB`IbLHs8x}(o zJ0nvTcN_b^=m7ZLd67jMQ)fdmcN>tc6R*1f#Xlf;k>$UtSt-c=0pe^eK%pV8L?&wI zXiCP#!pXu$A&5mrM#k@GV#cd1Ch;$H<Tn8d3ukA0URG8&H#ZhH4i-B{bJq7CKYnCo zV`pV&XGTIWJ9*eT8@e;wI#K?U$bZlgGj%d{w6u4&w6i7qi>{%Oor|*o1;t+-{pahS z<8-z(`>&pCo&Gf~<OEs&YGHlP!p8c4Lo;=^{Qp4vtL2|)|CrZ5yW{_h7_XwEr73d2 ze+^6UJ^w#C_&@6YYk2>JS2lIB1G)SK4z#s&7G(by%KxbTZ&-iz%?orgbriL;u|akv z_+QVJpY{LM_&*VqEZt2(8e*16OsBtw$j-%q?D8LI|Fh};imLfvs2u+%=6`GX7bZXJ zU(e;gJ*R&%!9Qw|Tp)<W&-$MnC5WYK<ZuoEd;&;|39GuJ?9O56Oq|_!A4R5RkUh!x z@&t81!7DK#Qvh@TI)F~t%(*_C&+l+ULGFo@eXu@VTPH<TokfEuPqrUUu1K2Q#W*Y2 z%O*>(H<A`E@0(jTE`lz8f3y=^kU=;<BYcei34roPA9+!z<OJoD&cuHP{ukLK01BDy z<3FPQ7dS&H03{8J-`)A$A9sQJY4*_*vM&JCKlxBKKtcUP;C{Ht`$yn^k$wE77UR!X zs1*s%aJV??^2bwt0&u|l)8UgT`J+7n02hB}?)=GY|3MZXuuSr&5BO6WDmFf#p!J*N z<g-7;Ap>*>{Nd`8effk&NCr^#$A~PZ{8OAyfMBmb<j+q4e=Md?fIL(@5?#qZ#X*|G z7k|b)e=R40#utDR8VP^>k3YsiA>03BX8!jE_?xZp?+x(3^U}XJz~3B<|CRv%`@#5c z3Gg?X!M`QI|E?M2{r^t|%F~I)thPa%H`MFrD`ziMJv7hO?N;p$`^-UD{5I-d#kMH= zIgJu(Cf9vFKIZAKhPE7R+#c+l`Ma#kkdr@u{TaAyoSEggHu7j^xt92EHOEE3i@YrI zAivq%o%<Nf>9+=M91y2ZPc$ygd&{fJ>)gZiA_LBMQ|TToAe*TWoKv(1m2>TzOJg4d z+;)29+vL?bC|L-e@&I2(T-adL7<XS+yH@E>@43nyHvis3JJ8lcRI|7r?M>AmUlUpI z6<HBT%N9V%$*{W6c8=cu@A3!PI+gmE!5Kiu%BmO|8k(&f?5ngV)WRY;S*@P0qgkMu zpFwJLpmA!k1BX7(0JGc=nX33UgIH#D9N!^y{3s|XFDxP6bPShS5365Pn}0|z;Tk_@ zh>qs^>fwG*gvq2`r@+0w+Anl<e-mbLQJ{HKldd-SL^?cjzHsH^lfNC@r^OPYsrNW1 zlc@)IslNros|~)Oan5`1yn8L+nbgq*k73p>(vnK(bQI?GQF3>8$ya9`^`VAC8C{l_ zv()4&JGL?d{Jbws^)Ya7tGth{h>q_^6se?denM)bV`8@ZS`KP;MMN)j+438$FYXvK zJwLUaPTpP->G$1`dKVd|8^<(AE30hxzjK>i-UlBS;abG`cstZ3az3pgRh+De{CFNV zwzf{RPjr{|;%_9`Uz*YywrVXPswF%rNhjgGPkkfLsyxmqRo_h2&TY<KBzJ?RR9+8U z9x(~#=QCeKbKIt<mF_2GrebEEfX+cCzIcyxe3g}jutXb@wy@?~Mws+2qrqzI{Ggyp z%}1XmbXv|kYi_@y(pOu_5I0U$+Z3wF7BEZ{1l(n!vi>%X(KD076}pvr7pQ&SsdT$C zTqa-WShlN=s?8<U`}Obj<I)E#)hR#}a6ey-89z!|N-FBt=%{~wg_YPYTQ($sm&wGK z)Ij@l^vH-3=7ez&&W-B4?}>}0j}ooN;lqA(JKn)T^<F=IR0}f`$XFHxDnkFlPL&}M z;iHDq8Kf78d#4o7s=XxV<mj}T28XUq8ApziDXsabKI!TDEuzHtqt}RsraHou^vUM% z)_%?@0z+W&<sYp16ID8YtT%x2@2&Arf6ErEN>6!V;dD?RYm|qRSv()0YI_{~y>^CW zF{VmTdwFFg3)pYQ?lt87@p_YTt(P`6K8&SViK4Cj!eg;hM6&uN;S48VVpeVKRMR|U zVczdR;I-hbUv_Te^|p1k-$OI;_YfxC3q=p3^t?Uea!ppR{snfLhnEM*#V4dnpe~F9 z*LqjAztNiiVQZBVp%Q!mRNh%J2B^lYF~VgoifvZ=Xi34r!S>Sy<UjDCtIDdXSt_9H z{;XaVm-^D-(=?oG0tWeCT#!!Lcxi8)chd6GF+0T#T><>X&DS#dT2<SEcqle4zgjjl zn>?lWJCYlmAt5iiWaQ++)!Hzxym;F+pIwHbF@0GfD!i;@CE}|AQk;-i_;}b31^hjK z*c)KI#YaiQ$1VW%#&>jxeO#Z)%$5-Qj(xakqOf0<XHlUxIn6Z8e^;x9#SoR7>Y+#C zyNM!gJ*DdCc#`$0#$|gJh>q7R%<HmE)#Q0LYp!Cy$65n^Jsnd>QvK3y`T`g{8*&xc zs?TKLpV|kmc^ETSd5n(n^}c=#!TFthe<7ZLF<v^E_vkqxA&qv?@}wXx`JKz8RR13^ ziC<9bx#I7K9~BS18&5GYqZz=3!2;;4U`BPw_Cz71xc;WtPc~JsX)U-NFLoSVz5^9t z4L6Z)?;2dqLox4Zn~t4*X_$@iwpCH4Ff|U7Oci#h8my*Pp6#59wOA^j8(7i&Fdb%B zMxl8-jZV-cfPJN!uPm-sqDO7)OPv2Zk(t+Kk!EZ1flfLvF^@d0Rn^<?l=n`+DAHBo z!4&A{=;*jQW+=MW<Tf8C5s}z)hbKTD9sT**E(&e`R`*=etM%v)Ci%eW|A+yQm0Af= zC^ROmzrkDH^Egz7YW;lctKpZx;a1FPJ)^2sW6QY1vo57!@pBcb&+>40%29Wjf$fU* zT=UKEJ=^Je;JW1-q5BV7Y9>W-1dM96eIGH8FqL`8g|9CT80CL)x~6|C??%5cw@c9$ z;<lZoTkyU~X40zE7;e&mmn@J~S#?^NMt|5ENpCvktqoELBK*9KKO0n3<Z`?he8Bm% zOrnkJEtlQA2qsQgbfbKtbBz`I(uV#j@=SJ}h%2&^R#2#Z%75|Jrr{iS4hMI3%Go-W zMlt$mg|@E%$Y{FO2UOM+#dA11f|VLR+Cm=DS>uZFGN!0ne4LkWSQ{UX*ZNI+yhx>- zox|V6er-ejxKYG0cV;(T4m2A|qSwDWu$ER-gn)2#$6<HRx4UFFhLW?qYKn(C71j_p z5o7gtw}KuX9-a{|OvWRHdg}+6rhg_gpKVV#8PAoAJ3%QXM&*xIFIW%WUp5kc(k^$- z4}W`=X<}j`)zt@Pp?h9v{F;b}mRY+ps@Vq*Ow45!=cO2rXr50joGb>X`Vv!)<th@r zIly_tEv2d&R~QFQQdO+a7p*Xpm&L=|SJ{&BdEPjmGMvDtC=p4*+#e6Mzi5nTIIBoe zTjV_*5zR8~C(OR^w&(M^aN6+-o{!v;CG3at=+cIq#ZZef9<6TQIV^RmO97!>CqcPu zuo1;{wbvCl3nBupe(+G}-b~fu=&`Bnn!lH=+siPbK}Z;DlZ;liZDtAP!|mJ!#>U_K zX&A~|{RsfD=)?5XMPd4eAq-+-E)dm0GoRQHY*DJ=JlSM$hDo}3K}pZ|4CmuRqf@rk zM8WUDUHtDqKOC8R+~()5eIq}J+chR#yt%XCW%kmevq8AUZlrh&1c)#J7Ke2mNAv`W zCJeg$=H0bzn=O?_j)12gdA<Z&5FmTm{r4W@NTKaEx#;NV{n`6lMlO@%)^CwL;rT+c z*$ku4)pK*GIy$93e=ZxBRfw}3Gw%zwYj)eq<^nN=5e<PUBR_cOB842H4A9dPE!30j zw!pg5{R3u9aa#DPrASd5RiB)zQhVBQX3M<)UCqL>2u1yp8>=r9Gsxvc{#&+TrWp%} z-TeIN$FtQJb6kR#BkhhiHZ^gTHZ;{5LLj+NYN!LY$8t2r>XW9F($WGiP8zkQ&Uooq z8tD>WTG^$XvvSi4piNn89Ny1_EAG0}W5&5FW_;tYg9@+D$Aj<$gcy$2+(WDAaSN-^ z1oP6hsV!VlD4yE)InBexq7QK!uk1D)+JF#b)o&Kj8$X2KT`W*eQ0_?iD#TY4<;Yt# z6vN~UrEdZpJHeAZRg*evZL)A$Kfg^}TTEX8(``<V%joXaJ94`n?!r9Ny{T6Sql?BL zWvf!{G|;sPNNVgiuk#VI@gEblpy3wdvYpb@mVqj3lkpxqT_TV!Xzzo^dT-ELl0T8O zMwL~=-mg9V`Q`4(Hc@aD>h#wur?vV*R=EAB<HxJ<iq&QeQi#zz>o*7Azl+sf&m^uU z<dVe0ZDyqJ;#A%IG@cC19NB;c6sMgq4%A%}g}B{GTYgCXt-1~Hf26Yb1skx}%QlU% za&FiZ@WRtdD*fhn(00)IiEaSF4Vmxpu(8Qfn>eh|qXM?RE9&Z(1Wft3vCBct#4n)? zBW}Q#=7N&M6oL(z@KrJ;zQ44cF9PZuQ*k&|oo<fmlK9+W*4@HnsrY9_NLu`kHd2NB z{B>NXfyZ|j`mzNn+I-Z}p3Q^AEK@ofn=>`^BjsnaYW^l8IFr5RsXp{2P1j%5mMk}O z_)b)^#3jY8zT|`y23FYKNz9o|=6!rum0t{u`Nd_oTl|r?J_j3sb}@57OG~Rh@4g~m zCm~8Ts9hPq8YiK}MW@3ERgIBPJkBl%WNE8}-rl0_=|{``WYg2CvZ7D*W|vd=VEDxv zRzom*ZzpiEguavb&Mpin=6N3gS#9<@h>wTPSS@CjW9v>epPR0HR@GtB4#hHQ{j#!p zM4J*L%hD`W;^$`k+=5T+0NksRBh&rkUG{{qO;!2lw1O~?>8*;1-)$-roJyxK?BQPP z5<jXJ-8c}}y%}C7QnKSoQ{eY`U-Muc-)U-Pp{nS>V&Ym~)d|5wOJCu1F>#67{2gwy z4XN+*JT<pF5(zB^&9g{likK?IZDq9^R>LRCNcwKPzG^%?1X77E&-J5Ho?<M<<l79B zcD?d;$0V#&-G-j7vh_#L$#4@@N%LKF_}#seI#*wfaip)#?$HTrbJR*Cp8|}Sd-R^$ zb<z@C$!*z5hp+|b48X(Bp0AF~H?2Oy!Pd>0GzW)yYyaLmKx`m5lT<Xhtq8IvIg{ex zY0*r2m1&%(9CrImI6E#grVx;4>BvZ5F^=ECG}m+sQK#oz^^}H2+Q3(_(f3t4fF6<W zhK3Wfcjh<n&<JoCYm3%3iE9@2gX*LM&M1~P;oI`_(6F#sV|z)E4}nehd4*{|ocY%Z z1It`V`F(gm;P?7e-8tZ-9rK?0^bKXLZpt5c-QRvdedqy1;iUSo*^(Abmgwu-5<4fO zi~N9i5(6|6>xQcP4oh0-aRAf4_o5Fx3!aiJAN<lPEfIR61a&NQ#uMg!+C^>M*JsnP zN=?Ss-tA{BZ=I29Q(VoC?WCrCD=Jlm*<gHTq=05T(=X~lPLPTPIqn`Jd`rcZx7i_f zy<9%_RRl2)gjB+Z(HyT)DbVNEpK8-tr+VsaShrFH&Xl^LH(3Ox`^;6a^U_RP$DYQg z*Ge~arTWTlzSZlch1A-pBq_vezfOhMWuHbCrfxxyKIM30Z1Z+Jr%6E;Os!k*3VET( zFPzKzhWzg4jJfJ;<4PbB4v|Zqmthd^(REwM9ZP419V))La#<fw{*|9Pqr_Ahlh`2r zi_?Z4nHdAcR(?w2Eo%8QV^<jND`FHXm%^`$j&~2y6Xk1?g!lIm$huBd8D{1@FR<BI zvx$LYR5_uG&U+~m^Vsg98qN=pp28SQ`qFkvVhLv^U3R!-K+w&1*GaInx<Hs&!(1Y_ zH9g_T_DES+<NbF3bCrsmS%+>LWfjtI2;B;^2<(SS7=1QU#hnnFy{j>aj&N|<n#;{) z(ydk=<`}F>oJkAew1jJLTfW+wJz<Sr(#MTmU0qei7Md4D8fywdd#XIPvSS=n+-f(x z#^(CgmGTJOaz~dO=Y5#GZKFdJHk;;?JP@GI#emee!g3djiwu&|+>y-1$~t+*#mb{j z$n=wu6!+aS>L=GhGvY=KvLO+H={Gz**Djj-<{ef7nuj#(>@wZtGXZ6w?UJH_s+eZy zkVN!>nW?;PjS-8Jb&-&e5U@Rt479&5jyRgjS*yBAS$kUwUN5Iko+kq?P}a^pK>U`u zF)C3n85qIWZNAYgbCTGaLJXJM^ux{_or&wA#J6QpN?d!^ap(DgYIo&=R}N2`Y5s`4 zHBcXrMkkJO8kSO?nu@f2rWJvch{$f{oszVE^#HWOPSE7NVVfAy{YR-sBs)B-ae;nA z@7(>>BtL3dNp$yc<6vt5;|`i{^iq7UrJ?xaJwPYvf`wM#ilvj1^%kNglJ6qLo9*Dn zV!}qx^U9RyzAUQq8b__nJgi8gT4S<>BA*wmWU;2Cj%G2s-03(0R<FJ1v4ypvMRi49 z36ps3O4mI!H_VNjxxCov!?0_~GW@ASWb1yJE@{#cY?tk?_E@XZ;75|@_G`y&%iP*N z4!DwkAnooeZSR(rn|m*!`z`pLK?0Y#Kc}sRzVDUC*IDP2mMrr~5|%FpDx^^T7Ck|d zbN$!X_xP3z=@m>GamD`W#f};ezQoNMdEgM@TGxwnZHFU5X_-(6Ys<An%r<o}T6uB9 zKKd3cyFx7|Kb<@TU$cnDP3W*Ti#1`7zsN{&&NJV!dk(MfH^znY&9ADK>cwV_k+xzX zO5?hL<decm(46po!v-#n^SC2<VwE+#FI#J_H)mSLCMv`K2M){b=_VzfY{@sgc;iTc z98OiEy@%@^CXfATB3&hm_O7?ko)<_pRz8|zh+k4+)N;Vc*xI@i!oYI)-Wp!wcm`CL z{uU^2nvY(DyFa1bee~?(Zt4AgKT=_Z+pzDB4bS%9-VW~nvU%I!c0f&}d+G<Pv{VTh zk>Mx&s#$z-{>HAEx#gC<S3V5<>la0)A2Ia{ntO^6UYmpf8Sf`uBIbn1C2h(bNUqU< zDaV??SYNEpIt@Eb0t?lcc~G>F=7ZcTq0c1VhbTlpv`g9M&;pC=x3MfoGwMzSD{I!G z@8dg*J98e&(*_#snpoafS@r*#C|s@fTVUldmvcf%Qxtm5fILPa*e8$OV7^^NUx#6x zVXGAnzEs14XHr}1-#a`V2j0_4J+w#0d^<IFgetJQ4(rzR{3MmMdXigzul<}s-&b(J zXIhxGMNo{_Ws8NC|KhvCyUTcM^MMZiwe!T1*rS!M&2iha)jG(0+&Z&%gUlz_5{;L= zB>LX_(jEtMJhShITW;e|$FM}s55mtDt_4?<A8KvRp>{2lS=y0$u$4toD&WH%J;Tgy zn@Bd_;p0DWw0(JTDT(oA_nV7$!FHv<bK-*>z4Fo^v@h^t-JNPp_g1*6nOW}*=~I`T zYKtimV_{<SgnZ#xVaIO@72u?#Rpfb2$RI5(4>nKn5f&O)C^Ag9vK{ktt}oJS^4y9O zLWmOH|C|%}QTl0AMREJ3sxFoB1aa@!Ruy-#Hg#rqIGALvVb4A<fRMM+j`bV*0+n(1 zZC-kc8S%VyG&!j^og|4z?dd3+gq(Bb>AsKDmcxN%6>)?Z_`Jd+%*^qtnmCqw+`bxd zpjMqD_^s3FXDx6}#ejaT7%`WW>r!fNs;@#jxw&-|h1HGlb&+*Vu~u>pc-9vI^_Tf% zT~5Wot1$1rV^g=YP}4Bdi;HnPM5I=irzd^6F}<M|rK0#zb9+-&-M7pEG@lW`e|t!I ze0Erp6rvYixOxJUE!jL(f2U*7g`t1za6g)J{)>-Rm!)~tk!aOwrZQw<m4wfAn+~!) zuFxWv#3J46kd5+-T9(lI3_^jU3#7;K(e>T}ms>2ob<?>ye^*sM!peTxl~_eF>Ozc) z`F+%Tr3r6~y2^SonnOWIo@t=U(`B*w?OD4bEMJ8dhg`ftw`RLi$*$=xB~fM|XSqO& zTGa}!5Y2bcDEdw0&f96ftm1rvLEi<|oinIadl+d`dKev1D9>sp^d`}TxB=t-fV?U4 zO>g-c;~7cGPMgr=0-IEE-L+NOqS7I(Mp1u`M?9CSVH`MF7OJF%v$cy|5+z=dYY|1m z<bL6EJDc;RKbllB!hS=*wv`^1t*wZYYYIL$KE+$;AMH-oxb`fZSK$_i1o#aJorr0c zIf`#_dzCX72Q*$ESM2X3;|V$mjS=3Lb>0V*j(j#;BD|Psw&|<cf}yH}T!DcTSxxtH z!$05a?x}CCs6xfYe*>SErwSyxf|lB@_WOT)yo?frRqIL;-6wLd5xsVYOE>4kx(_6t z65W)q#STkuzN&OFEH4-8&&K$ZU69s>tueDk+M)se*?#Q?qc2heKmIIY3PvXf9r;JC z^+Wn&75QoAyxuZR6I1mJ4S{7@nnY}yuOyIiV<h4R#=tJFbw)!&BT?M6&VU0<S}ZvI zZb9(tuxCa~+|*x#njBl>vf7OcP(3GDsb6OW4kteQhG3@U8BWek%Zmwr!!sY?2NFX1 z-Ac=>KDf$F7VFM(ekPwV))oJy#oMVWaV?U-$Aiy*bjJ)Y4Q5u$?<T~in=04LCF&n# z_~_3arhDT`vQq;+xhuos=H8pk(x>TDQ52wr=r~4WKU|*gjkbL}bFs?DX02@n)+Gqq zlxw8XaC1wfc-(U(b2APnpG10B<TtGk=`uYupV%U;bAOiGm7B$q(XWadscw3UoMt(b z<m6l?^S4**rhRd`KcoqgWo*h6GF`?$H?8R<?+>&InJprCAm@8Cz3q7OB{p_WDixZW z-SO12klsL?ojIq6y){S*I8yLl%(m_f7b&-GTSIu8rf^tpjeV+IeQvnpB}rYf6t3Vy zP(;Co4BSfDxLe*n9d{u|fJL*hWADW?J>6WqMC6?80|UKzYjt;1PHnVE`CNC&+5>%P zqPdLM=5I)%A_cECx*|zgM@PA26Dwtu51LPM)INuf$S6&8qS8+4c{R;`aF0SR%1({s zj$4+3waaJ#Q4eJ#Kh0Q<LX10(!P<75#p^Kh{-io5S;X9=;sBd|JCBg!D{as1=DWzK z%ge_&>Yd=?8{~N{^UXr7x3D1aJf2k+a<kuD#d+%l|44+4A^6aX2Kur<bR3|3-1)u* zPwUs8^W4FCGHH4q;R)n}<F>bal+q^rf5aQ=d$S(+Tm~ez4KlC+iyH;pERA6YrI}Q$ zJZy9Gp=<r83-J-fq}798jbmwkKtfi!Yn`~PW>uFf7o5x<7;0wSp;T~L*PVm<1H-G$ zF}vBxHTAi)ZZy;&R;#M?iR*))<gtB~KS&<?%X%h#2RJ79l0iY4Eu9%y4*ej>uyZP@ zOfS~XI?cjnxa2Q_(=M05J~4;#@uSCcWIh|W#aXiOw_>LWWhTI9>5B><QBE>r(rWF+ zwjAa1tyo^yZJLvHrkHDKOf7P=BDrKji=7(5s0##h_~|Z(VqG68+6-iZkz*D9TfH_a zGT<?C2e?t+4d*nJPr`G3eQx@wH<Fha&@_Rsv_Uhp*c_S*yVrZ8gm&q}s3k58oCveM znaqU+Zmk=&x?DZSUri%lMm>{77}+L(KheE*b%rQ<I#4OpG}phLVAP)%0t*?mYe3+L zgnpCd;g(t#zg2CMh$qYjafRfWCsaD^41{q<ceuDhN%n0=EL4>iOFH=(E90fYG2yT8 zzR4xj7rxJ@LPHBEwl+_7st%M`)}5lB>g1mJ@OHK$_pO7N9h8LNXNr7QePGPGWf~>^ ze(BvnF|a@0aT)W`YR((GC~DdG9!AzCvLgov+kwWqy`An3h7ISfw?EGZ;Q>MFvH2W? zwRbi`Evoqi;3DU;K7k|5UUswH$2^^h&<a<ZGGA+=S)_&`+2<$Zt6zAfL;nc<>B#%t z3>9^>uaxlN;g(C8HVPw`f_!gXQj42Y4u!EaWnFUvpQ9Df9zwtlj+CU|JK#2C+&0N` zvC4HhPjBoDJj+`XE|xB0Zd$KhyP0{Uth7Ykj_X}s%>C3vD@379UWYSluql4i!yea- z07a1SZEYMKxA#0l+V%cP4)80-BUAMqPQAG-r^$WCeGj63uE_<a{xOJ!X%4X5_Kw#Q zUX)!43*|GU{(%h4xy&>uz|vKSnjT*0jtmV{vmz?XRXCtY<E>C)u48SSivifSFrphK zB3!LeMV4p_Y7cZdp69cxrQc##V~Xug^_5oOU6X?rO$^<=aTsb1TdjSe0K-@M>CJH~ zt6tTcqMa9l_6HhI>&qwiRM)MIZF4%{k|0CFASgB1?si|><rgbyYbh4X0nXhNP_GP& zMD6v)NVBArmQ?{_E`Xc!so~8HYvO%({P`Y2dP8CFOtU%hc@KPTZEdFAmS`td=%EkH zIM?i&!oXV<3*U*3Rm7CLTY2<qzma&ROj6tYW`@&PZL2fB?dza22aPa|VlsK*<l~%Z z$2aH8+G=X?*n}EN8G-0_YQ-7_6H!A%Lez0+){Wl|BGE)a($dn=a2q~r1B$UTMOvAd z>550dkn;@2{iwt336rkVX~*`oL@I?xMAa6%CPAHYOfP{zQFh%1XSfZQNv4`ZK?Z>u zsFx|>c(Ccobxu;b#3KQl8P_;MUglrSW^WonEnP~M<9X3J{#ZIL>2c#?ukTKt;*5Y8 z=H||;N}~iMb~r)n&vKVY-`H7C!f(#Kl}un+y~m@atU4|vg-j;#Z#andoQGXO3u;Vc zYI!$e;^KW%qm*kYUI!4QcY8$y8OXL<7&6}*FNEaXNNm-K>a>8GnBm>5f)6rng+X=n z$2s!JOpk^elwdH}tScXPt$_99!U=NPj$2pey)bHQ&JQnhHeTY047yEj;vz$Er>ori z{SamsbKP?Hbe#gQSIkasZNaCiosKPMi+o$easc+~&9j9M*bVW(LiW{-kd@i$Q|hqQ zq!Sh-M@knPfg|#Pc)VAY6|24G`rsf^KRrhOiOKvc$80ho{dR5?$-<&4OO=!x2BbE9 zTZ6VNUaae76`z~pTkR!aH^fxd8VM~d^7+Z*RxOvz-fL6gTWyIDMzBVuAGGYjaT*ud zw<a1&#K!ZML^KJVWk$Zh*VJ_na-LNr7iC06D5gp7vo(|deRkzr160ID#>Z9`P$Wxt z8}9XQ_a6#dTz2=U`OgXWatdLJ2QFA8TG{d%;)!-aco0J7#D1E)!#O>3vtlqZ);1&` zX<`_1Oo*+bv1sx`&Hou@?BMlMBXb=w+3|$3t4q<IIq8h{S$cTPR?qIw!9-|`;?Jj~ z_Yt>;?TQV!z|HIc3$o4bR0&zRJ+Zq(zeI)6mn<r@gJYrGXz)htfK7Vei*m=c?bi36 zKHQzL%(1kJ6KS1(&fBFT>NxbJ?dJz(hUuZFr_R$^D0JA7j|-j?^w%RTiGy0A;Wkba z3gt9{XkKf33jCq>4dr2Y;~Jl`-42S`t;U~(OyrM(%Dh_Jbk%ISQ7M1-S1(5xspL(J zStidaD<FIyIy&mFIoXC>n<L&hxe-$?;Q56M%zT8f$V1Sui7ZVaPoWf*Y6oR<JU(MZ zADvu6^Z2KAINBmCr>TObwcIzeVilqyg*^4Gcx=+i!QPf5dHIdkeX{J!4WwD>!^JSA zcIm-Hp4e&|T&&07uY764{pUOCIA)sSOo_NdU$u5BVPkxDc+rQ!ho4%rnaa-F84NW) zm|ce_c*>dHdGtb*-o@&o74<nUDf(Gn_ybd~x5FN+M(DNL+1_NC7Jj4BV+5>i|4h^k zQqaw|HHs-3&|s-BAGE&^M#hxp&PiKt)C%dTtthM##da!vwQH=ZSZz2)Y@-#7)wQqB zg&J4Qr6+g%)-|O4&Ov2&yH(n`!~KEwySL=z>5d(ryL&0|=2w1{F^DBtPX+_=%JZ9P z6rRXExa@w3)nTI(5@IveQyqMjQ0SjdOL`}CaqtsJTG2UVIBX>`855z!+=Ci)g?3ep zSDpMv=jn?}bBr%CT^u|->Jr{3LYCvT34v%#w`Jl&r+BI{WxCb%pQNI(gG_c_8eAtd zsbOeRe#5{ihgSF7LOQZIrR8NYz1d5=w4&N_BnxyK&J~uT%5gL`%+CrwEp}a-83uax zo|zmDUi4IFEZ`1_O%yP`|I9TT^ze+AE53(9J)O#)gp`2J3qIGPm$~$~W!0LjK+o~f z>*M+E<JpSg?d^rbyqEOSy)HVy*F-8$BF0N)bL?zONTAD6%xZ&O47s=Pm?D(4EGitA z$ILr$yOH<3a4UY7zIU-!#7{%Ri<W-SC3<06NetT&1PpNDmp(6?stkJs0wKNPw12tk z)&~-xOL01y)kak&+s?|o(GctQW^wUuS(&@XIDQ0MAFOUnXRyCZiLBNdN5)e|^6K4R zOym+<NRQ4jNXO<dn@;><^4Nj$=y;JEmcbewViLOw&4)=Gk={fp+2oj_g1`z;SvAtN znVh`mOW0N^5`#ARd}4P)pQe8!)hE;IP7STFkGM3SHXn!B!oVzXe1yLL>%nWc44>1% z;?A#5CC#TrYP})O<~}P`kk$U-pt^h*)6duva%$}JDI)?u8pU69O*f}*2z96?^=Gck zZ0!p@TQ38Xxv^I34O1`})%Dy?)IhX%g@k{qjF4p;)|7k8ZkW_~yv$KtpeP3_QkaD3 z&9p^Jk{*0D($w@%h5XVIwz{1nom1aZSmW2sC1^P2iX$K)*=OKOz{LKWygg(*yVali z5MdeeXvfp7mKd9Fs@%hg4D{^TGjim^8Ryc@`Vr`KyIgpxG14J~=N+gAbStxB<&ORJ zu)08M8hI{!!`-XV+y)H~F4!XBID2%(4^4XEj8)UzXa}zW7Cu5rTkPXRgqFLw6}naw zI$>z_>p`f`O(!&BVjiW_=%dh;b{{;XfGzjX2q`ONL<5FKkfx2Y-V-_las-yCN4>{S z$Qe>Ts1mwQ-*g7~F1s)=YkLQ0gTe^COOL{Sgv4u=AsG3mecx~$#z4%$!0kAJUAN|W zU((v20Zp^b1(neJu^j6ONUVuV*Vh;qL**Jh-TZvuF9u6ecrorQNA-KJcB{KSaMm@q zFCWkPqj#<k%{fc)H~aF@>Q&0aec{=~dq{6*j7~{}({v@hK4ET2oW8k2Y_yO<T*H2& zsDjW6Q{7!Pg7eAvY=GZxn%ujUuWc0hgk~$R^Kj!bh3h_DnyVY{x=z@EO<Z~_UHnu1 zMKCA4I`&NqOOd%B4Ma3|{PW4MoR#uURKYdoXf1M!vjQ-?DQp;4v+yjN@UKXRvjNto zZ^pMsE-$}_>0$H51+*qBo=d*n*SAJN8-y_h%Gm`;PW$5QhPxI-$7Po7AenNc`)vE% zX0kapaefF@cA`)-O3`E*)@hWUMl+}tteXhbXJ`^S<;E;jlZRVs<XN5&+7|FV93=Do zwEKe;2aLE@Azpw9X$~T$jJ;i8#`=NW;~TnVHVS~WbgDq*+ZBFD0CT;oEI3NZCX-5P zm3VrP2OEn?t6pw<d=%@0mZqs9;f_kxw*ScYgCH~<UbnsHPe^u`>h`7>Jcri$<E_2? z0l!m{S{i){;=hZ460sjPUw*dCmwx_kj$O$xtMOZ(cCJr3nX0mK@3_|5UIoUEH(MXW z<<xR=ABmN*bqe8^a{8*TkZs-wjYAhSyNV5#?usC|Y2;bST@#l_pX$~~bF$cY_}GZz zFENXNw}qc7ES4H$bd6V|L~mrv)#zo^5)TibygplrWOvz?3t`9?Sw%ectvuhcS}UMU zaTmkoYfP29UL#82@~T$AJ~uqHg{2v)<m<H*7cE3V{gZgvZD$`_B2&WTesOBfShs-6 z(i8}IlC{z(l#oeLS=m(5gWSxz1O>^*%zR1Yn*sY4;4mZW&Rs{Hujlt;sWVN7o#v^v zuGrYvSqp}emIgU>FYByi5G8H<>578)t$Q{0OWvAL;7<w)E2+tSjDDnR)O03JUncjE z!`zQm^U!SY*M!lS9S~Ttx%mome`E|L+B>gWOn@SMyJBP~2oR?W1c?l#@`&^7$rk(H z-c6+I{pF|GwsWo6ETdjL<F6$qXGrua3`Sm?r)~^2i8Fq`@><AgtH_@!+Kz-)Fi2Kk z?(L&3{J{@^a9{cRfdD;%Q8jEm83AFd*E@EQ%0PKe{Ibs?%p;jVAKaaV66dJBZ*JN} zUqjHu30d^WiBkM>lHBI&u2H;Pk}2dE=XXzgeYcj%<r%%F&ZA_=l^e4)MBjdXPD+}m zcA`z%qds;*4VQP0m=3z$zr|kfktD?(U6lG>NLY?=(zfVSC?U|;9WDMyP2E{#KI~Sv z+1#Lo3U=jW%I513lk6RMt+KY?U>hsydFBXo)}gaf$Jh~Od7Ga8_%78;kI~F4%}_mP z&$dZE%&b3@fH6xxk(=7Mc84-PCwFID#vhB1c+H+qi!>u6WA<c$I99jj7NLzy@iaYL zOq~5u_Wm==lWK!`(8YD2@V9K~*e>2V^#ZDK`Ka%g?$UG#p)9u{Pp<Y6B~@4h!VUZ( zX9y6ph3l<DcYR4`7^J7w31j=EP9axbxrFbX%a6vJp~T_{WH`BJyK0B3-Ykm~G_G1) zzm9&j+d^8OzhyP~V`5tfXi`|MPD!Do#-vR}r0<-f@Y=N~k!1jmxZJZky6{d@)FP6} zeN_?F->kDctC?VJ+PA7dYsu%f#WIQ4ERM`Vp-kkeG+U}_eV+G}%XmgLA??O5-#<Mw z@*SDaH3`d{=P8W7+Sjom;(p2N<9&xpw&$7s#mqg<mFuOt;~f`K!=$3%O~G4_fg@^Q z8>)@nsMlCA;(D3MSuyb!bk_*@r3f~H<g-{FeZSAmukY)y3&h8RVWnEt&bzbng^z)l z;dT~e{1(RNt&eJC6J6hBiFUJ;b5Y?dJ)KD1*;1kH-yF@XEEp5!tuj;z2`edlP<z=R z7$?9}@&`Z8VrXs^Vh60Y3lZL3F6E|D`D`&+B8oEusmeQ0d5|+BECj3)VWUxJamI>3 zzdkQm!otQ?on+um=5ui-?Yp_V5AC+%jfe!gly!c6=Ubny#;h$f_{*QZ^ZdNg-(G?Y zpyK;x%`R-xAXNUu6a`->TSdz%w9;a<@z(5qxhg<wurprYFPZu7=3)|{bTuYdhs89r z6&?;Qx0kM0jV#h74h{|tjq4%il4*P6Cm$p#Dr&kuutod|kwG6t%<|HBDOE*5K$oTA zR9W4Jme+IR{osU^xHY_JLLtB^SoE7U*bUbftoCzs=j1nwHY7fNyLmSh#0lAU(YOEY z!R|Zzp>D5QJ6kghUheBttwvnHxY89K1Lk#6w@FT9k@LfCJ0n@hnusY{sGe$?Di_BN znUyD?s9Etn9K=X(zS*~idRC2}<sr4`7-ZNUq|q`D+;!lwm)74iUmEcZ>ivF{Irr=8 zWW6t1@*S&yCkcfjzhg^BM@QdY%`6#LRhweFg#77(ztWwXaR~Oq>4!_D*C%6A(#5G6 zz*q+BDT#LNkTa8^-Gp-YBM}_@h<JPGD>a_?y_z$%yS1t?2j&=J;-~z}dB!>b3sZ@} zqS5>ZEG+Kc-rSTm-yx=cb8rR)SKj%Q3TtngHLJ_u)3H8rHSs)!WOwysdOokrB=*Ha zn98ijfhhaott>SyZG$tDEYI;DMQ!k>K1$nv(t!^V8Ttcm7Uy!Vk5EFQDJ6T+Hc~fo z=F1KhBZ!}sOBL?uI9yR@|HileD-G1K??|$5woWTw9AOE|Yvw;WeNk@Mj_yWbJvPH~ zv&J}9q+O#Y)WbTPuEG}taGly6vb)i^%&;}mtr<<RgVP6ru3S6Z_8rtWs*P>5o6$dT zn_=X1Ib!S{C+2v#YV_efOtGkeX}ASDf!yWvji9S_!~qot$CyCP4vY2DjY`&CO@4im zogcj1Ql*)5lB}P(W;Tl;*ipBFd)}02=Nq$ZCBx9yIu2@b7H*{`=}B=($p)LXcN^Td z(hDG&V$#YOIU}Pz<!>CrA9Sxzx1c_GTW}l9ddO}i;U}+)rpRoESQ;Z=B&CYEF;~B- zOte5`>fvHR=ZA|JuiyJ~<Kx$`jgfiBK`!-vfs0vMC$qtk6Nzo-&sW9Mbxs=%WffLH z4ANPZgH#cEI;Obs%C6(KLc88RAmf}bJW@BJ><pQYlUq4hem4gxF(3R{Oy2Zq4e2dG z->-We5T{YMajw;Jea_eB0<A{3T;CbK231*3)I<3%j<vTFve6?}xBG`7g)DFA)b(9c zbiC)cSUy-RrCJw1K+wM^&sA!N5Z{M{hdbN+6>;ZK6i`EdJ16Oz{C*J4gVQ=|EDWvM z3!9_DUf)|JZAKjgvay`Yfg-$@>2n(_7nyF2*VQodkixkyEpgu-A&IoZKHg<zuBBt_ z$9WypcLw+&_fV4k@s{J%v+m6g>yZ0~4empnKX8|QdHx}d0ie0sj$yR>$VGjrD^NC7 z`$L-^!pJb_!S_0!|6~_inYK9vH1%_(8VG&PFsS7kh4kJcotd6=iN(2U&{wbRXWz4& z8k46-On)p+#uK^~E3REut|{?hvl|0V`yn&rb|2j#1GW9uB~AMb=-F1_BnIAhN|}Mk zKkzs)+i&--IkEE&iwuJV$|Gu9qjlAtK^go<;~b88=pT)&Cmi>ts;+h_d~UCTeArai zhZ1R#GSNXLa3UluRt>7P&1n+NLRNk^?%x^?e2zRQ1rm=>xLy+Eg{~lKx(^TSKVIyP ztwL+&CuHc*h|{*o6#4J--Z~A8vgjBYVrk!I3a~P;z_#gtl@xtO9{X1iBpY&sL`1lN zKmX#fra9Z8Mc8^({cH*_1HHaK<8g#1nAdLD%E@#!*1CtG(=s&Vw+KEg%ht^0$Y`~Y zYg<|W%>SI(Wt*&<dUXd3!;{v`&R=_Ny_!~??5tJtDS#GR;R;I;j<FDVdTLtkz4g|z zc<dvAE$(BNuQ%pHNDoW2bMnkU7n9GHaxZLTdJUq_fP?gzH5pvAFq;|aa~E^VPqjSw zG!%Nr)zIUwGK{1J+tm0XGZ8{~b*KDHv_attk%aWJIr8xbEu_>qZ#1HELair<_73<K z{1UBp!RmV{B{^dW6Oe7s7Ajg=S?i{Q^G+jM_`}v%PS4220*ioY&3=<JaZ4NQKHheO z))nVStFAj<E}3NyI~jd<QS`djK(hv^1gZ=-F-+=tL?fClmQXJ&7IGA>#P3~h1RP<# z=CytN-12DwnZ>o&=+kkDj0+L3^y=*-x*RPL&6)R4nP90Utu5r-z+ZD2uJ;)kgT!5- z(c1g9iuVWe2-!$knSz5xY_4E}sgfRfMpt+pQLT&^o{&8Ragn&>e>0;uRp|}U@r_9G z?W)rnrB}eh#&*5*aK`vEet-6X4fT`%K!hqhO7y!zm9dI5ShomOF;Jnf0(9kgwVr6V z=6`blo^c2%R+hBYYvz=bg<D2<^`SL^|Kq;^dcI@6&<%LQH{Zrj7+4x5s_YnJ4a>3X z8)l7?kk{$~tLxENTGBhNMoY%|*4o}6jQqnWaGV>j;0VW?y_$NLdjvA`Y6<m|;NsFG z#OL&P=t~@2U5_mf$99~_eqkG4i{Nyru6s_I6rXbs=&B>Q<1w(Lj2qfQ_~jLk@7E+3 zcmf}%*Kxi%GAEW_l^AfmQ5s5D4Vu?sa=?^kKaFKIS@hVD(Mjgr*ZTUV?0opco{7hD zSrAvFW0c9ps*I|069450WpRwcjjR7QB^()3{eKwy>VT;BeR~50K|)fI5Co(Vq`MU9 z?gr`Z1_9}kmImo&h@nejXrvj2?nZKeVc@sVd+*+N&pYS7-}`ge!;bmpTA#Jnb_Q%q z-67GZbL$F&k*os53mE`QctL^jK+B}5DLr2_&&=ua!|a}m9Gg>OOn3(u%x*P1+UxFZ zwvTp*?`bZF<@|)2igt@vYKGIG<wU(TF>HkFOlN(~ZDGh>iEku<naftosm&u*=)!zJ zGj(-FO<BYL{>pG<jYbA2>$zZ*&WFdRClpcEo<_PMuO?qK-8Gl#@!#pJ_eF2UN3y!C zn+Lo*HiCx)y9yx>oExlTo~Zrg_--cSi*+#PrsL&ud_?|+s#L~o#>)~~8vP&IM9Cs_ z{@r|h>0``gbN<oMv-XftyN*L5_wswUp$hj;`-tNc*85Y*SKVK~HlJ>C3zzJ25q}4j zG?hohxT7C^ZF$nB&_TvI9{iQ*9Z}wD^X;vi-CnJJ8)A_A&D;KY&N3R4UUtq>Du9(~ zww<wyCW#}dp?4AXo>A`(k?Sd3YIgh0%$GFFP?21(M#61-bkq$yZZ*KTzpy7Jtb3P9 z@oL}syL_$N!k2`6>xL{l(u3u={^B$i)eVF#@R(6HBtIuPR-D5wnPnKUDkgSefV1t# zY$hGRe>bhf>WK%aKdd#;{J#Jq-GIkb59(Zp)Jw><B)3Kk=oAEzQ3%B)G=&54>w|;n z8Wu*GZehmHYpj#?X@k1NX8n`WB1F%mrK8+evo-3iqyQpp(E_nvQ5wsPRc|$>L$bvS zUvSR%4ISkpoFI`Jrw@qX+avJYS>?Yt`6MMH=lYNuA>x0!QF40nHoJckka2SPD$B~& zrQa~{mSmC6BXDO6eRJ%$q0`1NW?4l&@rQ!mmx+9iSR7$-B}O6dq~tBB-4{JW%eC9I z<zG0oYVH(*pS(Z#ZaS1a<i70BiX(9Ky=S(fiZV-+yA9e1$}2F)UShE^In<`>%oY|9 z`03isaG^<OH1Nao6sY`Ke%tzlML=y4oXI><E9vg;3pN=_X5L(jWKC%ZX=Qa?Uw6so zxxU=5(w$pr4cL}u%@ktbWS$PLVS2~uw!m{O5=2?mdi%pgv18<e`XQ}q8JjH&)^a2E zZGb&dR4Jj-hZvzFUC+BzZ&xOM3lYYVm-5+MfXwjN*AqE{GgX<ZK1fg3b}5cHAGeYS zke2p$Riw(b(<{;Fh<lRk<Vsq$Gp(Ldl;t&}X1+IDRfQS$B0vozjmtNr_4bsJ{X7Ux zO;ZoTWKx5E__m&pkJjID+^hkJUmUw?jj_T6DviqIw4vJvwWAL3kRrWCi@4VNJ4Fp- z5$Flji9=KM4dsF@nC&c5t=$W8=)RfZJnA$Z%Ji9#5TCVS;nF@;&^(6J{eW$vT1ouS zyRkNd%eHyxtb4;0$y-AYWui7oit)?hksp2K0k*$n^*<NpCK@g&n{?Dl9AnVYawUg> z%X<5SXgEg>O%Ph>{iUaK#=_1emRPQ7RRosM=4cqC@JU^DZm^@z738ws1hYO~x%J7n zgIg>T4kuyjnRe7FWmkq8>7+*iq-CEr{GS}o+1@ytseNJU%zJg<Uy0L&nDc9A#(c;* zZWwpbRXLViO0rdhA?L>OQ#j`9|DQPOe8}n`g7W2{`(*C>C#|%0UAxA+`9*AP*~8`u z+3u%Je7#AiA4@IJ0YsY3xo{Sf;Wkfy^w`&W3=P$X@O4>_<JD^DfN6>zJ!|__28Z?1 zd~m4MbWD7@eY29#{jH3YG=?g{e0gqOYR71jR7cdL72kmIwCha8@@pC5u@q-c+3|K? zeqw15&IvP9T}$r`NUa+)lg~9#lA=lH3ATVFV|d*!alkqtitl-HZN8acWFQ@DN2c4~ zUsyk=*(BY5yY~KRiMEPzJf3dvkC&50{QwEeh{V}9INIfNKcXJ9HX_Fq+(9uTakF4L z#`1*t0$wXUaZ(f0i#<-32cLzA@R~1X(l>$S=-aPvJj5Ip6XgZB=iTt5GW+H3{46h3 z%(B8svdw|nW#sGBvWWtv^{pD(_cEncB1Wr$ynKW(b7ep!?1ZQ*VyqBWM_Ov#V1!Rs ztBC0~0;t1uqTPfzGmzn3{Ty64CIzUwbJk639@^eZ*GNE2I>X;u^K6p3GYD^ado2mh zkDb!eq~c@hT?lO$?oQ=K-@4C1w43OqA=T|scb54XJf_JRey8Jr>>$#Hq*9G9M5XYa zL56r_TKc`5i*!}Ac0E1r1jBLb#U4#W@RubIq-jHk-q3_;SslYKPIjk_Pi@@$O}Ima za-Qt|U1Be<7aNoff)uYwzC?zXl)(2S0RMxeo-2j*^8GVl>!;*&N^d?0@HUQw$yWO= zhSsxYgJjy%dzhKh6{10^nPN=J-BRfQ6o#G-jjeNBDKFRSluVcb=FXaD?I%RUIgC}y z{+oQ5y>lu0(SExMHEFjq#-ij69sHjWY+Fj2-;V?Ni7G+8Kl%MY*_$i944l^@F`2V{ zOBy%yf}!LqK_al&`V}RR<`+hXWt-#fOW#Lh<$Bi6L&<A7eyF3S@Nb-oU;|Uw3g`cY zPN!7NeJnyrqsH;GZZOPO#6XU5b1KHR;!SN^X^ig!a`br{=8`Fp*4D6gF~TNZTFpwj zmKN*t6pnB|Wt&%0j0H633z<E|3Z%Dpz?Gy}GjCc;=z8bz)5v1xi~Zgv4E{Wb{LI2| z@dQ_?<cyo>8$`8#+!H;UrlXrKr**lY#j_RXt8Miraq8h<tp)j;5nIM4QcOD2ilK>b zldg8o%E%{`>_ayfuUxguVs9yrKuQT)B*WwHe(lK)Xmw~eU+mDpmz*0oK4Gf%oOC_# zKf+gdkwaOivbi1`BHgyZL9A^xU#=!a_#6{IOkGjC@QLdq--+20K2GS>Q~Z4E6rmdi zg|cqyM#IEl7JxGF*3&3A2moqs5$eIbp8$RKXU`jDJuRlH_Dc$GwUlLZdkX819|kj^ z?*T}#9LL&mD=p;VAI35LZep!>=<_KnzHY7hQ+m-V$Rm6%Q)rsn5TJg@I$e1TZz)MU zxO=MKDq|@7Q?LHV%3+I_T|kT#=U!u}92c2NdHM+>t^mmSYjE(u>&!vhv=DD1){MN| zv_h6&Ntv09_N^y3*dw$S+4WhGODL31J*&Q(5DG~dRn_SD-R4r1Q_AMhs;%>Wakw?Q zRjLp7n!j?}N88Mq$}IInsl+iMGO&0HRZ{OyZFOF2+nFb1vB6GTTHAxX=GkgiMzi+F z=$M#f2)VB!gju8gZrS|iJ$}XEOw!jYK6cAJo78uHvX-#RvtQ+&j7VO_8HZV8Jp;NF zE5oBp*qs`mp62c-VkMlSJDz%kJd@2KDn^4>i;`mI1U`6qIb`2_;CA19PP$1!bakzK zFQ^p=!#HPjpg^=ANxeD<`jdt9mh6%C8OPOOy5LdZ{i0PY&K0IxT|0~->aZ%Zc6#)1 z%$I3w^uFB|b{FM%R|{jT8bh2lPwdaaUtBJ?xcU?2|9Msy>BTRue)xLGx_r61D|~Ef zkE_ERfDj3Fw$9(q4`Gr)grSG;1ScxzL7h>^wS_uMe9zS;^Nk#J=FRIAgM{ldGgLBV zJ#o=h<zhnnQ)hNgi^N^<#lbWT6|f34>lbZ-zKvb>F8!*uOtVQ9u>9ej!EYbneZFi% z;eFQk^UbV*JD|UkOC;9!kn+1)<?o0T3bFbvQ3lztR*PrmtpSME24)t@5Aq!w%1v8o z)_}>F=!nGU>g|ppfb<h*^?kMQTnB%cXZcZisO+AN3rEKVX*ak{Vm5sb@N(H*(ApYF zXK-I~jg?Ik=tXtBeQ5L?MA8Ul=tbQ(HSJSI)-dNf^;3rSt7#a}Lnz$Kt%r^~8e*SY z*~!4|^fq&XwD%M3p{E^H?R2)4W)&z}ZBD^{1ud>gKdpvJiZV+GlgQ&YHu5|9-h<Pn zQ%?InUuJmP!R&o&K}`L6jJ1AxI?ZKOryI+yd(hfYpF8MVc8g!pfCQHHF+#1BGLCbd zV_!w8hI<cL%_&*-pkS!04cj%hmK2NG_p0mLgmraLd3+pmyI%UEqfGa^H{6RpWw(51 z8g1E+R^P(jN_5+C=KZ93%W42I2^vm6E324!t;pDPxi?g2JW&9U>BrA}ye}<iFX|&E z`0YDb#)R(!<@2~)LfMjkeQIMZlg`z5H_BQ%t9=aj`2%hOei9mueICi(Hq*l^w?)7* z{HKoh`gbgmL)=&4@6y#k=&71tee+qn<^fJtIm5vnX%YGz5~h)d_4Mhq@GunQblCp; zrfvJGcA5LC7KYiLg%m_F^F=aN3C{&?|BrGMB36XP*W~p#syY9gI#|{fH#-w9o6C-3 zrq#YiW?*qhSzt}sWASsjnBRNP@zmZ+GZs%J5{;xcSvI=W-yh8&&R{|bv~tPzl0HQ$ zQq0Nq+JtnB)|u%<OaiUVQ!=uN+VwvQM7ux!M>$yAYEORT1{{KgsET^QCT2BTlJ_vn zr-V>PrmSZnN6p+Va}2P6)%zeXxPdwm0XNNLDW^3DPkbJsZmE<_g*ILhq4u7Iw=cG! zDz;!9Tz-3L8l!B9eWMLdEhwlrQ?Ad<$gbXG#TCbgRISnv?WZrws1vt<7zD``ahVOj zc*$#(__<s&mt3pHX__R{xT5A&c60a%-?VB}o!#`jXHQ?>Q7NW(o!?qd_(XvW@gL3w zZ*h}&^_x^q>tqi5C0+IM{%`J~&&E5ILWa{j6qA{z2S4y}YPR(>^9ic80wz207@@sS z#KjEW?EZrM(cx*>By|Wj5LoDXql4XX4W&f6K0<wY{8!`?$mlB`#iC9tMePzuwsV2} z*~MU474N=Q?Y0#zlL6Rfk*ePK2WMDPPC!L6AQLyU%ANfThyK1tDp)nXi&m?hr<&FC zzQE2UTXwhhKWIETJ#1J8oWy0+?-^y-+10HtiZ3b;=d{^Kd`jOANDWMM_zUmOfr9px zf1k9+UcPAcn?HZa?sGMJl-1y78x<KDc}`x!5`KYKhkPM5?d{un0%@^k@%C|OY4H-W z77fXA*3i-Fs6w^5W!z8S9U-AU*jI5D`d3pU&ll9w3nUKa)NR(cKxF9){kCTBj-DlA zlFH*qo4IQJC(n46<SfZ<5&PM4+}@+4+(_@(qs4P%*l3II*w&a3{MdG^FkipjC%9dK zT_?Fpv+`JBIv&vD?s6<?pJ*)?%~1fwT@05rr&r>bj2|QpyhzRkcm3n!tMn8VaXl2o z-{=7G9hV!`kIk~b6zO%$1k5b&mhF#?9A9hk8@_JD{nwinS)rg+1o#R6nX9>17~q3L z){ZWFhE2=f?0W0>rT{3f(ORxXpDbx*@-Z>ElmRn$AzBFiS9G9Yrcdz&M$a(6sZOs* z0Z!-i(z1{zc{b2VYi5{TfV@F+97wrz&!AztM5Se+Gs<3gZk%+cT#s>o*8Z1e|AAbH z)se^9ZyBib^@aD1rr!e#@RKiTNn9W`h{s*)HA{x6{kdi^DW=)=X6$8GL+#sG(=o!^ z`3xc!ZMqNXk*53L3cTm!l@BXDD$WVeby1FWE_F>Cpw>FK9vhps6Z-~?`y3g`MQUDv zCQT+^KGh7n-ANhBHJH`ifxR?#RL@Dmr_<oqCQk$Y@K`}@ntMhr!915$ClC&|Js4Oo zzb1JwpFjpR&qkl)!Fw?Ob}Hjvxcq>}`knV#7OR<X;TH@h5cyxiL=kS2uCQL%<x20p z-To}pn}u7~y*|I7U~p1FxX8a4|2q|O24<I%Zb!<*X+5*Bzx)Bo8%W{n&n%mu+Y#*c z4rY5NRz%St%yg>aghp}ZF3b&^UG@;KY}vA!O$y<=xcZ6eytyh#o>W%ZI?*P1<_>4O zx?TGHwt^2i+H%~oEWCaZJAda3vF&O(JaJxL`dp!m+|oIYKn?iWT{dvP=zomu{|gMk zN`|sIL>^r&$)xICMy9Mo6u!BK_`Gi7EATFgIlPFS9CgfP@K-n{&dmRxX(;~9os}}f zx4T6*XRqoE_J-Pd>&j|TIxIhr1sNRgeP66-SU+4)x0=6WC~57G#jsi48?A3SOKQW0 zxx4$vZH^uKTUM2cK1VRLXtsb4Dl1k@e1PXK-Ay#XnoyQ;2VHE|6Z&Kv+SoTjHK4sW z`-p>B`j#;YZ!(X^eJwf$wu4-V)5zl>TbLe2Yk=_RCG+t-((PXJl1Im2si|CWnb^Cw z)+AJfkbF5tP+JF_?TgHELxL_XD6_-D2!I?7Pzpa27pIn|FU+VYhq%iZ%%D+HGGFP3 z%DS`!=l6h-3(xMWWe6^1lHGefe5LSbq4i2E#@un#C8F00X%f$70vSxd_XLs>Z1wp# zZ*H)f;!|qb9MZm(;!zN<-~Aeh!5pWrodi-|0=BbgE`acvg=<)mLiT(2fQ^l<Bmkwx z8sAwcxC<=Z^$+|M9%pl`F+!5S(b&MD7uNpT<-!J*7lxSkr1M4DQMZ0yG4C}g5EqB* zKZX6CU8eYXclSmT4-ByimMxYtk@2}M>_7NsKUOL(jGQt#Vz-`^0*VCf&Q*^^mWBfj zRf^;Z%K~lvzs%~DiE6nPARPhEootr(*3;Sgu-|36t_7z{EejL~`RxC}FJ0>Ah@pMC zr2Ynib9DITw^<UBkf1xwE#1jI@jeoMx11n!G$1r%_S^Un;XLOVG-iu{g4---V=f>` zwv$y2zJofqZnG3H%AM$U%LdEar!n`FGfj?9RrPCDq73{LC~oVoOyK7yaMEo=?b~&@ z_k4Z(4HEg{M$(_m?daF9FL4G9Z)1T*LI%O=ZNXR0EyUg@722AFP}OR!a=Pog3-vvH z-QkChpJ+<d>&5O3dLOc3=%V}!ghC7aa^E&y+OLjXvBqM#v;ZwgQLq1)!C^N))dps0 zk|7#nUfjx_JFZdpyiO})Ny#{{(P+B5*{_WEy71{;w$)am`>p>abIebY86n9D9)<Vb z%ah+CDwdDnmb2jKR>0PO+S#oz=&BvCQ+<cjbGPw!fE~e&^cv)rBk8IH{jp2|`)IZ8 z<^`;Z(YxH=cAIfZdNkYbvfvL}Eattg$7(NM5@Nuv`Q!-}$(7z>-l2U`LeO#x2<vX% zeNM{&1wO84KET(pTp4o)Lz+17gGcpY-{%F5WV-vJ_0;I#KZdzyw{zg0HnmMxRV#~( zDXMSft>+|uxbV5ciVlnquUR`r8VFlEj@J)(o&N~qIcXWJvz*j>(0|uidf?4esfWxH zMU1g-)*m(`!8I?v4oOXCp^lqS9oMb=8!S`L8!@EkQ^q#Gee2zNdZ|wZhr*bqh!xud zHV^t^pDx%?49K?D`36DjVQ}Bt>WtK9T_%eC)0V1JSnG>|>;2bpcn1#xBAh$0JpJ`P z_{yEE4vqi#@S^cf6S3LaRD)K8RB?wcrepf=h2M#o_)lMHrQE)_fe8N^A;Z2nyoQi* z-E|Q=g5qjiJd<}|1vgvY+C&@9(p~(26Ogt`J_^7v=X&B;PX*sWcN6<l*q+<l75~t3 zLi{)P&7Re|&KHC<tEl7O2Gy@O5)?LbC9~rL7i4+Yhn+Wst2(Gp_&&IS<kvq#v_Iwe zA#aWdn03J4QuKY~BN_-~0MnX|Ic%sMM{$V{2AzQ!AKv&i5z;I(^{l{Z4pVe};-2x` zc@WE&{7@-Cv&Rt{&C;0oq695yMfy_QdIrYQyZa*rwY*=o>g+o2o77uPZ?wb-ODT($ z>-bMdy&YT)rBH8<MfDStCbhj+L^9aZA1`cPfNXXOTET&{NwbyqCNd{P4P|ns`uT)z zgDiKN9ru-B#KqFgd|Bx#)&0CZ{4k085*)j12f22hDJ6U(=uO6eNz4*YG?JFA-T^)Y zXWI`^=t$jLRJZopv)ZQ{Y{SmBFZUN4cdrLo{QNtX`n<&5vb-&~YY)L!hKWE_Ma2OK zJP#i?Q2Bk=1q+(h;lDKSghw21BNV}M{&zL|zOZ)IJI+71_=86+K;CSf^(!zS{#$;n z_(niB9^ZN(t=y&pMK#}^Z`Yv6Quv^P;eJNzxAXFc4m*ulaJFr2Zv(zZJ+ei3rs}C5 z+3kWoJhla9hCs2$@zY;A@$-g4Y7kHC8*G>QkGHGFkGE$Lkd=$BG250lF!upfsr3MI zj*c0h;z~x=pXtx{(@F6h9kYxfnuK$qB)mkW$ok4WNQZ)0LvkK)q}p-5DEs~1_r^sF z?9+rv*aPX6YH_orku74+=C{up&R|mk#5OddMKZ^}pIB3iCWA-PICX$PoY$^avvF>R zFzLmwovM4UxXp&5Qs29JfeLDxia)K@Rb&Y^15iIv9S=j*ZD439;aD=pY4s(hIw022 zC9(RDd2m2_eZ6f!ZLOEA`K7lI8Zq;&|9tm72X)OaIa?xfauz`BKfa=TicR^v<rAiW zW~0&h4qJ`tnEiH{dPVcT0e;0-ll>HC9hRgrRX6>^dGKNh7Dd+8B@B?!Lbd5x7!sp- zn?@ZD8Xfl(seuCNX4o6-6pPHt#p4d3Sf3tZ3p@v3!L(T>d0CCVbDhinyw=`S$$AVN zK}0~%KL=X>j10kwPfuqAY+Q-^2^aPkrD}MEU3q}NQ$|~R54+>O`J;5Zmd>U3mJeAZ zy-H!RTziO;7!5tWmKXephHJW!IY1bNfwy?03r%FEawPEtpSF>HW4P4KraZr}K&rM- zZsA-Xyj&?p-Nk%!S&s9^HY6(PB?;gBL0_vMlE8AJF>WfVQj6~{H8qvp^OWFa5yA}c zuJUD;+NH{~T>{%O8Jj~*%em?R09iw!H~Yh|I;p<c^w*3U6)v{3s)+oJ&z2|m2bpMw zguOEmoRWOFJceMd#zV`Ao)A4HrSh>Q7(A;@$XER!Li2&BXoND#ZX1yCk4gFU+qbOW znfFbp=_8wklym{_2N&B~RQ%ubw=|tCJICV<%+Ag(;mmlY`gW5c0o#UM({0u92sfy# zMK(>?J|K#>?hOZZBA?qq=d9E>y*iUqHrS5@F1A-!%m$!9?6+?dFeAepm|c$j2Iwot zpJhKImyB$>{T%fi%(6MC9_*k8Owegoy*(KdPpTpQjOyihg_5!4Nj%jes-Z9SdMX!j zWfA3w%aeZBph(W&5u4Vu^v_#;qzmF?&&8k8J*3G&N&JGR_()phKR;yPDL(wB!sMm+ zlrF$O{!53w+-d2q9XISwVWv0nkS?ALGByMLamv7Fzo!QEpcMksMyHoW-oCaLEJFO_ z9RECFz<bdLRFCmrlYYs0%u+u0@##Hd&TXL2;OHpcL)_7qMrab$9!dc3&~!eP5GzB( z+IGvp`FYj|_W`qJb=Xl8LY~)8r-Q#2If=v(kOll6@g@Pej#H(kcvyF<{HK?vh1|<N zk$z<F11^uDRNLVKI|lG&nX1;)A7P{pxME>`?n0klO2VZwp5ou*K2+4!Ch<Kxe0}5E z<G|aV@qtR*?<PFt?)-g)ev@j<YTgiy;Lahpfq8CUuhTI4>tB@(_Xw7v>r}A4mVIpY zR6Z}(ogXe1IeX$0Uqm$N{qMYo8?p~R<6&KGyuUG7<B3oxW?f6W`s#H)lWzZglImUH z19VcOuB~ny;UC8#(YdYbXorqrRufp<=egTi-pTXzE&Zbck-bd!@a$PjXgm}Tp7Q(+ zeQGcXpg{O8c(@^46!9P|iA0eL8fyZna|bLp=etD)zcvQ&r8Dmxf8#oCh6IJi=Hu_% zA3U@i-yTY-%1_bv3#L^tkWEZ67GAFKX0=*uCcNlacl*PUjGl$tQEu47%<q0!=)UBc zQmBwE&JVV)mb9O3$B%R&QSR_V7E8w3ISKGyzY{#|ajvtSv?8jZR<>|>K(@_xa<zWH zb(VU5)N+si5Vu^j2~=%{--7Xq#{$>)c2z{ke<91gh-I-v{?G$NYuXox%r}Mnp09Oh z)pK^GK%|CXk^Bmad$Ws#-<b=4+>qpkABrC%kI5opV;N~4i3y=sH`coyYTvAM$6AiZ zCnY*rq>w@&n5?Z5u>z;>04dOk{li;|7UsttK+N4Q^K5^qTC=fjYm;<AAvdqf=BO-> zHKpdjV8b0t6$A7rKT?73elOY50MVf)gB)ZuMR7ZZZ1;LQJIQ)Jzsuum|6xIje(rT- z@~La}XjY|O=;&09r%H2pu)<=Co-r$gT-5!aefYme$O^$Dh6jA8;pD~GD8sQYQd8f~ z)w%6bB$tXK>thJ<9k#h2o+t$U%UJryIWqiFNI#HV+2LQ$Nnjew<ZJdTIaPiQV(h5K z#U&8kwH(;6bUgX|^@Hmkm*IFfiPynNk<D5*i4apvI8i`fREhsYx_z5?6EBqG3UW*{ z*}3uw?1L{$ez3F;3orm}#)Y`tBk!pwDD0n;*ICAWdT&mxBH>crhKDPAb?Ql_Q3@gQ zeogoCVjmrLP0~)F!kF>s*4J{he0Qqp%w@jG`7I4K_1q-Ri{JEZfC+|x0I%1zOj2?p zrnaS4Y`)QsQ}A|Y-Pjcs;(k1D<}Plka8SLzyUHRdf<uZqC#|gbi32mIl?UlY6f)O% z1nbDo^1SrCK{kvNkdTYNjS%CtCng#tQ2z9dHJTjBc%Lr9sKNXL;J~1#8~Nnqc8OEP zPd7I<0RGNbOoph6p)vro{`glw1+DA1W3UjDQ17cZ=bEjb=@(s>yIrn2<x59=6SA_T zcx`rR_B}8bUCsSVm#d%lI_kg=_&zJxO#JjxN$0BA@X(ZCmX^W6%at}-VmnGGIklfG zWM+!;48?0&9>jbhL#6L^`jX@xVPSN<i%->x;T$u$_Tg+}8HWiso!yiH@ZqTRSojHX zVSb>BH!{NNGxrh8KgT-lX$-nDhi3_%8xWyjk=;J_ybf_di1YY9C)_F=Z{>Y|MKO*m z)L;X3dd`x{#aDJVU>v8rPCKIcEJfxXeoSm}QzuMQ8tRUY8F%aH<2C+?C?~h0<8JRg zcn{xdY!5}J)v4@d4^>u^&7tLUxpY3Q(d!ded?LL5b>Wmd#BzfN!EDZbJMsykBe?@F z*lOAeq#fM<&_{1-!);>|<jSDnj)8ri<nxWVT>jz!Dn1|M0-y&i&`wm<Qw=v7{r<`Y zt41Z<7D9styEh}*{E<$Y8$ggqRc-HEU2X|ntVLJ2FNeuZHUVDWY>_!`k<n8_c|K-+ z9*w)`dlLpMiW@=K-H8FAENYP7Ul)$VPI{C<Kboz?VlR=W8T=>$g4WWeR%hudPj5r; z1JlzFAuM;CBJKO3e=|UUvpL-1eNq@>u+trg6#e)mF#E}j?VLOUhi3AvjqBEam5`Z+ zoGbKZM4zaJBQL<fpK>i*NW(yK`5CE%g75`T0jV7EL;1Wux!vgov}&1(?s#Dd5?o2# zO%)bQ)7N(*oimr15|mA~=ug+OhpKkEi4;Fh^c$c7SeJM*B${9I^`z7qt9I+xGgjPy zQ3@NZZD7A(wyKC%P(Ys4jCHf+oF?G-tnGHt+Q!zLvPFq+m{l<8elpYYSjWDNo~87% zdJdBPK@tH!%Hh`ckE=M8{k+f1NJmAL@qrq8&aNX9c=eX0oqUsU8aVD9Kr2Tov+Tq9 zMX#_o>~&w#;<rVQGut}zG5r$mG|T`=Y|M`WjhO)4EP4`N|3Tv7p$?wc?=CdWur-rN z>uZj+WL3Lmv}1p|H45}JY+4HQrPy(b^^fE5<@-+~I(ia1+*NNhi2a@xU(v88T&{El zO*J}lOBd^9qZ-7yD7An&OeZww!KQ@KB!bC%Q!+nj<#c|1Ju$IdqrmUYd|CSCe8#Z7 zYx7l)0q#9DEvKo5N&tt=Z;|<SOTv-V_vtJhr>e8j|sT@NPr5_YK);Ak$m}N$fnp zf*gSu4aO#wE-(Z?;xOzCt&4){yCW}*Inh|E+V8w_!u<DUWC*N<g>evB74zkI#7-&t zZb=TI?{=>JJ9@;Zj|_;cd1t1lVCS}WcI2vhRCi5H_QHXvrH&^4X8R%<Yz<h$8^$E> z_lQZ@H{R}=<Tq@lDzGW#*17bOJU;{!5!M`zYt&x*7b(!`h6eQN*S}vPV8?Y{7bLsu zd6JVBSHBJNF^;I%F$zSNefnl%)hGJ1(P}?2258sSHJzpjnb5XS@iXksROl!Gr2MLj z9l;Ac3D&mX&mwcd)vnoc=l)}YG-7Qb;c^z85Q<-vZm&YWxCvhU%A>jqj|eZKb7Q<5 zsy?=0OyTtHbJ_ESCQ+TjI?NfdNO``kL{tgr$Cv!guwij{Wc6_85ygY)`fFxwj;h~i z@q6=J6%BtsN)(?yI=~nvifYZHmJ>C4n90N=U)6p^zo>VBSMD2n=`v2E5pE5-!6F%7 z3M%1POEF>!`He^X`C@;zK*xSp28h+l!`h#%Q6nYNCqUEm6Q%o1saP@*5lmY>Gm&rk z>c;a*kthk}(}Fy)d(Ly=`yL`?n~SeWB#o1&aCp)6nJr5^*mm*LqW5JX;QaWO#$m}c zqsp>7AN;fX=MD%$p4<6_dZ6q_?8oT%9wcECS_I*n9v~o!g{H=uqmd-&i}^z1)AKhv z;P9xJJi(TRaU3Rxrv1u0r*{07w`C)1F@VWdSuB&sQHtwyR_TwJ08koAAYQub3(ZGV zr$vrTIRP@Ir-9E;fO=n+dQE4~5VtDRmJebP?y@ZCF4LsfR3Rl5KGiZdl9-+%!|7{< z@fcmOlZ0h4EFNksivmFCcvLQfxrznq9*D~0OX8VwEtQC{2vfMG2~<th-3nS0ykS)J zYBrlw7B4;lXPh|OUrdj6_aorV%m@6SDnV;*ox$p7TjC`q+eZWhbILbI`sDnedgGqW zSALPFmu4~|0+p>+GoLk#!sBN&GqoH19=9PzVN*3~ue6(tJwd%i9`xKoEHM?*G&TH< zL&dI<7HMp@c$mX;KL{{u888gv5;DaFz4S&|R@-TXg$<-8vKH%5QLbcCf&4$SS?4!9 zqjwEM9^lPgX(8R^Mg9gL?^JlwwqcQKxXPhTwr^!|0lwl!cTIO_oMJHoUBfRIbzKz- zkBZ2*g*8ly<1DaNPJc5voPX*<wU2UPnxcEL_jV#MIFf$T0V5a%Z8EKXe{N#N*vS!Y zq7HIdkDgW0Eg#XI0kSm*XR3|ouom?rqM~xrnBIwNHaXEmzZ48KUf-|LsWv3xI!9}I z;(+aosSl{Xvcu;3<kCcuTcdeHtozIzXe5pVYgYe_G5)bHq6@%#wAt}d6;A>F&p-Y5 zcI&?YNuo&o>uPs6_TEe$F{XC&-2N*HVqh`d5v;S`<|1PMJf0AH7r6l4Bz}a#eh8~i z@KsPyfD-X)#>EB63+q};_FbI+esfP{AnfL=N_y*Y57hOIB6%_C+ua1`2dE+i+`NOU z0R`-uri5>0v)ET0+`aF=^32`$Tz5B70u)VyG<}UgVRUZ4wGJ-JBywuxYxrCYaTdLF zg!f=@+G`e;a?O>;#4^Vn_gshbprl2%=^roOn+<rvB(a{Sm+RF=^inTZ_vclTn%T+) z8^J3D>oQ?+nVw%O+qd|dPj2?9u?9b6vKmtk4c)_e$mSX%#e!}J9L9`61C1y6#X!~` zQ@^%2H>el|iPE4%Pfzc{!5l3nCSL4#1|}eUDGx}A@)F-jQroAalIl!jXk`S~82VaL zMylhQjipH{2%nKQIrv#ZVx;`4RZ$qF+E@?i9iOwldGq+y(-q74$lGWgPUkxZr<#Kw z6!!bG*%dTR_)L4B^q|V}ettrW-f&wE9KTMUa)XX>yXVr_i6;-sWY8`T^C1-8b1ZkF z*<u!MGL94>)zg{NjKtxckk9LDtBea?dS1a{-ouVIum=0LKWjIFymvMCgp9)1U({;o zdGhL5cm=lK-l~9PQHMU3l$6xjFALo@P>iF`_Gf5Cey9sRHZscHc=bZ+1Qb{24EF=q z0Nbr5<`oyo-su-#U0K_I`@0+qx+}T35XAqQ+I>&Q#GZV4v?R~H=nx$i)H!(0S}xsN zOBYS{OQ~-h>9csW<{LIH%i6Dj{F^TL5c6UEgU<oEK-|{fpyB`MmfL6nJN=(ZRf@ox zK>-hXy1OS?ay|)q=`y9QG(KhNJu1S`qEoJa5J~%%j*lTiQ1hkEdult7cC{KIianTJ zwMRW%kzDsB4RPcL2NpgCl2?xQU(axPrpk0;_h!q)RaVt@p9LS3+jz@AUwv*&|3nNg zk)CCA?y<(FPhmX+to=pnkV#VtIkC(rO$L@qq820fB$G`oV>U6Y_0y-R05noDG|XvJ zh;se$I}DwEC@keS>h_HN9MuofM(LJ|8J&pr#3c@!xv<-ypbf)^v#+`so{I`9DxiOH zJA}U3PM9;EkfiYIykAN=p20D=$F-W^QNk`LqDb%(@ld6@2lbg%nGUn2GoO<RSUB6d zo_@x1%e!F2qTp(Dk+@b*n6K~nPQ<D$5~_6&Kj!M>?3~aVZOsdjI64C8LmiOm8_3G$ zp<F#)yk>DCebEY-B~a@}Tjhe}2b&%SK0alpyVs9mV0{{TMEg@U=H@pTwhxO0hb?;} zl8iUa$Ky@w9F}Cgb<a`1DsQZrI>Y+R=fRe8NW|hN1HY4(ItVGl)p;VffLWypmwiXn zMUU?3snm|QG&E4iXaEw8E_kt|s|_|()joE#t6!61<Yv`7V-_hrGWTPG-R)(v3HHAF z-!%H*>zqe9?43JC|C1Z}=Oh)dC-cCrEb8Kw4x{GJE(q?*UU5#&w+`6ooKR#hKMe`_ z{y+`<17){ob9G=JrRG^^|0Alrb*7mwhCM{L2R}&?2*mKigrZjZNbk#Z-o%IsaYBQW zYFE^4p3@6c*vQvh_4Z*pVkHB{D+!g+QwM?M1QjZQz&X^1Vg%Oje$rce()lAQg9yl# z6EK>p1~JmP?W?l~M+TUe8eEvRO}?_G_KLj>ixjvOqi227n>BOrnOvdZ1LpS7Y+|A+ zXyNfgMS8WkaNX8mizi2mxbL<C#e(RWdoSB~q)%uidxWn5!5o8*CBs(aUh+p}(vGi5 zj+v&yUHrHQJrco_;j-zPm^03}os*hhoL28@PQjorj4gN{KR!TV{7`E?mJ39`Nej)y z(%M+kbJ0eqm+OAG^AlQ7lsC{d4{Ij(zh#Rs3Yd+w_xXr`SA5Iw%2i5CbNWK=c_n&% zw;n5AY|x?e;hg#hO_Lc<0@e197GH07ygSN#3SkzVzZ<^+HBXBl6x(olef*o2{Lco< zX~r{r{`I+EB1c!DrlA~q_Ih6LqmcNsq7DtJBD#U@9bLs|JtVkUKt8Raho+`u{xd!| zCb>(>Pk};DsB*hQRU}?3$4~Aar+PKjGScI-v)fiyME!pJgD^}tDv8jZRl(5+HJ4z5 zzZ>PDl$N@+EbrWtC(!aUL*X~wv}^A+Q%}z{Jpv8O7Y#d}oLQx*rZYb;7~fMH+AXVU zFI2D4QNoV&(Y+=e4DIiQr1aA1N})Tf&5gVgqh}-PdAG2-Lc!#ElFytzJBhC#B&VV4 z*raLo)3Xi~hH9+O39Z3u;E$|W_!=4v3)XxgLvzS1mv1JgfPsOLSaWuIy0gdVt#Z$Q z6aEXs6Lzzb-#F^z?3zakHp9mwr2;hN48P)JnJ7N?Jdpuja?(}M$5E~Z;JtJ{_a+JD zDYHlobO-OPy*?`LYxNuP8<lxwr-ek2`>~MMRk(Sv=wt9yw{dmz#U3af^h#?EU;H7{ z>A+`zHs*K#vD43$F-OZK#$sX8{p4adnD|a^78KdgW+O_+d4WEX+42Q(=p2Y!tQJ}5 zGOLFyaa{j66~g=^m${4b?qJ>;6Ny;9&)u);(Er{dYSa607GvQ{0G0<T8tRbadES%1 z8JG_8BB&yxO*=||bL=0}zM|!$0vgI9+S>3q8;HsJx(8Zica0@)i+1x#;j4kM+1V_M z-5OJ1u2hULbC(9zxf%-LOfnVLH#vsk&u!-#!`%+%=vgLSYn~W7Dtg^GYPYzx5j>O; z1c8d*prsr4fMXRBa!FZv4;sxSn1S6UmHRUK;FxS-^egVkKDl%{dbYUUk4;oxq-6L% z0=#_kMpM)E<pE_P;N_x`%jS|B?OL4vU<>0T66be2O7scT%rP$C(ELDUj1`K?U;$)+ zMf3Qw^!Cl>=1ImX6~z!IaBo{<h0Y1;=-ZJ`KYjL1i0x2>6kQMZH30)tjTTLyBI-;U z6?Bs{u%m;OOj<toXt8C$eIKp-?sHZ@0b688NA`tkDxyi3n2I~?cAKEm-=rj{WHL+8 zn<f*8*$aG$ugR^l`7PNk5p1U^r`O_UA|q0}8%oh`vW1J7``LT}K3V<wi2mgZE>fmT zUTMk63A#{bo#5bL#fgHp9xE02(PD{0HskK(SbI*vkOnBHm{Km4Jvyz{y7dXu3k*Yb zNho>(BivQS&C!fWBK7o=g6H)$ij%<=0x@JXsg5t%@HcC+qL_$5DxFcT_um}*2bH~2 zj*D9%0iw$j(oqk<rD4e>_dVIfC3&}kuiauNc(~9MSty^$GGnLsR6${^Lzno?cZ=nA z!QS54qF=u)(s+Ftd{1|`QBJVFvRz-JGVzeeXZxM90l{k-@i<3?L#!Rc%5I>EZm0a3 z7Do_h>W329>2K^@nn>bb5DI^3G#v7HuxTx4c6JC>9w5vV!6M-*+<3EVT!Q9_s4>m9 zzR?x6o-NO}TlAXHbH6MCxM@1IgR2w#5^Ff)P5>Htq4$yRmt<B0mTgSUM3X>JD++cr z3C+N22-e>CFUsXf9AWIjR)O>j$_&jGH?l=97@5m55=Z%X=q8MxsT*gFK=Wo*KR1by z%TbGwhSfyyEz^S8^wXoxy9|z)cCvH9mQ+SiS5PZL*H=*R{Flj8!?A6h!#I_c!8qD! zSe0J--PxWuhshQbC@hGJ*`Pge$#dH`Vw=rnqyPDyD^$&xb0Et=t-0Jo_a_En;E1+r zoaP1Fbr<R^8U=PvSTWDwumELfH2Pk{vR@G*60x#to<+Q`R%usB@cg+bP)5oVL|`i^ zeqlYFPZ&=A`lx4K^;pJxV)QV*1PA~)zl7OOblP{|yIU8w7RaPbGB+%VHaPe%I4?iu zu)9U!HT6jMXjc1Ywc@{5WIO;y7k>>tqW>#^_^<NDZ5~SLX{EN>8WDG?=FWq%cWRj6 zEBVPT8l~{19#60?xzoFX%a%iR0M%lQq`lAn@#E1>Qi{P3dKGiUitltco7+mH?^BG8 z_ru;nJVQ)LliUbXjJbTCC0ozeTgxa2UegI)OyN_ly%0Dz=j)oWAepL?48^9YZ8XC} zMUk8cxk%puG79sBH1v!ZB~Djy5)58`;3p6Hgu3~&Mg|CdwAhUgR%NWj_T~RAN%ZZr z;+dJ8<#PLD4yywmdF_PPPu5V}h&6DR>a3<Cvi$Fa&jA-n*sslK?&U(@jU3fUsqdtX zxGgDsFPS~Pr*gva{fhXH8Y7L3jq^!pkUa}s`i;1~5Xj^TrTFgXox36|a(*%|Rsh0M z?5332>`K4x!Piorrci4pThHAKF;1cf$SdO?RF=GOIUY=%cBC6Fv+lcW<^|o}%AU#` zt_q#W6azmwz|HxZ(|Rf5=zg}X&U;oq!WgdQkXi3BfTvyOfK5ZgX(sb&Ukm*rAo20X zLchyEW_~U-W6t6g2|oBxw~NNTjs*1|aaL)(&KP<Np!dw*g;RQU9@BA9ODIzbH^$fc zf<CMFv1o_}7NKX@98Ec_)Xy#(S_@VWuQM#5-M<Ul<F@&X&o#Z`Xpk{FvKVbP_Sw!( zsLltf44zqk`;+3l8_y0NQeRf0hXB{v?$b7xyR(+~115{_v)se`5C0&=mhM;HY}H31 zc(dd`n@tptchnl%WKA(LQ6(>Vt#d+IW0NF);rwMy=|q(UmK$P+ZR^RTf32SVvp)ia zW+g5i9-$am70oUws<BfGX`?Q}9=T2g&C{$1+SpFfbYpuSfnn>Y@Ht;m>3JD(1nM*J z8JM*R_s8oOYABL}0|Rm5yCn#TDXOAt4<V*j0`e5+`0RrupBE`gyO8%bj*$weXlUc^ z%f51p-nvrhT;;EEvK7;~%|iq!B^V|P<;)p5h38|{tlq-WBdr5z_N3~ncwUU7^w85E zgzR<LcZg=`Zn+0NNu%3XdoJ<86S6ZXG&|99+&Vzy5uq3F$c4L2um!#8s~gCw4kSYl z(D&O#oo_XL6@Bl^ff_6^Io9pJ<`4e*v>t!Aw2ZX~czMZl!h99%mM7xAO4tiRqSYu3 zT7PWP4;THvCf5*B;_C`Lq7!7zoOj)k7!yDc0KjE{esZZh^m3jVV-=<R>b&jRY>+Rm zH`#+chwlP!Hwb6xJ#>JJhbe7QnJfon;!h0MFq56G%<TM;3+Av}&|C#so^hpdyA!qC zMf_N5W5wq-yf+>n1D%_k|Mb6;iyL>efo@eOdvaSXM4_r%TQIb6%E;Q#ZOiJ(e5mtr zbagD4I_J2VeGLDVa~wJjxR0%bVfmJr&+j|qm1bp{=VF8OW=^_K+rCur^J1#+OKkaw z`8;YHpeh4;ejEucSMEa!|IhLRV4c{Z9xv5TnkWVop#xhOQ9EEA``ikhhLc7w6^YM} zJFZJro9C{Y>paFE-R!I@%+>3bXLL92EZ@5w!Jc{DHJQ^>Glc}}A16yoqQGsmI6nV= zy&CMM)-y!;7+Lz~>MYQ|8gtN#AM6C~+1Zx=Jx7>>GAj5;a|(WWY7AEynPZS6y1w#A zsr_XT)JyM2+CWcJlpmo(`v&8;13X9jV5_wFUG^hQ0cF0a>Xs?1r5}VTtG%X)J?}g_ zo1Z;G!9YJcIs%9W(Ti8qaa9IiG{w6dxiz>ko?^#&k&f{g3CB32_m63+mS{9^T_diO ztyEO0brQ7rV%013N0N2T#<9T?_yftNENyjYu7?xBTy}GYL&X@`74vmP4}>Y^LB5zx zj%^hW*Pb>ayf!z9CFtJ!%#9@`C49K{L>=xGUtkAHF$onYg7Ue!xm2B^uR7`2sS+bF zZY`!692}Euuvo2M#vsB>z6u!lU%aHLM$G~OmVnnADQ&E8N=e3=j_)XSH@5Tdq*>o6 z4yoJDVZ@I_#7eyyIG}tT=t>dhgwbSQTjSI}R7NYx;daP5`%BOrPP{LK8`IR>jJKc= zEHPC$@3=~egS6SVm_oG;{@oK>G39f2twHc&W$fBiMmTRwr{3-Zj<APtz2)Tml6(TW z&1>l!v)4N0Yp1cKynTUXveI&bVymmGRPVfQO5UbwQ2Snth`0q1euP4sHr5YmNVRK| za#p)TYSc2#;@wSAn3pmx=f<(l`>a`&AdxV~%nkxfflui}YgzVC*BLqPrPu4@8{3<k za?IM`+#nn1z?jj3<A;14B=T`T>$?o9IajR_V-4qkgRK27G>X?6<ou7({N8$QY;Lj% z69+c#&RbU{3)xK9&~KB;;l8Du>zj_8%9p|~83UPs7LG`pXn+0`gL0<wW4*e0<9gr$ zLN*5qV9j2O;|P8d74711*?C7~Hf=1bn0)^HG#J(#+Q|BhbrOfCNc3+2m^_VQ(EU3m zPqLk<GcSq1`NBUZ%z*cw9;lld=A!Em6P0_^yn~R)XYh!|3SIIbue#wrbD2W-r|-SK zGS7UvH8zUpyxTqKel(mb9=fwL&H=i_CnIAvE}a}GW3Y^=<;+K-VJkW);$nXOSr)I# z#0G?GsLX?0q;MQ@d)^kk>U>SJiB3ZyG;B;j5n)DbFsDxN3n!EpYf8zX1$9U)=Akk5 z2BwB-|9ggr4+=~kC3N3~^uac~^|r8&5=x93OzU2SVec?qmuk(c&?A7=7!*0rFxXJK z&GrO-DE!*CY{af9>UHH0pWiC)`w04oZfFB0#UwP8L|Qrth)R9NiET!nt}$c%&Hh!< z6DTm33NS{O{AJYt1H$B>$fth+{bIMCAx(SdhzD3LTBhzRTXrkBfpt-=>)q(j8Rf7= zS-E@!g<skuU%{P~RTmO&vln`Pp7zguiwP4a`wW=zl4%|U^7LsIl@ei%OEdg+$JDtj zzcMwea(BsK0Ys($+h$w&N%<`)lV**gu~qw>|MTA7z6s#fQG+v|11*2%3tQeK3KzSk zM_OFh&`fRb?H8*Q#XQ=!3G<Jl+da<5ao!+0wpL@gk)6Gk-8Q%VWx364Hzby!eZ_ky zP(fJMb0@_&fOPQ^bZvGOSaeCUi211Wmu+7L9A)a!FVE%Pd6B;?(f?SM1DvBfS15(Y z_1u>zrz67Ua**EcnaaJuRz2dV86j^4{c%mdecpL3)v5VFyVZlf-roQDhmXC#a)S_0 zE5`sS^cMT!Ep>i{@?Wk_7f^#<jG9x^zvK9)s}IWfyZ<8#;7<o=9Fox&p!aU2nYapN z8dbU1m_*}S%t{+;%0X$I))G?TSS5aK%{JFX?^}E^)MgFLOK?UvZIF*|ce_F<fSMjL zUq-x`o!!y4lWV=*-?WPZHm)M3$hOE^3&MYntG_fZ3+W>+Zb=J!EMSLG&>f1S;^qc^ z@cZNfsNFm`y|_p^?xTwG8IQ#b5wX)JCj*e`&i#*sxAcJ(_l-?W`tJ^BL;j}2h)n;% z!t4!m1pm7=3Amvv8I;$LehL$Vf3Go#Tq)&!#Jb)-XeC$q>ks>%H=Xna<4ZY*i^0F` ze<DwBqfw%8`}IF#&7mr<#%4lLTTNcQdiDkK6*IDn<8NxzU-0N+fwK<g<!%4_U+8~1 z(#b2|*%ZC%+&ZBx_~)km2lo8;qvgMj*r2FB$ba*9ljZ+%-T&&$swRI-5Pg|NY8wCU zNBduXe?{P*C)obaH~OdBDP?;|_&{xabh4E3FFoo{U;H;8xIg@F*S%wT^j6_ck0#Yg z(J*?Ab;j4Z{m0>MehJ-}^GWOOi|)axaS$?QS+4axsDkeJbTq|%6lA9szW<$Q`QFOQ z+*5t?JN>eaoHpcm>ne3AtHeoG$jrNNfA_nA=jL~3v;FU2hUKz&$q$Z><XtDtb!39b zvB5+gD7(yQsS=dB$iPwVf6llfyeL)~8;YZzf(8G}T>Nhy_K%*?$tx?u{2;SCGf(Z` zb@0w>iPx-EU)XC;`=@)&Xn(dQZCP;qoJ(+6;HxPf_DpzUsyS3!_<>Xf4Z<^XZnn%8 zBNcf@Yp~yb@trrOq9g&j_9Bo|81@`iWYR=i$?0!RnlO{WY8~l8n`x3o8*QS$#Sf;f zuncvzUgI4?+m_XlBcCy$Wd?7xa<)Ucx8<6y>;yGtJQIp)uV}Hrw3=t!kZMlT)Z6lt zVP0#Wp7)L!wsN}Gemq-DWHIUNvOc8Z?;y6z(i7>&rnY25q5{st2kCV)?B$Nbp3cv7 zP#{;}Jg@@9dFGfltJcS1G|^-&wSw1fVztqveTy_k2Tpd@=?*#D;vY@*aU6yUt$jCK z<FOm@tmVAs9~#RL*WLF#TimccW!Fg<&F^xAG}2;^@<y7Eu4hQ;Xu8DT`U(z=j1Uf# zx_-OVdi4j-x<16`&lRIls9&fHxk)`X+h@vJ=d~t1&_Vlpk>UF8H4cioqpi73wrP@@ z5~(%cemiF-)ZJ|f$_BZjje+uIvF>|oLCDTT1<WC`Ue4sOQ=T+|;Tg8JdV})qazu<} z+09~Fit92Ph4ZM_LbLs7N_~a&Ld|LM-brbqWwbSr+^*HMnJMn$yks*pl-J5L<1)I& zOWy7N^|UXO`6Dzt#*?bB)`x7Jx6e_)URpo}BIjqOlX^PD0NYq?bd5Sb;GfX+<nLqi zT;mDktUUZQP$XpyrZFFsGYc>Lqa2li222$$<SswB{_SkB&HnK0m5Zq8^Gu#NnaWBQ z)%=eoW1B3K&Hq7zFvxWV`}z|S5yr(fpk?A<V%LDRmmZZ-s-*JJ9;ME!7sx^yw_2cS zd|Dkk@DWd&AwD}n^R@34oNcwp!5(KKh}Uql0hE1E#$=S&PHt(-Lu+}6@8~=BNe0>b zT}J065{Q=m)_17(8Tg1lt7^~PT7SkD;xo*<@3`O2YcK<5a2y)UD}|IP7jjlYxpmAp zlijgTfCgt~jXhn{oaBw%_82~C;q*0yXKpH`n#4GgcBG$<O*tlHL;1G$ugL!6I+?a) z>l){6t?Z<e$r}2mYkV?Q5MbQ#u%c(+jID2fkhFO7?}nj6JAQFjvj1<K$R1AX=Ch$r zu!h!kF~=f$umdS%nCR_Dd$>sq)GxfDm(^2GyM}ReG5HaV=Ft0VL+c6NJ~nzA*SN4# zCA_f=(DX7<x4OzfdS2lXj~U|_*nHj=q3-mA-qtj6!zg;aTs1?|Vd-Nxq=#)v8a$Jh zsm-b*W8=#1Yce$C)~8-tp}*A%O-?kjO)wFZu?o2Y>)Jx3=RZqxT(5W!_({Ezu`+S0 z29NeZr>2ubO+0CrCw$kw>qwE)3ho&Wjf1fJ2YMI=AmGqOT2^aVMHKENoBjZN;)2t2 zwYXl^nyegAC^R#(_F`gwPcdF*fGuH=sCL6cDiwSy3&R~tG>kMU>sVLPX&>Fwh!-Ew zQhCpa*~7?dXB&Db3wXr0-1g?!O*LVLGO_Pz4tuy!RA?_N%>N%_ZynY4yL}Df?h>Fl z6lw8NT#FWm(n4@|cT(IbK}&IWDNx+qJ;g1!7K%Frn0)V@JM-Rm&F@|FZ?aahlIQuH zv-dgs?Bn2D$x~sG)X)D}X;eBk+(9AzJ4vHhBHp?(w}mcb>4KxI=-v??Uf`!6n9M68 z5?6aidlXpiASt5$5<N~e8mOLh`la|+xkEwy)_<T%D#D42qa!B?;O|dS_?a~${KI6C z4$K|$|EH`qNs7d>q!P{cf^hsNPeLh+%`gA@Ur-oEiqrzS-w*mCFzmPZUBiTMcb9b3 zPf<(x1&bVR+xYJru|Y-G9pJz884igI>aqTLqWq8^l*X2<DwzI1vBAGSnH-6~k904? z@jrE)OkNaQk_?`U+w<3ubjNZ;VXLolZ2ABGhA&Kkdb%Ha6ck002eeMgYtlN)`SrKi zg0M5;AcOM^F?ZtsPoB0%+1MH%m<xlh>VH8f43YXb-YMrm%-AXUc=*ea<EMjw?Ld-b z5@z#fp)ltEmkRt(_x_*s15(~7tV+%v>iDVhul$qwf@0sq(~*|-B38-q8L0>pj$Efj zuQLAm=W~~d1$AIYq3P}wHwI<6f^nE6q)Th<+$#OowpBVE;kZfIc0P@dPxku(RX19o zh2<7qt4i(b*MWB9<J)s}sJeFlM=Vq>5@gGQ(2M_5_RggtwH>Uq8%<81bxeDXUni5K zqP;3|XFqTBkdGnZ9%3`nySv1$c`5#aX`C0!rQM;bR`;_9GVV10G&6ou|2?e*k+@+D z#4RwKih@a#YOJ?3AjX>vA;T--BQMusII0T<k1e(Q%ELi%%Mxa&HEe<hByY0m+pYqm zXNBxWdJP6DNgp;5$mhnj`5N=pU-l1&<iFbOaJBR9_40)qkL_nE+N17Tp6#J^in}q7 z2TRu75~(E=cFm5Jk1xha_0~+zlSI`<FO5TaZjITxJpcaPf?`PTAUXAro061o#s51` z*x({8)k30!<wntJ8QkaarEbrg#Xf%YDkjsU8f*UDsbtigd?jn~uqkC$cw8wQR0|mR znLQJhh6IZ(EKW$#R=GI8`5so<<#QskzK1r%qm$Nx=R!4Okjhy5P@mqWoJ~A=b8ULD z-f1R4t)y1c4i$C1J<I*-vGs<VTXJxs=4zWg+l@XTz^IL`_90%hj*m2N5Cp@~ewQ;F z-?9Q($Pg71(}~nz*hA6im*(D<@BDm$oR2pypT<(l%Egrv9D?*Vt@c5VSHEVp!%Bi$ z=(}PIsAZ>TLDyHG0}C7XUhgEXc)fXh5;Qfo)asSd>D&ODa4wcl&f>N56<!!Ns*HQX zdw)h4g@K>+SGi4PtvHssN(jFG%Q=r|W1)_7w%D%iUys_p7-H5o<dJh8?Z5a%<~B-s z48kxh@~hx327DqSnM@vfk8VhIxCpn2Nrfln0ZK3pn^sj`#b5i2a-Bro25Uus|4s|p zg>6!TZsFMzF&~@l;>w-lV-=NG0)_D#xm^}KMZx8N{@AJ-_vBl&v-)TD_DPkh{M-{R ze!G-Y`*G4`f6_<>JEbDO8$sf5se^Y;A@XsBf<{41Q7O5S!An5Ec3CiifwAx9M))(4 zUfR^S7!w;?hE|2{5O}ZUM^>UVe7+|Ccl?IyiW%TUyUGyW1)$#Z`60s8Kcry*@U|8d zz)XD}Tr}u1sS{;;&BULJ0>H}r6Uf8ozeS?k;mBK5NRwDo@AE?Va8Owyi%{=7@Cv>e zmJrn3rg>XMrnxPLJ4Wqf)#|_h$-mgBy0p_}1~6(;^SPk^frO0Gjq}ST*Bq*8U~n*! zZoN6vi(b!`idyS=E1QlC0rNc2_#4)yyDYM$_;RZQx=OZi#zjkoD)sWTtb;DB=xff{ zw~6MSx|irQH=C*2xgV}O<dDr4d)Xfc+5QWoPgDIO84g0L{vsJ3Z`n>i1Ms;F8^1%H zPxnA9Z{KclLBzt(Ck=ey>i{`+Mgl@SnoCLHrN^=9fDt<si@9>wp%<IU<|==Rd&=WA zpLpFSdnp5vhW)NMMR4`YA7QQ7!og2SRylzx&VDyzQ$+uF49{V3F3vuCE_<+R`A;7C z_dB@{#HIX5bRxFTn=}$TPRq3+Sm2Lqu}-VCI%(L9mYZfb(6Fn%>UE2RA{SGKLud{4 zOKA)$sn2AqCMuk60H%^1L~ObR`rdFdf6oTJ|BNd6WurtRi?~~A>cAyndismrK{#7m zB*HLAS?us5f~F3kT9nzK%5K<Xf%|KYkoF}k0u;&WXJ`KPcCQMhw_w(_M|;+}t1Gxd z`^vh31R*U<7`XKjPM}W%&WUB^QKovN<qvN3stVHi#IiV}(|snjvS|bEY;cYxynz7C z^?)Ogyz;{n6@xLL44<jw_isYt!u4$bE7d5gyl)iPR^_dIa?yDsGi0AW=H>uFBNJl< zX9NK{>~a({mJ<c2O7oEjtP!$S3<z7>WLw)&e^TI8u&H>X!Md<av#Z%YuS@|Xx|z=L zapJ4vc%zY$V)V-8W-t-uEHPp{;R{JEUv6}?G7U1H`N{cCOG7zgZ><KgrN-)_Gr*ZP zx3MxK=e)*XPB`oMj`vRY!E+cGg@sQ<7AwS#fQ5^fivcKlrbgrhPdOb}L6zF?I$by; zX6xU7eYwngciaB7#b_miV7`ov_&bC4<>Tgf7bsDN5Fu+sqMz>O?JyS|nRa954SxGZ zjmr%GD=~jzRP=}GJ%_e8=>wV*8T_>pERs83!2>zu*aT=FHp)I=>Nlg@$){ppl<oB% zyEwGKa~K&XV%9kqv~wZ(zxXMv?w{y^f$a<g;#$=m`f;AhiFh6t{iX|e_0FE1uhb|7 z=If_QZ=(+%rl^anG-WT6l;8r@JxuxwM6#j4Fn&siX9ZVIqi?7(2#dzUd~M$jDr(L| zk`kV6g-xVJO6suok(TGVqHt%KZ2r`8M=7FKDvA6}*O+haCVlROO>K7uRR=#35Qpe= zSLw4&Rsx&lo8M^yM-SFqsHx4WG_5!b@s4#rZ5M`@uxB%h@5us@Qk#r1d(x$3tm*Vz z{z$qs<U=Y4Z5%R*0*BFV>r1O8DcY<a-fZ5TE9-W;B8Q<qf=PRSa-M#;J{lam#H~1> zmyrzxd;enA6RsdNqZA;^zmqp62{6XHyuCIhtClU%_nP;fbL?t1Th+n&U7_K(+~}8r z(H9NoWMow~IZ9dgm&oMM-2D`%#0fa!+tasLp&}t+mEzUb)^-u_Dh_i<svKI1jR285 zgrqvnrN>NL0!@zk7IZHy6@H9q73LQ(7QM0>Qz<Cxt1%n;^VlN+cCIv7*>hi=OBrkM zZybI4X>X9K#{p;^y_BihE$d1zQ8*pk<`jRM8rH)eEF6N*v?ol?XDM2_TAgG&Bs)`p zziLLdmU;oX;ZKJz)B9UX7~qqS_aVp|jc7H^Ucg~Zu1hUd3dH`YwO*dA#@KG~+du6( zXGB858Hg4cfv`jQzW~kyVRy(bh40Nze}wwM{|+M?IrQodD3aY~05;wCPEs9hM#{t` z<GW$PT<M|~fK~UWq#_L6m%&ut0G{JDuSg_V`yU4X?UoN6!bA%@+HdoAv3&vC4o7ZG zf{%I4wI1%tH_G)ttK;nu76YUOSNSs?TSwoQm4meT{6QYhe|?5dcZ)ncC%;YziWp7R z@Xql^7k9bof0^ZUdsc3M>}XFlmhYymf2Qet!P9N?=LKW?_D7+NzOk#BTEag|qL!cB z(mBEblRD1;HJo+PX`)FdAf&rK%##Ip)|xUh<OWM^lpVJtw<N?A%F^L+McU7og7?*r z(sta(Mm4S+Dj6N2QozE)UT}7bo9@s?bdFhOz(t!4xB+i6RtJ*tRJ)br0WGX^+^up= z9t^7EvEpiLhVb~0VOvb3STsygt@k>nLRVK04r*{b`)1Qu`|CxDQuUlV!_)Z`g8gGx z?U+aJYpc*_LsC*92iKoCb2M!qZ>bUbr0$&FvcTqAQ|5kIklH*nR9uo$3qVqxBd)qT zo~(~sRY(A@#!rxlUzh#44GxxCZh1tYR)Ls*Fs+NK<?vV=f9d$@UJPusMzxck$hf$B z%Ltp}Pf9qZAT$3lr(OJvjz^O(9icgZqzAT)DV1+hZ9mo3x}NlYQdie7p+8>9Q5LzS z*-9a`P0?w*?l+?Dn{UrN78zUTmWD~CY7dAWu)ClRW$rqt1cOK|lE^Z5O)8CaY)tN* zj|a0%LDdz4Nkaauw|nZHj_aT&q2)$oK>Oi^2Ni<@AA@x>7jz`K$<_7Z07Z{&Iv0i0 z9O=eLdo%}+(_CiR^B;sLdCijR=6iiA?GW_85*^6~X7%&Kze2O3?4cVfYVERLT^{*K zD2eGCGT!-dzI4MSyDH#CS<)@8{jkNQ%j7Z2IT{)o*v+v;(Uy>ZP>cWNcD+t2&pP$? z^XmG96v3g{q4^<D!$4WLzi*|?>coj>b^!FJIChV{GvpVa;9yO*8&tqS@~JZKO5liM zrBfloiCkj-?dKl=8>*wo)4kM@6<>MSMesK+Z1!E*ihiM)+hY5n)5%(HmkA*@rB40V zf`dFRH6EfYW@Y51HW_A_qs2`_iK=DFkVVbR8tS3elyv+kM4>?;voH~JbMJgS@}?wQ zLqkK;8s;*SCoEaS8`=#aH#djnAq|SUP@68X>>~f-Nur200_lQ^Z1$0%`PzW*9u|xI z7TPr0hRfeR&BTH&a)d4cDT?8Ch}g&Si-(Yk7VyXde6Q@$Y0LKDC#k&eo+}62Z6;3d zL=$=IN9xM;e2iSBc-4MTxvl-YX-pfDnNDWETb>b7Gc1qFHQUO#P(jg*y*Hezq_`~& zZ)uGFxK#)>iZc75sis667Wd8e@Gnr_jcQ*0;_`CIHctSK*%anfbZ78@AvRO(JPp?K zz-+H^7c0Hlz8wQn)!1uZD)sOze9nyk!PLgQSDz?ZJidd9@0!bezLY!cT0YDrsOj9N zJ?LD<w+fe8>3~wVJK2#Ae^-&t{mkh0vu#^Xhw+Gabl6=qpA&t+o=$aR_5<lvySca& z$$h)teMa#59NSaBv;&5p&bOnxRVpqgyJ_I1n8hSpNQ#2p#gLa<MMdYk1y_2o)5X%V zB8`!gO2&J3O_=8Q9EYpiw*d_jDtack_$LhKwZUx}$645#5;M$o4GRT#2%R~-W#b~{ zBSn8JXJFtQ4rRY7&uCJ6Hp+^M@#}r|7OL&I+6(@nW013cqL;#x>crAn|GKyL6mpe3 zp>q0YecunpKT%fQno8w@C9I7|v-ewI85kqzoR050kncmY#r5XVBF5BsOO)F@x#9+l z-nhy`53IVcC=vj)R{9r&+ZPD>F4TDi4e)Q$)hqe$IxC#{&y6Ax<Zeb7vVWc{qgGoL zZYtO;VE!JL!h%bCFCzBXkL<f<S<{oWO$`|?L<J|iz>tLf8RBR<UOX>2JW0c8dnfRJ zfk2?GcPw!J0dJis(!e~$*Pzimw60ISe!CI6cD^$pxYDi|K3#ute!dyjuDe%luL8T; zrf@&_ZBpij(#D0&>3Od4wl<MVNT{VgYn?&X$87OSP*)c%^?tjmxy6*0Ct=Wb&6Gx{ zfa>|4w=ANQZ%Gk#!4rDoo5Xcd*;lDQ@hwvb;CzIX>DL8l#{X*WJQ_z)K}ZpOiCWs< zp9Zx~2Uc3@jD>M#C7||Ke4I$Rm9b1djMD%2P{!FX3!8`%V8QDI%6J_c6-C#q9Ap=9 zfdr%xOJ{b7uzOwKVVLF3525Y05wqq34^7_-Ld^mj%8)PKKLTY&H$16!Iz`7F%6hih z#re~bgyIlRDC-bRD&;*r`Hz=;0xvEu$~>jmK_DLu=D3lLN4!Yvw#YLATPSNn^?|lw zH^V#}%d=*z5Yhmo2scfj5iG1JU8m5Flp$H>fqt2bbM-24SG1j`(~vLEUY(okf%k*U zo=YnH-q`hKm@bJWNW>vWqq-Rg77uu3_L(l%)VnK+XG)EXBY`<;^u_Peu6C2+P|xbk zL;?7(XEbOM`KE^cBC)&{OcfR4sw>^EfYrvDv~N6k?DkhX2a0=Yp~FyIQVq%qFEX~s zH8G)FoxV@$&DKVo5cKAGyt4)*GSw=39=c!yo1kAgIXN@;xq$}a^!{kKzqlY2H4XWS zF_?)GdxarX_~&M(`K<B35K(4P|HQd;<<i2pp1xK+gfH^28N*w0`tdnu_2a-t*o8PA zZv><0TFoN)#6n~mEqC}Wtzf@Xc22Hjw1;@aJ<7H<S(}2gnKo06KFj!<10@V!<qj3l z{OKS4g+BRDyXnKDql61)HNGmwIHu3C`fGx?cZeT>m%xt_{`wb!uCHUr6vbF$A0aub z)`GDXI}zflyNxb;pTR@yRbs@yn}CA-*R@{jA4W$e66}7dN@b2e&bMZ~Pg=^)KA?@h zjD@qdLyrv58l+gG>qWsqm%o6!lbLW_?-|}(EEpJDs9i}zIE3brGSw1b_sl|)*A;AT z327oyH8<YjTqZOVU|w0_P3{kvXG?3|rw3&uw~9u5VBI1&euLts3|Jt%6*+s4T^{Q~ z-K9riVQx8k4ch27q2T4wNbps|VZ`6tu)fE*2hNN>h40TwLyel}?Y?@C0{i(wk3xPL zy%h%-nN%Wg)1HWK-e4_YEC(K;y2+Z$u&xU*>~sdzIB-B}s3$x1w)-BW6wen`)F8$S z`Se@)96wGUt0y(P&4wv>?PyY2roEs0Q~TYJ_oj3Q7V6W`YrNw+rCP;&ZtHd<^lk75 z5uT|9e<<$>A)S~S+hBqF$+zERvLIENKwk*ysKkbCLKAbi)<aAMAygo|rJ)6WeVWbI z@SmS|BHAlF<Y@FsH{&kOVZqNr?!)|5+_%OjQcvf9Lj+_0Bt+B&x<s^^ob+c#b-K0- zY%hlbMcCN%_P#)!c#<nDjEx3y<J@Lx9dTS7a@S%Jw{buYD>WIvu0?5%rbvj0Ub~@h zNqw{mjk?I<{g6T6>Uyr<{WLUgEcBYLTkWJENHk!x)n(o@nnJ(MIWO!8%M2Bw>D{>8 zX@>9CcRhId>AWtc!Qhj%5N#y5-6bGc5dG<70)pf1+2b4Q5-#XCj^Z}R*?C)FU;WKI z#l`rG7WcK}x^c9zul$9ZjC1vbY=S}rzjUT&aGI(AdV>!ww))~VC&b131Oo@d`Rfbs zpDYKJrREp&^CvV&NZZZd5?DLZB(KaKWFt5C-KA{SZ*2-#Ch~Lhyt6?V3hMB6xX-)6 zv^VG;-E|6bgP3Uo`kRAMk9IH5()CLLZR5KeuV}TErs+EW*hRCPsi}%frHS75pYgg1 zLPVMY{SKr<4ap((u|1h7kBkeX5W&>-Rj9$6upCX#4V~CuB0CflkRHc@e7ZzDhp`R+ z@Auyxu^>v$=;$VxcRn?NJMO_Fv^G5ZOM6}BCr4ENCo%E&_}c(SnM#+jx7Z7-HCOJS zD%E`}^uhsHgdM^{SKWPGMY}UpmpQwD8-43E$(|GaHs+&cnD4|o4zqZb&-j~-@aK>f z8BsQ;)y_mLkZNxOmS=OZ$}3HLDEe;+^gA7Lh$XqE@#fei?OsuNBO(M-WJ!!~&s;QP zg8~&1Qj*Geb0Ws-Avu`(tLbvxyVQ>Lg*v25fcnVluuSj&SPK0i`33W{2qM9&NZKR9 zR`(OhBYyk5>x{-Rse!E`w!7m$^B2ex{#OPywj2|gU77j4NO0gJJX<bHtYGz&K#Hvu z024~IoG{B%H$mhQ1}IXoKln8J{BF>`E;L*f8DS9ihlc$|{&OGj3O4iWy~T;*;anM0 z$N6Yok$*d%g*~)AM*L-uMW+;Wu%=h$1>r2(QZP{!uRgdut8*GdI{gV*=jzRS!6knU zewW?8xH*wuqWrws$%##V($)4W(p))h{%>`4tA8K!D<MxJhowd^*`D3mmKq@#S$`l& zZZ%ZbecK}iT!h#+m;UU2(}M;wA+({#u9l0-d5itZ7)<*|<HdK)X}wWs)!D;|&|Yxf z?|2#a>TWDYeY>^c;HfElyHj7j&p(S5`?NYUP&AfCqz51*T>IGcGl~pD32>|2QF9>t z(4<gH7xy0c(bc3$W~t@g{pri<pIRlZyf}%+>^*iJrMOie<kh89=ET`GHQ?~Q+cI1$ z0|GQ16-E;_^8^m}49vxx9IQkvUpDt`y+K-zlr>^!7eCMOvRMc!xVl{Ubs78_;3w`( z9+#K6(*qU<jc?p^YR`O0xsB&JQkDsYRi~akwB^i9U$-6frO@UlbEHp`t>ak;sI3&z z`n8L-sLJk)IHj!zXdBtiw5C0&xE0EC`_ki(i#TF&0NcNlQMBN-vql7lSwwn2torit znJv&&=}R1KMJU9fD(Z7-T5{yRf~x8hlbZoIdVBxb4oS~m4YZv8h&VtC^o9AsNYaIz zzWL>$0XkI8_oMW>GMt(f0rnL(Z<mL>_1ZicJMK4|+O1RMbK0Mx$C2mVi#ZR*@+9Jl zn8xORC)6vyg3aj_p-7gl-zm)4>}3wPR_^TWy5%IYUwv)%nV!>jFL5*w8Q#LXkm&{v zZB0c^5g$M(z@=`FfGgMx{vug9!O)MmfoJXY`(RYkrK>%qxK9ya-R=5FYPsmNj|GDh zx&8uIrr1^vHW#xxqK*rR5_-NHRNhBQMmXM@TOyB=9_kA=b$c__3B)>d<Z^1_uK3vM zhl=j(^G{b}!1U3ovWMG_sITrFss69dDLHgHRRKm%_Y<HrO5kVL{mO+;WS%PKdm{By z^@!U(BhyLm?fbnAQ^nr`6sw!Tc1T+>Lo|Q60Ql;qCObf*Sz>VgHj8ROnp+Bn5yo!x zE<XmrNy`%&1$fPV3Iow&5w2<Nc<6FsefvI;qM<Ng)$b?!`107MAOWw~b??hCWK24g z_*czOPDYq}g}g;q2=d_9r>_lVLrl~MDN_N}MToSoM*PrH>{w}CJl&QGhSUm{YY2b1 zFho>!)-JpO&j4XrUB=(~mG;GZSbMJ{ju7lc8tfDnj16}NK8v_@4(c1&{l3z<JUHqx zd&B=O6s`TXwi)Z41Gfu37P<I^K)Se>kcZ<!rlH>^CV)Me1CLd~$t?Pm4b(Xxh73*v z>JKrzKOE#KRrn+p{Dl$YSUJrSJ7{bft~S?JZHtfvItPTf6DUeXBKE9gJyjKWI_N0| zq`RY{-uGT;)4VhptSjjkPngLu24oDn6=53{81|A~_B#j|en`1)EmTg(v5E6w<J+$Z zYO&qktGpU3J#W8jC7Vd_-^I1qCHXxQca_2u;v*}3`;9NPb&EXIo!C1&wavL@ocR9U z+A877j0EiM*oDg3P9!@V=1!mzOU@S?9-H>zIDL*ZkMSZ+5X20j90wU;iFxnyx$CVT zHCL{QN>t_tg~)5D?A=_M-Ky((8bl!=4%|r;Pi-UwsIUKo2Ry&8VC>m%ntSJb`XQ$u z2oh@}Lylrwn!SEi`Tn}9z9qisZiqlY93cnPaOkzfJ}$<D#oePE$sg?LHZUAi!K-_1 zpCjLmVTWV)>oUrz70QYVc+X!IzjWNxvj-NuXuPg6ibON?HbZC{3!8TolSGz)3Fryi zek%7T!1TL5R;y3WIi`yYab96Yczc3BiSBr<RjH%4jt^J#d!DBFe3OtMGq1CwhDMy6 zc!@PQ&P9)LII^cW9e!)v5PtI8`m8&Ci-=*%9gw%`%~?iFE8VmPjd;bvXUxg(`7z`H zlGYW9hD#xRZ6|-}v7SS5l1Cf<#2kzVygu9VakkY(yZ*Zz>)5%eNH{^~V1Xn9XULpI zTwRnsy;ZCaT`Z^D_r-YYam7>G63=oTwjVHdA-yPYcMEqum300b)YPHUQ;&{=6A{Pc zmW5?GyR^N#VvdzRiN7MEtna=>oaAQzCBp8>gc!r4O=8KV->~Ou5c(doC|4^lIHRg9 z`fD8}55^DWS9U_NkIbq72#8o{eVt`|!-skgv{HvGqeR1w*S<G;;yzHcDsyH&o!Wke zBLF(IPZxHhkFyZ)ry1=du$n)}cm)jy{|UF_B%XRTor}vTr;@vAR;<4L;KH7I{^M~4 z=#NJ&Y)WNhS2o+EX7vDZiyLW(>mu!@xvftyWBx{tW2zdBX@7aQRKCD;4B|X}^Q1HH zmR`oSM?OAxNybr>vPLa~OWgY=a$n5oq$wt&X$FdVdgga2=w`2mzv|T%xj3;7Xcl1C ztqqoodrU-S97+>|uw~}3fOUV9!NGJM<*$xtBf-d|bK5ElO-~)YJ`%lgj%KftLb#cM zqsSif55&B)ZTzeKO6~J6Av$&L-1m~r?`;2?>$X@jLR^|9c9e29gz7(Zc!Of?hdHae zu@+Qhdv?Ib)4M<aXrG`*20(S*GlAUDoSznUx3r)ODd1*;@!wtqWgRagbS{-&x;$}E zYrV-$_pFRyv=A$pK*mpzj^`ZtQc#^-(coX^=as+O&nw1HgANzd=%G%j+O@T=Wez_F z^;Mm07jq3|zi@fb1Z=kp7}Hg**JhkF|9RKi_QLV~wqoh>Pcgbg@uOpBWLF#ZZCV}K zRI`NT^k2TVgBh~ZB0bQ_0=$Yvg%rO(TJN&?UPtd=BJ^fS%pal}hvNZ3c!&;-|7#tq zTjFE)H6PxK@qNjc_x|dGab3X0-rkdR56Y!alAPF_cw_naYw-h=dC~#*F-X3)wRg;M zG|vmirj-M*-_gPJ;deV@J@ql`Bw@zL;7JACqqBTlf-Z%0l{Hx3%_l=Dk$#4}!I)R0 z`TV1N64t-Wg9t0E`iEq}O7C`TCevKM-{Wpj!#srnY}ItYjDY5*!9*@q@iWWA-hr`F zL~P^f8D5*UU<+7*r!b$D0Gf9nE%w`L-%xL*<X<LDc-M=z@`27DsFm;C_PC1iC7y!1 z$VRus*-7V2rtksf)r;!G`6Uv?<3-g30X5}2g>O~y=>vc{IupIv%~ZBC<!{2mQIuMM z?|Y=U0ipp<$7*{AJz$)$S-~34E(@wR`NXlk^Iu}8aXga}fnAM2Y97?Q=f{>8euw4W z{Vi(&y{R-ID|#-+2lcwa>s=MU_El;M8X3EJrzC-$41PyzqY7TXz=5Ne^SE;x8=H${ zK0xIw7izlM5es^Pi-D~m5iWQMGpv0I!c0fY4c{@&tvd{UM_`a;9Hg+iTr-WH#=Zq_ zRiw$blQ+F|f3RJxE&IV3u<WYa{-@J@$=3F>fGz;4RcjGX(kMv40s#23W^z<Q;Wh6} zr*GXoKO9!2;QZtqD+&`kKCJ1QlD}@)>`jB?T6~yMjp!bH2eTi=!Kw5NNQ3^ZsLYz9 zfZ1F$YCGZ6i9GUBtqfMlX3Ey8XsLL~kRHSvJ5wGv=EW`cO8Zma_b_~RygW6NppDC4 z{)JzBJ9?1NX#t3@s#2s3?>70k9^CdAM$N|9Vkr5lYc^a=ACR}w<HR3TWl+fj_!g-Z z%mBpQ7g97_bjQ2Ti)}A~)uY4X`6!)Lx=pnlz8Rtw`qfT{XbDJzrvG%WK)V_YT;e^) z;Wi>$4ET|%bZZ!xR|RZeJ-*)~VZRe>ir5dqm)L!%`G}5$5S=pUYtW<kVYvpU(-Lal zb3_2)tsV@4sdTcsjm=ZLGw@2U6%GY=fa+*nl*Q<BdwUbPz?#cV4m|(_1}1#=+N$;D zFsw^gSp)<y02}bj5*x(?Cihj4>zTCXvDeV_T9!!g(fAoA0kLW`=fuIqB$;BYFsC=a zq{2kRMX?|>>A7NQQ-wBzSZ+U1H%5}OV0RE~hDM-G$0sC~YJ{NF;GpssKa;Nn)N;e) zwZCb2=ev^bs1MZH+P~2w@Jps|vf2u9+Rw8`7*aW@SB5F?nDJ*(FE8cU+gBzlRzVtM zm&gD-7ZoarNvHG68VM`*T%<<w`F6PKf|@;JmUWa2Ob)My5t~@O#^zL)hlO-Iz2<rb zknWuao8W%kF?#CHifyp}5zvZg5n9KD!w#brb(g6?@4v`I1FKZaaDzsb8xLwDeqC<6 zFE}h{Bo2Q2#PuVho<K)3lQ)=5jfbn3NlmQLAN8Di(rk+27H9nS8}4CbYL6%N%JjBj z*rPtH-pRpoOGh(tP2<21cr#F|F*AOEA&V7|)=<09^J>8*2b{ufHt+jzcG<&T?wo}B z3i$0O#3R%K9b>^*$7Z=A>>YmZ+sHI4b$%HhWN-Vs$9WPSIfivL%6TOM7o_Erp5C}O z?B9P<lQGTD$D<)`)m*dR4Nr_D^91t1#um$F-`C*rZHXG!F!EiKyI~c;$9|k&_Q2Mp zHYzlWTx`bl<mVeiSKD0v8~0JGNHwTL&4iVG47wQ~i{rzJkKm`S0Uw+fvYTt?>G_)R z23apsUi|(-o(9=RR(VwDaxsQD0jr7!!(~t<o6$`0+bT!iHv;3LGZ+QYK_7UT{{!ho zutie%HL>?32HAqL$5Ji*9`1P9<IOSI9sy@xFe(zDj0bHR=pEtnN1uiTJGm;a5bZou z%|Rif2ZB<QkoVpdrVNlkKff#IxD-$u_(Zl7B6J`IAdx0vO+;Il{;d|o&fU{N>UMvc zXsJQ4uKB9kd-;lIS{SVlO^RMX6+;8z5HpCY;+8H|FyelV7j#IqX*euJaK%v}wAEfl zTk-vA5D7!OlV8}&nnTJ7L)Q5P*kBogQMn<9j?_?pg=0Hap9f{5!%N&3r16n>ewVP^ zU~BHxXLcCv+GxM>0ofa8Ls%+pV>NIkb{~6u8|JQH#yr0Bm`_Xli*cO$l%9kAoSr&V zkU-S$b_PiCYvR@1zEvq5jmVI<BQD7iO*5@WYxBe#Q+-XcA&x=T!Fm5q^zb^Sa(;H> zUS8@7F;ESVELa-4KSg%H0?n|M4SU!3@HsB*TQdtI`TRU=0v6#Tm@RL@RK$eM5KT%| z_(901?#%WEX5riMb>xzy-`~S-;ro3{aRi&hQANT&Q!^pkPj=0!H^lRnXisP0aSB$l z`HA1B*S2+!B4}W%4}^KOa)hQ|B88Q8p@}&@_hOBL!&?2uplI2*6D?gl`<7?CUsdqE zY9hbw*E7TZhIg`W`MhDTLP5P77JIdgNuPdNR1E`0?9<q1TtIPxuw?j&b<Fv!&#bf6 zR%N5925*O2^(9P3dc`AKti}!59sB9zh&3pA-DvC~qC@w>7w#e>*Js-;1dwG}*lm=+ zy3<izLp!&BW968eubBU2HRfOL+qj2g{8!IMC>MKXLZT9UmNYK<Mj)Obog!K_EBaZ6 z=QcXk3SS|vt}6{*PZ#&mE1|3N6zN5*k~nA^&#w(8BxsxFBGUQ|waD%gwN}r&cW#SG zU+ijREFO?W=g*p-Pa}{)?Ah_4mA*RWb=oa&--mZ?_HVb29-6-Kf^g7BFX8tcrEuWR zuy_8PTg&J6uYJ>NmQ10^*PQ|W{LX^wl&d?>h)SX40jW9X<FWo>1ULb_8#)MxNX)?f z=qQW?A7{>hAzlN`PG-9rK3Z7EOs4Gd-YMhNJsd<Gbi{S-g5Ii)_V8MZ`2&)z<T^X) z>Zz_D-&+zhYQ+@hD*A3L>(|;do!c?EzBn$24qWLQzLmI@kEl7~@}D09O8Q9O(ZqVb z9+1BP+7DmS8R1jmfE7tfG~f+8=59CSK@pVMB_ULpK(Yu#w(${o?U*`m_-}EZ>%9;^ z*RS}TYtfyhHG(onh)}7MqhnCJ=;1`y`eqTv|1;fF&Wi}kPD&c!l01)d@fUCOs62$y zRJOt46De_NV^{r#ygqC(iq@0M^n9e3>E{7L#&M3gowz~3wZ+y0wj)P%wKoe_zuYB$ z&pd+WxkL?9Jn`SX!pL<7$Mr@Eu6g~}4D{?6-S2+yl)2rjc;f41M#iSA3aop3l+jw9 zhlu<8%E4-p`~@S}h*v202D(C1NS9oxP6s#Td4AM<Uw3yJ#{L{9<{beek7@Fxf1S$j zmJMv{rrdYaIWPmf?Lqae#t=2X1A5XLyXm>ZnfF=TIA(2XRM>0w*Q&ds`HTh!dX4-9 zq!e#@(Ukbg+rc*s%4y;mmUT%f@pS%|X=Dy3mUc9RgoLJ;NRF%<>A2WoC*vnar{Ulv ztZh8ZKMD9Uh(L3_c6U;b)9F}F)1QR&1Qafh)scLlW&Il0cZrn(9w&>*19&P4pOM&c zaVW&op`Z^JGFpgSJIrv6g77yFbYNW|hUMQ-n_9Y{0sI=({(D{ILvGu@G62uNKblUq zw@piZ7Vx%cFtLdaLdtmera28OR-0`oCo;uyIJDhUu0M}NXqda{^o%1Umv1m^=J`BC zl}fD%N6b+Hta3A>p2-KdghCyFx#2}QRx};bfH-FyGtll~Lv1%&!gM|pn~rz<Ye&X$ zVBl`XDO%jl`DZ$8qK;ONADx3p*nrKmWHEq|I=-{Q)_^R#YM!GvYd6EPwPEJ+gqE0d z#nAvq87B7f#yfOuDrbdvJ|_&%$m?O2<2t=IM^SCB`-pw%eTR3BVz3irv)EF<(6yEI zn4TvTl(l0BBsSJ2y=|{CBE(PRvSOkSG%$0w1an_5G7NpUu(QCcZjF%gFTFhxdjtiQ z2jUeKexrjlzw3p^i{D0XB38#i)n_aTznW<5;i{dr?lX)w8j7)GFx{f0(KEl}yH(Jm zN^)nN&ig>wqTYPhJ!Jg_0$OL$*`Zh5ae=h@(uFk`d#&PPGTkAb-Q`LSo)%vmB|XQH z^I3l&?iDEo7Exr_70lTQj6l8DvlcFq0t^WAHq(Ph8~#88sCAj9)fk7sq&VCD7#2=T zwOO6C!r`xKxp_oba*h@gg_zIdZn7D?S6V&VBK3?-Fu_@2vh3W>7zBS{cQdRs*c4l6 z82N)Y?4N>sh{yE^^kW~*TB8v&2#TvR<yYyGkLIsUYaaGSz`lI})Lh``YSGYYlWi^C z;Y-v|gp`|uj|%OJUyG3j2?nL;xBxdNOJAU4lHA<M16VOcl*5Zp$8kC&G=J3`^!QDc z^e2jFyqo3x2rS3bhvxhD>H;GSVr0TJASVVgqC0yh%=4@8F;_@_Y!QP@H|%<c@iq!$ z7;5&riCpBsh(^-l{c+({WwflNRuTf?N=k@--eM_13s)}^O@H9p-><0olQ9|mb*R-# zrfDYZM#uzClF^9#*koKKQ(bC#511P4<HLoI59{4kPqt%FOg21tt$3>uVlgF!@pLvr z{zsrqN!byr!r7Q}t=FxahvwxLIv>HYUcVu<Vgv|ia$K3rj~l7|-RAiOm~^URf5;H3 zs_;y|Ox>1?rZHmAoG8wy>iF@h#u~xVg8Rl~&UCo~m0eY&`}!<i)|}0xo-kikRKVP# z23zh~qfUMSyr}qv5fF;v>P7O+B3D7v5*!xsr%vbfKyT|jN5(h1UU<py6S^mTQ>0K& zKGg{#S(B3rS%VF|Jx}<QKgthmFf9@LQ}p&mXnn?A=Z{Ipgp&gwCT!yGz<Lwn#wwE| z&^8OC_=bbBmMNvo^d6}SWZyDRFtseO{xS|ew7-Y%O>1t-$8DDQAX;N}DxQ5*TzkhI zdRpUFiU(%mM#GWUD}tA`+z5s~#2=3J+F>}*Dfe^`Awo>;<{h@&45tk-w5H-X^xh{9 zIBQBkkqOTFc=TVq&l-XPl`vS(V7yk(pA_66)B@G1ta8npEv9hoV14BNi<Zh^ZBog% zt6sNrhMj(W@N-C@F{=b|){c-cTU%h&-&F<utGpLyryq}W*gp=Lnx|!G_N(iWlq4e| zzbzaG>XtMB5u3s%Q$-xt?S+g+1<uIcpB`v05eG$1#@y~H4yF}#{bVRL)I{0x<1~yy z`PqY2?A3Enj~*@7LX!%>D^2-qTu1b`sKD?LLA0L21URvM9gr<j0V(*1Tvgp(Ydm60 zSfW4M`X(-8kYOX30HAMtj036ddghl6l_p?K^Y{AnqaGE+WmJ>S;lf$q4LEJEPVNt` z9Nap==ylPzODrDWf?H{h(GIC21H>B5!RjB;HSjBVO~u13gfTi=dF?=!n<NKg>w_;N z9wHydv?NiqQ(8T3xPo5+fAw98hSH=aHY4jqF30A8Un$b2AK_dZ4qj6V?WtvJ2jA%o z8the)d;S8GA#Ft2l43WR(AT4Z4_K-PTH7A$8koeb21zce(V%?<bVP$5=$p&x*<+f( z?!|f+<VKu1`B44p9TYneW?Cp^@kAy>s#dbal4ie4FF!wjCynAd(1H$lgk^j_o)Qv1 zL&+uf1`;=4n{~V*N4VYwa-@B4{(im9%)I7l`RCVRkJFJ`M-1!6i)&%iadUrvT?5}! zP7uvtdkDg<wbA)yD?WA+uvHeW4;<|6YbEIpeh>5sx%22Pq<{&?V#FnmnDXE=@Iss3 zzREaSbcN>jn0c=S>6y{etgkL*8FFNt{n+2X_N9Tqs;Xq|JM6GtRLI^WllKAN`%>$T z_qAWH#!1Yi<LV7WX}_#E#-C$pq~5O}T{6q~O2FQyuN*Kf{K;z4SK;|vjt%*G56kQb z%Q4~hVyR|z8$Me%$LkjTycD?43H8}sX6+2;>Dm&qyDx8mWsYf8r;-|`AB>w31;k0} zgVhNOM(00lzX>{&=^p2rE1T5S{&zR3lnSn`W*bs4`)_xYpgP&yWvoDie%SA|{ZXZ* zhapQtcjXcf`z(}Tl;)%$5gb@Nz87PpoxipGGHyoW@3*SN-A<S+^J=-B0tOT3PtJ-+ z{>>4x84K(8`fCS<-AIh=k;e4OfT{bTy*g^!>N6x$G8nht^_P?=CLB#moR_;80ps=i z4W$|>x712GxV06QaSw&b^laKip9o-$^LRP!>-B-{_c4G|rYYj10KiwW6uD-MO+hU= zN^_3uE{NJG4YC==^;f#v9i83ey<)vpSW_(VU8Pw&X`ACV|Ha;eY6ef7L4tusc^sYS z2TeNWmd$0hCEQowFHzF$FUI)vH~^_$?;wnMf8&lJcK-YTuah;FC&M_7o2$0nua67} zwSmC5qN14`oxXPWQ>%@igK1ARyqas5x_fB^{AZ9oI!gl9KXH1gqr)B#SLnC=jd9wZ zZN|VY<O0mbo3wTaj_g{^F{^exit&8Fp~CCtZSf1q<BjEAW>0AkonMYc`Njzr3p5$B z1s&+$ZEjCG7!ah^&Hh4CI|9kZr*|qzBa0l(v*%^Gf#JP+ze7MKC}3abyz@hBCNmQe zy`5BkJ07m@sCA^}GOgdpYAPI)woJ_mSF4jrx-CrUsZYK~qhhdg_B^2uB3D45E-Nu8 zV;s!6F!ILm%k%y9^WL)K7(chFb`F4YHvvN(v%QBkl3rbK0}3$to2in{h7)<83fZ6q z0+*-{=w2OI<AJq<-$YKpW8y-}X?$Xy^0u190tt==B4~Ykx5MzO^gDu3RonVoqrbT^ zH<Ei%*jwy=^5jMBp=W2xS~8~m$XWu~{p(re758bWuTqmATMSSO7Mw)}FA^XG@uJWX z;F#k4g=Q!}IkpC`=Ih(4;VVftYjrI4_HhID$fv;H0{ta{gV+<*2(Q7d?R3zb)e{q* zSrm+825)=cUM*o`3%jiyiduEdJj|+zRu7{7<1wzk!k8XeyiN&zJidb9<P9v=A7LJ= zI?h4&x$UyHnwAz#&B^iWFLho3XU{JSD~1GKUS4W+a!9XHKE`kK1nZ$X<Z%?;%w;vI z=Sr?f{N6gj!*rpiKRMxd(Y{-=%39*JI)RE1<qa?0Tb#7)+Z*^ewD@%F8$@p_m?l!N zn7tWXD%sI>D8QNb*h$Ap=GN!RlQ^$6(F4ilqC^)2QtC7zsD%Z#G4Ab<vMn_C_-%eq znnd!t=|;@P_w#&>>@k3A;CIb+EuywT8>o7Yz=nqAl{(08549|S`)T`0O2i?tDMB2n z9j5DBTxt1+DWbM)C^6u}&V69hFtbd=))7Pm3wiTnOW3yS{&#H1gvrnbj~oBEvGn^U zcAc6*3RmMNjIX3zZ2r{I<(jC42F>0{ln-hobpt|HSye3wQ&eF9q}FcLi$W-hY;NL5 zBkGt$YTV?iH@th_J`{Y<Vm}+&P@440RUby~#>k!Q5<5#>Zq?)DX8A^4&@!klYn4k! zb4et0nbUxT?1@1>3MMKQc=Ff_?DSj{vJxzi`-rX{?}0=|B$))aM@eVartKTXI&(nj z7hUd=Kp@&`4a+p~Ydy_-8Rb}}37VIC)W<tx9xuwPIHNGf;oeG}bU^LTU@^O8|08*t z$wv{`-LK#(P~1QuX$NW<PiHr1Icq;&Lda!pQb5v2@VA}KZRE37mmo>FRG>~ZtLnI5 zuyVn~KUAvn;0sUXwS?%sX0D9E<3#Nyn#WvZfDe7-x3uSXOZfd|Xu+4=my+~E$UAx2 zC&oh~XW8q3o45(7GxqmXl0Py7Q>r@u_EIquW!KT>R<I0+f2&f>5n4f%q<3%;Pl`dG z=YNhk9YzDZdWZzXe;WIb7r;vdqdhUVSC#p^<c4UVP|5XaN}sUob9E9ob2g!f$~y5^ zVK$mu=`J^F{3}AYqL50|*|I7>{;DJ(mo4UdDk%>hDnwI%MY9vZ<E$-7?27{*Q?D8c z)oT8UBasaNS}s8(IP&=^$101-t@y?lA+S_49^0i99VdjZ;S@tzmp(3LIV6_m_8Zh~ zB&M9(a6#Wc8^I>w=LSK99}eC3rgd7AzJBrfqvk5S<+0hDcs%M|i4FFf_$x{~DHR^s zFoHp1V`k`B%lLc#PM2e*SMn{_xoZ>eZyf;{M09kL?tvIwT|4d3X77IVuv}LCS~Z=} zul3Es?L1SSI4#+in_7+;t19JM8(#R;j7G91f3g`atRCBffR^J{&p)uQK8SC3p9twF z=INC0f*V<$uK9LAJX*qbJEUT(_r+c=R;IfSkwlXkKe+w@Kxx7kIT}vtu>I9?A8qOY z!od6YPsJZBO>#zPOqw2Ep$#>2CddQ95g6uSB8K|=hV*3ZfumbN9)Ue*7@ykY(eI61 z{@mZ26R9QsNpGAQ3T(cI(4@2g0@bf==U}(G#q}dkGDt?~n4#2aC#rvsejgUbd_y6^ zd`<N6b^J%V1WAS<8KnR11&BOSOL82fq`l7&E8-_P3upTVj)eKp0dj6pg(Sj}fJ0MI z$+g>tyr6Xn5>+@pF+r|Y%v;AZk;idOYS?x(#b{iJ>6TlnUmqV?t50Fl&pP`gs3;+p z$ldM7h)sNwf+GRP8sh6luLw^EQF#Os1m99xIYcNXfpb_8eR|*rY%-~%-B>BYUC)ZV zESKexXZHFSUyPEYV|RU{&8k3wDwB`&@h?5$YRqbGj8xYLT*VaK5`o21OT!d>Fk?j1 z!>C4DZM<qyP?l*)AbBRg<Fc(4b}7PLgm8kqabGtu_J}H#47$kDhZ!UY@72ZQ{Yc1@ zaU#lDTK7OORvHcw3{-viqvCRMlxaxslmTJ{O|+^wR<|o7@ZdD8;U&q77yc~sY2NBF zz^v*AaOr%I6AJ3{hwiycG=|iDIinj67AE<U5)0VCsYX6|6>P#<AJMuYmmjz0Jyad| z*lJ*^%J3V#*+VzKDcj`|b*%q>Kl5aR_K+|Iy(;-1Ji0OD*rJm7$Q&e5O1p~`TCQ8v z{@VSAds$9Mz}7JxEe=b_PO<G}GBv;534_{c((fFecePV!hoGD8XS`?3Yx$fJYyrh5 z)xSl;MK?0TOiwHp#Kt++Z@dV}hr(mXokRxGiSeW3bl$l-uGJdIjXS;rj1lBy0d9~b zF{}9u-dpEV9!fn$N<VR*<apg6j8xS-%zLNN?FIHx#PjWTyCPc?p5c2)s@>5Zel4{? z%L-A5Ah-x8Me5VBYLP?i|D+)KY7tv1kO}jax{ax%vm@3e5EtT|k=2@jzlrjP9u0UB zRtx)ZLrY%nIZUpv7ycW}B{+r~{$YNH&^+dmDjMu#PStO~NFV*Xb2`yXxY4!XZS;FW z<T>C38Kpy9H(N=zZ+lxRg9J`!1aByRme-_Bm7U1zlms&t;W~uNf$nG11>2QnFpkUp zJCzEh<|o}>Lb#p`-4e5LFCYBJ!P+?DYO0ZRR0(4wHQ>$fn8;TNct`V<UK>+rbNE`! z<TDso@};!vT%_E`D+~CIM^%FBJ?zi|T!)o<B9XzO8!+uEgJnpze_Z{hP!2*Qzm0!j znLU_XZwt{F^&TO)|87j5Z~=QOziwQ<JU$!lMP@+-i95;-2{ha1(0^+TWU9R1eIKjl zwu)7Ye{BxE22j!+IaZA`Rw7rw*FRF6uuXzG`=obk1nPV`TGXQ3<bB9FQ04>IXIJSo zP5vAZr2k8{t%Fg>ghH`z>m8Z!l30X=4AYvpEE)BV5y|=;8^6wzKIR3^`>C50g|y>% zw!b4I)Q1v_7X7=}LbI|G8A?a(g#0c<qcnp2Ei3wh`Z<U$Ajb7pCNM`Byleimn+wj` z$qJTFG7p+L3|MnHyJ_bQCBOdsA`s|?@<51|4>x*w)SUy``Pc<<S?j5)Z!fXbYpuF$ zl3aaP+v7?V7cPfQn93pHARO?aTsiEdszDpH8Cy301}M@R(QZ4iaNcLXrNeyu)iRxi z>)Hgs=SB#Ma1N(JRNnei##ZsAnbEWZ_lZ!=2zvC}f8GVj73<;ED5qm~+4%@@w-BOM znYz=CqRuR0Q+Csucf-xH73RS#ot1sj9_h>EFg-rfk*M8A43kyk9KW%qstXWPbN_2R zyWyqfwpEWI0aS9Dos%wOY@B;S^xs&V%1ui1ZFRSzQ2dJzEaaM;yfJ*!;rxVLc28d^ zUq+Nyep>BkySU=rMO@L-_y{hBE*^bJ@M$SBl}194i`3mqxqlA*+DjCL@p_BO0Pj9R zP!r{!epkjzxR7k?5Dk7BGRAAXryjwso!+{NZ%|<*S7dYfM{7NkAR%7ew%bL_A&+xV z$oo9};MlC+dUj1W%bx||Mh@I3;fTw1M(E?1$fUQ@dcz^DH^NmJZH-bd0uIofjqK0d z&bEFa8{@P^raFH68sh$)VVIiXdAo@`m9s5vP{Zh>lOVL0u-&O{U+Yj(XOk&Xou%uS zA42!`7o@LsjkQL{3r$V?gj*UkK`lWb9D?^17U-0}@qgtU%3?ey#f8<TLV{_$3wP8Q zf_^2UV5Q4+sk(k#PX8ZL#eZ^#AQF*ad-4>cdQWdHPQ+}x7_?SLQ{sKZgynrXdz<mb z$UC&%caYF_LFZkE{o{8B9@Z<puMR66kkH3>$OOo}lG&IR3Eqwsp`s6w*W~ZZKhH+F za$n4q8T8>IQ;}=R<24sZpQ`Of<pniS#4A9XYh`e_kLI!4KeZMjt053O4=ZOEGSOaa zAA7Gkb29ZwI89EHK0W1y&;48wro)sr^3F(im0oJcRawFvm_#{3m5Zc41b=aTLjL#~ z<uEd@AP*;qKGgRPkD#Ci2NY<?KNd-jQz5#YyS~cISLVe1ihz43^qGlPDu>v|l2XHU zY?mUO6hR{p{5C4PD=!s;`(fjqMUH;g-y|QR=u%jOLUDMvIRfK+)flRBe1Jj&q8Gn| z9^dVQYuwlVm7b2?U`k_i^}LR1b^<9MYhpw#Rvd~0R(lSVQAE+256T1<b3=i}&I>XI zHsB`d2WlMMIrASJEb&NaBo847dMH)8tf&Pa?=MJyXgO#L@AR|W6WV?z`=}`Q^9j11 zV|QTqrb%nXT(X=c#D;PtnBXu@+)d?xW1EnUWLaaD;Gs4M$QgUIrt{Rex{A?bD;YUB ziYT!2gH2B{e3Iy0KHpjA<~=`Rmh*8)LPacjJ%W?EI0C}-g~Tkrmss<$aXTt935Y5d z0l{>kN~~PZ&uW!kZ4|ea=;2;{EZ>38nU^6DH3(L~FK31T2u%MvNxu4eJAhlY=Tl&e zcV%E00{)cr76K8S-vK&Q=bF$v;y%fWo*;tf+fN#O;M{!s;Nl0PDGD5DmF6_Z;Cp+S zaXo}(){MX^?f_)-qX1XhjxTD|H!JWx4*Q&x=TmE%#v+m*L;IL`A?%O%AO>O}Izk+h zZfV5>ck*(RjpNW*<R~;OQ~JI?hco5NY)3IpMKw7gP&ODA0z>HKTgd#P`V^u;;`M`` zR?R*1c|1|+V_-CQNJ9c!Hn-Y-^vqu&;%<%&Iw&=oWs|yBsv^SZdDcrIs&~_;3iD=( zd+UCn7vf-h4GUW6IkQ5OF^-LTmnU8uIp?jl&u~}!BGafMOLGL<|Hal@g~buIYobl# z?%KEn_uviz5?q1>cXxLPmf#xP0>Rzg-JQnW-5Q6(zvs+(X7<^)byXKtYkl9VeBxp? zh%KW}RTfuBF)I~OItxSP1c5%^6ovBcs_Jy=KRdJK*ga<)VBWz~2|kB10~=l91SkoJ zeMr@^2M&~%7dmVi;c2?SP@5@TFW-JG^61<UR^(~IzNqQkB5Xp}kO$vNo5wV&5Cz>G zFF29FbYXX?fJ{FRX6~?*-vt;r2=y*|Z;GBj7@t;?e)KSYe@v^5-V~3=*geu$c?;%i zjSfgDV+U9`AmYr7C698LXsXE(4Bj7CT<I$Av?h+HHY#052T%ksrf47G6KqfQ$Flab zOJ8UDqCd`@PlZWak6{9o)Z<Be{03iedxW779S^>}yW)?^N;Xeia|so`|8;{tw`9dn z(eA_QAq4=W1<9YoXL`HXevU~9{TlqCt49ud{+Lm~?d)3==p%vf7}5~-4F8O%8O|40 zkL}PmYxKFdp9w|95LNtXofg;*yJXG~^E9nkwK0b^<$U(UJTVrk-P^bUV%QuX$Z!qf z0y?-(?ZwiX0=x|Mp{pX5WK3(_00gN*?t$%}LR0UIuIRNxpD{gxJj8^zu&3}Aw?u3y zc}3;C1y{$pu*riv%*kSFd5p62-f6za{Bb%M1b5Z5iK3yG7#mW|QIN9EQBmucZs46x zgP&azths=`vf0?l?FcujYy9;jx97&+?{tdWxhW#q-{bcuLo@2VBTl%>{45vkqLx<c z1&9<)q(3?WcwnvhYs{iqbDIR}^#g}l%hn=kA<-Z8*tZ>FM-d$|v_VSp$I;$3D*t32 ze1aK`fZn-u7el5bw!-0_Vx5FjjCyEbhN>S~ZCqat<JeSwW(Y~VYJC!AW_8ZdXo@k@ zGZ{DB5ChT0JjNbW**pqs+=RBSqNL*NaF&F*unNcnmae$u5OZT9;%u?F;<_}HfFYCr z^t+{K<z@bBFX+<H2M*u9&0p-~hy1to;A5SzKqU735ja`=NB~zs?9=i3(s=)1=*kF1 z;(?7z^(hnqtxAIT@(4-<ymv_yBr>o&$4kKiKU6hVrq!xYMyE|;5>!o1yc*^qz0FA= z$~GcJK};pR!OP3S+~VV>ftl=2ahezx)B7-jJE~<2g@oXVHgYF41d|7ZV~)HjE<?$x zqVso(STKAP=20>V-jz2LFQ{=0{5c&Y@gQ%cYe9`6jnG7bFtF~x`t}<$%&+k5ZNT1* zgl%GKkbtaYq#V}{pX1Kn1Yw};>(E=NFg(Uj3M^xIgEVil2luwaRco4Vgi|S5LUO2< ze7KS5F6v^%@Ou(ygi~(7XF(WbaW`%P*&w|ESExk|K=DWsb3`AE%l!uF*dm#Um>b)- zX)=O3jY>V*f{=YTQK@)W4zQsQ?Q18gC#AG|O#}q}iD1WR?Z>>$UfLZI=SfmWNOHYC zIcg*muH$6BaN(qi>rXicsxO_PZhbebhy1tp#(|GAqrBf`eAzvZ<=`!2$)4`wGy@N} zDx8#6^*1?zu7HmqkW|L0B)Tsxv9B}-&^&0S`HKKS0{ufc{vWGP`z8dPN^ytmIn@R^ zks`vxi?@z2;>CFB%-8!mf4_X=33$x-DfwBzW@_bS4%vXLtD9~&S=FSjd}oK!uFkBZ zI|uDDFaDN5L&bgLCMRZ`4Je`I)6*pW&ZcN?T7EA*M;~C_;$n9ZP>CKIRWB*4;kChS zsWVAfQY10;+aoLNg#XY^q}spR0!9J}Fp}_eI|j8K^2n9g?0KV}osfp8gS!d?w2(oa z0~J(iIq$cEaskm_qck?}SM3<te!Nhy5T**Ga+aF5;vt<y4kG(vbmDgoY(D>9%`4Yz z9_bDOv>7Zee|gqQfZ<<iqGx?ZKbnRT%?SAA(7$)D($||Nx<Sdk`+ZKdRdWLj2Ot#- zQ<1P>WQnCT&|=96Xqt->JYJ~Cg^W9JqoDLr=nlnP1SA}f>`i5aFkV+}2J?nJA;uP% zja%7a#2n!E_47t8K$pX?>*mD78M?AVPs0(s1AzGrfr3y{+Y_|by=K`|JA3)9Xr6OZ zFK8HOpR#|enrSxLWy0RZwX%*62IM(B&y|{gRI%QB=oZMOQ?YIQCN)34)e^2;m?5yt zLXAg0sYyP1eM@zzlj-0OYe=4Z!G-!nIgqTR@q}*n*DQ@nDx%u@Ne<xoxH6Fei;yGM zp2qF{=F}V$4$z?>yCrk$kpW_0iZ}aZ3S}9t@5DFtPpeK|I=^8@9blp142GO`_<Hvz zHiGwAewZ0k7g{;FhcPy=Wbz|4fx*`JPc2;~W}|;I3CLqk7Q~o>8Hr)qEQV#=o3$jI z<#d~E1=K&Bk98Jl($Tx1kuIURUCUaV^)}cEss5I(jGipGf(j%f?1%wpxoPAw&07pz z7z}Cs`7*tJF~z+^4PhRiV`+%!n7$g99o}#~lL1F9k|f=~O}ZsYrvSvAc&@x$fZ~yO zEW8~yR2M*Vsfeq&c)zx%2QJERdDuRgt+C~20kz4hlCXEW%L%@>?noAkdWHy#f7iij zBGU_FncgXnA=J-6ltqtJ;8Swa_#Eul*UWnnr^c+KZRq2bB4K#qR`oJF?cH^Z`|yyE z9Ku$&vpGHA!uy@C%{oElpItA+bQVlSt>){=_S|7kJ(>dL#s3F%<bRL6{}+DJ!G!fN z0tmq1#d)o&x550Cn~)-tF`{?h+wFOX(?vvp!YhYnfP|Ji3%mYOu3cDA{-a$=Doodo zTppiwR)_~JMD<NBj$=(DsqGv#e-g^8uUu)wz7p+{-62+(Ae|F8NGw{y7mUPKK`irY zJ!S3Unpw9d@fuY$@V5Edj7OA0hmCy0;}_cY4ajQ8@u%x7`c<uIz!lI1S{F$cgF@o| znwlfApo_vlbz9y6rI-M*a8fVUHs>#f6&`Nri)RqYBUITCOb%r~1uSk@^fjDI{$#W3 z&^V7TeQSS3mGmYI3V$2>IB2R^3jLbgU(?XQu1k|>8JL2U%z$c&(JwS~%;iL%*SMc2 z=yW3H<sYFPz#m!EgegJB7C<Qh+@$>3NE4-(017SH4rLnv@z`1DeuflIrX5t+ImAhj znGI{!DUf67@Yms=XgC}Ua7MOA;s(H~-7WA?$j>{Kd@oj^S+u{6yuxC~&rkMM_?v;8 z|EIi&@7{^^r`z5-AC|_FoB`p9nD%vJm?yRr6WH!2CVN5#Ln7k^Kh6_PolzLd<xtuq zzQO1m;Z2QJCmpK>OC;kHG&jSp+|rSF%=zGQelZZ$qRbB07@i5W3Y)EwERyseV_uFo z0K>5wA@*-*<WRl!{0ISwuA$)f#1{jDAsmDDVj2m-P>bbgC_&pHT#XT9%M_8(jWBx5 z8=tj`j=<l)`C8kaCMD9)3KR)DgFW6=HWoL$CWUdxt+OKw(hba&hy&>U%_kECQ(fAG zdeL(%8TmvVoWPpC=koXc4!@TgATw`+3uw}IV)}Q57KFJYtO^kQ$=E<5;QmFq#<c6n zC6VA5aM;aX;{qG$`gnq|02A=tJO6|ag~M{&tVBZWo*omCBm00=D2t;r!_fHe1>3DX z9`@q3T2t?|4+!!5Z;5l|&hD;|(d;g|WNc<VIf&~NvQ9z+{^$%&b6YyUaYb!+>ZMNY z{)9%RtcAY1r11@%Ik>2xeXtEy)@i{{ClGjQv7R4TZ#_HW99?VnMN;xcBaOjiW5m{7 zM>tYs8EMLSyd|o^V(IwywNR>t7V5NGyGtnm?`o4nY2fiB3B;%u^mG4t73aORbjm*9 z^Lg8AI%MpoQlKe{drY@#4k}%Zak4R&Xpv;4u|{?m7%OC4z$I80TrEbdNoxNzkOX;= zwO<}vy79G3>$GSd2e%HDSahNhMDQl-cr;9|UHRbuN;;h$%yuWIj$}Q>PL(xi$d4)M z1{5}Tkhi1UeS3xZ5_Yl@@3c1JXL?nmCak{0l$dWQIE%O731L0iD+uR6m;Pl^`P$-w zvUbbG3TRVBLU5+6m@a}J`y#niNi}%}G=pZTU;?<+>Hn^5@I(e4`ih>$7SH0|ka6T? zu}LuNr)H(1c|uJY`T^Nsf=mpdc#?-QU;7!LCJpIiGqs2D3BQX9KjmM9bFg|YEg|*% zXc5p}DDB&YA?M1Zj>WZOusjhS2IAGj0KRLoewxJofNkkYU{Z|1*}<OeMMv=-|G&}f zzdhLgy2%I&09s(Q*N=3|tllPQP!mwFt2=dN>|{~h)d>g;7Xn#KhLi9fjR^WZa6)vj z71vjL8;g97`_kKCzkgVm%d(qp|5gyc^|l0pLgb*jaO|6naQ5V1B@h#T8^S>&);+SZ z8c<K-6oI6!kc@B<Lw{rN#2Xkop;bGJ7&0SV4;Y9IO|{$cio^evXj-i?i0dBeN#Cei z$naKw9}=aY`eG$Iu;o8a#HB(;)^Ndso}{)4KtM7;JF}T>3F&gQ<uD7ZxQ>~sk>q^; za_?9Sq$`P9?XS0A<d<#~6hB3GGB`bp%Z1g@Kg4+gMBw^%`HB}vD4rXavD%T77^7Bc zpZt-xxgAth8<2v3+uXJv8%$W8T5K}ZZI8;jkMa}^prIkV#kl_t)0gqhydi=Rx>3>8 zB$$bjN*SR}2<i5F6PjYJ2yR$)oTcALECWq~#Jd;U-sTeu04B7tOD17<H<7{60p@Fi z^!fERlqb7%m)X3W)SE2a-K8gGrf@KOzYeN3GDRP9_RgR`WzeY^&q5NT#*d0Gf50yx zvSmpGG){{_9;j#+^(U=3{UTfnNJtgtRssQ>k$=l1j(~UTbODG`mR+2l2a}qU{VY3= z247rv#6Q7COGoRflC8dX=|Kl&grPuF3}y3*O<ef%j*)s^t63`*w%j`&K$!a#rj<@9 z?qCRtN*tHuUTde$eGeVUB80Og|Ls1e=W2Owo5-Zos+=O<VC0Z4Ij^0e2lUC2=e!zK zt<Vte0)}c#0R$iNbETu1;&Rtx@B{?G;}04F*6ns;LLW6Yc);k6FL9Lk(S*nc)+8ED zMSsCtl)vc^hAE>MwGLX>D);J(C@nHlA2S8T7HMfB81dfvRiB1O(lmdvjEwF1v-R>^ zZ2*0dZD|3w<F%YSF5DrC8yXP6n=&v}eoM3ewR;DD5B;@}@Qbm17|CK@ZS6`mX}>Gq zF80&KZb$oGNtIbs=6&riH9DiZHc$MAv&#bllP=Bnn`nFQY<bL+i5^MW3`E%dB9i0I zX(NGNwRu+!U7Nf9bqW7MAlJ4U`r}{p#x<96&VTah!YfO;3udPDmE}MUn-3z@edGSu z+T)u2LxvdX=-$9xN7&oR32LOQJW;jVB7UAJG!(NVnO5)4n^t7#4(+%~_-z_irQ%E4 zRZMg-Vh03W@QivA`~Kf!jS8{L&n{Ug+}-VQ3CDf#=QXLUNcs&<YsGF-m`pkN40L`( z0-7qZfqOFLkn8t<=$frZv;<W@OE*vVcV)W>U~rP`&lWDoR!@~<CP-F(2s95HlO-yu zkHq=rPr`<8d?@XPG?Y%^UI9~WI>R+a(*gtC+^1_nZ+(Bg9s|yn4)UObJ$UjLe;(R> zYflVdff5%!>f0gqz=O12aWqY=A(PR#hhrvKT76(7SyCiuG_BOO{~3Dp9T0=tuiHFt z%H`7+xDB_zoUE5?Pmn$#>%HcC{pXM&7DKE$SgJObUiO`gWBBt*%o_Z?$l);Zk90}& zw~qgI4E?W}iMR!(Lj^$I*BwLnK4ucIDB*Ydkn8ct;bdDkyzzIhe9@unoY3TbtIO;t zT#dsj6)eVZ05Bo8$oIy<2g`3CvG<I8-<-Q57#khs)fG+JmL&Zstijf_{Ad{3J15z` z%ZoKA>-9yIvIMY7=FTc=cY})suJ>&9(3UjHwP<_ggM4aGO)K>~yHQC^Wi&<&^${P* zPNDdGRe$7At#5`5kSz+_>hk(fy^|yBxM5~rP&nvnoeKeIwki;+1}qC9s4>W|E)H50 zp)=x~!#EV54&;<oE_!)?R>LH-G_4Uh$Yjsa!TJ@7STB@WX*mT2P>}V0Gnimt%O!<t z{sSN=@G-E|qU9z<@yJEr_PjLXyN&?4Y)?iwt>rr!TT|wspHmD(W}6%gKk#lP6m$5T z)$6ULA3$-(>2ozF&{O$BRpDvI{OwND2M=LDulW(?P!`|>j^h9Z*a{8CB2a8RXW{OE zn$?a}6<-*9vStGpuaw@q76QA`?-{FPBq`iigJ1aioboyW_^oc{(BE!j-zwDq)x^l_ z1Z|$5?IuK{4~O6Wj%0tkGJEU$HfyumXDO`U2&$JKkk>>MesE}l4o!hpab-F*ren$s zWEW&ypj|u5%+M#L$YwAKhMEcz_=D=?snV)G?sG@Q($cAEX9mdWTQl?&t`5ZPa-n#i zTKIKll~?N-VlMd@oEpO3VtRts3|!s*rm}~7{X0f^Uojv9P-*qOoQ`dHn)~6ebJ--K zkc7*T7Yp5DcfnXQpW=<)E(xD!HpywD3dhU#{&iQNZ-WWFUF8%7lu42y9cvw~1IXHq zD{9(<9KB1EVA`>@S5Py<0qnwDIHh!x0SeLU@`J%J2olAY2YrBOVAyv0&()MT3!wm; zGFpePrTeJ1fvaETaW|n!ayL#EOV7x^kM!JGr2mn(y?vnPHa{0Pe_W;)#T^siI~6Ih zK1}{QSDC|0Gw)9D-pH$}i4BG7g^MFJS-U+%r`SVv{qNybZ_X+>1M2=VyQ{;p3{dxR zK=<6Me4H0`*k0~YS)2#``}sX1#oC2`p4$IpE_7DjGde$nNl1q$Ig|&vnvZ2rEn2&h zU~pQFpqPt7fAz9ShPd_r!_QyK2By)=vChs%G&i*nyr&@7^c_2kU)b>(w7Xo*t|4E` z+%v5r8~4zr;b_6G!2yDaq2O!Xxb2sDsV5&%9C>WOhfc*Ti#GEm>f@ezQ?OS<tyA^d zT|-IBwa|Y)FsgJYW&vYAP~yC=Ci%%|J?m+>Br0qa*;BMHjZ;t5C%~O?s|%CW0x4_b zJC}a`H^RP&4%{ltPWjlY--GUo*v~_2Bh#?Bn4JpD?6+L^&MSY27$37fD1@$LWgwKx zA#0c~At-i^??3D_6=mR0h>Y}KQ3!rp(eTpuM}Un87A%eDr~iqdz7$Ck?M{S!pDiJ2 z?(vMMH;wpYhmj%V9tQ=aFgV;C#2*;P*dK+3vahpG0->zpe2>i~>_Qhw<E1`GkZ=Wj zCTM2+)VBot(d4)n0F~vN1@$K(jjN<dHi)qH;4zTLb==l?molt{WlDR!DUF^HpSk?U zXMtU-g}A^%nLQ+y<YKRg48UgC`_SSZm8S{fORZE6R+l*O7*A|Bz2Bwp6t1#>cB7qL z62qT_lZp@^lH6U{VbGLca>()ZfPlnm=9jj~-_Rgs+~%X{f6(TCnDvi5mE5y#$a=A% zqyp!y7g`*dIHVrWSo_G15udR?n5wFq{K>#}8eMINm3k>S@&Fb=+C)Z;iBx~Um0UWX z2H=mppGa1g6GEF%bZc9=6IZXM=mbpUZ(N2%*UQP5$A}lw$)k&}w100u;vR3kNXI-7 zO}m}uWGZspPFJb!l{jtwtOjl|01berP)&S!=Y54XDB8Gv*L@xn@s3efqK{2tqviV4 z5yK<spJ2L7lVHs#FyJAHBS{R$%fz>EDZc`A=op=7s`an+OFD`+?}d7jH_^|i=04yw zJLzKtln;&?cwsDxQy0T42JcYHZnHaRG{JDdfg-=_i93wKM#Lm)y=WWD7&rcw;@Epb z&T0o_5W^2*af~?_!pd2g+RD@2n98&6|2kc2j=!fnFrbiOM<o?a)v`FsTJt`2aP^*R zd&MigoyM_JZ+Uc{w}9l*;xSy4VPv7I;|KcO0hnde1927Yz};Y^Lh}b?4k0%h!z`0s zZ$6KxmD=`?xRO@#o_&~{imxBX4#HqRxJ}oVw>3(*aLl}cCF$Nl-UN74pv4b*ca>Y~ z12o%teBI`=yKBd+_JSF1O=mPSAMeoqm!MTdwSVsN>2vodsm}Yd{tZue=1Vm(0~Uz- z@COsx)I6M~ZHi9rz@IlVi|IVJbOuV2?)LQx*7#6eplkH^W_VfY6zS%7NyMsiz+qqg zdJS%=Z<LhO(Q=jE=2HDhO`iw#KrLlMcWUrw{LeFj5oK=Y%f_4sW3|Ihv+x%2e8Kg< z9x-*hbu|&2b+q%Z*u+k56`-IU*}=;EUl3m1d3U8-9hs%xeK|ZsD;IZ11wVdcA*Aku ztooBVw`PU#Gx*o7_d|5oFQmB@->J%S!+y}1h^D6s{M4o&_;PrU?d94C>U0dT#Yt(2 zU%0x{0=3%=I5rH;s0aEGBA+6HX+u0&>T;zUS%lr~SKHQf=~%Eeg_?fqHrRxmNT60r zWx5U&cPL2v-ld)}!q%v((t;ntvBk3&%9O{~Zj+c*Rh*aNGnjfZ!ch=>Y6i6{U&VI0 z8ECC?@y}V*W@8(L1Vol6?{hZltrqHzfxotqY_1biv&?@<w6Td)>j6s!Q7N8NLYKy} zD6-{}3|HCTG+WJ)Z9Y=;?d%367cS#=U<FOjCNdj~B(STSp~444@G6$JYY<-v&!JAu z&kaO|YJUP<?P<u#oq^V`Dt7`DbppF2*ILX0IImq<(Y&5Oj&X(2*I4epV#ZI|Ex>G5 zMTnDOTbRdI!b74MsK*1rlX%430=ho*>Q`60hd`6mr>#zDnYaJwYc7-GMC%xZ+Md%Z zBOT&Hsj(i2WXZ=+vkMX8+XoKl&+^Ou2Q29wgy_>zl=v<Wx=BKEmKJGm?{vK3=22+7 z-(rKmbReHVr_dC9=p(qkq?-KkPiC*&ZTy(e9zLx12N=M{YY%Sf--s?CkDT4@ZN43v zCR_1ohtgLAK(BYawgJOdn)FNl@nhqapphLiTLa<Ji=vbl{n<?NKT>i{T^L!RWofLZ z+kOvHO>~D=47#`_D-+;uka36)*aQ}RXBmUu1rd@8*PH8mtf>!KpePlVi-Ou<Nld(} zOcSD=6!@!?ZP#07qtvJd<*JUnYKeR0E#A4CHwpQ?+H_`^Ml2%jRtoA-{s5JSH?JOM zSq}iDLqYEZZ0yuR_uC-1S6h)rf8p!I#ycewce*o$WIWvf$$aHruZgyrZzuxxZLhf? z?ZYq+Z8pH$-o<;(#p<26_x4fps)s~Y{@~vDll+Q{eHd!;6<M!>pwOd1?BiqtEBH+0 zseSD^M%uO<rHBH6U?2zh?EM@Rvx<vwEukK#fPnGIEJyj6@uwZWKrDKw!1^itVednJ z7HbEjB8dJ6w>|Z}Y1}jCF$i5Z=4h8mx9Qn?Yp-#YO^?G{_}8&U4{AVV8zid{J3yP~ zhz|-HZJ>#P=l}pKl3-{)21cv^B?e_6kd69|Jp5LLl`7g5CF*>nc~VvA$|POm=l3vp zIQ+)#(??J#bS5DsR`3z-F{8P(Z{Ji1nj9j6-Wi$Kg7nDR^YLQplKaNuOKrlx-vzJT zzUs^3>qDA(SxO8Uyszt;<Gtyl?y~+v5(>C)0vOePbhXRu*$h>&+kK_(G;pC3;tvOv zSaO;@uPV0B&a>++Y_$kC$ifE>LPn;vr-dIZB2lW5otBAr;W@iGCp))Xdti|(CIOXf z$yf|Ma-Wu_KLL1G`o8z3Vei5zVX8-Qa9H5;%q6oECNq3=dlZhxQFxS@$1QhGT6K6I zzGpSSzr99|YgY~JY?@(&Qt_CD2SLR$Q<P|Y7ZFv=8}Owhw?%a~+`){#%%18DP+6(7 zGSf2J;3vn|uWY~Sn8cln;Wdm@crgi&%4Cz5vm6rSn6l!&{s9a=rPU3xL?Yi9V&4%$ zH*XtV(7lGfba<C|uO@prRfKHN>etMd=6PP;%+&t;g2cFRHRy_4R9m<3>Is?fmJsr? z0<rnM?<=B%@BN>oy&vb@S8a(fk*%TQjVgPIbQDoU4q+oTKs>fiu_m=PX4qNSCCC9# zsu*4wG)jmZVI<LfHB~i&K}Iiz{<8<c=fJ<GHN~6<OW-SPwNL^I;}h~bV2aOu`+E)9 z`*tN{uC|gN13>bq4=+0WJ*e5B6hI6EkqgVS13dWM6vCgSf&9%T+b&Bgbt4gPQ{Q1m z?k-ATd^1)=u#997CIQx~@0UAnJ7=AB{vwdbd;1~INWOg&QA3x3X(wDFahh@0I#wW` z<nuvMWwa9p=(&d7n6~9S5wA&>FgQQNFZ8^Oesi3iMElw6_Egq>#U>CM@rp0$0=u95 zq5R@)<n6XG3^n#zubo|26X8`w${NeIfF!*(b)LXp5Z&=3&WVnj5(4{N&mB3l%(gKb z%sYgX+HrZE-tb|eKT938o?M-|ClOnKoiEG?5D;pWvcCUSonV{NRSR?dFY=>2RxxFF zlYA}m&K~A->8A$j6n}s;i&o3X`l|u2?!IT=GtTCR_4wZXd0p|%gthJZ&%$autlD@s zmz9z}zf!-IdZkU?fC2|NyGTO^p5FMlE){Yn;Ai@N(RgoF`QVtvACKuIX>LFOQ-!M- zlkwyDUj8G;#-?&VHPwsVsHbmO&#%b;!KD0Ysq*c3PcUzT{z@pAmUl=bPIfZ>E&b;c zrZ`!!U;bJtO)ou=4wh|B3@@2l_W#sFc6<PBPb?7GnVkHz-!RbuFyMrnY|isT9wQE? z54Jpk=|521|HlASroe>T)4aqZ2S8hAR`QSgFjfO>;|;C06PNgX{G?qjh5BDq)R|w# z2vOI4%!>lp_iW~uQQa1feD`YGLmGt%==t5P>^aSb4RT(DUo7fY3lkjxsPN5gsV@uO zy{=QOi>UfGN)h;I<C}dHPVWiN;9D)^w)Q6bu6npJQGz|TeTN~`l%U2!9-C#Wjh45X zZ8i43Xtktq4`@O}HjWOK$0X%i_Mdu=N6j1<8dtp^N%D{;Ow*3YqBdm|Xwi37h1=Dl z`z?fzX}A7EaAr~2!8I2JdiOi!JDJamcq*(W>zGV!oRW&nIvi1wwNH@_yHH+Y!@7DU zAUt*SW&d^xYrSYzOu`B-rp+ejQ@>(3$NIXJFg$C@lx<3)%~eBhG}!zybE8t?@3Bm! zsw~qX`5Z15<S_D$7Ce|O=bW?hF={nC{wrOE&qHVt)n51XPa$yN)_z@9%On8`AwroI z?X<erG<(VV9bR790Z!Ix(}M<LaRbm--6J#E=7|<7Y5wGl8?6qPJ8M^Gv#tMO(xteZ zl=6OR);Mdch3Cx)ylxy~gY+<7{KB*f64iDpO?uUiCJw);MY|*otmd=pG0|>!Yo~4; zk5Y;P&AF1}h!6$o{Oq_Bu1LS#G7h>k3R(Rsbay&>&VXvhAgZ@=YsNoN)(*6oT30w* z;mwoPvA626qv+*2zt8e|llSj!wcL?nIiZnFUcsJhx7-^YL5&I!XN%dD87$4Xp`Crr zKnT&rp$MY<@>}NWm-4Ao8VEka=kIGLdqTNdtrz4xc3L>u<$P{pkPT-BaQyZ>X6=Nl z!f<f*q_jqUveW;G-DhqP4Jk#~x<cq~mC;SS(yjt|jBJ-ve9}=KoTI=MNS8dciP(w- zx1DEOF>oGhxRWv770qA>ttiqTQS^z2QbWfnTIjN}Fh54X_ONQ2C<cF*;2XVviYW8F z@NJ?k9>V6r3EUEH5bI^#p=O*Z7EvOE)0w4-kI+TI-}`*eofzk-Aix7Y|9QSt!<lU> znxqv*F3r?=pZSun#B#^WO(*8pH`+tSE`_c%kjaZ)hf}@K+g!v#<%J^)egG{Q8i{QJ z%wd^+W5H@YEI@WSe82S@VKN&3sNZ84{H}OqLpx+4Oqhqwja{W@GmsRz0OnM^Q9&Mx zfs#iP6_(9rwWwmhXNlW)KnGOp3X4H{gPc=PR>m|AGPc?3F@?*6uh<o?3|ODK&lG5= z9YFo;{*ihh<QLC1<ulcxYwdnA+#WJhySPD0c{yUf1o(HV_2EEF)&38ST?RTle3lsS z5V<>ai*#xHN%qAS@0Zi|uI2eaSoK7kx;orV8%1sOZdCHyN^ZUs+UpafA*OFit=Y(u zEG!Yo%Y0nwn|9K$)Vj<{9yYT)TZR{#0Kw(jM2iC;E2$pAbg6Jt9NMDQDneTN{PN{T zKXLnv(Q>?v_UG(N?%Ro{u)d5^yor5?m|TPk@_chVPiiO8z>M~2jt!;8{O%Y<6+dS; zdjkerswG{8pAIK&3O}xCyML%*Gnkf~Ob?&zG61~fg`Pjcpi<QnWO??J`0K54Gk77N zb?c!lE>>Cxy+~JN$lK{B_!p{uwawp+?E%jC-a4WT$jRl74xTUp6S}g-lDj&<9}G0_ z&GMjm$AvNqvM7udS>(WDMl1RCvqyy#Udf0TC~eAx8stfl-c<bIoS+4;BX)rW%Z6cP z=Urgt`a8A0c4}eKtY*~KN5GL4Dnk-sY(ho#2xv{5_IOCh;=>;R7J)Id(X1>GqVHN< zf>xX+z&H5uoUPmHPRQb-@9$mYYPA9`7}v9bR-A3Zh^?Rt<XCmZi;PcV;FTrXR0I4@ zVpMZ7`?AfJOj^lx8KSW<@AF+s^f>wSc$9^0;q$)Uexc)X#6()H(sf+L`TLv#+0<gG zQlevzEc$76SWK!3bNWK<eQ0#`Ov|FAF>0ofa60P(&%!y!KgufQHs4&7loa9V3mP}m zQ+yFzaC6=hq60Mxy*qt&GECFH=N^)2Urw#?<ddv>{>o(10s+WpS_?Ah{Wf_Y!`kuG z04Z^*2N&fYYb~D)f?qlZ_3PZ2LCYLx(;m?*FnDCg+8U8YZ4TAC*7Tj8UMKDdXT3BO z&-g%AcsUi&*XNX7loO0+ZNKNM6&Sbt#&wcy$C!A=1K(!|>9r2dE<7Oq5hj38&N-n_ zF4<>fsNc@j9Z@EC==1}kww91qY>2i^15f&S)N)zR4Bc_<?j*_n*EZtt70ck<bW-ec z<25a_X^_|0kIw4SCsE<Ib9}7yL$)(#^Z&Zfx-eq_Hv~5r&;8UsLeyQJgt<*8^T}HL zhrCek>%|lkKhmC<9{nz{MEAG+ODY^i%+db|VNWLfUuFUyN19lF_`Cjc>n*O?4(Ly4 zXjANvd}KrWo|Vl-J=eIk`%Qn?)g{`UU0%X-vmX+KuuI=>LPg-WKz&{_|31S0ITC0= znGS3&Ix)tk0V$j0A1yFehnH_8xP&A`wh3EBT6s?k724+7lsV&nn2q{=K~c`kGyBCb zf9E4adt}EKMZG%MBI-pw7aSQvz~a{Psi7B;8jwNRMi;rxu(&AYPghoDm-&v}+HF=% zwgn8XD_yXyv)AGJdL<BS6LI^EZ)kaRf;&5mKZ8E+1&#!a?pQT!4k`40vpxI4vuNl? zpTy{n!S7P2+j>t@b+P7@x|$?uBbjSp0^5pZuZUll*@v+AT0V(kA#m69VaZK`aC$?M z(98778H}<BD|o7?+&{f|6fy2hZbrb3pn|7}mpn<AV6Q)2^#{Q%dj)EJ*a|9mLJvkC z*k$Fg<aOcqhg0O=_VS&P|CBYX*nfcN2~RBE$w9|T>Qb9|CSOsV5M7xjXy@s5Tk<3I zP1P!vhcC$XGFd(Rzt|o9jK)IuG;nBvgh!lKq6>a<7%=zp_6}~fv|=DxW6m2KYmO+F znh#&k()GSyvE|V{wwt1Z&Kz`|HBHVizZbkLYPBWew2KEwa+)Yrp3EDz<vgkZXl>T* z+*h5-S6k<%Nh-?*G{3d#9KE}}Q#mnL_llADw;bqKV7K-GszjO8p6}FspWVt=!6Dj0 zI?;Qig(?X>&`t#%Y^3w0+M|D%lA}xg4H7NZN+btR4ES31!;wurJXfPSuxaHRi-9Vi z?H7g)f|laZ?Zg{w)>z2Jv_aHs;_QJ4!Oq(ix&kZJM*4*OPCq~R`7d%v_P-HnjOu?d zy5(VeyZxaksenc$SSjWYR7O}dI=mGNu}R9gAjBq+QmuzECJ3$iiT2weDOBL|^`?>_ zDIiFP^MTlVcUWUJ_92qMM=I*IPmIJGrol+=^9%?gL>++$6bI}h*^p6W%Wwqix#QOO ziHEL|aQ`@xj!4RJl?}Xs!Aos5D2DzA&^yC2p3B^L4c#w8aDnH<$mxGIa$IV24O??O zsaMB^{5qYw11q>?1X#&_)*JK@lr;G1wr~diRs5SS59agXYDF=p^461M<`XOxn=$oS z3KAjy<!`3Z;a>;W3b-CjB(J^$mb4L=X62~Z50`ZFR~IvlW=^ufxjuJkOy(d%1$Z*& z`OTX(46+4cVMA%YZ>O&4B2R5xampn3GE|@O7?E5;S2~1<TJf_*x|Ztp$Fxs(Skyzr zS>qPDlC!O2gkICQER{yHJg=CW_lrv&n@gCr8f3<(R@MORs%2;g$X#LSUo^F+v;f@p zojfB4chYaqe?gTXp0X3Tg}t;J_o9pc$f`WsGbSU7y_CPd4yu`YmZSEu$`}Ze3q)2X z>$)_UyakJ5<DOZvGk;9|iX7#3ConG(Z%qWp;D&#<TdLK~%;Sw_ix`?GPu47M>IsS> zA?3!AQKURta`Jbuc;KB=VpG{<htSG+Afk@fG+(?v7pq95`$EGI0x^5p7h8mIY+p*y z_JdB&i3jhGrvX7_ndbyKep#&m93Pa@*DECr>+Z&i*1iv4oa)R97LWn`=2h{=%xD|4 zb=oIt%Sw&mfr}h=IUu4pC+w<iMmNk?Ap%c6>TNRK21-&L*CY59*Ek9iN7fSH{nbnb zf++}{pTIKpX`6UT6R}1Pq<ALjmhG43O@O;y`$_WkKKS@D6<Q!PCXG(0$a)2qPP575 z-#~l-nUk)%<jsgAu&-JJrYovL(%Bl~$EdrtbPovfCbL|dSn-CXo}qFN8(AISGE?Z3 z=F35*g`A&ns$Bb@(pO_44S94g6<RQ5ojW63BiqVrU`+xV5)-lp?~?!+EQ@+qG55k& z%;|I0$$Gx}-oeTX;wNO*i`z7eu<@023u9+)5KG@O??sj@--4PZMO~};GK!p$Z;-`j zGHj2czxxS|Brmh#=Udzs`t=UONKnQj*1Bt!udpVk)32J7$#ti&MAn^1o7jzNJ0hvY zui~out$&!bkC?vJbGh%JA?q5Tz#`e7$dr670J&G7~>X;l2MW<|yr5Pl>h!k6dD zDn+)a*AY#)GlC7qwSDWEcRMHag`GRfQXP~#n`EXs7Vu+~%e-nk*-MygXVG0TepNg! zem!VLtH^7IRyaH1@O%!6%gPXPe&!x8kAxhunQnVkCoZ?hGda1h`nbl4>5I`W*Uc>Z zE_ni{+sf)&E1;F7t<L}e^vg6M9cZXHFSiRycOTEi^PKP|sMf9Hh|gid#cyQ>m2Fpn z`(4$-6Ivf@x;CYO9j>_&4A|=*pdk|U6c*41UQA9x3w6XihL63j5i?)rWbG^!>NAJ@ z>Jn}`G4j)6RvJ?|+ap2(w>S(l2sA6Af2e#Rve3!{S^oESx}US7Vl!m<H(#mF`j0Kf z9|yRS5j+;g?wtUm6)mSe<Nk_Xox+b}C(C4uw@%zA?nK@M_Cc%sjdp8eEX|i0z`;a( z;^!T2*Y~pmd_*7k(npP`f0;=z`8F(gfBR)M_yqP|(M1eF|DJht94j)N7c8@opU}up zcGoj~vN<GK$pHYF|B|+aDFO}Gf4}2x-|HX<(&BIrhWTPvY|n-$DYTdmxBtJaZ8%Iy zw#V;id|uv-E!gOcn@)*g-fzz#$$-u<i3k1weN9=dO0BemUt-=nQaT(L3tC?-t*6EH z(5>cCw!aFaC&2t1yTj(EC7xQc0h2l6QIO7Nm_NIaYJ#)qX`P(n{!eF#&pFnRztLN> z#?~e7Ln=3oGk!%Ctn4E1ytiR`>^=v=y5or}1kx&D8*FjVc&2Ghz`zIDnrcZzD~8YH z6otR>&Bziaz6~aV#%LCUA8kW?J{`SiJt0KlS-FK+3X#y=*o2|QZM-_vmE%NAEkPr@ zgD|emoVi?jh*#Q90#LfWYwV@rRVdK1mDXaiK5zUuDqq)0rfCjSFN6eD7u2-BJUut? zTPJ{N@P>!zjekdmdBb)TtJPMo{o{%HFox)Dd*b`}Cax1~n3EMpXKM4f^;-T?Tys=) zUg|$MmOtj7=z-2L?%5^mu<T=NmNq40742(=enw82UcH#r&);*dM0r>A;azL_TylQ? zNqqfE@yR<cC89`Tk0G$1mPg97J!x#qmzJ=ga6BcCCnLGZ5V&Xo$Zc^y+hxM7Y<o29 zK(#JHhU?Yt^i9$!ic%4Yc5*->Cr3jX9bv1LhijT}qHrvar0k~oZUHS?GhCazG$>nR z^0^tzh?ljuP;<$+?x5G?Qr^z**pca_!aC2z@hSiK9?G_DP+r$yl>4kEVj?0E5vwQ? zjG2ddiYxLy%?t@m5%L)AOms2-z=99?y*@Hp%mj`e?A#UzX^|ghs0)pVKPlOF$%{Np z@SNHnJ;!41z=D^~2XrapNqs*;9NSR{Ur}=q#D?2Cba)c0Uq4#KYBe@qx<Ziw%6iuz z`b&6G^mPjn?SXo+gRCv`T<Ng!*oX)-KjL)#li~6lj8~PT)#~<6_D*@buC&oju>2;5 zcuOzl@?wpr>hqiJ;%LBa9BP8{!(pD=uUE#=ldkTOH)zvS!TPgAzrj{zkz3O#-1VBy zkAIlMLA@q<oq$1u@SjN)H{r9J0Kp{|;f(vy(=h%<?IR-(IEv?sRCN)Jkup|}>EWRB zss+&+<Nk(?;l+%m1Umnryr&5WsM3ANzq_+EF@YIa+cUeW2!{Jm+8W*@SK!HF+jmM& zTCmoD=<ooVs0KAl6tDVK9;x!_d>d=YYz-9&6+06<CE0>D<tNfCw@%J6E`QZV_aQ+S z>p9KNO(#DM%$#DlbpwhKnyReMxKCzVOZUT6%c68LVYFiKHm^0%+YCsE7OR{mPft+b zcE_E8z7CMo!ev{LmpqcYCBNqtkvD7q$20WWZVNMC#nY{UQTY`&zOVEF{wjm<=IVVS zY!^O)zPVi3)(Spo3dzKx1M|Rbt~pJwoi#&_B74VP78cixkex2`g~CPliRgLpr?2m@ zzNp!>zq?`GZQkD|kt;aWN)z2<Q3DcA`u;ljT#!P*JCjQZ5{1ho965MgFofAc4gs1{ zB`c#G=XUGydu0f+e=1zqP>x{;VjWR(qCW$$A8a-n>R%t=H`Lp+YMFuY1}{3TETdw& z-k&?{TOgG1cdvKdg*FQ_u5PurOr+s|-(7A_A4ku6Q%BFJ+1+utg5UZ@eGbn4!G7_W zT`++X)%=uq_tzrhYh&k4`KZZ5<+;HU&*0e1lVd}S{|Mr>WuBY=g}RG-%Kr551b4L* z+%W)SsbeSLF6lgr^YVMP^f&2^t8ZZ1*o8ViS>h^(XicTRU7T<~Zkwg8866E~!fWAc z&Ta6iM!a{-Rzi{(BECgFGzU@=R8Cwr`b0&g3Jxlqd;2H^Pr->gy00m(uX`O(J!_tD z1mG`=>i@wQa@jkMa$7EL=c3In^Xv@VO+faU7-s5)Ezg+%6qJV7o4rKRsOPC@wf@+w zamkg6B5F|XTE#70)Lv95hv6>$!;%(L4$JYzs+(krpV2C!pJ8*=lHNI7i`P0jc_KDr z8a4&_s6^y1x@10k9`NN@bF+$u2Z*o4tv$(mpW;BFOe_fE1KOdOf?7*{bK+?kH&^dq zFmb^=LeqKMjuE%YbrmDP#1e6?-RHGUkVR+Pwzt-~Rf*$B)aj!C?<{}_r`VDuLg=SQ zigzl-4y%t_C?MA)u`8h}Z4UeSn;}$t3TrI(^R(E3q<u^%KeWo@^x5LdjnTI8%Q@!F z@NxBzcb98v|MS^*Mphx|lMO_))$sj-B0booQT`VpD6Z^;i1K-(_g-JTQ@iODK^gMN zSGVcM!lhK8G!O^*6^0jObAYk3)4Z}%pr=HQg|+HcaHI1)w!`gYb)jPMhx2>yd%d(s ziqQsNXPXAqA(XxYHn;J*(+ai0;5?9j5PC0fF@P05)4gEyV!kmH;Y+g?c`S{aK~|Qf zkRg-ZO7%)d@gp*Xi9lPNWasf;E1EU!YcKKT<e=VMQx1;^wy0}bj6Ar02)#iJU=B#8 za$`7JPE37cI!*O<JK6M(b+i5PkCEj}X!+aQ;bqsXBHoQs$Z0*OYlWja*y?Oy9W|EL z+Fc&Xz2a#}q+Bg?gr(D?U>6z?&b7&Pwqu|O`#=yy_G*T;=~=!%KdZo}*Wwiq7NzRa z2Y>0p>g#wTDBo~w98!Lb#;fwm5uK^8mnJq^SvYjizu9?_lqDJaRbabXvsQtXZXxnv z=hH4h<Hi*|g5PLfC-pnka#vNCW$D)=<5w<|_ay<~EYBPSXIV+mY(#uS&uqAjy6#g# zIi*6&$S442CJ3e$wGs@#3|6A|f6B*d4x}dL-u~uQ9@Rxb!nh85Zs5H1MF#B$!c8-| zEdK!P2JhET4YVN>hi{ixvt_msp@dLzlI5yctpCw`v|$;@agcsg-Z3qXVcYJ6qAm}f zT?)zKo@pJ=mzuYG-`#$puv;hoYj3#zquMD6%#6RpUrhsCH})%2EB#Y%yU0Ch-|yl{ zegD653>>Pkz=f}$J8MHxL1xbTW7Q`WtrJUf=-i#uYxw%WGToOyAdX!scpomy8E}j1 z$#ExPukcO8M)>w3#^of->nD$`$K<mhbm2NJBa@JB=joT<+$M(z@PKK*g+1yI)mki7 z=WlNNb*ltg#cFvYpxyf4)cV<ug2V}sXEg0^des7cgwi~}6Q21|Bt(S6DbwuT{{sz) zPK1e`0lp<I(L1KZlolwO;%voc1+5r-md7O@M+2FP@`D!a9oV4Zw9Xexw8oDQ0fjAK zbPr?xOem(^!0yZ-YVL2ulve{Ep4P?qtE6#;xjXQkgLl{aUl_l+@&vKyF3@2<@?QU} z{aTAWIS$w*8X`d}%6hcD)nl0V*6RV~D$GRA2DNEKUUiW#i_gk<N7VQ=(Z3Ert!8>j ztC;vZ=qVN-?&^+TXQj$8VH7_|4!4;yVnj;eXisciyTR_Rqlo#tNc#93pbPGv(%U3} zjz*%mb!Hkp7(<-o0nHiV^^3@L0k6wDfnUzc`$T4^y0G?HkMncH*=ActO9IO-l<dT( zKw1aPdNI2l1BUKc6=~O<L3aZ>3V8%?7^CGX!@Lu!a{-25ruzoK&=0><{;Zx(5}@KM zeyr_+*HI*Y?%(4Nof=9XyU;!SF^Ng5R)wVlR~KlKAjvQU*d`{lM*a_YoeufCE*V{C z-Tr1?tdAHl#<sdJ<?oUm+i26d=ih)FTdTKYdzV%}oxWWWH2+zzv^f%hn)6PuVHGZx z(?pRdVEbg_eft}~&0bNcxG?}9zkp<r;ytHT;Cp8jQ7sGE5$qExGLj8kByNhHI3Wdd zwqdlWa1&6R$CI(6U`AazI}Q)}8m_%woQxg9=7BX7!%pOq>IX3JU<<4v+#$Fw4d;XB z!y<?nlLYuUl#2QG5Dz({%pU@cO(T}a1(8zdg{34~AIGlwoP%7PgM!E$I-#gg&MkN| zH1m2LuFdU=avEpFf3PxYv!;4KDkI7wT#GLnT3<WTJSw?;g~vc!6r4kUq);9BUXsP3 zPy{-fqFP5XvZG{^Qm@pteukVnyHj*O5G4mmGYybEp}KRAbvMEH#e$AA(&U>iT<3J; zmYJfc05Jrp29!m)ju_?GVpOWmzi(+|j~Xvlw`xk6jEg`d`FUeWWB5($;u;Y*>fejV zXgE5wI1Sv4-bzdT%8Om&nmOm`h!myM4N5f|#F^lMSb&=U;JsDM-4>|v+QPTuHAv2s zM-hMDBiV1m71urF%BB6j?XCY_jJq0t8u9v-wK$_`uvUR+z|b1qXU-DwL^(p61%LD9 zuyZ_}axH5A_i>4a>v-PLfwxZa7Drsy!%tjFE{CFe-4lK&z7Wr!Zk!5k)+m<?pc~s4 zRLBRL@3v5CF-~{Ug6Sf-4mUzUx&up|&M)<((SOe}pAusn5E<+4DC}5RD{)5iT~wM& zBp9PET?p%D9I6@nr)QZ|hbR4y2sf(=1H}Lo25Vc{By9`)=UiLu#%G^>=Q79_ieO$J zb2~E@GkNoiftSII!;=(I1F`*&ujB9z?d%FLA1b8y;@LD2AI-Vw;1No}2Kd!;<B~l$ z{;caOo~_~zwpQsC9xpG;o-<8&<J16tmuZwnvg}=*XsJ@O7Um~QHq>D`ohP^#rj=di z`i{QZ(lhXDlpUgYD^}3%N|!L{(UJaHYQcQeJFjAi6AHuJe;kYqAI|4hayxc5m&z4& z=P`fm+VN=)|7-B)Aq1_wivSZV>nw_3C&Ii#lnqBQ<XL?y1Y0P%8f9;R<rsx7gnm*? zI3ma=F4*tTyZF}%<AqfhiM^|XS%l;)UT{s(90(NpUFugtoX+;UPH`WMtDtdF701q` z#2Z$~lUsXZ9AB(o8KY-`ZfotqVJvqR*%Lk_j*aSX?R=_0&3&9Bo5oj-sSaU1xM$hy zJguEuaaaTI-TsGsRxl{U57~22<lE$f)cP1bu}rP-z$m$}Grc$E_B7l8$Qp^9Za>#$ zhgDDEnCr3D-}JrLp4~4YANds8lB^R{Z0_4`0l+2_b^iITuDX%4QRV)L;=|J_4~)d! zr`&(e1iIKQx2bw(UZ>^dJzfsg^DKKZY1Pd6-G_C8zqX&UyDv0pI_{NePwKgiC*iM1 z;-g<D!>b%bX_|n9%rah|-$@frRy?^ad#X;Q>&p~3&KJa3;n&{Qv|nl9NQ3#T*V{au z=r;yF$)#AVwYrZsXJ_(0{s&Cow5EfCpuU_lj;s@1VPyNB6)ESP{?WE;NaZwNYQJB% z=2`d1%l;PJ?qc}Y#LwAm3T*$cX9nl)5wG2*-gbrbteC+<q@R!F#{TogbAR%tV#<4? z%^D5HlS2K!zY~eq+28#2<i$jI%}*CEY|?oRf4%Ni`Zo%kKScXoob(e^yA@{r_SL)N zkKfA~&9D@@+U10l+v^yg3EbV{C###=Hm+&oh10tQb|(G_P(;&b&ADfLVbW?@?eIUC zJl(@5ZS;P7i(PYgo%ieLx1Wy*jjEb`$}Vf%Us;YtfB%Oc{M6)|U*rtlDz%MQ{f}rI zo(d}EqITf~_E)^LcKdQODK6TlN^1H4(vzbh`uqck!c$#WRij%jO=0jJqEm1wG)<a| zO>SSI-8~tMev=<`N6Te1=+~{v9}t*(iWlZm9NE)bHAp2oa7YAQZw~gnz((BV<!DWG zdwJjq^Oe0XRla}fox^MOx?D2CBPb$Mj%$s<pskP2C22DH{XQiVg+KFNDLgw*dzW?6 zN(A-%6`|O%$5&W2+t6S@4xfybbn?O}iKlPY8MP>{$n;>G{-)7k=;_wEa_DU3D<K=> ziu^{COxYJq<8NYNlvhv6!0YLY2|;*{V#jSR`a><j_2ftX`lulg3Ej|8W?CquaNSu7 zkcrywO3$TW=oAqRxfvWuR4jOYbmsMOR~bdQ`KEl(KX)5eX{M}D{Af%tNTY6eCz~X6 zw(ZYmMSAW<D(CmOT<|CzHOko$5pQoLJl(N%qrDQYGWc_QN~2Cd7+=bkx9$p`l~avu zdop^?)v7a}k=A*o)8jRHIm>5bzN-qJ@4M&0sP<E!0>CIdY|i7#{HQ{8M^zDwl&Ywy zE%7yK@O93cK+qwGXd!LxfPz(#Q35((;cxJq&%?xO$V!#cpMz8mv+#KL7MGDvg=bea zJB#_q))GFIsYHcEu3t6KuSJ-w-7z8GB#Ygxh&%8b$y9C-u77XD=(p<J9;lv~rlRk_ zFBV^k>xEr=QeO)uK2cj@BfhXwck%w(@16t!Od71_ty+)%Tnxh=dYpLLU~9J+WfBAm zAbf8f|1&brOrF2QNedotTs3rG^((E%F{Zy!N&)o{_+7kGKt}anr_IK73qJqrf6?jH zn%tkzKV>Cj`q4H#A=qB}`sUtQXZ-Qv!&Fd!SJuxg^qg^B_}ajJD1akm0GZl&AhNo& zvST@#Z=b+l%;6MV?RHY$h=k!H8z&|@W{wE>f7p8quc+Fte;g1LL`6VA=}@`^>F#dn z?i`SA22?tg?(Q67=#cL24#@$A8k*rZKKC2X^RD~;{RQ8(&Vm8fVPEGu``Yo@MO$P4 z{RSS6inN(u6VBW;x$1fMq4_Z&_;4rHVH#RjS#kGa6wTA~Aj!V)Ijf-z%c6R1X+_KQ z?Iq7IH(C5hLe4mN;yD4y)-GYPH;1Qc66(13GbAQm`}XT?=n-O$3rGmQQRp@@qxl=j zKj<Zy^;+AhTkExo+L#}O+bk|FlCtqvg$x>;YZMuBWF+4JUaDeQ%78H$lxI>OPkGdj zjlzt(a70x&1G+J+8x%PNon;M`1&jCT_%aOd`R35Jd(J)3Z@#doHF*%fI#XZar^q|^ z@anyC30i*5qO>X6);*+{D7Z{TI=68WVJEhTI4MOZX?Mw+CyZ(>kzQT5LP~8}-x>qm z0+t(I@*ll%Hy25HeGR%eJg;oNqhGZNR-x3-x>r^dIg-{Ki;0So*-vqiFmFkWjW$7W z;d@3#0~_75eQ%1JU8PK0;uq$)G-|r%`I>s7{D6iX!P9V}@tSQDvSc3bwr|TN`y&n= zLf<>jhBVvXkY_p3vPMr|#JyX@9aMZ!Bo=KLa}61Cbrci1d2_*NpeS-Gx)Rdmde9Ih zbj3dr{OO^;Rr%Fiu`ugoK>_Ben7&%(GXNrMQ88q<RP5tih_Xh(*mN~p59XEg!A}vt zZcInflxs^5{6U2)0e%L?N{_Y;-VCz2AISWKyA*4$Y4T2;s@uPF?@5fmY?l(ERrDB5 z+*6EW-EC_t7!u;UTfPYF#ys81q%a&j0~aecozQNO8a^+@v=$?-2xpHDa>+KxR^0G5 z-tL<!lp{K$qs^$le!cj5kajPYZPS(9zUfx73v}YEtJ2GSvrDJ8mb*GqzMowykm240 z{;nEE$kL6KS-h`0guWKqS2v^;dLs|8>}Q9+8_T?-Xuoz<Tpbkh2a58ts9lBQioWBy zp?6d{{{Uz?M52yZ!<;+iysmqXa;|cT*=Mk=Oz?<vhkLv`t+Gv8;affTLD!=3Mk+8E znoVB}LqDe(6XO$0iz(pFqyW%zaXen1$2c?)w4D#MdiaL1J@!m}=il_~g?g^ifBRJY zkd^9r!KqJr+H}fa%hml75Y{)O8ATcFL7}fAD3;N!keK03q1d#WhY5R`xh(e=pv)Y= zWYXTc4JMmM0MX?lE6-=!fkMp&4z*lGhGXozfGh7uIF@Ce_X*h*H~U<=yWiNtr>!lw ziOmmgSB7wV28{~!MZ(Li<~CD;G<WcmRpV=~`_RH8&35k&i(x(Ttp(`eLLr&+<*=B8 z$WO6<X%@t}l`PW&<wO#3DU!#8mnmfm!gak1-v%_hLM*U^?yJI|y?)KOJ0Q3@RLpeG zIqNp@2&v?vL^+Z=!hon;5H+1}B4$$Ui>?M1@?O6cfo^U~3iXFw5&a}oHcToP5~%8v zMD$I=61;F|zCZiLbGBiQ2M?~^tc#kX>Su)W`;kl%;Im{<>-7z7kTNgc5S(3j+n}#? z2~2)>p~(F9@WPjHtU0S?^Hg;4;&jIF=i{r7M){b{?oj82LT~(II!_nH08s|io1i<t zbLZ>W`Vr5&f~rk1p&wF3Kx6BlyM_RaFF`n&u~<^J(c&4wxdt+%f2yl|ToL)jPmlt8 zTDkS(=oAX>iaiT^84kT|Zsph1&SeNHX&t2#=?n_)_6KEKHK%L$H}jhb#@efPDeMb8 z8Y*wh4(v*mD{B8h+PsIl2!H*+0x_iK_4qoiZnaN->-nk_N>~{P;DkF->?;SE&Q7-^ z0&X=|IkCkXYBim-6lDg+<DSvUw#YlOtzdZukIA1RzVCNhHhG+SpF&~^vc{_D`T%`t zo|pm$<HorX)(rzI?&)qeYhQovdM6a$%U`LnBl<kdU&RP=7&I6zk9|EuXw;UpoNhS+ z8b204k}*ENbUH;xXy5s7Uent>W19=H+l=C}PBw)^=9O0Yo4npgV6>s7tl|8Fi)UVQ zVv14|_aD+8i}F`njt$H<Ez>Ti(EYQJwQ$3}sh&#qo&gu3Jf=e)#1J60@fu}GW6$p% z$!CLzUosq6s+@(6etRzT`r_?EuoPOnVH}%G=AYd|%a<uv67l>)jK!wOqowmhqOK^v z{_#qS=KdyvDwq1k+T`|+V*?w-{mpJ@Pvv?3c0cGX%3z!(;+1UUT?%kyPD3eto9_0H z1Fw4?<P$aT4eoi>R+Bf)nv?|51i}+z|Ij(D-5(r?t7y1V8<M#aP|G-N2<*Wa>$2nr zIHmt7ocSeZv?oPncU>goG@&_I(Y#~gJ`vd5{(2E?Z4SKcsyu40e^fq?UqIyVT0bZX z4k&WBCBC}-_*UY4-W%#`HD$r<1kQr4!2!(&VZSIapWQCIOmU?LZ0)xD_V0}7+KB~4 zRn?5~3eYJ2cSPpf52W?XXd(Fg)0c$rkxYS>ej9<kKR-~_fA;q$^*;RgOlj-Y3(Y-4 zbGM{#KQ<C6UNUQ=Bk8iT)m(P;i>@!@j!W8vJfRQi8p6Lv<;|*Ncw6$3HIdOV?(IBP z!bBSXn^P-L2Fm5N{9GoFnAPYMKf$3w7yMI+oW1$=t1JVlBeU%?{`UoX1{Xt`_8DpC zKnfB-Fbv%SSQ9i`q$0L$4%W1*{-CabUJTpxlaa`Kh(JD&NFxvT(8nUj>Y)&K-Tv^i z2%cRIXT4KuVLZdEUaf>vjsx=wA8BcRdb>EZACUBf9w?@51}Xc+0LKZ=c1T%<zgzw$ zSqZ-|ZYLx%dwom4C*1@_G5hH<sew%mJX0iSfF32VjYC;mpG0(y;usLi%(+d*Bs85Q z(*Xw=X_@y`m!wk0HIo;K&E)ici@)1*jw1afUiR^O+0;O|i_G<boDs|M?zYAKm-5QJ zcb*A9<?g<^z)M*c{%Wy9EQ8^*jU+6kswJ~(NQzNwvoLJmVqDdFa<+853W=p-w?lN7 z)=^$SJvXIya`<IY>l}=bWjB_$seX25TNM*+{7i~Aybf@byJMwC3jyA`Dt)gf&Xs<& zm&X$eQG6A)lxcrcZ}3;8=5>mUzu4{7Dwz!o@)>k6V>|D;n{Mh4<bD>y9;1P6d#D6- zDol4dxB+|Jyg>HY;Xy)ore>z)a#*z^i+-H1)))b?SF|ZsNHe?3n7ohGp2j*h#%ue% zDZ**oNprc0DRvmiwN}kO_BO`!;x;8z(Axfw=nfV^d5bO;@z%I7!>a^_Xt=mDoE$r= ztd%c|*Zgp~w9RSV-25b*XaGx$<0oTO6)KVx!ekrbw3|1Q>yfSZd+;h%2DKn+!AEUo zO7_>I&<$eiDLZL@qjre4tT(w1X}EhgT8!vCWB+8OJVyA*%4nuUedOb(Cng;y{0^%= z0fd*f`ehsBL>*YgNY7lXcSrR(fpDL>R>Xg!Yrky+JAxG((|#Q<H%`qBdU}0yeuVpK zR2m4BvJ?o+E+Z)p6x*eQBdu!HT7k?!Voq8Xc!P;`PZeyhVauMF%S>+}u3bSdmtVJg zp5qJX9{9gp)M|A4Fkm0cq}MQy9}cVZJg1%onLe|;$I41ajDcR*QAh=hq;P<pwq@U) z3)L*v*=om9N5-{<B{s4=y+DWQP|s;yV6Hw{thGLJU1;+yjFwqkYV+mGuVfVd!t*Sf ze6C#AeGz=LWH&p!z}$?_l+vizpIh`4i0Dlz!oq34yyq*ey#zjrA(~?1^u3iI@C_&N zM#L_Fx8duzS+{_N>IEZSz0A5_gK=~Kgfdn3w$+WNR~In66mt}io#K#a!aKl_wirq{ z0=pgQ=z>i0hl;&m2lVyX5K+V%TcO6Ct1BymtrF}RZ1qN#Ny2RKq2D~v`rT(rI40F< z3KUXhD@%X-k6N80rm^cW4<%MAlU2sI$m(D=x|SQ1H!bS%*f?_{F-*U^nP`s)Ma-3J zum>!GNAMZ7Xj=`f5L*Lc?sG}7kGuL9&nvkJldEX=LIBC2dNN*@27O@HjE0mm8)qTw zY}k~EOO#6t?r>^*e}?a+1QGu=rR_|KCkiV=6nSjJAC7;cje>zx)Sn|u>6iSz!=h~L zRKQn-l-Dk<=9k@kZO{CkGplButVF45W6n&u+R)RCiM0~-^21ap>ixO-!S-I{(_61- z&V9&CJK~&8@3dEQB(UsJ->R_hwFG#+a%<Nsm$OOz_sI6YWs4*Do-$y2C~;|czw|H) zdNt+H-J7A_wD$0lXttg@@?Z&^?rnFPlh0NQz_BVy=_BL2G)?6PL~&S840v50{@5aA zd>e4xoitNR*V}uEg4Aj*htE=zTw|fTt4MM|?Q>hdjg_x2v-sz*w>9B(NTV|#`Nz1g z`OcAgtRuTa@pjT&n8^4&s$OiB+D+!kxNU~g@RH|dUGJYsAN#^_{6S9%;-mS`4DTMG zq_scs1{dKZa_T=OZ`<dN8?VUR20jq*dQj;feHHP9f0elGjvZTc@PlDWeB+_{ZZlhE zF4qhhB|4gvV{wa#NMJ;k1}}Zo=k?5kuAYkBP3Q|%@$ynBne$LQ7ONF5gwkA`H7N1l zMCiLM<hSi0%P$nw%qJT9jkE#hG69gF<ZNZ%gu2_v#YHI4xlo^VkH1to+h`oo77=#a zMRp99BJ-5qw?zOqBxNb|ce$A>fF*|;@UHI--ddG6^dWYpM0=%REXn%eHp6J<z^&@h zdoP+8XDRU8sCvubY=JLBDjx(lmD*oE_|*}~HL~-)F0=&^B!vh8cBc2k>Icq0mC}{8 z(_a<}tyyRq_!axhxjMhN&o*#qg@ISRh9YO7)6Pdi(eN(PpSsmT52te(ZK8DvU{ke( z6_<0^Wfz&>SPG{#?fNS1-MQg$4c4l!gd@F9sv7`sd>DF}z63>-1Vfuq^f>xyAcup$ zZ@y5Au6V+42#%PyeeXjbjv6h=64T%&Sn#dPocdzp{GlY+-t0t%-<jd@4bo+L;9?*D z?cUa8@m(CD?|fRigEn8=*Z?AAykb|FHaSKqtmp;KJVXujBd2mP-W^@x^csG9cjx<9 zUBBibw-2@~jQ1(eTk(P5xoy=~UinU1jw_l6?@w9I`@?DO>Jt&+0zF}}ouHV<+47}B z!$+@aznk#P>#pJ{3-o!l9#@e3zAD%PkRWh%FL!yqX4AIZI&^8LU+6KNU0Y`}HFDg# zo9NauPr{&H@|%<VEFV97d$Ue=&Xj*_K&=4dx~8AGZEx_fwjq4Qy0ZPWEZzC?-P2T6 zjHk*tZTL7}NL1W`*BeroHJPi{;fai(wfoy$jY2ntXT<^H3?-Z~1a?|Jqsh(VZ8r#! zH+|xcNLA87$|@?$*}1HH4V>)%!~d_oq2eHo8^1RB*+Za)!kEUGb#K^a5?{VnH2`Ei zr)p|i^(j&>4ccoS^4^Y>xC~zi4xFJUwur+<+rnsV(q(T2A+OLlU{<}O`ZAqjm#Oz= zAoCw|s1M+Mhr=&KVZ{N|rWN(`0=-6=vhY$g4#O8fE2w>8heeCA>#mm=>9s@fn0B1G z{^Bey`?#YDY4OvnLufjmd-d#*PP2;35#hT`RHQSqe6+YU{=ZuB3G1Pxxo!+%g5!nm zH?Sm}csd)Yhf!Fg4;SkoS@Rg1uF@6JEvS1ev#AcgcYI*$DM{O<Hc&i+;e^*!)3~<& z>cfd?fHY}Uk4cwIeGC#m6H`#^JCh`y3MhH0dR;At)#NB*?xQiuV!h+Hvwjs^v!Yd| z^`4g%YFx`-%HtVydy#p7*IR3cNA+u<xivz2O+CSR!=GqhR7H=Y&{=VR!OwSeq1u_T zPiZrA%Ue4>RcUsl)rjmKA|y`q!;KP<pkMlsv(9@-#<y8lJ-soSglobrY+!fM)&VEU zqEg>|Wu_u_x-o0KR8z^FtWGXM6tnyHHv=s0{K6z-<~LT>sjmCW3x<auutu+%Vf+Jx zVcX~(BWuu`Qtcajx7B@t71-x`(`dXJB~$m^xDO{|EAEdY$MAEZa<#;S*&<JNB9BG& z5;crFkIv7aSAZI!m4}!}QjSq%$&nP!s2BGO@l2W(X@(s3pXZL@khLSSD*>w~ib88T zA?8+t)7mCY#pYN7*Hs+&*M;BSdcp5^z3ry^u?}w?Rw;Wa0`d%e#Mt;pj+?Li7^u2m z31_Epu(7Y05kTa*^fbre`EK8$MorEufkN~rV{6lMeTxG$t~HjcZ_VqMUDDa#VY>(U ztIX*EQvnMt6NH~C82m-pK{9pKE6r|8h^&9jcDp(ef;3b2$8Ce=(_V+rI%)KrZ!dmj zbQ)mBOv2{$%~!lGRP6DN4s2QGhUVgXKGpT_>^)weZXNx4W>BM&oB1U{Ld(zS2svve zR};vfxkF3D<5dPba82{J4yi%P{^38H;kf}o?ovb;XZ-qhvaY_~fuv=6b&GztQ-(`R z&{s82>*yB_lXZ{I7?@$;RxYzLVWAI)WdVgtW5840yNPJO^(Neu2$F0&*yU`UzP|TH zkEY#bw~SZq%BbKK&Jx9g1Jl!NgFcu`qR~FmZ;H&{=cP2rvnDS02o2#RSp<AM_p^*| zf&{O*Q-9iFujk8$Q%hq@yrt19>Wz5Ea58oUSUq&Sta-e$eYSa;BV6T}|6ZZ(ukHZr zG4ErL{9noV$ZWDyqiS)J&{gW2P_>TqJx+IsDzupWP>3H+gz{yP!GmKi05Rfc$^W2| zD>G49-){Kj+2?YCtu|EMp9L@kFMsnuf085S{$huv{nMlu$(rbT`iM#LN-R}X`4V_B zV<i0dZEo_bdru<%M>*;rjnicYD@|+%>LA3pu*HIr0DYu$VVu7L)XFXx;+83y&*K{E z_Cnv_D$6+aYBT<LP@<etYG}GeC<biZ0mY>@(@cG@Q*BPG@taroi>==E2;|-7u1_p_ zKGmUxrb?{*&`T0BV43MlKO3(Kw!5LfgJb#GC>*F)=c1W49H$H|XGQ3;beboYgJ?2+ zbjXu%+?L9@c*FJU?fVG*6Of-Mg2^8DxWeiN^sQZwyvi<U$}BRL^|@Q`51Kh0W}WVi zp!PKu3aPxTPuC}iOgtN}vMtN5Fa!?cV(*^EIi_fRKS0;}EF#a(aQH*&ajT-F4K@Oa zV2kD{kc+cUY46|i?~o$U`;q~J0!v2H`R42&M)kqoSI9HoS?O-KNHgZm>Lpq#<a8hm z^Ib<_M87xD*2_UwWWfqmZx-xkMXF~b8#bl#$!w#GXWh6;3u<F+Hu_EAnk_F<Q%ytP zKm+1(sz%~`f*`JW1cqyjXaj)1w8nS`Sv#%~x`)qs`hP@js8v2>&6SF*y(4QF^STmL z^i@|su9#h5sB9?^TsBt{dZ<>&<Xu$U2UfJ6A3vLIk#Kfra)qgXJK`89txd8)NDYUh zobb^(gKR{voA;5@XUn&r?Mr9NS2osvuieAfF1Ir8J4d;<K0TvfL-^0FhJ%AW1dQD6 z_cLU6eV660Y@Y5-Rj$dr8eC*i-iX(Hh0i_?<dBN1;sc&MvmLL>e%W>*YDqPyW`x~d z6^zn-{wrAQXq4=6^<7vLvx=&4THiKrX>xr0J@Rn`G0$Lz@3A?=T~@C7_I3%-@694^ zzdQZIzoxR;qADr*xE{MJvziDMztpf&G0HA!?6UL$lYqIpk=>%yf~XtiLJcH5^QD0L zb_ae(29B1DnBXopE_}IXi6!(&xw`oHtnK!I<FXrfOuAlf@d+YZRKUxn27v%{UDA^v z>o2xCW?y=Y9DyGBZ3UX#L30Mcp_Lz}FIEr<7)=mgwt7lXrDg|szFI=98BzhgS-y;Z z2DcgFfWi?F{A-W$^yu^xUCMN`9Lw7kasg5fn}`*}JP-7H_65@0T`H4!!lW+hxIGQt z{SW`j;o$y^@g6BlEZ*oR9Fr;Fq${u|;gJV<Ji4taRIXD~4CPeNVk++9NHf<kR^vY` z>HqCBv~Kji1KJry!Z#m=$8cDV)wh_1X*ozf(_O>+W!)cmw!?*ZAqMqel7nkl&`Vvr z%;n%<{~!38j19Pzdik;q>6bMK$BV5jq0YRtK5T-*sS%qmR63Qq@xNq-JPx|^=YrjV z2bMxq?yfXy0?9GKtEjgJgBZ2refG^q7M2^vBkRLWt@FPRW-1-(m(K(Oq@6^HS4|`) zadyiDzdcPiRT6~dz=XEN?{>Hxst`>yxQmdxTumEOz6Mx+Px5bag_>^l`r7F?x!_|e z$UNhI!QGl^UT$bBCPZl67rOmD(elap^WzR`r3{ly(yT*9L#0yna=T_XsN;CwU_65z zbQaA-bAR16I5fR!3hd=-%O`e+7@K%#0h&VU#ULlF1f~e(b-}2Ixoh1aV12OlQlUn@ zJxOWhz2HL`xc<h!gM1_8(F*hiu-G!g+|<yH#N>`{_NI{ob3qOj1$U$#2*1N9Rc<Sr zDOH<lqan}(=+vDwQSR=Toc;>jML4~7UA;`4UKf3wKJ(~&y3CnweBnm@Bg^@_EZY`G zDYg}F-qM}XkL%rqot?3s>@1OKf4i;gCY(|~{@Uh1a|KC_tunm>Ym~Y%L4;0hR`?cY zD-EF?d7Byf(0S03eY<PbiesPq@=G0BB>xv12y>)vK+Pg_yEx8O037ZM(OrwV`WDg} zvRgiLe6~Hb;O@{q)I_{AsXweTmVz=xEN|rZRe%2_vc=^wpAjZOWi<`_TsTUuGHVF1 zSnI~RpfA+26a|@CH1OEKYu@s%m#Kdx9fg<Yy#ko{idG`Zlge&cp%t$4d|iXBZ)O<` z;QJi}A%QHmrfbEN@b!n^;#k&deG7_y`yriin|WjW+v3^nYZQR}a>EZKVxc;7hS>$* ztH&wrppuYxY+OYw`7cINIW*QDl*zM9oyqoXpluJK=@il8Z3c!(xJw9F&wbUixfyzg zZA2cKn|c5H&!i_LH@w{?;H-X4f&%BUq-ezYuWV`1rU3%y%8vt&`w0g=ch#{97mE=E zt&@s|*t={Ur@A7FtldY`n=O@&Wkv03#yVD=N3ZWKjs<ww$2@oKZ}ja9QS;iZZ}~{x zykVqlU^$)gKJKeNT%e5dnY9}zYL_9_6|iLl)xG~xgrWTKr6{zfrAxHqx#$Ji?2giL z+vi!*gbHq}z^1z-U+-~Nc2gX3<o~$#@KG-o9w7wj!Hv#>zxpX!%_nvZEwZH_Tqk57 zT|~}iG}k(m{NS%uf8wT<yYb_{E-`1oasBb*#}42!iZC-Ki9Fo)hgHci9&*eWN=$|S z#1ABl7{uit?a%z8y%OK#Y2E<7#(ske>W6px#gclt;Ui77Wk4$PiJL(NmUzGlVl3R( z--5H`ORf9(pXUsm@iM&5GON?4$}MbJ@b-#4`kve0!XUwPvC+Ra(~c<l={PyYmsI8D z8SNY3vLHgWuTqaU@592w(^zY)j_iETcZS_Z+;r9&4(MNyvdw>A;?dNf*3e}6x}ci5 zuHM7rrB4IQ6~8!JT3e1La%fp)%t-A|_bKAm>|un#U>2CwC(4$5{Do;=nRSt~@}l3n zdR<FdeQ#wX?{l|jXZQ{ezGpJG0q+MaouIG8tfb$z!OC?buB8G6UgA`gaYR0s{Cxd` ze6!eGt{Oy1(`P4Pv1B8+Of~z!jLjecqJ&StCu#@TI6j~m^0_zJ&4IhneLtJ!!wKyr z#I=3zOcuMbtKGG!-HsNiW+QDz2m_-6nRyll6?*sx3_RMfAFbNpywarc>N8rc7B9hr zv)0<$t*76}?lTd8A~{T&JRgXq*_d@$^%p=hFR{W2mps4JUCx;WB3iHo9QN?^56X9v zthJ*RraAot-XCyJdj$mtt~Ws{63U~Qe;vGRKHZSY42jR7e_WK;(IK>NIOUa3;?_f5 zfF=Qj_BEVmi(!R{27W|x)rp&%m6;4C$H)aQBF_S~)RTqW>q6!xB^cdP_vMBpZ}uAP z_uUrE35MRH;~jHY@X<Wf8<pY?MK<0v+*f0Mv|oN}8Y!!7?e$<wRL_Ao=Jgc$fn*%2 z{OITFcs|0l{%Z}6&C+^Zt0i$KpfP|Sk$omGzD8K@+%41u-wOdAKipJS86DGjoE5*b zko)MX?Qc4y5V8AS80FbF|2su@)-%ft#1DUeed))DAmzYeX}e}?yY>OwrK?cJ!mu_d z7M!-XH4S=d##;TKk=;KzzMgp4i~T{4ds?mh0khE8tMDBty1cB8(XRZd_M>ngew}<4 z^|RN#Xt~1vds2UB38eWmQ$setD2~#XX@LjqWb*M<Q+kw`Que@~>AA;+@Ve4`XOoL6 zidVvQsu&p|IWA^qs6j6Xjle%uCdA|P=0f*G>U(vX7@tAg&NI+SIZc0$yA1SU*On;L z@Y18;cFPWDq|-kS>yp*(ulV6Id+^y$1R0;jAWVTM!6Zye{2hnWckL>0PEvQ?`|e9Z z3f*M&A+TEeFNi}+<o!Jg_R{z8z-(4EmX$#|X6Dgp=gOz3C*v)3D~j)IMhwd>xfvi{ zE^r;(lKCR2zlzC+{)G%RG0|@Nn2o~IZLb;G?G^*Z%?P%m8NOQZL_+TFph_UwlWvq3 zF|;V@dJCMN)))_)w|NG6<;0P6Sk!`)#B(0-sdBPhA!n>^)2vhNI^bRq|F&wkf$CV0 z4Hewl-u~xhk%Ojwz8w#K^akbgDM#bpu;}>bj)*csYTd>oaaEfpJB3e!S~U}H);EJA zU`+}3Et-hFkEX%omMe<;S2K57(O}q0Y+~?XVCHiOd79rX9o%c-tTuzbQ>9cHw>Mf$ zV#2E?eF+R$Qb;G1xX9PYU~V}fX4Jp`VBp~wWGGw?)4-nC?2&t4p<^%K6N23p!9i0l zAz{vO`Fm$@f%F9lTff%RlGnyR;NA*MJe>VtOZtnF;_}2QKT2^(aLc_(&4;obfc|Hv zPa4~dZ?G4*yX4w4-6E{`_N0aT!Ubva^4@QyuC-vad!A6V+)uJMK;dg4=vIJKsAuVQ z-@+xN@QR<Dh02FkcX*^@JJHbOyAQ7<516|`+8^~5C$c@VTNMU7@IU1B|BCMbF-2jT zIhMxXkfe`Wbb8)L>Pg%;X3Gy-d;woTh+5F_j1O<Q&G;+Y4%oEQWD@}b6~97hh-nhA zP3~PI!<@i3MTvoV2M2`gj!>+Nw77)$@cba1?=%I2qWU?wi%q@1Lr3KPklsu3XXZUH zG0{w8?g%%_VNiLu%ZfYRvsO|fTP#63X=Y1XCyd)q_<gm@#k(NnB*dR%_B0!aN7<>} zK)w{h^BnU`MMo#By81cx?>8nZL4fKJtq3h+4CmgTkc?@$v$lt4T${OALcOW%YhA^K zX^cx+=2<G=%bdH}<Qwf;Ke=?jK^WVr-(^NG4RmPm7<?Zf1hP#^rwasfF^0-tS$3Ga zk_#0$mY86POmzkF$=^4+g238uvF1Z6*Nb5xp;5wCNj2U1jLV9!2KAYyNXzVvq~wJq zblH~E3!QdLvEUaXqJ#Wz!X>E8=XFtk*(bi&fD?--lvXlL_?)K@Z-j6GBg_31VJTN? zU#Pw!50J~>PR!QV;R`q3--!i|I)bn*Fv}%DU-rs_4Y)Ak+I-o5Q0RhZ5&-dzsy5$M zk6SLcTiQmk3yXWw;174t<ZS|9wR+`~w~lFH3(pMA4<|O{ikD5<p_+bs`m%E!TTMk@ zI|>n!NNLIGkqy(S^*Vypn>SbC`<&07fApv_4VAqUVPZ<q{7jw;wX$2Sekt^@FJN+G z16>maxNCbh-V;^mz#}!HNvb)@qAVezVrk(gCtvo!P9v%`yf`N~;{+(5V+ts<bRAk3 zw6yPf#(*Ye84t(x?QcpgyGA^~TlzpT;B~Gy=+m7uKiy{L5OcG521^bK{Hf>ACdVJu zPK=K728jecZ1@{0f=&PCS`VSj!t~lO2^FSUQBxJ{+)@$@MqhX?KHKw~2}Y6Rarlw@ ze0b{1;zjJ~a1BdJ)73#dBPE&CMJ{R7TiV_hnF>tlCNwGU3cb!!@%Pg#0tTqUGSn%| zgHwM@i;gy&@imr}UKs*h*m83cbWEx9v~C4T?!WoE(KE>EX!?4lA?h7VEw9nTf( zpeW7wjZpF1uR2f~Ud~R5Yc>ZsCI8u8JIG>0lF=ZJ>XbNKP$l$T|3NzWW{&tfToFp{ zl2gk{Q<?Ivyn=%D7U!{!wZ~iUGVRv4?G0Cbl1T5L$aD*28m%0RT+h~5_JaDN=2mis z=h-N6ikrhM$l!gMr*rM_Cz(EHjavEEol{D!jOKCVw(A}dq&ywyDt=%3u0DP-0s_4s z;<<%sf^?Bwbd<KsG>oQudU`~ewu{C~TA@Fmf2ZseQ&v%-6a7KxeB}m_`TE_|KSv&3 zVEH@u!7q*#*BL0Jb0?_$s*X~SnWd6VBfQq(VvW>5BnzzD7kTL|D%xT;MLX+3k77QT zoe9W|qQH|Zm6MN1ET7QnnF?SV2NJ*_sn7A`5)(D|#uD~1w<img$n@N2Bs{Kv6rQd< zwgrSU^BR_YmI!Modwnjk4EFA$mrrpi)Z#pFV0>PjPgf_X{z1ck(}Yr@N<FCk@yOw4 z?5v2h%Q?>J=g%p2&r*X(bS0Lzm#P&h>l}|F^ErQbOypwhx%Y?pyDark-w3WeKKfC& z7rwln5^INr`s=W|AN%;+c?)$e#-E>dtBq|Coe|?GoGL|=^4alY5Wo7vbFU5<WB-of z5L~#Pg;N#ogI%rca=Bpn78KpaWT2`S7IEPsKA2O&jLpHxY4Q-HP{4c})Xr?O5O_78 zq$U3TGG3xW=P<6m*VR~oAk=O(rQZO$njU`Nsd^zBmDp2<8cQbhhrf*s(f6RCIybcR z^f(Mp>It!P!f+rE$kP4sJiq!$Zo3pFK4V92v|yN;lE4f)87*q{_o$X!odmUyp-r;b z#cvzGmQbK@A1#T34mY`_M02iaRxE5!C-E8{6We<VGg+iGEKr!6@AZhChq)0(>)U;& zXd-TMOp0vd>%Ok&^=zSgiQ{jDcXH#71*t^l=H`eo#_Uyys^DR`Nrg<a_m#cfe9=`m zH3-fwdYo8Xgu5Xh62alBLsMrGx4`$r=0>!hD3#AaaJE95W+@U7SE~zhxp`{0_9I-o z27mqG$^hGzcmJ6Jsu}(E&G@B+gapN>Zf&?Kghg_A>XoHJg>DkZC(dy7Y+7tgsq5RG zc+fi5vRnl>iTECQfBY|adXSv2sW`ft)^x<z&K&>bB*8>MMrP(8M>W%IIIpo6+KPCL zs5h+xN9c>fB3!zyZ5&I$;8|7&7JX08WV>JLl=#It!_X9$AMfOv;&n?9wj`T5W!Q1^ zGcrGAW3aKDqT<g}_9ZQiG~S~Z3vk=-EVfc1`Q}n#(nSrm&-)Yv@UQL<nQ!V-&q+>a zvwLV_rlE@Me%ie_Kkbv}W<4vHg3iKF<NV?9V)P=-%J)9d<~7bS%=VT?gY#C8^?=N9 z^>Vi5+ao>@U`v%B-p$^yNt8HnMfo!U$nEn-4f7yB_kYFXgfIP1=42H{kp!uJ-gMxX zy6V@2g!Gt77&~M7ZXzPs@T<k<UIsO=P-sL1YYw?WBK=ZL1W86{dNbz9O&L!Tzjcn` z$=0aYSR$i-&<I4+sDEL1aOtpB;mb4I$kpF1)PG#Hnua0`IaM{a$gEvNmLum9_6Hgo zJ`EW?A^N75QOpNpX*`I+#RpDByi+A}^KFq8w^03y8I13t+oXMydQZ<T-z1ecP1A?3 zR=PMY@E$F7cAD%fNqKBt&Yj~8C2n<H3HE?udp8CdnDKtiD>wnexkL#RN>PH-DMyR3 zjh~Kd#FcCpX;8AW<7)bCp)A9;f=>=39yd}-D?3m?^q+tO)M;Ler%7JRpVi8m4ZKJX zO4X#lpx<7O#7P{>jeuo2s#~YNqG6t1u(Ma0^w5JYRVj42N4f#3Tzm!!LBZ={kRnQQ z(4#5$&dxD5g=()sS{?mj!AnX5`hiMG6V<Pvm|PQ_x{PTOJs+Pm?Du5`HE5}v_ME<z zCe-fj3m-wYi6Qal67S!9d@U0y<GnDnU)#$3o<2^M03ZJ=V9D*aoUG|wc_Ok&6q_2b zR{f^6P=QOgx;S%oZ1!WRp^%=_Lfy5KJ*VIs%+F%MuX+y`oT~umvU+X<O5)3$v*_*@ zYZi-Kp_KDcxWC*~5Y<j6F0YsyuTcyeO24WG^}2@pex{r@LIvm%&Io2Lxuft}kYFoQ z+CR2KQ|?YG#qZDI&6PK7m|Z|pAfcwg%}XlyDI5&-4wV=A!%cUJSx4=pR{{cRe>~>D zy*jWZgbC7)n;+fBCC<CM#TTf}vx_sCZ>^H_V^qhuEZZWh!{|X7Ur2hRh%7f3(2D6| zX-w`Le)O+^#Ll#gz~$pTH0i?*31}L1q<M3;vlUVZ??jx2XDK5BrxfGBPH^Wd*&jD) z91Z2RIeYfg=d@D<xcioYC_g_xBs!Xl@;M%RP;fAjO0EtZk#gexWt3-E`F;uw9LyJH zKa}^tXK_IrLCS>`o><lq1S5*{kc2YOPgY&g;xV;6{tC8Wc<<hN<eOhrrQ9+UVFd#_ ztWeHEOh)iEy$n^uRSw)j%`*eT6HKR*7-Q>C<FH1=puwRSj!ERYKG~i$_@fUUS|=*V zN@6{d5yT(gAS`<Jr9d<}AIRq{4f4)B#H@|bo_8xw!`Pp>mu!&>Gn{g?-$X}-CpJkL zwbm*vnLz;OJo8d`UPUuW*tt?B+w{An<zA%DkN7Gf)w9lc&k?}VJ6%qP*f-5)M767u zw0Xq3y1rGm&A=OmDQauEN4WN0Vti<4i%*$e<MT%Evk^C=<B$1A>WMXM&lofvI<F^u zzmKtQQ~}LxOQxqkMG$&_-S}iVnplu|^maBk?EUm}Q%9L(JGFWZRWk}UN>y+m(K=c5 zVvyv5hW%a)1@}#!b^lT;J{j=rT|!tO14+BT-P(u8f=ST9ed-WMIR5=oRDRyY&l738 z#TK+BbN&PO0!7B>`}4EyO-)`~n(q_HTwCx%VN`Y8;!-Gv@&51X+1g@bNw8yd?i!(R z!_;;Jg9Mb)!f#4Kk~0uWk^v_RX^#QL%;}$83aW7bFem1w6TKH?92nn%Nf>lve2lvJ zY&=D}E|gXf>HR0m5sx`7tYnB%yN*2-Dl?Um1;%Q~SM#r0YDxT_IFeEC0$ho}gG8-L zDLqtmW?7gyO|L6;t@*jO&=`jn{C_>DeF3!uD*nq~HVpKKOYVau5S^2H)*j*RrUUO; zSjM!XCIVd_j&AmHqfdUvDh<vmTBZV|F5E+p(P_v{F!i}-0d(PV^dRG@SHm7~v<1Rq z<?q<^2hT+smJ2T&hGvgEwzuab)^U%m<8tT6%e$wG`*TIaU(%a_taH16>boj1?Tn^J zZ<p351Io*gx-F<@SSuVd+Zrx!msri_QSUdh+l}|D<DH;sUu8^A73&FW6cM_=7ZG7U zS^tI=x}L}4cLP~VJ)`PO=d~r8-oK8Fj^uQma|vFgGrdV!k6<qdf1NjAmwP#_HfFSR zsUPIrpj9@(R95S2z8ycAA(WF>tJf_W`_W?9YD$r%QfwutB5pV2_2+)PXlyDeO7(8J z)cWI?wFoKk`$?n4!lP-&Y=Az6==N@gFEVIi13h6aJXVo6JCeMK!F-XMeo>{Azfa*^ zxB%Mr^^_rLPmV<ROHHORJ8XPxi`$JJg2(Xo2N;?>k3Fj*-_aXv_TB}%;VY58s;F$^ zu3*ZNIqA5#xOK9}`$W6el;Cp~ehjrj#g7SLhwUqNn_E$QuePGozrQ4MThGLLB-%cM zf~2hrA4vB+%8JXoG9S;X-c`0gK4eP#1`j+s2&ZC2zpoNPEkmcJqr<LW_7U)dpL?G? z!q-|GPQIQ;u-5FeqLW<}lE{mpy#M0zhZpw_HNjzjZ_;^v3OL>BGnpT!*qh^eS=n}j zo#An2U8djsDwWHj2ay8TUEL|wuu%XVqSQ`D_mLdRnJx}WWF{<`3iWl}P4`X!m5~pH zRx97p!_Vh&cN8u;Y-f$@S|;GTLXR)m4U$5?H=wJno=!!bw=dYUtv~xCfDfM`<6Z0} z7-(y2Uk@3=O~7oQv6WR-aSZ%!%v&xd<@`>gpMTwJdWPIuPt2g<u9zwKvg@hkCahkF zKu$@?I9+RS;wYIj{Dj8)RQ3MC^2!*ts2~}0V4vJ7RUBAEK}DT<H-f9g59lV*H7BCR zdsUurH?{S1H(jWKAhu^RMn~e57f<a|2wJ$vx2GZ7@mp1n530X+kFY;#^RTh24hyK1 z56ydLlfs%11MI5P)sTBhorx2ew1YGaz4go10k1I`8nsxKl$Zt$!Vn=jg>KGfkjDf8 zH*7lg()x}?H>1Ao&Z`_H;|EpnR+B9=J7r>;I?;&|c6=EQ=aSpu&)ef(9b@=j?&Ggs zg;ZsA{cl@^3URj?CXAD{VG2!F&!l_w?{o&9yf%asKb+N_kN)~?DwU(%{mC%w1ah-$ z7zY^PG%buME?;sBsj@|b!z%kg4E0E*n)aRUZLYBkZ2*VtSSXoD`m{p%>BXpY*Ib($ zbJ%4ZWvLSHF>u{otLh7g&LKFi)bzB6z%b$T1Yc1Az&LA1-+`xTV9^`btOxk^3E8wS zq9;-_BQi48*<22EG~beoo|}gy70Rt!j<EpBK2`U3*$kZ$C;p@|$!R=$$m4;?QR(TN zpsyiGejw$)oL9TP-qPlFz2))PDvus+-(6NXe^47c>T$-|V?!p1rFSYTb%<Nrw4e(4 zY-@G!st+oX$S@j$(2-IC$b#>PVfw>QfBvni79OL@(gi-;Y6|sz++yzC1Ic(ChVGtT ztFf4FUaM$PECnzc@?%a#3B5eu@e7+<^T3RyR%FF2ZmP;tq=C7<D|1*A^!UB8wiT2L z^gqeMzu$<CUT<6D|B71>(W~p=7y5CFje?~yl}Z1&9cpP(Of|{)bUu(i_T67TiV%8H zRUZ=y0?chbxtLPg>cSH0zSy7YNp-Nm{_kD@)!L1qr?q6->;uM>S>Zh&KZ33iS>J=c z+unPzq`?FRJ}(_w&qL823qoMAY%LF?yG13%-L9I3j7z^}*2Bj%Q~WeeqgQi3pExep z7ISYjgnAt3U-c}G4S68?JVzEuqrE)eW$Bvi$=tZdWR_}J&iZO*`+g;CpqaefRb`0v z+cPZ5$_voXO1mG$q7ja!<CTUQL=aXlB{eywV!DBb{Q{ydx7Gw9u=tM+8wr`4ak$aH z8bH<h7WSkDK5z_Tc4I<~ilks~;HiH%-;9HLCHrrUH$P`+@b+O*9BsnZwal$Qal4z8 zoSSF$KC$3Utaw2blsA@hqxqRMtiPW8lB)UmFl`;Q`!!H5&>a+F66QEOztM0WTu;SA z_scHd!njzyAgdqQq>h?eS$&uuXl0ee3b6(6VAdX1!XhIgy2r7<`K)O=D4~w(_`<ld z);h8&^)U3>cFG@;X1H+MuX~ifOqkbWB=X-MZ~=SwxK^=;g1VH|)g!NjQoenkXD$2b z*9Z-G=6JK6C<_GZSWXg3NQxUx?*({=j@G_7ibVx2=k6X{6j7$tjPk0L!T9|V>1Uks z$zIQ+_->y2+$CUQ6A&=ymI8iFZrhGCd?Z{5pWSN3${@(TFe<KuLrP|nTf~*8>y?7E zj0gkgR`0tnx_+OEv8pht?9T!se|Bru$`m~iv6wI4bUk(*>w8{%TvFbY`=BWaz{1e$ zl{n>B{T?yJrJj4gyQ|q@>7~gW6-Pkw>2N$-4VwW+qcwwhJpSdiidmi02-GG?;XVgx zX^6W{<^CTpdHoA6LZW}ULK>p^&k)o9K$hIJsJ)RSk@2Og-9wcvL58c3&T72}c+S7y zI*h7KO`dKio)2r#9Bic5&e8ekn@yH08+h&udF&}+ZSB(ty<QukgliXPYbE0bWWp~9 zm)#(dZ@IttU;iuQ)Db{sBq9883+saVUGWv6TWxlSRu>u8&51q)FvRna=%FyZ74Z7L ztOO6}BLflwA0cFU4cx<zs!*1wyRA%klpM<gZ$;|{-zI3tF8qB88aALKgov%@c8~>l z<NW>u&1NMKo-R{sJmO<$vwq2U+!;t<;17Jf!@z#+8!{}Yz2mnNO-`dB|H<v}?XuIB zL^axcO%iK%CdkLKhkNzfhC`aE(uWg5a)0Cy9fp_1a(enKbsOpmoZe;#GqW8|?B*Tj zv1q2jD{|@C7toSGbTjj@&(R!APz*@ZX-tOgds7$fxNYOkTN8O*DfS6mEi<)9Z4$J@ zX=I%=jd~^*065F;kKY=078yReoCs6BQeg&<=I5JR6|aO{tuD~JdN(QXI#a+##>S*Z z!_X*G2pb4YBXc{8(J-B>jE`_Y8K2)f^6nbn5Dd9#E!8u!1Eb-Pjn*Lovh4y5sRG61 z@6l`N6tkHbA5CqRcD6mP%4gqGNoA5hoKcPnToF@^PjJ#ZxO%lY!6eHJ;v=79<2R-2 z+<|<Zu2zItMHCI|LXw!C&*?dTU}I-DBdP)-yQZF0O2Ic3qtxtgqwM4^X+X2=3n5Xp zfK{Nw0xCkvi>!_kw=e;PpBi{>n^DPQYT(5TS$mO$)6?EU41qMK23<<PGo?@v29|@? zUU>5RKAdGI$kl1cv~`%>eu*_gj9Yb_eHhiUvayNdU3g6@^A}i|<&BH}GqoIwzt&3B zxfuJmq8tHodZM}<$XI5&fC`!lUVX@)k(LjUw3F`^DKGO5kSRBNgNK*ejz|lnP%XPK zgB^uWPru2_&rk7c*z#tu=yKVp0E6+-&;m{NjiMI>#p=aEe{h}S;^GW<W`flSCS8yn z5uEx~(1#nJX^@kW5&|8`ocj|&3if9%C{-tWh@2-Vq(rHs%=t==_jqXQ^+1A&g+;(% zu5zbpm$;drKAn}5^NMcZqlvYoe9pT&YwvLS=C}ppFf-up(4eido(2;jRN`|Uc)Np7 zSEGp5D=bW|%2FxAF1hZBs}pd-Th+@eWjS+FoFCT~ENb&QThz|3?0bIlUHGcyr)XA? zqMFv{ualDqS{GhG1OUS}>&?dQ9o|o+c&v$5R9qYn!VQRsh~VtR)WsSxtgpGhX%#{Q z7c#%qTeR7sQWBE(^K5th)>n>+UTMDSf2c#HGa<3+@P`+aU0k@BdP<-X5Vn^pLP0hl zsc=Pk`IyW1M97gsSOX=p-$lHHG!n_L3;;ELLidh(f!d1k>Kv5Q1Guv{LG`^#GW+Ib z_xX8w<a8fbL&WSzQxuudiyI1aazsbP6!c&<dY>w)84xgCFUQ$K7^`pLnu<H|ip?jX zc408cM%cwA!Y((#uC0$Vs<a8NrrTCsWg@h4sW9X)CzC#7qLO{@Ep>yaVNm;Sntzr) z-KNClI+d&Q&B>uS|7e`|pdCO+crc=+b__0G^n2in3;W`NDQa%-X)91S{1ls<uC#^U zl7D*o^U!r<BGZdI^xe<zn(5fwbnmz7TRFL5${LYDKc17p))bF;m<-#W{qYAZcGoPt zrf=Veb62=SSNA?Vq)|Vv*5F4o>OPRnLW6fI*O(rntlyGg5Cc#Nx34O)s$|>Le(k02 zw4gfH*8Mo5K*q6>^GC@7^Lt4A6F`N8v1bxiQMiXPmHh^3f!gZEO+@LzWkQZ%bj2ao zduzV-IF~C*b9n1jz405QMvSvGRB2(1!%8ISsRL*P{0I@LD#%BYmO*v9<hoZz_qTgl zE04!ggg9P5+W?$7!LPA(ie897H97UR_7ddm=NR|9eD^uzduZtw(XpI4{l?2XKe0eA zWm!6(MK-%=zw$eM^b5q}u{~LVE=Q29cs9Q?)oB+VtyV>j<;A<P(pN_}fs~p<TE~4K zU&bZQjV)*DmM%-inQjG1H&)OhZ_PI#HjJJ?BD-0Mjs}o2JGT<l3ZdV`Ph6K=`fZ+L zy&Q4H71i8!sW(*3Kf|KD%2^@MH1!FAVD3pUEun^U(@nEtPO}V(CN~Airh;~M%Beb; zNGF}@<d3-c?A3j8eJh6n59QnGt?!mn`1&d?fJ<)_Zx$1IsV^9EL>bCspMw@5hA**x ze9{OiKB`8caDcZ^2OKLRUc&L}w=yA&Lq0^{4h$Vm`ug{djdWJ(>+v3H{XLb!-6rY0 z(WAMAuW`LsJEjEdD>qjBynlRiZY|Uc_acUN&1a=PJKjbZR)#vp-@_Qq)R>(eR5yZn z-5Xjtk=vq;G`;ZZO7aO>X%_g?FUoT$uI4A4TceAODEat^pe?ZHqNYzbzMhXADc^5Z z1T#sUhlYG%+|m+q=XX!%<I~)bj)i8d7?9EnJMy_VFT*eOx@Jrw3nrcMf{Ji?l!!EX zYeuAOAB)_xoQPKg-Yu0i;q>*olGU~NZtp9ac7LKU>5+wF<Za^bt}%E&21$REtePUd z8uhSE21j~Tbdo*PC%EO7x8J(=aJXhaw%%B+f}_0b?=-jSG~0UBsE_Ivbe~rKw^-)G z&O$2UgW*GD|ACLI#!yk1_|eWFj9bFiC^xPNSY3#Fy*LB9V9guoNM4+GROK)?#)iAz zTWkH5-GBr8E_J(X{O>K+b`1)pIj<3z`^_2gbU#>$he2a=-_oFC-5B@FsCHpC@DWal zr0V#cDy?oGg#@sw<E{&Y5YYN*KJX6Z)|?1$H%!ep+3?o`E%#9Z-9JQE^kT#TEnyJa zNbAB<BEF&0)|1QoR`Vr~QI9X8<(XXe-gA=F(-NQ<J}h@0{iC%9rXhXivHyC|b?NuQ z$m2ie8Om_~0rUGyC3UFCWJ#3ig$!=S)GPFmxd<fsKc{j@Eu5TWBL>b!zD>i9N?DXV z94+rI`jLFSdSx%>;t~gnm~^HCZT~^^{<_9nF_e*}TkoRl{?RBC#hB-sJUT@$r!GZ^ zkT2*Mdr%Q8tt9l1W=m;epDUgVx#*_#_e+}=2e!)uqu*oeMCc$5%D?EE|43ynFHX)- zidE5eEBk_o^Ua7LgQ%3%j5gE1!Ak*(=!gYikU#w=O&ikze{E%D#X4|cmWt<k44{j6 z_Q#>|A`Xa&dEMRHOA2;VyLX-+C%gPw2Te`UjY&xftG5&kzP<Gl?-MuOi}@82fi5Lx zs#d6LLUJit_1{naujeO0fDA=q{4d`BgGEXn;7eshFz@;U2I|WYMuZKhpV+t8I1s-} zMU8Spu|bx0Gqah~#uOpxvF7^tM4B84887F6(+~kf!h$(Jab&k;tGMNF;XC@#@*^bi ze;K*~_Ob|JV87^C#`zC#xZ{V6Fq&{ve+f#KgWtJ@noKLWGmENbwhRvu;LN5TPp&Gg zIT6!0OmKI3ZH3PutU!4SQiLkJdDJ50|6k`*_=;K>S^4T%XcmF({bk(zpReoa?-52Z zf{rd+`Q91T4X0H6&-Mt!`0x4t&Jedn6i-7I%>HNHq{4`Gla3GAQU24qvuUz&GRKt_ z+ey667=Qc?RWDNH!4_|W%$lD6<-z}9#{b_BQrL(<OH|INncCk!%l~<_fBO+Z^SQs* z|D*ZO+x!3a_TSj$Z`sR>G+;bq&J3LNH$464hV`n~R>(RRN{>^x|5DK80rpBA_Z8<{ ztxH!_ME}0?;}3r%?!#RS)BpIr|M4M!Dn(d1Mxzq#7sam-bSw#RE!wZdV^mG6WyJqF zb;7#{)!!;8>Nocd)|at4IvV=%>3<wYV&XrsaN>&L_<vYyhm`P3G1Q^XFRltC;A48p z%7eG!Qo+vYNmSqe+!2L>f~Q_b%TW63gkoRv_rmfrCFNLdma!eme~@uuN04!?d1dPQ zUyAGhY++V2wiP~_GV9kWH)lb`w2N0?B%Ui%m1J31hZ2UPU)D)ix=v_SJ_)q0{f4bM zR2#%lE4T`&h%4TIrJ-x*n}^;dQMqJlwzYWcQQ16+Z;t5v*$tcR^InN(11vS+xEn5+ zKyr_ucKnMCV8o5zRN8&_2^@S|=Jbm*0lJ!-KkLqkvW72%VQptinV>9d#AL6ipHCm_ z(IK3MQP=a*H*{~1V*;|!CjToR^}qc*V){S3M?c9J{P(-(MT@MDsYyVm+r176z3z?C z`pnT!-*{svSXPX#&#kGXU^EI_gxJ})p_B9gaCc+~Xm#C_N%8@>)bBhiA3Wv!g@)4` zg+!NdfqJl6OxL44Tim(O{m0K4)X6M>V8;~+pFp-&*h(Us!t#UFZd=@ba4wCik(4<& z6e8|$^i-j!f&@%$NF%wVq+7rMSV9L>F8<!4s{zQ*y*+>051Zh}=QWw8W<(-rpA)PG z#8%P(Qd!MefJZMNt+zdfnWKvQ=3co_xn#uZVk^Zj`r@DNH~Q@r^E@*V{dRJeuYivE z@*|z^D!^$2?LS_3Ovf)8gkAE>av0}t4~TS@6mFI6ItRzg4kAyFMgw`}xB<f|eR+KT zCX+)04lu)ztRj1rF_V+YsILX%vN0i7*0}_mHLOK0RFCHd)BT=T_W0!;y?IK@h1jye zP1yg()>lBawQcRTl(skocXxMpEyY`kyGw$*7I!EP#frN_a423ZxVsb&6nA(z_kZ{O z=iGP4SYu>ojASQk?X~9orhPM~SO?);<~-#<$(Hld_qMm)`c2Y-a`E1CgVzb{L9cwB zU*r6}loQ7m(1vp5WcaYHlSum-*-@A$t5rOjn+$80c<E(Ev4VlvF!bc!swcKe$(JXP zFM$?&@A^9DC?d(a>Pjk8Y_w(NXqrrOX;wSkn??iO@bz;;r2$lS{?&_zFotPvB4?v8 z-}}#+N2P<xE6<!xsf$ZS#Wk>Y%CnP=IhA~$zIr|6@5|Gfc9YGg#yzy=bFQ9om%c2y z=UK-bkQ=6Xl~3mbZ$jV!&+WR=p<>+k9Z&~$($zmwmH4H$Pbf2#sHi*k38V$+#j^TL z^SWZ*pg3^kiS11b>U{ovIr5A_2CSTbt!k+6#`xlxzG`eb12WgUYh1m0cG+Hk3GHt> zIG!9hI&Q7^IJrD=&VcyNIJiO^m3o1s*Cl>)i<e%j$-*lKD`y>^-qk$%nosSHZwl+L z{*d0#RPjNd4VF2fwfR0Pj>jz`?>^3}r42M~UN5MTlJq+kBV&&r70(~8nEpIFxG&~Y zQ6iu>v=_D~wr{TNhBaflTQt=iwyy?egx&1NknQVCH+#bDMB&+WL3f{{V!4dDi1N8x z7bXjsC=AG!Auo~98@J)qRrm+=`d|I;P=c^Ollc7h{rmiyW;h}+E+scL0;<xOm9<Sm zqbZ%9Wr<6|F!5C{|Elc3QAJ$LwBRf>rgWaLoF^px-8$2Ep;*2NMBA}$BD?D4aj9vW z{mxd%2vBSgRv=NWyG+as(q{bg-ecOU`U&6~Ai)Y;y54Rqny8<P3FMX;v^y2nU2bvL zT5bn6iwNdRR$seSI$opI=MODz(W`pM`Bh#)=~IM8OBI$~z<$^JvG(J-y*kt2`$a7% z*_)V<YtyDse)EQuMZzgBizDN>N(z!<+Zeq4ii-xFY(b)FU-Jj&Q$c~+W6Nb>pz_>& z#H==Hz;NT8cO0*!?k8I)=)>|lzx_RUzH)sMa%k0?^(k{IC@@Q@<MQKGy2Lqv7(067 zo6(&Tx<vkCQ5@;_fZJyJi?*uTRY3^YRp7kpQnV1n$W$$1Efb?vft>iD!E{GeJx~Go zzlYaFS)8o=@Q4UNNEjVGa|^*@hbas3COUCs@zqY`#aI8vcK;8Y{_BE20g*rI=h)cT z2l-eoe`S#F55F-MN_b3U%vjYAc=cJ%JTrNFmB?%082u|`Y{TiYBcR&6zO3dnzd+Md zgY}!_16HZtj`@eJV#msQbGJEJqIFV`V8;nP=!cgLVRhGy&USMapI-HBqo$kpCNG({ zi<9-s^scFCgJyQ<a`OrQoJ#NNvlrA&zcNlJ=BB+vxS~sB$;GQu`N+H%?k@d<{;fmt zmFy|=XkG2qpQ3qNB8xb?F7dO<93ekBKi*N&H-*#eSDJgfySK+r2aw(@2+1_bAk=<* zb@RlT=tR_O<d1>v%Jn(Ij{Vc|q<+f7N~jQK2QFZsByBL#OPwBzIuBwbP}W?3)wc0i zW$WSY%J>mvXCtAnpWni!jq~{iq~;DqoXhx^iZJp=+}B^>Usu5Ks=NXIYs*V~#r^6f zD^{QUznlE;5WqnTAq~-LeaATw$yfT)R9dvoHgWwv4(FA1_<-xP`{9v-w-)2L<X?LA zM=>V*Q82_L*ZC0lb?K{LcgVQf-|}CdYs1%RIIC07pf2)6(Buyc&~is0l*m`i@RSv{ zS~P0VHPP;c&Xo}yg+fh}|3^Q^n!q`2^HAywgoY<~ew)AuhP`0a&f!t=9o4We)+NTm zKupPBB3^C1A4vXB+5i8PqXC@k4AmF*CDJ>Gil^qd)@+;V#wxqF81p*l_NTQje;xM^ zKVm%O@UXu?@?VII<MbAt1=Pyn7!f|H+;LY4>As$NhmY*a_zrWj3@PBd%<F=@FQ-pK z+$sM`GJ&m;Lo;F;k;9RQ_FJ)5nPNN3QcCiFt*F#j-LF@fofZoJ9c*l{111QpO$ED| z35AktM*5s+iXkb65>^~^v0;fl@MJ|^^;&;z_5DTo#{|+R?YWoB;$^x^#|o6&N5vBJ z!uZx|XX)}OR&8O__@a`ZLu`7`&M}j*|M@YmSFbx%-bY-KwJ8;^m0yw0t%kIS{5V>W z#^g7G_lkb?OA((Sq%+G-&<F+HT2|lJWedjT3dO~h{crMa;`QsS@HuOOz5P);_|gfv zWHCFs)H&Uv(k#_-IH$pFfq$+1&u*HHd(Z2f;kagj8xoS&-ylu8fN!5^o+?l0APwU! zcfT+hbpm5z1YdgK>=jm9VVS*uO^=@u@z%b>DbL*&CSGoK?EFnd8QY>`C<B6IH%ivv z6kjOpX6~KxXdzzTo!8VSh8nZyue0aofo%WfaT6cFXWrChntv8?-(_)GW-H!xBkk4G z8K>${t04R9^Ox9gve?_)a}YkEX-H*Mbf+rS_3??;vB-$8%2s7*+YRH9%3muWC-(X! zq2{G?RinWB64n$Owy3c>uT>L|hlnsMNRGn|4+(Wub+n_Fmfmsm9A<YYS>(xo`F7}% zFeKW%fJo>2>FlGWV%o?$iRQ)REiaq5y8lg!fv)9~ud}|gm*J1yLa~|FE{C8Q!yC2O za0CfyEp|#t*HhWWCbgv!YjYu!yJ_EWbN|5&4C(<nsXY8*Z!96t13HrbGG*ALh)LlD z(M_^M+}meb1Nr@HPIcN{czelkt!#RWYK^@><G*Keip8i@Jmef#Jlif@A8fs<>m57f z+=cDa#-;~qub?F?Yy2m|E5=~vj3yBse|JIDixh(WrHp~1i`@fd+mYFPCHo`m-d4=@ zj5P!Iq`A;VCy=LCgRz~M$jw0G8QfiYPN+L}k>@+7lLjzKjO9h0-<rqu(ysOPvaP!> zkQ64}Iy_6dgvc@=1I}TK!tIU~U1KAmy8iA4gccW<*~_;l`7z~wCqAI;ljiG{(8c_# zCb<k4l01z$f-Gly$AN`KT6<yNnFcGsq%f+c*iB2vT)vWNFSNFUe~tTEX9}97?%Q|Q zb1A)7r5oqPsu^4C?1=5N<UOl4fz2E6FQNA%48Xs1G9*&*u%L&zU=Jsk_3A@E>-~>> zT>nc?%cE>0Y&=b)#a$C0a4vlHaf!6AACIaA`b>n)?gy9qje?B&FCU-EcKEr8HPPdG ze$F`b4Tk>Ej7IRu3&bD+L_17FaA$broe5=_v9Tk=f6+%1rUm>8{}3D;Mnxqs*HG8e zqTPI}E-?`HZ@KYz@%on-u|jOd`&@Y|XS*@=?jYI!OuJZq^gCGFYA)?{rmPj)3W){h zA$ir<QbtinJLoZgvsnx%Xw#Ho{KF%l=gnQqv>W!CS{fgE$H~VWo9sileyEM7GTOrn zK?(7ZWgM@2heq+$RcQLxH@B0sk3y02YFct%MDP!Q+1CpOcWVx(jYY^i^RtibXWVSA z0Rum<ru;miv-u+a89AghvF`W+UBk-M<!2n#<E@7SA+mhZ+5hl<{mi9vP)GbqTrLK| z8eD?XXo2m}Etr4x3n?H;t4;@Y%Nu_{!$TI#wGogDX73EcdSK7LUERB0T4h<YWc3DZ zFI=AFhc@2m{l1=e<~XEkLwd7p^PNLf1g;n@Lc+oZo)a?=K!y`q^XEgboHRK%v*Hp4 zqecKXSnC;pB_5-MT2fsu<?4z$Jj|%7wHVwS41al)6`8i6WmeQDuNT3>W#fa-MSuIR z6vh8ka1Qtg%`)OT?SL2fA)gS%*khKbN$nI!Calpq(L71f-l5>gbVgDAt#Vb^?zDc> z8*LMBVEb=a7H+we=61`pdrDFMpV*#u^L<y%hlUQH<qP*zS8~XkWYfR&bnI2Voclt6 z;Cy@KQM9St)js{`F4?{Z`_!T^ltZ=Ua1Zsy;C<w@fq{NR`Ca)@xbqJ|tM9&7^W1Zb z4W0S8Y{e4iRF$F_OqUw)W}h887ZW!A>7qg-3&@v!WhTS&_P6V;(KD{Fpe@s`9qZtq zV2pzP;9QApMH}-d=2gaWZPL$6onPE;1%K+-?I);G>H2~&)yCfp4w&}*z^5LBr=Xxk z;y8;4kAVf*%!0$eN+V#G(FQIFnomrSQ<C46S5``yo4<`jLar??csI#$_CZCV|7)kU zi2!{ckf}%`VgJ9ISQ`$2KS%*U5g!GJ#j`A4`dDB+JeV(W6CoTftgZLh=bQKD(r%@> z?engVD3DmmbetzPv<()do#Qvyi!~hwbwc&MFD7hb%E?k9D#ONl$>fxQY4@I4G4^qU zc8gY$?mD_EFi5{t&`8!9?Dc2BIn_MxK^Um*WxZTfY+!k`cY^Fr49gNCb|)5b-!p|2 z!hz99`WubG*}F@r6GiT+P{?vYJUnl<5ZhHf%r+rAQLtJD_CA4d(20tyfy;^#+3XpX znsJ?ZN-nx`9qfDA;>$2niao-4=|ps0IieG>`<|7G#{*%{(k@r<)3r_<ugYmlO#UV` zhHXUYXwiDDGY}~BW}pdL7cw$A&}0Da<n8DHZ(i?LW!%4ww7mEe+V%wUqm8wogj`2u zdtWqKL)Et7-IPaGJm1F38U7RO21rS4lwiDCd>?;jdvUg-%XFrtj2J5SrlZe9`AcHB ziS(^AwNRygnlKa2Op}q1EPSW0Bxl056o8B*bfy7?Iua-61K`<XJ@1clf@d#L#&=aZ z$sc)JlE-Tu?~`3w!Xp&=emwhrV_gp9LB@;x8oLwU-TEKShQD%p#m6a(EbMi}yp($v zKm7}%@WPv6F5h)6&!pkd{2iAEWJ~{8M*iwz@L`?H!}gi?aVwdanXP1CrT}5)gZMUp z^|AI1i@Mv{5{0gxJ~#6_O(iASk3a;>#DvK<_fW0Jh=$1>RBSF}a4N<xvTpaSnE92J z=;1QP<CPYy!a5!;Phb340v`O1&s&qsp6@PjP}w96{vntC4FmuB+y8ZlH&IMfz7?N4 zAAjjwh#oN<m9Q|S;>?p&W76<%jY7sd8@B+w=y5UPrYb2*O1dDxV*T;)*(Z4SB|ipj zSBuM`&c&70)q^k=05$UEKpc&?rso{J@oP*Fgs5x2m#Vp-v;TfD{=@b3x3_3$0d`EU z>UwY+ADuVrN7!px5FL#vtS+^O1o)fLfK>p-=TguBjg+awSc4gL<ZZFx%ku~5?9or$ zo#9G(@Z051XT0-^Yw~JN{6QuBfQAAsO_c2ab+P|_6<`jM4Sc(l)a*+!o>Rq}WQ3Ar zOIMNADQ78DEW(WM00MwTMW{bb2?@2vn(I{z%+VrY6|Q*x?}F%m+{&1Cf+a^e!z}az z%iO48hCTS{(}>ur(qn##f8?RAgOdeyCkG9pJmd3$yF<U2;GCqS<b+r`+o#Xd-vG;j z$C*m>)n#10e^eKg%Bt<fVY0letUOmYk%XZtHy1FHQr(l+KQcKnvGHeL)})Rq#5CUr zuhG8T)@Fh_5%hk_x@&)7vWv?4nD`ejX?VMhjZKIe&*9-Ay0qK>U(|)h|GLff?g6=J zbN)p?cHG&iU-0ZTTalc3vq%@Fzo#iq_MMeT*%6`AvNz@@p`z=gnGH)7X7Ni9*V$$s z)Ir+fy&t_*C)@Z^@V@SPpS=aMtYhH?irtaphJsn_f2tRlYM&4Yu%ml5)nqFf7^JFd z5JtCd5b^u%ti^KmiP@c8Ssd=9Y|`+u#C+r}9hE5d0YOLncc(whFAKRpumIiN-TQQu zKZ5(HspV#j$5K`&<a2|r>awyPODf6+{9kTxPoDcv9S2vt1`c_MfQ@KJYL%3}w`Y5| zy@q7H)z5zr)?OS^5EQTdmm7PR(t6dKq1&0swr5bGliu-@2Q0T!2v1|J@q;c8({*~2 z5ywgUUQ_eY+WIiBo6JMTs#;c++M1Kke)Y@1&FMYP^TVNTQDw@y+NuLD%=-G<uKn<1 z8N(s!lhfSsfN$KM(epiAda6U1OU5qob)?SbOjVxE%GDBKJBK$G<I(p_FOu93M1&c& zP6~kC%3&El`NmRP&0RELrjn2XhrKx~@9&hmJ6*K4i;=Tpwu`S@grj;1QG~S<`6uG} zR!J=dmb=hzPBxDIZlvIoQioxIiMQ!`cmGYh>r+iY;l-~bo_g<e|13meDk?>agQhn< zTjxIIO9p-`+4Z^Z4vCtwXaPRC4mN9<QHM~niXwJ!P2Et0J;jx!B)arab8};B`*H!W zu!7oG^supouy7u7oF5pV@JfDuuSM^CUiU}^jja#ni~&9my<h)0#0tn8&E_Jzz+;v0 zlqoDNsZ2EB4xjxF5^|4XXZ)20T1(EbWL~gJ6UsIqvnl?)SD_Qd)~WXumOt>=jy4`{ z-*qKeHN(ThmzUd#*56NKVz->`@L1;BnCRi^>RLiyE#9%SPM;X^eyP%+t=qw%j`=-L zV;F>SE&v!7=}WjH^ySN!5SzPvs=o_j*mVF^x_HSby0}3k65lc%^ubpCJ|V61XMRfF zmC87j%gh@(w+FN*Y;#TFiy7d#yXOS4RBJPj@T;_~@q7P1joKS)W19E=T?hiwiDgZP zha*Y2c$6%DQo5LLe&`v<DB>#OeYrj~JF0G<T`Wu0oZr?RXYN0n_X#hwy-8zVtt+p; z3!+_rT)!Zz=suhG`#LDLWOYBaTTOs^oEThOO&BYravGFTj4tgWT{2`SwgRnnwY{=s z(I0P6a?9MGoLjZPrNssNyFEKR?vHkQoCQkYrzBeix_I>!eMVQB*EZl)@#eNJ80GaX z_8iLD1s$4FUHrESCsw#hm2TE?sw;IepV|9y7+AgCtEj{Wpw2Xi=8#R<*w%7zswL~w zN(OAnMh`^>4wDFGR3RlJgt)TsbFmO_zaJoH;3c*`upVHHQx?^t=<fzb<GhxUlcN$4 zSVUmlWmyl7DvA@M?=S18a20a@omWtSQrfWv003fT6f`#l0Xx!{AJ>YVvgA|eVo$@< zIrZz^s7`$U01BvSHa5i`QO+D|IbTl?3vyDz847u~YMI+$;>Pe_Tw(!;us~Z@{oGZp zvBQ%NMAh}pgeuMrriJ-Fvx1Ybj#N=9d(5!joXP|44=Z28cN|J>xdMIk8r#LI%C8WU zz+7S(O&~d2qChi~5o7b^c{KxGvY6@ba&ipRqqs}j+=gA&4OKf&kcS+j-S>tjOSM#v zd(b9IM$W5m&T~aW;!EY7`o9ZCl}NwG`3I**vBs&;xh<=>-w{sXWb=l-Nzow0+p$h$ z36lE{&~hUGQy3gkl7A&obOcoe1V<XciO}Bm3NJ2t(yR+HgCwsO`=2WEU8ik5Pe=Gs z(dUA9m-ZMa*7&`kW9y!*OUqqKZ-w!)X1_2^6%m(KEAkQ4M);yl3vgFofTu$<I=^LG zf$~uuV-1RyETR3g*eQk?f`Zx<yo|(DiTUjAE-08LRMGZYR^bAI2R;Ci_f+^;T{FQS zjMP!4uqZP*Hlm6piLxx)HdoZXKDT5hSdH}ds`RWrnGFQK&&kLFAMH4%?~dc<E4DvX zpA}F)S#38|g&GnW7Qf7_C!HcrkNkM$OGr-G@egVEFUjadA7DrGYDyl@H_ZTM5AA|j z2hTdF)Rr7JSOQ#lan(04@NlDLXk2e6&wSZEjVS#%o!@K)?LdhujovF4vM(17uM^|P zjP_wr(-u;)@(vVOoo;pp9bXImN=c^J%1@a3)b}OX)ZLhX^E2kP(6~4vbmxPkBZFv8 zJ%V<6DLoDoE5&({y1F!eN~KoJL2>4UMGvj2=wY$vK@JtYO_qRlLQ|iMWIs~O%0XjR zd^`YOpgGPVmM0~Sdj-5c09~(UvunR5vdF9Gc&-7}TDQyDXP-Eb;L0{^XY^TDcC-i3 zUd_uZxO?fQ+|xukSl|9sq^21_=95$W9lKma%uph8ojUE{PTYp7PA+?LnU&Q94Vt@S z!eO+|IpmueIM^@8C=un&YC1U)Jb+JstnP<*`5u-fef05xr!yw?8%CUQPm5-?Gyxr? zFCP_IJq_HgJ1-7JN&<_Baj_PhRv;%Cl8X_o8`VbpWCv`O=QN%0qI+M~qp<Uir6rS@ zJynYon_Kxx3QIOtB~|*CkgU4351-n8J^kqYdphTz%4=hv`o}oIJ$2srWSe<LF^Tu^ z1U=hD@Gk`&waN3xbun#bB!Rg&C|8!K$$owcl6Yh}VU4*a!(rdKZN1`FaAbd`=)u{q zkMS)8hSCoe&E+*nLg!515->t2d@*Zis^L7};*?Z^#AS7aWiJ&ZC9Go>BN;hpd-U)$ zW=xy<N=r&`Yh@8QKW($qQ$bupE9ERj@_*avM=>7NDuG+dDoayac^?kHle;GKZS_Hu zb3Bu507nDebyr`o=6)f&xX!xX7sT$T(MJ=1i$>@j*fc(x{H}rl-qkdTo9U{}ofJ;& zACNV%(!k6!BOQ%QV9sIj9v;IrD2<rJpAlNKpu2L)ZcHB2h`?gd@Q}SyNbw9J|6JU@ zWwVny`;kVc#>5%0wVkg<p%E~EdPw6e<E`>#>E7C)@XOT{y2+|G>2lL?)z7V~yWK_Z z&-ZLp0)$s493JKD)10!X`ymF5xR{#r6TyW<NElcIHcOw^7XruHMpVCOQ*F}{`%Yth z!#xd;cPVnL2OfOU)1zUF<RNFI#Wa0aL@v2@SPz;OzA$^JixE;V^O4RFE*w#1`VCAt z`$Fr>XYKJFWd;K{!X)P?pR5II815I|hd_`&JPk3lG8mA5DZMRjXax|tW9L`N8VDvG z;U5G!27OXx^V|cnN|%hH9`MJZxbLz8o&KFi`*%2FbXt5!l@#GiKPS>?33Ft?3~F`P zBCr4gNbO9e9eCGRQ-a$>Hjn47@5s!FNp-frvPz$Vh?(_uia#Jz8D4!DzPF)I^-?8H zT+am?6N|Vz#v6`8bt!1G7{+1)OU_5+ndQ-Hun}SvG(Ya9M=CVAv+OUs3QvrP{j8ix ziA7eZ)#*ecn$Ck)oGq+0eC#pRb3QpFg!4KnDP?F*AJs&uB-OAY*KwwW?$#xWBdek` zHG*k%PQEGrlcugF8<y(kbF&hq1_CmAVgzpbM8ad`gzPwxc@+B?mtK#M6QRoX(X!U2 zai!yv>kT3WBV)N4WzAHL=48a2RMrDXa2X;9YjG6x*}u}cvLTnEXj1Xf+83zH)6qq2 z9n_jI<uo%h6V8*5pRO3i<7Xf{P#;CcxS}c%nxajos8ERBFvh^pfw5^ywM2zzFD9ki ziQ`5e7CCG~HT5Ys5flefco2Y+m`n$Mc<bU+Ur>ND+t~O4BTA)KG(L;PaKw=oBWP5^ zTrj?DyFg+<USB`R0Shw4do|zb(q(LUQ3Fzy&~^QSnwL-Y`=R|NcyEmdv@RE-u48BQ zp@bj^936>7z?GaFo(R?o_ztr7ZYjl3%(A;FRvy$ZtkIxIkKCGRObvtDnwM^WVsW3H znW1E4l$@gbxSFYqmb5k^*Md8g;$YmPcBkd|<wt`Koh}%yfbgKJj&skQM}|3M@w8AZ zmiEVgpsRf~_+zTQu*GGLi;>FPy#Y=mIUWp>z|uF{4!@hRGetn`ve(XFv%0N#K|rWk zHKbqn0=xzCECtS@0piueS@!%Uo882Pt3-3jAOe2h)Modczlq-X)cVj>-Oqm%cDX`8 zQD*7MxM<o=pY8uy!TEUJsdn3s`neY9OA5IkqkKF(H0GDDkoIr2Vj?v#_?iH!V{!Jv zW`#s{qZXs}5hT7Rr={$>VP29*l@B4(4XmNJ#52fgLnX6k=&d73(3GK?5PPR-*}vsA zWPe}qEW2;EH<C%LE3HKthy^%nzxgdI+)?rBs7YQZWXw_9vDw3e(ynD6|MDDBpF75v zw>%l|SX8_DEtiFTuR>cvJM=siI~J?(881e@|Mzs*u%1RH;I%c`FDfE~7ZWbO%U#^Z z>!YBv>5&0}FW*$M@TLa`eiI=(?B**tKL4S9youc|B+P9-uLV{t=toRWcH<{vMA~<> zA>JCnsPakNL><xY!)u1;hH`R+w-qANk~>iOo;cob$3=861hco-!q|(mS#-mB-fxB+ z4Q`YjNJWe9r^oSabr<s*ZFZ^LAb&-Yao~n_3f!JBbU4mhODXA+VTraO*>IGppg{KV z!d}|Uh~Js@Z6CO6Z21m7%(`-d3rI}8VE3A2xP9(71)SDv74YaZSG~ep6GQK6aYHz1 zwaGh(YfsR5yq-<=@G}tQecC4ey!T?hx7E>D_->e*VJ{FMe>-=V4|5I_fpiNiP=yrE zZkNm1KM(9LL2)<(W&=5Tw;To|w9~l3Y>-=b-T~>bEq^gVf{y;k1d{d23XlIkIx~@o z=tA`R+o?7gO+Su@rTlAUQjCxuFUx=jRo5TNMp|d%B-8g>Crq^XXXAm5cfS&wzV}Gq z=Ay4b1(KVA753c%rJMMfxU}B&gW>Gmp0*=MWJ?O(?2n-I)|yTsck~1*!cpoNq-3<D zX-@T@btb=csGdu!Y`Ft-W^Ly->jk1>noR~FtN1WWew7m1r&5a`h|8=Kt>1S2qoREZ zfoAGc0)WcC7L`a49xIjrIxZDLTs`hH9<F|l9AzFzyA-al=5=FAC8<g=Ax}pd#*rVI z!R>v$v)%QQVZEj2uttE->G9*t|0oN+#`S?!9xDuaTuis`69hi5i+nwzv;XS6+&))) z_+zr5zDxIFcs$Eog{s6`uBf_HlZzBszZtk6jOmIf@z7s8sErNSidmchm}&R8MTO(t zeg%=E%w&`^Fv#7(30YZzYd>FFrreL<w8u2Ki$RW0`M#CI{Aq6Kq~)T%)^*uUo~bA4 zPzMk#O~t{1_H=K)S+HH4#_M&ozSszolQ0JCj_L=uKf)zN(aXFQm+!Io`IR}-ZCIZ2 z9D&EaK}PymBpfJaqrDiFY6`taEsAA)6^SVkiS%_UxSxTJ#J+0vtWBrO22eL<*xc7( zc%;dahlBHqhPv-#4jLw8@H?MO<-$i9meb)mL(jJ%3$><AfU^>QXd~Y`k8l3=@l+H< zMnfZqH<Rb7{q5pHgLPE6DWfXQZyPci#J$ncHGb^@jWiXHY3)@|bELlL?Y=W`wUvZQ z4h<)p&IH<us@3XKc<G)@z}L!?h2$|1M-;@7pH)j_Ri_eS1*mJxYE`lHjp)gvB*>tV zg)ewYPD=ZVrIHyr8ttOn{<5$%-(M8-_N@$UR%D*~t0Z!hx_~$Lro#niJxpa|L{TTA zx@jGX0}mQhf{fV6MuNOs{YaWQq6GYoOJ;yV0sEi#$SGJ#)p^A+8BN9qQ@`oy8LuLK z2gXxxOC9+>Iwr=)vo6=m>pc+dLW2I{L;L%X6AKvE+}S!FO!<|;#v@*B^|=4|+A3+U zp=)eC<SkQ_1Eh>n*l#dmpUU_?GQ5mGrE;V<!e8eV_e>N9752OmMEpCD;;LAtC9T#B z7O!CId&tuf@IDm3V6K+6%jm1a2qcW}aKiJe2*d|$t_WB14a*i9RcMu~X|i1qBiQtW zvV`0kUMn-NYX^}jo<^0N5u~*+k{JS-2aXgX*^lrx`OO0%zWi4l5h7%BJrExNY1X3y z?@lGIsf6s&cM8|1?JW@x<I>09*jv+N?@aIe{B{X6>nHWzNBp#Mc4T=zU#IbKb0byG zN(zkX;>D=v`*pEeggI)c9lrIQR@h-$T{`?N;b*LLg^9&RbUa|c%nN4GEULIHv!BPN zc*TNtfJ(}5Q^*n~kfE&GcU~FWBA%0MTZ_{!r3H<nE7+pN?kJO&x3sGdF*Q~Hl0bPC zI%sM9RK@8-4Rk8caJZ;3i~jYouWCxiv*nlaXK>bM2dBjAE2W;eYO+XF-6(c<6&%`| zh{3U-1R3_Xmukq$TZF&OyDid*BuXCd45A$$WsY$sqeV<64^FFD2ALN7o3Elff2oxB zX4pp7cv%X3>}#C}ejU+#5pu<E??iZ#ogL!OHil&jOHX&#XV@x)Hf8Z4ZJHR%XME20 zC7TNWgA0PS$YI8i7dSUjQv@PEU)?(iU&gir-6icG5A!Ir>I&hjt68M42QVkE;5RKb zqviC}(_Zd)H7jtRZii$%oMm!nc;Hi&KJ;!};<tk-$(lr4kk-=;qM1Dfm_=kO-wXUc z`)_<aEAYpOjmxLuLi1r(jTN8iR4x_x@J6J3V1<RwAF^<Zm;FkAlQBIHCGmkSK{;e% zSuB!4@37X?8fT2u!gu25m{4lt&*`EzTfh49<JC1D!}zOAzZ9tT(ZWhGjW2(?a5++Z zdH4tcD^w!;ULNR~-kBbz0c0EUOtMEWvD4LUd+;dftyNx`T`V+PGd<tj3;oir9|~7? z(ap6;|7AThL|tkrdx)9oH_WZ~r;#hVKaqCmW_x^(O04TwIH!7M?zC}KN>xH<8J9n- zK?sc3a=P#E(5C%)4et}#V((Kh!?PP+6i!y0s3HAUp%sADY-@B{*=E`h>}NX<>Km-z zHMO*(fbe@J0A3bAwQeWFI1)n-zqC8n5K_6Fq3*wrfVtSg{UaLNa~W0AVu0@@u<F;G zF@vwrHe~h^!%$;Q8rMgYHOveBTTVIJZxFHRzFAlyP$8~Cw&w|sskMCNRB+UWWC)|p zYKa8x5B1DCFIaD2ud_SZ0y9kaO{wLQyl7NPH&2U!a?0=}7Rf@|LB`nNgB^`+%ZvUk zWr2i5ELZ|ZZwCZG&l4VgK;k3d&w&&*Qm8LzO`GUUsb$Tbm+VlX-3Blex<Nr9;+zQf zyf`xuGRZdDiBkRDpSs>xm)SV5l&BMB%>iS5x(A1cGZ7ul+4p$vWzs_3X>Go+bK7rz zV%F&-%@2jqzh+_7zEY2CK~5#AUp_Un=k%>IU+UCgQsgr5Q5u-~SZnshj+Xu^MgbJ$ zq!FMPJF^)%!YY2c=8X(&ziPVUm0wD><=t3~+uhOtwE8?Q;(1&^<7$Pfe<cBEmlF<7 zqp(93o$<EokjHzhIY}EKyy%}*?!pt+@o>b)o}DO2Js)YN4eyBvaR}_T=7y=S88>~d za100k<erC?k87W)Tqpd#T_-v<-8=EAy;irUP0HdZ-{$==&?~v$+<DvMEd3P^%4XPm zNb_vVwLS=3JZDppma_pHJb~5(QyR!zMnrI~v@Dm|y&-V&FBDEPw?#s00@k`H%Luh8 zjYgABdVXh~{BAw`Tqhu}|1_Pv-UZCoRnDqp>oXrl$qKs+Ijm3yqIiDgTBcleyJmkp z38C?@v!-~y^Fs6U9l^c;rs}GP5asB;PWrNaUH@*gZ7(i~WupH+QW(18x@jeRJB%bO zY%65JvKBE-ht55|8d@X@9N|?!c2nPIjW0F%Z7GboO*!VQod$eg2+?B1iDG7QOB#t1 zIrDf@p`+vx7!XEYCD#>uI!q=O?lR*u$mn{L|E`$gOU3EJ9$8|*sZ<Wr)t!7(lh;P$ zY*CeF`0s;tLuVAs?R>?DPG>uwzajyo9$yT~h8Kensl2H;T4&)L8xYdmzVI5wwkw_; zqtk9}CBB0NTEkA`Qy|(M@BJ}GxVv6l-gEY!k3v&pok`gXV=nraCX&aI$<mj-&V&ZH z8swk)bR5$><>i~S+HT`zJj^!jE)zX#PW^l{N38`kGJ|H|YK6BMiolRF_UBJ@zExc4 z4VVX^^<g7(+B^%N+A$RH_O|P`AENq;0!pwq)hdAFg^-LKyQo6D;gU6eV;{rEv&9e( zQxHLsqDp^OYBa}qMeZkb*Ifd2{=+l}%YqBG+$j}gX?||;C61f!&toa3_i$rj3T|6B z_Ep`^<uFc^GECuXsHwy6QmN?1{5Dp*p7NZkUiY=Na3Qhf*m7k8W{r?c0a_LXTDehv z&XAEXaHGs~Pe10gl;QEfAbMuFJQY`gLAM3k5ohhF%h=1@R?{hnBPBN!{R4-!i+8o* zxK=cu%ulzcKJFC?+~iQRfhc|^1b4%!Xt{NrkR1PJ8G|+C9(IO#3KNCj{|tHmkDrYg zZdLNt&M4-wgy^?_a{>G!T}W=c1xg{lqYKG(BQtd6n0|Hc(jGU2LgQN!n}8T4bB>#= z`RF|VIjW}S2ceWXW^R5vPn=+cgQ9x)F)Ar7TSf?l;P7JD%0XoBg*B~lfmP#xnwDOu zzGpuy$e!+>th3neezL?er@$yP^C_r&AO?epGG2Ct!^Hu&F11o3R_pzz5gr?gKIn1q z!pVy8sK<e8Em9pxZQa->Js=ygkY6-HgjWQ<IUUR+2a=Ys?|g_DZG(@x%BqhpIaua1 zq)D+ssx|0)$LKaugFG&@s)b&PgDg%JhI)>NN9kQ>d8N!T2G*su-WZ}&?EmhXQ6ndf z&zKF<3=L+UvFSgFI11R5F^*^tXL{n0JlF8bS?fFXg4e7&zNI7tW5wnK`}un1e*(wo z)B$N`;HJ<3pWAQG6=9{_II2;KOJwr~t{i1$W#$<TY%y=s8fMHgy{}zrUtz~&1Z(Dv z6UHM6sXJU$4_e@#sVKSxCnYlD+P^c}-*_Gf9Pa678a+!~j55mvZ?rY7VmS0ns;^ub zKagwQZ^XZhvU^hZmH#fouYKhleJR5X4)6a?Lm7H^dErUv7m)~B#H?{vQL|+&(~2Kr z!}(ege)JUAg%O}m?M2g1Rc>z&Bez9~F`==EpHT}jcE+n>Uv~6;5#l2#7d)>7jg2@L zT}@vfxtWcNzLYiiXU#ASYt0d|!sSs+`866Pc9<0+BoqEQ&mbeHU6!HLn;dGwuZ=CB zOyQFLaB+us@mokW&<wDi>3T0;gkIIv`ue~GB%4Jtt|D^7xf_n5z`|kekA{6D*Bge$ zy<E?tQ`Z9&0gDfp<4}yQiamm7#?yl@)qSfK#ti*oHVzNQ5g$+%%wC!FEM|PjfzN8n z!^ruG84kp`twu-iLeWDC4cj(vU-X+&ywYP~1g*8cv8BlwjW$SgIo2{Y{>Y+kj=a}; zFNnAvp(zu6mDtv4J5YwR4_s--8SlI;GA3kWPE7QQn$3!!B##=bTJ@w{)1h2%@*4H= zPa!BDhS(hydbVFYTYB6CjTf>2VD!jb>sK84Vd-AJ=Zku#A~tJz#M5*3z88Yqr<bPe zxZzhtayj4J`om>P`m_?ebOb-mmCphDWC6LQUn<1J&QbjQU*eXuES8YzMgGIX9s3cE zOLUb!Fq3h`*}{Lt?+(5mngH4_c^<kg0#+s^=EM}&xo^*1FmbR`p&iJpd7Q>tr`6Mv z4Wg>_e-o`_qw0(Ly1TXgeq(dIiK43vAcV}wLB6^uyR3-$OHVm1+}O|kNt%kV&iueR zTF^5o5#1<VtJJ{x2_9t>IOgr4f%$xTOyS`NVPytv%A0@5qI%_&VCB?RPnlYgWF>sp zVSVdyXO}6^iC#Aa)c+dLvF-R=AnLIZ(x{cJ88a2R#0y70OARWu>3K2<*l(>TF0TcD zy(qdI++A_<F{mMB^J^J%h{R>$lEHEHI2eJJ3{?+w?4biVAmr5jg1X7JO9jo`k9$kC z{M)%Lw+ES7X`-T7pQR`Al$+M)hS<rFw)dXdgLmQ$_C|<x&Xse7$7vBR96X2KQYuF# z3+{iezm~F8uEb?H`Q;!_ad+qnlwNM39_zh~*@3dDKkcX(3NO)Ii1`b6(-+0q_!{p? zF5W{E?{vRq>4ucc_HBmN%aSYZzOEEHNn_5e(aH{UjvRfAy5fV*4R|6=CDAl0-LCfc zay%{g$wrw?X9`=tvI9g(skArYcuOPj_<Y5xb5)@s)oyrCb>FuY$rZY_kPFcZR=Noq z88E#nl5DRr0MlSudM-Kqr;7h;7r=_CpOSpwolDDcjwtHn9yrdgzknXTf9=pESLtUm zr<5fU;^frY!)rY@Gl1JXuWc?sgE>nFfe+>^FEFP>cp5u*+WY70`q{7-!qN+J1~DF1 z_*~<<w`t5%<@G&q&W>rKE^Ull)-<|;Bp>F<dt$YnaVd3}<MyvbI=C|BDH{o==(ye} zXjX77(;e{2wHAI;p7QW)f7!I8G+SWQ6&NBtrF_?X);c01{No{WWZBV#Qu-~7_v4VJ zwiQ-~vHtu)T9A&goSG4Hil0$BEvEy{u?}aZfdMPJk%Gz13S=9l2p=&^NI+x(rvRs} zo=-`*`po36lB>nVfSU`kGmD@h=Srt`RA0%}FjFs3XG$^UoJ!zu4E$ULHieOLdOY+l z%IaZbVupI3+=GG6v#q}INK7-7kc2{kG!c6SR{m3NDlgU7gA8>tiFUP(UQjQ95_W`t zLalNE@s~bRy7!H!Ib+#TJd`d|e53DBkHe0tJ7*BG8c=lx>mmFEDxyybFkm%0Z!(8> z;czHF9UVfBGXd`eW}AT<&Gd{Ky|!TNQ;p)_({nBbmgAgmV+4bi-8aV3#VAsepZ&d0 zUz5$d8a((>d!5F-lK)13EK`xEC4I$OuBi~ulG>+s{3{}7#QVmeD|H8N@Y;3jh~JG_ z*RGCvD1l|<up<h)O{)(n;Z?+%H`VRjQV=Sd_*ZzDkCbw@%UqVbnffmeDE>=CM-|n* zi0y&yd5=C*68kNwYfi>sOiaw<6CwNHn!=xsMf^u~QRDS6O3W1vD&YlhUH3&8PdQ3c z9+MuKb%&^)$*Nf`>CJfC5uec6WI+VhF;|HY3y=9v*WE4T@y48|EeT|)XSp1YNsjMA zmPN=C?vO>~l@7x?dog1BGV;d=cS=^IQJ)g_@huhyttQ8EnQcGP)I{r?jtkn6AXsj$ zN~)eqmB^nBQ^=(CeD;&_qpN_lZs((eDT3&r*RR;z5yA~o*LmoCi)UmsidLYZ$C{J3 z`>O22kZ)H#;x^}ToWEyxgweoWj5G10q7x)TR|muxET8jKuA8Y9tE`GGlI4FQa6O&# zg3Btu>VQ{PtCX?s9w?ZyDbnsW_HM7JZ^99IcPvz4qWI5_<;+i!CWmL>!={R#xi*GZ z$190(pB>``A=<U-@s7)P@E)7IuYK<?E9bjsk$k0=EBrSfTdq%E_AGD5PU|}mDm8W7 zCRz*}NeM##Scm`KqA=R7k9J>i%X;85X3j3^GjH4JNk$O6fz9_%4hsh>EE#@!`g-1d zUG!G~eOjSt)K`S?zl~thfa@wL3}badpenFC8c6qi5X!|)mhf{5!#1oJY$h9<l?(uN zF<XOu9j0?%g&)QHgj?R4n5;?pY)7rP;0C1?6qGL8P?QN!zUnc7x0_Kw{v)pPkv!Pj zAJAlgazP2WG?r10{A~f>C#d(vDI@%8_=9XqJG^&&9SM3DvHv&?@dGhd9p-WU6C5dc z?_pTv8!LZ5K54W!792UA-)PKF>u(h;#p99FdBD5Ch?5F*hTVDaJTp@Roo4b<=Pv28 z{+d}mU13jYbFbf}K@7p12_I|LexDfgpve1^xIg^<AHl1Le0l4_$dey&;OPxs1$X*> zlcqo;aI75!r|tJ`uO!8)Q4C7#X0kE{XuVf(W)XJDF|*>))7%;o*5##GJ9mDwxvIZh zLWQYEceXO%H8S?mWs7WXaJa=X0RzukrgZWe_ZoMZ;uw)ygWt#Lf&5n+(Chl^?cfa? z4aM+owA_c|>|Tw@i38&A^t@hV#*--KRo^p>@OlFxVz5x>2Z=3-gFoT1LYm&+*g2Y# zbed=3yar(WbKDkS;b-ym4=P4Pc@`N2|2i1Jg6Y@-MBTRmiG!Ylf~y$uE6;YyMXLr$ zCK&)jVUr!6`yWeMyl_JBM?|ezw|hrTqg;{x8eGSCnf`OL;AN{mv8qoqvw^6QeZM$T zh`Dfya5oW-f*gc{bRKUzrMvZmGXy6Qs@)i|`Z;Xp?A$1tc1M}P5m;~(RSN^h+S4q^ zRlF<?L!R!?0f{lE&tXKgLhh%HBp8)_5`BrWe?A#Lu0SEL!-&}JOc653>oGKrBcoD# zuc+T$6^bL&d;ega>y8m+JKV%iU$H=mwd)<qBDjm8L_jjcPuLd;b~ACxP+UQgT&e>J z^-z2f(#*&Ul*b4oc69qLV*CB+=;gj_ERDDS`8j)>{|tTP_8Mzr!|Ckp$VR(*7;oMt z{>;G0n|X%lGtZ#$2gg6e59h<>r_JkfC(X=lB*s~F5Bj$Il6~i;4#@Z1(h{WzEi*GK zp%`Cku-p%BFIEvWNkjQYJ}89NPz_gg?S7(rHg=p-DnQwE8^=3s82<jww4`iv>cZjK z_*XS7>AUTzs66X7%-51kfK*UQjXmM@Cfc4mT~FsM4>wx#2#O}%I8XP}UJKrO19ve0 z$On}$haDZd=S?1n$Y%`;!9GDg9ipDDTJL4|lx9`KcE~fABXf4BrKmdb6>ZNf2Ry#O zryr7=s25(42#oYqr|n{L%n_%XN5SAJ!AWU8l2F{X`??DXI3c3ZH!2eEmI!Pw_O^yb zlJ}auy&kHbG+u9_V1;!*a~Zn3qvKOAC#M?1&PMwehG*lgj@rxPkhEflqk&!LFFd?n z@$^#>vf-8G)y)gfyUtA%<34S7_e`+4%|D6oIZ9^hqe*D%n?_+FU0u3d)G1&STuHdh z!8KJ!V8F`rdw2YT_Tfol?K%z!5oW3y*<Qvhvu+0?vcFlLu6;u2a%+3I+a;=Mpo!XR z`(u&$CN@GZg-UoG2QTL+_#;Z#Je(y5%|Ca2zy#gKyv>&wl8Fz*;0UcJ;oFZ9tKRFd zo@F`J;OebgbpEx6`q}HThxJC51)(iCYeUx&a(<{s4bWM>^69=m>$=OY4Ptk<X3Kjr zqO$Z>%wrj8yGAyzE*QDwc_$^xij9Q=Lpi;;R@jlP3E_f(VwZk&Bk0Q;<WX_b-9a6o zBix)ThC6ZTA|A2N<-F(d@nNG<o9%Hxs{7)L_^*21u9xqH>leW+58Xm;Zn8;Vq{6pu z1btXsF_>`r<Q8uIC@@n#vpVYcU%4CTM4NBl$Hq#5FJ8gZeNawPU$PlF$2$8O;;%Xu z$E7MkP1=_s^co^-q&B+(g5o15o>o6NN!mY=m=e59))Og-Fi)@Fil0p;y~!cw_n_;0 zM;r_1Oi&VVA>F7<y&Ce3zWvPC6m1=1HE?_`Ntcw4y>W1OL`IeshlziPa-$fBC3(hp zopL?fW~%e4VRC3FswVJ(pWx&Z$39t+ggm^o_<xR28V6Z{S65fYSJB0_J#}z)_`R|8 z`_wN+Bw@u}U~#MZGiS@*!a?Te&L-%fZ8^}`rl7G0=@;8ZP-IJ-Fj>U;5m6iT6gRH^ z_1XBf&BJ~5{GvC;3wCdI8j(uAd_^^ZwrNddTvXuxkC(VJJJV8sEF<nKA1zPH%@2Kc zeX$xOJdv^AP<ruYx*6L#OGnNro{jOTPCs&iY~szuYd#xjzX3=k&%&bWgnD+d;kE-> zh&_PhWKAL|0IbK|M>-w+85glOWQgu-x&&Cf4vpI7{w%`R$k(qtG$$=K6VZq4WYvCU zGJQXN&#*DH2$zXTXru0&Q0AkeH@SML#QJ9naqUjv<WE;WBmP?J&q%8y`Uqb6x=2UX z!P5$v&fJ1KJ%P1douD<c&T;0$(5={j`cX}|O=+TF4WB@}`x(i-3hbHDpK?fI`)Dq& zgqJCTa~HxX3f?vHeS7#7R<vtTUT)v;4jAlvSA8n}BoH)wd!CN5$o!oT%TE5wYsWcp z98>b|2i$_Mc$!?u3uc8gxV&521lb|a?P?f5DzrKmNPTwLSdX<uP9vUGE#J(d-c77b zZS`oM4f@bY3urrN5waE*7caIb;4NLSby?3gx*EOXpjf(iLVpJ>y&%MT(02RL({la? zMXFp0lCx2T>Z=g)ClsRAcAX+&G#$jL1bMRgk(K*4)JN_!{k)|!IjQMOyEj^WEgDiF zYl}mR$j$jO0#oX7kIz^d2M!#!Xw0zpAi2w7gSJ2juk(Ep)%FqFcrEsimotak(o&H4 zuR2)`k#F=L^B=GcrLd%~TzdhL6qodudA=Q%eeEzovgID1o(;^vhy@`@=8Z|N^P`E) zx4*wLG0~0;5}a7?ctGE9Cj|j+Z@f7Cobd<LA|#nwWo0D);1Eq8!GBoPPJiP{_C=iT zKQ^*t&?`I>E$W5__s@Kr@R-Zx%Rp3OKl*uuiWUBuueM6?a|A9RYwJBK<A4S?xkld; zJ|fVxTWE!>`N5<cuVjPax1c|e5X9>Vu-6Ew8%<ARRJHjI6*xy$@dT4ez(A%wmS?%` zRC96O?<TvWws0=u6H2TsGA7kA=Oqs(8w5<DH{+lWk~pJp9_m90?iZ}9Ga<WWVI?%7 zZXKVIq7Ipf34>O&%+vOMv9_{uGZchF6A&2kSU`NR0%d98<tYNYR4tnQnj@bws{8!W zMM>l29M(Rc5%?k+^rBTI1b@3n4`2(pF;;$SNV@4fv4-Y+i?}iPW4!ZEx6UX-u*O-$ z>tY5v@pHU~xHAkin(fe+l3LV*(9X!e!N323f|&#G5c=2ObeS(0sGdW-v4>a=tp`^Y zte3Cnmf*CoU*fuS;F;EWuF1-oK=NKmv-zSH1mByDCHKf8{W~3PyDrfC#Mb*hYc5kf zGl(x#Uz;L?ht3V2V&nW_$VNb57$C1u+E}Ua<~>=GyBiRLT;PZjN24zQ1OwX7=4|kA ztp<|hHPqENY_`bGeDlPO$JgFy=+Ey<5^<oY8*$OrbWEYe%f2Vp+>hlVQWm44iKN7@ zvu?0XV<4-gm$I8|30IbR7-rn~puW{(H0jog3zuAX{;@A7PQ0W>nkg+)tR&m$OjaZq zmjofczsBlOPjelfLz#v+*p0GXlTvh^pJ>ncI^f-`z~zWUcya5-Z32SCdnta9w}0`~ zWmHt)g_GX_3Kkx6aW42;`~zFKi0sGF@s^URTp_h+9^R%l2dmNXi+0FP9QKdVOoQMW zOYbbI*tY#DqQesRK!#A$d@bwuJ;|=(*gGU%J_gT(-@kv?UjSPmB++LJ7?`}|VK_xn zCJrAiJ-4>0y1y{L*~j<UU0~4L)MDJ+m7a_!B(A=unrA96o4ipDZ_Ha2lhFl39dLg? z;p@pdA%?Z#4dRm#z1jSXPV8or^=kiv5|uyYh}+8PbmRqvSr83>!XA+xBT7$Q;G-TL zm{PYDGrnsbzJQknQ<AV~qvhOnqBI<iG;&}c4m;DwFEW*|J0~y)4PoH$kjSBHe)&YC zP}xOVuH>+FY9mkik6U-741&@%Ch^z0<1UOc;Pog27}F%rB^WXP75m#j)|bmtww1sZ z*6IqkSTXH%>szH`hph(D%W->JvVkABLhJ8yF?tiPdOY{ZCBc*WM;^Rqog^eO|5QK_ zRk){-Hhu*1{WBu;+&+<1mD)T<L@isVRTnco))k!28>4YrK9-tYmU0_#$V=xiE!jzJ z8*UGds}63DAf2|(r|940Dkd&zPdRNbW?c0_jDnwj%bgEh5y3)Sg)!I3>%f{>{xwgx zqRO=F2$)Tsl8JAch(TCEO3`L_cgBcP^M0hT`$_5NJZp4D?o=r4?v9@n7wOIq9yetj zaVt#3VuL8edfym*trt`SvU@@L+tR)@LcT_N$=s+Ig^F+0xkD_<fVHS2rDoJS%MBlJ zfWdo}%r5@Od?qo~A$p|D*V+mDoxvi*Zo>TiJCdQOqihtW=w*c?jLmoiCZ_Ih<}&_a zqy2SAe=<-wSRj7oH$zenUDm^Y_r8Aew<W9(nb1q;)%CC;Tg_d6`t{W^p2>xA<<kb# zNjDp38<^N}5@NnplUob!v~^fu3-|B5TD}6;7p>BYKTgAip;fct7aagp9MSs-1}|R< zpIvn7+d5kyF$+&vt*QoUARo1#;<eq+Pv#o0yOH0%Q-s{TkwlD?w4n%HY;5bJe}#lA ztQw4g){P+}g#vJ`*f~OF^{;rObAkpYD}a`-SHUmhG?F+_cR2Et^+sECc!>uVMnVXW z!wX`z%5|725NK0}O4PK_8lww+BB4P@e9M6njJi^DZ~(0@2-XUY9wy#!qI@!0OWD=f z!;}K_MOC+h(1p*r)2_lqkbk&QBAJW_Y-36>%t|`QNDLM{p7kP0`;ejK<|sLcZpE<@ zZ7$)%0So%*-hL(zJPe+o)!ONQjKR37sqzSqn*%M_#EINRVnJ1B0GYQeGz^eWiJ0Ve zr9rQ(YJ`*=4E!vzP!UpP(y+xvE*GX9Ol>5^ddFs0#VClq@%?HJO65}!)`V`71UPVy zHX2Pq*`5+8B#HY=(th?7k2CrHev@O>5AP#L+(DBBW#e@lUwa*NV#ZiB{!e@F8P?Rg zwF?8%K?qW%7b%J~K?uEziZof$Tj)p&T?j>b2N4CN3J8ew9tgd65Tu0~0t6|cNhqNl z_V>Nld-igzcb~I=oj*I*{E<1Yc_q)B;~C=_W8C*M#;xFqKcLgh6)c$W6BpMpj;Nqj zc6-vWtJSmI`wt!rx_i`=?N~H=JhyBkymPK}B1)R{L=#uoe@{*9-NyjF@X0Co?TiCB zX~&3Si5gVsk)_#E&8MHw-lU87#t+c{I+0e6I=Jb%eC#7Y<-4@pI<(~L!<Bt6zV?1N z_3lo%M=8|)k&2gZrC1S8@@lEe0+)d1iY^JqxO~taFQD!?M97HTa_CI+d6e5xf3*$K zU{-z_zCs|KC(S>{qrsxdI5X5VGGN)xG38|Ah7}_{_c(5qxVnb<^M~@c&;_C%5w<KC zEH3fe(&ipp!TwrEc}8eUZpUbq4LR)woVET`&3z*AyuCvzD#*ym&?RIMf;7o67Cr?P zjn-4lzx-}HK#W>nbPOO8t<0$_Xzau2iy4Y^>zGKm1-(Ulf$}WfMtu%-j&w3pg3_Wm zztFz~GUt{Fe>Yp6aoXJl5OFkC?#%Kbo8YqT!7X)DkSaMM>~MEK?g<;cAlb2aJ>g&# ziv{yjuXym?5VA=ftXMy?8dOfH+}=ZzcJjG1c(O0R=j8Tlq%-vb#*Hl7_AZb0D#zzd zk@}MA9>$J`cgvCFRK1Ty`}&D6^&I|L9KSM_yJSWpKBNCRv+`d{D<OWuG5zY~XGkb) zrPG!}&)33@?G(1Z!mJjABvg=~8%joqyPs*zz;(?{EXWG2;qpt5mM@bou&yk%v;f>! zAY2Wt>^DxfrNw)-6`5If*E0fkbI>0Q#=AZ8m8qku*pWA!kwK|)-)Rz+$nQ?$9*l$9 zy4><U`rp(LVqfXi;k{`kq2tGbmiIJ^j*h8+8K!l9l^FQ*DrIadI`QafumYpXU7Cmw z`afp9fnC}U6{!fQB{HDFT}5zB(=n4N-d}nqzyZn9aoob%(uKx8?RP4;cv-=GtA@a! z(e^?*iE?O%YTt*P#p};4Rj-rRZHf$a)k|nMP>TD>w|PI@W3I_OMa<n~1QE%=X=)Af zcr|e+*E?HsWQe+RaL{diS{8GLka){1u8?mC_j5CRXI?4!Bdal`&uo0s_cF+qBPSR9 zhX<e6d=iaWWTu>XBtd?L?eE`V1a};?NS?o8@LFw%t*Tk5U42$hj23SWBAgk)5-|;4 zp1gYUgs__jH!}14BRj*TngxHRoK$Cz6({7i0ONvC)SLF%$fnpX*-<gL_pIBJ{ONTS zbvaQW{i(3i5=e^`rfITR?FGBs=WTNf$pl6n8JslF=?XB7%G|#n4aN-Axf7pdN6yBL zs^9pt`-@(E8s5{HcSp<Yj<B#&+Khf#SyS*%apm>ZI)!>q%XQD#LRe*hhlyK4D$}sc zBmB8TZe&)}@MXd|(~A9@L|qv*wCBWgEp;zc1V(ZB_vP>*9!*i$iEHhC8&>W4fe4iz zkYmcs%-ChDbjcMp-0x;dQ|@ILLrJs~{&w|a9oCr>Uulx8<{^`&#IZ9m!Ss~f5l;d9 zLv(TZxr>bd%|<_PweRZ@+$bTy#3_`lD#_3L!6@ui;<3m*eT`HNbMYnH+_o1T0j4!I z5xk{dFWNi$8ips_z(;fO+L#JgDGSutn8zwxd0l_%&$CzDnCGUc0&!$DotY{=g1EV9 z*WORkFHhG4FsIT5dYL&cB4C46zhUX^a=*3-Gg}yPwUUAiI#mtEV;%nt883YASK|1y zzBa5~DueXnBCP=C$A;0+Sah`uaa0KP49ZGGe>x`8@cgEA+4@r!f5#P%Tky3&oXIM5 z#!9``%ou8HR2;i#3u&yK3cOyWz^+b-A}mI;p3AI-!XQJfevtPk_qAA%604+}8ovj* zDl63LE1PXg*}Z(7_9B^d@w^rkjdkd+CpML1U<R8>szVe!r>sssFtAl1Gu`H7No<V7 zw-vjgXq<A_Icq!<crbP+D#!)1n!|`C><s*V#=Cc~TYh2d>B<rzzW4}BKuWv_{(_2T z;{DAnw0lTsLLe6vM&gb6x{7No>#U5csy#pH8>j;fTaLx#`(z^Lmz9B}N(@(#hztzd z*AV0WQCwVrsr8#y`UEcPsc>Nxoy)v<#Q71(1*5VO4XvRcsY^8rm=||mbl|6CuDvPY zJWr^WgCEA5Z-1WzE%8FLcD(KG5gHzk>6OlK@;i8QlY4526*AZu?CI_{xT&_u&CO%r z?3^WgFud)O?+$glEhq72GH!+sx{sGeU^h~2gL)VS%=4KY5sERGm9Mtxf5g+4i)tnJ zwQBwH<&D0+s#lg5NB8X0Xy=I@Zqn5}!Kj50UC!QTsLUr&S^+cRzVgQNm%MpWQuqux zV&osVJHt*-6=g!V*HBefw~!V~8!6&2^j0i~%%}B*fJ_VUQ(SY2c^i9)!WC@q;*kn- z*qnJ{sBpNZ9yzx-r1uZlN^^mC6jM!?Q!@cPm)PmyX*~1bkQe)AyhoQfFhvl$8uy_I za2UHP`bYymA1o|Cr^0iykrhgB9`dHR?-Bd3wB3MAhP)3?VA}y8t_QlzMIbfrvr}y@ zfAN8=h;Bg;J66@FFy64XL*PBVU|8?@Q)#=qt%W=sbD{3q1W7y@yle{?uCA%hOr|1m zcouy?OsgNN4RY{C)}<PAwoV?{+2;YtN7z~F4Z>u(ZvCFk5>3PDzJI%HvA*Hk;}vo0 zX4bCCQyiQw%>wQxjdgpe71=KG^G1#pt|j$3GOYvUhC24i)zp;{TQw7dw%G5;jNLw= z6w5A9+{cR@(uM|+yE9b=b!Cw4o!e1XDWjtvptjfPu-(P7b<B{yx|7nHL9J?ni_NJB z&h1*J)Tl}u0+M>ipsbdr;srX3>j(FF7QSV`oTgITv7<FGX9w@NmdDnMBNU?hGpA`) z7}(T$N>0m2xrv@d@qvz>&N9f=Rj^^XrFD$l@++)Du--s;ol%hMKHSAb>U&^wU2p5< z^I{0VrKg#MFNZi-qsVzl*YSGK%D9YiRPow>P9?)Q^Kqr-m>NUfSu_F@Xc~Fh$0k0j zfuc87a{9tj>Qdilwq!%;db4eC03oh&eG8<XMr#Ag8~|aqHl7cSsEbClKMzNG<14?9 zPs59QuZsk+G2756mo1w*Hr^$nqo>_KCsV~{Z_vl|@!ssTO#}H{S|-b4Hspvq&YiqL zP4gc1N>4FZvso)4eJ=w}Rul528sJD|0Xq6Gv9NzPzUEa$FPmcI<uqB>xk)CI9TBDY zD&-Q$h1$M$<iwJm7tbaSF15RnQ&AI%&UTFj99{BDjCusUxLShIro^^!1#uf()a3WJ zUTxRa-(JnRNCsS2CSHVkJtUkM518Gmba4OL&=-Bbv+EX<pqaHW{2+77f0wvNwQ4lC zs}F838CbF)vuYsTr5e_mJzCD1Aq`1i^g|YvQVYINR=rD8?&<9{=M%KAE0biaXXH1| z@cO19?*2VvPtRIa%jAUBu#tK1*$Hm4h+TXFr4jJV&v5ooH0Rpj+8zr!A(PyS6m-*c z#a>J1vihU`W9U1*EI^kNyon6&GaqdKqG0w5<Auj-C#QN@h`RH{=?mhl-r3tTX13u3 z$q8FQqADV{iIZqGBtCwQ*UU+>TDk1HqLhe;i}R!x{6>*mxha)Q2%0E<?vyCVUv|2v zJ=>*i_M+o*-(zWd$;Fuc-177rCcPsU_Gt3#2j@b?P18z?&{ZxW1$SCjWV{vUHR4W_ z-6vv=>F;y9VU{$?I$)%#MAyf=2h3ZfU{)EqoE&CL4kw4#8v%<yp{I^TTTfGHB6b&A zmf=Rmrghn_V5a6}bwE15ocQ1);Vb(vd@Ihx<YzSb9~GnML(gqTGhgeQ1}0G#6U+>p z%{E-WEhxGNw98p>Y!(VZ#aMlMm%3d|Lr*&!=b*cz--f-_xv}e|lzYQfmc#}0sAl$M z!A^|0!;~Z?KhcFQx4!>#kfvZy4ek{K=g(E<!yix;#yY02*oc@0!=)g*nTE)n1Tqez z;C`##ZW_puI+^oaTdNII_Og|uI-?Wf^i5bky2fYFh-!lr(Y&&8G(R@#)yaNm_(g1k zvHsfZo<2)$M7c7iw>LE9BLGCi*tCP)c6`Xxnd}C@>1l7|d1I=oZ`I|C(iH3Ti^Ve1 zJ*LY`p?dT=K<dZ<znn;4&iXYAS!M<vQ8p|#d6&L|t+p!Bxjx(%`%pr1(A&y&E7Ev- zgq^$*kFv^e$O2_tKWZBN>8?mh>Rs2H2wE14Z8;Vf6zP1vCACWl%P6JDZ9>bs<}G@E z|8X^aD?rXiv;6Yv+#7a0vp3g}4YwH*e+6GXAkka;VdI)oHyd#&fSFPE*i{D?Aef;5 z5MPs}UcyL+|3X`NXW;oLuCYGciTXX~Zd=2Txx8NtSmT{49fh@srDaY^Hvn5%8lIba zmpH^vJ^tg5(r~VE2J97z&hW`|=IM>DJ;WRTqeAPsFa0bSGiO);HRUd?Z8yA5op&z$ z=y1U-H$#Xx*Z(TGP$V^pi#To*GX$_(5^(rTE;k-9Ga`g8!KrG0C1D4oH;I^1IW$u+ z?(hxW_Mo(EykZ&X(2_6*(o){W%%%pNXSaCbASUnRJtRBU|7a1!&f6R4ekq0>ID&!6 z@UNeTI8NLB8NIlPmx8sVf;(cuCsUqSC^FMiI}9Br?*yU0)eziAOnZconQdsjjdwHk zh+M?PdSNWuh&M}!iKdt8;Bbz>vtEIthtk~erSMafW19(5oSL+f>PHN3$%XAOQ4dW# z=^#k-kI9AY&KXYy05V*Vt#&k7044Ft2m$Qe4V?`{j3fy}Q9A~ERqkv(-Zr%_RSD}& zCnBPXfIT7umXqsSQ7JjKv{^McNA8296UYFXu@0SKGD9Pyl{~~+*#U^h#?=hD^C3JT zE?hK3Ems>4AXFUDH=D3_b@k0GJ!~~R)+OayJG<D;99%k3Z}X$r8ivFMB}g3$X<k&z zVxNn&#?L-ww7MT%MTc93-^D3XWtQW|K5^5^!V9nHCqQm(t$p-vG#+V+P21T$<fts< zV2#BRrrhlLrM7~5<-Ll2ns`(#9Pvd7L7s8ITu7r4;w-81@~g+>#tGsNv9aED>qhTc z!Xx)vF{P}5zexO9V*w_*PVf(%xVb-)rW5=R<6gdhpUI@onVG<PdE@~QSvS`7PT7Xd zZ|*Eld@C=ndc56W^nGnXaa5p`_okV+yGUS6VVWH}^V3cCnud2aPZg%Mc8KE5@i~$W zFuFnWjjXGP>%2=pgk9NmJ}#`Nn926Tyc$+zHL-pf+N(8xSOpNNo6ip-g-#Eri;VDS zrEe<bo;3|b2K-cD8<4t1FJqUG3qDkV?kc=}1MRJEZJUp_ION?RsOw6{bG|${C^BVX zMv^yka&h^K=1WbS`*#&OZ(6nTZ}0IR=0Zk~gjzrYZywavHuo0NY`}ul@O<Sqg(SuW zBBt`diMW#t&l4zKmCm&Bp>r*qch3a?aPC!!SCYc4n0Um&wCjSC7jZy?|4&PP!StQe zeMa-*;sL=wmdY2g?C`A+;_9J~cG3jNy~-9R>C}KSKcAMYhE-;tc&4G|9tzkQNzI7y zQiH^j84|tRSY!9=dj8S)?SS6^YTyV7cxv@Zl#R{EUb(rXD|@FW=tN?MWzi#wuQYGy z4hN}ZH-S-*krX7e<=3&t&UK(?iR>@EaM>TBWF|&R4v&It(`5rtGGXnEd+s#`MwYb! zClz!CtR`WtCu?R9H}z0MX$;XgI@Kl3$-LP*X5?&mlFm&JO5N~FBGilQ{3H<eN=WgR zS~{f(`g$o`+p@lHanRNW_V|m?cB08-^UHY$?@H{`#fQ??XT6W9XUsl5)4^!@2)@nG z_;R^F7l4`I0S717g3f-8NXM?2eX!DBYQWW$i)2<?rr4f`!bT2Js_<)%d4Kij_{u%G zO6n?f)iHf|EC8*2aa5LpGQwjHPa9urhhG(boaJf{^^lOOo?>0rwn}V!MUdT3!{lP# zR@&a`KIN$%%pQ(J1mZWoq&doh(HYnd>S0IuvAcJ}E><T^hit89wf52-A(Y~CiEN9G zWT}1RD^`;AkkK6z$XZ71PT{gsRo$#sC9ly=Hh-ZMF2ImH6-uP&S;H>nw-Ot>bJGsa zeoUF>_yR*poV5?8!&iv3koaRV=FG2f(eFy2lBm0B0q(93bB;U$C`VCh#5dEQcpEI@ zExib(K1vnuC^)IZDB4IjiJX+c%YIg82OsEU)-+Hh9|!h*Zf<>2zc7m3IuqY+q`%x| zd(fz&{Px!wza6~v;tz<sRl%+jL!HX-R3<I;Zc_~}Q2$`>28DBGSqw67OW<V3`|Zea z!m|szVUz^AgxmuiS@!%8>+W81srvbSI^p;*y3ple_vFDB9RU@E1_k_I`zShgW`n{2 zY`H4nhNf(7z%{9K%7!+#+O`165IB2V99e|5MCwS46-b_x)q68npZBt&aDKqySGmxr zxF+5Hehpeuw)FH2Q>W9sfjJl5wa~a!kM5B)_&Fhe#n&fK&spPyh$s|97cP=Iz{bFx zt{9uxEXWJxfEpGcajYZp+u4e{fMA+66r8E#wFz;qx$J(_V&G8St=x9LozE7VltF<@ z@Ok+71_yR9%p~&dC1{cS_y?(?nx%i~Ze*ACRX2$yz@0NQO@h>g2UTHWIUi(ZNh7S? z+*Rv7$4MU(l{3dWZ<EKQ;f7Fwrhk~lm_h(%#Y?M}9z>E~N+ZS*Red>iakVt_`raxp z5D(g!wueTCD`g?i5vMO*hyZ?0Cf*xwPb1GZy=$!xWFY5fGdmW(A7w9Q&36)vE0~}S z+TrSn*XxpDK7J$7;6eUxfcjElFao$Y0B|*}J#>O>gwJF#tWyU0!O^Wp8@LCI+d`_q zZ#kET9KRm-kbH{J8*nr6N04H_YX#k=(v7@CBx*^@nE}_2+KxvVAr}LwnHjnRt&e!E zV`AeEQX^$w0=#~P5AB>J$`L5)5U9v$%{w=kSVgalb=Ti-@;jeP-8oBL_CDcOc3R)q z0OG!D)2e>-XypraG^C*ybA!*GK@*$%2PK*<mYC<w^+3nBH83k&LG>^+6!$1;YB|Ai zBpZTw1z9^lmC-w+1?OCKi)hYP^QB&{Bqyaf-4JLa3J|T({brj`^i18h#2gs_R&cM+ zm?MzM%wVHe<Qv_S(GO{9_Giexj_@M*k|~U&ZSf~yN>w`I;S??|oGs@K9XW+kRLV*( zgNgC|QQdob%fu3baXEN$kB*D!tsr|X&S+MULCe~j0)v!U4iMB#OCJ}BQ#{4m;~Ii! zp%Y4jSW~deSzgMwTyxN`?l$V{&0Sv=RXoF4Lu~Q=Ng3<_xNXzt@FIHnGE(tj`TQwk zCLWB~WPALXIM3^Sy6H0ykKM*R@)F0b%5S|CG%QwzZ$9(O-Y0Y^PP&DqY=t++0kK76 z4{L*(K`FZ>E?&7Mymmdt4-RY4y+y8`jurM$0M>JxTX*;Th;&gZ8}g)MKz`W$`>MaA zKY!(P;!!7~^)KY7sC_Gq<(Ao9+Wii39{Io%?#+?ZfoHKbdkZb&tzJXS^S7voPt<s< zyNzvMvy;0|#<fd{)wjv%iBzzUFtW8$1h60%EU$l-hhuzl(m~v`WpuQ1y*%x-eB4xs z{sRjWuzMb(ux-v}-lQ<SW9PYdiSy5D1|Th}um|d{10Zq}^j{wMIL~%>Km@ZpKU!U3 zDtZgzY?^Y1ExIM~DUcxC*v;kr<15LV0=b~k<H+6fGmEbk+hYRNgv52}^N20%VpmFX zLZwCDGqhmGyrigy({Y1{EtF9wOf`vKSMzmT!1Yn=?y?*VXS7;vIv?3lanP87=MfiK znYN&;aoMmq!x48Lxoy|jqG)C%|MQ|tj3h5tt+jsPytRqOiVV1aI9I!!s!`4Fv(|`B zj{8JfjodwO&9Vzv-el?@I=Y4Ib@rTDpWK};v@A`fI*fBsRGg8N=SRgi^oY8jpP=?} z?jEXyUS}AWl;TtJjjGrvj=gL=^rQag%=&+Qzr)ZBac2}o6ynhj8GbqqJ@{Y^#CRGr zWWET=!C`VffwAK~4<-IeQZ?)fbuGI*AR}|S`tU+Ob2X<z>7u5ve6djJLb*fR;=UXl zt~MI^%}IuC7xo%fR@>TVxoVU}_Jll)+bm4j{ikkFPs7~o?3xPI>~%E(*cXwk5}1rs zF*-hWo`v?j-e#=&PIZfl03YWP>A}R$^@jmDJ(JX=^%w5BdKQQi75)RyDp1o}-Vu93 zaphLJ9|SVxhkEn~vLO~5EIOQ!1u4Y`)mu=mh6$&d*4}Y>Oj4e?N2yBa$pHFV-p8(K z&;W`J2OaG<l?c@x_##crTEl%CGC{VPURBpSyqLvIaG2f-mg0~3IkF9MXzi(ny344} zse)a8bxfZVUH2XN^9u91wF{C_#Yi+SjGY`#!ttGB%|_BC?|_w3lLk1F^>{Jc5B->z z)OW3_$Z0D5Hn=Ca<#;NUJPg}(F>$mAeel3><x6ef)d}UE2gQBg#yP#2@l7BL(7@&y z$t-dFO=fvx6m0c5%HfMIC<o{gk!s|J!Gm1x9=9)SZ(TRAU3Ak4Wp1k|kQ3E`kb0=o z4|vm_hO1A$vc=>?8WP{HBknBsnQ0*s(a*Z<3%cqoq@_1dRBR=~_BKA0)kcV$%}aN2 zTs`nS!O8l-U>1LJZ+pErRjV`u@2e`=SoM_Sa!t(OgL(YOw992_`<fN^5228+-@XxY z6k(v^y2-0$)#U>u#;XYL9$!wY!nw_5>apgy_z8RL(4<gqwsXSKt5nmKEs!z2Y2|`= zYr|Ci?t&xaB(+gQ`>862uC6*6aIcr)L5JkDANyOwsDs|_%-Ow+U2ujpX}MzJ#eu_o zOyz6c_UJaQNAUUpdNc|+Z){{^-h!eawzF_c2r>aCn1#Y<5}H#ld#jih-bviCzN*SB z`kWysDtf!K(w}%5(*!oTK3u#Gds_@h(E3z~tnl9T@HhK`lxPk(_CUR8Pyusyoz(AC z2A!c3nP+~`5HDa-mHO+K!(sW!Q@>W9B~T8rO8u})-k*o=tgd5_Ir2N5v9kMEdAM}R zw4#c{oNRcLhko>KIA7_Wb_KTVp|Q+N^|%mEP-3Id@0ta)BE}~(kb7E0jpVE%jIMo# zOz>vjXxi%E6491cefX)^4gI)Qwmdbmkbzk2R7x)<<Y`1j(o5j9Y4mI&@O!r~!r!J4 zU+D``s#csl{C;Xk`j;>+6j#+=QfktQS%*y|c4zt;+ODlP@HMmo@pAt>X{IsLb6X!A zAM!57^4p4v1QG!~m!bL2Tq2v}`h_dp%>OKGy_QLNUot3ud&cURTQK5C=EB5-g8DpM zzEzGjpTm8XAK2L3m*%>ZECOIZcr5l&uWnX!n__ksMc;w@8r(7rqeA?k@KH1f<0aR{ z5@;!^pXW~fg#9@&@elNv_g(w<l7UH@kY(%saGXu)*y>#-t=+1gDBq=tuCfSfEgH<d zCmf|Ojf+e#mK}FL-K6-n?&(|{iLZVeQ<|-yzAfV2Y^II#flzwOhyBVBmuft$R@~9S zp(pRUTOuT3W;)uWLKVsyk&}0ew17zM3lr~4GKoMuV@FN)D%dd3x{cDkN3MT-R8dv3 zuC|slaWbnDkfxlCDTpQPG@xbwHNnzg=16&oAmQh)sNV&c@5~u*z_+*1Zd$9{3P0Sh zVz|8*iv;g(M(%0p=@l-%8R-G{`t~+r##;)?@`u7>4)NGYL4yzMC0N0+cZ(-UNJzY| z8e<U=M-e@Wvm$m+lDLcRv3*=@FvUOUq(?VTXNO2rs#4ta5vliE<mrRuQ=cff@MKdk zxne2xjGh_Z9%ZYlJIo`DiJ}|L0PVR71*a9=#fzbXIPVI^ojCF0SjxqCqFYcd*gY(p zCth(2nCyXS*20@SVAv5;0xz0xyzw-ofT8OpZ#u)X3nWpuTjkXO0D7^Da;?d^-l7T% zcpXur@oAS|z-Oiju{8l-a>!{taF?)KK1Z>^AnB{=3Zx74GzSa5STC1Q@Z`p>-m6I* zof|icI!}-XlO%~m{P3LO=HG#9nW9Ira+qJ3*^X}!R~ilNdrK!mqFf`b`*X%SGi?xZ zrQ}deVLFDOH0rZT7t+@Znma@0(A%J&wgg)d#JxoW$vo|Dw&F?#&ICw3Vn3ssnp)C3 zPQ+P!_c)0n+RrEG(Y4sX<9F1qA5&g+cop}OBpXl~f^|g*LWG)BO-T*_$!%;4saDN8 zA13jA^1_eol)uv23ALWrw;ZE+j1$2YrJ*N)a7&Pd?@3Wb)eWNHU3Yd{p7m~CNo_TS zpk(mAQP<->Yzx(ij^rC}Oe7*t{mx##4e??R){Y2YqV8B@^dQRF2iY)9fq)-!+bPP> z1q+*Omwjo*&8uuTc}I!8SQlEfx%OJVH68NK(F<I@>JK)t?!rpbB`DPt(Id>D9d}ld zw@x_HM6!I)?%O*%Rc$iZn8)p^_OvRd+rr*1q#hKFHJNX*`8bGq^!cyjQ)bj)V#*%) zp{M4b0izWp_uGOn^*~c3r0Ylqm3VbwpJ-y9{nSz-f`4+k1ypf%uJ&NN;s}^7({Yw~ zeD=rm`uu^F{P(5+N%OHjU-H(-2&O(TO7lxw*GD$=g8de=QF(deq@F+O@w|CF*!|-O zMnZoqtVD-~mC-|IYNu|57BjD}4v;UMDb&(zcq+r(;{~1W%Fiv6`7My*+#lcoV4S~* zf}kedllQ|@8cf!%{GAKdBiJI4sutAip>e@M4I7gh2d7<!ZLQT~Xh=X#kEJ>fwKMzH zOyqm*x>rbtEb@yM$V=}V*g(>ngcznwpPcB9K+k`3wXaN1XDqSbsVlIf4OUB|X2{$m z45_FntY7-J()m6ob-mNv)bon8;jUZrIUm5{X|8wJ^?kv9uY?CQDD9p0k=BP{9qG|v zizJ-1sG`I7fTjB+XJki5?}9ix?+HXg`Ue#`vSxX(s`WJA*Q|@?8K5`*MUjD~9^=-F z$ow(unKnV-^JCAtxwzHnCq?PCKRzfPA+T&W753_prTHx*JZm=d1b~V0#(OJE9@g_i z4J@>G9VQFu3|~LbQ?+<Vv!cEKF(V74n%vjbgL-M)=pX$mWbW7M0eJVmJ11kxiI=vM z$aU$QCVo;TgQEk0nReX{K74nRS4ri}-wkY*%TKvoR0f>S8`6;Ke5S#iV>MZ%S?^fU zM3a{kj$X2D{C>|oi092nwj@DFq8zc1CE(?4EsYSHt1!2E_n&yMD>(nk4{BRemNIci zzu*zYQ$A9eG=G+)6}RckPb*1l+14*Kf<>vfK<2z_wuU+#_^_>*Sm9KZ<oBpOwjl|{ z$~$D=%@AKqG7_~-L;&ycXR^YyElQ>7(4zh^A2^v~q6vHD3))>;&KTE7!oDy`1ulgi zagfKf%RW&wG<yA>R%_T3v{_yKXn|qYj7H^AEFk>>u9MY4n8kB<3vvgBn?8x*>OWqk zny)GOG*Tq2#s~aV>~HpB62GCMHA}cQqe=NQWjZL1J(1az!h-|PBV+$y4Rc9_`|_vW zu$?hqu^-w{(SQ_MWVVpt1K^evtgHTJw%lsd{ncRM9(c`sw>Q~(vWSLpardVf4H>V{ zm3Uv5#_Q2xOW1Lt7KozP*x9*EAoG>|(P%m?4TVeG4Q*BGg!|&$f|`v;t^AEdAGv^d z86R7m-7HJPqA;K-)=J);m({y%057U)HjtD#<4q2CR|mh3Nufq|S}fKlY0<yy)#>G= z^Ye_Xd}zxD)j#R5rX!w7`r%`-Gmk6auk+$7xfk>%)H3oDkC!8nrgp90*A9+Z_TD_$ zW`s{i8lH^T%MI^!#alr=cqbwegOollVqO#ieeWF3qNy+o<x&uk#>dN*^*i&VeK|h$ z`tuE}^S0MlsixkQ`D3lMz{#r(_*@D(ivJ26F)f;2|55EvWBCVHmEDshu7gcm{$BA= zab$1y4Y|J{f949AbQ>dY4tI^!<tl5W=lGym-MD#Gsbs2s<)5aoX-yR`@1&ob<SM9M z<C~mE74cd|g>8;kGUPk`Nsw5P^3doa4DnpoF4_U<^rQpGTj>_`?)t0u?2|d?Wjouw zaElUFP}wHW`=peuPFI$S^p(RhFi);ioD27h%)Q(bEpTA!PnwphWlww1(`p*xCvs0; zySP+6jnejK;4$wTmy=+xHHJVUsTFh{s`}6u=AQYVAz4C)yp)8e-d1U6exRV5czPci zH%9GWPT(RT00?j+e9umk8x?&YI0jxeE#z=j9ugb>8I6qm%uAa`7n7KvuMcMNM3F|W z43WhXK1N-ObPn(g6YbrPabpNf5LE7S<b?_@+cIr^4xNn9Fh)purre-mQz_|;;M8yB z#a?LnDiJ^%NKnnVtwI{wf{-IZF`YLyS2KbdC=_RtH@a<jU$zpJ%QvH7O)vr3$5YWY z{%1)_w+S1Tzt8;)Gxy|;>Dv3KbT235=*&avujJUM_D?TX3T_kaEFKrsm*fta$&A0Y zSq$)Y@T=9(jIRDkoxF=tw^g|C@I0*)^&Q^&8}F-_3;g7UySJlUxtr@amJ)F6JrmSw zRVR>@5(1rFWJ|FbE4JEwomb97deaJbsY_gzYofLCQCDxllew_y<o!Nppb`6ww#eXp zbf<z>0TG3fv)9L04e@pBM@35PA-C~8-*KcyH06`iNR1M0aZ+^I^zk-*ixWSfJogv5 z&8u`c6FL2iV-kE8SwB>%W^d7M$YY?evdvn&yV9h2uR;jb1tK_EJjw7i;GL}MMI2!p zNziTl3)kXeIc?$-zCi(EYVw#BH~gHV9K)G|-cFg0<9%$^IWWEHSrUb6S6x79(_FpQ zaNioX*IU*jC$djL?!xTr7TNQB=RW#_V@f)lk-B-8rrzjozCh5XNX{F!njXY?w~SK` zb6Q_wFe;KqUNf65eXNFc@OxssO$b(`R;cx2+%F(Qd90>&MeOBS(kM~t)SnQR*KiqP z92{!tXDW(+{1@^9q$UB6Y|qR<9vGMA)lcn)^6;t{+q##of61J^rDn%@>)7xw8o07X z9F}8pkk~5LBY%_A9vRlEt1vUNZ;*%1z2xH9YBz`7o!G9`+T>zgs`}7hg?ardb!2hM zl757w=EkT3KfH*5JdL9cJtep<W=&jv@j3r#fNA_x-7n6t>3hWF4A1!hcXqAeh3yW* zY2RZ5L;Cu>6Q{iQy%M^(Ykg!yf?Y#9dBlXDIw30vW_HKoJ!O)bTPc?Nf&-Bu@_jOW zj3-aM;{NEJVOpTu-bV!lu&r(Ov6?i<_nn8xvy}ucr>^*=E$6V6@7QnklFz3FexLi? zB(m4{O&ThjGnQ%x>ngZWPu8HNAo)42?V|vYDOyhMNkP8zwZU14A?0i7r{nbEc=X;Q zsXlEluZ?Y%LkHQch}8y(KHe@rF|hIaD`Q3he^dp}MBQU7d1yCe2mgeWRc%Ev(`qk^ z05$U`@%(=x3D#l_rY!t%nkIQB-)|0aNxBT8*Q~$o+(PFYC;ud9c#-9Y%r*O{J`r<l zAqU;;Wk!bcF<OuQ+gIy7IjerA1fkPJbm)WAx90u<rLg+)r3ZtQMqbKA1-90PntplV z$~bF{f$cnU6P7zAkN}*vd*&FfU2u?9t23*-{h=3gMe`Ucv2Q4db0#25Ci?|xIm-IR zvL`BfQMLeM_F69vs?Yte-ZWpRnNlh}Ey{`72h(dlJe|gP9i8eFB|Bua$QB=7`78xp zeC;d8{I<2=AEzt%_Y_h=<@xt9xeQU7n=<a^LMyYEI+!QUe`OV9I^d6L<7%^Cym--V z06T#jdhfkIsBbOk<8-*?$#akIEkjl5tqP}KXFl7E&Q=aZb#?V~Xj$%Q`1A%H)~wc} zTG>+845<Ce)QX7WgW)S>7<Yl~?5}5YqnAWMg^|*c*_={_(+`C3cwfAYQMh-dX}o_^ zSKTzfuHFZFyS1IR<+oj*|35d;|2?txPFH}GRIXziI$7+9vE=u_F_Sr1<TT&oIwwb~ zJTEa{EGGgH0xihzyIM!YV_YlHHFG3M(-1=P=t2HcguoreSqiRu2G-pSFlSJVKqj-J zj*d=Bs`Ti@<b>wk>DE>`erfRdO*Nvj^2VV%$)ZlSI_1>Y!Vk58nQCv{75F>{8TC|e zeA|4^@%eej`TD*3TSWX1T}|q5066=bn#%bPN?!c#`u+t~`0pG30WZ|zMCqayo#8Ob zIiZ|ImlK)#5z^I8)2G5Jb)8<#nv;?gp)0-7Z#!3r@uioe_N%<7O7UU#Pu|C?qLS}W z3(zZlo=r<jW>ho{X!)rBhmoCHWSu9*(BGXgGsrz5DyXyT+&OFvKva;Nm)pq+_M--R zex=kp5xKYgb5ZN~xA@^^#{5sm$}bLZFWK9u_nd53RTlucQr|Xs>rqh|M$;j`4(ac5 z$`IR8vL|fz4lheHgdK$!CUKP|e}|L3P|p98ydYdK{gX9vl9Pj!v|;Uwin^9o1N0R7 zR+#;rSGP}09v`Q@)9c#TVHcJLx#ii))6+~21k^PGyaL}Pue7ZJgt=7aJK^|5T%1z` ze}S<7CO7%N?*TfKgoWYQ^DRy%m_c^p??AjYip##)*8~X2+5%>2)Z*(HqD(tMFl47` z)n}i%eR0JL)(c<zb>)h)J>~7gWBi#td90L9%H?M=K%y{?dk(}+j>o-JKq#t4H5vI( zQf{H=A|XDZJ}m4_Y<z5;y?+96;@da8!;S1LQl9-yFjyIjpnRD?8Q@yX*v^M?i^XwQ z*6N`k$6TS-sJo^-0zj+ti&`@^DX=I><mL6L;dh<?Spt72nNdDGj{7)=qT@f7tc09_ z_Qv(8^O!@u`SEe*`3w%i5QTofbBhM*(xrm}xd^UsMO<oD;*VbmJAI&Z9TUXQKUZP& z397u!K+Ofbs_nS_5Al3E5Axh7YaY4r`LlRy%2^3;h!3X2-bp-~CJEv@y-Sv)1?&t6 z&%M)heJZSc=Ng}3%k<wIu?ijsKhBmi!$VRte<|%57wJL9(x&neBV*~ZqLTS@0ME9k zI_|SO${z{js)AZJ?RfFkMMOX;pO_tr-KbJ%m~2JBVli(605#q)naEtn5Me&f&cjE# z54kxQ{Wv4!Ld%Ima==i6c-5;aO>+Dbww0t)lqc-g54Qh3D}Dop|MnCp@{e(H5<a)j zd`HN}=PyY;iRcQLo<W&MmNhhtQ8eyFB2JZawJrXjInv%&QKU>nGYU3pn_q_H2n&Nb z+TL_Ojt&~_mR1U&`<FBH_dgHrz*jQDp^^E6H29`~@1_l*9KM~TvmC57uP7ku=X#jT z4O>=?10bDfWx*VrME(*7arl<FKm0V0fml=C^Ab^F&c3!LZ&%2=Rr`s{OXc4ajwU@` z4g>D^PdxwH%g_6f?%ceX;6q+^i%yZ#%#u=bVtg&OO-N=*qVy`(AnNVuCs$9b+ja83 zU9IkC|Nk~>|5snYPXO<5HpQ}eif}_#A_qu<_j|7iuGoMSTdmY*z!pl)li0w_mB<{T z^&j;Ap5Oq%01f~vCz5yogs&p4_CfmAa`7eN=UZ`miygGo*t1`v?J8{lqnZ0VB~xMl zLDG-Q_ruNr`FBXjzZxE~1D=(#pC@DH@2l2dS@^$Q2?OGiyjAiKc`Wm<e*gE`b2HU~ z$9dRswe80$p78z&!23Uo1+a>L4~O)CWP1PKdp!#HN*QnQ6>??U7_<J(=TwNIeuu-? z&1=y0Z@*b*ygN8Iyw}&B|K|t$^8(DFsetzxkYjOM>)%rj74}+^r#Lk5qmu7`b)J5c z-fyS>5$4}a)PFLI#QzcIztq+LXy)JA<^R6;AI<y=NBmC~=s#xmpN!4ln4<rzng7!K hu;cwdSu=yL+35U+@$GcQMsRLE&r~&4%9Sia{uk(uDun<5 literal 0 HcmV?d00001 diff --git a/docs/images/tutorial-ilm-hotphaserollover-default.png b/docs/images/tutorial-ilm-hotphaserollover-default.png new file mode 100644 index 0000000000000000000000000000000000000000..a9088c63d885ddf96e9928c4d4b60bd721be9825 GIT binary patch literal 252951 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 literal 0 HcmV?d00001 diff --git a/docs/images/tutorial-ilm-modify-default-warm-phase-rollover.png b/docs/images/tutorial-ilm-modify-default-warm-phase-rollover.png new file mode 100644 index 0000000000000000000000000000000000000000..c6f1e9b40e9777450420d36d1dbe5122466ea36f GIT binary patch literal 455134 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≤HxUyZFe%r=|9)j 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 literal 0 HcmV?d00001 diff --git a/docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc b/docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc index f68708f1b6394..e6d94e9ca61a3 100644 --- a/docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc +++ b/docs/management/index-lifecycle-policies/example-index-lifecycle-policy.asciidoc @@ -1,23 +1,179 @@ [role="xpack"] + [[example-using-index-lifecycle-policy]] -=== Example of using an index lifecycle policy +=== Tutorial: Use {ilm-init} to manage {filebeat} time-based indices + +With {ilm} ({ilm-init}), you can create policies that perform actions automatically +on indices as they age and grow. {ilm-init} policies help you to manage +performance, resilience, and retention of your data during its lifecycle. This tutorial shows +you how to use {kib}’s *Index Lifecycle Policies* to modify and create {ilm-init} +policies. You can learn more about all of the actions, benefits, and lifecycle +phases in the {ref}/overview-index-lifecycle-management.html[{ilm-init} overview]. + + +[discrete] +[[example-using-index-lifecycle-policy-scenario]] +==== Scenario + +You’re tasked with sending syslog files to an {es} cluster. This +log data has the following data retention guidelines: + +* Keep logs on hot data nodes for 30 days +* Roll over to a new index if the size reaches 50GB +* After 30 days: +** Move the logs to warm data nodes +** Set {ref}/glossary.html#glossary-replica-shard[replica shards] to 1 +** {ref}/indices-forcemerge.html[Force merge] multiple index segments to free up the space used by deleted documents +* Delete logs after 90 days + + +[discrete] +[[example-using-index-lifecycle-policy-prerequisites]] +==== Prerequisites + +To complete this tutorial, you'll need: + +* An {es} cluster with hot and warm nodes configured for shard allocation +awareness. If you’re using {cloud}/ec-getting-started-templates-hot-warm.html[{ess}], +choose the hot-warm architecture deployment template. + ++ +For a self-managed cluster, add node attributes as described for {ref}/shard-allocation-filtering.html[shard allocation filtering] +to label data nodes as hot or warm. This step is required to migrate shards between +nodes configured with specific hardware for the hot or warm phases. ++ +For example, you can set this in your `elasticsearch.yml` for each data node: ++ +[source,yaml] +-------------------------------------------------------------------------------- +node.attr.data: "warm" +-------------------------------------------------------------------------------- + +* A server with {filebeat} installed and configured to send logs to the `elasticsearch` +output as described in {filebeat-ref}/filebeat-getting-started.html[Getting Started with {filebeat}]. + +[discrete] +[[example-using-index-lifecycle-policy-view-fb-ilm-policy]] +==== View the {filebeat} {ilm-init} policy + +{filebeat} includes a default {ilm-init} policy that enables rollover. {ilm-init} +is enabled automatically if you’re using the default `filebeat.yml` and index template. + +To view the default policy in {kib}, go to *Management > Index Lifecycle Policies*, +search for _filebeat_, and choose the _filebeat-version_ policy. + +This policy initiates the rollover action when the index size reaches 50GB or +becomes 30 days old. + +[role="screenshot"] +image::images/tutorial-ilm-hotphaserollover-default.png["Default policy"] + + +[float] +==== Modify the policy + +The default policy is enough to prevent the creation of many tiny daily indices. +You can modify the policy to meet more complex requirements. + +. Activate the warm phase. + ++ +. Set either of the following options to control when the index moves to the warm phase: + +** Provide a value for *Timing for warm phase*. Setting this to *15* keeps the +indices on hot nodes for a range of 15-45 days, depending on when the initial +rollover occurred. + +** Enable *Move to warm phase on rollover*. The index might move to the warm phase +more quickly than intended if it reaches the *Maximum index size* before the +the *Maximum age*. + +. In the *Select a node attribute to control shard allocation* dropdown, select +*data:warm(2)* to migrate shards to warm data nodes. + +. Change *Number of replicas* to *1*. + +. Enable *Force merge data* and set *Number of segments* to *1*. ++ +NOTE: When rollover is enabled in the hot phase, action timing in the other phases +is based on the rollover date. + ++ +[role="screenshot"] +image::images/tutorial-ilm-modify-default-warm-phase-rollover.png["Modify to add warm phase"] + +. Activate the delete phase and set *Timing for delete phase* to *90* days. ++ +[role="screenshot"] +image::images/tutorial-ilm-delete-rollover.png["Add a delete phase"] + +[float] +==== Create a custom policy + +If meeting a specific retention time period is most important, you can create a +custom policy. For this option, you will use {filebeat} daily indices without +rollover. + +. Create a custom policy in {kib}, go to *Management > Index Lifecycle Policies > +Create Policy*. + +. Activate the warm phase and configure it as follows: ++ +|=== +|*Setting* |*Value* + +|Timing for warm phase +|30 days from index creation + +|Node attribute +|`data:warm` + +|Number of replicas +|1 + +|Force merge data +|enable + +|Number of segments +|1 +|=== + ++ +[role="screenshot"] +image::images/tutorial-ilm-custom-policy.png["Modify the custom policy to add a warm phase"] + -A common use case for managing index lifecycle policies is when you’re using -{beats-ref}/beats-reference.html[Beats] to continually send time-series data, -such as metrics and log data, to {es}. When you create the Beats packages, an -index template is installed. The template includes a default policy to apply -when new indices are created. ++ +. Activate the delete phase and set the timing. ++ +|=== +|*Setting* |*Value* +|Timing for delete phase +|90 +|=== -You can edit the policy in {kib}'s *Index Lifecycle Policies*. For example, you might: ++ +[role="screenshot"] +image::images/tutorial-ilm-delete-phase-creation.png["Delete phase"] -* Rollover the index when it reaches 50 GB in size or is 30 days old. These -settings are the default for the Beats lifecycle policy. This avoids -having 1000s of tiny indices. When a rollover occurs, a new “hot” index is -created and added to the index alias. +. Configure the index to use the new policy in *{kib} > Management > Index Lifecycle +Policies* -* Move the index into the warm phase, shrink the index down to a single shard, -and force merge to a single segment. +.. Find your {ilm-init} policy. +.. Click the *Actions* link next to your policy name. +.. Choose *Add policy to index template*. +.. Select your {filebeat} index template name from the *Index template* list. For example, `filebeat-7.5.x`. +.. Click *Add Policy* to save the changes. -* After 60 days, move the index into the cold phase and onto less expensive hardware. ++ +NOTE: If you initially used the default {filebeat} {ilm-init} policy, you will +see a notice that the template already has a policy associated with it. Confirm +that you want to overwrite that configuration. -* Delete the index after 90 days. ++ ++ +TIP: When you change the policy associated with the index template, the active +index will continue to use the policy it was associated with at index creation +unless you manually update it. The next new index will use the updated policy. +For more reasons that your {ilm-init} policy changes might be delayed, see +{ref}/update-lifecycle-policy.html#update-lifecycle-policy[Update Lifecycle Policy]. From 25cedbe60c89173900be726a550c2c20c22577ca Mon Sep 17 00:00:00 2001 From: Corey Robertson <corey.robertson@elastic.co> Date: Mon, 13 Apr 2020 16:26:00 -0400 Subject: [PATCH 071/102] [Canvas] Migrate saved object mappings and migrations to Kibana Platform (#58891) * Move saved object mappings and migratins to kibana platform * Remove ts-ignore Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- x-pack/legacy/plugins/canvas/index.js | 4 -- .../legacy/plugins/canvas/migrations.test.js | 37 ------------------ x-pack/plugins/canvas/server/plugin.ts | 4 ++ .../server/saved_objects/custom_element.ts} | 27 ++++--------- .../canvas/server/saved_objects/index.ts} | 14 ++----- .../migrations/remove_attributes_id.test.ts | 39 +++++++++++++++++++ .../migrations/remove_attributes_id.ts | 14 +++++++ .../canvas/server/saved_objects/workpad.ts | 33 ++++++++++++++++ 8 files changed, 101 insertions(+), 71 deletions(-) delete mode 100644 x-pack/legacy/plugins/canvas/migrations.test.js rename x-pack/{legacy/plugins/canvas/server/mappings.ts => plugins/canvas/server/saved_objects/custom_element.ts} (56%) rename x-pack/{legacy/plugins/canvas/migrations.js => plugins/canvas/server/saved_objects/index.ts} (53%) create mode 100644 x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.test.ts create mode 100644 x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.ts create mode 100644 x-pack/plugins/canvas/server/saved_objects/workpad.ts diff --git a/x-pack/legacy/plugins/canvas/index.js b/x-pack/legacy/plugins/canvas/index.js index 489b9600f200e..a1d4b35826b00 100644 --- a/x-pack/legacy/plugins/canvas/index.js +++ b/x-pack/legacy/plugins/canvas/index.js @@ -7,9 +7,7 @@ import { resolve } from 'path'; import { DEFAULT_APP_CATEGORIES } from '../../../../src/core/utils'; import { init } from './init'; -import { mappings } from './server/mappings'; import { CANVAS_APP, CANVAS_TYPE, CUSTOM_ELEMENT_TYPE } from './common/lib'; -import { migrations } from './migrations'; export function canvas(kibana) { return new kibana.Plugin({ @@ -33,8 +31,6 @@ export function canvas(kibana) { 'plugins/canvas/lib/window_error_handler.js', ], home: ['plugins/canvas/legacy_register_feature'], - mappings, - migrations, savedObjectsManagement: { [CANVAS_TYPE]: { icon: 'canvasApp', diff --git a/x-pack/legacy/plugins/canvas/migrations.test.js b/x-pack/legacy/plugins/canvas/migrations.test.js deleted file mode 100644 index 182ef3b18cce7..0000000000000 --- a/x-pack/legacy/plugins/canvas/migrations.test.js +++ /dev/null @@ -1,37 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { migrations } from './migrations'; -import { CANVAS_TYPE } from './common/lib'; - -describe(`${CANVAS_TYPE}`, () => { - describe('7.0.0', () => { - const migrate = doc => migrations[CANVAS_TYPE]['7.0.0'](doc); - - it('does not throw error on empty object', () => { - const migratedDoc = migrate({}); - expect(migratedDoc).toMatchInlineSnapshot(`Object {}`); - }); - - it('removes id from "attributes"', () => { - const migratedDoc = migrate({ - foo: true, - attributes: { - id: '123', - bar: true, - }, - }); - expect(migratedDoc).toMatchInlineSnapshot(` -Object { - "attributes": Object { - "bar": true, - }, - "foo": true, -} -`); - }); - }); -}); diff --git a/x-pack/plugins/canvas/server/plugin.ts b/x-pack/plugins/canvas/server/plugin.ts index 0325de9cf29e2..91a5634734559 100644 --- a/x-pack/plugins/canvas/server/plugin.ts +++ b/x-pack/plugins/canvas/server/plugin.ts @@ -14,6 +14,7 @@ import { initRoutes } from './routes'; import { registerCanvasUsageCollector } from './collectors'; import { loadSampleData } from './sample_data'; import { setupInterpreter } from './setup_interpreter'; +import { customElementType, workpadType } from './saved_objects'; interface PluginsSetup { expressions: ExpressionsServerSetup; @@ -29,6 +30,9 @@ export class CanvasPlugin implements Plugin { } public async setup(coreSetup: CoreSetup, plugins: PluginsSetup) { + coreSetup.savedObjects.registerType(customElementType); + coreSetup.savedObjects.registerType(workpadType); + plugins.features.registerFeature({ id: 'canvas', name: 'Canvas', diff --git a/x-pack/legacy/plugins/canvas/server/mappings.ts b/x-pack/plugins/canvas/server/saved_objects/custom_element.ts similarity index 56% rename from x-pack/legacy/plugins/canvas/server/mappings.ts rename to x-pack/plugins/canvas/server/saved_objects/custom_element.ts index bf2be51882b1a..dadead0263be1 100644 --- a/x-pack/legacy/plugins/canvas/server/mappings.ts +++ b/x-pack/plugins/canvas/server/saved_objects/custom_element.ts @@ -4,26 +4,14 @@ * you may not use this file except in compliance with the Elastic License. */ -// @ts-ignore converting /libs/constants to TS breaks CI -import { CANVAS_TYPE, CUSTOM_ELEMENT_TYPE } from '../common/lib/constants'; +import { SavedObjectsType } from 'src/core/server'; +import { CUSTOM_ELEMENT_TYPE } from '../../../../legacy/plugins/canvas/common/lib/constants'; -export const mappings = { - [CANVAS_TYPE]: { - dynamic: false, - properties: { - name: { - type: 'text', - fields: { - keyword: { - type: 'keyword', - }, - }, - }, - '@timestamp': { type: 'date' }, - '@created': { type: 'date' }, - }, - }, - [CUSTOM_ELEMENT_TYPE]: { +export const customElementType: SavedObjectsType = { + name: CUSTOM_ELEMENT_TYPE, + hidden: false, + namespaceAgnostic: false, + mappings: { dynamic: false, properties: { name: { @@ -41,4 +29,5 @@ export const mappings = { '@created': { type: 'date' }, }, }, + migrations: {}, }; diff --git a/x-pack/legacy/plugins/canvas/migrations.js b/x-pack/plugins/canvas/server/saved_objects/index.ts similarity index 53% rename from x-pack/legacy/plugins/canvas/migrations.js rename to x-pack/plugins/canvas/server/saved_objects/index.ts index d5b3d3fb1ce2a..dd7e74b87e2f4 100644 --- a/x-pack/legacy/plugins/canvas/migrations.js +++ b/x-pack/plugins/canvas/server/saved_objects/index.ts @@ -4,15 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { CANVAS_TYPE } from './common/lib'; +import { workpadType } from './workpad'; +import { customElementType } from './custom_element'; -export const migrations = { - [CANVAS_TYPE]: { - '7.0.0': doc => { - if (doc.attributes) { - delete doc.attributes.id; - } - return doc; - }, - }, -}; +export { customElementType, workpadType }; diff --git a/x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.test.ts b/x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.test.ts new file mode 100644 index 0000000000000..a7112504e9980 --- /dev/null +++ b/x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.test.ts @@ -0,0 +1,39 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { removeAttributesId } from './remove_attributes_id'; + +const context: any = { + log: jest.fn(), +}; + +describe(`removeAttributesId`, () => { + it('does not throw error on empty object', () => { + const migratedDoc = removeAttributesId({} as any, context); + expect(migratedDoc).toMatchInlineSnapshot(`Object {}`); + }); + + it('removes id from "attributes"', () => { + const migratedDoc = removeAttributesId( + { + foo: true, + attributes: { + id: '123', + bar: true, + }, + } as any, + context + ); + expect(migratedDoc).toMatchInlineSnapshot(` +Object { + "attributes": Object { + "bar": true, + }, + "foo": true, +} +`); + }); +}); diff --git a/x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.ts b/x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.ts new file mode 100644 index 0000000000000..893a73d7b5913 --- /dev/null +++ b/x-pack/plugins/canvas/server/saved_objects/migrations/remove_attributes_id.ts @@ -0,0 +1,14 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { SavedObjectMigrationFn } from 'src/core/server'; + +export const removeAttributesId: SavedObjectMigrationFn = doc => { + if (typeof doc.attributes === 'object' && doc.attributes !== null) { + delete (doc.attributes as any).id; + } + return doc; +}; diff --git a/x-pack/plugins/canvas/server/saved_objects/workpad.ts b/x-pack/plugins/canvas/server/saved_objects/workpad.ts new file mode 100644 index 0000000000000..e83ba9720b43a --- /dev/null +++ b/x-pack/plugins/canvas/server/saved_objects/workpad.ts @@ -0,0 +1,33 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { SavedObjectsType } from 'src/core/server'; +import { CANVAS_TYPE } from '../../../../legacy/plugins/canvas/common/lib/constants'; +import { removeAttributesId } from './migrations/remove_attributes_id'; + +export const workpadType: SavedObjectsType = { + name: CANVAS_TYPE, + hidden: false, + namespaceAgnostic: false, + mappings: { + dynamic: false, + properties: { + name: { + type: 'text', + fields: { + keyword: { + type: 'keyword', + }, + }, + }, + '@timestamp': { type: 'date' }, + '@created': { type: 'date' }, + }, + }, + migrations: { + '7.0.0': removeAttributesId, + }, +}; From 48fd5c025526e3aa6736ca1db2a1f757c90ea508 Mon Sep 17 00:00:00 2001 From: Paul Tavares <56442535+paul-tavares@users.noreply.github.com> Date: Mon, 13 Apr 2020 16:26:45 -0400 Subject: [PATCH 072/102] [Endpoint] Policy list support for URL pagination state (#63291) * store changes to support pagination via url * Fix storing location when pagination happens * Initial set of tests * Redux spy middleware and async utility * Add better types to `waitForAction` * Add more docs * fix urlSearchParams selector to account for array of values * full set of tests for policy list store concerns * More efficient redux spy middleware (no more sleep()) * Set spy middleware `dispatch` to a `jest.fn` and expose `mock` info. * Fix url param selector to return first param value when it is defined multiple times * Removed PageId and associated hook * clean up TODO items * Fixes post-merge frm `master` * Address code review comments --- .../endpoint/store/policy_list/action.ts | 13 +- .../endpoint/store/policy_list/index.test.ts | 168 +++++++++++++++--- .../endpoint/store/policy_list/middleware.ts | 19 +- .../endpoint/store/policy_list/reducer.ts | 29 +-- .../endpoint/store/policy_list/selectors.ts | 50 +++++- .../store/policy_list/services/ingest.ts | 2 +- .../store/policy_list/test_mock_utils.ts | 151 ++++++++++++++++ .../endpoint/store/routing/action.ts | 14 +- .../public/applications/endpoint/types.ts | 10 ++ .../endpoint/view/policy/policy_list.tsx | 17 +- .../applications/endpoint/view/use_page_id.ts | 28 --- 11 files changed, 384 insertions(+), 117 deletions(-) create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts delete mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/action.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/action.ts index 3f4f3f39e9be0..3db224f049c05 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/action.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/action.ts @@ -21,15 +21,4 @@ interface ServerFailedToReturnPolicyListData { payload: ServerApiError; } -interface UserPaginatedPolicyListTable { - type: 'userPaginatedPolicyListTable'; - payload: { - pageSize: number; - pageIndex: number; - }; -} - -export type PolicyListAction = - | ServerReturnedPolicyListData - | UserPaginatedPolicyListTable - | ServerFailedToReturnPolicyListData; +export type PolicyListAction = ServerReturnedPolicyListData | ServerFailedToReturnPolicyListData; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/index.test.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/index.test.ts index 0cf0eb8bfa3cd..4d153b5e03cd2 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/index.test.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/index.test.ts @@ -4,71 +4,106 @@ * you may not use this file except in compliance with the Elastic License. */ -import { PolicyListState } from '../../types'; +import { EndpointAppLocation, PolicyListState } from '../../types'; import { applyMiddleware, createStore, Dispatch, Store } from 'redux'; import { AppAction } from '../action'; import { policyListReducer } from './reducer'; import { policyListMiddlewareFactory } from './middleware'; import { coreMock } from '../../../../../../../../src/core/public/mocks'; -import { CoreStart } from 'kibana/public'; -import { selectIsLoading } from './selectors'; +import { isOnPolicyListPage, selectIsLoading, urlSearchParams } from './selectors'; import { DepsStartMock, depsStartMock } from '../../mocks'; +import { + createSpyMiddleware, + MiddlewareActionSpyHelper, + setPolicyListApiMockImplementation, +} from './test_mock_utils'; +import { INGEST_API_DATASOURCES } from './services/ingest'; describe('policy list store concerns', () => { - const sleep = () => new Promise(resolve => setTimeout(resolve, 1000)); - let fakeCoreStart: jest.Mocked<CoreStart>; + let fakeCoreStart: ReturnType<typeof coreMock.createStart>; let depsStart: DepsStartMock; let store: Store<PolicyListState>; let getState: typeof store['getState']; let dispatch: Dispatch<AppAction>; + let waitForAction: MiddlewareActionSpyHelper['waitForAction']; beforeEach(() => { fakeCoreStart = coreMock.createStart({ basePath: '/mock' }); depsStart = depsStartMock(); + setPolicyListApiMockImplementation(fakeCoreStart.http); + let actionSpyMiddleware; + ({ actionSpyMiddleware, waitForAction } = createSpyMiddleware<PolicyListState>()); + store = createStore( policyListReducer, - applyMiddleware(policyListMiddlewareFactory(fakeCoreStart, depsStart)) + applyMiddleware(policyListMiddlewareFactory(fakeCoreStart, depsStart), actionSpyMiddleware) ); getState = store.getState; dispatch = store.dispatch; }); - // https://github.com/elastic/kibana/issues/58972 - test.skip('it sets `isLoading` when `userNavigatedToPage`', async () => { - expect(selectIsLoading(getState())).toBe(false); - dispatch({ type: 'userNavigatedToPage', payload: 'policyListPage' }); - expect(selectIsLoading(getState())).toBe(true); - await sleep(); - expect(selectIsLoading(getState())).toBe(false); + it('it does nothing on `userChangedUrl` if pathname is NOT `/policy`', async () => { + const state = getState(); + expect(isOnPolicyListPage(state)).toBe(false); + dispatch({ + type: 'userChangedUrl', + payload: { + pathname: '/foo', + search: '', + hash: '', + } as EndpointAppLocation, + }); + expect(getState()).toEqual(state); }); - // https://github.com/elastic/kibana/issues/58896 - test.skip('it sets `isLoading` when `userPaginatedPolicyListTable`', async () => { + it('it reports `isOnPolicyListPage` correctly when router pathname is `/policy`', async () => { + dispatch({ + type: 'userChangedUrl', + payload: { + pathname: '/policy', + search: '', + hash: '', + }, + }); + expect(isOnPolicyListPage(getState())).toBe(true); + }); + + it('it sets `isLoading` when `userChangedUrl`', async () => { expect(selectIsLoading(getState())).toBe(false); dispatch({ - type: 'userPaginatedPolicyListTable', + type: 'userChangedUrl', payload: { - pageSize: 10, - pageIndex: 1, + pathname: '/policy', + search: '', + hash: '', }, }); expect(selectIsLoading(getState())).toBe(true); - await sleep(); + await waitForAction('serverReturnedPolicyListData'); expect(selectIsLoading(getState())).toBe(false); }); - test('it resets state on `userNavigatedFromPage` action', async () => { + it('it resets state on `userChangedUrl` and pathname is NOT `/policy`', async () => { + dispatch({ + type: 'userChangedUrl', + payload: { + pathname: '/policy', + search: '', + hash: '', + }, + }); + await waitForAction('serverReturnedPolicyListData'); dispatch({ - type: 'serverReturnedPolicyListData', + type: 'userChangedUrl', payload: { - policyItems: [], - pageIndex: 20, - pageSize: 50, - total: 200, + pathname: '/foo', + search: '', + hash: '', }, }); - dispatch({ type: 'userNavigatedFromPage', payload: 'policyListPage' }); expect(getState()).toEqual({ + apiError: undefined, + location: undefined, policyItems: [], isLoading: false, pageIndex: 0, @@ -76,4 +111,85 @@ describe('policy list store concerns', () => { total: 0, }); }); + it('uses default pagination params when not included in url', async () => { + dispatch({ + type: 'userChangedUrl', + payload: { + pathname: '/policy', + search: '', + hash: '', + }, + }); + await waitForAction('serverReturnedPolicyListData'); + expect(fakeCoreStart.http.get).toHaveBeenCalledWith(INGEST_API_DATASOURCES, { + query: { kuery: 'datasources.package.name: endpoint', page: 1, perPage: 10 }, + }); + }); + + describe('when url contains search params', () => { + const dispatchUserChangedUrl = (searchParams: string = '') => + dispatch({ + type: 'userChangedUrl', + payload: { + pathname: '/policy', + search: searchParams, + hash: '', + }, + }); + + it('uses pagination params from url', async () => { + dispatchUserChangedUrl('?page_size=50&page_index=0'); + await waitForAction('serverReturnedPolicyListData'); + expect(fakeCoreStart.http.get).toHaveBeenCalledWith(INGEST_API_DATASOURCES, { + query: { kuery: 'datasources.package.name: endpoint', page: 1, perPage: 50 }, + }); + }); + it('uses defaults for params not in url', async () => { + dispatchUserChangedUrl('?page_index=99'); + expect(urlSearchParams(getState())).toEqual({ + page_index: 99, + page_size: 10, + }); + dispatchUserChangedUrl('?page_size=50'); + expect(urlSearchParams(getState())).toEqual({ + page_index: 0, + page_size: 50, + }); + }); + it('accepts only positive numbers for page_index and page_size', async () => { + dispatchUserChangedUrl('?page_size=-50&page_index=-99'); + await waitForAction('serverReturnedPolicyListData'); + expect(fakeCoreStart.http.get).toHaveBeenCalledWith(INGEST_API_DATASOURCES, { + query: { kuery: 'datasources.package.name: endpoint', page: 1, perPage: 10 }, + }); + }); + it('it ignores non-numeric values for page_index and page_size', async () => { + dispatchUserChangedUrl('?page_size=fifty&page_index=ten'); + await waitForAction('serverReturnedPolicyListData'); + expect(fakeCoreStart.http.get).toHaveBeenCalledWith(INGEST_API_DATASOURCES, { + query: { kuery: 'datasources.package.name: endpoint', page: 1, perPage: 10 }, + }); + }); + it('accepts only known values for `page_size`', async () => { + dispatchUserChangedUrl('?page_size=300&page_index=10'); + await waitForAction('serverReturnedPolicyListData'); + expect(fakeCoreStart.http.get).toHaveBeenCalledWith(INGEST_API_DATASOURCES, { + query: { kuery: 'datasources.package.name: endpoint', page: 11, perPage: 10 }, + }); + }); + it(`ignores unknown url search params`, async () => { + dispatchUserChangedUrl('?page_size=20&page_index=10&foo=bar'); + expect(urlSearchParams(getState())).toEqual({ + page_index: 10, + page_size: 20, + }); + }); + it(`uses last param value if param is defined multiple times`, async () => { + dispatchUserChangedUrl('?page_size=20&page_size=50&page_index=20&page_index=40'); + expect(urlSearchParams(getState())).toEqual({ + page_index: 20, + page_size: 20, + }); + }); + }); }); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts index adc176740fb4b..c073d26a676f0 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts @@ -6,6 +6,7 @@ import { MiddlewareFactory, PolicyListState, GetDatasourcesResponse } from '../../types'; import { sendGetEndpointSpecificDatasources } from './services/ingest'; +import { isOnPolicyListPage, urlSearchParams } from './selectors'; export const policyListMiddlewareFactory: MiddlewareFactory<PolicyListState> = coreStart => { const http = coreStart.http; @@ -13,22 +14,10 @@ export const policyListMiddlewareFactory: MiddlewareFactory<PolicyListState> = c return ({ getState, dispatch }) => next => async action => { next(action); - if ( - (action.type === 'userNavigatedToPage' && action.payload === 'policyListPage') || - action.type === 'userPaginatedPolicyListTable' - ) { - const state = getState(); - let pageSize: number; - let pageIndex: number; - - if (action.type === 'userPaginatedPolicyListTable') { - pageSize = action.payload.pageSize; - pageIndex = action.payload.pageIndex; - } else { - pageSize = state.pageSize; - pageIndex = state.pageIndex; - } + const state = getState(); + if (action.type === 'userChangedUrl' && isOnPolicyListPage(state)) { + const { page_index: pageIndex, page_size: pageSize } = urlSearchParams(state); let response: GetDatasourcesResponse; try { diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/reducer.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/reducer.ts index b964f4f023866..30c1deac7f5e1 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/reducer.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/reducer.ts @@ -7,6 +7,7 @@ import { Reducer } from 'redux'; import { PolicyListState } from '../../types'; import { AppAction } from '../action'; +import { isOnPolicyListPage } from './selectors'; const initialPolicyListState = (): PolicyListState => { return { @@ -16,6 +17,7 @@ const initialPolicyListState = (): PolicyListState => { pageIndex: 0, pageSize: 10, total: 0, + location: undefined, }; }; @@ -39,19 +41,26 @@ export const policyListReducer: Reducer<PolicyListState, AppAction> = ( }; } - if ( - action.type === 'userPaginatedPolicyListTable' || - (action.type === 'userNavigatedToPage' && action.payload === 'policyListPage') - ) { - return { + if (action.type === 'userChangedUrl') { + const newState = { ...state, - apiError: undefined, - isLoading: true, + location: action.payload, }; - } + const isCurrentlyOnListPage = isOnPolicyListPage(newState); + const wasPreviouslyOnListPage = isOnPolicyListPage(state); - if (action.type === 'userNavigatedFromPage' && action.payload === 'policyListPage') { - return initialPolicyListState(); + // If on the current page, then return new state with location information + // Also adjust some state if user is just entering the policy list view + if (isCurrentlyOnListPage) { + if (!wasPreviouslyOnListPage) { + newState.apiError = undefined; + newState.isLoading = true; + } + return newState; + } + return { + ...initialPolicyListState(), + }; } return state; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/selectors.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/selectors.ts index 7ca25e81ce75a..ce13d89b2b8c2 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/selectors.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/selectors.ts @@ -4,7 +4,11 @@ * you may not use this file except in compliance with the Elastic License. */ -import { PolicyListState } from '../../types'; +import { createSelector } from 'reselect'; +import { parse } from 'query-string'; +import { PolicyListState, PolicyListUrlSearchParams } from '../../types'; + +const PAGE_SIZES = Object.freeze([10, 20, 50]); export const selectPolicyItems = (state: PolicyListState) => state.policyItems; @@ -17,3 +21,47 @@ export const selectTotal = (state: PolicyListState) => state.total; export const selectIsLoading = (state: PolicyListState) => state.isLoading; export const selectApiError = (state: PolicyListState) => state.apiError; + +export const isOnPolicyListPage = (state: PolicyListState) => { + return state.location?.pathname === '/policy'; +}; + +const routeLocation = (state: PolicyListState) => state.location; + +/** + * Returns the supported URL search params, populated with defaults if none where present in the URL + */ +export const urlSearchParams: ( + state: PolicyListState +) => PolicyListUrlSearchParams = createSelector(routeLocation, location => { + const searchParams = { + page_index: 0, + page_size: 10, + }; + if (!location) { + return searchParams; + } + + const query = parse(location.search); + + // Search params can appear multiple times in the URL, in which case the value for them, + // once parsed, would be an array. In these case, we take the first value defined + searchParams.page_index = Number( + (Array.isArray(query.page_index) ? query.page_index[0] : query.page_index) ?? 0 + ); + searchParams.page_size = Number( + (Array.isArray(query.page_size) ? query.page_size[0] : query.page_size) ?? 10 + ); + + // If pageIndex is not a valid positive integer, set it to 0 + if (!Number.isFinite(searchParams.page_index) || searchParams.page_index < 0) { + searchParams.page_index = 0; + } + + // if pageSize is not one of the expected page sizes, reset it to 10 + if (!PAGE_SIZES.includes(searchParams.page_size)) { + searchParams.page_size = 10; + } + + return searchParams; +}); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts index 16c885f26f0a4..bfbb5f94e8950 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts @@ -17,7 +17,7 @@ import { } from '../../../types'; const INGEST_API_ROOT = `/api/ingest_manager`; -const INGEST_API_DATASOURCES = `${INGEST_API_ROOT}/datasources`; +export const INGEST_API_DATASOURCES = `${INGEST_API_ROOT}/datasources`; const INGEST_API_FLEET = `${INGEST_API_ROOT}/fleet`; const INGEST_API_FLEET_AGENT_STATUS = `${INGEST_API_FLEET}/agent-status`; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts new file mode 100644 index 0000000000000..0d41ae0d76da4 --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts @@ -0,0 +1,151 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { HttpStart } from 'kibana/public'; +import { Dispatch } from 'redux'; +import { INGEST_API_DATASOURCES } from './services/ingest'; +import { EndpointDocGenerator } from '../../../../../common/generate_data'; +import { AppAction, GetDatasourcesResponse, GlobalState, MiddlewareFactory } from '../../types'; + +const generator = new EndpointDocGenerator('policy-list'); + +/** + * It sets the mock implementation on the necessary http methods to support the policy list view + * @param mockedHttpService + * @param responseItems + */ +export const setPolicyListApiMockImplementation = ( + mockedHttpService: jest.Mocked<HttpStart>, + responseItems: GetDatasourcesResponse['items'] = [generator.generatePolicyDatasource()] +): void => { + mockedHttpService.get.mockImplementation((...args) => { + const [path] = args; + if (typeof path === 'string') { + if (path === INGEST_API_DATASOURCES) { + return Promise.resolve<GetDatasourcesResponse>({ + items: responseItems, + total: 10, + page: 1, + perPage: 10, + success: true, + }); + } + } + return Promise.reject(new Error(`MOCK: unknown policy list api: ${path}`)); + }); +}; + +/** + * Utilities for testing Redux middleware + */ +export interface MiddlewareActionSpyHelper<S = GlobalState> { + /** + * Returns a promise that is fulfilled when the given action is dispatched or a timeout occurs. + * The use of this method instead of a `sleep()` type of delay should avoid test case instability + * especially when run in a CI environment. + * + * @param actionType + */ + waitForAction: (actionType: AppAction['type']) => Promise<void>; + /** + * A property holding the information around the calls that were processed by the internal + * `actionSpyMiddlware`. This property holds the information typically found in Jets's mocked + * function `mock` property - [see here for more information](https://jestjs.io/docs/en/mock-functions#mock-property) + * + * **Note**: this property will only be set **after* the `actionSpyMiddlware` has been + * initialized (ex. via `createStore()`. Attempting to reference this property before that time + * will throw an error. + * Also - do not hold on to references to this property value if `jest.clearAllMocks()` or + * `jest.resetAllMocks()` is called between usages of the value. + */ + dispatchSpy: jest.Mock<Dispatch<AppAction>>['mock']; + /** + * Redux middleware that enables spying on the action that are dispatched through the store + */ + actionSpyMiddleware: ReturnType<MiddlewareFactory<S>>; +} + +/** + * Creates a new instance of middleware action helpers + * Note: in most cases (testing concern specific middleware) this function should be given + * the state type definition, else, the global state will be used. + * + * @example + * // Use in Policy List middleware testing + * const middlewareSpyUtils = createSpyMiddleware<PolicyListState>(); + * store = createStore( + * policyListReducer, + * applyMiddleware( + * policyListMiddlewareFactory(fakeCoreStart, depsStart), + * middlewareSpyUtils.actionSpyMiddleware + * ) + * ); + * // Reference `dispatchSpy` ONLY after creating the store that includes `actionSpyMiddleware` + * const { waitForAction, dispatchSpy } = middlewareSpyUtils; + * // + * // later in test + * // + * it('...', async () => { + * //... + * await waitForAction('serverReturnedPolicyListData'); + * // do assertions + * // or check how action was called + * expect(dispatchSpy.calls.length).toBe(2) + * }); + */ +export const createSpyMiddleware = <S = GlobalState>(): MiddlewareActionSpyHelper<S> => { + type ActionWatcher = (action: AppAction) => void; + + const watchers = new Set<ActionWatcher>(); + let spyDispatch: jest.Mock<Dispatch<AppAction>>; + + return { + waitForAction: async (actionType: string) => { + // Error is defined here so that we get a better stack trace that points to the test from where it was used + const err = new Error(`action '${actionType}' was not dispatched within the allocated time`); + + await new Promise((resolve, reject) => { + const watch: ActionWatcher = action => { + if (action.type === actionType) { + watchers.delete(watch); + clearTimeout(timeout); + resolve(); + } + }; + + // We timeout before jest's default 5s, so that a better error stack is returned + const timeout = setTimeout(() => { + watchers.delete(watch); + reject(err); + }, 4500); + watchers.add(watch); + }); + }, + + get dispatchSpy() { + if (!spyDispatch) { + throw new Error( + 'Spy Middleware has not been initialized. Access this property only after using `actionSpyMiddleware` in a redux store' + ); + } + return spyDispatch.mock; + }, + + actionSpyMiddleware: api => { + return next => { + spyDispatch = jest.fn(action => { + next(action); + // loop through the list of watcher (if any) and call them with this action + for (const watch of watchers) { + watch(action); + } + return action; + }); + return spyDispatch; + }; + }, + }; +}; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts index f22272bc68233..fd72a02b33588 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/routing/action.ts @@ -5,21 +5,11 @@ */ import { Immutable } from '../../../../../common/types'; -import { EndpointAppLocation, PageId } from '../../types'; - -interface UserNavigatedToPage { - readonly type: 'userNavigatedToPage'; - readonly payload: PageId; -} - -interface UserNavigatedFromPage { - readonly type: 'userNavigatedFromPage'; - readonly payload: PageId; -} +import { EndpointAppLocation } from '../../types'; interface UserChangedUrl { readonly type: 'userChangedUrl'; readonly payload: Immutable<EndpointAppLocation>; } -export type RoutingAction = UserNavigatedToPage | UserNavigatedFromPage | UserChangedUrl; +export type RoutingAction = UserChangedUrl; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts index f9ad8f6708f6b..a625c49bf7d5a 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts @@ -95,6 +95,8 @@ export interface PolicyListState { pageIndex: number; /** data is being retrieved from server */ isLoading: boolean; + /** current location information */ + location?: Immutable<EndpointAppLocation>; } /** @@ -117,6 +119,14 @@ export interface PolicyDetailsState { }; } +/** + * The URL search params that are supported by the Policy List page view + */ +export interface PolicyListUrlSearchParams { + page_index: number; + page_size: number; +} + /** * Endpoint Policy configuration */ diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx index 06ba74aa46732..295312fff01dd 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_list.tsx @@ -9,8 +9,7 @@ import { EuiBasicTable, EuiText, EuiTableFieldDataColumnType, EuiLink } from '@e import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; import { useDispatch } from 'react-redux'; -import { useHistory } from 'react-router-dom'; -import { usePageId } from '../use_page_id'; +import { useHistory, useLocation } from 'react-router-dom'; import { selectApiError, selectIsLoading, @@ -50,9 +49,9 @@ const renderPolicyNameLink = (value: string, _item: PolicyData) => { }; export const PolicyList = React.memo(() => { - usePageId('policyListPage'); - const { services, notifications } = useKibana(); + const history = useHistory(); + const location = useLocation(); const dispatch = useDispatch<(action: PolicyListAction) => void>(); const policyItems = usePolicyListSelector(selectPolicyItems); @@ -84,15 +83,9 @@ export const PolicyList = React.memo(() => { const handleTableChange = useCallback( ({ page: { index, size } }: TableChangeCallbackArguments) => { - dispatch({ - type: 'userPaginatedPolicyListTable', - payload: { - pageIndex: index, - pageSize: size, - }, - }); + history.push(`${location.pathname}?page_index=${index}&page_size=${size}`); }, - [dispatch] + [history, location.pathname] ); const columns: Array<EuiTableFieldDataColumnType<PolicyData>> = useMemo( diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts b/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts deleted file mode 100644 index 85ed8a39fb386..0000000000000 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/use_page_id.ts +++ /dev/null @@ -1,28 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { useEffect } from 'react'; -import { useDispatch } from 'react-redux'; -import { RoutingAction } from '../store/routing'; -import { PageId } from '../types'; - -/** - * Dispatches a 'userNavigatedToPage' action with the given 'pageId' as the action payload. - * When the component is un-mounted, a `userNavigatedFromPage` action will be dispatched - * with the given `pageId`. - * - * @param pageId A page id - */ -export function usePageId(pageId: PageId) { - const dispatch: (action: RoutingAction) => unknown = useDispatch(); - useEffect(() => { - dispatch({ type: 'userNavigatedToPage', payload: pageId }); - - return () => { - dispatch({ type: 'userNavigatedFromPage', payload: pageId }); - }; - }, [dispatch, pageId]); -} From 0666dbd35fe3ad8e8cd8824c23ed66c7465c8a6c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Mike=20C=C3=B4t=C3=A9?= <mikecote@users.noreply.github.com> Date: Mon, 13 Apr 2020 16:29:48 -0400 Subject: [PATCH 073/102] Fix task manager query to return tasks to retry (#63360) * Fix task manager query to also return tasks to retry * Fix failing jest tests --- .../server/queries/mark_available_tasks_as_claimed.ts | 7 ++++--- x-pack/plugins/task_manager/server/task_store.test.ts | 4 ++-- 2 files changed, 6 insertions(+), 5 deletions(-) diff --git a/x-pack/plugins/task_manager/server/queries/mark_available_tasks_as_claimed.ts b/x-pack/plugins/task_manager/server/queries/mark_available_tasks_as_claimed.ts index b0d9dc61c9667..8f7cc47f936b2 100644 --- a/x-pack/plugins/task_manager/server/queries/mark_available_tasks_as_claimed.ts +++ b/x-pack/plugins/task_manager/server/queries/mark_available_tasks_as_claimed.ts @@ -11,7 +11,7 @@ import { RangeFilter, mustBeAllOf, MustCondition, - MustNotCondition, + BoolClauseWithAnyCondition, } from './query_clauses'; export const TaskWithSchedule: ExistsFilter = { @@ -54,15 +54,16 @@ export const IdleTaskWithExpiredRunAt: MustCondition<TermFilter | RangeFilter> = }, }; -export const InactiveTasks: MustNotCondition<TermFilter | RangeFilter> = { +// TODO: Fix query clauses to support this +export const InactiveTasks: BoolClauseWithAnyCondition<any> = { bool: { must_not: [ { bool: { should: [{ term: { 'task.status': 'running' } }, { term: { 'task.status': 'claiming' } }], + must: { range: { 'task.retryAt': { gt: 'now' } } }, }, }, - { range: { 'task.retryAt': { gt: 'now' } } }, ], }, }; diff --git a/x-pack/plugins/task_manager/server/task_store.test.ts b/x-pack/plugins/task_manager/server/task_store.test.ts index 97794311fb3d2..4ecefcb7984eb 100644 --- a/x-pack/plugins/task_manager/server/task_store.test.ts +++ b/x-pack/plugins/task_manager/server/task_store.test.ts @@ -407,9 +407,9 @@ describe('TaskStore', () => { { term: { 'task.status': 'running' } }, { term: { 'task.status': 'claiming' } }, ], + must: { range: { 'task.retryAt': { gt: 'now' } } }, }, }, - { range: { 'task.retryAt': { gt: 'now' } } }, ], }, }, @@ -553,9 +553,9 @@ describe('TaskStore', () => { { term: { 'task.status': 'running' } }, { term: { 'task.status': 'claiming' } }, ], + must: { range: { 'task.retryAt': { gt: 'now' } } }, }, }, - { range: { 'task.retryAt': { gt: 'now' } } }, ], }, }, From 6f46e6b827ce5c35e7195bb32bf0bc6361686189 Mon Sep 17 00:00:00 2001 From: Aaron Caldwell <aaron.caldwell@elastic.co> Date: Mon, 13 Apr 2020 14:32:32 -0600 Subject: [PATCH 074/102] Migrate legacy maps service to NP & update refs (#60942) * Get legacy maps into basic NP plugin form. Swap out legacy services for NP * Pull service settings from injected vars. Return new instance of service settings from setup * Use NP service settings in vega maps. Clean up legacy shim * Use NP maps service in region maps. Clean up shim. Add exports to NP service * Pull zoom precision out to separate module since it's dependent on config * Update paths to point to NP resources * More path updates, clean up, use IServiceSettings * Remove dependency on legacy service settings. Add tile_map dependency ng-sanitize * More path cleanup. Use zoomPrecision provided through plugin inteface * Move getPrecision into contract-provided function since it depends on config * Move tests to new service location, remove vis dir * Update test paths. Move origin const declaration into public * Clean up, fixes * Fix type errors. General cleaning * Inject toast service into map when needed * Fix typo in regionmap config * i18n fixes * Update jest test path * Fix karma tests * i18n fixes * Type updates. Add mapsLegacy to np karma mock * Remove html sanitizer * Fix vega test that depends on serviceSettings * Revise xpack license handling to use NP serviceSettings. Remove angular bindings Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .i18nrc.json | 1 + .../core_plugins/kibana/public/index.scss | 2 +- .../__tests__/region_map_visualization.js | 48 +++- .../region_map/public/choropleth_layer.js | 4 +- .../public/components/region_map_options.tsx | 9 +- .../core_plugins/region_map/public/legacy.ts | 9 +- .../core_plugins/region_map/public/plugin.ts | 10 +- .../public/region_map_visualization.js | 12 +- .../public/shim/legacy_dependencies_plugin.ts | 11 - .../core_plugins/region_map/public/types.ts | 2 +- .../core_plugins/region_map/public/util.ts | 2 +- .../coordinate_maps_visualization.js | 55 +++- .../public/__tests__/geohash_layer.js | 2 +- .../public/base_maps_visualization.js | 12 +- .../public/components/wms_options.tsx | 3 +- .../tile_map/public/geohash_layer.js | 3 +- .../core_plugins/tile_map/public/legacy.ts | 1 + .../tile_map/public/markers/scaled_circles.js | 3 +- .../core_plugins/tile_map/public/plugin.ts | 13 +- .../public/shim/legacy_dependencies_plugin.ts | 9 +- .../tile_map/public/tile_map_fn.js | 2 +- .../tile_map/public/tile_map_type.js | 4 +- .../tile_map/public/tile_map_visualization.js | 21 +- .../tile_map/public/tilemap_fn.test.js | 4 +- .../core_plugins/tile_map/public/types.ts | 2 +- .../public/shim/timelion_legacy_module.ts | 1 - .../public/__tests__/vega_visualization.js | 33 ++- .../vis_type_vega/public/legacy.ts | 6 +- .../vis_type_vega/public/plugin.ts | 11 +- .../public/shim/legacy_dependencies_plugin.ts | 49 ---- .../public/vega_view/vega_map_layer.js | 2 +- .../public/vega_view/vega_map_view.js | 27 +- .../public/vega_visualization.js | 3 +- .../new_platform/new_platform.karma_mock.js | 6 + .../ui/public/new_platform/new_platform.ts | 2 + .../ui/public/vis/map/service_settings.js | 256 ------------------ src/plugins/maps_legacy/kibana.json | 6 + .../__tests__/map/ems_mocks/sample_files.json | 0 .../map/ems_mocks/sample_manifest.json | 0 .../map/ems_mocks/sample_style_bright.json | 0 .../ems_mocks/sample_style_bright_vector.json | 0 .../sample_style_bright_vector_source.json | 0 .../map/ems_mocks/sample_style_dark.json | 0 .../ems_mocks/sample_style_desaturated.json | 0 .../__tests__/map/ems_mocks/sample_tiles.json | 0 .../public}/__tests__/map/kibana_map.js | 0 .../public}/__tests__/map/service_settings.js | 2 +- .../maps_legacy/public}/_index.scss | 0 .../maps_legacy/public/common/origin.ts} | 5 +- src/plugins/maps_legacy/public/index.ts | 61 +++++ .../maps_legacy/public/kibana_services.js} | 15 +- .../maps_legacy/public}/map/_index.scss | 0 .../public}/map/_leaflet_overrides.scss | 0 .../maps_legacy/public}/map/_legend.scss | 0 .../maps_legacy/public}/map/color_util.js | 0 .../public}/map/convert_to_geojson.js | 0 .../public}/map/decode_geo_hash.test.ts | 0 .../public}/map/decode_geo_hash.ts | 52 +--- .../public}/map/grid_dimensions.js | 0 .../maps_legacy/public}/map/kibana_map.js | 27 +- .../public}/map/kibana_map_layer.js | 0 .../maps_legacy/public}/map/map_messages.js | 9 +- .../maps_legacy/public/map/precision.ts | 74 +++++ .../public}/map/service_settings.d.ts | 2 +- .../public/map/service_settings.js | 254 +++++++++++++++++ .../public}/map/zoom_to_precision.ts | 0 src/plugins/maps_legacy/public/plugin.ts | 57 ++++ .../update_tilemap_settings.js | 17 +- .../translations/translations/ja-JP.json | 2 - .../translations/translations/zh-CN.json | 2 - 70 files changed, 733 insertions(+), 492 deletions(-) delete mode 100644 src/legacy/core_plugins/vis_type_vega/public/shim/legacy_dependencies_plugin.ts delete mode 100644 src/legacy/ui/public/vis/map/service_settings.js create mode 100644 src/plugins/maps_legacy/kibana.json rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_files.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_manifest.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_style_bright.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_style_bright_vector.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_style_bright_vector_source.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_style_dark.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_style_desaturated.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/ems_mocks/sample_tiles.json (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/kibana_map.js (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/__tests__/map/service_settings.js (99%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/_index.scss (100%) rename src/{legacy/core_plugins/vis_type_vega/public/shim/index.ts => plugins/maps_legacy/public/common/origin.ts} (90%) create mode 100644 src/plugins/maps_legacy/public/index.ts rename src/{legacy/core_plugins/vis_type_vega/public/legacy_imports.ts => plugins/maps_legacy/public/kibana_services.js} (64%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/_index.scss (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/_leaflet_overrides.scss (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/_legend.scss (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/color_util.js (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/convert_to_geojson.js (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/decode_geo_hash.test.ts (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/decode_geo_hash.ts (79%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/grid_dimensions.js (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/kibana_map.js (96%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/kibana_map_layer.js (100%) rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/map_messages.js (93%) create mode 100644 src/plugins/maps_legacy/public/map/precision.ts rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/service_settings.d.ts (97%) create mode 100644 src/plugins/maps_legacy/public/map/service_settings.js rename src/{legacy/ui/public/vis => plugins/maps_legacy/public}/map/zoom_to_precision.ts (100%) create mode 100644 src/plugins/maps_legacy/public/plugin.ts diff --git a/.i18nrc.json b/.i18nrc.json index 19d361aed9344..e18f529b92ac3 100644 --- a/.i18nrc.json +++ b/.i18nrc.json @@ -24,6 +24,7 @@ "src/legacy/core_plugins/management", "src/plugins/management" ], + "maps_legacy": "src/plugins/maps_legacy", "indexPatternManagement": "src/plugins/index_pattern_management", "advancedSettings": "src/plugins/advanced_settings", "kibana_legacy": "src/plugins/kibana_legacy", diff --git a/src/legacy/core_plugins/kibana/public/index.scss b/src/legacy/core_plugins/kibana/public/index.scss index 9b7d0afcd7e39..fbfb0a06fabcf 100644 --- a/src/legacy/core_plugins/kibana/public/index.scss +++ b/src/legacy/core_plugins/kibana/public/index.scss @@ -17,7 +17,7 @@ @import './visualize/index'; // Has to come after visualize because of some // bad cascading in the Editor layout -@import 'src/legacy/ui/public/vis/index'; +@import '../../../../plugins/maps_legacy/public/index'; // Home styles @import '../../../../plugins/home/public/application/index'; diff --git a/src/legacy/core_plugins/region_map/public/__tests__/region_map_visualization.js b/src/legacy/core_plugins/region_map/public/__tests__/region_map_visualization.js index 3880f42d52561..6e1b0b7160941 100644 --- a/src/legacy/core_plugins/region_map/public/__tests__/region_map_visualization.js +++ b/src/legacy/core_plugins/region_map/public/__tests__/region_map_visualization.js @@ -23,12 +23,18 @@ import _ from 'lodash'; import ChoroplethLayer from '../choropleth_layer'; import { ImageComparator } from 'test_utils/image_comparator'; import worldJson from './world.json'; -import EMS_CATALOGUE from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_manifest.json'; -import EMS_FILES from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_files.json'; -import EMS_TILES from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_tiles.json'; -import EMS_STYLE_ROAD_MAP_BRIGHT from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_style_bright'; -import EMS_STYLE_ROAD_MAP_DESATURATED from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_style_desaturated'; -import EMS_STYLE_DARK_MAP from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_style_dark'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_CATALOGUE from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_manifest.json'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_FILES from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_files.json'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_TILES from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_tiles.json'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_STYLE_ROAD_MAP_BRIGHT from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_STYLE_ROAD_MAP_DESATURATED from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_desaturated'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_STYLE_DARK_MAP from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_dark'; import initialPng from './initial.png'; import toiso3Png from './toiso3.png'; @@ -44,6 +50,10 @@ import { createRegionMapTypeDefinition } from '../region_map_type'; import { ExprVis } from '../../../../../plugins/visualizations/public/expressions/vis'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { BaseVisType } from '../../../../../plugins/visualizations/public/vis_types/base_vis_type'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { setInjectedVarFunc } from '../../../../../plugins/maps_legacy/public/kibana_services'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { ServiceSettings } from '../../../../../plugins/maps_legacy/public/map/service_settings'; const THRESHOLD = 0.45; const PIXEL_DIFF = 96; @@ -92,7 +102,31 @@ describe('RegionMapsVisualizationTests', function() { let getManifestStub; beforeEach( ngMock.inject((Private, $injector) => { - const serviceSettings = $injector.get('serviceSettings'); + setInjectedVarFunc(injectedVar => { + switch (injectedVar) { + case 'mapConfig': + return { + emsFileApiUrl: '', + emsTileApiUrl: '', + emsLandingPageUrl: '', + }; + case 'tilemapsConfig': + return { + deprecated: { + config: { + options: { + attribution: '123', + }, + }, + }, + }; + case 'version': + return '123'; + default: + return 'not found'; + } + }); + const serviceSettings = new ServiceSettings(); const uiSettings = $injector.get('config'); const regionmapsConfig = { includeElasticMapsService: true, diff --git a/src/legacy/core_plugins/region_map/public/choropleth_layer.js b/src/legacy/core_plugins/region_map/public/choropleth_layer.js index e637a217bfbc3..4ea9cc1f7bfbf 100644 --- a/src/legacy/core_plugins/region_map/public/choropleth_layer.js +++ b/src/legacy/core_plugins/region_map/public/choropleth_layer.js @@ -22,11 +22,9 @@ import L from 'leaflet'; import _ from 'lodash'; import d3 from 'd3'; import { i18n } from '@kbn/i18n'; -import { KibanaMapLayer } from 'ui/vis/map/kibana_map_layer'; import * as topojson from 'topojson-client'; import { toastNotifications } from 'ui/notify'; -import * as colorUtil from 'ui/vis/map/color_util'; - +import { colorUtil, KibanaMapLayer } from '../../../../plugins/maps_legacy/public'; import { truncatedColorMaps } from '../../../../plugins/charts/public'; const EMPTY_STYLE = { diff --git a/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx b/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx index 187b27953830d..31a27c4da7fcf 100644 --- a/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx +++ b/src/legacy/core_plugins/region_map/public/components/region_map_options.tsx @@ -21,9 +21,12 @@ import React, { useCallback, useMemo } from 'react'; import { EuiIcon, EuiLink, EuiPanel, EuiSpacer, EuiText, EuiTitle } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; - -import { FileLayerField, VectorLayer, ServiceSettings } from 'ui/vis/map/service_settings'; import { VisOptionsProps } from 'src/plugins/vis_default_editor/public'; +import { + FileLayerField, + VectorLayer, + IServiceSettings, +} from '../../../../../plugins/maps_legacy/public'; import { NumberInputOption, SelectOption, @@ -43,7 +46,7 @@ const mapFieldForOption = ({ description, name }: FileLayerField) => ({ }); export type RegionMapOptionsProps = { - serviceSettings: ServiceSettings; + serviceSettings: IServiceSettings; } & VisOptionsProps<RegionMapVisParams>; function RegionMapOptions(props: RegionMapOptionsProps) { diff --git a/src/legacy/core_plugins/region_map/public/legacy.ts b/src/legacy/core_plugins/region_map/public/legacy.ts index 08615946affa2..b0cc767a044e8 100644 --- a/src/legacy/core_plugins/region_map/public/legacy.ts +++ b/src/legacy/core_plugins/region_map/public/legacy.ts @@ -20,21 +20,18 @@ import { PluginInitializerContext } from 'kibana/public'; import { npSetup, npStart } from 'ui/new_platform'; -import { RegionMapPluginSetupDependencies, RegionMapsConfig } from './plugin'; +import { RegionMapPluginSetupDependencies } from './plugin'; import { LegacyDependenciesPlugin } from './shim'; import { plugin } from '.'; -const regionmapsConfig = npSetup.core.injectedMetadata.getInjectedVar( - 'regionmap' -) as RegionMapsConfig; - const plugins: Readonly<RegionMapPluginSetupDependencies> = { expressions: npSetup.plugins.expressions, visualizations: npSetup.plugins.visualizations, + mapsLegacy: npSetup.plugins.mapsLegacy, // Temporary solution // It will be removed when all dependent services are migrated to the new platform. - __LEGACY: new LegacyDependenciesPlugin(regionmapsConfig), + __LEGACY: new LegacyDependenciesPlugin(), }; const pluginInstance = plugin({} as PluginInitializerContext); diff --git a/src/legacy/core_plugins/region_map/public/plugin.ts b/src/legacy/core_plugins/region_map/public/plugin.ts index cae569f8fd26d..1453c2155e2d6 100644 --- a/src/legacy/core_plugins/region_map/public/plugin.ts +++ b/src/legacy/core_plugins/region_map/public/plugin.ts @@ -32,10 +32,14 @@ import { LegacyDependenciesPlugin, LegacyDependenciesPluginSetup } from './shim' import { createRegionMapFn } from './region_map_fn'; // @ts-ignore import { createRegionMapTypeDefinition } from './region_map_type'; +import { IServiceSettings, MapsLegacyPluginSetup } from '../../../../plugins/maps_legacy/public'; /** @private */ interface RegionMapVisualizationDependencies extends LegacyDependenciesPluginSetup { uiSettings: IUiSettingsClient; + regionmapsConfig: RegionMapsConfig; + serviceSettings: IServiceSettings; + notificationService: any; } /** @internal */ @@ -43,6 +47,7 @@ export interface RegionMapPluginSetupDependencies { expressions: ReturnType<ExpressionsPublicPlugin['setup']>; visualizations: VisualizationsSetup; __LEGACY: LegacyDependenciesPlugin; + mapsLegacy: MapsLegacyPluginSetup; } /** @internal */ @@ -61,10 +66,13 @@ export class RegionMapPlugin implements Plugin<Promise<void>, void> { public async setup( core: CoreSetup, - { expressions, visualizations, __LEGACY }: RegionMapPluginSetupDependencies + { expressions, visualizations, mapsLegacy, __LEGACY }: RegionMapPluginSetupDependencies ) { const visualizationDependencies: Readonly<RegionMapVisualizationDependencies> = { uiSettings: core.uiSettings, + regionmapsConfig: core.injectedMetadata.getInjectedVar('regionmap') as RegionMapsConfig, + serviceSettings: mapsLegacy.serviceSettings, + notificationService: core.notifications.toasts, ...(await __LEGACY.setup()), }; diff --git a/src/legacy/core_plugins/region_map/public/region_map_visualization.js b/src/legacy/core_plugins/region_map/public/region_map_visualization.js index 72f9d66e7d2bf..f08d53ee35c8d 100644 --- a/src/legacy/core_plugins/region_map/public/region_map_visualization.js +++ b/src/legacy/core_plugins/region_map/public/region_map_visualization.js @@ -28,8 +28,16 @@ import { truncatedColorMaps } from '../../../../plugins/charts/public'; // TODO: reference to TILE_MAP plugin should be removed import { BaseMapsVisualizationProvider } from '../../tile_map/public/base_maps_visualization'; -export function createRegionMapVisualization({ serviceSettings, $injector, uiSettings }) { - const BaseMapsVisualization = new BaseMapsVisualizationProvider(serviceSettings); +export function createRegionMapVisualization({ + serviceSettings, + $injector, + uiSettings, + notificationService, +}) { + const BaseMapsVisualization = new BaseMapsVisualizationProvider( + serviceSettings, + notificationService + ); const tooltipFormatter = new TileMapTooltipFormatter($injector); return class RegionMapsVisualization extends BaseMapsVisualization { diff --git a/src/legacy/core_plugins/region_map/public/shim/legacy_dependencies_plugin.ts b/src/legacy/core_plugins/region_map/public/shim/legacy_dependencies_plugin.ts index c47fc40fbacd7..3a7615e83f281 100644 --- a/src/legacy/core_plugins/region_map/public/shim/legacy_dependencies_plugin.ts +++ b/src/legacy/core_plugins/region_map/public/shim/legacy_dependencies_plugin.ts @@ -19,31 +19,20 @@ import chrome from 'ui/chrome'; import { CoreStart, Plugin } from 'kibana/public'; -import 'ui/vis/map/service_settings'; -import { RegionMapsConfig } from '../plugin'; /** @internal */ export interface LegacyDependenciesPluginSetup { $injector: any; serviceSettings: any; - regionmapsConfig: RegionMapsConfig; } export class LegacyDependenciesPlugin implements Plugin<Promise<LegacyDependenciesPluginSetup>, void> { - constructor(private readonly regionmapsConfig: RegionMapsConfig) {} - public async setup() { const $injector = await chrome.dangerouslyGetActiveInjector(); return { $injector, - regionmapsConfig: this.regionmapsConfig, - // Settings for EMSClient. - // EMSClient, which currently lives in the tile_map vis, - // will probably end up being exposed from the future vis_type_maps plugin, - // which would register both the tile_map and the region_map vis plugins. - serviceSettings: $injector.get('serviceSettings'), } as LegacyDependenciesPluginSetup; } diff --git a/src/legacy/core_plugins/region_map/public/types.ts b/src/legacy/core_plugins/region_map/public/types.ts index 2097aebd27ce0..8585bf720e0cf 100644 --- a/src/legacy/core_plugins/region_map/public/types.ts +++ b/src/legacy/core_plugins/region_map/public/types.ts @@ -17,7 +17,7 @@ * under the License. */ -import { VectorLayer, FileLayerField } from 'ui/vis/map/service_settings'; +import { VectorLayer, FileLayerField } from '../../../../plugins/maps_legacy/public'; import { WMSOptions } from '../../tile_map/public/types'; export interface RegionMapVisParams { diff --git a/src/legacy/core_plugins/region_map/public/util.ts b/src/legacy/core_plugins/region_map/public/util.ts index 69a7a1815bc8e..24c721da1f31a 100644 --- a/src/legacy/core_plugins/region_map/public/util.ts +++ b/src/legacy/core_plugins/region_map/public/util.ts @@ -17,7 +17,7 @@ * under the License. */ -import { FileLayer, VectorLayer } from 'ui/vis/map/service_settings'; +import { FileLayer, VectorLayer } from '../../../../plugins/maps_legacy/public'; // TODO: reference to TILE_MAP plugin should be removed import { ORIGIN } from '../../../../legacy/core_plugins/tile_map/common/origin'; diff --git a/src/legacy/core_plugins/tile_map/public/__tests__/coordinate_maps_visualization.js b/src/legacy/core_plugins/tile_map/public/__tests__/coordinate_maps_visualization.js index 2c142b19d9096..3904c43707906 100644 --- a/src/legacy/core_plugins/tile_map/public/__tests__/coordinate_maps_visualization.js +++ b/src/legacy/core_plugins/tile_map/public/__tests__/coordinate_maps_visualization.js @@ -25,12 +25,18 @@ import initial from './initial.png'; import blues from './blues.png'; import shadedGeohashGrid from './shadedGeohashGrid.png'; import heatmapRaw from './heatmap_raw.png'; -import EMS_CATALOGUE from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_manifest.json'; -import EMS_FILES from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_files.json'; -import EMS_TILES from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_tiles.json'; -import EMS_STYLE_ROAD_MAP_BRIGHT from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_style_bright'; -import EMS_STYLE_ROAD_MAP_DESATURATED from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_style_desaturated'; -import EMS_STYLE_DARK_MAP from '../../../../ui/public/vis/__tests__/map/ems_mocks/sample_style_dark'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_CATALOGUE from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_manifest.json'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_FILES from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_files.json'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_TILES from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_tiles.json'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_STYLE_ROAD_MAP_BRIGHT from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_STYLE_ROAD_MAP_DESATURATED from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_desaturated'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import EMS_STYLE_DARK_MAP from '../../../../../plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_dark'; import { createTileMapVisualization } from '../tile_map_visualization'; import { createTileMapTypeDefinition } from '../tile_map_type'; @@ -38,6 +44,15 @@ import { createTileMapTypeDefinition } from '../tile_map_type'; import { ExprVis } from '../../../../../plugins/visualizations/public/expressions/vis'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { BaseVisType } from '../../../../../plugins/visualizations/public/vis_types/base_vis_type'; +import { + getPrecision, + getZoomPrecision, + // eslint-disable-next-line @kbn/eslint/no-restricted-paths +} from '../../../../../plugins/maps_legacy/public/map/precision'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { ServiceSettings } from '../../../../../plugins/maps_legacy/public/map/service_settings'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { setInjectedVarFunc } from '../../../../../plugins/maps_legacy/public/kibana_services'; function mockRawData() { const stack = [dummyESResponse]; @@ -75,13 +90,39 @@ describe('CoordinateMapsVisualizationTest', function() { beforeEach(ngMock.module('kibana')); beforeEach( ngMock.inject((Private, $injector) => { - const serviceSettings = $injector.get('serviceSettings'); + setInjectedVarFunc(injectedVar => { + switch (injectedVar) { + case 'mapConfig': + return { + emsFileApiUrl: '', + emsTileApiUrl: '', + emsLandingPageUrl: '', + }; + case 'tilemapsConfig': + return { + deprecated: { + config: { + options: { + attribution: '123', + }, + }, + }, + }; + case 'version': + return '123'; + default: + return 'not found'; + } + }); + const serviceSettings = new ServiceSettings(); const uiSettings = $injector.get('config'); dependencies = { serviceSettings, uiSettings, $injector, + getPrecision, + getZoomPrecision, }; visType = new BaseVisType(createTileMapTypeDefinition(dependencies)); diff --git a/src/legacy/core_plugins/tile_map/public/__tests__/geohash_layer.js b/src/legacy/core_plugins/tile_map/public/__tests__/geohash_layer.js index 857432079e376..fc029d6bccb6e 100644 --- a/src/legacy/core_plugins/tile_map/public/__tests__/geohash_layer.js +++ b/src/legacy/core_plugins/tile_map/public/__tests__/geohash_layer.js @@ -18,13 +18,13 @@ */ import expect from '@kbn/expect'; -import { KibanaMap } from 'ui/vis/map/kibana_map'; import { GeohashLayer } from '../geohash_layer'; // import heatmapPng from './heatmap.png'; import scaledCircleMarkersPng from './scaledCircleMarkers.png'; // import shadedCircleMarkersPng from './shadedCircleMarkers.png'; import { ImageComparator } from 'test_utils/image_comparator'; import GeoHashSampleData from './dummy_es_response.json'; +import { KibanaMap } from '../../../../../plugins/maps_legacy/public'; describe('geohash_layer', function() { let domNode; diff --git a/src/legacy/core_plugins/tile_map/public/base_maps_visualization.js b/src/legacy/core_plugins/tile_map/public/base_maps_visualization.js index d38159c91ef9f..1dac4607280cc 100644 --- a/src/legacy/core_plugins/tile_map/public/base_maps_visualization.js +++ b/src/legacy/core_plugins/tile_map/public/base_maps_visualization.js @@ -19,22 +19,25 @@ import _ from 'lodash'; import { i18n } from '@kbn/i18n'; -import { KibanaMap } from 'ui/vis/map/kibana_map'; +import { KibanaMap } from '../../../../plugins/maps_legacy/public'; import * as Rx from 'rxjs'; import { filter, first } from 'rxjs/operators'; -import 'ui/vis/map/service_settings'; import { toastNotifications } from 'ui/notify'; import chrome from 'ui/chrome'; const WMS_MINZOOM = 0; const WMS_MAXZOOM = 22; //increase this to 22. Better for WMS -export function BaseMapsVisualizationProvider(serviceSettings) { +export function BaseMapsVisualizationProvider(mapServiceSettings, notificationService) { /** * Abstract base class for a visualization consisting of a map with a single baselayer. * @class BaseMapsVisualization * @constructor */ + + const serviceSettings = mapServiceSettings; + const toastService = notificationService; + return class BaseMapsVisualization { constructor(element, vis) { this.vis = vis; @@ -94,8 +97,9 @@ export function BaseMapsVisualizationProvider(serviceSettings) { const centerFromUIState = uiState.get('mapCenter'); options.zoom = !isNaN(zoomFromUiState) ? zoomFromUiState : this.vis.params.mapZoom; options.center = centerFromUIState ? centerFromUIState : this.vis.params.mapCenter; + const services = { toastService }; - this._kibanaMap = new KibanaMap(this._container, options); + this._kibanaMap = new KibanaMap(this._container, options, services); this._kibanaMap.setMinZoom(WMS_MINZOOM); //use a default this._kibanaMap.setMaxZoom(WMS_MAXZOOM); //use a default diff --git a/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx b/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx index b8535e72e8818..e74c260d3b8e5 100644 --- a/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx +++ b/src/legacy/core_plugins/tile_map/public/components/wms_options.tsx @@ -21,8 +21,7 @@ import React, { useMemo } from 'react'; import { EuiPanel, EuiSpacer, EuiTitle } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; - -import { TmsLayer } from 'ui/vis/map/service_settings'; +import { TmsLayer } from '../../../../../plugins/maps_legacy/public'; import { Vis } from '../../../../../plugins/visualizations/public'; import { RegionMapVisParams } from '../../../region_map/public/types'; import { SelectOption, SwitchOption } from '../../../../../plugins/charts/public'; diff --git a/src/legacy/core_plugins/tile_map/public/geohash_layer.js b/src/legacy/core_plugins/tile_map/public/geohash_layer.js index a604e02be7c8c..b9acf1a15208f 100644 --- a/src/legacy/core_plugins/tile_map/public/geohash_layer.js +++ b/src/legacy/core_plugins/tile_map/public/geohash_layer.js @@ -20,8 +20,7 @@ import L from 'leaflet'; import { min, isEqual } from 'lodash'; import { i18n } from '@kbn/i18n'; - -import { KibanaMapLayer } from 'ui/vis/map/kibana_map_layer'; +import { KibanaMapLayer } from '../../../../plugins/maps_legacy/public'; import { HeatmapMarkers } from './markers/heatmap'; import { ScaledCirclesMarkers } from './markers/scaled_circles'; import { ShadedCirclesMarkers } from './markers/shaded_circles'; diff --git a/src/legacy/core_plugins/tile_map/public/legacy.ts b/src/legacy/core_plugins/tile_map/public/legacy.ts index 7b1f916076f61..741e118750f32 100644 --- a/src/legacy/core_plugins/tile_map/public/legacy.ts +++ b/src/legacy/core_plugins/tile_map/public/legacy.ts @@ -27,6 +27,7 @@ import { plugin } from '.'; const plugins: Readonly<TileMapPluginSetupDependencies> = { expressions: npSetup.plugins.expressions, visualizations: npSetup.plugins.visualizations, + mapsLegacy: npSetup.plugins.mapsLegacy, // Temporary solution // It will be removed when all dependent services are migrated to the new platform. diff --git a/src/legacy/core_plugins/tile_map/public/markers/scaled_circles.js b/src/legacy/core_plugins/tile_map/public/markers/scaled_circles.js index 88d6db82946c7..f39de6ca7d179 100644 --- a/src/legacy/core_plugins/tile_map/public/markers/scaled_circles.js +++ b/src/legacy/core_plugins/tile_map/public/markers/scaled_circles.js @@ -22,8 +22,7 @@ import _ from 'lodash'; import d3 from 'd3'; import $ from 'jquery'; import { EventEmitter } from 'events'; -import * as colorUtil from 'ui/vis/map/color_util'; - +import { colorUtil } from '../../../../../plugins/maps_legacy/public'; import { truncatedColorMaps } from '../../../../../plugins/charts/public'; export class ScaledCirclesMarkers extends EventEmitter { diff --git a/src/legacy/core_plugins/tile_map/public/plugin.ts b/src/legacy/core_plugins/tile_map/public/plugin.ts index f2addbe3ab872..2b97407b17b38 100644 --- a/src/legacy/core_plugins/tile_map/public/plugin.ts +++ b/src/legacy/core_plugins/tile_map/public/plugin.ts @@ -32,16 +32,22 @@ import { LegacyDependenciesPlugin, LegacyDependenciesPluginSetup } from './shim' import { createTileMapFn } from './tile_map_fn'; // @ts-ignore import { createTileMapTypeDefinition } from './tile_map_type'; +import { IServiceSettings, MapsLegacyPluginSetup } from '../../../../plugins/maps_legacy/public'; /** @private */ interface TileMapVisualizationDependencies extends LegacyDependenciesPluginSetup { + serviceSettings: IServiceSettings; uiSettings: IUiSettingsClient; + getZoomPrecision: any; + getPrecision: any; + notificationService: any; } /** @internal */ export interface TileMapPluginSetupDependencies { expressions: ReturnType<ExpressionsPublicPlugin['setup']>; visualizations: VisualizationsSetup; + mapsLegacy: MapsLegacyPluginSetup; __LEGACY: LegacyDependenciesPlugin; } @@ -55,9 +61,14 @@ export class TileMapPlugin implements Plugin<Promise<void>, void> { public async setup( core: CoreSetup, - { expressions, visualizations, __LEGACY }: TileMapPluginSetupDependencies + { expressions, visualizations, mapsLegacy, __LEGACY }: TileMapPluginSetupDependencies ) { + const { getZoomPrecision, getPrecision, serviceSettings } = mapsLegacy; const visualizationDependencies: Readonly<TileMapVisualizationDependencies> = { + serviceSettings, + getZoomPrecision, + getPrecision, + notificationService: core.notifications.toasts, uiSettings: core.uiSettings, ...(await __LEGACY.setup()), }; diff --git a/src/legacy/core_plugins/tile_map/public/shim/legacy_dependencies_plugin.ts b/src/legacy/core_plugins/tile_map/public/shim/legacy_dependencies_plugin.ts index 063b12bf0a2db..5296e98b09efe 100644 --- a/src/legacy/core_plugins/tile_map/public/shim/legacy_dependencies_plugin.ts +++ b/src/legacy/core_plugins/tile_map/public/shim/legacy_dependencies_plugin.ts @@ -18,12 +18,12 @@ */ import chrome from 'ui/chrome'; -import 'ui/vis/map/service_settings'; import { CoreStart, Plugin } from 'kibana/public'; +// TODO: Determine why visualizations don't populate without this +import 'angular-sanitize'; /** @internal */ export interface LegacyDependenciesPluginSetup { - serviceSettings: any; $injector: any; } @@ -34,11 +34,6 @@ export class LegacyDependenciesPlugin return { $injector, - // Settings for EMSClient. - // EMSClient, which currently lives in the tile_map vis, - // will probably end up being exposed from the future vis_type_maps plugin, - // which would register both the tile_map and the region_map vis plugins. - serviceSettings: $injector.get('serviceSettings'), } as LegacyDependenciesPluginSetup; } diff --git a/src/legacy/core_plugins/tile_map/public/tile_map_fn.js b/src/legacy/core_plugins/tile_map/public/tile_map_fn.js index 2f54d23590c33..5ad4a2c33db25 100644 --- a/src/legacy/core_plugins/tile_map/public/tile_map_fn.js +++ b/src/legacy/core_plugins/tile_map/public/tile_map_fn.js @@ -16,7 +16,7 @@ * specific language governing permissions and limitations * under the License. */ -import { convertToGeoJson } from 'ui/vis/map/convert_to_geojson'; +import { convertToGeoJson } from '../../../../plugins/maps_legacy/public'; import { i18n } from '@kbn/i18n'; export const createTileMapFn = () => ({ diff --git a/src/legacy/core_plugins/tile_map/public/tile_map_type.js b/src/legacy/core_plugins/tile_map/public/tile_map_type.js index fe82ad5c7352b..ae3a839b600e9 100644 --- a/src/legacy/core_plugins/tile_map/public/tile_map_type.js +++ b/src/legacy/core_plugins/tile_map/public/tile_map_type.js @@ -19,9 +19,7 @@ import React from 'react'; import { i18n } from '@kbn/i18n'; - -import { convertToGeoJson } from 'ui/vis/map/convert_to_geojson'; - +import { convertToGeoJson } from '../../../../plugins/maps_legacy/public'; import { Schemas } from '../../../../plugins/vis_default_editor/public'; import { createTileMapVisualization } from './tile_map_visualization'; import { TileMapOptions } from './components/tile_map_options'; diff --git a/src/legacy/core_plugins/tile_map/public/tile_map_visualization.js b/src/legacy/core_plugins/tile_map/public/tile_map_visualization.js index 910def8a0c78e..fdce8bc51fe86 100644 --- a/src/legacy/core_plugins/tile_map/public/tile_map_visualization.js +++ b/src/legacy/core_plugins/tile_map/public/tile_map_visualization.js @@ -23,15 +23,19 @@ import { BaseMapsVisualizationProvider } from './base_maps_visualization'; import { TileMapTooltipFormatterProvider } from './editors/_tooltip_formatter'; import { npStart } from 'ui/new_platform'; import { getFormat } from '../../../ui/public/visualize/loader/pipeline_helpers/utilities'; -import { - scaleBounds, - zoomPrecision, - getPrecision, - geoContains, -} from '../../../ui/public/vis/map/decode_geo_hash'; +import { scaleBounds, geoContains } from '../../../../plugins/maps_legacy/public'; -export const createTileMapVisualization = ({ serviceSettings, $injector }) => { - const BaseMapsVisualization = new BaseMapsVisualizationProvider(serviceSettings); +export const createTileMapVisualization = ({ + serviceSettings, + $injector, + getZoomPrecision, + getPrecision, + notificationService, +}) => { + const BaseMapsVisualization = new BaseMapsVisualizationProvider( + serviceSettings, + notificationService + ); const tooltipFormatter = new TileMapTooltipFormatterProvider($injector); return class CoordinateMapsVisualization extends BaseMapsVisualization { @@ -59,6 +63,7 @@ export const createTileMapVisualization = ({ serviceSettings, $injector }) => { updateVarsObject.data.boundingBox = geohashAgg.aggConfigParams.boundingBox; } // todo: autoPrecision should be vis parameter, not aggConfig one + const zoomPrecision = getZoomPrecision(); updateVarsObject.data.precision = geohashAgg.aggConfigParams.autoPrecision ? zoomPrecision[this.vis.getUiState().get('mapZoom')] : getPrecision(geohashAgg.aggConfigParams.precision); diff --git a/src/legacy/core_plugins/tile_map/public/tilemap_fn.test.js b/src/legacy/core_plugins/tile_map/public/tilemap_fn.test.js index 0913d6fc92e8a..6da37f4c5ef86 100644 --- a/src/legacy/core_plugins/tile_map/public/tilemap_fn.test.js +++ b/src/legacy/core_plugins/tile_map/public/tilemap_fn.test.js @@ -22,7 +22,7 @@ import { functionWrapper } from '../../../../plugins/expressions/common/expressi import { createTileMapFn } from './tile_map_fn'; jest.mock('ui/new_platform'); -jest.mock('ui/vis/map/convert_to_geojson', () => ({ +jest.mock('../../../../plugins/maps_legacy/public', () => ({ convertToGeoJson: jest.fn().mockReturnValue({ featureCollection: { type: 'FeatureCollection', @@ -37,7 +37,7 @@ jest.mock('ui/vis/map/convert_to_geojson', () => ({ }), })); -import { convertToGeoJson } from 'ui/vis/map/convert_to_geojson'; +import { convertToGeoJson } from '../../../../plugins/maps_legacy/public'; describe('interpreter/functions#tilemap', () => { const fn = functionWrapper(createTileMapFn()); diff --git a/src/legacy/core_plugins/tile_map/public/types.ts b/src/legacy/core_plugins/tile_map/public/types.ts index 5f1c3f9b03c9e..e1b4c27319123 100644 --- a/src/legacy/core_plugins/tile_map/public/types.ts +++ b/src/legacy/core_plugins/tile_map/public/types.ts @@ -17,7 +17,7 @@ * under the License. */ -import { TmsLayer } from 'ui/vis/map/service_settings'; +import { TmsLayer } from '../../../../plugins/maps_legacy/public'; import { MapTypes } from './map_types'; export interface WMSOptions { diff --git a/src/legacy/core_plugins/timelion/public/shim/timelion_legacy_module.ts b/src/legacy/core_plugins/timelion/public/shim/timelion_legacy_module.ts index 9de8477e3978c..8fadf223e1807 100644 --- a/src/legacy/core_plugins/timelion/public/shim/timelion_legacy_module.ts +++ b/src/legacy/core_plugins/timelion/public/shim/timelion_legacy_module.ts @@ -21,7 +21,6 @@ import 'ngreact'; import 'brace/mode/hjson'; import 'brace/ext/searchbox'; import 'ui/accessibility/kbn_ui_ace_keyboard_mode'; -import 'ui/vis/map/service_settings'; import { once } from 'lodash'; // @ts-ignore diff --git a/src/legacy/core_plugins/vis_type_vega/public/__tests__/vega_visualization.js b/src/legacy/core_plugins/vis_type_vega/public/__tests__/vega_visualization.js index c7fbc0815b07c..6412d8a569b2a 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/__tests__/vega_visualization.js +++ b/src/legacy/core_plugins/vis_type_vega/public/__tests__/vega_visualization.js @@ -49,6 +49,10 @@ import { BaseVisType } from '../../../../../plugins/visualizations/public/vis_ty // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { ExprVis } from '../../../../../plugins/visualizations/public/expressions/vis'; import { setInjectedVars } from '../services'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { setInjectedVarFunc } from '../../../../../plugins/maps_legacy/public/kibana_services'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { ServiceSettings } from '../../../../../plugins/maps_legacy/public/map/service_settings'; const THRESHOLD = 0.1; const PIXEL_DIFF = 30; @@ -69,9 +73,34 @@ describe('VegaVisualizations', () => { beforeEach(ngMock.module('kibana')); beforeEach( - ngMock.inject($injector => { + ngMock.inject(() => { + setInjectedVarFunc(injectedVar => { + switch (injectedVar) { + case 'mapConfig': + return { + emsFileApiUrl: '', + emsTileApiUrl: '', + emsLandingPageUrl: '', + }; + case 'tilemapsConfig': + return { + deprecated: { + config: { + options: { + attribution: '123', + }, + }, + }, + }; + case 'version': + return '123'; + default: + return 'not found'; + } + }); + const serviceSettings = new ServiceSettings(); vegaVisualizationDependencies = { - serviceSettings: $injector.get('serviceSettings'), + serviceSettings, core: { uiSettings: npStart.core.uiSettings, }, diff --git a/src/legacy/core_plugins/vis_type_vega/public/legacy.ts b/src/legacy/core_plugins/vis_type_vega/public/legacy.ts index b2c73894d978d..450af4a6f253e 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/legacy.ts +++ b/src/legacy/core_plugins/vis_type_vega/public/legacy.ts @@ -20,16 +20,12 @@ import { PluginInitializerContext } from 'kibana/public'; import { npSetup, npStart } from 'ui/new_platform'; import { VegaPluginSetupDependencies, VegaPluginStartDependencies } from './plugin'; -import { LegacyDependenciesPlugin } from './shim'; import { plugin } from '.'; const setupPlugins: Readonly<VegaPluginSetupDependencies> = { ...npSetup.plugins, visualizations: npSetup.plugins.visualizations, - - // Temporary solution - // It will be removed when all dependent services are migrated to the new platform. - __LEGACY: new LegacyDependenciesPlugin(), + mapsLegacy: npSetup.plugins.mapsLegacy, }; const startPlugins: Readonly<VegaPluginStartDependencies> = { diff --git a/src/legacy/core_plugins/vis_type_vega/public/plugin.ts b/src/legacy/core_plugins/vis_type_vega/public/plugin.ts index 38b92a40cd99a..9fa77d28fbbfa 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/plugin.ts +++ b/src/legacy/core_plugins/vis_type_vega/public/plugin.ts @@ -17,7 +17,6 @@ * under the License. */ import { PluginInitializerContext, CoreSetup, CoreStart, Plugin } from '../../../../core/public'; -import { LegacyDependenciesPlugin, LegacyDependenciesPluginSetup } from './shim'; import { Plugin as ExpressionsPublicPlugin } from '../../../../plugins/expressions/public'; import { Plugin as DataPublicPlugin } from '../../../../plugins/data/public'; import { VisualizationsSetup } from '../../../../plugins/visualizations/public'; @@ -32,13 +31,15 @@ import { import { createVegaFn } from './vega_fn'; import { createVegaTypeDefinition } from './vega_type'; import { VisTypeVegaSetup } from '../../../../plugins/vis_type_vega/public'; +import { IServiceSettings } from '../../../../plugins/maps_legacy/public'; /** @internal */ -export interface VegaVisualizationDependencies extends LegacyDependenciesPluginSetup { +export interface VegaVisualizationDependencies { core: CoreSetup; plugins: { data: ReturnType<DataPublicPlugin['setup']>; }; + serviceSettings: IServiceSettings; } /** @internal */ @@ -47,7 +48,7 @@ export interface VegaPluginSetupDependencies { visualizations: VisualizationsSetup; data: ReturnType<DataPublicPlugin['setup']>; visTypeVega: VisTypeVegaSetup; - __LEGACY: LegacyDependenciesPlugin; + mapsLegacy: any; } /** @internal */ @@ -65,7 +66,7 @@ export class VegaPlugin implements Plugin<Promise<void>, void> { public async setup( core: CoreSetup, - { data, expressions, visualizations, visTypeVega, __LEGACY }: VegaPluginSetupDependencies + { data, expressions, visualizations, visTypeVega, mapsLegacy }: VegaPluginSetupDependencies ) { setInjectedVars({ enableExternalUrls: visTypeVega.config.enableExternalUrls, @@ -79,7 +80,7 @@ export class VegaPlugin implements Plugin<Promise<void>, void> { plugins: { data, }, - ...(await __LEGACY.setup()), + serviceSettings: mapsLegacy.serviceSettings, }; expressions.registerFunction(() => createVegaFn(visualizationDependencies)); diff --git a/src/legacy/core_plugins/vis_type_vega/public/shim/legacy_dependencies_plugin.ts b/src/legacy/core_plugins/vis_type_vega/public/shim/legacy_dependencies_plugin.ts deleted file mode 100644 index 8925f76cffa43..0000000000000 --- a/src/legacy/core_plugins/vis_type_vega/public/shim/legacy_dependencies_plugin.ts +++ /dev/null @@ -1,49 +0,0 @@ -/* - * 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. - */ - -// TODO remove this file as soon as serviceSettings is exposed in the new platform -// eslint-disable-next-line @kbn/eslint/no-restricted-paths -import chrome from 'ui/chrome'; -// eslint-disable-next-line @kbn/eslint/no-restricted-paths -import 'ui/vis/map/service_settings'; -import { CoreStart, Plugin } from 'kibana/public'; - -/** @internal */ -export interface LegacyDependenciesPluginSetup { - serviceSettings: any; -} - -export class LegacyDependenciesPlugin - implements Plugin<Promise<LegacyDependenciesPluginSetup>, void> { - public async setup() { - const $injector = await chrome.dangerouslyGetActiveInjector(); - - return { - // Settings for EMSClient. - // EMSClient, which currently lives in the tile_map vis, - // will probably end up being exposed from the future vis_type_maps plugin, - // which would register both the tile_map and the region_map vis plugins. - serviceSettings: $injector.get('serviceSettings'), - } as LegacyDependenciesPluginSetup; - } - - public start(core: CoreStart) { - // nothing to do here yet - } -} diff --git a/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_layer.js b/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_layer.js index 38540e9f218fb..d43eb9c3351ea 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_layer.js +++ b/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_layer.js @@ -19,7 +19,7 @@ import L from 'leaflet'; import 'leaflet-vega'; -import { KibanaMapLayer } from '../legacy_imports'; +import { KibanaMapLayer } from '../../../../../plugins/maps_legacy/public'; export class VegaMapLayer extends KibanaMapLayer { constructor(spec, options) { diff --git a/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_view.js b/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_view.js index 487c90d01ada3..03aef29dc5739 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_view.js +++ b/src/legacy/core_plugins/vis_type_vega/public/vega_view/vega_map_view.js @@ -21,10 +21,15 @@ import * as vega from 'vega-lib'; import { i18n } from '@kbn/i18n'; import { VegaBaseView } from './vega_base_view'; import { VegaMapLayer } from './vega_map_layer'; -import { KibanaMap } from '../legacy_imports'; +import { KibanaMap } from '../../../../../plugins/maps_legacy/public'; import { getEmsTileLayerId, getUISettings } from '../services'; export class VegaMapView extends VegaBaseView { + constructor(opts, services) { + super(opts); + this.services = services; + } + async _initViewCustomizations() { const mapConfig = this._parser.mapConfig; let baseMapOpts; @@ -102,14 +107,18 @@ export class VegaMapView extends VegaBaseView { // maxBounds = L.latLngBounds(L.latLng(b[1], b[0]), L.latLng(b[3], b[2])); // } - this._kibanaMap = new KibanaMap(this._$container.get(0), { - zoom, - minZoom, - maxZoom, - center: [mapConfig.latitude, mapConfig.longitude], - zoomControl: mapConfig.zoomControl, - scrollWheelZoom: mapConfig.scrollWheelZoom, - }); + this._kibanaMap = new KibanaMap( + this._$container.get(0), + { + zoom, + minZoom, + maxZoom, + center: [mapConfig.latitude, mapConfig.longitude], + zoomControl: mapConfig.zoomControl, + scrollWheelZoom: mapConfig.scrollWheelZoom, + }, + this.services + ); if (baseMapOpts) { this._kibanaMap.setBaseLayer({ diff --git a/src/legacy/core_plugins/vis_type_vega/public/vega_visualization.js b/src/legacy/core_plugins/vis_type_vega/public/vega_visualization.js index 96835ef3b10bc..a6e911de7f0cb 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/vega_visualization.js +++ b/src/legacy/core_plugins/vis_type_vega/public/vega_visualization.js @@ -116,7 +116,8 @@ export const createVegaVisualization = ({ serviceSettings }) => }; if (vegaParser.useMap) { - this._vegaView = new VegaMapView(vegaViewParams); + const services = { toastService: getNotifications().toasts }; + this._vegaView = new VegaMapView(vegaViewParams, services); } else { this._vegaView = new VegaView(vegaViewParams); } diff --git a/src/legacy/ui/public/new_platform/new_platform.karma_mock.js b/src/legacy/ui/public/new_platform/new_platform.karma_mock.js index 0779d6472671c..33a7fdad065b4 100644 --- a/src/legacy/ui/public/new_platform/new_platform.karma_mock.js +++ b/src/legacy/ui/public/new_platform/new_platform.karma_mock.js @@ -309,6 +309,12 @@ export const npSetup = { registerAlias: sinon.fake(), hideTypes: sinon.fake(), }, + + mapsLegacy: { + serviceSettings: sinon.fake(), + getPrecision: sinon.fake(), + getZoomPrecision: sinon.fake(), + }, }, }; diff --git a/src/legacy/ui/public/new_platform/new_platform.ts b/src/legacy/ui/public/new_platform/new_platform.ts index cdd7e1a994912..21b80e827e4c2 100644 --- a/src/legacy/ui/public/new_platform/new_platform.ts +++ b/src/legacy/ui/public/new_platform/new_platform.ts @@ -68,6 +68,7 @@ import { VisualizationsSetup, VisualizationsStart, } from '../../../../plugins/visualizations/public'; +import { MapsLegacyPluginSetup } from '../../../../plugins/maps_legacy/public'; export interface PluginsSetup { bfetch: BfetchPublicSetup; @@ -90,6 +91,7 @@ export interface PluginsSetup { visualizations: VisualizationsSetup; telemetry?: TelemetryPluginSetup; savedObjectsManagement: SavedObjectsManagementPluginSetup; + mapsLegacy: MapsLegacyPluginSetup; indexPatternManagement: IndexPatternManagementSetup; } diff --git a/src/legacy/ui/public/vis/map/service_settings.js b/src/legacy/ui/public/vis/map/service_settings.js deleted file mode 100644 index a014aeb182c67..0000000000000 --- a/src/legacy/ui/public/vis/map/service_settings.js +++ /dev/null @@ -1,256 +0,0 @@ -/* - * 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. - */ - -import { uiModules } from '../../modules'; -import _ from 'lodash'; -import MarkdownIt from 'markdown-it'; -import { ORIGIN } from '../../../../core_plugins/tile_map/common/origin'; -import { EMSClient } from '@elastic/ems-client'; -import { i18n } from '@kbn/i18n'; -import 'angular-sanitize'; - -const markdownIt = new MarkdownIt({ - html: false, - linkify: true, -}); - -const TMS_IN_YML_ID = 'TMS in config/kibana.yml'; - -uiModules - .get('kibana', ['ngSanitize']) - .service('serviceSettings', function($sanitize, mapConfig, tilemapsConfig, kbnVersion) { - const attributionFromConfig = $sanitize( - markdownIt.render(tilemapsConfig.deprecated.config.options.attribution || '') - ); - const tmsOptionsFromConfig = _.assign({}, tilemapsConfig.deprecated.config.options, { - attribution: attributionFromConfig, - }); - - class ServiceSettings { - constructor() { - this._showZoomMessage = true; - this._emsClient = new EMSClient({ - language: i18n.getLocale(), - appVersion: kbnVersion, - appName: 'kibana', - fileApiUrl: mapConfig.emsFileApiUrl, - tileApiUrl: mapConfig.emsTileApiUrl, - htmlSanitizer: $sanitize, - landingPageUrl: mapConfig.emsLandingPageUrl, - // Wrap to avoid errors passing window fetch - fetchFunction: function(...args) { - return fetch(...args); - }, - }); - } - - shouldShowZoomMessage({ origin }) { - return origin === ORIGIN.EMS && this._showZoomMessage; - } - - disableZoomMessage() { - this._showZoomMessage = false; - } - - __debugStubManifestCalls(manifestRetrieval) { - const oldGetManifest = this._emsClient.getManifest; - this._emsClient.getManifest = manifestRetrieval; - return { - removeStub: () => { - delete this._emsClient.getManifest; - //not strictly necessary since this is prototype method - if (this._emsClient.getManifest !== oldGetManifest) { - this._emsClient.getManifest = oldGetManifest; - } - }, - }; - } - - async getFileLayers() { - if (!mapConfig.includeElasticMapsService) { - return []; - } - - const fileLayers = await this._emsClient.getFileLayers(); - return fileLayers.map(fileLayer => { - //backfill to older settings - const format = fileLayer.getDefaultFormatType(); - const meta = fileLayer.getDefaultFormatMeta(); - - return { - name: fileLayer.getDisplayName(), - origin: fileLayer.getOrigin(), - id: fileLayer.getId(), - created_at: fileLayer.getCreatedAt(), - attribution: fileLayer.getHTMLAttribution(), - fields: fileLayer.getFieldsInLanguage(), - format: format, //legacy: format and meta are split up - meta: meta, //legacy, format and meta are split up - }; - }); - } - - /** - * Returns all the services published by EMS (if configures) - * It also includes the service configured in tilemap (override) - */ - async getTMSServices() { - let allServices = []; - if (tilemapsConfig.deprecated.isOverridden) { - //use tilemap.* settings from yml - const tmsService = _.cloneDeep(tmsOptionsFromConfig); - tmsService.id = TMS_IN_YML_ID; - tmsService.origin = ORIGIN.KIBANA_YML; - allServices.push(tmsService); - } - - if (mapConfig.includeElasticMapsService) { - const servicesFromManifest = await this._emsClient.getTMSServices(); - const strippedServiceFromManifest = await Promise.all( - servicesFromManifest - .filter(tmsService => tmsService.getId() === mapConfig.emsTileLayerId.bright) - .map(async tmsService => { - //shim for compatibility - const shim = { - origin: tmsService.getOrigin(), - id: tmsService.getId(), - minZoom: await tmsService.getMinZoom(), - maxZoom: await tmsService.getMaxZoom(), - attribution: tmsService.getHTMLAttribution(), - }; - return shim; - }) - ); - allServices = allServices.concat(strippedServiceFromManifest); - } - - return allServices; - } - - /** - * Add optional query-parameters to all requests - * - * @param additionalQueryParams - */ - addQueryParams(additionalQueryParams) { - this._emsClient.addQueryParams(additionalQueryParams); - } - - async getEMSHotLink(fileLayerConfig) { - const fileLayers = await this._emsClient.getFileLayers(); - const layer = fileLayers.find(fileLayer => { - const hasIdByName = fileLayer.hasId(fileLayerConfig.name); //legacy - const hasIdById = fileLayer.hasId(fileLayerConfig.id); - return hasIdByName || hasIdById; - }); - return layer ? layer.getEMSHotLink() : null; - } - - async _getAttributesForEMSTMSLayer(isDesaturated, isDarkMode) { - const tmsServices = await this._emsClient.getTMSServices(); - const emsTileLayerId = mapConfig.emsTileLayerId; - let serviceId; - if (isDarkMode) { - serviceId = emsTileLayerId.dark; - } else { - if (isDesaturated) { - serviceId = emsTileLayerId.desaturated; - } else { - serviceId = emsTileLayerId.bright; - } - } - const tmsService = tmsServices.find(service => { - return service.getId() === serviceId; - }); - return { - url: await tmsService.getUrlTemplate(), - minZoom: await tmsService.getMinZoom(), - maxZoom: await tmsService.getMaxZoom(), - attribution: await tmsService.getHTMLAttribution(), - origin: ORIGIN.EMS, - }; - } - - async getAttributesForTMSLayer(tmsServiceConfig, isDesaturated, isDarkMode) { - if (tmsServiceConfig.origin === ORIGIN.EMS) { - return this._getAttributesForEMSTMSLayer(isDesaturated, isDarkMode); - } else if (tmsServiceConfig.origin === ORIGIN.KIBANA_YML) { - const config = tilemapsConfig.deprecated.config; - const attrs = _.pick(config, ['url', 'minzoom', 'maxzoom', 'attribution']); - return { ...attrs, ...{ origin: ORIGIN.KIBANA_YML } }; - } else { - //this is an older config. need to resolve this dynamically. - if (tmsServiceConfig.id === TMS_IN_YML_ID) { - const config = tilemapsConfig.deprecated.config; - const attrs = _.pick(config, ['url', 'minzoom', 'maxzoom', 'attribution']); - return { ...attrs, ...{ origin: ORIGIN.KIBANA_YML } }; - } else { - //assume ems - return this._getAttributesForEMSTMSLayer(isDesaturated, isDarkMode); - } - } - } - - async _getFileUrlFromEMS(fileLayerConfig) { - const fileLayers = await this._emsClient.getFileLayers(); - const layer = fileLayers.find(fileLayer => { - const hasIdByName = fileLayer.hasId(fileLayerConfig.name); //legacy - const hasIdById = fileLayer.hasId(fileLayerConfig.id); - return hasIdByName || hasIdById; - }); - - if (layer) { - return layer.getDefaultFormatUrl(); - } else { - throw new Error(`File ${fileLayerConfig.name} not recognized`); - } - } - - async getUrlForRegionLayer(fileLayerConfig) { - let url; - if (fileLayerConfig.origin === ORIGIN.EMS) { - url = this._getFileUrlFromEMS(fileLayerConfig); - } else if ( - fileLayerConfig.layerId && - fileLayerConfig.layerId.startsWith(`${ORIGIN.EMS}.`) - ) { - //fallback for older saved objects - url = this._getFileUrlFromEMS(fileLayerConfig); - } else if ( - fileLayerConfig.layerId && - fileLayerConfig.layerId.startsWith(`${ORIGIN.KIBANA_YML}.`) - ) { - //fallback for older saved objects - url = fileLayerConfig.url; - } else { - //generic fallback - url = fileLayerConfig.url; - } - return url; - } - - async getJsonForRegionLayer(fileLayerConfig) { - const url = await this.getUrlForRegionLayer(fileLayerConfig); - const response = await fetch(url); - return await response.json(); - } - } - - return new ServiceSettings(); - }); diff --git a/src/plugins/maps_legacy/kibana.json b/src/plugins/maps_legacy/kibana.json new file mode 100644 index 0000000000000..d66be2b156bb9 --- /dev/null +++ b/src/plugins/maps_legacy/kibana.json @@ -0,0 +1,6 @@ +{ + "id": "mapsLegacy", + "version": "8.0.0", + "kibanaVersion": "kibana", + "ui": true +} diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_files.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_files.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_files.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_files.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_manifest.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_manifest.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_manifest.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_manifest.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_bright.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_bright.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_bright_vector.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright_vector.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_bright_vector.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright_vector.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_bright_vector_source.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright_vector_source.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_bright_vector_source.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_bright_vector_source.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_dark.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_dark.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_dark.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_dark.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_desaturated.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_desaturated.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_style_desaturated.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_style_desaturated.json diff --git a/src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_tiles.json b/src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_tiles.json similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/ems_mocks/sample_tiles.json rename to src/plugins/maps_legacy/public/__tests__/map/ems_mocks/sample_tiles.json diff --git a/src/legacy/ui/public/vis/__tests__/map/kibana_map.js b/src/plugins/maps_legacy/public/__tests__/map/kibana_map.js similarity index 100% rename from src/legacy/ui/public/vis/__tests__/map/kibana_map.js rename to src/plugins/maps_legacy/public/__tests__/map/kibana_map.js diff --git a/src/legacy/ui/public/vis/__tests__/map/service_settings.js b/src/plugins/maps_legacy/public/__tests__/map/service_settings.js similarity index 99% rename from src/legacy/ui/public/vis/__tests__/map/service_settings.js rename to src/plugins/maps_legacy/public/__tests__/map/service_settings.js index 61925760457c6..a9272ea396639 100644 --- a/src/legacy/ui/public/vis/__tests__/map/service_settings.js +++ b/src/plugins/maps_legacy/public/__tests__/map/service_settings.js @@ -26,7 +26,7 @@ import EMS_TILES from './ems_mocks/sample_tiles.json'; import EMS_STYLE_ROAD_MAP_BRIGHT from './ems_mocks/sample_style_bright'; import EMS_STYLE_ROAD_MAP_DESATURATED from './ems_mocks/sample_style_desaturated'; import EMS_STYLE_DARK_MAP from './ems_mocks/sample_style_dark'; -import { ORIGIN } from '../../../../../core_plugins/tile_map/common/origin'; +import { ORIGIN } from '../../common/origin'; describe('service_settings (FKA tilemaptest)', function() { let serviceSettings; diff --git a/src/legacy/ui/public/vis/_index.scss b/src/plugins/maps_legacy/public/_index.scss similarity index 100% rename from src/legacy/ui/public/vis/_index.scss rename to src/plugins/maps_legacy/public/_index.scss diff --git a/src/legacy/core_plugins/vis_type_vega/public/shim/index.ts b/src/plugins/maps_legacy/public/common/origin.ts similarity index 90% rename from src/legacy/core_plugins/vis_type_vega/public/shim/index.ts rename to src/plugins/maps_legacy/public/common/origin.ts index cfc7b62ff4f86..fdf74cae4ba68 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/shim/index.ts +++ b/src/plugins/maps_legacy/public/common/origin.ts @@ -17,4 +17,7 @@ * under the License. */ -export * from './legacy_dependencies_plugin'; +export const ORIGIN = { + EMS: 'elastic_maps_service', + KIBANA_YML: 'self_hosted', +}; diff --git a/src/plugins/maps_legacy/public/index.ts b/src/plugins/maps_legacy/public/index.ts new file mode 100644 index 0000000000000..861f67006ad83 --- /dev/null +++ b/src/plugins/maps_legacy/public/index.ts @@ -0,0 +1,61 @@ +/* + * 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. + */ + +import { MapsLegacyPlugin } from './plugin'; +// @ts-ignore +import * as colorUtil from './map/color_util'; +// @ts-ignore +import { KibanaMap } from './map/kibana_map'; +// @ts-ignore +import { KibanaMapLayer } from './map/kibana_map_layer'; +// @ts-ignore +import { convertToGeoJson } from './map/convert_to_geojson'; +// @ts-ignore +import { scaleBounds, getPrecision, geoContains } from './map/decode_geo_hash'; +// @ts-ignore +import { + VectorLayer, + FileLayerField, + FileLayer, + TmsLayer, + IServiceSettings, +} from './map/service_settings'; + +export function plugin() { + return new MapsLegacyPlugin(); +} + +/** @public */ +export { + scaleBounds, + getPrecision, + geoContains, + colorUtil, + convertToGeoJson, + IServiceSettings, + KibanaMap, + KibanaMapLayer, + VectorLayer, + FileLayerField, + FileLayer, + TmsLayer, +}; + +export type MapsLegacyPluginSetup = ReturnType<MapsLegacyPlugin['setup']>; +export type MapsLegacyPluginStart = ReturnType<MapsLegacyPlugin['start']>; diff --git a/src/legacy/core_plugins/vis_type_vega/public/legacy_imports.ts b/src/plugins/maps_legacy/public/kibana_services.js similarity index 64% rename from src/legacy/core_plugins/vis_type_vega/public/legacy_imports.ts rename to src/plugins/maps_legacy/public/kibana_services.js index b868321d6310f..815c6f9e5651f 100644 --- a/src/legacy/core_plugins/vis_type_vega/public/legacy_imports.ts +++ b/src/plugins/maps_legacy/public/kibana_services.js @@ -17,7 +17,14 @@ * under the License. */ -// @ts-ignore -export { KibanaMapLayer } from 'ui/vis/map/kibana_map_layer'; -// @ts-ignore -export { KibanaMap } from 'ui/vis/map/kibana_map'; +let toast; +export const setToasts = notificationToast => (toast = notificationToast); +export const getToasts = () => toast; + +let uiSettings; +export const setUiSettings = coreUiSettings => (uiSettings = coreUiSettings); +export const getUiSettings = () => uiSettings; + +let getInjectedVar; +export const setInjectedVarFunc = getInjectedVarFunc => (getInjectedVar = getInjectedVarFunc); +export const getInjectedVarFunc = () => getInjectedVar; diff --git a/src/legacy/ui/public/vis/map/_index.scss b/src/plugins/maps_legacy/public/map/_index.scss similarity index 100% rename from src/legacy/ui/public/vis/map/_index.scss rename to src/plugins/maps_legacy/public/map/_index.scss diff --git a/src/legacy/ui/public/vis/map/_leaflet_overrides.scss b/src/plugins/maps_legacy/public/map/_leaflet_overrides.scss similarity index 100% rename from src/legacy/ui/public/vis/map/_leaflet_overrides.scss rename to src/plugins/maps_legacy/public/map/_leaflet_overrides.scss diff --git a/src/legacy/ui/public/vis/map/_legend.scss b/src/plugins/maps_legacy/public/map/_legend.scss similarity index 100% rename from src/legacy/ui/public/vis/map/_legend.scss rename to src/plugins/maps_legacy/public/map/_legend.scss diff --git a/src/legacy/ui/public/vis/map/color_util.js b/src/plugins/maps_legacy/public/map/color_util.js similarity index 100% rename from src/legacy/ui/public/vis/map/color_util.js rename to src/plugins/maps_legacy/public/map/color_util.js diff --git a/src/legacy/ui/public/vis/map/convert_to_geojson.js b/src/plugins/maps_legacy/public/map/convert_to_geojson.js similarity index 100% rename from src/legacy/ui/public/vis/map/convert_to_geojson.js rename to src/plugins/maps_legacy/public/map/convert_to_geojson.js diff --git a/src/legacy/ui/public/vis/map/decode_geo_hash.test.ts b/src/plugins/maps_legacy/public/map/decode_geo_hash.test.ts similarity index 100% rename from src/legacy/ui/public/vis/map/decode_geo_hash.test.ts rename to src/plugins/maps_legacy/public/map/decode_geo_hash.test.ts diff --git a/src/legacy/ui/public/vis/map/decode_geo_hash.ts b/src/plugins/maps_legacy/public/map/decode_geo_hash.ts similarity index 79% rename from src/legacy/ui/public/vis/map/decode_geo_hash.ts rename to src/plugins/maps_legacy/public/map/decode_geo_hash.ts index 3f8430b8628d7..8c39ada03a46b 100644 --- a/src/legacy/ui/public/vis/map/decode_geo_hash.ts +++ b/src/plugins/maps_legacy/public/map/decode_geo_hash.ts @@ -17,11 +17,8 @@ * under the License. */ -import chrome from 'ui/chrome'; import _ from 'lodash'; -const config = chrome.getUiSettingsClient(); - interface DecodedGeoHash { latitude: number[]; longitude: number[]; @@ -74,6 +71,10 @@ function refineInterval(interval: number[], cd: number, mask: number) { } } +export function geohashColumns(precision: number): number { + return geohashCells(precision, 0); +} + /** * Get the number of geohash cells for a given precision * @@ -90,51 +91,6 @@ function geohashCells(precision: number, axis: number) { return cells; } -/** - * Get the number of geohash columns (world-wide) for a given precision - * @param precision the geohash precision - * @returns {number} the number of columns - */ -export function geohashColumns(precision: number): number { - return geohashCells(precision, 0); -} - -const defaultPrecision = 2; -const maxPrecision = parseInt(config.get('visualization:tileMap:maxPrecision'), 10) || 12; -/** - * Map Leaflet zoom levels to geohash precision levels. - * The size of a geohash column-width on the map should be at least `minGeohashPixels` pixels wide. - */ -export const zoomPrecision: any = {}; -const minGeohashPixels = 16; - -for (let zoom = 0; zoom <= 21; zoom += 1) { - const worldPixels = 256 * Math.pow(2, zoom); - zoomPrecision[zoom] = 1; - for (let precision = 2; precision <= maxPrecision; precision += 1) { - const columns = geohashColumns(precision); - if (worldPixels / columns >= minGeohashPixels) { - zoomPrecision[zoom] = precision; - } else { - break; - } - } -} - -export function getPrecision(val: string) { - let precision = parseInt(val, 10); - - if (Number.isNaN(precision)) { - precision = defaultPrecision; - } - - if (precision > maxPrecision) { - return maxPrecision; - } - - return precision; -} - interface GeoBoundingBoxCoordinate { lat: number; lon: number; diff --git a/src/legacy/ui/public/vis/map/grid_dimensions.js b/src/plugins/maps_legacy/public/map/grid_dimensions.js similarity index 100% rename from src/legacy/ui/public/vis/map/grid_dimensions.js rename to src/plugins/maps_legacy/public/map/grid_dimensions.js diff --git a/src/legacy/ui/public/vis/map/kibana_map.js b/src/plugins/maps_legacy/public/map/kibana_map.js similarity index 96% rename from src/legacy/ui/public/vis/map/kibana_map.js rename to src/plugins/maps_legacy/public/map/kibana_map.js index bc581b1a8fbaf..1c4d0882cb7da 100644 --- a/src/legacy/ui/public/vis/map/kibana_map.js +++ b/src/plugins/maps_legacy/public/map/kibana_map.js @@ -24,7 +24,7 @@ import $ from 'jquery'; import _ from 'lodash'; import { zoomToPrecision } from './zoom_to_precision'; import { i18n } from '@kbn/i18n'; -import { ORIGIN } from '../../../../core_plugins/tile_map/common/origin'; +import { ORIGIN } from '../common/origin'; function makeFitControl(fitContainer, kibanaMap) { const FitControl = L.Control.extend({ @@ -39,7 +39,7 @@ function makeFitControl(fitContainer, kibanaMap) { onAdd: function(leafletMap) { this._leafletMap = leafletMap; const fitDatBoundsLabel = i18n.translate( - 'common.ui.vis.kibanaMap.leaflet.fitDataBoundsAriaLabel', + 'maps_legacy.kibanaMap.leaflet.fitDataBoundsAriaLabel', { defaultMessage: 'Fit Data Bounds' } ); $(this._fitContainer) @@ -101,7 +101,7 @@ function makeLegendControl(container, kibanaMap, position) { * Serves as simple abstraction for leaflet as well. */ export class KibanaMap extends EventEmitter { - constructor(containerNode, options) { + constructor(containerNode, options, services) { super(); this._containerNode = containerNode; this._leafletBaseLayer = null; @@ -116,6 +116,7 @@ export class KibanaMap extends EventEmitter { this._layers = []; this._listeners = []; this._showTooltip = false; + this.toastService = services ? services.toastService : null; const leafletOptions = { minZoom: options.minZoom, @@ -482,15 +483,21 @@ export class KibanaMap extends EventEmitter { } _addMaxZoomMessage = layer => { - const zoomWarningMsg = createZoomWarningMsg(this.getZoomLevel, this.getMaxZoomLevel); + if (this.toastService) { + const zoomWarningMsg = createZoomWarningMsg( + this.toastService, + this.getZoomLevel, + this.getMaxZoomLevel + ); - this._leafletMap.on('zoomend', zoomWarningMsg); - this._containerNode.setAttribute('data-test-subj', 'zoomWarningEnabled'); + this._leafletMap.on('zoomend', zoomWarningMsg); + this._containerNode.setAttribute('data-test-subj', 'zoomWarningEnabled'); - layer.on('remove', () => { - this._leafletMap.off('zoomend', zoomWarningMsg); - this._containerNode.removeAttribute('data-test-subj'); - }); + layer.on('remove', () => { + this._leafletMap.off('zoomend', zoomWarningMsg); + this._containerNode.removeAttribute('data-test-subj'); + }); + } }; setLegendPosition(position) { diff --git a/src/legacy/ui/public/vis/map/kibana_map_layer.js b/src/plugins/maps_legacy/public/map/kibana_map_layer.js similarity index 100% rename from src/legacy/ui/public/vis/map/kibana_map_layer.js rename to src/plugins/maps_legacy/public/map/kibana_map_layer.js diff --git a/src/legacy/ui/public/vis/map/map_messages.js b/src/plugins/maps_legacy/public/map/map_messages.js similarity index 93% rename from src/legacy/ui/public/vis/map/map_messages.js rename to src/plugins/maps_legacy/public/map/map_messages.js index 211796d734958..7422fa71280fb 100644 --- a/src/legacy/ui/public/vis/map/map_messages.js +++ b/src/plugins/maps_legacy/public/map/map_messages.js @@ -17,11 +17,10 @@ * under the License. */ -import { toastNotifications } from 'ui/notify'; import React from 'react'; import { FormattedMessage } from '@kbn/i18n/react'; import { EuiSpacer, EuiButtonEmpty } from '@elastic/eui'; -import { toMountPoint } from '../../../../../plugins/kibana_react/public'; +import { toMountPoint } from '../../../kibana_react/public'; export const createZoomWarningMsg = (function() { let disableZoomMsg = false; @@ -40,7 +39,7 @@ export const createZoomWarningMsg = (function() { <div> <p> <FormattedMessage - id="common.ui.vis.kibanaMap.zoomWarning" + id="maps_legacy.kibanaMap.zoomWarning" defaultMessage="You've reached the maximum number of zoom levels. To zoom all the way in, upgrade to the {defaultDistribution} of Elasticsearch and Kibana. You'll get @@ -105,12 +104,12 @@ export const createZoomWarningMsg = (function() { 'data-test-subj': 'maxZoomWarning', }; - return (getZoomLevel, getMaxZoomLevel) => { + return (toastService, getZoomLevel, getMaxZoomLevel) => { return () => { const zoomLevel = getZoomLevel(); const maxMapZoom = getMaxZoomLevel(); if (!disableZoomMsg && zoomLevel === maxMapZoom) { - toastNotifications.addDanger(zoomToast); + toastService.addDanger(zoomToast); } }; }; diff --git a/src/plugins/maps_legacy/public/map/precision.ts b/src/plugins/maps_legacy/public/map/precision.ts new file mode 100644 index 0000000000000..a1b3b72f201a4 --- /dev/null +++ b/src/plugins/maps_legacy/public/map/precision.ts @@ -0,0 +1,74 @@ +/* + * 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. + */ + +// @ts-ignore +import { getUiSettings } from '../kibana_services'; +import { geohashColumns } from './decode_geo_hash'; + +/** + * Get the number of geohash columns (world-wide) for a given precision + * @param precision the geohash precision + * @returns {number} the number of columns + */ + +const DEFAULT_PRECISION = 2; + +function getMaxPrecision() { + const config = getUiSettings(); + return parseInt(config.get('visualization:tileMap:maxPrecision'), 10) || 12; +} + +export function getZoomPrecision() { + /** + * Map Leaflet zoom levels to geohash precision levels. + * The size of a geohash column-width on the map should be at least `minGeohashPixels` pixels wide. + */ + const zoomPrecision: any = {}; + const minGeohashPixels = 16; + const maxPrecision = getMaxPrecision(); + + for (let zoom = 0; zoom <= 21; zoom += 1) { + const worldPixels = 256 * Math.pow(2, zoom); + zoomPrecision[zoom] = 1; + for (let precision = 2; precision <= maxPrecision; precision += 1) { + const columns = geohashColumns(precision); + if (worldPixels / columns >= minGeohashPixels) { + zoomPrecision[zoom] = precision; + } else { + break; + } + } + } + return zoomPrecision; +} + +export function getPrecision(val: string) { + let precision = parseInt(val, 10); + const maxPrecision = getMaxPrecision(); + + if (Number.isNaN(precision)) { + precision = DEFAULT_PRECISION; + } + + if (precision > maxPrecision) { + return maxPrecision; + } + + return precision; +} diff --git a/src/legacy/ui/public/vis/map/service_settings.d.ts b/src/plugins/maps_legacy/public/map/service_settings.d.ts similarity index 97% rename from src/legacy/ui/public/vis/map/service_settings.d.ts rename to src/plugins/maps_legacy/public/map/service_settings.d.ts index 6766000861e47..e265accaeb8fd 100644 --- a/src/legacy/ui/public/vis/map/service_settings.d.ts +++ b/src/plugins/maps_legacy/public/map/service_settings.d.ts @@ -44,7 +44,7 @@ export interface VectorLayer extends FileLayer { isEMS: boolean; } -export interface ServiceSettings { +export interface IServiceSettings { getEMSHotLink(layer: FileLayer): Promise<string>; getTMSServices(): Promise<TmsLayer[]>; getFileLayers(): Promise<FileLayer[]>; diff --git a/src/plugins/maps_legacy/public/map/service_settings.js b/src/plugins/maps_legacy/public/map/service_settings.js new file mode 100644 index 0000000000000..11c853d39e107 --- /dev/null +++ b/src/plugins/maps_legacy/public/map/service_settings.js @@ -0,0 +1,254 @@ +/* + * 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. + */ + +import _ from 'lodash'; +import MarkdownIt from 'markdown-it'; +import { EMSClient } from '@elastic/ems-client'; +import { i18n } from '@kbn/i18n'; +import { getInjectedVarFunc } from '../kibana_services'; +import { ORIGIN } from '../common/origin'; + +const TMS_IN_YML_ID = 'TMS in config/kibana.yml'; + +export class ServiceSettings { + constructor() { + const getInjectedVar = getInjectedVarFunc(); + this.mapConfig = getInjectedVar('mapConfig'); + this.tilemapsConfig = getInjectedVar('tilemapsConfig'); + const kbnVersion = getInjectedVar('version'); + + this._showZoomMessage = true; + this._emsClient = new EMSClient({ + language: i18n.getLocale(), + appVersion: kbnVersion, + appName: 'kibana', + fileApiUrl: this.mapConfig.emsFileApiUrl, + tileApiUrl: this.mapConfig.emsTileApiUrl, + landingPageUrl: this.mapConfig.emsLandingPageUrl, + // Wrap to avoid errors passing window fetch + fetchFunction: function(...args) { + return fetch(...args); + }, + }); + this.getTMSOptions(); + } + + getTMSOptions() { + const markdownIt = new MarkdownIt({ + html: false, + linkify: true, + }); + + // TMS attribution + const attributionFromConfig = _.escape( + markdownIt.render(this.tilemapsConfig.deprecated.config.options.attribution || '') + ); + // TMS Options + this.tmsOptionsFromConfig = _.assign({}, this.tilemapsConfig.deprecated.config.options, { + attribution: attributionFromConfig, + }); + } + + shouldShowZoomMessage({ origin }) { + return origin === ORIGIN.EMS && this._showZoomMessage; + } + + disableZoomMessage() { + this._showZoomMessage = false; + } + + __debugStubManifestCalls(manifestRetrieval) { + const oldGetManifest = this._emsClient.getManifest; + this._emsClient.getManifest = manifestRetrieval; + return { + removeStub: () => { + delete this._emsClient.getManifest; + //not strictly necessary since this is prototype method + if (this._emsClient.getManifest !== oldGetManifest) { + this._emsClient.getManifest = oldGetManifest; + } + }, + }; + } + + async getFileLayers() { + if (!this.mapConfig.includeElasticMapsService) { + return []; + } + + const fileLayers = await this._emsClient.getFileLayers(); + return fileLayers.map(fileLayer => { + //backfill to older settings + const format = fileLayer.getDefaultFormatType(); + const meta = fileLayer.getDefaultFormatMeta(); + + return { + name: fileLayer.getDisplayName(), + origin: fileLayer.getOrigin(), + id: fileLayer.getId(), + created_at: fileLayer.getCreatedAt(), + attribution: fileLayer.getHTMLAttribution(), + fields: fileLayer.getFieldsInLanguage(), + format: format, //legacy: format and meta are split up + meta: meta, //legacy, format and meta are split up + }; + }); + } + + /** + * Returns all the services published by EMS (if configures) + * It also includes the service configured in tilemap (override) + */ + async getTMSServices() { + let allServices = []; + if (this.tilemapsConfig.deprecated.isOverridden) { + //use tilemap.* settings from yml + const tmsService = _.cloneDeep(this.tmsOptionsFromConfig); + tmsService.id = TMS_IN_YML_ID; + tmsService.origin = ORIGIN.KIBANA_YML; + allServices.push(tmsService); + } + + if (this.mapConfig.includeElasticMapsService) { + const servicesFromManifest = await this._emsClient.getTMSServices(); + const strippedServiceFromManifest = await Promise.all( + servicesFromManifest + .filter(tmsService => tmsService.getId() === this.mapConfig.emsTileLayerId.bright) + .map(async tmsService => { + //shim for compatibility + return { + origin: tmsService.getOrigin(), + id: tmsService.getId(), + minZoom: await tmsService.getMinZoom(), + maxZoom: await tmsService.getMaxZoom(), + attribution: tmsService.getHTMLAttribution(), + }; + }) + ); + allServices = allServices.concat(strippedServiceFromManifest); + } + + return allServices; + } + + /** + * Add optional query-parameters to all requests + * + * @param additionalQueryParams + */ + addQueryParams(additionalQueryParams) { + this._emsClient.addQueryParams(additionalQueryParams); + } + + async getEMSHotLink(fileLayerConfig) { + const fileLayers = await this._emsClient.getFileLayers(); + const layer = fileLayers.find(fileLayer => { + const hasIdByName = fileLayer.hasId(fileLayerConfig.name); //legacy + const hasIdById = fileLayer.hasId(fileLayerConfig.id); + return hasIdByName || hasIdById; + }); + return layer ? layer.getEMSHotLink() : null; + } + + async _getAttributesForEMSTMSLayer(isDesaturated, isDarkMode) { + const tmsServices = await this._emsClient.getTMSServices(); + const emsTileLayerId = this.mapConfig.emsTileLayerId; + let serviceId; + if (isDarkMode) { + serviceId = emsTileLayerId.dark; + } else { + if (isDesaturated) { + serviceId = emsTileLayerId.desaturated; + } else { + serviceId = emsTileLayerId.bright; + } + } + const tmsService = tmsServices.find(service => { + return service.getId() === serviceId; + }); + return { + url: await tmsService.getUrlTemplate(), + minZoom: await tmsService.getMinZoom(), + maxZoom: await tmsService.getMaxZoom(), + attribution: await tmsService.getHTMLAttribution(), + origin: ORIGIN.EMS, + }; + } + + async getAttributesForTMSLayer(tmsServiceConfig, isDesaturated, isDarkMode) { + if (tmsServiceConfig.origin === ORIGIN.EMS) { + return this._getAttributesForEMSTMSLayer(isDesaturated, isDarkMode); + } else if (tmsServiceConfig.origin === ORIGIN.KIBANA_YML) { + const config = this.tilemapsConfig.deprecated.config; + const attrs = _.pick(config, ['url', 'minzoom', 'maxzoom', 'attribution']); + return { ...attrs, ...{ origin: ORIGIN.KIBANA_YML } }; + } else { + //this is an older config. need to resolve this dynamically. + if (tmsServiceConfig.id === TMS_IN_YML_ID) { + const config = this.tilemapsConfig.deprecated.config; + const attrs = _.pick(config, ['url', 'minzoom', 'maxzoom', 'attribution']); + return { ...attrs, ...{ origin: ORIGIN.KIBANA_YML } }; + } else { + //assume ems + return this._getAttributesForEMSTMSLayer(isDesaturated, isDarkMode); + } + } + } + + async _getFileUrlFromEMS(fileLayerConfig) { + const fileLayers = await this._emsClient.getFileLayers(); + const layer = fileLayers.find(fileLayer => { + const hasIdByName = fileLayer.hasId(fileLayerConfig.name); //legacy + const hasIdById = fileLayer.hasId(fileLayerConfig.id); + return hasIdByName || hasIdById; + }); + + if (layer) { + return layer.getDefaultFormatUrl(); + } else { + throw new Error(`File ${fileLayerConfig.name} not recognized`); + } + } + + async getUrlForRegionLayer(fileLayerConfig) { + let url; + if (fileLayerConfig.origin === ORIGIN.EMS) { + url = this._getFileUrlFromEMS(fileLayerConfig); + } else if (fileLayerConfig.layerId && fileLayerConfig.layerId.startsWith(`${ORIGIN.EMS}.`)) { + //fallback for older saved objects + url = this._getFileUrlFromEMS(fileLayerConfig); + } else if ( + fileLayerConfig.layerId && + fileLayerConfig.layerId.startsWith(`${ORIGIN.KIBANA_YML}.`) + ) { + //fallback for older saved objects + url = fileLayerConfig.url; + } else { + //generic fallback + url = fileLayerConfig.url; + } + return url; + } + + async getJsonForRegionLayer(fileLayerConfig) { + const url = await this.getUrlForRegionLayer(fileLayerConfig); + const response = await fetch(url); + return await response.json(); + } +} diff --git a/src/legacy/ui/public/vis/map/zoom_to_precision.ts b/src/plugins/maps_legacy/public/map/zoom_to_precision.ts similarity index 100% rename from src/legacy/ui/public/vis/map/zoom_to_precision.ts rename to src/plugins/maps_legacy/public/map/zoom_to_precision.ts diff --git a/src/plugins/maps_legacy/public/plugin.ts b/src/plugins/maps_legacy/public/plugin.ts new file mode 100644 index 0000000000000..751be65e1dbf6 --- /dev/null +++ b/src/plugins/maps_legacy/public/plugin.ts @@ -0,0 +1,57 @@ +/* + * 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. + */ + +// @ts-ignore +import { CoreSetup, CoreStart, Plugin } from 'kibana/public'; +// @ts-ignore +import { setToasts, setUiSettings, setInjectedVarFunc } from './kibana_services'; +// @ts-ignore +import { ServiceSettings } from './map/service_settings'; +// @ts-ignore +import { getPrecision, getZoomPrecision } from './map/precision'; +import { MapsLegacyPluginSetup, MapsLegacyPluginStart } from './index'; + +/** + * These are the interfaces with your public contracts. You should export these + * for other plugins to use in _their_ `SetupDeps`/`StartDeps` interfaces. + * @public + */ + +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface MapsLegacySetupDependencies {} +// eslint-disable-next-line @typescript-eslint/no-empty-interface +export interface MapsLegacyStartDependencies {} + +export class MapsLegacyPlugin implements Plugin<MapsLegacyPluginSetup, MapsLegacyPluginStart> { + constructor() {} + + public setup(core: CoreSetup, plugins: MapsLegacySetupDependencies) { + setToasts(core.notifications.toasts); + setUiSettings(core.uiSettings); + setInjectedVarFunc(core.injectedMetadata.getInjectedVar); + + return { + serviceSettings: new ServiceSettings(), + getZoomPrecision, + getPrecision, + }; + } + + public start(core: CoreStart, plugins: MapsLegacyStartDependencies) {} +} diff --git a/x-pack/legacy/plugins/tilemap/public/vis_type_enhancers/update_tilemap_settings.js b/x-pack/legacy/plugins/tilemap/public/vis_type_enhancers/update_tilemap_settings.js index 45764016f0311..294bc31e3893e 100644 --- a/x-pack/legacy/plugins/tilemap/public/vis_type_enhancers/update_tilemap_settings.js +++ b/x-pack/legacy/plugins/tilemap/public/vis_type_enhancers/update_tilemap_settings.js @@ -4,20 +4,13 @@ * you may not use this file except in compliance with the Elastic License. */ -import uiRoutes from 'ui/routes'; import { xpackInfo } from 'plugins/xpack_main/services/xpack_info'; -import 'ui/vis/map/service_settings'; +import { npSetup } from 'ui/new_platform'; -uiRoutes.addSetupWork(function($injector, serviceSettings) { - const tileMapPluginInfo = xpackInfo.get('features.tilemap'); +const tileMapPluginInfo = xpackInfo.get('features.tilemap'); - if (!tileMapPluginInfo) { - return; - } - - if (!tileMapPluginInfo.license.active || !tileMapPluginInfo.license.valid) { - return; - } +if (tileMapPluginInfo && (tileMapPluginInfo.license.active || tileMapPluginInfo.license.valid)) { + const { serviceSettings } = npSetup.plugins.mapsLegacy; serviceSettings.addQueryParams({ license: tileMapPluginInfo.license.uid }); serviceSettings.disableZoomMessage(); -}); +} diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index 3cebde793a085..a8574971426f5 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -319,8 +319,6 @@ "common.ui.stateManagement.unableToStoreHistoryInSessionErrorMessage": "セッションがいっぱいで安全に削除できるアイテムが見つからないため、Kibana は履歴アイテムを保存できません。\n\nこれは大抵新規タブに移動することで解決されますが、より大きな問題が原因である可能性もあります。このメッセージが定期的に表示される場合は、{gitHubIssuesUrl} で問題を報告してください。", "common.ui.url.replacementFailedErrorMessage": "置換に失敗、未解決の表現式: {expr}", "common.ui.url.savedObjectIsMissingNotificationMessage": "保存されたオブジェクトがありません", - "common.ui.vis.kibanaMap.leaflet.fitDataBoundsAriaLabel": "データバウンドを合わせる", - "common.ui.vis.kibanaMap.zoomWarning": "ズームレベルが最大に達しました。完全にズームインするには、Elasticsearch と Kibana の {defaultDistribution} にアップグレードしてください。{ems} でより多くのズームレベルが利用できます。または、独自のマップサーバーを構成できます。詳細は { wms } または { configSettings} をご覧ください。", "console.autocomplete.addMethodMetaText": "メソド", "console.consoleDisplayName": "コンソール", "console.consoleMenu.copyAsCurlMessage": "リクエストが URL としてコピーされました", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index 1daf66117e948..df5cccf1a9b97 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -319,8 +319,6 @@ "common.ui.stateManagement.unableToStoreHistoryInSessionErrorMessage": "Kibana 无法将历史记录项存储在您的会话中，因为其已满，并且似乎没有任何可安全删除的项。\n\n通常可通过移至新的标签页来解决此问题，但这会导致更大的问题。如果您有规律地看到此消息，请在 {gitHubIssuesUrl} 提交问题。", "common.ui.url.replacementFailedErrorMessage": "替换失败，未解析的表达式：{expr}", "common.ui.url.savedObjectIsMissingNotificationMessage": "已保存对象缺失", - "common.ui.vis.kibanaMap.leaflet.fitDataBoundsAriaLabel": "适应数据边界", - "common.ui.vis.kibanaMap.zoomWarning": "已达到缩放级别最大数目。要一直放大，请升级到 Elasticsearch 和 Kibana 的 {defaultDistribution}。您可以通过 {ems} 免费使用其他缩放级别。或者，您可以配置自己的地图服务器。请前往 { wms } 或 { configSettings} 以获取详细信息。", "console.autocomplete.addMethodMetaText": "方法", "console.consoleDisplayName": "控制台", "console.consoleMenu.copyAsCurlMessage": "请求已复制为 cURL", From 5bc233f3c733323834b669cc7ef4be809d12ddc6 Mon Sep 17 00:00:00 2001 From: Ahmad Bamieh <ahmadbamieh@gmail.com> Date: Mon, 13 Apr 2020 23:45:13 +0300 Subject: [PATCH 075/102] [Telemetry] force staging urls in tests (#63356) * specify telemetry url configs * opt out by default except where we are testing telemetry --- test/common/config.js | 4 ++++ x-pack/test/api_integration/config.js | 2 ++ x-pack/test/functional/config.js | 1 - x-pack/test/functional/config_security_basic.js | 1 - 4 files changed, 6 insertions(+), 2 deletions(-) diff --git a/test/common/config.js b/test/common/config.js index faf8cef027170..ca80dfb01012f 100644 --- a/test/common/config.js +++ b/test/common/config.js @@ -56,6 +56,10 @@ export default function() { `--elasticsearch.password=${kibanaServerTestUser.password}`, `--home.disableWelcomeScreen=true`, '--telemetry.banner=false', + '--telemetry.optIn=false', + // These are *very* important to have them pointing to staging + '--telemetry.url=https://telemetry-staging.elastic.co/xpack/v2/send', + '--telemetry.optInStatusUrl=https://telemetry-staging.elastic.co/opt_in_status/v2/send', `--server.maxPayloadBytes=1679958`, // newsfeed mock service `--plugin-path=${path.join(__dirname, 'fixtures', 'plugins', 'newsfeed')}`, diff --git a/x-pack/test/api_integration/config.js b/x-pack/test/api_integration/config.js index b62368bf2d608..0eac7c58044e6 100644 --- a/x-pack/test/api_integration/config.js +++ b/x-pack/test/api_integration/config.js @@ -27,6 +27,8 @@ export async function getApiIntegrationConfig({ readConfigFile }) { '--xpack.security.session.idleTimeout=3600000', // 1 hour '--optimize.enabled=false', '--xpack.endpoint.enabled=true', + '--telemetry.optIn=true', + '--xpack.endpoint.enabled=true', '--xpack.ingestManager.enabled=true', '--xpack.ingestManager.fleet.enabled=true', '--xpack.endpoint.alertResultListDefaultDateRange.from=2018-01-10T00:00:00.000Z', diff --git a/x-pack/test/functional/config.js b/x-pack/test/functional/config.js index bc9a67da731cc..f26110513a9b3 100644 --- a/x-pack/test/functional/config.js +++ b/x-pack/test/functional/config.js @@ -85,7 +85,6 @@ export default async function({ readConfigFile }) { '--stats.maximumWaitTimeForAllCollectorsInS=1', '--xpack.security.encryptionKey="wuGNaIhoMpk5sO4UBxgr3NyW1sFcLgIf"', // server restarts should not invalidate active sessions '--xpack.encryptedSavedObjects.encryptionKey="DkdXazszSCYexXqz4YktBGHCRkV6hyNK"', - '--telemetry.banner=false', '--timelion.ui.enabled=true', ], }, diff --git a/x-pack/test/functional/config_security_basic.js b/x-pack/test/functional/config_security_basic.js index 12d94e922a97c..2bb59796b5517 100644 --- a/x-pack/test/functional/config_security_basic.js +++ b/x-pack/test/functional/config_security_basic.js @@ -42,7 +42,6 @@ export default async function({ readConfigFile }) { ...kibanaCommonConfig.get('kbnTestServer.serverArgs'), '--server.uuid=5b2de169-2785-441b-ae8c-186a1936b17d', '--xpack.security.encryptionKey="wuGNaIhoMpk5sO4UBxgr3NyW1sFcLgIf"', // server restarts should not invalidate active sessions - '--telemetry.banner=false', ], }, uiSettings: { From 500b069efd2e344147169163983c4535b21fed8f Mon Sep 17 00:00:00 2001 From: Patrick Mueller <pmuellr@gmail.com> Date: Mon, 13 Apr 2020 17:41:22 -0400 Subject: [PATCH 076/102] [Alerting] set correct parameter for unauthented email action (#63086) PR https://github.com/elastic/kibana/pull/60839 added support for unauthenticated emails, but didn't actually do enough to make it work. This PR completes that support, and adds some tests. You can do manual testing now with [maildev](http://maildev.github.io/maildev/). --- .../server/builtin_action_types/email.test.ts | 107 ++++++++++- .../server/builtin_action_types/email.ts | 11 +- .../lib/send_email.test.ts | 175 ++++++++++++++++++ .../builtin_action_types/lib/send_email.ts | 22 ++- 4 files changed, 299 insertions(+), 16 deletions(-) create mode 100644 x-pack/plugins/actions/server/builtin_action_types/lib/send_email.test.ts diff --git a/x-pack/plugins/actions/server/builtin_action_types/email.test.ts b/x-pack/plugins/actions/server/builtin_action_types/email.test.ts index 469df4fd86e2c..658f8f3fd8cf9 100644 --- a/x-pack/plugins/actions/server/builtin_action_types/email.test.ts +++ b/x-pack/plugins/actions/server/builtin_action_types/email.test.ts @@ -255,7 +255,14 @@ describe('execute()', () => { services, }; sendEmailMock.mockReset(); - await actionType.executor(executorOptions); + const result = await actionType.executor(executorOptions); + expect(result).toMatchInlineSnapshot(` + Object { + "actionId": "some-id", + "data": undefined, + "status": "ok", + } + `); expect(sendEmailMock.mock.calls[0][1]).toMatchInlineSnapshot(` Object { "content": Object { @@ -282,4 +289,102 @@ describe('execute()', () => { } `); }); + + test('parameters are as expected with no auth', async () => { + const config: ActionTypeConfigType = { + service: null, + host: 'a host', + port: 42, + secure: true, + from: 'bob@example.com', + }; + const secrets: ActionTypeSecretsType = { + user: null, + password: null, + }; + const params: ActionParamsType = { + to: ['jim@example.com'], + cc: ['james@example.com'], + bcc: ['jimmy@example.com'], + subject: 'the subject', + message: 'a message to you', + }; + + const actionId = 'some-id'; + const executorOptions: ActionTypeExecutorOptions = { + actionId, + config, + params, + secrets, + services, + }; + sendEmailMock.mockReset(); + await actionType.executor(executorOptions); + expect(sendEmailMock.mock.calls[0][1]).toMatchInlineSnapshot(` + Object { + "content": Object { + "message": "a message to you", + "subject": "the subject", + }, + "routing": Object { + "bcc": Array [ + "jimmy@example.com", + ], + "cc": Array [ + "james@example.com", + ], + "from": "bob@example.com", + "to": Array [ + "jim@example.com", + ], + }, + "transport": Object { + "host": "a host", + "port": 42, + "secure": true, + }, + } + `); + }); + + test('returns expected result when an error is thrown', async () => { + const config: ActionTypeConfigType = { + service: null, + host: 'a host', + port: 42, + secure: true, + from: 'bob@example.com', + }; + const secrets: ActionTypeSecretsType = { + user: null, + password: null, + }; + const params: ActionParamsType = { + to: ['jim@example.com'], + cc: ['james@example.com'], + bcc: ['jimmy@example.com'], + subject: 'the subject', + message: 'a message to you', + }; + + const actionId = 'some-id'; + const executorOptions: ActionTypeExecutorOptions = { + actionId, + config, + params, + secrets, + services, + }; + sendEmailMock.mockReset(); + sendEmailMock.mockRejectedValue(new Error('wops')); + const result = await actionType.executor(executorOptions); + expect(result).toMatchInlineSnapshot(` + Object { + "actionId": "some-id", + "message": "error sending email", + "serviceMessage": "wops", + "status": "error", + } + `); + }); }); diff --git a/x-pack/plugins/actions/server/builtin_action_types/email.ts b/x-pack/plugins/actions/server/builtin_action_types/email.ts index 7992920fdfcb4..ca8d089ad2946 100644 --- a/x-pack/plugins/actions/server/builtin_action_types/email.ts +++ b/x-pack/plugins/actions/server/builtin_action_types/email.ts @@ -9,7 +9,7 @@ import { i18n } from '@kbn/i18n'; import { schema, TypeOf } from '@kbn/config-schema'; import nodemailerGetService from 'nodemailer/lib/well-known'; -import { sendEmail, JSON_TRANSPORT_SERVICE } from './lib/send_email'; +import { sendEmail, JSON_TRANSPORT_SERVICE, SendEmailOptions, Transport } from './lib/send_email'; import { portSchema } from './lib/schemas'; import { Logger } from '../../../../../src/core/server'; import { ActionType, ActionTypeExecutorOptions, ActionTypeExecutorResult } from '../types'; @@ -143,7 +143,7 @@ async function executor( const secrets = execOptions.secrets as ActionTypeSecretsType; const params = execOptions.params as ActionParamsType; - const transport: any = {}; + const transport: Transport = {}; if (secrets.user != null) { transport.user = secrets.user; @@ -155,12 +155,13 @@ async function executor( if (config.service !== null) { transport.service = config.service; } else { - transport.host = config.host; - transport.port = config.port; + // already validated service or host/port is not null ... + transport.host = config.host!; + transport.port = config.port!; transport.secure = getSecureValue(config.secure, config.port); } - const sendEmailOptions = { + const sendEmailOptions: SendEmailOptions = { transport, routing: { from: config.from, diff --git a/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.test.ts b/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.test.ts new file mode 100644 index 0000000000000..42160dc2fc22b --- /dev/null +++ b/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.test.ts @@ -0,0 +1,175 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +jest.mock('nodemailer', () => ({ + createTransport: jest.fn(), +})); + +import { Logger } from '../../../../../../src/core/server'; +import { sendEmail } from './send_email'; +import { loggingServiceMock } from '../../../../../../src/core/server/mocks'; +import nodemailer from 'nodemailer'; + +const createTransportMock = nodemailer.createTransport as jest.Mock; +const sendMailMockResult = { result: 'does not matter' }; +const sendMailMock = jest.fn(); + +const mockLogger = loggingServiceMock.create().get() as jest.Mocked<Logger>; + +describe('send_email module', () => { + beforeEach(() => { + jest.resetAllMocks(); + createTransportMock.mockReturnValue({ sendMail: sendMailMock }); + sendMailMock.mockResolvedValue(sendMailMockResult); + }); + + test('handles authenticated email using service', async () => { + const sendEmailOptions = getSendEmailOptions(); + const result = await sendEmail(mockLogger, sendEmailOptions); + expect(result).toBe(sendMailMockResult); + expect(createTransportMock.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + Object { + "auth": Object { + "pass": "changeme", + "user": "elastic", + }, + "service": "whatever", + }, + ] + `); + expect(sendMailMock.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + Object { + "bcc": Array [], + "cc": Array [ + "bob@example.com", + "robert@example.com", + ], + "from": "fred@example.com", + "html": "<p>a message</p> + ", + "subject": "a subject", + "text": "a message", + "to": Array [ + "jim@example.com", + ], + }, + ] + `); + }); + + test('handles unauthenticated email using not secure host/port', async () => { + const sendEmailOptions = getSendEmailOptions(); + delete sendEmailOptions.transport.service; + delete sendEmailOptions.transport.user; + delete sendEmailOptions.transport.password; + sendEmailOptions.transport.host = 'example.com'; + sendEmailOptions.transport.port = 1025; + const result = await sendEmail(mockLogger, sendEmailOptions); + expect(result).toBe(sendMailMockResult); + expect(createTransportMock.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + Object { + "host": "example.com", + "port": 1025, + "secure": false, + "tls": Object { + "rejectUnauthorized": false, + }, + }, + ] + `); + expect(sendMailMock.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + Object { + "bcc": Array [], + "cc": Array [ + "bob@example.com", + "robert@example.com", + ], + "from": "fred@example.com", + "html": "<p>a message</p> + ", + "subject": "a subject", + "text": "a message", + "to": Array [ + "jim@example.com", + ], + }, + ] + `); + }); + + test('handles unauthenticated email using secure host/port', async () => { + const sendEmailOptions = getSendEmailOptions(); + delete sendEmailOptions.transport.service; + delete sendEmailOptions.transport.user; + delete sendEmailOptions.transport.password; + sendEmailOptions.transport.host = 'example.com'; + sendEmailOptions.transport.port = 1025; + sendEmailOptions.transport.secure = true; + const result = await sendEmail(mockLogger, sendEmailOptions); + expect(result).toBe(sendMailMockResult); + expect(createTransportMock.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + Object { + "host": "example.com", + "port": 1025, + "secure": true, + }, + ] + `); + expect(sendMailMock.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + Object { + "bcc": Array [], + "cc": Array [ + "bob@example.com", + "robert@example.com", + ], + "from": "fred@example.com", + "html": "<p>a message</p> + ", + "subject": "a subject", + "text": "a message", + "to": Array [ + "jim@example.com", + ], + }, + ] + `); + }); + + test('passes nodemailer exceptions to caller', async () => { + const sendEmailOptions = getSendEmailOptions(); + + sendMailMock.mockReset(); + sendMailMock.mockRejectedValue(new Error('wops')); + + await expect(sendEmail(mockLogger, sendEmailOptions)).rejects.toThrow('wops'); + }); +}); + +function getSendEmailOptions(): any { + return { + content: { + message: 'a message', + subject: 'a subject', + }, + routing: { + from: 'fred@example.com', + to: ['jim@example.com'], + cc: ['bob@example.com', 'robert@example.com'], + bcc: [], + }, + transport: { + service: 'whatever', + user: 'elastic', + password: 'changeme', + }, + }; +} diff --git a/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.ts b/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.ts index 47d7aff8022ce..ffbf7485a8b0b 100644 --- a/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.ts +++ b/x-pack/plugins/actions/server/builtin_action_types/lib/send_email.ts @@ -14,30 +14,30 @@ import { Logger } from '../../../../../../src/core/server'; // an email "service" which doesn't actually send, just returns what it would send export const JSON_TRANSPORT_SERVICE = '__json'; -interface SendEmailOptions { +export interface SendEmailOptions { transport: Transport; routing: Routing; content: Content; } // config validation ensures either service is set or host/port are set -interface Transport { - user: string; - password: string; +export interface Transport { + user?: string; + password?: string; service?: string; // see: https://nodemailer.com/smtp/well-known/ host?: string; port?: number; secure?: boolean; // see: https://nodemailer.com/smtp/#tls-options } -interface Routing { +export interface Routing { from: string; to: string[]; cc: string[]; bcc: string[]; } -interface Content { +export interface Content { subject: string; message: string; } @@ -49,12 +49,14 @@ export async function sendEmail(logger: Logger, options: SendEmailOptions): Prom const { from, to, cc, bcc } = routing; const { subject, message } = content; - const transportConfig: Record<string, any> = { - auth: { + const transportConfig: Record<string, any> = {}; + + if (user != null && password != null) { + transportConfig.auth = { user, pass: password, - }, - }; + }; + } if (service === JSON_TRANSPORT_SERVICE) { transportConfig.jsonTransport = true; From 3623875175720d867e1c37bb10e20d4e4aacb1d9 Mon Sep 17 00:00:00 2001 From: Nathan Reese <reese.nathan@gmail.com> Date: Mon, 13 Apr 2020 15:53:07 -0600 Subject: [PATCH 077/102] [Maps] fix bug where toggling Scaling type does not re-fetch data (#63326) * [Maps] fix bug where toggling Scaling type does not re-fetch data * reset to empty array instead of deleting * move setting of layer type to action creator instead of side effect of UPDATE_SOURCE_PROP * review feedback --- .../maps/public/actions/map_actions.js | 38 +++++++++++++++++-- x-pack/plugins/maps/public/reducers/map.js | 13 +------ 2 files changed, 36 insertions(+), 15 deletions(-) diff --git a/x-pack/legacy/plugins/maps/public/actions/map_actions.js b/x-pack/legacy/plugins/maps/public/actions/map_actions.js index aa55cf0808ef2..7bfbf5761c5b8 100644 --- a/x-pack/legacy/plugins/maps/public/actions/map_actions.js +++ b/x-pack/legacy/plugins/maps/public/actions/map_actions.js @@ -125,9 +125,21 @@ async function syncDataForAllLayers(dispatch, getState, dataFilters) { export function cancelAllInFlightRequests() { return (dispatch, getState) => { getLayerList(getState()).forEach(layer => { - layer.getInFlightRequestTokens().forEach(requestToken => { - dispatch(cancelRequest(requestToken)); - }); + dispatch(clearDataRequests(layer)); + }); + }; +} + +function clearDataRequests(layer) { + return dispatch => { + layer.getInFlightRequestTokens().forEach(requestToken => { + dispatch(cancelRequest(requestToken)); + }); + dispatch({ + type: UPDATE_LAYER_PROP, + id: layer.getId(), + propName: '__dataRequests', + newValue: [], }); }; } @@ -663,13 +675,31 @@ export function updateSourceProp(layerId, propName, value, newLayerType) { layerId, propName, value, - newLayerType, }); + if (newLayerType) { + dispatch(updateLayerType(layerId, newLayerType)); + } await dispatch(clearMissingStyleProperties(layerId)); dispatch(syncDataForLayer(layerId)); }; } +function updateLayerType(layerId, newLayerType) { + return (dispatch, getState) => { + const layer = getLayerById(layerId, getState()); + if (!layer || layer.getType() === newLayerType) { + return; + } + dispatch(clearDataRequests(layer)); + dispatch({ + type: UPDATE_LAYER_PROP, + id: layerId, + propName: 'type', + newValue: newLayerType, + }); + }; +} + export function syncDataForLayer(layerId) { return async (dispatch, getState) => { const targetLayer = getLayerById(layerId, getState()); diff --git a/x-pack/plugins/maps/public/reducers/map.js b/x-pack/plugins/maps/public/reducers/map.js index 1e20df89c8fad..7e07569b44b83 100644 --- a/x-pack/plugins/maps/public/reducers/map.js +++ b/x-pack/plugins/maps/public/reducers/map.js @@ -74,7 +74,7 @@ const updateLayerInList = (state, layerId, attribute, newValue) => { return { ...state, layerList: updatedList }; }; -const updateLayerSourceDescriptorProp = (state, layerId, propName, value, newLayerType) => { +const updateLayerSourceDescriptorProp = (state, layerId, propName, value) => { const { layerList } = state; const layerIdx = getLayerIndex(layerList, layerId); const updatedLayer = { @@ -84,9 +84,6 @@ const updateLayerSourceDescriptorProp = (state, layerId, propName, value, newLay [propName]: value, }, }; - if (newLayerType) { - updatedLayer.type = newLayerType; - } const updatedList = [ ...layerList.slice(0, layerIdx), updatedLayer, @@ -261,13 +258,7 @@ export function map(state = INITIAL_STATE, action) { case UPDATE_LAYER_PROP: return updateLayerInList(state, action.id, action.propName, action.newValue); case UPDATE_SOURCE_PROP: - return updateLayerSourceDescriptorProp( - state, - action.layerId, - action.propName, - action.value, - action.newLayerType - ); + return updateLayerSourceDescriptorProp(state, action.layerId, action.propName, action.value); case SET_JOINS: const layerDescriptor = state.layerList.find( descriptor => descriptor.id === action.layer.getId() From b54388746dedfadd8f5432f9005c063271afc129 Mon Sep 17 00:00:00 2001 From: The SpaceCake Project <randomuserid@users.noreply.github.com> Date: Mon, 13 Apr 2020 18:42:10 -0400 Subject: [PATCH 078/102] investigation notes field (documentation / metadata) (#63386) * notes field added text to the "investigation notes" field in md which the field supports. * Revert "notes field" This reverts commit dae6ffc683150b9c471f3591073427ae62949a6e. * Revert "Revert "notes field"" This reverts commit f9de4bfc920217740fde316d3462cba409afa654. * Update linux_anomalous_network_activity.json * text change change to "Signals from this rule indicate" --- .../prepackaged_rules/linux_anomalous_network_activity.json | 3 ++- .../prepackaged_rules/linux_anomalous_process_all_hosts.json | 3 ++- .../rules/prepackaged_rules/linux_anomalous_user_name.json | 3 ++- .../rules/prepackaged_rules/rare_process_by_host_linux.json | 3 ++- .../rules/prepackaged_rules/rare_process_by_host_windows.json | 3 ++- .../prepackaged_rules/windows_anomalous_network_activity.json | 3 ++- .../prepackaged_rules/windows_anomalous_process_all_hosts.json | 3 ++- .../rules/prepackaged_rules/windows_anomalous_user_name.json | 3 ++- .../windows_rare_user_type10_remote_login.json | 3 ++- 9 files changed, 18 insertions(+), 9 deletions(-) diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json index fe248a6c1e23e..41f38173dba33 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_network_activity.json @@ -20,5 +20,6 @@ "ML" ], "type": "machine_learning", + "note": "### Investigating Unusual Network Activity ###\nSignals from this rule indicate the presence of network activity from a Linux process for which network activity is rare and unusual. Here are some possible avenues of investigation:\n- Consider the IP addresses and ports. Are these used by normal but infrequent network workflows? Are they expected or unexpected? \n- If the destination IP address is remote or external, does it associate with an expected domain, organization or geography? Note: avoid interacting directly with suspected malicious IP addresses.\n- Consider the user as identified by the username field. Is this network activity part of an expected workflow for the user who ran the program?\n- Examine the history of execution. If this process manifested only very recently, it might be part of a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business or maintenance process.\n- Examine the process arguments, title and working directory. These may provide indications as to the source of the program or the nature of the tasks it is performing.", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json index d15c4fc794378..103171bcdfe50 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_process_all_hosts.json @@ -20,5 +20,6 @@ "ML" ], "type": "machine_learning", + "note": "### Investigating an Unusual Linux Process ###\nSignals from this rule indicate the presence of a Linux process that is rare and unusual for all of the monitored Linux hosts for which Auditbeat data is available. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is this program part of an expected workflow for the user who ran this program on this host?\n- Examine the history of execution. If this process manifested only very recently, it might be part of a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process arguments, title and working directory. These may provide indications as to the source of the program or the nature of the tasks it is performing.", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json index 2f33948b0a93e..6642bb5d73fbd 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/linux_anomalous_user_name.json @@ -20,5 +20,6 @@ "ML" ], "type": "machine_learning", + "note": "### Investigating an Unusual Linux User ###\nSignals from this rule indicate activity for a Linux user name that is rare and unusual. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is this program part of an expected workflow for the user who ran this program on this host? Could this be related to troubleshooting or debugging activity by a developer or site reliability engineer?\n- Examine the history of user activity. If this user manifested only very recently, it might be a service account for a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process arguments, title and working directory. These may provide indications as to the source of the program or the nature of the tasks that the user is performing.", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json index f071677ae8d33..8ae1b84aaf199 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_linux.json @@ -20,5 +20,6 @@ "ML" ], "type": "machine_learning", + "note": "### Investigating an Unusual Linux Process ###\nSignals from this rule indicate the presence of a Linux process that is rare and unusual for the host it ran on. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is this program part of an expected workflow for the user who ran this program on this host?\n- Examine the history of execution. If this process manifested only very recently, it might be part of a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process arguments, title and working directory. These may provide indications as to the source of the program or the nature of the tasks it is performing.", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json index 5e0050c6c25ec..879cee388f5dd 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/rare_process_by_host_windows.json @@ -20,5 +20,6 @@ "Windows" ], "type": "machine_learning", + "note": "### Investigating an Unusual Windows Process ###\nSignals from this rule indicate the presence of a Windows process that is rare and unusual for the host it ran on. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is this program part of an expected workflow for the user who ran this program on this host?\n- Examine the history of execution. If this process manifested only very recently, it might be part of a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process metadata like the values of the Company, Description and Product fields which may indicate whether the program is associated with an expected software vendor or package. \n- Examine arguments and working directory. These may provide indications as to the source of the program or the nature of the tasks it is performing.\n- Consider the same for the parent process. If the parent process is a legitimate system utility or service, this could be related to software updates or system management. If the parent process is something user-facing like an Office application, this process could be more suspicious.\n- If you have file hash values in the event data, and you suspect malware, you can optionally run a search for the file hash to see if the file is identified as malware by anti-malware tools. ", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json index ca18fe95b1fc1..1092bcb20bcc3 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_network_activity.json @@ -20,5 +20,6 @@ "Windows" ], "type": "machine_learning", + "note": "### Investigating Unusual Network Activity ###\nSignals from this rule indicate the presence of network activity from a Windows process for which network activity is very unusual. Here are some possible avenues of investigation:\n- Consider the IP addresses, protocol and ports. Are these used by normal but infrequent network workflows? Are they expected or unexpected? \n- If the destination IP address is remote or external, does it associate with an expected domain, organization or geography? Note: avoid interacting directly with suspected malicious IP addresses.\n- Consider the user as identified by the username field. Is this network activity part of an expected workflow for the user who ran the program?\n- Examine the history of execution. If this process manifested only very recently, it might be part of a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process arguments, title and working directory. These may provide indications as to the source of the program or the nature of the tasks it is performing.\n- Consider the same for the parent process. If the parent process is a legitimate system utility or service, this could be related to software updates or system management. If the parent process is something user-facing like an Office application, this process could be more suspicious.\n- If you have file hash values in the event data, and you suspect malware, you can optionally run a search for the file hash to see if the file is identified as malware by anti-malware tools. ", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json index 1229c4a52b97d..f9adfeb830618 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_process_all_hosts.json @@ -20,5 +20,6 @@ "Windows" ], "type": "machine_learning", + "note": "### Investigating an Unusual Windows Process ###\nSignals from this rule indicate the presence of a Windows process that is rare and unusual for all of the Windows hosts for which Winlogbeat data is available. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is this program part of an expected workflow for the user who ran this program on this host?\n- Examine the history of execution. If this process manifested only very recently, it might be part of a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process metadata like the values of the Company, Description and Product fields which may indicate whether the program is associated with an expected software vendor or package. \n- Examine arguments and working directory. These may provide indications as to the source of the program or the nature of the tasks it is performing.\n- Consider the same for the parent process. If the parent process is a legitimate system utility or service, this could be related to software updates or system management. If the parent process is something user-facing like an Office application, this process could be more suspicious.\n- If you have file hash values in the event data, and you suspect malware, you can optionally run a search for the file hash to see if the file is identified as malware by anti-malware tools. ", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json index 703dc1a1dc633..a0c6ff5c938f1 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_anomalous_user_name.json @@ -20,5 +20,6 @@ "Windows" ], "type": "machine_learning", + "note": "### Investigating an Unusual Windows User ###\nSignals from this rule indicate activity for a Windows user name that is rare and unusual. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is this program part of an expected workflow for the user who ran this program on this host? Could this be related to occasional troubleshooting or support activity?\n- Examine the history of user activity. If this user manifested only very recently, it might be a service account for a new software package. If it has a consistent cadence - for example if it runs monthly or quarterly - it might be part of a monthly or quarterly business process.\n- Examine the process arguments, title and working directory. These may provide indications as to the source of the program or the nature of the tasks that the user is performing.\n- Consider the same for the parent process. If the parent process is a legitimate system utility or service, this could be related to software updates or system management. If the parent process is something user-facing like an Office application, this process could be more suspicious.", "version": 1 -} \ No newline at end of file +} diff --git a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json index 946cdb95b8e70..7318364c3aac2 100644 --- a/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json +++ b/x-pack/legacy/plugins/siem/server/lib/detection_engine/rules/prepackaged_rules/windows_rare_user_type10_remote_login.json @@ -20,5 +20,6 @@ "Windows" ], "type": "machine_learning", + "note": "### Investigating an Unusual Windows User ###\nSignals from this rule indicate activity for a rare and unusual Windows RDP (remote desktop) user. Here are some possible avenues of investigation:\n- Consider the user as identified by the username field. Is the user part of a group who normally logs into Windows hosts using RDP (remote desktop protocol)? Is this logon activity part of an expected workflow for the user? \n- Consider the source of the login. If the source is remote, could this be related to occasional troubleshooting or support activity by a vendor or an employee working remotely?", "version": 1 -} \ No newline at end of file +} From 5bc539c6db8c1f735876e0f16adb7bbd5d4b41eb Mon Sep 17 00:00:00 2001 From: Gil Raphaelli <gil@elastic.co> Date: Mon, 13 Apr 2020 22:06:09 -0400 Subject: [PATCH 079/102] update in-app links to metricbeat configuration docs (#63295) --- .../flyout/__snapshots__/flyout.test.js.snap | 24 +++++++++---------- .../apm/enable_metricbeat_instructions.js | 6 ++--- .../beats/enable_metricbeat_instructions.js | 2 +- .../kibana/enable_metricbeat_instructions.js | 2 +- .../enable_metricbeat_instructions.js | 2 +- 5 files changed, 18 insertions(+), 18 deletions(-) diff --git a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/flyout/__snapshots__/flyout.test.js.snap b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/flyout/__snapshots__/flyout.test.js.snap index eb1c65c6a696d..4a7537166bd8a 100644 --- a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/flyout/__snapshots__/flyout.test.js.snap +++ b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/flyout/__snapshots__/flyout.test.js.snap @@ -161,7 +161,7 @@ exports[`Flyout apm part two should show instructions to migrate to metricbeat 1 "children": <EuiText> <p> <ForwardRef - href="https://www.elastic.co/guide/en/apm/metricbeat/current/metricbeat-installation.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-installation.html" target="_blank" > <FormattedMessage @@ -220,7 +220,7 @@ exports[`Flyout apm part two should show instructions to migrate to metricbeat 1 "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/apm/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-configuration.html" target="_blank" > <FormattedMessage @@ -287,7 +287,7 @@ exports[`Flyout apm part two should show instructions to migrate to metricbeat 1 "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/apm/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-configuration.html" target="_blank" > <FormattedMessage @@ -311,7 +311,7 @@ exports[`Flyout apm part two should show instructions to migrate to metricbeat 1 "children": <EuiText> <p> <ForwardRef - href="https://www.elastic.co/guide/en/apm/metricbeat/current/metricbeat-starting.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-starting.html" target="_blank" > <FormattedMessage @@ -601,7 +601,7 @@ exports[`Flyout beats part two should show instructions to migrate to metricbeat "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/beats/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-configuration.html" target="_blank" > <FormattedMessage @@ -668,7 +668,7 @@ exports[`Flyout beats part two should show instructions to migrate to metricbeat "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/beats/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-configuration.html" target="_blank" > <FormattedMessage @@ -1290,7 +1290,7 @@ exports[`Flyout kibana part two should show instructions to migrate to metricbea "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/kibana/reference/current/monitoring-metricbeat.html" + href="https://www.elastic.co/guide/en/kibana/current/monitoring-metricbeat.html" target="_blank" > <FormattedMessage @@ -1357,7 +1357,7 @@ exports[`Flyout kibana part two should show instructions to migrate to metricbea "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/kibana/reference/current/monitoring-metricbeat.html" + href="https://www.elastic.co/guide/en/kibana/current/monitoring-metricbeat.html" target="_blank" > <FormattedMessage @@ -1629,7 +1629,7 @@ exports[`Flyout logstash part two should show instructions to migrate to metricb "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/logstash/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/logstash/current/monitoring-with-metricbeat.html" target="_blank" > <FormattedMessage @@ -1696,7 +1696,7 @@ exports[`Flyout logstash part two should show instructions to migrate to metricb "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/logstash/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/logstash/current/monitoring-with-metricbeat.html" target="_blank" > <FormattedMessage @@ -1943,7 +1943,7 @@ exports[`Flyout should render the beat type for beats for the enabling metricbea "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/beats/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-configuration.html" target="_blank" > <FormattedMessage @@ -2010,7 +2010,7 @@ exports[`Flyout should render the beat type for beats for the enabling metricbea "link": <React.Fragment> <ForwardRef - href="https://www.elastic.co/guide/en/beats/reference/current/configuring-metricbeat.html" + href="https://www.elastic.co/guide/en/beats/metricbeat/current/metricbeat-configuration.html" target="_blank" > <FormattedMessage diff --git a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/apm/enable_metricbeat_instructions.js b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/apm/enable_metricbeat_instructions.js index 387a8ff0d9359..9fa33802b0202 100644 --- a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/apm/enable_metricbeat_instructions.js +++ b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/apm/enable_metricbeat_instructions.js @@ -13,7 +13,7 @@ import { getMigrationStatusStep, getSecurityStep } from '../common_instructions' export function getApmInstructionsForEnablingMetricbeat(product, _meta, { esMonitoringUrl }) { const securitySetup = getSecurityStep( - `${ELASTIC_WEBSITE_URL}guide/en/apm/reference/${DOC_LINK_VERSION}/configuring-metricbeat.html` + `${ELASTIC_WEBSITE_URL}guide/en/beats/metricbeat/${DOC_LINK_VERSION}/metricbeat-configuration.html` ); const installMetricbeatStep = { @@ -27,7 +27,7 @@ export function getApmInstructionsForEnablingMetricbeat(product, _meta, { esMoni <EuiText> <p> <EuiLink - href={`${ELASTIC_WEBSITE_URL}guide/en/apm/metricbeat/${DOC_LINK_VERSION}/metricbeat-installation.html`} + href={`${ELASTIC_WEBSITE_URL}guide/en/beats/metricbeat/${DOC_LINK_VERSION}/metricbeat-installation.html`} target="_blank" > <FormattedMessage @@ -115,7 +115,7 @@ export function getApmInstructionsForEnablingMetricbeat(product, _meta, { esMoni <EuiText> <p> <EuiLink - href={`${ELASTIC_WEBSITE_URL}guide/en/apm/metricbeat/${DOC_LINK_VERSION}/metricbeat-starting.html`} + href={`${ELASTIC_WEBSITE_URL}guide/en/beats/metricbeat/${DOC_LINK_VERSION}/metricbeat-starting.html`} target="_blank" > <FormattedMessage diff --git a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/beats/enable_metricbeat_instructions.js b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/beats/enable_metricbeat_instructions.js index 1848455ac2386..56e7c9b5af064 100644 --- a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/beats/enable_metricbeat_instructions.js +++ b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/beats/enable_metricbeat_instructions.js @@ -15,7 +15,7 @@ import { getMigrationStatusStep, getSecurityStep } from '../common_instructions' export function getBeatsInstructionsForEnablingMetricbeat(product, _meta, { esMonitoringUrl }) { const beatType = product.beatType; const securitySetup = getSecurityStep( - `${ELASTIC_WEBSITE_URL}guide/en/beats/reference/${DOC_LINK_VERSION}/configuring-metricbeat.html` + `${ELASTIC_WEBSITE_URL}guide/en/beats/metricbeat/${DOC_LINK_VERSION}/metricbeat-configuration.html` ); const installMetricbeatStep = { diff --git a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/kibana/enable_metricbeat_instructions.js b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/kibana/enable_metricbeat_instructions.js index 23f3eb71bfb41..98c75dbfe4b37 100644 --- a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/kibana/enable_metricbeat_instructions.js +++ b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/kibana/enable_metricbeat_instructions.js @@ -13,7 +13,7 @@ import { getMigrationStatusStep, getSecurityStep } from '../common_instructions' export function getKibanaInstructionsForEnablingMetricbeat(product, _meta, { esMonitoringUrl }) { const securitySetup = getSecurityStep( - `${ELASTIC_WEBSITE_URL}guide/en/kibana/reference/${DOC_LINK_VERSION}/monitoring-metricbeat.html` + `${ELASTIC_WEBSITE_URL}guide/en/kibana/${DOC_LINK_VERSION}/monitoring-metricbeat.html` ); const installMetricbeatStep = { diff --git a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/logstash/enable_metricbeat_instructions.js b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/logstash/enable_metricbeat_instructions.js index 70ee43d00ab3d..4a36f394e4bd5 100644 --- a/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/logstash/enable_metricbeat_instructions.js +++ b/x-pack/legacy/plugins/monitoring/public/components/metricbeat_migration/instruction_steps/logstash/enable_metricbeat_instructions.js @@ -13,7 +13,7 @@ import { getMigrationStatusStep, getSecurityStep } from '../common_instructions' export function getLogstashInstructionsForEnablingMetricbeat(product, _meta, { esMonitoringUrl }) { const securitySetup = getSecurityStep( - `${ELASTIC_WEBSITE_URL}guide/en/logstash/reference/${DOC_LINK_VERSION}/configuring-metricbeat.html` + `${ELASTIC_WEBSITE_URL}guide/en/logstash/${DOC_LINK_VERSION}/monitoring-with-metricbeat.html` ); const installMetricbeatStep = { From 5d7c651cd7eab09601e570946158f5083e18b34a Mon Sep 17 00:00:00 2001 From: kqualters-elastic <56408403+kqualters-elastic@users.noreply.github.com> Date: Tue, 14 Apr 2020 02:05:06 -0400 Subject: [PATCH 080/102] [Endpoint] Update cli mapping to match endpoint package (#63372) * Update cli mapping to match endpoint package --- x-pack/plugins/endpoint/scripts/alert_mapping.json | 3 ++- x-pack/plugins/endpoint/scripts/event_mapping.json | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/x-pack/plugins/endpoint/scripts/alert_mapping.json b/x-pack/plugins/endpoint/scripts/alert_mapping.json index a21e48b4bc95f..2e0041d0af986 100644 --- a/x-pack/plugins/endpoint/scripts/alert_mapping.json +++ b/x-pack/plugins/endpoint/scripts/alert_mapping.json @@ -394,7 +394,8 @@ "type": "nested" }, "file_extension": { - "type": "long" + "ignore_above": 1024, + "type": "keyword" }, "project_file": { "properties": { diff --git a/x-pack/plugins/endpoint/scripts/event_mapping.json b/x-pack/plugins/endpoint/scripts/event_mapping.json index 59d1ed17852b1..f410edc7abe5e 100644 --- a/x-pack/plugins/endpoint/scripts/event_mapping.json +++ b/x-pack/plugins/endpoint/scripts/event_mapping.json @@ -386,7 +386,8 @@ "type": "nested" }, "file_extension": { - "type": "long" + "ignore_above": 1024, + "type": "keyword" }, "project_file": { "properties": { From f4abaabaee04ed78cb38f32defed37ac969834a5 Mon Sep 17 00:00:00 2001 From: Jean-Louis Leysens <jloleysens@gmail.com> Date: Tue, 14 Apr 2020 08:47:23 +0200 Subject: [PATCH 081/102] Escape single quotes surrounded by double quotes (#63229) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../models/sense_editor/__tests__/editor_input1.txt | 6 ++++++ .../sense_editor/__tests__/sense_editor.test.js | 12 ++++++++++++ .../application/models/sense_editor/sense_editor.ts | 5 +++-- 3 files changed, 21 insertions(+), 2 deletions(-) diff --git a/src/plugins/console/public/application/models/sense_editor/__tests__/editor_input1.txt b/src/plugins/console/public/application/models/sense_editor/__tests__/editor_input1.txt index f9a4bcb85034d..398a0fdeab61f 100644 --- a/src/plugins/console/public/application/models/sense_editor/__tests__/editor_input1.txt +++ b/src/plugins/console/public/application/models/sense_editor/__tests__/editor_input1.txt @@ -25,3 +25,9 @@ GET index_1/type1/1/_source?_source_include=f DELETE index_2 + +POST /_sql?format=txt +{ + "query": "SELECT prenom FROM claude_index WHERE prenom = 'claude' ", + "fetch_size": 1 +} diff --git a/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js b/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js index 6afc03df13b4c..34b4cad7fbb6b 100644 --- a/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js +++ b/src/plugins/console/public/application/models/sense_editor/__tests__/sense_editor.test.js @@ -470,6 +470,18 @@ curl -XGET "http://localhost:9200/_stats?level=shards" curl -XPUT "http://localhost:9200/index_1/type1/1" -H 'Content-Type: application/json' -d' { "f": 1 +}'`.trim() + ); + + multiReqCopyAsCurlTest( + 'with single quotes', + editorInput1, + { start: { lineNumber: 29 }, end: { lineNumber: 33 } }, + ` +curl -XPOST "http://localhost:9200/_sql?format=txt" -H 'Content-Type: application/json' -d' +{ + "query": "SELECT prenom FROM claude_index WHERE prenom = '\\''claude'\\'' ", + "fetch_size": 1 }'`.trim() ); }); diff --git a/src/plugins/console/public/application/models/sense_editor/sense_editor.ts b/src/plugins/console/public/application/models/sense_editor/sense_editor.ts index 9bcd3a6872196..d326543bbe00b 100644 --- a/src/plugins/console/public/application/models/sense_editor/sense_editor.ts +++ b/src/plugins/console/public/application/models/sense_editor/sense_editor.ts @@ -484,8 +484,9 @@ export class SenseEditor { if (esData && esData.length) { ret += " -H 'Content-Type: application/json' -d'\n"; const dataAsString = collapseLiteralStrings(esData.join('\n')); - // since Sense doesn't allow single quote json string any single qoute is within a string. - ret += dataAsString.replace(/'/g, '\\"'); + + // We escape single quoted strings that that are wrapped in single quoted strings + ret += dataAsString.replace(/'/g, "'\\''"); if (esData.length > 1) { ret += '\n'; } // end with a new line From f44d951300169f7fefeb621e5642f42131dae9fc Mon Sep 17 00:00:00 2001 From: Mikhail Shustov <restrry@gmail.com> Date: Tue, 14 Apr 2020 09:11:03 +0200 Subject: [PATCH 082/102] document code splitting for client code (#62593) * add lazy loading section for client bundles * add Pierres suggestion --- src/core/MIGRATION.md | 61 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 61 insertions(+) diff --git a/src/core/MIGRATION.md b/src/core/MIGRATION.md index 5d7b467052029..368d1f47e9c3f 100644 --- a/src/core/MIGRATION.md +++ b/src/core/MIGRATION.md @@ -24,6 +24,7 @@ - [7. Switch to new platform services](#7-switch-to-new-platform-services) - [8. Migrate to the new plugin system](#8-migrate-to-the-new-plugin-system) - [Bonus: Tips for complex migration scenarios](#bonus-tips-for-complex-migration-scenarios) + - [Keep Kibana fast](#keep-kibana-fast) - [Frequently asked questions](#frequently-asked-questions) - [Is migrating a plugin an all-or-nothing thing?](#is-migrating-a-plugin-an-all-or-nothing-thing) - [Do plugins need to be converted to TypeScript?](#do-plugins-need-to-be-converted-to-typescript) @@ -933,6 +934,66 @@ For a few plugins, some of these steps (such as angular removal) could be a mont One convention that is useful for this is creating a dedicated `public/np_ready` directory to house the code that is ready to migrate, and gradually move more and more code into it until the rest of your plugin is essentially empty. At that point, you'll be able to copy your `index.ts`, `plugin.ts`, and the contents of `./np_ready` over into your plugin in the new platform, leaving your legacy shim behind. This carries the added benefit of providing a way for us to introduce helpful tooling in the future, such as [custom eslint rules](https://github.com/elastic/kibana/pull/40537), which could be run against that specific directory to ensure your code is ready to migrate. +## Keep Kibana fast +**tl;dr**: Load as much code lazily as possible. +Everyone loves snappy applications with responsive UI and hates spinners. Users deserve the best user experiences regardless of whether they run Kibana locally or in the cloud, regardless of their hardware & environment. +There are 2 main aspects of the perceived speed of an application: loading time and responsiveness to user actions. +New platform loads and bootstraps **all** the plugins whenever a user lands on any page. It means that adding every new application affects overall **loading performance** in the new platform, as plugin code is loaded **eagerly** to initialize the plugin and provide plugin API to dependent plugins. +However, it's usually not necessary that the whole plugin code should be loaded and initialized at once. The plugin could keep on loading code covering API functionality on Kibana bootstrap but load UI related code lazily on-demand, when an application page or management section is mounted. +Always prefer to require UI root components lazily when possible (such as in mount handlers). Even if their size may seem negligible, they are likely using some heavy-weight libraries that will also be removed from the initial plugin bundle, therefore, reducing its size by a significant amount. + +```typescript +import { Plugin, CoreSetup, AppMountParameters } from 'src/core/public'; +export class MyPlugin implements Plugin<MyPluginSetup> { + setup(core: CoreSetup, plugins: SetupDeps){ + core.application.register({ + id: 'app', + title: 'My app', + async mount(params: AppMountParameters) { + const { mountApp } = await import('./app/mount_app'); + return mountApp(await core.getStartServices(), params); + }, + }); + plugins.management.sections.getSection('another').registerApp({ + id: 'app', + title: 'My app', + order: 1, + async mount(params) { + const { mountManagementSection } = await import('./app/mount_management_section'); + return mountManagementSection(coreSetup, params); + }, + }) + return { + doSomething(){} + } + } +} +``` + +#### How to understand how big the bundle size of my plugin is? +New platform plugins are distributed as a pre-built with `@kbn/optimizer` package artifacts. It allows us to get rid of the shipping of `optimizer` in the distributable version of Kibana. +Every NP plugin artifact contains all plugin dependencies required to run the plugin, except some stateful dependencies shared across plugin bundles via `@kbn/ui-shared-deps`. +It means that NP plugin artifacts tend to have a bigger size than the legacy platform version. +To understand the current size of your plugin artifact, run `@kbn/optimizer` as +```bash +node scripts/build_kibana_platform_plugins.js --dist --no-examples +``` +and check the output in the `target` sub-folder of your plugin folder +```bash +ls -lh plugins/my_plugin/target/public/ +# output +# an async chunk loaded on demand +... 262K 0.plugin.js +# eagerly loaded chunk +... 50K my_plugin.plugin.js +``` +you might see at least one js bundle - `my_plugin.plugin.js`. This is the only artifact loaded by the platform during bootstrap in the browser. The rule of thumb is to keep its size as small as possible. +Other lazily loaded parts of your plugin present in the same folder as separate chunks under `{number}.plugin.js` names. +If you want to investigate what your plugin bundle consists of you need to run `@kbn/optimizer` with `--profile` flag to get generated [webpack stats file](https://webpack.js.org/api/stats/). +Many OSS tools are allowing you to analyze generated stats file +- [an official tool](http://webpack.github.io/analyse/#modules) from webpack authors +- [webpack-visualizer](https://chrisbateman.github.io/webpack-visualizer/) + ## Frequently asked questions ### Is migrating a plugin an all-or-nothing thing? From 1f732ad29ac7f386d9255d016f80c51367abd685 Mon Sep 17 00:00:00 2001 From: Gidi Meir Morris <github@gidi.io> Date: Tue, 14 Apr 2020 10:57:46 +0100 Subject: [PATCH 083/102] [Event Log] Adds namespace into save objects (#62974) Adds a namespace attribute to the saved object object within the Event Log so that each Saved Object can have its own. This change also removes the existing kibana.namespace field. As Event Log is not yet in use, this does not include a migration. --- .../plugins/actions/server/lib/action_executor.ts | 9 ++++----- .../task_runner/create_execution_handler.test.ts | 1 - .../task_runner/create_execution_handler.ts | 7 ++++--- .../server/task_runner/task_runner.test.ts | 15 ++++++++------- .../alerting/server/task_runner/task_runner.ts | 5 ++--- x-pack/plugins/event_log/README.md | 1 - x-pack/plugins/event_log/generated/mappings.json | 6 +----- x-pack/plugins/event_log/generated/schemas.ts | 3 +-- x-pack/plugins/event_log/scripts/mappings.js | 12 +++--------- .../server/routes/_mock_handler_arguments.ts | 2 +- .../event_log/public_api_integration.ts | 2 +- 11 files changed, 25 insertions(+), 38 deletions(-) diff --git a/x-pack/plugins/actions/server/lib/action_executor.ts b/x-pack/plugins/actions/server/lib/action_executor.ts index af0353247d99f..ba8bb79170c63 100644 --- a/x-pack/plugins/actions/server/lib/action_executor.ts +++ b/x-pack/plugins/actions/server/lib/action_executor.ts @@ -75,7 +75,8 @@ export class ActionExecutor { } = this.actionExecutorContext!; const services = getServices(request); - const namespace = spaces && spaces.getSpaceId(request); + const spaceId = spaces && spaces.getSpaceId(request); + const namespace = spaceId && spaceId !== 'default' ? { namespace: spaceId } : {}; // Ensure user can read the action before processing const { @@ -91,9 +92,7 @@ export class ActionExecutor { } = await encryptedSavedObjectsPlugin.getDecryptedAsInternalUser<RawAction>( 'action', actionId, - { - namespace: namespace === 'default' ? undefined : namespace, - } + namespace ); const actionType = actionTypeRegistry.get(actionTypeId); @@ -112,7 +111,7 @@ export class ActionExecutor { const actionLabel = `${actionTypeId}:${actionId}: ${name}`; const event: IEvent = { event: { action: EVENT_LOG_ACTIONS.execute }, - kibana: { namespace, saved_objects: [{ type: 'action', id: actionId }] }, + kibana: { saved_objects: [{ type: 'action', id: actionId, ...namespace }] }, }; eventLogger.startTiming(event); diff --git a/x-pack/plugins/alerting/server/task_runner/create_execution_handler.test.ts b/x-pack/plugins/alerting/server/task_runner/create_execution_handler.test.ts index 8d037a1ecee91..756080baba626 100644 --- a/x-pack/plugins/alerting/server/task_runner/create_execution_handler.test.ts +++ b/x-pack/plugins/alerting/server/task_runner/create_execution_handler.test.ts @@ -91,7 +91,6 @@ test('calls actionsPlugin.execute per selected action', async () => { "alerting": Object { "instance_id": "2", }, - "namespace": "default", "saved_objects": Array [ Object { "id": "1", diff --git a/x-pack/plugins/alerting/server/task_runner/create_execution_handler.ts b/x-pack/plugins/alerting/server/task_runner/create_execution_handler.ts index de06c8bbb374a..72f9e70905dc2 100644 --- a/x-pack/plugins/alerting/server/task_runner/create_execution_handler.ts +++ b/x-pack/plugins/alerting/server/task_runner/create_execution_handler.ts @@ -87,16 +87,17 @@ export function createExecutionHandler({ apiKey, }); + const namespace = spaceId === 'default' ? {} : { namespace: spaceId }; + const event: IEvent = { event: { action: EVENT_LOG_ACTIONS.executeAction }, kibana: { alerting: { instance_id: alertInstanceId, }, - namespace: spaceId, saved_objects: [ - { type: 'alert', id: alertId }, - { type: 'action', id: action.id }, + { type: 'alert', id: alertId, ...namespace }, + { type: 'action', id: action.id, ...namespace }, ], }, }; diff --git a/x-pack/plugins/alerting/server/task_runner/task_runner.test.ts b/x-pack/plugins/alerting/server/task_runner/task_runner.test.ts index 520f8d5c99b16..4e6d959f0ce60 100644 --- a/x-pack/plugins/alerting/server/task_runner/task_runner.test.ts +++ b/x-pack/plugins/alerting/server/task_runner/task_runner.test.ts @@ -169,10 +169,10 @@ describe('Task Runner', () => { "action": "execute", }, "kibana": Object { - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, ], @@ -229,10 +229,10 @@ describe('Task Runner', () => { "action": "execute", }, "kibana": Object { - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, ], @@ -249,10 +249,10 @@ describe('Task Runner', () => { "alerting": Object { "instance_id": "1", }, - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, ], @@ -269,14 +269,15 @@ describe('Task Runner', () => { "alerting": Object { "instance_id": "1", }, - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, Object { "id": "1", + "namespace": undefined, "type": "action", }, ], @@ -344,10 +345,10 @@ describe('Task Runner', () => { "action": "execute", }, "kibana": Object { - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, ], @@ -364,10 +365,10 @@ describe('Task Runner', () => { "alerting": Object { "instance_id": "2", }, - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, ], @@ -560,10 +561,10 @@ describe('Task Runner', () => { "action": "execute", }, "kibana": Object { - "namespace": undefined, "saved_objects": Array [ Object { "id": "1", + "namespace": undefined, "type": "alert", }, ], diff --git a/x-pack/plugins/alerting/server/task_runner/task_runner.ts b/x-pack/plugins/alerting/server/task_runner/task_runner.ts index 2ba56396279ea..190cdc184930c 100644 --- a/x-pack/plugins/alerting/server/task_runner/task_runner.ts +++ b/x-pack/plugins/alerting/server/task_runner/task_runner.ts @@ -173,7 +173,7 @@ export class TaskRunner { const alertLabel = `${this.alertType.id}:${alertId}: '${name}'`; const event: IEvent = { event: { action: EVENT_LOG_ACTIONS.execute }, - kibana: { namespace, saved_objects: [{ type: 'alert', id: alertId }] }, + kibana: { saved_objects: [{ type: 'alert', id: alertId, namespace }] }, }; eventLogger.startTiming(event); @@ -378,11 +378,10 @@ function generateNewAndResolvedInstanceEvents(params: GenerateNewAndResolvedInst action, }, kibana: { - namespace: params.namespace, alerting: { instance_id: id, }, - saved_objects: [{ type: 'alert', id: params.alertId }], + saved_objects: [{ type: 'alert', id: params.alertId, namespace: params.namespace }], }, message, }; diff --git a/x-pack/plugins/event_log/README.md b/x-pack/plugins/event_log/README.md index 027bbc694801f..38364033cb70b 100644 --- a/x-pack/plugins/event_log/README.md +++ b/x-pack/plugins/event_log/README.md @@ -125,7 +125,6 @@ Here's the event written to the event log index: "duration": 1000000 }, "kibana": { - "namespace": "default", "saved_objects": [ { "type": "action", diff --git a/x-pack/plugins/event_log/generated/mappings.json b/x-pack/plugins/event_log/generated/mappings.json index ab1b4096d17f2..9c1dff60f9727 100644 --- a/x-pack/plugins/event_log/generated/mappings.json +++ b/x-pack/plugins/event_log/generated/mappings.json @@ -72,10 +72,6 @@ "type": "keyword", "ignore_above": 1024 }, - "namespace": { - "type": "keyword", - "ignore_above": 1024 - }, "alerting": { "properties": { "instance_id": { @@ -86,7 +82,7 @@ }, "saved_objects": { "properties": { - "store": { + "namespace": { "type": "keyword", "ignore_above": 1024 }, diff --git a/x-pack/plugins/event_log/generated/schemas.ts b/x-pack/plugins/event_log/generated/schemas.ts index b731093b33b06..5e93f320c009f 100644 --- a/x-pack/plugins/event_log/generated/schemas.ts +++ b/x-pack/plugins/event_log/generated/schemas.ts @@ -56,7 +56,6 @@ export const EventSchema = schema.maybe( kibana: schema.maybe( schema.object({ server_uuid: ecsString(), - namespace: ecsString(), alerting: schema.maybe( schema.object({ instance_id: ecsString(), @@ -65,7 +64,7 @@ export const EventSchema = schema.maybe( saved_objects: schema.maybe( schema.arrayOf( schema.object({ - store: ecsString(), + namespace: ecsString(), id: ecsString(), type: ecsString(), }) diff --git a/x-pack/plugins/event_log/scripts/mappings.js b/x-pack/plugins/event_log/scripts/mappings.js index 9e721b06ec335..de3c9d631fbca 100644 --- a/x-pack/plugins/event_log/scripts/mappings.js +++ b/x-pack/plugins/event_log/scripts/mappings.js @@ -20,17 +20,12 @@ exports.EcsKibanaExtensionsMappings = { }, }, }, - // relevant kibana space - namespace: { - type: 'keyword', - ignore_above: 1024, - }, // array of saved object references, for "linking" via search saved_objects: { type: 'nested', properties: { - // 'kibana' for typical saved object, 'task_manager' for TM, etc - store: { + // relevant kibana space + namespace: { type: 'keyword', ignore_above: 1024, }, @@ -61,9 +56,8 @@ exports.EcsEventLogProperties = [ 'error.message', 'user.name', 'kibana.server_uuid', - 'kibana.namespace', 'kibana.alerting.instance_id', - 'kibana.saved_objects.store', + 'kibana.saved_objects.namespace', 'kibana.saved_objects.id', 'kibana.saved_objects.name', 'kibana.saved_objects.type', diff --git a/x-pack/plugins/event_log/server/routes/_mock_handler_arguments.ts b/x-pack/plugins/event_log/server/routes/_mock_handler_arguments.ts index 6640683bf6005..19933649277aa 100644 --- a/x-pack/plugins/event_log/server/routes/_mock_handler_arguments.ts +++ b/x-pack/plugins/event_log/server/routes/_mock_handler_arguments.ts @@ -50,9 +50,9 @@ export function fakeEvent(overrides = {}) { duration: 1000000, }, kibana: { - namespace: 'default', saved_objects: [ { + namespace: 'default', type: 'action', id: '968f1b82-0414-4a10-becc-56b6473e4a29', }, diff --git a/x-pack/test/plugin_api_integration/test_suites/event_log/public_api_integration.ts b/x-pack/test/plugin_api_integration/test_suites/event_log/public_api_integration.ts index c440971225d78..d664357c3ba12 100644 --- a/x-pack/test/plugin_api_integration/test_suites/event_log/public_api_integration.ts +++ b/x-pack/test/plugin_api_integration/test_suites/event_log/public_api_integration.ts @@ -220,9 +220,9 @@ export default function({ getService }: FtrProviderContext) { duration: 1000000, }, kibana: { - namespace: 'default', saved_objects: [ { + namespace: 'default', type: 'event_log_test', id, }, From 637a9e11a2d713b8aa82d134ebf0c3d09abeace7 Mon Sep 17 00:00:00 2001 From: Dmitry Lemeshko <dzmitry.lemechko@elastic.co> Date: Tue, 14 Apr 2020 14:25:26 +0300 Subject: [PATCH 084/102] Revert FTR: add chromium-based Edge browser support (#61684) (#63448) --- package.json | 5 +- packages/kbn-pm/dist/index.js | 1105 ++++++++++++++--- .../lib/config/schema.ts | 2 +- test/functional/config.edge.js | 34 - test/functional/services/browser.ts | 4 +- .../web_element_wrapper.ts | 9 +- test/functional/services/remote/browsers.ts | 1 - test/functional/services/remote/remote.ts | 17 +- test/functional/services/remote/webdriver.ts | 50 +- x-pack/test/functional/config.edge.js | 21 - yarn.lock | 322 +---- 11 files changed, 1013 insertions(+), 557 deletions(-) delete mode 100644 test/functional/config.edge.js delete mode 100644 x-pack/test/functional/config.edge.js diff --git a/package.json b/package.json index 2bad3116c9ef2..388e46aedf37d 100644 --- a/package.json +++ b/package.json @@ -376,7 +376,7 @@ "@types/recompose": "^0.30.6", "@types/redux-actions": "^2.6.1", "@types/request": "^2.48.2", - "@types/selenium-webdriver": "4.0.9", + "@types/selenium-webdriver": "^4.0.5", "@types/semver": "^5.5.0", "@types/sinon": "^7.0.13", "@types/strip-ansi": "^3.0.0", @@ -462,7 +462,6 @@ "load-grunt-config": "^3.0.1", "mocha": "^7.1.1", "mock-http-server": "1.3.0", - "ms-chromium-edge-driver": "^0.2.0", "multistream": "^2.1.1", "murmurhash3js": "3.0.1", "mutation-observer": "^1.0.3", @@ -481,7 +480,7 @@ "react-textarea-autosize": "^7.1.2", "regenerate": "^1.4.0", "sass-lint": "^1.12.1", - "selenium-webdriver": "^4.0.0-alpha.7", + "selenium-webdriver": "^4.0.0-alpha.5", "simple-git": "1.116.0", "simplebar-react": "^2.1.0", "sinon": "^7.4.2", diff --git a/packages/kbn-pm/dist/index.js b/packages/kbn-pm/dist/index.js index 399720f310f67..fa8884e2ece75 100644 --- a/packages/kbn-pm/dist/index.js +++ b/packages/kbn-pm/dist/index.js @@ -79185,7 +79185,7 @@ __webpack_require__.r(__webpack_exports__); /* harmony import */ var _build_production_projects__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(704); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "buildProductionProjects", function() { return _build_production_projects__WEBPACK_IMPORTED_MODULE_0__["buildProductionProjects"]; }); -/* harmony import */ var _prepare_project_dependencies__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(922); +/* harmony import */ var _prepare_project_dependencies__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(927); /* harmony reexport (safe) */ __webpack_require__.d(__webpack_exports__, "prepareExternalProjectDependencies", function() { return _prepare_project_dependencies__WEBPACK_IMPORTED_MODULE_1__["prepareExternalProjectDependencies"]; }); /* @@ -79370,9 +79370,9 @@ const pAll = __webpack_require__(706); const arrify = __webpack_require__(708); const globby = __webpack_require__(709); const isGlob = __webpack_require__(603); -const cpFile = __webpack_require__(907); -const junk = __webpack_require__(919); -const CpyError = __webpack_require__(920); +const cpFile = __webpack_require__(912); +const junk = __webpack_require__(924); +const CpyError = __webpack_require__(925); const defaultOptions = { ignoreJunk: true @@ -79622,8 +79622,8 @@ const fs = __webpack_require__(23); const arrayUnion = __webpack_require__(710); const glob = __webpack_require__(712); const fastGlob = __webpack_require__(717); -const dirGlob = __webpack_require__(900); -const gitignore = __webpack_require__(903); +const dirGlob = __webpack_require__(905); +const gitignore = __webpack_require__(908); const DEFAULT_FILTER = () => false; @@ -81456,11 +81456,11 @@ module.exports.generateTasks = pkg.generateTasks; Object.defineProperty(exports, "__esModule", { value: true }); var optionsManager = __webpack_require__(719); var taskManager = __webpack_require__(720); -var reader_async_1 = __webpack_require__(871); -var reader_stream_1 = __webpack_require__(895); -var reader_sync_1 = __webpack_require__(896); -var arrayUtils = __webpack_require__(898); -var streamUtils = __webpack_require__(899); +var reader_async_1 = __webpack_require__(876); +var reader_stream_1 = __webpack_require__(900); +var reader_sync_1 = __webpack_require__(901); +var arrayUtils = __webpack_require__(903); +var streamUtils = __webpack_require__(904); /** * Synchronous API. */ @@ -82100,9 +82100,9 @@ var extend = __webpack_require__(837); */ var compilers = __webpack_require__(840); -var parsers = __webpack_require__(867); -var cache = __webpack_require__(868); -var utils = __webpack_require__(869); +var parsers = __webpack_require__(872); +var cache = __webpack_require__(873); +var utils = __webpack_require__(874); var MAX_LENGTH = 1024 * 64; /** @@ -100635,9 +100635,9 @@ var toRegex = __webpack_require__(728); */ var compilers = __webpack_require__(857); -var parsers = __webpack_require__(863); -var Extglob = __webpack_require__(866); -var utils = __webpack_require__(865); +var parsers = __webpack_require__(868); +var Extglob = __webpack_require__(871); +var utils = __webpack_require__(870); var MAX_LENGTH = 1024 * 64; /** @@ -101147,7 +101147,7 @@ var parsers = __webpack_require__(861); * Module dependencies */ -var debug = __webpack_require__(800)('expand-brackets'); +var debug = __webpack_require__(863)('expand-brackets'); var extend = __webpack_require__(737); var Snapdragon = __webpack_require__(767); var toRegex = __webpack_require__(728); @@ -101741,12 +101741,839 @@ exports.createRegex = function(pattern, include) { /* 863 */ /***/ (function(module, exports, __webpack_require__) { +/** + * Detect Electron renderer process, which is node, but we should + * treat as a browser. + */ + +if (typeof process !== 'undefined' && process.type === 'renderer') { + module.exports = __webpack_require__(864); +} else { + module.exports = __webpack_require__(867); +} + + +/***/ }), +/* 864 */ +/***/ (function(module, exports, __webpack_require__) { + +/** + * This is the web browser implementation of `debug()`. + * + * Expose `debug()` as the module. + */ + +exports = module.exports = __webpack_require__(865); +exports.log = log; +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; +exports.storage = 'undefined' != typeof chrome + && 'undefined' != typeof chrome.storage + ? chrome.storage.local + : localstorage(); + +/** + * Colors. + */ + +exports.colors = [ + 'lightseagreen', + 'forestgreen', + 'goldenrod', + 'dodgerblue', + 'darkorchid', + 'crimson' +]; + +/** + * Currently only WebKit-based Web Inspectors, Firefox >= v31, + * and the Firebug extension (any Firefox version) are known + * to support "%c" CSS customizations. + * + * TODO: add a `localStorage` variable to explicitly enable/disable colors + */ + +function useColors() { + // NB: In an Electron preload script, document will be defined but not fully + // initialized. Since we know we're in Chrome, we'll just detect this case + // explicitly + if (typeof window !== 'undefined' && window.process && window.process.type === 'renderer') { + return true; + } + + // is webkit? http://stackoverflow.com/a/16459606/376773 + // document is undefined in react-native: https://github.com/facebook/react-native/pull/1632 + return (typeof document !== 'undefined' && document.documentElement && document.documentElement.style && document.documentElement.style.WebkitAppearance) || + // is firebug? http://stackoverflow.com/a/398120/376773 + (typeof window !== 'undefined' && window.console && (window.console.firebug || (window.console.exception && window.console.table))) || + // is firefox >= v31? + // https://developer.mozilla.org/en-US/docs/Tools/Web_Console#Styling_messages + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/firefox\/(\d+)/) && parseInt(RegExp.$1, 10) >= 31) || + // double check webkit in userAgent just in case we are in a worker + (typeof navigator !== 'undefined' && navigator.userAgent && navigator.userAgent.toLowerCase().match(/applewebkit\/(\d+)/)); +} + +/** + * Map %j to `JSON.stringify()`, since no Web Inspectors do that by default. + */ + +exports.formatters.j = function(v) { + try { + return JSON.stringify(v); + } catch (err) { + return '[UnexpectedJSONParseError]: ' + err.message; + } +}; + + +/** + * Colorize log arguments if enabled. + * + * @api public + */ + +function formatArgs(args) { + var useColors = this.useColors; + + args[0] = (useColors ? '%c' : '') + + this.namespace + + (useColors ? ' %c' : ' ') + + args[0] + + (useColors ? '%c ' : ' ') + + '+' + exports.humanize(this.diff); + + if (!useColors) return; + + var c = 'color: ' + this.color; + args.splice(1, 0, c, 'color: inherit') + + // the final "%c" is somewhat tricky, because there could be other + // arguments passed either before or after the %c, so we need to + // figure out the correct index to insert the CSS into + var index = 0; + var lastC = 0; + args[0].replace(/%[a-zA-Z%]/g, function(match) { + if ('%%' === match) return; + index++; + if ('%c' === match) { + // we only are interested in the *last* %c + // (the user may have provided their own) + lastC = index; + } + }); + + args.splice(lastC, 0, c); +} + +/** + * Invokes `console.log()` when available. + * No-op when `console.log` is not a "function". + * + * @api public + */ + +function log() { + // this hackery is required for IE8/9, where + // the `console.log` function doesn't have 'apply' + return 'object' === typeof console + && console.log + && Function.prototype.apply.call(console.log, console, arguments); +} + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ + +function save(namespaces) { + try { + if (null == namespaces) { + exports.storage.removeItem('debug'); + } else { + exports.storage.debug = namespaces; + } + } catch(e) {} +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ + +function load() { + var r; + try { + r = exports.storage.debug; + } catch(e) {} + + // If debug isn't set in LS, and we're in Electron, try to load $DEBUG + if (!r && typeof process !== 'undefined' && 'env' in process) { + r = process.env.DEBUG; + } + + return r; +} + +/** + * Enable namespaces listed in `localStorage.debug` initially. + */ + +exports.enable(load()); + +/** + * Localstorage attempts to return the localstorage. + * + * This is necessary because safari throws + * when a user disables cookies/localstorage + * and you attempt to access it. + * + * @return {LocalStorage} + * @api private + */ + +function localstorage() { + try { + return window.localStorage; + } catch (e) {} +} + + +/***/ }), +/* 865 */ +/***/ (function(module, exports, __webpack_require__) { + + +/** + * This is the common logic for both the Node.js and web browser + * implementations of `debug()`. + * + * Expose `debug()` as the module. + */ + +exports = module.exports = createDebug.debug = createDebug['default'] = createDebug; +exports.coerce = coerce; +exports.disable = disable; +exports.enable = enable; +exports.enabled = enabled; +exports.humanize = __webpack_require__(866); + +/** + * The currently active debug mode names, and names to skip. + */ + +exports.names = []; +exports.skips = []; + +/** + * Map of special "%n" handling functions, for the debug "format" argument. + * + * Valid key names are a single, lower or upper-case letter, i.e. "n" and "N". + */ + +exports.formatters = {}; + +/** + * Previous log timestamp. + */ + +var prevTime; + +/** + * Select a color. + * @param {String} namespace + * @return {Number} + * @api private + */ + +function selectColor(namespace) { + var hash = 0, i; + + for (i in namespace) { + hash = ((hash << 5) - hash) + namespace.charCodeAt(i); + hash |= 0; // Convert to 32bit integer + } + + return exports.colors[Math.abs(hash) % exports.colors.length]; +} + +/** + * Create a debugger with the given `namespace`. + * + * @param {String} namespace + * @return {Function} + * @api public + */ + +function createDebug(namespace) { + + function debug() { + // disabled? + if (!debug.enabled) return; + + var self = debug; + + // set `diff` timestamp + var curr = +new Date(); + var ms = curr - (prevTime || curr); + self.diff = ms; + self.prev = prevTime; + self.curr = curr; + prevTime = curr; + + // turn the `arguments` into a proper Array + var args = new Array(arguments.length); + for (var i = 0; i < args.length; i++) { + args[i] = arguments[i]; + } + + args[0] = exports.coerce(args[0]); + + if ('string' !== typeof args[0]) { + // anything else let's inspect with %O + args.unshift('%O'); + } + + // apply any `formatters` transformations + var index = 0; + args[0] = args[0].replace(/%([a-zA-Z%])/g, function(match, format) { + // if we encounter an escaped % then don't increase the array index + if (match === '%%') return match; + index++; + var formatter = exports.formatters[format]; + if ('function' === typeof formatter) { + var val = args[index]; + match = formatter.call(self, val); + + // now we need to remove `args[index]` since it's inlined in the `format` + args.splice(index, 1); + index--; + } + return match; + }); + + // apply env-specific formatting (colors, etc.) + exports.formatArgs.call(self, args); + + var logFn = debug.log || exports.log || console.log.bind(console); + logFn.apply(self, args); + } + + debug.namespace = namespace; + debug.enabled = exports.enabled(namespace); + debug.useColors = exports.useColors(); + debug.color = selectColor(namespace); + + // env-specific initialization logic for debug instances + if ('function' === typeof exports.init) { + exports.init(debug); + } + + return debug; +} + +/** + * Enables a debug mode by namespaces. This can include modes + * separated by a colon and wildcards. + * + * @param {String} namespaces + * @api public + */ + +function enable(namespaces) { + exports.save(namespaces); + + exports.names = []; + exports.skips = []; + + var split = (typeof namespaces === 'string' ? namespaces : '').split(/[\s,]+/); + var len = split.length; + + for (var i = 0; i < len; i++) { + if (!split[i]) continue; // ignore empty strings + namespaces = split[i].replace(/\*/g, '.*?'); + if (namespaces[0] === '-') { + exports.skips.push(new RegExp('^' + namespaces.substr(1) + '$')); + } else { + exports.names.push(new RegExp('^' + namespaces + '$')); + } + } +} + +/** + * Disable debug output. + * + * @api public + */ + +function disable() { + exports.enable(''); +} + +/** + * Returns true if the given mode name is enabled, false otherwise. + * + * @param {String} name + * @return {Boolean} + * @api public + */ + +function enabled(name) { + var i, len; + for (i = 0, len = exports.skips.length; i < len; i++) { + if (exports.skips[i].test(name)) { + return false; + } + } + for (i = 0, len = exports.names.length; i < len; i++) { + if (exports.names[i].test(name)) { + return true; + } + } + return false; +} + +/** + * Coerce `val`. + * + * @param {Mixed} val + * @return {Mixed} + * @api private + */ + +function coerce(val) { + if (val instanceof Error) return val.stack || val.message; + return val; +} + + +/***/ }), +/* 866 */ +/***/ (function(module, exports) { + +/** + * Helpers. + */ + +var s = 1000; +var m = s * 60; +var h = m * 60; +var d = h * 24; +var y = d * 365.25; + +/** + * Parse or format the given `val`. + * + * Options: + * + * - `long` verbose formatting [false] + * + * @param {String|Number} val + * @param {Object} [options] + * @throws {Error} throw an error if val is not a non-empty string or a number + * @return {String|Number} + * @api public + */ + +module.exports = function(val, options) { + options = options || {}; + var type = typeof val; + if (type === 'string' && val.length > 0) { + return parse(val); + } else if (type === 'number' && isNaN(val) === false) { + return options.long ? fmtLong(val) : fmtShort(val); + } + throw new Error( + 'val is not a non-empty string or a valid number. val=' + + JSON.stringify(val) + ); +}; + +/** + * Parse the given `str` and return milliseconds. + * + * @param {String} str + * @return {Number} + * @api private + */ + +function parse(str) { + str = String(str); + if (str.length > 100) { + return; + } + var match = /^((?:\d+)?\.?\d+) *(milliseconds?|msecs?|ms|seconds?|secs?|s|minutes?|mins?|m|hours?|hrs?|h|days?|d|years?|yrs?|y)?$/i.exec( + str + ); + if (!match) { + return; + } + var n = parseFloat(match[1]); + var type = (match[2] || 'ms').toLowerCase(); + switch (type) { + case 'years': + case 'year': + case 'yrs': + case 'yr': + case 'y': + return n * y; + case 'days': + case 'day': + case 'd': + return n * d; + case 'hours': + case 'hour': + case 'hrs': + case 'hr': + case 'h': + return n * h; + case 'minutes': + case 'minute': + case 'mins': + case 'min': + case 'm': + return n * m; + case 'seconds': + case 'second': + case 'secs': + case 'sec': + case 's': + return n * s; + case 'milliseconds': + case 'millisecond': + case 'msecs': + case 'msec': + case 'ms': + return n; + default: + return undefined; + } +} + +/** + * Short format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtShort(ms) { + if (ms >= d) { + return Math.round(ms / d) + 'd'; + } + if (ms >= h) { + return Math.round(ms / h) + 'h'; + } + if (ms >= m) { + return Math.round(ms / m) + 'm'; + } + if (ms >= s) { + return Math.round(ms / s) + 's'; + } + return ms + 'ms'; +} + +/** + * Long format for `ms`. + * + * @param {Number} ms + * @return {String} + * @api private + */ + +function fmtLong(ms) { + return plural(ms, d, 'day') || + plural(ms, h, 'hour') || + plural(ms, m, 'minute') || + plural(ms, s, 'second') || + ms + ' ms'; +} + +/** + * Pluralization helper. + */ + +function plural(ms, n, name) { + if (ms < n) { + return; + } + if (ms < n * 1.5) { + return Math.floor(ms / n) + ' ' + name; + } + return Math.ceil(ms / n) + ' ' + name + 's'; +} + + +/***/ }), +/* 867 */ +/***/ (function(module, exports, __webpack_require__) { + +/** + * Module dependencies. + */ + +var tty = __webpack_require__(478); +var util = __webpack_require__(29); + +/** + * This is the Node.js implementation of `debug()`. + * + * Expose `debug()` as the module. + */ + +exports = module.exports = __webpack_require__(865); +exports.init = init; +exports.log = log; +exports.formatArgs = formatArgs; +exports.save = save; +exports.load = load; +exports.useColors = useColors; + +/** + * Colors. + */ + +exports.colors = [6, 2, 3, 4, 5, 1]; + +/** + * Build up the default `inspectOpts` object from the environment variables. + * + * $ DEBUG_COLORS=no DEBUG_DEPTH=10 DEBUG_SHOW_HIDDEN=enabled node script.js + */ + +exports.inspectOpts = Object.keys(process.env).filter(function (key) { + return /^debug_/i.test(key); +}).reduce(function (obj, key) { + // camel-case + var prop = key + .substring(6) + .toLowerCase() + .replace(/_([a-z])/g, function (_, k) { return k.toUpperCase() }); + + // coerce string value into JS value + var val = process.env[key]; + if (/^(yes|on|true|enabled)$/i.test(val)) val = true; + else if (/^(no|off|false|disabled)$/i.test(val)) val = false; + else if (val === 'null') val = null; + else val = Number(val); + + obj[prop] = val; + return obj; +}, {}); + +/** + * The file descriptor to write the `debug()` calls to. + * Set the `DEBUG_FD` env variable to override with another value. i.e.: + * + * $ DEBUG_FD=3 node script.js 3>debug.log + */ + +var fd = parseInt(process.env.DEBUG_FD, 10) || 2; + +if (1 !== fd && 2 !== fd) { + util.deprecate(function(){}, 'except for stderr(2) and stdout(1), any other usage of DEBUG_FD is deprecated. Override debug.log if you want to use a different log function (https://git.io/debug_fd)')() +} + +var stream = 1 === fd ? process.stdout : + 2 === fd ? process.stderr : + createWritableStdioStream(fd); + +/** + * Is stdout a TTY? Colored output is enabled when `true`. + */ + +function useColors() { + return 'colors' in exports.inspectOpts + ? Boolean(exports.inspectOpts.colors) + : tty.isatty(fd); +} + +/** + * Map %o to `util.inspect()`, all on a single line. + */ + +exports.formatters.o = function(v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts) + .split('\n').map(function(str) { + return str.trim() + }).join(' '); +}; + +/** + * Map %o to `util.inspect()`, allowing multiple lines if needed. + */ + +exports.formatters.O = function(v) { + this.inspectOpts.colors = this.useColors; + return util.inspect(v, this.inspectOpts); +}; + +/** + * Adds ANSI color escape codes if enabled. + * + * @api public + */ + +function formatArgs(args) { + var name = this.namespace; + var useColors = this.useColors; + + if (useColors) { + var c = this.color; + var prefix = ' \u001b[3' + c + ';1m' + name + ' ' + '\u001b[0m'; + + args[0] = prefix + args[0].split('\n').join('\n' + prefix); + args.push('\u001b[3' + c + 'm+' + exports.humanize(this.diff) + '\u001b[0m'); + } else { + args[0] = new Date().toUTCString() + + ' ' + name + ' ' + args[0]; + } +} + +/** + * Invokes `util.format()` with the specified arguments and writes to `stream`. + */ + +function log() { + return stream.write(util.format.apply(util, arguments) + '\n'); +} + +/** + * Save `namespaces`. + * + * @param {String} namespaces + * @api private + */ + +function save(namespaces) { + if (null == namespaces) { + // If you set a process.env field to null or undefined, it gets cast to the + // string 'null' or 'undefined'. Just delete instead. + delete process.env.DEBUG; + } else { + process.env.DEBUG = namespaces; + } +} + +/** + * Load `namespaces`. + * + * @return {String} returns the previously persisted debug modes + * @api private + */ + +function load() { + return process.env.DEBUG; +} + +/** + * Copied from `node/src/node.js`. + * + * XXX: It's lame that node doesn't expose this API out-of-the-box. It also + * relies on the undocumented `tty_wrap.guessHandleType()` which is also lame. + */ + +function createWritableStdioStream (fd) { + var stream; + var tty_wrap = process.binding('tty_wrap'); + + // Note stream._type is used for test-module-load-list.js + + switch (tty_wrap.guessHandleType(fd)) { + case 'TTY': + stream = new tty.WriteStream(fd); + stream._type = 'tty'; + + // Hack to have stream not keep the event loop alive. + // See https://github.com/joyent/node/issues/1726 + if (stream._handle && stream._handle.unref) { + stream._handle.unref(); + } + break; + + case 'FILE': + var fs = __webpack_require__(23); + stream = new fs.SyncWriteStream(fd, { autoClose: false }); + stream._type = 'fs'; + break; + + case 'PIPE': + case 'TCP': + var net = __webpack_require__(805); + stream = new net.Socket({ + fd: fd, + readable: false, + writable: true + }); + + // FIXME Should probably have an option in net.Socket to create a + // stream from an existing fd which is writable only. But for now + // we'll just add this hack and set the `readable` member to false. + // Test: ./node test/fixtures/echo.js < /etc/passwd + stream.readable = false; + stream.read = null; + stream._type = 'pipe'; + + // FIXME Hack to have stream not keep the event loop alive. + // See https://github.com/joyent/node/issues/1726 + if (stream._handle && stream._handle.unref) { + stream._handle.unref(); + } + break; + + default: + // Probably an error on in uv_guess_handle() + throw new Error('Implement me. Unknown stream file type!'); + } + + // For supporting legacy API we put the FD here. + stream.fd = fd; + + stream._isStdio = true; + + return stream; +} + +/** + * Init logic for `debug` instances. + * + * Create a new `inspectOpts` object in case `useColors` is set + * differently for a particular `debug` instance. + */ + +function init (debug) { + debug.inspectOpts = {}; + + var keys = Object.keys(exports.inspectOpts); + for (var i = 0; i < keys.length; i++) { + debug.inspectOpts[keys[i]] = exports.inspectOpts[keys[i]]; + } +} + +/** + * Enable namespaces listed in `process.env.DEBUG` initially. + */ + +exports.enable(load()); + + +/***/ }), +/* 868 */ +/***/ (function(module, exports, __webpack_require__) { + "use strict"; var brackets = __webpack_require__(858); -var define = __webpack_require__(864); -var utils = __webpack_require__(865); +var define = __webpack_require__(869); +var utils = __webpack_require__(870); /** * Characters to use in text regex (we want to "not" match @@ -101901,7 +102728,7 @@ module.exports = parsers; /***/ }), -/* 864 */ +/* 869 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -101939,7 +102766,7 @@ module.exports = function defineProperty(obj, prop, val) { /***/ }), -/* 865 */ +/* 870 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102015,7 +102842,7 @@ utils.createRegex = function(str) { /***/ }), -/* 866 */ +/* 871 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102026,7 +102853,7 @@ utils.createRegex = function(str) { */ var Snapdragon = __webpack_require__(767); -var define = __webpack_require__(864); +var define = __webpack_require__(869); var extend = __webpack_require__(737); /** @@ -102034,7 +102861,7 @@ var extend = __webpack_require__(737); */ var compilers = __webpack_require__(857); -var parsers = __webpack_require__(863); +var parsers = __webpack_require__(868); /** * Customize Snapdragon parser and renderer @@ -102100,7 +102927,7 @@ module.exports = Extglob; /***/ }), -/* 867 */ +/* 872 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102190,14 +103017,14 @@ function textRegex(pattern) { /***/ }), -/* 868 */ +/* 873 */ /***/ (function(module, exports, __webpack_require__) { module.exports = new (__webpack_require__(849))(); /***/ }), -/* 869 */ +/* 874 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102215,7 +103042,7 @@ utils.define = __webpack_require__(836); utils.diff = __webpack_require__(853); utils.extend = __webpack_require__(837); utils.pick = __webpack_require__(854); -utils.typeOf = __webpack_require__(870); +utils.typeOf = __webpack_require__(875); utils.unique = __webpack_require__(740); /** @@ -102513,7 +103340,7 @@ utils.unixify = function(options) { /***/ }), -/* 870 */ +/* 875 */ /***/ (function(module, exports) { var toString = Object.prototype.toString; @@ -102648,7 +103475,7 @@ function isBuffer(val) { /***/ }), -/* 871 */ +/* 876 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102667,9 +103494,9 @@ var __extends = (this && this.__extends) || (function () { }; })(); Object.defineProperty(exports, "__esModule", { value: true }); -var readdir = __webpack_require__(872); -var reader_1 = __webpack_require__(885); -var fs_stream_1 = __webpack_require__(889); +var readdir = __webpack_require__(877); +var reader_1 = __webpack_require__(890); +var fs_stream_1 = __webpack_require__(894); var ReaderAsync = /** @class */ (function (_super) { __extends(ReaderAsync, _super); function ReaderAsync() { @@ -102730,15 +103557,15 @@ exports.default = ReaderAsync; /***/ }), -/* 872 */ +/* 877 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const readdirSync = __webpack_require__(873); -const readdirAsync = __webpack_require__(881); -const readdirStream = __webpack_require__(884); +const readdirSync = __webpack_require__(878); +const readdirAsync = __webpack_require__(886); +const readdirStream = __webpack_require__(889); module.exports = exports = readdirAsyncPath; exports.readdir = exports.readdirAsync = exports.async = readdirAsyncPath; @@ -102822,7 +103649,7 @@ function readdirStreamStat (dir, options) { /***/ }), -/* 873 */ +/* 878 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102830,11 +103657,11 @@ function readdirStreamStat (dir, options) { module.exports = readdirSync; -const DirectoryReader = __webpack_require__(874); +const DirectoryReader = __webpack_require__(879); let syncFacade = { - fs: __webpack_require__(879), - forEach: __webpack_require__(880), + fs: __webpack_require__(884), + forEach: __webpack_require__(885), sync: true }; @@ -102863,7 +103690,7 @@ function readdirSync (dir, options, internalOptions) { /***/ }), -/* 874 */ +/* 879 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -102872,9 +103699,9 @@ function readdirSync (dir, options, internalOptions) { const Readable = __webpack_require__(27).Readable; const EventEmitter = __webpack_require__(379).EventEmitter; const path = __webpack_require__(16); -const normalizeOptions = __webpack_require__(875); -const stat = __webpack_require__(877); -const call = __webpack_require__(878); +const normalizeOptions = __webpack_require__(880); +const stat = __webpack_require__(882); +const call = __webpack_require__(883); /** * Asynchronously reads the contents of a directory and streams the results @@ -103250,14 +104077,14 @@ module.exports = DirectoryReader; /***/ }), -/* 875 */ +/* 880 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); -const globToRegExp = __webpack_require__(876); +const globToRegExp = __webpack_require__(881); module.exports = normalizeOptions; @@ -103434,7 +104261,7 @@ function normalizeOptions (options, internalOptions) { /***/ }), -/* 876 */ +/* 881 */ /***/ (function(module, exports) { module.exports = function (glob, opts) { @@ -103571,13 +104398,13 @@ module.exports = function (glob, opts) { /***/ }), -/* 877 */ +/* 882 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const call = __webpack_require__(878); +const call = __webpack_require__(883); module.exports = stat; @@ -103652,7 +104479,7 @@ function symlinkStat (fs, path, lstats, callback) { /***/ }), -/* 878 */ +/* 883 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103713,14 +104540,14 @@ function callOnce (fn) { /***/ }), -/* 879 */ +/* 884 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); -const call = __webpack_require__(878); +const call = __webpack_require__(883); /** * A facade around {@link fs.readdirSync} that allows it to be called @@ -103784,7 +104611,7 @@ exports.lstat = function (path, callback) { /***/ }), -/* 880 */ +/* 885 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103813,7 +104640,7 @@ function syncForEach (array, iterator, done) { /***/ }), -/* 881 */ +/* 886 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103821,12 +104648,12 @@ function syncForEach (array, iterator, done) { module.exports = readdirAsync; -const maybe = __webpack_require__(882); -const DirectoryReader = __webpack_require__(874); +const maybe = __webpack_require__(887); +const DirectoryReader = __webpack_require__(879); let asyncFacade = { fs: __webpack_require__(23), - forEach: __webpack_require__(883), + forEach: __webpack_require__(888), async: true }; @@ -103868,7 +104695,7 @@ function readdirAsync (dir, options, callback, internalOptions) { /***/ }), -/* 882 */ +/* 887 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103895,7 +104722,7 @@ module.exports = function maybe (cb, promise) { /***/ }), -/* 883 */ +/* 888 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103931,7 +104758,7 @@ function asyncForEach (array, iterator, done) { /***/ }), -/* 884 */ +/* 889 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -103939,11 +104766,11 @@ function asyncForEach (array, iterator, done) { module.exports = readdirStream; -const DirectoryReader = __webpack_require__(874); +const DirectoryReader = __webpack_require__(879); let streamFacade = { fs: __webpack_require__(23), - forEach: __webpack_require__(883), + forEach: __webpack_require__(888), async: true }; @@ -103963,16 +104790,16 @@ function readdirStream (dir, options, internalOptions) { /***/ }), -/* 885 */ +/* 890 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); var path = __webpack_require__(16); -var deep_1 = __webpack_require__(886); -var entry_1 = __webpack_require__(888); -var pathUtil = __webpack_require__(887); +var deep_1 = __webpack_require__(891); +var entry_1 = __webpack_require__(893); +var pathUtil = __webpack_require__(892); var Reader = /** @class */ (function () { function Reader(options) { this.options = options; @@ -104038,13 +104865,13 @@ exports.default = Reader; /***/ }), -/* 886 */ +/* 891 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var pathUtils = __webpack_require__(887); +var pathUtils = __webpack_require__(892); var patternUtils = __webpack_require__(721); var DeepFilter = /** @class */ (function () { function DeepFilter(options, micromatchOptions) { @@ -104128,7 +104955,7 @@ exports.default = DeepFilter; /***/ }), -/* 887 */ +/* 892 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104159,13 +104986,13 @@ exports.makeAbsolute = makeAbsolute; /***/ }), -/* 888 */ +/* 893 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -var pathUtils = __webpack_require__(887); +var pathUtils = __webpack_require__(892); var patternUtils = __webpack_require__(721); var EntryFilter = /** @class */ (function () { function EntryFilter(options, micromatchOptions) { @@ -104251,7 +105078,7 @@ exports.default = EntryFilter; /***/ }), -/* 889 */ +/* 894 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104271,8 +105098,8 @@ var __extends = (this && this.__extends) || (function () { })(); Object.defineProperty(exports, "__esModule", { value: true }); var stream = __webpack_require__(27); -var fsStat = __webpack_require__(890); -var fs_1 = __webpack_require__(894); +var fsStat = __webpack_require__(895); +var fs_1 = __webpack_require__(899); var FileSystemStream = /** @class */ (function (_super) { __extends(FileSystemStream, _super); function FileSystemStream() { @@ -104322,14 +105149,14 @@ exports.default = FileSystemStream; /***/ }), -/* 890 */ +/* 895 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const optionsManager = __webpack_require__(891); -const statProvider = __webpack_require__(893); +const optionsManager = __webpack_require__(896); +const statProvider = __webpack_require__(898); /** * Asynchronous API. */ @@ -104360,13 +105187,13 @@ exports.statSync = statSync; /***/ }), -/* 891 */ +/* 896 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; Object.defineProperty(exports, "__esModule", { value: true }); -const fsAdapter = __webpack_require__(892); +const fsAdapter = __webpack_require__(897); function prepare(opts) { const options = Object.assign({ fs: fsAdapter.getFileSystemAdapter(opts ? opts.fs : undefined), @@ -104379,7 +105206,7 @@ exports.prepare = prepare; /***/ }), -/* 892 */ +/* 897 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104402,7 +105229,7 @@ exports.getFileSystemAdapter = getFileSystemAdapter; /***/ }), -/* 893 */ +/* 898 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104454,7 +105281,7 @@ exports.isFollowedSymlink = isFollowedSymlink; /***/ }), -/* 894 */ +/* 899 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104485,7 +105312,7 @@ exports.default = FileSystem; /***/ }), -/* 895 */ +/* 900 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104505,9 +105332,9 @@ var __extends = (this && this.__extends) || (function () { })(); Object.defineProperty(exports, "__esModule", { value: true }); var stream = __webpack_require__(27); -var readdir = __webpack_require__(872); -var reader_1 = __webpack_require__(885); -var fs_stream_1 = __webpack_require__(889); +var readdir = __webpack_require__(877); +var reader_1 = __webpack_require__(890); +var fs_stream_1 = __webpack_require__(894); var TransformStream = /** @class */ (function (_super) { __extends(TransformStream, _super); function TransformStream(reader) { @@ -104575,7 +105402,7 @@ exports.default = ReaderStream; /***/ }), -/* 896 */ +/* 901 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104594,9 +105421,9 @@ var __extends = (this && this.__extends) || (function () { }; })(); Object.defineProperty(exports, "__esModule", { value: true }); -var readdir = __webpack_require__(872); -var reader_1 = __webpack_require__(885); -var fs_sync_1 = __webpack_require__(897); +var readdir = __webpack_require__(877); +var reader_1 = __webpack_require__(890); +var fs_sync_1 = __webpack_require__(902); var ReaderSync = /** @class */ (function (_super) { __extends(ReaderSync, _super); function ReaderSync() { @@ -104656,7 +105483,7 @@ exports.default = ReaderSync; /***/ }), -/* 897 */ +/* 902 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104675,8 +105502,8 @@ var __extends = (this && this.__extends) || (function () { }; })(); Object.defineProperty(exports, "__esModule", { value: true }); -var fsStat = __webpack_require__(890); -var fs_1 = __webpack_require__(894); +var fsStat = __webpack_require__(895); +var fs_1 = __webpack_require__(899); var FileSystemSync = /** @class */ (function (_super) { __extends(FileSystemSync, _super); function FileSystemSync() { @@ -104722,7 +105549,7 @@ exports.default = FileSystemSync; /***/ }), -/* 898 */ +/* 903 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104738,7 +105565,7 @@ exports.flatten = flatten; /***/ }), -/* 899 */ +/* 904 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104759,13 +105586,13 @@ exports.merge = merge; /***/ }), -/* 900 */ +/* 905 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); -const pathType = __webpack_require__(901); +const pathType = __webpack_require__(906); const getExtensions = extensions => extensions.length > 1 ? `{${extensions.join(',')}}` : extensions[0]; @@ -104831,13 +105658,13 @@ module.exports.sync = (input, opts) => { /***/ }), -/* 901 */ +/* 906 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const fs = __webpack_require__(23); -const pify = __webpack_require__(902); +const pify = __webpack_require__(907); function type(fn, fn2, fp) { if (typeof fp !== 'string') { @@ -104880,7 +105707,7 @@ exports.symlinkSync = typeSync.bind(null, 'lstatSync', 'isSymbolicLink'); /***/ }), -/* 902 */ +/* 907 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104971,7 +105798,7 @@ module.exports = (obj, opts) => { /***/ }), -/* 903 */ +/* 908 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -104979,9 +105806,9 @@ module.exports = (obj, opts) => { const fs = __webpack_require__(23); const path = __webpack_require__(16); const fastGlob = __webpack_require__(717); -const gitIgnore = __webpack_require__(904); -const pify = __webpack_require__(905); -const slash = __webpack_require__(906); +const gitIgnore = __webpack_require__(909); +const pify = __webpack_require__(910); +const slash = __webpack_require__(911); const DEFAULT_IGNORE = [ '**/node_modules/**', @@ -105079,7 +105906,7 @@ module.exports.sync = options => { /***/ }), -/* 904 */ +/* 909 */ /***/ (function(module, exports) { // A simple implementation of make-array @@ -105548,7 +106375,7 @@ module.exports = options => new IgnoreBase(options) /***/ }), -/* 905 */ +/* 910 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -105623,7 +106450,7 @@ module.exports = (input, options) => { /***/ }), -/* 906 */ +/* 911 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -105641,17 +106468,17 @@ module.exports = input => { /***/ }), -/* 907 */ +/* 912 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const path = __webpack_require__(16); const {constants: fsConstants} = __webpack_require__(23); -const pEvent = __webpack_require__(908); -const CpFileError = __webpack_require__(911); -const fs = __webpack_require__(915); -const ProgressEmitter = __webpack_require__(918); +const pEvent = __webpack_require__(913); +const CpFileError = __webpack_require__(916); +const fs = __webpack_require__(920); +const ProgressEmitter = __webpack_require__(923); const cpFileAsync = async (source, destination, options, progressEmitter) => { let readError; @@ -105765,12 +106592,12 @@ module.exports.sync = (source, destination, options) => { /***/ }), -/* 908 */ +/* 913 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const pTimeout = __webpack_require__(909); +const pTimeout = __webpack_require__(914); const symbolAsyncIterator = Symbol.asyncIterator || '@@asyncIterator'; @@ -106061,12 +106888,12 @@ module.exports.iterator = (emitter, event, options) => { /***/ }), -/* 909 */ +/* 914 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const pFinally = __webpack_require__(910); +const pFinally = __webpack_require__(915); class TimeoutError extends Error { constructor(message) { @@ -106112,7 +106939,7 @@ module.exports.TimeoutError = TimeoutError; /***/ }), -/* 910 */ +/* 915 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -106134,12 +106961,12 @@ module.exports = (promise, onFinally) => { /***/ }), -/* 911 */ +/* 916 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const NestedError = __webpack_require__(912); +const NestedError = __webpack_require__(917); class CpFileError extends NestedError { constructor(message, nested) { @@ -106153,10 +106980,10 @@ module.exports = CpFileError; /***/ }), -/* 912 */ +/* 917 */ /***/ (function(module, exports, __webpack_require__) { -var inherits = __webpack_require__(913); +var inherits = __webpack_require__(918); var NestedError = function (message, nested) { this.nested = nested; @@ -106207,7 +107034,7 @@ module.exports = NestedError; /***/ }), -/* 913 */ +/* 918 */ /***/ (function(module, exports, __webpack_require__) { try { @@ -106215,12 +107042,12 @@ try { if (typeof util.inherits !== 'function') throw ''; module.exports = util.inherits; } catch (e) { - module.exports = __webpack_require__(914); + module.exports = __webpack_require__(919); } /***/ }), -/* 914 */ +/* 919 */ /***/ (function(module, exports) { if (typeof Object.create === 'function') { @@ -106249,16 +107076,16 @@ if (typeof Object.create === 'function') { /***/ }), -/* 915 */ +/* 920 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; const {promisify} = __webpack_require__(29); const fs = __webpack_require__(22); -const makeDir = __webpack_require__(916); -const pEvent = __webpack_require__(908); -const CpFileError = __webpack_require__(911); +const makeDir = __webpack_require__(921); +const pEvent = __webpack_require__(913); +const CpFileError = __webpack_require__(916); const stat = promisify(fs.stat); const lstat = promisify(fs.lstat); @@ -106355,7 +107182,7 @@ exports.copyFileSync = (source, destination, flags) => { /***/ }), -/* 916 */ +/* 921 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -106363,7 +107190,7 @@ exports.copyFileSync = (source, destination, flags) => { const fs = __webpack_require__(23); const path = __webpack_require__(16); const {promisify} = __webpack_require__(29); -const semver = __webpack_require__(917); +const semver = __webpack_require__(922); const defaults = { mode: 0o777 & (~process.umask()), @@ -106512,7 +107339,7 @@ module.exports.sync = (input, options) => { /***/ }), -/* 917 */ +/* 922 */ /***/ (function(module, exports) { exports = module.exports = SemVer @@ -108114,7 +108941,7 @@ function coerce (version, options) { /***/ }), -/* 918 */ +/* 923 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -108155,7 +108982,7 @@ module.exports = ProgressEmitter; /***/ }), -/* 919 */ +/* 924 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; @@ -108201,12 +109028,12 @@ exports.default = module.exports; /***/ }), -/* 920 */ +/* 925 */ /***/ (function(module, exports, __webpack_require__) { "use strict"; -const NestedError = __webpack_require__(921); +const NestedError = __webpack_require__(926); class CpyError extends NestedError { constructor(message, nested) { @@ -108220,7 +109047,7 @@ module.exports = CpyError; /***/ }), -/* 921 */ +/* 926 */ /***/ (function(module, exports, __webpack_require__) { var inherits = __webpack_require__(29).inherits; @@ -108276,7 +109103,7 @@ module.exports = NestedError; /***/ }), -/* 922 */ +/* 927 */ /***/ (function(module, __webpack_exports__, __webpack_require__) { "use strict"; diff --git a/packages/kbn-test/src/functional_test_runner/lib/config/schema.ts b/packages/kbn-test/src/functional_test_runner/lib/config/schema.ts index f4b91d154cbb8..66f17ab579ec3 100644 --- a/packages/kbn-test/src/functional_test_runner/lib/config/schema.ts +++ b/packages/kbn-test/src/functional_test_runner/lib/config/schema.ts @@ -136,7 +136,7 @@ export const schema = Joi.object() browser: Joi.object() .keys({ type: Joi.string() - .valid('chrome', 'firefox', 'ie', 'msedge') + .valid('chrome', 'firefox', 'ie') .default('chrome'), logPollingMs: Joi.number().default(100), diff --git a/test/functional/config.edge.js b/test/functional/config.edge.js deleted file mode 100644 index ed68b41e8c89a..0000000000000 --- a/test/functional/config.edge.js +++ /dev/null @@ -1,34 +0,0 @@ -/* - * 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. - */ - -export default async function({ readConfigFile }) { - const defaultConfig = await readConfigFile(require.resolve('./config')); - - return { - ...defaultConfig.getAll(), - - browser: { - type: 'msedge', - }, - - junit: { - reportName: 'MS Chromium Edge UI Functional Tests', - }, - }; -} diff --git a/test/functional/services/browser.ts b/test/functional/services/browser.ts index 13d2365c07191..5017947e95d03 100644 --- a/test/functional/services/browser.ts +++ b/test/functional/services/browser.ts @@ -47,9 +47,7 @@ export async function BrowserProvider({ getService }: FtrProviderContext) { */ public readonly browserType: string = browserType; - public readonly isChromium: boolean = [Browsers.Chrome, Browsers.ChromiumEdge].includes( - browserType - ); + public readonly isChrome: boolean = browserType === Browsers.Chrome; public readonly isFirefox: boolean = browserType === Browsers.Firefox; diff --git a/test/functional/services/lib/web_element_wrapper/web_element_wrapper.ts b/test/functional/services/lib/web_element_wrapper/web_element_wrapper.ts index 8b57ecd3c8235..157918df874c8 100644 --- a/test/functional/services/lib/web_element_wrapper/web_element_wrapper.ts +++ b/test/functional/services/lib/web_element_wrapper/web_element_wrapper.ts @@ -55,7 +55,6 @@ export class WebElementWrapper { private driver: WebDriver = this.webDriver.driver; private Keys = Key; public isW3CEnabled: boolean = (this.webDriver.driver as any).executor_.w3c === true; - public isChromium: boolean = [Browsers.Chrome, Browsers.ChromiumEdge].includes(this.browserType); public static create( webElement: WebElement | WebElementWrapper, @@ -64,7 +63,7 @@ export class WebElementWrapper { timeout: number, fixedHeaderHeight: number, logger: ToolingLog, - browserType: Browsers + browserType: string ): WebElementWrapper { if (webElement instanceof WebElementWrapper) { return webElement; @@ -88,7 +87,7 @@ export class WebElementWrapper { private timeout: number, private fixedHeaderHeight: number, private logger: ToolingLog, - private browserType: Browsers + private browserType: string ) {} private async _findWithCustomTimeout( @@ -244,7 +243,7 @@ export class WebElementWrapper { return this.clearValueWithKeyboard(); } await this.retryCall(async function clearValue(wrapper) { - if (wrapper.isChromium || options.withJS) { + if (wrapper.browserType === Browsers.Chrome || options.withJS) { // https://bugs.chromium.org/p/chromedriver/issues/detail?id=2702 await wrapper.driver.executeScript(`arguments[0].value=''`, wrapper._webElement); } else { @@ -276,7 +275,7 @@ export class WebElementWrapper { await delay(100); } } else { - if (this.isChromium) { + if (this.browserType === Browsers.Chrome) { // https://bugs.chromium.org/p/chromedriver/issues/detail?id=30 await this.retryCall(async function clearValueWithKeyboard(wrapper) { await wrapper.driver.executeScript(`arguments[0].select();`, wrapper._webElement); diff --git a/test/functional/services/remote/browsers.ts b/test/functional/services/remote/browsers.ts index aa6e364d0a09d..46d81f1737a55 100644 --- a/test/functional/services/remote/browsers.ts +++ b/test/functional/services/remote/browsers.ts @@ -21,5 +21,4 @@ export enum Browsers { Chrome = 'chrome', Firefox = 'firefox', InternetExplorer = 'ie', - ChromiumEdge = 'msedge', } diff --git a/test/functional/services/remote/remote.ts b/test/functional/services/remote/remote.ts index b0724488cb5db..e571a1a7e5551 100644 --- a/test/functional/services/remote/remote.ts +++ b/test/functional/services/remote/remote.ts @@ -64,23 +64,18 @@ export async function RemoteProvider({ getService }: FtrProviderContext) { lifecycle, config.get('browser.logPollingMs') ); - const isW3CEnabled = (driver as any).executor_.w3c; const caps = await driver.getCapabilities(); - const browserVersion = caps.get( - isW3CEnabled || browserType === Browsers.ChromiumEdge ? 'browserVersion' : 'version' - ); + const browserVersion = caps.get(isW3CEnabled ? 'browserVersion' : 'version'); - log.info( - `Remote initialized: ${caps.get( - 'browserName' - )} ${browserVersion}, w3c compliance=${isW3CEnabled}, collectingCoverage=${collectCoverage}` - ); + log.info(`Remote initialized: ${caps.get('browserName')} ${browserVersion}`); - if ([Browsers.Chrome, Browsers.ChromiumEdge].includes(browserType)) { + if (browserType === Browsers.Chrome) { log.info( - `${browserType}driver version: ${caps.get(browserType)[`${browserType}driverVersion`]}` + `Chromedriver version: ${ + caps.get('chrome').chromedriverVersion + }, w3c=${isW3CEnabled}, codeCoverage=${collectCoverage}` ); } diff --git a/test/functional/services/remote/webdriver.ts b/test/functional/services/remote/webdriver.ts index fc0b5bbb787c8..3bf5b865aa7ba 100644 --- a/test/functional/services/remote/webdriver.ts +++ b/test/functional/services/remote/webdriver.ts @@ -31,12 +31,10 @@ import { Builder, Capabilities, By, logging, until } from 'selenium-webdriver'; import chrome from 'selenium-webdriver/chrome'; import firefox from 'selenium-webdriver/firefox'; // @ts-ignore internal modules are not typed -import edge from 'selenium-webdriver/edge'; -import { installDriver } from 'ms-chromium-edge-driver'; -// @ts-ignore internal modules are not typed import { Executor } from 'selenium-webdriver/lib/http'; // @ts-ignore internal modules are not typed import { getLogger } from 'selenium-webdriver/lib/logging'; + import { pollForLogEntry$ } from './poll_for_log_entry'; import { createStdoutSocket } from './create_stdout_stream'; import { preventParallelCalls } from './prevent_parallel_calls'; @@ -65,7 +63,6 @@ Executor.prototype.execute = preventParallelCalls( ); let attemptCounter = 0; -let edgePaths: { driverPath: string | undefined; browserPath: string | undefined }; async function attemptToCreateCommand( log: ToolingLog, browserType: Browsers, @@ -77,46 +74,6 @@ async function attemptToCreateCommand( const buildDriverInstance = async () => { switch (browserType) { - case 'msedge': { - if (edgePaths && edgePaths.browserPath && edgePaths.driverPath) { - const edgeOptions = new edge.Options(); - if (headlessBrowser === '1') { - // @ts-ignore internal modules are not typed - edgeOptions.headless(); - } - // @ts-ignore internal modules are not typed - edgeOptions.setEdgeChromium(true); - // @ts-ignore internal modules are not typed - edgeOptions.setBinaryPath(edgePaths.browserPath); - const session = await new Builder() - .forBrowser('MicrosoftEdge') - .setEdgeOptions(edgeOptions) - .setEdgeService(new edge.ServiceBuilder(edgePaths.driverPath)) - .build(); - return { - session, - consoleLog$: pollForLogEntry$( - session, - logging.Type.BROWSER, - logPollingMs, - lifecycle.cleanup.after$ - ).pipe( - takeUntil(lifecycle.cleanup.after$), - map(({ message, level: { name: level } }) => ({ - message: message.replace(/\\n/g, '\n'), - level, - })) - ), - }; - } else { - throw new Error( - `Chromium Edge session requires browser or driver path to be defined: ${JSON.stringify( - edgePaths - )}` - ); - } - } - case 'chrome': { const chromeCapabilities = Capabilities.chrome(); const chromeOptions = [ @@ -308,11 +265,6 @@ export async function initWebDriver( log.verbose(entry.message); }); - // download Edge driver only in case of usage - if (browserType === Browsers.ChromiumEdge) { - edgePaths = await installDriver(); - } - return await Promise.race([ (async () => { await delay(2 * MINUTE); diff --git a/x-pack/test/functional/config.edge.js b/x-pack/test/functional/config.edge.js deleted file mode 100644 index 882fb6fea3686..0000000000000 --- a/x-pack/test/functional/config.edge.js +++ /dev/null @@ -1,21 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export default async function({ readConfigFile }) { - const chromeConfig = await readConfigFile(require.resolve('./config')); - - return { - ...chromeConfig.getAll(), - - browser: { - type: 'msedge', - }, - - junit: { - reportName: 'MS Chromium Edge XPack UI Functional Tests', - }, - }; -} diff --git a/yarn.lock b/yarn.lock index 8ca25cc18a8a2..fdfdcada62e2c 100644 --- a/yarn.lock +++ b/yarn.lock @@ -2562,11 +2562,6 @@ resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-0.7.0.tgz#9a06f4f137ee84d7df0460c1fdb1135ffa6c50fd" integrity sha512-ONhaKPIufzzrlNbqtWFFd+jlnemX6lJAgq9ZeiZtS7I1PIf/la7CW4m83rTXRnVnsMbW2k56pGYu7AUFJD9Pow== -"@sindresorhus/is@^2.0.0": - version "2.1.0" - resolved "https://registry.yarnpkg.com/@sindresorhus/is/-/is-2.1.0.tgz#6ad4ca610f696098e92954ab431ff83bea0ce13f" - integrity sha512-lXKXfypKo644k4Da4yXkPCrwcvn6SlUW2X2zFbuflKHNjf0w9htru01bo26uMhleMXsDmnZ12eJLdrAZa9MANg== - "@sinonjs/commons@^1", "@sinonjs/commons@^1.3.0", "@sinonjs/commons@^1.4.0": version "1.6.0" resolved "https://registry.yarnpkg.com/@sinonjs/commons/-/commons-1.6.0.tgz#ec7670432ae9c8eb710400d112c201a362d83393" @@ -3466,13 +3461,6 @@ "@svgr/plugin-svgo" "^4.2.0" loader-utils "^1.2.3" -"@szmarczak/http-timer@^4.0.0": - version "4.0.5" - resolved "https://registry.yarnpkg.com/@szmarczak/http-timer/-/http-timer-4.0.5.tgz#bfbd50211e9dfa51ba07da58a14cdfd333205152" - integrity sha512-PyRA9sm1Yayuj5OIoJ1hGt2YISX45w9WcFbh6ddT0Z/0yaFxOtGLInr4jUfU1EAFVs0Yfyfev4RNwBlUaHdlDQ== - dependencies: - defer-to-connect "^2.0.0" - "@testim/chrome-version@^1.0.7": version "1.0.7" resolved "https://registry.yarnpkg.com/@testim/chrome-version/-/chrome-version-1.0.7.tgz#0cd915785ec4190f08a3a6acc9b61fc38fb5f1a9" @@ -3721,16 +3709,6 @@ resolved "https://registry.yarnpkg.com/@types/browserslist-useragent/-/browserslist-useragent-3.0.0.tgz#d425c9818182ce71ce53866798cee9c7d41d6e53" integrity sha512-ZBvKzg3yyWNYEkwxAzdmUzp27sFvw+1m080/+2lwrt+eltNefn1f4fnpMyrjOla31p8zLleCYqQXw+3EETfn0w== -"@types/cacheable-request@^6.0.1": - version "6.0.1" - resolved "https://registry.yarnpkg.com/@types/cacheable-request/-/cacheable-request-6.0.1.tgz#5d22f3dded1fd3a84c0bbeb5039a7419c2c91976" - integrity sha512-ykFq2zmBGOCbpIXtoVbz4SKY5QriWPh3AjyU4G74RYbtt5yOc5OfaY75ftjg7mikMOla1CTGpX3lLbuJh8DTrQ== - dependencies: - "@types/http-cache-semantics" "*" - "@types/keyv" "*" - "@types/node" "*" - "@types/responselike" "*" - "@types/caseless@*": version "0.12.2" resolved "https://registry.yarnpkg.com/@types/caseless/-/caseless-0.12.2.tgz#f65d3d6389e01eeb458bd54dc8f52b95a9463bc8" @@ -4100,11 +4078,6 @@ "@types/react" "*" hoist-non-react-statics "^3.3.0" -"@types/http-cache-semantics@*": - version "4.0.0" - resolved "https://registry.yarnpkg.com/@types/http-cache-semantics/-/http-cache-semantics-4.0.0.tgz#9140779736aa2655635ee756e2467d787cfe8a2a" - integrity sha512-c3Xy026kOF7QOTn00hbIllV1dLR9hG9NkSrLQgCVs8NF6sBU+VGWjD3wLPhmh1TYAc7ugCFsvHYMN4VcBN1U1A== - "@types/indent-string@^3.0.0": version "3.0.0" resolved "https://registry.yarnpkg.com/@types/indent-string/-/indent-string-3.0.0.tgz#9ebb391ceda548926f5819ad16405349641b999f" @@ -4236,13 +4209,6 @@ dependencies: "@types/node" "*" -"@types/keyv@*": - version "3.1.1" - resolved "https://registry.yarnpkg.com/@types/keyv/-/keyv-3.1.1.tgz#e45a45324fca9dab716ab1230ee249c9fb52cfa7" - integrity sha512-MPtoySlAZQ37VoLaPcTHCu1RWJ4llDkULYZIzOYxlhxBqYPB0RsRlmMU0R6tahtFe27mIdkHV+551ZWV4PLmVw== - dependencies: - "@types/node" "*" - "@types/license-checker@15.0.0": version "15.0.0" resolved "https://registry.yarnpkg.com/@types/license-checker/-/license-checker-15.0.0.tgz#685d69e2cf61ffd862320434601f51c85e28bba1" @@ -4714,13 +4680,6 @@ "@types/tough-cookie" "*" form-data "^2.5.0" -"@types/responselike@*": - version "1.0.0" - resolved "https://registry.yarnpkg.com/@types/responselike/-/responselike-1.0.0.tgz#251f4fe7d154d2bad125abe1b429b23afd262e29" - integrity sha512-85Y2BjiufFzaMIlvJDvTTB8Fxl2xfLo4HgmHzVBz08w4wDePCTjYw66PdrolO0kzli3yam/YCgRufyo1DdQVTA== - dependencies: - "@types/node" "*" - "@types/retry@^0.12.0": version "0.12.0" resolved "https://registry.yarnpkg.com/@types/retry/-/retry-0.12.0.tgz#2b35eccfcee7d38cd72ad99232fbd58bffb3c84d" @@ -4736,10 +4695,10 @@ resolved "https://registry.yarnpkg.com/@types/seedrandom/-/seedrandom-2.4.28.tgz#9ce8fa048c1e8c85cb71d7fe4d704e000226036f" integrity sha512-SMA+fUwULwK7sd/ZJicUztiPs8F1yCPwF3O23Z9uQ32ME5Ha0NmDK9+QTsYE4O2tHXChzXomSWWeIhCnoN1LqA== -"@types/selenium-webdriver@4.0.9": - version "4.0.9" - resolved "https://registry.yarnpkg.com/@types/selenium-webdriver/-/selenium-webdriver-4.0.9.tgz#12621e55b2ef8f6c98bd17fe23fa720c6cba16bd" - integrity sha512-HopIwBE7GUXsscmt/J0DhnFXLSmO04AfxT6b8HAprknwka7pqEWquWDMXxCjd+NUHK9MkCe1SDKKsMiNmCItbQ== +"@types/selenium-webdriver@^4.0.5": + version "4.0.5" + resolved "https://registry.yarnpkg.com/@types/selenium-webdriver/-/selenium-webdriver-4.0.5.tgz#23041a4948c82daf2df9836e4d2358fec10d3e24" + integrity sha512-ma1aL1znI3ptEbSQgbywgadrRCJouPIACSfOl/bPwu/TPNSyyE/+o9jZ6+bpDVTtIdksZuVKpq4SR1ip3DRduw== "@types/semver@^5.5.0": version "5.5.0" @@ -7470,18 +7429,13 @@ binaryextensions@2: resolved "https://registry.yarnpkg.com/binaryextensions/-/binaryextensions-2.1.1.tgz#3209a51ca4a4ad541a3b8d3d6a6d5b83a2485935" integrity sha512-XBaoWE9RW8pPdPQNibZsW2zh8TW6gcarXp1FZPwT8Uop8ScSNldJEWf2k9l3HeTqdrEwsOsFcq74RiJECW34yA== -bindings@1, bindings@^1.5.0: +bindings@^1.5.0: version "1.5.0" resolved "https://registry.yarnpkg.com/bindings/-/bindings-1.5.0.tgz#10353c9e945334bc0511a6d90b38fbc7c9c504df" integrity sha512-p2q/t/mhvuOj/UeLlV6566GD/guowlr0hHxClI0W9m7MWYkL1F0hLo+0Aexs9HSPCtR1SXQ0TD3MMKrXZajbiQ== dependencies: file-uri-to-path "1.0.0" -bindings@~1.2.0: - version "1.2.1" - resolved "https://registry.yarnpkg.com/bindings/-/bindings-1.2.1.tgz#14ad6113812d2d37d72e67b4cacb4bb726505f11" - integrity sha1-FK1hE4EtLTfXLme0ystLtyZQXxE= - bit-twiddle@^1.0.0: version "1.0.2" resolved "https://registry.yarnpkg.com/bit-twiddle/-/bit-twiddle-1.0.2.tgz#0c6c1fabe2b23d17173d9a61b7b7093eb9e1769e" @@ -8015,7 +7969,7 @@ buffer@^5.1.0, buffer@^5.2.0: base64-js "^1.0.2" ieee754 "^1.1.4" -builtin-modules@^1.0.0, builtin-modules@^1.1.1: +builtin-modules@^1.0.0: version "1.1.1" resolved "https://registry.yarnpkg.com/builtin-modules/-/builtin-modules-1.1.1.tgz#270f076c5a72c02f5b65a47df94c5fe3a278892f" integrity sha1-Jw8HbFpywC9bZaR9+Uxf46J4iS8= @@ -8162,13 +8116,6 @@ cache-loader@^4.1.0: neo-async "^2.6.1" schema-utils "^2.0.0" -cacheable-lookup@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/cacheable-lookup/-/cacheable-lookup-2.0.0.tgz#33b1e56f17507f5cf9bb46075112d65473fb7713" - integrity sha512-s2piO6LvA7xnL1AR03wuEdSx3BZT3tIJpZ56/lcJwzO/6DTJZlTs7X3lrvPxk6d1PlDe6PrVe2TjlUIZNFglAQ== - dependencies: - keyv "^4.0.0" - cacheable-request@^2.1.1: version "2.1.4" resolved "https://registry.yarnpkg.com/cacheable-request/-/cacheable-request-2.1.4.tgz#0d808801b6342ad33c91df9d0b44dc09b91e5c3d" @@ -8182,19 +8129,6 @@ cacheable-request@^2.1.1: normalize-url "2.0.1" responselike "1.0.2" -cacheable-request@^7.0.1: - version "7.0.1" - resolved "https://registry.yarnpkg.com/cacheable-request/-/cacheable-request-7.0.1.tgz#062031c2856232782ed694a257fa35da93942a58" - integrity sha512-lt0mJ6YAnsrBErpTMWeu5kl/tg9xMAWjavYTN6VQXM1A/teBITuNcccXsCxF0tDQQJf9DfAaX5O4e0zp0KlfZw== - dependencies: - clone-response "^1.0.2" - get-stream "^5.1.0" - http-cache-semantics "^4.0.0" - keyv "^4.0.0" - lowercase-keys "^2.0.0" - normalize-url "^4.1.0" - responselike "^2.0.0" - cachedir@2.3.0: version "2.3.0" resolved "https://registry.yarnpkg.com/cachedir/-/cachedir-2.3.0.tgz#0c75892a052198f0b21c7c1804d8331edfcae0e8" @@ -9023,7 +8957,7 @@ clone-regexp@^1.0.0: is-regexp "^1.0.0" is-supported-regexp-flag "^1.0.0" -clone-response@1.0.2, clone-response@^1.0.2: +clone-response@1.0.2: version "1.0.2" resolved "https://registry.yarnpkg.com/clone-response/-/clone-response-1.0.2.tgz#d1dc973920314df67fbeb94223b4ee350239e96b" integrity sha1-0dyXOSAxTfZ/vrlCI7TuNQI56Ws= @@ -9287,16 +9221,16 @@ commander@4.1.0: resolved "https://registry.yarnpkg.com/commander/-/commander-4.1.0.tgz#545983a0603fe425bc672d66c9e3c89c42121a83" integrity sha512-NIQrwvv9V39FHgGFm36+U9SMQzbiHvU79k+iADraJTpmrFFfx7Ds0IvDoAdZsDrknlkRk14OYoWXb57uTh7/sw== -commander@^2.12.1, commander@^2.20.0, commander@^2.7.1: - version "2.20.3" - resolved "https://registry.yarnpkg.com/commander/-/commander-2.20.3.tgz#fd485e84c03eb4881c20722ba48035e8531aeb33" - integrity sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ== - commander@^2.13.0, commander@^2.15.1, commander@^2.16.0, commander@^2.19.0: version "2.20.0" resolved "https://registry.yarnpkg.com/commander/-/commander-2.20.0.tgz#d58bb2b5c1ee8f87b0d340027e9e94e222c5a422" integrity sha512-7j2y+40w61zy6YC2iRNpUe/NwhNyoXrYpHMrSunaMG64nRnaf96zO/KMQR4OyN/UnE5KLyEBnKHd4aG3rskjpQ== +commander@^2.20.0, commander@^2.7.1: + version "2.20.3" + resolved "https://registry.yarnpkg.com/commander/-/commander-2.20.3.tgz#fd485e84c03eb4881c20722ba48035e8531aeb33" + integrity sha512-GpVkmM8vF2vQUkj2LvZmD35JxeJOLCwJ9cUkugyk2nuhbv3+mJvpLYYt+0+USMxE+oj+ey/lJEnhZw75x/OMcQ== + commander@^2.8.1: version "2.18.0" resolved "https://registry.yarnpkg.com/commander/-/commander-2.18.0.tgz#2bf063ddee7c7891176981a2cc798e5754bc6970" @@ -10701,7 +10635,7 @@ debug-fabulous@1.X: memoizee "0.4.X" object-assign "4.X" -debug@2, debug@2.6.9, debug@^2.0.0, debug@^2.1.0, debug@^2.1.1, debug@^2.2.0, debug@^2.3.3, debug@^2.6.0, debug@^2.6.8, debug@^2.6.9: +debug@2.6.9, debug@^2.0.0, debug@^2.1.0, debug@^2.1.1, debug@^2.2.0, debug@^2.3.3, debug@^2.6.0, debug@^2.6.8, debug@^2.6.9: version "2.6.9" resolved "https://registry.yarnpkg.com/debug/-/debug-2.6.9.tgz#5d128515df134ff327e90a4c93f4e077a536341f" integrity sha512-bC7ElrdJaJnPbAP+1EotYvqZsb3ecl5wi6Bfi6BJTUcNowp6cvspg0jXznRTKDjm/E7AdgFBVeAPVMNcKGsHMA== @@ -10773,13 +10707,6 @@ decompress-response@^4.2.0: dependencies: mimic-response "^2.0.0" -decompress-response@^5.0.0: - version "5.0.0" - resolved "https://registry.yarnpkg.com/decompress-response/-/decompress-response-5.0.0.tgz#7849396e80e3d1eba8cb2f75ef4930f76461cb0f" - integrity sha512-TLZWWybuxWgoW7Lykv+gq9xvzOsUjQ9tF09Tj6NSTYGMTCHNXzrPnD6Hi+TgZq19PyTAGH4Ll/NIM/eTGglnMw== - dependencies: - mimic-response "^2.0.0" - decompress-tar@^4.0.0, decompress-tar@^4.1.0, decompress-tar@^4.1.1: version "4.1.1" resolved "https://registry.yarnpkg.com/decompress-tar/-/decompress-tar-4.1.1.tgz#718cbd3fcb16209716e70a26b84e7ba4592e5af1" @@ -10931,11 +10858,6 @@ defaults@^1.0.3: dependencies: clone "^1.0.2" -defer-to-connect@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/defer-to-connect/-/defer-to-connect-2.0.0.tgz#83d6b199db041593ac84d781b5222308ccf4c2c1" - integrity sha512-bYL2d05vOSf1JEZNx5vSAtPuBMkX8K9EUutg7zlKvTqKXHt7RhWJFbmd7qakVuf13i+IkGmp6FwSsONOf6VYIg== - define-properties@^1.1.2, define-properties@^1.1.3: version "1.1.3" resolved "https://registry.yarnpkg.com/define-properties/-/define-properties-1.1.3.tgz#cf88da6cbee26fe6db7094f61d870cbd84cee9f1" @@ -13158,7 +13080,7 @@ extract-zip@1.6.7: mkdirp "0.5.1" yauzl "2.4.1" -extract-zip@^1.6.6, extract-zip@^1.6.7, extract-zip@^1.7.0: +extract-zip@^1.6.6, extract-zip@^1.7.0: version "1.7.0" resolved "https://registry.yarnpkg.com/extract-zip/-/extract-zip-1.7.0.tgz#556cc3ae9df7f452c493a0cfb51cc30277940927" integrity sha512-xoh5G1W/PB0/27lXgMQyIhP5DSY/LhoCsOyZgb+6iMmRtCwVBo55uKaMoEYrDCKQhWvqEip5ZPKAc6eFNyf/MA== @@ -13388,17 +13310,6 @@ fetch-mock@^7.3.9: path-to-regexp "^2.2.1" whatwg-url "^6.5.0" -ffi@^2.0.0: - version "2.3.0" - resolved "https://registry.yarnpkg.com/ffi/-/ffi-2.3.0.tgz#fa1a7b3d85c0fa8c83d96947a64b5192bc47f858" - integrity sha512-vkPA9Hf9CVuQ5HeMZykYvrZF2QNJ/iKGLkyDkisBnoOOFeFXZQhUPxBARPBIZMJVulvBI2R+jgofW03gyPpJcQ== - dependencies: - bindings "~1.2.0" - debug "2" - nan "2" - ref "1" - ref-struct "1" - figgy-pudding@^3.5.1: version "3.5.1" resolved "https://registry.yarnpkg.com/figgy-pudding/-/figgy-pudding-3.5.1.tgz#862470112901c727a0e495a80744bd5baa1d6790" @@ -14881,27 +14792,6 @@ got@5.6.0: unzip-response "^1.0.0" url-parse-lax "^1.0.0" -got@^10.6.0: - version "10.6.0" - resolved "https://registry.yarnpkg.com/got/-/got-10.6.0.tgz#ac3876261a4d8e5fc4f81186f79955ce7b0501dc" - integrity sha512-3LIdJNTdCFbbJc+h/EH0V5lpNpbJ6Bfwykk21lcQvQsEcrzdi/ltCyQehFHLzJ/ka0UMH4Slg0hkYvAZN9qUDg== - dependencies: - "@sindresorhus/is" "^2.0.0" - "@szmarczak/http-timer" "^4.0.0" - "@types/cacheable-request" "^6.0.1" - cacheable-lookup "^2.0.0" - cacheable-request "^7.0.1" - decompress-response "^5.0.0" - duplexer3 "^0.1.4" - get-stream "^5.0.0" - lowercase-keys "^2.0.0" - mimic-response "^2.1.0" - p-cancelable "^2.0.0" - p-event "^4.0.0" - responselike "^2.0.0" - to-readable-stream "^2.0.0" - type-fest "^0.10.0" - got@^3.2.0: version "3.3.1" resolved "https://registry.yarnpkg.com/got/-/got-3.3.1.tgz#e5d0ed4af55fc3eef4d56007769d98192bcb2eca" @@ -16008,11 +15898,6 @@ http-cache-semantics@3.8.1: resolved "https://registry.yarnpkg.com/http-cache-semantics/-/http-cache-semantics-3.8.1.tgz#39b0e16add9b605bf0a9ef3d9daaf4843b4cacd2" integrity sha512-5ai2iksyV8ZXmnZhHH4rWPoxxistEexSi5936zIQ1bnNTW5VnA85B6P/VpXiRM017IgRvb2kKo1a//y+0wSp3w== -http-cache-semantics@^4.0.0: - version "4.1.0" - resolved "https://registry.yarnpkg.com/http-cache-semantics/-/http-cache-semantics-4.1.0.tgz#49e91c5cbf36c9b94bcfcd71c23d5249ec74e390" - integrity sha512-carPklcUh7ROWRK7Cv27RPtdhYhUsela/ue5/jKzjegVvXDqM2ILE9Q2BGn9JZJh1g87cp56su/FgQSzcWS8cQ== - http-deceiver@^1.2.7: version "1.2.7" resolved "https://registry.yarnpkg.com/http-deceiver/-/http-deceiver-1.2.7.tgz#fa7168944ab9a519d337cb0bec7284dc3e723d87" @@ -17051,11 +16936,6 @@ is-generator-fn@^2.0.0: resolved "https://registry.yarnpkg.com/is-generator-fn/-/is-generator-fn-2.0.0.tgz#038c31b774709641bda678b1f06a4e3227c10b3e" integrity sha512-elzyIdM7iKoFHzcrndIqjYomImhxrFRnGP3galODoII4TB9gI7mZ+FnlLQmmjf27SxHS2gKEeyhX5/+YRS6H9g== -is-generator-function@^1.0.7: - version "1.0.7" - resolved "https://registry.yarnpkg.com/is-generator-function/-/is-generator-function-1.0.7.tgz#d2132e529bb0000a7f80794d4bdf5cd5e5813522" - integrity sha512-YZc5EwyO4f2kWCax7oegfuSr9mFz1ZvieNYBEjmukLxgXfBUbxAWGVF7GZf0zidYtoBl3WvC07YK0wT76a+Rtw== - is-glob@4.0.0, is-glob@^4.0.0: version "4.0.0" resolved "https://registry.yarnpkg.com/is-glob/-/is-glob-4.0.0.tgz#9521c76845cc2610a85203ddf080a958c2ffabc0" @@ -18345,11 +18225,6 @@ json-buffer@3.0.0: resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.0.tgz#5b1f397afc75d677bde8bcfc0e47e1f9a3d9a898" integrity sha1-Wx85evx11ne96Lz8Dkfh+aPZqJg= -json-buffer@3.0.1: - version "3.0.1" - resolved "https://registry.yarnpkg.com/json-buffer/-/json-buffer-3.0.1.tgz#9338802a30d3b6605fbe0613e094008ca8c05a13" - integrity sha512-4bV5BfR2mqfQTJm+V5tPPdf+ZpuhiIvTuAB5g8kcrXOZpTT/QwwVRWBywX1ozr6lEuPdbHxwaJlm9G6mI2sfSQ== - json-parse-better-errors@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/json-parse-better-errors/-/json-parse-better-errors-1.0.1.tgz#50183cd1b2d25275de069e9e71b467ac9eab973a" @@ -18585,7 +18460,7 @@ jsx-to-string@^1.4.0: json-stringify-pretty-compact "^1.0.1" react "^0.14.0" -jszip@^3.2.2: +jszip@^3.1.5: version "3.2.2" resolved "https://registry.yarnpkg.com/jszip/-/jszip-3.2.2.tgz#b143816df7e106a9597a94c77493385adca5bd1d" integrity sha512-NmKajvAFQpbg3taXQXr/ccS2wcucR1AZ+NtyWp2Nq7HHVsXhcJFR8p0Baf32C2yVvBylFWVeKf+WI2AnvlPhpA== @@ -18761,13 +18636,6 @@ keyv@3.0.0: dependencies: json-buffer "3.0.0" -keyv@^4.0.0: - version "4.0.0" - resolved "https://registry.yarnpkg.com/keyv/-/keyv-4.0.0.tgz#2d1dab694926b2d427e4c74804a10850be44c12f" - integrity sha512-U7ioE8AimvRVLfw4LffyOIRhL2xVgmE8T22L6i0BucSnBUyv4w+I7VN/zVZwRKHOI6ZRUcdMdWHQ8KSUvGpEog== - dependencies: - json-buffer "3.0.1" - killable@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/killable/-/killable-1.0.1.tgz#4c8ce441187a061c7474fb87ca08e2a638194892" @@ -19736,11 +19604,6 @@ lowercase-keys@^1.0.0: resolved "https://registry.yarnpkg.com/lowercase-keys/-/lowercase-keys-1.0.1.tgz#6f9e30b47084d971a7c820ff15a6c5167b74c26f" integrity sha512-G2Lj61tXDnVFFOi8VZds+SoQjtQC3dgokKdDG2mTm1tx4m50NUHBOZSBwQQHyy0V12A0JTG4icfZQH+xPyh8VA== -lowercase-keys@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/lowercase-keys/-/lowercase-keys-2.0.0.tgz#2603e78b7b4b0006cbca2fbcc8a3202558ac9479" - integrity sha512-tqNXrS78oMOE73NMxK4EMLQsQowWf8jKooH9g7xPavRT706R6bkQJ6DY2Te7QukaZsulxa30wQ7bk0pm4XiHmA== - lowlight@~1.9.1: version "1.9.1" resolved "https://registry.yarnpkg.com/lowlight/-/lowlight-1.9.1.tgz#ed7c3dffc36f8c1f263735c0fe0c907847c11250" @@ -20394,11 +20257,6 @@ mimic-response@^2.0.0: resolved "https://registry.yarnpkg.com/mimic-response/-/mimic-response-2.0.0.tgz#996a51c60adf12cb8a87d7fb8ef24c2f3d5ebb46" integrity sha512-8ilDoEapqA4uQ3TwS0jakGONKXVJqpy+RpM+3b7pLdOjghCrEiGp9SRkFbUHAmZW9vdnrENWHjaweIoTIJExSQ== -mimic-response@^2.1.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/mimic-response/-/mimic-response-2.1.0.tgz#d13763d35f613d09ec37ebb30bac0469c0ee8f43" - integrity sha512-wXqjST+SLt7R009ySCglWBCFpjUygmCIfD790/kVbiGmUgfYGuB14PiTd5DwVxSV4NcYHjzMkoj5LjQZwTQLEA== - mimos@4.x.x: version "4.0.0" resolved "https://registry.yarnpkg.com/mimos/-/mimos-4.0.0.tgz#76e3d27128431cb6482fd15b20475719ad626a5a" @@ -20827,19 +20685,6 @@ move-concurrently@^1.0.1: rimraf "^2.5.4" run-queue "^1.0.3" -ms-chromium-edge-driver@^0.2.0: - version "0.2.0" - resolved "https://registry.yarnpkg.com/ms-chromium-edge-driver/-/ms-chromium-edge-driver-0.2.0.tgz#0e0c6fd9fd1d1d36db97b2b3d7e9d4ba4d2de456" - integrity sha512-RkDsBPnMLjRna7q4LlvtLb+CHPei9gZapnlxm3ayWKk3Ab6HmDsz/17xG2eyqkKX5UcKeo04YlLZ345tO7OolA== - dependencies: - extract-zip "^1.6.7" - got "^10.6.0" - lodash "4.17.15" - tslint "^6.1.0" - tslint-config-prettier "^1.18.0" - util "^0.12.2" - windows-registry "^0.1.5" - ms@2.0.0: version "2.0.0" resolved "https://registry.yarnpkg.com/ms/-/ms-2.0.0.tgz#5608aeadfc00be6c2901df5f9861788de0d597c8" @@ -20952,7 +20797,7 @@ mute-stream@0.0.8: resolved "https://registry.yarnpkg.com/mute-stream/-/mute-stream-0.0.8.tgz#1630c42b2251ff81e2a283de96a5497ea92e5e0d" integrity sha512-nnbWWOkoWyUsTjKrhgD0dcz22mdkSnpYqbEjIm2nhwhuxlSkpywJmBo8h0ZqJdkp73mb90SssHkN4rsRaBAfAA== -nan@2, nan@^2.12.1, nan@^2.13.2: +nan@^2.12.1, nan@^2.13.2: version "2.14.0" resolved "https://registry.yarnpkg.com/nan/-/nan-2.14.0.tgz#7818f722027b2459a86f0295d434d1fc2336c52c" integrity sha512-INOFj37C7k3AfaNTtX8RhsTw7qRy7eLET14cROi9+5HAVbbHuIWUHEauBv5qT4Av2tWasiTY1Jw6puUNqRJXQg== @@ -21462,11 +21307,6 @@ normalize-url@^3.3.0: resolved "https://registry.yarnpkg.com/normalize-url/-/normalize-url-3.3.0.tgz#b2e1c4dc4f7c6d57743df733a4f5978d18650559" integrity sha512-U+JJi7duF1o+u2pynbp2zXDW2/PADgC30f0GsHZtRh+HOcXHnw137TrNlyxxRvWW5fjKd3bcLHPxofWuCjaeZg== -normalize-url@^4.1.0: - version "4.5.0" - resolved "https://registry.yarnpkg.com/normalize-url/-/normalize-url-4.5.0.tgz#453354087e6ca96957bd8f5baf753f5982142129" - integrity sha512-2s47yzUxdexf1OhyRi4Em83iQk0aPvwTddtFz4hnSSw9dCEsLEGf6SwIO8ss/19S9iBb5sJaOuTvTGDeZI00BQ== - now-and-later@^2.0.0: version "2.0.0" resolved "https://registry.yarnpkg.com/now-and-later/-/now-and-later-2.0.0.tgz#bc61cbb456d79cb32207ce47ca05136ff2e7d6ee" @@ -22153,11 +21993,6 @@ p-cancelable@^0.4.0: resolved "https://registry.yarnpkg.com/p-cancelable/-/p-cancelable-0.4.1.tgz#35f363d67d52081c8d9585e37bcceb7e0bbcb2a0" integrity sha512-HNa1A8LvB1kie7cERyy21VNeHb2CWJJYqyyC2o3klWFfMGlFmWv2Z7sFgZH8ZiaYL95ydToKTFVXgMV/Os0bBQ== -p-cancelable@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/p-cancelable/-/p-cancelable-2.0.0.tgz#4a3740f5bdaf5ed5d7c3e34882c6fb5d6b266a6e" - integrity sha512-wvPXDmbMmu2ksjkB4Z3nZWTSkJEb9lqVdMaCKpZUGJG9TMiNp9XcbG3fn9fPKjem04fJMJnXoyFPk2FmgiaiNg== - p-defer@^1.0.0: version "1.0.0" resolved "https://registry.yarnpkg.com/p-defer/-/p-defer-1.0.0.tgz#9f6eb182f6c9aa8cd743004a7d4f96b196b0fb0c" @@ -22170,7 +22005,7 @@ p-each-series@^1.0.0: dependencies: p-reduce "^1.0.0" -p-event@^4.0.0, p-event@^4.1.0: +p-event@^4.1.0: version "4.1.0" resolved "https://registry.yarnpkg.com/p-event/-/p-event-4.1.0.tgz#e92bb866d7e8e5b732293b1c8269d38e9982bf8e" integrity sha512-4vAd06GCsgflX4wHN1JqrMzBh/8QZ4j+rzp0cd2scXRwuBEv+QR3wrVA5aLhWDLw4y2WgDKvzWF3CCLmVM1UgA== @@ -25226,31 +25061,6 @@ redux@^4.0.5: loose-envify "^1.4.0" symbol-observable "^1.2.0" -ref-struct@1, ref-struct@^1.0.2: - version "1.1.0" - resolved "https://registry.yarnpkg.com/ref-struct/-/ref-struct-1.1.0.tgz#5d5ee65ad41cefc3a5c5feb40587261e479edc13" - integrity sha1-XV7mWtQc78Olxf60BYcmHkee3BM= - dependencies: - debug "2" - ref "1" - -ref-union@^1.0.0: - version "1.0.1" - resolved "https://registry.yarnpkg.com/ref-union/-/ref-union-1.0.1.tgz#3a2397f862f1e75171d687268f43b3f17729f120" - integrity sha1-OiOX+GLx51Fx1ocmj0Oz8Xcp8SA= - dependencies: - debug "2" - ref "1" - -ref@1, ref@^1.2.0: - version "1.3.5" - resolved "https://registry.yarnpkg.com/ref/-/ref-1.3.5.tgz#0e33f080cdb94a3d95312b2b3b1fd0f82044ca0f" - integrity sha512-2cBCniTtxcGUjDpvFfVpw323a83/0RLSGJJY5l5lcomZWhYpU2cuLdsvYqMixvsdLJ9+sTdzEkju8J8ZHDM2nA== - dependencies: - bindings "1" - debug "2" - nan "2" - reflect.ownkeys@^0.2.0: version "0.2.0" resolved "https://registry.yarnpkg.com/reflect.ownkeys/-/reflect.ownkeys-0.2.0.tgz#749aceec7f3fdf8b63f927a04809e90c5c0b3460" @@ -25990,13 +25800,6 @@ responselike@1.0.2: dependencies: lowercase-keys "^1.0.0" -responselike@^2.0.0: - version "2.0.0" - resolved "https://registry.yarnpkg.com/responselike/-/responselike-2.0.0.tgz#26391bcc3174f750f9a79eacc40a12a5c42d7723" - integrity sha512-xH48u3FTB9VsZw7R+vvgaKeLKzT6jOogbQhEe/jewwnZgzPcnyWui2Av6JpoYZF/91uueC+lqhWqeURw5/qhCw== - dependencies: - lowercase-keys "^2.0.0" - restore-cursor@^1.0.1: version "1.0.1" resolved "https://registry.yarnpkg.com/restore-cursor/-/restore-cursor-1.0.1.tgz#34661f46886327fed2991479152252df92daa541" @@ -26555,14 +26358,15 @@ select@^1.1.2: resolved "https://registry.yarnpkg.com/select/-/select-1.1.2.tgz#0e7350acdec80b1108528786ec1d4418d11b396d" integrity sha1-DnNQrN7ICxEIUoeG7B1EGNEbOW0= -selenium-webdriver@^4.0.0-alpha.7: - version "4.0.0-alpha.7" - resolved "https://registry.yarnpkg.com/selenium-webdriver/-/selenium-webdriver-4.0.0-alpha.7.tgz#e3879d8457fd7ad8e4424094b7dc0540d99e6797" - integrity sha512-D4qnTsyTr91jT8f7MfN+OwY0IlU5+5FmlO5xlgRUV6hDEV8JyYx2NerdTEqDDkNq7RZDYc4VoPALk8l578RBHw== +selenium-webdriver@^4.0.0-alpha.5: + version "4.0.0-alpha.5" + resolved "https://registry.yarnpkg.com/selenium-webdriver/-/selenium-webdriver-4.0.0-alpha.5.tgz#e4683b3dbf827d70df09a7e43bf02ebad20fa7c1" + integrity sha512-hktl3DSrhzM59yLhWzDGHIX9o56DvA+cVK7Dw6FcJR6qQ4CGzkaHeXQPcdrslkWMTeq0Ci9AmCxq0EMOvm2Rkg== dependencies: - jszip "^3.2.2" - rimraf "^2.7.1" + jszip "^3.1.5" + rimraf "^2.6.3" tmp "0.0.30" + xml2js "^0.4.19" selfsigned@^1.10.7: version "1.10.7" @@ -28962,11 +28766,6 @@ to-object-path@^0.3.0: dependencies: kind-of "^3.0.2" -to-readable-stream@^2.0.0: - version "2.1.0" - resolved "https://registry.yarnpkg.com/to-readable-stream/-/to-readable-stream-2.1.0.tgz#82880316121bea662cdc226adb30addb50cb06e8" - integrity sha512-o3Qa6DGg1CEXshSdvWNX2sN4QHqg03SPq7U6jPXRahlQdl5dK8oXjkU/2/sGrnOZKeGV1zLSO8qPwyKklPPE7w== - to-regex-range@^2.1.0: version "2.1.1" resolved "https://registry.yarnpkg.com/to-regex-range/-/to-regex-range-2.1.1.tgz#7c80c17b9dfebe599e27367e0d4dd5590141db38" @@ -29246,37 +29045,6 @@ tslib@^1.8.1, tslib@^1.9.0, tslib@^1.9.2, tslib@^1.9.3: resolved "https://registry.yarnpkg.com/tslib/-/tslib-1.9.3.tgz#d7e4dd79245d85428c4d7e4822a79917954ca286" integrity sha512-4krF8scpejhaOgqzBEcGM7yDIEfi0/8+8zDRZhNZZ2kjmHJ4hv3zCbQWxoJGz1iw5U0Jl0nma13xzHXcncMavQ== -tslint-config-prettier@^1.18.0: - version "1.18.0" - resolved "https://registry.yarnpkg.com/tslint-config-prettier/-/tslint-config-prettier-1.18.0.tgz#75f140bde947d35d8f0d238e0ebf809d64592c37" - integrity sha512-xPw9PgNPLG3iKRxmK7DWr+Ea/SzrvfHtjFt5LBl61gk2UBG/DB9kCXRjv+xyIU1rUtnayLeMUVJBcMX8Z17nDg== - -tslint@^6.1.0: - version "6.1.0" - resolved "https://registry.yarnpkg.com/tslint/-/tslint-6.1.0.tgz#c6c611b8ba0eed1549bf5a59ba05a7732133d851" - integrity sha512-fXjYd/61vU6da04E505OZQGb2VCN2Mq3doeWcOIryuG+eqdmFUXTYVwdhnbEu2k46LNLgUYt9bI5icQze/j0bQ== - dependencies: - "@babel/code-frame" "^7.0.0" - builtin-modules "^1.1.1" - chalk "^2.3.0" - commander "^2.12.1" - diff "^4.0.1" - glob "^7.1.1" - js-yaml "^3.13.1" - minimatch "^3.0.4" - mkdirp "^0.5.1" - resolve "^1.3.2" - semver "^5.3.0" - tslib "^1.10.0" - tsutils "^2.29.0" - -tsutils@^2.29.0: - version "2.29.0" - resolved "https://registry.yarnpkg.com/tsutils/-/tsutils-2.29.0.tgz#32b488501467acbedd4b85498673a0812aca0b99" - integrity sha512-g5JVHCIJwzfISaXpXE1qvNalca5Jwob6FjI4AoPlqMusJ6ftFE7IkkFoMhVLRgK+4Kx3gkzb8UZK5t5yTTvEmA== - dependencies: - tslib "^1.8.1" - tsutils@^3.17.1: version "3.17.1" resolved "https://registry.yarnpkg.com/tsutils/-/tsutils-3.17.1.tgz#ed719917f11ca0dee586272b2ac49e015a2dd759" @@ -29781,11 +29549,6 @@ type-detect@^1.0.0: resolved "https://registry.yarnpkg.com/type-detect/-/type-detect-1.0.0.tgz#762217cc06db258ec48908a1298e8b95121e8ea2" integrity sha1-diIXzAbbJY7EiQihKY6LlRIejqI= -type-fest@^0.10.0: - version "0.10.0" - resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.10.0.tgz#7f06b2b9fbfc581068d1341ffabd0349ceafc642" - integrity sha512-EUV9jo4sffrwlg8s0zDhP0T2WD3pru5Xi0+HTE3zTUmBaZNhfkite9PdSJwdXLwPVW0jnAHT56pZHIOYckPEiw== - type-fest@^0.3.0, type-fest@^0.3.1: version "0.3.1" resolved "https://registry.yarnpkg.com/type-fest/-/type-fest-0.3.1.tgz#63d00d204e059474fe5e1b7c011112bbd1dc29e1" @@ -30483,16 +30246,6 @@ util@^0.11.0: dependencies: inherits "2.0.3" -util@^0.12.2: - version "0.12.2" - resolved "https://registry.yarnpkg.com/util/-/util-0.12.2.tgz#54adb634c9e7c748707af2bf5a8c7ab640cbba2b" - integrity sha512-XE+MkWQvglYa+IOfBt5UFG93EmncEMP23UqpgDvVZVFBPxwmkK10QRp6pgU4xICPnWRf/t0zPv4noYSUq9gqUQ== - dependencies: - inherits "^2.0.3" - is-arguments "^1.0.4" - is-generator-function "^1.0.7" - safe-buffer "^5.1.2" - utila@^0.4.0, utila@~0.4: version "0.4.0" resolved "https://registry.yarnpkg.com/utila/-/utila-0.4.0.tgz#8a16a05d445657a3aea5eecc5b12a4fa5379772c" @@ -31654,17 +31407,6 @@ window-size@^0.2.0: resolved "https://registry.yarnpkg.com/window-size/-/window-size-0.2.0.tgz#b4315bb4214a3d7058ebeee892e13fa24d98b075" integrity sha1-tDFbtCFKPXBY6+7okuE/ok2YsHU= -windows-registry@^0.1.5: - version "0.1.5" - resolved "https://registry.yarnpkg.com/windows-registry/-/windows-registry-0.1.5.tgz#92c25c960884b0d215e69395f52d8dfaa0ba4ad0" - integrity sha512-gMN3ets1fbdP+TApEbbX2TIfBK3MIH5+p9GMvIFS3CNLr7U0Khe5mRj/T5zvwo/pKdhJgDrCLYyaNSs7HYiBCw== - dependencies: - debug "^2.2.0" - ffi "^2.0.0" - ref "^1.2.0" - ref-struct "^1.0.2" - ref-union "^1.0.0" - windows-release@^3.1.0: version "3.2.0" resolved "https://registry.yarnpkg.com/windows-release/-/windows-release-3.2.0.tgz#8122dad5afc303d833422380680a79cdfa91785f" @@ -31973,6 +31715,14 @@ xml-parse-from-string@^1.0.0: resolved "https://registry.yarnpkg.com/xml-parse-from-string/-/xml-parse-from-string-1.0.1.tgz#a9029e929d3dbcded169f3c6e28238d95a5d5a28" integrity sha1-qQKekp09vN7RafPG4oI42VpdWig= +xml2js@^0.4.19, xml2js@^0.4.5: + version "0.4.19" + resolved "https://registry.yarnpkg.com/xml2js/-/xml2js-0.4.19.tgz#686c20f213209e94abf0d1bcf1efaa291c7827a7" + integrity sha512-esZnJZJOiJR9wWKMyuvSE1y6Dq5LCuJanqhxslH2bxM6duahNZ+HMpCLhBQGZkbX6xRf8x1Y2eJlgt2q3qo49Q== + dependencies: + sax ">=0.6.0" + xmlbuilder "~9.0.1" + xml2js@^0.4.22: version "0.4.22" resolved "https://registry.yarnpkg.com/xml2js/-/xml2js-0.4.22.tgz#4fa2d846ec803237de86f30aa9b5f70b6600de02" @@ -31982,14 +31732,6 @@ xml2js@^0.4.22: util.promisify "~1.0.0" xmlbuilder "~11.0.0" -xml2js@^0.4.5: - version "0.4.19" - resolved "https://registry.yarnpkg.com/xml2js/-/xml2js-0.4.19.tgz#686c20f213209e94abf0d1bcf1efaa291c7827a7" - integrity sha512-esZnJZJOiJR9wWKMyuvSE1y6Dq5LCuJanqhxslH2bxM6duahNZ+HMpCLhBQGZkbX6xRf8x1Y2eJlgt2q3qo49Q== - dependencies: - sax ">=0.6.0" - xmlbuilder "~9.0.1" - xml@^1.0.0: version "1.0.1" resolved "https://registry.yarnpkg.com/xml/-/xml-1.0.1.tgz#78ba72020029c5bc87b8a81a3cfcd74b4a2fc1e5" From 040e7b464edfe58de4612278fbb33f21a99c62d1 Mon Sep 17 00:00:00 2001 From: Larry Gregory <larry.gregory@elastic.co> Date: Tue, 14 Apr 2020 07:33:14 -0400 Subject: [PATCH 085/102] Adjust API authorization logging (#63350) --- .../security/server/authorization/api_authorization.ts | 5 ++--- 1 file changed, 2 insertions(+), 3 deletions(-) diff --git a/x-pack/plugins/security/server/authorization/api_authorization.ts b/x-pack/plugins/security/server/authorization/api_authorization.ts index cc672fbc69e06..88b3f2c6f7155 100644 --- a/x-pack/plugins/security/server/authorization/api_authorization.ts +++ b/x-pack/plugins/security/server/authorization/api_authorization.ts @@ -24,7 +24,6 @@ export function initAPIAuthorization( // if there are no tags starting with "access:", just continue if (actionTags.length === 0) { - logger.debug('API endpoint is not marked with "access:" tags, skipping.'); return toolkit.next(); } @@ -34,11 +33,11 @@ export function initAPIAuthorization( // we've actually authorized the request if (checkPrivilegesResponse.hasAllRequested) { - logger.debug(`authorized for "${request.url.path}"`); + logger.debug(`User authorized for "${request.url.path}"`); return toolkit.next(); } - logger.debug(`not authorized for "${request.url.path}"`); + logger.warn(`User not authorized for "${request.url.path}": responding with 404`); return response.notFound(); }); } From 1a6398b983ee3645b175009f150c92dc1a8b70cd Mon Sep 17 00:00:00 2001 From: Sandra Gonzales <neptunian@users.noreply.github.com> Date: Tue, 14 Apr 2020 07:56:24 -0400 Subject: [PATCH 086/102] [EPM] add/remove package in package settings page (#63389) * fix bug where assets were not being returned, use archive info for assets * add settings page, add install/remove button and text * check existence of datasources associated with this package * add package title variable to text * update modal text and rename to uninstall --- .../ingest_manager/common/types/models/epm.ts | 2 +- .../common/types/rest_spec/datasource.ts | 15 ++- .../hooks/use_request/datasource.ts | 12 +- .../sections/epm/hooks/index.tsx | 2 +- .../epm/hooks/use_package_install.tsx | 101 +++++++++------ .../screens/detail/confirm_package_delete.tsx | 32 ----- .../detail/confirm_package_install.tsx | 41 +++++- .../detail/confirm_package_uninstall.tsx | 73 +++++++++++ .../sections/epm/screens/detail/content.tsx | 5 +- .../screens/detail/installation_button.tsx | 83 ++++++++---- .../epm/screens/detail/settings_panel.tsx | 118 ++++++++++++++++++ .../epm/screens/detail/side_nav_links.tsx | 1 + .../server/services/epm/packages/get.ts | 4 +- 13 files changed, 381 insertions(+), 108 deletions(-) delete mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_delete.tsx create mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_uninstall.tsx create mode 100644 x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/settings_panel.tsx diff --git a/x-pack/plugins/ingest_manager/common/types/models/epm.ts b/x-pack/plugins/ingest_manager/common/types/models/epm.ts index 5524e7505d74b..064341c68a97a 100644 --- a/x-pack/plugins/ingest_manager/common/types/models/epm.ts +++ b/x-pack/plugins/ingest_manager/common/types/models/epm.ts @@ -19,7 +19,7 @@ export enum InstallStatus { uninstalling = 'uninstalling', } -export type DetailViewPanelName = 'overview' | 'data-sources'; +export type DetailViewPanelName = 'overview' | 'data-sources' | 'settings'; export type ServiceName = 'kibana' | 'elasticsearch'; export type AssetType = KibanaAssetType | ElasticsearchAssetType | AgentAssetType; diff --git a/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts b/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts index f630602503f0a..66f734b904cfc 100644 --- a/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts +++ b/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts @@ -4,10 +4,13 @@ * you may not use this file except in compliance with the Elastic License. */ import { Datasource, NewDatasource } from '../models'; -import { ListWithKuery } from './common'; export interface GetDatasourcesRequest { - query: ListWithKuery; + query: { + page: number; + perPage: number; + kuery?: string; + }; } export interface GetOneDatasourceRequest { @@ -16,6 +19,14 @@ export interface GetOneDatasourceRequest { }; } +export interface GetDatasourcesResponse { + items: Datasource[]; + total: number; + page: number; + perPage: number; + success: boolean; +} + export interface CreateDatasourceRequest { body: NewDatasource; } diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/hooks/use_request/datasource.ts b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/hooks/use_request/datasource.ts index d0072f0355993..0d19ecd0cb735 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/hooks/use_request/datasource.ts +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/hooks/use_request/datasource.ts @@ -3,12 +3,14 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ -import { sendRequest } from './use_request'; +import { sendRequest, useRequest } from './use_request'; import { datasourceRouteService } from '../../services'; import { CreateDatasourceRequest, CreateDatasourceResponse } from '../../types'; import { DeleteDatasourcesRequest, DeleteDatasourcesResponse, + GetDatasourcesRequest, + GetDatasourcesResponse, } from '../../../../../common/types/rest_spec'; export const sendCreateDatasource = (body: CreateDatasourceRequest['body']) => { @@ -26,3 +28,11 @@ export const sendDeleteDatasource = (body: DeleteDatasourcesRequest['body']) => body: JSON.stringify(body), }); }; + +export function useGetDatasources(query: GetDatasourcesRequest['query']) { + return useRequest<GetDatasourcesResponse>({ + method: 'get', + path: datasourceRouteService.getListPath(), + query, + }); +} diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/index.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/index.tsx index 48986481b6061..fbc00fbadcfaa 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/index.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/index.tsx @@ -7,7 +7,7 @@ export { useLinks } from './use_links'; export { useLocalSearch, searchIdField } from './use_local_search'; export { PackageInstallProvider, - useDeletePackage, + useUninstallPackage, useGetPackageInstallStatus, useInstallPackage, useSetPackageInstallStatus, diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/use_package_install.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/use_package_install.tsx index 537a2616f1786..0c5f45cdc47a7 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/use_package_install.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/hooks/use_package_install.tsx @@ -6,8 +6,8 @@ import createContainer from 'constate'; import React, { useCallback, useState } from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; import { NotificationsStart } from 'src/core/public'; -import { useLinks } from '.'; import { toMountPoint } from '../../../../../../../../../src/plugins/kibana_react/public'; import { PackageInfo } from '../../../types'; import { sendInstallPackage, sendRemovePackage } from '../../../hooks'; @@ -25,7 +25,6 @@ type InstallPackageProps = Pick<PackageInfo, 'name' | 'version' | 'title'>; function usePackageInstall({ notifications }: { notifications: NotificationsStart }) { const [packages, setPackage] = useState<PackagesInstall>({}); - const { toDetailView } = useLinks(); const setPackageInstallStatus = useCallback( ({ name, status }: { name: PackageInfo['name']; status: InstallStatus }) => { @@ -46,34 +45,43 @@ function usePackageInstall({ notifications }: { notifications: NotificationsStar if (res.error) { setPackageInstallStatus({ name, status: InstallStatus.notInstalled }); notifications.toasts.addWarning({ - title: `Failed to install ${title} package`, - text: - 'Something went wrong while trying to install this package. Please try again later.', + title: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageInstallErrorTitle" + defaultMessage="Failed to install {title} package" + values={{ title }} + /> + ), + text: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageInstallErrorDescription" + defaultMessage="Something went wrong while trying to install this package. Please try again later." + /> + ), iconType: 'alert', }); } else { setPackageInstallStatus({ name, status: InstallStatus.installed }); - const SuccessMsg = <p>Successfully installed {name}</p>; notifications.toasts.addSuccess({ - title: `Installed ${title} package`, - text: toMountPoint(SuccessMsg), + title: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageInstallSuccessTitle" + defaultMessage="Installed {title}" + values={{ title }} + /> + ), + text: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageInstallSuccessDescription" + defaultMessage="Successfully installed {title}" + values={{ title }} + /> + ), }); - - // TODO: this should probably live somewhere else and use <Redirect />, - // this hook could return the request state and a component could - // use that state. the component should be able to unsubscribe to prevent memory leaks - const packageUrl = toDetailView({ name, version }); - const dataSourcesUrl = toDetailView({ - name, - version, - panel: 'data-sources', - withAppRoot: false, - }); - if (window.location.href.includes(packageUrl)) window.location.hash = dataSourcesUrl; } }, - [notifications.toasts, setPackageInstallStatus, toDetailView] + [notifications.toasts, setPackageInstallStatus] ); const getPackageInstallStatus = useCallback( @@ -83,7 +91,7 @@ function usePackageInstall({ notifications }: { notifications: NotificationsStar [packages] ); - const deletePackage = useCallback( + const uninstallPackage = useCallback( async ({ name, version, title }: Pick<PackageInfo, 'name' | 'version' | 'title'>) => { setPackageInstallStatus({ name, status: InstallStatus.uninstalling }); const pkgkey = `${name}-${version}`; @@ -92,30 +100,43 @@ function usePackageInstall({ notifications }: { notifications: NotificationsStar if (res.error) { setPackageInstallStatus({ name, status: InstallStatus.installed }); notifications.toasts.addWarning({ - title: `Failed to delete ${title} package`, - text: 'Something went wrong while trying to delete this package. Please try again later.', + title: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageUninstallErrorTitle" + defaultMessage="Failed to uninstall {title} package" + values={{ title }} + /> + ), + text: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageUninstallErrorDescription" + defaultMessage="Something went wrong while trying to uninstall this package. Please try again later." + /> + ), iconType: 'alert', }); } else { setPackageInstallStatus({ name, status: InstallStatus.notInstalled }); - const SuccessMsg = <p>Successfully deleted {title}</p>; - notifications.toasts.addSuccess({ - title: `Deleted ${title} package`, - text: toMountPoint(SuccessMsg), - }); - - const packageUrl = toDetailView({ name, version }); - const dataSourcesUrl = toDetailView({ - name, - version, - panel: 'data-sources', + title: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageUninstallSuccessTitle" + defaultMessage="Uninstalled {title}" + values={{ title }} + /> + ), + text: toMountPoint( + <FormattedMessage + id="xpack.ingestManager.integrations.packageUninstallSuccessDescription" + defaultMessage="Successfully uninstalled {title}" + values={{ title }} + /> + ), }); - if (window.location.href.includes(packageUrl)) window.location.href = dataSourcesUrl; } }, - [notifications.toasts, setPackageInstallStatus, toDetailView] + [notifications.toasts, setPackageInstallStatus] ); return { @@ -123,7 +144,7 @@ function usePackageInstall({ notifications }: { notifications: NotificationsStar installPackage, setPackageInstallStatus, getPackageInstallStatus, - deletePackage, + uninstallPackage, }; } @@ -132,11 +153,11 @@ export const [ useInstallPackage, useSetPackageInstallStatus, useGetPackageInstallStatus, - useDeletePackage, + useUninstallPackage, ] = createContainer( usePackageInstall, value => value.installPackage, value => value.setPackageInstallStatus, value => value.getPackageInstallStatus, - value => value.deletePackage + value => value.uninstallPackage ); diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_delete.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_delete.tsx deleted file mode 100644 index 2b3be04ac476b..0000000000000 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_delete.tsx +++ /dev/null @@ -1,32 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import { EuiCallOut, EuiConfirmModal, EuiOverlayMask } from '@elastic/eui'; -import React from 'react'; - -interface ConfirmPackageDeleteProps { - onCancel: () => void; - onConfirm: () => void; - packageName: string; - numOfAssets: number; -} -export const ConfirmPackageDelete = (props: ConfirmPackageDeleteProps) => { - const { onCancel, onConfirm, packageName, numOfAssets } = props; - return ( - <EuiOverlayMask> - <EuiConfirmModal - title={`Delete ${packageName}?`} - onCancel={onCancel} - onConfirm={onConfirm} - cancelButtonText="Cancel" - confirmButtonText="Delete package" - defaultFocusedButton="confirm" - buttonColor="danger" - > - <EuiCallOut title={`This package will delete ${numOfAssets} assets.`} color="danger" /> - </EuiConfirmModal> - </EuiOverlayMask> - ); -}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_install.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_install.tsx index 137d9cf226b4d..ac30815a941ee 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_install.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_install.tsx @@ -5,6 +5,7 @@ */ import { EuiCallOut, EuiConfirmModal, EuiOverlayMask, EuiSpacer } from '@elastic/eui'; import React from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; interface ConfirmPackageInstallProps { onCancel: () => void; @@ -17,18 +18,46 @@ export const ConfirmPackageInstall = (props: ConfirmPackageInstallProps) => { return ( <EuiOverlayMask> <EuiConfirmModal - title={`Install ${packageName}?`} + title={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmInstallModal.installTitle" + defaultMessage="Install {packageName}" + values={{ packageName }} + /> + } onCancel={onCancel} onConfirm={onConfirm} - cancelButtonText="Cancel" - confirmButtonText="Install package" + cancelButtonText={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmInstallModal.cancelButtonLabel" + defaultMessage="Cancel" + /> + } + confirmButtonText={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmInstallModal.installButtonLabel" + defaultMessage="Install {packageName}" + values={{ packageName }} + /> + } defaultFocusedButton="confirm" > - <EuiCallOut title={`This package will install ${numOfAssets} assets.`} /> + <EuiCallOut + iconType="iInCircle" + title={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmInstallModal.installCalloutTitle" + defaultMessage="This action will install {numOfAssets} assets" + values={{ numOfAssets }} + /> + } + /> <EuiSpacer size="l" /> <p> - and will only be accessible to users who have permission to view this Space. Elasticsearch - assets are installed globally and will be accessible to all Kibana users. + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmInstallModal.installDescription" + defaultMessage="Kibana assets will be installed in the current Space (Default) and will only be accessible to users who have permission to view this Space. Elasticsearch assets are installed globally and will be accessible to all Kibana users." + /> </p> </EuiConfirmModal> </EuiOverlayMask> diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_uninstall.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_uninstall.tsx new file mode 100644 index 0000000000000..14b9bf77c3a00 --- /dev/null +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/confirm_package_uninstall.tsx @@ -0,0 +1,73 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { EuiCallOut, EuiConfirmModal, EuiOverlayMask, EuiSpacer } from '@elastic/eui'; +import React from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; + +interface ConfirmPackageUninstallProps { + onCancel: () => void; + onConfirm: () => void; + packageName: string; + numOfAssets: number; +} +export const ConfirmPackageUninstall = (props: ConfirmPackageUninstallProps) => { + const { onCancel, onConfirm, packageName, numOfAssets } = props; + return ( + <EuiOverlayMask> + <EuiConfirmModal + title={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmUninstallModal.uninstallTitle" + defaultMessage="Uninstall {packageName}" + values={{ packageName }} + /> + } + onCancel={onCancel} + onConfirm={onConfirm} + cancelButtonText={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmUninstallModal.cancelButtonLabel" + defaultMessage="Cancel" + /> + } + confirmButtonText={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmUninstallModal.uninstallButtonLabel" + defaultMessage="Uninstall {packageName}" + values={{ packageName }} + /> + } + defaultFocusedButton="confirm" + buttonColor="danger" + > + <EuiCallOut + color="danger" + title={ + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmUninstallModal.uninstallCallout.title" + defaultMessage="This action will remove {numOfAssets} assets" + values={{ numOfAssets }} + /> + } + > + <p> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmUninstallModal.uninstallCallout.description" + defaultMessage="Kibana and Elasticsearch assets that were created by this Integration will be removed. Agents configurations and any data sent by your agents will not be effected." + /> + </p> + </EuiCallOut> + <EuiSpacer size="l" /> + <p> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.confirmUninstallModal.uninstallDescription" + defaultMessage="This action cannot be undone. Are you sure you wish to continue?" + /> + </p> + </EuiConfirmModal> + </EuiOverlayMask> + ); +}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/content.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/content.tsx index 384cbbeed378e..0d4b395895322 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/content.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/content.tsx @@ -15,6 +15,7 @@ import { CenterColumn, LeftColumn, RightColumn } from './layout'; import { OverviewPanel } from './overview_panel'; import { SideNavLinks } from './side_nav_links'; import { DataSourcesPanel } from './data_sources_panel'; +import { SettingsPanel } from './settings_panel'; type ContentProps = PackageInfo & Pick<DetailParams, 'panel'> & { hasIconPanel: boolean }; export function Content(props: ContentProps) { @@ -49,8 +50,10 @@ export function Content(props: ContentProps) { type ContentPanelProps = PackageInfo & Pick<DetailParams, 'panel'>; export function ContentPanel(props: ContentPanelProps) { - const { panel, name, version } = props; + const { panel, name, version, assets, title } = props; switch (panel) { + case 'settings': + return <SettingsPanel name={name} version={version} assets={assets} title={title} />; case 'data-sources': return <DataSourcesPanel name={name} version={version} />; case 'overview': diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/installation_button.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/installation_button.tsx index 8a8afed5570ed..cbbf1ce53c4ea 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/installation_button.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/installation_button.tsx @@ -5,21 +5,21 @@ */ import { EuiButton } from '@elastic/eui'; import React, { Fragment, useCallback, useMemo, useState } from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; import { PackageInfo, InstallStatus } from '../../../../types'; import { useCapabilities } from '../../../../hooks'; -import { useDeletePackage, useGetPackageInstallStatus, useInstallPackage } from '../../hooks'; -import { ConfirmPackageDelete } from './confirm_package_delete'; +import { useUninstallPackage, useGetPackageInstallStatus, useInstallPackage } from '../../hooks'; +import { ConfirmPackageUninstall } from './confirm_package_uninstall'; import { ConfirmPackageInstall } from './confirm_package_install'; -interface InstallationButtonProps { - package: PackageInfo; -} - +type InstallationButtonProps = Pick<PackageInfo, 'assets' | 'name' | 'title' | 'version'> & { + disabled: boolean; +}; export function InstallationButton(props: InstallationButtonProps) { - const { assets, name, title, version } = props.package; + const { assets, name, title, version, disabled = true } = props; const hasWriteCapabilites = useCapabilities().write; const installPackage = useInstallPackage(); - const deletePackage = useDeletePackage(); + const uninstallPackage = useUninstallPackage(); const getPackageInstallStatus = useGetPackageInstallStatus(); const installationStatus = getPackageInstallStatus(name); @@ -36,11 +36,12 @@ export function InstallationButton(props: InstallationButtonProps) { toggleModal(); }, [installPackage, name, title, toggleModal, version]); - const handleClickDelete = useCallback(() => { - deletePackage({ name, version, title }); + const handleClickUninstall = useCallback(() => { + uninstallPackage({ name, version, title }); toggleModal(); - }, [deletePackage, name, title, toggleModal, version]); + }, [uninstallPackage, name, title, toggleModal, version]); + // counts the number of assets in the package const numOfAssets = useMemo( () => Object.entries(assets).reduce( @@ -56,30 +57,68 @@ export function InstallationButton(props: InstallationButtonProps) { ); const installButton = ( - <EuiButton isLoading={isInstalling} fill={true} onClick={toggleModal}> - {isInstalling ? 'Installing' : 'Install package'} + <EuiButton iconType={'importAction'} isLoading={isInstalling} onClick={toggleModal}> + {isInstalling ? ( + <FormattedMessage + id="xpack.ingestManager.integrations.installPackage.installingPackageButtonLabel" + defaultMessage="Installing {title} assets" + values={{ + title, + }} + /> + ) : ( + <FormattedMessage + id="xpack.ingestManager.integrations.installPackage.installPackageButtonLabel" + defaultMessage="Install {title} assets" + values={{ + title, + }} + /> + )} </EuiButton> ); - const installedButton = ( - <EuiButton isLoading={isRemoving} fill={true} onClick={toggleModal} color="danger"> - {isInstalling ? 'Deleting' : 'Delete package'} + const uninstallButton = ( + <EuiButton + iconType={'trash'} + isLoading={isRemoving} + onClick={toggleModal} + color="danger" + disabled={disabled || isRemoving ? true : false} + > + {isRemoving ? ( + <FormattedMessage + id="xpack.ingestManager.integrations.uninstallPackage.uninstallingPackageButtonLabel" + defaultMessage="Uninstalling {title}" + values={{ + title, + }} + /> + ) : ( + <FormattedMessage + id="xpack.ingestManager.integrations.uninstallPackage.uninstallPackageButtonLabel" + defaultMessage="Uninstall {title}" + values={{ + title, + }} + /> + )} </EuiButton> ); - const deletionModal = ( - <ConfirmPackageDelete + const uninstallModal = ( + <ConfirmPackageUninstall // this is number of which would be installed // deleted includes ingest-pipelines etc so could be larger // not sure how to do this at the moment so using same value numOfAssets={numOfAssets} packageName={title} onCancel={toggleModal} - onConfirm={handleClickDelete} + onConfirm={handleClickUninstall} /> ); - const installationModal = ( + const installModal = ( <ConfirmPackageInstall numOfAssets={numOfAssets} packageName={title} @@ -90,8 +129,8 @@ export function InstallationButton(props: InstallationButtonProps) { return hasWriteCapabilites ? ( <Fragment> - {isInstalled ? installedButton : installButton} - {isModalVisible && (isInstalled ? deletionModal : installationModal)} + {isInstalled || isRemoving ? uninstallButton : installButton} + {isModalVisible && (isInstalled ? uninstallModal : installModal)} </Fragment> ) : null; } diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/settings_panel.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/settings_panel.tsx new file mode 100644 index 0000000000000..ff7ecf97714b6 --- /dev/null +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/settings_panel.tsx @@ -0,0 +1,118 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React from 'react'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { EuiTitle, EuiFlexGroup, EuiFlexItem, EuiText } from '@elastic/eui'; +import { EuiSpacer } from '@elastic/eui'; +import { useGetPackageInstallStatus } from '../../hooks'; +import { InstallStatus, PackageInfo } from '../../../../types'; +import { InstallationButton } from './installation_button'; +import { useGetDatasources } from '../../../../hooks'; + +export const SettingsPanel = ( + props: Pick<PackageInfo, 'assets' | 'name' | 'title' | 'version'> +) => { + const getPackageInstallStatus = useGetPackageInstallStatus(); + const { data: datasourcesData } = useGetDatasources({ + perPage: 0, + page: 1, + kuery: `datasources.package.name:${props.name}`, + }); + const { name, title } = props; + const packageInstallStatus = getPackageInstallStatus(name); + const packageHasDatasources = !!datasourcesData?.total; + + return ( + <EuiText> + <EuiTitle> + <h3> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageSettingsTitle" + defaultMessage="Settings" + /> + </h3> + </EuiTitle> + <EuiSpacer size="s" /> + {packageInstallStatus === InstallStatus.notInstalled || + packageInstallStatus === InstallStatus.installing ? ( + <div> + <EuiTitle> + <h4> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageInstallTitle" + defaultMessage="Install {title}" + values={{ + title, + }} + /> + </h4> + </EuiTitle> + <EuiSpacer size="s" /> + <p> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageInstallDescription" + defaultMessage="Install this integration to setup Kibana and Elasticsearch assets designed for {title} data." + values={{ + title, + }} + /> + </p> + </div> + ) : ( + <div> + <EuiTitle> + <h4> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageUninstallTitle" + defaultMessage="Uninstall {title}" + values={{ + title, + }} + /> + </h4> + </EuiTitle> + <EuiSpacer size="s" /> + <p> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageUninstallDescription" + defaultMessage="Remove Kibana and Elasticsearch assets that were installed by this Integration." + /> + </p> + </div> + )} + <EuiFlexGroup> + <EuiFlexItem grow={false}> + <p> + <InstallationButton + {...props} + disabled={!datasourcesData ? true : packageHasDatasources} + /> + </p> + </EuiFlexItem> + </EuiFlexGroup> + {packageHasDatasources && ( + <p> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageUninstallNoteDescription.packageUninstallNoteDetail" + defaultMessage="{strongNote} {title} cannot be uninstalled because there are active agents that use this integration. To uninstall, remove all {title} data sources from your agent configurations." + values={{ + title, + strongNote: ( + <strong> + <FormattedMessage + id="xpack.ingestManager.integrations.settings.packageUninstallNoteDescription.packageUninstallNoteLabel" + defaultMessage="Note:" + /> + </strong> + ), + }} + /> + </p> + )} + </EuiText> + ); +}; diff --git a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/side_nav_links.tsx b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/side_nav_links.tsx index 39a6fca2e4318..05729ccfc1af4 100644 --- a/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/side_nav_links.tsx +++ b/x-pack/plugins/ingest_manager/public/applications/ingest_manager/sections/epm/screens/detail/side_nav_links.tsx @@ -17,6 +17,7 @@ export type NavLinkProps = Pick<PackageInfo, 'name' | 'version'> & { const PanelDisplayNames: Record<DetailViewPanelName, string> = { overview: 'Overview', 'data-sources': 'Data Sources', + settings: 'Settings', }; export function SideNavLinks({ name, version, active }: NavLinkProps) { diff --git a/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts b/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts index 0e2c2a3d26073..d76584225877c 100644 --- a/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts +++ b/x-pack/plugins/ingest_manager/server/services/epm/packages/get.ts @@ -67,7 +67,7 @@ export async function getPackageInfo(options: { pkgVersion: string; }): Promise<PackageInfo> { const { savedObjectsClient, pkgName, pkgVersion } = options; - const [item, savedObject] = await Promise.all([ + const [item, savedObject, assets] = await Promise.all([ Registry.fetchInfo(pkgName, pkgVersion), getInstallationObject({ savedObjectsClient, pkgName }), Registry.getArchiveInfo(pkgName, pkgVersion), @@ -80,7 +80,7 @@ export async function getPackageInfo(options: { const updated = { ...item, title: item.title || nameAsTitle(item.name), - assets: Registry.groupPathsByService(item?.assets || []), + assets: Registry.groupPathsByService(assets || []), }; return createInstallableFrom(updated, savedObject); } From 69ed664dd93a2825679a3d1ff920dd7ccc7823d4 Mon Sep 17 00:00:00 2001 From: Matthew Kime <matt@mattki.me> Date: Tue, 14 Apr 2020 06:58:56 -0500 Subject: [PATCH 087/102] Index Pattern Field class - factor out copy_field code for future typescripting (#63083) * Index Pattern Field class - factor out copy_field code for future typescripting --- ...n-plugins-data-public.indexpatternfield.md | 1 - ...ns-data-public.indexpatternfield.routes.md | 11 --- ...ugins-data-public.indexpatternfieldlist.md | 2 +- ...ata-public.indexpatternfieldlist.update.md | 2 +- .../create_edit_field/create_edit_field.js | 1 - .../edit_index_pattern/edit_index_pattern.js | 10 ++- .../indexed_fields_table.test.js.snap | 5 -- .../indexed_fields_table.js | 3 +- .../scripted_fields_table.tsx | 2 +- .../ui/public/field_editor/field_editor.js | 13 +-- .../lib/__tests__/copy_field.test.js | 48 ----------- .../ui/public/field_editor/lib/copy_field.js | 82 ------------------- .../ui/public/field_editor/lib/index.js | 1 - .../public/index_patterns/fields/field.ts | 7 -- .../index_patterns/fields/field_list.ts | 13 +-- src/plugins/data/public/public.api.md | 4 +- 16 files changed, 22 insertions(+), 183 deletions(-) delete mode 100644 docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.routes.md delete mode 100644 src/legacy/ui/public/field_editor/lib/__tests__/copy_field.test.js delete mode 100644 src/legacy/ui/public/field_editor/lib/copy_field.js diff --git a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.md b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.md index 430590c7a2505..121ae80734dfd 100644 --- a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.md +++ b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.md @@ -29,7 +29,6 @@ export declare class Field implements IFieldType | [format](./kibana-plugin-plugins-data-public.indexpatternfield.format.md) | | <code>any</code> | | | [lang](./kibana-plugin-plugins-data-public.indexpatternfield.lang.md) | | <code>string</code> | | | [name](./kibana-plugin-plugins-data-public.indexpatternfield.name.md) | | <code>string</code> | | -| [routes](./kibana-plugin-plugins-data-public.indexpatternfield.routes.md) | | <code>Record<string, string></code> | | | [script](./kibana-plugin-plugins-data-public.indexpatternfield.script.md) | | <code>string</code> | | | [scripted](./kibana-plugin-plugins-data-public.indexpatternfield.scripted.md) | | <code>boolean</code> | | | [searchable](./kibana-plugin-plugins-data-public.indexpatternfield.searchable.md) | | <code>boolean</code> | | diff --git a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.routes.md b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.routes.md deleted file mode 100644 index 664a7b7b7ca0e..0000000000000 --- a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfield.routes.md +++ /dev/null @@ -1,11 +0,0 @@ -<!-- Do not edit this file. It is automatically generated by API Documenter. --> - -[Home](./index.md) > [kibana-plugin-plugins-data-public](./kibana-plugin-plugins-data-public.md) > [IndexPatternField](./kibana-plugin-plugins-data-public.indexpatternfield.md) > [routes](./kibana-plugin-plugins-data-public.indexpatternfield.routes.md) - -## IndexPatternField.routes property - -<b>Signature:</b> - -```typescript -routes: Record<string, string>; -``` diff --git a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.md b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.md index 4b7184b7dc151..478b73f5f8581 100644 --- a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.md +++ b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.md @@ -24,5 +24,5 @@ export declare class FieldList extends Array<Field> implements IFieldList | [getByName](./kibana-plugin-plugins-data-public.indexpatternfieldlist.getbyname.md) | | <code>(name: string) => Field | undefined</code> | | | [getByType](./kibana-plugin-plugins-data-public.indexpatternfieldlist.getbytype.md) | | <code>(type: string) => any[]</code> | | | [remove](./kibana-plugin-plugins-data-public.indexpatternfieldlist.remove.md) | | <code>(field: IFieldType) => void</code> | | -| [update](./kibana-plugin-plugins-data-public.indexpatternfieldlist.update.md) | | <code>(field: Field) => void</code> | | +| [update](./kibana-plugin-plugins-data-public.indexpatternfieldlist.update.md) | | <code>(field: Record<string, any>) => void</code> | | diff --git a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.update.md b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.update.md index ca03ec4b72893..d5156ed41e493 100644 --- a/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.update.md +++ b/docs/development/plugins/data/public/kibana-plugin-plugins-data-public.indexpatternfieldlist.update.md @@ -7,5 +7,5 @@ <b>Signature:</b> ```typescript -update: (field: Field) => void; +update: (field: Record<string, any>) => void; ``` diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/create_edit_field/create_edit_field.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/create_edit_field/create_edit_field.js index 0dcf778a5a662..3569e9caf4e27 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/create_edit_field/create_edit_field.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/create_edit_field/create_edit_field.js @@ -53,7 +53,6 @@ const renderFieldEditor = ( indexPattern={indexPattern} field={field} helpers={{ - Field: IndexPatternField, getConfig, $http, fieldFormatEditors, diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/edit_index_pattern.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/edit_index_pattern.js index 594430ca01f4c..c65054f583ef2 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/edit_index_pattern.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/edit_index_pattern.js @@ -49,6 +49,8 @@ const TAB_INDEXED_FIELDS = 'indexedFields'; const TAB_SCRIPTED_FIELDS = 'scriptedFields'; const TAB_SOURCE_FILTERS = 'sourceFilters'; +const EDIT_FIELD_PATH = '/management/kibana/index_patterns/{{indexPattern.id}}/field/{{name}}'; + function updateSourceFiltersTable($scope) { $scope.$$postDigest(() => { const node = document.getElementById(REACT_SOURCE_FILTERS_DOM_ELEMENT_ID); @@ -97,8 +99,8 @@ function updateScriptedFieldsTable($scope) { fieldFilter={$scope.fieldFilter} scriptedFieldLanguageFilter={$scope.scriptedFieldLanguageFilter} helpers={{ - redirectToRoute: (obj, route) => { - $scope.kbnUrl.changeToRoute(obj, route); + redirectToRoute: field => { + $scope.kbnUrl.changePath(EDIT_FIELD_PATH, field); $scope.$apply(); }, getRouteHref: (obj, route) => $scope.kbnUrl.getRouteHref(obj, route), @@ -140,8 +142,8 @@ function updateIndexedFieldsTable($scope) { fieldWildcardMatcher={$scope.fieldWildcardMatcher} indexedFieldTypeFilter={$scope.indexedFieldTypeFilter} helpers={{ - redirectToRoute: (obj, route) => { - $scope.kbnUrl.changeToRoute(obj, route); + redirectToRoute: field => { + $scope.kbnUrl.changePath(EDIT_FIELD_PATH, field); $scope.$apply(); }, getFieldInfo: $scope.getFieldInfo, diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/__jest__/__snapshots__/indexed_fields_table.test.js.snap b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/__jest__/__snapshots__/indexed_fields_table.test.js.snap index dc77fe6c8a69d..b38036a0c2bf0 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/__jest__/__snapshots__/indexed_fields_table.test.js.snap +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/__jest__/__snapshots__/indexed_fields_table.test.js.snap @@ -18,7 +18,6 @@ exports[`IndexedFieldsTable should filter based on the query bar 1`] = ` "indexPattern": undefined, "info": undefined, "name": "Elastic", - "routes": undefined, "searchable": true, }, ] @@ -45,7 +44,6 @@ exports[`IndexedFieldsTable should filter based on the type filter 1`] = ` "indexPattern": undefined, "info": undefined, "name": "timestamp", - "routes": undefined, "type": "date", }, ] @@ -72,7 +70,6 @@ exports[`IndexedFieldsTable should render normally 1`] = ` "indexPattern": undefined, "info": undefined, "name": "Elastic", - "routes": undefined, "searchable": true, }, Object { @@ -82,7 +79,6 @@ exports[`IndexedFieldsTable should render normally 1`] = ` "indexPattern": undefined, "info": undefined, "name": "timestamp", - "routes": undefined, "type": "date", }, Object { @@ -92,7 +88,6 @@ exports[`IndexedFieldsTable should render normally 1`] = ` "indexPattern": undefined, "info": undefined, "name": "conflictingField", - "routes": undefined, "type": "conflict", }, ] diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/indexed_fields_table.js b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/indexed_fields_table.js index 652efbe98067f..074e5784f3dae 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/indexed_fields_table.js +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/indexed_fields_table/indexed_fields_table.js @@ -65,7 +65,6 @@ export class IndexedFieldsTable extends Component { return { ...field, displayName: field.displayName, - routes: field.routes, indexPattern: field.indexPattern, format: getFieldFormat(indexPattern, field.name), excluded: fieldWildcardMatch ? fieldWildcardMatch(field.name) : false, @@ -104,7 +103,7 @@ export class IndexedFieldsTable extends Component { <Table indexPattern={indexPattern} items={fields} - editField={field => this.props.helpers.redirectToRoute(field, 'edit')} + editField={field => this.props.helpers.redirectToRoute(field)} /> </div> ); diff --git a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx index ba044296a693a..e8dfbd6496057 100644 --- a/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx +++ b/src/legacy/core_plugins/kibana/public/management/sections/index_patterns/edit_index_pattern/scripted_fields_table/scripted_fields_table.tsx @@ -155,7 +155,7 @@ export class ScriptedFieldsTable extends Component< <Table indexPattern={indexPattern} items={items} - editField={field => this.props.helpers.redirectToRoute(field, 'edit')} + editField={field => this.props.helpers.redirectToRoute(field)} deleteField={this.startDeleteField} /> diff --git a/src/legacy/ui/public/field_editor/field_editor.js b/src/legacy/ui/public/field_editor/field_editor.js index 43461c4c689be..e90cb110ac304 100644 --- a/src/legacy/ui/public/field_editor/field_editor.js +++ b/src/legacy/ui/public/field_editor/field_editor.js @@ -66,7 +66,7 @@ import { ScriptingHelpFlyout } from './components/scripting_help'; import { FieldFormatEditor } from './components/field_format_editor'; import { FIELD_TYPES_BY_LANG, DEFAULT_FIELD_TYPES } from './constants'; -import { copyField, executeScript, isScriptValid } from './lib'; +import { executeScript, isScriptValid } from './lib'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; @@ -100,7 +100,6 @@ export class FieldEditor extends PureComponent { indexPattern: PropTypes.object.isRequired, field: PropTypes.object.isRequired, helpers: PropTypes.shape({ - Field: PropTypes.func.isRequired, getConfig: PropTypes.func.isRequired, $http: PropTypes.func.isRequired, fieldFormatEditors: PropTypes.object.isRequired, @@ -111,11 +110,7 @@ export class FieldEditor extends PureComponent { constructor(props) { super(props); - const { - field, - indexPattern, - helpers: { Field }, - } = props; + const { field, indexPattern } = props; this.state = { isReady: false, @@ -125,7 +120,7 @@ export class FieldEditor extends PureComponent { fieldTypes: [], fieldTypeFormats: [], existingFieldNames: indexPattern.fields.map(f => f.name), - field: copyField(field, indexPattern, Field), + field: { ...field, format: field.format }, fieldFormatId: undefined, fieldFormatParams: {}, showScriptingHelp: false, @@ -730,7 +725,7 @@ export class FieldEditor extends PureComponent { }; saveField = async () => { - const field = this.state.field.toActualField(); + const field = this.state.field; const { indexPattern } = this.props; const { fieldFormatId } = this.state; diff --git a/src/legacy/ui/public/field_editor/lib/__tests__/copy_field.test.js b/src/legacy/ui/public/field_editor/lib/__tests__/copy_field.test.js deleted file mode 100644 index 2cee45742ab81..0000000000000 --- a/src/legacy/ui/public/field_editor/lib/__tests__/copy_field.test.js +++ /dev/null @@ -1,48 +0,0 @@ -/* - * 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. - */ - -import { copyField } from '../copy_field'; - -const field = { - name: 'test_field', - scripted: true, - type: 'number', - lang: 'painless', -}; - -describe('copyField', () => { - it('should copy a field', () => { - const copiedField = copyField(field, {}, {}); - copiedField.name = 'test_name_change'; - - // Check that copied field has `toActualField()` method - expect(typeof copiedField.toActualField).toEqual('function'); - - // Check that we did not modify the original field object when - // modifying copied field - expect(field.toActualField).toEqual(undefined); - expect(field.name).toEqual('test_field'); - - expect(copiedField).not.toEqual(field); - expect(copiedField.name).toEqual('test_name_change'); - expect(copiedField.scripted).toEqual(field.scripted); - expect(copiedField.type).toEqual(field.type); - expect(copiedField.lang).toEqual(field.lang); - }); -}); diff --git a/src/legacy/ui/public/field_editor/lib/copy_field.js b/src/legacy/ui/public/field_editor/lib/copy_field.js deleted file mode 100644 index bfc1cb8480d5d..0000000000000 --- a/src/legacy/ui/public/field_editor/lib/copy_field.js +++ /dev/null @@ -1,82 +0,0 @@ -/* - * 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. - */ - -import { has } from 'lodash'; - -/** - * Fully clones a Field object, so that modifications can be performed on - * the copy without affecting original field. Field objects contain - * enumerable and non-eumerable properties that may or may not be writable. - * The function copies all properties as property descriptors into - * `newFieldProps`, overrides getter and setter, and returns a new object - * created from that. - * - * @param {object} field - Field object to copy - * @param {object} indexPattern - index pattern object the field belongs to - * @param {object} Field - Field object type - * @return {object} the cloned object - */ -export const copyField = (field, indexPattern, Field) => { - const changes = {}; - const newFieldProps = { - // When we are ready to save the copied field back into the index pattern, - // we use `toActualField()` to retrieve an actual `Field` type object, using - // its original properties with our "changes" applied. - toActualField: { - value: () => { - return new Field(indexPattern, { - ...field.$$spec, - ...changes, - }); - }, - }, - }; - - // Index pattern `Field` objects are created with custom property - // descriptors using `ObjDefine`. - // - // Each property of a `Field` type object could be enumerable/non-enumerable, - // writable/not writable, configurable/not configurable, and have custom - // getter and setter. We can't use the original `field` object directly for - // creating a new field or editing a new field, since we need all the - // properties to be editable. - // - // A normal copy of `field` (i.e. `const newField = { ...field }`) will only - // copy enumerable properties and copy each property's descriptors (not - // writable, etc). - // - // So we copy `field`'s **property descriptors** into `newFieldProps` - // and modify them so that they are "writable" with a getter/setter that - // stores and retrieves changes into/from another object (`changes`). - Object.getOwnPropertyNames(field).forEach(function(prop) { - const desc = Object.getOwnPropertyDescriptor(field, prop); - - newFieldProps[prop] = { - enumerable: desc.enumerable, - get: function() { - return has(changes, prop) ? changes[prop] : field[prop]; - }, - set: function(v) { - changes[prop] = v; - }, - }; - }); - - return Object.create(null, newFieldProps); -}; diff --git a/src/legacy/ui/public/field_editor/lib/index.js b/src/legacy/ui/public/field_editor/lib/index.js index c74bb0cc2ef8a..c9dd9d03b74f7 100644 --- a/src/legacy/ui/public/field_editor/lib/index.js +++ b/src/legacy/ui/public/field_editor/lib/index.js @@ -17,5 +17,4 @@ * under the License. */ -export { copyField } from './copy_field'; export { executeScript, isScriptValid } from './validate_script'; diff --git a/src/plugins/data/public/index_patterns/fields/field.ts b/src/plugins/data/public/index_patterns/fields/field.ts index 1554565d1403e..6370dcdf2db6f 100644 --- a/src/plugins/data/public/index_patterns/fields/field.ts +++ b/src/plugins/data/public/index_patterns/fields/field.ts @@ -45,9 +45,6 @@ export class Field implements IFieldType { subType?: IFieldSubType; displayName?: string; format: any; - routes: Record<string, string> = { - edit: '/management/kibana/index_patterns/{{indexPattern.id}}/field/{{name}}', - }; $$spec: FieldSpec; constructor( @@ -146,7 +143,3 @@ export class Field implements IFieldType { return obj.create(); } } - -Field.prototype.routes = { - edit: '/management/kibana/index_patterns/{{indexPattern.id}}/field/{{name}}', -}; diff --git a/src/plugins/data/public/index_patterns/fields/field_list.ts b/src/plugins/data/public/index_patterns/fields/field_list.ts index 03214a8c96427..d6067280fd7b6 100644 --- a/src/plugins/data/public/index_patterns/fields/field_list.ts +++ b/src/plugins/data/public/index_patterns/fields/field_list.ts @@ -70,11 +70,12 @@ export class FieldList extends Array<Field> implements IFieldList { this.splice(fieldIndex, 1); }; - update = (field: Field) => { - const index = this.findIndex(f => f.name === field.name); - this.splice(index, 1, field); - this.setByName(field); - this.removeByGroup(field); - this.setByGroup(field); + update = (field: FieldSpec) => { + const newField = new Field(this.indexPattern, field, this.shortDotsEnable); + const index = this.findIndex(f => f.name === newField.name); + this.splice(index, 1, newField); + this.setByName(newField); + this.removeByGroup(newField); + this.setByGroup(newField); }; } diff --git a/src/plugins/data/public/public.api.md b/src/plugins/data/public/public.api.md index cef82b27b1b5b..62967a7071d82 100644 --- a/src/plugins/data/public/public.api.md +++ b/src/plugins/data/public/public.api.md @@ -947,8 +947,6 @@ export class IndexPatternField implements IFieldType { // (undocumented) name: string; // (undocumented) - routes: Record<string, string>; - // (undocumented) script?: string; // (undocumented) scripted?: boolean; @@ -978,7 +976,7 @@ export class IndexPatternFieldList extends Array<IndexPatternField> implements I // (undocumented) remove: (field: IFieldType) => void; // (undocumented) - update: (field: IndexPatternField) => void; + update: (field: Record<string, any>) => void; } // Warning: (ae-missing-release-tag) "indexPatterns" is exported by the package, but it is missing a release tag (@alpha, @beta, @public, or @internal) From e6095fcd03120b62c6d65dcdd23ea7a0ba6d3aab Mon Sep 17 00:00:00 2001 From: Justin Kambic <justin.kambic@elastic.co> Date: Tue, 14 Apr 2020 08:35:31 -0400 Subject: [PATCH 088/102] [Uptime] Remove pings graphql (#59392) * WIP replacing GQL with redux/rest. * Finish implementing migration. * Introduce new connected component for ping list. * Replace GraphQL type with io-ts. * Update some broken tests. * Add test for new helper function. * Write test snapshots. * Migrate api tests from graphql to rest. * Update fixtures that rely on pings. * Move ping types to runtime_types folder with rest of io-ts files. * Update Ping type location and imports, type checking. * Remove reliance on fixtures for ping functional API tests. * Fix broken unit tests. * Fix broken types. * Remove local state storage from parent components. * Add functional test to cover Ping List functionality. * Fix monitor page functional test that was broken by merge conflicts. * Fix broken tests. * Fix broken API test. * Replace a test with a describe block that will pre-navigate all tests. * Delete unused reducer keys. * Re-introduce loading to ping list reducer. * Inroduce code that will cause PingList to re-fetch when refresh button is pressed. * Update expanded rows to support multiple concurrent expanded rows. * Modify pingList reducer to have singular optional error field. * Delete unnecessary helper code. * Delete unused interface. * Add runtime_type to parse getPings params, fix pagination index. * Add dedicated monitor type to runtime_types. * Fix broken tests. * Fix broken tests. * Rename '@timestamp' property to 'timestamp' on Ping type. * Fix broken type and key pings list table on document ID instead of timestamp. * Fix broken unit tests. * Fix broken tests and types. * Fix broken functional test. --- .../plugins/uptime/common/graphql/types.ts | 340 ---- .../uptime/common/runtime_types/common.ts | 6 + .../uptime/common/runtime_types/index.ts | 1 + .../ping/histogram.ts | 12 + .../runtime_types/ping}/index.ts | 3 +- .../uptime/common/runtime_types/ping/ping.ts | 181 ++ .../plugins/uptime/common/types/index.ts | 2 - .../connected/charts/ping_histogram.tsx | 2 +- .../public/components/connected/index.ts | 1 + .../monitor/status_bar_container.tsx | 2 +- .../components/connected/pings/index.ts | 7 + .../components/connected/pings/ping_list.tsx | 52 + .../functional/charts/ping_histogram.tsx | 2 +- .../public/components/functional/index.ts | 2 +- .../__test__/monitor_ssl_certificate.test.tsx | 4 +- .../__test__/monitor_status.bar.test.tsx | 6 +- .../monitor_ssl_certificate.tsx | 5 +- .../monitor_status_bar/monitor_status_bar.tsx | 2 +- .../__snapshots__/ping_list.test.tsx.snap | 665 ++++--- .../ping_list/__tests__/expanded_row.test.tsx | 14 +- .../ping_list/__tests__/ping_list.test.tsx | 418 +++-- .../functional/ping_list/expanded_row.tsx | 4 +- .../components/functional/ping_list/index.tsx | 2 +- .../functional/ping_list/ping_list.tsx | 343 ++-- .../plugins/uptime/public/hooks/index.ts | 1 + .../plugins/uptime/public/pages/monitor.tsx | 46 +- .../uptime/public/queries/pings_query.ts | 73 - .../public/state/actions/monitor_status.ts | 2 +- .../uptime/public/state/actions/ping.ts | 11 +- .../uptime/public/state/api/monitor_status.ts | 4 +- .../plugins/uptime/public/state/api/ping.ts | 19 +- .../public/state/effects/fetch_effect.ts | 2 +- .../uptime/public/state/effects/index.ts | 3 +- .../uptime/public/state/effects/ping.ts | 15 +- .../uptime/public/state/reducers/index.ts | 2 + .../public/state/reducers/monitor_status.ts | 2 +- .../uptime/public/state/reducers/ping.ts | 2 +- .../uptime/public/state/reducers/ping_list.ts | 48 + .../state/selectors/__tests__/index.test.ts | 8 + .../uptime/public/state/selectors/index.ts | 5 + x-pack/plugins/uptime/server/graphql/index.ts | 3 +- .../graphql/monitor_states/schema.gql.ts | 2 +- .../uptime/server/graphql/pings/index.ts | 1 - .../uptime/server/graphql/pings/resolvers.ts | 59 - .../uptime/server/graphql/pings/schema.gql.ts | 26 - .../__tests__/get_latest_monitor.test.ts | 25 +- .../lib/requests/__tests__/get_pings.test.ts | 273 ++- .../server/lib/requests/get_latest_monitor.ts | 12 +- .../server/lib/requests/get_ping_histogram.ts | 6 +- .../uptime/server/lib/requests/get_pings.ts | 65 +- .../uptime/server/lib/requests/index.ts | 2 +- .../uptime/server/lib/requests/types.ts | 72 - .../server/lib/requests/uptime_requests.ts | 13 +- .../plugins/uptime/server/rest_api/index.ts | 4 +- .../uptime/server/rest_api/pings/get_all.ts | 47 - .../uptime/server/rest_api/pings/get_pings.ts | 24 +- .../uptime/server/rest_api/pings/index.ts | 1 + .../apis/uptime/feature_controls.ts | 2 +- .../apis/uptime/get_all_pings.ts | 18 +- .../uptime/graphql/fixtures/ping_list.json | 320 ---- .../graphql/fixtures/ping_list_count.json | 1569 ----------------- .../fixtures/ping_list_monitor_id.json | 475 ----- .../graphql/fixtures/ping_list_sort.json | 165 -- .../apis/uptime/graphql/index.ts | 1 - .../apis/uptime/graphql/ping_list.ts | 116 -- .../test/api_integration/apis/uptime/index.ts | 11 +- .../rest/fixtures/monitor_latest_status.json | 15 +- .../api_integration/apis/uptime/rest/index.ts | 5 +- .../apis/uptime/rest/ping_list.ts | 178 ++ x-pack/test/functional/apps/uptime/monitor.ts | 29 +- .../functional/page_objects/uptime_page.ts | 16 +- .../functional/services/uptime/monitor.ts | 17 + 72 files changed, 1695 insertions(+), 4196 deletions(-) rename x-pack/legacy/plugins/uptime/common/{types => runtime_types}/ping/histogram.ts (77%) rename x-pack/legacy/plugins/uptime/{public/queries => common/runtime_types/ping}/index.ts (79%) create mode 100644 x-pack/legacy/plugins/uptime/common/runtime_types/ping/ping.ts create mode 100644 x-pack/legacy/plugins/uptime/public/components/connected/pings/index.ts create mode 100644 x-pack/legacy/plugins/uptime/public/components/connected/pings/ping_list.tsx delete mode 100644 x-pack/legacy/plugins/uptime/public/queries/pings_query.ts create mode 100644 x-pack/legacy/plugins/uptime/public/state/reducers/ping_list.ts delete mode 100644 x-pack/plugins/uptime/server/graphql/pings/resolvers.ts delete mode 100644 x-pack/plugins/uptime/server/lib/requests/types.ts delete mode 100644 x-pack/plugins/uptime/server/rest_api/pings/get_all.ts delete mode 100644 x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list.json delete mode 100644 x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_count.json delete mode 100644 x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_monitor_id.json delete mode 100644 x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_sort.json delete mode 100644 x-pack/test/api_integration/apis/uptime/graphql/ping_list.ts create mode 100644 x-pack/test/api_integration/apis/uptime/rest/ping_list.ts diff --git a/x-pack/legacy/plugins/uptime/common/graphql/types.ts b/x-pack/legacy/plugins/uptime/common/graphql/types.ts index c8beb91d807d5..506966ec6b5c9 100644 --- a/x-pack/legacy/plugins/uptime/common/graphql/types.ts +++ b/x-pack/legacy/plugins/uptime/common/graphql/types.ts @@ -15,294 +15,15 @@ export type UnsignedInteger = any; // ==================================================== export interface Query { - /** Get a list of all recorded pings for all monitors */ - allPings: PingResults; - /** Fetches the current state of Uptime monitors for the given parameters. */ getMonitorStates?: MonitorSummaryResult | null; } -export interface PingResults { - /** Total number of matching pings */ - total: UnsignedInteger; - /** Unique list of all locations the query matched */ - locations: string[]; - /** List of pings */ - pings: Ping[]; -} -/** A request sent from a monitor to a host */ -export interface Ping { - /** unique ID for this ping */ - id: string; - /** The timestamp of the ping's creation */ - timestamp: string; - /** The agent that recorded the ping */ - beat?: Beat | null; - - container?: Container | null; - - docker?: Docker | null; - - ecs?: Ecs | null; - - error?: Error | null; - - host?: Host | null; - - http?: Http | null; - - icmp?: Icmp | null; - - kubernetes?: Kubernetes | null; - - meta?: Meta | null; - - monitor?: Monitor | null; - - observer?: Observer | null; - - resolve?: Resolve | null; - - socks5?: Socks5 | null; - - summary?: Summary | null; - - tags?: string | null; - - tcp?: Tcp | null; - - tls?: PingTls | null; - - url?: Url | null; -} -/** An agent for recording a beat */ -export interface Beat { - hostname?: string | null; - - name?: string | null; - - timezone?: string | null; - - type?: string | null; -} - -export interface Container { - id?: string | null; - - image?: ContainerImage | null; - - name?: string | null; - - runtime?: string | null; -} - -export interface ContainerImage { - name?: string | null; - - tag?: string | null; -} - -export interface Docker { - id?: string | null; - - image?: string | null; - - name?: string | null; -} - -export interface Ecs { - version?: string | null; -} - -export interface Error { - code?: number | null; - - message?: string | null; - - type?: string | null; -} - -export interface Host { - architecture?: string | null; - - id?: string | null; - - hostname?: string | null; - - ip?: string | null; - - mac?: string | null; - - name?: string | null; - - os?: Os | null; -} - -export interface Os { - family?: string | null; - - kernel?: string | null; - - platform?: string | null; - - version?: string | null; - - name?: string | null; - - build?: string | null; -} - -export interface Http { - response?: HttpResponse | null; - - rtt?: HttpRtt | null; - - url?: string | null; -} - -export interface HttpResponse { - status_code?: UnsignedInteger | null; - - body?: HttpBody | null; -} - -export interface HttpBody { - /** Size of HTTP response body in bytes */ - bytes?: UnsignedInteger | null; - /** Hash of the HTTP response body */ - hash?: string | null; - /** Response body of the HTTP Response. May be truncated based on client settings. */ - content?: string | null; - /** Byte length of the content string, taking into account multibyte chars. */ - content_bytes?: UnsignedInteger | null; -} - -export interface HttpRtt { - content?: Duration | null; - - response_header?: Duration | null; - - total?: Duration | null; - - validate?: Duration | null; - - validate_body?: Duration | null; - - write_request?: Duration | null; -} /** The monitor's status for a ping */ export interface Duration { us?: UnsignedInteger | null; } -export interface Icmp { - requests?: number | null; - - rtt?: number | null; -} - -export interface Kubernetes { - container?: KubernetesContainer | null; - - namespace?: string | null; - - node?: KubernetesNode | null; - - pod?: KubernetesPod | null; -} - -export interface KubernetesContainer { - image?: string | null; - - name?: string | null; -} - -export interface KubernetesNode { - name?: string | null; -} - -export interface KubernetesPod { - name?: string | null; - - uid?: string | null; -} - -export interface Meta { - cloud?: MetaCloud | null; -} - -export interface MetaCloud { - availability_zone?: string | null; - - instance_id?: string | null; - - instance_name?: string | null; - - machine_type?: string | null; - - project_id?: string | null; - - provider?: string | null; - - region?: string | null; -} - -export interface Monitor { - duration?: Duration | null; - - host?: string | null; - /** The id of the monitor */ - id?: string | null; - /** The IP pinged by the monitor */ - ip?: string | null; - /** The name of the protocol being monitored */ - name?: string | null; - /** The protocol scheme of the monitored host */ - scheme?: string | null; - /** The status of the monitored host */ - status?: string | null; - /** The type of host being monitored */ - type?: string | null; - - check_group?: string | null; -} -/** Metadata added by a proccessor, which is specified in its configuration. */ -export interface Observer { - /** Geolocation data for the agent. */ - geo?: Geo | null; -} -/** Geolocation data added via processors to enrich events. */ -export interface Geo { - /** Name of the city in which the agent is running. */ - city_name?: string | null; - /** The name of the continent on which the agent is running. */ - continent_name?: string | null; - /** ISO designation for the agent's country. */ - country_iso_code?: string | null; - /** The name of the agent's country. */ - country_name?: string | null; - /** The lat/long of the agent. */ - location?: string | null; - /** A name for the host's location, e.g. 'us-east-1' or 'LAX'. */ - name?: string | null; - /** ISO designation of the agent's region. */ - region_iso_code?: string | null; - /** Name of the region hosting the agent. */ - region_name?: string | null; -} - -export interface Resolve { - host?: string | null; - - ip?: string | null; - - rtt?: Duration | null; -} - -export interface Socks5 { - rtt?: Rtt | null; -} - export interface Rtt { connect?: Duration | null; @@ -331,53 +52,10 @@ export interface Location { lon?: number | null; } -export interface Tcp { - port?: number | null; - - rtt?: Rtt | null; -} -/** Contains monitor transmission encryption information. */ -export interface PingTls { - /** The date and time after which the certificate is invalid. */ - certificate_not_valid_after?: string | null; - - certificate_not_valid_before?: string | null; - - certificates?: string | null; - - rtt?: Rtt | null; -} - -export interface Url { - full?: string | null; - - scheme?: string | null; - - domain?: string | null; - - port?: number | null; - - path?: string | null; - - query?: string | null; -} - export interface DocCount { count: UnsignedInteger; } -export interface Snapshot { - counts: SnapshotCount; -} - -export interface SnapshotCount { - up: number; - - down: number; - - total: number; -} - /** The primary object returned for monitor states. */ export interface MonitorSummaryResult { /** Used to go to the next page of results */ @@ -521,24 +199,6 @@ export interface SummaryHistogramPoint { down: number; } -export interface AllPingsQueryArgs { - /** Optional: the direction to sort by. Accepts 'asc' and 'desc'. Defaults to 'desc'. */ - sort?: string | null; - /** Optional: the number of results to return. */ - size?: number | null; - /** Optional: the monitor ID filter. */ - monitorId?: string | null; - /** Optional: the check status to filter by. */ - status?: string | null; - /** The lower limit of the date range. */ - dateRangeStart: string; - /** The upper limit of the date range. */ - dateRangeEnd: string; - /** Optional: agent location to filter by. */ - location?: string | null; - page?: number; -} - export interface GetMonitorStatesQueryArgs { dateRangeStart: string; diff --git a/x-pack/legacy/plugins/uptime/common/runtime_types/common.ts b/x-pack/legacy/plugins/uptime/common/runtime_types/common.ts index 37101b5b46fd2..9018f4acaa320 100644 --- a/x-pack/legacy/plugins/uptime/common/runtime_types/common.ts +++ b/x-pack/legacy/plugins/uptime/common/runtime_types/common.ts @@ -27,7 +27,13 @@ export const StatesIndexStatusType = t.type({ docCount: t.number, }); +export const DateRangeType = t.type({ + from: t.string, + to: t.string, +}); + export type Summary = t.TypeOf<typeof SummaryType>; export type CheckGeo = t.TypeOf<typeof CheckGeoType>; export type Location = t.TypeOf<typeof LocationType>; export type StatesIndexStatus = t.TypeOf<typeof StatesIndexStatusType>; +export type DateRange = t.TypeOf<typeof DateRangeType>; diff --git a/x-pack/legacy/plugins/uptime/common/runtime_types/index.ts b/x-pack/legacy/plugins/uptime/common/runtime_types/index.ts index 5e3fb2326bdb9..652d60cbe304d 100644 --- a/x-pack/legacy/plugins/uptime/common/runtime_types/index.ts +++ b/x-pack/legacy/plugins/uptime/common/runtime_types/index.ts @@ -8,5 +8,6 @@ export * from './alerts'; export * from './common'; export * from './monitor'; export * from './overview_filters'; +export * from './ping'; export * from './snapshot'; export * from './dynamic_settings'; diff --git a/x-pack/legacy/plugins/uptime/common/types/ping/histogram.ts b/x-pack/legacy/plugins/uptime/common/runtime_types/ping/histogram.ts similarity index 77% rename from x-pack/legacy/plugins/uptime/common/types/ping/histogram.ts rename to x-pack/legacy/plugins/uptime/common/runtime_types/ping/histogram.ts index 3ae32e15ca55c..2c3b52051be0f 100644 --- a/x-pack/legacy/plugins/uptime/common/types/ping/histogram.ts +++ b/x-pack/legacy/plugins/uptime/common/runtime_types/ping/histogram.ts @@ -28,3 +28,15 @@ export interface HistogramResult { histogram: HistogramDataPoint[]; interval: string; } + +export interface HistogramQueryResult { + key: number; + key_as_string: string; + doc_count: number; + down: { + doc_count: number; + }; + up: { + doc_count: number; + }; +} diff --git a/x-pack/legacy/plugins/uptime/public/queries/index.ts b/x-pack/legacy/plugins/uptime/common/runtime_types/ping/index.ts similarity index 79% rename from x-pack/legacy/plugins/uptime/public/queries/index.ts rename to x-pack/legacy/plugins/uptime/common/runtime_types/ping/index.ts index 283382ec1b7ba..a2fc7c1b243ba 100644 --- a/x-pack/legacy/plugins/uptime/public/queries/index.ts +++ b/x-pack/legacy/plugins/uptime/common/runtime_types/ping/index.ts @@ -4,4 +4,5 @@ * you may not use this file except in compliance with the Elastic License. */ -export { pingsQuery, pingsQueryString } from './pings_query'; +export * from './histogram'; +export * from './ping'; diff --git a/x-pack/legacy/plugins/uptime/common/runtime_types/ping/ping.ts b/x-pack/legacy/plugins/uptime/common/runtime_types/ping/ping.ts new file mode 100644 index 0000000000000..ee14b298f3810 --- /dev/null +++ b/x-pack/legacy/plugins/uptime/common/runtime_types/ping/ping.ts @@ -0,0 +1,181 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import * as t from 'io-ts'; +import { DateRangeType } from '../common'; + +export const HttpResponseBodyType = t.partial({ + bytes: t.number, + content: t.string, + content_bytes: t.number, + hash: t.string, +}); + +export type HttpResponseBody = t.TypeOf<typeof HttpResponseBodyType>; + +export const TlsType = t.partial({ + certificate_not_valid_after: t.string, + certificate_not_valid_before: t.string, +}); + +export type Tls = t.TypeOf<typeof TlsType>; + +export const MonitorType = t.intersection([ + t.type({ + duration: t.type({ + us: t.number, + }), + id: t.string, + status: t.string, + type: t.string, + }), + t.partial({ + check_group: t.string, + ip: t.string, + name: t.string, + timespan: t.partial({ + gte: t.string, + lte: t.string, + }), + }), +]); + +export type Monitor = t.TypeOf<typeof MonitorType>; + +export const PingType = t.intersection([ + t.type({ + timestamp: t.string, + monitor: MonitorType, + docId: t.string, + }), + t.partial({ + agent: t.intersection([ + t.type({ + ephemeral_id: t.string, + hostname: t.string, + id: t.string, + type: t.string, + version: t.string, + }), + t.partial({ + name: t.string, + }), + ]), + container: t.partial({ + id: t.string, + image: t.partial({ + name: t.string, + tag: t.string, + }), + name: t.string, + runtime: t.string, + }), + ecs: t.partial({ + version: t.string, + }), + error: t.intersection([ + t.partial({ + code: t.string, + id: t.string, + stack_trace: t.string, + type: t.string, + }), + t.type({ + // this is _always_ on the error field + message: t.string, + }), + ]), + http: t.partial({ + request: t.partial({ + body: t.partial({ + bytes: t.number, + content: t.partial({ + text: t.string, + }), + }), + bytes: t.number, + method: t.string, + referrer: t.string, + }), + response: t.partial({ + body: HttpResponseBodyType, + bytes: t.number, + redirects: t.string, + status_code: t.number, + }), + version: t.string, + }), + icmp: t.partial({ + requests: t.number, + rtt: t.partial({ + us: t.number, + }), + }), + kubernetes: t.partial({ + pod: t.partial({ + name: t.string, + uid: t.string, + }), + }), + observer: t.partial({ + geo: t.partial({ + name: t.string, + }), + }), + resolve: t.partial({ + ip: t.string, + rtt: t.partial({ + us: t.number, + }), + }), + summary: t.partial({ + down: t.number, + up: t.number, + }), + tags: t.array(t.string), + tcp: t.partial({ + rtt: t.partial({ + connect: t.partial({ + us: t.number, + }), + }), + }), + tls: TlsType, + // should this be partial? + url: t.partial({ + domain: t.string, + full: t.string, + port: t.number, + scheme: t.string, + }), + }), +]); + +export type Ping = t.TypeOf<typeof PingType>; + +export const PingsResponseType = t.type({ + total: t.number, + locations: t.array(t.string), + pings: t.array(PingType), +}); + +export type PingsResponse = t.TypeOf<typeof PingsResponseType>; + +export const GetPingsParamsType = t.intersection([ + t.type({ + dateRange: DateRangeType, + }), + t.partial({ + index: t.number, + size: t.number, + location: t.string, + monitorId: t.string, + sort: t.string, + status: t.string, + }), +]); + +export type GetPingsParams = t.TypeOf<typeof GetPingsParamsType>; diff --git a/x-pack/legacy/plugins/uptime/common/types/index.ts b/x-pack/legacy/plugins/uptime/common/types/index.ts index 2c39f2a3b7314..1d0003addd761 100644 --- a/x-pack/legacy/plugins/uptime/common/types/index.ts +++ b/x-pack/legacy/plugins/uptime/common/types/index.ts @@ -41,5 +41,3 @@ export interface MonitorDurationResult { /** The maximum duration value in this chart. */ durationMaxValue: number; } - -export * from './ping/histogram'; diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx index 6428ddfd10f8c..cf35dbf4e5206 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/charts/ping_histogram.tsx @@ -14,7 +14,7 @@ import { import { getPingHistogram } from '../../../state/actions'; import { selectPingHistogram } from '../../../state/selectors'; import { withResponsiveWrapper, ResponsiveWrapperProps } from '../../higher_order'; -import { GetPingHistogramParams, HistogramResult } from '../../../../common/types'; +import { GetPingHistogramParams, HistogramResult } from '../../../../common/runtime_types'; import { useGetUrlParams } from '../../../hooks'; type Props = ResponsiveWrapperProps & diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/index.ts b/x-pack/legacy/plugins/uptime/public/components/connected/index.ts index 7e442cbe850ba..be3cc5b65aa0e 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/index.ts +++ b/x-pack/legacy/plugins/uptime/public/components/connected/index.ts @@ -13,5 +13,6 @@ export { MonitorStatusDetails } from './monitor/status_details_container'; export { MonitorStatusBar } from './monitor/status_bar_container'; export { MonitorListDrawer } from './monitor/list_drawer_container'; export { MonitorListActionsPopover } from './monitor/drawer_popover_container'; +export { PingList, PingListProps } from './pings'; export { DurationChart } from './charts/monitor_duration'; export { EmptyState } from './empty_state/empty_state'; diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx index 00cfd02d8dc32..3a96aa7c0275b 100644 --- a/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/connected/monitor/status_bar_container.tsx @@ -12,7 +12,7 @@ import { monitorLocationsSelector, monitorStatusSelector } from '../../../state/ import { MonitorStatusBarComponent } from '../../functional/monitor_status_details/monitor_status_bar'; import { getMonitorStatusAction } from '../../../state/actions'; import { useGetUrlParams } from '../../../hooks'; -import { Ping } from '../../../../common/graphql/types'; +import { Ping } from '../../../../common/runtime_types'; import { MonitorLocations } from '../../../../common/runtime_types/monitor'; import { UptimeRefreshContext } from '../../../contexts'; diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/pings/index.ts b/x-pack/legacy/plugins/uptime/public/components/connected/pings/index.ts new file mode 100644 index 0000000000000..95ced104e5188 --- /dev/null +++ b/x-pack/legacy/plugins/uptime/public/components/connected/pings/index.ts @@ -0,0 +1,7 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +export { PingList, PingListProps } from './ping_list'; diff --git a/x-pack/legacy/plugins/uptime/public/components/connected/pings/ping_list.tsx b/x-pack/legacy/plugins/uptime/public/components/connected/pings/ping_list.tsx new file mode 100644 index 0000000000000..5b32a623495f1 --- /dev/null +++ b/x-pack/legacy/plugins/uptime/public/components/connected/pings/ping_list.tsx @@ -0,0 +1,52 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { useSelector, useDispatch } from 'react-redux'; +import React, { useContext, useCallback } from 'react'; +import { selectPingList } from '../../../state/selectors'; +import { getPings } from '../../../state/actions'; +import { GetPingsParams } from '../../../../common/runtime_types'; +import { UptimeSettingsContext } from '../../../contexts'; +import { PingListComponent } from '../../functional'; + +export interface PingListProps { + monitorId: string; +} + +export const PingList = (props: PingListProps) => { + const { + lastRefresh, + pings: { + error, + loading, + pingList: { locations, pings, total }, + }, + } = useSelector(selectPingList); + + const { dateRangeStart: drs, dateRangeEnd: dre } = useContext(UptimeSettingsContext); + + const dispatch = useDispatch(); + const getPingsCallback = useCallback((params: GetPingsParams) => dispatch(getPings(params)), [ + dispatch, + ]); + + return ( + <PingListComponent + dateRange={{ + from: drs, + to: dre, + }} + error={error} + getPings={getPingsCallback} + lastRefresh={lastRefresh} + loading={loading} + locations={locations} + pings={pings} + total={total} + {...props} + /> + ); +}; diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/charts/ping_histogram.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/charts/ping_histogram.tsx index f988afc7fc84d..66e86d6731236 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/charts/ping_histogram.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/charts/ping_histogram.tsx @@ -13,7 +13,7 @@ import moment from 'moment'; import { getChartDateLabel } from '../../../lib/helper'; import { ChartWrapper } from './chart_wrapper'; import { UptimeThemeContext } from '../../../contexts'; -import { HistogramResult } from '../../../../common/types'; +import { HistogramResult } from '../../../../common/runtime_types'; import { useUrlParams } from '../../../hooks'; import { ChartEmptyState } from './chart_empty_state'; diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/index.ts b/x-pack/legacy/plugins/uptime/public/components/functional/index.ts index 8d0352e01d40e..d82912a6216e8 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/index.ts +++ b/x-pack/legacy/plugins/uptime/public/components/functional/index.ts @@ -15,6 +15,6 @@ export { KueryBarComponent } from './kuery_bar/kuery_bar'; export { MonitorCharts } from './monitor_charts'; export { MonitorList } from './monitor_list'; export { OverviewPageParsingErrorCallout } from './overview_page_parsing_error_callout'; -export { PingList } from './ping_list'; +export { PingListComponent } from './ping_list'; export { PingHistogramComponent } from './charts'; export { StatusPanel } from './status_panel'; diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_ssl_certificate.test.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_ssl_certificate.test.tsx index 2eae14301fd4d..57ed09cc30ef1 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_ssl_certificate.test.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_ssl_certificate.test.tsx @@ -9,11 +9,11 @@ import moment from 'moment'; import { mountWithIntl } from 'test_utils/enzyme_helpers'; import { EuiBadge } from '@elastic/eui'; import { renderWithIntl } from 'test_utils/enzyme_helpers'; -import { PingTls } from '../../../../../common/graphql/types'; +import { Tls } from '../../../../../common/runtime_types'; import { MonitorSSLCertificate } from '../monitor_status_bar'; describe('MonitorStatusBar component', () => { - let monitorTls: PingTls; + let monitorTls: Tls; beforeEach(() => { const dateInTwoMonths = moment() diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_status.bar.test.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_status.bar.test.tsx index 0a53eeb89d793..5fd32c808da42 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_status.bar.test.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/__test__/monitor_status.bar.test.tsx @@ -8,7 +8,7 @@ import moment from 'moment'; import React from 'react'; import { renderWithIntl } from 'test_utils/enzyme_helpers'; import { MonitorStatusBarComponent } from '../monitor_status_bar'; -import { Ping } from '../../../../../common/graphql/types'; +import { Ping } from '../../../../../common/runtime_types'; describe('MonitorStatusBar component', () => { let monitorStatus: Ping; @@ -16,7 +16,7 @@ describe('MonitorStatusBar component', () => { beforeEach(() => { monitorStatus = { - id: 'id1', + docId: 'few213kl', timestamp: moment(new Date()) .subtract(15, 'm') .toString(), @@ -24,7 +24,9 @@ describe('MonitorStatusBar component', () => { duration: { us: 1234567, }, + id: 'id1', status: 'up', + type: 'http', }, url: { full: 'https://www.example.com/', diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_ssl_certificate.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_ssl_certificate.tsx index c57348c4ab4cd..d92534aecd175 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_ssl_certificate.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_ssl_certificate.tsx @@ -9,14 +9,13 @@ import moment from 'moment'; import { EuiSpacer, EuiText, EuiBadge } from '@elastic/eui'; import { FormattedMessage } from '@kbn/i18n/react'; import { i18n } from '@kbn/i18n'; - -import { PingTls } from '../../../../../common/graphql/types'; +import { Tls } from '../../../../../common/runtime_types'; interface Props { /** * TLS information coming from monitor in ES heartbeat index */ - tls: PingTls | null | undefined; + tls: Tls | null | undefined; } export const MonitorSSLCertificate = ({ tls }: Props) => { diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_status_bar.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_status_bar.tsx index 22e4377944be1..ac3cedc517995 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_status_bar.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/monitor_status_details/monitor_status_bar/monitor_status_bar.tsx @@ -17,7 +17,7 @@ import { import { MonitorSSLCertificate } from './monitor_ssl_certificate'; import * as labels from './translations'; import { StatusByLocations } from './status_by_location'; -import { Ping } from '../../../../../common/graphql/types'; +import { Ping } from '../../../../../common/runtime_types'; import { MonitorLocations } from '../../../../../common/runtime_types'; interface MonitorStatusBarProps { diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/__snapshots__/ping_list.test.tsx.snap b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/__snapshots__/ping_list.test.tsx.snap index 2e59ec5e57337..154ab6399452d 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/__snapshots__/ping_list.test.tsx.snap +++ b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/__snapshots__/ping_list.test.tsx.snap @@ -1,384 +1,349 @@ // Jest Snapshot v1, https://goo.gl/fbAQLP exports[`PingList component renders sorted list without errors 1`] = ` -<Fragment> - <EuiPanel> - <EuiTitle - size="xs" +<EuiPanel> + <EuiTitle + size="xs" + > + <h4> + <FormattedMessage + defaultMessage="History" + id="xpack.uptime.pingList.checkHistoryTitle" + values={Object {}} + /> + </h4> + </EuiTitle> + <EuiSpacer + size="s" + /> + <EuiFlexGroup + justifyContent="spaceBetween" + > + <EuiFlexItem + grow={false} > - <h4> - <FormattedMessage - defaultMessage="History" - id="xpack.uptime.pingList.checkHistoryTitle" - values={Object {}} + <EuiFormRow + aria-label="Status" + describedByIds={Array []} + display="row" + fullWidth={false} + hasChildLabel={true} + hasEmptyLabelSpace={false} + label="Status" + labelType="label" + > + <EuiSelect + aria-label="Status" + data-test-subj="xpack.uptime.pingList.statusSelect" + onChange={[Function]} + options={ + Array [ + Object { + "data-test-subj": "xpack.uptime.pingList.statusOptions.all", + "text": "All", + "value": "", + }, + Object { + "data-test-subj": "xpack.uptime.pingList.statusOptions.up", + "text": "Up", + "value": "up", + }, + Object { + "data-test-subj": "xpack.uptime.pingList.statusOptions.down", + "text": "Down", + "value": "down", + }, + ] + } + value="" /> - </h4> - </EuiTitle> - <EuiSpacer - size="s" - /> - <EuiFlexGroup - justifyContent="spaceBetween" - > - <EuiFlexItem - grow={false} + </EuiFormRow> + </EuiFlexItem> + <EuiFlexItem> + <EuiFormRow + aria-label="Location" + describedByIds={Array []} + display="row" + fullWidth={false} + hasChildLabel={true} + hasEmptyLabelSpace={false} + label="Location" + labelType="label" > - <EuiFlexGroup> - <EuiFlexItem - style={ + <EuiSelect + aria-label="Location" + data-test-subj="xpack.uptime.pingList.locationSelect" + onChange={[Function]} + options={ + Array [ Object { - "minWidth": 200, - } - } - > - <EuiFlexGroup> - <EuiFlexItem> - <EuiFormRow - aria-label="Status" - describedByIds={Array []} - display="row" - fullWidth={false} - hasChildLabel={true} - hasEmptyLabelSpace={false} - label="Status" - labelType="label" - > - <EuiSelect - aria-label="Status" - onChange={[Function]} - options={ - Array [ - Object { - "text": "All", - "value": "", - }, - Object { - "text": "Up", - "value": "up", - }, - Object { - "text": "Down", - "value": "down", - }, - ] - } - value="down" - /> - </EuiFormRow> - </EuiFlexItem> - <EuiFlexItem> - <EuiFormRow - aria-label="Location" - describedByIds={Array []} - display="row" - fullWidth={false} - hasChildLabel={true} - hasEmptyLabelSpace={false} - label="Location" - labelType="label" - > - <EuiSelect - aria-label="Location" - onChange={[Function]} - options={ - Array [ - Object { - "text": "All", - "value": "", - }, - Object { - "text": "nyc", - "value": "nyc", - }, - ] - } - value="" - /> - </EuiFormRow> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - </EuiFlexGroup> - <EuiSpacer - size="s" - /> - <EuiBasicTable - columns={ - Array [ - Object { - "field": "monitor.status", - "name": "Status", - "render": [Function], - }, - Object { - "align": "left", - "field": "observer.geo.name", - "name": "Location", - "render": [Function], + "data-test-subj": "xpack.uptime.pingList.locationOptions.all", + "text": "All", + "value": "", + }, + ] + } + value="" + /> + </EuiFormRow> + </EuiFlexItem> + </EuiFlexGroup> + <EuiSpacer + size="s" + /> + <EuiBasicTable + columns={ + Array [ + Object { + "field": "monitor.status", + "name": "Status", + "render": [Function], + }, + Object { + "align": "left", + "field": "observer.geo.name", + "name": "Location", + "render": [Function], + }, + Object { + "align": "right", + "dataType": "number", + "field": "monitor.ip", + "name": "IP", + }, + Object { + "align": "right", + "field": "monitor.duration.us", + "name": "Duration", + "render": [Function], + }, + Object { + "align": "right", + "field": "error.type", + "name": "Error type", + "render": [Function], + }, + Object { + "align": "right", + "field": "http.response.status_code", + "name": <ForwardRef(styled.span)> + Response code + </ForwardRef(styled.span)>, + "render": [Function], + }, + Object { + "align": "right", + "isExpander": true, + "render": [Function], + "width": "24px", + }, + ] + } + hasActions={true} + isExpandable={true} + itemId="docId" + itemIdToExpandedRowMap={Object {}} + items={ + Array [ + Object { + "docId": "fewjio21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", }, - Object { - "align": "right", - "dataType": "number", - "field": "monitor.ip", - "name": "IP", + "monitor": Object { + "duration": Object { + "us": 1430, + }, + "id": "auto-tcp-0X81440A68E839814F", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", }, - Object { - "align": "right", - "field": "monitor.duration.us", - "name": "Duration", - "render": [Function], + "timestamp": "2019-01-28T17:47:08.078Z", + }, + Object { + "docId": "fewjoo21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", }, - Object { - "align": "right", - "field": "error.type", - "name": "Error type", - "render": [Function], + "monitor": Object { + "duration": Object { + "us": 1370, + }, + "id": "auto-tcp-0X81440A68E839814D", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", }, - Object { - "align": "right", - "field": "http.response.status_code", - "name": <ForwardRef(styled.span)> - Response code - </ForwardRef(styled.span)>, - "render": [Function], + "timestamp": "2019-01-28T17:47:09.075Z", + }, + Object { + "docId": "fejjio21", + "monitor": Object { + "duration": Object { + "us": 1452, + }, + "id": "auto-tcp-0X81440A68E839814D", + "ip": "127.0.0.1", + "name": "", + "status": "up", + "type": "tcp", }, - Object { - "align": "right", - "isExpander": true, - "render": [Function], - "width": "24px", + "timestamp": "2019-01-28T17:47:06.077Z", + }, + Object { + "docId": "fewzio21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", }, - ] - } - hasActions={true} - isExpandable={true} - itemId="id" - itemIdToExpandedRowMap={Object {}} - items={ - Array [ - Object { - "error": Object { - "message": "dial tcp 127.0.0.1:9200: connect: connection refused", - "type": "io", + "monitor": Object { + "duration": Object { + "us": 1094, }, - "http": null, - "id": "id1", - "monitor": Object { - "duration": Object { - "us": 1430, - }, - "id": "auto-tcp-0X81440A68E839814C", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "tcp", - }, - "timestamp": "2019-01-28T17:47:08.078Z", + "id": "auto-tcp-0X81440A68E839814E", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", }, - Object { - "error": Object { - "message": "dial tcp 127.0.0.1:9200: connect: connection refused", - "type": "io", - }, - "http": null, - "id": "id2", - "monitor": Object { - "duration": Object { - "us": 1370, - }, - "id": "auto-tcp-0X81440A68E839814C", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "tcp", - }, - "timestamp": "2019-01-28T17:47:09.075Z", + "timestamp": "2019-01-28T17:47:07.075Z", + }, + Object { + "docId": "fewpi321", + "error": Object { + "message": "Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused", + "type": "io", }, - Object { - "error": null, - "http": null, - "id": "id3", - "monitor": Object { - "duration": Object { - "us": 1452, - }, - "id": "auto-tcp-0X81440A68E839814C", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "tcp", + "monitor": Object { + "duration": Object { + "us": 1597, }, - "timestamp": "2019-01-28T17:47:06.077Z", + "id": "auto-http-0X3675F89EF061209G", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "http", }, - Object { - "error": Object { - "message": "dial tcp 127.0.0.1:9200: connect: connection refused", - "type": "io", - }, - "http": null, - "id": "id4", - "monitor": Object { - "duration": Object { - "us": 1094, - }, - "id": "auto-tcp-0X81440A68E839814C", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "tcp", - }, - "timestamp": "2019-01-28T17:47:07.075Z", + "timestamp": "2019-01-28T17:47:07.074Z", + }, + Object { + "docId": "0ewjio21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", }, - Object { - "error": Object { - "message": "Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused", - "type": "io", + "monitor": Object { + "duration": Object { + "us": 1699, }, - "http": null, - "id": "id5", - "monitor": Object { - "duration": Object { - "us": 1597, - }, - "id": "auto-http-0X3675F89EF0612091", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "http", - }, - "timestamp": "2019-01-28T17:47:07.074Z", + "id": "auto-tcp-0X81440A68E839814H", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", }, - Object { - "error": Object { - "message": "dial tcp 127.0.0.1:9200: connect: connection refused", - "type": "io", - }, - "http": null, - "id": "id6", - "monitor": Object { - "duration": Object { - "us": 1699, - }, - "id": "auto-tcp-0X81440A68E839814C", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "tcp", - }, - "timestamp": "2019-01-28T17:47:18.080Z", + "timestamp": "2019-01-28T17:47:18.080Z", + }, + Object { + "docId": "3ewjio21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", }, - Object { - "error": Object { - "message": "dial tcp 127.0.0.1:9200: connect: connection refused", - "type": "io", - }, - "http": null, - "id": "id7", - "monitor": Object { - "duration": Object { - "us": 5384, - }, - "id": "auto-tcp-0X81440A68E839814C", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "tcp", + "monitor": Object { + "duration": Object { + "us": 5384, }, - "timestamp": "2019-01-28T17:47:19.076Z", + "id": "auto-tcp-0X81440A68E839814I", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", }, - Object { - "error": Object { - "message": "Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused", - "type": "io", - }, - "http": null, - "id": "id8", - "monitor": Object { - "duration": Object { - "us": 5397, - }, - "id": "auto-http-0X3675F89EF0612091", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "http", + "timestamp": "2019-01-28T17:47:19.076Z", + }, + Object { + "docId": "fewjip21", + "error": Object { + "message": "Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused", + "type": "io", + }, + "monitor": Object { + "duration": Object { + "us": 5397, }, - "timestamp": "2019-01-28T17:47:19.076Z", + "id": "auto-http-0X3675F89EF061209J", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "http", }, - Object { - "error": null, - "http": Object { - "response": Object { - "status_code": 200, - }, + "timestamp": "2019-01-28T17:47:19.076Z", + }, + Object { + "docId": "fewjio21", + "http": Object { + "response": Object { + "status_code": 200, }, - "id": "id9", - "monitor": Object { - "duration": Object { - "us": 127511, - }, - "id": "auto-http-0X131221E73F825974", - "ip": "172.217.7.4", - "name": "", - "scheme": null, - "status": "up", - "type": "http", + }, + "monitor": Object { + "duration": Object { + "us": 127511, }, - "timestamp": "2019-01-28T17:47:19.077Z", + "id": "auto-tcp-0X81440A68E839814C", + "ip": "172.217.7.4", + "name": "", + "status": "up", + "type": "http", }, - Object { - "error": null, - "http": Object { - "response": Object { - "status_code": 200, - }, + "timestamp": "2019-01-28T17:47:19.077Z", + }, + Object { + "docId": "fewjik81", + "http": Object { + "response": Object { + "status_code": 200, }, - "id": "id10", - "monitor": Object { - "duration": Object { - "us": 287543, - }, - "id": "auto-http-0X9CB71300ABD5A2A8", - "ip": "192.30.253.112", - "name": "", - "scheme": null, - "status": "up", - "type": "http", + }, + "monitor": Object { + "duration": Object { + "us": 287543, }, - "timestamp": "2019-01-28T17:47:19.077Z", + "id": "auto-http-0X131221E73F825974", + "ip": "192.30.253.112", + "name": "", + "status": "up", + "type": "http", }, - ] - } - loading={false} - noItemsMessage="No items found" - onChange={[Function]} - pagination={ - Object { - "initialPageSize": 25, - "pageIndex": 0, - "pageSize": 10, - "pageSizeOptions": Array [ - 10, - 25, - 50, - 100, - ], - "totalItemCount": 9231, - } + "timestamp": "2019-01-28T17:47:19.077Z", + }, + ] + } + loading={false} + noItemsMessage="No items found" + onChange={[Function]} + pagination={ + Object { + "initialPageSize": 10, + "pageIndex": 0, + "pageSize": 10, + "pageSizeOptions": Array [ + 10, + 25, + 50, + 100, + ], + "totalItemCount": 10, } - responsive={true} - tableLayout="fixed" - /> - </EuiPanel> -</Fragment> + } + responsive={true} + tableLayout="fixed" + /> +</EuiPanel> `; diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/expanded_row.test.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/expanded_row.test.tsx index 9dbe48ec5553a..2c1434cfd64bd 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/expanded_row.test.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/expanded_row.test.tsx @@ -7,15 +7,23 @@ import { mountWithIntl, renderWithIntl, shallowWithIntl } from 'test_utils/enzyme_helpers'; import React from 'react'; import { PingListExpandedRowComponent } from '../expanded_row'; -import { Ping } from '../../../../../common/graphql/types'; +import { Ping } from '../../../../../common/runtime_types'; import { DocLinkForBody } from '../doc_link_body'; describe('PingListExpandedRow', () => { let ping: Ping; beforeEach(() => { ping = { - id: '123', + docId: 'fdeio12', timestamp: '19290310', + monitor: { + duration: { + us: 12345, + }, + id: '123', + status: 'down', + type: 'http', + }, http: { response: { body: { @@ -34,7 +42,7 @@ describe('PingListExpandedRow', () => { it('renders error information when an error field is present', () => { ping.error = { - code: 403, + code: '403', message: 'Forbidden', }; expect(shallowWithIntl(<PingListExpandedRowComponent ping={ping} />)).toMatchSnapshot(); diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/ping_list.test.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/ping_list.test.tsx index 68d285bd0baf1..ec256a886aa16 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/ping_list.test.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/__tests__/ping_list.test.tsx @@ -6,211 +6,188 @@ import React from 'react'; import { shallowWithIntl } from 'test_utils/enzyme_helpers'; -import { PingResults, Ping } from '../../../../../common/graphql/types'; -import { PingListComponent, AllLocationOption, toggleDetails } from '../ping_list'; +import { PingListComponent, toggleDetails } from '../ping_list'; import { ExpandedRowMap } from '../../monitor_list/types'; +import { Ping, PingsResponse } from '../../../../../common/runtime_types'; describe('PingList component', () => { - let pingList: { allPings: PingResults }; + let response: PingsResponse; beforeEach(() => { - pingList = { - allPings: { - total: 9231, - pings: [ - { - id: 'id1', - timestamp: '2019-01-28T17:47:08.078Z', - http: null, - error: { - message: 'dial tcp 127.0.0.1:9200: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 1430 }, - id: 'auto-tcp-0X81440A68E839814C', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'tcp', - }, - }, - { - id: 'id2', - timestamp: '2019-01-28T17:47:09.075Z', - http: null, - error: { - message: 'dial tcp 127.0.0.1:9200: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 1370 }, - id: 'auto-tcp-0X81440A68E839814C', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'tcp', - }, - }, - { - id: 'id3', - timestamp: '2019-01-28T17:47:06.077Z', - http: null, - error: null, - monitor: { - duration: { us: 1452 }, - id: 'auto-tcp-0X81440A68E839814C', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'up', - type: 'tcp', - }, - }, - { - id: 'id4', - timestamp: '2019-01-28T17:47:07.075Z', - http: null, - error: { - message: 'dial tcp 127.0.0.1:9200: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 1094 }, - id: 'auto-tcp-0X81440A68E839814C', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'tcp', - }, - }, - { - id: 'id5', - timestamp: '2019-01-28T17:47:07.074Z', - http: null, - error: { - message: - 'Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 1597 }, - id: 'auto-http-0X3675F89EF0612091', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'http', - }, - }, - { - id: 'id6', - timestamp: '2019-01-28T17:47:18.080Z', - http: null, - error: { - message: 'dial tcp 127.0.0.1:9200: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 1699 }, - id: 'auto-tcp-0X81440A68E839814C', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'tcp', - }, - }, - { - id: 'id7', - timestamp: '2019-01-28T17:47:19.076Z', - http: null, - error: { - message: 'dial tcp 127.0.0.1:9200: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 5384 }, - id: 'auto-tcp-0X81440A68E839814C', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'tcp', - }, - }, - { - id: 'id8', - timestamp: '2019-01-28T17:47:19.076Z', - http: null, - error: { - message: - 'Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused', - type: 'io', - }, - monitor: { - duration: { us: 5397 }, - id: 'auto-http-0X3675F89EF0612091', - ip: '127.0.0.1', - name: '', - scheme: null, - status: 'down', - type: 'http', - }, - }, - { - id: 'id9', - timestamp: '2019-01-28T17:47:19.077Z', - http: { response: { status_code: 200 } }, - error: null, - monitor: { - duration: { us: 127511 }, - id: 'auto-http-0X131221E73F825974', - ip: '172.217.7.4', - name: '', - scheme: null, - status: 'up', - type: 'http', - }, - }, - { - id: 'id10', - timestamp: '2019-01-28T17:47:19.077Z', - http: { response: { status_code: 200 } }, - error: null, - monitor: { - duration: { us: 287543 }, - id: 'auto-http-0X9CB71300ABD5A2A8', - ip: '192.30.253.112', - name: '', - scheme: null, - status: 'up', - type: 'http', - }, - }, - ], - locations: ['nyc'], - }, + response = { + total: 9231, + locations: ['nyc'], + pings: [ + { + docId: 'fewjio21', + timestamp: '2019-01-28T17:47:08.078Z', + error: { + message: 'dial tcp 127.0.0.1:9200: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 1430 }, + id: 'auto-tcp-0X81440A68E839814F', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'tcp', + }, + }, + { + docId: 'fewjoo21', + timestamp: '2019-01-28T17:47:09.075Z', + error: { + message: 'dial tcp 127.0.0.1:9200: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 1370 }, + id: 'auto-tcp-0X81440A68E839814D', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'tcp', + }, + }, + { + docId: 'fejjio21', + timestamp: '2019-01-28T17:47:06.077Z', + monitor: { + duration: { us: 1452 }, + id: 'auto-tcp-0X81440A68E839814D', + ip: '127.0.0.1', + name: '', + status: 'up', + type: 'tcp', + }, + }, + { + docId: 'fewzio21', + timestamp: '2019-01-28T17:47:07.075Z', + error: { + message: 'dial tcp 127.0.0.1:9200: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 1094 }, + id: 'auto-tcp-0X81440A68E839814E', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'tcp', + }, + }, + { + docId: 'fewpi321', + timestamp: '2019-01-28T17:47:07.074Z', + error: { + message: + 'Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 1597 }, + id: 'auto-http-0X3675F89EF061209G', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'http', + }, + }, + { + docId: '0ewjio21', + timestamp: '2019-01-28T17:47:18.080Z', + error: { + message: 'dial tcp 127.0.0.1:9200: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 1699 }, + id: 'auto-tcp-0X81440A68E839814H', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'tcp', + }, + }, + { + docId: '3ewjio21', + timestamp: '2019-01-28T17:47:19.076Z', + error: { + message: 'dial tcp 127.0.0.1:9200: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 5384 }, + id: 'auto-tcp-0X81440A68E839814I', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'tcp', + }, + }, + { + docId: 'fewjip21', + timestamp: '2019-01-28T17:47:19.076Z', + error: { + message: + 'Get http://localhost:12349/: dial tcp 127.0.0.1:12349: connect: connection refused', + type: 'io', + }, + monitor: { + duration: { us: 5397 }, + id: 'auto-http-0X3675F89EF061209J', + ip: '127.0.0.1', + name: '', + status: 'down', + type: 'http', + }, + }, + { + docId: 'fewjio21', + timestamp: '2019-01-28T17:47:19.077Z', + http: { response: { status_code: 200 } }, + monitor: { + duration: { us: 127511 }, + id: 'auto-tcp-0X81440A68E839814C', + ip: '172.217.7.4', + name: '', + status: 'up', + type: 'http', + }, + }, + { + docId: 'fewjik81', + timestamp: '2019-01-28T17:47:19.077Z', + http: { response: { status_code: 200 } }, + monitor: { + duration: { us: 287543 }, + id: 'auto-http-0X131221E73F825974', + ip: '192.30.253.112', + name: '', + status: 'up', + type: 'http', + }, + }, + ], }; }); it('renders sorted list without errors', () => { - const { allPings } = pingList; const component = shallowWithIntl( <PingListComponent + dateRange={{ + from: 'now-15m', + to: 'now', + }} + getPings={jest.fn()} + lastRefresh={123} loading={false} - data={{ allPings }} - onPageCountChange={jest.fn()} - onPageIndexChange={jest.fn()} - onSelectedLocationChange={(_loc: any[]) => {}} - onSelectedStatusChange={jest.fn()} - pageIndex={0} - pageSize={10} - selectedOption="down" - selectedLocation={AllLocationOption.value} + locations={[]} + monitorId="foo" + pings={response.pings} + total={10} /> ); expect(component).toMatchSnapshot(); @@ -224,13 +201,38 @@ describe('PingList component', () => { beforeEach(() => { itemIdToExpandedRowMap = {}; - pings = pingList.allPings.pings; + pings = response.pings; }); it('should expand an item if empty', () => { const ping = pings[0]; toggleDetails(ping, itemIdToExpandedRowMap, setItemIdToExpandedRowMap); - expect(itemIdToExpandedRowMap).toHaveProperty(ping.id); + expect(itemIdToExpandedRowMap).toMatchInlineSnapshot(` + Object { + "fewjio21": <PingListExpandedRowComponent + ping={ + Object { + "docId": "fewjio21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", + }, + "monitor": Object { + "duration": Object { + "us": 1430, + }, + "id": "auto-tcp-0X81440A68E839814F", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", + }, + "timestamp": "2019-01-28T17:47:08.078Z", + } + } + />, + } + `); }); it('should un-expand an item if clicked again', () => { @@ -245,7 +247,31 @@ describe('PingList component', () => { const pingB = pings[1]; toggleDetails(pingA, itemIdToExpandedRowMap, setItemIdToExpandedRowMap); toggleDetails(pingB, itemIdToExpandedRowMap, setItemIdToExpandedRowMap); - expect(itemIdToExpandedRowMap).toHaveProperty(pingB.id); + expect(pingA.docId).not.toEqual(pingB.docId); + expect(itemIdToExpandedRowMap[pingB.docId]).toMatchInlineSnapshot(` + <PingListExpandedRowComponent + ping={ + Object { + "docId": "fewjoo21", + "error": Object { + "message": "dial tcp 127.0.0.1:9200: connect: connection refused", + "type": "io", + }, + "monitor": Object { + "duration": Object { + "us": 1370, + }, + "id": "auto-tcp-0X81440A68E839814D", + "ip": "127.0.0.1", + "name": "", + "status": "down", + "type": "tcp", + }, + "timestamp": "2019-01-28T17:47:09.075Z", + } + } + /> + `); }); }); }); diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/expanded_row.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/expanded_row.tsx index c684235122e34..28b96fcb1bf7b 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/expanded_row.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/expanded_row.tsx @@ -16,14 +16,14 @@ import { } from '@elastic/eui'; import React from 'react'; import { i18n } from '@kbn/i18n'; -import { Ping, HttpBody } from '../../../../common/graphql/types'; +import { Ping, HttpResponseBody } from '../../../../common/runtime_types'; import { DocLinkForBody } from './doc_link_body'; interface Props { ping: Ping; } -const BodyDescription = ({ body }: { body: HttpBody }) => { +const BodyDescription = ({ body }: { body: HttpResponseBody }) => { const contentBytes = body.content_bytes || 0; const bodyBytes = body.bytes || 0; diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/index.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/index.tsx index e57b229dfd973..808f3f90ef015 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/index.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/index.tsx @@ -4,4 +4,4 @@ * you may not use this file except in compliance with the Elastic License. */ -export * from './ping_list'; +export { PingListComponent } from './ping_list'; diff --git a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/ping_list.tsx b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/ping_list.tsx index 19768c7104e91..934dfd961f9e0 100644 --- a/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/ping_list.tsx +++ b/x-pack/legacy/plugins/uptime/public/components/functional/ping_list/ping_list.tsx @@ -20,109 +20,127 @@ import { } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { FormattedMessage } from '@kbn/i18n/react'; -import { get } from 'lodash'; import moment from 'moment'; -import React, { Fragment, useState } from 'react'; +import React, { useState, useEffect } from 'react'; import styled from 'styled-components'; -import { CriteriaWithPagination } from '@elastic/eui/src/components/basic_table/basic_table'; -import { Ping, PingResults } from '../../../../common/graphql/types'; +import { Ping, GetPingsParams, DateRange } from '../../../../common/runtime_types'; import { convertMicrosecondsToMilliseconds as microsToMillis } from '../../../lib/helper'; -import { UptimeGraphQLQueryProps, withUptimeGraphQL } from '../../higher_order'; -import { pingsQuery } from '../../../queries'; import { LocationName } from './location_name'; import { Pagination } from './../monitor_list'; import { PingListExpandedRowComponent } from './expanded_row'; +import { PingListProps } from '../../connected/pings'; -interface PingListQueryResult { - allPings?: PingResults; -} - -interface PingListProps { - onSelectedStatusChange: (status: string | undefined) => void; - onSelectedLocationChange: (location: any) => void; - onPageCountChange: (itemCount: number) => void; - onPageIndexChange: (index: number) => void; - pageSize: number; - pageIndex: number; - selectedOption: string; - selectedLocation: string | undefined; -} - -type Props = UptimeGraphQLQueryProps<PingListQueryResult> & PingListProps; -interface ExpandedRowMap { - [key: string]: JSX.Element; -} - -export const AllLocationOption = { text: 'All', value: '' }; +export const AllLocationOption = { + 'data-test-subj': 'xpack.uptime.pingList.locationOptions.all', + text: 'All', + value: '', +}; export const toggleDetails = ( ping: Ping, - itemIdToExpandedRowMap: ExpandedRowMap, - setItemIdToExpandedRowMap: (update: ExpandedRowMap) => any + expandedRows: Record<string, JSX.Element>, + setExpandedRows: (update: Record<string, JSX.Element>) => any ) => { - // If the user has clicked on the expanded map, close all expanded rows. - if (itemIdToExpandedRowMap[ping.id]) { - setItemIdToExpandedRowMap({}); + // If already expanded, collapse + if (expandedRows[ping.docId]) { + delete expandedRows[ping.docId]; + setExpandedRows({ ...expandedRows }); return; } // Otherwise expand this row - const newItemIdToExpandedRowMap: ExpandedRowMap = {}; - newItemIdToExpandedRowMap[ping.id] = <PingListExpandedRowComponent ping={ping} />; - setItemIdToExpandedRowMap(newItemIdToExpandedRowMap); + setExpandedRows({ + ...expandedRows, + [ping.docId]: <PingListExpandedRowComponent ping={ping} />, + }); }; const SpanWithMargin = styled.span` margin-right: 16px; `; -export const PingListComponent = ({ - data, - loading, - onPageCountChange, - onPageIndexChange, - onSelectedLocationChange, - onSelectedStatusChange, - pageIndex, - pageSize, - selectedOption, - selectedLocation, -}: Props) => { - const [itemIdToExpandedRowMap, setItemIdToExpandedRowMap] = useState<ExpandedRowMap>({}); +interface Props extends PingListProps { + dateRange: DateRange; + error?: Error; + getPings: (props: GetPingsParams) => void; + lastRefresh: number; + loading: boolean; + locations: string[]; + pings: Ping[]; + total: number; +} + +const DEFAULT_PAGE_SIZE = 10; + +const statusOptions = [ + { + 'data-test-subj': 'xpack.uptime.pingList.statusOptions.all', + text: i18n.translate('xpack.uptime.pingList.statusOptions.allStatusOptionLabel', { + defaultMessage: 'All', + }), + value: '', + }, + { + 'data-test-subj': 'xpack.uptime.pingList.statusOptions.up', + text: i18n.translate('xpack.uptime.pingList.statusOptions.upStatusOptionLabel', { + defaultMessage: 'Up', + }), + value: 'up', + }, + { + 'data-test-subj': 'xpack.uptime.pingList.statusOptions.down', + text: i18n.translate('xpack.uptime.pingList.statusOptions.downStatusOptionLabel', { + defaultMessage: 'Down', + }), + value: 'down', + }, +]; + +export const PingListComponent = (props: Props) => { + const [selectedLocation, setSelectedLocation] = useState<string>(''); + const [status, setStatus] = useState<string>(''); + const [pageSize, setPageSize] = useState(DEFAULT_PAGE_SIZE); + const [pageIndex, setPageIndex] = useState(0); + const { + dateRange: { from, to }, + error, + getPings, + lastRefresh, + loading, + locations, + monitorId, + pings, + total, + } = props; + + useEffect(() => { + getPings({ + dateRange: { + from, + to, + }, + location: selectedLocation, + monitorId, + index: pageIndex, + size: pageSize, + status: status !== 'all' ? status : '', + }); + }, [from, to, getPings, monitorId, lastRefresh, selectedLocation, pageIndex, pageSize, status]); + + const [expandedRows, setExpandedRows] = useState<Record<string, JSX.Element>>({}); - const statusOptions = [ - { - text: i18n.translate('xpack.uptime.pingList.statusOptions.allStatusOptionLabel', { - defaultMessage: 'All', - }), - value: '', - }, - { - text: i18n.translate('xpack.uptime.pingList.statusOptions.upStatusOptionLabel', { - defaultMessage: 'Up', - }), - value: 'up', - }, - { - text: i18n.translate('xpack.uptime.pingList.statusOptions.downStatusOptionLabel', { - defaultMessage: 'Down', - }), - value: 'down', - }, - ]; - const locations = get<string[]>(data, 'allPings.locations'); const locationOptions = !locations ? [AllLocationOption] : [AllLocationOption].concat( - locations.map(name => { - return { text: name, value: name }; - }) + locations.map(name => ({ + text: name, + 'data-test-subj': `xpack.uptime.pingList.locationOptions.${name}`, + value: name, + })) ); - const pings: Ping[] = data?.allPings?.pings ?? []; - const hasStatus: boolean = pings.reduce( - (hasHttpStatus: boolean, currentPing: Ping) => + (hasHttpStatus: boolean, currentPing) => hasHttpStatus || !!currentPing.http?.response?.status_code, false ); @@ -134,7 +152,7 @@ export const PingListComponent = ({ defaultMessage: 'Status', }), render: (pingStatus: string, item: Ping) => ( - <div> + <div data-test-subj={`xpack.uptime.pingList.ping-${item.docId}`}> <EuiHealth color={pingStatus === 'up' ? 'success' : 'danger'}> {pingStatus === 'up' ? i18n.translate('xpack.uptime.pingList.statusColumnHealthUpLabel', { @@ -189,7 +207,7 @@ export const PingListComponent = ({ name: i18n.translate('xpack.uptime.pingList.errorTypeColumnLabel', { defaultMessage: 'Error type', }), - render: (error: string) => error ?? '-', + render: (errorType: string) => errorType ?? '-', }, // Only add this column is there is any status present in list ...(hasStatus @@ -219,16 +237,16 @@ export const PingListComponent = ({ render: (item: Ping) => { return ( <EuiButtonIcon - onClick={() => toggleDetails(item, itemIdToExpandedRowMap, setItemIdToExpandedRowMap)} - disabled={!item.error && !(item.http?.response?.body?.bytes > 0)} + onClick={() => toggleDetails(item, expandedRows, setExpandedRows)} + disabled={!item.error && !(item.http?.response?.body?.bytes ?? 0 > 0)} aria-label={ - itemIdToExpandedRowMap[item.id] + expandedRows[item.docId] ? i18n.translate('xpack.uptime.pingList.collapseRow', { defaultMessage: 'Collapse', }) : i18n.translate('xpack.uptime.pingList.expandRow', { defaultMessage: 'Expand' }) } - iconType={itemIdToExpandedRowMap[item.id] ? 'arrowUp' : 'arrowDown'} + iconType={expandedRows[item.docId] ? 'arrowUp' : 'arrowDown'} /> ); }, @@ -236,104 +254,83 @@ export const PingListComponent = ({ ]; const pagination: Pagination = { - initialPageSize: 25, + initialPageSize: DEFAULT_PAGE_SIZE, pageIndex, pageSize, pageSizeOptions: [10, 25, 50, 100], - totalItemCount: data?.allPings?.total ?? pageSize, + /** + * we're not currently supporting pagination in this component + * so the first page is the only page + */ + totalItemCount: total, }; return ( - <Fragment> - <EuiPanel> - <EuiTitle size="xs"> - <h4> - <FormattedMessage - id="xpack.uptime.pingList.checkHistoryTitle" - defaultMessage="History" + <EuiPanel> + <EuiTitle size="xs"> + <h4> + <FormattedMessage id="xpack.uptime.pingList.checkHistoryTitle" defaultMessage="History" /> + </h4> + </EuiTitle> + <EuiSpacer size="s" /> + <EuiFlexGroup justifyContent="spaceBetween"> + <EuiFlexItem grow={false}> + <EuiFormRow + label="Status" + aria-label={i18n.translate('xpack.uptime.pingList.statusLabel', { + defaultMessage: 'Status', + })} + > + <EuiSelect + options={statusOptions} + aria-label={i18n.translate('xpack.uptime.pingList.statusLabel', { + defaultMessage: 'Status', + })} + data-test-subj="xpack.uptime.pingList.statusSelect" + value={status} + onChange={selected => { + setStatus(selected.target.value); + }} /> - </h4> - </EuiTitle> - <EuiSpacer size="s" /> - <EuiFlexGroup justifyContent="spaceBetween"> - <EuiFlexItem grow={false}> - <EuiFlexGroup> - <EuiFlexItem style={{ minWidth: 200 }}> - <EuiFlexGroup> - <EuiFlexItem> - <EuiFormRow - label="Status" - aria-label={i18n.translate('xpack.uptime.pingList.statusLabel', { - defaultMessage: 'Status', - })} - > - <EuiSelect - options={statusOptions} - aria-label={i18n.translate('xpack.uptime.pingList.statusLabel', { - defaultMessage: 'Status', - })} - value={selectedOption} - onChange={selected => { - if (typeof selected.target.value === 'string') { - onSelectedStatusChange( - selected.target && selected.target.value !== '' - ? selected.target.value - : undefined - ); - } - }} - /> - </EuiFormRow> - </EuiFlexItem> - <EuiFlexItem> - <EuiFormRow - label="Location" - aria-label={i18n.translate('xpack.uptime.pingList.locationLabel', { - defaultMessage: 'Location', - })} - > - <EuiSelect - options={locationOptions} - value={selectedLocation} - aria-label={i18n.translate('xpack.uptime.pingList.locationLabel', { - defaultMessage: 'Location', - })} - onChange={selected => { - onSelectedLocationChange( - selected.target && selected.target.value !== '' - ? selected.target.value - : null - ); - }} - /> - </EuiFormRow> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - </EuiFlexGroup> - </EuiFlexItem> - </EuiFlexGroup> - <EuiSpacer size="s" /> - <EuiBasicTable - loading={loading} - columns={columns} - isExpandable={true} - hasActions={true} - items={pings} - itemId="id" - itemIdToExpandedRowMap={itemIdToExpandedRowMap} - pagination={pagination} - onChange={(criteria: CriteriaWithPagination<Ping>) => { - onPageCountChange(criteria.page!.size); - onPageIndexChange(criteria.page!.index); - }} - /> - </EuiPanel> - </Fragment> + </EuiFormRow> + </EuiFlexItem> + <EuiFlexItem> + <EuiFormRow + label="Location" + aria-label={i18n.translate('xpack.uptime.pingList.locationLabel', { + defaultMessage: 'Location', + })} + > + <EuiSelect + options={locationOptions} + value={selectedLocation} + aria-label={i18n.translate('xpack.uptime.pingList.locationLabel', { + defaultMessage: 'Location', + })} + data-test-subj="xpack.uptime.pingList.locationSelect" + onChange={selected => { + setSelectedLocation(selected.target.value); + }} + /> + </EuiFormRow> + </EuiFlexItem> + </EuiFlexGroup> + <EuiSpacer size="s" /> + <EuiBasicTable + loading={loading} + columns={columns} + error={error?.message} + isExpandable={true} + hasActions={true} + items={pings} + itemId="docId" + itemIdToExpandedRowMap={expandedRows} + pagination={pagination} + onChange={(criteria: any) => { + setPageSize(criteria.page!.size); + setPageIndex(criteria.page!.index); + }} + /> + </EuiPanel> ); }; - -export const PingList = withUptimeGraphQL<PingListQueryResult, PingListProps>( - PingListComponent, - pingsQuery -); diff --git a/x-pack/legacy/plugins/uptime/public/hooks/index.ts b/x-pack/legacy/plugins/uptime/public/hooks/index.ts index e022248df407a..1f50e995eda49 100644 --- a/x-pack/legacy/plugins/uptime/public/hooks/index.ts +++ b/x-pack/legacy/plugins/uptime/public/hooks/index.ts @@ -4,6 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ +export * from './use_monitor'; export * from './use_url_params'; export * from './use_telemetry'; export * from './update_kuery_string'; diff --git a/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx b/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx index 5016ccebbab54..683af81239c99 100644 --- a/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx +++ b/x-pack/legacy/plugins/uptime/public/pages/monitor.tsx @@ -5,39 +5,21 @@ */ import { EuiSpacer } from '@elastic/eui'; -import React, { useContext, useState } from 'react'; +import React from 'react'; import { useSelector } from 'react-redux'; -import { MonitorCharts, PingList } from '../components/functional'; -import { UptimeRefreshContext } from '../contexts'; -import { useUptimeTelemetry, useUrlParams, UptimePage } from '../hooks'; import { useTrackPageview } from '../../../../../plugins/observability/public'; -import { MonitorStatusDetails } from '../components/connected'; +import { MonitorStatusDetails, PingList } from '../components/connected'; import { monitorStatusSelector } from '../state/selectors'; import { PageHeader } from './page_header'; +import { MonitorCharts } from '../components/functional'; import { useBreadcrumbs } from '../hooks/use_breadcrumbs'; -import { useMonitorId } from '../hooks/use_monitor'; +import { useMonitorId, useUptimeTelemetry, UptimePage } from '../hooks'; export const MonitorPage: React.FC = () => { const monitorId = useMonitorId(); - const [pingListPageCount, setPingListPageCount] = useState<number>(10); - const { refreshApp } = useContext(UptimeRefreshContext); - const [getUrlParams, updateUrlParams] = useUrlParams(); - const { absoluteDateRangeStart, absoluteDateRangeEnd, ...params } = getUrlParams(); - const { dateRangeStart, dateRangeEnd, selectedPingStatus } = params; - - const [selectedLocation, setSelectedLocation] = useState(undefined); - const [pingListIndex, setPingListIndex] = useState(0); - const selectedMonitor = useSelector(monitorStatusSelector); - const sharedVariables = { - dateRangeStart, - dateRangeEnd, - monitorId, - location: selectedLocation, - }; - useUptimeTelemetry(UptimePage.Monitor); useTrackPageview({ app: 'uptime', path: 'monitor' }); @@ -53,25 +35,7 @@ export const MonitorPage: React.FC = () => { <EuiSpacer size="s" /> <MonitorCharts monitorId={monitorId} /> <EuiSpacer size="s" /> - <PingList - onPageCountChange={setPingListPageCount} - onSelectedLocationChange={setSelectedLocation} - onSelectedStatusChange={(selectedStatus: string | undefined) => { - updateUrlParams({ selectedPingStatus: selectedStatus || '' }); - refreshApp(); - }} - onPageIndexChange={(index: number) => setPingListIndex(index)} - pageIndex={pingListIndex} - pageSize={pingListPageCount} - selectedOption={selectedPingStatus} - selectedLocation={selectedLocation} - variables={{ - ...sharedVariables, - page: pingListIndex, - size: pingListPageCount, - status: selectedPingStatus, - }} - /> + <PingList monitorId={monitorId} /> </> ); }; diff --git a/x-pack/legacy/plugins/uptime/public/queries/pings_query.ts b/x-pack/legacy/plugins/uptime/public/queries/pings_query.ts deleted file mode 100644 index ed20fe8eb2931..0000000000000 --- a/x-pack/legacy/plugins/uptime/public/queries/pings_query.ts +++ /dev/null @@ -1,73 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import gql from 'graphql-tag'; - -export const pingsQueryString = ` -query PingList( - $dateRangeStart: String! - $dateRangeEnd: String! - $monitorId: String - $status: String - $sort: String - $size: Int - $location: String - $page: Int -) { - allPings( - dateRangeStart: $dateRangeStart - dateRangeEnd: $dateRangeEnd - monitorId: $monitorId - status: $status - sort: $sort - size: $size - location: $location - page: $page - ) { - total - locations - pings { - id - timestamp - http { - response { - status_code - body { - bytes - hash - content - content_bytes - } - } - } - error { - message - type - } - monitor { - duration { - us - } - id - ip - name - scheme - status - type - } - observer { - geo { - name - } - } - } - } - } -`; - -export const pingsQuery = gql` - ${pingsQueryString} -`; diff --git a/x-pack/legacy/plugins/uptime/public/state/actions/monitor_status.ts b/x-pack/legacy/plugins/uptime/public/state/actions/monitor_status.ts index a8f37d38ebae6..e8c862e209739 100644 --- a/x-pack/legacy/plugins/uptime/public/state/actions/monitor_status.ts +++ b/x-pack/legacy/plugins/uptime/public/state/actions/monitor_status.ts @@ -5,7 +5,7 @@ */ import { createAction } from 'redux-actions'; import { QueryParams } from './types'; -import { Ping } from '../../../common/graphql/types'; +import { Ping } from '../../../common/runtime_types'; export const getMonitorStatusAction = createAction<QueryParams>('GET_MONITOR_STATUS'); export const getMonitorStatusActionSuccess = createAction<Ping>('GET_MONITOR_STATUS_SUCCESS'); diff --git a/x-pack/legacy/plugins/uptime/public/state/actions/ping.ts b/x-pack/legacy/plugins/uptime/public/state/actions/ping.ts index bb7258d9a54b2..70918a4cc70e5 100644 --- a/x-pack/legacy/plugins/uptime/public/state/actions/ping.ts +++ b/x-pack/legacy/plugins/uptime/public/state/actions/ping.ts @@ -5,8 +5,17 @@ */ import { createAction } from 'redux-actions'; -import { GetPingHistogramParams, HistogramResult } from '../../../common/types'; +import { + GetPingHistogramParams, + HistogramResult, + PingsResponse, + GetPingsParams, +} from '../../../common/runtime_types'; export const getPingHistogram = createAction<GetPingHistogramParams>('GET_PING_HISTOGRAM'); export const getPingHistogramSuccess = createAction<HistogramResult>('GET_PING_HISTOGRAM_SUCCESS'); export const getPingHistogramFail = createAction<Error>('GET_PING_HISTOGRAM_FAIL'); + +export const getPings = createAction<GetPingsParams>('GET PINGS'); +export const getPingsSuccess = createAction<PingsResponse>('GET PINGS SUCCESS'); +export const getPingsFail = createAction<Error>('GET PINGS FAIL'); diff --git a/x-pack/legacy/plugins/uptime/public/state/api/monitor_status.ts b/x-pack/legacy/plugins/uptime/public/state/api/monitor_status.ts index f9e171adda334..7c8ab3518b5a0 100644 --- a/x-pack/legacy/plugins/uptime/public/state/api/monitor_status.ts +++ b/x-pack/legacy/plugins/uptime/public/state/api/monitor_status.ts @@ -5,9 +5,9 @@ */ import { QueryParams } from '../actions/types'; -import { Ping } from '../../../common/graphql/types'; -import { apiService } from './utils'; +import { Ping } from '../../../common/runtime_types'; import { API_URLS } from '../../../common/constants'; +import { apiService } from './utils'; export const fetchMonitorStatus = async ({ monitorId, diff --git a/x-pack/legacy/plugins/uptime/public/state/api/ping.ts b/x-pack/legacy/plugins/uptime/public/state/api/ping.ts index df71cc8d67bd0..bbd3ddf399dcc 100644 --- a/x-pack/legacy/plugins/uptime/public/state/api/ping.ts +++ b/x-pack/legacy/plugins/uptime/public/state/api/ping.ts @@ -5,10 +5,21 @@ */ import { APIFn } from './types'; -import { GetPingHistogramParams, HistogramResult } from '../../../common/types'; +import { + PingsResponseType, + PingsResponse, + GetPingsParams, + GetPingHistogramParams, + HistogramResult, +} from '../../../common/runtime_types'; import { apiService } from './utils'; import { API_URLS } from '../../../common/constants/rest_api'; +export const fetchPings: APIFn<GetPingsParams, PingsResponse> = async ({ + dateRange: { from, to }, + ...optional +}) => await apiService.get(API_URLS.PINGS, { from, to, ...optional }, PingsResponseType); + export const fetchPingHistogram: APIFn<GetPingHistogramParams, HistogramResult> = async ({ monitorId, dateStart, @@ -19,9 +30,9 @@ export const fetchPingHistogram: APIFn<GetPingHistogramParams, HistogramResult> const queryParams = { dateStart, dateEnd, - ...(monitorId && { monitorId }), - ...(statusFilter && { statusFilter }), - ...(filters && { filters }), + monitorId, + statusFilter, + filters, }; return await apiService.get(API_URLS.PING_HISTOGRAM, queryParams); diff --git a/x-pack/legacy/plugins/uptime/public/state/effects/fetch_effect.ts b/x-pack/legacy/plugins/uptime/public/state/effects/fetch_effect.ts index 49e497952ea44..b0734cb5ccabb 100644 --- a/x-pack/legacy/plugins/uptime/public/state/effects/fetch_effect.ts +++ b/x-pack/legacy/plugins/uptime/public/state/effects/fetch_effect.ts @@ -16,7 +16,7 @@ import { IHttpFetchError } from '../../../../../../../target/types/core/public/h * @param fail creates a failure action * @template T the action type expected by the fetch action * @template R the type that the API request should return on success - * @template S tye type of the success action + * @template S the type of the success action * @template F the type of the failure action */ export function fetchEffectFactory<T, R, S, F>( diff --git a/x-pack/legacy/plugins/uptime/public/state/effects/index.ts b/x-pack/legacy/plugins/uptime/public/state/effects/index.ts index 8d457be1d1c78..8df11312b6455 100644 --- a/x-pack/legacy/plugins/uptime/public/state/effects/index.ts +++ b/x-pack/legacy/plugins/uptime/public/state/effects/index.ts @@ -11,7 +11,7 @@ import { fetchSnapshotCountEffect } from './snapshot'; import { fetchMonitorStatusEffect } from './monitor_status'; import { fetchDynamicSettingsEffect, setDynamicSettingsEffect } from './dynamic_settings'; import { fetchIndexPatternEffect } from './index_pattern'; -import { fetchPingHistogramEffect } from './ping'; +import { fetchPingsEffect, fetchPingHistogramEffect } from './ping'; import { fetchMonitorDurationEffect } from './monitor_duration'; import { fetchMLJobEffect } from './ml_anomaly'; import { fetchIndexStatusEffect } from './index_status'; @@ -24,6 +24,7 @@ export function* rootEffect() { yield fork(fetchDynamicSettingsEffect); yield fork(setDynamicSettingsEffect); yield fork(fetchIndexPatternEffect); + yield fork(fetchPingsEffect); yield fork(fetchPingHistogramEffect); yield fork(fetchMLJobEffect); yield fork(fetchMonitorDurationEffect); diff --git a/x-pack/legacy/plugins/uptime/public/state/effects/ping.ts b/x-pack/legacy/plugins/uptime/public/state/effects/ping.ts index acb9b31915fa9..dec67ed8cf979 100644 --- a/x-pack/legacy/plugins/uptime/public/state/effects/ping.ts +++ b/x-pack/legacy/plugins/uptime/public/state/effects/ping.ts @@ -5,10 +5,21 @@ */ import { takeLatest } from 'redux-saga/effects'; -import { getPingHistogram, getPingHistogramSuccess, getPingHistogramFail } from '../actions'; -import { fetchPingHistogram } from '../api'; +import { + getPingHistogram, + getPingHistogramSuccess, + getPingHistogramFail, + getPings, + getPingsSuccess, + getPingsFail, +} from '../actions'; +import { fetchPingHistogram, fetchPings } from '../api'; import { fetchEffectFactory } from './fetch_effect'; +export function* fetchPingsEffect() { + yield takeLatest(String(getPings), fetchEffectFactory(fetchPings, getPingsSuccess, getPingsFail)); +} + export function* fetchPingHistogramEffect() { yield takeLatest( String(getPingHistogram), diff --git a/x-pack/legacy/plugins/uptime/public/state/reducers/index.ts b/x-pack/legacy/plugins/uptime/public/state/reducers/index.ts index 7bf8af5dd4d03..0a3ff35df0599 100644 --- a/x-pack/legacy/plugins/uptime/public/state/reducers/index.ts +++ b/x-pack/legacy/plugins/uptime/public/state/reducers/index.ts @@ -13,6 +13,7 @@ import { monitorStatusReducer } from './monitor_status'; import { dynamicSettingsReducer } from './dynamic_settings'; import { indexPatternReducer } from './index_pattern'; import { pingReducer } from './ping'; +import { pingListReducer } from './ping_list'; import { monitorDurationReducer } from './monitor_duration'; import { indexStatusReducer } from './index_status'; import { mlJobsReducer } from './ml_anomaly'; @@ -26,6 +27,7 @@ export const rootReducer = combineReducers({ dynamicSettings: dynamicSettingsReducer, indexPattern: indexPatternReducer, ping: pingReducer, + pingList: pingListReducer, ml: mlJobsReducer, monitorDuration: monitorDurationReducer, indexStatus: indexStatusReducer, diff --git a/x-pack/legacy/plugins/uptime/public/state/reducers/monitor_status.ts b/x-pack/legacy/plugins/uptime/public/state/reducers/monitor_status.ts index 6cfaa9f8f59c1..fa3e377b5ebf4 100644 --- a/x-pack/legacy/plugins/uptime/public/state/reducers/monitor_status.ts +++ b/x-pack/legacy/plugins/uptime/public/state/reducers/monitor_status.ts @@ -9,7 +9,7 @@ import { getMonitorStatusActionSuccess, getMonitorStatusActionFail, } from '../actions'; -import { Ping } from '../../../common/graphql/types'; +import { Ping } from '../../../common/runtime_types'; import { QueryParams } from '../actions/types'; export interface MonitorStatusState { diff --git a/x-pack/legacy/plugins/uptime/public/state/reducers/ping.ts b/x-pack/legacy/plugins/uptime/public/state/reducers/ping.ts index 76775e6a0a355..4c8715038ce36 100644 --- a/x-pack/legacy/plugins/uptime/public/state/reducers/ping.ts +++ b/x-pack/legacy/plugins/uptime/public/state/reducers/ping.ts @@ -6,7 +6,7 @@ import { handleActions, Action } from 'redux-actions'; import { getPingHistogram, getPingHistogramSuccess, getPingHistogramFail } from '../actions'; -import { HistogramResult } from '../../../common/types'; +import { HistogramResult } from '../../../common/runtime_types'; export interface PingState { pingHistogram: HistogramResult | null; diff --git a/x-pack/legacy/plugins/uptime/public/state/reducers/ping_list.ts b/x-pack/legacy/plugins/uptime/public/state/reducers/ping_list.ts new file mode 100644 index 0000000000000..e3ccb1e663eda --- /dev/null +++ b/x-pack/legacy/plugins/uptime/public/state/reducers/ping_list.ts @@ -0,0 +1,48 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { handleActions, Action } from 'redux-actions'; +import { PingsResponse } from '../../../common/runtime_types'; +import { getPings, getPingsSuccess, getPingsFail } from '../actions'; + +export interface PingListState { + pingList: PingsResponse; + error?: Error; + loading: boolean; +} + +const initialState: PingListState = { + pingList: { + total: 0, + locations: [], + pings: [], + }, + loading: false, +}; + +type PingListPayload = PingsResponse & Error; + +export const pingListReducer = handleActions<PingListState, PingListPayload>( + { + [String(getPings)]: state => ({ + ...state, + loading: true, + }), + + [String(getPingsSuccess)]: (state, action: Action<PingsResponse>) => ({ + ...state, + pingList: { ...action.payload }, + loading: false, + }), + + [String(getPingsFail)]: (state, action: Action<Error>) => ({ + ...state, + error: action.payload, + loading: false, + }), + }, + initialState +); diff --git a/x-pack/legacy/plugins/uptime/public/state/selectors/__tests__/index.test.ts b/x-pack/legacy/plugins/uptime/public/state/selectors/__tests__/index.test.ts index 3b4547514a11e..77902f347f6f9 100644 --- a/x-pack/legacy/plugins/uptime/public/state/selectors/__tests__/index.test.ts +++ b/x-pack/legacy/plugins/uptime/public/state/selectors/__tests__/index.test.ts @@ -58,6 +58,14 @@ describe('state selectors', () => { loading: false, errors: [], }, + pingList: { + loading: false, + pingList: { + total: 0, + locations: [], + pings: [], + }, + }, monitorDuration: { durationLines: null, loading: false, diff --git a/x-pack/legacy/plugins/uptime/public/state/selectors/index.ts b/x-pack/legacy/plugins/uptime/public/state/selectors/index.ts index 0fc3c7151cb3b..37695e4274306 100644 --- a/x-pack/legacy/plugins/uptime/public/state/selectors/index.ts +++ b/x-pack/legacy/plugins/uptime/public/state/selectors/index.ts @@ -41,6 +41,11 @@ export const selectPingHistogram = ({ ping, ui }: AppState) => { }; }; +export const selectPingList = ({ pingList, ui: { lastRefresh } }: AppState) => ({ + pings: pingList, + lastRefresh, +}); + const mlCapabilitiesSelector = (state: AppState) => state.ml.mlCapabilities.data; export const hasMLFeatureAvailable = createSelector( diff --git a/x-pack/plugins/uptime/server/graphql/index.ts b/x-pack/plugins/uptime/server/graphql/index.ts index 49ba5583b417b..a88afd7ac769c 100644 --- a/x-pack/plugins/uptime/server/graphql/index.ts +++ b/x-pack/plugins/uptime/server/graphql/index.ts @@ -5,14 +5,13 @@ */ import { createMonitorStatesResolvers, monitorStatesSchema } from './monitor_states'; -import { createPingsResolvers, pingsSchema } from './pings'; +import { pingsSchema } from './pings'; import { CreateUMGraphQLResolvers } from './types'; import { unsignedIntegerResolverFunctions, unsignedIntegerSchema } from './unsigned_int_scalar'; export { DEFAULT_GRAPHQL_PATH } from './constants'; export const resolvers: CreateUMGraphQLResolvers[] = [ createMonitorStatesResolvers, - createPingsResolvers, unsignedIntegerResolverFunctions, ]; export const typeDefs: any[] = [pingsSchema, unsignedIntegerSchema, monitorStatesSchema]; diff --git a/x-pack/plugins/uptime/server/graphql/monitor_states/schema.gql.ts b/x-pack/plugins/uptime/server/graphql/monitor_states/schema.gql.ts index 6ab564fdeb532..040ad99ac0c64 100644 --- a/x-pack/plugins/uptime/server/graphql/monitor_states/schema.gql.ts +++ b/x-pack/plugins/uptime/server/graphql/monitor_states/schema.gql.ts @@ -169,7 +169,7 @@ export const monitorStatesSchema = gql` DESC } - extend type Query { + type Query { "Fetches the current state of Uptime monitors for the given parameters." getMonitorStates( dateRangeStart: String! diff --git a/x-pack/plugins/uptime/server/graphql/pings/index.ts b/x-pack/plugins/uptime/server/graphql/pings/index.ts index 57ec3242a7aa9..100ce29c398ec 100644 --- a/x-pack/plugins/uptime/server/graphql/pings/index.ts +++ b/x-pack/plugins/uptime/server/graphql/pings/index.ts @@ -4,5 +4,4 @@ * you may not use this file except in compliance with the Elastic License. */ -export { createPingsResolvers } from './resolvers'; export { pingsSchema } from './schema.gql'; diff --git a/x-pack/plugins/uptime/server/graphql/pings/resolvers.ts b/x-pack/plugins/uptime/server/graphql/pings/resolvers.ts deleted file mode 100644 index 2bb1e13bc4b1f..0000000000000 --- a/x-pack/plugins/uptime/server/graphql/pings/resolvers.ts +++ /dev/null @@ -1,59 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { UMResolver } from '../../../../../legacy/plugins/uptime/common/graphql/resolver_types'; -import { - AllPingsQueryArgs, - PingResults, -} from '../../../../../legacy/plugins/uptime/common/graphql/types'; -import { UMServerLibs } from '../../lib/lib'; -import { UMContext } from '../types'; -import { CreateUMGraphQLResolvers } from '../types'; -import { savedObjectsAdapter } from '../../lib/saved_objects'; - -export type UMAllPingsResolver = UMResolver< - PingResults | Promise<PingResults>, - any, - AllPingsQueryArgs, - UMContext ->; - -export interface UMPingResolver { - allPings: () => PingResults; -} - -export const createPingsResolvers: CreateUMGraphQLResolvers = ( - libs: UMServerLibs -): { - Query: { - allPings: UMAllPingsResolver; - }; -} => ({ - Query: { - async allPings( - _resolver, - { monitorId, sort, size, status, dateRangeStart, dateRangeEnd, location, page }, - { APICaller, savedObjectsClient } - ): Promise<PingResults> { - const dynamicSettings = await savedObjectsAdapter.getUptimeDynamicSettings( - savedObjectsClient - ); - - return await libs.requests.getPings({ - callES: APICaller, - dynamicSettings, - dateRangeStart, - dateRangeEnd, - monitorId, - status, - sort, - size, - location, - page, - }); - }, - }, -}); diff --git a/x-pack/plugins/uptime/server/graphql/pings/schema.gql.ts b/x-pack/plugins/uptime/server/graphql/pings/schema.gql.ts index 25767fb544104..179bca53db161 100644 --- a/x-pack/plugins/uptime/server/graphql/pings/schema.gql.ts +++ b/x-pack/plugins/uptime/server/graphql/pings/schema.gql.ts @@ -7,10 +7,6 @@ import gql from 'graphql-tag'; export const pingsSchema = gql` - schema { - query: Query - } - type PingResults { "Total number of matching pings" total: UnsignedInteger! @@ -20,28 +16,6 @@ export const pingsSchema = gql` pings: [Ping!]! } - type Query { - "Get a list of all recorded pings for all monitors" - allPings( - "Optional: the direction to sort by. Accepts 'asc' and 'desc'. Defaults to 'desc'." - sort: String - "Optional: the number of results to return." - size: Int - "Optional: the monitor ID filter." - monitorId: String - "Optional: the check status to filter by." - status: String - "The lower limit of the date range." - dateRangeStart: String! - "The upper limit of the date range." - dateRangeEnd: String! - "Optional: agent location to filter by." - location: String - "Optional: current page." - page: Int - ): PingResults! - } - type ContainerImage { name: String tag: String diff --git a/x-pack/plugins/uptime/server/lib/requests/__tests__/get_latest_monitor.test.ts b/x-pack/plugins/uptime/server/lib/requests/__tests__/get_latest_monitor.test.ts index 112c8e97d4c00..cf8414a3b0a68 100644 --- a/x-pack/plugins/uptime/server/lib/requests/__tests__/get_latest_monitor.test.ts +++ b/x-pack/plugins/uptime/server/lib/requests/__tests__/get_latest_monitor.test.ts @@ -42,10 +42,16 @@ describe('getLatestMonitor', () => { hits: { hits: [ { + _id: 'fejwio32', _source: { - timestamp: 123456, + '@timestamp': '123456', monitor: { + duration: { + us: 12345, + }, id: 'testMonitor', + status: 'down', + type: 'http', }, }, }, @@ -64,7 +70,22 @@ describe('getLatestMonitor', () => { monitorId: 'testMonitor', }); - expect(result.timestamp).toBe(123456); + expect(result).toMatchInlineSnapshot(` + Object { + "@timestamp": "123456", + "docId": "fejwio32", + "monitor": Object { + "duration": Object { + "us": 12345, + }, + "id": "testMonitor", + "status": "down", + "type": "http", + }, + "timestamp": "123456", + } + `); + expect(result.timestamp).toBe('123456'); expect(result.monitor).not.toBeFalsy(); expect(result?.monitor?.id).toBe('testMonitor'); expect(mockEsClient).toHaveBeenCalledWith('search', expectedGetLatestSearchParams); diff --git a/x-pack/plugins/uptime/server/lib/requests/__tests__/get_pings.test.ts b/x-pack/plugins/uptime/server/lib/requests/__tests__/get_pings.test.ts index 9145ccca1b6d1..fcf773db23de6 100644 --- a/x-pack/plugins/uptime/server/lib/requests/__tests__/get_pings.test.ts +++ b/x-pack/plugins/uptime/server/lib/requests/__tests__/get_pings.test.ts @@ -17,16 +17,34 @@ describe('getAll', () => { { _source: { '@timestamp': '2018-10-30T18:51:59.792Z', + monitor: { + duration: { us: 2134 }, + id: 'foo', + status: 'up', + type: 'http', + }, }, }, { _source: { '@timestamp': '2018-10-30T18:53:59.792Z', + monitor: { + duration: { us: 2131 }, + id: 'foo', + status: 'up', + type: 'http', + }, }, }, { _source: { '@timestamp': '2018-10-30T18:55:59.792Z', + monitor: { + duration: { us: 2132 }, + id: 'foo', + status: 'up', + type: 'http', + }, }, }, ]; @@ -48,7 +66,7 @@ describe('getAll', () => { body: { query: { bool: { - filter: [{ range: { '@timestamp': { gte: 'now-1h', lte: 'now' } } }], + filter: [{ range: { timestamp: { gte: 'now-1h', lte: 'now' } } }], }, }, aggregations: { @@ -60,8 +78,7 @@ describe('getAll', () => { }, }, }, - sort: [{ '@timestamp': { order: 'desc' } }], - size: 12, + sort: [{ timestamp: { order: 'desc' } }], }, }; }); @@ -72,8 +89,7 @@ describe('getAll', () => { const result = await getPings({ callES: mockEsClient, dynamicSettings: defaultDynamicSettings, - dateRangeStart: 'now-1h', - dateRangeEnd: 'now', + dateRange: { from: 'now-1h', to: 'now' }, sort: 'asc', size: 12, }); @@ -95,15 +111,54 @@ describe('getAll', () => { await getPings({ callES: mockEsClient, dynamicSettings: defaultDynamicSettings, - dateRangeStart: 'now-1h', - dateRangeEnd: 'now', + dateRange: { from: 'now-1h', to: 'now' }, sort: 'asc', size: 12, }); - set(expectedGetAllParams, 'body.sort[0]', { '@timestamp': { order: 'asc' } }); + set(expectedGetAllParams, 'body.sort[0]', { timestamp: { order: 'asc' } }); expect(mockEsClient).toHaveBeenCalledTimes(1); - expect(mockEsClient).toHaveBeenCalledWith('search', expectedGetAllParams); + expect(mockEsClient.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + "search", + Object { + "body": Object { + "aggregations": Object { + "locations": Object { + "terms": Object { + "field": "observer.geo.name", + "missing": "N/A", + "size": 1000, + }, + }, + }, + "query": Object { + "bool": Object { + "filter": Array [ + Object { + "range": Object { + "@timestamp": Object { + "gte": "now-1h", + "lte": "now", + }, + }, + }, + ], + }, + }, + "size": 12, + "sort": Array [ + Object { + "@timestamp": Object { + "order": "asc", + }, + }, + ], + }, + "index": "heartbeat-8*", + }, + ] + `); }); it('omits the sort param when no sort passed', async () => { @@ -112,12 +167,52 @@ describe('getAll', () => { await getPings({ callES: mockEsClient, dynamicSettings: defaultDynamicSettings, - dateRangeStart: 'now-1h', - dateRangeEnd: 'now', + dateRange: { from: 'now-1h', to: 'now' }, size: 12, }); - expect(mockEsClient).toHaveBeenCalledWith('search', expectedGetAllParams); + expect(mockEsClient).toHaveBeenCalledTimes(1); + expect(mockEsClient.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + "search", + Object { + "body": Object { + "aggregations": Object { + "locations": Object { + "terms": Object { + "field": "observer.geo.name", + "missing": "N/A", + "size": 1000, + }, + }, + }, + "query": Object { + "bool": Object { + "filter": Array [ + Object { + "range": Object { + "@timestamp": Object { + "gte": "now-1h", + "lte": "now", + }, + }, + }, + ], + }, + }, + "size": 12, + "sort": Array [ + Object { + "@timestamp": Object { + "order": "desc", + }, + }, + ], + }, + "index": "heartbeat-8*", + }, + ] + `); }); it('omits the size param when no size passed', async () => { @@ -126,14 +221,52 @@ describe('getAll', () => { await getPings({ callES: mockEsClient, dynamicSettings: defaultDynamicSettings, - dateRangeStart: 'now-1h', - dateRangeEnd: 'now', + dateRange: { from: 'now-1h', to: 'now' }, sort: 'desc', }); - delete expectedGetAllParams.body.size; - set(expectedGetAllParams, 'body.sort[0].@timestamp.order', 'desc'); - expect(mockEsClient).toHaveBeenCalledWith('search', expectedGetAllParams); + expect(mockEsClient).toHaveBeenCalledTimes(1); + expect(mockEsClient.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + "search", + Object { + "body": Object { + "aggregations": Object { + "locations": Object { + "terms": Object { + "field": "observer.geo.name", + "missing": "N/A", + "size": 1000, + }, + }, + }, + "query": Object { + "bool": Object { + "filter": Array [ + Object { + "range": Object { + "@timestamp": Object { + "gte": "now-1h", + "lte": "now", + }, + }, + }, + ], + }, + }, + "size": 25, + "sort": Array [ + Object { + "@timestamp": Object { + "order": "desc", + }, + }, + ], + }, + "index": "heartbeat-8*", + }, + ] + `); }); it('adds a filter for monitor ID', async () => { @@ -142,14 +275,57 @@ describe('getAll', () => { await getPings({ callES: mockEsClient, dynamicSettings: defaultDynamicSettings, - dateRangeStart: 'now-1h', - dateRangeEnd: 'now', + dateRange: { from: 'now-1h', to: 'now' }, monitorId: 'testmonitorid', }); - delete expectedGetAllParams.body.size; - expectedGetAllParams.body.query.bool.filter.push({ term: { 'monitor.id': 'testmonitorid' } }); - expect(mockEsClient).toHaveBeenCalledWith('search', expectedGetAllParams); + expect(mockEsClient).toHaveBeenCalledTimes(1); + expect(mockEsClient.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + "search", + Object { + "body": Object { + "aggregations": Object { + "locations": Object { + "terms": Object { + "field": "observer.geo.name", + "missing": "N/A", + "size": 1000, + }, + }, + }, + "query": Object { + "bool": Object { + "filter": Array [ + Object { + "range": Object { + "@timestamp": Object { + "gte": "now-1h", + "lte": "now", + }, + }, + }, + Object { + "term": Object { + "monitor.id": "testmonitorid", + }, + }, + ], + }, + }, + "size": 25, + "sort": Array [ + Object { + "@timestamp": Object { + "order": "desc", + }, + }, + ], + }, + "index": "heartbeat-8*", + }, + ] + `); }); it('adds a filter for monitor status', async () => { @@ -158,13 +334,56 @@ describe('getAll', () => { await getPings({ callES: mockEsClient, dynamicSettings: defaultDynamicSettings, - dateRangeStart: 'now-1h', - dateRangeEnd: 'now', + dateRange: { from: 'now-1h', to: 'now' }, status: 'down', }); - delete expectedGetAllParams.body.size; - expectedGetAllParams.body.query.bool.filter.push({ term: { 'monitor.status': 'down' } }); - expect(mockEsClient).toHaveBeenCalledWith('search', expectedGetAllParams); + expect(mockEsClient).toHaveBeenCalledTimes(1); + expect(mockEsClient.mock.calls[0]).toMatchInlineSnapshot(` + Array [ + "search", + Object { + "body": Object { + "aggregations": Object { + "locations": Object { + "terms": Object { + "field": "observer.geo.name", + "missing": "N/A", + "size": 1000, + }, + }, + }, + "query": Object { + "bool": Object { + "filter": Array [ + Object { + "range": Object { + "@timestamp": Object { + "gte": "now-1h", + "lte": "now", + }, + }, + }, + Object { + "term": Object { + "monitor.status": "down", + }, + }, + ], + }, + }, + "size": 25, + "sort": Array [ + Object { + "@timestamp": Object { + "order": "desc", + }, + }, + ], + }, + "index": "heartbeat-8*", + }, + ] + `); }); }); diff --git a/x-pack/plugins/uptime/server/lib/requests/get_latest_monitor.ts b/x-pack/plugins/uptime/server/lib/requests/get_latest_monitor.ts index 299e3eb6ca3cf..a8e9ccb875a08 100644 --- a/x-pack/plugins/uptime/server/lib/requests/get_latest_monitor.ts +++ b/x-pack/plugins/uptime/server/lib/requests/get_latest_monitor.ts @@ -5,7 +5,7 @@ */ import { UMElasticsearchQueryFn } from '../adapters'; -import { Ping } from '../../../../../legacy/plugins/uptime/common/graphql/types'; +import { Ping } from '../../../../../legacy/plugins/uptime/common/runtime_types'; export interface GetLatestMonitorParams { /** @member dateRangeStart timestamp bounds */ @@ -53,11 +53,9 @@ export const getLatestMonitor: UMElasticsearchQueryFn<GetLatestMonitorParams, Pi }; const result = await callES('search', params); - const ping: any = result.hits?.hits?.[0] ?? {}; - const { '@timestamp': timestamp, ...monitorResult } = ping?._source ?? {}; + const doc = result.hits?.hits?.[0]; + const source = doc?._source ?? {}; + const docId = doc?._id ?? ''; - return { - timestamp, - ...monitorResult, - }; + return { ...source, docId, timestamp: source['@timestamp'] }; }; diff --git a/x-pack/plugins/uptime/server/lib/requests/get_ping_histogram.ts b/x-pack/plugins/uptime/server/lib/requests/get_ping_histogram.ts index a49e4c8931142..5a8927764ea5c 100644 --- a/x-pack/plugins/uptime/server/lib/requests/get_ping_histogram.ts +++ b/x-pack/plugins/uptime/server/lib/requests/get_ping_histogram.ts @@ -7,8 +7,10 @@ import { UMElasticsearchQueryFn } from '../adapters'; import { QUERY } from '../../../../../legacy/plugins/uptime/common/constants'; import { getFilterClause } from '../helper'; -import { HistogramQueryResult } from './types'; -import { HistogramResult } from '../../../../../legacy/plugins/uptime/common/types'; +import { + HistogramResult, + HistogramQueryResult, +} from '../../../../../legacy/plugins/uptime/common/runtime_types'; export interface GetPingHistogramParams { /** @member dateRangeStart timestamp bounds */ diff --git a/x-pack/plugins/uptime/server/lib/requests/get_pings.ts b/x-pack/plugins/uptime/server/lib/requests/get_pings.ts index c64b5f3ad4af4..6eccfdb13cef7 100644 --- a/x-pack/plugins/uptime/server/lib/requests/get_pings.ts +++ b/x-pack/plugins/uptime/server/lib/requests/get_pings.ts @@ -6,52 +6,28 @@ import { UMElasticsearchQueryFn } from '../adapters/framework'; import { - PingResults, + GetPingsParams, + HttpResponseBody, + PingsResponse, Ping, - HttpBody, -} from '../../../../../legacy/plugins/uptime/common/graphql/types'; +} from '../../../../../legacy/plugins/uptime/common/runtime_types'; -export interface GetPingsParams { - /** @member dateRangeStart timestamp bounds */ - dateRangeStart: string; +const DEFAULT_PAGE_SIZE = 25; - /** @member dateRangeEnd timestamp bounds */ - dateRangeEnd: string; - - /** @member monitorId optional limit by monitorId */ - monitorId?: string | null; - - /** @member status optional limit by check statuses */ - status?: string | null; - - /** @member sort optional sort by timestamp */ - sort?: string | null; - - /** @member size optional limit query size */ - size?: number | null; - - /** @member location optional location value for use in filtering*/ - location?: string | null; - - /** @member page the number to provide to Elasticsearch as the "from" parameter */ - page?: number; -} - -export const getPings: UMElasticsearchQueryFn<GetPingsParams, PingResults> = async ({ +export const getPings: UMElasticsearchQueryFn<GetPingsParams, PingsResponse> = async ({ callES, dynamicSettings, - dateRangeStart, - dateRangeEnd, + dateRange: { from, to }, + index, monitorId, status, sort, - size, + size: sizeParam, location, - page, }) => { + const size = sizeParam ?? DEFAULT_PAGE_SIZE; const sortParam = { sort: [{ '@timestamp': { order: sort ?? 'desc' } }] }; - const sizeParam = size ? { size } : undefined; - const filter: any[] = [{ range: { '@timestamp': { gte: dateRangeStart, lte: dateRangeEnd } } }]; + const filter: any[] = [{ range: { '@timestamp': { gte: from, lte: to } } }]; if (monitorId) { filter.push({ term: { 'monitor.id': monitorId } }); } @@ -71,7 +47,7 @@ export const getPings: UMElasticsearchQueryFn<GetPingsParams, PingResults> = asy ...queryContext, }, ...sortParam, - ...sizeParam, + size, aggregations: { locations: { terms: { @@ -85,8 +61,8 @@ export const getPings: UMElasticsearchQueryFn<GetPingsParams, PingResults> = asy }, }; - if (page) { - params.body.from = page * (size ?? 25); + if (index) { + params.body.from = index * size; } const { @@ -96,25 +72,22 @@ export const getPings: UMElasticsearchQueryFn<GetPingsParams, PingResults> = asy const locations = aggs?.locations ?? { buckets: [{ key: 'N/A', doc_count: 0 }] }; - const pings: Ping[] = hits.map(({ _id, _source }: any) => { - const timestamp = _source['@timestamp']; - + const pings: Ping[] = hits.map((doc: any) => { + const { _id, _source } = doc; // Calculate here the length of the content string in bytes, this is easier than in client JS, where // we don't have access to Buffer.byteLength. There are some hacky ways to do this in the // client but this is cleaner. - const httpBody: HttpBody | undefined = _source?.http?.response?.body; + const httpBody: HttpResponseBody | undefined = _source?.http?.response?.body; if (httpBody && httpBody.content) { httpBody.content_bytes = Buffer.byteLength(httpBody.content); } - return { id: _id, timestamp, ..._source }; + return { ..._source, timestamp: _source['@timestamp'], docId: _id }; }); - const results: PingResults = { + return { total: total.value, locations: locations.buckets.map((bucket: { key: string }) => bucket.key), pings, }; - - return results; }; diff --git a/x-pack/plugins/uptime/server/lib/requests/index.ts b/x-pack/plugins/uptime/server/lib/requests/index.ts index 445adc3c15a93..6317f665d377f 100644 --- a/x-pack/plugins/uptime/server/lib/requests/index.ts +++ b/x-pack/plugins/uptime/server/lib/requests/index.ts @@ -13,7 +13,7 @@ export { getMonitorLocations, GetMonitorLocationsParams } from './get_monitor_lo export { getMonitorStates, GetMonitorStatesParams } from './get_monitor_states'; export { getMonitorStatus, GetMonitorStatusParams } from './get_monitor_status'; export * from './get_monitor_status'; -export { getPings, GetPingsParams } from './get_pings'; +export { getPings } from './get_pings'; export { getPingHistogram, GetPingHistogramParams } from './get_ping_histogram'; export { UptimeRequests } from './uptime_requests'; export { getSnapshotCount, GetSnapshotCountParams } from './get_snapshot_counts'; diff --git a/x-pack/plugins/uptime/server/lib/requests/types.ts b/x-pack/plugins/uptime/server/lib/requests/types.ts deleted file mode 100644 index 53a4e989e3789..0000000000000 --- a/x-pack/plugins/uptime/server/lib/requests/types.ts +++ /dev/null @@ -1,72 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { Ping, PingResults } from '../../../../../legacy/plugins/uptime/common/graphql/types'; -import { UMElasticsearchQueryFn } from '../adapters'; -import { - GetPingHistogramParams, - HistogramResult, -} from '../../../../../legacy/plugins/uptime/common/types'; - -export interface GetAllParams { - /** @member dateRangeStart timestamp bounds */ - dateRangeStart: string; - - /** @member dateRangeEnd timestamp bounds */ - dateRangeEnd: string; - - /** @member monitorId optional limit by monitorId */ - monitorId?: string | null; - - /** @member status optional limit by check statuses */ - status?: string | null; - - /** @member sort optional sort by timestamp */ - sort?: string | null; - - /** @member size optional limit query size */ - size?: number | null; - - /** @member location optional location value for use in filtering*/ - location?: string | null; -} - -export interface GetLatestMonitorDocsParams { - /** @member dateRangeStart timestamp bounds */ - dateStart?: string; - - /** @member dateRangeEnd timestamp bounds */ - dateEnd?: string; - - /** @member monitorId optional limit to monitorId */ - monitorId?: string | null; -} - -/** - * Count the number of documents in heartbeat indices - */ -export interface UMPingsAdapter { - getAll: UMElasticsearchQueryFn<GetAllParams, PingResults>; - - // Get the monitor meta info regardless of timestamp - getMonitor: UMElasticsearchQueryFn<GetLatestMonitorDocsParams, Ping>; - - getLatestMonitorStatus: UMElasticsearchQueryFn<GetLatestMonitorDocsParams, Ping>; - - getPingHistogram: UMElasticsearchQueryFn<GetPingHistogramParams, HistogramResult>; -} - -export interface HistogramQueryResult { - key: number; - key_as_string: string; - doc_count: number; - down: { - doc_count: number; - }; - up: { - doc_count: number; - }; -} diff --git a/x-pack/plugins/uptime/server/lib/requests/uptime_requests.ts b/x-pack/plugins/uptime/server/lib/requests/uptime_requests.ts index 9d3fa5aa08aed..e9a7aa94dd3aa 100644 --- a/x-pack/plugins/uptime/server/lib/requests/uptime_requests.ts +++ b/x-pack/plugins/uptime/server/lib/requests/uptime_requests.ts @@ -5,7 +5,12 @@ */ import { UMElasticsearchQueryFn } from '../adapters'; -import { Ping, PingResults } from '../../../../../legacy/plugins/uptime/common/graphql/types'; +import { + HistogramResult, + Ping, + PingsResponse as PingResults, + GetPingsParams, +} from '../../../../../legacy/plugins/uptime/common/runtime_types'; import { GetFilterBarParams, GetLatestMonitorParams, @@ -13,7 +18,6 @@ import { GetMonitorDetailsParams, GetMonitorLocationsParams, GetMonitorStatesParams, - GetPingsParams, GetPingHistogramParams, GetMonitorStatusParams, GetMonitorStatusResult, @@ -27,10 +31,7 @@ import { } from '../../../../../legacy/plugins/uptime/common/runtime_types'; import { GetMonitorStatesResult } from './get_monitor_states'; import { GetSnapshotCountParams } from './get_snapshot_counts'; -import { - HistogramResult, - MonitorDurationResult, -} from '../../../../../legacy/plugins/uptime/common/types'; +import { MonitorDurationResult } from '../../../../../legacy/plugins/uptime/common/types'; type ESQ<P, R> = UMElasticsearchQueryFn<P, R>; diff --git a/x-pack/plugins/uptime/server/rest_api/index.ts b/x-pack/plugins/uptime/server/rest_api/index.ts index c84ea71037953..c0412e588fa93 100644 --- a/x-pack/plugins/uptime/server/rest_api/index.ts +++ b/x-pack/plugins/uptime/server/rest_api/index.ts @@ -5,7 +5,7 @@ */ import { createGetOverviewFilters } from './overview_filters'; -import { createGetPingsRoute } from './pings'; +import { createGetPingHistogramRoute, createGetPingsRoute } from './pings'; import { createGetDynamicSettingsRoute, createPostDynamicSettingsRoute } from './dynamic_settings'; import { createLogPageViewRoute } from './telemetry'; import { createGetSnapshotCount } from './snapshot'; @@ -15,10 +15,8 @@ import { createGetMonitorLocationsRoute, createGetStatusBarRoute, } from './monitors'; -import { createGetPingHistogramRoute } from './pings/get_ping_histogram'; import { createGetMonitorDurationRoute } from './monitors/monitors_durations'; import { createGetIndexPatternRoute, createGetIndexStatusRoute } from './index_state'; - export * from './types'; export { createRouteWithAuth } from './create_route_with_auth'; export { uptimeRouteWrapper } from './uptime_route_wrapper'; diff --git a/x-pack/plugins/uptime/server/rest_api/pings/get_all.ts b/x-pack/plugins/uptime/server/rest_api/pings/get_all.ts deleted file mode 100644 index c76892103da6b..0000000000000 --- a/x-pack/plugins/uptime/server/rest_api/pings/get_all.ts +++ /dev/null @@ -1,47 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { schema } from '@kbn/config-schema'; -import { UMServerLibs } from '../../lib/lib'; -import { UMRestApiRouteFactory } from '../types'; -import { API_URLS } from '../../../../../legacy/plugins/uptime/common/constants/rest_api'; - -export const createGetAllRoute: UMRestApiRouteFactory = (libs: UMServerLibs) => ({ - method: 'GET', - path: API_URLS.PINGS, - validate: { - query: schema.object({ - dateRangeStart: schema.string(), - dateRangeEnd: schema.string(), - location: schema.maybe(schema.string()), - monitorId: schema.maybe(schema.string()), - size: schema.maybe(schema.number()), - sort: schema.maybe(schema.string()), - status: schema.maybe(schema.string()), - }), - }, - handler: async ({ callES, dynamicSettings }, _context, request, response): Promise<any> => { - const { dateRangeStart, dateRangeEnd, location, monitorId, size, sort, status } = request.query; - - const result = await libs.requests.getPings({ - callES, - dynamicSettings, - dateRangeStart, - dateRangeEnd, - monitorId, - status, - sort, - size, - location, - }); - - return response.ok({ - body: { - ...result, - }, - }); - }, -}); diff --git a/x-pack/plugins/uptime/server/rest_api/pings/get_pings.ts b/x-pack/plugins/uptime/server/rest_api/pings/get_pings.ts index cde9a8c4e47ea..80a887a7f64a9 100644 --- a/x-pack/plugins/uptime/server/rest_api/pings/get_pings.ts +++ b/x-pack/plugins/uptime/server/rest_api/pings/get_pings.ts @@ -5,37 +5,41 @@ */ import { schema } from '@kbn/config-schema'; +import { isLeft } from 'fp-ts/lib/Either'; +import { PathReporter } from 'io-ts/lib/PathReporter'; import { UMServerLibs } from '../../lib/lib'; import { UMRestApiRouteFactory } from '../types'; import { API_URLS } from '../../../../../legacy/plugins/uptime/common/constants/rest_api'; +import { GetPingsParamsType } from '../../../../../legacy/plugins/uptime/common/runtime_types'; export const createGetPingsRoute: UMRestApiRouteFactory = (libs: UMServerLibs) => ({ method: 'GET', path: API_URLS.PINGS, validate: { query: schema.object({ - dateRangeStart: schema.string(), - dateRangeEnd: schema.string(), + from: schema.string(), + to: schema.string(), location: schema.maybe(schema.string()), monitorId: schema.maybe(schema.string()), + index: schema.maybe(schema.number()), size: schema.maybe(schema.number()), sort: schema.maybe(schema.string()), status: schema.maybe(schema.string()), }), }, handler: async ({ callES, dynamicSettings }, _context, request, response): Promise<any> => { - const { dateRangeStart, dateRangeEnd, location, monitorId, size, sort, status } = request.query; + const { from, to, ...optional } = request.query; + const params = GetPingsParamsType.decode({ dateRange: { from, to }, ...optional }); + if (isLeft(params)) { + // eslint-disable-next-line no-console + console.error(new Error(PathReporter.report(params).join(';'))); + return response.badRequest({ body: { message: 'Received invalid request parameters.' } }); + } const result = await libs.requests.getPings({ callES, dynamicSettings, - dateRangeStart, - dateRangeEnd, - monitorId, - status, - sort, - size, - location, + ...params.right, }); return response.ok({ diff --git a/x-pack/plugins/uptime/server/rest_api/pings/index.ts b/x-pack/plugins/uptime/server/rest_api/pings/index.ts index abb7da26f994f..a10ab435e4b0a 100644 --- a/x-pack/plugins/uptime/server/rest_api/pings/index.ts +++ b/x-pack/plugins/uptime/server/rest_api/pings/index.ts @@ -5,3 +5,4 @@ */ export { createGetPingsRoute } from './get_pings'; +export { createGetPingHistogramRoute } from './get_ping_histogram'; diff --git a/x-pack/test/api_integration/apis/uptime/feature_controls.ts b/x-pack/test/api_integration/apis/uptime/feature_controls.ts index 4c3b7f97c9544..8b82735fc38b0 100644 --- a/x-pack/test/api_integration/apis/uptime/feature_controls.ts +++ b/x-pack/test/api_integration/apis/uptime/feature_controls.ts @@ -40,7 +40,7 @@ export default function featureControlsTests({ getService }: FtrProviderContext) const executePingsRequest = async (username: string, password: string, spaceId?: string) => { const basePath = spaceId ? `/s/${spaceId}` : ''; - const url = `${basePath}${API_URLS.PINGS}?sort=desc&dateRangeStart=${PINGS_DATE_RANGE_START}&dateRangeEnd=${PINGS_DATE_RANGE_END}`; + const url = `${basePath}${API_URLS.PINGS}?sort=desc&from=${PINGS_DATE_RANGE_START}&to=${PINGS_DATE_RANGE_END}`; return await supertest .get(url) .auth(username, password) diff --git a/x-pack/test/api_integration/apis/uptime/get_all_pings.ts b/x-pack/test/api_integration/apis/uptime/get_all_pings.ts index 666986e7008b7..0b3f5faccb044 100644 --- a/x-pack/test/api_integration/apis/uptime/get_all_pings.ts +++ b/x-pack/test/api_integration/apis/uptime/get_all_pings.ts @@ -22,7 +22,7 @@ export default function({ getService }: FtrProviderContext) { it('should get all pings stored in index', async () => { const { body: apiResponse } = await supertest .get( - `/api/uptime/pings?sort=desc&dateRangeStart=${PINGS_DATE_RANGE_START}&dateRangeEnd=${PINGS_DATE_RANGE_END}` + `/api/uptime/pings?sort=desc&from=${PINGS_DATE_RANGE_START}&to=${PINGS_DATE_RANGE_END}` ) .expect(200); @@ -33,21 +33,19 @@ export default function({ getService }: FtrProviderContext) { it('should sort pings according to timestamp', async () => { const { body: apiResponse } = await supertest - .get( - `/api/uptime/pings?sort=asc&dateRangeStart=${PINGS_DATE_RANGE_START}&dateRangeEnd=${PINGS_DATE_RANGE_END}` - ) + .get(`/api/uptime/pings?sort=asc&from=${PINGS_DATE_RANGE_START}&to=${PINGS_DATE_RANGE_END}`) .expect(200); expect(apiResponse.total).to.be(2); expect(apiResponse.pings.length).to.be(2); - expect(apiResponse.pings[0].timestamp).to.be('2018-10-30T14:49:23.889Z'); - expect(apiResponse.pings[1].timestamp).to.be('2018-10-30T18:51:56.792Z'); + expect(apiResponse.pings[0]['@timestamp']).to.be('2018-10-30T14:49:23.889Z'); + expect(apiResponse.pings[1]['@timestamp']).to.be('2018-10-30T18:51:56.792Z'); }); it('should return results of n length', async () => { const { body: apiResponse } = await supertest .get( - `/api/uptime/pings?sort=desc&size=1&dateRangeStart=${PINGS_DATE_RANGE_START}&dateRangeEnd=${PINGS_DATE_RANGE_END}` + `/api/uptime/pings?sort=desc&size=1&from=${PINGS_DATE_RANGE_START}&to=${PINGS_DATE_RANGE_END}` ) .expect(200); @@ -57,10 +55,10 @@ export default function({ getService }: FtrProviderContext) { }); it('should miss pings outside of date range', async () => { - const dateRangeStart = moment('2002-01-01').valueOf(); - const dateRangeEnd = moment('2002-01-02').valueOf(); + const from = moment('2002-01-01').valueOf(); + const to = moment('2002-01-02').valueOf(); const { body: apiResponse } = await supertest - .get(`/api/uptime/pings?dateRangeStart=${dateRangeStart}&dateRangeEnd=${dateRangeEnd}`) + .get(`/api/uptime/pings?from=${from}&to=${to}`) .expect(200); expect(apiResponse.total).to.be(0); diff --git a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list.json b/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list.json deleted file mode 100644 index 330ec83931a62..0000000000000 --- a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list.json +++ /dev/null @@ -1,320 +0,0 @@ -{ - "allPings": { - "total": 2000, - "locations": [ - "mpls" - ], - "pings": [ - { - "timestamp": "2019-09-11T03:40:34.410Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 413 - }, - "id": "0074-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 441 - }, - "id": "0073-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 482 - }, - "id": "0099-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 558 - }, - "id": "0098-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 304 - }, - "id": "0075-intermittent", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.405Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 487 - }, - "id": "0097-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.405Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 602 - }, - "id": "0049-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.390Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 365 - }, - "id": "0047-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.389Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 870 - }, - "id": "0077-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.387Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 2808 - }, - "id": "0076-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - } - ] - } -} \ No newline at end of file diff --git a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_count.json b/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_count.json deleted file mode 100644 index 3a619f517626a..0000000000000 --- a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_count.json +++ /dev/null @@ -1,1569 +0,0 @@ -{ - "allPings": { - "total": 2000, - "locations": [ - "mpls" - ], - "pings": [ - { - "timestamp": "2019-09-11T03:40:34.410Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 413 - }, - "id": "0074-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 441 - }, - "id": "0073-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 482 - }, - "id": "0099-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 558 - }, - "id": "0098-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.406Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 304 - }, - "id": "0075-intermittent", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.405Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 487 - }, - "id": "0097-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.405Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 602 - }, - "id": "0049-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.390Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 365 - }, - "id": "0047-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.389Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 870 - }, - "id": "0077-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.387Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 2808 - }, - "id": "0076-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.386Z", - "http": { - "response": { - "status_code": 400, - "body": { - "bytes": 3, - "hash": "26d228663f13a88592a12d16cf9587caab0388b262d6d9f126ed62f9333aca94", - "content": "400", - "content_bytes": 3 - } - } - }, - "error": { - "message": "400 Bad Request", - "type": "validate" - }, - "monitor": { - "duration": { - "us": 4258 - }, - "id": "0050-down", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.386Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 4784 - }, - "id": "0048-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.376Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 14580 - }, - "id": "0072-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.376Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 14679 - }, - "id": "0096-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15308 - }, - "id": "0092-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15183 - }, - "id": "0069-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15013 - }, - "id": "0093-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 400, - "body": { - "bytes": 3, - "hash": "26d228663f13a88592a12d16cf9587caab0388b262d6d9f126ed62f9333aca94", - "content": "400", - "content_bytes": 3 - } - } - }, - "error": { - "message": "400 Bad Request", - "type": "validate" - }, - "monitor": { - "duration": { - "us": 15117 - }, - "id": "0070-down", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 14875 - }, - "id": "0071-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 14801 - }, - "id": "0095-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15065 - }, - "id": "0032-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 14911 - }, - "id": "0094-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 16135 - }, - "id": "0046-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15428 - }, - "id": "0091-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15499 - }, - "id": "0067-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15464 - }, - "id": "0068-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 21736 - }, - "id": "0090-intermittent", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 21874 - }, - "id": "0031-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.374Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 36584 - }, - "id": "0066-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 3148 - }, - "id": "0084-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 13442 - }, - "id": "0083-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 13666 - }, - "id": "0041-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 16290 - }, - "id": "0045-intermittent", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 17255 - }, - "id": "0042-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 500, - "body": { - "bytes": 3, - "hash": "0604cd3138feed202ef293e062da2f4720f77a05d25ee036a7a01c9cfcdd1f0a", - "content": "500", - "content_bytes": 3 - } - } - }, - "error": { - "message": "500 Internal Server Error", - "type": "validate" - }, - "monitor": { - "duration": { - "us": 17146 - }, - "id": "0030-intermittent", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "down", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 17770 - }, - "id": "0063-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 18194 - }, - "id": "0061-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 17587 - }, - "id": "0065-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 22666 - }, - "id": "0062-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 33311 - }, - "id": "0026-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 33506 - }, - "id": "0085-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 33974 - }, - "id": "0025-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 33693 - }, - "id": "0088-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 33833 - }, - "id": "0089-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 34600 - }, - "id": "0087-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 35573 - }, - "id": "0028-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 35830 - }, - "id": "0086-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 35698 - }, - "id": "0064-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 35594 - }, - "id": "0029-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 35652 - }, - "id": "0044-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - } - ] - } -} \ No newline at end of file diff --git a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_monitor_id.json b/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_monitor_id.json deleted file mode 100644 index 5826fd9f3f540..0000000000000 --- a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_monitor_id.json +++ /dev/null @@ -1,475 +0,0 @@ -{ - "allPings": { - "total": 20, - "locations": [ - "mpls" - ], - "pings": [ - { - "timestamp": "2019-09-11T03:40:34.371Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 35534 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:40:04.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 3080 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:39:34.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 7810 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:39:04.371Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 1575 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:38:34.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 1787 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:38:04.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 654 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:37:34.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 15915 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:37:04.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 2679 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:36:34.371Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 2104 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:36:04.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 5759 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:35:34.373Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 7166 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:35:04.371Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 26830 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:34:34.371Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 993 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:34:04.381Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 3880 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:33:34.371Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 1604 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - } - ] - } -} \ No newline at end of file diff --git a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_sort.json b/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_sort.json deleted file mode 100644 index b9b8deae2e564..0000000000000 --- a/x-pack/test/api_integration/apis/uptime/graphql/fixtures/ping_list_sort.json +++ /dev/null @@ -1,165 +0,0 @@ -{ - "allPings": { - "total": 20, - "locations": [ - "mpls" - ], - "pings": [ - { - "timestamp": "2019-09-11T03:31:04.380Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 56940 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:31:34.366Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 9861 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:32:04.372Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 2924 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:32:34.375Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 21665 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - }, - { - "timestamp": "2019-09-11T03:33:04.370Z", - "http": { - "response": { - "status_code": 200, - "body": { - "bytes": 3, - "hash": "27badc983df1780b60c2b3fa9d3a19a00e46aac798451f0febdca52920faaddf", - "content": null, - "content_bytes": null - } - } - }, - "error": null, - "monitor": { - "duration": { - "us": 2128 - }, - "id": "0001-up", - "ip": "127.0.0.1", - "name": "", - "scheme": null, - "status": "up", - "type": "http" - }, - "observer": { - "geo": { - "name": "mpls" - } - } - } - ] - } -} \ No newline at end of file diff --git a/x-pack/test/api_integration/apis/uptime/graphql/index.ts b/x-pack/test/api_integration/apis/uptime/graphql/index.ts index 2e0b5e2eea2a5..862cce47f257a 100644 --- a/x-pack/test/api_integration/apis/uptime/graphql/index.ts +++ b/x-pack/test/api_integration/apis/uptime/graphql/index.ts @@ -13,6 +13,5 @@ export default function({ loadTestFile }: FtrProviderContext) { // verifying the pre-loaded documents are returned in a way that // matches the snapshots contained in './fixtures' loadTestFile(require.resolve('./monitor_states')); - loadTestFile(require.resolve('./ping_list')); }); } diff --git a/x-pack/test/api_integration/apis/uptime/graphql/ping_list.ts b/x-pack/test/api_integration/apis/uptime/graphql/ping_list.ts deleted file mode 100644 index c84b9c382acdd..0000000000000 --- a/x-pack/test/api_integration/apis/uptime/graphql/ping_list.ts +++ /dev/null @@ -1,116 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { pingsQueryString } from '../../../../../legacy/plugins/uptime/public/queries'; -import { expectFixtureEql } from './helpers/expect_fixture_eql'; -import { Ping, PingResults } from '../../../../../legacy/plugins/uptime/common/graphql/types'; - -const expectPingFixtureEql = (data: { allPings: PingResults }, fixtureName: string) => { - expectFixtureEql(data, fixtureName, d => d.allPings.pings.forEach((p: Ping) => delete p.id)); -}; - -export default function({ getService }: any) { - describe('pingList query', () => { - before('load heartbeat data', () => getService('esArchiver').load('uptime/full_heartbeat')); - after('unload heartbeat index', () => getService('esArchiver').unload('uptime/full_heartbeat')); - - const supertest = getService('supertest'); - - it('returns a list of pings for the given date range and default size', async () => { - const getPingsQuery = { - operationName: 'PingList', - query: pingsQueryString, - variables: { - dateRangeStart: '2019-01-28T17:40:08.078Z', - dateRangeEnd: '2025-01-28T19:00:16.078Z', - }, - }; - const { - body: { data }, - } = await supertest - .post('/api/uptime/graphql') - .set('kbn-xsrf', 'foo') - .send({ ...getPingsQuery }); - const { - allPings: { pings }, - } = data; - expect(pings).length(10); - - expectPingFixtureEql(data, 'ping_list'); - }); - - it('returns a list of pings for the date range and given size', async () => { - const SIZE = 50; - const getPingsQuery = { - operationName: 'PingList', - query: pingsQueryString, - variables: { - dateRangeStart: '2019-01-28T17:40:08.078Z', - dateRangeEnd: '2025-01-28T19:00:16.078Z', - size: SIZE, - }, - }; - const { - body: { data }, - } = await supertest - .post('/api/uptime/graphql') - .set('kbn-xsrf', 'foo') - .send({ ...getPingsQuery }); - const { - allPings: { pings }, - } = data; - expect(pings).length(SIZE); - expectPingFixtureEql(data, 'ping_list_count'); - }); - - it('returns a list of pings for a monitor ID', async () => { - const SIZE = 15; - const MONITOR_ID = '0001-up'; - const getPingsQuery = { - operationName: 'PingList', - query: pingsQueryString, - variables: { - dateRangeStart: '2019-01-28T17:40:08.078Z', - dateRangeEnd: '2025-01-28T19:00:16.078Z', - monitorId: MONITOR_ID, - size: SIZE, - }, - }; - const { - body: { data }, - } = await supertest - .post('/api/uptime/graphql') - .set('kbn-xsrf', 'foo') - .send({ ...getPingsQuery }); - expectPingFixtureEql(data, 'ping_list_monitor_id'); - }); - - it('returns a list of pings sorted ascending', async () => { - const SIZE = 5; - const MONITOR_ID = '0001-up'; - const getPingsQuery = { - operationName: 'PingList', - query: pingsQueryString, - variables: { - dateRangeStart: '2019-01-28T17:40:08.078Z', - dateRangeEnd: '2025-01-28T19:00:16.078Z', - monitorId: MONITOR_ID, - size: SIZE, - sort: 'asc', - }, - }; - const { - body: { data }, - } = await supertest - .post('/api/uptime/graphql') - .set('kbn-xsrf', 'foo') - .send({ ...getPingsQuery }); - - expectPingFixtureEql(data, 'ping_list_sort'); - }); - }); -} diff --git a/x-pack/test/api_integration/apis/uptime/index.ts b/x-pack/test/api_integration/apis/uptime/index.ts index a21db08d58c4d..8def64b71a110 100644 --- a/x-pack/test/api_integration/apis/uptime/index.ts +++ b/x-pack/test/api_integration/apis/uptime/index.ts @@ -10,11 +10,12 @@ export default function({ getService, loadTestFile }: FtrProviderContext) { const es = getService('legacyEs'); describe('uptime', () => { - before(() => - es.indices.delete({ - index: 'heartbeat*', - ignore: [404], - }) + before( + async () => + await es.indices.delete({ + index: 'heartbeat*', + ignore: [404], + }) ); loadTestFile(require.resolve('./feature_controls')); diff --git a/x-pack/test/api_integration/apis/uptime/rest/fixtures/monitor_latest_status.json b/x-pack/test/api_integration/apis/uptime/rest/fixtures/monitor_latest_status.json index 2e5854f4d9866..6a832ad8536f7 100644 --- a/x-pack/test/api_integration/apis/uptime/rest/fixtures/monitor_latest_status.json +++ b/x-pack/test/api_integration/apis/uptime/rest/fixtures/monitor_latest_status.json @@ -1,16 +1,11 @@ { - "timestamp": "2019-09-11T03:40:34.371Z", "observer": { - "geo": { - "name": "mpls", - "location": "37.926868, -78.024902" - }, + "geo": { "name": "mpls", "location": "37.926868, -78.024902" }, "hostname": "avc-x1x" }, + "@timestamp": "2019-09-11T03:40:34.371Z", "monitor": { - "duration": { - "us": 24627 - }, + "duration": { "us": 24627 }, "ip": "127.0.0.1", "name": "", "check_group": "d76f0762-d445-11e9-88e3-3e80641b9c71", @@ -25,5 +20,7 @@ "domain": "localhost", "query": "r=200x1", "full": "http://localhost:5678/pattern?r=200x1" - } + }, + "docId": "h5toHm0B0I9WX_CznN_V", + "timestamp": "2019-09-11T03:40:34.371Z" } diff --git a/x-pack/test/api_integration/apis/uptime/rest/index.ts b/x-pack/test/api_integration/apis/uptime/rest/index.ts index 9b0cd61c22462..3f8df81856f5c 100644 --- a/x-pack/test/api_integration/apis/uptime/rest/index.ts +++ b/x-pack/test/api_integration/apis/uptime/rest/index.ts @@ -45,10 +45,11 @@ export default function({ getService, loadTestFile }: FtrProviderContext) { loadTestFile(require.resolve('./telemetry_collectors')); }); describe('with real-world data', () => { - before('load heartbeat data', async () => await esArchiver.load('uptime/full_heartbeat')); - after('unload', async () => await esArchiver.unload('uptime/full_heartbeat')); + beforeEach('load heartbeat data', async () => await esArchiver.load('uptime/full_heartbeat')); + afterEach('unload', async () => await esArchiver.unload('uptime/full_heartbeat')); loadTestFile(require.resolve('./monitor_latest_status')); loadTestFile(require.resolve('./ping_histogram')); + loadTestFile(require.resolve('./ping_list')); loadTestFile(require.resolve('./monitor_duration')); loadTestFile(require.resolve('./doc_count')); }); diff --git a/x-pack/test/api_integration/apis/uptime/rest/ping_list.ts b/x-pack/test/api_integration/apis/uptime/rest/ping_list.ts new file mode 100644 index 0000000000000..a261763d5991f --- /dev/null +++ b/x-pack/test/api_integration/apis/uptime/rest/ping_list.ts @@ -0,0 +1,178 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import expect from '@kbn/expect'; +import { isLeft } from 'fp-ts/lib/Either'; +import { PathReporter } from 'io-ts/lib/PathReporter'; +import { PingsResponseType } from '../../../../../legacy/plugins/uptime/common/runtime_types'; +import { FtrProviderContext } from '../../../ftr_provider_context'; + +function decodePingsResponseData(response: any) { + const decoded = PingsResponseType.decode(response); + if (isLeft(decoded)) { + throw Error(JSON.stringify(PathReporter.report(decoded), null, 2)); + } + return decoded.right; +} + +export default function({ getService }: FtrProviderContext) { + const supertest = getService('supertest'); + describe('pingList query', () => { + before('load heartbeat data', () => getService('esArchiver').load('uptime/full_heartbeat')); + after('unload heartbeat index', () => getService('esArchiver').unload('uptime/full_heartbeat')); + + it('returns a list of pings for the given date range and default size', async () => { + const from = '2019-01-28T17:40:08.078Z'; + const to = '2025-01-28T19:00:16.078Z'; + + const apiResponse = await supertest.get(`/api/uptime/pings?from=${from}&to=${to}&size=10`); + + const { total, locations, pings } = decodePingsResponseData(apiResponse.body); + + expect(total).to.be(2000); + expect(locations).to.eql(['mpls']); + expect(pings).length(10); + expect(pings.map(({ monitor: { id } }) => id)).to.eql([ + '0074-up', + '0073-up', + '0099-up', + '0098-up', + '0075-intermittent', + '0097-up', + '0049-up', + '0047-up', + '0077-up', + '0076-up', + ]); + }); + + it('returns a list of pings for the date range and given size', async () => { + const from = '2019-01-28T17:40:08.078Z'; + const to = '2025-01-28T19:00:16.078Z'; + const size = 50; + + const apiResponse = await supertest.get( + `/api/uptime/pings?from=${from}&to=${to}&size=${size}` + ); + + const { total, locations, pings } = decodePingsResponseData(apiResponse.body); + + expect(total).to.be(2000); + expect(locations).to.eql(['mpls']); + expect(pings).length(50); + expect(pings.map(({ monitor: { id } }) => id)).to.eql([ + '0074-up', + '0073-up', + '0099-up', + '0098-up', + '0075-intermittent', + '0097-up', + '0049-up', + '0047-up', + '0077-up', + '0076-up', + '0050-down', + '0048-up', + '0072-up', + '0096-up', + '0092-up', + '0069-up', + '0093-up', + '0070-down', + '0071-up', + '0095-up', + '0032-up', + '0094-up', + '0046-up', + '0091-up', + '0067-up', + '0068-up', + '0090-intermittent', + '0031-up', + '0066-up', + '0084-up', + '0083-up', + '0041-up', + '0045-intermittent', + '0042-up', + '0030-intermittent', + '0063-up', + '0061-up', + '0065-up', + '0062-up', + '0026-up', + '0085-up', + '0025-up', + '0088-up', + '0089-up', + '0087-up', + '0028-up', + '0086-up', + '0064-up', + '0029-up', + '0044-up', + ]); + }); + + it('returns a list of pings for a monitor ID', async () => { + const from = '2019-01-28T17:40:08.078Z'; + const to = '2025-01-28T19:00:16.078Z'; + const monitorId = '0001-up'; + const size = 15; + + const apiResponse = await supertest.get( + `/api/uptime/pings?from=${from}&to=${to}&monitorId=${monitorId}&size=${size}` + ); + + const { total, locations, pings } = decodePingsResponseData(apiResponse.body); + + expect(total).to.be(20); + expect(locations).to.eql(['mpls']); + pings.forEach(({ monitor: { id } }) => expect(id).to.eql('0001-up')); + expect(pings.map(({ timestamp }) => timestamp)).to.eql([ + '2019-09-11T03:40:34.371Z', + '2019-09-11T03:40:04.370Z', + '2019-09-11T03:39:34.370Z', + '2019-09-11T03:39:04.371Z', + '2019-09-11T03:38:34.370Z', + '2019-09-11T03:38:04.370Z', + '2019-09-11T03:37:34.370Z', + '2019-09-11T03:37:04.370Z', + '2019-09-11T03:36:34.371Z', + '2019-09-11T03:36:04.370Z', + '2019-09-11T03:35:34.373Z', + '2019-09-11T03:35:04.371Z', + '2019-09-11T03:34:34.371Z', + '2019-09-11T03:34:04.381Z', + '2019-09-11T03:33:34.371Z', + ]); + }); + + it('returns a list of pings sorted ascending', async () => { + const from = '2019-01-28T17:40:08.078Z'; + const to = '2025-01-28T19:00:16.078Z'; + const monitorId = '0001-up'; + const size = 5; + const sort = 'asc'; + + const apiResponse = await supertest.get( + `/api/uptime/pings?from=${from}&to=${to}&monitorId=${monitorId}&size=${size}&sort=${sort}` + ); + + const { total, locations, pings } = decodePingsResponseData(apiResponse.body); + + expect(total).to.be(20); + expect(locations).to.eql(['mpls']); + expect(pings.map(({ timestamp }) => timestamp)).to.eql([ + '2019-09-11T03:31:04.380Z', + '2019-09-11T03:31:34.366Z', + '2019-09-11T03:32:04.372Z', + '2019-09-11T03:32:34.375Z', + '2019-09-11T03:33:04.370Z', + ]); + }); + }); +} diff --git a/x-pack/test/functional/apps/uptime/monitor.ts b/x-pack/test/functional/apps/uptime/monitor.ts index 90ad1836c69d3..388d660f21eb3 100644 --- a/x-pack/test/functional/apps/uptime/monitor.ts +++ b/x-pack/test/functional/apps/uptime/monitor.ts @@ -23,8 +23,33 @@ export default ({ getPageObjects, getService }: FtrProviderContext) => { await uptimeService.navigation.goToUptime(); }); - it('loads and displays uptime data based on date range', async () => { - await uptime.loadDataAndGoToMonitorPage(dateStart, dateEnd, monitorId); + after(async () => { + await esArchiver.unload(archive); + }); + + describe('navigation to monitor page', () => { + before(async () => { + await uptime.loadDataAndGoToMonitorPage(dateStart, dateEnd, monitorId); + }); + + it('displays ping data as expected', async () => { + await uptime.checkPingListInteractions( + [ + 'XZtoHm0B0I9WX_CznN-6', + '7ZtoHm0B0I9WX_CzJ96M', + 'pptnHm0B0I9WX_Czst5X', + 'I5tnHm0B0I9WX_CzPd46', + 'y5tmHm0B0I9WX_Czx93x', + 'XZtmHm0B0I9WX_CzUt3H', + '-JtlHm0B0I9WX_Cz3dyX', + 'k5tlHm0B0I9WX_CzaNxm', + 'NZtkHm0B0I9WX_Cz89w9', + 'zJtkHm0B0I9WX_CzftsN', + ], + 'mpls', + 'up' + ); + }); }); }); }; diff --git a/x-pack/test/functional/page_objects/uptime_page.ts b/x-pack/test/functional/page_objects/uptime_page.ts index 7157bbfb3811b..0ebcb5c87deee 100644 --- a/x-pack/test/functional/page_objects/uptime_page.ts +++ b/x-pack/test/functional/page_objects/uptime_page.ts @@ -9,7 +9,7 @@ import { FtrProviderContext } from '../ftr_provider_context'; export function UptimePageProvider({ getPageObjects, getService }: FtrProviderContext) { const pageObjects = getPageObjects(['common', 'timePicker']); - const { common: commonService, navigation, alerts } = getService('uptime'); + const { alerts, common: commonService, monitor, navigation } = getService('uptime'); const retry = getService('retry'); return new (class UptimePage { @@ -137,6 +137,20 @@ export function UptimePageProvider({ getPageObjects, getService }: FtrProviderCo return commonService.clickPageSizeSelectPopoverItem(size); } + public async checkPingListInteractions( + timestamps: string[], + location?: string, + status?: string + ): Promise<void> { + if (location) { + await monitor.setPingListLocation(location); + } + if (status) { + await monitor.setPingListStatus(status); + } + return monitor.checkForPingListTimestamps(timestamps); + } + public async resetFilters() { await this.inputFilterQuery(''); await commonService.resetStatusFilter(); diff --git a/x-pack/test/functional/services/uptime/monitor.ts b/x-pack/test/functional/services/uptime/monitor.ts index 3bdec4b6749d4..a3e3d953e2eb7 100644 --- a/x-pack/test/functional/services/uptime/monitor.ts +++ b/x-pack/test/functional/services/uptime/monitor.ts @@ -27,5 +27,22 @@ export function UptimeMonitorProvider({ getService }: FtrProviderContext) { await find.descendantExistsByCssSelector('canvas.mapboxgl-canvas', mapPanel); }); }, + async setPingListLocation(location: string) { + await testSubjects.click('xpack.uptime.pingList.locationSelect', 5000); + return testSubjects.click(`xpack.uptime.pingList.locationOptions.${location}`, 5000); + }, + async setPingListStatus(status: string) { + await testSubjects.click('xpack.uptime.pingList.statusSelect', 5000); + return testSubjects.click(`xpack.uptime.pingList.statusOptions.${status}`, 5000); + }, + async checkForPingListTimestamps(timestamps: string[]): Promise<void> { + return retry.tryForTime(10000, async () => { + await Promise.all( + timestamps.map(timestamp => + testSubjects.existOrFail(`xpack.uptime.pingList.ping-${timestamp}`) + ) + ); + }); + }, }; } From b38c98a730f4962910e29acf7d8847346ab67e6d Mon Sep 17 00:00:00 2001 From: Alison Goryachev <alison.goryachev@elastic.co> Date: Tue, 14 Apr 2020 09:13:20 -0400 Subject: [PATCH 089/102] =?UTF-8?q?[Remote=20clusters]=20guard=20against?= =?UTF-8?q?=20usageCollection=20plugin=20if=20unav=E2=80=A6=20(#63284)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../public/application/services/ui_metric.ts | 21 ++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/x-pack/plugins/remote_clusters/public/application/services/ui_metric.ts b/x-pack/plugins/remote_clusters/public/application/services/ui_metric.ts index 91354155cacb0..4fc3c438e76d6 100644 --- a/x-pack/plugins/remote_clusters/public/application/services/ui_metric.ts +++ b/x-pack/plugins/remote_clusters/public/application/services/ui_metric.ts @@ -3,17 +3,24 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ - +import { UiStatsMetricType, METRIC_TYPE } from '@kbn/analytics'; import { UsageCollectionSetup } from 'src/plugins/usage_collection/public'; -import { UiStatsMetricType } from '@kbn/analytics'; import { UIM_APP_NAME } from '../constants'; -export let trackUiMetric: (metricType: UiStatsMetricType, eventName: string) => void; -export let METRIC_TYPE: UsageCollectionSetup['METRIC_TYPE']; +export { METRIC_TYPE }; + +export let usageCollection: UsageCollectionSetup | undefined; + +export function init(_usageCollection: UsageCollectionSetup): void { + usageCollection = _usageCollection; +} -export function init(usageCollection: UsageCollectionSetup): void { - trackUiMetric = usageCollection.reportUiStats.bind(usageCollection, UIM_APP_NAME); - METRIC_TYPE = usageCollection.METRIC_TYPE; +export function trackUiMetric(metricType: UiStatsMetricType, name: string) { + if (!usageCollection) { + return; + } + const { reportUiStats } = usageCollection; + reportUiStats(UIM_APP_NAME, metricType, name); } /** From 11e2e0839627dcd00da39165537fc13bc6b46a39 Mon Sep 17 00:00:00 2001 From: Candace Park <56409205+parkiino@users.noreply.github.com> Date: Tue, 14 Apr 2020 10:56:25 -0400 Subject: [PATCH 090/102] Task/linux events (#63400) * linux events for endpoint policy details, additional windows events --- .../applications/endpoint/models/policy.ts | 7 +- .../store/policy_details/index.test.ts | 22 ++++ .../store/policy_details/selectors.ts | 20 ++++ .../public/applications/endpoint/types.ts | 84 +++++++------- .../endpoint/view/policy/policy_details.tsx | 4 +- .../view/policy/policy_forms/events/index.tsx | 1 + .../view/policy/policy_forms/events/linux.tsx | 106 ++++++++++++++++++ .../policy/policy_forms/events/windows.tsx | 41 ++++++- 8 files changed, 240 insertions(+), 45 deletions(-) create mode 100644 x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/linux.tsx diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts b/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts index 30f45e54c2005..5269ee72f4039 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/models/policy.ts @@ -15,8 +15,13 @@ export const generatePolicy = (): PolicyConfig => { return { windows: { events: { - process: true, + dll_and_driver_load: true, + dns: true, + file: true, network: true, + process: true, + registry: true, + security: true, }, malware: { mode: ProtectionModes.prevent, diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts index e09a62b235e35..f81852d6a074a 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/index.test.ts @@ -98,4 +98,26 @@ describe('policy details: ', () => { expect(config!.mac.events.file).toEqual(true); }); }); + + describe('when the user has enabled linux process events', () => { + beforeEach(() => { + const config = policyConfig(getState()); + if (!config) { + throw new Error(); + } + + const newPayload1 = clone(config); + newPayload1.linux.events.file = true; + + dispatch({ + type: 'userChangedPolicyConfig', + payload: { policyConfig: newPayload1 }, + }); + }); + + it('linux file events is enabled', () => { + const config = policyConfig(getState()); + expect(config!.linux.events.file).toEqual(true); + }); + }); }); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts index 4b4dc9d9bee43..a37a06bafcf05 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/selectors.ts @@ -119,6 +119,26 @@ export const selectedMacEvents = (state: PolicyDetailsState): number => { return 0; }; +/** Returns the total number of possible linux eventing configurations */ +export const totalLinuxEvents = (state: PolicyDetailsState): number => { + const config = policyConfig(state); + if (config) { + return Object.keys(config.linux.events).length; + } + return 0; +}; + +/** Returns the number of selected liinux eventing configurations */ +export const selectedLinuxEvents = (state: PolicyDetailsState): number => { + const config = policyConfig(state); + if (config) { + return Object.values(config.linux.events).reduce((count, event) => { + return event === true ? count + 1 : count; + }, 0); + } + return 0; +}; + /** is there an api call in flight */ export const isLoading = (state: PolicyDetailsState) => state.isLoading; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts index a625c49bf7d5a..54afbf220944e 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts @@ -131,21 +131,42 @@ export interface PolicyListUrlSearchParams { * Endpoint Policy configuration */ export interface PolicyConfig { - windows: UIPolicyConfig['windows'] & { + windows: { + events: { + dll_and_driver_load: boolean; + dns: boolean; + file: boolean; + network: boolean; + process: boolean; + registry: boolean; + security: boolean; + }; + malware: MalwareFields; logging: { stdout: string; file: string; }; advanced: PolicyConfigAdvancedOptions; }; - mac: UIPolicyConfig['mac'] & { + mac: { + events: { + file: boolean; + process: boolean; + network: boolean; + }; + malware: MalwareFields; logging: { stdout: string; file: string; }; advanced: PolicyConfigAdvancedOptions; }; - linux: UIPolicyConfig['linux'] & { + linux: { + events: { + file: boolean; + process: boolean; + network: boolean; + }; logging: { stdout: string; file: string; @@ -169,38 +190,28 @@ interface PolicyConfigAdvancedOptions { } /** - * The set of Policy configuration settings that are show/edited via the UI + * Windows-specific policy configuration that is supported via the UI */ -/* eslint-disable @typescript-eslint/consistent-type-definitions */ -export type UIPolicyConfig = { - windows: { - events: { - process: boolean; - network: boolean; - }; - /** malware mode can be off, detect, prevent or prevent and notify user */ - malware: MalwareFields; - }; - mac: { - events: { - file: boolean; - process: boolean; - network: boolean; - }; - malware: MalwareFields; - }; +type WindowsPolicyConfig = Pick<PolicyConfig['windows'], 'events' | 'malware'>; - /** - * Linux-specific policy configuration that is supported via the UI - */ - linux: { - events: { - file: boolean; - process: boolean; - network: boolean; - }; - }; -}; +/** + * Mac-specific policy configuration that is supported via the UI + */ +type MacPolicyConfig = Pick<PolicyConfig['mac'], 'malware' | 'events'>; + +/** + * Linux-specific policy configuration that is supported via the UI + */ +type LinuxPolicyConfig = Pick<PolicyConfig['linux'], 'events'>; + +/** + * The set of Policy configuration settings that are show/edited via the UI + */ +export interface UIPolicyConfig { + windows: WindowsPolicyConfig; + mac: MacPolicyConfig; + linux: LinuxPolicyConfig; +} /** OS used in Policy */ export enum OS { @@ -209,13 +220,6 @@ export enum OS { linux = 'linux', } -/** Used in Policy */ -export enum EventingFields { - process = 'process', - network = 'network', - file = 'file', -} - /** * Returns the keys of an object whose values meet a criteria. * Ex) interface largeNestedObject = { diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx index 267077da6598c..076de7b57b44b 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_details.tsx @@ -34,7 +34,7 @@ import { AppAction } from '../../types'; import { useKibana } from '../../../../../../../../src/plugins/kibana_react/public'; import { AgentsSummary } from './agents_summary'; import { VerticalDivider } from './vertical_divider'; -import { WindowsEvents, MacEvents } from './policy_forms/events'; +import { WindowsEvents, MacEvents, LinuxEvents } from './policy_forms/events'; import { MalwareProtections } from './policy_forms/protections/malware'; export const PolicyDetails = React.memo(() => { @@ -208,6 +208,8 @@ export const PolicyDetails = React.memo(() => { <WindowsEvents /> <EuiSpacer size="l" /> <MacEvents /> + <EuiSpacer size="l" /> + <LinuxEvents /> </PageView> </> ); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx index 44716d8183041..927456fb671d8 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/index.tsx @@ -6,3 +6,4 @@ export { WindowsEvents } from './windows'; export { MacEvents } from './mac'; +export { LinuxEvents } from './linux'; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/linux.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/linux.tsx new file mode 100644 index 0000000000000..9d2ce03c20462 --- /dev/null +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/linux.tsx @@ -0,0 +1,106 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import React, { useMemo } from 'react'; +import { i18n } from '@kbn/i18n'; +import { FormattedMessage } from '@kbn/i18n/react'; +import { EuiTitle, EuiText, EuiSpacer } from '@elastic/eui'; +import { EventsCheckbox } from './checkbox'; +import { OS, UIPolicyConfig } from '../../../../types'; +import { usePolicyDetailsSelector } from '../../policy_hooks'; +import { selectedLinuxEvents, totalLinuxEvents } from '../../../../store/policy_details/selectors'; +import { ConfigForm } from '../config_form'; +import { getIn, setIn } from '../../../../models/policy_details_config'; + +export const LinuxEvents = React.memo(() => { + const selected = usePolicyDetailsSelector(selectedLinuxEvents); + const total = usePolicyDetailsSelector(totalLinuxEvents); + + const checkboxes: Array<{ + name: string; + os: 'linux'; + protectionField: keyof UIPolicyConfig['linux']['events']; + }> = useMemo( + () => [ + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.linux.events.file', { + defaultMessage: 'File', + }), + os: OS.linux, + protectionField: 'file', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.linux.events.process', { + defaultMessage: 'Process', + }), + os: OS.linux, + protectionField: 'process', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.linux.events.network', { + defaultMessage: 'Network', + }), + os: OS.linux, + protectionField: 'network', + }, + ], + [] + ); + + const renderCheckboxes = () => { + return ( + <> + <EuiTitle size="xxs"> + <h5> + <FormattedMessage + id="xpack.endpoint.policyDetailsConfig.eventingEvents" + defaultMessage="Events" + /> + </h5> + </EuiTitle> + <EuiSpacer size="s" /> + {checkboxes.map((item, index) => { + return ( + <EventsCheckbox + name={item.name} + key={index} + setter={(config, checked) => + setIn(config)(item.os)('events')(item.protectionField)(checked) + } + getter={config => getIn(config)(item.os)('events')(item.protectionField)} + /> + ); + })} + </> + ); + }; + + const collectionsEnabled = () => { + return ( + <EuiText size="s" color="subdued"> + <FormattedMessage + id="xpack.endpoint.policy.details.eventCollectionsEnabled" + defaultMessage="{selected} / {total} event collections enabled" + values={{ selected, total }} + /> + </EuiText> + ); + }; + + return ( + <ConfigForm + type={i18n.translate('xpack.endpoint.policy.details.eventCollection', { + defaultMessage: 'Event Collection', + })} + supportedOss={[ + i18n.translate('xpack.endpoint.policy.details.linux', { defaultMessage: 'Linux' }), + ]} + id="linuxEventingForm" + rightCorner={collectionsEnabled()} + children={renderCheckboxes()} + /> + ); +}); diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx index 63a140912437d..da675dc1e2393 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/policy/policy_forms/events/windows.tsx @@ -29,11 +29,25 @@ export const WindowsEvents = React.memo(() => { }> = useMemo( () => [ { - name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.process', { - defaultMessage: 'Process', + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.dllDriverLoad', { + defaultMessage: 'DLL and Driver Load', }), os: OS.windows, - protectionField: 'process', + protectionField: 'dll_and_driver_load', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.dns', { + defaultMessage: 'DNS', + }), + os: OS.windows, + protectionField: 'dns', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.file', { + defaultMessage: 'File', + }), + os: OS.windows, + protectionField: 'file', }, { name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.network', { @@ -42,6 +56,27 @@ export const WindowsEvents = React.memo(() => { os: OS.windows, protectionField: 'network', }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.process', { + defaultMessage: 'Process', + }), + os: OS.windows, + protectionField: 'process', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.registry', { + defaultMessage: 'Registry', + }), + os: OS.windows, + protectionField: 'registry', + }, + { + name: i18n.translate('xpack.endpoint.policyDetailsConfig.windows.events.security', { + defaultMessage: 'Security', + }), + os: OS.windows, + protectionField: 'security', + }, ], [] ); From 48d528ff2ea65405456051d8067e3b265e915379 Mon Sep 17 00:00:00 2001 From: Wylie Conlon <william.conlon@elastic.co> Date: Tue, 14 Apr 2020 10:59:01 -0400 Subject: [PATCH 091/102] [Lens] Fix bug where suggestions didn't use filters (#63293) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../editor_frame/suggestion_panel.test.tsx | 16 ++++++++++++++-- .../editor_frame/suggestion_panel.tsx | 1 + 2 files changed, 15 insertions(+), 2 deletions(-) diff --git a/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.test.tsx b/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.test.tsx index b146f2467c46c..0e32f1f053b9d 100644 --- a/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.test.tsx +++ b/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.test.tsx @@ -16,6 +16,7 @@ import { } from '../mocks'; import { act } from 'react-dom/test-utils'; import { ReactExpressionRendererType } from '../../../../../../../src/plugins/expressions/public'; +import { esFilters, IFieldType, IIndexPattern } from '../../../../../../../src/plugins/data/public'; import { SuggestionPanel, SuggestionPanelProps } from './suggestion_panel'; import { getSuggestions, Suggestion } from './suggestion_helpers'; import { EuiIcon, EuiPanel, EuiToolTip } from '@elastic/eui'; @@ -243,14 +244,25 @@ describe('suggestion_panel', () => { (mockVisualization.toPreviewExpression as jest.Mock).mockReturnValueOnce('test | expression'); mockDatasource.toExpression.mockReturnValue('datasource_expression'); - mount(<SuggestionPanel {...defaultProps} />); + const indexPattern = ({ id: 'index1' } as unknown) as IIndexPattern; + const field = ({ name: 'myfield' } as unknown) as IFieldType; + + mount( + <SuggestionPanel + {...defaultProps} + frame={{ + ...createMockFramePublicAPI(), + filters: [esFilters.buildExistsFilter(field, indexPattern)], + }} + /> + ); expect(expressionRendererMock).toHaveBeenCalledTimes(1); const passedExpression = (expressionRendererMock as jest.Mock).mock.calls[0][0].expression; expect(passedExpression).toMatchInlineSnapshot(` "kibana - | kibana_context timeRange=\\"{\\\\\\"from\\\\\\":\\\\\\"now-7d\\\\\\",\\\\\\"to\\\\\\":\\\\\\"now\\\\\\"}\\" query=\\"{\\\\\\"query\\\\\\":\\\\\\"\\\\\\",\\\\\\"language\\\\\\":\\\\\\"lucene\\\\\\"}\\" filters=\\"[]\\" + | kibana_context timeRange=\\"{\\\\\\"from\\\\\\":\\\\\\"now-7d\\\\\\",\\\\\\"to\\\\\\":\\\\\\"now\\\\\\"}\\" query=\\"{\\\\\\"query\\\\\\":\\\\\\"\\\\\\",\\\\\\"language\\\\\\":\\\\\\"lucene\\\\\\"}\\" filters=\\"[{\\\\\\"meta\\\\\\":{\\\\\\"index\\\\\\":\\\\\\"index1\\\\\\"},\\\\\\"exists\\\\\\":{\\\\\\"field\\\\\\":\\\\\\"myfield\\\\\\"}}]\\" | lens_merge_tables layerIds=\\"first\\" tables={datasource_expression} | test | expression" diff --git a/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.tsx b/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.tsx index 93f6ea6ea67ac..76443027ab88a 100644 --- a/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.tsx +++ b/x-pack/legacy/plugins/lens/public/editor_frame_service/editor_frame/suggestion_panel.tsx @@ -235,6 +235,7 @@ export function SuggestionPanel({ const expressionContext = { query: frame.query, + filters: frame.filters, timeRange: { from: frame.dateRange.fromDate, to: frame.dateRange.toDate, From 8489efc034dddfae18913830f50091eb603100ff Mon Sep 17 00:00:00 2001 From: Wylie Conlon <william.conlon@elastic.co> Date: Tue, 14 Apr 2020 11:04:47 -0400 Subject: [PATCH 092/102] [Lens] Migration from 7.7 (#62879) * [Lens] Migration from 7.7 * Fix types * Fix types in test * Add docs * Commit forgotten file * Remove extra types Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- x-pack/plugins/lens/server/migrations.test.ts | 161 ++++++++++++++++++ x-pack/plugins/lens/server/migrations.ts | 37 ++++ x-pack/plugins/lens/server/saved_objects.ts | 2 + 3 files changed, 200 insertions(+) create mode 100644 x-pack/plugins/lens/server/migrations.test.ts create mode 100644 x-pack/plugins/lens/server/migrations.ts diff --git a/x-pack/plugins/lens/server/migrations.test.ts b/x-pack/plugins/lens/server/migrations.test.ts new file mode 100644 index 0000000000000..e80308cc9acdb --- /dev/null +++ b/x-pack/plugins/lens/server/migrations.test.ts @@ -0,0 +1,161 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { migrations } from './migrations'; +import { SavedObjectMigrationContext } from 'src/core/server'; + +describe('Lens migrations', () => { + describe('7.7.0 missing dimensions in XY', () => { + const context = {} as SavedObjectMigrationContext; + + const example = { + type: 'lens', + attributes: { + expression: + 'kibana\n| kibana_context query="{\\"language\\":\\"kuery\\",\\"query\\":\\"\\"}" \n| lens_merge_tables layerIds="c61a8afb-a185-4fae-a064-fb3846f6c451" \n tables={esaggs index="logstash-*" metricsAtAllLevels=false partialRows=false includeFormatHints=true aggConfigs="[{\\"id\\":\\"2cd09808-3915-49f4-b3b0-82767eba23f7\\",\\"enabled\\":true,\\"type\\":\\"max\\",\\"schema\\":\\"metric\\",\\"params\\":{\\"field\\":\\"bytes\\"}}]" | lens_rename_columns idMap="{\\"col-0-2cd09808-3915-49f4-b3b0-82767eba23f7\\":\\"2cd09808-3915-49f4-b3b0-82767eba23f7\\"}"}\n| lens_metric_chart title="Maximum of bytes" accessor="2cd09808-3915-49f4-b3b0-82767eba23f7"', + state: { + datasourceMetaData: { + filterableIndexPatterns: [ + { + id: 'logstash-*', + title: 'logstash-*', + }, + ], + }, + datasourceStates: { + indexpattern: { + currentIndexPatternId: 'logstash-*', + layers: { + 'c61a8afb-a185-4fae-a064-fb3846f6c451': { + columnOrder: ['2cd09808-3915-49f4-b3b0-82767eba23f7'], + columns: { + '2cd09808-3915-49f4-b3b0-82767eba23f7': { + dataType: 'number', + isBucketed: false, + label: 'Maximum of bytes', + operationType: 'max', + scale: 'ratio', + sourceField: 'bytes', + }, + 'd3e62a7a-c259-4fff-a2fc-eebf20b7008a': { + dataType: 'number', + isBucketed: false, + label: 'Minimum of bytes', + operationType: 'min', + scale: 'ratio', + sourceField: 'bytes', + }, + 'd6e40cea-6299-43b4-9c9d-b4ee305a2ce8': { + dataType: 'date', + isBucketed: true, + label: 'Date Histogram of @timestamp', + operationType: 'date_histogram', + params: { + interval: 'auto', + }, + scale: 'interval', + sourceField: '@timestamp', + }, + }, + indexPatternId: 'logstash-*', + }, + }, + }, + }, + filters: [], + query: { + language: 'kuery', + query: '', + }, + visualization: { + accessor: '2cd09808-3915-49f4-b3b0-82767eba23f7', + isHorizontal: false, + layerId: 'c61a8afb-a185-4fae-a064-fb3846f6c451', + layers: [ + { + accessors: [ + 'd3e62a7a-c259-4fff-a2fc-eebf20b7008a', + '26ef70a9-c837-444c-886e-6bd905ee7335', + ], + layerId: 'c61a8afb-a185-4fae-a064-fb3846f6c451', + seriesType: 'area', + splitAccessor: '54cd64ed-2a44-4591-af84-b2624504569a', + xAccessor: 'd6e40cea-6299-43b4-9c9d-b4ee305a2ce8', + }, + ], + legend: { + isVisible: true, + position: 'right', + }, + preferredSeriesType: 'area', + }, + }, + title: 'Artistpreviouslyknownaslens', + visualizationType: 'lnsXY', + }, + }; + + it('should not change anything by XY visualizations', () => { + const target = { + ...example, + attributes: { + ...example.attributes, + visualizationType: 'lnsMetric', + }, + }; + const result = migrations['7.7.0'](target, context); + expect(result).toEqual(target); + }); + + it('should handle missing layers', () => { + const result = migrations['7.7.0']( + { + ...example, + attributes: { + ...example.attributes, + state: { + ...example.attributes.state, + datasourceStates: { + indexpattern: { + layers: [], + }, + }, + }, + }, + }, + context + ); + + expect(result.attributes.state.visualization.layers).toEqual([ + { + layerId: 'c61a8afb-a185-4fae-a064-fb3846f6c451', + seriesType: 'area', + // Removed split accessor + splitAccessor: undefined, + xAccessor: undefined, + // Removed a yAcccessor + accessors: [], + }, + ]); + }); + + it('should remove only missing accessors', () => { + const result = migrations['7.7.0'](example, context); + + expect(result.attributes.state.visualization.layers).toEqual([ + { + layerId: 'c61a8afb-a185-4fae-a064-fb3846f6c451', + seriesType: 'area', + xAccessor: 'd6e40cea-6299-43b4-9c9d-b4ee305a2ce8', + // Removed split accessor + splitAccessor: undefined, + // Removed a yAcccessor + accessors: ['d3e62a7a-c259-4fff-a2fc-eebf20b7008a'], + }, + ]); + }); + }); +}); diff --git a/x-pack/plugins/lens/server/migrations.ts b/x-pack/plugins/lens/server/migrations.ts new file mode 100644 index 0000000000000..3d238723b7438 --- /dev/null +++ b/x-pack/plugins/lens/server/migrations.ts @@ -0,0 +1,37 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { cloneDeep } from 'lodash'; +import { SavedObjectMigrationFn } from 'src/core/server'; + +interface XYLayerPre77 { + layerId: string; + xAccessor: string; + splitAccessor: string; + accessors: string[]; +} + +export const migrations: Record<string, SavedObjectMigrationFn> = { + '7.7.0': doc => { + const newDoc = cloneDeep(doc); + if (newDoc.attributes?.visualizationType === 'lnsXY') { + const datasourceState = newDoc.attributes.state?.datasourceStates?.indexpattern; + const datasourceLayers = datasourceState?.layers ?? {}; + const xyState = newDoc.attributes.state?.visualization; + newDoc.attributes.state.visualization.layers = xyState.layers.map((layer: XYLayerPre77) => { + const layerId = layer.layerId; + const datasource = datasourceLayers[layerId]; + return { + ...layer, + xAccessor: datasource?.columns[layer.xAccessor] ? layer.xAccessor : undefined, + splitAccessor: datasource?.columns[layer.splitAccessor] ? layer.splitAccessor : undefined, + accessors: layer.accessors.filter(accessor => !!datasource?.columns[accessor]), + }; + }) as typeof xyState.layers; + } + return newDoc; + }, +}; diff --git a/x-pack/plugins/lens/server/saved_objects.ts b/x-pack/plugins/lens/server/saved_objects.ts index 42dc750878f45..b2eb325c09266 100644 --- a/x-pack/plugins/lens/server/saved_objects.ts +++ b/x-pack/plugins/lens/server/saved_objects.ts @@ -6,6 +6,7 @@ import { CoreSetup } from 'kibana/server'; import { getEditPath } from '../common'; +import { migrations } from './migrations'; export function setupSavedObjects(core: CoreSetup) { core.savedObjects.registerType({ @@ -22,6 +23,7 @@ export function setupSavedObjects(core: CoreSetup) { uiCapabilitiesPath: 'visualize.show', }), }, + migrations, mappings: { properties: { title: { From 4ce2412316624184cb1a3dde3b9e724550fe7659 Mon Sep 17 00:00:00 2001 From: Uladzislau Lasitsa <Uladzislau_Lasitsa@epam.com> Date: Tue, 14 Apr 2020 18:45:21 +0300 Subject: [PATCH 093/102] Clicking cancel in saved query save modal doesn't close it (#62774) * use validation by clicking on save, added autotrim * Fixes form errors. * Fixed comments Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../ui/saved_query_form/save_query_form.tsx | 99 +++++++++---------- .../translations/translations/ja-JP.json | 2 - .../translations/translations/zh-CN.json | 2 - 3 files changed, 48 insertions(+), 55 deletions(-) diff --git a/src/plugins/data/public/ui/saved_query_form/save_query_form.tsx b/src/plugins/data/public/ui/saved_query_form/save_query_form.tsx index 36dcd4a00c05e..5550ea16c22df 100644 --- a/src/plugins/data/public/ui/saved_query_form/save_query_form.tsx +++ b/src/plugins/data/public/ui/saved_query_form/save_query_form.tsx @@ -17,7 +17,7 @@ * under the License. */ -import React, { useEffect, useState } from 'react'; +import React, { useEffect, useState, useCallback } from 'react'; import { EuiButtonEmpty, EuiOverlayMask, @@ -63,6 +63,7 @@ export function SaveQueryForm({ showTimeFilterOption = true, }: Props) { const [title, setTitle] = useState(savedQuery ? savedQuery.title : ''); + const [enabledSaveButton, setEnabledSaveButton] = useState(Boolean(savedQuery)); const [description, setDescription] = useState(savedQuery ? savedQuery.description : ''); const [savedQueries, setSavedQueries] = useState<SavedQuery[]>([]); const [shouldIncludeFilters, setShouldIncludeFilters] = useState( @@ -76,49 +77,31 @@ export function SaveQueryForm({ ); const [formErrors, setFormErrors] = useState<string[]>([]); - useEffect(() => { - const fetchQueries = async () => { - const allSavedQueries = await savedQueryService.getAllSavedQueries(); - const sortedAllSavedQueries = sortBy(allSavedQueries, 'attributes.title') as SavedQuery[]; - setSavedQueries(sortedAllSavedQueries); - }; - fetchQueries(); - }, [savedQueryService]); - - const savedQueryDescriptionText = i18n.translate( - 'data.search.searchBar.savedQueryDescriptionText', - { - defaultMessage: 'Save query text and filters that you want to use again.', - } - ); - const titleConflictErrorText = i18n.translate( 'data.search.searchBar.savedQueryForm.titleConflictText', { defaultMessage: 'Name conflicts with an existing saved query', } ); - const titleMissingErrorText = i18n.translate( - 'data.search.searchBar.savedQueryForm.titleMissingText', - { - defaultMessage: 'Name is required', - } - ); - const whitespaceErrorText = i18n.translate( - 'data.search.searchBar.savedQueryForm.whitespaceErrorText', + + const savedQueryDescriptionText = i18n.translate( + 'data.search.searchBar.savedQueryDescriptionText', { - defaultMessage: 'Name cannot contain leading or trailing whitespace', + defaultMessage: 'Save query text and filters that you want to use again.', } ); - const validate = () => { + useEffect(() => { + const fetchQueries = async () => { + const allSavedQueries = await savedQueryService.getAllSavedQueries(); + const sortedAllSavedQueries = sortBy(allSavedQueries, 'attributes.title') as SavedQuery[]; + setSavedQueries(sortedAllSavedQueries); + }; + fetchQueries(); + }, [savedQueryService]); + + const validate = useCallback(() => { const errors = []; - if (!title.length) { - errors.push(titleMissingErrorText); - } - if (title.length > title.trim().length) { - errors.push(whitespaceErrorText); - } if ( !!savedQueries.find( existingSavedQuery => !savedQuery && existingSavedQuery.attributes.title === title @@ -129,14 +112,37 @@ export function SaveQueryForm({ if (!isEqual(errors, formErrors)) { setFormErrors(errors); + return false; } - }; - const hasErrors = formErrors.length > 0; + return !formErrors.length; + }, [savedQueries, savedQuery, title, titleConflictErrorText, formErrors]); + + const onClickSave = useCallback(() => { + if (validate()) { + onSave({ + title, + description, + shouldIncludeFilters, + shouldIncludeTimefilter, + }); + } + }, [validate, onSave, title, description, shouldIncludeFilters, shouldIncludeTimefilter]); + + const onInputChange = useCallback(event => { + setEnabledSaveButton(Boolean(event.target.value)); + setFormErrors([]); + setTitle(event.target.value); + }, []); + + const autoTrim = useCallback(() => { + const trimmedTitle = title.trim(); + if (title.length > trimmedTitle.length) { + setTitle(trimmedTitle); + } + }, [title]); - if (hasErrors) { - validate(); - } + const hasErrors = formErrors.length > 0; const saveQueryForm = ( <EuiForm isInvalid={hasErrors} error={formErrors} data-test-subj="saveQueryForm"> @@ -157,12 +163,10 @@ export function SaveQueryForm({ disabled={!!savedQuery} value={title} name="title" - onChange={event => { - setTitle(event.target.value); - }} + onChange={onInputChange} data-test-subj="saveQueryFormTitle" isInvalid={hasErrors} - onBlur={validate} + onBlur={autoTrim} /> </EuiFormRow> @@ -235,17 +239,10 @@ export function SaveQueryForm({ </EuiButtonEmpty> <EuiButton - onClick={() => - onSave({ - title, - description, - shouldIncludeFilters, - shouldIncludeTimefilter, - }) - } + onClick={onClickSave} fill data-test-subj="savedQueryFormSaveButton" - disabled={hasErrors} + disabled={hasErrors || !enabledSaveButton} > {i18n.translate('data.search.searchBar.savedQueryFormSaveButtonText', { defaultMessage: 'Save', diff --git a/x-pack/plugins/translations/translations/ja-JP.json b/x-pack/plugins/translations/translations/ja-JP.json index a8574971426f5..a5d2c20447ad5 100644 --- a/x-pack/plugins/translations/translations/ja-JP.json +++ b/x-pack/plugins/translations/translations/ja-JP.json @@ -798,8 +798,6 @@ "data.search.searchBar.savedQueryDescriptionLabelText": "説明", "data.search.searchBar.savedQueryDescriptionText": "再度使用するクエリテキストとフィルターを保存します。", "data.search.searchBar.savedQueryForm.titleConflictText": "タイトルが既に保存されているクエリに使用されています", - "data.search.searchBar.savedQueryForm.titleMissingText": "名前が必要です", - "data.search.searchBar.savedQueryForm.whitespaceErrorText": "タイトルの始めと終わりにはスペースを使用できません", "data.search.searchBar.savedQueryFormCancelButtonText": "キャンセル", "data.search.searchBar.savedQueryFormSaveButtonText": "保存", "data.search.searchBar.savedQueryFormTitle": "クエリを保存", diff --git a/x-pack/plugins/translations/translations/zh-CN.json b/x-pack/plugins/translations/translations/zh-CN.json index df5cccf1a9b97..ef749e9218e11 100644 --- a/x-pack/plugins/translations/translations/zh-CN.json +++ b/x-pack/plugins/translations/translations/zh-CN.json @@ -799,8 +799,6 @@ "data.search.searchBar.savedQueryDescriptionLabelText": "描述", "data.search.searchBar.savedQueryDescriptionText": "保存想要再次使用的查询文本和筛选。", "data.search.searchBar.savedQueryForm.titleConflictText": "标题与现有已保存查询有冲突", - "data.search.searchBar.savedQueryForm.titleMissingText": "“名称”必填", - "data.search.searchBar.savedQueryForm.whitespaceErrorText": "标题不能包含前导或尾随空格", "data.search.searchBar.savedQueryFormCancelButtonText": "取消", "data.search.searchBar.savedQueryFormSaveButtonText": "保存", "data.search.searchBar.savedQueryFormTitle": "保存查询", From d015c24509d0ed8a2bce5802fea036ae7c910a38 Mon Sep 17 00:00:00 2001 From: Mikhail Shustov <restrry@gmail.com> Date: Tue, 14 Apr 2020 17:45:40 +0200 Subject: [PATCH 094/102] [NP] Migrate logstash server side code to NP (#63135) * convert api_integration test into TS * create logstash NP plugin and move models * move common/constants to NP * type fetch all from scroll * move route declaration to NP * add licence checker wrapper * register logstash route handlers in NP * track logstash NP i18n * address shaunak comment * fix validation * udpdate security tests since for new mock defaults * address Pierres comments * rename upgrade file route --- x-pack/.i18nrc.json | 2 +- x-pack/legacy/plugins/logstash/index.js | 10 +-- .../pipeline_editor/pipeline_editor.js | 2 +- .../public/lib/register_home_feature.ts | 2 +- .../pipeline_list_item/pipeline_list_item.js | 2 +- .../services/cluster/cluster_service.js | 2 +- .../license/logstash_license_service.js | 2 +- .../services/monitoring/monitoring_service.js | 2 +- .../services/pipeline/pipeline_service.js | 2 +- .../services/pipelines/pipelines_service.js | 2 +- .../services/upgrade/upgrade_service.js | 2 +- .../call_with_request_factory.js | 18 ---- .../__tests__/wrap_custom_error.js | 21 ----- .../error_wrappers/__tests__/wrap_es_error.js | 42 --------- .../__tests__/wrap_unknown_error.js | 19 ---- .../lib/error_wrappers/wrap_custom_error.js | 18 ---- .../lib/error_wrappers/wrap_es_error.js | 27 ------ .../lib/error_wrappers/wrap_unknown_error.js | 17 ---- .../__tests__/fetch_all_from_scroll.js | 88 ------------------- .../fetch_all_from_scroll.js | 28 ------ .../__tests__/license_pre_routing_factory.js | 69 --------------- .../license_pre_routing_factory.js | 27 ------ .../register_license_checker.js | 2 +- .../api/cluster/register_cluster_routes.js | 11 --- .../routes/api/cluster/register_load_route.js | 40 --------- .../api/pipeline/register_delete_route.js | 38 -------- .../api/pipeline/register_load_route.js | 47 ---------- .../api/pipeline/register_pipeline_routes.js | 15 ---- .../api/pipeline/register_save_route.js | 48 ---------- .../server/routes/api/pipelines/index.js | 7 -- .../api/pipelines/register_delete_route.js | 51 ----------- .../api/pipelines/register_list_route.js | 52 ----------- .../pipelines/register_pipelines_routes.js | 13 --- .../server/routes/api/upgrade/index.js | 7 -- .../api/upgrade/register_execute_route.js | 56 ------------ .../api/upgrade/register_upgrade_routes.js | 11 --- .../licensing/common/licensing.mock.ts | 1 + x-pack/plugins/licensing/server/index.ts | 1 + .../wrap_route_with_license_check.test.ts | 71 +++++++++++++++ .../server/wrap_route_with_license_check.ts | 40 +++++++++ .../common/constants/es_scroll_settings.ts} | 0 .../logstash/common/constants/index.ts} | 0 .../logstash/common/constants/index_names.ts} | 0 .../logstash/common/constants/monitoring.ts} | 0 .../logstash/common/constants/pagination.ts} | 0 .../logstash/common/constants/pipeline.ts} | 0 .../logstash/common/constants/plugin.ts} | 0 .../logstash/common/constants/routes.ts} | 0 .../logstash/common/constants/tooltips.ts} | 0 x-pack/plugins/logstash/kibana.json | 12 +++ x-pack/plugins/logstash/server/index.ts | 16 ++++ .../lib/check_license/check_license.test.ts | 60 +++++++++++++ .../server/lib/check_license/check_license.ts | 65 ++++++++++++++ .../server/lib/check_license/index.ts} | 2 +- .../fetch_all_from_scroll.test.ts | 71 +++++++++++++++ .../fetch_all_from_scroll.ts | 34 +++++++ .../lib/fetch_all_from_scroll/index.ts} | 0 .../server/models/cluster/cluster.test.ts} | 5 +- .../server/models/cluster/cluster.ts} | 11 +-- .../logstash/server/models/cluster/index.ts} | 0 .../logstash/server/models/pipeline/index.ts} | 0 .../server/models/pipeline/pipeline.test.ts} | 21 +++-- .../server/models/pipeline/pipeline.ts} | 55 ++++++++---- .../models/pipeline_list_item/index.ts} | 0 .../pipeline_list_item.test.ts} | 16 ++-- .../pipeline_list_item/pipeline_list_item.ts} | 25 +++--- x-pack/plugins/logstash/server/plugin.ts | 51 +++++++++++ .../logstash/server/routes/cluster/index.ts} | 3 +- .../logstash/server/routes/cluster/load.ts | 34 +++++++ .../plugins/logstash/server/routes/index.ts | 28 ++++++ .../logstash/server/routes/pipeline/delete.ts | 38 ++++++++ .../logstash/server/routes/pipeline/index.ts} | 7 +- .../logstash/server/routes/pipeline/load.ts | 46 ++++++++++ .../logstash/server/routes/pipeline/save.ts | 69 +++++++++++++++ .../server/routes/pipelines/delete.ts | 54 ++++++++++++ .../server/routes/pipelines/index.ts} | 4 +- .../logstash/server/routes/pipelines/list.ts | 63 +++++++++++++ .../logstash/server/routes/upgrade/index.ts} | 2 +- .../logstash/server/routes/upgrade/upgrade.ts | 46 ++++++++++ x-pack/plugins/logstash/server/types.ts | 27 ++++++ .../common/licensing/license_service.test.ts | 16 ++-- .../logstash/cluster/{index.js => index.ts} | 3 +- .../logstash/cluster/{load.js => load.ts} | 3 +- .../apis/logstash/{index.js => index.ts} | 3 +- .../pipeline/{delete.js => delete.ts} | 3 +- .../logstash/pipeline/{index.js => index.ts} | 4 +- .../logstash/pipeline/{load.js => load.ts} | 6 +- .../logstash/pipeline/{save.js => save.ts} | 3 +- .../pipelines/{delete.js => delete.ts} | 3 +- .../logstash/pipelines/{index.js => index.ts} | 3 +- .../logstash/pipelines/{list.js => list.ts} | 5 +- 91 files changed, 959 insertions(+), 873 deletions(-) delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/call_with_request_factory.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_custom_error.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_es_error.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_unknown_error.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_custom_error.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_es_error.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_unknown_error.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/__tests__/fetch_all_from_scroll.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js delete mode 100755 x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/license_pre_routing_factory.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_cluster_routes.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_load_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_delete_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_load_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_pipeline_routes.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_save_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipelines/index.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_delete_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_list_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_pipelines_routes.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/upgrade/index.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_execute_route.js delete mode 100755 x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_upgrade_routes.js create mode 100644 x-pack/plugins/licensing/server/wrap_route_with_license_check.test.ts create mode 100644 x-pack/plugins/licensing/server/wrap_route_with_license_check.ts rename x-pack/{legacy/plugins/logstash/common/constants/es_scroll_settings.js => plugins/logstash/common/constants/es_scroll_settings.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/index.js => plugins/logstash/common/constants/index.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/index_names.js => plugins/logstash/common/constants/index_names.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/monitoring.js => plugins/logstash/common/constants/monitoring.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/pagination.js => plugins/logstash/common/constants/pagination.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/pipeline.js => plugins/logstash/common/constants/pipeline.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/plugin.js => plugins/logstash/common/constants/plugin.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/routes.js => plugins/logstash/common/constants/routes.ts} (100%) rename x-pack/{legacy/plugins/logstash/common/constants/tooltips.js => plugins/logstash/common/constants/tooltips.ts} (100%) create mode 100644 x-pack/plugins/logstash/kibana.json create mode 100644 x-pack/plugins/logstash/server/index.ts create mode 100755 x-pack/plugins/logstash/server/lib/check_license/check_license.test.ts create mode 100644 x-pack/plugins/logstash/server/lib/check_license/check_license.ts rename x-pack/{legacy/plugins/logstash/server/lib/call_with_request_factory/index.js => plugins/logstash/server/lib/check_license/index.ts} (77%) mode change 100755 => 100644 create mode 100755 x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.test.ts create mode 100755 x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.ts rename x-pack/{legacy/plugins/logstash/server/lib/fetch_all_from_scroll/index.js => plugins/logstash/server/lib/fetch_all_from_scroll/index.ts} (100%) rename x-pack/{legacy/plugins/logstash/server/models/cluster/__tests__/cluster.js => plugins/logstash/server/models/cluster/cluster.test.ts} (81%) rename x-pack/{legacy/plugins/logstash/server/models/cluster/cluster.js => plugins/logstash/server/models/cluster/cluster.ts} (68%) rename x-pack/{legacy/plugins/logstash/server/models/cluster/index.js => plugins/logstash/server/models/cluster/index.ts} (100%) rename x-pack/{legacy/plugins/logstash/server/models/pipeline/index.js => plugins/logstash/server/models/pipeline/index.ts} (100%) rename x-pack/{legacy/plugins/logstash/server/models/pipeline/__tests__/pipeline.js => plugins/logstash/server/models/pipeline/pipeline.test.ts} (74%) rename x-pack/{legacy/plugins/logstash/server/models/pipeline/pipeline.js => plugins/logstash/server/models/pipeline/pipeline.ts} (59%) rename x-pack/{legacy/plugins/logstash/server/models/pipeline_list_item/index.js => plugins/logstash/server/models/pipeline_list_item/index.ts} (100%) rename x-pack/{legacy/plugins/logstash/server/models/pipeline_list_item/__tests__/pipeline_list_item.js => plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.test.ts} (72%) rename x-pack/{legacy/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.js => plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.ts} (50%) create mode 100644 x-pack/plugins/logstash/server/plugin.ts rename x-pack/{legacy/plugins/logstash/server/routes/api/cluster/index.js => plugins/logstash/server/routes/cluster/index.ts} (76%) mode change 100755 => 100644 create mode 100644 x-pack/plugins/logstash/server/routes/cluster/load.ts create mode 100644 x-pack/plugins/logstash/server/routes/index.ts create mode 100644 x-pack/plugins/logstash/server/routes/pipeline/delete.ts rename x-pack/{legacy/plugins/logstash/server/lib/error_wrappers/index.js => plugins/logstash/server/routes/pipeline/index.ts} (60%) mode change 100755 => 100644 create mode 100644 x-pack/plugins/logstash/server/routes/pipeline/load.ts create mode 100644 x-pack/plugins/logstash/server/routes/pipeline/save.ts create mode 100644 x-pack/plugins/logstash/server/routes/pipelines/delete.ts rename x-pack/{legacy/plugins/logstash/server/routes/api/pipeline/index.js => plugins/logstash/server/routes/pipelines/index.ts} (68%) mode change 100755 => 100644 create mode 100644 x-pack/plugins/logstash/server/routes/pipelines/list.ts rename x-pack/{legacy/plugins/logstash/server/lib/license_pre_routing_factory/index.js => plugins/logstash/server/routes/upgrade/index.ts} (76%) mode change 100755 => 100644 create mode 100644 x-pack/plugins/logstash/server/routes/upgrade/upgrade.ts create mode 100644 x-pack/plugins/logstash/server/types.ts rename x-pack/test/api_integration/apis/logstash/cluster/{index.js => index.ts} (71%) rename x-pack/test/api_integration/apis/logstash/cluster/{load.js => load.ts} (83%) rename x-pack/test/api_integration/apis/logstash/{index.js => index.ts} (76%) rename x-pack/test/api_integration/apis/logstash/pipeline/{delete.js => delete.ts} (90%) rename x-pack/test/api_integration/apis/logstash/pipeline/{index.js => index.ts} (76%) rename x-pack/test/api_integration/apis/logstash/pipeline/{load.js => load.ts} (82%) rename x-pack/test/api_integration/apis/logstash/pipeline/{save.js => save.ts} (90%) rename x-pack/test/api_integration/apis/logstash/pipelines/{delete.js => delete.ts} (90%) rename x-pack/test/api_integration/apis/logstash/pipelines/{index.js => index.ts} (73%) rename x-pack/test/api_integration/apis/logstash/pipelines/{list.js => list.ts} (82%) diff --git a/x-pack/.i18nrc.json b/x-pack/.i18nrc.json index bbbcc062786b0..b3744f7cf93ab 100644 --- a/x-pack/.i18nrc.json +++ b/x-pack/.i18nrc.json @@ -24,7 +24,7 @@ "xpack.lens": "legacy/plugins/lens", "xpack.licenseMgmt": "plugins/license_management", "xpack.licensing": "plugins/licensing", - "xpack.logstash": "legacy/plugins/logstash", + "xpack.logstash": ["plugins/logstash", "legacy/plugins/logstash"], "xpack.main": "legacy/plugins/xpack_main", "xpack.maps": ["plugins/maps", "legacy/plugins/maps"], "xpack.ml": ["plugins/ml", "legacy/plugins/ml"], diff --git a/x-pack/legacy/plugins/logstash/index.js b/x-pack/legacy/plugins/logstash/index.js index ae8571d1c19c3..29f01032f3413 100755 --- a/x-pack/legacy/plugins/logstash/index.js +++ b/x-pack/legacy/plugins/logstash/index.js @@ -5,12 +5,8 @@ */ import { resolve } from 'path'; -import { registerLogstashPipelinesRoutes } from './server/routes/api/pipelines'; -import { registerLogstashPipelineRoutes } from './server/routes/api/pipeline'; -import { registerLogstashUpgradeRoutes } from './server/routes/api/upgrade'; -import { registerLogstashClusterRoutes } from './server/routes/api/cluster'; import { registerLicenseChecker } from './server/lib/register_license_checker'; -import { PLUGIN } from './common/constants'; +import { PLUGIN } from '../../../plugins/logstash/common/constants'; export const logstash = kibana => new kibana.Plugin({ @@ -32,9 +28,5 @@ export const logstash = kibana => }, init: server => { registerLicenseChecker(server); - registerLogstashPipelinesRoutes(server); - registerLogstashPipelineRoutes(server); - registerLogstashUpgradeRoutes(server); - registerLogstashClusterRoutes(server); }, }); diff --git a/x-pack/legacy/plugins/logstash/public/components/pipeline_editor/pipeline_editor.js b/x-pack/legacy/plugins/logstash/public/components/pipeline_editor/pipeline_editor.js index 43ca656e0827c..5e430ccbd8ceb 100644 --- a/x-pack/legacy/plugins/logstash/public/components/pipeline_editor/pipeline_editor.js +++ b/x-pack/legacy/plugins/logstash/public/components/pipeline_editor/pipeline_editor.js @@ -13,7 +13,7 @@ import 'brace/mode/plain_text'; import 'brace/theme/github'; import { isEmpty } from 'lodash'; -import { TOOLTIPS } from '../../../common/constants/tooltips'; +import { TOOLTIPS } from '../../../../../../plugins/logstash/common/constants/tooltips'; import { EuiButton, EuiButtonEmpty, diff --git a/x-pack/legacy/plugins/logstash/public/lib/register_home_feature.ts b/x-pack/legacy/plugins/logstash/public/lib/register_home_feature.ts index e943656120d5e..2e1ee2afb9ce6 100644 --- a/x-pack/legacy/plugins/logstash/public/lib/register_home_feature.ts +++ b/x-pack/legacy/plugins/logstash/public/lib/register_home_feature.ts @@ -10,7 +10,7 @@ import { npSetup } from 'ui/new_platform'; import { xpackInfo } from 'plugins/xpack_main/services/xpack_info'; import { FeatureCatalogueCategory } from '../../../../../../src/plugins/home/public'; // @ts-ignore -import { PLUGIN } from '../../common/constants'; +import { PLUGIN } from '../../../../../plugins/logstash/common/constants'; const { plugins: { home }, diff --git a/x-pack/legacy/plugins/logstash/public/models/pipeline_list_item/pipeline_list_item.js b/x-pack/legacy/plugins/logstash/public/models/pipeline_list_item/pipeline_list_item.js index 14900fdaa7cdc..06d01a05bac27 100755 --- a/x-pack/legacy/plugins/logstash/public/models/pipeline_list_item/pipeline_list_item.js +++ b/x-pack/legacy/plugins/logstash/public/models/pipeline_list_item/pipeline_list_item.js @@ -8,7 +8,7 @@ import { pick, capitalize } from 'lodash'; import { getSearchValue } from 'plugins/logstash/lib/get_search_value'; import { getMoment } from 'plugins/logstash/../common/lib/get_moment'; -import { PIPELINE } from '../../../common/constants'; +import { PIPELINE } from '../../../../../../plugins/logstash/common/constants'; /** * Represents the model for listing pipelines in the UI diff --git a/x-pack/legacy/plugins/logstash/public/services/cluster/cluster_service.js b/x-pack/legacy/plugins/logstash/public/services/cluster/cluster_service.js index 4bad4f48cc61d..e89c2fe7d11bf 100755 --- a/x-pack/legacy/plugins/logstash/public/services/cluster/cluster_service.js +++ b/x-pack/legacy/plugins/logstash/public/services/cluster/cluster_service.js @@ -5,7 +5,7 @@ */ import chrome from 'ui/chrome'; -import { ROUTES } from '../../../common/constants'; +import { ROUTES } from '../../../../../../plugins/logstash/common/constants'; import { Cluster } from 'plugins/logstash/models/cluster'; export class ClusterService { diff --git a/x-pack/legacy/plugins/logstash/public/services/license/logstash_license_service.js b/x-pack/legacy/plugins/logstash/public/services/license/logstash_license_service.js index 97b336ec0728b..69cc8614a6ae2 100755 --- a/x-pack/legacy/plugins/logstash/public/services/license/logstash_license_service.js +++ b/x-pack/legacy/plugins/logstash/public/services/license/logstash_license_service.js @@ -7,7 +7,7 @@ import React from 'react'; import { toastNotifications } from 'ui/notify'; import { MarkdownSimple } from '../../../../../../../src/plugins/kibana_react/public'; -import { PLUGIN } from '../../../common/constants'; +import { PLUGIN } from '../../../../../../plugins/logstash/common/constants'; export class LogstashLicenseService { constructor(xpackInfoService, kbnUrlService, $timeout) { diff --git a/x-pack/legacy/plugins/logstash/public/services/monitoring/monitoring_service.js b/x-pack/legacy/plugins/logstash/public/services/monitoring/monitoring_service.js index 8a267e38db738..6103e730c2171 100755 --- a/x-pack/legacy/plugins/logstash/public/services/monitoring/monitoring_service.js +++ b/x-pack/legacy/plugins/logstash/public/services/monitoring/monitoring_service.js @@ -6,7 +6,7 @@ import moment from 'moment'; import chrome from 'ui/chrome'; -import { ROUTES, MONITORING } from '../../../common/constants'; +import { ROUTES, MONITORING } from '../../../../../../plugins/logstash/common/constants'; import { PipelineListItem } from 'plugins/logstash/models/pipeline_list_item'; export class MonitoringService { diff --git a/x-pack/legacy/plugins/logstash/public/services/pipeline/pipeline_service.js b/x-pack/legacy/plugins/logstash/public/services/pipeline/pipeline_service.js index 0696bf9d83256..b5d0dbeb852d5 100755 --- a/x-pack/legacy/plugins/logstash/public/services/pipeline/pipeline_service.js +++ b/x-pack/legacy/plugins/logstash/public/services/pipeline/pipeline_service.js @@ -5,7 +5,7 @@ */ import chrome from 'ui/chrome'; -import { ROUTES } from '../../../common/constants'; +import { ROUTES } from '../../../../../../plugins/logstash/common/constants'; import { Pipeline } from 'plugins/logstash/models/pipeline'; export class PipelineService { diff --git a/x-pack/legacy/plugins/logstash/public/services/pipelines/pipelines_service.js b/x-pack/legacy/plugins/logstash/public/services/pipelines/pipelines_service.js index 5a43cf07eba41..d70c8be06fde4 100755 --- a/x-pack/legacy/plugins/logstash/public/services/pipelines/pipelines_service.js +++ b/x-pack/legacy/plugins/logstash/public/services/pipelines/pipelines_service.js @@ -5,7 +5,7 @@ */ import chrome from 'ui/chrome'; -import { ROUTES, MONITORING } from '../../../common/constants'; +import { ROUTES, MONITORING } from '../../../../../../plugins/logstash/common/constants'; import { PipelineListItem } from 'plugins/logstash/models/pipeline_list_item'; const RECENTLY_DELETED_PIPELINE_IDS_STORAGE_KEY = 'xpack.logstash.recentlyDeletedPipelines'; diff --git a/x-pack/legacy/plugins/logstash/public/services/upgrade/upgrade_service.js b/x-pack/legacy/plugins/logstash/public/services/upgrade/upgrade_service.js index 7870a495d07a3..2019bdc1bf1aa 100755 --- a/x-pack/legacy/plugins/logstash/public/services/upgrade/upgrade_service.js +++ b/x-pack/legacy/plugins/logstash/public/services/upgrade/upgrade_service.js @@ -5,7 +5,7 @@ */ import chrome from 'ui/chrome'; -import { ROUTES } from '../../../common/constants'; +import { ROUTES } from '../../../../../../plugins/logstash/common/constants'; export class UpgradeService { constructor($http) { diff --git a/x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/call_with_request_factory.js b/x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/call_with_request_factory.js deleted file mode 100755 index 8dc09d394e973..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/call_with_request_factory.js +++ /dev/null @@ -1,18 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { once } from 'lodash'; - -const callWithRequest = once(server => { - const cluster = server.plugins.elasticsearch.createCluster('logstash'); - return cluster.callWithRequest; -}); - -export const callWithRequestFactory = (server, request) => { - return (...args) => { - return callWithRequest(server)(request, ...args); - }; -}; diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_custom_error.js b/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_custom_error.js deleted file mode 100755 index f9c102be7a1ff..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_custom_error.js +++ /dev/null @@ -1,21 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { wrapCustomError } from '../wrap_custom_error'; - -describe('wrap_custom_error', () => { - describe('#wrapCustomError', () => { - it('should return a Boom object', () => { - const originalError = new Error('I am an error'); - const statusCode = 404; - const wrappedError = wrapCustomError(originalError, statusCode); - - expect(wrappedError.isBoom).to.be(true); - expect(wrappedError.output.statusCode).to.equal(statusCode); - }); - }); -}); diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_es_error.js b/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_es_error.js deleted file mode 100755 index cab25cd0b1b10..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_es_error.js +++ /dev/null @@ -1,42 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { wrapEsError } from '../wrap_es_error'; - -describe('wrap_es_error', () => { - describe('#wrapEsError', () => { - let originalError; - beforeEach(() => { - originalError = new Error('I am an error'); - originalError.statusCode = 404; - }); - - it('should return a Boom object', () => { - const wrappedError = wrapEsError(originalError); - - expect(wrappedError.isBoom).to.be(true); - }); - - it('should return the correct Boom object', () => { - const wrappedError = wrapEsError(originalError); - - expect(wrappedError.output.statusCode).to.be(originalError.statusCode); - expect(wrappedError.output.payload.message).to.be(originalError.message); - }); - - it('should return invalid permissions message for 403 errors', () => { - const securityError = new Error('I am an error'); - securityError.statusCode = 403; - const wrappedError = wrapEsError(securityError); - - expect(wrappedError.isBoom).to.be(true); - expect(wrappedError.message).to.be( - 'Insufficient user permissions for managing Logstash pipelines' - ); - }); - }); -}); diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_unknown_error.js b/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_unknown_error.js deleted file mode 100755 index 85e0b2b3033ad..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/__tests__/wrap_unknown_error.js +++ /dev/null @@ -1,19 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { wrapUnknownError } from '../wrap_unknown_error'; - -describe('wrap_unknown_error', () => { - describe('#wrapUnknownError', () => { - it('should return a Boom object', () => { - const originalError = new Error('I am an error'); - const wrappedError = wrapUnknownError(originalError); - - expect(wrappedError.isBoom).to.be(true); - }); - }); -}); diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_custom_error.js b/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_custom_error.js deleted file mode 100755 index 3295113d38ee5..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_custom_error.js +++ /dev/null @@ -1,18 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; - -/** - * Wraps a custom error into a Boom error response and returns it - * - * @param err Object error - * @param statusCode Error status code - * @return Object Boom error response - */ -export function wrapCustomError(err, statusCode) { - return Boom.boomify(err, { statusCode }); -} diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_es_error.js b/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_es_error.js deleted file mode 100755 index 41819179bde55..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_es_error.js +++ /dev/null @@ -1,27 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; -import { i18n } from '@kbn/i18n'; - -/** - * Wraps ES errors into a Boom error response and returns it - * This also handles the permissions issue gracefully - * - * @param err Object ES error - * @return Object Boom error response - */ -export function wrapEsError(err) { - const statusCode = err.statusCode; - if (statusCode === 403) { - return Boom.forbidden( - i18n.translate('xpack.logstash.insufficientUserPermissionsDescription', { - defaultMessage: 'Insufficient user permissions for managing Logstash pipelines', - }) - ); - } - return Boom.boomify(err, { statusCode: err.statusCode }); -} diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_unknown_error.js b/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_unknown_error.js deleted file mode 100755 index ffd915c513362..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/wrap_unknown_error.js +++ /dev/null @@ -1,17 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; - -/** - * Wraps an unknown error into a Boom error response and returns it - * - * @param err Object Unknown error - * @return Object Boom error response - */ -export function wrapUnknownError(err) { - return Boom.boomify(err); -} diff --git a/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/__tests__/fetch_all_from_scroll.js b/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/__tests__/fetch_all_from_scroll.js deleted file mode 100755 index b1593fb1ba355..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/__tests__/fetch_all_from_scroll.js +++ /dev/null @@ -1,88 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import sinon from 'sinon'; -import { fetchAllFromScroll } from '../fetch_all_from_scroll'; -import { set } from 'lodash'; - -describe('fetch_all_from_scroll', () => { - let mockResponse; - let stubCallWithRequest; - - beforeEach(() => { - mockResponse = {}; - - stubCallWithRequest = sinon.stub(); - stubCallWithRequest.onCall(0).returns( - new Promise(resolve => { - const mockInnerResponse = { - hits: { - hits: ['newhit'], - }, - _scroll_id: 'newScrollId', - }; - return resolve(mockInnerResponse); - }) - ); - - stubCallWithRequest.onCall(1).returns( - new Promise(resolve => { - const mockInnerResponse = { - hits: { - hits: [], - }, - }; - return resolve(mockInnerResponse); - }) - ); - }); - - describe('#fetchAllFromScroll', () => { - describe('when the passed-in response has no hits', () => { - beforeEach(() => { - set(mockResponse, 'hits.hits', []); - }); - - it('should return an empty array of hits', () => { - return fetchAllFromScroll(mockResponse).then(hits => { - expect(hits).to.eql([]); - }); - }); - - it('should not call callWithRequest', () => { - return fetchAllFromScroll(mockResponse, stubCallWithRequest).then(() => { - expect(stubCallWithRequest.called).to.be(false); - }); - }); - }); - - describe('when the passed-in response has some hits', () => { - beforeEach(() => { - set(mockResponse, 'hits.hits', ['foo', 'bar']); - set(mockResponse, '_scroll_id', 'originalScrollId'); - }); - - it('should return the hits from the response', () => { - return fetchAllFromScroll(mockResponse, stubCallWithRequest).then(hits => { - expect(hits).to.eql(['foo', 'bar', 'newhit']); - }); - }); - - it('should call callWithRequest', () => { - return fetchAllFromScroll(mockResponse, stubCallWithRequest).then(() => { - expect(stubCallWithRequest.calledTwice).to.be(true); - - const firstCallWithRequestCallArgs = stubCallWithRequest.args[0]; - expect(firstCallWithRequestCallArgs[1].body.scroll_id).to.eql('originalScrollId'); - - const secondCallWithRequestCallArgs = stubCallWithRequest.args[1]; - expect(secondCallWithRequestCallArgs[1].body.scroll_id).to.eql('newScrollId'); - }); - }); - }); - }); -}); diff --git a/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.js b/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.js deleted file mode 100755 index 835ef0090a5d2..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.js +++ /dev/null @@ -1,28 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { get } from 'lodash'; -import { ES_SCROLL_SETTINGS } from '../../../common/constants'; - -export function fetchAllFromScroll(response, callWithRequest, hits = []) { - const newHits = get(response, 'hits.hits', []); - const scrollId = get(response, '_scroll_id'); - - if (newHits.length > 0) { - hits.push(...newHits); - - return callWithRequest('scroll', { - body: { - scroll: ES_SCROLL_SETTINGS.KEEPALIVE, - scroll_id: scrollId, - }, - }).then(innerResponse => { - return fetchAllFromScroll(innerResponse, callWithRequest, hits); - }); - } - - return Promise.resolve(hits); -} diff --git a/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js b/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js deleted file mode 100755 index 1dc1df922acf7..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/__tests__/license_pre_routing_factory.js +++ /dev/null @@ -1,69 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { licensePreRoutingFactory } from '../license_pre_routing_factory'; - -describe('license_pre_routing_factory', () => { - describe('#logstashFeaturePreRoutingFactory', () => { - let mockServer; - let mockLicenseCheckResults; - - beforeEach(() => { - mockServer = { - plugins: { - xpack_main: { - info: { - feature: () => ({ - getLicenseCheckResults: () => mockLicenseCheckResults, - }), - }, - }, - }, - }; - }); - - it('only instantiates one instance per server', () => { - const firstInstance = licensePreRoutingFactory(mockServer); - const secondInstance = licensePreRoutingFactory(mockServer); - - expect(firstInstance).to.be(secondInstance); - }); - - describe('isAvailable is false', () => { - beforeEach(() => { - mockLicenseCheckResults = { - isAvailable: false, - }; - }); - - it('replies with 403', () => { - const licensePreRouting = licensePreRoutingFactory(mockServer); - const stubRequest = {}; - expect(() => licensePreRouting(stubRequest)).to.throwException(response => { - expect(response).to.be.an(Error); - expect(response.isBoom).to.be(true); - expect(response.output.statusCode).to.be(403); - }); - }); - }); - - describe('isAvailable is true', () => { - beforeEach(() => { - mockLicenseCheckResults = { - isAvailable: true, - }; - }); - - it('replies with nothing', () => { - const licensePreRouting = licensePreRoutingFactory(mockServer); - const stubRequest = {}; - const response = licensePreRouting(stubRequest); - expect(response).to.be(null); - }); - }); - }); -}); diff --git a/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/license_pre_routing_factory.js b/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/license_pre_routing_factory.js deleted file mode 100755 index 05402a56a52d8..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/license_pre_routing_factory.js +++ /dev/null @@ -1,27 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { once } from 'lodash'; -import { wrapCustomError } from '../error_wrappers'; -import { PLUGIN } from '../../../common/constants'; - -export const licensePreRoutingFactory = once(server => { - const xpackMainPlugin = server.plugins.xpack_main; - - // License checking and enable/disable logic - function licensePreRouting() { - const licenseCheckResults = xpackMainPlugin.info.feature(PLUGIN.ID).getLicenseCheckResults(); - if (!licenseCheckResults.isAvailable) { - const error = new Error(licenseCheckResults.message); - const statusCode = 403; - throw wrapCustomError(error, statusCode); - } - - return null; - } - - return licensePreRouting; -}); diff --git a/x-pack/legacy/plugins/logstash/server/lib/register_license_checker/register_license_checker.js b/x-pack/legacy/plugins/logstash/server/lib/register_license_checker/register_license_checker.js index 8a17fb2eea497..a0d06e77b410d 100755 --- a/x-pack/legacy/plugins/logstash/server/lib/register_license_checker/register_license_checker.js +++ b/x-pack/legacy/plugins/logstash/server/lib/register_license_checker/register_license_checker.js @@ -6,7 +6,7 @@ import { mirrorPluginStatus } from '../../../../../server/lib/mirror_plugin_status'; import { checkLicense } from '../check_license'; -import { PLUGIN } from '../../../common/constants'; +import { PLUGIN } from '../../../../../../plugins/logstash/common/constants'; export function registerLicenseChecker(server) { const xpackMainPlugin = server.plugins.xpack_main; diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_cluster_routes.js b/x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_cluster_routes.js deleted file mode 100755 index 86e18b02ddce2..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_cluster_routes.js +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { registerLoadRoute } from './register_load_route'; - -export function registerLogstashClusterRoutes(server) { - registerLoadRoute(server); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_load_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_load_route.js deleted file mode 100755 index 663b60cc8c1d1..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/cluster/register_load_route.js +++ /dev/null @@ -1,40 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { Cluster } from '../../../models/cluster'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function fetchCluster(callWithRequest) { - return callWithRequest('info'); -} - -export function registerLoadRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/cluster', - method: 'GET', - handler: (request, h) => { - const callWithRequest = callWithRequestFactory(server, request); - - return fetchCluster(callWithRequest) - .then(responseFromES => ({ - cluster: Cluster.fromUpstreamJSON(responseFromES).downstreamJSON, - })) - .catch(e => { - if (e.status === 403) { - return h.response(); - } - throw Boom.internal(e); - }); - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_delete_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_delete_route.js deleted file mode 100755 index 232ee4207541c..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_delete_route.js +++ /dev/null @@ -1,38 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { wrapEsError } from '../../../lib/error_wrappers'; -import { INDEX_NAMES } from '../../../../common/constants'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function deletePipeline(callWithRequest, pipelineId) { - return callWithRequest('delete', { - index: INDEX_NAMES.PIPELINES, - id: pipelineId, - refresh: 'wait_for', - }); -} - -export function registerDeleteRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/pipeline/{id}', - method: 'DELETE', - handler: (request, h) => { - const callWithRequest = callWithRequestFactory(server, request); - const pipelineId = request.params.id; - - return deletePipeline(callWithRequest, pipelineId) - .then(() => h.response().code(204)) - .catch(e => wrapEsError(e)); - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_load_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_load_route.js deleted file mode 100755 index 796bf939d747f..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_load_route.js +++ /dev/null @@ -1,47 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import Boom from 'boom'; -import { INDEX_NAMES } from '../../../../common/constants'; -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { Pipeline } from '../../../models/pipeline'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function fetchPipeline(callWithRequest, pipelineId) { - return callWithRequest('get', { - index: INDEX_NAMES.PIPELINES, - id: pipelineId, - _source: ['description', 'username', 'pipeline', 'pipeline_settings'], - ignore: [404], - }); -} - -export function registerLoadRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/pipeline/{id}', - method: 'GET', - handler: request => { - const callWithRequest = callWithRequestFactory(server, request); - const pipelineId = request.params.id; - - return fetchPipeline(callWithRequest, pipelineId) - .then(pipelineResponseFromES => { - if (!pipelineResponseFromES.found) { - throw Boom.notFound(); - } - - const pipeline = Pipeline.fromUpstreamJSON(pipelineResponseFromES); - return pipeline.downstreamJSON; - }) - .catch(e => Boom.boomify(e)); - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_pipeline_routes.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_pipeline_routes.js deleted file mode 100755 index 9966cd2ca2139..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_pipeline_routes.js +++ /dev/null @@ -1,15 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { registerLoadRoute } from './register_load_route'; -import { registerDeleteRoute } from './register_delete_route'; -import { registerSaveRoute } from './register_save_route'; - -export function registerLogstashPipelineRoutes(server) { - registerLoadRoute(server); - registerDeleteRoute(server); - registerSaveRoute(server); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_save_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_save_route.js deleted file mode 100755 index 50f62dc0a0ddd..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/register_save_route.js +++ /dev/null @@ -1,48 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { get } from 'lodash'; -import { wrapEsError } from '../../../lib/error_wrappers'; -import { INDEX_NAMES } from '../../../../common/constants'; -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { Pipeline } from '../../../models/pipeline'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function savePipeline(callWithRequest, pipelineId, pipelineBody) { - return callWithRequest('index', { - index: INDEX_NAMES.PIPELINES, - id: pipelineId, - body: pipelineBody, - refresh: 'wait_for', - }); -} - -export function registerSaveRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/pipeline/{id}', - method: 'PUT', - handler: async (request, h) => { - let username; - if (server.plugins.security) { - const user = await server.plugins.security.getUser(request); - username = get(user, 'username'); - } - - const callWithRequest = callWithRequestFactory(server, request); - const pipelineId = request.params.id; - - const pipeline = Pipeline.fromDownstreamJSON(request.payload, pipelineId, username); - return savePipeline(callWithRequest, pipeline.id, pipeline.upstreamJSON) - .then(() => h.response().code(204)) - .catch(e => wrapEsError(e)); - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/index.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/index.js deleted file mode 100755 index db275b5a3ea79..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/index.js +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerLogstashPipelinesRoutes } from './register_pipelines_routes'; diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_delete_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_delete_route.js deleted file mode 100755 index 8ccd792d5a876..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_delete_route.js +++ /dev/null @@ -1,51 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { wrapUnknownError } from '../../../lib/error_wrappers'; -import { INDEX_NAMES } from '../../../../common/constants'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function deletePipelines(callWithRequest, pipelineIds) { - const deletePromises = pipelineIds.map(pipelineId => { - return callWithRequest('delete', { - index: INDEX_NAMES.PIPELINES, - id: pipelineId, - refresh: 'wait_for', - }) - .then(success => ({ success })) - .catch(error => ({ error })); - }); - - return Promise.all(deletePromises).then(results => { - const successes = results.filter(result => Boolean(result.success)); - const errors = results.filter(result => Boolean(result.error)); - - return { - numSuccesses: successes.length, - numErrors: errors.length, - }; - }); -} - -export function registerDeleteRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/pipelines/delete', - method: 'POST', - handler: request => { - const callWithRequest = callWithRequestFactory(server, request); - - return deletePipelines(callWithRequest, request.payload.pipelineIds) - .then(results => ({ results })) - .catch(err => wrapUnknownError(err)); - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_list_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_list_route.js deleted file mode 100755 index 43ce1c3e8f6f6..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_list_route.js +++ /dev/null @@ -1,52 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { wrapEsError } from '../../../lib/error_wrappers'; -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { fetchAllFromScroll } from '../../../lib/fetch_all_from_scroll'; -import { INDEX_NAMES, ES_SCROLL_SETTINGS } from '../../../../common/constants'; -import { PipelineListItem } from '../../../models/pipeline_list_item'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function fetchPipelines(callWithRequest) { - const params = { - index: INDEX_NAMES.PIPELINES, - scroll: ES_SCROLL_SETTINGS.KEEPALIVE, - body: { - size: ES_SCROLL_SETTINGS.PAGE_SIZE, - }, - ignore: [404], - }; - - return callWithRequest('search', params).then(response => - fetchAllFromScroll(response, callWithRequest) - ); -} - -export function registerListRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/pipelines', - method: 'GET', - handler: request => { - const callWithRequest = callWithRequestFactory(server, request); - - return fetchPipelines(callWithRequest) - .then((pipelinesHits = []) => { - const pipelines = pipelinesHits.map(pipeline => { - return PipelineListItem.fromUpstreamJSON(pipeline).downstreamJSON; - }); - - return { pipelines }; - }) - .catch(e => wrapEsError(e)); - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_pipelines_routes.js b/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_pipelines_routes.js deleted file mode 100755 index 6d25f3acb9bf9..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipelines/register_pipelines_routes.js +++ /dev/null @@ -1,13 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { registerListRoute } from './register_list_route'; -import { registerDeleteRoute } from './register_delete_route'; - -export function registerLogstashPipelinesRoutes(server) { - registerListRoute(server); - registerDeleteRoute(server); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/index.js b/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/index.js deleted file mode 100755 index d616349dd6566..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/index.js +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { registerLogstashUpgradeRoutes } from './register_upgrade_routes'; diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_execute_route.js b/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_execute_route.js deleted file mode 100755 index 16f97930ae25e..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_execute_route.js +++ /dev/null @@ -1,56 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { callWithRequestFactory } from '../../../lib/call_with_request_factory'; -import { wrapUnknownError } from '../../../lib/error_wrappers'; -import { INDEX_NAMES } from '../../../../common/constants'; -import { licensePreRoutingFactory } from '../../../lib/license_pre_routing_factory'; - -function doesIndexExist(callWithRequest) { - return callWithRequest('indices.exists', { - index: INDEX_NAMES.PIPELINES, - }); -} - -async function executeUpgrade(callWithRequest) { - // If index doesn't exist yet, there is no mapping to upgrade - if (!(await doesIndexExist(callWithRequest))) { - return; - } - - return callWithRequest('indices.putMapping', { - index: INDEX_NAMES.PIPELINES, - body: { - properties: { - pipeline_settings: { - dynamic: false, - type: 'object', - }, - }, - }, - }); -} - -export function registerExecuteRoute(server) { - const licensePreRouting = licensePreRoutingFactory(server); - - server.route({ - path: '/api/logstash/upgrade', - method: 'POST', - handler: async request => { - const callWithRequest = callWithRequestFactory(server, request); - try { - await executeUpgrade(callWithRequest); - return { is_upgraded: true }; - } catch (err) { - throw wrapUnknownError(err); - } - }, - config: { - pre: [licensePreRouting], - }, - }); -} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_upgrade_routes.js b/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_upgrade_routes.js deleted file mode 100755 index a198f82613e37..0000000000000 --- a/x-pack/legacy/plugins/logstash/server/routes/api/upgrade/register_upgrade_routes.js +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { registerExecuteRoute } from './register_execute_route'; - -export function registerLogstashUpgradeRoutes(server) { - registerExecuteRoute(server); -} diff --git a/x-pack/plugins/licensing/common/licensing.mock.ts b/x-pack/plugins/licensing/common/licensing.mock.ts index bf8b85e3e981b..4a6b27255587a 100644 --- a/x-pack/plugins/licensing/common/licensing.mock.ts +++ b/x-pack/plugins/licensing/common/licensing.mock.ts @@ -53,6 +53,7 @@ const createLicenseMock = () => { }; mock.check.mockReturnValue({ state: 'valid' }); mock.hasAtLeast.mockReturnValue(true); + mock.getFeature.mockReturnValue({ isAvailable: true, isEnabled: true }); return mock; }; export const licenseMock = { diff --git a/x-pack/plugins/licensing/server/index.ts b/x-pack/plugins/licensing/server/index.ts index 0e14ead7c6c57..76e65afc595c4 100644 --- a/x-pack/plugins/licensing/server/index.ts +++ b/x-pack/plugins/licensing/server/index.ts @@ -12,3 +12,4 @@ export const plugin = (context: PluginInitializerContext) => new LicensingPlugin export * from '../common/types'; export * from './types'; export { config } from './licensing_config'; +export { CheckLicense, wrapRouteWithLicenseCheck } from './wrap_route_with_license_check'; diff --git a/x-pack/plugins/licensing/server/wrap_route_with_license_check.test.ts b/x-pack/plugins/licensing/server/wrap_route_with_license_check.test.ts new file mode 100644 index 0000000000000..7abdd3f6190ce --- /dev/null +++ b/x-pack/plugins/licensing/server/wrap_route_with_license_check.test.ts @@ -0,0 +1,71 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { httpServerMock } from 'src/core/server/mocks'; + +import { wrapRouteWithLicenseCheck, CheckLicense } from './wrap_route_with_license_check'; + +const context = { + licensing: { + license: {}, + }, +} as any; +const request = httpServerMock.createKibanaRequest(); + +describe('wrapRouteWithLicenseCheck', () => { + it('calls route handler if checkLicense returns "valid": true', async () => { + const checkLicense: CheckLicense = () => ({ valid: true, message: null }); + const routeHandler = jest.fn(); + const wrapper = wrapRouteWithLicenseCheck(checkLicense, routeHandler); + const response = httpServerMock.createResponseFactory(); + + await wrapper(context, request, response); + + expect(routeHandler).toHaveBeenCalledTimes(1); + expect(routeHandler).toHaveBeenCalledWith(context, request, response); + }); + + it('does not call route handler if checkLicense returns "valid": false', async () => { + const checkLicense: CheckLicense = () => ({ valid: false, message: 'reason' }); + const routeHandler = jest.fn(); + const wrapper = wrapRouteWithLicenseCheck(checkLicense, routeHandler); + const response = httpServerMock.createResponseFactory(); + + await wrapper(context, request, response); + + expect(routeHandler).toHaveBeenCalledTimes(0); + expect(response.forbidden).toHaveBeenCalledTimes(1); + expect(response.forbidden).toHaveBeenCalledWith({ body: 'reason' }); + }); + + it('allows an exception to bubble up if handler throws', async () => { + const checkLicense: CheckLicense = () => ({ valid: true, message: null }); + const routeHandler = () => { + throw new Error('reason'); + }; + const wrapper = wrapRouteWithLicenseCheck(checkLicense, routeHandler); + const response = httpServerMock.createResponseFactory(); + + await expect(wrapper(context, request, response)).rejects.toThrowErrorMatchingInlineSnapshot( + `"reason"` + ); + }); + + it('allows an exception to bubble up if "checkLicense" throws', async () => { + const checkLicense: CheckLicense = () => { + throw new Error('reason'); + }; + const routeHandler = jest.fn(); + const wrapper = wrapRouteWithLicenseCheck(checkLicense, routeHandler); + const response = httpServerMock.createResponseFactory(); + + await expect(wrapper(context, request, response)).rejects.toThrowErrorMatchingInlineSnapshot( + `"reason"` + ); + + expect(routeHandler).toHaveBeenCalledTimes(0); + }); +}); diff --git a/x-pack/plugins/licensing/server/wrap_route_with_license_check.ts b/x-pack/plugins/licensing/server/wrap_route_with_license_check.ts new file mode 100644 index 0000000000000..e0cac8d9db208 --- /dev/null +++ b/x-pack/plugins/licensing/server/wrap_route_with_license_check.ts @@ -0,0 +1,40 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { + RequestHandler, + RequestHandlerContext, + KibanaRequest, + RouteMethod, + KibanaResponseFactory, +} from 'src/core/server'; + +import { ILicense } from '../common/types'; + +export type CheckLicense = ( + license: ILicense +) => { valid: false; message: string } | { valid: true; message: null }; + +export function wrapRouteWithLicenseCheck<P, Q, B>( + checkLicense: CheckLicense, + handler: RequestHandler<P, Q, B> +): RequestHandler<P, Q, B> { + return async ( + context: RequestHandlerContext, + request: KibanaRequest<P, Q, B, RouteMethod>, + response: KibanaResponseFactory + ) => { + const licenseCheckResult = checkLicense(context.licensing.license); + + if (licenseCheckResult.valid) { + return handler(context, request, response); + } else { + return response.forbidden({ + body: licenseCheckResult.message, + }); + } + }; +} diff --git a/x-pack/legacy/plugins/logstash/common/constants/es_scroll_settings.js b/x-pack/plugins/logstash/common/constants/es_scroll_settings.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/es_scroll_settings.js rename to x-pack/plugins/logstash/common/constants/es_scroll_settings.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/index.js b/x-pack/plugins/logstash/common/constants/index.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/index.js rename to x-pack/plugins/logstash/common/constants/index.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/index_names.js b/x-pack/plugins/logstash/common/constants/index_names.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/index_names.js rename to x-pack/plugins/logstash/common/constants/index_names.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/monitoring.js b/x-pack/plugins/logstash/common/constants/monitoring.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/monitoring.js rename to x-pack/plugins/logstash/common/constants/monitoring.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/pagination.js b/x-pack/plugins/logstash/common/constants/pagination.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/pagination.js rename to x-pack/plugins/logstash/common/constants/pagination.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/pipeline.js b/x-pack/plugins/logstash/common/constants/pipeline.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/pipeline.js rename to x-pack/plugins/logstash/common/constants/pipeline.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/plugin.js b/x-pack/plugins/logstash/common/constants/plugin.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/plugin.js rename to x-pack/plugins/logstash/common/constants/plugin.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/routes.js b/x-pack/plugins/logstash/common/constants/routes.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/routes.js rename to x-pack/plugins/logstash/common/constants/routes.ts diff --git a/x-pack/legacy/plugins/logstash/common/constants/tooltips.js b/x-pack/plugins/logstash/common/constants/tooltips.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/common/constants/tooltips.js rename to x-pack/plugins/logstash/common/constants/tooltips.ts diff --git a/x-pack/plugins/logstash/kibana.json b/x-pack/plugins/logstash/kibana.json new file mode 100644 index 0000000000000..bcc926535d3c2 --- /dev/null +++ b/x-pack/plugins/logstash/kibana.json @@ -0,0 +1,12 @@ +{ + "id": "logstash", + "version": "0.0.1", + "kibanaVersion": "kibana", + "configPath": ["xpack", "logstash"], + "requiredPlugins": [ + "licensing" + ], + "optionalPlugins": ["security"], + "server": true, + "ui": false +} diff --git a/x-pack/plugins/logstash/server/index.ts b/x-pack/plugins/logstash/server/index.ts new file mode 100644 index 0000000000000..cc65184a1f3a0 --- /dev/null +++ b/x-pack/plugins/logstash/server/index.ts @@ -0,0 +1,16 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { schema } from '@kbn/config-schema'; +import { PluginInitializerContext, PluginConfigDescriptor } from 'src/core/server'; +import { LogstashPlugin } from './plugin'; + +export const plugin = (context: PluginInitializerContext) => new LogstashPlugin(context); + +export const config: PluginConfigDescriptor = { + schema: schema.object({ + enabled: schema.boolean({ defaultValue: true }), + }), +}; diff --git a/x-pack/plugins/logstash/server/lib/check_license/check_license.test.ts b/x-pack/plugins/logstash/server/lib/check_license/check_license.test.ts new file mode 100755 index 0000000000000..324e0a22ff378 --- /dev/null +++ b/x-pack/plugins/logstash/server/lib/check_license/check_license.test.ts @@ -0,0 +1,60 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { licensingMock } from '../../../../licensing/server/mocks'; +import { checkLicense } from './check_license'; + +describe('check_license', function() { + describe('returns "valid": false & message when', () => { + it('license information is not available', () => { + const license = licensingMock.createLicenseMock(); + license.isAvailable = false; + + const { valid, message } = checkLicense(license); + + expect(valid).toBe(false); + expect(message).toStrictEqual(expect.any(String)); + }); + + it('license level is not enough', () => { + const license = licensingMock.createLicenseMock(); + license.hasAtLeast.mockReturnValue(false); + + const { valid, message } = checkLicense(license); + + expect(valid).toBe(false); + expect(message).toStrictEqual(expect.any(String)); + }); + + it('license is expired', () => { + const license = licensingMock.createLicenseMock(); + license.isActive = false; + + const { valid, message } = checkLicense(license); + + expect(valid).toBe(false); + expect(message).toStrictEqual(expect.any(String)); + }); + + it('elasticsearch security is disabled', () => { + const license = licensingMock.createLicenseMock(); + license.getFeature.mockReturnValue({ isEnabled: false, isAvailable: false }); + + const { valid, message } = checkLicense(license); + + expect(valid).toBe(false); + expect(message).toStrictEqual(expect.any(String)); + }); + }); + + it('returns "valid": true without message otherwise', () => { + const license = licensingMock.createLicenseMock(); + + const { valid, message } = checkLicense(license); + + expect(valid).toBe(true); + expect(message).toBe(null); + }); +}); diff --git a/x-pack/plugins/logstash/server/lib/check_license/check_license.ts b/x-pack/plugins/logstash/server/lib/check_license/check_license.ts new file mode 100644 index 0000000000000..4eef2eb9b0681 --- /dev/null +++ b/x-pack/plugins/logstash/server/lib/check_license/check_license.ts @@ -0,0 +1,65 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { i18n } from '@kbn/i18n'; + +import { CheckLicense } from '../../../../licensing/server'; + +export const checkLicense: CheckLicense = license => { + if (!license.isAvailable) { + return { + valid: false, + message: i18n.translate( + 'xpack.logstash.managementSection.notPossibleToManagePipelinesMessage', + { + defaultMessage: + 'You cannot manage Logstash pipelines because license information is not available at this time.', + } + ), + }; + } + + if (!license.hasAtLeast('standard')) { + return { + valid: false, + message: i18n.translate('xpack.logstash.managementSection.licenseDoesNotSupportDescription', { + defaultMessage: + 'Your {licenseType} license does not support Logstash pipeline management features. Please upgrade your license.', + values: { licenseType: license.type }, + }), + }; + } + + if (!license.isActive) { + return { + valid: false, + message: i18n.translate( + 'xpack.logstash.managementSection.pipelineCrudOperationsNotAllowedDescription', + { + defaultMessage: + 'You cannot edit, create, or delete your Logstash pipelines because your {licenseType} license has expired.', + values: { licenseType: license.type }, + } + ), + }; + } + + if (!license.getFeature('security').isEnabled) { + return { + valid: false, + message: i18n.translate('xpack.logstash.managementSection.enableSecurityDescription', { + defaultMessage: + 'Security must be enabled in order to use Logstash pipeline management features.' + + ' Please set xpack.security.enabled: true in your elasticsearch.yml.', + }), + }; + } + + return { + valid: true, + message: null, + }; +}; diff --git a/x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/index.js b/x-pack/plugins/logstash/server/lib/check_license/index.ts old mode 100755 new mode 100644 similarity index 77% rename from x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/index.js rename to x-pack/plugins/logstash/server/lib/check_license/index.ts index 787814d87dff9..f2c070fd44b6e --- a/x-pack/legacy/plugins/logstash/server/lib/call_with_request_factory/index.js +++ b/x-pack/plugins/logstash/server/lib/check_license/index.ts @@ -4,4 +4,4 @@ * you may not use this file except in compliance with the Elastic License. */ -export { callWithRequestFactory } from './call_with_request_factory'; +export { checkLicense } from './check_license'; diff --git a/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.test.ts b/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.test.ts new file mode 100755 index 0000000000000..8cd6b70d47570 --- /dev/null +++ b/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.test.ts @@ -0,0 +1,71 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { fetchAllFromScroll } from './fetch_all_from_scroll'; + +describe('fetch_all_from_scroll', () => { + let stubCallWithRequest: jest.Mock; + + beforeEach(() => { + stubCallWithRequest = jest.fn(); + stubCallWithRequest + .mockResolvedValueOnce({ + hits: { + hits: ['newhit'], + }, + _scroll_id: 'newScrollId', + }) + .mockResolvedValueOnce({ + hits: { + hits: [], + }, + }); + }); + + describe('#fetchAllFromScroll', () => { + describe('when the passed-in response has no hits', () => { + const mockResponse = { + hits: { + hits: [], + }, + }; + + it('should return an empty array of hits', async () => { + const hits = await fetchAllFromScroll(mockResponse as any, stubCallWithRequest); + expect(hits).toEqual([]); + }); + + it('should not call callWithRequest', async () => { + await fetchAllFromScroll(mockResponse as any, stubCallWithRequest); + expect(stubCallWithRequest).toHaveBeenCalledTimes(0); + }); + }); + + describe('when the passed-in response has some hits', () => { + const mockResponse = { + hits: { + hits: ['foo', 'bar'], + }, + _scroll_id: 'originalScrollId', + }; + + it('should return the hits from the response', async () => { + const hits = await fetchAllFromScroll(mockResponse as any, stubCallWithRequest); + expect(hits).toEqual(['foo', 'bar', 'newhit']); + }); + + it('should call callWithRequest', async () => { + await fetchAllFromScroll(mockResponse as any, stubCallWithRequest); + expect(stubCallWithRequest).toHaveBeenCalledTimes(2); + + const firstCallWithRequestCallArgs = stubCallWithRequest.mock.calls[0]; + expect(firstCallWithRequestCallArgs[1].body.scroll_id).toBe('originalScrollId'); + + const secondCallWithRequestCallArgs = stubCallWithRequest.mock.calls[1]; + expect(secondCallWithRequestCallArgs[1].body.scroll_id).toBe('newScrollId'); + }); + }); + }); +}); diff --git a/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.ts b/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.ts new file mode 100755 index 0000000000000..060cf188a4c60 --- /dev/null +++ b/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/fetch_all_from_scroll.ts @@ -0,0 +1,34 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { APICaller } from 'src/core/server'; +import { SearchResponse } from 'elasticsearch'; + +import { ES_SCROLL_SETTINGS } from '../../../common/constants'; +import { Hits } from '../../types'; + +export async function fetchAllFromScroll( + response: SearchResponse<any>, + callWithRequest: APICaller, + hits: Hits = [] +): Promise<Hits> { + const newHits = response.hits?.hits || []; + const scrollId = response._scroll_id; + + if (newHits.length > 0) { + hits.push(...newHits); + + const innerResponse = await callWithRequest('scroll', { + body: { + scroll: ES_SCROLL_SETTINGS.KEEPALIVE, + scroll_id: scrollId, + }, + }); + + return await fetchAllFromScroll(innerResponse, callWithRequest, hits); + } + + return hits; +} diff --git a/x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/index.js b/x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/index.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/server/lib/fetch_all_from_scroll/index.js rename to x-pack/plugins/logstash/server/lib/fetch_all_from_scroll/index.ts diff --git a/x-pack/legacy/plugins/logstash/server/models/cluster/__tests__/cluster.js b/x-pack/plugins/logstash/server/models/cluster/cluster.test.ts similarity index 81% rename from x-pack/legacy/plugins/logstash/server/models/cluster/__tests__/cluster.js rename to x-pack/plugins/logstash/server/models/cluster/cluster.test.ts index 08a447a160a1a..63f9f1e58f6ec 100755 --- a/x-pack/legacy/plugins/logstash/server/models/cluster/__tests__/cluster.js +++ b/x-pack/plugins/logstash/server/models/cluster/cluster.test.ts @@ -4,8 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; -import { Cluster } from '../cluster'; +import { Cluster } from './cluster'; describe('cluster', () => { describe('Cluster', () => { @@ -16,7 +15,7 @@ describe('cluster', () => { it('returns correct Cluster instance', () => { const cluster = Cluster.fromUpstreamJSON(upstreamJSON); - expect(cluster.uuid).to.be(upstreamJSON.cluster_uuid); + expect(cluster.uuid).toEqual(upstreamJSON.cluster_uuid); }); }); }); diff --git a/x-pack/legacy/plugins/logstash/server/models/cluster/cluster.js b/x-pack/plugins/logstash/server/models/cluster/cluster.ts similarity index 68% rename from x-pack/legacy/plugins/logstash/server/models/cluster/cluster.js rename to x-pack/plugins/logstash/server/models/cluster/cluster.ts index b114162fb0986..54f03605e14d6 100755 --- a/x-pack/legacy/plugins/logstash/server/models/cluster/cluster.js +++ b/x-pack/plugins/logstash/server/models/cluster/cluster.ts @@ -10,11 +10,12 @@ import { get } from 'lodash'; * This model deals with a cluster object from ES and converts it to Kibana downstream */ export class Cluster { - constructor(props) { - this.uuid = props.uuid; + public readonly uuid: string; + constructor({ uuid }: { uuid: string }) { + this.uuid = uuid; } - get downstreamJSON() { + public get downstreamJSON() { const json = { uuid: this.uuid, }; @@ -23,8 +24,8 @@ export class Cluster { } // generate Pipeline object from elasticsearch response - static fromUpstreamJSON(upstreamCluster) { - const uuid = get(upstreamCluster, 'cluster_uuid'); + static fromUpstreamJSON(upstreamCluster: Record<string, string>) { + const uuid = get<string>(upstreamCluster, 'cluster_uuid'); return new Cluster({ uuid }); } } diff --git a/x-pack/legacy/plugins/logstash/server/models/cluster/index.js b/x-pack/plugins/logstash/server/models/cluster/index.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/server/models/cluster/index.js rename to x-pack/plugins/logstash/server/models/cluster/index.ts diff --git a/x-pack/legacy/plugins/logstash/server/models/pipeline/index.js b/x-pack/plugins/logstash/server/models/pipeline/index.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/server/models/pipeline/index.js rename to x-pack/plugins/logstash/server/models/pipeline/index.ts diff --git a/x-pack/legacy/plugins/logstash/server/models/pipeline/__tests__/pipeline.js b/x-pack/plugins/logstash/server/models/pipeline/pipeline.test.ts similarity index 74% rename from x-pack/legacy/plugins/logstash/server/models/pipeline/__tests__/pipeline.js rename to x-pack/plugins/logstash/server/models/pipeline/pipeline.test.ts index 41869c22271f0..82ce0d72e2052 100755 --- a/x-pack/legacy/plugins/logstash/server/models/pipeline/__tests__/pipeline.js +++ b/x-pack/plugins/logstash/server/models/pipeline/pipeline.test.ts @@ -4,8 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; -import { Pipeline } from '../pipeline'; +import { Pipeline } from './pipeline'; describe('pipeline', () => { describe('Pipeline', () => { @@ -25,10 +24,10 @@ describe('pipeline', () => { it('returns correct Pipeline instance', () => { const pipeline = Pipeline.fromUpstreamJSON(upstreamJSON); - expect(pipeline.id).to.be(upstreamJSON._id); - expect(pipeline.description).to.be(upstreamJSON._source.description); - expect(pipeline.username).to.be(upstreamJSON._source.username); - expect(pipeline.pipeline).to.be(upstreamJSON._source.pipeline); + expect(pipeline.id).toBe(upstreamJSON._id); + expect(pipeline.description).toBe(upstreamJSON._source.description); + expect(pipeline.username).toBe(upstreamJSON._source.username); + expect(pipeline.pipeline).toBe(upstreamJSON._source.pipeline); }); it('throws if pipeline argument does not contain an id property', () => { @@ -39,7 +38,7 @@ describe('pipeline', () => { const testFromUpstreamJsonError = () => { return Pipeline.fromUpstreamJSON(badJSON); }; - expect(testFromUpstreamJsonError).to.throwError( + expect(testFromUpstreamJsonError).toThrowError( /upstreamPipeline argument must contain an id property/i ); }); @@ -64,12 +63,12 @@ describe('pipeline', () => { pipeline: 'input {} filter { grok {} }\n output {}', }; // can't do an object level comparison because modified field is always `now` - expect(pipeline.upstreamJSON.last_modified).to.be.a('string'); - expect(pipeline.upstreamJSON.description).to.be(expectedUpstreamJSON.description); - expect(pipeline.upstreamJSON.pipeline_metadata).to.eql( + expect(pipeline.upstreamJSON.last_modified).toStrictEqual(expect.any(String)); + expect(pipeline.upstreamJSON.description).toBe(expectedUpstreamJSON.description); + expect(pipeline.upstreamJSON.pipeline_metadata).toEqual( expectedUpstreamJSON.pipeline_metadata ); - expect(pipeline.upstreamJSON.pipeline).to.be(expectedUpstreamJSON.pipeline); + expect(pipeline.upstreamJSON.pipeline).toBe(expectedUpstreamJSON.pipeline); }); }); }); diff --git a/x-pack/legacy/plugins/logstash/server/models/pipeline/pipeline.js b/x-pack/plugins/logstash/server/models/pipeline/pipeline.ts similarity index 59% rename from x-pack/legacy/plugins/logstash/server/models/pipeline/pipeline.js rename to x-pack/plugins/logstash/server/models/pipeline/pipeline.ts index f02d303cb0380..3f2debeebeb46 100755 --- a/x-pack/legacy/plugins/logstash/server/models/pipeline/pipeline.js +++ b/x-pack/plugins/logstash/server/models/pipeline/pipeline.ts @@ -9,19 +9,38 @@ import { badRequest } from 'boom'; import { get } from 'lodash'; import { i18n } from '@kbn/i18n'; +interface PipelineOptions { + id: string; + description: string; + pipeline: string; + username?: string; + settings?: Record<string, any>; +} + +interface DownstreamPipeline { + description: string; + pipeline: string; + settings?: Record<string, any>; +} /** * This model deals with a pipeline object from ES and converts it to Kibana downstream */ export class Pipeline { - constructor(props) { - this.id = props.id; - this.description = props.description; - this.username = props.username; - this.pipeline = props.pipeline; - this.settings = props.settings || {}; + public readonly id: string; + public readonly description: string; + public readonly username?: string; + public readonly pipeline: string; + private readonly settings: Record<string, any>; + + constructor(options: PipelineOptions) { + this.id = options.id; + this.description = options.description; + this.username = options.username; + this.pipeline = options.pipeline; + this.settings = options.settings || {}; } - get downstreamJSON() { + public get downstreamJSON() { const json = { id: this.id, description: this.description, @@ -41,7 +60,7 @@ export class Pipeline { * pipeline_metadata.type is the Logstash config type (future: LIR, json, etc) * @return {[JSON]} [Elasticsearch JSON] */ - get upstreamJSON() { + public get upstreamJSON() { return { description: this.description, last_modified: moment().toISOString(), @@ -56,7 +75,11 @@ export class Pipeline { } // generate Pipeline object from kibana response - static fromDownstreamJSON(downstreamPipeline, pipelineId, username) { + static fromDownstreamJSON( + downstreamPipeline: DownstreamPipeline, + pipelineId: string, + username?: string + ) { const opts = { id: pipelineId, description: downstreamPipeline.description, @@ -69,7 +92,7 @@ export class Pipeline { } // generate Pipeline object from elasticsearch response - static fromUpstreamJSON(upstreamPipeline) { + static fromUpstreamJSON(upstreamPipeline: Record<string, any>) { if (!upstreamPipeline._id) { throw badRequest( i18n.translate( @@ -80,13 +103,13 @@ export class Pipeline { ) ); } - const id = get(upstreamPipeline, '_id'); - const description = get(upstreamPipeline, '_source.description'); - const username = get(upstreamPipeline, '_source.username'); - const pipeline = get(upstreamPipeline, '_source.pipeline'); - const settings = get(upstreamPipeline, '_source.pipeline_settings'); + const id = get<string>(upstreamPipeline, '_id'); + const description = get<string>(upstreamPipeline, '_source.description'); + const username = get<string>(upstreamPipeline, '_source.username'); + const pipeline = get<string>(upstreamPipeline, '_source.pipeline'); + const settings = get<Record<string, any>>(upstreamPipeline, '_source.pipeline_settings'); - const opts = { id, description, username, pipeline, settings }; + const opts: PipelineOptions = { id, description, username, pipeline, settings }; return new Pipeline(opts); } diff --git a/x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/index.js b/x-pack/plugins/logstash/server/models/pipeline_list_item/index.ts similarity index 100% rename from x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/index.js rename to x-pack/plugins/logstash/server/models/pipeline_list_item/index.ts diff --git a/x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/__tests__/pipeline_list_item.js b/x-pack/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.test.ts similarity index 72% rename from x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/__tests__/pipeline_list_item.js rename to x-pack/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.test.ts index 4f3a447f030c7..c557e84443b02 100755 --- a/x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/__tests__/pipeline_list_item.js +++ b/x-pack/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.test.ts @@ -4,8 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; -import { PipelineListItem } from '../pipeline_list_item'; +import { PipelineListItem } from './pipeline_list_item'; describe('pipeline_list_item', () => { describe('PipelineListItem', () => { @@ -21,15 +20,18 @@ describe('pipeline_list_item', () => { username: 'elastic', pipeline: 'input {} filter { grok {} }\n output {}', }, + _index: 'index', + _type: 'type', + _score: 100, }; describe('fromUpstreamJSON factory method', () => { it('returns correct PipelineListItem instance', () => { const pipelineListItem = PipelineListItem.fromUpstreamJSON(upstreamJSON); - expect(pipelineListItem.id).to.be(upstreamJSON._id); - expect(pipelineListItem.description).to.be(upstreamJSON._source.description); - expect(pipelineListItem.username).to.be(upstreamJSON._source.username); - expect(pipelineListItem.last_modified).to.be(upstreamJSON._source.last_modified); + expect(pipelineListItem.id).toBe(upstreamJSON._id); + expect(pipelineListItem.description).toBe(upstreamJSON._source.description); + expect(pipelineListItem.username).toBe(upstreamJSON._source.username); + expect(pipelineListItem.last_modified).toBe(upstreamJSON._source.last_modified); }); }); @@ -42,7 +44,7 @@ describe('pipeline_list_item', () => { username: 'elastic', last_modified: '2017-05-14T02:50:51.250Z', }; - expect(pipelineListItem.downstreamJSON).to.eql(expectedDownstreamJSON); + expect(pipelineListItem.downstreamJSON).toEqual(expectedDownstreamJSON); }); }); }); diff --git a/x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.js b/x-pack/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.ts similarity index 50% rename from x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.js rename to x-pack/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.ts index bbb506766897e..98c91fca1fcca 100755 --- a/x-pack/legacy/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.js +++ b/x-pack/plugins/logstash/server/models/pipeline_list_item/pipeline_list_item.ts @@ -5,16 +5,21 @@ */ import { get } from 'lodash'; +import { Hit, PipelineListItemOptions } from '../../types'; export class PipelineListItem { - constructor(props) { - this.id = props.id; - this.description = props.description; - this.last_modified = props.last_modified; - this.username = props.username; + public readonly id: string; + public readonly description: string; + public readonly last_modified: string; + public readonly username: string; + constructor(options: PipelineListItemOptions) { + this.id = options.id; + this.description = options.description; + this.last_modified = options.last_modified; + this.username = options.username; } - get downstreamJSON() { + public get downstreamJSON() { const json = { id: this.id, description: this.description, @@ -29,12 +34,12 @@ export class PipelineListItem { * Takes the json GET response from ES and constructs a pipeline model to be used * in Kibana downstream */ - static fromUpstreamJSON(pipeline) { + static fromUpstreamJSON(pipeline: Hit) { const opts = { id: pipeline._id, - description: get(pipeline, '_source.description'), - last_modified: get(pipeline, '_source.last_modified'), - username: get(pipeline, '_source.username'), + description: get<string>(pipeline, '_source.description'), + last_modified: get<string>(pipeline, '_source.last_modified'), + username: get<string>(pipeline, '_source.username'), }; return new PipelineListItem(opts); diff --git a/x-pack/plugins/logstash/server/plugin.ts b/x-pack/plugins/logstash/server/plugin.ts new file mode 100644 index 0000000000000..c048dd13bfb0c --- /dev/null +++ b/x-pack/plugins/logstash/server/plugin.ts @@ -0,0 +1,51 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { + CoreSetup, + CoreStart, + ICustomClusterClient, + Logger, + Plugin, + PluginInitializerContext, +} from 'src/core/server'; +import { LicensingPluginSetup } from '../../licensing/server'; +import { SecurityPluginSetup } from '../../security/server'; + +import { registerRoutes } from './routes'; + +interface SetupDeps { + licensing: LicensingPluginSetup; + security?: SecurityPluginSetup; +} + +export class LogstashPlugin implements Plugin { + private readonly logger: Logger; + private esClient?: ICustomClusterClient; + private coreSetup?: CoreSetup; + constructor(context: PluginInitializerContext) { + this.logger = context.logger.get(); + } + + setup(core: CoreSetup, deps: SetupDeps) { + this.logger.debug('Setting up Logstash plugin'); + + this.coreSetup = core; + registerRoutes(core.http.createRouter(), deps.security); + } + + start(core: CoreStart) { + const esClient = core.elasticsearch.legacy.createClient('logstash'); + + this.coreSetup!.http.registerRouteHandlerContext('logstash', async (context, request) => { + return { esClient: esClient.asScoped(request) }; + }); + } + stop() { + if (this.esClient) { + this.esClient.close(); + } + } +} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/cluster/index.js b/x-pack/plugins/logstash/server/routes/cluster/index.ts old mode 100755 new mode 100644 similarity index 76% rename from x-pack/legacy/plugins/logstash/server/routes/api/cluster/index.js rename to x-pack/plugins/logstash/server/routes/cluster/index.ts index b129d8524b573..c43c409cf5a17 --- a/x-pack/legacy/plugins/logstash/server/routes/api/cluster/index.js +++ b/x-pack/plugins/logstash/server/routes/cluster/index.ts @@ -3,5 +3,4 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ - -export { registerLogstashClusterRoutes } from './register_cluster_routes'; +export { registerClusterLoadRoute } from './load'; diff --git a/x-pack/plugins/logstash/server/routes/cluster/load.ts b/x-pack/plugins/logstash/server/routes/cluster/load.ts new file mode 100644 index 0000000000000..18fe21f3da675 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/cluster/load.ts @@ -0,0 +1,34 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { IRouter } from 'src/core/server'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; +import { Cluster } from '../../models/cluster'; +import { checkLicense } from '../../lib/check_license'; + +export function registerClusterLoadRoute(router: IRouter) { + router.get( + { + path: '/api/logstash/cluster', + validate: false, + }, + wrapRouteWithLicenseCheck(checkLicense, async (context, request, response) => { + try { + const client = context.logstash!.esClient; + const info = await client.callAsCurrentUser('info'); + return response.ok({ + body: { + cluster: Cluster.fromUpstreamJSON(info).downstreamJSON, + }, + }); + } catch (err) { + if (err.status === 403) { + return response.ok(); + } + return response.internalError(); + } + }) + ); +} diff --git a/x-pack/plugins/logstash/server/routes/index.ts b/x-pack/plugins/logstash/server/routes/index.ts new file mode 100644 index 0000000000000..0c7183b409055 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/index.ts @@ -0,0 +1,28 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { IRouter } from 'src/core/server'; +import { SecurityPluginSetup } from '../../../security/server'; +import { registerClusterLoadRoute } from './cluster'; +import { + registerPipelineDeleteRoute, + registerPipelineLoadRoute, + registerPipelineSaveRoute, +} from './pipeline'; +import { registerPipelinesListRoute, registerPipelinesDeleteRoute } from './pipelines'; +import { registerUpgradeRoute } from './upgrade'; + +export function registerRoutes(router: IRouter, security?: SecurityPluginSetup) { + registerClusterLoadRoute(router); + + registerPipelineDeleteRoute(router); + registerPipelineLoadRoute(router); + registerPipelineSaveRoute(router, security); + + registerPipelinesListRoute(router); + registerPipelinesDeleteRoute(router); + + registerUpgradeRoute(router); +} diff --git a/x-pack/plugins/logstash/server/routes/pipeline/delete.ts b/x-pack/plugins/logstash/server/routes/pipeline/delete.ts new file mode 100644 index 0000000000000..4aeae3e0ae2d5 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/pipeline/delete.ts @@ -0,0 +1,38 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { schema } from '@kbn/config-schema'; +import { IRouter } from 'src/core/server'; +import { INDEX_NAMES } from '../../../common/constants'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; + +import { checkLicense } from '../../lib/check_license'; + +export function registerPipelineDeleteRoute(router: IRouter) { + router.delete( + { + path: '/api/logstash/pipeline/{id}', + validate: { + params: schema.object({ + id: schema.string(), + }), + }, + }, + wrapRouteWithLicenseCheck( + checkLicense, + router.handleLegacyErrors(async (context, request, response) => { + const client = context.logstash!.esClient; + + await client.callAsCurrentUser('delete', { + index: INDEX_NAMES.PIPELINES, + id: request.params.id, + refresh: 'wait_for', + }); + + return response.noContent(); + }) + ) + ); +} diff --git a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/index.js b/x-pack/plugins/logstash/server/routes/pipeline/index.ts old mode 100755 new mode 100644 similarity index 60% rename from x-pack/legacy/plugins/logstash/server/lib/error_wrappers/index.js rename to x-pack/plugins/logstash/server/routes/pipeline/index.ts index f275f15637091..e7db6e18ddaf3 --- a/x-pack/legacy/plugins/logstash/server/lib/error_wrappers/index.js +++ b/x-pack/plugins/logstash/server/routes/pipeline/index.ts @@ -3,7 +3,6 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ - -export { wrapCustomError } from './wrap_custom_error'; -export { wrapEsError } from './wrap_es_error'; -export { wrapUnknownError } from './wrap_unknown_error'; +export { registerPipelineDeleteRoute } from './delete'; +export { registerPipelineLoadRoute } from './load'; +export { registerPipelineSaveRoute } from './save'; diff --git a/x-pack/plugins/logstash/server/routes/pipeline/load.ts b/x-pack/plugins/logstash/server/routes/pipeline/load.ts new file mode 100644 index 0000000000000..fec9097114d26 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/pipeline/load.ts @@ -0,0 +1,46 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { schema } from '@kbn/config-schema'; +import { IRouter } from 'src/core/server'; + +import { INDEX_NAMES } from '../../../common/constants'; +import { Pipeline } from '../../models/pipeline'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; +import { checkLicense } from '../../lib/check_license'; + +export function registerPipelineLoadRoute(router: IRouter) { + router.get( + { + path: '/api/logstash/pipeline/{id}', + validate: { + params: schema.object({ + id: schema.string(), + }), + }, + }, + wrapRouteWithLicenseCheck( + checkLicense, + router.handleLegacyErrors(async (context, request, response) => { + const client = context.logstash!.esClient; + + const result = await client.callAsCurrentUser('get', { + index: INDEX_NAMES.PIPELINES, + id: request.params.id, + _source: ['description', 'username', 'pipeline', 'pipeline_settings'], + ignore: [404], + }); + + if (!result.found) { + return response.notFound(); + } + + return response.ok({ + body: Pipeline.fromUpstreamJSON(result).downstreamJSON, + }); + }) + ) + ); +} diff --git a/x-pack/plugins/logstash/server/routes/pipeline/save.ts b/x-pack/plugins/logstash/server/routes/pipeline/save.ts new file mode 100644 index 0000000000000..556c281944a85 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/pipeline/save.ts @@ -0,0 +1,69 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { schema } from '@kbn/config-schema'; +import { i18n } from '@kbn/i18n'; +import { IRouter } from 'src/core/server'; + +import { INDEX_NAMES } from '../../../common/constants'; +import { Pipeline } from '../../models/pipeline'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; +import { SecurityPluginSetup } from '../../../../security/server'; +import { checkLicense } from '../../lib/check_license'; + +export function registerPipelineSaveRoute(router: IRouter, security?: SecurityPluginSetup) { + router.put( + { + path: '/api/logstash/pipeline/{id}', + validate: { + params: schema.object({ + id: schema.string(), + }), + body: schema.object({ + id: schema.string(), + description: schema.string(), + pipeline: schema.string(), + username: schema.string(), + settings: schema.maybe(schema.object({}, { unknowns: 'allow' })), + }), + }, + }, + wrapRouteWithLicenseCheck( + checkLicense, + router.handleLegacyErrors(async (context, request, response) => { + try { + let username: string | undefined; + if (security) { + const user = await security.authc.getCurrentUser(request); + username = user?.username; + } + + const client = context.logstash!.esClient; + const pipeline = Pipeline.fromDownstreamJSON(request.body, request.params.id, username); + + await client.callAsCurrentUser('index', { + index: INDEX_NAMES.PIPELINES, + id: pipeline.id, + body: pipeline.upstreamJSON, + refresh: 'wait_for', + }); + + return response.noContent(); + } catch (err) { + const statusCode = err.statusCode; + // handles the permissions issue of Elasticsearch + if (statusCode === 403) { + return response.forbidden({ + body: i18n.translate('xpack.logstash.insufficientUserPermissionsDescription', { + defaultMessage: 'Insufficient user permissions for managing Logstash pipelines', + }), + }); + } + throw err; + } + }) + ) + ); +} diff --git a/x-pack/plugins/logstash/server/routes/pipelines/delete.ts b/x-pack/plugins/logstash/server/routes/pipelines/delete.ts new file mode 100644 index 0000000000000..ac3097ac0424b --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/pipelines/delete.ts @@ -0,0 +1,54 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { schema } from '@kbn/config-schema'; +import { APICaller, IRouter } from 'src/core/server'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; + +import { INDEX_NAMES } from '../../../common/constants'; +import { checkLicense } from '../../lib/check_license'; + +async function deletePipelines(callWithRequest: APICaller, pipelineIds: string[]) { + const deletePromises = pipelineIds.map(pipelineId => { + return callWithRequest('delete', { + index: INDEX_NAMES.PIPELINES, + id: pipelineId, + refresh: 'wait_for', + }) + .then(success => ({ success })) + .catch(error => ({ error })); + }); + + const results = await Promise.all(deletePromises); + const successes = results.filter(result => Reflect.has(result, 'success')); + const errors = results.filter(result => Reflect.has(result, 'error')); + + return { + numSuccesses: successes.length, + numErrors: errors.length, + }; +} + +export function registerPipelinesDeleteRoute(router: IRouter) { + router.post( + { + path: '/api/logstash/pipelines/delete', + validate: { + body: schema.object({ + pipelineIds: schema.arrayOf(schema.string()), + }), + }, + }, + wrapRouteWithLicenseCheck( + checkLicense, + router.handleLegacyErrors(async (context, request, response) => { + const client = context.logstash!.esClient; + const results = await deletePipelines(client.callAsCurrentUser, request.body.pipelineIds); + + return response.ok({ body: { results } }); + }) + ) + ); +} diff --git a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/index.js b/x-pack/plugins/logstash/server/routes/pipelines/index.ts old mode 100755 new mode 100644 similarity index 68% rename from x-pack/legacy/plugins/logstash/server/routes/api/pipeline/index.js rename to x-pack/plugins/logstash/server/routes/pipelines/index.ts index 643a405ced919..36681502cfc70 --- a/x-pack/legacy/plugins/logstash/server/routes/api/pipeline/index.js +++ b/x-pack/plugins/logstash/server/routes/pipelines/index.ts @@ -3,5 +3,5 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ - -export { registerLogstashPipelineRoutes } from './register_pipeline_routes'; +export { registerPipelinesListRoute } from './list'; +export { registerPipelinesDeleteRoute } from './delete'; diff --git a/x-pack/plugins/logstash/server/routes/pipelines/list.ts b/x-pack/plugins/logstash/server/routes/pipelines/list.ts new file mode 100644 index 0000000000000..bc477a25a7988 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/pipelines/list.ts @@ -0,0 +1,63 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { i18n } from '@kbn/i18n'; +import { SearchResponse } from 'elasticsearch'; +import { APICaller, IRouter } from 'src/core/server'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; + +import { INDEX_NAMES, ES_SCROLL_SETTINGS } from '../../../common/constants'; +import { PipelineListItem } from '../../models/pipeline_list_item'; +import { fetchAllFromScroll } from '../../lib/fetch_all_from_scroll'; +import { checkLicense } from '../../lib/check_license'; + +async function fetchPipelines(callWithRequest: APICaller) { + const params = { + index: INDEX_NAMES.PIPELINES, + scroll: ES_SCROLL_SETTINGS.KEEPALIVE, + body: { + size: ES_SCROLL_SETTINGS.PAGE_SIZE, + }, + ignore: [404], + }; + + const response = await callWithRequest<SearchResponse<any>>('search', params); + return fetchAllFromScroll(response, callWithRequest); +} + +export function registerPipelinesListRoute(router: IRouter) { + router.get( + { + path: '/api/logstash/pipelines', + validate: false, + }, + wrapRouteWithLicenseCheck( + checkLicense, + router.handleLegacyErrors(async (context, request, response) => { + try { + const client = context.logstash!.esClient; + const pipelinesHits = await fetchPipelines(client.callAsCurrentUser); + + const pipelines = pipelinesHits.map(pipeline => { + return PipelineListItem.fromUpstreamJSON(pipeline).downstreamJSON; + }); + + return response.ok({ body: { pipelines } }); + } catch (err) { + const statusCode = err.statusCode; + // handles the permissions issue of Elasticsearch + if (statusCode === 403) { + return response.forbidden({ + body: i18n.translate('xpack.logstash.insufficientUserPermissionsDescription', { + defaultMessage: 'Insufficient user permissions for managing Logstash pipelines', + }), + }); + } + throw err; + } + }) + ) + ); +} diff --git a/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/index.js b/x-pack/plugins/logstash/server/routes/upgrade/index.ts old mode 100755 new mode 100644 similarity index 76% rename from x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/index.js rename to x-pack/plugins/logstash/server/routes/upgrade/index.ts index 0743e443955f4..3a5b0868b446b --- a/x-pack/legacy/plugins/logstash/server/lib/license_pre_routing_factory/index.js +++ b/x-pack/plugins/logstash/server/routes/upgrade/index.ts @@ -4,4 +4,4 @@ * you may not use this file except in compliance with the Elastic License. */ -export { licensePreRoutingFactory } from './license_pre_routing_factory'; +export { registerUpgradeRoute } from './upgrade'; diff --git a/x-pack/plugins/logstash/server/routes/upgrade/upgrade.ts b/x-pack/plugins/logstash/server/routes/upgrade/upgrade.ts new file mode 100644 index 0000000000000..2bd2c0f89e190 --- /dev/null +++ b/x-pack/plugins/logstash/server/routes/upgrade/upgrade.ts @@ -0,0 +1,46 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { IRouter } from 'src/core/server'; +import { wrapRouteWithLicenseCheck } from '../../../../licensing/server'; + +import { INDEX_NAMES } from '../../../common/constants'; +import { checkLicense } from '../../lib/check_license'; + +export function registerUpgradeRoute(router: IRouter) { + router.post( + { + path: '/api/logstash/upgrade', + validate: false, + }, + wrapRouteWithLicenseCheck( + checkLicense, + router.handleLegacyErrors(async (context, request, response) => { + const client = context.logstash!.esClient; + + const doesIndexExist = await client.callAsCurrentUser('indices.exists', { + index: INDEX_NAMES.PIPELINES, + }); + + // If index doesn't exist yet, there is no mapping to upgrade + if (doesIndexExist) { + await client.callAsCurrentUser('indices.putMapping', { + index: INDEX_NAMES.PIPELINES, + body: { + properties: { + pipeline_settings: { + dynamic: false, + type: 'object', + }, + }, + }, + }); + } + + return response.ok({ body: { is_upgraded: true } }); + }) + ) + ); +} diff --git a/x-pack/plugins/logstash/server/types.ts b/x-pack/plugins/logstash/server/types.ts new file mode 100644 index 0000000000000..2b266b2f27708 --- /dev/null +++ b/x-pack/plugins/logstash/server/types.ts @@ -0,0 +1,27 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { SearchResponse } from 'elasticsearch'; +import { IScopedClusterClient } from 'src/core/server'; + +type UnwrapArray<T> = T extends Array<infer U> ? U : never; + +export type Hits = SearchResponse<any>['hits']['hits']; +export type Hit = UnwrapArray<Hits>; + +export interface PipelineListItemOptions { + id: string; + description: string; + last_modified: string; + username: string; +} + +declare module 'src/core/server' { + interface RequestHandlerContext { + logstash?: { + esClient: IScopedClusterClient; + }; + } +} diff --git a/x-pack/plugins/security/common/licensing/license_service.test.ts b/x-pack/plugins/security/common/licensing/license_service.test.ts index dfc94042ef930..5bdfa7d4886aa 100644 --- a/x-pack/plugins/security/common/licensing/license_service.test.ts +++ b/x-pack/plugins/security/common/licensing/license_service.test.ts @@ -78,14 +78,14 @@ describe('license features', function() { expect(subscriptionHandler.mock.calls[1]).toMatchInlineSnapshot(` Array [ Object { - "allowLogin": false, - "allowRbac": false, - "allowRoleDocumentLevelSecurity": false, - "allowRoleFieldLevelSecurity": false, - "allowSubFeaturePrivileges": false, - "showLinks": false, - "showLogin": false, - "showRoleMappingsManagement": false, + "allowLogin": true, + "allowRbac": true, + "allowRoleDocumentLevelSecurity": true, + "allowRoleFieldLevelSecurity": true, + "allowSubFeaturePrivileges": true, + "showLinks": true, + "showLogin": true, + "showRoleMappingsManagement": true, }, ] `); diff --git a/x-pack/test/api_integration/apis/logstash/cluster/index.js b/x-pack/test/api_integration/apis/logstash/cluster/index.ts similarity index 71% rename from x-pack/test/api_integration/apis/logstash/cluster/index.js rename to x-pack/test/api_integration/apis/logstash/cluster/index.ts index f016fde97ee4b..1d4fbd40b252b 100644 --- a/x-pack/test/api_integration/apis/logstash/cluster/index.js +++ b/x-pack/test/api_integration/apis/logstash/cluster/index.ts @@ -3,8 +3,9 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ loadTestFile }) { +export default function({ loadTestFile }: FtrProviderContext) { describe('cluster', () => { loadTestFile(require.resolve('./load')); }); diff --git a/x-pack/test/api_integration/apis/logstash/cluster/load.js b/x-pack/test/api_integration/apis/logstash/cluster/load.ts similarity index 83% rename from x-pack/test/api_integration/apis/logstash/cluster/load.js rename to x-pack/test/api_integration/apis/logstash/cluster/load.ts index a348c6e4857b1..0678c5faf82dc 100644 --- a/x-pack/test/api_integration/apis/logstash/cluster/load.js +++ b/x-pack/test/api_integration/apis/logstash/cluster/load.ts @@ -5,8 +5,9 @@ */ import expect from '@kbn/expect'; +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ getService }) { +export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const es = getService('legacyEs'); diff --git a/x-pack/test/api_integration/apis/logstash/index.js b/x-pack/test/api_integration/apis/logstash/index.ts similarity index 76% rename from x-pack/test/api_integration/apis/logstash/index.js rename to x-pack/test/api_integration/apis/logstash/index.ts index 53293e5ff9423..582bef5a53bf2 100644 --- a/x-pack/test/api_integration/apis/logstash/index.js +++ b/x-pack/test/api_integration/apis/logstash/index.ts @@ -3,8 +3,9 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ +import { FtrProviderContext } from '../../ftr_provider_context'; -export default function({ loadTestFile }) { +export default function({ loadTestFile }: FtrProviderContext) { describe('logstash', () => { loadTestFile(require.resolve('./pipelines')); loadTestFile(require.resolve('./pipeline')); diff --git a/x-pack/test/api_integration/apis/logstash/pipeline/delete.js b/x-pack/test/api_integration/apis/logstash/pipeline/delete.ts similarity index 90% rename from x-pack/test/api_integration/apis/logstash/pipeline/delete.js rename to x-pack/test/api_integration/apis/logstash/pipeline/delete.ts index 85813f4ed04d1..cdbf5a3e6a1fe 100644 --- a/x-pack/test/api_integration/apis/logstash/pipeline/delete.js +++ b/x-pack/test/api_integration/apis/logstash/pipeline/delete.ts @@ -3,8 +3,9 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ getService }) { +export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); describe('delete', () => { diff --git a/x-pack/test/api_integration/apis/logstash/pipeline/index.js b/x-pack/test/api_integration/apis/logstash/pipeline/index.ts similarity index 76% rename from x-pack/test/api_integration/apis/logstash/pipeline/index.js rename to x-pack/test/api_integration/apis/logstash/pipeline/index.ts index dcc8a01378e37..2697f7f428f5f 100644 --- a/x-pack/test/api_integration/apis/logstash/pipeline/index.js +++ b/x-pack/test/api_integration/apis/logstash/pipeline/index.ts @@ -3,8 +3,8 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ - -export default function({ loadTestFile }) { +import { FtrProviderContext } from '../../../ftr_provider_context'; +export default function({ loadTestFile }: FtrProviderContext) { describe('pipeline', () => { loadTestFile(require.resolve('./load')); loadTestFile(require.resolve('./save')); diff --git a/x-pack/test/api_integration/apis/logstash/pipeline/load.js b/x-pack/test/api_integration/apis/logstash/pipeline/load.ts similarity index 82% rename from x-pack/test/api_integration/apis/logstash/pipeline/load.js rename to x-pack/test/api_integration/apis/logstash/pipeline/load.ts index eb2ab6500a9dc..a892f527a6e61 100644 --- a/x-pack/test/api_integration/apis/logstash/pipeline/load.js +++ b/x-pack/test/api_integration/apis/logstash/pipeline/load.ts @@ -5,9 +5,11 @@ */ import expect from '@kbn/expect'; -import pipeline from './fixtures/load'; +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ getService }) { +import pipeline from './fixtures/load.json'; + +export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); describe('list', () => { diff --git a/x-pack/test/api_integration/apis/logstash/pipeline/save.js b/x-pack/test/api_integration/apis/logstash/pipeline/save.ts similarity index 90% rename from x-pack/test/api_integration/apis/logstash/pipeline/save.js rename to x-pack/test/api_integration/apis/logstash/pipeline/save.ts index ad35ee21f00fc..2ca9fbe7d68e0 100644 --- a/x-pack/test/api_integration/apis/logstash/pipeline/save.js +++ b/x-pack/test/api_integration/apis/logstash/pipeline/save.ts @@ -5,8 +5,9 @@ */ import expect from '@kbn/expect'; +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ getService }) { +export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); describe('save', () => { diff --git a/x-pack/test/api_integration/apis/logstash/pipelines/delete.js b/x-pack/test/api_integration/apis/logstash/pipelines/delete.ts similarity index 90% rename from x-pack/test/api_integration/apis/logstash/pipelines/delete.js rename to x-pack/test/api_integration/apis/logstash/pipelines/delete.ts index 98ff5b99ea744..e71dc7f08ddc9 100644 --- a/x-pack/test/api_integration/apis/logstash/pipelines/delete.js +++ b/x-pack/test/api_integration/apis/logstash/pipelines/delete.ts @@ -3,8 +3,9 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ getService }) { +export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); describe('delete', () => { diff --git a/x-pack/test/api_integration/apis/logstash/pipelines/index.js b/x-pack/test/api_integration/apis/logstash/pipelines/index.ts similarity index 73% rename from x-pack/test/api_integration/apis/logstash/pipelines/index.js rename to x-pack/test/api_integration/apis/logstash/pipelines/index.ts index 3abe2ee5ac43d..510bd625b54a0 100644 --- a/x-pack/test/api_integration/apis/logstash/pipelines/index.js +++ b/x-pack/test/api_integration/apis/logstash/pipelines/index.ts @@ -3,8 +3,9 @@ * or more contributor license agreements. Licensed under the Elastic License; * you may not use this file except in compliance with the Elastic License. */ +import { FtrProviderContext } from '../../../ftr_provider_context'; -export default function({ loadTestFile }) { +export default function({ loadTestFile }: FtrProviderContext) { describe('pipelines', () => { loadTestFile(require.resolve('./list')); loadTestFile(require.resolve('./delete')); diff --git a/x-pack/test/api_integration/apis/logstash/pipelines/list.js b/x-pack/test/api_integration/apis/logstash/pipelines/list.ts similarity index 82% rename from x-pack/test/api_integration/apis/logstash/pipelines/list.js rename to x-pack/test/api_integration/apis/logstash/pipelines/list.ts index fe5c3222a2ab1..a4ef52791ab70 100644 --- a/x-pack/test/api_integration/apis/logstash/pipelines/list.js +++ b/x-pack/test/api_integration/apis/logstash/pipelines/list.ts @@ -5,9 +5,10 @@ */ import expect from '@kbn/expect'; -import pipelineList from './fixtures/list'; +import { FtrProviderContext } from '../../../ftr_provider_context'; +import pipelineList from './fixtures/list.json'; -export default function({ getService }) { +export default function({ getService }: FtrProviderContext) { const supertest = getService('supertest'); const esArchiver = getService('esArchiver'); describe('list', () => { From c2f2a79acb5037078022d939742ed6630b41cca2 Mon Sep 17 00:00:00 2001 From: Chris Cowan <chris@chriscowan.us> Date: Tue, 14 Apr 2020 09:01:41 -0700 Subject: [PATCH 095/102] [Metrics UI] Refactor With* containers to hooks (#59503) * [Metrics UI] Refactor containers to hooks * clean up depends; move useInterval out of useWaffleTime; * converting WithWaffleFilters to useWaffleFilters * Removing WithWaffleOptions * Refactor WithWaffleViewState to useWaffleViewState * Removing obsolete files * Fixing race condition with complext state * Adding undefined to RisonValue; unwinding changes trying to work around bad type * Switching to context * Change assertion to ignore the length of the current URL * Fixing test frameork to accept urls longer then 230 characters * Fixes #59395; Refactor WithMetricsTime to hook; Fixes brushing on metric detail page; fixes refresh button on metric detail page * Fixing tests with adding timeRange Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- test/functional/page_objects/common_page.ts | 24 +- test/typings/rison_node.d.ts | 2 +- typings/rison_node.d.ts | 2 +- .../infra/common/http_api/metadata_api.ts | 4 + .../inventory_models/aws_ec2/layout.tsx | 3 +- .../inventory_models/aws_rds/layout.tsx | 3 +- .../common/inventory_models/aws_s3/layout.tsx | 3 +- .../inventory_models/aws_sqs/layout.tsx | 3 +- .../inventory_models/container/layout.tsx | 3 +- .../common/inventory_models/host/layout.tsx | 8 +- .../common/inventory_models/pod/layout.tsx | 5 +- .../inventory_models/shared/layouts/aws.tsx | 3 +- .../inventory_models/shared/layouts/nginx.tsx | 9 +- .../common/saved_objects/inventory_view.ts | 10 +- .../plugins/infra/public/apps/start_app.tsx | 33 +-- .../public/components/inventory/layout.tsx | 105 ++++--- .../inventory/toolbars/save_views.tsx | 21 ++ .../components/inventory/toolbars/toolbar.tsx | 42 +-- .../inventory/toolbars/toolbar_wrapper.tsx | 74 +++-- .../components/nodes_overview/index.tsx | 6 +- .../infra/public/components/waffle/legend.tsx | 32 ++- .../waffle/lib/create_uptime_link.test.ts | 8 +- .../components/waffle/lib/type_guards.ts | 12 +- .../waffle/waffle_inventory_switcher.tsx | 35 +-- .../waffle/waffle_time_controls.tsx | 128 ++++----- .../containers/metadata/use_metadata.ts | 6 +- .../infra/public/containers/waffle/index.ts | 7 - .../waffle/waffle_nodes.gql_query.ts | 37 --- .../containers/waffle/with_waffle_filters.tsx | 96 ------- .../containers/waffle/with_waffle_options.tsx | 265 ------------------ .../containers/waffle/with_waffle_time.tsx | 96 ------- .../waffle/with_waffle_view_state.tsx | 145 ---------- .../infra/public/containers/with_options.tsx | 4 +- x-pack/plugins/infra/public/lib/lib.ts | 9 +- .../public/pages/infrastructure/index.tsx | 172 ++++++------ .../pages/infrastructure/snapshot/index.tsx | 11 +- .../infrastructure/snapshot/page_content.tsx | 68 ----- .../pages/infrastructure/snapshot/toolbar.tsx | 76 +---- .../inventory_view/compontents/search_bar.tsx | 40 +++ .../hooks/use_waffle_filters.ts | 93 ++++++ .../hooks/use_waffle_options.ts | 147 ++++++++++ .../inventory_view/hooks/use_waffle_time.ts | 76 +++++ .../hooks/use_waffle_view_state.ts | 95 +++++++ .../redirect_to_host_detail_via_ip.tsx | 2 +- .../pages/link_to/redirect_to_node_detail.tsx | 2 +- .../metrics/components/node_details_page.tsx | 4 +- .../pages/metrics/components/page_body.tsx | 8 +- .../pages/metrics/components/section.tsx | 3 + .../metrics/components/time_controls.test.tsx | 2 +- .../metrics/components/time_controls.tsx | 6 +- .../metrics/containers/metrics.gql_query.ts | 38 --- .../metrics/containers/with_metrics_time.tsx | 201 ------------- .../metrics_time.test.tsx | 2 +- .../pages/metrics/hooks/use_metrics_time.ts | 121 ++++++++ .../infra/public/pages/metrics/index.tsx | 101 ++++--- .../public/pages/metrics/page_providers.tsx | 6 +- .../infra/public/pages/metrics/types.ts | 2 +- x-pack/plugins/infra/public/store/actions.ts | 7 - x-pack/plugins/infra/public/store/epics.ts | 11 - x-pack/plugins/infra/public/store/index.ts | 11 - .../infra/public/store/local/actions.ts | 9 - .../plugins/infra/public/store/local/epic.ts | 11 - .../plugins/infra/public/store/local/index.ts | 10 - .../infra/public/store/local/reducer.ts | 33 --- .../infra/public/store/local/selectors.ts | 26 -- .../store/local/waffle_filter/actions.ts | 19 -- .../public/store/local/waffle_filter/index.ts | 11 - .../store/local/waffle_filter/reducer.ts | 43 --- .../store/local/waffle_filter/selectors.ts | 33 --- .../store/local/waffle_options/actions.ts | 29 -- .../store/local/waffle_options/index.ts | 11 - .../store/local/waffle_options/reducer.ts | 113 -------- .../store/local/waffle_options/selector.ts | 18 -- .../public/store/local/waffle_time/actions.ts | 15 - .../public/store/local/waffle_time/epic.ts | 38 --- .../public/store/local/waffle_time/index.ts | 12 - .../public/store/local/waffle_time/reducer.ts | 52 ---- .../store/local/waffle_time/selectors.ts | 23 -- x-pack/plugins/infra/public/store/reducer.ts | 21 -- .../plugins/infra/public/store/selectors.ts | 22 -- x-pack/plugins/infra/public/store/store.ts | 50 ---- .../infra/public/utils/redux_context.tsx | 16 -- .../infra/server/routes/metadata/index.ts | 13 +- .../metadata/lib/get_cloud_metric_metadata.ts | 16 +- .../metadata/lib/get_metric_metadata.ts | 12 +- .../api_integration/apis/infra/metadata.ts | 30 ++ x-pack/typings/rison_node.d.ts | 2 +- 87 files changed, 1087 insertions(+), 2149 deletions(-) create mode 100644 x-pack/plugins/infra/public/components/inventory/toolbars/save_views.tsx delete mode 100644 x-pack/plugins/infra/public/containers/waffle/index.ts delete mode 100644 x-pack/plugins/infra/public/containers/waffle/waffle_nodes.gql_query.ts delete mode 100644 x-pack/plugins/infra/public/containers/waffle/with_waffle_filters.tsx delete mode 100644 x-pack/plugins/infra/public/containers/waffle/with_waffle_options.tsx delete mode 100644 x-pack/plugins/infra/public/containers/waffle/with_waffle_time.tsx delete mode 100644 x-pack/plugins/infra/public/containers/waffle/with_waffle_view_state.tsx delete mode 100644 x-pack/plugins/infra/public/pages/infrastructure/snapshot/page_content.tsx create mode 100644 x-pack/plugins/infra/public/pages/inventory_view/compontents/search_bar.tsx create mode 100644 x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_filters.ts create mode 100644 x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_options.ts create mode 100644 x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_time.ts create mode 100644 x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_view_state.ts delete mode 100644 x-pack/plugins/infra/public/pages/metrics/containers/metrics.gql_query.ts delete mode 100644 x-pack/plugins/infra/public/pages/metrics/containers/with_metrics_time.tsx rename x-pack/plugins/infra/public/pages/metrics/{containers => hooks}/metrics_time.test.tsx (96%) create mode 100644 x-pack/plugins/infra/public/pages/metrics/hooks/use_metrics_time.ts delete mode 100644 x-pack/plugins/infra/public/store/actions.ts delete mode 100644 x-pack/plugins/infra/public/store/epics.ts delete mode 100644 x-pack/plugins/infra/public/store/index.ts delete mode 100644 x-pack/plugins/infra/public/store/local/actions.ts delete mode 100644 x-pack/plugins/infra/public/store/local/epic.ts delete mode 100644 x-pack/plugins/infra/public/store/local/index.ts delete mode 100644 x-pack/plugins/infra/public/store/local/reducer.ts delete mode 100644 x-pack/plugins/infra/public/store/local/selectors.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_filter/actions.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_filter/index.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_filter/reducer.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_filter/selectors.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_options/actions.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_options/index.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_options/reducer.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_options/selector.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_time/actions.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_time/epic.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_time/index.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_time/reducer.ts delete mode 100644 x-pack/plugins/infra/public/store/local/waffle_time/selectors.ts delete mode 100644 x-pack/plugins/infra/public/store/reducer.ts delete mode 100644 x-pack/plugins/infra/public/store/selectors.ts delete mode 100644 x-pack/plugins/infra/public/store/store.ts delete mode 100644 x-pack/plugins/infra/public/utils/redux_context.tsx diff --git a/test/functional/page_objects/common_page.ts b/test/functional/page_objects/common_page.ts index f06baeb7a4167..862e5127bb670 100644 --- a/test/functional/page_objects/common_page.ts +++ b/test/functional/page_objects/common_page.ts @@ -247,25 +247,11 @@ export function CommonPageProvider({ getService, getPageObjects }: FtrProviderCo } currentUrl = (await browser.getCurrentUrl()).replace(/\/\/\w+:\w+@/, '//'); - const maxAdditionalLengthOnNavUrl = 230; - - // On several test failures at the end of the TileMap test we try to navigate back to - // Visualize so we can create the next Vertical Bar Chart, but we can see from the - // logging and the screenshot that it's still on the TileMap page. Why didn't the "get" - // with a new timestamped URL go? I thought that sleep(700) between the get and the - // refresh would solve the problem but didn't seem to always work. - // So this hack fails the navSuccessful check if the currentUrl doesn't match the - // appUrl plus up to 230 other chars. - // Navigating to Settings when there is a default index pattern has a URL length of 196 - // (from debug output). Some other tabs may also be long. But a rather simple configured - // visualization is about 1000 chars long. So at least we catch that case. - - // Browsers don't show the ':port' if it's 80 or 443 so we have to - // remove that part so we can get a match in the tests. - const navSuccessful = new RegExp( - appUrl.replace(':80/', '/').replace(':443/', '/') + - `.{0,${maxAdditionalLengthOnNavUrl}}$` - ).test(currentUrl); + + const navSuccessful = currentUrl + .replace(':80/', '/') + .replace(':443/', '/') + .startsWith(appUrl); if (!navSuccessful) { const msg = `App failed to load: ${appName} in ${defaultFindTimeout}ms appUrl=${appUrl} currentUrl=${currentUrl}`; diff --git a/test/typings/rison_node.d.ts b/test/typings/rison_node.d.ts index 2592c36e8ae9a..a0497f421c3fe 100644 --- a/test/typings/rison_node.d.ts +++ b/test/typings/rison_node.d.ts @@ -18,7 +18,7 @@ */ declare module 'rison-node' { - export type RisonValue = null | boolean | number | string | RisonObject | RisonArray; + export type RisonValue = undefined | null | boolean | number | string | RisonObject | RisonArray; // eslint-disable-next-line @typescript-eslint/no-empty-interface export interface RisonArray extends Array<RisonValue> {} diff --git a/typings/rison_node.d.ts b/typings/rison_node.d.ts index 2592c36e8ae9a..a0497f421c3fe 100644 --- a/typings/rison_node.d.ts +++ b/typings/rison_node.d.ts @@ -18,7 +18,7 @@ */ declare module 'rison-node' { - export type RisonValue = null | boolean | number | string | RisonObject | RisonArray; + export type RisonValue = undefined | null | boolean | number | string | RisonObject | RisonArray; // eslint-disable-next-line @typescript-eslint/no-empty-interface export interface RisonArray extends Array<RisonValue> {} diff --git a/x-pack/plugins/infra/common/http_api/metadata_api.ts b/x-pack/plugins/infra/common/http_api/metadata_api.ts index 7fc3c3e876f08..5ee96b479be8e 100644 --- a/x-pack/plugins/infra/common/http_api/metadata_api.ts +++ b/x-pack/plugins/infra/common/http_api/metadata_api.ts @@ -11,6 +11,10 @@ export const InfraMetadataRequestRT = rt.type({ nodeId: rt.string, nodeType: ItemTypeRT, sourceId: rt.string, + timeRange: rt.type({ + from: rt.number, + to: rt.number, + }), }); export const InfraMetadataFeatureRT = rt.type({ diff --git a/x-pack/plugins/infra/common/inventory_models/aws_ec2/layout.tsx b/x-pack/plugins/infra/common/inventory_models/aws_ec2/layout.tsx index c8e0680287526..68bfe41fd538e 100644 --- a/x-pack/plugins/infra/common/inventory_models/aws_ec2/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/aws_ec2/layout.tsx @@ -20,7 +20,7 @@ import { withTheme } from '../../../../observability/public'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { MetadataDetails } from '../../../public/pages/metrics/components/metadata_details'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, theme, onChangeRangeTime }: LayoutPropsWithTheme) => ( <React.Fragment> <MetadataDetails fields={[ @@ -42,6 +42,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="awsEC2CpuUtilization" diff --git a/x-pack/plugins/infra/common/inventory_models/aws_rds/layout.tsx b/x-pack/plugins/infra/common/inventory_models/aws_rds/layout.tsx index 4bc4562ab2760..220c6c67f4aea 100644 --- a/x-pack/plugins/infra/common/inventory_models/aws_rds/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/aws_rds/layout.tsx @@ -18,7 +18,7 @@ import { withTheme } from '../../../../observability/public'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { LayoutContent } from '../../../public/pages/metrics/components/layout_content'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <LayoutContent> <Section @@ -30,6 +30,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="awsRDSCpuTotal" diff --git a/x-pack/plugins/infra/common/inventory_models/aws_s3/layout.tsx b/x-pack/plugins/infra/common/inventory_models/aws_s3/layout.tsx index c40c8e7b8c6d3..805236cf47082 100644 --- a/x-pack/plugins/infra/common/inventory_models/aws_s3/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/aws_s3/layout.tsx @@ -18,7 +18,7 @@ import { withTheme } from '../../../../observability/public'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { LayoutContent } from '../../../public/pages/metrics/components/layout_content'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <LayoutContent> <Section @@ -30,6 +30,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="awsS3BucketSize" diff --git a/x-pack/plugins/infra/common/inventory_models/aws_sqs/layout.tsx b/x-pack/plugins/infra/common/inventory_models/aws_sqs/layout.tsx index 7f2dc92f42205..d581ac751682d 100644 --- a/x-pack/plugins/infra/common/inventory_models/aws_sqs/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/aws_sqs/layout.tsx @@ -18,7 +18,7 @@ import { withTheme } from '../../../../observability/public'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { LayoutContent } from '../../../public/pages/metrics/components/layout_content'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <LayoutContent> <Section @@ -30,6 +30,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="awsSQSMessagesVisible" diff --git a/x-pack/plugins/infra/common/inventory_models/container/layout.tsx b/x-pack/plugins/infra/common/inventory_models/container/layout.tsx index b61e8eed09cce..9956b2c9a2ce4 100644 --- a/x-pack/plugins/infra/common/inventory_models/container/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/container/layout.tsx @@ -22,7 +22,7 @@ import { LayoutContent } from '../../../public/pages/metrics/components/layout_c // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { MetadataDetails } from '../../../public/pages/metrics/components/metadata_details'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <MetadataDetails /> <LayoutContent> @@ -40,6 +40,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="containerOverview"> <GaugesSectionVis diff --git a/x-pack/plugins/infra/common/inventory_models/host/layout.tsx b/x-pack/plugins/infra/common/inventory_models/host/layout.tsx index 15e5530e8db53..6d7d361254220 100644 --- a/x-pack/plugins/infra/common/inventory_models/host/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/host/layout.tsx @@ -24,7 +24,7 @@ import { MetadataDetails } from '../../../public/pages/metrics/components/metada // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { LayoutContent } from '../../../public/pages/metrics/components/layout_content'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <MetadataDetails fields={[ @@ -52,6 +52,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="hostSystemOverview"> <GaugesSectionVis @@ -242,6 +243,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="hostK8sOverview"> <GaugesSectionVis @@ -371,8 +373,8 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( /> </SubSection> </Section> - <Aws.Layout metrics={metrics} /> - <Ngnix.Layout metrics={metrics} /> + <Aws.Layout metrics={metrics} onChangeRangeTime={onChangeRangeTime} /> + <Ngnix.Layout metrics={metrics} onChangeRangeTime={onChangeRangeTime} /> </LayoutContent> </React.Fragment> )); diff --git a/x-pack/plugins/infra/common/inventory_models/pod/layout.tsx b/x-pack/plugins/infra/common/inventory_models/pod/layout.tsx index 43b95d73f6d95..8bc2f3ee8b4b3 100644 --- a/x-pack/plugins/infra/common/inventory_models/pod/layout.tsx +++ b/x-pack/plugins/infra/common/inventory_models/pod/layout.tsx @@ -23,7 +23,7 @@ import { MetadataDetails } from '../../../public/pages/metrics/components/metada // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { LayoutContent } from '../../../public/pages/metrics/components/layout_content'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <MetadataDetails /> <LayoutContent> @@ -38,6 +38,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="podOverview"> <GaugesSectionVis @@ -161,7 +162,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( /> </SubSection> </Section> - <Nginx.Layout metrics={metrics} /> + <Nginx.Layout metrics={metrics} onChangeRangeTime={onChangeRangeTime} /> </LayoutContent> </React.Fragment> )); diff --git a/x-pack/plugins/infra/common/inventory_models/shared/layouts/aws.tsx b/x-pack/plugins/infra/common/inventory_models/shared/layouts/aws.tsx index fba48c4224e6b..7a0b898d406ce 100644 --- a/x-pack/plugins/infra/common/inventory_models/shared/layouts/aws.tsx +++ b/x-pack/plugins/infra/common/inventory_models/shared/layouts/aws.tsx @@ -18,7 +18,7 @@ import { ChartSectionVis } from '../../../../public/pages/metrics/components/cha // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { withTheme } from '../../../../../observability/public'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> <Section navLabel="AWS" @@ -29,6 +29,7 @@ export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( } )} metrics={metrics} + onChangeRangeTime={onChangeRangeTime} > <SubSection id="awsOverview"> <GaugesSectionVis diff --git a/x-pack/plugins/infra/common/inventory_models/shared/layouts/nginx.tsx b/x-pack/plugins/infra/common/inventory_models/shared/layouts/nginx.tsx index eff0a9bbca85a..79cea5150d498 100644 --- a/x-pack/plugins/infra/common/inventory_models/shared/layouts/nginx.tsx +++ b/x-pack/plugins/infra/common/inventory_models/shared/layouts/nginx.tsx @@ -16,9 +16,14 @@ import { ChartSectionVis } from '../../../../public/pages/metrics/components/cha // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { withTheme } from '../../../../../observability/public'; -export const Layout = withTheme(({ metrics, theme }: LayoutPropsWithTheme) => ( +export const Layout = withTheme(({ metrics, onChangeRangeTime, theme }: LayoutPropsWithTheme) => ( <React.Fragment> - <Section navLabel="Nginx" sectionLabel="Nginx" metrics={metrics}> + <Section + navLabel="Nginx" + sectionLabel="Nginx" + metrics={metrics} + onChangeRangeTime={onChangeRangeTime} + > <SubSection id="nginxHits" label={i18n.translate( diff --git a/x-pack/plugins/infra/common/saved_objects/inventory_view.ts b/x-pack/plugins/infra/common/saved_objects/inventory_view.ts index bccffadc0a1ba..8ae765f379add 100644 --- a/x-pack/plugins/infra/common/saved_objects/inventory_view.ts +++ b/x-pack/plugins/infra/common/saved_objects/inventory_view.ts @@ -7,7 +7,7 @@ // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { ElasticsearchMappingOf } from '../../server/utils/typed_elasticsearch_mappings'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths -import { WaffleViewState } from '../../public/containers/waffle/with_waffle_view_state'; +import { WaffleViewState } from '../../public/pages/inventory_view/hooks/use_waffle_view_state'; export const inventoryViewSavedObjectType = 'inventory-view'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths @@ -102,7 +102,7 @@ export const inventoryViewSavedObjectMappings: { type: 'boolean', }, time: { - type: 'integer', + type: 'long', }, autoReload: { type: 'boolean', @@ -117,6 +117,12 @@ export const inventoryViewSavedObjectMappings: { }, }, }, + accountId: { + type: 'keyword', + }, + region: { + type: 'keyword', + }, }, }, }; diff --git a/x-pack/plugins/infra/public/apps/start_app.tsx b/x-pack/plugins/infra/public/apps/start_app.tsx index a986ee6ece352..ebf9562c38d7a 100644 --- a/x-pack/plugins/infra/public/apps/start_app.tsx +++ b/x-pack/plugins/infra/public/apps/start_app.tsx @@ -8,9 +8,6 @@ import { createBrowserHistory } from 'history'; import React from 'react'; import ReactDOM from 'react-dom'; import { ApolloProvider } from 'react-apollo'; -import { Provider as ReduxStoreProvider } from 'react-redux'; -import { BehaviorSubject } from 'rxjs'; -import { pluck } from 'rxjs/operators'; import { CoreStart, AppMountParameters } from 'kibana/public'; // TODO use theme provided from parentApp when kibana supports it @@ -18,9 +15,7 @@ import { EuiErrorBoundary } from '@elastic/eui'; // eslint-disable-next-line @kbn/eslint/no-restricted-paths import { EuiThemeProvider } from '../../../observability/public/typings/eui_styled_components'; import { InfraFrontendLibs } from '../lib/lib'; -import { createStore } from '../store'; import { ApolloClientContext } from '../utils/apollo_context'; -import { ReduxStateContextProvider } from '../utils/redux_context'; import { HistoryContext } from '../utils/history_context'; import { useUiSetting$, @@ -43,12 +38,6 @@ export async function startApp( ) { const { element, appBasePath } = params; const history = createBrowserHistory({ basename: appBasePath }); - const libs$ = new BehaviorSubject(libs); - const store = createStore({ - apolloClient: libs$.pipe(pluck('apolloClient')), - observableApi: libs$.pipe(pluck('observableApi')), - }); - const InfraPluginRoot: React.FunctionComponent = () => { const [darkMode] = useUiSetting$<boolean>('theme:darkMode'); @@ -56,19 +45,15 @@ export async function startApp( <core.i18n.Context> <EuiErrorBoundary> <TriggersActionsProvider triggersActionsUI={triggersActionsUI}> - <ReduxStoreProvider store={store}> - <ReduxStateContextProvider> - <ApolloProvider client={libs.apolloClient}> - <ApolloClientContext.Provider value={libs.apolloClient}> - <EuiThemeProvider darkMode={darkMode}> - <HistoryContext.Provider value={history}> - <Router history={history} /> - </HistoryContext.Provider> - </EuiThemeProvider> - </ApolloClientContext.Provider> - </ApolloProvider> - </ReduxStateContextProvider> - </ReduxStoreProvider> + <ApolloProvider client={libs.apolloClient}> + <ApolloClientContext.Provider value={libs.apolloClient}> + <EuiThemeProvider darkMode={darkMode}> + <HistoryContext.Provider value={history}> + <Router history={history} /> + </HistoryContext.Provider> + </EuiThemeProvider> + </ApolloClientContext.Provider> + </ApolloProvider> </TriggersActionsProvider> </EuiErrorBoundary> </core.i18n.Context> diff --git a/x-pack/plugins/infra/public/components/inventory/layout.tsx b/x-pack/plugins/infra/public/components/inventory/layout.tsx index 4dd9803c7bfce..3c91f9fa5946f 100644 --- a/x-pack/plugins/infra/public/components/inventory/layout.tsx +++ b/x-pack/plugins/infra/public/components/inventory/layout.tsx @@ -5,64 +5,89 @@ */ import React from 'react'; -import { InfraWaffleMapOptions, InfraWaffleMapBounds } from '../../lib/lib'; -import { KueryFilterQuery } from '../../store/local/waffle_filter'; +import { useInterval } from 'react-use'; +import { euiPaletteColorBlind } from '@elastic/eui'; import { NodesOverview } from '../nodes_overview'; import { Toolbar } from './toolbars/toolbar'; import { PageContent } from '../page'; import { useSnapshot } from '../../containers/waffle/use_snaphot'; import { useInventoryMeta } from '../../containers/inventory_metadata/use_inventory_meta'; -import { SnapshotMetricInput, SnapshotGroupBy } from '../../../common/http_api/snapshot_api'; -import { InventoryItemType } from '../../../common/inventory_models/types'; +import { useWaffleTimeContext } from '../../pages/inventory_view/hooks/use_waffle_time'; +import { useWaffleFiltersContext } from '../../pages/inventory_view/hooks/use_waffle_filters'; +import { useWaffleOptionsContext } from '../../pages/inventory_view/hooks/use_waffle_options'; +import { useSourceContext } from '../../containers/source'; +import { InfraFormatterType, InfraWaffleMapGradientLegend } from '../../lib/lib'; -export interface LayoutProps { - options: InfraWaffleMapOptions; - nodeType: InventoryItemType; - onDrilldown: (filter: KueryFilterQuery) => void; - currentTime: number; - onViewChange: (view: string) => void; - view: string; - boundsOverride: InfraWaffleMapBounds; - autoBounds: boolean; +const euiVisColorPalette = euiPaletteColorBlind(); - filterQuery: string | null | undefined; - metric: SnapshotMetricInput; - groupBy: SnapshotGroupBy; - sourceId: string; - accountId: string; - region: string; -} - -export const Layout = (props: LayoutProps) => { - const { accounts, regions } = useInventoryMeta(props.sourceId, props.nodeType); +export const Layout = () => { + const { sourceId, source } = useSourceContext(); + const { + metric, + groupBy, + nodeType, + accountId, + region, + changeView, + view, + autoBounds, + boundsOverride, + } = useWaffleOptionsContext(); + const { accounts, regions } = useInventoryMeta(sourceId, nodeType); + const { currentTime, jumpToTime, isAutoReloading } = useWaffleTimeContext(); + const { filterQueryAsJson, applyFilterQuery } = useWaffleFiltersContext(); const { loading, nodes, reload, interval } = useSnapshot( - props.filterQuery, - props.metric, - props.groupBy, - props.nodeType, - props.sourceId, - props.currentTime, - props.accountId, - props.region + filterQueryAsJson, + metric, + groupBy, + nodeType, + sourceId, + currentTime, + accountId, + region + ); + + const options = { + formatter: InfraFormatterType.percent, + formatTemplate: '{{value}}', + legend: { + type: 'gradient', + rules: [ + { value: 0, color: '#D3DAE6' }, + { value: 1, color: euiVisColorPalette[1] }, + ], + } as InfraWaffleMapGradientLegend, + metric, + fields: source?.configuration?.fields, + groupBy, + }; + + useInterval( + () => { + if (!loading) { + jumpToTime(Date.now()); + } + }, + isAutoReloading ? 5000 : null ); return ( <> - <Toolbar accounts={accounts} regions={regions} nodeType={props.nodeType} /> + <Toolbar accounts={accounts} regions={regions} nodeType={nodeType} /> <PageContent> <NodesOverview nodes={nodes} - options={props.options} - nodeType={props.nodeType} + options={options} + nodeType={nodeType} loading={loading} reload={reload} - onDrilldown={props.onDrilldown} - currentTime={props.currentTime} - onViewChange={props.onViewChange} - view={props.view} - autoBounds={props.autoBounds} - boundsOverride={props.boundsOverride} + onDrilldown={applyFilterQuery} + currentTime={currentTime} + onViewChange={changeView} + view={view} + autoBounds={autoBounds} + boundsOverride={boundsOverride} interval={interval} /> </PageContent> diff --git a/x-pack/plugins/infra/public/components/inventory/toolbars/save_views.tsx b/x-pack/plugins/infra/public/components/inventory/toolbars/save_views.tsx new file mode 100644 index 0000000000000..cb315d3e17b03 --- /dev/null +++ b/x-pack/plugins/infra/public/components/inventory/toolbars/save_views.tsx @@ -0,0 +1,21 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import React from 'react'; +import { SavedViewsToolbarControls } from '../../saved_views/toolbar_control'; +import { inventoryViewSavedObjectType } from '../../../../common/saved_objects/inventory_view'; +import { useWaffleViewState } from '../../../pages/inventory_view/hooks/use_waffle_view_state'; + +export const SavedViews = () => { + const { viewState, defaultViewState, onViewChange } = useWaffleViewState(); + return ( + <SavedViewsToolbarControls + defaultViewState={defaultViewState} + viewState={viewState} + onViewChange={onViewChange} + viewType={inventoryViewSavedObjectType} + /> + ); +}; diff --git a/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar.tsx b/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar.tsx index c59ab994a018c..63ab6d2f4465a 100644 --- a/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar.tsx +++ b/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar.tsx @@ -5,7 +5,6 @@ */ import React, { FunctionComponent } from 'react'; -import { Action } from 'typescript-fsa'; import { EuiFlexItem } from '@elastic/eui'; import { SnapshotMetricInput, @@ -16,33 +15,23 @@ import { InventoryCloudAccount } from '../../../../common/http_api/inventory_met import { findToolbar } from '../../../../common/inventory_models/toolbars'; import { ToolbarWrapper } from './toolbar_wrapper'; -import { waffleOptionsSelectors } from '../../../store'; import { InfraGroupByOptions } from '../../../lib/lib'; -import { WithWaffleViewState } from '../../../containers/waffle/with_waffle_view_state'; -import { SavedViewsToolbarControls } from '../../saved_views/toolbar_control'; -import { inventoryViewSavedObjectType } from '../../../../common/saved_objects/inventory_view'; import { IIndexPattern } from '../../../../../../../src/plugins/data/public'; import { InventoryItemType } from '../../../../common/inventory_models/types'; +import { WaffleOptionsState } from '../../../pages/inventory_view/hooks/use_waffle_options'; +import { SavedViews } from './save_views'; -export interface ToolbarProps { +export interface ToolbarProps + extends Omit<WaffleOptionsState, 'view' | 'boundsOverride' | 'autoBounds'> { createDerivedIndexPattern: (type: 'logs' | 'metrics' | 'both') => IIndexPattern; - changeMetric: (payload: SnapshotMetricInput) => Action<SnapshotMetricInput>; - changeGroupBy: (payload: SnapshotGroupBy) => Action<SnapshotGroupBy>; - changeCustomOptions: (payload: InfraGroupByOptions[]) => Action<InfraGroupByOptions[]>; - changeAccount: (id: string) => Action<string>; - changeRegion: (name: string) => Action<string>; - customOptions: ReturnType<typeof waffleOptionsSelectors.selectCustomOptions>; - groupBy: ReturnType<typeof waffleOptionsSelectors.selectGroupBy>; - metric: ReturnType<typeof waffleOptionsSelectors.selectMetric>; - nodeType: ReturnType<typeof waffleOptionsSelectors.selectNodeType>; - accountId: ReturnType<typeof waffleOptionsSelectors.selectAccountId>; - region: ReturnType<typeof waffleOptionsSelectors.selectRegion>; + changeMetric: (payload: SnapshotMetricInput) => void; + changeGroupBy: (payload: SnapshotGroupBy) => void; + changeCustomOptions: (payload: InfraGroupByOptions[]) => void; + changeAccount: (id: string) => void; + changeRegion: (name: string) => void; accounts: InventoryCloudAccount[]; regions: string[]; - customMetrics: ReturnType<typeof waffleOptionsSelectors.selectCustomMetrics>; - changeCustomMetrics: ( - payload: SnapshotCustomMetricInput[] - ) => Action<SnapshotCustomMetricInput[]>; + changeCustomMetrics: (payload: SnapshotCustomMetricInput[]) => void; } const wrapToolbarItems = ( @@ -57,16 +46,7 @@ const wrapToolbarItems = ( <ToolbarItems {...props} accounts={accounts} regions={regions} /> <EuiFlexItem grow={true} /> <EuiFlexItem grow={false}> - <WithWaffleViewState indexPattern={props.createDerivedIndexPattern('metrics')}> - {({ defaultViewState, viewState, onViewChange }) => ( - <SavedViewsToolbarControls - defaultViewState={defaultViewState} - viewState={viewState} - onViewChange={onViewChange} - viewType={inventoryViewSavedObjectType} - /> - )} - </WithWaffleViewState> + <SavedViews /> </EuiFlexItem> </> )} diff --git a/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar_wrapper.tsx b/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar_wrapper.tsx index 735539d063b01..fefda94372cfb 100644 --- a/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar_wrapper.tsx +++ b/x-pack/plugins/infra/public/components/inventory/toolbars/toolbar_wrapper.tsx @@ -8,58 +8,52 @@ import React from 'react'; import { EuiFlexGroup } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import { SnapshotMetricType } from '../../../../common/inventory_models/types'; -import { WithSource } from '../../../containers/with_source'; -import { WithWaffleOptions } from '../../../containers/waffle/with_waffle_options'; import { Toolbar } from '../../eui/toolbar'; import { ToolbarProps } from './toolbar'; import { fieldToName } from '../../waffle/lib/field_to_display_name'; +import { useSourceContext } from '../../../containers/source'; +import { useWaffleOptionsContext } from '../../../pages/inventory_view/hooks/use_waffle_options'; interface Props { children: (props: Omit<ToolbarProps, 'accounts' | 'regions'>) => React.ReactElement; } export const ToolbarWrapper = (props: Props) => { + const { + changeMetric, + changeGroupBy, + changeCustomOptions, + changeAccount, + changeRegion, + customOptions, + groupBy, + metric, + nodeType, + accountId, + region, + customMetrics, + changeCustomMetrics, + } = useWaffleOptionsContext(); + const { createDerivedIndexPattern } = useSourceContext(); return ( <Toolbar> <EuiFlexGroup alignItems="center" gutterSize="m"> - <WithSource> - {({ createDerivedIndexPattern }) => ( - <WithWaffleOptions> - {({ - changeMetric, - changeGroupBy, - changeCustomOptions, - changeAccount, - changeRegion, - customOptions, - groupBy, - metric, - nodeType, - accountId, - region, - customMetrics, - changeCustomMetrics, - }) => - props.children({ - createDerivedIndexPattern, - changeMetric, - changeGroupBy, - changeAccount, - changeRegion, - changeCustomOptions, - customOptions, - groupBy, - metric, - nodeType, - region, - accountId, - customMetrics, - changeCustomMetrics, - }) - } - </WithWaffleOptions> - )} - </WithSource> + {props.children({ + createDerivedIndexPattern, + changeMetric, + changeGroupBy, + changeAccount, + changeRegion, + changeCustomOptions, + customOptions, + groupBy, + metric, + nodeType, + region, + accountId, + customMetrics, + changeCustomMetrics, + })} </EuiFlexGroup> </Toolbar> ); diff --git a/x-pack/plugins/infra/public/components/nodes_overview/index.tsx b/x-pack/plugins/infra/public/components/nodes_overview/index.tsx index 4d61568a63b9f..ef22e0486f892 100644 --- a/x-pack/plugins/infra/public/components/nodes_overview/index.tsx +++ b/x-pack/plugins/infra/public/components/nodes_overview/index.tsx @@ -12,7 +12,6 @@ import React from 'react'; import { euiStyled } from '../../../../observability/public'; import { InfraFormatterType, InfraWaffleMapBounds, InfraWaffleMapOptions } from '../../lib/lib'; -import { KueryFilterQuery } from '../../store/local/waffle_filter'; import { createFormatter } from '../../utils/formatters'; import { NoData } from '../empty_states'; import { InfraLoadingPanel } from '../loading'; @@ -24,6 +23,11 @@ import { convertIntervalToString } from '../../utils/convert_interval_to_string' import { InventoryItemType } from '../../../common/inventory_models/types'; import { createFormatterForMetric } from '../metrics_explorer/helpers/create_formatter_for_metric'; +export interface KueryFilterQuery { + kind: 'kuery'; + expression: string; +} + interface Props { options: InfraWaffleMapOptions; nodeType: InventoryItemType; diff --git a/x-pack/plugins/infra/public/components/waffle/legend.tsx b/x-pack/plugins/infra/public/components/waffle/legend.tsx index de070efb35a1f..13e533b225d4d 100644 --- a/x-pack/plugins/infra/public/components/waffle/legend.tsx +++ b/x-pack/plugins/infra/public/components/waffle/legend.tsx @@ -6,12 +6,12 @@ import React from 'react'; import { euiStyled } from '../../../../observability/public'; -import { WithWaffleOptions } from '../../containers/waffle/with_waffle_options'; import { InfraFormatter, InfraWaffleMapBounds, InfraWaffleMapLegend } from '../../lib/lib'; import { GradientLegend } from './gradient_legend'; import { LegendControls } from './legend_controls'; import { isInfraWaffleMapGradientLegend, isInfraWaffleMapStepLegend } from './lib/type_guards'; import { StepLegend } from './steps_legend'; +import { useWaffleOptionsContext } from '../../pages/inventory_view/hooks/use_waffle_options'; interface Props { legend: InfraWaffleMapLegend; bounds: InfraWaffleMapBounds; @@ -25,22 +25,24 @@ interface LegendControlOptions { } export const Legend: React.FC<Props> = ({ dataBounds, legend, bounds, formatter }) => { + const { + changeBoundsOverride, + changeAutoBounds, + autoBounds, + boundsOverride, + } = useWaffleOptionsContext(); return ( <LegendContainer> - <WithWaffleOptions> - {({ changeBoundsOverride, changeAutoBounds, autoBounds, boundsOverride }) => ( - <LegendControls - dataBounds={dataBounds} - bounds={bounds} - autoBounds={autoBounds} - boundsOverride={boundsOverride} - onChange={(options: LegendControlOptions) => { - changeBoundsOverride(options.bounds); - changeAutoBounds(options.auto); - }} - /> - )} - </WithWaffleOptions> + <LegendControls + dataBounds={dataBounds} + bounds={bounds} + autoBounds={autoBounds} + boundsOverride={boundsOverride} + onChange={(options: LegendControlOptions) => { + changeBoundsOverride(options.bounds); + changeAutoBounds(options.auto); + }} + /> {isInfraWaffleMapGradientLegend(legend) && ( <GradientLegend formatter={formatter} legend={legend} bounds={bounds} /> )} diff --git a/x-pack/plugins/infra/public/components/waffle/lib/create_uptime_link.test.ts b/x-pack/plugins/infra/public/components/waffle/lib/create_uptime_link.test.ts index 18e5838a15b56..902969c83ba39 100644 --- a/x-pack/plugins/infra/public/components/waffle/lib/create_uptime_link.test.ts +++ b/x-pack/plugins/infra/public/components/waffle/lib/create_uptime_link.test.ts @@ -5,11 +5,7 @@ */ import { createUptimeLink } from './create_uptime_link'; -import { - InfraWaffleMapOptions, - InfraWaffleMapLegendMode, - InfraFormatterType, -} from '../../../lib/lib'; +import { InfraWaffleMapOptions, InfraFormatterType } from '../../../lib/lib'; import { SnapshotMetricType } from '../../../../common/inventory_models/types'; const options: InfraWaffleMapOptions = { @@ -26,7 +22,7 @@ const options: InfraWaffleMapOptions = { metric: { type: 'cpu' }, groupBy: [], legend: { - type: InfraWaffleMapLegendMode.gradient, + type: 'gradient', rules: [], }, }; diff --git a/x-pack/plugins/infra/public/components/waffle/lib/type_guards.ts b/x-pack/plugins/infra/public/components/waffle/lib/type_guards.ts index aff16374ae262..f793afee1b948 100644 --- a/x-pack/plugins/infra/public/components/waffle/lib/type_guards.ts +++ b/x-pack/plugins/infra/public/components/waffle/lib/type_guards.ts @@ -4,16 +4,14 @@ * you may not use this file except in compliance with the Elastic License. */ -import { - InfraWaffleMapGradientLegend, - InfraWaffleMapLegendMode, - InfraWaffleMapStepLegend, -} from '../../../lib/lib'; +import { InfraWaffleMapGradientLegend, InfraWaffleMapStepLegend } from '../../../lib/lib'; + export function isInfraWaffleMapStepLegend(subject: any): subject is InfraWaffleMapStepLegend { - return subject.type && subject.type === InfraWaffleMapLegendMode.step; + return subject.type && subject.type === 'step'; } + export function isInfraWaffleMapGradientLegend( subject: any ): subject is InfraWaffleMapGradientLegend { - return subject.type && subject.type === InfraWaffleMapLegendMode.gradient; + return subject.type && subject.type === 'gradient'; } diff --git a/x-pack/plugins/infra/public/components/waffle/waffle_inventory_switcher.tsx b/x-pack/plugins/infra/public/components/waffle/waffle_inventory_switcher.tsx index d265b418f010d..21da10a0a7650 100644 --- a/x-pack/plugins/infra/public/components/waffle/waffle_inventory_switcher.tsx +++ b/x-pack/plugins/infra/public/components/waffle/waffle_inventory_switcher.tsx @@ -16,36 +16,23 @@ import React, { useCallback, useState, useMemo } from 'react'; import { FormattedMessage } from '@kbn/i18n/react'; import { findInventoryModel } from '../../../common/inventory_models'; import { InventoryItemType } from '../../../common/inventory_models/types'; -import { - SnapshotMetricInput, - SnapshotGroupBy, - SnapshotCustomMetricInput, -} from '../../../common/http_api/snapshot_api'; - -interface WaffleInventorySwitcherProps { - nodeType: InventoryItemType; - changeNodeType: (nodeType: InventoryItemType) => void; - changeGroupBy: (groupBy: SnapshotGroupBy) => void; - changeMetric: (metric: SnapshotMetricInput) => void; - changeCustomMetrics: (metrics: SnapshotCustomMetricInput[]) => void; - changeAccount: (id: string) => void; - changeRegion: (name: string) => void; -} +import { useWaffleOptionsContext } from '../../pages/inventory_view/hooks/use_waffle_options'; const getDisplayNameForType = (type: InventoryItemType) => { const inventoryModel = findInventoryModel(type); return inventoryModel.displayName; }; -export const WaffleInventorySwitcher: React.FC<WaffleInventorySwitcherProps> = ({ - changeNodeType, - changeGroupBy, - changeMetric, - changeAccount, - changeRegion, - changeCustomMetrics, - nodeType, -}) => { +export const WaffleInventorySwitcher: React.FC = () => { + const { + changeNodeType, + changeGroupBy, + changeMetric, + changeAccount, + changeRegion, + changeCustomMetrics, + nodeType, + } = useWaffleOptionsContext(); const [isOpen, setIsOpen] = useState(false); const closePopover = useCallback(() => setIsOpen(false), []); const openPopover = useCallback(() => setIsOpen(true), []); diff --git a/x-pack/plugins/infra/public/components/waffle/waffle_time_controls.tsx b/x-pack/plugins/infra/public/components/waffle/waffle_time_controls.tsx index 4f840336de8c3..458bb674afade 100644 --- a/x-pack/plugins/infra/public/components/waffle/waffle_time_controls.tsx +++ b/x-pack/plugins/infra/public/components/waffle/waffle_time_controls.tsx @@ -7,84 +7,60 @@ import { EuiButtonEmpty, EuiDatePicker, EuiFormControlLayout } from '@elastic/eui'; import { FormattedMessage } from '@kbn/i18n/react'; import moment, { Moment } from 'moment'; -import React from 'react'; -import { Action } from 'typescript-fsa'; +import React, { useCallback } from 'react'; +import { useWaffleTimeContext } from '../../pages/inventory_view/hooks/use_waffle_time'; -interface WaffleTimeControlsProps { - currentTime: number; - isLiveStreaming?: boolean; - onChangeTime?: (time: number) => void; - startLiveStreaming?: (payload: void) => Action<void>; - stopLiveStreaming?: (payload: void) => Action<void>; -} +export const WaffleTimeControls = () => { + const { + currentTime, + isAutoReloading, + startAutoReload, + stopAutoReload, + jumpToTime, + } = useWaffleTimeContext(); -export class WaffleTimeControls extends React.Component<WaffleTimeControlsProps> { - public render() { - const { currentTime, isLiveStreaming } = this.props; + const currentMoment = moment(currentTime); - const currentMoment = moment(currentTime); + const liveStreamingButton = isAutoReloading ? ( + <EuiButtonEmpty color="primary" iconSide="left" iconType="pause" onClick={stopAutoReload}> + <FormattedMessage + id="xpack.infra.waffleTime.stopRefreshingButtonLabel" + defaultMessage="Stop refreshing" + /> + </EuiButtonEmpty> + ) : ( + <EuiButtonEmpty iconSide="left" iconType="play" onClick={startAutoReload}> + <FormattedMessage + id="xpack.infra.waffleTime.autoRefreshButtonLabel" + defaultMessage="Auto-refresh" + /> + </EuiButtonEmpty> + ); - const liveStreamingButton = isLiveStreaming ? ( - <EuiButtonEmpty - color="primary" - iconSide="left" - iconType="pause" - onClick={this.stopLiveStreaming} - > - <FormattedMessage - id="xpack.infra.waffleTime.stopRefreshingButtonLabel" - defaultMessage="Stop refreshing" - /> - </EuiButtonEmpty> - ) : ( - <EuiButtonEmpty iconSide="left" iconType="play" onClick={this.startLiveStreaming}> - <FormattedMessage - id="xpack.infra.waffleTime.autoRefreshButtonLabel" - defaultMessage="Auto-refresh" - /> - </EuiButtonEmpty> - ); + const handleChangeDate = useCallback( + (time: Moment | null) => { + if (time) { + jumpToTime(time.valueOf()); + } + }, + [jumpToTime] + ); - return ( - <EuiFormControlLayout append={liveStreamingButton} data-test-subj="waffleDatePicker"> - <EuiDatePicker - className="euiFieldText--inGroup" - dateFormat="L LTS" - disabled={isLiveStreaming} - injectTimes={currentMoment ? [currentMoment] : []} - isLoading={isLiveStreaming} - onChange={this.handleChangeDate} - popperPlacement="top-end" - selected={currentMoment} - shouldCloseOnSelect - showTimeSelect - timeFormat="LT" - /> - </EuiFormControlLayout> - ); - } - - private handleChangeDate = (time: Moment | null) => { - const { onChangeTime } = this.props; - - if (onChangeTime && time) { - onChangeTime(time.valueOf()); - } - }; - - private startLiveStreaming = () => { - const { startLiveStreaming } = this.props; - - if (startLiveStreaming) { - startLiveStreaming(); - } - }; - - private stopLiveStreaming = () => { - const { stopLiveStreaming } = this.props; - - if (stopLiveStreaming) { - stopLiveStreaming(); - } - }; -} + return ( + <EuiFormControlLayout append={liveStreamingButton} data-test-subj="waffleDatePicker"> + <EuiDatePicker + className="euiFieldText--inGroup" + dateFormat="L LTS" + disabled={isAutoReloading} + injectTimes={currentMoment ? [currentMoment] : []} + isLoading={isAutoReloading} + onChange={handleChangeDate} + popperPlacement="top-end" + selected={currentMoment} + shouldCloseOnSelect + showTimeSelect + timeFormat="LT" + /> + </EuiFormControlLayout> + ); +}; diff --git a/x-pack/plugins/infra/public/containers/metadata/use_metadata.ts b/x-pack/plugins/infra/public/containers/metadata/use_metadata.ts index 52c522ce8efd4..1ba016195bef4 100644 --- a/x-pack/plugins/infra/public/containers/metadata/use_metadata.ts +++ b/x-pack/plugins/infra/public/containers/metadata/use_metadata.ts @@ -13,17 +13,18 @@ import { useHTTPRequest } from '../../hooks/use_http_request'; import { throwErrors, createPlainError } from '../../../common/runtime_types'; import { InventoryMetric, InventoryItemType } from '../../../common/inventory_models/types'; import { getFilteredMetrics } from './lib/get_filtered_metrics'; +import { MetricsTimeInput } from '../../pages/metrics/hooks/use_metrics_time'; export function useMetadata( nodeId: string, nodeType: InventoryItemType, requiredMetrics: InventoryMetric[], - sourceId: string + sourceId: string, + timeRange: MetricsTimeInput ) { const decodeResponse = (response: any) => { return pipe(InfraMetadataRT.decode(response), fold(throwErrors(createPlainError), identity)); }; - const { error, loading, response, makeRequest } = useHTTPRequest<InfraMetadata>( '/api/infra/metadata', 'POST', @@ -31,6 +32,7 @@ export function useMetadata( nodeId, nodeType, sourceId, + timeRange: { from: timeRange.from, to: timeRange.to }, }), decodeResponse ); diff --git a/x-pack/plugins/infra/public/containers/waffle/index.ts b/x-pack/plugins/infra/public/containers/waffle/index.ts deleted file mode 100644 index 40c4bfc8cf678..0000000000000 --- a/x-pack/plugins/infra/public/containers/waffle/index.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export * from './with_waffle_filters'; diff --git a/x-pack/plugins/infra/public/containers/waffle/waffle_nodes.gql_query.ts b/x-pack/plugins/infra/public/containers/waffle/waffle_nodes.gql_query.ts deleted file mode 100644 index 1ca6bc8c397e5..0000000000000 --- a/x-pack/plugins/infra/public/containers/waffle/waffle_nodes.gql_query.ts +++ /dev/null @@ -1,37 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import gql from 'graphql-tag'; - -export const waffleNodesQuery = gql` - query WaffleNodesQuery( - $sourceId: ID! - $timerange: InfraTimerangeInput! - $filterQuery: String - $metric: InfraSnapshotMetricInput! - $groupBy: [InfraSnapshotGroupbyInput!]! - $type: InfraNodeType! - ) { - source(id: $sourceId) { - id - snapshot(timerange: $timerange, filterQuery: $filterQuery) { - nodes(groupBy: $groupBy, metric: $metric, type: $type) { - path { - value - label - ip - } - metric { - name - value - avg - max - } - } - } - } - } -`; diff --git a/x-pack/plugins/infra/public/containers/waffle/with_waffle_filters.tsx b/x-pack/plugins/infra/public/containers/waffle/with_waffle_filters.tsx deleted file mode 100644 index 0214237ef52d8..0000000000000 --- a/x-pack/plugins/infra/public/containers/waffle/with_waffle_filters.tsx +++ /dev/null @@ -1,96 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React from 'react'; -import { connect } from 'react-redux'; - -import { IIndexPattern } from 'src/plugins/data/public'; -import { State, waffleFilterActions, waffleFilterSelectors } from '../../store'; -import { FilterQuery } from '../../store/local/waffle_filter'; -import { convertKueryToElasticSearchQuery } from '../../utils/kuery'; -import { asChildFunctionRenderer } from '../../utils/typed_react'; -import { bindPlainActionCreators } from '../../utils/typed_redux'; -import { UrlStateContainer } from '../../utils/url_state'; - -interface WithWaffleFilterProps { - indexPattern: IIndexPattern; -} - -export const withWaffleFilter = connect( - (state: State) => ({ - filterQuery: waffleFilterSelectors.selectWaffleFilterQuery(state), - filterQueryDraft: waffleFilterSelectors.selectWaffleFilterQueryDraft(state), - filterQueryAsJson: waffleFilterSelectors.selectWaffleFilterQueryAsJson(state), - isFilterQueryDraftValid: waffleFilterSelectors.selectIsWaffleFilterQueryDraftValid(state), - }), - (dispatch, ownProps: WithWaffleFilterProps) => - bindPlainActionCreators({ - applyFilterQuery: (query: FilterQuery) => - waffleFilterActions.applyWaffleFilterQuery({ - query, - serializedQuery: convertKueryToElasticSearchQuery( - query.expression, - ownProps.indexPattern - ), - }), - applyFilterQueryFromKueryExpression: (expression: string) => - waffleFilterActions.applyWaffleFilterQuery({ - query: { - kind: 'kuery', - expression, - }, - serializedQuery: convertKueryToElasticSearchQuery(expression, ownProps.indexPattern), - }), - setFilterQueryDraft: waffleFilterActions.setWaffleFilterQueryDraft, - setFilterQueryDraftFromKueryExpression: (expression: string) => - waffleFilterActions.setWaffleFilterQueryDraft({ - kind: 'kuery', - expression, - }), - }) -); - -export const WithWaffleFilter = asChildFunctionRenderer(withWaffleFilter); - -/** - * Url State - */ - -type WaffleFilterUrlState = ReturnType<typeof waffleFilterSelectors.selectWaffleFilterQuery>; - -type WithWaffleFilterUrlStateProps = WithWaffleFilterProps; - -export const WithWaffleFilterUrlState: React.FC<WithWaffleFilterUrlStateProps> = ({ - indexPattern, -}) => ( - <WithWaffleFilter indexPattern={indexPattern}> - {({ applyFilterQuery, filterQuery }) => ( - <UrlStateContainer - urlState={filterQuery} - urlStateKey="waffleFilter" - mapToUrlState={mapToUrlState} - onChange={urlState => { - if (urlState) { - applyFilterQuery(urlState); - } - }} - onInitialize={urlState => { - if (urlState) { - applyFilterQuery(urlState); - } - }} - /> - )} - </WithWaffleFilter> -); - -const mapToUrlState = (value: any): WaffleFilterUrlState | undefined => - value && value.kind === 'kuery' && typeof value.expression === 'string' - ? { - kind: value.kind, - expression: value.expression, - } - : undefined; diff --git a/x-pack/plugins/infra/public/containers/waffle/with_waffle_options.tsx b/x-pack/plugins/infra/public/containers/waffle/with_waffle_options.tsx deleted file mode 100644 index 47dd6a5a73a73..0000000000000 --- a/x-pack/plugins/infra/public/containers/waffle/with_waffle_options.tsx +++ /dev/null @@ -1,265 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React from 'react'; -import { connect } from 'react-redux'; -import { createSelector } from 'reselect'; - -import { isBoolean, isNumber } from 'lodash'; -import { InfraGroupByOptions } from '../../lib/lib'; -import { State, waffleOptionsActions, waffleOptionsSelectors } from '../../store'; -import { asChildFunctionRenderer } from '../../utils/typed_react'; -import { bindPlainActionCreators } from '../../utils/typed_redux'; -import { UrlStateContainer } from '../../utils/url_state'; -import { - SnapshotMetricInput, - SnapshotGroupBy, - SnapshotCustomMetricInputRT, -} from '../../../common/http_api/snapshot_api'; -import { - SnapshotMetricTypeRT, - InventoryItemType, - ItemTypeRT, -} from '../../../common/inventory_models/types'; - -const selectOptionsUrlState = createSelector( - waffleOptionsSelectors.selectMetric, - waffleOptionsSelectors.selectView, - waffleOptionsSelectors.selectGroupBy, - waffleOptionsSelectors.selectNodeType, - waffleOptionsSelectors.selectCustomOptions, - waffleOptionsSelectors.selectBoundsOverride, - waffleOptionsSelectors.selectAutoBounds, - waffleOptionsSelectors.selectAccountId, - waffleOptionsSelectors.selectRegion, - waffleOptionsSelectors.selectCustomMetrics, - ( - metric, - view, - groupBy, - nodeType, - customOptions, - boundsOverride, - autoBounds, - accountId, - region, - customMetrics - ) => ({ - metric, - groupBy, - nodeType, - view, - customOptions, - boundsOverride, - autoBounds, - accountId, - region, - customMetrics, - }) -); - -export const withWaffleOptions = connect( - (state: State) => ({ - metric: waffleOptionsSelectors.selectMetric(state), - groupBy: waffleOptionsSelectors.selectGroupBy(state), - nodeType: waffleOptionsSelectors.selectNodeType(state), - view: waffleOptionsSelectors.selectView(state), - customOptions: waffleOptionsSelectors.selectCustomOptions(state), - boundsOverride: waffleOptionsSelectors.selectBoundsOverride(state), - autoBounds: waffleOptionsSelectors.selectAutoBounds(state), - accountId: waffleOptionsSelectors.selectAccountId(state), - region: waffleOptionsSelectors.selectRegion(state), - urlState: selectOptionsUrlState(state), - customMetrics: waffleOptionsSelectors.selectCustomMetrics(state), - }), - bindPlainActionCreators({ - changeMetric: waffleOptionsActions.changeMetric, - changeGroupBy: waffleOptionsActions.changeGroupBy, - changeNodeType: waffleOptionsActions.changeNodeType, - changeView: waffleOptionsActions.changeView, - changeCustomOptions: waffleOptionsActions.changeCustomOptions, - changeBoundsOverride: waffleOptionsActions.changeBoundsOverride, - changeAutoBounds: waffleOptionsActions.changeAutoBounds, - changeAccount: waffleOptionsActions.changeAccount, - changeRegion: waffleOptionsActions.changeRegion, - changeCustomMetrics: waffleOptionsActions.changeCustomMetrics, - }) -); - -export const WithWaffleOptions = asChildFunctionRenderer(withWaffleOptions); - -/** - * Url State - */ - -interface WaffleOptionsUrlState { - metric?: ReturnType<typeof waffleOptionsSelectors.selectMetric>; - groupBy?: ReturnType<typeof waffleOptionsSelectors.selectGroupBy>; - nodeType?: ReturnType<typeof waffleOptionsSelectors.selectNodeType>; - view?: ReturnType<typeof waffleOptionsSelectors.selectView>; - customOptions?: ReturnType<typeof waffleOptionsSelectors.selectCustomOptions>; - bounds?: ReturnType<typeof waffleOptionsSelectors.selectBoundsOverride>; - auto?: ReturnType<typeof waffleOptionsSelectors.selectAutoBounds>; - accountId?: ReturnType<typeof waffleOptionsSelectors.selectAccountId>; - region?: ReturnType<typeof waffleOptionsSelectors.selectRegion>; - customMetrics?: ReturnType<typeof waffleOptionsSelectors.selectCustomMetrics>; -} - -export const WithWaffleOptionsUrlState = () => ( - <WithWaffleOptions> - {({ - changeMetric, - urlState, - changeGroupBy, - changeNodeType, - changeView, - changeCustomOptions, - changeAutoBounds, - changeBoundsOverride, - changeAccount, - changeRegion, - changeCustomMetrics, - }) => ( - <UrlStateContainer<WaffleOptionsUrlState> - urlState={urlState} - urlStateKey="waffleOptions" - mapToUrlState={mapToUrlState} - onChange={newUrlState => { - if (newUrlState && newUrlState.metric) { - changeMetric(newUrlState.metric); - } - if (newUrlState && newUrlState.groupBy) { - changeGroupBy(newUrlState.groupBy); - } - if (newUrlState && newUrlState.nodeType) { - changeNodeType(newUrlState.nodeType); - } - if (newUrlState && newUrlState.view) { - changeView(newUrlState.view); - } - if (newUrlState && newUrlState.customOptions) { - changeCustomOptions(newUrlState.customOptions); - } - if (newUrlState && newUrlState.bounds) { - changeBoundsOverride(newUrlState.bounds); - } - if (newUrlState && newUrlState.auto) { - changeAutoBounds(newUrlState.auto); - } - if (newUrlState && newUrlState.accountId) { - changeAccount(newUrlState.accountId); - } - if (newUrlState && newUrlState.region) { - changeRegion(newUrlState.region); - } - if (newUrlState && newUrlState.customMetrics) { - changeCustomMetrics(newUrlState.customMetrics); - } - }} - onInitialize={initialUrlState => { - if (initialUrlState && initialUrlState.metric) { - changeMetric(initialUrlState.metric); - } - if (initialUrlState && initialUrlState.groupBy) { - changeGroupBy(initialUrlState.groupBy); - } - if (initialUrlState && initialUrlState.nodeType) { - changeNodeType(initialUrlState.nodeType); - } - if (initialUrlState && initialUrlState.view) { - changeView(initialUrlState.view); - } - if (initialUrlState && initialUrlState.customOptions) { - changeCustomOptions(initialUrlState.customOptions); - } - if (initialUrlState && initialUrlState.bounds) { - changeBoundsOverride(initialUrlState.bounds); - } - if (initialUrlState && initialUrlState.auto) { - changeAutoBounds(initialUrlState.auto); - } - if (initialUrlState && initialUrlState.accountId) { - changeAccount(initialUrlState.accountId); - } - if (initialUrlState && initialUrlState.region) { - changeRegion(initialUrlState.region); - } - if (initialUrlState && initialUrlState.customMetrics) { - changeCustomMetrics(initialUrlState.customMetrics); - } - }} - /> - )} - </WithWaffleOptions> -); - -const mapToUrlState = (value: any): WaffleOptionsUrlState | undefined => - value - ? { - metric: mapToMetricUrlState(value.metric), - groupBy: mapToGroupByUrlState(value.groupBy), - nodeType: mapToNodeTypeUrlState(value.nodeType), - view: mapToViewUrlState(value.view), - customOptions: mapToCustomOptionsUrlState(value.customOptions), - bounds: mapToBoundsOverideUrlState(value.boundsOverride), - auto: mapToAutoBoundsUrlState(value.autoBounds), - accountId: value.accountId, - region: value.region, - customMetrics: mapToCustomMetricsUrlState(value.customMetrics), - } - : undefined; - -const isInfraNodeType = (value: any): value is InventoryItemType => value in ItemTypeRT; - -const isInfraSnapshotMetricInput = (subject: any): subject is SnapshotMetricInput => { - return subject != null && subject.type in SnapshotMetricTypeRT; -}; - -const isInfraSnapshotGroupbyInput = (subject: any): subject is SnapshotGroupBy => { - return subject != null && subject.type != null; -}; - -const isInfraGroupByOption = (subject: any): subject is InfraGroupByOptions => { - return subject != null && subject.text != null && subject.field != null; -}; - -const mapToMetricUrlState = (subject: any) => { - return subject && isInfraSnapshotMetricInput(subject) ? subject : undefined; -}; - -const mapToGroupByUrlState = (subject: any) => { - return subject && Array.isArray(subject) && subject.every(isInfraSnapshotGroupbyInput) - ? subject - : undefined; -}; - -const mapToNodeTypeUrlState = (subject: any) => { - return isInfraNodeType(subject) ? subject : undefined; -}; - -const mapToViewUrlState = (subject: any) => { - return subject && ['map', 'table'].includes(subject) ? subject : undefined; -}; - -const mapToCustomOptionsUrlState = (subject: any) => { - return subject && Array.isArray(subject) && subject.every(isInfraGroupByOption) - ? subject - : undefined; -}; - -const mapToCustomMetricsUrlState = (subject: any) => { - return subject && Array.isArray(subject) && subject.every(s => SnapshotCustomMetricInputRT.is(s)) - ? subject - : []; -}; - -const mapToBoundsOverideUrlState = (subject: any) => { - return subject != null && isNumber(subject.max) && isNumber(subject.min) ? subject : undefined; -}; - -const mapToAutoBoundsUrlState = (subject: any) => { - return subject != null && isBoolean(subject) ? subject : undefined; -}; diff --git a/x-pack/plugins/infra/public/containers/waffle/with_waffle_time.tsx b/x-pack/plugins/infra/public/containers/waffle/with_waffle_time.tsx deleted file mode 100644 index 293f6184af21b..0000000000000 --- a/x-pack/plugins/infra/public/containers/waffle/with_waffle_time.tsx +++ /dev/null @@ -1,96 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React from 'react'; -import { connect } from 'react-redux'; -import { createSelector } from 'reselect'; - -import { State, waffleTimeActions, waffleTimeSelectors } from '../../store'; -import { asChildFunctionRenderer } from '../../utils/typed_react'; -import { bindPlainActionCreators } from '../../utils/typed_redux'; -import { UrlStateContainer } from '../../utils/url_state'; - -export const withWaffleTime = connect( - (state: State) => ({ - currentTime: waffleTimeSelectors.selectCurrentTime(state), - currentTimeRange: waffleTimeSelectors.selectCurrentTimeRange(state), - isAutoReloading: waffleTimeSelectors.selectIsAutoReloading(state), - urlState: selectTimeUrlState(state), - }), - bindPlainActionCreators({ - jumpToTime: waffleTimeActions.jumpToTime, - startAutoReload: waffleTimeActions.startAutoReload, - stopAutoReload: waffleTimeActions.stopAutoReload, - }) -); - -export const WithWaffleTime = asChildFunctionRenderer(withWaffleTime, { - onCleanup: ({ stopAutoReload }) => stopAutoReload(), -}); - -/** - * Url State - */ - -interface WaffleTimeUrlState { - time?: ReturnType<typeof waffleTimeSelectors.selectCurrentTime>; - autoReload?: ReturnType<typeof waffleTimeSelectors.selectIsAutoReloading>; -} - -export const WithWaffleTimeUrlState = () => ( - <WithWaffleTime> - {({ jumpToTime, startAutoReload, stopAutoReload, urlState }) => ( - <UrlStateContainer - urlState={urlState} - urlStateKey="waffleTime" - mapToUrlState={mapToUrlState} - onChange={newUrlState => { - if (newUrlState && newUrlState.time) { - jumpToTime(newUrlState.time); - } - if (newUrlState && newUrlState.autoReload) { - startAutoReload(); - } else if ( - newUrlState && - typeof newUrlState.autoReload !== 'undefined' && - !newUrlState.autoReload - ) { - stopAutoReload(); - } - }} - onInitialize={initialUrlState => { - if (initialUrlState) { - jumpToTime(initialUrlState.time ? initialUrlState.time : Date.now()); - } - if (initialUrlState && initialUrlState.autoReload) { - startAutoReload(); - } - }} - /> - )} - </WithWaffleTime> -); - -const selectTimeUrlState = createSelector( - waffleTimeSelectors.selectCurrentTime, - waffleTimeSelectors.selectIsAutoReloading, - (time, autoReload) => ({ - time, - autoReload, - }) -); - -const mapToUrlState = (value: any): WaffleTimeUrlState | undefined => - value - ? { - time: mapToTimeUrlState(value.time), - autoReload: mapToAutoReloadUrlState(value.autoReload), - } - : undefined; - -const mapToTimeUrlState = (value: any) => (value && typeof value === 'number' ? value : undefined); - -const mapToAutoReloadUrlState = (value: any) => (typeof value === 'boolean' ? value : undefined); diff --git a/x-pack/plugins/infra/public/containers/waffle/with_waffle_view_state.tsx b/x-pack/plugins/infra/public/containers/waffle/with_waffle_view_state.tsx deleted file mode 100644 index 421c506166d04..0000000000000 --- a/x-pack/plugins/infra/public/containers/waffle/with_waffle_view_state.tsx +++ /dev/null @@ -1,145 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ -import { connect } from 'react-redux'; -import { createSelector } from 'reselect'; -import { IIndexPattern } from 'src/plugins/data/public'; -import { - State, - waffleOptionsActions, - waffleOptionsSelectors, - waffleTimeSelectors, - waffleTimeActions, - waffleFilterActions, - waffleFilterSelectors, - initialState, -} from '../../store'; -import { asChildFunctionRenderer } from '../../utils/typed_react'; -import { convertKueryToElasticSearchQuery } from '../../utils/kuery'; - -const selectViewState = createSelector( - waffleOptionsSelectors.selectMetric, - waffleOptionsSelectors.selectView, - waffleOptionsSelectors.selectGroupBy, - waffleOptionsSelectors.selectNodeType, - waffleOptionsSelectors.selectCustomOptions, - waffleOptionsSelectors.selectBoundsOverride, - waffleOptionsSelectors.selectAutoBounds, - waffleTimeSelectors.selectCurrentTime, - waffleTimeSelectors.selectIsAutoReloading, - waffleFilterSelectors.selectWaffleFilterQuery, - waffleOptionsSelectors.selectCustomMetrics, - ( - metric, - view, - groupBy, - nodeType, - customOptions, - boundsOverride, - autoBounds, - time, - autoReload, - filterQuery, - customMetrics - ) => ({ - time, - autoReload, - metric, - groupBy, - nodeType, - view, - customOptions, - boundsOverride, - autoBounds, - filterQuery, - customMetrics, - }) -); - -interface Props { - indexPattern: IIndexPattern; -} - -export const withWaffleViewState = connect( - (state: State) => ({ - viewState: selectViewState(state), - defaultViewState: selectViewState(initialState), - }), - (dispatch, ownProps: Props) => { - return { - onViewChange: (viewState: WaffleViewState) => { - if (viewState.time) { - dispatch(waffleTimeActions.jumpToTime(viewState.time)); - } - if (viewState.autoReload) { - dispatch(waffleTimeActions.startAutoReload()); - } else if (typeof viewState.autoReload !== 'undefined' && !viewState.autoReload) { - dispatch(waffleTimeActions.stopAutoReload()); - } - if (viewState.metric) { - dispatch(waffleOptionsActions.changeMetric(viewState.metric)); - } - if (viewState.groupBy) { - dispatch(waffleOptionsActions.changeGroupBy(viewState.groupBy)); - } - if (viewState.nodeType) { - dispatch(waffleOptionsActions.changeNodeType(viewState.nodeType)); - } - if (viewState.view) { - dispatch(waffleOptionsActions.changeView(viewState.view)); - } - if (viewState.customOptions) { - dispatch(waffleOptionsActions.changeCustomOptions(viewState.customOptions)); - } - if (viewState.customMetrics) { - dispatch(waffleOptionsActions.changeCustomMetrics(viewState.customMetrics)); - } - if (viewState.boundsOverride) { - dispatch(waffleOptionsActions.changeBoundsOverride(viewState.boundsOverride)); - } - if (viewState.autoBounds) { - dispatch(waffleOptionsActions.changeAutoBounds(viewState.autoBounds)); - } - if (viewState.filterQuery) { - dispatch( - waffleFilterActions.applyWaffleFilterQuery({ - query: viewState.filterQuery, - serializedQuery: convertKueryToElasticSearchQuery( - viewState.filterQuery.expression, - ownProps.indexPattern - ), - }) - ); - } else { - dispatch( - waffleFilterActions.applyWaffleFilterQuery({ - query: null, - serializedQuery: null, - }) - ); - } - }, - }; - } -); - -export const WithWaffleViewState = asChildFunctionRenderer(withWaffleViewState); - -/** - * View State - */ -export interface WaffleViewState { - metric?: ReturnType<typeof waffleOptionsSelectors.selectMetric>; - groupBy?: ReturnType<typeof waffleOptionsSelectors.selectGroupBy>; - nodeType?: ReturnType<typeof waffleOptionsSelectors.selectNodeType>; - view?: ReturnType<typeof waffleOptionsSelectors.selectView>; - customOptions?: ReturnType<typeof waffleOptionsSelectors.selectCustomOptions>; - customMetrics?: ReturnType<typeof waffleOptionsSelectors.selectCustomMetrics>; - boundsOverride?: ReturnType<typeof waffleOptionsSelectors.selectBoundsOverride>; - autoBounds?: ReturnType<typeof waffleOptionsSelectors.selectAutoBounds>; - time?: ReturnType<typeof waffleTimeSelectors.selectCurrentTime>; - autoReload?: ReturnType<typeof waffleTimeSelectors.selectIsAutoReloading>; - filterQuery?: ReturnType<typeof waffleFilterSelectors.selectWaffleFilterQuery>; -} diff --git a/x-pack/plugins/infra/public/containers/with_options.tsx b/x-pack/plugins/infra/public/containers/with_options.tsx index 972722890ffef..e18fc85a68d60 100644 --- a/x-pack/plugins/infra/public/containers/with_options.tsx +++ b/x-pack/plugins/infra/public/containers/with_options.tsx @@ -8,7 +8,7 @@ import moment from 'moment'; import React from 'react'; import { euiPaletteColorBlind } from '@elastic/eui'; -import { InfraFormatterType, InfraOptions, InfraWaffleMapLegendMode } from '../lib/lib'; +import { InfraFormatterType, InfraOptions } from '../lib/lib'; import { RendererFunction } from '../utils/typed_react'; const euiVisColorPalette = euiPaletteColorBlind(); @@ -29,7 +29,7 @@ const initialState = { metric: { type: 'cpu' }, groupBy: [], legend: { - type: InfraWaffleMapLegendMode.gradient, + type: 'gradient', rules: [ { value: 0, diff --git a/x-pack/plugins/infra/public/lib/lib.ts b/x-pack/plugins/infra/public/lib/lib.ts index 9f851e185018b..e4de0caf9bb8b 100644 --- a/x-pack/plugins/infra/public/lib/lib.ts +++ b/x-pack/plugins/infra/public/lib/lib.ts @@ -136,18 +136,13 @@ export interface InfraWaffleMapGradientRule { color: string; } -export enum InfraWaffleMapLegendMode { - step = 'step', - gradient = 'gradient', -} - export interface InfraWaffleMapStepLegend { - type: InfraWaffleMapLegendMode.step; + type: 'step'; rules: InfraWaffleMapStepRule[]; } export interface InfraWaffleMapGradientLegend { - type: InfraWaffleMapLegendMode.gradient; + type: 'gradient'; rules: InfraWaffleMapGradientRule[]; } diff --git a/x-pack/plugins/infra/public/pages/infrastructure/index.tsx b/x-pack/plugins/infra/public/pages/infrastructure/index.tsx index 422eb53148fe6..d592ae3480fc9 100644 --- a/x-pack/plugins/infra/public/pages/infrastructure/index.tsx +++ b/x-pack/plugins/infra/public/pages/infrastructure/index.tsx @@ -25,6 +25,9 @@ import { MetricsSettingsPage } from './settings'; import { AppNavigation } from '../../components/navigation/app_navigation'; import { SourceLoadingPage } from '../../components/source_loading_page'; import { useKibana } from '../../../../../../src/plugins/kibana_react/public'; +import { WaffleOptionsProvider } from '../inventory_view/hooks/use_waffle_options'; +import { WaffleTimeProvider } from '../inventory_view/hooks/use_waffle_time'; +import { WaffleFiltersProvider } from '../inventory_view/hooks/use_waffle_filters'; import { AlertDropdown } from '../../components/alerting/metrics/alert_dropdown'; export const InfrastructurePage = ({ match }: RouteComponentProps) => { @@ -32,96 +35,101 @@ export const InfrastructurePage = ({ match }: RouteComponentProps) => { return ( <Source.Provider sourceId="default"> - <ColumnarPage> - <DocumentTitle - title={i18n.translate('xpack.infra.homePage.documentTitle', { - defaultMessage: 'Metrics', - })} - /> - - <HelpCenterContent - feedbackLink="https://discuss.elastic.co/c/metrics" - appName={i18n.translate('xpack.infra.header.infrastructureHelpAppName', { - defaultMessage: 'Metrics', - })} - /> + <WaffleOptionsProvider> + <WaffleTimeProvider> + <WaffleFiltersProvider> + <ColumnarPage> + <DocumentTitle + title={i18n.translate('xpack.infra.homePage.documentTitle', { + defaultMessage: 'Metrics', + })} + /> - <Header - breadcrumbs={[ - { - text: i18n.translate('xpack.infra.header.infrastructureTitle', { - defaultMessage: 'Metrics', - }), - }, - ]} - readOnlyBadge={!uiCapabilities?.infrastructure?.save} - /> + <HelpCenterContent + feedbackLink="https://discuss.elastic.co/c/metrics" + appName={i18n.translate('xpack.infra.header.infrastructureHelpAppName', { + defaultMessage: 'Metrics', + })} + /> - <AppNavigation - aria-label={i18n.translate('xpack.infra.header.infrastructureNavigationTitle', { - defaultMessage: 'Metrics', - })} - > - <EuiFlexGroup gutterSize={'none'} alignItems={'center'}> - <EuiFlexItem> - <RoutedTabs - tabs={[ - { - app: 'metrics', - title: i18n.translate('xpack.infra.homePage.inventoryTabTitle', { - defaultMessage: 'Inventory', - }), - pathname: '/inventory', - }, - { - app: 'metrics', - title: i18n.translate('xpack.infra.homePage.metricsExplorerTabTitle', { - defaultMessage: 'Metrics Explorer', - }), - pathname: '/explorer', - }, + <Header + breadcrumbs={[ { - app: 'metrics', - title: i18n.translate('xpack.infra.homePage.settingsTabTitle', { - defaultMessage: 'Settings', + text: i18n.translate('xpack.infra.header.infrastructureTitle', { + defaultMessage: 'Metrics', }), - pathname: '/settings', }, ]} + readOnlyBadge={!uiCapabilities?.infrastructure?.save} /> - </EuiFlexItem> - <EuiFlexItem grow={false}> - <Route path={'/explorer'} component={AlertDropdown} /> - </EuiFlexItem> - </EuiFlexGroup> - </AppNavigation> + <AppNavigation + aria-label={i18n.translate('xpack.infra.header.infrastructureNavigationTitle', { + defaultMessage: 'Metrics', + })} + > + <EuiFlexGroup gutterSize={'none'} alignItems={'center'}> + <EuiFlexItem> + <RoutedTabs + tabs={[ + { + app: 'metrics', + title: i18n.translate('xpack.infra.homePage.inventoryTabTitle', { + defaultMessage: 'Inventory', + }), + pathname: '/inventory', + }, + { + app: 'metrics', + title: i18n.translate('xpack.infra.homePage.metricsExplorerTabTitle', { + defaultMessage: 'Metrics Explorer', + }), + pathname: '/explorer', + }, + { + app: 'metrics', + title: i18n.translate('xpack.infra.homePage.settingsTabTitle', { + defaultMessage: 'Settings', + }), + pathname: '/settings', + }, + ]} + /> + </EuiFlexItem> + <EuiFlexItem grow={false}> + <Route path={'/explorer'} component={AlertDropdown} /> + </EuiFlexItem> + </EuiFlexGroup> + </AppNavigation> - <Switch> - <Route path={'/inventory'} component={SnapshotPage} /> - <Route - path={'/explorer'} - render={props => ( - <WithSource> - {({ configuration, createDerivedIndexPattern }) => ( - <MetricsExplorerOptionsContainer.Provider> - <WithMetricsExplorerOptionsUrlState /> - {configuration ? ( - <MetricsExplorerPage - derivedIndexPattern={createDerivedIndexPattern('metrics')} - source={configuration} - {...props} - /> - ) : ( - <SourceLoadingPage /> - )} - </MetricsExplorerOptionsContainer.Provider> - )} - </WithSource> - )} - /> - <Route path={'/settings'} component={MetricsSettingsPage} /> - </Switch> - </ColumnarPage> + <Switch> + <Route path={'/inventory'} component={SnapshotPage} /> + <Route + path={'/explorer'} + render={props => ( + <WithSource> + {({ configuration, createDerivedIndexPattern }) => ( + <MetricsExplorerOptionsContainer.Provider> + <WithMetricsExplorerOptionsUrlState /> + {configuration ? ( + <MetricsExplorerPage + derivedIndexPattern={createDerivedIndexPattern('metrics')} + source={configuration} + {...props} + /> + ) : ( + <SourceLoadingPage /> + )} + </MetricsExplorerOptionsContainer.Provider> + )} + </WithSource> + )} + /> + <Route path={'/settings'} component={MetricsSettingsPage} /> + </Switch> + </ColumnarPage> + </WaffleFiltersProvider> + </WaffleTimeProvider> + </WaffleOptionsProvider> </Source.Provider> ); }; diff --git a/x-pack/plugins/infra/public/pages/infrastructure/snapshot/index.tsx b/x-pack/plugins/infra/public/pages/infrastructure/snapshot/index.tsx index dbb8b2d8e2952..48cc56388c0f2 100644 --- a/x-pack/plugins/infra/public/pages/infrastructure/snapshot/index.tsx +++ b/x-pack/plugins/infra/public/pages/infrastructure/snapshot/index.tsx @@ -8,7 +8,6 @@ import { EuiButton, EuiFlexGroup, EuiFlexItem } from '@elastic/eui'; import { i18n } from '@kbn/i18n'; import React, { useContext } from 'react'; -import { SnapshotPageContent } from './page_content'; import { SnapshotToolbar } from './toolbar'; import { DocumentTitle } from '../../../components/document_title'; @@ -19,17 +18,14 @@ import { SourceErrorPage } from '../../../components/source_error_page'; import { SourceLoadingPage } from '../../../components/source_loading_page'; import { ViewSourceConfigurationButton } from '../../../components/source_configuration'; import { Source } from '../../../containers/source'; -import { WithWaffleFilterUrlState } from '../../../containers/waffle/with_waffle_filters'; -import { WithWaffleOptionsUrlState } from '../../../containers/waffle/with_waffle_options'; -import { WithWaffleTimeUrlState } from '../../../containers/waffle/with_waffle_time'; import { useTrackPageview } from '../../../../../observability/public'; import { useKibana } from '../../../../../../../src/plugins/kibana_react/public'; +import { Layout } from '../../../components/inventory/layout'; import { useLinkProps } from '../../../hooks/use_link_props'; export const SnapshotPage = () => { const uiCapabilities = useKibana().services.application?.capabilities; const { - createDerivedIndexPattern, hasFailedLoadingSource, isLoading, loadSourceFailureMessage, @@ -60,11 +56,8 @@ export const SnapshotPage = () => { <SourceLoadingPage /> ) : metricIndicesExist ? ( <> - <WithWaffleTimeUrlState /> - <WithWaffleFilterUrlState indexPattern={createDerivedIndexPattern('metrics')} /> - <WithWaffleOptionsUrlState /> <SnapshotToolbar /> - <SnapshotPageContent /> + <Layout /> </> ) : hasFailedLoadingSource ? ( <SourceErrorPage errorMessage={loadSourceFailureMessage || ''} retry={loadSource} /> diff --git a/x-pack/plugins/infra/public/pages/infrastructure/snapshot/page_content.tsx b/x-pack/plugins/infra/public/pages/infrastructure/snapshot/page_content.tsx deleted file mode 100644 index 83a4c8d3a497f..0000000000000 --- a/x-pack/plugins/infra/public/pages/infrastructure/snapshot/page_content.tsx +++ /dev/null @@ -1,68 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import React from 'react'; - -import { WithWaffleFilter } from '../../../containers/waffle/with_waffle_filters'; -import { WithWaffleOptions } from '../../../containers/waffle/with_waffle_options'; -import { WithWaffleTime } from '../../../containers/waffle/with_waffle_time'; -import { WithOptions } from '../../../containers/with_options'; -import { WithSource } from '../../../containers/with_source'; -import { Layout } from '../../../components/inventory/layout'; - -export const SnapshotPageContent: React.FC = () => ( - <WithSource> - {({ configuration, createDerivedIndexPattern, sourceId }) => ( - <WithOptions> - {({ wafflemap }) => ( - <WithWaffleFilter indexPattern={createDerivedIndexPattern('metrics')}> - {({ filterQueryAsJson, applyFilterQuery }) => ( - <WithWaffleTime> - {({ currentTime }) => ( - <WithWaffleOptions> - {({ - metric, - groupBy, - nodeType, - view, - changeView, - autoBounds, - boundsOverride, - accountId, - region, - }) => ( - <Layout - currentTime={currentTime} - filterQuery={filterQueryAsJson} - metric={metric} - groupBy={groupBy} - nodeType={nodeType} - sourceId={sourceId} - options={{ - ...wafflemap, - metric, - fields: configuration && configuration.fields, - groupBy, - }} - onDrilldown={applyFilterQuery} - view={view} - onViewChange={changeView} - autoBounds={autoBounds} - boundsOverride={boundsOverride} - accountId={accountId} - region={region} - /> - )} - </WithWaffleOptions> - )} - </WithWaffleTime> - )} - </WithWaffleFilter> - )} - </WithOptions> - )} - </WithSource> -); diff --git a/x-pack/plugins/infra/public/pages/infrastructure/snapshot/toolbar.tsx b/x-pack/plugins/infra/public/pages/infrastructure/snapshot/toolbar.tsx index 3606580e86504..ccdaa5e8dc785 100644 --- a/x-pack/plugins/infra/public/pages/infrastructure/snapshot/toolbar.tsx +++ b/x-pack/plugins/infra/public/pages/infrastructure/snapshot/toolbar.tsx @@ -5,92 +5,24 @@ */ import { EuiFlexGroup, EuiFlexItem } from '@elastic/eui'; -import { i18n } from '@kbn/i18n'; import React from 'react'; -import { AutocompleteField } from '../../../components/autocomplete_field'; import { Toolbar } from '../../../components/eui/toolbar'; import { WaffleTimeControls } from '../../../components/waffle/waffle_time_controls'; -import { WithWaffleFilter } from '../../../containers/waffle/with_waffle_filters'; -import { WithWaffleTime } from '../../../containers/waffle/with_waffle_time'; -import { WithKueryAutocompletion } from '../../../containers/with_kuery_autocompletion'; -import { WithSource } from '../../../containers/with_source'; -import { WithWaffleOptions } from '../../../containers/waffle/with_waffle_options'; import { WaffleInventorySwitcher } from '../../../components/waffle/waffle_inventory_switcher'; +import { SearchBar } from '../../inventory_view/compontents/search_bar'; export const SnapshotToolbar = () => ( <Toolbar> <EuiFlexGroup alignItems="center" justifyContent="spaceBetween" gutterSize="m"> <EuiFlexItem grow={false}> - <WithWaffleOptions> - {({ - changeMetric, - changeNodeType, - changeGroupBy, - changeAccount, - changeRegion, - changeCustomMetrics, - nodeType, - }) => ( - <WaffleInventorySwitcher - nodeType={nodeType} - changeNodeType={changeNodeType} - changeMetric={changeMetric} - changeGroupBy={changeGroupBy} - changeAccount={changeAccount} - changeRegion={changeRegion} - changeCustomMetrics={changeCustomMetrics} - /> - )} - </WithWaffleOptions> + <WaffleInventorySwitcher /> </EuiFlexItem> <EuiFlexItem> - <WithSource> - {({ createDerivedIndexPattern }) => ( - <WithKueryAutocompletion indexPattern={createDerivedIndexPattern('metrics')}> - {({ isLoadingSuggestions, loadSuggestions, suggestions }) => ( - <WithWaffleFilter indexPattern={createDerivedIndexPattern('metrics')}> - {({ - applyFilterQueryFromKueryExpression, - filterQueryDraft, - isFilterQueryDraftValid, - setFilterQueryDraftFromKueryExpression, - }) => ( - <AutocompleteField - isLoadingSuggestions={isLoadingSuggestions} - isValid={isFilterQueryDraftValid} - loadSuggestions={loadSuggestions} - onChange={setFilterQueryDraftFromKueryExpression} - onSubmit={applyFilterQueryFromKueryExpression} - placeholder={i18n.translate( - 'xpack.infra.homePage.toolbar.kqlSearchFieldPlaceholder', - { - defaultMessage: 'Search for infrastructure data… (e.g. host.name:host-1)', - } - )} - suggestions={suggestions} - value={filterQueryDraft ? filterQueryDraft.expression : ''} - autoFocus={true} - /> - )} - </WithWaffleFilter> - )} - </WithKueryAutocompletion> - )} - </WithSource> + <SearchBar /> </EuiFlexItem> <EuiFlexItem grow={false}> - <WithWaffleTime resetOnUnmount> - {({ currentTime, isAutoReloading, jumpToTime, startAutoReload, stopAutoReload }) => ( - <WaffleTimeControls - currentTime={currentTime} - isLiveStreaming={isAutoReloading} - onChangeTime={jumpToTime} - startLiveStreaming={startAutoReload} - stopLiveStreaming={stopAutoReload} - /> - )} - </WithWaffleTime> + <WaffleTimeControls /> </EuiFlexItem> </EuiFlexGroup> </Toolbar> diff --git a/x-pack/plugins/infra/public/pages/inventory_view/compontents/search_bar.tsx b/x-pack/plugins/infra/public/pages/inventory_view/compontents/search_bar.tsx new file mode 100644 index 0000000000000..f4fde46d434f8 --- /dev/null +++ b/x-pack/plugins/infra/public/pages/inventory_view/compontents/search_bar.tsx @@ -0,0 +1,40 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import React, { useContext } from 'react'; +import { i18n } from '@kbn/i18n'; +import { Source } from '../../../containers/source'; +import { AutocompleteField } from '../../../components/autocomplete_field'; +import { WithKueryAutocompletion } from '../../../containers/with_kuery_autocompletion'; +import { useWaffleFiltersContext } from '../hooks/use_waffle_filters'; + +export const SearchBar = () => { + const { createDerivedIndexPattern } = useContext(Source.Context); + const { + applyFilterQueryFromKueryExpression, + filterQueryDraft, + isFilterQueryDraftValid, + setFilterQueryDraftFromKueryExpression, + } = useWaffleFiltersContext(); + return ( + <WithKueryAutocompletion indexPattern={createDerivedIndexPattern('metrics')}> + {({ isLoadingSuggestions, loadSuggestions, suggestions }) => ( + <AutocompleteField + isLoadingSuggestions={isLoadingSuggestions} + isValid={isFilterQueryDraftValid} + loadSuggestions={loadSuggestions} + onChange={setFilterQueryDraftFromKueryExpression} + onSubmit={applyFilterQueryFromKueryExpression} + placeholder={i18n.translate('xpack.infra.homePage.toolbar.kqlSearchFieldPlaceholder', { + defaultMessage: 'Search for infrastructure data… (e.g. host.name:host-1)', + })} + suggestions={suggestions} + value={filterQueryDraft ? filterQueryDraft : ''} + autoFocus={true} + /> + )} + </WithKueryAutocompletion> + ); +}; diff --git a/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_filters.ts b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_filters.ts new file mode 100644 index 0000000000000..02c079dcaddc4 --- /dev/null +++ b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_filters.ts @@ -0,0 +1,93 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { useState, useMemo, useCallback, useEffect } from 'react'; +import * as rt from 'io-ts'; +import { pipe } from 'fp-ts/lib/pipeable'; +import { fold } from 'fp-ts/lib/Either'; +import { constant, identity } from 'fp-ts/lib/function'; +import createContainter from 'constate'; +import { useUrlState } from '../../../utils/use_url_state'; +import { useSourceContext } from '../../../containers/source'; +import { convertKueryToElasticSearchQuery } from '../../../utils/kuery'; +import { esKuery } from '../../../../../../../src/plugins/data/public'; + +const validateKuery = (expression: string) => { + try { + esKuery.fromKueryExpression(expression); + } catch (err) { + return false; + } + return true; +}; + +export const DEFAULT_WAFFLE_FILTERS_STATE: WaffleFiltersState = { kind: 'kuery', expression: '' }; + +export const useWaffleFilters = () => { + const { createDerivedIndexPattern } = useSourceContext(); + const indexPattern = createDerivedIndexPattern('metrics'); + + const [urlState, setUrlState] = useUrlState<WaffleFiltersState>({ + defaultState: DEFAULT_WAFFLE_FILTERS_STATE, + decodeUrlState, + encodeUrlState, + urlStateKey: 'waffleFilter', + }); + + const [state, setState] = useState<WaffleFiltersState>(urlState); + + useEffect(() => setUrlState(state), [setUrlState, state]); + + const [filterQueryDraft, setFilterQueryDraft] = useState<string>(urlState.expression); + + const filterQueryAsJson = useMemo( + () => convertKueryToElasticSearchQuery(urlState.expression, indexPattern), + [indexPattern, urlState.expression] + ); + + const applyFilterQueryFromKueryExpression = useCallback( + (expression: string) => { + setState(previous => ({ + ...previous, + kind: 'kuery', + expression, + })); + }, + [setState] + ); + + const applyFilterQuery = useCallback((filterQuery: WaffleFiltersState) => { + setState(filterQuery); + setFilterQueryDraft(filterQuery.expression); + }, []); + + const isFilterQueryDraftValid = useMemo(() => validateKuery(filterQueryDraft), [ + filterQueryDraft, + ]); + + return { + filterQuery: urlState, + filterQueryDraft, + filterQueryAsJson, + applyFilterQuery, + setFilterQueryDraftFromKueryExpression: setFilterQueryDraft, + applyFilterQueryFromKueryExpression, + isFilterQueryDraftValid, + setWaffleFiltersState: applyFilterQuery, + }; +}; + +export const WaffleFiltersStateRT = rt.type({ + kind: rt.literal('kuery'), + expression: rt.string, +}); + +export type WaffleFiltersState = rt.TypeOf<typeof WaffleFiltersStateRT>; +const encodeUrlState = WaffleFiltersStateRT.encode; +const decodeUrlState = (value: unknown) => + pipe(WaffleFiltersStateRT.decode(value), fold(constant(undefined), identity)); +export const WaffleFilters = createContainter(useWaffleFilters); +export const [WaffleFiltersProvider, useWaffleFiltersContext] = WaffleFilters; diff --git a/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_options.ts b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_options.ts new file mode 100644 index 0000000000000..2853917d5f683 --- /dev/null +++ b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_options.ts @@ -0,0 +1,147 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { useCallback, useState, useEffect } from 'react'; +import * as rt from 'io-ts'; +import { pipe } from 'fp-ts/lib/pipeable'; +import { fold } from 'fp-ts/lib/Either'; +import { constant, identity } from 'fp-ts/lib/function'; +import createContainer from 'constate'; +import { + SnapshotMetricInput, + SnapshotGroupBy, + SnapshotCustomMetricInput, + SnapshotMetricInputRT, + SnapshotGroupByRT, + SnapshotCustomMetricInputRT, +} from '../../../../common/http_api/snapshot_api'; +import { useUrlState } from '../../../utils/use_url_state'; +import { InventoryItemType, ItemTypeRT } from '../../../../common/inventory_models/types'; + +export const DEFAULT_WAFFLE_OPTIONS_STATE: WaffleOptionsState = { + metric: { type: 'cpu' }, + groupBy: [], + nodeType: 'host', + view: 'map', + customOptions: [], + boundsOverride: { max: 1, min: 0 }, + autoBounds: true, + accountId: '', + region: '', + customMetrics: [], +}; + +export const useWaffleOptions = () => { + const [urlState, setUrlState] = useUrlState<WaffleOptionsState>({ + defaultState: DEFAULT_WAFFLE_OPTIONS_STATE, + decodeUrlState, + encodeUrlState, + urlStateKey: 'waffleOptions', + }); + + const [state, setState] = useState<WaffleOptionsState>(urlState); + + useEffect(() => setUrlState(state), [setUrlState, state]); + + const changeMetric = useCallback( + (metric: SnapshotMetricInput) => setState(previous => ({ ...previous, metric })), + [setState] + ); + + const changeGroupBy = useCallback( + (groupBy: SnapshotGroupBy) => setState(previous => ({ ...previous, groupBy })), + [setState] + ); + + const changeNodeType = useCallback( + (nodeType: InventoryItemType) => setState(previous => ({ ...previous, nodeType })), + [setState] + ); + + const changeView = useCallback((view: string) => setState(previous => ({ ...previous, view })), [ + setState, + ]); + + const changeCustomOptions = useCallback( + (customOptions: Array<{ text: string; field: string }>) => + setState(previous => ({ ...previous, customOptions })), + [setState] + ); + + const changeAutoBounds = useCallback( + (autoBounds: boolean) => setState(previous => ({ ...previous, autoBounds })), + [setState] + ); + + const changeBoundsOverride = useCallback( + (boundsOverride: { min: number; max: number }) => + setState(previous => ({ ...previous, boundsOverride })), + [setState] + ); + + const changeAccount = useCallback( + (accountId: string) => setState(previous => ({ ...previous, accountId })), + [setState] + ); + + const changeRegion = useCallback( + (region: string) => setState(previous => ({ ...previous, region })), + [setState] + ); + + const changeCustomMetrics = useCallback( + (customMetrics: SnapshotCustomMetricInput[]) => { + setState(previous => ({ ...previous, customMetrics })); + }, + [setState] + ); + + return { + ...state, + changeMetric, + changeGroupBy, + changeNodeType, + changeView, + changeCustomOptions, + changeAutoBounds, + changeBoundsOverride, + changeAccount, + changeRegion, + changeCustomMetrics, + setWaffleOptionsState: setState, + }; +}; + +export const WaffleOptionsStateRT = rt.type({ + metric: SnapshotMetricInputRT, + groupBy: SnapshotGroupByRT, + nodeType: ItemTypeRT, + view: rt.string, + customOptions: rt.array( + rt.type({ + text: rt.string, + field: rt.string, + }) + ), + boundsOverride: rt.type({ + min: rt.number, + max: rt.number, + }), + autoBounds: rt.boolean, + accountId: rt.string, + region: rt.string, + customMetrics: rt.array(SnapshotCustomMetricInputRT), +}); + +export type WaffleOptionsState = rt.TypeOf<typeof WaffleOptionsStateRT>; +const encodeUrlState = (state: WaffleOptionsState) => { + return WaffleOptionsStateRT.encode(state); +}; +const decodeUrlState = (value: unknown) => + pipe(WaffleOptionsStateRT.decode(value), fold(constant(undefined), identity)); + +export const WaffleOptions = createContainer(useWaffleOptions); +export const [WaffleOptionsProvider, useWaffleOptionsContext] = WaffleOptions; diff --git a/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_time.ts b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_time.ts new file mode 100644 index 0000000000000..051b5e598cb75 --- /dev/null +++ b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_time.ts @@ -0,0 +1,76 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { useCallback, useState, useEffect } from 'react'; +import * as rt from 'io-ts'; +import { pipe } from 'fp-ts/lib/pipeable'; +import { fold } from 'fp-ts/lib/Either'; +import { constant, identity } from 'fp-ts/lib/function'; +import createContainer from 'constate'; +import { useUrlState } from '../../../utils/use_url_state'; + +export const DEFAULT_WAFFLE_TIME_STATE: WaffleTimeState = { + currentTime: Date.now(), + isAutoReloading: false, +}; + +export const useWaffleTime = () => { + const [urlState, setUrlState] = useUrlState<WaffleTimeState>({ + defaultState: DEFAULT_WAFFLE_TIME_STATE, + decodeUrlState, + encodeUrlState, + urlStateKey: 'waffleTime', + }); + + const [state, setState] = useState<WaffleTimeState>(urlState); + + useEffect(() => setUrlState(state), [setUrlState, state]); + + const { currentTime, isAutoReloading } = urlState; + + const startAutoReload = useCallback(() => { + setState(previous => ({ ...previous, isAutoReloading: true })); + }, [setState]); + + const stopAutoReload = useCallback(() => { + setState(previous => ({ ...previous, isAutoReloading: false })); + }, [setState]); + + const jumpToTime = useCallback( + (time: number) => { + setState(previous => ({ ...previous, currentTime: time })); + }, + [setState] + ); + + const currentTimeRange = { + from: currentTime - 1000 * 60 * 5, + interval: '1m', + to: currentTime, + }; + + return { + currentTime, + currentTimeRange, + isAutoReloading, + startAutoReload, + stopAutoReload, + jumpToTime, + setWaffleTimeState: setState, + }; +}; + +export const WaffleTimeStateRT = rt.type({ + currentTime: rt.number, + isAutoReloading: rt.boolean, +}); + +export type WaffleTimeState = rt.TypeOf<typeof WaffleTimeStateRT>; +const encodeUrlState = WaffleTimeStateRT.encode; +const decodeUrlState = (value: unknown) => + pipe(WaffleTimeStateRT.decode(value), fold(constant(undefined), identity)); + +export const WaffleTime = createContainer(useWaffleTime); +export const [WaffleTimeProvider, useWaffleTimeContext] = WaffleTime; diff --git a/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_view_state.ts b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_view_state.ts new file mode 100644 index 0000000000000..869560b2b8709 --- /dev/null +++ b/x-pack/plugins/infra/public/pages/inventory_view/hooks/use_waffle_view_state.ts @@ -0,0 +1,95 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { useCallback } from 'react'; +import { + useWaffleOptionsContext, + DEFAULT_WAFFLE_OPTIONS_STATE, + WaffleOptionsState, +} from './use_waffle_options'; +import { useWaffleTimeContext, DEFAULT_WAFFLE_TIME_STATE } from './use_waffle_time'; +import { + useWaffleFiltersContext, + DEFAULT_WAFFLE_FILTERS_STATE, + WaffleFiltersState, +} from './use_waffle_filters'; + +export const useWaffleViewState = () => { + const { + metric, + groupBy, + nodeType, + view, + customOptions, + customMetrics, + boundsOverride, + autoBounds, + accountId, + region, + setWaffleOptionsState, + } = useWaffleOptionsContext(); + const { currentTime, isAutoReloading, setWaffleTimeState } = useWaffleTimeContext(); + const { filterQuery, setWaffleFiltersState } = useWaffleFiltersContext(); + + const viewState: WaffleViewState = { + metric, + groupBy, + nodeType, + view, + customOptions, + customMetrics, + boundsOverride, + autoBounds, + accountId, + region, + time: currentTime, + autoReload: isAutoReloading, + filterQuery, + }; + + const defaultViewState: WaffleViewState = { + ...DEFAULT_WAFFLE_OPTIONS_STATE, + filterQuery: DEFAULT_WAFFLE_FILTERS_STATE, + time: DEFAULT_WAFFLE_TIME_STATE.currentTime, + autoReload: DEFAULT_WAFFLE_TIME_STATE.isAutoReloading, + }; + + const onViewChange = useCallback( + (newState: WaffleViewState) => { + setWaffleOptionsState({ + metric: newState.metric, + groupBy: newState.groupBy, + nodeType: newState.nodeType, + view: newState.view, + customOptions: newState.customOptions, + customMetrics: newState.customMetrics, + boundsOverride: newState.boundsOverride, + autoBounds: newState.autoBounds, + accountId: newState.accountId, + region: newState.region, + }); + if (newState.time) { + setWaffleTimeState({ + currentTime: newState.time, + isAutoReloading: newState.autoReload, + }); + } + setWaffleFiltersState(newState.filterQuery); + }, + [setWaffleOptionsState, setWaffleTimeState, setWaffleFiltersState] + ); + + return { + viewState, + defaultViewState, + onViewChange, + }; +}; + +export type WaffleViewState = WaffleOptionsState & { + time: number; + autoReload: boolean; + filterQuery: WaffleFiltersState; +}; diff --git a/x-pack/plugins/infra/public/pages/link_to/redirect_to_host_detail_via_ip.tsx b/x-pack/plugins/infra/public/pages/link_to/redirect_to_host_detail_via_ip.tsx index 01b02f1acbbf2..b1dab3bd3f673 100644 --- a/x-pack/plugins/infra/public/pages/link_to/redirect_to_host_detail_via_ip.tsx +++ b/x-pack/plugins/infra/public/pages/link_to/redirect_to_host_detail_via_ip.tsx @@ -8,7 +8,7 @@ import React from 'react'; import { Redirect, RouteComponentProps } from 'react-router-dom'; import { i18n } from '@kbn/i18n'; -import { replaceMetricTimeInQueryString } from '../metrics/containers/with_metrics_time'; +import { replaceMetricTimeInQueryString } from '../metrics/hooks/use_metrics_time'; import { useHostIpToName } from './use_host_ip_to_name'; import { getFromFromLocation, getToFromLocation } from './query_params'; import { LoadingPage } from '../../components/loading_page'; diff --git a/x-pack/plugins/infra/public/pages/link_to/redirect_to_node_detail.tsx b/x-pack/plugins/infra/public/pages/link_to/redirect_to_node_detail.tsx index 9eae632756a3f..72a41f5264244 100644 --- a/x-pack/plugins/infra/public/pages/link_to/redirect_to_node_detail.tsx +++ b/x-pack/plugins/infra/public/pages/link_to/redirect_to_node_detail.tsx @@ -7,7 +7,7 @@ import React from 'react'; import { Redirect, RouteComponentProps } from 'react-router-dom'; -import { replaceMetricTimeInQueryString } from '../metrics/containers/with_metrics_time'; +import { replaceMetricTimeInQueryString } from '../metrics/hooks/use_metrics_time'; import { getFromFromLocation, getToFromLocation } from './query_params'; import { InventoryItemType } from '../../../common/inventory_models/types'; import { LinkDescriptor } from '../../hooks/use_link_props'; diff --git a/x-pack/plugins/infra/public/pages/metrics/components/node_details_page.tsx b/x-pack/plugins/infra/public/pages/metrics/components/node_details_page.tsx index ea91c53faf675..dd2a5f2bdb39e 100644 --- a/x-pack/plugins/infra/public/pages/metrics/components/node_details_page.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/components/node_details_page.tsx @@ -22,7 +22,7 @@ import { MetricsTimeControls } from './time_controls'; import { SideNavContext, NavItem } from '../lib/side_nav_context'; import { PageBody } from './page_body'; import { euiStyled } from '../../../../../observability/public'; -import { MetricsTimeInput } from '../containers/with_metrics_time'; +import { MetricsTimeInput } from '../hooks/use_metrics_time'; import { InfraMetadata } from '../../../../common/http_api/metadata_api'; import { PageError } from './page_error'; import { MetadataContext } from '../../../pages/metrics/containers/metadata_context'; @@ -94,7 +94,7 @@ export const NodeDetailsPage = (props: Props) => { setRefreshInterval={props.setRefreshInterval} onChangeTimeRange={props.setTimeRange} setAutoReload={props.setAutoReload} - onRefresh={props.triggerRefresh} + onRefresh={refetch} /> </MetricsTitleTimeRangeContainer> </EuiPageHeaderSection> diff --git a/x-pack/plugins/infra/public/pages/metrics/components/page_body.tsx b/x-pack/plugins/infra/public/pages/metrics/components/page_body.tsx index 414b9c60adee3..e651d6b92d981 100644 --- a/x-pack/plugins/infra/public/pages/metrics/components/page_body.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/components/page_body.tsx @@ -9,7 +9,7 @@ import { i18n } from '@kbn/i18n'; import { findLayout } from '../../../../common/inventory_models/layouts'; import { InventoryItemType } from '../../../../common/inventory_models/types'; -import { MetricsTimeInput } from '../containers/with_metrics_time'; +import { MetricsTimeInput } from '../hooks/use_metrics_time'; import { InfraLoadingPanel } from '../../../components/loading'; import { NoData } from '../../../components/empty_states'; import { NodeDetailsMetricData } from '../../../../common/http_api/node_details_api'; @@ -19,9 +19,9 @@ interface Props { refetch: () => void; type: InventoryItemType; metrics: NodeDetailsMetricData[]; - onChangeRangeTime?: (time: MetricsTimeInput) => void; - isLiveStreaming?: boolean; - stopLiveStreaming?: () => void; + onChangeRangeTime: (time: MetricsTimeInput) => void; + isLiveStreaming: boolean; + stopLiveStreaming: () => void; } export const PageBody = ({ diff --git a/x-pack/plugins/infra/public/pages/metrics/components/section.tsx b/x-pack/plugins/infra/public/pages/metrics/components/section.tsx index 2f9ed9f54df82..68003737a1f14 100644 --- a/x-pack/plugins/infra/public/pages/metrics/components/section.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/components/section.tsx @@ -41,6 +41,9 @@ export const Section: FunctionComponent<SectionProps> = ({ if (metric === null) { return accumulatedChildren; } + if (!child.props.label) { + return accumulatedChildren; + } return [ ...accumulatedChildren, { diff --git a/x-pack/plugins/infra/public/pages/metrics/components/time_controls.test.tsx b/x-pack/plugins/infra/public/pages/metrics/components/time_controls.test.tsx index 91e25fd8ef585..02ba506e8abe1 100644 --- a/x-pack/plugins/infra/public/pages/metrics/components/time_controls.test.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/components/time_controls.test.tsx @@ -19,7 +19,7 @@ jest.mock('../../../utils/use_kibana_ui_setting', () => ({ import React from 'react'; import { MetricsTimeControls } from './time_controls'; import { mount } from 'enzyme'; -import { MetricsTimeInput } from '../containers/with_metrics_time'; +import { MetricsTimeInput } from '../hooks/use_metrics_time'; describe('MetricsTimeControls', () => { it('should set a valid from and to value for Today', () => { diff --git a/x-pack/plugins/infra/public/pages/metrics/components/time_controls.tsx b/x-pack/plugins/infra/public/pages/metrics/components/time_controls.tsx index b1daaa0320fab..cdbdc9bb7ecdb 100644 --- a/x-pack/plugins/infra/public/pages/metrics/components/time_controls.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/components/time_controls.tsx @@ -7,7 +7,7 @@ import { EuiSuperDatePicker, OnRefreshChangeProps, OnTimeChangeProps } from '@elastic/eui'; import React, { useCallback } from 'react'; import { euiStyled } from '../../../../../observability/public'; -import { MetricsTimeInput } from '../containers/with_metrics_time'; +import { MetricsTimeInput } from '../hooks/use_metrics_time'; import { useKibanaUiSetting } from '../../../utils/use_kibana_ui_setting'; import { mapKibanaQuickRangesToDatePickerRanges } from '../../../utils/map_timepicker_quickranges_to_datepicker_ranges'; @@ -61,8 +61,8 @@ export const MetricsTimeControls = (props: MetricsTimeControlsProps) => { return ( <MetricsTimeControlsContainer> <EuiSuperDatePicker - start={currentTimeRange.from} - end={currentTimeRange.to} + start={currentTimeRange.from.toString()} + end={currentTimeRange.to.toString()} isPaused={!isLiveStreaming} refreshInterval={refreshInterval ? refreshInterval : 0} onTimeChange={handleTimeChange} diff --git a/x-pack/plugins/infra/public/pages/metrics/containers/metrics.gql_query.ts b/x-pack/plugins/infra/public/pages/metrics/containers/metrics.gql_query.ts deleted file mode 100644 index 1241c0d771382..0000000000000 --- a/x-pack/plugins/infra/public/pages/metrics/containers/metrics.gql_query.ts +++ /dev/null @@ -1,38 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import gql from 'graphql-tag'; - -export const metricsQuery = gql` - query MetricsQuery( - $sourceId: ID! - $timerange: InfraTimerangeInput! - $metrics: [InfraMetric!]! - $nodeId: ID! - $cloudId: ID - $nodeType: InfraNodeType! - ) { - source(id: $sourceId) { - id - metrics( - nodeIds: { nodeId: $nodeId, cloudId: $cloudId } - timerange: $timerange - metrics: $metrics - nodeType: $nodeType - ) { - id - series { - id - label - data { - timestamp - value - } - } - } - } - } -`; diff --git a/x-pack/plugins/infra/public/pages/metrics/containers/with_metrics_time.tsx b/x-pack/plugins/infra/public/pages/metrics/containers/with_metrics_time.tsx deleted file mode 100644 index 64d2ddb67139d..0000000000000 --- a/x-pack/plugins/infra/public/pages/metrics/containers/with_metrics_time.tsx +++ /dev/null @@ -1,201 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import createContainer from 'constate'; -import React, { useContext, useState, useCallback } from 'react'; -import { isNumber } from 'lodash'; -import moment from 'moment'; -import dateMath from '@elastic/datemath'; -import * as rt from 'io-ts'; -import { isRight } from 'fp-ts/lib/Either'; -import { replaceStateKeyInQueryString, UrlStateContainer } from '../../../utils/url_state'; -import { InfraTimerangeInput } from '../../../graphql/types'; - -export interface MetricsTimeInput { - from: string; - to: string; - interval: string; -} - -interface MetricsTimeState { - timeRange: MetricsTimeInput; - parsedTimeRange: InfraTimerangeInput; - setTimeRange: (timeRange: MetricsTimeInput) => void; - refreshInterval: number; - setRefreshInterval: (refreshInterval: number) => void; - isAutoReloading: boolean; - setAutoReload: (isAutoReloading: boolean) => void; - lastRefresh: number; - triggerRefresh: () => void; -} - -const parseRange = (range: MetricsTimeInput) => { - const parsedFrom = dateMath.parse(range.from); - const parsedTo = dateMath.parse(range.to, { roundUp: true }); - return { - ...range, - from: - (parsedFrom && parsedFrom.valueOf()) || - moment() - .subtract(1, 'hour') - .valueOf(), - to: (parsedTo && parsedTo.valueOf()) || moment().valueOf(), - }; -}; - -export const useMetricsTime = () => { - const defaultRange = { - from: 'now-1h', - to: 'now', - interval: '>=1m', - }; - const [isAutoReloading, setAutoReload] = useState(false); - const [refreshInterval, setRefreshInterval] = useState(5000); - const [lastRefresh, setLastRefresh] = useState<number>(moment().valueOf()); - const [timeRange, setTimeRange] = useState(defaultRange); - - const [parsedTimeRange, setParsedTimeRange] = useState(parseRange(defaultRange)); - - const updateTimeRange = useCallback((range: MetricsTimeInput) => { - setTimeRange(range); - setParsedTimeRange(parseRange(range)); - }, []); - - return { - timeRange, - setTimeRange: updateTimeRange, - parsedTimeRange, - refreshInterval, - setRefreshInterval, - isAutoReloading, - setAutoReload, - lastRefresh, - triggerRefresh: useCallback(() => setLastRefresh(moment().valueOf()), [setLastRefresh]), - }; -}; - -export const MetricsTimeContainer = createContainer(useMetricsTime); - -interface WithMetricsTimeProps { - children: (args: MetricsTimeState) => React.ReactElement; -} -export const WithMetricsTime: React.FunctionComponent<WithMetricsTimeProps> = ({ - children, -}: WithMetricsTimeProps) => { - const metricsTimeState = useContext(MetricsTimeContainer.Context); - return children({ ...metricsTimeState }); -}; - -/** - * Url State - */ - -interface MetricsTimeUrlState { - time?: MetricsTimeState['timeRange']; - autoReload?: boolean; - refreshInterval?: number; -} - -export const WithMetricsTimeUrlState = () => ( - <WithMetricsTime> - {({ - timeRange, - setTimeRange, - refreshInterval, - setRefreshInterval, - isAutoReloading, - setAutoReload, - }) => ( - <UrlStateContainer - urlState={{ - time: timeRange, - autoReload: isAutoReloading, - refreshInterval, - }} - urlStateKey="metricTime" - mapToUrlState={mapToUrlState} - onChange={newUrlState => { - if (newUrlState && newUrlState.time) { - setTimeRange(newUrlState.time); - } - if (newUrlState && newUrlState.autoReload) { - setAutoReload(true); - } else if ( - newUrlState && - typeof newUrlState.autoReload !== 'undefined' && - !newUrlState.autoReload - ) { - setAutoReload(false); - } - if (newUrlState && newUrlState.refreshInterval) { - setRefreshInterval(newUrlState.refreshInterval); - } - }} - onInitialize={initialUrlState => { - if (initialUrlState && initialUrlState.time) { - if ( - timeRange.from !== initialUrlState.time.from || - timeRange.to !== initialUrlState.time.to || - timeRange.interval !== initialUrlState.time.interval - ) { - setTimeRange(initialUrlState.time); - } - } - if (initialUrlState && initialUrlState.autoReload) { - setAutoReload(true); - } - if (initialUrlState && initialUrlState.refreshInterval) { - setRefreshInterval(initialUrlState.refreshInterval); - } - }} - /> - )} - </WithMetricsTime> -); - -const mapToUrlState = (value: any): MetricsTimeUrlState | undefined => - value - ? { - time: mapToTimeUrlState(value.time), - autoReload: mapToAutoReloadUrlState(value.autoReload), - refreshInterval: mapToRefreshInterval(value.refreshInterval), - } - : undefined; - -const MetricsTimeRT = rt.type({ - from: rt.union([rt.string, rt.number]), - to: rt.union([rt.string, rt.number]), - interval: rt.string, -}); - -const mapToTimeUrlState = (value: any) => { - const result = MetricsTimeRT.decode(value); - if (isRight(result)) { - const resultValue = result.right; - const to = isNumber(resultValue.to) ? moment(resultValue.to).toISOString() : resultValue.to; - const from = isNumber(resultValue.from) - ? moment(resultValue.from).toISOString() - : resultValue.from; - return { ...resultValue, from, to }; - } - return undefined; -}; - -const mapToAutoReloadUrlState = (value: any) => (typeof value === 'boolean' ? value : undefined); - -const mapToRefreshInterval = (value: any) => (typeof value === 'number' ? value : undefined); - -export const replaceMetricTimeInQueryString = (from: number, to: number) => - Number.isNaN(from) || Number.isNaN(to) - ? (value: string) => value - : replaceStateKeyInQueryString<MetricsTimeUrlState>('metricTime', { - autoReload: false, - time: { - interval: '>=1m', - from: moment(from).toISOString(), - to: moment(to).toISOString(), - }, - }); diff --git a/x-pack/plugins/infra/public/pages/metrics/containers/metrics_time.test.tsx b/x-pack/plugins/infra/public/pages/metrics/hooks/metrics_time.test.tsx similarity index 96% rename from x-pack/plugins/infra/public/pages/metrics/containers/metrics_time.test.tsx rename to x-pack/plugins/infra/public/pages/metrics/hooks/metrics_time.test.tsx index 350fa90810935..17fcc05406470 100644 --- a/x-pack/plugins/infra/public/pages/metrics/containers/metrics_time.test.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/hooks/metrics_time.test.tsx @@ -6,7 +6,7 @@ import { mountHook } from 'test_utils/enzyme_helpers'; -import { useMetricsTime } from './with_metrics_time'; +import { useMetricsTime } from './use_metrics_time'; describe('useMetricsTime hook', () => { describe('timeRange state', () => { diff --git a/x-pack/plugins/infra/public/pages/metrics/hooks/use_metrics_time.ts b/x-pack/plugins/infra/public/pages/metrics/hooks/use_metrics_time.ts new file mode 100644 index 0000000000000..2ed86863535ff --- /dev/null +++ b/x-pack/plugins/infra/public/pages/metrics/hooks/use_metrics_time.ts @@ -0,0 +1,121 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import createContainer from 'constate'; +import { useState, useCallback, useEffect } from 'react'; +import moment from 'moment'; +import dateMath from '@elastic/datemath'; +import * as rt from 'io-ts'; +import { pipe } from 'fp-ts/lib/pipeable'; +import { fold } from 'fp-ts/lib/Either'; +import { constant, identity } from 'fp-ts/lib/function'; +import { useUrlState } from '../../../utils/use_url_state'; +import { replaceStateKeyInQueryString } from '../../../utils/url_state'; + +const parseRange = (range: MetricsTimeInput) => { + const parsedFrom = dateMath.parse(range.from.toString()); + const parsedTo = dateMath.parse(range.to.toString(), { roundUp: true }); + return { + ...range, + from: + (parsedFrom && parsedFrom.valueOf()) || + moment() + .subtract(1, 'hour') + .valueOf(), + to: (parsedTo && parsedTo.valueOf()) || moment().valueOf(), + }; +}; + +const DEFAULT_TIMERANGE: MetricsTimeInput = { + from: 'now-1h', + to: 'now', + interval: '>=1m', +}; + +const DEFAULT_URL_STATE: MetricsTimeUrlState = { + time: DEFAULT_TIMERANGE, + autoReload: false, + refreshInterval: 5000, +}; + +export const useMetricsTime = () => { + const [urlState, setUrlState] = useUrlState<MetricsTimeUrlState>({ + defaultState: DEFAULT_URL_STATE, + decodeUrlState, + encodeUrlState, + urlStateKey: 'metricTime', + }); + + const [isAutoReloading, setAutoReload] = useState(urlState.autoReload || false); + const [refreshInterval, setRefreshInterval] = useState(urlState.refreshInterval || 5000); + const [lastRefresh, setLastRefresh] = useState<number>(moment().valueOf()); + const [timeRange, setTimeRange] = useState(urlState.time || DEFAULT_TIMERANGE); + + useEffect(() => { + const newState = { + time: timeRange, + autoReload: isAutoReloading, + refreshInterval, + }; + return setUrlState(newState); + }, [isAutoReloading, refreshInterval, setUrlState, timeRange]); + + const [parsedTimeRange, setParsedTimeRange] = useState( + parseRange(urlState.time || DEFAULT_TIMERANGE) + ); + + const updateTimeRange = useCallback((range: MetricsTimeInput) => { + setTimeRange(range); + setParsedTimeRange(parseRange(range)); + }, []); + + return { + timeRange, + setTimeRange: updateTimeRange, + parsedTimeRange, + refreshInterval, + setRefreshInterval, + isAutoReloading, + setAutoReload, + lastRefresh, + triggerRefresh: useCallback(() => { + return setLastRefresh(moment().valueOf()); + }, [setLastRefresh]), + }; +}; + +export const MetricsTimeInputRT = rt.type({ + from: rt.union([rt.string, rt.number]), + to: rt.union([rt.string, rt.number]), + interval: rt.string, +}); +export type MetricsTimeInput = rt.TypeOf<typeof MetricsTimeInputRT>; + +export const MetricsTimeUrlStateRT = rt.partial({ + time: MetricsTimeInputRT, + autoReload: rt.boolean, + refreshInterval: rt.number, +}); +export type MetricsTimeUrlState = rt.TypeOf<typeof MetricsTimeUrlStateRT>; + +const encodeUrlState = MetricsTimeUrlStateRT.encode; +const decodeUrlState = (value: unknown) => + pipe(MetricsTimeUrlStateRT.decode(value), fold(constant(undefined), identity)); + +export const replaceMetricTimeInQueryString = (from: number, to: number) => + Number.isNaN(from) || Number.isNaN(to) + ? (value: string) => value + : replaceStateKeyInQueryString<MetricsTimeUrlState>('metricTime', { + autoReload: false, + time: { + interval: '>=1m', + from: moment(from).toISOString(), + to: moment(to).toISOString(), + }, + }); + +export const MetricsTimeContainer = createContainer(useMetricsTime); +export const [MetricsTimeProvider, useMetricsTimeContext] = MetricsTimeContainer; diff --git a/x-pack/plugins/infra/public/pages/metrics/index.tsx b/x-pack/plugins/infra/public/pages/metrics/index.tsx index 52c9825a4d614..531be40d2dc43 100644 --- a/x-pack/plugins/infra/public/pages/metrics/index.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/index.tsx @@ -9,7 +9,6 @@ import { euiStyled, EuiTheme, withTheme } from '../../../../observability/public import { DocumentTitle } from '../../components/document_title'; import { Header } from '../../components/header'; import { ColumnarPage, PageContent } from '../../components/page'; -import { WithMetricsTime, WithMetricsTimeUrlState } from './containers/with_metrics_time'; import { withMetricPageProviders } from './page_providers'; import { useMetadata } from '../../containers/metadata/use_metadata'; import { Source } from '../../containers/source'; @@ -19,6 +18,7 @@ import { NavItem } from './lib/side_nav_context'; import { NodeDetailsPage } from './components/node_details_page'; import { useKibana } from '../../../../../../src/plugins/kibana_react/public'; import { InventoryItemType } from '../../../common/inventory_models/types'; +import { useMetricsTimeContext } from './hooks/use_metrics_time'; import { useLinkProps } from '../../hooks/use_link_props'; const DetailPageContent = euiStyled(PageContent)` @@ -37,19 +37,29 @@ interface Props { } export const MetricDetail = withMetricPageProviders( - withTheme(({ match, theme }: Props) => { + withTheme(({ match }: Props) => { const uiCapabilities = useKibana().services.application?.capabilities; const nodeId = match.params.node; const nodeType = match.params.type as InventoryItemType; const inventoryModel = findInventoryModel(nodeType); const { sourceId } = useContext(Source.Context); + const { + timeRange, + parsedTimeRange, + setTimeRange, + refreshInterval, + setRefreshInterval, + isAutoReloading, + setAutoReload, + triggerRefresh, + } = useMetricsTimeContext(); const { name, filteredRequiredMetrics, loading: metadataLoading, cloudId, metadata, - } = useMetadata(nodeId, nodeType, inventoryModel.requiredMetrics, sourceId); + } = useMetadata(nodeId, nodeType, inventoryModel.requiredMetrics, sourceId, parsedTimeRange); const [sideNav, setSideNav] = useState<NavItem[]>([]); @@ -90,58 +100,41 @@ export const MetricDetail = withMetricPageProviders( } return ( - <WithMetricsTime> - {({ - timeRange, - parsedTimeRange, - setTimeRange, - refreshInterval, - setRefreshInterval, - isAutoReloading, - setAutoReload, - triggerRefresh, - }) => ( - <ColumnarPage> - <Header - breadcrumbs={breadcrumbs} - readOnlyBadge={!uiCapabilities?.infrastructure?.save} - /> - <WithMetricsTimeUrlState /> - <DocumentTitle - title={i18n.translate('xpack.infra.metricDetailPage.documentTitle', { - defaultMessage: 'Infrastructure | Metrics | {name}', - values: { - name, - }, - })} + <ColumnarPage> + <Header breadcrumbs={breadcrumbs} readOnlyBadge={!uiCapabilities?.infrastructure?.save} /> + <DocumentTitle + title={i18n.translate('xpack.infra.metricDetailPage.documentTitle', { + defaultMessage: 'Infrastructure | Metrics | {name}', + values: { + name, + }, + })} + /> + <DetailPageContent data-test-subj="infraMetricsPage"> + {metadata ? ( + <NodeDetailsPage + name={name} + requiredMetrics={filteredRequiredMetrics} + sourceId={sourceId} + timeRange={timeRange} + parsedTimeRange={parsedTimeRange} + nodeType={nodeType} + nodeId={nodeId} + cloudId={cloudId} + metadataLoading={metadataLoading} + isAutoReloading={isAutoReloading} + refreshInterval={refreshInterval} + sideNav={sideNav} + metadata={metadata} + addNavItem={addNavItem} + setRefreshInterval={setRefreshInterval} + setAutoReload={setAutoReload} + triggerRefresh={triggerRefresh} + setTimeRange={setTimeRange} /> - <DetailPageContent data-test-subj="infraMetricsPage"> - {metadata ? ( - <NodeDetailsPage - name={name} - requiredMetrics={filteredRequiredMetrics} - sourceId={sourceId} - timeRange={timeRange} - parsedTimeRange={parsedTimeRange} - nodeType={nodeType} - nodeId={nodeId} - cloudId={cloudId} - metadataLoading={metadataLoading} - isAutoReloading={isAutoReloading} - refreshInterval={refreshInterval} - sideNav={sideNav} - metadata={metadata} - addNavItem={addNavItem} - setRefreshInterval={setRefreshInterval} - setAutoReload={setAutoReload} - triggerRefresh={triggerRefresh} - setTimeRange={setTimeRange} - /> - ) : null} - </DetailPageContent> - </ColumnarPage> - )} - </WithMetricsTime> + ) : null} + </DetailPageContent> + </ColumnarPage> ); }) ); diff --git a/x-pack/plugins/infra/public/pages/metrics/page_providers.tsx b/x-pack/plugins/infra/public/pages/metrics/page_providers.tsx index 0abbd597dd65c..d3f10adec06ed 100644 --- a/x-pack/plugins/infra/public/pages/metrics/page_providers.tsx +++ b/x-pack/plugins/infra/public/pages/metrics/page_providers.tsx @@ -6,15 +6,15 @@ import React from 'react'; -import { MetricsTimeContainer } from './containers/with_metrics_time'; import { Source } from '../../containers/source'; +import { MetricsTimeProvider } from './hooks/use_metrics_time'; export const withMetricPageProviders = <T extends object>(Component: React.ComponentType<T>) => ( props: T ) => ( <Source.Provider sourceId="default"> - <MetricsTimeContainer.Provider> + <MetricsTimeProvider> <Component {...props} /> - </MetricsTimeContainer.Provider> + </MetricsTimeProvider> </Source.Provider> ); diff --git a/x-pack/plugins/infra/public/pages/metrics/types.ts b/x-pack/plugins/infra/public/pages/metrics/types.ts index fd6243292ec07..2cc261df28977 100644 --- a/x-pack/plugins/infra/public/pages/metrics/types.ts +++ b/x-pack/plugins/infra/public/pages/metrics/types.ts @@ -7,7 +7,7 @@ import rt from 'io-ts'; import { EuiTheme } from '../../../../observability/public'; import { InventoryFormatterTypeRT } from '../../../common/inventory_models/types'; -import { MetricsTimeInput } from './containers/with_metrics_time'; +import { MetricsTimeInput } from './hooks/use_metrics_time'; import { NodeDetailsMetricData } from '../../../common/http_api/node_details_api'; export interface LayoutProps { diff --git a/x-pack/plugins/infra/public/store/actions.ts b/x-pack/plugins/infra/public/store/actions.ts deleted file mode 100644 index 8a5d1f6c668d0..0000000000000 --- a/x-pack/plugins/infra/public/store/actions.ts +++ /dev/null @@ -1,7 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { waffleFilterActions, waffleTimeActions, waffleOptionsActions } from './local'; diff --git a/x-pack/plugins/infra/public/store/epics.ts b/x-pack/plugins/infra/public/store/epics.ts deleted file mode 100644 index b5e48a4ec6214..0000000000000 --- a/x-pack/plugins/infra/public/store/epics.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { combineEpics } from 'redux-observable'; - -import { createLocalEpic } from './local'; - -export const createRootEpic = <State>() => combineEpics(createLocalEpic<State>()); diff --git a/x-pack/plugins/infra/public/store/index.ts b/x-pack/plugins/infra/public/store/index.ts deleted file mode 100644 index 025da41ec40d5..0000000000000 --- a/x-pack/plugins/infra/public/store/index.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export * from './actions'; -export * from './epics'; -export * from './reducer'; -export * from './selectors'; -export { createStore } from './store'; diff --git a/x-pack/plugins/infra/public/store/local/actions.ts b/x-pack/plugins/infra/public/store/local/actions.ts deleted file mode 100644 index 1c79d5a515cd4..0000000000000 --- a/x-pack/plugins/infra/public/store/local/actions.ts +++ /dev/null @@ -1,9 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export { waffleFilterActions } from './waffle_filter'; -export { waffleTimeActions } from './waffle_time'; -export { waffleOptionsActions } from './waffle_options'; diff --git a/x-pack/plugins/infra/public/store/local/epic.ts b/x-pack/plugins/infra/public/store/local/epic.ts deleted file mode 100644 index e1a051355576f..0000000000000 --- a/x-pack/plugins/infra/public/store/local/epic.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { combineEpics } from 'redux-observable'; - -import { createWaffleTimeEpic } from './waffle_time'; - -export const createLocalEpic = <State>() => combineEpics(createWaffleTimeEpic<State>()); diff --git a/x-pack/plugins/infra/public/store/local/index.ts b/x-pack/plugins/infra/public/store/local/index.ts deleted file mode 100644 index c2843320bfd0c..0000000000000 --- a/x-pack/plugins/infra/public/store/local/index.ts +++ /dev/null @@ -1,10 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -export * from './actions'; -export * from './epic'; -export * from './reducer'; -export * from './selectors'; diff --git a/x-pack/plugins/infra/public/store/local/reducer.ts b/x-pack/plugins/infra/public/store/local/reducer.ts deleted file mode 100644 index 9e194a5d37f49..0000000000000 --- a/x-pack/plugins/infra/public/store/local/reducer.ts +++ /dev/null @@ -1,33 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { combineReducers } from 'redux'; - -import { initialWaffleFilterState, waffleFilterReducer, WaffleFilterState } from './waffle_filter'; -import { - initialWaffleOptionsState, - waffleOptionsReducer, - WaffleOptionsState, -} from './waffle_options'; -import { initialWaffleTimeState, waffleTimeReducer, WaffleTimeState } from './waffle_time'; - -export interface LocalState { - waffleFilter: WaffleFilterState; - waffleTime: WaffleTimeState; - waffleMetrics: WaffleOptionsState; -} - -export const initialLocalState: LocalState = { - waffleFilter: initialWaffleFilterState, - waffleTime: initialWaffleTimeState, - waffleMetrics: initialWaffleOptionsState, -}; - -export const localReducer = combineReducers<LocalState>({ - waffleFilter: waffleFilterReducer, - waffleTime: waffleTimeReducer, - waffleMetrics: waffleOptionsReducer, -}); diff --git a/x-pack/plugins/infra/public/store/local/selectors.ts b/x-pack/plugins/infra/public/store/local/selectors.ts deleted file mode 100644 index 56ffc53c2bc72..0000000000000 --- a/x-pack/plugins/infra/public/store/local/selectors.ts +++ /dev/null @@ -1,26 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { globalizeSelectors } from '../../utils/typed_redux'; -import { LocalState } from './reducer'; -import { waffleFilterSelectors as innerWaffleFilterSelectors } from './waffle_filter'; -import { waffleOptionsSelectors as innerWaffleOptionsSelectors } from './waffle_options'; -import { waffleTimeSelectors as innerWaffleTimeSelectors } from './waffle_time'; - -export const waffleFilterSelectors = globalizeSelectors( - (state: LocalState) => state.waffleFilter, - innerWaffleFilterSelectors -); - -export const waffleTimeSelectors = globalizeSelectors( - (state: LocalState) => state.waffleTime, - innerWaffleTimeSelectors -); - -export const waffleOptionsSelectors = globalizeSelectors( - (state: LocalState) => state.waffleMetrics, - innerWaffleOptionsSelectors -); diff --git a/x-pack/plugins/infra/public/store/local/waffle_filter/actions.ts b/x-pack/plugins/infra/public/store/local/waffle_filter/actions.ts deleted file mode 100644 index a23f9b3108b5b..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_filter/actions.ts +++ /dev/null @@ -1,19 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import actionCreatorFactory from 'typescript-fsa'; - -import { FilterQuery, SerializedFilterQuery } from './reducer'; - -const actionCreator = actionCreatorFactory('x-pack/infra/local/waffle_filter'); - -export const setWaffleFilterQueryDraft = actionCreator<FilterQuery>( - 'SET_WAFFLE_FILTER_QUERY_DRAFT' -); - -export const applyWaffleFilterQuery = actionCreator<SerializedFilterQuery>( - 'APPLY_WAFFLE_FILTER_QUERY' -); diff --git a/x-pack/plugins/infra/public/store/local/waffle_filter/index.ts b/x-pack/plugins/infra/public/store/local/waffle_filter/index.ts deleted file mode 100644 index 558314f2aeda8..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_filter/index.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import * as waffleFilterActions from './actions'; -import * as waffleFilterSelectors from './selectors'; - -export { waffleFilterActions, waffleFilterSelectors }; -export * from './reducer'; diff --git a/x-pack/plugins/infra/public/store/local/waffle_filter/reducer.ts b/x-pack/plugins/infra/public/store/local/waffle_filter/reducer.ts deleted file mode 100644 index 912ad96357334..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_filter/reducer.ts +++ /dev/null @@ -1,43 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { reducerWithInitialState } from 'typescript-fsa-reducers/dist'; - -import { applyWaffleFilterQuery, setWaffleFilterQueryDraft } from './actions'; - -export interface KueryFilterQuery { - kind: 'kuery'; - expression: string; -} - -export type FilterQuery = KueryFilterQuery; - -export interface SerializedFilterQuery { - query: FilterQuery | null; - serializedQuery: string | null; -} - -export interface WaffleFilterState { - filterQuery: SerializedFilterQuery | null; - filterQueryDraft: KueryFilterQuery | null; -} - -export const initialWaffleFilterState: WaffleFilterState = { - filterQuery: null, - filterQueryDraft: null, -}; - -export const waffleFilterReducer = reducerWithInitialState(initialWaffleFilterState) - .case(setWaffleFilterQueryDraft, (state, filterQueryDraft) => ({ - ...state, - filterQueryDraft, - })) - .case(applyWaffleFilterQuery, (state, filterQuery) => ({ - ...state, - filterQuery, - filterQueryDraft: filterQuery.query, - })) - .build(); diff --git a/x-pack/plugins/infra/public/store/local/waffle_filter/selectors.ts b/x-pack/plugins/infra/public/store/local/waffle_filter/selectors.ts deleted file mode 100644 index 047dabd3f0dd3..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_filter/selectors.ts +++ /dev/null @@ -1,33 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { createSelector } from 'reselect'; - -import { esKuery } from '../../../../../../../src/plugins/data/public'; -import { WaffleFilterState } from './reducer'; - -export const selectWaffleFilterQuery = (state: WaffleFilterState) => - state.filterQuery ? state.filterQuery.query : null; - -export const selectWaffleFilterQueryAsJson = (state: WaffleFilterState) => - state.filterQuery ? state.filterQuery.serializedQuery : null; - -export const selectWaffleFilterQueryDraft = (state: WaffleFilterState) => state.filterQueryDraft; - -export const selectIsWaffleFilterQueryDraftValid = createSelector( - selectWaffleFilterQueryDraft, - filterQueryDraft => { - if (filterQueryDraft && filterQueryDraft.kind === 'kuery') { - try { - esKuery.fromKueryExpression(filterQueryDraft.expression); - } catch (err) { - return false; - } - } - - return true; - } -); diff --git a/x-pack/plugins/infra/public/store/local/waffle_options/actions.ts b/x-pack/plugins/infra/public/store/local/waffle_options/actions.ts deleted file mode 100644 index 88229c31b2056..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_options/actions.ts +++ /dev/null @@ -1,29 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import actionCreatorFactory from 'typescript-fsa'; -import { - SnapshotGroupBy, - SnapshotMetricInput, - SnapshotCustomMetricInput, -} from '../../../../common/http_api/snapshot_api'; -import { InventoryItemType } from '../../../../common/inventory_models/types'; -import { InfraGroupByOptions, InfraWaffleMapBounds } from '../../../lib/lib'; - -const actionCreator = actionCreatorFactory('x-pack/infra/local/waffle_options'); - -export const changeMetric = actionCreator<SnapshotMetricInput>('CHANGE_METRIC'); -export const changeGroupBy = actionCreator<SnapshotGroupBy>('CHANGE_GROUP_BY'); -export const changeCustomOptions = actionCreator<InfraGroupByOptions[]>('CHANGE_CUSTOM_OPTIONS'); -export const changeNodeType = actionCreator<InventoryItemType>('CHANGE_NODE_TYPE'); -export const changeView = actionCreator<string>('CHANGE_VIEW'); -export const changeBoundsOverride = actionCreator<InfraWaffleMapBounds>('CHANGE_BOUNDS_OVERRIDE'); -export const changeAutoBounds = actionCreator<boolean>('CHANGE_AUTO_BOUNDS'); -export const changeAccount = actionCreator<string>('CHANGE_ACCOUNT'); -export const changeRegion = actionCreator<string>('CHANGE_REGION'); -export const changeCustomMetrics = actionCreator<SnapshotCustomMetricInput[]>( - 'CHANGE_CUSTOM_METRICS' -); diff --git a/x-pack/plugins/infra/public/store/local/waffle_options/index.ts b/x-pack/plugins/infra/public/store/local/waffle_options/index.ts deleted file mode 100644 index 3ecf108eb49d4..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_options/index.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import * as waffleOptionsActions from './actions'; -import * as waffleOptionsSelectors from './selector'; - -export { waffleOptionsActions, waffleOptionsSelectors }; -export * from './reducer'; diff --git a/x-pack/plugins/infra/public/store/local/waffle_options/reducer.ts b/x-pack/plugins/infra/public/store/local/waffle_options/reducer.ts deleted file mode 100644 index 3789228a7c16b..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_options/reducer.ts +++ /dev/null @@ -1,113 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { combineReducers } from 'redux'; -import { reducerWithInitialState } from 'typescript-fsa-reducers'; -import { - SnapshotMetricInput, - SnapshotGroupBy, - SnapshotCustomMetricInput, -} from '../../../../common/http_api/snapshot_api'; -import { InfraGroupByOptions, InfraWaffleMapBounds } from '../../../lib/lib'; -import { - changeAutoBounds, - changeBoundsOverride, - changeCustomOptions, - changeGroupBy, - changeMetric, - changeNodeType, - changeView, - changeAccount, - changeRegion, - changeCustomMetrics, -} from './actions'; -import { InventoryItemType } from '../../../../common/inventory_models/types'; - -export interface WaffleOptionsState { - metric: SnapshotMetricInput; - groupBy: SnapshotGroupBy; - nodeType: InventoryItemType; - view: string; - customOptions: InfraGroupByOptions[]; - boundsOverride: InfraWaffleMapBounds; - autoBounds: boolean; - accountId: string; - region: string; - customMetrics: SnapshotCustomMetricInput[]; -} - -export const initialWaffleOptionsState: WaffleOptionsState = { - metric: { type: 'cpu' }, - groupBy: [], - nodeType: 'host', - view: 'map', - customOptions: [], - boundsOverride: { max: 1, min: 0 }, - autoBounds: true, - accountId: '', - region: '', - customMetrics: [], -}; - -const currentMetricReducer = reducerWithInitialState(initialWaffleOptionsState.metric).case( - changeMetric, - (current, target) => target -); - -const currentCustomOptionsReducer = reducerWithInitialState( - initialWaffleOptionsState.customOptions -).case(changeCustomOptions, (current, target) => target); - -const currentGroupByReducer = reducerWithInitialState(initialWaffleOptionsState.groupBy).case( - changeGroupBy, - (current, target) => target -); - -const currentNodeTypeReducer = reducerWithInitialState(initialWaffleOptionsState.nodeType).case( - changeNodeType, - (current, target) => target -); - -const currentViewReducer = reducerWithInitialState(initialWaffleOptionsState.view).case( - changeView, - (current, target) => target -); - -const currentBoundsOverrideReducer = reducerWithInitialState( - initialWaffleOptionsState.boundsOverride -).case(changeBoundsOverride, (current, target) => target); - -const currentAutoBoundsReducer = reducerWithInitialState(initialWaffleOptionsState.autoBounds).case( - changeAutoBounds, - (current, target) => target -); - -const currentAccountIdReducer = reducerWithInitialState(initialWaffleOptionsState.accountId).case( - changeAccount, - (current, target) => target -); - -const currentRegionReducer = reducerWithInitialState(initialWaffleOptionsState.region).case( - changeRegion, - (current, target) => target -); - -const currentCustomMetricsReducer = reducerWithInitialState( - initialWaffleOptionsState.customMetrics -).case(changeCustomMetrics, (current, target) => target); - -export const waffleOptionsReducer = combineReducers<WaffleOptionsState>({ - metric: currentMetricReducer, - groupBy: currentGroupByReducer, - nodeType: currentNodeTypeReducer, - view: currentViewReducer, - customOptions: currentCustomOptionsReducer, - boundsOverride: currentBoundsOverrideReducer, - autoBounds: currentAutoBoundsReducer, - accountId: currentAccountIdReducer, - region: currentRegionReducer, - customMetrics: currentCustomMetricsReducer, -}); diff --git a/x-pack/plugins/infra/public/store/local/waffle_options/selector.ts b/x-pack/plugins/infra/public/store/local/waffle_options/selector.ts deleted file mode 100644 index 4487af156df97..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_options/selector.ts +++ /dev/null @@ -1,18 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { WaffleOptionsState } from './reducer'; - -export const selectMetric = (state: WaffleOptionsState) => state.metric; -export const selectGroupBy = (state: WaffleOptionsState) => state.groupBy; -export const selectCustomOptions = (state: WaffleOptionsState) => state.customOptions; -export const selectNodeType = (state: WaffleOptionsState) => state.nodeType; -export const selectView = (state: WaffleOptionsState) => state.view; -export const selectBoundsOverride = (state: WaffleOptionsState) => state.boundsOverride; -export const selectAutoBounds = (state: WaffleOptionsState) => state.autoBounds; -export const selectAccountId = (state: WaffleOptionsState) => state.accountId; -export const selectRegion = (state: WaffleOptionsState) => state.region; -export const selectCustomMetrics = (state: WaffleOptionsState) => state.customMetrics; diff --git a/x-pack/plugins/infra/public/store/local/waffle_time/actions.ts b/x-pack/plugins/infra/public/store/local/waffle_time/actions.ts deleted file mode 100644 index fe79f2f536a93..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_time/actions.ts +++ /dev/null @@ -1,15 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import actionCreatorFactory from 'typescript-fsa'; - -const actionCreator = actionCreatorFactory('x-pack/infra/local/waffle_time'); - -export const jumpToTime = actionCreator<number>('JUMP_TO_TIME'); - -export const startAutoReload = actionCreator('START_AUTO_RELOAD'); - -export const stopAutoReload = actionCreator('STOP_AUTO_RELOAD'); diff --git a/x-pack/plugins/infra/public/store/local/waffle_time/epic.ts b/x-pack/plugins/infra/public/store/local/waffle_time/epic.ts deleted file mode 100644 index 986d6b17a2424..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_time/epic.ts +++ /dev/null @@ -1,38 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { Action } from 'redux'; -import { Epic } from 'redux-observable'; -import { timer } from 'rxjs'; -import { exhaustMap, filter, map, takeUntil, withLatestFrom } from 'rxjs/operators'; - -import { jumpToTime, startAutoReload, stopAutoReload } from './actions'; - -interface WaffleTimeEpicDependencies<State> { - selectWaffleTimeUpdatePolicyInterval: (state: State) => number | null; -} - -export const createWaffleTimeEpic = <State>(): Epic< - Action, - Action, - State, - WaffleTimeEpicDependencies<State> -> => (action$, state$, { selectWaffleTimeUpdatePolicyInterval }) => { - const updateInterval$ = state$.pipe(map(selectWaffleTimeUpdatePolicyInterval), filter(isNotNull)); - - return action$.pipe( - filter(startAutoReload.match), - withLatestFrom(updateInterval$), - exhaustMap(([action, updateInterval]) => - timer(0, updateInterval).pipe( - map(() => jumpToTime(Date.now())), - takeUntil(action$.pipe(filter(stopAutoReload.match))) - ) - ) - ); -}; - -const isNotNull = <T>(value: T | null): value is T => value !== null; diff --git a/x-pack/plugins/infra/public/store/local/waffle_time/index.ts b/x-pack/plugins/infra/public/store/local/waffle_time/index.ts deleted file mode 100644 index 2b99a6d6d5760..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_time/index.ts +++ /dev/null @@ -1,12 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import * as waffleTimeActions from './actions'; -import * as waffleTimeSelectors from './selectors'; - -export { waffleTimeActions, waffleTimeSelectors }; -export * from './epic'; -export * from './reducer'; diff --git a/x-pack/plugins/infra/public/store/local/waffle_time/reducer.ts b/x-pack/plugins/infra/public/store/local/waffle_time/reducer.ts deleted file mode 100644 index 026e5decf5d37..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_time/reducer.ts +++ /dev/null @@ -1,52 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { combineReducers } from 'redux'; -import { reducerWithInitialState } from 'typescript-fsa-reducers/dist'; - -import { jumpToTime, startAutoReload, stopAutoReload } from './actions'; - -interface ManualTimeUpdatePolicy { - policy: 'manual'; -} - -interface IntervalTimeUpdatePolicy { - policy: 'interval'; - interval: number; -} - -type TimeUpdatePolicy = ManualTimeUpdatePolicy | IntervalTimeUpdatePolicy; - -export interface WaffleTimeState { - currentTime: number; - updatePolicy: TimeUpdatePolicy; -} - -export const initialWaffleTimeState: WaffleTimeState = { - currentTime: Date.now(), - updatePolicy: { - policy: 'manual', - }, -}; - -const currentTimeReducer = reducerWithInitialState(initialWaffleTimeState.currentTime).case( - jumpToTime, - (currentTime, targetTime) => targetTime -); - -const updatePolicyReducer = reducerWithInitialState(initialWaffleTimeState.updatePolicy) - .case(startAutoReload, () => ({ - policy: 'interval', - interval: 5000, - })) - .case(stopAutoReload, () => ({ - policy: 'manual', - })); - -export const waffleTimeReducer = combineReducers<WaffleTimeState>({ - currentTime: currentTimeReducer, - updatePolicy: updatePolicyReducer, -}); diff --git a/x-pack/plugins/infra/public/store/local/waffle_time/selectors.ts b/x-pack/plugins/infra/public/store/local/waffle_time/selectors.ts deleted file mode 100644 index 0b6d01bdf5288..0000000000000 --- a/x-pack/plugins/infra/public/store/local/waffle_time/selectors.ts +++ /dev/null @@ -1,23 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { createSelector } from 'reselect'; - -import { WaffleTimeState } from './reducer'; - -export const selectCurrentTime = (state: WaffleTimeState) => state.currentTime; - -export const selectIsAutoReloading = (state: WaffleTimeState) => - state.updatePolicy.policy === 'interval'; - -export const selectTimeUpdatePolicyInterval = (state: WaffleTimeState) => - state.updatePolicy.policy === 'interval' ? state.updatePolicy.interval : null; - -export const selectCurrentTimeRange = createSelector(selectCurrentTime, currentTime => ({ - from: currentTime - 1000 * 60 * 5, - interval: '1m', - to: currentTime, -})); diff --git a/x-pack/plugins/infra/public/store/reducer.ts b/x-pack/plugins/infra/public/store/reducer.ts deleted file mode 100644 index 2536ddbee401b..0000000000000 --- a/x-pack/plugins/infra/public/store/reducer.ts +++ /dev/null @@ -1,21 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { combineReducers } from 'redux'; - -import { initialLocalState, localReducer, LocalState } from './local'; - -export interface State { - local: LocalState; -} - -export const initialState: State = { - local: initialLocalState, -}; - -export const reducer = combineReducers<State>({ - local: localReducer, -}); diff --git a/x-pack/plugins/infra/public/store/selectors.ts b/x-pack/plugins/infra/public/store/selectors.ts deleted file mode 100644 index f4011c232cba4..0000000000000 --- a/x-pack/plugins/infra/public/store/selectors.ts +++ /dev/null @@ -1,22 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { globalizeSelectors } from '../utils/typed_redux'; -import { - waffleFilterSelectors as localWaffleFilterSelectors, - waffleOptionsSelectors as localWaffleOptionsSelectors, - waffleTimeSelectors as localWaffleTimeSelectors, -} from './local'; -import { State } from './reducer'; -/** - * local selectors - */ - -const selectLocal = (state: State) => state.local; - -export const waffleFilterSelectors = globalizeSelectors(selectLocal, localWaffleFilterSelectors); -export const waffleTimeSelectors = globalizeSelectors(selectLocal, localWaffleTimeSelectors); -export const waffleOptionsSelectors = globalizeSelectors(selectLocal, localWaffleOptionsSelectors); diff --git a/x-pack/plugins/infra/public/store/store.ts b/x-pack/plugins/infra/public/store/store.ts deleted file mode 100644 index cae0622c5e4a1..0000000000000 --- a/x-pack/plugins/infra/public/store/store.ts +++ /dev/null @@ -1,50 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { Action, applyMiddleware, compose, createStore as createBasicStore } from 'redux'; -import { createEpicMiddleware } from 'redux-observable'; -import { Observable } from 'rxjs'; -import { map } from 'rxjs/operators'; - -import { createRootEpic, initialState, reducer, State, waffleTimeSelectors } from '.'; -import { InfraApolloClient, InfraObservableApi } from '../lib/lib'; - -declare global { - interface Window { - __REDUX_DEVTOOLS_EXTENSION_COMPOSE__: typeof compose; - } -} - -export interface StoreDependencies { - apolloClient: Observable<InfraApolloClient>; - observableApi: Observable<InfraObservableApi>; -} - -export function createStore({ apolloClient, observableApi }: StoreDependencies) { - const composeEnhancers = window.__REDUX_DEVTOOLS_EXTENSION_COMPOSE__ || compose; - - const middlewareDependencies = { - postToApi$: observableApi.pipe(map(({ post }) => post)), - apolloClient$: apolloClient, - selectWaffleTimeUpdatePolicyInterval: waffleTimeSelectors.selectTimeUpdatePolicyInterval, - }; - - const epicMiddleware = createEpicMiddleware<Action, Action, State, typeof middlewareDependencies>( - { - dependencies: middlewareDependencies, - } - ); - - const store = createBasicStore( - reducer, - initialState, - composeEnhancers(applyMiddleware(epicMiddleware)) - ); - - epicMiddleware.run(createRootEpic<State>()); - - return store; -} diff --git a/x-pack/plugins/infra/public/utils/redux_context.tsx b/x-pack/plugins/infra/public/utils/redux_context.tsx deleted file mode 100644 index f249d72a6b56f..0000000000000 --- a/x-pack/plugins/infra/public/utils/redux_context.tsx +++ /dev/null @@ -1,16 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { useSelector } from 'react-redux'; -import React, { createContext } from 'react'; -import { State, initialState } from '../store'; - -export const ReduxStateContext = createContext(initialState); - -export const ReduxStateContextProvider = ({ children }: { children: JSX.Element }) => { - const state = useSelector((store: State) => store); - return <ReduxStateContext.Provider value={state}>{children}</ReduxStateContext.Provider>; -}; diff --git a/x-pack/plugins/infra/server/routes/metadata/index.ts b/x-pack/plugins/infra/server/routes/metadata/index.ts index 03d28110d612a..c45f191b1130d 100644 --- a/x-pack/plugins/infra/server/routes/metadata/index.ts +++ b/x-pack/plugins/infra/server/routes/metadata/index.ts @@ -38,7 +38,7 @@ export const initMetadataRoute = (libs: InfraBackendLibs) => { }, async (requestContext, request, response) => { try { - const { nodeId, nodeType, sourceId } = pipe( + const { nodeId, nodeType, sourceId, timeRange } = pipe( InfraMetadataRequestRT.decode(request.body), fold(throwErrors(Boom.badRequest), identity) ); @@ -52,7 +52,8 @@ export const initMetadataRoute = (libs: InfraBackendLibs) => { requestContext, configuration, nodeId, - nodeType + nodeType, + timeRange ); const metricFeatures = pickFeatureName(metricsMetadata.buckets).map( nameToFeature('metrics') @@ -62,7 +63,13 @@ export const initMetadataRoute = (libs: InfraBackendLibs) => { const cloudInstanceId = get<string>(info, 'cloud.instance.id'); const cloudMetricsMetadata = cloudInstanceId - ? await getCloudMetricsMetadata(framework, requestContext, configuration, cloudInstanceId) + ? await getCloudMetricsMetadata( + framework, + requestContext, + configuration, + cloudInstanceId, + timeRange + ) : { buckets: [] }; const cloudMetricsFeatures = pickFeatureName(cloudMetricsMetadata.buckets).map( nameToFeature('metrics') diff --git a/x-pack/plugins/infra/server/routes/metadata/lib/get_cloud_metric_metadata.ts b/x-pack/plugins/infra/server/routes/metadata/lib/get_cloud_metric_metadata.ts index 75ca3ae3caee2..54a1ca0aaa7e0 100644 --- a/x-pack/plugins/infra/server/routes/metadata/lib/get_cloud_metric_metadata.ts +++ b/x-pack/plugins/infra/server/routes/metadata/lib/get_cloud_metric_metadata.ts @@ -21,7 +21,8 @@ export const getCloudMetricsMetadata = async ( framework: KibanaFramework, requestContext: RequestHandlerContext, sourceConfiguration: InfraSourceConfiguration, - instanceId: string + instanceId: string, + timeRange: { from: number; to: number } ): Promise<InfraCloudMetricsAdapterResponse> => { const metricQuery = { allowNoIndices: true, @@ -30,7 +31,18 @@ export const getCloudMetricsMetadata = async ( body: { query: { bool: { - filter: [{ match: { 'cloud.instance.id': instanceId } }], + filter: [ + { match: { 'cloud.instance.id': instanceId } }, + { + range: { + [sourceConfiguration.fields.timestamp]: { + gte: timeRange.from, + lte: timeRange.to, + format: 'epoch_millis', + }, + }, + }, + ], should: CLOUD_METRICS_MODULES.map(module => ({ match: { 'event.module': module } })), }, }, diff --git a/x-pack/plugins/infra/server/routes/metadata/lib/get_metric_metadata.ts b/x-pack/plugins/infra/server/routes/metadata/lib/get_metric_metadata.ts index 191339565b813..7753d3161039b 100644 --- a/x-pack/plugins/infra/server/routes/metadata/lib/get_metric_metadata.ts +++ b/x-pack/plugins/infra/server/routes/metadata/lib/get_metric_metadata.ts @@ -26,7 +26,8 @@ export const getMetricMetadata = async ( requestContext: RequestHandlerContext, sourceConfiguration: InfraSourceConfiguration, nodeId: string, - nodeType: InventoryItemType + nodeType: InventoryItemType, + timeRange: { from: number; to: number } ): Promise<InfraMetricsAdapterResponse> => { const fields = findInventoryFields(nodeType, sourceConfiguration.fields); const metricQuery = { @@ -41,6 +42,15 @@ export const getMetricMetadata = async ( { match: { [fields.id]: nodeId }, }, + { + range: { + [sourceConfiguration.fields.timestamp]: { + gte: timeRange.from, + lte: timeRange.to, + format: 'epoch_millis', + }, + }, + }, ], }, }, diff --git a/x-pack/test/api_integration/apis/infra/metadata.ts b/x-pack/test/api_integration/apis/infra/metadata.ts index b693881abcdf7..5187cc5e3ec26 100644 --- a/x-pack/test/api_integration/apis/infra/metadata.ts +++ b/x-pack/test/api_integration/apis/infra/metadata.ts @@ -12,6 +12,28 @@ import { } from '../../../../plugins/infra/common/http_api/metadata_api'; import { FtrProviderContext } from '../../ftr_provider_context'; +import { DATES } from './constants'; + +const timeRange700 = { + from: DATES['7.0.0'].hosts.min, + to: DATES[`7.0.0`].hosts.max, +}; + +const timeRange660 = { + from: DATES['6.6.0'].docker.min, + to: DATES[`6.6.0`].docker.max, +}; + +const timeRange800withAws = { + from: DATES['8.0.0'].logs_and_metrics_with_aws.min, + to: DATES[`8.0.0`].logs_and_metrics_with_aws.max, +}; + +const timeRange800 = { + from: DATES['8.0.0'].logs_and_metrics.min, + to: DATES[`8.0.0`].logs_and_metrics.max, +}; + export default function({ getService }: FtrProviderContext) { const esArchiver = getService('esArchiver'); const supertest = getService('supertest'); @@ -34,6 +56,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: 'demo-stack-mysql-01', nodeType: InfraNodeType.host, + timeRange: timeRange700, }); if (metadata) { expect(metadata.features.length).to.be(12); @@ -53,6 +76,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: '631f36a845514442b93c3fdd2dc91bcd8feb680b8ac5832c7fb8fdc167bb938e', nodeType: InfraNodeType.container, + timeRange: timeRange660, }); if (metadata) { expect(metadata.features.length).to.be(10); @@ -74,6 +98,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: 'gke-observability-8--observability-8--bc1afd95-f0zc', nodeType: InfraNodeType.host, + timeRange: timeRange800withAws, }); if (metadata) { expect(metadata.features.length).to.be(58); @@ -114,6 +139,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: 'ip-172-31-47-9.us-east-2.compute.internal', nodeType: InfraNodeType.host, + timeRange: timeRange800withAws, }); if (metadata) { expect(metadata.features.length).to.be(19); @@ -155,6 +181,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: '14887487-99f8-11e9-9a96-42010a84004d', nodeType: InfraNodeType.pod, + timeRange: timeRange800withAws, }); if (metadata) { expect(metadata.features.length).to.be(29); @@ -200,6 +227,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: 'c74b04834c6d7cc1800c3afbe31d0c8c0c267f06e9eb45c2b0c2df3e6cee40c5', nodeType: InfraNodeType.container, + timeRange: timeRange800withAws, }); if (metadata) { expect(metadata.features.length).to.be(26); @@ -251,6 +279,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: 'gke-observability-8--observability-8--bc1afd95-f0zc', nodeType: 'host', + timeRange: timeRange800, }); if (metadata) { expect( @@ -265,6 +294,7 @@ export default function({ getService }: FtrProviderContext) { sourceId: 'default', nodeId: 'c1031331-9ae0-11e9-9a96-42010a84004d', nodeType: 'pod', + timeRange: timeRange800, }); if (metadata) { expect( diff --git a/x-pack/typings/rison_node.d.ts b/x-pack/typings/rison_node.d.ts index ec8e5c1f407ad..f830adc897445 100644 --- a/x-pack/typings/rison_node.d.ts +++ b/x-pack/typings/rison_node.d.ts @@ -5,7 +5,7 @@ */ declare module 'rison-node' { - export type RisonValue = null | boolean | number | string | RisonObject | RisonArray; + export type RisonValue = undefined | null | boolean | number | string | RisonObject | RisonArray; // eslint-disable-next-line @typescript-eslint/no-empty-interface export interface RisonArray extends Array<RisonValue> {} From 3e2665441633472fc57ba41b1a11bcf9b45db049 Mon Sep 17 00:00:00 2001 From: Pete Harverson <peteharverson@users.noreply.github.com> Date: Tue, 14 Apr 2020 17:49:46 +0100 Subject: [PATCH 096/102] [ML] Converts utils Mocha tests to Jest (#63132) * [ML] Converts utils Mocha tests to Jest * [ML] Remove unused imports * [ML] Switch out enzyme mount for react testing library render Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../ml/common/util/__tests__/anomaly_utils.js | 443 ------------- .../plugins/ml/common/util/anomaly_utils.d.ts | 11 - .../ml/common/util/anomaly_utils.test.ts | 444 +++++++++++++ .../{anomaly_utils.js => anomaly_utils.ts} | 54 +- .../{__tests__/utils.js => utils.test.js} | 45 +- .../util/__tests__/calc_auto_interval.js | 140 ---- .../application/util/__tests__/chart_utils.js | 297 --------- .../util/__tests__/string_utils.js | 229 ------- .../util/calc_auto_interval.test.js | 139 ++++ .../application/util/chart_utils.test.js | 624 ++++++++++++------ .../public/application/util/string_utils.d.ts | 4 + .../public/application/util/string_utils.js | 205 ------ .../application/util/string_utils.test.ts | 193 ++++++ 13 files changed, 1271 insertions(+), 1557 deletions(-) delete mode 100644 x-pack/plugins/ml/common/util/__tests__/anomaly_utils.js delete mode 100644 x-pack/plugins/ml/common/util/anomaly_utils.d.ts create mode 100644 x-pack/plugins/ml/common/util/anomaly_utils.test.ts rename x-pack/plugins/ml/common/util/{anomaly_utils.js => anomaly_utils.ts} (87%) rename x-pack/plugins/ml/public/application/components/rule_editor/{__tests__/utils.js => utils.test.js} (66%) delete mode 100644 x-pack/plugins/ml/public/application/util/__tests__/calc_auto_interval.js delete mode 100644 x-pack/plugins/ml/public/application/util/__tests__/chart_utils.js delete mode 100644 x-pack/plugins/ml/public/application/util/__tests__/string_utils.js create mode 100644 x-pack/plugins/ml/public/application/util/calc_auto_interval.test.js create mode 100644 x-pack/plugins/ml/public/application/util/string_utils.test.ts diff --git a/x-pack/plugins/ml/common/util/__tests__/anomaly_utils.js b/x-pack/plugins/ml/common/util/__tests__/anomaly_utils.js deleted file mode 100644 index 515304d222c8c..0000000000000 --- a/x-pack/plugins/ml/common/util/__tests__/anomaly_utils.js +++ /dev/null @@ -1,443 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { - getSeverity, - getSeverityWithLow, - getSeverityColor, - getMultiBucketImpactLabel, - getEntityFieldName, - getEntityFieldValue, - getEntityFieldList, - showActualForFunction, - showTypicalForFunction, - isRuleSupported, - aggregationTypeTransform, -} from '../anomaly_utils'; - -describe('ML - anomaly utils', () => { - const partitionEntityRecord = { - job_id: 'farequote', - result_type: 'record', - probability: 0.012818, - record_score: 0.0162059, - bucket_span: 300, - detector_index: 0, - timestamp: 1455047400000, - partition_field_name: 'airline', - partition_field_value: 'AAL', - function: 'mean', - function_description: 'mean', - field_name: 'responsetime', - }; - - const byEntityRecord = { - job_id: 'farequote', - result_type: 'record', - probability: 0.012818, - record_score: 0.0162059, - bucket_span: 300, - detector_index: 0, - timestamp: 1455047400000, - by_field_name: 'airline', - by_field_value: 'JZA', - function: 'mean', - function_description: 'mean', - field_name: 'responsetime', - }; - - const overEntityRecord = { - job_id: 'gallery', - result_type: 'record', - probability: 2.81806e-9, - record_score: 59.055, - bucket_span: 3600, - detector_index: 4, - timestamp: 1420552800000, - function: 'sum', - function_description: 'sum', - field_name: 'bytes', - by_field_name: 'method', - over_field_name: 'clientip', - over_field_value: '37.157.32.164', - }; - - const noEntityRecord = { - job_id: 'farequote_no_by', - result_type: 'record', - probability: 0.0191711, - record_score: 4.38431, - initial_record_score: 19.654, - bucket_span: 300, - detector_index: 0, - timestamp: 1454890500000, - function: 'mean', - function_description: 'mean', - field_name: 'responsetime', - }; - - const metricNoEntityRecord = { - job_id: 'farequote_metric', - result_type: 'record', - probability: 0.030133495093182184, - record_score: 0.024881740359975164, - initial_record_score: 0.024881740359975164, - bucket_span: 900, - detector_index: 0, - is_interim: false, - timestamp: 1486845000000, - function: 'metric', - function_description: 'mean', - typical: [545.7764658569108], - actual: [758.8220213274412], - field_name: 'responsetime', - influencers: [ - { - influencer_field_name: 'airline', - influencer_field_values: ['NKS'], - }, - ], - airline: ['NKS'], - }; - - const rareEntityRecord = { - job_id: 'gallery', - result_type: 'record', - probability: 0.02277014211908481, - record_score: 4.545378107075983, - initial_record_score: 4.545378107075983, - bucket_span: 3600, - detector_index: 0, - is_interim: false, - timestamp: 1495879200000, - by_field_name: 'status', - function: 'rare', - function_description: 'rare', - over_field_name: 'clientip', - over_field_value: '173.252.74.112', - causes: [ - { - probability: 0.02277014211908481, - by_field_name: 'status', - by_field_value: '206', - function: 'rare', - function_description: 'rare', - typical: [0.00014832458182211878], - actual: [1], - over_field_name: 'clientip', - over_field_value: '173.252.74.112', - }, - ], - influencers: [ - { - influencer_field_name: 'uri', - influencer_field_values: [ - '/wp-content/uploads/2013/06/dune_house_oil_on_canvas_24x20-298x298.jpg', - '/wp-content/uploads/2013/10/Case-dAste-1-11-298x298.png', - ], - }, - { - influencer_field_name: 'status', - influencer_field_values: ['206'], - }, - { - influencer_field_name: 'clientip', - influencer_field_values: ['173.252.74.112'], - }, - ], - clientip: ['173.252.74.112'], - uri: [ - '/wp-content/uploads/2013/06/dune_house_oil_on_canvas_24x20-298x298.jpg', - '/wp-content/uploads/2013/10/Case-dAste-1-11-298x298.png', - ], - status: ['206'], - }; - - describe('getSeverity', () => { - it('returns warning for 0 <= score < 25', () => { - expect(getSeverity(0).id).to.be('warning'); - expect(getSeverity(0.001).id).to.be('warning'); - expect(getSeverity(24.99).id).to.be('warning'); - }); - - it('returns minor for 25 <= score < 50', () => { - expect(getSeverity(25).id).to.be('minor'); - expect(getSeverity(49.99).id).to.be('minor'); - }); - - it('returns minor for 50 <= score < 75', () => { - expect(getSeverity(50).id).to.be('major'); - expect(getSeverity(74.99).id).to.be('major'); - }); - - it('returns critical for score >= 75', () => { - expect(getSeverity(75).id).to.be('critical'); - expect(getSeverity(100).id).to.be('critical'); - expect(getSeverity(1000).id).to.be('critical'); - }); - - it('returns unknown for scores less than 0 or string input', () => { - expect(getSeverity(-10).id).to.be('unknown'); - expect(getSeverity('value').id).to.be('unknown'); - }); - }); - - describe('getSeverityWithLow', () => { - it('returns low for 0 <= score < 3', () => { - expect(getSeverityWithLow(0).id).to.be('low'); - expect(getSeverityWithLow(0.001).id).to.be('low'); - expect(getSeverityWithLow(2.99).id).to.be('low'); - }); - - it('returns warning for 3 <= score < 25', () => { - expect(getSeverityWithLow(3).id).to.be('warning'); - expect(getSeverityWithLow(24.99).id).to.be('warning'); - }); - - it('returns minor for 25 <= score < 50', () => { - expect(getSeverityWithLow(25).id).to.be('minor'); - expect(getSeverityWithLow(49.99).id).to.be('minor'); - }); - - it('returns minor for 50 <= score < 75', () => { - expect(getSeverityWithLow(50).id).to.be('major'); - expect(getSeverityWithLow(74.99).id).to.be('major'); - }); - - it('returns critical for score >= 75', () => { - expect(getSeverityWithLow(75).id).to.be('critical'); - expect(getSeverityWithLow(100).id).to.be('critical'); - expect(getSeverityWithLow(1000).id).to.be('critical'); - }); - - it('returns unknown for scores less than 0 or string input', () => { - expect(getSeverityWithLow(-10).id).to.be('unknown'); - expect(getSeverityWithLow('value').id).to.be('unknown'); - }); - }); - - describe('getSeverityColor', () => { - it('returns correct hex code for low for 0 <= score < 3', () => { - expect(getSeverityColor(0)).to.be('#d2e9f7'); - expect(getSeverityColor(0.001)).to.be('#d2e9f7'); - expect(getSeverityColor(2.99)).to.be('#d2e9f7'); - }); - - it('returns correct hex code for warning for 3 <= score < 25', () => { - expect(getSeverityColor(3)).to.be('#8bc8fb'); - expect(getSeverityColor(24.99)).to.be('#8bc8fb'); - }); - - it('returns correct hex code for minor for 25 <= score < 50', () => { - expect(getSeverityColor(25)).to.be('#fdec25'); - expect(getSeverityColor(49.99)).to.be('#fdec25'); - }); - - it('returns correct hex code for major for 50 <= score < 75', () => { - expect(getSeverityColor(50)).to.be('#fba740'); - expect(getSeverityColor(74.99)).to.be('#fba740'); - }); - - it('returns correct hex code for critical for score >= 75', () => { - expect(getSeverityColor(75)).to.be('#fe5050'); - expect(getSeverityColor(100)).to.be('#fe5050'); - expect(getSeverityColor(1000)).to.be('#fe5050'); - }); - - it('returns correct hex code for unknown for scores less than 0 or string input', () => { - expect(getSeverityColor(-10)).to.be('#ffffff'); - expect(getSeverityColor('value')).to.be('#ffffff'); - }); - }); - - describe('getMultiBucketImpactLabel', () => { - it('returns high for 3 <= score <= 5', () => { - expect(getMultiBucketImpactLabel(3)).to.be('high'); - expect(getMultiBucketImpactLabel(5)).to.be('high'); - }); - - it('returns medium for 2 <= score < 3', () => { - expect(getMultiBucketImpactLabel(2)).to.be('medium'); - expect(getMultiBucketImpactLabel(2.99)).to.be('medium'); - }); - - it('returns low for 1 <= score < 2', () => { - expect(getMultiBucketImpactLabel(1)).to.be('low'); - expect(getMultiBucketImpactLabel(1.99)).to.be('low'); - }); - - it('returns none for -5 <= score < 1', () => { - expect(getMultiBucketImpactLabel(-5)).to.be('none'); - expect(getMultiBucketImpactLabel(0.99)).to.be('none'); - }); - - it('returns expected label when impact outside normal bounds', () => { - expect(getMultiBucketImpactLabel(10)).to.be('high'); - expect(getMultiBucketImpactLabel(-10)).to.be('none'); - }); - }); - - describe('getEntityFieldName', () => { - it('returns the by field name', () => { - expect(getEntityFieldName(byEntityRecord)).to.be('airline'); - }); - - it('returns the partition field name', () => { - expect(getEntityFieldName(partitionEntityRecord)).to.be('airline'); - }); - - it('returns the over field name', () => { - expect(getEntityFieldName(overEntityRecord)).to.be('clientip'); - }); - - it('returns undefined if no by, over or partition fields', () => { - expect(getEntityFieldName(noEntityRecord)).to.be(undefined); - }); - }); - - describe('getEntityFieldValue', () => { - it('returns the by field value', () => { - expect(getEntityFieldValue(byEntityRecord)).to.be('JZA'); - }); - - it('returns the partition field value', () => { - expect(getEntityFieldValue(partitionEntityRecord)).to.be('AAL'); - }); - - it('returns the over field value', () => { - expect(getEntityFieldValue(overEntityRecord)).to.be('37.157.32.164'); - }); - - it('returns undefined if no by, over or partition fields', () => { - expect(getEntityFieldValue(noEntityRecord)).to.be(undefined); - }); - }); - - describe('getEntityFieldList', () => { - it('returns an empty list for a record with no by, over or partition fields', () => { - expect(getEntityFieldList(noEntityRecord)).to.be.empty(); - }); - - it('returns correct list for a record with a by field', () => { - expect(getEntityFieldList(byEntityRecord)).to.eql([ - { - fieldName: 'airline', - fieldValue: 'JZA', - fieldType: 'by', - }, - ]); - }); - - it('returns correct list for a record with a partition field', () => { - expect(getEntityFieldList(partitionEntityRecord)).to.eql([ - { - fieldName: 'airline', - fieldValue: 'AAL', - fieldType: 'partition', - }, - ]); - }); - - it('returns correct list for a record with an over field', () => { - expect(getEntityFieldList(overEntityRecord)).to.eql([ - { - fieldName: 'clientip', - fieldValue: '37.157.32.164', - fieldType: 'over', - }, - ]); - }); - - it('returns correct list for a record with a by and over field', () => { - expect(getEntityFieldList(rareEntityRecord)).to.eql([ - { - fieldName: 'clientip', - fieldValue: '173.252.74.112', - fieldType: 'over', - }, - ]); - }); - }); - - describe('showActualForFunction', () => { - it('returns true for expected function descriptions', () => { - expect(showActualForFunction('count')).to.be(true); - expect(showActualForFunction('distinct_count')).to.be(true); - expect(showActualForFunction('lat_long')).to.be(true); - expect(showActualForFunction('mean')).to.be(true); - expect(showActualForFunction('max')).to.be(true); - expect(showActualForFunction('min')).to.be(true); - expect(showActualForFunction('sum')).to.be(true); - expect(showActualForFunction('median')).to.be(true); - expect(showActualForFunction('varp')).to.be(true); - expect(showActualForFunction('info_content')).to.be(true); - expect(showActualForFunction('time')).to.be(true); - }); - - it('returns false for expected function descriptions', () => { - expect(showActualForFunction('rare')).to.be(false); - }); - }); - - describe('showTypicalForFunction', () => { - it('returns true for expected function descriptions', () => { - expect(showTypicalForFunction('count')).to.be(true); - expect(showTypicalForFunction('distinct_count')).to.be(true); - expect(showTypicalForFunction('lat_long')).to.be(true); - expect(showTypicalForFunction('mean')).to.be(true); - expect(showTypicalForFunction('max')).to.be(true); - expect(showTypicalForFunction('min')).to.be(true); - expect(showTypicalForFunction('sum')).to.be(true); - expect(showTypicalForFunction('median')).to.be(true); - expect(showTypicalForFunction('varp')).to.be(true); - expect(showTypicalForFunction('info_content')).to.be(true); - expect(showTypicalForFunction('time')).to.be(true); - }); - - it('returns false for expected function descriptions', () => { - expect(showTypicalForFunction('rare')).to.be(false); - }); - }); - - describe('isRuleSupported', () => { - it('returns true for anomalies supporting rules', () => { - expect(isRuleSupported(partitionEntityRecord)).to.be(true); - expect(isRuleSupported(byEntityRecord)).to.be(true); - expect(isRuleSupported(overEntityRecord)).to.be(true); - expect(isRuleSupported(rareEntityRecord)).to.be(true); - expect(isRuleSupported(noEntityRecord)).to.be(true); - }); - - it('returns false for anomaly not supporting rules', () => { - expect(isRuleSupported(metricNoEntityRecord)).to.be(false); - }); - }); - - describe('aggregationTypeTransform', () => { - it('returns correct ES aggregation type for ML function description', () => { - expect(aggregationTypeTransform.toES('count')).to.be('count'); - expect(aggregationTypeTransform.toES('distinct_count')).to.be('cardinality'); - expect(aggregationTypeTransform.toES('distinct_count')).to.not.be('distinct_count'); - expect(aggregationTypeTransform.toES('mean')).to.be('avg'); - expect(aggregationTypeTransform.toES('mean')).to.not.be('mean'); - expect(aggregationTypeTransform.toES('max')).to.be('max'); - expect(aggregationTypeTransform.toES('min')).to.be('min'); - expect(aggregationTypeTransform.toES('sum')).to.be('sum'); - }); - - it('returns correct ML function description for ES aggregation type', () => { - expect(aggregationTypeTransform.toML('count')).to.be('count'); - expect(aggregationTypeTransform.toML('cardinality')).to.be('distinct_count'); - expect(aggregationTypeTransform.toML('cardinality')).to.not.be('cardinality'); - expect(aggregationTypeTransform.toML('avg')).to.be('mean'); - expect(aggregationTypeTransform.toML('avg')).to.not.be('avg'); - expect(aggregationTypeTransform.toML('max')).to.be('max'); - expect(aggregationTypeTransform.toML('min')).to.be('min'); - expect(aggregationTypeTransform.toML('sum')).to.be('sum'); - }); - }); -}); diff --git a/x-pack/plugins/ml/common/util/anomaly_utils.d.ts b/x-pack/plugins/ml/common/util/anomaly_utils.d.ts deleted file mode 100644 index adeb6dc7dd5b9..0000000000000 --- a/x-pack/plugins/ml/common/util/anomaly_utils.d.ts +++ /dev/null @@ -1,11 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { ANOMALY_SEVERITY } from '../constants/anomalies'; - -export function getSeverity(normalizedScore: number): string; -export function getSeverityType(normalizedScore: number): ANOMALY_SEVERITY; -export function getSeverityColor(normalizedScore: number): string; diff --git a/x-pack/plugins/ml/common/util/anomaly_utils.test.ts b/x-pack/plugins/ml/common/util/anomaly_utils.test.ts new file mode 100644 index 0000000000000..1343e4611c215 --- /dev/null +++ b/x-pack/plugins/ml/common/util/anomaly_utils.test.ts @@ -0,0 +1,444 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { AnomalyRecordDoc } from '../types/anomalies'; + +import { + aggregationTypeTransform, + getEntityFieldList, + getEntityFieldName, + getEntityFieldValue, + getMultiBucketImpactLabel, + getSeverity, + getSeverityWithLow, + getSeverityColor, + isRuleSupported, + showActualForFunction, + showTypicalForFunction, +} from './anomaly_utils'; + +describe('ML - anomaly utils', () => { + const partitionEntityRecord: AnomalyRecordDoc = { + job_id: 'farequote', + result_type: 'record', + probability: 0.012818, + record_score: 0.0162059, + initial_record_score: 0.0162059, + bucket_span: 300, + detector_index: 0, + is_interim: false, + timestamp: 1455047400000, + partition_field_name: 'airline', + partition_field_value: 'AAL', + function: 'mean', + function_description: 'mean', + field_name: 'responsetime', + }; + + const byEntityRecord: AnomalyRecordDoc = { + job_id: 'farequote', + result_type: 'record', + probability: 0.012818, + record_score: 0.0162059, + initial_record_score: 0.0162059, + bucket_span: 300, + detector_index: 0, + is_interim: false, + timestamp: 1455047400000, + by_field_name: 'airline', + by_field_value: 'JZA', + function: 'mean', + function_description: 'mean', + field_name: 'responsetime', + }; + + const overEntityRecord: AnomalyRecordDoc = { + job_id: 'gallery', + result_type: 'record', + probability: 2.81806e-9, + record_score: 59.055, + initial_record_score: 59.055, + bucket_span: 3600, + detector_index: 4, + is_interim: false, + timestamp: 1420552800000, + function: 'sum', + function_description: 'sum', + field_name: 'bytes', + by_field_name: 'method', + over_field_name: 'clientip', + over_field_value: '37.157.32.164', + }; + + const noEntityRecord: AnomalyRecordDoc = { + job_id: 'farequote_no_by', + result_type: 'record', + probability: 0.0191711, + record_score: 4.38431, + initial_record_score: 19.654, + bucket_span: 300, + detector_index: 0, + is_interim: false, + timestamp: 1454890500000, + function: 'mean', + function_description: 'mean', + field_name: 'responsetime', + }; + + const metricNoEntityRecord: AnomalyRecordDoc = { + job_id: 'farequote_metric', + result_type: 'record', + probability: 0.030133495093182184, + record_score: 0.024881740359975164, + initial_record_score: 0.024881740359975164, + bucket_span: 900, + detector_index: 0, + is_interim: false, + timestamp: 1486845000000, + function: 'metric', + function_description: 'mean', + typical: [545.7764658569108], + actual: [758.8220213274412], + field_name: 'responsetime', + influencers: [ + { + influencer_field_name: 'airline', + influencer_field_values: ['NKS'], + }, + ], + airline: ['NKS'], + }; + + const rareEntityRecord: AnomalyRecordDoc = { + job_id: 'gallery', + result_type: 'record', + probability: 0.02277014211908481, + record_score: 4.545378107075983, + initial_record_score: 4.545378107075983, + bucket_span: 3600, + detector_index: 0, + is_interim: false, + timestamp: 1495879200000, + by_field_name: 'status', + function: 'rare', + function_description: 'rare', + over_field_name: 'clientip', + over_field_value: '173.252.74.112', + causes: [ + { + probability: 0.02277014211908481, + by_field_name: 'status', + by_field_value: '206', + function: 'rare', + function_description: 'rare', + typical: [0.00014832458182211878], + actual: [1], + over_field_name: 'clientip', + over_field_value: '173.252.74.112', + }, + ], + influencers: [ + { + influencer_field_name: 'uri', + influencer_field_values: [ + '/wp-content/uploads/2013/06/dune_house_oil_on_canvas_24x20-298x298.jpg', + '/wp-content/uploads/2013/10/Case-dAste-1-11-298x298.png', + ], + }, + { + influencer_field_name: 'status', + influencer_field_values: ['206'], + }, + { + influencer_field_name: 'clientip', + influencer_field_values: ['173.252.74.112'], + }, + ], + clientip: ['173.252.74.112'], + uri: [ + '/wp-content/uploads/2013/06/dune_house_oil_on_canvas_24x20-298x298.jpg', + '/wp-content/uploads/2013/10/Case-dAste-1-11-298x298.png', + ], + status: ['206'], + }; + + describe('getSeverity', () => { + test('returns warning for 0 <= score < 25', () => { + expect(getSeverity(0).id).toBe('warning'); + expect(getSeverity(0.001).id).toBe('warning'); + expect(getSeverity(24.99).id).toBe('warning'); + }); + + test('returns minor for 25 <= score < 50', () => { + expect(getSeverity(25).id).toBe('minor'); + expect(getSeverity(49.99).id).toBe('minor'); + }); + + test('returns minor for 50 <= score < 75', () => { + expect(getSeverity(50).id).toBe('major'); + expect(getSeverity(74.99).id).toBe('major'); + }); + + test('returns critical for score >= 75', () => { + expect(getSeverity(75).id).toBe('critical'); + expect(getSeverity(100).id).toBe('critical'); + expect(getSeverity(1000).id).toBe('critical'); + }); + + test('returns unknown for scores less than 0', () => { + expect(getSeverity(-10).id).toBe('unknown'); + }); + }); + + describe('getSeverityWithLow', () => { + test('returns low for 0 <= score < 3', () => { + expect(getSeverityWithLow(0).id).toBe('low'); + expect(getSeverityWithLow(0.001).id).toBe('low'); + expect(getSeverityWithLow(2.99).id).toBe('low'); + }); + + test('returns warning for 3 <= score < 25', () => { + expect(getSeverityWithLow(3).id).toBe('warning'); + expect(getSeverityWithLow(24.99).id).toBe('warning'); + }); + + test('returns minor for 25 <= score < 50', () => { + expect(getSeverityWithLow(25).id).toBe('minor'); + expect(getSeverityWithLow(49.99).id).toBe('minor'); + }); + + test('returns minor for 50 <= score < 75', () => { + expect(getSeverityWithLow(50).id).toBe('major'); + expect(getSeverityWithLow(74.99).id).toBe('major'); + }); + + test('returns critical for score >= 75', () => { + expect(getSeverityWithLow(75).id).toBe('critical'); + expect(getSeverityWithLow(100).id).toBe('critical'); + expect(getSeverityWithLow(1000).id).toBe('critical'); + }); + + test('returns unknown for scores less than 0 ', () => { + expect(getSeverityWithLow(-10).id).toBe('unknown'); + }); + }); + + describe('getSeverityColor', () => { + test('returns correct hex code for low for 0 <= score < 3', () => { + expect(getSeverityColor(0)).toBe('#d2e9f7'); + expect(getSeverityColor(0.001)).toBe('#d2e9f7'); + expect(getSeverityColor(2.99)).toBe('#d2e9f7'); + }); + + test('returns correct hex code for warning for 3 <= score < 25', () => { + expect(getSeverityColor(3)).toBe('#8bc8fb'); + expect(getSeverityColor(24.99)).toBe('#8bc8fb'); + }); + + test('returns correct hex code for minor for 25 <= score < 50', () => { + expect(getSeverityColor(25)).toBe('#fdec25'); + expect(getSeverityColor(49.99)).toBe('#fdec25'); + }); + + test('returns correct hex code for major for 50 <= score < 75', () => { + expect(getSeverityColor(50)).toBe('#fba740'); + expect(getSeverityColor(74.99)).toBe('#fba740'); + }); + + test('returns correct hex code for critical for score >= 75', () => { + expect(getSeverityColor(75)).toBe('#fe5050'); + expect(getSeverityColor(100)).toBe('#fe5050'); + expect(getSeverityColor(1000)).toBe('#fe5050'); + }); + + test('returns correct hex code for unknown for scores less than 0', () => { + expect(getSeverityColor(-10)).toBe('#ffffff'); + }); + }); + + describe('getMultiBucketImpactLabel', () => { + test('returns high for 3 <= score <= 5', () => { + expect(getMultiBucketImpactLabel(3)).toBe('high'); + expect(getMultiBucketImpactLabel(5)).toBe('high'); + }); + + test('returns medium for 2 <= score < 3', () => { + expect(getMultiBucketImpactLabel(2)).toBe('medium'); + expect(getMultiBucketImpactLabel(2.99)).toBe('medium'); + }); + + test('returns low for 1 <= score < 2', () => { + expect(getMultiBucketImpactLabel(1)).toBe('low'); + expect(getMultiBucketImpactLabel(1.99)).toBe('low'); + }); + + test('returns none for -5 <= score < 1', () => { + expect(getMultiBucketImpactLabel(-5)).toBe('none'); + expect(getMultiBucketImpactLabel(0.99)).toBe('none'); + }); + + test('returns expected label when impact outside normal bounds', () => { + expect(getMultiBucketImpactLabel(10)).toBe('high'); + expect(getMultiBucketImpactLabel(-10)).toBe('none'); + }); + }); + + describe('getEntityFieldName', () => { + it('returns the by field name', () => { + expect(getEntityFieldName(byEntityRecord)).toBe('airline'); + }); + + it('returns the partition field name', () => { + expect(getEntityFieldName(partitionEntityRecord)).toBe('airline'); + }); + + it('returns the over field name', () => { + expect(getEntityFieldName(overEntityRecord)).toBe('clientip'); + }); + + it('returns undefined if no by, over or partition fields', () => { + expect(getEntityFieldName(noEntityRecord)).toBe(undefined); + }); + }); + + describe('getEntityFieldValue', () => { + test('returns the by field value', () => { + expect(getEntityFieldValue(byEntityRecord)).toBe('JZA'); + }); + + test('returns the partition field value', () => { + expect(getEntityFieldValue(partitionEntityRecord)).toBe('AAL'); + }); + + test('returns the over field value', () => { + expect(getEntityFieldValue(overEntityRecord)).toBe('37.157.32.164'); + }); + + test('returns undefined if no by, over or partition fields', () => { + expect(getEntityFieldValue(noEntityRecord)).toBe(undefined); + }); + }); + + describe('getEntityFieldList', () => { + test('returns an empty list for a record with no by, over or partition fields', () => { + expect(getEntityFieldList(noEntityRecord)).toHaveLength(0); + }); + + test('returns correct list for a record with a by field', () => { + expect(getEntityFieldList(byEntityRecord)).toEqual([ + { + fieldName: 'airline', + fieldValue: 'JZA', + fieldType: 'by', + }, + ]); + }); + + test('returns correct list for a record with a partition field', () => { + expect(getEntityFieldList(partitionEntityRecord)).toEqual([ + { + fieldName: 'airline', + fieldValue: 'AAL', + fieldType: 'partition', + }, + ]); + }); + + test('returns correct list for a record with an over field', () => { + expect(getEntityFieldList(overEntityRecord)).toEqual([ + { + fieldName: 'clientip', + fieldValue: '37.157.32.164', + fieldType: 'over', + }, + ]); + }); + + test('returns correct list for a record with a by and over field', () => { + expect(getEntityFieldList(rareEntityRecord)).toEqual([ + { + fieldName: 'clientip', + fieldValue: '173.252.74.112', + fieldType: 'over', + }, + ]); + }); + }); + + describe('showActualForFunction', () => { + test('returns true for expected function descriptions', () => { + expect(showActualForFunction('count')).toBe(true); + expect(showActualForFunction('distinct_count')).toBe(true); + expect(showActualForFunction('lat_long')).toBe(true); + expect(showActualForFunction('mean')).toBe(true); + expect(showActualForFunction('max')).toBe(true); + expect(showActualForFunction('min')).toBe(true); + expect(showActualForFunction('sum')).toBe(true); + expect(showActualForFunction('median')).toBe(true); + expect(showActualForFunction('varp')).toBe(true); + expect(showActualForFunction('info_content')).toBe(true); + expect(showActualForFunction('time')).toBe(true); + }); + + test('returns false for expected function descriptions', () => { + expect(showActualForFunction('rare')).toBe(false); + }); + }); + + describe('showTypicalForFunction', () => { + test('returns true for expected function descriptions', () => { + expect(showTypicalForFunction('count')).toBe(true); + expect(showTypicalForFunction('distinct_count')).toBe(true); + expect(showTypicalForFunction('lat_long')).toBe(true); + expect(showTypicalForFunction('mean')).toBe(true); + expect(showTypicalForFunction('max')).toBe(true); + expect(showTypicalForFunction('min')).toBe(true); + expect(showTypicalForFunction('sum')).toBe(true); + expect(showTypicalForFunction('median')).toBe(true); + expect(showTypicalForFunction('varp')).toBe(true); + expect(showTypicalForFunction('info_content')).toBe(true); + expect(showTypicalForFunction('time')).toBe(true); + }); + + test('returns false for expected function descriptions', () => { + expect(showTypicalForFunction('rare')).toBe(false); + }); + }); + + describe('isRuleSupported', () => { + test('returns true for anomalies supporting rules', () => { + expect(isRuleSupported(partitionEntityRecord)).toBe(true); + expect(isRuleSupported(byEntityRecord)).toBe(true); + expect(isRuleSupported(overEntityRecord)).toBe(true); + expect(isRuleSupported(rareEntityRecord)).toBe(true); + expect(isRuleSupported(noEntityRecord)).toBe(true); + }); + + it('returns false for anomaly not supporting rules', () => { + expect(isRuleSupported(metricNoEntityRecord)).toBe(false); + }); + }); + + describe('aggregationTypeTransform', () => { + test('returns correct ES aggregation type for ML function description', () => { + expect(aggregationTypeTransform.toES('count')).toBe('count'); + expect(aggregationTypeTransform.toES('distinct_count')).toBe('cardinality'); + expect(aggregationTypeTransform.toES('mean')).toBe('avg'); + expect(aggregationTypeTransform.toES('max')).toBe('max'); + expect(aggregationTypeTransform.toES('min')).toBe('min'); + expect(aggregationTypeTransform.toES('sum')).toBe('sum'); + }); + + test('returns correct ML function description for ES aggregation type', () => { + expect(aggregationTypeTransform.toML('count')).toBe('count'); + expect(aggregationTypeTransform.toML('cardinality')).toBe('distinct_count'); + expect(aggregationTypeTransform.toML('avg')).toBe('mean'); + expect(aggregationTypeTransform.toML('max')).toBe('max'); + expect(aggregationTypeTransform.toML('min')).toBe('min'); + expect(aggregationTypeTransform.toML('sum')).toBe('sum'); + }); + }); +}); diff --git a/x-pack/plugins/ml/common/util/anomaly_utils.js b/x-pack/plugins/ml/common/util/anomaly_utils.ts similarity index 87% rename from x-pack/plugins/ml/common/util/anomaly_utils.js rename to x-pack/plugins/ml/common/util/anomaly_utils.ts index 16c27b6af869d..36b91f5580b39 100644 --- a/x-pack/plugins/ml/common/util/anomaly_utils.js +++ b/x-pack/plugins/ml/common/util/anomaly_utils.ts @@ -13,6 +13,24 @@ import { i18n } from '@kbn/i18n'; import { CONDITIONS_NOT_SUPPORTED_FUNCTIONS } from '../constants/detector_rule'; import { MULTI_BUCKET_IMPACT } from '../constants/multi_bucket_impact'; import { ANOMALY_SEVERITY, ANOMALY_THRESHOLD } from '../constants/anomalies'; +import { AnomalyRecordDoc } from '../types/anomalies'; + +export interface SeverityType { + id: ANOMALY_SEVERITY; + label: string; +} + +export enum ENTITY_FIELD_TYPE { + BY = 'by', + OVER = 'over', + PARTITON = 'partition', +} + +export interface EntityField { + fieldName: string; + fieldValue: string | number | undefined; + fieldType: ENTITY_FIELD_TYPE; +} // List of function descriptions for which actual values from record level results should be displayed. const DISPLAY_ACTUAL_FUNCTIONS = [ @@ -44,7 +62,7 @@ const DISPLAY_TYPICAL_FUNCTIONS = [ 'time', ]; -let severityTypes; +let severityTypes: Record<string, SeverityType>; function getSeverityTypes() { if (severityTypes) { @@ -93,7 +111,7 @@ function getSeverityTypes() { // Returns a severity label (one of critical, major, minor, warning or unknown) // for the supplied normalized anomaly score (a value between 0 and 100). -export function getSeverity(normalizedScore) { +export function getSeverity(normalizedScore: number): SeverityType { const severityTypesList = getSeverityTypes(); if (normalizedScore >= ANOMALY_THRESHOLD.CRITICAL) { @@ -109,7 +127,7 @@ export function getSeverity(normalizedScore) { } } -export function getSeverityType(normalizedScore) { +export function getSeverityType(normalizedScore: number): ANOMALY_SEVERITY { if (normalizedScore >= 75) { return ANOMALY_SEVERITY.CRITICAL; } else if (normalizedScore >= 50) { @@ -128,7 +146,7 @@ export function getSeverityType(normalizedScore) { // Returns a severity label (one of critical, major, minor, warning, low or unknown) // for the supplied normalized anomaly score (a value between 0 and 100), where scores // less than 3 are assigned a severity of 'low'. -export function getSeverityWithLow(normalizedScore) { +export function getSeverityWithLow(normalizedScore: number): SeverityType { const severityTypesList = getSeverityTypes(); if (normalizedScore >= ANOMALY_THRESHOLD.CRITICAL) { @@ -148,7 +166,7 @@ export function getSeverityWithLow(normalizedScore) { // Returns a severity RGB color (one of critical, major, minor, warning, low_warning or unknown) // for the supplied normalized anomaly score (a value between 0 and 100). -export function getSeverityColor(normalizedScore) { +export function getSeverityColor(normalizedScore: number): string { if (normalizedScore >= ANOMALY_THRESHOLD.CRITICAL) { return '#fe5050'; } else if (normalizedScore >= ANOMALY_THRESHOLD.MAJOR) { @@ -167,7 +185,7 @@ export function getSeverityColor(normalizedScore) { // Returns a label to use for the multi-bucket impact of an anomaly // according to the value of the multi_bucket_impact field of a record, // which ranges from -5 to +5. -export function getMultiBucketImpactLabel(multiBucketImpact) { +export function getMultiBucketImpactLabel(multiBucketImpact: number): string { if (multiBucketImpact >= MULTI_BUCKET_IMPACT.HIGH) { return i18n.translate('xpack.ml.anomalyUtils.multiBucketImpact.highLabel', { defaultMessage: 'high', @@ -190,7 +208,7 @@ export function getMultiBucketImpactLabel(multiBucketImpact) { // Returns the name of the field to use as the entity name from the source record // obtained from Elasticsearch. The function looks first for a by_field, then over_field, // then partition_field, returning undefined if none of these fields are present. -export function getEntityFieldName(record) { +export function getEntityFieldName(record: AnomalyRecordDoc): string | undefined { // Analyses with by and over fields, will have a top-level by_field_name, but // the by_field_value(s) will be in the nested causes array. if (record.by_field_name !== undefined && record.by_field_value !== undefined) { @@ -211,7 +229,7 @@ export function getEntityFieldName(record) { // Returns the value of the field to use as the entity value from the source record // obtained from Elasticsearch. The function looks first for a by_field, then over_field, // then partition_field, returning undefined if none of these fields are present. -export function getEntityFieldValue(record) { +export function getEntityFieldValue(record: AnomalyRecordDoc): string | number | undefined { if (record.by_field_value !== undefined) { return record.by_field_value; } @@ -229,13 +247,13 @@ export function getEntityFieldValue(record) { // Returns the list of partitioning entity fields for the source record as a list // of objects in the form { fieldName: airline, fieldValue: AAL, fieldType: partition } -export function getEntityFieldList(record) { - const entityFields = []; +export function getEntityFieldList(record: AnomalyRecordDoc): EntityField[] { + const entityFields: EntityField[] = []; if (record.partition_field_name !== undefined) { entityFields.push({ fieldName: record.partition_field_name, fieldValue: record.partition_field_value, - fieldType: 'partition', + fieldType: ENTITY_FIELD_TYPE.PARTITON, }); } @@ -243,7 +261,7 @@ export function getEntityFieldList(record) { entityFields.push({ fieldName: record.over_field_name, fieldValue: record.over_field_value, - fieldType: 'over', + fieldType: ENTITY_FIELD_TYPE.OVER, }); } @@ -254,7 +272,7 @@ export function getEntityFieldList(record) { entityFields.push({ fieldName: record.by_field_name, fieldValue: record.by_field_value, - fieldType: 'by', + fieldType: ENTITY_FIELD_TYPE.BY, }); } @@ -264,19 +282,19 @@ export function getEntityFieldList(record) { // Returns whether actual values should be displayed for a record with the specified function description. // Note that the 'function' field in a record contains what the user entered e.g. 'high_count', // whereas the 'function_description' field holds a ML-built display hint for function e.g. 'count'. -export function showActualForFunction(functionDescription) { +export function showActualForFunction(functionDescription: string): boolean { return DISPLAY_ACTUAL_FUNCTIONS.indexOf(functionDescription) > -1; } // Returns whether typical values should be displayed for a record with the specified function description. // Note that the 'function' field in a record contains what the user entered e.g. 'high_count', // whereas the 'function_description' field holds a ML-built display hint for function e.g. 'count'. -export function showTypicalForFunction(functionDescription) { +export function showTypicalForFunction(functionDescription: string): boolean { return DISPLAY_TYPICAL_FUNCTIONS.indexOf(functionDescription) > -1; } // Returns whether a rule can be configured against the specified anomaly. -export function isRuleSupported(record) { +export function isRuleSupported(record: AnomalyRecordDoc): boolean { // A rule can be configured with a numeric condition if the function supports it, // and/or with scope if there is a partitioning fields. return ( @@ -303,7 +321,7 @@ export function isRuleSupported(record) { // The input to toES and the output from toML correspond to the value of the // function_description field of anomaly records. export const aggregationTypeTransform = { - toES: function(oldAggType) { + toES(oldAggType: string): string { let newAggType = oldAggType; if (newAggType === 'mean') { @@ -316,7 +334,7 @@ export const aggregationTypeTransform = { return newAggType; }, - toML: function(oldAggType) { + toML(oldAggType: string): string { let newAggType = oldAggType; if (newAggType === 'avg') { diff --git a/x-pack/plugins/ml/public/application/components/rule_editor/__tests__/utils.js b/x-pack/plugins/ml/public/application/components/rule_editor/utils.test.js similarity index 66% rename from x-pack/plugins/ml/public/application/components/rule_editor/__tests__/utils.js rename to x-pack/plugins/ml/public/application/components/rule_editor/utils.test.js index b5f9bdeaa12aa..18e382f8fe5e8 100644 --- a/x-pack/plugins/ml/public/application/components/rule_editor/__tests__/utils.js +++ b/x-pack/plugins/ml/public/application/components/rule_editor/utils.test.js @@ -4,14 +4,13 @@ * you may not use this file except in compliance with the Elastic License. */ -import expect from '@kbn/expect'; -import { isValidRule, buildRuleDescription, getAppliesToValueFromAnomaly } from '../utils'; +import { isValidRule, buildRuleDescription, getAppliesToValueFromAnomaly } from './utils'; import { ACTION, APPLIES_TO, OPERATOR, FILTER_TYPE, -} from '../../../../../common/constants/detector_rule'; +} from '../../../../common/constants/detector_rule'; describe('ML - rule editor utils', () => { const ruleWithCondition = { @@ -55,19 +54,19 @@ describe('ML - rule editor utils', () => { }; describe('isValidRule', () => { - it('returns true for a rule with an action and a condition', () => { - expect(isValidRule(ruleWithCondition)).to.be(true); + test('returns true for a rule with an action and a condition', () => { + expect(isValidRule(ruleWithCondition)).toBe(true); }); - it('returns true for a rule with an action and scope', () => { - expect(isValidRule(ruleWithScope)).to.be(true); + test('returns true for a rule with an action and scope', () => { + expect(isValidRule(ruleWithScope)).toBe(true); }); - it('returns true for a rule with an action, scope and condition', () => { - expect(isValidRule(ruleWithConditionAndScope)).to.be(true); + test('returns true for a rule with an action, scope and condition', () => { + expect(isValidRule(ruleWithConditionAndScope)).toBe(true); }); - it('returns false for a rule with no action', () => { + test('returns false for a rule with no action', () => { const ruleWithNoAction = { actions: [], conditions: [ @@ -79,27 +78,27 @@ describe('ML - rule editor utils', () => { ], }; - expect(isValidRule(ruleWithNoAction)).to.be(false); + expect(isValidRule(ruleWithNoAction)).toBe(false); }); - it('returns false for a rule with no scope or conditions', () => { + test('returns false for a rule with no scope or conditions', () => { const ruleWithNoScopeOrCondition = { actions: [ACTION.SKIP_RESULT], }; - expect(isValidRule(ruleWithNoScopeOrCondition)).to.be(false); + expect(isValidRule(ruleWithNoScopeOrCondition)).toBe(false); }); }); describe('buildRuleDescription', () => { - it('returns expected rule descriptions', () => { - expect(buildRuleDescription(ruleWithCondition)).to.be( + test('returns expected rule descriptions', () => { + expect(buildRuleDescription(ruleWithCondition)).toBe( 'skip result when actual is greater than 10' ); - expect(buildRuleDescription(ruleWithScope)).to.be( + expect(buildRuleDescription(ruleWithScope)).toBe( 'skip result when instance is in test_aws_instances' ); - expect(buildRuleDescription(ruleWithConditionAndScope)).to.be( + expect(buildRuleDescription(ruleWithConditionAndScope)).toBe( 'skip result when typical is less than 100 AND instance is not in test_aws_instances' ); }); @@ -111,16 +110,16 @@ describe('ML - rule editor utils', () => { typical: [1.23], }; - it('returns expected actual value from an anomaly', () => { - expect(getAppliesToValueFromAnomaly(anomaly, APPLIES_TO.ACTUAL)).to.be(210); + test('returns expected actual value from an anomaly', () => { + expect(getAppliesToValueFromAnomaly(anomaly, APPLIES_TO.ACTUAL)).toBe(210); }); - it('returns expected typical value from an anomaly', () => { - expect(getAppliesToValueFromAnomaly(anomaly, APPLIES_TO.TYPICAL)).to.be(1.23); + test('returns expected typical value from an anomaly', () => { + expect(getAppliesToValueFromAnomaly(anomaly, APPLIES_TO.TYPICAL)).toBe(1.23); }); - it('returns expected diff from typical value from an anomaly', () => { - expect(getAppliesToValueFromAnomaly(anomaly, APPLIES_TO.DIFF_FROM_TYPICAL)).to.be(208.77); + test('returns expected diff from typical value from an anomaly', () => { + expect(getAppliesToValueFromAnomaly(anomaly, APPLIES_TO.DIFF_FROM_TYPICAL)).toBe(208.77); }); }); }); diff --git a/x-pack/plugins/ml/public/application/util/__tests__/calc_auto_interval.js b/x-pack/plugins/ml/public/application/util/__tests__/calc_auto_interval.js deleted file mode 100644 index 0553cec5cd7d4..0000000000000 --- a/x-pack/plugins/ml/public/application/util/__tests__/calc_auto_interval.js +++ /dev/null @@ -1,140 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import moment from 'moment'; - -import { timeBucketsCalcAutoIntervalProvider } from '../calc_auto_interval'; - -describe('ML - calc auto intervals', () => { - const calcAuto = timeBucketsCalcAutoIntervalProvider(); - - describe('near interval', () => { - it('returns 0ms buckets for undefined / 0 bars', () => { - const interval = calcAuto.near(0, undefined); - expect(interval.asMilliseconds()).to.be(0); - }); - - it('returns 1000ms buckets for 60s / 100 bars', () => { - const interval = calcAuto.near(100, moment.duration(60, 's')); - expect(interval.asMilliseconds()).to.be(1000); - }); - - it('returns 5m buckets for 8h / 100 bars', () => { - const interval = calcAuto.near(100, moment.duration(8, 'h')); - expect(interval.asMinutes()).to.be(5); - }); - - it('returns 15m buckets for 1d / 100 bars', () => { - const interval = calcAuto.near(100, moment.duration(1, 'd')); - expect(interval.asMinutes()).to.be(15); - }); - - it('returns 1h buckets for 20d / 500 bars', () => { - const interval = calcAuto.near(500, moment.duration(20, 'd')); - expect(interval.asHours()).to.be(1); - }); - - it('returns 6h buckets for 100d / 500 bars', () => { - const interval = calcAuto.near(500, moment.duration(100, 'd')); - expect(interval.asHours()).to.be(6); - }); - - it('returns 24h buckets for 1y / 500 bars', () => { - const interval = calcAuto.near(500, moment.duration(1, 'y')); - expect(interval.asHours()).to.be(24); - }); - - it('returns 12h buckets for 1y / 1000 bars', () => { - const interval = calcAuto.near(1000, moment.duration(1, 'y')); - expect(interval.asHours()).to.be(12); - }); - }); - - describe('lessThan interval', () => { - it('returns 0ms buckets for undefined / 0 bars', () => { - const interval = calcAuto.lessThan(0, undefined); - expect(interval.asMilliseconds()).to.be(0); - }); - - it('returns 500ms buckets for 60s / 100 bars', () => { - const interval = calcAuto.lessThan(100, moment.duration(60, 's')); - expect(interval.asMilliseconds()).to.be(500); - }); - - it('returns 5m buckets for 8h / 100 bars', () => { - const interval = calcAuto.lessThan(100, moment.duration(8, 'h')); - expect(interval.asMinutes()).to.be(5); - }); - - it('returns 30m buckets for 1d / 100 bars', () => { - const interval = calcAuto.lessThan(100, moment.duration(1, 'd')); - expect(interval.asMinutes()).to.be(30); - }); - - it('returns 1h buckets for 20d / 500 bars', () => { - const interval = calcAuto.lessThan(500, moment.duration(20, 'd')); - expect(interval.asHours()).to.be(1); - }); - - it('returns 6h buckets for 100d / 500 bars', () => { - const interval = calcAuto.lessThan(500, moment.duration(100, 'd')); - expect(interval.asHours()).to.be(6); - }); - - it('returns 24h buckets for 1y / 500 bars', () => { - const interval = calcAuto.lessThan(500, moment.duration(1, 'y')); - expect(interval.asHours()).to.be(24); - }); - - it('returns 12h buckets for 1y / 1000 bars', () => { - const interval = calcAuto.lessThan(1000, moment.duration(1, 'y')); - expect(interval.asHours()).to.be(12); - }); - }); - - describe('atLeast interval', () => { - it('returns 0ms buckets for undefined / 0 bars', () => { - const interval = calcAuto.atLeast(0, undefined); - expect(interval.asMilliseconds()).to.be(0); - }); - - it('returns 100ms buckets for 60s / 100 bars', () => { - const interval = calcAuto.atLeast(100, moment.duration(60, 's')); - expect(interval.asMilliseconds()).to.be(100); - }); - - it('returns 1m buckets for 8h / 100 bars', () => { - const interval = calcAuto.atLeast(100, moment.duration(8, 'h')); - expect(interval.asMinutes()).to.be(1); - }); - - it('returns 10m buckets for 1d / 100 bars', () => { - const interval = calcAuto.atLeast(100, moment.duration(1, 'd')); - expect(interval.asMinutes()).to.be(10); - }); - - it('returns 30m buckets for 20d / 500 bars', () => { - const interval = calcAuto.atLeast(500, moment.duration(20, 'd')); - expect(interval.asMinutes()).to.be(30); - }); - - it('returns 4h buckets for 100d / 500 bars', () => { - const interval = calcAuto.atLeast(500, moment.duration(100, 'd')); - expect(interval.asHours()).to.be(4); - }); - - it('returns 12h buckets for 1y / 500 bars', () => { - const interval = calcAuto.atLeast(500, moment.duration(1, 'y')); - expect(interval.asHours()).to.be(12); - }); - - it('returns 8h buckets for 1y / 1000 bars', () => { - const interval = calcAuto.atLeast(1000, moment.duration(1, 'y')); - expect(interval.asHours()).to.be(8); - }); - }); -}); diff --git a/x-pack/plugins/ml/public/application/util/__tests__/chart_utils.js b/x-pack/plugins/ml/public/application/util/__tests__/chart_utils.js deleted file mode 100644 index 89df5946abe76..0000000000000 --- a/x-pack/plugins/ml/public/application/util/__tests__/chart_utils.js +++ /dev/null @@ -1,297 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import $ from 'jquery'; -import d3 from 'd3'; -import expect from '@kbn/expect'; -import { - chartLimits, - filterAxisLabels, - getChartType, - numTicks, - showMultiBucketAnomalyMarker, - showMultiBucketAnomalyTooltip, -} from '../chart_utils'; -import { MULTI_BUCKET_IMPACT } from '../../../../common/constants/multi_bucket_impact'; -import { CHART_TYPE } from '../../explorer/explorer_constants'; - -describe('ML - chart utils', () => { - describe('chartLimits', () => { - it('returns NaN when called without data', () => { - const limits = chartLimits(); - expect(limits.min).to.be.NaN; - expect(limits.max).to.be.NaN; - }); - - it('returns {max: 625736376, min: 201039318} for some test data', () => { - const data = [ - { - date: new Date('2017-02-23T08:00:00.000Z'), - value: 228243469, - anomalyScore: 63.32916, - numberOfCauses: 1, - actual: [228243469], - typical: [133107.7703441773], - }, - { date: new Date('2017-02-23T09:00:00.000Z'), value: null }, - { date: new Date('2017-02-23T10:00:00.000Z'), value: null }, - { date: new Date('2017-02-23T11:00:00.000Z'), value: null }, - { - date: new Date('2017-02-23T12:00:00.000Z'), - value: 625736376, - anomalyScore: 97.32085, - numberOfCauses: 1, - actual: [625736376], - typical: [132830.424736973], - }, - { - date: new Date('2017-02-23T13:00:00.000Z'), - value: 201039318, - anomalyScore: 59.83488, - numberOfCauses: 1, - actual: [201039318], - typical: [132739.5267403542], - }, - ]; - - const limits = chartLimits(data); - - // {max: 625736376, min: 201039318} - expect(limits.min).to.be(201039318); - expect(limits.max).to.be(625736376); - }); - - it("adds 5% padding when min/max are the same, e.g. when there's only one data point", () => { - const data = [ - { - date: new Date('2017-02-23T08:00:00.000Z'), - value: 100, - anomalyScore: 50, - numberOfCauses: 1, - actual: [100], - typical: [100], - }, - ]; - - const limits = chartLimits(data); - expect(limits.min).to.be(95); - expect(limits.max).to.be(105); - }); - - it('returns minimum of 0 when data includes an anomaly for missing data', () => { - const data = [ - { date: new Date('2017-02-23T09:00:00.000Z'), value: 22.2 }, - { date: new Date('2017-02-23T10:00:00.000Z'), value: 23.3 }, - { date: new Date('2017-02-23T11:00:00.000Z'), value: 24.4 }, - { - date: new Date('2017-02-23T12:00:00.000Z'), - value: null, - anomalyScore: 97.32085, - actual: [0], - typical: [22.2], - }, - { date: new Date('2017-02-23T13:00:00.000Z'), value: 21.3 }, - { date: new Date('2017-02-23T14:00:00.000Z'), value: 21.2 }, - { date: new Date('2017-02-23T15:00:00.000Z'), value: 21.1 }, - ]; - - const limits = chartLimits(data); - expect(limits.min).to.be(0); - expect(limits.max).to.be(24.4); - }); - }); - - describe('filterAxisLabels', () => { - it('throws an error when called without arguments', () => { - expect(() => filterAxisLabels()).to.throwError(); - }); - - it('filters axis labels', () => { - // this provides a dummy structure of axis labels. - // the first one should always be filtered because it overflows on the - // left side of the axis. the last one should be filtered based on the - // given width parameter when doing the test calls. - $('body').append(` - <svg id="filterAxisLabels"> - <g class="x axis"> - <g class="tick" transform="translate(5,0)"> - <text dy=".71em" y="10" x="0" style="text-anchor: middle;">06:00</text> - </g> - <g class="tick" transform="translate(187.24137931034485,0)"> - <text dy=".71em" y="10" x="0" style="text-anchor: middle;">12:00</text> - </g> - <g class="tick" transform="translate(486.82758620689657,0)"> - <text dy=".71em" y="10" x="0" style="text-anchor: middle;">18:00</text> - </g> - <g class="tick" transform="translate(786.4137931034483,0)"> - <text dy=".71em" y="10" x="0" style="text-anchor: middle;">00:00</text> - </g> - </g> - </svg> - `); - - const selector = '#filterAxisLabels .x.axis'; - - // given this width, the last tick should not be removed - filterAxisLabels(d3.selectAll(selector), 1000); - expect(d3.selectAll(selector + ' .tick text').size()).to.be(3); - - // given this width, the last tick should be removed - filterAxisLabels(d3.selectAll(selector), 790); - expect(d3.selectAll(selector + ' .tick text').size()).to.be(2); - - // clean up - $('#filterAxisLabels').remove(); - }); - }); - - describe('getChartType', () => { - const singleMetricConfig = { - metricFunction: 'avg', - functionDescription: 'mean', - fieldName: 'responsetime', - entityFields: [], - }; - - const multiMetricConfig = { - metricFunction: 'avg', - functionDescription: 'mean', - fieldName: 'responsetime', - entityFields: [ - { - fieldName: 'airline', - fieldValue: 'AAL', - fieldType: 'partition', - }, - ], - }; - - const populationConfig = { - metricFunction: 'avg', - functionDescription: 'mean', - fieldName: 'http.response.body.bytes', - entityFields: [ - { - fieldName: 'source.ip', - fieldValue: '10.11.12.13', - fieldType: 'over', - }, - ], - }; - - const rareConfig = { - metricFunction: 'count', - functionDescription: 'rare', - entityFields: [ - { - fieldName: 'http.response.status_code', - fieldValue: '404', - fieldType: 'by', - }, - ], - }; - - const varpModelPlotConfig = { - metricFunction: null, - functionDescription: 'varp', - fieldName: 'NetworkOut', - entityFields: [ - { - fieldName: 'instance', - fieldValue: 'i-ef74d410', - fieldType: 'over', - }, - ], - }; - - const overScriptFieldModelPlotConfig = { - metricFunction: 'count', - functionDescription: 'count', - fieldName: 'highest_registered_domain', - entityFields: [ - { - fieldName: 'highest_registered_domain', - fieldValue: 'elastic.co', - fieldType: 'over', - }, - ], - datafeedConfig: { - script_fields: { - highest_registered_domain: { - script: { - source: "return domainSplit(doc['query'].value, params).get(1);", - lang: 'painless', - }, - ignore_failure: false, - }, - }, - }, - }; - - it('returns single metric chart type as expected for configs', () => { - expect(getChartType(singleMetricConfig)).to.be(CHART_TYPE.SINGLE_METRIC); - expect(getChartType(multiMetricConfig)).to.be(CHART_TYPE.SINGLE_METRIC); - expect(getChartType(varpModelPlotConfig)).to.be(CHART_TYPE.SINGLE_METRIC); - expect(getChartType(overScriptFieldModelPlotConfig)).to.be(CHART_TYPE.SINGLE_METRIC); - }); - - it('returns event distribution chart type as expected for configs', () => { - expect(getChartType(rareConfig)).to.be(CHART_TYPE.EVENT_DISTRIBUTION); - }); - - it('returns population distribution chart type as expected for configs', () => { - expect(getChartType(populationConfig)).to.be(CHART_TYPE.POPULATION_DISTRIBUTION); - }); - }); - - describe('numTicks', () => { - it('returns 10 for 1000', () => { - expect(numTicks(1000)).to.be(10); - }); - }); - - describe('showMultiBucketAnomalyMarker', () => { - it('returns true for points with multiBucketImpact at or above medium impact', () => { - expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.HIGH })).to.be( - true - ); - expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.MEDIUM })).to.be( - true - ); - }); - - it('returns false for points with multiBucketImpact missing or below medium impact', () => { - expect(showMultiBucketAnomalyMarker({})).to.be(false); - expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.LOW })).to.be( - false - ); - expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.NONE })).to.be( - false - ); - }); - }); - - describe('showMultiBucketAnomalyTooltip', () => { - it('returns true for points with multiBucketImpact at or above low impact', () => { - expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.HIGH })).to.be( - true - ); - expect( - showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.MEDIUM }) - ).to.be(true); - expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.LOW })).to.be( - true - ); - }); - - it('returns false for points with multiBucketImpact missing or below medium impact', () => { - expect(showMultiBucketAnomalyTooltip({})).to.be(false); - expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.NONE })).to.be( - false - ); - }); - }); -}); diff --git a/x-pack/plugins/ml/public/application/util/__tests__/string_utils.js b/x-pack/plugins/ml/public/application/util/__tests__/string_utils.js deleted file mode 100644 index 702e9dfd96205..0000000000000 --- a/x-pack/plugins/ml/public/application/util/__tests__/string_utils.js +++ /dev/null @@ -1,229 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import expect from '@kbn/expect'; -import { - replaceStringTokens, - detectorToString, - sortByKey, - guessTimeFormat, - toLocaleString, - mlEscape, - escapeForElasticsearchQuery, -} from '../string_utils'; - -describe('ML - string utils', () => { - describe('replaceStringTokens', () => { - const testRecord = { - job_id: 'test_job', - result_type: 'record', - probability: 0.0191711, - record_score: 4.3, - bucket_span: 300, - detector_index: 0, - timestamp: 1454890500000, - function: 'mean', - function_description: 'mean', - field_name: 'responsetime', - user: "Des O'Connor", - testfield1: 'test$tring=[+-?]', - testfield2: '{<()>}', - testfield3: 'host=\\\\test@uk.dev', - }; - - it('returns correct values without URI encoding', () => { - const result = replaceStringTokens('user=$user$,time=$timestamp$', testRecord, false); - expect(result).to.be("user=Des O'Connor,time=1454890500000"); - }); - - it('returns correct values for missing token without URI encoding', () => { - const result = replaceStringTokens('user=$username$,time=$timestamp$', testRecord, false); - expect(result).to.be('user=$username$,time=1454890500000'); - }); - - it('returns correct values with URI encoding', () => { - const testString1 = 'https://www.google.co.uk/webhp#q=$testfield1$'; - const testString2 = 'https://www.google.co.uk/webhp#q=$testfield2$'; - const testString3 = 'https://www.google.co.uk/webhp#q=$testfield3$'; - const testString4 = 'https://www.google.co.uk/webhp#q=$user$'; - - const result1 = replaceStringTokens(testString1, testRecord, true); - const result2 = replaceStringTokens(testString2, testRecord, true); - const result3 = replaceStringTokens(testString3, testRecord, true); - const result4 = replaceStringTokens(testString4, testRecord, true); - - expect(result1).to.be('https://www.google.co.uk/webhp#q=test%24tring%3D%5B%2B-%3F%5D'); - expect(result2).to.be('https://www.google.co.uk/webhp#q=%7B%3C()%3E%7D'); - expect(result3).to.be('https://www.google.co.uk/webhp#q=host%3D%5C%5Ctest%40uk.dev'); - expect(result4).to.be("https://www.google.co.uk/webhp#q=Des%20O'Connor"); - }); - - it('returns correct values for missing token with URI encoding', () => { - const testString = 'https://www.google.co.uk/webhp#q=$username$&time=$timestamp$'; - const result = replaceStringTokens(testString, testRecord, true); - expect(result).to.be('https://www.google.co.uk/webhp#q=$username$&time=1454890500000'); - }); - }); - - describe('detectorToString', () => { - it('returns the correct descriptions for detectors', () => { - const detector1 = { - function: 'count', - }; - - const detector2 = { - function: 'count', - by_field_name: 'airline', - use_null: false, - }; - - const detector3 = { - function: 'mean', - field_name: 'CPUUtilization', - partition_field_name: 'region', - by_field_name: 'host', - over_field_name: 'user', - exclude_frequent: 'all', - }; - - expect(detectorToString(detector1)).to.be('count'); - expect(detectorToString(detector2)).to.be('count by airline use_null=false'); - expect(detectorToString(detector3)).to.be( - 'mean(CPUUtilization) by host over user partition_field_name=region exclude_frequent=all' - ); - }); - }); - - describe('sortByKey', () => { - const obj = { - zebra: 'stripes', - giraffe: 'neck', - elephant: 'trunk', - }; - - const valueComparator = function(value) { - return value; - }; - - it('returns correct ordering with default comparator', () => { - const result = sortByKey(obj, false); - const keys = Object.keys(result); - expect(keys[0]).to.be('elephant'); - expect(keys[1]).to.be('giraffe'); - expect(keys[2]).to.be('zebra'); - }); - - it('returns correct ordering with default comparator and order reversed', () => { - const result = sortByKey(obj, true); - const keys = Object.keys(result); - expect(keys[0]).to.be('zebra'); - expect(keys[1]).to.be('giraffe'); - expect(keys[2]).to.be('elephant'); - }); - - it('returns correct ordering with comparator', () => { - const result = sortByKey(obj, false, valueComparator); - const keys = Object.keys(result); - expect(keys[0]).to.be('giraffe'); - expect(keys[1]).to.be('zebra'); - expect(keys[2]).to.be('elephant'); - }); - - it('returns correct ordering with comparator and order reversed', () => { - const result = sortByKey(obj, true, valueComparator); - const keys = Object.keys(result); - expect(keys[0]).to.be('elephant'); - expect(keys[1]).to.be('zebra'); - expect(keys[2]).to.be('giraffe'); - }); - }); - - describe('guessTimeFormat', () => { - it('returns correct format for various dates', () => { - expect(guessTimeFormat('2017-03-24T00:00')).to.be("yyyy-MM-dd'T'HH:mm"); - expect(guessTimeFormat('2017-03-24 00:00')).to.be('yyyy-MM-dd HH:mm'); - expect(guessTimeFormat('2017-03-24 00:00:00')).to.be('yyyy-MM-dd HH:mm:ss'); - expect(guessTimeFormat('2017-03-24 00:00:00Z')).to.be('yyyy-MM-dd HH:mm:ssX'); - expect(guessTimeFormat('2017-03-24 00:00:00.000')).to.be('yyyy-MM-dd HH:mm:ss.SSS'); - expect(guessTimeFormat('2017-03-24 00:00:00:000')).to.be('yyyy-MM-dd HH:mm:ss:SSS'); - expect(guessTimeFormat('2017-03-24 00:00:00.000+00:00:00')).to.be( - 'yyyy-MM-dd HH:mm:ss.SSSXXXXX' - ); - expect(guessTimeFormat('2017-03-24 00:00:00.000+00:00')).to.be('yyyy-MM-dd HH:mm:ss.SSSXXX'); - expect(guessTimeFormat('2017-03-24 00:00:00.000+000000')).to.be( - 'yyyy-MM-dd HH:mm:ss.SSSXXXX' - ); - expect(guessTimeFormat('2017-03-24 00:00:00.000+0000')).to.be('yyyy-MM-dd HH:mm:ss.SSSZ'); - expect(guessTimeFormat('2017-03-24 00:00:00.000+00')).to.be('yyyy-MM-dd HH:mm:ss.SSSX'); - expect(guessTimeFormat('2017-03-24 00:00:00.000Z')).to.be('yyyy-MM-dd HH:mm:ss.SSSX'); - expect(guessTimeFormat('2017-03-24 00:00:00.000 GMT')).to.be('yyyy-MM-dd HH:mm:ss.SSS zzz'); - expect(guessTimeFormat('2017-03-24 00:00:00 GMT')).to.be('yyyy-MM-dd HH:mm:ss zzz'); - expect(guessTimeFormat('2017 03 24 00:00:00.000')).to.be('yyyy MM dd HH:mm:ss.SSS'); - expect(guessTimeFormat('2017.03.24 00:00:00.000')).to.be('yyyy.MM.dd HH:mm:ss.SSS'); - expect(guessTimeFormat('2017/03/24 00:00:00.000')).to.be('yyyy/MM/dd HH:mm:ss.SSS'); - expect(guessTimeFormat('24/03/2017 00:00:00.000')).to.be('dd/MM/yyyy HH:mm:ss.SSS'); - expect(guessTimeFormat('03 24 2017 00:00:00.000')).to.be('MM dd yyyy HH:mm:ss.SSS'); - expect(guessTimeFormat('03/24/2017 00:00:00.000')).to.be('MM/dd/yyyy HH:mm:ss.SSS'); - expect(guessTimeFormat('2017 Mar 24 00:00:00.000')).to.be('yyyy MMM dd HH:mm:ss.SSS'); - expect(guessTimeFormat('Mar 24 2017 00:00:00.000')).to.be('MMM dd yyyy HH:mm:ss.SSS'); - expect(guessTimeFormat('24 Mar 2017 00:00:00.000')).to.be('dd MMM yyyy HH:mm:ss.SSS'); - expect(guessTimeFormat('1490313600')).to.be('epoch'); - expect(guessTimeFormat('1490313600000')).to.be('epoch_ms'); - }); - }); - - describe('toLocaleString', () => { - it('returns correct comma placement for large numbers', () => { - expect(toLocaleString(1)).to.be('1'); - expect(toLocaleString(10)).to.be('10'); - expect(toLocaleString(100)).to.be('100'); - expect(toLocaleString(1000)).to.be('1,000'); - expect(toLocaleString(10000)).to.be('10,000'); - expect(toLocaleString(100000)).to.be('100,000'); - expect(toLocaleString(1000000)).to.be('1,000,000'); - expect(toLocaleString(10000000)).to.be('10,000,000'); - expect(toLocaleString(100000000)).to.be('100,000,000'); - expect(toLocaleString(1000000000)).to.be('1,000,000,000'); - }); - }); - - describe('mlEscape', () => { - it('returns correct escaping of characters', () => { - expect(mlEscape('foo&bar')).to.be('foo&bar'); - expect(mlEscape('foo<bar')).to.be('foo<bar'); - expect(mlEscape('foo>bar')).to.be('foo>bar'); - expect(mlEscape('foo"bar')).to.be('foo"bar'); - expect(mlEscape("foo'bar")).to.be('foo'bar'); - expect(mlEscape('foo/bar')).to.be('foo/bar'); - }); - }); - - describe('escapeForElasticsearchQuery', () => { - it('returns correct escaping of reserved elasticsearch characters', () => { - expect(escapeForElasticsearchQuery('foo+bar')).to.be('foo\\+bar'); - expect(escapeForElasticsearchQuery('foo-bar')).to.be('foo\\-bar'); - expect(escapeForElasticsearchQuery('foo=bar')).to.be('foo\\=bar'); - expect(escapeForElasticsearchQuery('foo&&bar')).to.be('foo\\&\\&bar'); - expect(escapeForElasticsearchQuery('foo||bar')).to.be('foo\\|\\|bar'); - expect(escapeForElasticsearchQuery('foo>bar')).to.be('foo\\>bar'); - expect(escapeForElasticsearchQuery('foo<bar')).to.be('foo\\<bar'); - expect(escapeForElasticsearchQuery('foo!bar')).to.be('foo\\!bar'); - expect(escapeForElasticsearchQuery('foo(bar')).to.be('foo\\(bar'); - expect(escapeForElasticsearchQuery('foo)bar')).to.be('foo\\)bar'); - expect(escapeForElasticsearchQuery('foo{bar')).to.be('foo\\{bar'); - expect(escapeForElasticsearchQuery('foo[bar')).to.be('foo\\[bar'); - expect(escapeForElasticsearchQuery('foo]bar')).to.be('foo\\]bar'); - expect(escapeForElasticsearchQuery('foo^bar')).to.be('foo\\^bar'); - expect(escapeForElasticsearchQuery('foo"bar')).to.be('foo\\"bar'); - expect(escapeForElasticsearchQuery('foo~bar')).to.be('foo\\~bar'); - expect(escapeForElasticsearchQuery('foo*bar')).to.be('foo\\*bar'); - expect(escapeForElasticsearchQuery('foo?bar')).to.be('foo\\?bar'); - expect(escapeForElasticsearchQuery('foo:bar')).to.be('foo\\:bar'); - expect(escapeForElasticsearchQuery('foo\\bar')).to.be('foo\\\\bar'); - expect(escapeForElasticsearchQuery('foo/bar')).to.be('foo\\/bar'); - }); - }); -}); diff --git a/x-pack/plugins/ml/public/application/util/calc_auto_interval.test.js b/x-pack/plugins/ml/public/application/util/calc_auto_interval.test.js new file mode 100644 index 0000000000000..c36557a0e6951 --- /dev/null +++ b/x-pack/plugins/ml/public/application/util/calc_auto_interval.test.js @@ -0,0 +1,139 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import moment from 'moment'; + +import { timeBucketsCalcAutoIntervalProvider } from './calc_auto_interval'; + +describe('ML - calc auto intervals', () => { + const calcAuto = timeBucketsCalcAutoIntervalProvider(); + + describe('near interval', () => { + test('returns 0ms buckets for undefined / 0 bars', () => { + const interval = calcAuto.near(0, undefined); + expect(interval.asMilliseconds()).toBe(0); + }); + + test('returns 1000ms buckets for 60s / 100 bars', () => { + const interval = calcAuto.near(100, moment.duration(60, 's')); + expect(interval.asMilliseconds()).toBe(1000); + }); + + test('returns 5m buckets for 8h / 100 bars', () => { + const interval = calcAuto.near(100, moment.duration(8, 'h')); + expect(interval.asMinutes()).toBe(5); + }); + + test('returns 15m buckets for 1d / 100 bars', () => { + const interval = calcAuto.near(100, moment.duration(1, 'd')); + expect(interval.asMinutes()).toBe(15); + }); + + test('returns 1h buckets for 20d / 500 bars', () => { + const interval = calcAuto.near(500, moment.duration(20, 'd')); + expect(interval.asHours()).toBe(1); + }); + + test('returns 6h buckets for 100d / 500 bars', () => { + const interval = calcAuto.near(500, moment.duration(100, 'd')); + expect(interval.asHours()).toBe(6); + }); + + test('returns 24h buckets for 1y / 500 bars', () => { + const interval = calcAuto.near(500, moment.duration(1, 'y')); + expect(interval.asHours()).toBe(24); + }); + + test('returns 12h buckets for 1y / 1000 bars', () => { + const interval = calcAuto.near(1000, moment.duration(1, 'y')); + expect(interval.asHours()).toBe(12); + }); + }); + + describe('lessThan interval', () => { + test('returns 0ms buckets for undefined / 0 bars', () => { + const interval = calcAuto.lessThan(0, undefined); + expect(interval.asMilliseconds()).toBe(0); + }); + + test('returns 500ms buckets for 60s / 100 bars', () => { + const interval = calcAuto.lessThan(100, moment.duration(60, 's')); + expect(interval.asMilliseconds()).toBe(500); + }); + + test('returns 5m buckets for 8h / 100 bars', () => { + const interval = calcAuto.lessThan(100, moment.duration(8, 'h')); + expect(interval.asMinutes()).toBe(5); + }); + + test('returns 30m buckets for 1d / 100 bars', () => { + const interval = calcAuto.lessThan(100, moment.duration(1, 'd')); + expect(interval.asMinutes()).toBe(30); + }); + + test('returns 1h buckets for 20d / 500 bars', () => { + const interval = calcAuto.lessThan(500, moment.duration(20, 'd')); + expect(interval.asHours()).toBe(1); + }); + + test('returns 6h buckets for 100d / 500 bars', () => { + const interval = calcAuto.lessThan(500, moment.duration(100, 'd')); + expect(interval.asHours()).toBe(6); + }); + + test('returns 24h buckets for 1y / 500 bars', () => { + const interval = calcAuto.lessThan(500, moment.duration(1, 'y')); + expect(interval.asHours()).toBe(24); + }); + + test('returns 12h buckets for 1y / 1000 bars', () => { + const interval = calcAuto.lessThan(1000, moment.duration(1, 'y')); + expect(interval.asHours()).toBe(12); + }); + }); + + describe('atLeast interval', () => { + test('returns 0ms buckets for undefined / 0 bars', () => { + const interval = calcAuto.atLeast(0, undefined); + expect(interval.asMilliseconds()).toBe(0); + }); + + test('returns 100ms buckets for 60s / 100 bars', () => { + const interval = calcAuto.atLeast(100, moment.duration(60, 's')); + expect(interval.asMilliseconds()).toBe(100); + }); + + test('returns 1m buckets for 8h / 100 bars', () => { + const interval = calcAuto.atLeast(100, moment.duration(8, 'h')); + expect(interval.asMinutes()).toBe(1); + }); + + test('returns 10m buckets for 1d / 100 bars', () => { + const interval = calcAuto.atLeast(100, moment.duration(1, 'd')); + expect(interval.asMinutes()).toBe(10); + }); + + test('returns 30m buckets for 20d / 500 bars', () => { + const interval = calcAuto.atLeast(500, moment.duration(20, 'd')); + expect(interval.asMinutes()).toBe(30); + }); + + test('returns 4h buckets for 100d / 500 bars', () => { + const interval = calcAuto.atLeast(500, moment.duration(100, 'd')); + expect(interval.asHours()).toBe(4); + }); + + test('returns 12h buckets for 1y / 500 bars', () => { + const interval = calcAuto.atLeast(500, moment.duration(1, 'y')); + expect(interval.asHours()).toBe(12); + }); + + test('returns 8h buckets for 1y / 1000 bars', () => { + const interval = calcAuto.atLeast(1000, moment.duration(1, 'y')); + expect(interval.asHours()).toBe(8); + }); + }); +}); diff --git a/x-pack/plugins/ml/public/application/util/chart_utils.test.js b/x-pack/plugins/ml/public/application/util/chart_utils.test.js index 4b33cb131be7f..57aea3c0ab5aa 100644 --- a/x-pack/plugins/ml/public/application/util/chart_utils.test.js +++ b/x-pack/plugins/ml/public/application/util/chart_utils.test.js @@ -29,246 +29,488 @@ const timefilter = getTimefilter(); import d3 from 'd3'; import moment from 'moment'; -import { mount } from 'enzyme'; import React from 'react'; +import { render } from '@testing-library/react'; import { + chartLimits, + getChartType, getExploreSeriesLink, getTickValues, - isLabelLengthAboveThreshold, getXTransform, + isLabelLengthAboveThreshold, + numTicks, removeLabelOverlap, + showMultiBucketAnomalyMarker, + showMultiBucketAnomalyTooltip, } from './chart_utils'; +import { MULTI_BUCKET_IMPACT } from '../../../common/constants/multi_bucket_impact'; +import { CHART_TYPE } from '../explorer/explorer_constants'; + timefilter.setTime({ from: moment(seriesConfig.selectedEarliest).toISOString(), to: moment(seriesConfig.selectedLatest).toISOString(), }); -describe('getExploreSeriesLink', () => { - test('get timeseriesexplorer link', () => { - const link = getExploreSeriesLink(seriesConfig); - const expectedLink = - `#/timeseriesexplorer?_g=(ml:(jobIds:!(population-03)),` + - `refreshInterval:(display:Off,pause:!f,value:0),time:(from:'2017-02-23T00:00:00.000Z',mode:absolute,` + - `to:'2017-02-23T23:59:59.999Z'))&_a=(mlTimeSeriesExplorer%3A(detectorIndex%3A0%2Centities%3A` + - `(nginx.access.remote_ip%3A'72.57.0.53')%2Czoom%3A(from%3A'2017-02-19T20%3A00%3A00.000Z'%2Cto%3A'2017-02-27T04%3A00%3A00.000Z'))` + - `%2Cquery%3A(query_string%3A(analyze_wildcard%3A!t%2Cquery%3A'*')))`; - - expect(link).toBe(expectedLink); - }); -}); +describe('ML - chart utils', () => { + describe('chartLimits', () => { + test('returns NaN when called without data', () => { + const limits = chartLimits(); + expect(limits.min).toBeNaN(); + expect(limits.max).toBeNaN(); + }); -describe('getTickValues', () => { - test('farequote sample data', () => { - const tickValues = getTickValues(1486656000000, 14400000, 1486606500000, 1486719900000); - - expect(tickValues).toEqual([ - 1486612800000, - 1486627200000, - 1486641600000, - 1486656000000, - 1486670400000, - 1486684800000, - 1486699200000, - 1486713600000, - ]); - }); + test('returns {max: 625736376, min: 201039318} for some test data', () => { + const data = [ + { + date: new Date('2017-02-23T08:00:00.000Z'), + value: 228243469, + anomalyScore: 63.32916, + numberOfCauses: 1, + actual: [228243469], + typical: [133107.7703441773], + }, + { date: new Date('2017-02-23T09:00:00.000Z'), value: null }, + { date: new Date('2017-02-23T10:00:00.000Z'), value: null }, + { date: new Date('2017-02-23T11:00:00.000Z'), value: null }, + { + date: new Date('2017-02-23T12:00:00.000Z'), + value: 625736376, + anomalyScore: 97.32085, + numberOfCauses: 1, + actual: [625736376], + typical: [132830.424736973], + }, + { + date: new Date('2017-02-23T13:00:00.000Z'), + value: 201039318, + anomalyScore: 59.83488, + numberOfCauses: 1, + actual: [201039318], + typical: [132739.5267403542], + }, + ]; + + const limits = chartLimits(data); + + // {max: 625736376, min: 201039318} + expect(limits.min).toBe(201039318); + expect(limits.max).toBe(625736376); + }); - test('filebeat sample data', () => { - const tickValues = getTickValues(1486080000000, 14400000, 1485860400000, 1486314000000); - expect(tickValues).toEqual([ - 1485864000000, - 1485878400000, - 1485892800000, - 1485907200000, - 1485921600000, - 1485936000000, - 1485950400000, - 1485964800000, - 1485979200000, - 1485993600000, - 1486008000000, - 1486022400000, - 1486036800000, - 1486051200000, - 1486065600000, - 1486080000000, - 1486094400000, - 1486108800000, - 1486123200000, - 1486137600000, - 1486152000000, - 1486166400000, - 1486180800000, - 1486195200000, - 1486209600000, - 1486224000000, - 1486238400000, - 1486252800000, - 1486267200000, - 1486281600000, - 1486296000000, - 1486310400000, - ]); + test("adds 5% padding when min/max are the same, e.g. when there's only one data point", () => { + const data = [ + { + date: new Date('2017-02-23T08:00:00.000Z'), + value: 100, + anomalyScore: 50, + numberOfCauses: 1, + actual: [100], + typical: [100], + }, + ]; + + const limits = chartLimits(data); + expect(limits.min).toBe(95); + expect(limits.max).toBe(105); + }); + + test('returns minimum of 0 when data includes an anomaly for missing data', () => { + const data = [ + { date: new Date('2017-02-23T09:00:00.000Z'), value: 22.2 }, + { date: new Date('2017-02-23T10:00:00.000Z'), value: 23.3 }, + { date: new Date('2017-02-23T11:00:00.000Z'), value: 24.4 }, + { + date: new Date('2017-02-23T12:00:00.000Z'), + value: null, + anomalyScore: 97.32085, + actual: [0], + typical: [22.2], + }, + { date: new Date('2017-02-23T13:00:00.000Z'), value: 21.3 }, + { date: new Date('2017-02-23T14:00:00.000Z'), value: 21.2 }, + { date: new Date('2017-02-23T15:00:00.000Z'), value: 21.1 }, + ]; + + const limits = chartLimits(data); + expect(limits.min).toBe(0); + expect(limits.max).toBe(24.4); + }); }); - test('gallery sample data', () => { - const tickValues = getTickValues(1518652800000, 604800000, 1518274800000, 1519635600000); - expect(tickValues).toEqual([1518652800000, 1519257600000]); + describe('getChartType', () => { + const singleMetricConfig = { + metricFunction: 'avg', + functionDescription: 'mean', + fieldName: 'responsetime', + entityFields: [], + }; + + const multiMetricConfig = { + metricFunction: 'avg', + functionDescription: 'mean', + fieldName: 'responsetime', + entityFields: [ + { + fieldName: 'airline', + fieldValue: 'AAL', + fieldType: 'partition', + }, + ], + }; + + const populationConfig = { + metricFunction: 'avg', + functionDescription: 'mean', + fieldName: 'http.response.body.bytes', + entityFields: [ + { + fieldName: 'source.ip', + fieldValue: '10.11.12.13', + fieldType: 'over', + }, + ], + }; + + const rareConfig = { + metricFunction: 'count', + functionDescription: 'rare', + entityFields: [ + { + fieldName: 'http.response.status_code', + fieldValue: '404', + fieldType: 'by', + }, + ], + }; + + const varpModelPlotConfig = { + metricFunction: null, + functionDescription: 'varp', + fieldName: 'NetworkOut', + entityFields: [ + { + fieldName: 'instance', + fieldValue: 'i-ef74d410', + fieldType: 'over', + }, + ], + }; + + const overScriptFieldModelPlotConfig = { + metricFunction: 'count', + functionDescription: 'count', + fieldName: 'highest_registered_domain', + entityFields: [ + { + fieldName: 'highest_registered_domain', + fieldValue: 'elastic.co', + fieldType: 'over', + }, + ], + datafeedConfig: { + script_fields: { + highest_registered_domain: { + script: { + source: "return domainSplit(doc['query'].value, params).get(1);", + lang: 'painless', + }, + ignore_failure: false, + }, + }, + }, + }; + + test('returns single metric chart type as expected for configs', () => { + expect(getChartType(singleMetricConfig)).toBe(CHART_TYPE.SINGLE_METRIC); + expect(getChartType(multiMetricConfig)).toBe(CHART_TYPE.SINGLE_METRIC); + expect(getChartType(varpModelPlotConfig)).toBe(CHART_TYPE.SINGLE_METRIC); + expect(getChartType(overScriptFieldModelPlotConfig)).toBe(CHART_TYPE.SINGLE_METRIC); + }); + + test('returns event distribution chart type as expected for configs', () => { + expect(getChartType(rareConfig)).toBe(CHART_TYPE.EVENT_DISTRIBUTION); + }); + + test('returns population distribution chart type as expected for configs', () => { + expect(getChartType(populationConfig)).toBe(CHART_TYPE.POPULATION_DISTRIBUTION); + }); }); - test('invalid tickIntervals trigger an error', () => { - expect(() => { - getTickValues(1518652800000, 0, 1518274800000, 1519635600000); - }).toThrow(); - expect(() => { - getTickValues(1518652800000, -604800000, 1518274800000, 1519635600000); - }).toThrow(); + describe('getExploreSeriesLink', () => { + test('get timeseriesexplorer link', () => { + const link = getExploreSeriesLink(seriesConfig); + const expectedLink = + `#/timeseriesexplorer?_g=(ml:(jobIds:!(population-03)),` + + `refreshInterval:(display:Off,pause:!f,value:0),time:(from:'2017-02-23T00:00:00.000Z',mode:absolute,` + + `to:'2017-02-23T23:59:59.999Z'))&_a=(mlTimeSeriesExplorer%3A(detectorIndex%3A0%2Centities%3A` + + `(nginx.access.remote_ip%3A'72.57.0.53')%2Czoom%3A(from%3A'2017-02-19T20%3A00%3A00.000Z'%2Cto%3A'2017-02-27T04%3A00%3A00.000Z'))` + + `%2Cquery%3A(query_string%3A(analyze_wildcard%3A!t%2Cquery%3A'*')))`; + + expect(link).toBe(expectedLink); + }); }); -}); -describe('isLabelLengthAboveThreshold', () => { - test('short label', () => { - const isLongLabel = isLabelLengthAboveThreshold({ - detectorLabel: 'count', - entityFields: seriesConfig.entityFields, + describe('numTicks', () => { + test('returns 10 for 1000', () => { + expect(numTicks(1000)).toBe(10); }); - expect(isLongLabel).toBeFalsy(); }); - test('long label', () => { - const isLongLabel = isLabelLengthAboveThreshold(seriesConfig); - expect(isLongLabel).toBeTruthy(); + describe('showMultiBucketAnomalyMarker', () => { + test('returns true for points with multiBucketImpact at or above medium impact', () => { + expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.HIGH })).toBe( + true + ); + expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.MEDIUM })).toBe( + true + ); + }); + + test('returns false for points with multiBucketImpact missing or below medium impact', () => { + expect(showMultiBucketAnomalyMarker({})).toBe(false); + expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.LOW })).toBe( + false + ); + expect(showMultiBucketAnomalyMarker({ multiBucketImpact: MULTI_BUCKET_IMPACT.NONE })).toBe( + false + ); + }); }); -}); -describe('getXTransform', () => { - const expectedXTransform = 0.007167499999999999; + describe('showMultiBucketAnomalyTooltip', () => { + test('returns true for points with multiBucketImpact at or above low impact', () => { + expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.HIGH })).toBe( + true + ); + expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.MEDIUM })).toBe( + true + ); + expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.LOW })).toBe( + true + ); + }); - test('Chrome/Safari/Firefox String variant.', () => { - const transformStr = 'translate(0.007167499999999999,0)'; - const xTransform = getXTransform(transformStr); - expect(xTransform).toEqual(expectedXTransform); + test('returns false for points with multiBucketImpact missing or below medium impact', () => { + expect(showMultiBucketAnomalyTooltip({})).toBe(false); + expect(showMultiBucketAnomalyTooltip({ multiBucketImpact: MULTI_BUCKET_IMPACT.NONE })).toBe( + false + ); + }); }); - test('IE11 String variant.', () => { - const transformStr = 'translate(0.007167499999999999)'; - const xTransform = getXTransform(transformStr); - expect(xTransform).toEqual(expectedXTransform); + describe('getTickValues', () => { + test('farequote sample data', () => { + const tickValues = getTickValues(1486656000000, 14400000, 1486606500000, 1486719900000); + + expect(tickValues).toEqual([ + 1486612800000, + 1486627200000, + 1486641600000, + 1486656000000, + 1486670400000, + 1486684800000, + 1486699200000, + 1486713600000, + ]); + }); + + test('filebeat sample data', () => { + const tickValues = getTickValues(1486080000000, 14400000, 1485860400000, 1486314000000); + expect(tickValues).toEqual([ + 1485864000000, + 1485878400000, + 1485892800000, + 1485907200000, + 1485921600000, + 1485936000000, + 1485950400000, + 1485964800000, + 1485979200000, + 1485993600000, + 1486008000000, + 1486022400000, + 1486036800000, + 1486051200000, + 1486065600000, + 1486080000000, + 1486094400000, + 1486108800000, + 1486123200000, + 1486137600000, + 1486152000000, + 1486166400000, + 1486180800000, + 1486195200000, + 1486209600000, + 1486224000000, + 1486238400000, + 1486252800000, + 1486267200000, + 1486281600000, + 1486296000000, + 1486310400000, + ]); + }); + + test('gallery sample data', () => { + const tickValues = getTickValues(1518652800000, 604800000, 1518274800000, 1519635600000); + expect(tickValues).toEqual([1518652800000, 1519257600000]); + }); + + test('invalid tickIntervals trigger an error', () => { + expect(() => { + getTickValues(1518652800000, 0, 1518274800000, 1519635600000); + }).toThrow(); + expect(() => { + getTickValues(1518652800000, -604800000, 1518274800000, 1519635600000); + }).toThrow(); + }); }); - test('Invalid String.', () => { - const transformStr = 'translate()'; - const xTransform = getXTransform(transformStr); - expect(xTransform).toEqual(NaN); + describe('isLabelLengthAboveThreshold', () => { + test('short label', () => { + const isLongLabel = isLabelLengthAboveThreshold({ + detectorLabel: 'count', + entityFields: seriesConfig.entityFields, + }); + expect(isLongLabel).toBeFalsy(); + }); + + test('long label', () => { + const isLongLabel = isLabelLengthAboveThreshold(seriesConfig); + expect(isLongLabel).toBeTruthy(); + }); }); -}); -describe('removeLabelOverlap', () => { - const originalGetBBox = SVGElement.prototype.getBBox; - - // This resembles how ExplorerChart renders its x axis. - // We set up this boilerplate so we can then run removeLabelOverlap() - // on some "real" structure. - function axisSetup({ interval, plotEarliest, plotLatest, startTimeMs, xAxisTickFormat }) { - const wrapper = mount(<div className="content-wrapper" />); - const node = wrapper.getDOMNode(); - - const chartHeight = 170; - const margin = { top: 10, right: 0, bottom: 30, left: 60 }; - const svgWidth = 500; - const svgHeight = chartHeight + margin.top + margin.bottom; - const vizWidth = 500; - - const chartElement = d3.select(node); - - const lineChartXScale = d3.time - .scale() - .range([0, vizWidth]) - .domain([plotEarliest, plotLatest]); - - const xAxis = d3.svg - .axis() - .scale(lineChartXScale) - .orient('bottom') - .innerTickSize(-chartHeight) - .outerTickSize(0) - .tickPadding(10) - .tickFormat(d => moment(d).format(xAxisTickFormat)); - - const tickValues = getTickValues(startTimeMs, interval, plotEarliest, plotLatest); - xAxis.tickValues(tickValues); - - const svg = chartElement - .append('svg') - .attr('width', svgWidth) - .attr('height', svgHeight); - - const axes = svg.append('g'); - - const gAxis = axes - .append('g') - .attr('class', 'x axis') - .attr('transform', 'translate(0,' + chartHeight + ')') - .call(xAxis); - - return { - gAxis, - node, - vizWidth, - }; - } + describe('getXTransform', () => { + const expectedXTransform = 0.007167499999999999; - test('farequote sample data', () => { - const mockedGetBBox = { width: 27.21875 }; - SVGElement.prototype.getBBox = () => mockedGetBBox; + test('Chrome/Safari/Firefox String variant.', () => { + const transformStr = 'translate(0.007167499999999999,0)'; + const xTransform = getXTransform(transformStr); + expect(xTransform).toEqual(expectedXTransform); + }); - const startTimeMs = 1486656000000; - const interval = 14400000; + test('IE11 String variant.', () => { + const transformStr = 'translate(0.007167499999999999)'; + const xTransform = getXTransform(transformStr); + expect(xTransform).toEqual(expectedXTransform); + }); - const { gAxis, node, vizWidth } = axisSetup({ - interval, - plotEarliest: 1486606500000, - plotLatest: 1486719900000, - startTimeMs, - xAxisTickFormat: 'HH:mm', + test('Invalid String.', () => { + const transformStr = 'translate()'; + const xTransform = getXTransform(transformStr); + expect(xTransform).toEqual(NaN); }); + }); - expect(node.getElementsByTagName('text')).toHaveLength(8); + describe('removeLabelOverlap', () => { + const originalGetBBox = SVGElement.prototype.getBBox; + + // This resembles how ExplorerChart renders its x axis. + // We set up this boilerplate so we can then run removeLabelOverlap() + // on some "real" structure. + function axisSetup({ interval, plotEarliest, plotLatest, startTimeMs, xAxisTickFormat }) { + const { container } = render(<div className="content-wrapper" />); + const node = container.querySelector('.content-wrapper'); + + const chartHeight = 170; + const margin = { top: 10, right: 0, bottom: 30, left: 60 }; + const svgWidth = 500; + const svgHeight = chartHeight + margin.top + margin.bottom; + const vizWidth = 500; + + const chartElement = d3.select(node); + + const lineChartXScale = d3.time + .scale() + .range([0, vizWidth]) + .domain([plotEarliest, plotLatest]); + + const xAxis = d3.svg + .axis() + .scale(lineChartXScale) + .orient('bottom') + .innerTickSize(-chartHeight) + .outerTickSize(0) + .tickPadding(10) + .tickFormat(d => moment(d).format(xAxisTickFormat)); + + const tickValues = getTickValues(startTimeMs, interval, plotEarliest, plotLatest); + xAxis.tickValues(tickValues); + + const svg = chartElement + .append('svg') + .attr('width', svgWidth) + .attr('height', svgHeight); + + const axes = svg.append('g'); + + const gAxis = axes + .append('g') + .attr('class', 'x axis') + .attr('transform', 'translate(0,' + chartHeight + ')') + .call(xAxis); - removeLabelOverlap(gAxis, startTimeMs, interval, vizWidth); + return { + gAxis, + node, + vizWidth, + }; + } - // at the vizWidth of 500, the most left and right tick label - // will get removed because it overflows the chart area - expect(node.getElementsByTagName('text')).toHaveLength(6); + test('farequote sample data', () => { + const mockedGetBBox = { width: 27.21875 }; + SVGElement.prototype.getBBox = () => mockedGetBBox; - SVGElement.prototype.getBBox = originalGetBBox; - }); + const startTimeMs = 1486656000000; + const interval = 14400000; + + const { gAxis, node, vizWidth } = axisSetup({ + interval, + plotEarliest: 1486606500000, + plotLatest: 1486719900000, + startTimeMs, + xAxisTickFormat: 'HH:mm', + }); - test('filebeat sample data', () => { - const mockedGetBBox = { width: 85.640625 }; - SVGElement.prototype.getBBox = () => mockedGetBBox; + expect(node.getElementsByTagName('text')).toHaveLength(8); - const startTimeMs = 1486080000000; - const interval = 14400000; + removeLabelOverlap(gAxis, startTimeMs, interval, vizWidth); - const { gAxis, node, vizWidth } = axisSetup({ - interval, - plotEarliest: 1485860400000, - plotLatest: 1486314000000, - startTimeMs, - xAxisTickFormat: 'YYYY-MM-DD HH:mm', + // at the vizWidth of 500, the most left and right tick label + // will get removed because it overflows the chart area + expect(node.getElementsByTagName('text')).toHaveLength(6); + + SVGElement.prototype.getBBox = originalGetBBox; }); - expect(node.getElementsByTagName('text')).toHaveLength(32); + test('filebeat sample data', () => { + const mockedGetBBox = { width: 85.640625 }; + SVGElement.prototype.getBBox = () => mockedGetBBox; + + const startTimeMs = 1486080000000; + const interval = 14400000; - removeLabelOverlap(gAxis, startTimeMs, interval, vizWidth); + const { gAxis, node, vizWidth } = axisSetup({ + interval, + plotEarliest: 1485860400000, + plotLatest: 1486314000000, + startTimeMs, + xAxisTickFormat: 'YYYY-MM-DD HH:mm', + }); - // In this case labels get reduced significantly because of the wider - // labels (full dates + time) and the narrow interval. - expect(node.getElementsByTagName('text')).toHaveLength(3); + expect(node.getElementsByTagName('text')).toHaveLength(32); - SVGElement.prototype.getBBox = originalGetBBox; + removeLabelOverlap(gAxis, startTimeMs, interval, vizWidth); + + // In this case labels get reduced significantly because of the wider + // labels (full dates + time) and the narrow interval. + expect(node.getElementsByTagName('text')).toHaveLength(3); + + SVGElement.prototype.getBBox = originalGetBBox; + }); }); }); diff --git a/x-pack/plugins/ml/public/application/util/string_utils.d.ts b/x-pack/plugins/ml/public/application/util/string_utils.d.ts index b5063907e1fdf..531e44e3e78c1 100644 --- a/x-pack/plugins/ml/public/application/util/string_utils.d.ts +++ b/x-pack/plugins/ml/public/application/util/string_utils.d.ts @@ -14,4 +14,8 @@ export function replaceStringTokens( export function detectorToString(dtr: any): string; +export function sortByKey(list: any, reverse: boolean, comparator?: any): any; + export function toLocaleString(x: number): string; + +export function mlEscape(str: string): string; diff --git a/x-pack/plugins/ml/public/application/util/string_utils.js b/x-pack/plugins/ml/public/application/util/string_utils.js index 172d334099b3d..66835984df5e5 100644 --- a/x-pack/plugins/ml/public/application/util/string_utils.js +++ b/x-pack/plugins/ml/public/application/util/string_utils.js @@ -99,211 +99,6 @@ export function sortByKey(list, reverse, comparator) { ); } -// guess the time format for a given time string -export function guessTimeFormat(time) { - let format = ''; - let matched = false; - if (isNaN(time)) { - let match; - - // match date format - if (!matched) { - let reg = ''; - - reg += '('; // 1 ( date - - reg += '('; // 2 ( yyyy-MM-dd - reg += '(\\d{4})'; // 3 yyyy - reg += '([-/.\\s])'; // 4 - or . or \s - reg += '('; // 5 ( month - reg += '([01]\\d)'; // 6 MM - reg += '|'; // or - reg += '(\\w{3})'; // 7 MMM - reg += ')'; // ) end month - reg += '([-/.\\s])'; // 8 - or . or \s - reg += '([0-3]\\d)'; // 9 dd 0-3 and 0-9 - reg += ')'; // ) end yyyy-MM-dd - - reg += '|'; // or - - reg += '('; // 10 ( d[d]-MM[M]-yyyy or MM[M]-d[d]-yyyy - - reg += '('; // 11 ( day or month - reg += '(\\d{1,2})'; // 12 d or M or dd or MM - reg += '|'; // or - reg += '(\\w{3})'; // 13 MMM - reg += ')'; // ) end day or month - - reg += '([-/.\\s])'; // 14 - or . or \s - - reg += '('; // 15 ( day or month - reg += '(\\d{1,2})'; // 12 d or M or dd or MM - reg += '|'; // or - reg += '(\\w{3})'; // 17 MMM - reg += ')'; // ) end day or month - - reg += '([-/.\\s])'; // 18 - or . or \s - reg += '(\\d{4})'; // 19 yyyy - reg += ')'; // ) end d[d]-MM[M]-yyyy or MM[M]-d[d]-yyyy - - reg += ')'; // ) end date - - reg += '([T\\s])?'; // 20 T or space - - reg += '([0-2]\\d)'; // 21 HH 0-2 and 0-9 - reg += '([:.])'; // 22 :. - reg += '([0-5]\\d)'; // 23 mm 0-5 and 0-9 - reg += '('; // 24 ( optional secs - reg += '([:.])'; // 25 :. - reg += '([0-5]\\d)'; // 26 ss 0-5 and 0-9 - reg += ')?'; // ) end optional secs - reg += '('; // 27 ( optional millisecs - reg += '([:.])'; // 28 :. - reg += '(\\d{3})'; // 29 3 * 0-9 - reg += ')?'; // ) end optional millisecs - reg += '('; // 30 ( optional timezone matches - reg += '([+-]\\d{2}[:.]\\d{2}[:.]\\d{2})'; // 31 +- 0-9 0-9 :. 0-9 0-9 :. 0-9 0-9 e.g. +00:00:00 - reg += '|'; // or - reg += '([+-]\\d{2}[:.]\\d{2})'; // 32 +- 0-9 0-9 :. 0-9 0-9 e.g. +00:00 - reg += '|'; // or - reg += '([+-]\\d{6})'; // 33 +- 6 * 0-9 e.g. +000000 - reg += '|'; // or - reg += '([+-]\\d{4})'; // 34 +- 4 * 0-9 e.g. +0000 - reg += '|'; // or - reg += '(Z)'; // 35 Z - reg += '|'; // or - reg += '([+-]\\d{2})'; // 36 +- 0-9 0-9 e.g. +00 - reg += '|'; // or - reg += '('; // 37 ( string timezone - reg += '(\\s)'; // 38 optional space - reg += '(\\w{1,4})'; // 39 1-4 letters e.g UTC - reg += ')'; // ) end string timezone - reg += ')?'; // ) end optional timezone - - console.log('guessTimeFormat: time format regex: ' + reg); - - match = time.match(new RegExp(reg)); - // console.log(match); - if (match) { - // add the standard data and time - if (match[2] !== undefined) { - // match yyyy-[MM MMM]-dd - format += 'yyyy'; - format += match[4]; - if (match[6] !== undefined) { - format += 'MM'; - } else if (match[7] !== undefined) { - format += 'MMM'; - } - format += match[8]; - format += 'dd'; - } else if (match[10] !== undefined) { - // match dd-MM[M]-yyyy or MM[M]-dd-yyyy - - if (match[13] !== undefined) { - // found a word as the first part - // e.g., Jan 01 2000 - format += 'MMM'; - format += match[14]; - format += 'dd'; - } else if (match[17] !== undefined) { - // found a word as the second part - // e.g., 01 Jan 2000 - format += 'dd'; - format += match[14]; - format += 'MMM'; - } else { - // check to see if the first number is greater than 12 - // e.g., 24/03/1981 - // this is a guess, but is only thing we can do - // with one line from the data set - if (match[12] !== undefined && +match[12] > 12) { - format += 'dd'; - format += match[14]; - format += 'MM'; - } else { - // default to US format. - format += 'MM'; - format += match[14]; - format += 'dd'; - } - } - - format += match[18]; - format += 'yyyy'; - } - - // optional T or space splitter - // wrap T in single quotes - format += match[20] === 'T' ? "'" + match[20] + "'" : match[20]; - format += 'HH'; - format += match[22]; - format += 'mm'; - - // add optional secs - if (match[24] !== undefined) { - format += match[25]; - format += 'ss'; - } - - // add optional millisecs - if (match[27] !== undefined) { - // .000 - format += match[28]; - format += 'SSS'; - } - - // add optional time zone - if (match[31] !== undefined) { - // +00:00:00 - format += 'XXXXX'; - } else if (match[32] !== undefined) { - // +00:00 - format += 'XXX'; - } else if (match[33] !== undefined) { - // +000000 - format += 'XXXX'; - } else if (match[34] !== undefined) { - // +0000 - format += 'Z'; - } else if (match[35] !== undefined || match[36] !== undefined) { - // Z or +00 - format += 'X'; - } else if (match[37] !== undefined) { - // UTC - if (match[38] !== undefined) { - // add optional space char - format += match[38]; - } - // add time zone name, up to 4 chars - for (let i = 0; i < match[39].length; i++) { - format += 'z'; - } - } - matched = true; - } - } - } else { - // time field is a number, so probably epoch or epoch_ms - if (time > 10000000000) { - // probably milliseconds - format = 'epoch_ms'; - } else { - // probably seconds - format = 'epoch'; - } - matched = true; - } - - if (matched) { - console.log('guessTimeFormat: guessed time format: ', format); - } else { - console.log('guessTimeFormat: time format could not be guessed from: ' + time); - } - - return format; -} - // add commas to large numbers // Number.toLocaleString is not supported on safari export function toLocaleString(x) { diff --git a/x-pack/plugins/ml/public/application/util/string_utils.test.ts b/x-pack/plugins/ml/public/application/util/string_utils.test.ts new file mode 100644 index 0000000000000..d940fce2ee1d5 --- /dev/null +++ b/x-pack/plugins/ml/public/application/util/string_utils.test.ts @@ -0,0 +1,193 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { + replaceStringTokens, + detectorToString, + sortByKey, + toLocaleString, + mlEscape, + escapeForElasticsearchQuery, +} from './string_utils'; + +describe('ML - string utils', () => { + describe('replaceStringTokens', () => { + const testRecord = { + job_id: 'test_job', + result_type: 'record', + probability: 0.0191711, + record_score: 4.3, + bucket_span: 300, + detector_index: 0, + timestamp: 1454890500000, + function: 'mean', + function_description: 'mean', + field_name: 'responsetime', + user: "Des O'Connor", + testfield1: 'test$tring=[+-?]', + testfield2: '{<()>}', + testfield3: 'host=\\\\test@uk.dev', + }; + + test('returns correct values without URI encoding', () => { + const result = replaceStringTokens('user=$user$,time=$timestamp$', testRecord, false); + expect(result).toBe("user=Des O'Connor,time=1454890500000"); + }); + + test('returns correct values for missing token without URI encoding', () => { + const result = replaceStringTokens('user=$username$,time=$timestamp$', testRecord, false); + expect(result).toBe('user=$username$,time=1454890500000'); + }); + + test('returns correct values with URI encoding', () => { + const testString1 = 'https://www.google.co.uk/webhp#q=$testfield1$'; + const testString2 = 'https://www.google.co.uk/webhp#q=$testfield2$'; + const testString3 = 'https://www.google.co.uk/webhp#q=$testfield3$'; + const testString4 = 'https://www.google.co.uk/webhp#q=$user$'; + + const result1 = replaceStringTokens(testString1, testRecord, true); + const result2 = replaceStringTokens(testString2, testRecord, true); + const result3 = replaceStringTokens(testString3, testRecord, true); + const result4 = replaceStringTokens(testString4, testRecord, true); + + expect(result1).toBe('https://www.google.co.uk/webhp#q=test%24tring%3D%5B%2B-%3F%5D'); + expect(result2).toBe('https://www.google.co.uk/webhp#q=%7B%3C()%3E%7D'); + expect(result3).toBe('https://www.google.co.uk/webhp#q=host%3D%5C%5Ctest%40uk.dev'); + expect(result4).toBe("https://www.google.co.uk/webhp#q=Des%20O'Connor"); + }); + + test('returns correct values for missing token with URI encoding', () => { + const testString = 'https://www.google.co.uk/webhp#q=$username$&time=$timestamp$'; + const result = replaceStringTokens(testString, testRecord, true); + expect(result).toBe('https://www.google.co.uk/webhp#q=$username$&time=1454890500000'); + }); + }); + + describe('detectorToString', () => { + test('returns the correct descriptions for detectors', () => { + const detector1 = { + function: 'count', + }; + + const detector2 = { + function: 'count', + by_field_name: 'airline', + use_null: false, + }; + + const detector3 = { + function: 'mean', + field_name: 'CPUUtilization', + partition_field_name: 'region', + by_field_name: 'host', + over_field_name: 'user', + exclude_frequent: 'all', + }; + + expect(detectorToString(detector1)).toBe('count'); + expect(detectorToString(detector2)).toBe('count by airline use_null=false'); + expect(detectorToString(detector3)).toBe( + 'mean(CPUUtilization) by host over user partition_field_name=region exclude_frequent=all' + ); + }); + }); + + describe('sortByKey', () => { + const obj = { + zebra: 'stripes', + giraffe: 'neck', + elephant: 'trunk', + }; + + const valueComparator = function(value: string) { + return value; + }; + + test('returns correct ordering with default comparator', () => { + const result = sortByKey(obj, false); + const keys = Object.keys(result); + expect(keys[0]).toBe('elephant'); + expect(keys[1]).toBe('giraffe'); + expect(keys[2]).toBe('zebra'); + }); + + test('returns correct ordering with default comparator and order reversed', () => { + const result = sortByKey(obj, true); + const keys = Object.keys(result); + expect(keys[0]).toBe('zebra'); + expect(keys[1]).toBe('giraffe'); + expect(keys[2]).toBe('elephant'); + }); + + test('returns correct ordering with comparator', () => { + const result = sortByKey(obj, false, valueComparator); + const keys = Object.keys(result); + expect(keys[0]).toBe('giraffe'); + expect(keys[1]).toBe('zebra'); + expect(keys[2]).toBe('elephant'); + }); + + test('returns correct ordering with comparator and order reversed', () => { + const result = sortByKey(obj, true, valueComparator); + const keys = Object.keys(result); + expect(keys[0]).toBe('elephant'); + expect(keys[1]).toBe('zebra'); + expect(keys[2]).toBe('giraffe'); + }); + }); + + describe('toLocaleString', () => { + test('returns correct comma placement for large numbers', () => { + expect(toLocaleString(1)).toBe('1'); + expect(toLocaleString(10)).toBe('10'); + expect(toLocaleString(100)).toBe('100'); + expect(toLocaleString(1000)).toBe('1,000'); + expect(toLocaleString(10000)).toBe('10,000'); + expect(toLocaleString(100000)).toBe('100,000'); + expect(toLocaleString(1000000)).toBe('1,000,000'); + expect(toLocaleString(10000000)).toBe('10,000,000'); + expect(toLocaleString(100000000)).toBe('100,000,000'); + expect(toLocaleString(1000000000)).toBe('1,000,000,000'); + }); + }); + + describe('mlEscape', () => { + test('returns correct escaping of characters', () => { + expect(mlEscape('foo&bar')).toBe('foo&bar'); + expect(mlEscape('foo<bar')).toBe('foo<bar'); + expect(mlEscape('foo>bar')).toBe('foo>bar'); + expect(mlEscape('foo"bar')).toBe('foo"bar'); + expect(mlEscape("foo'bar")).toBe('foo'bar'); + expect(mlEscape('foo/bar')).toBe('foo/bar'); + }); + }); + + describe('escapeForElasticsearchQuery', () => { + test('returns correct escaping of reserved elasticsearch characters', () => { + expect(escapeForElasticsearchQuery('foo+bar')).toBe('foo\\+bar'); + expect(escapeForElasticsearchQuery('foo-bar')).toBe('foo\\-bar'); + expect(escapeForElasticsearchQuery('foo=bar')).toBe('foo\\=bar'); + expect(escapeForElasticsearchQuery('foo&&bar')).toBe('foo\\&\\&bar'); + expect(escapeForElasticsearchQuery('foo||bar')).toBe('foo\\|\\|bar'); + expect(escapeForElasticsearchQuery('foo>bar')).toBe('foo\\>bar'); + expect(escapeForElasticsearchQuery('foo<bar')).toBe('foo\\<bar'); + expect(escapeForElasticsearchQuery('foo!bar')).toBe('foo\\!bar'); + expect(escapeForElasticsearchQuery('foo(bar')).toBe('foo\\(bar'); + expect(escapeForElasticsearchQuery('foo)bar')).toBe('foo\\)bar'); + expect(escapeForElasticsearchQuery('foo{bar')).toBe('foo\\{bar'); + expect(escapeForElasticsearchQuery('foo[bar')).toBe('foo\\[bar'); + expect(escapeForElasticsearchQuery('foo]bar')).toBe('foo\\]bar'); + expect(escapeForElasticsearchQuery('foo^bar')).toBe('foo\\^bar'); + expect(escapeForElasticsearchQuery('foo"bar')).toBe('foo\\"bar'); + expect(escapeForElasticsearchQuery('foo~bar')).toBe('foo\\~bar'); + expect(escapeForElasticsearchQuery('foo*bar')).toBe('foo\\*bar'); + expect(escapeForElasticsearchQuery('foo?bar')).toBe('foo\\?bar'); + expect(escapeForElasticsearchQuery('foo:bar')).toBe('foo\\:bar'); + expect(escapeForElasticsearchQuery('foo\\bar')).toBe('foo\\\\bar'); + expect(escapeForElasticsearchQuery('foo/bar')).toBe('foo\\/bar'); + }); + }); +}); From 7cb3ee44eaeae29edcfe39b17140040a16c8ad2e Mon Sep 17 00:00:00 2001 From: Phillip Burch <phillip.burch@live.com> Date: Tue, 14 Apr 2020 12:13:44 -0500 Subject: [PATCH 097/102] Add help text to form fields (#63165) Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../public/components/alerting/metrics/expression.tsx | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/x-pack/plugins/infra/public/components/alerting/metrics/expression.tsx b/x-pack/plugins/infra/public/components/alerting/metrics/expression.tsx index 2e43ede2480ce..2430fe78e2053 100644 --- a/x-pack/plugins/infra/public/components/alerting/metrics/expression.tsx +++ b/x-pack/plugins/infra/public/components/alerting/metrics/expression.tsx @@ -264,10 +264,10 @@ export const Expressions: React.FC<Props> = props => { <EuiFormRow label={i18n.translate('xpack.infra.metrics.alertFlyout.filterLabel', { - defaultMessage: 'Filter', + defaultMessage: 'Filter (optional)', })} helpText={i18n.translate('xpack.infra.metrics.alertFlyout.filterHelpText', { - defaultMessage: 'Filter help text', + defaultMessage: 'Use a KQL expression to limit the scope of your alert trigger.', })} fullWidth compressed @@ -284,10 +284,11 @@ export const Expressions: React.FC<Props> = props => { {alertsContext.metadata && ( <EuiFormRow label={i18n.translate('xpack.infra.metrics.alertFlyout.createAlertPerText', { - defaultMessage: 'Create alert per', + defaultMessage: 'Create alert per (optional)', })} helpText={i18n.translate('xpack.infra.metrics.alertFlyout.createAlertPerHelpText', { - defaultMessage: 'Create alert help text', + defaultMessage: + 'Create an alert for every unique value. For example: "host.id" or "cloud.region".', })} fullWidth compressed From a4464c22ba90cdc7243e1116fc64adc1d5ade355 Mon Sep 17 00:00:00 2001 From: Paul Tavares <56442535+paul-tavares@users.noreply.github.com> Date: Tue, 14 Apr 2020 13:36:54 -0400 Subject: [PATCH 098/102] [Ingest][Endpoint] Add Ingest rest api response types for use in Endpoint (#63373) * Added REST Response types to datasouces * Adjust Types in Endpoint to reference those from Ingest * Remove un-used endpoint type --- .../store/policy_details/middleware.ts | 4 +-- .../endpoint/store/policy_list/middleware.ts | 4 +-- .../store/policy_list/services/ingest.ts | 14 +++++----- .../store/policy_list/test_mock_utils.ts | 6 ++--- .../public/applications/endpoint/types.ts | 27 +++++++------------ .../common/types/rest_spec/datasource.ts | 17 ++++++++---- 6 files changed, 36 insertions(+), 36 deletions(-) diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts index a00ce255cbac4..2581ab37f5677 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_details/middleware.ts @@ -8,7 +8,7 @@ import { MiddlewareFactory, PolicyData, PolicyDetailsState, - UpdateDatasourceResponse, + UpdatePolicyResponse, } from '../../types'; import { policyIdFromParams, isOnPolicyDetailsPage, policyDetails } from './selectors'; import { generatePolicy } from '../../models/policy'; @@ -77,7 +77,7 @@ export const policyDetailsMiddlewareFactory: MiddlewareFactory<PolicyDetailsStat } else if (action.type === 'userClickedPolicyDetailsSaveButton') { const { id, revision, ...updatedPolicyItem } = policyDetails(state) as PolicyData; - let apiResponse: UpdateDatasourceResponse; + let apiResponse: UpdatePolicyResponse; try { apiResponse = await sendPutDatasource(http, id, updatedPolicyItem); } catch (error) { diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts index c073d26a676f0..cc771a4619e78 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/middleware.ts @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { MiddlewareFactory, PolicyListState, GetDatasourcesResponse } from '../../types'; +import { GetPolicyListResponse, MiddlewareFactory, PolicyListState } from '../../types'; import { sendGetEndpointSpecificDatasources } from './services/ingest'; import { isOnPolicyListPage, urlSearchParams } from './selectors'; @@ -18,7 +18,7 @@ export const policyListMiddlewareFactory: MiddlewareFactory<PolicyListState> = c if (action.type === 'userChangedUrl' && isOnPolicyListPage(state)) { const { page_index: pageIndex, page_size: pageSize } = urlSearchParams(state); - let response: GetDatasourcesResponse; + let response: GetPolicyListResponse; try { response = await sendGetEndpointSpecificDatasources(http, { diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts index bfbb5f94e8950..5fccb01d1ad35 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/services/ingest.ts @@ -11,9 +11,9 @@ import { } from '../../../../../../../ingest_manager/common'; import { NewPolicyData, - GetDatasourcesResponse, - GetDatasourceResponse, - UpdateDatasourceResponse, + GetPolicyListResponse, + GetPolicyResponse, + UpdatePolicyResponse, } from '../../../types'; const INGEST_API_ROOT = `/api/ingest_manager`; @@ -30,8 +30,8 @@ const INGEST_API_FLEET_AGENT_STATUS = `${INGEST_API_FLEET}/agent-status`; export const sendGetEndpointSpecificDatasources = ( http: HttpStart, options: HttpFetchOptions & Partial<GetDatasourcesRequest> = {} -): Promise<GetDatasourcesResponse> => { - return http.get<GetDatasourcesResponse>(INGEST_API_DATASOURCES, { +): Promise<GetPolicyListResponse> => { + return http.get<GetPolicyListResponse>(INGEST_API_DATASOURCES, { ...options, query: { ...options.query, @@ -53,7 +53,7 @@ export const sendGetDatasource = ( datasourceId: string, options?: HttpFetchOptions ) => { - return http.get<GetDatasourceResponse>(`${INGEST_API_DATASOURCES}/${datasourceId}`, options); + return http.get<GetPolicyResponse>(`${INGEST_API_DATASOURCES}/${datasourceId}`, options); }; /** @@ -69,7 +69,7 @@ export const sendPutDatasource = ( datasourceId: string, datasource: NewPolicyData, options: Exclude<HttpFetchOptions, 'body'> = {} -): Promise<UpdateDatasourceResponse> => { +): Promise<UpdatePolicyResponse> => { return http.put(`${INGEST_API_DATASOURCES}/${datasourceId}`, { ...options, body: JSON.stringify(datasource), diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts index 0d41ae0d76da4..20d5a637182d2 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/policy_list/test_mock_utils.ts @@ -8,7 +8,7 @@ import { HttpStart } from 'kibana/public'; import { Dispatch } from 'redux'; import { INGEST_API_DATASOURCES } from './services/ingest'; import { EndpointDocGenerator } from '../../../../../common/generate_data'; -import { AppAction, GetDatasourcesResponse, GlobalState, MiddlewareFactory } from '../../types'; +import { AppAction, GetPolicyListResponse, GlobalState, MiddlewareFactory } from '../../types'; const generator = new EndpointDocGenerator('policy-list'); @@ -19,13 +19,13 @@ const generator = new EndpointDocGenerator('policy-list'); */ export const setPolicyListApiMockImplementation = ( mockedHttpService: jest.Mocked<HttpStart>, - responseItems: GetDatasourcesResponse['items'] = [generator.generatePolicyDatasource()] + responseItems: GetPolicyListResponse['items'] = [generator.generatePolicyDatasource()] ): void => { mockedHttpService.get.mockImplementation((...args) => { const [path] = args; if (typeof path === 'string') { if (path === INGEST_API_DATASOURCES) { - return Promise.resolve<GetDatasourcesResponse>({ + return Promise.resolve<GetPolicyListResponse>({ items: responseItems, total: 10, page: 1, diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts index 54afbf220944e..015468f84e740 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/types.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/types.ts @@ -17,11 +17,14 @@ import { import { EndpointPluginStartDependencies } from '../../plugin'; import { AppAction } from './store/action'; import { CoreStart } from '../../../../../../src/core/public'; -import { Datasource, NewDatasource } from '../../../../ingest_manager/common/types/models'; import { + Datasource, + NewDatasource, GetAgentStatusResponse, - CreateDatasourceResponse, -} from '../../../../ingest_manager/common/types/rest_spec'; + GetDatasourcesResponse, + GetOneDatasourceResponse, + UpdateDatasourceResponse, +} from '../../../../ingest_manager/common'; export { AppAction }; export type MiddlewareFactory<S = GlobalState> = ( @@ -335,24 +338,14 @@ export interface AlertingIndexUIQueryParams { filters?: string; } -export interface GetDatasourcesResponse { +export interface GetPolicyListResponse extends GetDatasourcesResponse { items: PolicyData[]; - total: number; - page: number; - perPage: number; - success: boolean; } -export interface GetDatasourceResponse { +export interface GetPolicyResponse extends GetOneDatasourceResponse { item: PolicyData; - success: boolean; } -export type UpdateDatasourceResponse = CreateDatasourceResponse & { +export interface UpdatePolicyResponse extends UpdateDatasourceResponse { item: PolicyData; -}; - -/** - * The PageId type is used for the payload when firing userNavigatedToPage actions - */ -export type PageId = 'alertsPage' | 'managementPage' | 'policyListPage'; +} diff --git a/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts b/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts index 66f734b904cfc..61f1f15d49259 100644 --- a/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts +++ b/x-pack/plugins/ingest_manager/common/types/rest_spec/datasource.ts @@ -13,17 +13,22 @@ export interface GetDatasourcesRequest { }; } +export interface GetDatasourcesResponse { + items: Datasource[]; + total: number; + page: number; + perPage: number; + success: boolean; +} + export interface GetOneDatasourceRequest { params: { datasourceId: string; }; } -export interface GetDatasourcesResponse { - items: Datasource[]; - total: number; - page: number; - perPage: number; +export interface GetOneDatasourceResponse { + item: Datasource; success: boolean; } @@ -40,6 +45,8 @@ export type UpdateDatasourceRequest = GetOneDatasourceRequest & { body: NewDatasource; }; +export type UpdateDatasourceResponse = CreateDatasourceResponse; + export interface DeleteDatasourcesRequest { body: { datasourceIds: string[]; From 959a0e5d3de1a6d7b9790aa59fba31e19f115a19 Mon Sep 17 00:00:00 2001 From: James Gowdy <jgowdy@elastic.co> Date: Tue, 14 Apr 2020 18:57:26 +0100 Subject: [PATCH 099/102] [ML] Listing global calendars on the job management page (#63124) * [ML] Listing global calendars on the job management page * tiny refactor Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../plugins/ml/server/models/job_service/jobs.ts | 15 ++++++++++++--- 1 file changed, 12 insertions(+), 3 deletions(-) diff --git a/x-pack/plugins/ml/server/models/job_service/jobs.ts b/x-pack/plugins/ml/server/models/job_service/jobs.ts index edcabcac93c2a..6024ecf4925e6 100644 --- a/x-pack/plugins/ml/server/models/job_service/jobs.ts +++ b/x-pack/plugins/ml/server/models/job_service/jobs.ts @@ -16,6 +16,7 @@ import { DatafeedWithStats, CombinedJobWithStats, } from '../../../common/types/anomaly_detection_jobs'; +import { GLOBAL_CALENDAR } from '../../../common/constants/calendars'; import { datafeedsProvider, MlDatafeedsResponse, MlDatafeedsStatsResponse } from './datafeeds'; import { jobAuditMessagesProvider } from '../job_audit_messages'; import { resultsServiceProvider } from '../results_service'; @@ -227,6 +228,8 @@ export function jobsProvider(callAsCurrentUser: APICaller) { const groups: { [jobId: string]: string[] } = {}; const datafeeds: { [id: string]: DatafeedWithStats } = {}; const calendarsByJobId: { [jobId: string]: string[] } = {}; + const globalCalendars: string[] = []; + const requests: [ Promise<MlJobsResponse>, Promise<MlJobsStatsResponse>, @@ -298,7 +301,9 @@ export function jobsProvider(callAsCurrentUser: APICaller) { if (calendarResults) { calendarResults.forEach(cal => { cal.job_ids.forEach(id => { - if (groups[id]) { + if (id === GLOBAL_CALENDAR) { + globalCalendars.push(cal.calendar_id); + } else if (groups[id]) { groups[id].forEach(jId => { if (calendarsByJobId[jId] !== undefined) { calendarsByJobId[jId].push(cal.calendar_id); @@ -325,8 +330,12 @@ export function jobsProvider(callAsCurrentUser: APICaller) { jobResults.jobs.forEach(job => { const tempJob = job as CombinedJobWithStats; - if (calendarsByJobId[tempJob.job_id].length) { - tempJob.calendars = calendarsByJobId[tempJob.job_id]; + const calendars: string[] = [ + ...(calendarsByJobId[tempJob.job_id] || []), + ...(globalCalendars || []), + ]; + if (calendars.length) { + tempJob.calendars = calendars; } if (jobStatsResults && jobStatsResults.jobs) { From 2b4c3003aba51153ccf64f2c6e46239390d3dbdc Mon Sep 17 00:00:00 2001 From: James Gowdy <jgowdy@elastic.co> Date: Tue, 14 Apr 2020 18:58:22 +0100 Subject: [PATCH 100/102] [ML] Improving parsing of large uploaded files (#62970) * [ML] Improving parsing of large uploaded files * small clean up * increasing max to 1GB * adding comments Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../common/constants/file_datavisualizer.ts | 4 +- .../ml/common/types/file_datavisualizer.ts | 4 +- .../file_datavisualizer_view.js | 28 +++++------ .../components/import_view/import_view.js | 4 +- .../import_view/importer/importer.ts | 48 ++++++++++++++++--- .../import_view/importer/message_importer.ts | 34 ++++++------- .../import_view/importer/ndjson_importer.ts | 35 ++++++++++---- .../file_based/components/utils/index.ts | 1 - .../file_based/components/utils/utils.ts | 22 ++++----- 9 files changed, 113 insertions(+), 67 deletions(-) diff --git a/x-pack/plugins/ml/common/constants/file_datavisualizer.ts b/x-pack/plugins/ml/common/constants/file_datavisualizer.ts index 81d51bfa25816..675247af2db99 100644 --- a/x-pack/plugins/ml/common/constants/file_datavisualizer.ts +++ b/x-pack/plugins/ml/common/constants/file_datavisualizer.ts @@ -4,8 +4,8 @@ * you may not use this file except in compliance with the Elastic License. */ -export const MAX_BYTES = 104857600; -export const ABSOLUTE_MAX_BYTES = MAX_BYTES * 5; +export const MAX_BYTES = 104857600; // 100MB +export const ABSOLUTE_MAX_BYTES = 1073741274; // 1GB export const FILE_SIZE_DISPLAY_FORMAT = '0,0.[0] b'; // Value to use in the Elasticsearch index mapping meta data to identify the diff --git a/x-pack/plugins/ml/common/types/file_datavisualizer.ts b/x-pack/plugins/ml/common/types/file_datavisualizer.ts index f771547b97811..c997a4e24f868 100644 --- a/x-pack/plugins/ml/common/types/file_datavisualizer.ts +++ b/x-pack/plugins/ml/common/types/file_datavisualizer.ts @@ -67,13 +67,15 @@ export interface ImportResponse { export interface ImportFailure { item: number; reason: string; - doc: Doc; + doc: ImportDoc; } export interface Doc { message: string; } +export type ImportDoc = Doc | string; + export interface Settings { pipeline?: string; index: string; diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/file_datavisualizer_view/file_datavisualizer_view.js b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/file_datavisualizer_view/file_datavisualizer_view.js index d1b615a878b2b..c73ab4b9e11c7 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/file_datavisualizer_view/file_datavisualizer_view.js +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/file_datavisualizer_view/file_datavisualizer_view.js @@ -24,14 +24,11 @@ import { readFile, createUrlOverrides, processResults, - reduceData, hasImportPermission, } from '../utils'; import { MODE } from './constants'; -const UPLOAD_SIZE_MB = 5; - export class FileDataVisualizerView extends Component { constructor(props) { super(props); @@ -40,6 +37,7 @@ export class FileDataVisualizerView extends Component { files: {}, fileName: '', fileContents: '', + data: [], fileSize: 0, fileTooLarge: false, fileCouldNotBeRead: false, @@ -79,6 +77,7 @@ export class FileDataVisualizerView extends Component { loaded: false, fileName: '', fileContents: '', + data: [], fileSize: 0, fileTooLarge: false, fileCouldNotBeRead: false, @@ -97,15 +96,15 @@ export class FileDataVisualizerView extends Component { async loadFile(file) { if (file.size <= this.maxFileUploadBytes) { try { - const fileContents = await readFile(file); - const data = fileContents.data; + const { data, fileContents } = await readFile(file); this.setState({ - fileContents: data, + data, + fileContents, fileName: file.name, fileSize: file.size, }); - await this.loadSettings(data); + await this.analyzeFile(fileContents); } catch (error) { this.setState({ loaded: false, @@ -124,14 +123,9 @@ export class FileDataVisualizerView extends Component { } } - async loadSettings(data, overrides, isRetry = false) { + async analyzeFile(fileContents, overrides, isRetry = false) { try { - // reduce the amount of data being sent to the endpoint - // 5MB should be enough to contain 1000 lines - const lessData = reduceData(data, UPLOAD_SIZE_MB); - console.log('overrides', overrides); - const { analyzeFile } = ml.fileDatavisualizer; - const resp = await analyzeFile(lessData, overrides); + const resp = await ml.fileDatavisualizer.analyzeFile(fileContents, overrides); const serverSettings = processResults(resp); const serverOverrides = resp.overrides; @@ -198,7 +192,7 @@ export class FileDataVisualizerView extends Component { loading: true, loaded: false, }); - this.loadSettings(data, this.previousOverrides, true); + this.analyzeFile(fileContents, this.previousOverrides, true); } } } @@ -240,7 +234,7 @@ export class FileDataVisualizerView extends Component { }, () => { const formattedOverrides = createUrlOverrides(overrides, this.originalSettings); - this.loadSettings(this.state.fileContents, formattedOverrides); + this.analyzeFile(this.state.fileContents, formattedOverrides); } ); }; @@ -261,6 +255,7 @@ export class FileDataVisualizerView extends Component { results, explanation, fileContents, + data, fileName, fileSize, fileTooLarge, @@ -339,6 +334,7 @@ export class FileDataVisualizerView extends Component { results={results} fileName={fileName} fileContents={fileContents} + data={data} indexPatterns={this.props.indexPatterns} kibanaConfig={this.props.kibanaConfig} showBottomBar={this.showBottomBar} diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/import_view.js b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/import_view.js index 4c9579bfd4b46..2bf7bbeb641d0 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/import_view.js +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/import_view.js @@ -94,7 +94,7 @@ export class ImportView extends Component { // TODO - sort this function out. it's a mess async import() { - const { fileContents, results, indexPatterns, kibanaConfig, showBottomBar } = this.props; + const { data, results, indexPatterns, kibanaConfig, showBottomBar } = this.props; const { format } = results; let { timeFieldName } = this.state; @@ -217,7 +217,7 @@ export class ImportView extends Component { if (success) { const importer = importerFactory(format, results, indexCreationSettings); if (importer !== undefined) { - const readResp = importer.read(fileContents, this.setReadProgress); + const readResp = importer.read(data, this.setReadProgress); success = readResp.success; this.setState({ readStatus: success ? IMPORT_STATUS.COMPLETE : IMPORT_STATUS.FAILED, diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/importer.ts b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/importer.ts index c97f1c147c454..718587ad15ad5 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/importer.ts +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/importer.ts @@ -9,7 +9,7 @@ import moment from 'moment'; import { i18n } from '@kbn/i18n'; import { ml } from '../../../../../services/ml_api_service'; import { - Doc, + ImportDoc, ImportFailure, ImportResponse, Mappings, @@ -20,6 +20,7 @@ import { const CHUNK_SIZE = 5000; const MAX_CHUNK_CHAR_COUNT = 1000000; const IMPORT_RETRIES = 5; +const STRING_CHUNKS_MB = 100; export interface ImportConfig { settings: Settings; @@ -34,12 +35,19 @@ export interface ImportResults { error?: any; } -export class Importer { +export interface CreateDocsResponse { + success: boolean; + remainder: number; + docs: ImportDoc[]; + error?: any; +} + +export abstract class Importer { private _settings: Settings; private _mappings: Mappings; private _pipeline: IngestPipeline; - protected _docArray: Doc[] = []; + protected _docArray: ImportDoc[] = []; constructor({ settings, mappings, pipeline }: ImportConfig) { this._settings = settings; @@ -47,7 +55,33 @@ export class Importer { this._pipeline = pipeline; } - async initializeImport(index: string) { + public read(data: ArrayBuffer) { + const decoder = new TextDecoder(); + const size = STRING_CHUNKS_MB * Math.pow(2, 20); + + // chop the data up into 100MB chunks for processing. + // if the chop produces a partial line at the end, a character "remainder" count + // is returned which is used to roll the next chunk back that many chars so + // it is included in the next chunk. + const parts = Math.ceil(data.byteLength / size); + let remainder = 0; + for (let i = 0; i < parts; i++) { + const byteArray = decoder.decode(data.slice(i * size - remainder, (i + 1) * size)); + const { success, docs, remainder: tempRemainder } = this._createDocs(byteArray); + if (success) { + this._docArray = this._docArray.concat(docs); + remainder = tempRemainder; + } else { + return { success: false }; + } + } + + return { success: true }; + } + + protected abstract _createDocs(t: string): CreateDocsResponse; + + public async initializeImport(index: string) { const settings = this._settings; const mappings = this._mappings; const pipeline = this._pipeline; @@ -75,7 +109,7 @@ export class Importer { return createIndexResp; } - async import( + public async import( id: string, index: string, pipelineId: string, @@ -201,8 +235,8 @@ function updatePipelineTimezone(ingestPipeline: IngestPipeline) { } } -function createDocumentChunks(docArray: Doc[]) { - const chunks: Doc[][] = []; +function createDocumentChunks(docArray: ImportDoc[]) { + const chunks: ImportDoc[][] = []; // chop docArray into 5000 doc chunks const tempChunks = chunk(docArray, CHUNK_SIZE); diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/message_importer.ts b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/message_importer.ts index 7ccc5a8d673f4..65be24d9e7be4 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/message_importer.ts +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/message_importer.ts @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { Importer, ImportConfig } from './importer'; +import { Importer, ImportConfig, CreateDocsResponse } from './importer'; import { Doc, FindFileStructureResponse, @@ -33,54 +33,54 @@ export class MessageImporter extends Importer { // multiline_start_pattern regex // if it does, it is a legitimate end of line and can be pushed into the list, // if not, it must be a newline char inside a field value, so keep looking. - read(text: string) { + protected _createDocs(text: string): CreateDocsResponse { + let remainder = 0; try { - const data: Doc[] = []; + const docs: Doc[] = []; let message = ''; let line = ''; for (let i = 0; i < text.length; i++) { const char = text[i]; if (char === '\n') { - message = this.processLine(data, message, line); + message = this._processLine(docs, message, line); line = ''; } else { line += char; } } - // the last line may have been missing a newline ending - if (line !== '') { - message = this.processLine(data, message, line); - } + remainder = line.length; - // add the last message to the list if not already done + // // add the last message to the list if not already done if (message !== '') { - this.addMessage(data, message); + this._addMessage(docs, message); } // remove first line if it is blank - if (data[0] && data[0].message === '') { - data.shift(); + if (docs[0] && docs[0].message === '') { + docs.shift(); } - this._docArray = data; - return { success: true, + docs, + remainder, }; } catch (error) { return { success: false, + docs: [], + remainder, error, }; } } - processLine(data: Doc[], message: string, line: string) { + private _processLine(data: Doc[], message: string, line: string) { if (this._excludeLinesRegex === null || line.match(this._excludeLinesRegex) === null) { if (this._multilineStartRegex === null || line.match(this._multilineStartRegex) !== null) { - this.addMessage(data, message); + this._addMessage(data, message); message = ''; } else if (data.length === 0) { // discard everything before the first line that is considered the first line of a message @@ -95,7 +95,7 @@ export class MessageImporter extends Importer { return message; } - addMessage(data: Doc[], message: string) { + private _addMessage(data: Doc[], message: string) { // if the message ended \r\n (Windows line endings) // then omit the \r as well as the \n for consistency message = message.replace(/\r$/, ''); diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/ndjson_importer.ts b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/ndjson_importer.ts index 7f5f37abc5246..17c9de8ef4558 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/ndjson_importer.ts +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/import_view/importer/ndjson_importer.ts @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { Importer, ImportConfig } from './importer'; +import { Importer, ImportConfig, CreateDocsResponse } from './importer'; import { FindFileStructureResponse } from '../../../../../../../common/types/file_datavisualizer'; export class NdjsonImporter extends Importer { @@ -12,27 +12,42 @@ export class NdjsonImporter extends Importer { super(settings); } - read(json: string) { + protected _createDocs(json: string): CreateDocsResponse { + let remainder = 0; try { const splitJson = json.split(/}\s*\n/); + const incompleteLastLine = json.match(/}\s*\n?$/) === null; - const ndjson: any[] = []; - for (let i = 0; i < splitJson.length; i++) { - if (splitJson[i] !== '') { - // note the extra } at the end of the line, adding back - // the one that was eaten in the split - ndjson.push(`${splitJson[i]}}`); + const docs: string[] = []; + if (splitJson.length) { + for (let i = 0; i < splitJson.length - 1; i++) { + if (splitJson[i] !== '') { + // note the extra } at the end of the line, adding back + // the one that was eaten in the split + docs.push(`${splitJson[i]}}`); + } } - } - this._docArray = ndjson; + const lastDoc = splitJson[splitJson.length - 1]; + if (lastDoc) { + if (incompleteLastLine === true) { + remainder = lastDoc.length; + } else { + docs.push(`${lastDoc}}`); + } + } + } return { success: true, + docs, + remainder, }; } catch (error) { return { success: false, + docs: [], + remainder, error, }; } diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/index.ts b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/index.ts index 0f0036a7c4616..492a797f7a2f2 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/index.ts +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/index.ts @@ -9,7 +9,6 @@ export { hasImportPermission, processResults, readFile, - reduceData, getMaxBytes, getMaxBytesFormatted, } from './utils'; diff --git a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/utils.ts b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/utils.ts index 0d2016b71ed83..ecef01aae0519 100644 --- a/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/utils.ts +++ b/x-pack/plugins/ml/public/application/datavisualizer/file_based/components/utils/utils.ts @@ -15,6 +15,7 @@ import { import { getMlConfig } from '../../../../util/dependency_cache'; const DEFAULT_LINES_TO_SAMPLE = 1000; +const UPLOAD_SIZE_MB = 5; const overrideDefaults = { timestampFormat: undefined, @@ -34,15 +35,22 @@ export function readFile(file: File) { return new Promise((resolve, reject) => { if (file && file.size) { const reader = new FileReader(); - reader.readAsText(file); + reader.readAsArrayBuffer(file); reader.onload = (() => { return () => { + const decoder = new TextDecoder(); const data = reader.result; - if (data === '') { + if (data === null || typeof data === 'string') { + return reject(); + } + const size = UPLOAD_SIZE_MB * Math.pow(2, 20); + const fileContents = decoder.decode(data.slice(0, size)); + + if (fileContents === '') { reject(); } else { - resolve({ data }); + resolve({ fileContents, data }); } }; })(); @@ -52,14 +60,6 @@ export function readFile(file: File) { }); } -export function reduceData(data: string, mb: number) { - // assuming ascii characters in the file where 1 char is 1 byte - // TODO - change this when other non UTF-8 formats are - // supported for the read data - const size = mb * Math.pow(2, 20); - return data.length >= size ? data.slice(0, size) : data; -} - export function getMaxBytes() { const maxBytes = getMlConfig().file_data_visualizer.max_file_size_bytes; return maxBytes < ABSOLUTE_MAX_BYTES ? maxBytes : ABSOLUTE_MAX_BYTES; From d275d7f4df60f2370671f4fef56ccc7b5436091b Mon Sep 17 00:00:00 2001 From: Steph Milovic <stephanie.milovic@elastic.co> Date: Tue, 14 Apr 2020 12:25:54 -0600 Subject: [PATCH 101/102] [SIEM] [Cases] Case container unit tests (#63376) --- .../public/containers/case/__mocks__/api.ts | 122 +++++ .../siem/public/containers/case/api.test.tsx | 463 ++++++++++++++++++ .../siem/public/containers/case/mock.ts | 307 ++++++++++++ .../siem/public/containers/case/types.ts | 2 +- .../case/use_bulk_update_case.test.tsx | 128 +++++ .../containers/case/use_bulk_update_case.tsx | 4 +- .../containers/case/use_delete_cases.test.tsx | 124 +++++ .../containers/case/use_delete_cases.tsx | 8 +- .../case/use_get_action_license.test.tsx | 89 ++++ .../case/use_get_action_license.tsx | 4 +- .../containers/case/use_get_case.test.tsx | 112 +++++ .../public/containers/case/use_get_case.tsx | 4 +- .../case/use_get_case_user_actions.test.tsx | 106 ++++ .../case/use_get_case_user_actions.tsx | 5 +- .../containers/case/use_get_cases.test.tsx | 202 ++++++++ .../public/containers/case/use_get_cases.tsx | 6 +- .../case/use_get_cases_status.test.tsx | 88 ++++ .../containers/case/use_get_cases_status.tsx | 2 +- .../case/use_get_reporters.test.tsx | 86 ++++ .../containers/case/use_get_reporters.tsx | 2 +- .../containers/case/use_get_tags.test.tsx | 74 +++ .../public/containers/case/use_get_tags.tsx | 4 +- .../containers/case/use_post_case.test.tsx | 96 ++++ .../public/containers/case/use_post_case.tsx | 2 +- .../containers/case/use_post_comment.test.tsx | 102 ++++ .../containers/case/use_post_comment.tsx | 2 +- .../case/use_post_push_to_service.test.tsx | 137 ++++++ .../case/use_post_push_to_service.tsx | 4 +- .../containers/case/use_update_case.test.tsx | 119 +++++ .../containers/case/use_update_case.tsx | 4 +- .../case/use_update_comment.test.tsx | 116 +++++ .../containers/case/use_update_comment.tsx | 2 +- .../case/components/__mock__/case_data.tsx | 226 --------- .../components/all_cases/columns.test.tsx | 2 +- .../case/components/all_cases/index.test.tsx | 2 +- .../pages/case/components/all_cases/index.tsx | 4 +- .../components/case_view/actions.test.tsx | 2 +- .../case/components/case_view/index.test.tsx | 22 +- .../case/components/case_view/translations.ts | 3 + .../user_action_tree/helpers.test.tsx | 2 +- .../user_action_tree/index.test.tsx | 2 +- .../components/user_action_tree/index.tsx | 2 +- .../user_action_title.test.tsx | 2 +- .../user_action_tree/user_action_title.tsx | 4 +- x-pack/plugins/case/common/api/cases/case.ts | 1 + 45 files changed, 2529 insertions(+), 271 deletions(-) create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/__mocks__/api.ts create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/api.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/mock.ts create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_case.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_post_case.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_update_case.test.tsx create mode 100644 x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.test.tsx delete mode 100644 x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx diff --git a/x-pack/legacy/plugins/siem/public/containers/case/__mocks__/api.ts b/x-pack/legacy/plugins/siem/public/containers/case/__mocks__/api.ts new file mode 100644 index 0000000000000..6d2cfb7147537 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/__mocks__/api.ts @@ -0,0 +1,122 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { + ActionLicense, + AllCases, + BulkUpdateStatus, + Case, + CasesStatus, + CaseUserActions, + FetchCasesProps, + SortFieldCase, +} from '../types'; +import { + actionLicenses, + allCases, + basicCase, + basicCaseCommentPatch, + basicCasePost, + casesStatus, + caseUserActions, + pushedCase, + respReporters, + serviceConnector, + tags, +} from '../mock'; +import { + CaseExternalServiceRequest, + CasePatchRequest, + CasePostRequest, + CommentRequest, + ServiceConnectorCaseParams, + ServiceConnectorCaseResponse, + User, +} from '../../../../../../../plugins/case/common/api'; + +export const getCase = async ( + caseId: string, + includeComments: boolean = true, + signal: AbortSignal +): Promise<Case> => { + return Promise.resolve(basicCase); +}; + +export const getCasesStatus = async (signal: AbortSignal): Promise<CasesStatus> => + Promise.resolve(casesStatus); + +export const getTags = async (signal: AbortSignal): Promise<string[]> => Promise.resolve(tags); + +export const getReporters = async (signal: AbortSignal): Promise<User[]> => + Promise.resolve(respReporters); + +export const getCaseUserActions = async ( + caseId: string, + signal: AbortSignal +): Promise<CaseUserActions[]> => Promise.resolve(caseUserActions); + +export const getCases = async ({ + filterOptions = { + search: '', + reporters: [], + status: 'open', + tags: [], + }, + queryParams = { + page: 1, + perPage: 5, + sortField: SortFieldCase.createdAt, + sortOrder: 'desc', + }, + signal, +}: FetchCasesProps): Promise<AllCases> => Promise.resolve(allCases); + +export const postCase = async (newCase: CasePostRequest, signal: AbortSignal): Promise<Case> => + Promise.resolve(basicCasePost); + +export const patchCase = async ( + caseId: string, + updatedCase: Pick<CasePatchRequest, 'description' | 'status' | 'tags' | 'title'>, + version: string, + signal: AbortSignal +): Promise<Case[]> => Promise.resolve([basicCase]); + +export const patchCasesStatus = async ( + cases: BulkUpdateStatus[], + signal: AbortSignal +): Promise<Case[]> => Promise.resolve(allCases.cases); + +export const postComment = async ( + newComment: CommentRequest, + caseId: string, + signal: AbortSignal +): Promise<Case> => Promise.resolve(basicCase); + +export const patchComment = async ( + caseId: string, + commentId: string, + commentUpdate: string, + version: string, + signal: AbortSignal +): Promise<Case> => Promise.resolve(basicCaseCommentPatch); + +export const deleteCases = async (caseIds: string[], signal: AbortSignal): Promise<boolean> => + Promise.resolve(true); + +export const pushCase = async ( + caseId: string, + push: CaseExternalServiceRequest, + signal: AbortSignal +): Promise<Case> => Promise.resolve(pushedCase); + +export const pushToService = async ( + connectorId: string, + casePushParams: ServiceConnectorCaseParams, + signal: AbortSignal +): Promise<ServiceConnectorCaseResponse> => Promise.resolve(serviceConnector); + +export const getActionLicense = async (signal: AbortSignal): Promise<ActionLicense[]> => + Promise.resolve(actionLicenses); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/api.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/api.test.tsx new file mode 100644 index 0000000000000..4f5655cc9f221 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/api.test.tsx @@ -0,0 +1,463 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { KibanaServices } from '../../lib/kibana'; +import { + deleteCases, + getActionLicense, + getCase, + getCases, + getCasesStatus, + getCaseUserActions, + getReporters, + getTags, + patchCase, + patchCasesStatus, + patchComment, + postCase, + postComment, + pushCase, + pushToService, +} from './api'; +import { + actionLicenses, + allCases, + basicCase, + allCasesSnake, + basicCaseSnake, + actionTypeExecutorResult, + pushedCaseSnake, + casesStatus, + casesSnake, + cases, + caseUserActions, + pushedCase, + pushSnake, + reporters, + respReporters, + serviceConnector, + casePushParams, + tags, + caseUserActionsSnake, + casesStatusSnake, +} from './mock'; +import { CASES_URL } from './constants'; +import { DEFAULT_FILTER_OPTIONS, DEFAULT_QUERY_PARAMS } from './use_get_cases'; +import * as i18n from './translations'; + +const abortCtrl = new AbortController(); +const mockKibanaServices = KibanaServices.get as jest.Mock; +jest.mock('../../lib/kibana'); + +const fetchMock = jest.fn(); +mockKibanaServices.mockReturnValue({ http: { fetch: fetchMock } }); + +describe('Case Configuration API', () => { + describe('deleteCases', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(''); + }); + const data = ['1', '2']; + + test('check url, method, signal', async () => { + await deleteCases(data, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}`, { + method: 'DELETE', + query: { ids: JSON.stringify(data) }, + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await deleteCases(data, abortCtrl.signal); + expect(resp).toEqual(''); + }); + }); + describe('getActionLicense', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(actionLicenses); + }); + test('check url, method, signal', async () => { + await getActionLicense(abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`/api/action/types`, { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getActionLicense(abortCtrl.signal); + expect(resp).toEqual(actionLicenses); + }); + }); + describe('getCase', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(basicCaseSnake); + }); + const data = basicCase.id; + + test('check url, method, signal', async () => { + await getCase(data, true, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/${basicCase.id}`, { + method: 'GET', + query: { includeComments: true }, + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getCase(data, true, abortCtrl.signal); + expect(resp).toEqual(basicCase); + }); + }); + describe('getCases', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(allCasesSnake); + }); + test('check url, method, signal', async () => { + await getCases({ + filterOptions: DEFAULT_FILTER_OPTIONS, + queryParams: DEFAULT_QUERY_PARAMS, + signal: abortCtrl.signal, + }); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/_find`, { + method: 'GET', + query: { + ...DEFAULT_QUERY_PARAMS, + reporters: [], + tags: [], + status: 'open', + }, + signal: abortCtrl.signal, + }); + }); + test('correctly applies filters', async () => { + await getCases({ + filterOptions: { + ...DEFAULT_FILTER_OPTIONS, + reporters: [...respReporters, { username: null, full_name: null, email: null }], + tags, + status: '', + search: 'hello', + }, + queryParams: DEFAULT_QUERY_PARAMS, + signal: abortCtrl.signal, + }); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/_find`, { + method: 'GET', + query: { + ...DEFAULT_QUERY_PARAMS, + reporters, + tags, + search: 'hello', + }, + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getCases({ + filterOptions: DEFAULT_FILTER_OPTIONS, + queryParams: DEFAULT_QUERY_PARAMS, + signal: abortCtrl.signal, + }); + expect(resp).toEqual({ ...allCases }); + }); + }); + describe('getCasesStatus', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(casesStatusSnake); + }); + test('check url, method, signal', async () => { + await getCasesStatus(abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/status`, { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getCasesStatus(abortCtrl.signal); + expect(resp).toEqual(casesStatus); + }); + }); + describe('getCaseUserActions', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(caseUserActionsSnake); + }); + + test('check url, method, signal', async () => { + await getCaseUserActions(basicCase.id, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/${basicCase.id}/user_actions`, { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getCaseUserActions(basicCase.id, abortCtrl.signal); + expect(resp).toEqual(caseUserActions); + }); + }); + describe('getReporters', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(respReporters); + }); + + test('check url, method, signal', async () => { + await getReporters(abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/reporters`, { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getReporters(abortCtrl.signal); + expect(resp).toEqual(respReporters); + }); + }); + describe('getTags', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(tags); + }); + + test('check url, method, signal', async () => { + await getTags(abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/tags`, { + method: 'GET', + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await getTags(abortCtrl.signal); + expect(resp).toEqual(tags); + }); + }); + describe('patchCase', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue([basicCaseSnake]); + }); + const data = { description: 'updated description' }; + test('check url, method, signal', async () => { + await patchCase(basicCase.id, data, basicCase.version, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}`, { + method: 'PATCH', + body: JSON.stringify({ + cases: [{ ...data, id: basicCase.id, version: basicCase.version }], + }), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await patchCase( + basicCase.id, + { description: 'updated description' }, + basicCase.version, + abortCtrl.signal + ); + expect(resp).toEqual({ ...[basicCase] }); + }); + }); + describe('patchCasesStatus', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(casesSnake); + }); + const data = [ + { + status: 'closed', + id: basicCase.id, + version: basicCase.version, + }, + ]; + + test('check url, method, signal', async () => { + await patchCasesStatus(data, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}`, { + method: 'PATCH', + body: JSON.stringify({ cases: data }), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await patchCasesStatus(data, abortCtrl.signal); + expect(resp).toEqual({ ...cases }); + }); + }); + describe('patchComment', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(basicCaseSnake); + }); + + test('check url, method, signal', async () => { + await patchComment( + basicCase.id, + basicCase.comments[0].id, + 'updated comment', + basicCase.comments[0].version, + abortCtrl.signal + ); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/${basicCase.id}/comments`, { + method: 'PATCH', + body: JSON.stringify({ + comment: 'updated comment', + id: basicCase.comments[0].id, + version: basicCase.comments[0].version, + }), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await patchComment( + basicCase.id, + basicCase.comments[0].id, + 'updated comment', + basicCase.comments[0].version, + abortCtrl.signal + ); + expect(resp).toEqual(basicCase); + }); + }); + describe('postCase', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(basicCaseSnake); + }); + const data = { + description: 'description', + tags: ['tag'], + title: 'title', + }; + + test('check url, method, signal', async () => { + await postCase(data, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}`, { + method: 'POST', + body: JSON.stringify(data), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await postCase(data, abortCtrl.signal); + expect(resp).toEqual(basicCase); + }); + }); + describe('postComment', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(basicCaseSnake); + }); + const data = { + comment: 'comment', + }; + + test('check url, method, signal', async () => { + await postComment(data, basicCase.id, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/${basicCase.id}/comments`, { + method: 'POST', + body: JSON.stringify(data), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await postComment(data, basicCase.id, abortCtrl.signal); + expect(resp).toEqual(basicCase); + }); + }); + describe('pushCase', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(pushedCaseSnake); + }); + + test('check url, method, signal', async () => { + await pushCase(basicCase.id, pushSnake, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`${CASES_URL}/${basicCase.id}/_push`, { + method: 'POST', + body: JSON.stringify(pushSnake), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await pushCase(basicCase.id, pushSnake, abortCtrl.signal); + expect(resp).toEqual(pushedCase); + }); + }); + describe('pushToService', () => { + beforeEach(() => { + fetchMock.mockClear(); + fetchMock.mockResolvedValue(actionTypeExecutorResult); + }); + const connectorId = 'connectorId'; + test('check url, method, signal', async () => { + await pushToService(connectorId, casePushParams, abortCtrl.signal); + expect(fetchMock).toHaveBeenCalledWith(`/api/action/${connectorId}/_execute`, { + method: 'POST', + body: JSON.stringify({ params: casePushParams }), + signal: abortCtrl.signal, + }); + }); + + test('happy path', async () => { + const resp = await pushToService(connectorId, casePushParams, abortCtrl.signal); + expect(resp).toEqual(serviceConnector); + }); + + test('unhappy path - serviceMessage', async () => { + const theError = 'the error'; + fetchMock.mockResolvedValue({ + ...actionTypeExecutorResult, + status: 'error', + serviceMessage: theError, + message: 'not it', + }); + await expect( + pushToService(connectorId, casePushParams, abortCtrl.signal) + ).rejects.toMatchObject({ message: theError }); + }); + + test('unhappy path - message', async () => { + const theError = 'the error'; + fetchMock.mockResolvedValue({ + ...actionTypeExecutorResult, + status: 'error', + message: theError, + }); + await expect( + pushToService(connectorId, casePushParams, abortCtrl.signal) + ).rejects.toMatchObject({ message: theError }); + }); + + test('unhappy path - no message', async () => { + const theError = i18n.ERROR_PUSH_TO_SERVICE; + fetchMock.mockResolvedValue({ + ...actionTypeExecutorResult, + status: 'error', + }); + await expect( + pushToService(connectorId, casePushParams, abortCtrl.signal) + ).rejects.toMatchObject({ message: theError }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/mock.ts b/x-pack/legacy/plugins/siem/public/containers/case/mock.ts new file mode 100644 index 0000000000000..0bda75e5bc9e0 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/mock.ts @@ -0,0 +1,307 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { ActionLicense, AllCases, Case, CasesStatus, CaseUserActions, Comment } from './types'; + +import { + CommentResponse, + ServiceConnectorCaseResponse, + Status, + UserAction, + UserActionField, + CaseResponse, + CasesStatusResponse, + CaseUserActionsResponse, + CasesResponse, + CasesFindResponse, +} from '../../../../../../plugins/case/common/api/cases'; +import { UseGetCasesState, DEFAULT_FILTER_OPTIONS, DEFAULT_QUERY_PARAMS } from './use_get_cases'; + +export const basicCaseId = 'basic-case-id'; +const basicCommentId = 'basic-comment-id'; +const basicCreatedAt = '2020-02-19T23:06:33.798Z'; +const basicUpdatedAt = '2020-02-20T15:02:57.995Z'; +const laterTime = '2020-02-28T15:02:57.995Z'; +export const elasticUser = { + fullName: 'Leslie Knope', + username: 'lknope', + email: 'leslie.knope@elastic.co', +}; + +export const tags: string[] = ['coke', 'pepsi']; + +export const basicComment: Comment = { + comment: 'Solve this fast!', + id: basicCommentId, + createdAt: basicCreatedAt, + createdBy: elasticUser, + pushedAt: null, + pushedBy: null, + updatedAt: null, + updatedBy: null, + version: 'WzQ3LDFc', +}; + +export const basicCase: Case = { + closedAt: null, + closedBy: null, + id: basicCaseId, + comments: [basicComment], + createdAt: basicCreatedAt, + createdBy: elasticUser, + description: 'Security banana Issue', + externalService: null, + status: 'open', + tags, + title: 'Another horrible breach!!', + totalComment: 1, + updatedAt: basicUpdatedAt, + updatedBy: elasticUser, + version: 'WzQ3LDFd', +}; + +export const basicCasePost: Case = { + ...basicCase, + updatedAt: null, + updatedBy: null, +}; + +export const basicCommentPatch: Comment = { + ...basicComment, + updatedAt: basicUpdatedAt, + updatedBy: { + username: 'elastic', + }, +}; + +export const basicCaseCommentPatch = { + ...basicCase, + comments: [basicCommentPatch], +}; + +export const casesStatus: CasesStatus = { + countClosedCases: 130, + countOpenCases: 20, +}; + +const basicPush = { + connectorId: 'connector_id', + connectorName: 'connector name', + externalId: 'external_id', + externalTitle: 'external title', + externalUrl: 'basicPush.com', + pushedAt: basicUpdatedAt, + pushedBy: elasticUser, +}; + +export const pushedCase: Case = { + ...basicCase, + externalService: basicPush, +}; + +export const serviceConnector: ServiceConnectorCaseResponse = { + number: '123', + incidentId: '444', + pushedDate: basicUpdatedAt, + url: 'connector.com', + comments: [ + { + commentId: basicCommentId, + pushedDate: basicUpdatedAt, + }, + ], +}; + +const basicAction = { + actionAt: basicCreatedAt, + actionBy: elasticUser, + oldValue: null, + newValue: 'what a cool value', + caseId: basicCaseId, + commentId: null, +}; + +export const casePushParams = { + actionBy: elasticUser, + caseId: basicCaseId, + createdAt: basicCreatedAt, + createdBy: elasticUser, + incidentId: null, + title: 'what a cool value', + commentId: null, + updatedAt: basicCreatedAt, + updatedBy: elasticUser, + description: 'nice', +}; +export const actionTypeExecutorResult = { + actionId: 'string', + status: 'ok', + data: serviceConnector, +}; + +export const cases: Case[] = [ + basicCase, + { ...pushedCase, id: '1', totalComment: 0, comments: [] }, + { ...pushedCase, updatedAt: laterTime, id: '2', totalComment: 0, comments: [] }, + { ...basicCase, id: '3', totalComment: 0, comments: [] }, + { ...basicCase, id: '4', totalComment: 0, comments: [] }, +]; + +export const allCases: AllCases = { + cases, + page: 1, + perPage: 5, + total: 10, + ...casesStatus, +}; +export const actionLicenses: ActionLicense[] = [ + { + id: '.servicenow', + name: 'ServiceNow', + enabled: true, + enabledInConfig: true, + enabledInLicense: true, + }, +]; + +// Snake case for mock api responses +export const elasticUserSnake = { + full_name: 'Leslie Knope', + username: 'lknope', + email: 'leslie.knope@elastic.co', +}; +export const basicCommentSnake: CommentResponse = { + ...basicComment, + comment: 'Solve this fast!', + id: basicCommentId, + created_at: basicCreatedAt, + created_by: elasticUserSnake, + pushed_at: null, + pushed_by: null, + updated_at: null, + updated_by: null, +}; + +export const basicCaseSnake: CaseResponse = { + ...basicCase, + status: 'open' as Status, + closed_at: null, + closed_by: null, + comments: [basicCommentSnake], + created_at: basicCreatedAt, + created_by: elasticUserSnake, + external_service: null, + updated_at: basicUpdatedAt, + updated_by: elasticUserSnake, +}; + +export const casesStatusSnake: CasesStatusResponse = { + count_closed_cases: 130, + count_open_cases: 20, +}; + +export const pushSnake = { + connector_id: 'connector_id', + connector_name: 'connector name', + external_id: 'external_id', + external_title: 'external title', + external_url: 'basicPush.com', +}; +const basicPushSnake = { + ...pushSnake, + pushed_at: basicUpdatedAt, + pushed_by: elasticUserSnake, +}; +export const pushedCaseSnake = { + ...basicCaseSnake, + external_service: basicPushSnake, +}; + +export const reporters: string[] = ['alexis', 'kim', 'maria', 'steph']; +export const respReporters = [ + { username: 'alexis', full_name: null, email: null }, + { username: 'kim', full_name: null, email: null }, + { username: 'maria', full_name: null, email: null }, + { username: 'steph', full_name: null, email: null }, +]; +export const casesSnake: CasesResponse = [ + basicCaseSnake, + { ...pushedCaseSnake, id: '1', totalComment: 0, comments: [] }, + { ...pushedCaseSnake, updated_at: laterTime, id: '2', totalComment: 0, comments: [] }, + { ...basicCaseSnake, id: '3', totalComment: 0, comments: [] }, + { ...basicCaseSnake, id: '4', totalComment: 0, comments: [] }, +]; + +export const allCasesSnake: CasesFindResponse = { + cases: casesSnake, + page: 1, + per_page: 5, + total: 10, + ...casesStatusSnake, +}; + +const basicActionSnake = { + action_at: basicCreatedAt, + action_by: elasticUserSnake, + old_value: null, + new_value: 'what a cool value', + case_id: basicCaseId, + comment_id: null, +}; +export const getUserActionSnake = (af: UserActionField, a: UserAction) => ({ + ...basicActionSnake, + action_id: `${af[0]}-${a}`, + action_field: af, + action: a, + comment_id: af[0] === 'comment' ? basicCommentId : null, + new_value: + a === 'push-to-service' && af[0] === 'pushed' + ? JSON.stringify(basicPushSnake) + : basicAction.newValue, +}); + +export const caseUserActionsSnake: CaseUserActionsResponse = [ + getUserActionSnake(['description'], 'create'), + getUserActionSnake(['comment'], 'create'), + getUserActionSnake(['description'], 'update'), +]; + +// user actions + +export const getUserAction = (af: UserActionField, a: UserAction) => ({ + ...basicAction, + actionId: `${af[0]}-${a}`, + actionField: af, + action: a, + commentId: af[0] === 'comment' ? basicCommentId : null, + newValue: + a === 'push-to-service' && af[0] === 'pushed' + ? JSON.stringify(basicPushSnake) + : basicAction.newValue, +}); + +export const caseUserActions: CaseUserActions[] = [ + getUserAction(['description'], 'create'), + getUserAction(['comment'], 'create'), + getUserAction(['description'], 'update'), +]; + +// components tests +export const useGetCasesMockState: UseGetCasesState = { + data: allCases, + loading: [], + selectedCases: [], + isError: false, + queryParams: DEFAULT_QUERY_PARAMS, + filterOptions: DEFAULT_FILTER_OPTIONS, +}; + +export const basicCaseClosed: Case = { + ...basicCase, + closedAt: '2020-02-25T23:06:33.798Z', + closedBy: elasticUser, + status: 'closed', +}; diff --git a/x-pack/legacy/plugins/siem/public/containers/case/types.ts b/x-pack/legacy/plugins/siem/public/containers/case/types.ts index d2a58e9eeeff4..e552f22b55fa4 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/types.ts +++ b/x-pack/legacy/plugins/siem/public/containers/case/types.ts @@ -31,7 +31,7 @@ export interface CaseUserActions { export interface CaseExternalService { pushedAt: string; - pushedBy: string; + pushedBy: ElasticUser; connectorId: string; connectorName: string; externalId: string; diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.test.tsx new file mode 100644 index 0000000000000..329fda10424a8 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.test.tsx @@ -0,0 +1,128 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useUpdateCases, UseUpdateCases } from './use_bulk_update_case'; +import { basicCase } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useUpdateCases', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCases>(() => + useUpdateCases() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoading: false, + isError: false, + isUpdated: false, + updateBulkStatus: result.current.updateBulkStatus, + dispatchResetIsUpdated: result.current.dispatchResetIsUpdated, + }); + }); + }); + + it('calls patchCase with correct arguments', async () => { + const spyOnPatchCases = jest.spyOn(api, 'patchCasesStatus'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCases>(() => + useUpdateCases() + ); + await waitForNextUpdate(); + + result.current.updateBulkStatus([basicCase], 'closed'); + await waitForNextUpdate(); + expect(spyOnPatchCases).toBeCalledWith( + [ + { + status: 'closed', + id: basicCase.id, + version: basicCase.version, + }, + ], + abortCtrl.signal + ); + }); + }); + + it('patch cases', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCases>(() => + useUpdateCases() + ); + await waitForNextUpdate(); + result.current.updateBulkStatus([basicCase], 'closed'); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isUpdated: true, + isLoading: false, + isError: false, + updateBulkStatus: result.current.updateBulkStatus, + dispatchResetIsUpdated: result.current.dispatchResetIsUpdated, + }); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCases>(() => + useUpdateCases() + ); + await waitForNextUpdate(); + result.current.updateBulkStatus([basicCase], 'closed'); + + expect(result.current.isLoading).toBe(true); + }); + }); + + it('dispatchResetIsUpdated resets is updated', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCases>(() => + useUpdateCases() + ); + + await waitForNextUpdate(); + result.current.updateBulkStatus([basicCase], 'closed'); + await waitForNextUpdate(); + expect(result.current.isUpdated).toBeTruthy(); + result.current.dispatchResetIsUpdated(); + expect(result.current.isUpdated).toBeFalsy(); + }); + }); + + it('unhappy path', async () => { + const spyOnPatchCases = jest.spyOn(api, 'patchCasesStatus'); + spyOnPatchCases.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCases>(() => + useUpdateCases() + ); + await waitForNextUpdate(); + result.current.updateBulkStatus([basicCase], 'closed'); + + expect(result.current).toEqual({ + isUpdated: false, + isLoading: false, + isError: true, + updateBulkStatus: result.current.updateBulkStatus, + dispatchResetIsUpdated: result.current.dispatchResetIsUpdated, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.tsx index 7d040c49f1971..d0cc4d99f8f9f 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_bulk_update_case.tsx @@ -51,12 +51,12 @@ const dataFetchReducer = (state: UpdateState, action: Action): UpdateState => { return state; } }; -interface UseUpdateCase extends UpdateState { +export interface UseUpdateCases extends UpdateState { updateBulkStatus: (cases: Case[], status: string) => void; dispatchResetIsUpdated: () => void; } -export const useUpdateCases = (): UseUpdateCase => { +export const useUpdateCases = (): UseUpdateCases => { const [state, dispatch] = useReducer(dataFetchReducer, { isLoading: false, isError: false, diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.test.tsx new file mode 100644 index 0000000000000..45ba392f3b5b4 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.test.tsx @@ -0,0 +1,124 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useDeleteCases, UseDeleteCase } from './use_delete_cases'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useDeleteCases', () => { + const abortCtrl = new AbortController(); + const deleteObj = [{ id: '1' }, { id: '2' }, { id: '3' }]; + const deleteArr = ['1', '2', '3']; + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseDeleteCase>(() => + useDeleteCases() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isDisplayConfirmDeleteModal: false, + isLoading: false, + isError: false, + isDeleted: false, + dispatchResetIsDeleted: result.current.dispatchResetIsDeleted, + handleOnDeleteConfirm: result.current.handleOnDeleteConfirm, + handleToggleModal: result.current.handleToggleModal, + }); + }); + }); + + it('calls deleteCases with correct arguments', async () => { + const spyOnDeleteCases = jest.spyOn(api, 'deleteCases'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseDeleteCase>(() => + useDeleteCases() + ); + await waitForNextUpdate(); + + result.current.handleOnDeleteConfirm(deleteObj); + await waitForNextUpdate(); + expect(spyOnDeleteCases).toBeCalledWith(deleteArr, abortCtrl.signal); + }); + }); + + it('deletes cases', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseDeleteCase>(() => + useDeleteCases() + ); + await waitForNextUpdate(); + result.current.handleToggleModal(); + result.current.handleOnDeleteConfirm(deleteObj); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isDisplayConfirmDeleteModal: false, + isLoading: false, + isError: false, + isDeleted: true, + dispatchResetIsDeleted: result.current.dispatchResetIsDeleted, + handleOnDeleteConfirm: result.current.handleOnDeleteConfirm, + handleToggleModal: result.current.handleToggleModal, + }); + }); + }); + + it('resets is deleting', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseDeleteCase>(() => + useDeleteCases() + ); + await waitForNextUpdate(); + result.current.handleToggleModal(); + result.current.handleOnDeleteConfirm(deleteObj); + await waitForNextUpdate(); + expect(result.current.isDeleted).toBeTruthy(); + result.current.handleToggleModal(); + result.current.dispatchResetIsDeleted(); + expect(result.current.isDeleted).toBeFalsy(); + }); + }); + + it('set isLoading to true when deleting cases', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseDeleteCase>(() => + useDeleteCases() + ); + await waitForNextUpdate(); + result.current.handleToggleModal(); + result.current.handleOnDeleteConfirm(deleteObj); + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnDeleteCases = jest.spyOn(api, 'deleteCases'); + spyOnDeleteCases.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseDeleteCase>(() => + useDeleteCases() + ); + await waitForNextUpdate(); + result.current.handleToggleModal(); + result.current.handleOnDeleteConfirm(deleteObj); + + expect(result.current).toEqual({ + isDisplayConfirmDeleteModal: false, + isLoading: false, + isError: true, + isDeleted: false, + dispatchResetIsDeleted: result.current.dispatchResetIsDeleted, + handleOnDeleteConfirm: result.current.handleOnDeleteConfirm, + handleToggleModal: result.current.handleToggleModal, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.tsx index 07e3786758aeb..3c49be551c064 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_delete_cases.tsx @@ -59,9 +59,9 @@ const dataFetchReducer = (state: DeleteState, action: Action): DeleteState => { } }; -interface UseDeleteCase extends DeleteState { +export interface UseDeleteCase extends DeleteState { dispatchResetIsDeleted: () => void; - handleOnDeleteConfirm: (caseIds: DeleteCase[]) => void; + handleOnDeleteConfirm: (cases: DeleteCase[]) => void; handleToggleModal: () => void; } @@ -117,8 +117,8 @@ export const useDeleteCases = (): UseDeleteCase => { }, [state.isDisplayConfirmDeleteModal]); const handleOnDeleteConfirm = useCallback( - caseIds => { - dispatchDeleteCases(caseIds); + (cases: DeleteCase[]) => { + dispatchDeleteCases(cases); dispatchToggleDeleteModal(); }, [state.isDisplayConfirmDeleteModal] diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.test.tsx new file mode 100644 index 0000000000000..23c9ff5e49586 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.test.tsx @@ -0,0 +1,89 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { initialData, useGetActionLicense, ActionLicenseState } from './use_get_action_license'; +import { actionLicenses } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetActionLicense', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, ActionLicenseState>(() => + useGetActionLicense() + ); + await waitForNextUpdate(); + expect(result.current).toEqual(initialData); + }); + }); + + it('calls getActionLicense with correct arguments', async () => { + const spyOnGetActionLicense = jest.spyOn(api, 'getActionLicense'); + + await act(async () => { + const { waitForNextUpdate } = renderHook<string, ActionLicenseState>(() => + useGetActionLicense() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(spyOnGetActionLicense).toBeCalledWith(abortCtrl.signal); + }); + }); + + it('gets action license', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, ActionLicenseState>(() => + useGetActionLicense() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoading: false, + isError: false, + actionLicense: actionLicenses[0], + }); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, ActionLicenseState>(() => + useGetActionLicense() + ); + await waitForNextUpdate(); + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnGetActionLicense = jest.spyOn(api, 'getActionLicense'); + spyOnGetActionLicense.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, ActionLicenseState>(() => + useGetActionLicense() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + actionLicense: null, + isLoading: false, + isError: true, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.tsx index 12f92b2db039b..0d28a1b20c61f 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_action_license.tsx @@ -11,13 +11,13 @@ import { getActionLicense } from './api'; import * as i18n from './translations'; import { ActionLicense } from './types'; -interface ActionLicenseState { +export interface ActionLicenseState { actionLicense: ActionLicense | null; isLoading: boolean; isError: boolean; } -const initialData: ActionLicenseState = { +export const initialData: ActionLicenseState = { actionLicense: null, isLoading: true, isError: false, diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.test.tsx new file mode 100644 index 0000000000000..10649da548d43 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.test.tsx @@ -0,0 +1,112 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { initialData, useGetCase, UseGetCase } from './use_get_case'; +import { basicCase } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetCase', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCase>(() => + useGetCase(basicCase.id) + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + data: initialData, + isLoading: true, + isError: false, + fetchCase: result.current.fetchCase, + updateCase: result.current.updateCase, + }); + }); + }); + + it('calls getCase with correct arguments', async () => { + const spyOnGetCase = jest.spyOn(api, 'getCase'); + await act(async () => { + const { waitForNextUpdate } = renderHook<string, UseGetCase>(() => useGetCase(basicCase.id)); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(spyOnGetCase).toBeCalledWith(basicCase.id, true, abortCtrl.signal); + }); + }); + + it('fetch case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCase>(() => + useGetCase(basicCase.id) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + data: basicCase, + isLoading: false, + isError: false, + fetchCase: result.current.fetchCase, + updateCase: result.current.updateCase, + }); + }); + }); + + it('refetch case', async () => { + const spyOnGetCase = jest.spyOn(api, 'getCase'); + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCase>(() => + useGetCase(basicCase.id) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.fetchCase(); + expect(spyOnGetCase).toHaveBeenCalledTimes(2); + }); + }); + + it('set isLoading to true when refetching case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCase>(() => + useGetCase(basicCase.id) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.fetchCase(); + + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnGetCase = jest.spyOn(api, 'getCase'); + spyOnGetCase.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCase>(() => + useGetCase(basicCase.id) + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + data: initialData, + isLoading: false, + isError: true, + fetchCase: result.current.fetchCase, + updateCase: result.current.updateCase, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.tsx index 835fb7153dc95..b2e3b6d0cacf6 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case.tsx @@ -53,7 +53,7 @@ const dataFetchReducer = (state: CaseState, action: Action): CaseState => { return state; } }; -const initialData: Case = { +export const initialData: Case = { id: '', closedAt: null, closedBy: null, @@ -73,7 +73,7 @@ const initialData: Case = { version: '', }; -interface UseGetCase extends CaseState { +export interface UseGetCase extends CaseState { fetchCase: () => void; updateCase: (newCase: Case) => void; } diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.test.tsx new file mode 100644 index 0000000000000..cdd40b84f8724 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.test.tsx @@ -0,0 +1,106 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { + initialData, + useGetCaseUserActions, + UseGetCaseUserActions, +} from './use_get_case_user_actions'; +import { basicCaseId, caseUserActions, elasticUser } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetCaseUserActions', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCaseUserActions>(() => + useGetCaseUserActions(basicCaseId) + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + ...initialData, + fetchCaseUserActions: result.current.fetchCaseUserActions, + }); + }); + }); + + it('calls getCaseUserActions with correct arguments', async () => { + const spyOnPostCase = jest.spyOn(api, 'getCaseUserActions'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCaseUserActions>(() => + useGetCaseUserActions(basicCaseId) + ); + await waitForNextUpdate(); + + result.current.fetchCaseUserActions(basicCaseId); + await waitForNextUpdate(); + expect(spyOnPostCase).toBeCalledWith(basicCaseId, abortCtrl.signal); + }); + }); + + it('retuns proper state on getCaseUserActions', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCaseUserActions>(() => + useGetCaseUserActions(basicCaseId) + ); + await waitForNextUpdate(); + result.current.fetchCaseUserActions(basicCaseId); + await waitForNextUpdate(); + expect(result.current).toEqual({ + ...initialData, + caseUserActions: caseUserActions.slice(1), + fetchCaseUserActions: result.current.fetchCaseUserActions, + hasDataToPush: true, + isError: false, + isLoading: false, + participants: [elasticUser], + }); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCaseUserActions>(() => + useGetCaseUserActions(basicCaseId) + ); + await waitForNextUpdate(); + result.current.fetchCaseUserActions(basicCaseId); + + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnPostCase = jest.spyOn(api, 'getCaseUserActions'); + spyOnPostCase.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCaseUserActions>(() => + useGetCaseUserActions(basicCaseId) + ); + await waitForNextUpdate(); + result.current.fetchCaseUserActions(basicCaseId); + + expect(result.current).toEqual({ + ...initialData, + isLoading: false, + isError: true, + fetchCaseUserActions: result.current.fetchCaseUserActions, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.tsx index 4c278bc038134..6d9874a655e97 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_case_user_actions.tsx @@ -22,7 +22,7 @@ interface CaseUserActionsState { lastIndexPushToService: number; } -const initialData: CaseUserActionsState = { +export const initialData: CaseUserActionsState = { caseUserActions: [], firstIndexPushToService: -1, lastIndexPushToService: -1, @@ -32,7 +32,7 @@ const initialData: CaseUserActionsState = { participants: [], }; -interface UseGetCaseUserActions extends CaseUserActionsState { +export interface UseGetCaseUserActions extends CaseUserActionsState { fetchCaseUserActions: (caseId: string) => void; } @@ -80,6 +80,7 @@ export const useGetCaseUserActions = (caseId: string): UseGetCaseUserActions => const participants = !isEmpty(response) ? uniqBy('actionBy.username', response).map(cau => cau.actionBy) : []; + const caseUserActions = !isEmpty(response) ? response.slice(1) : []; setCaseUserActionsState({ caseUserActions, diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.test.tsx new file mode 100644 index 0000000000000..4e274e074b036 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.test.tsx @@ -0,0 +1,202 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { + DEFAULT_FILTER_OPTIONS, + DEFAULT_QUERY_PARAMS, + initialData, + useGetCases, + UseGetCases, +} from './use_get_cases'; +import { UpdateKey } from './use_update_case'; +import { allCases, basicCase } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetCases', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + expect(result.current).toEqual({ + data: initialData, + dispatchUpdateCaseProperty: result.current.dispatchUpdateCaseProperty, + filterOptions: DEFAULT_FILTER_OPTIONS, + isError: false, + loading: [], + queryParams: DEFAULT_QUERY_PARAMS, + refetchCases: result.current.refetchCases, + selectedCases: [], + setFilters: result.current.setFilters, + setQueryParams: result.current.setQueryParams, + setSelectedCases: result.current.setSelectedCases, + }); + }); + }); + + it('calls getCases with correct arguments', async () => { + const spyOnGetCases = jest.spyOn(api, 'getCases'); + await act(async () => { + const { waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(spyOnGetCases).toBeCalledWith({ + filterOptions: DEFAULT_FILTER_OPTIONS, + queryParams: DEFAULT_QUERY_PARAMS, + signal: abortCtrl.signal, + }); + }); + }); + + it('fetch cases', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + data: allCases, + dispatchUpdateCaseProperty: result.current.dispatchUpdateCaseProperty, + filterOptions: DEFAULT_FILTER_OPTIONS, + isError: false, + loading: [], + queryParams: DEFAULT_QUERY_PARAMS, + refetchCases: result.current.refetchCases, + selectedCases: [], + setFilters: result.current.setFilters, + setQueryParams: result.current.setQueryParams, + setSelectedCases: result.current.setSelectedCases, + }); + }); + }); + it('dispatch update case property', async () => { + const spyOnPatchCase = jest.spyOn(api, 'patchCase'); + await act(async () => { + const updateCase = { + updateKey: 'description' as UpdateKey, + updateValue: 'description update', + caseId: basicCase.id, + refetchCasesStatus: jest.fn(), + version: '99999', + }; + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.dispatchUpdateCaseProperty(updateCase); + expect(result.current.loading).toEqual(['caseUpdate']); + expect(spyOnPatchCase).toBeCalledWith( + basicCase.id, + { [updateCase.updateKey]: updateCase.updateValue }, + updateCase.version, + abortCtrl.signal + ); + }); + }); + + it('refetch cases', async () => { + const spyOnGetCases = jest.spyOn(api, 'getCases'); + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.refetchCases(); + expect(spyOnGetCases).toHaveBeenCalledTimes(2); + }); + }); + + it('set isLoading to true when refetching case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.refetchCases(); + + expect(result.current.loading).toEqual(['cases']); + }); + }); + + it('unhappy path', async () => { + const spyOnGetCases = jest.spyOn(api, 'getCases'); + spyOnGetCases.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + data: initialData, + dispatchUpdateCaseProperty: result.current.dispatchUpdateCaseProperty, + filterOptions: DEFAULT_FILTER_OPTIONS, + isError: true, + loading: [], + queryParams: DEFAULT_QUERY_PARAMS, + refetchCases: result.current.refetchCases, + selectedCases: [], + setFilters: result.current.setFilters, + setQueryParams: result.current.setQueryParams, + setSelectedCases: result.current.setSelectedCases, + }); + }); + }); + it('set filters', async () => { + await act(async () => { + const spyOnGetCases = jest.spyOn(api, 'getCases'); + const newFilters = { + search: 'new', + tags: ['new'], + status: 'closed', + }; + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.setFilters(newFilters); + await waitForNextUpdate(); + expect(spyOnGetCases.mock.calls[1][0]).toEqual({ + filterOptions: { ...DEFAULT_FILTER_OPTIONS, ...newFilters }, + queryParams: DEFAULT_QUERY_PARAMS, + signal: abortCtrl.signal, + }); + }); + }); + it('set query params', async () => { + await act(async () => { + const spyOnGetCases = jest.spyOn(api, 'getCases'); + const newQueryParams = { + page: 2, + }; + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.setQueryParams(newQueryParams); + await waitForNextUpdate(); + expect(spyOnGetCases.mock.calls[1][0]).toEqual({ + filterOptions: DEFAULT_FILTER_OPTIONS, + queryParams: { ...DEFAULT_QUERY_PARAMS, ...newQueryParams }, + signal: abortCtrl.signal, + }); + }); + }); + it('set selected cases', async () => { + await act(async () => { + const selectedCases = [basicCase]; + const { result, waitForNextUpdate } = renderHook<string, UseGetCases>(() => useGetCases()); + await waitForNextUpdate(); + await waitForNextUpdate(); + result.current.setSelectedCases(selectedCases); + expect(result.current.selectedCases).toEqual(selectedCases); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.tsx index 1cbce5af6304b..465b50dbdc1bc 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases.tsx @@ -105,7 +105,7 @@ export const DEFAULT_QUERY_PARAMS: QueryParams = { sortOrder: 'desc', }; -const initialData: AllCases = { +export const initialData: AllCases = { cases: [], countClosedCases: null, countOpenCases: null, @@ -113,7 +113,7 @@ const initialData: AllCases = { perPage: 0, total: 0, }; -interface UseGetCases extends UseGetCasesState { +export interface UseGetCases extends UseGetCasesState { dispatchUpdateCaseProperty: ({ updateKey, updateValue, @@ -121,7 +121,7 @@ interface UseGetCases extends UseGetCasesState { version, refetchCasesStatus, }: UpdateCase) => void; - refetchCases: (filters: FilterOptions, queryParams: QueryParams) => void; + refetchCases: () => void; setFilters: (filters: Partial<FilterOptions>) => void; setQueryParams: (queryParams: Partial<QueryParams>) => void; setSelectedCases: (mySelectedCases: Case[]) => void; diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.test.tsx new file mode 100644 index 0000000000000..bfbcbd2525e3b --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.test.tsx @@ -0,0 +1,88 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useGetCasesStatus, UseGetCasesStatus } from './use_get_cases_status'; +import { casesStatus } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetCasesStatus', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCasesStatus>(() => + useGetCasesStatus() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + countClosedCases: null, + countOpenCases: null, + isLoading: true, + isError: false, + fetchCasesStatus: result.current.fetchCasesStatus, + }); + }); + }); + + it('calls getCasesStatus api', async () => { + const spyOnGetCasesStatus = jest.spyOn(api, 'getCasesStatus'); + await act(async () => { + const { waitForNextUpdate } = renderHook<string, UseGetCasesStatus>(() => + useGetCasesStatus() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(spyOnGetCasesStatus).toBeCalledWith(abortCtrl.signal); + }); + }); + + it('fetch reporters', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCasesStatus>(() => + useGetCasesStatus() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + countClosedCases: casesStatus.countClosedCases, + countOpenCases: casesStatus.countOpenCases, + isLoading: false, + isError: false, + fetchCasesStatus: result.current.fetchCasesStatus, + }); + }); + }); + + it('unhappy path', async () => { + const spyOnGetCasesStatus = jest.spyOn(api, 'getCasesStatus'); + spyOnGetCasesStatus.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetCasesStatus>(() => + useGetCasesStatus() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + countClosedCases: 0, + countOpenCases: 0, + isLoading: false, + isError: true, + fetchCasesStatus: result.current.fetchCasesStatus, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.tsx index 7f56d27ef160e..0788464602357 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_cases_status.tsx @@ -23,7 +23,7 @@ const initialData: CasesStatusState = { isError: false, }; -interface UseGetCasesStatus extends CasesStatusState { +export interface UseGetCasesStatus extends CasesStatusState { fetchCasesStatus: () => void; } diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.test.tsx new file mode 100644 index 0000000000000..3629fbc60e4d3 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.test.tsx @@ -0,0 +1,86 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useGetReporters, UseGetReporters } from './use_get_reporters'; +import { reporters, respReporters } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetReporters', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetReporters>(() => + useGetReporters() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + reporters: [], + respReporters: [], + isLoading: true, + isError: false, + fetchReporters: result.current.fetchReporters, + }); + }); + }); + + it('calls getReporters api', async () => { + const spyOnGetReporters = jest.spyOn(api, 'getReporters'); + await act(async () => { + const { waitForNextUpdate } = renderHook<string, UseGetReporters>(() => useGetReporters()); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(spyOnGetReporters).toBeCalledWith(abortCtrl.signal); + }); + }); + + it('fetch reporters', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetReporters>(() => + useGetReporters() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + reporters, + respReporters, + isLoading: false, + isError: false, + fetchReporters: result.current.fetchReporters, + }); + }); + }); + + it('unhappy path', async () => { + const spyOnGetReporters = jest.spyOn(api, 'getReporters'); + spyOnGetReporters.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseGetReporters>(() => + useGetReporters() + ); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + reporters: [], + respReporters: [], + isLoading: false, + isError: true, + fetchReporters: result.current.fetchReporters, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.tsx index 2478172a3394b..2fc9b8294c8e0 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_reporters.tsx @@ -26,7 +26,7 @@ const initialData: ReportersState = { isError: false, }; -interface UseGetReporters extends ReportersState { +export interface UseGetReporters extends ReportersState { fetchReporters: () => void; } diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.test.tsx new file mode 100644 index 0000000000000..3df83d1c8a596 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.test.tsx @@ -0,0 +1,74 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useGetTags, TagsState } from './use_get_tags'; +import { tags } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useGetTags', () => { + const abortCtrl = new AbortController(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, TagsState>(() => useGetTags()); + await waitForNextUpdate(); + expect(result.current).toEqual({ + tags: [], + isLoading: true, + isError: false, + }); + }); + }); + + it('calls getTags api', async () => { + const spyOnGetTags = jest.spyOn(api, 'getTags'); + await act(async () => { + const { waitForNextUpdate } = renderHook<string, TagsState>(() => useGetTags()); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(spyOnGetTags).toBeCalledWith(abortCtrl.signal); + }); + }); + + it('fetch tags', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, TagsState>(() => useGetTags()); + await waitForNextUpdate(); + await waitForNextUpdate(); + expect(result.current).toEqual({ + tags, + isLoading: false, + isError: false, + }); + }); + }); + + it('unhappy path', async () => { + const spyOnGetTags = jest.spyOn(api, 'getTags'); + spyOnGetTags.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, TagsState>(() => useGetTags()); + await waitForNextUpdate(); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + tags: [], + isLoading: false, + isError: true, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.tsx index b41d5aab5c07a..7c58316ac3fe9 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_get_tags.tsx @@ -10,7 +10,7 @@ import { errorToToaster, useStateToaster } from '../../components/toasters'; import { getTags } from './api'; import * as i18n from './translations'; -interface TagsState { +export interface TagsState { tags: string[]; isLoading: boolean; isError: boolean; @@ -49,7 +49,7 @@ const initialData: string[] = []; export const useGetTags = (): TagsState => { const [state, dispatch] = useReducer(dataFetchReducer, { - isLoading: false, + isLoading: true, isError: false, tags: initialData, }); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.test.tsx new file mode 100644 index 0000000000000..8b105fe041d27 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.test.tsx @@ -0,0 +1,96 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { usePostCase, UsePostCase } from './use_post_case'; +import { basicCasePost } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('usePostCase', () => { + const abortCtrl = new AbortController(); + const samplePost = { + description: 'description', + tags: ['tags'], + title: 'title', + }; + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostCase>(() => usePostCase()); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoading: false, + isError: false, + caseData: null, + postCase: result.current.postCase, + }); + }); + }); + + it('calls postCase with correct arguments', async () => { + const spyOnPostCase = jest.spyOn(api, 'postCase'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostCase>(() => usePostCase()); + await waitForNextUpdate(); + + result.current.postCase(samplePost); + await waitForNextUpdate(); + expect(spyOnPostCase).toBeCalledWith(samplePost, abortCtrl.signal); + }); + }); + + it('post case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostCase>(() => usePostCase()); + await waitForNextUpdate(); + result.current.postCase(samplePost); + await waitForNextUpdate(); + expect(result.current).toEqual({ + caseData: basicCasePost, + isLoading: false, + isError: false, + postCase: result.current.postCase, + }); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostCase>(() => usePostCase()); + await waitForNextUpdate(); + result.current.postCase(samplePost); + + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnPostCase = jest.spyOn(api, 'postCase'); + spyOnPostCase.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostCase>(() => usePostCase()); + await waitForNextUpdate(); + result.current.postCase(samplePost); + + expect(result.current).toEqual({ + caseData: null, + isLoading: false, + isError: true, + postCase: result.current.postCase, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.tsx index 0e01364721dc5..aeb50fc098eee 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_post_case.tsx @@ -48,7 +48,7 @@ const dataFetchReducer = (state: NewCaseState, action: Action): NewCaseState => } }; -interface UsePostCase extends NewCaseState { +export interface UsePostCase extends NewCaseState { postCase: (data: CasePostRequest) => void; } export const usePostCase = (): UsePostCase => { diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.test.tsx new file mode 100644 index 0000000000000..d7d9cf9c557c9 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.test.tsx @@ -0,0 +1,102 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { usePostComment, UsePostComment } from './use_post_comment'; +import { basicCaseId } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('usePostComment', () => { + const abortCtrl = new AbortController(); + const samplePost = { + comment: 'a comment', + }; + const updateCaseCallback = jest.fn(); + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostComment>(() => + usePostComment(basicCaseId) + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoading: false, + isError: false, + postComment: result.current.postComment, + }); + }); + }); + + it('calls postComment with correct arguments', async () => { + const spyOnPostCase = jest.spyOn(api, 'postComment'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostComment>(() => + usePostComment(basicCaseId) + ); + await waitForNextUpdate(); + + result.current.postComment(samplePost, updateCaseCallback); + await waitForNextUpdate(); + expect(spyOnPostCase).toBeCalledWith(samplePost, basicCaseId, abortCtrl.signal); + }); + }); + + it('post case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostComment>(() => + usePostComment(basicCaseId) + ); + await waitForNextUpdate(); + result.current.postComment(samplePost, updateCaseCallback); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoading: false, + isError: false, + postComment: result.current.postComment, + }); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostComment>(() => + usePostComment(basicCaseId) + ); + await waitForNextUpdate(); + result.current.postComment(samplePost, updateCaseCallback); + + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnPostCase = jest.spyOn(api, 'postComment'); + spyOnPostCase.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostComment>(() => + usePostComment(basicCaseId) + ); + await waitForNextUpdate(); + result.current.postComment(samplePost, updateCaseCallback); + + expect(result.current).toEqual({ + isLoading: false, + isError: true, + postComment: result.current.postComment, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.tsx index 207b05814717f..c6d34b5449977 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_post_comment.tsx @@ -41,7 +41,7 @@ const dataFetchReducer = (state: NewCommentState, action: Action): NewCommentSta } }; -interface UsePostComment extends NewCommentState { +export interface UsePostComment extends NewCommentState { postComment: (data: CommentRequest, updateCase: (newCase: Case) => void) => void; } diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.test.tsx new file mode 100644 index 0000000000000..b07a346a8da46 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.test.tsx @@ -0,0 +1,137 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { + formatServiceRequestData, + usePostPushToService, + UsePostPushToService, +} from './use_post_push_to_service'; +import { basicCase, pushedCase, serviceConnector } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('usePostPushToService', () => { + const abortCtrl = new AbortController(); + const updateCase = jest.fn(); + const samplePush = { + caseId: pushedCase.id, + connectorName: 'sample', + connectorId: '22', + updateCase, + }; + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostPushToService>(() => + usePostPushToService() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + serviceData: null, + pushedCaseData: null, + isLoading: false, + isError: false, + postPushToService: result.current.postPushToService, + }); + }); + }); + + it('calls pushCase with correct arguments', async () => { + const spyOnPushCase = jest.spyOn(api, 'pushCase'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostPushToService>(() => + usePostPushToService() + ); + await waitForNextUpdate(); + result.current.postPushToService(samplePush); + await waitForNextUpdate(); + expect(spyOnPushCase).toBeCalledWith( + samplePush.caseId, + { + connector_id: samplePush.connectorId, + connector_name: samplePush.connectorName, + external_id: serviceConnector.incidentId, + external_title: serviceConnector.number, + external_url: serviceConnector.url, + }, + abortCtrl.signal + ); + }); + }); + + it('calls pushToService with correct arguments', async () => { + const spyOnPushToService = jest.spyOn(api, 'pushToService'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostPushToService>(() => + usePostPushToService() + ); + await waitForNextUpdate(); + result.current.postPushToService(samplePush); + await waitForNextUpdate(); + expect(spyOnPushToService).toBeCalledWith( + samplePush.connectorId, + formatServiceRequestData(basicCase), + abortCtrl.signal + ); + }); + }); + + it('post push to service', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostPushToService>(() => + usePostPushToService() + ); + await waitForNextUpdate(); + result.current.postPushToService(samplePush); + await waitForNextUpdate(); + expect(result.current).toEqual({ + serviceData: serviceConnector, + pushedCaseData: pushedCase, + isLoading: false, + isError: false, + postPushToService: result.current.postPushToService, + }); + }); + }); + + it('set isLoading to true when deleting cases', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostPushToService>(() => + usePostPushToService() + ); + await waitForNextUpdate(); + result.current.postPushToService(samplePush); + expect(result.current.isLoading).toBe(true); + }); + }); + + it('unhappy path', async () => { + const spyOnPushToService = jest.spyOn(api, 'pushToService'); + spyOnPushToService.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UsePostPushToService>(() => + usePostPushToService() + ); + await waitForNextUpdate(); + result.current.postPushToService(samplePush); + await waitForNextUpdate(); + + expect(result.current).toEqual({ + serviceData: null, + pushedCaseData: null, + isLoading: false, + isError: true, + postPushToService: result.current.postPushToService, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.tsx index d9a32f26f7fe7..89e7e18cf0688 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_post_push_to_service.tsx @@ -68,7 +68,7 @@ interface PushToServiceRequest { updateCase: (newCase: Case) => void; } -interface UsePostPushToService extends PushToServiceState { +export interface UsePostPushToService extends PushToServiceState { postPushToService: ({ caseId, connectorId, updateCase }: PushToServiceRequest) => void; } @@ -131,7 +131,7 @@ export const usePostPushToService = (): UsePostPushToService => { return { ...state, postPushToService }; }; -const formatServiceRequestData = (myCase: Case): ServiceConnectorCaseParams => { +export const formatServiceRequestData = (myCase: Case): ServiceConnectorCaseParams => { const { id: caseId, createdAt, diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.test.tsx new file mode 100644 index 0000000000000..86cfc3459c595 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.test.tsx @@ -0,0 +1,119 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useUpdateCase, UseUpdateCase, UpdateKey } from './use_update_case'; +import { basicCase } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useUpdateCase', () => { + const abortCtrl = new AbortController(); + const fetchCaseUserActions = jest.fn(); + const updateCase = jest.fn(); + const updateKey: UpdateKey = 'description'; + const sampleUpdate = { + fetchCaseUserActions, + updateKey, + updateValue: 'updated description', + updateCase, + version: basicCase.version, + }; + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCase>(() => + useUpdateCase({ caseId: basicCase.id }) + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoading: false, + isError: false, + updateKey: null, + updateCaseProperty: result.current.updateCaseProperty, + }); + }); + }); + + it('calls patchCase with correct arguments', async () => { + const spyOnPatchCase = jest.spyOn(api, 'patchCase'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCase>(() => + useUpdateCase({ caseId: basicCase.id }) + ); + await waitForNextUpdate(); + + result.current.updateCaseProperty(sampleUpdate); + await waitForNextUpdate(); + expect(spyOnPatchCase).toBeCalledWith( + basicCase.id, + { description: 'updated description' }, + basicCase.version, + abortCtrl.signal + ); + }); + }); + + it('patch case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCase>(() => + useUpdateCase({ caseId: basicCase.id }) + ); + await waitForNextUpdate(); + result.current.updateCaseProperty(sampleUpdate); + await waitForNextUpdate(); + expect(result.current).toEqual({ + updateKey: null, + isLoading: false, + isError: false, + updateCaseProperty: result.current.updateCaseProperty, + }); + expect(fetchCaseUserActions).toBeCalledWith(basicCase.id); + expect(updateCase).toBeCalledWith(basicCase); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCase>(() => + useUpdateCase({ caseId: basicCase.id }) + ); + await waitForNextUpdate(); + result.current.updateCaseProperty(sampleUpdate); + + expect(result.current.isLoading).toBe(true); + expect(result.current.updateKey).toBe(updateKey); + }); + }); + + it('unhappy path', async () => { + const spyOnPatchCase = jest.spyOn(api, 'patchCase'); + spyOnPatchCase.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateCase>(() => + useUpdateCase({ caseId: basicCase.id }) + ); + await waitForNextUpdate(); + result.current.updateCaseProperty(sampleUpdate); + + expect(result.current).toEqual({ + updateKey: null, + isLoading: false, + isError: true, + updateCaseProperty: result.current.updateCaseProperty, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.tsx index 4973deef4d91a..7ebbbba076c12 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_update_case.tsx @@ -12,7 +12,7 @@ import { patchCase } from './api'; import * as i18n from './translations'; import { Case } from './types'; -type UpdateKey = keyof Pick<CasePatchRequest, 'description' | 'status' | 'tags' | 'title'>; +export type UpdateKey = keyof Pick<CasePatchRequest, 'description' | 'status' | 'tags' | 'title'>; interface NewCaseState { isLoading: boolean; @@ -62,7 +62,7 @@ const dataFetchReducer = (state: NewCaseState, action: Action): NewCaseState => } }; -interface UseUpdateCase extends NewCaseState { +export interface UseUpdateCase extends NewCaseState { updateCaseProperty: (updates: UpdateByKey) => void; } export const useUpdateCase = ({ caseId }: { caseId: string }): UseUpdateCase => { diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.test.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.test.tsx new file mode 100644 index 0000000000000..5772ff4246866 --- /dev/null +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.test.tsx @@ -0,0 +1,116 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { renderHook, act } from '@testing-library/react-hooks'; +import { useUpdateComment, UseUpdateComment } from './use_update_comment'; +import { basicCase, basicCaseCommentPatch } from './mock'; +import * as api from './api'; + +jest.mock('./api'); + +describe('useUpdateComment', () => { + const abortCtrl = new AbortController(); + const fetchUserActions = jest.fn(); + const updateCase = jest.fn(); + const sampleUpdate = { + caseId: basicCase.id, + commentId: basicCase.comments[0].id, + commentUpdate: 'updated comment', + fetchUserActions, + updateCase, + version: basicCase.comments[0].version, + }; + beforeEach(() => { + jest.clearAllMocks(); + jest.restoreAllMocks(); + }); + + it('init', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateComment>(() => + useUpdateComment() + ); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoadingIds: [], + isError: false, + patchComment: result.current.patchComment, + }); + }); + }); + + it('calls patchComment with correct arguments', async () => { + const spyOnPatchComment = jest.spyOn(api, 'patchComment'); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateComment>(() => + useUpdateComment() + ); + await waitForNextUpdate(); + + result.current.patchComment(sampleUpdate); + await waitForNextUpdate(); + expect(spyOnPatchComment).toBeCalledWith( + basicCase.id, + basicCase.comments[0].id, + 'updated comment', + basicCase.comments[0].version, + abortCtrl.signal + ); + }); + }); + + it('patch comment', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateComment>(() => + useUpdateComment() + ); + await waitForNextUpdate(); + result.current.patchComment(sampleUpdate); + await waitForNextUpdate(); + expect(result.current).toEqual({ + isLoadingIds: [], + isError: false, + patchComment: result.current.patchComment, + }); + expect(fetchUserActions).toBeCalled(); + expect(updateCase).toBeCalledWith(basicCaseCommentPatch); + }); + }); + + it('set isLoading to true when posting case', async () => { + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateComment>(() => + useUpdateComment() + ); + await waitForNextUpdate(); + result.current.patchComment(sampleUpdate); + + expect(result.current.isLoadingIds).toEqual([basicCase.comments[0].id]); + }); + }); + + it('unhappy path', async () => { + const spyOnPatchComment = jest.spyOn(api, 'patchComment'); + spyOnPatchComment.mockImplementation(() => { + throw new Error('Something went wrong'); + }); + + await act(async () => { + const { result, waitForNextUpdate } = renderHook<string, UseUpdateComment>(() => + useUpdateComment() + ); + await waitForNextUpdate(); + result.current.patchComment(sampleUpdate); + + expect(result.current).toEqual({ + isLoadingIds: [], + isError: true, + patchComment: result.current.patchComment, + }); + }); + }); +}); diff --git a/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.tsx b/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.tsx index faf9649a705c5..ffc5cffee7a55 100644 --- a/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.tsx +++ b/x-pack/legacy/plugins/siem/public/containers/case/use_update_comment.tsx @@ -60,7 +60,7 @@ interface UpdateComment { version: string; } -interface UseUpdateComment extends CommentUpdateState { +export interface UseUpdateComment extends CommentUpdateState { patchComment: ({ caseId, commentId, commentUpdate, fetchUserActions }: UpdateComment) => void; } diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx deleted file mode 100644 index 64c6276fc1be2..0000000000000 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/__mock__/case_data.tsx +++ /dev/null @@ -1,226 +0,0 @@ -/* - * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one - * or more contributor license agreements. Licensed under the Elastic License; - * you may not use this file except in compliance with the Elastic License. - */ - -import { CaseProps } from '../case_view'; -import { Case, Comment, SortFieldCase } from '../../../../containers/case/types'; -import { UseGetCasesState } from '../../../../containers/case/use_get_cases'; -import { UserAction, UserActionField } from '../../../../../../../../plugins/case/common/api/cases'; - -const updateCase = jest.fn(); -const fetchCase = jest.fn(); - -const basicCaseId = 'basic-case-id'; -const basicCommentId = 'basic-comment-id'; -const basicCreatedAt = '2020-02-20T23:06:33.798Z'; -const elasticUser = { - fullName: 'Leslie Knope', - username: 'lknope', - email: 'leslie.knope@elastic.co', -}; - -export const basicComment: Comment = { - comment: 'Solve this fast!', - id: basicCommentId, - createdAt: basicCreatedAt, - createdBy: elasticUser, - pushedAt: null, - pushedBy: null, - updatedAt: '2020-02-20T23:06:33.798Z', - updatedBy: { - username: 'elastic', - }, - version: 'WzQ3LDFc', -}; - -export const basicCase: Case = { - closedAt: null, - closedBy: null, - id: basicCaseId, - comments: [basicComment], - createdAt: '2020-02-13T19:44:23.627Z', - createdBy: elasticUser, - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['defacement'], - title: 'Another horrible breach!!', - totalComment: 1, - updatedAt: '2020-02-19T15:02:57.995Z', - updatedBy: { - username: 'elastic', - }, - version: 'WzQ3LDFd', -}; - -export const caseProps: CaseProps = { - caseId: basicCaseId, - userCanCrud: true, - caseData: basicCase, - fetchCase, - updateCase, -}; - -export const caseClosedProps: CaseProps = { - ...caseProps, - caseData: { - ...caseProps.caseData, - closedAt: '2020-02-20T23:06:33.798Z', - closedBy: { - username: 'elastic', - }, - status: 'closed', - }, -}; - -export const basicCaseClosed: Case = { - ...caseClosedProps.caseData, -}; - -const basicAction = { - actionAt: basicCreatedAt, - actionBy: elasticUser, - oldValue: null, - newValue: 'what a cool value', - caseId: basicCaseId, - commentId: null, -}; -export const caseUserActions = [ - { - ...basicAction, - actionBy: elasticUser, - actionField: ['comment'], - action: 'create', - actionId: 'tt', - }, -]; - -export const useGetCasesMockState: UseGetCasesState = { - data: { - countClosedCases: 0, - countOpenCases: 5, - cases: [ - basicCase, - { - closedAt: null, - closedBy: null, - id: '362a5c10-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:13.328Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: { - pushedAt: '2020-02-13T19:45:01.901Z', - pushedBy: 'elastic', - connectorId: 'string', - connectorName: 'string', - externalId: 'string', - externalTitle: 'string', - externalUrl: 'string', - }, - status: 'open', - tags: ['phishing'], - title: 'Bad email', - totalComment: 0, - updatedAt: '2020-02-13T15:45:01.901Z', - updatedBy: { username: 'elastic' }, - version: 'WzQ3LDFd', - }, - { - closedAt: null, - closedBy: null, - id: '34f8b9e0-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:11.328Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: { - pushedAt: '2020-02-13T19:45:01.901Z', - pushedBy: 'elastic', - connectorId: 'string', - connectorName: 'string', - externalId: 'string', - externalTitle: 'string', - externalUrl: 'string', - }, - status: 'open', - tags: ['phishing'], - title: 'Bad email', - totalComment: 0, - updatedAt: '2020-02-14T19:45:01.901Z', - updatedBy: { username: 'elastic' }, - version: 'WzQ3LDFd', - }, - { - closedAt: '2020-02-13T19:44:13.328Z', - closedBy: { username: 'elastic' }, - id: '31890e90-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:05.563Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'closed', - tags: ['phishing'], - title: 'Uh oh', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - { - closedAt: null, - closedBy: null, - id: '2f5b3210-4e99-11ea-9290-35d05cb55c15', - createdAt: '2020-02-13T19:44:01.901Z', - createdBy: { username: 'elastic' }, - comments: [], - description: 'Security banana Issue', - externalService: null, - status: 'open', - tags: ['phishing'], - title: 'Uh oh', - totalComment: 0, - updatedAt: null, - updatedBy: null, - version: 'WzQ3LDFd', - }, - ], - page: 1, - perPage: 5, - total: 10, - }, - loading: [], - selectedCases: [], - isError: false, - queryParams: { - page: 1, - perPage: 5, - sortField: SortFieldCase.createdAt, - sortOrder: 'desc', - }, - filterOptions: { search: '', reporters: [], tags: [], status: 'open' }, -}; - -const basicPush = { - connector_id: 'connector_id', - connector_name: 'connector name', - external_id: 'external_id', - external_title: 'external title', - external_url: 'basicPush.com', - pushed_at: basicCreatedAt, - pushed_by: elasticUser, -}; -export const getUserAction = (af: UserActionField, a: UserAction) => ({ - ...basicAction, - actionId: `${af[0]}-${a}`, - actionField: af, - action: a, - commentId: af[0] === 'comment' ? basicCommentId : null, - newValue: - a === 'push-to-service' && af[0] === 'pushed' - ? JSON.stringify(basicPush) - : basicAction.newValue, -}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx index e008b94ab9e16..31c795c05edd5 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/columns.test.tsx @@ -9,7 +9,7 @@ import { mount } from 'enzyme'; import { ServiceNowColumn } from './columns'; -import { useGetCasesMockState } from '../__mock__/case_data'; +import { useGetCasesMockState } from '../../../../containers/case/mock'; describe('ServiceNowColumn ', () => { it('Not pushed render', () => { diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx index f65736e7cd109..58d0c1b0faaf3 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.test.tsx @@ -9,7 +9,7 @@ import { mount } from 'enzyme'; import moment from 'moment-timezone'; import { AllCases } from './'; import { TestProviders } from '../../../../mock'; -import { useGetCasesMockState } from '../__mock__/case_data'; +import { useGetCasesMockState } from '../../../../containers/case/mock'; import * as i18n from './translations'; import { getEmptyTagValue } from '../../../../components/empty_value'; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.tsx index b0ff3dbada6c9..c50b7d8c17abc 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/all_cases/index.tsx @@ -131,11 +131,11 @@ export const AllCases = React.memo<AllCasesProps>(({ userCanCrud }) => { const [deleteBulk, setDeleteBulk] = useState<DeleteCase[]>([]); const refreshCases = useCallback(() => { - refetchCases(filterOptions, queryParams); + refetchCases(); fetchCasesStatus(); setSelectedCases([]); setDeleteBulk([]); - }, [filterOptions, queryParams]); + }, []); useEffect(() => { if (isDeleted) { diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx index 8a25a2121104d..8b6ee76dd783d 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/actions.test.tsx @@ -9,7 +9,7 @@ import { mount } from 'enzyme'; import { useDeleteCases } from '../../../../containers/case/use_delete_cases'; import { TestProviders } from '../../../../mock'; -import { basicCase } from '../__mock__/case_data'; +import { basicCase } from '../../../../containers/case/mock'; import { CaseViewActions } from './actions'; jest.mock('../../../../containers/case/use_delete_cases'); const useDeleteCasesMock = useDeleteCases as jest.Mock; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx index 3721a5a727ca5..7ce9d7b8533e4 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/index.test.tsx @@ -8,13 +8,8 @@ import React from 'react'; import { mount } from 'enzyme'; import { Router, routeData, mockHistory, mockLocation } from '../__mock__/router'; -import { CaseComponent, CaseView } from './'; -import { - basicCaseClosed, - caseClosedProps, - caseProps, - caseUserActions, -} from '../__mock__/case_data'; +import { CaseComponent, CaseProps, CaseView } from './'; +import { basicCase, basicCaseClosed, caseUserActions } from '../../../../containers/case/mock'; import { TestProviders } from '../../../../mock'; import { useUpdateCase } from '../../../../containers/case/use_update_case'; import { useGetCase } from '../../../../containers/case/use_get_case'; @@ -29,6 +24,19 @@ const useUpdateCaseMock = useUpdateCase as jest.Mock; const useGetCaseUserActionsMock = useGetCaseUserActions as jest.Mock; const usePushToServiceMock = usePushToService as jest.Mock; +export const caseProps: CaseProps = { + caseId: basicCase.id, + userCanCrud: true, + caseData: basicCase, + fetchCase: jest.fn(), + updateCase: jest.fn(), +}; + +export const caseClosedProps: CaseProps = { + ...caseProps, + caseData: basicCaseClosed, +}; + describe('CaseView ', () => { const updateCaseProperty = jest.fn(); const fetchCaseUserActions = jest.fn(); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/translations.ts b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/translations.ts index 17132b9610754..70b8035db5c16 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/translations.ts +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/case_view/translations.ts @@ -118,3 +118,6 @@ export const EMAIL_BODY = (caseUrl: string) => values: { caseUrl }, defaultMessage: 'Case reference: {caseUrl}', }); +export const UNKNOWN = i18n.translate('xpack.siem.case.caseView.unknown', { + defaultMessage: 'Unknown', +}); diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx index 5c342538f0feb..e34981286bc81 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/helpers.test.tsx @@ -5,7 +5,7 @@ */ import React from 'react'; -import { getUserAction } from '../__mock__/case_data'; +import { getUserAction } from '../../../../containers/case/mock'; import { getLabelTitle } from './helpers'; import * as i18n from '../case_view/translations'; import { mount } from 'enzyme'; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx index 0d8cd729b4a1d..1c71260422d4b 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.test.tsx @@ -10,7 +10,7 @@ import { mount } from 'enzyme'; import { Router, routeData, mockHistory, mockLocation } from '../__mock__/router'; import { getFormMock } from '../__mock__/form'; import { useUpdateComment } from '../../../../containers/case/use_update_comment'; -import { basicCase, getUserAction } from '../__mock__/case_data'; +import { basicCase, getUserAction } from '../../../../containers/case/mock'; import { UserActionTree } from './'; import { TestProviders } from '../../../../mock'; import { useFormMock } from '../create/index.test'; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx index f8f3f0651fa3c..d1e8eb3f6306b 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/index.tsx @@ -179,7 +179,7 @@ export const UserActionTree = React.memo( markdown={MarkdownDescription} onEdit={handleManageMarkdownEditId.bind(null, DESCRIPTION_ID)} onQuote={handleManageQuote.bind(null, caseData.description)} - username={caseData.createdBy.username ?? 'Unknown'} + username={caseData.createdBy.username ?? i18n.UNKNOWN} /> {caseUserActions.map((action, index) => { diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx index e2189367068ca..8a1e8a80f664d 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.test.tsx @@ -8,7 +8,7 @@ import React from 'react'; import { mount } from 'enzyme'; import copy from 'copy-to-clipboard'; import { Router, routeData, mockHistory } from '../__mock__/router'; -import { caseUserActions as basicUserActions } from '../__mock__/case_data'; +import { caseUserActions as basicUserActions } from '../../../../containers/case/mock'; import { UserActionTitle } from './user_action_title'; import { TestProviders } from '../../../../mock'; diff --git a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx index a1edbab7e1fa2..fc2a74466dedc 100644 --- a/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx +++ b/x-pack/legacy/plugins/siem/public/pages/case/components/user_action_tree/user_action_title.tsx @@ -43,7 +43,7 @@ interface UserActionTitleProps { linkId?: string | null; fullName?: string | null; updatedAt?: string | null; - username: string; + username?: string | null; onEdit?: (id: string) => void; onQuote?: (id: string) => void; outlineComment?: (id: string) => void; @@ -63,7 +63,7 @@ export const UserActionTitle = ({ onQuote, outlineComment, updatedAt, - username, + username = i18n.UNKNOWN, }: UserActionTitleProps) => { const { detailName: caseId } = useParams(); const urlSearch = useGetUrlSearch(navTabs.case); diff --git a/x-pack/plugins/case/common/api/cases/case.ts b/x-pack/plugins/case/common/api/cases/case.ts index 3c5d3405f395e..1f08a41024905 100644 --- a/x-pack/plugins/case/common/api/cases/case.ts +++ b/x-pack/plugins/case/common/api/cases/case.ts @@ -167,6 +167,7 @@ export type CasesResponse = rt.TypeOf<typeof CasesResponseRt>; export type CasesFindResponse = rt.TypeOf<typeof CasesFindResponseRt>; export type CasePatchRequest = rt.TypeOf<typeof CasePatchRequestRt>; export type CasesPatchRequest = rt.TypeOf<typeof CasesPatchRequestRt>; +export type Status = rt.TypeOf<typeof StatusRt>; export type CaseExternalServiceRequest = rt.TypeOf<typeof CaseExternalServiceRequestRt>; export type ServiceConnectorCaseParams = rt.TypeOf<typeof ServiceConnectorCaseParamsRt>; export type ServiceConnectorCaseResponse = rt.TypeOf<typeof ServiceConnectorCaseResponseRt>; From 287d477f211e2ed7b92f78812c8f065c6e779de6 Mon Sep 17 00:00:00 2001 From: Christos Nasikas <christos.nasikas@elastic.co> Date: Tue, 14 Apr 2020 22:09:03 +0300 Subject: [PATCH 102/102] [SIEM][CASE] Tests for server's configuration API (#63099) * Test utils * Test get_configure * Test post_configure * Test get_connectors * Test patch_configure * Improve test * Fixes Co-authored-by: Elastic Machine <elasticmachine@users.noreply.github.com> --- .../__fixtures__/create_mock_so_repository.ts | 70 ++- .../api/__fixtures__/mock_saved_objects.ts | 32 +- .../routes/api/__fixtures__/route_contexts.ts | 6 + .../routes/api/__mocks__/request_responses.ts | 64 +++ .../api/cases/configure/get_configure.test.ts | 112 +++++ .../cases/configure/get_connectors.test.ts | 63 +++ .../cases/configure/patch_configure.test.ts | 156 +++++++ .../cases/configure/post_configure.test.ts | 294 ++++++++++++ .../case/server/routes/api/utils.test.ts | 418 ++++++++++++++++++ 9 files changed, 1213 insertions(+), 2 deletions(-) create mode 100644 x-pack/plugins/case/server/routes/api/__mocks__/request_responses.ts create mode 100644 x-pack/plugins/case/server/routes/api/cases/configure/get_configure.test.ts create mode 100644 x-pack/plugins/case/server/routes/api/cases/configure/get_connectors.test.ts create mode 100644 x-pack/plugins/case/server/routes/api/cases/configure/patch_configure.test.ts create mode 100644 x-pack/plugins/case/server/routes/api/cases/configure/post_configure.test.ts create mode 100644 x-pack/plugins/case/server/routes/api/utils.test.ts diff --git a/x-pack/plugins/case/server/routes/api/__fixtures__/create_mock_so_repository.ts b/x-pack/plugins/case/server/routes/api/__fixtures__/create_mock_so_repository.ts index 95cd66a9c51a2..e83dafc68ee69 100644 --- a/x-pack/plugins/case/server/routes/api/__fixtures__/create_mock_so_repository.ts +++ b/x-pack/plugins/case/server/routes/api/__fixtures__/create_mock_so_repository.ts @@ -11,14 +11,20 @@ import { SavedObjectsBulkUpdateObject, } from 'src/core/server'; -import { CASE_COMMENT_SAVED_OBJECT, CASE_SAVED_OBJECT } from '../../../saved_object_types'; +import { + CASE_COMMENT_SAVED_OBJECT, + CASE_SAVED_OBJECT, + CASE_CONFIGURE_SAVED_OBJECT, +} from '../../../saved_object_types'; export const createMockSavedObjectsRepository = ({ caseSavedObject = [], caseCommentSavedObject = [], + caseConfigureSavedObject = [], }: { caseSavedObject?: any[]; caseCommentSavedObject?: any[]; + caseConfigureSavedObject?: any[]; }) => { const mockSavedObjectsClientContract = ({ bulkGet: jest.fn((objects: SavedObjectsBulkGetObject[]) => { @@ -70,6 +76,7 @@ export const createMockSavedObjectsRepository = ({ } return result[0]; } + const result = caseSavedObject.filter(s => s.id === id); if (!result.length) { throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); @@ -81,6 +88,23 @@ export const createMockSavedObjectsRepository = ({ throw SavedObjectsErrorHelpers.createBadRequestError('Error thrown for testing'); } + if ( + findArgs.type === CASE_CONFIGURE_SAVED_OBJECT && + caseConfigureSavedObject[0] && + caseConfigureSavedObject[0].id === 'throw-error-find' + ) { + throw SavedObjectsErrorHelpers.createGenericNotFoundError('Error thrown for testing'); + } + + if (findArgs.type === CASE_CONFIGURE_SAVED_OBJECT) { + return { + page: 1, + per_page: 5, + total: caseConfigureSavedObject.length, + saved_objects: caseConfigureSavedObject, + }; + } + if (findArgs.type === CASE_COMMENT_SAVED_OBJECT) { return { page: 1, @@ -101,6 +125,13 @@ export const createMockSavedObjectsRepository = ({ throw SavedObjectsErrorHelpers.createBadRequestError('Error thrown for testing'); } + if ( + type === CASE_CONFIGURE_SAVED_OBJECT && + attributes.connector_id === 'throw-error-create' + ) { + throw SavedObjectsErrorHelpers.createBadRequestError('Error thrown for testing'); + } + if (type === CASE_COMMENT_SAVED_OBJECT) { const newCommentObj = { type, @@ -113,6 +144,20 @@ export const createMockSavedObjectsRepository = ({ caseCommentSavedObject = [...caseCommentSavedObject, newCommentObj]; return newCommentObj; } + + if (type === CASE_CONFIGURE_SAVED_OBJECT) { + const newConfiguration = { + type, + id: 'mock-configuration', + attributes, + updated_at: '2020-04-09T09:43:51.778Z', + version: attributes.connector_id === 'no-version' ? undefined : 'WzksMV0=', + }; + + caseConfigureSavedObject = [newConfiguration]; + return newConfiguration; + } + return { type, id: 'mock-it', @@ -143,6 +188,16 @@ export const createMockSavedObjectsRepository = ({ } } + if (type === CASE_CONFIGURE_SAVED_OBJECT) { + return { + id, + type, + updated_at: '2019-11-22T22:50:55.191Z', + attributes, + version: attributes.connector_id === 'no-version' ? undefined : 'WzE3LDFd', + }; + } + return { id, type, @@ -153,16 +208,29 @@ export const createMockSavedObjectsRepository = ({ }), delete: jest.fn((type: string, id: string) => { let result = caseSavedObject.filter(s => s.id === id); + if (type === CASE_COMMENT_SAVED_OBJECT) { result = caseCommentSavedObject.filter(s => s.id === id); } + + if (type === CASE_CONFIGURE_SAVED_OBJECT) { + result = caseConfigureSavedObject.filter(s => s.id === id); + } + if (type === CASE_COMMENT_SAVED_OBJECT && id === 'bad-guy') { throw SavedObjectsErrorHelpers.createBadRequestError('Error thrown for testing'); } + if (!result.length) { throw SavedObjectsErrorHelpers.createGenericNotFoundError(type, id); } + if ( + type === CASE_CONFIGURE_SAVED_OBJECT && + caseConfigureSavedObject[0].id === 'throw-error-delete' + ) { + throw new Error('Error thrown for testing'); + } return {}; }), deleteByNamespace: jest.fn(), diff --git a/x-pack/plugins/case/server/routes/api/__fixtures__/mock_saved_objects.ts b/x-pack/plugins/case/server/routes/api/__fixtures__/mock_saved_objects.ts index 03da50f886fd5..75e793a80272f 100644 --- a/x-pack/plugins/case/server/routes/api/__fixtures__/mock_saved_objects.ts +++ b/x-pack/plugins/case/server/routes/api/__fixtures__/mock_saved_objects.ts @@ -5,7 +5,11 @@ */ import { SavedObject } from 'kibana/server'; -import { CaseAttributes, CommentAttributes } from '../../../../common/api'; +import { + CaseAttributes, + CommentAttributes, + CasesConfigureAttributes, +} from '../../../../common/api'; export const mockCases: Array<SavedObject<CaseAttributes>> = [ { @@ -225,7 +229,33 @@ export const mockCaseComments: Array<SavedObject<CommentAttributes>> = [ }, ], updated_at: '2019-11-25T22:32:30.608Z', + version: 'WzYsMV0=', + }, +]; +export const mockCaseConfigure: Array<SavedObject<CasesConfigureAttributes>> = [ + { + type: 'cases-configure', + id: 'mock-configuration-1', + attributes: { + connector_id: '123', + connector_name: 'My connector', + closure_type: 'close-by-user', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + updated_at: '2020-04-09T09:43:51.778Z', + updated_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + }, + references: [], + updated_at: '2020-04-09T09:43:51.778Z', version: 'WzYsMV0=', }, ]; diff --git a/x-pack/plugins/case/server/routes/api/__fixtures__/route_contexts.ts b/x-pack/plugins/case/server/routes/api/__fixtures__/route_contexts.ts index b1881e394e796..d947ffbaf181d 100644 --- a/x-pack/plugins/case/server/routes/api/__fixtures__/route_contexts.ts +++ b/x-pack/plugins/case/server/routes/api/__fixtures__/route_contexts.ts @@ -5,13 +5,19 @@ */ import { RequestHandlerContext } from 'src/core/server'; +import { actionsClientMock } from '../../../../../actions/server/mocks'; +import { getActions } from '../__mocks__/request_responses'; export const createRouteContext = (client: any) => { + const actionsMock = actionsClientMock.create(); + actionsMock.getAll.mockImplementation(() => Promise.resolve(getActions())); + return ({ core: { savedObjects: { client, }, }, + actions: { getActionsClient: () => actionsMock }, } as unknown) as RequestHandlerContext; }; diff --git a/x-pack/plugins/case/server/routes/api/__mocks__/request_responses.ts b/x-pack/plugins/case/server/routes/api/__mocks__/request_responses.ts new file mode 100644 index 0000000000000..846013674986e --- /dev/null +++ b/x-pack/plugins/case/server/routes/api/__mocks__/request_responses.ts @@ -0,0 +1,64 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ +import { CasePostRequest, CasesConfigureRequest } from '../../../../common/api'; +// eslint-disable-next-line @kbn/eslint/no-restricted-paths +import { FindActionResult } from '../../../../../actions/server/types'; + +export const newCase: CasePostRequest = { + title: 'My new case', + description: 'A description', + tags: ['new', 'case'], +}; + +export const getActions = (): FindActionResult[] => [ + { + id: 'e90075a5-c386-41e3-ae21-ba4e61510695', + actionTypeId: '.webhook', + name: 'Test', + config: { + method: 'post', + url: 'https://example.com', + headers: null, + }, + isPreconfigured: false, + referencedByCount: 0, + }, + { + id: 'd611af27-3532-4da9-8034-271fee81d634', + actionTypeId: '.servicenow', + name: 'ServiceNow', + config: { + casesConfiguration: { + mapping: [ + { + source: 'title', + target: 'short_description', + actionType: 'overwrite', + }, + { + source: 'description', + target: 'description', + actionType: 'overwrite', + }, + { + source: 'comments', + target: 'comments', + actionType: 'append', + }, + ], + }, + apiUrl: 'https://dev102283.service-now.com', + }, + isPreconfigured: false, + referencedByCount: 0, + }, +]; + +export const newConfiguration: CasesConfigureRequest = { + connector_id: '456', + connector_name: 'My connector 2', + closure_type: 'close-by-pushing', +}; diff --git a/x-pack/plugins/case/server/routes/api/cases/configure/get_configure.test.ts b/x-pack/plugins/case/server/routes/api/cases/configure/get_configure.test.ts new file mode 100644 index 0000000000000..66d39c3f11d28 --- /dev/null +++ b/x-pack/plugins/case/server/routes/api/cases/configure/get_configure.test.ts @@ -0,0 +1,112 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { kibanaResponseFactory, RequestHandler } from 'src/core/server'; +import { httpServerMock } from 'src/core/server/mocks'; + +import { + createMockSavedObjectsRepository, + createRoute, + createRouteContext, +} from '../../__fixtures__'; + +import { mockCaseConfigure } from '../../__fixtures__/mock_saved_objects'; +import { initGetCaseConfigure } from './get_configure'; + +describe('GET configuration', () => { + let routeHandler: RequestHandler<any, any, any>; + beforeAll(async () => { + routeHandler = await createRoute(initGetCaseConfigure, 'get'); + }); + + it('returns the configuration', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'get', + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(200); + expect(res.payload).toEqual({ + ...mockCaseConfigure[0].attributes, + version: mockCaseConfigure[0].version, + }); + }); + + it('handles undefined version correctly', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'get', + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: [{ ...mockCaseConfigure[0], version: undefined }], + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(200); + expect(res.payload).toEqual({ + connector_id: '123', + connector_name: 'My connector', + closure_type: 'close-by-user', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + updated_at: '2020-04-09T09:43:51.778Z', + updated_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + version: '', + }); + }); + + it('returns an empty object when there is no configuration', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'get', + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: [], + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(200); + expect(res.payload).toEqual({}); + }); + + it('returns an error if find throws an error', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'get', + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: [{ ...mockCaseConfigure[0], id: 'throw-error-find' }], + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(404); + expect(res.payload.isBoom).toEqual(true); + }); +}); diff --git a/x-pack/plugins/case/server/routes/api/cases/configure/get_connectors.test.ts b/x-pack/plugins/case/server/routes/api/cases/configure/get_connectors.test.ts new file mode 100644 index 0000000000000..62edaa0a4792a --- /dev/null +++ b/x-pack/plugins/case/server/routes/api/cases/configure/get_connectors.test.ts @@ -0,0 +1,63 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { kibanaResponseFactory, RequestHandler } from 'src/core/server'; +import { httpServerMock } from 'src/core/server/mocks'; + +import { + createMockSavedObjectsRepository, + createRoute, + createRouteContext, +} from '../../__fixtures__'; + +import { mockCaseConfigure } from '../../__fixtures__/mock_saved_objects'; +import { initCaseConfigureGetActionConnector } from './get_connectors'; +import { getActions } from '../../__mocks__/request_responses'; + +describe('GET connectors', () => { + let routeHandler: RequestHandler<any, any, any>; + beforeAll(async () => { + routeHandler = await createRoute(initCaseConfigureGetActionConnector, 'get'); + }); + + it('returns the connectors', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure/connectors/_find', + method: 'get', + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(200); + expect(res.payload).toEqual( + getActions().filter(action => action.actionTypeId === '.servicenow') + ); + }); + + it('it throws an error when actions client is null', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure/connectors/_find', + method: 'get', + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + context.actions = undefined; + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(404); + expect(res.payload.isBoom).toEqual(true); + }); +}); diff --git a/x-pack/plugins/case/server/routes/api/cases/configure/patch_configure.test.ts b/x-pack/plugins/case/server/routes/api/cases/configure/patch_configure.test.ts new file mode 100644 index 0000000000000..5b3d68a258664 --- /dev/null +++ b/x-pack/plugins/case/server/routes/api/cases/configure/patch_configure.test.ts @@ -0,0 +1,156 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { kibanaResponseFactory, RequestHandler } from 'src/core/server'; +import { httpServerMock } from 'src/core/server/mocks'; + +import { + createMockSavedObjectsRepository, + createRoute, + createRouteContext, +} from '../../__fixtures__'; + +import { mockCaseConfigure } from '../../__fixtures__/mock_saved_objects'; +import { initPatchCaseConfigure } from './patch_configure'; + +describe('PATCH configuration', () => { + let routeHandler: RequestHandler<any, any, any>; + + beforeAll(async () => { + routeHandler = await createRoute(initPatchCaseConfigure, 'patch'); + const spyOnDate = jest.spyOn(global, 'Date') as jest.SpyInstance<{}, []>; + spyOnDate.mockImplementation(() => ({ + toISOString: jest.fn().mockReturnValue('2020-04-09T09:43:51.778Z'), + })); + }); + + it('patch configuration', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'patch', + body: { + closure_type: 'close-by-pushing', + version: mockCaseConfigure[0].version, + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(res.payload).toEqual( + expect.objectContaining({ + ...mockCaseConfigure[0].attributes, + closure_type: 'close-by-pushing', + updated_at: '2020-04-09T09:43:51.778Z', + updated_by: { email: 'd00d@awesome.com', full_name: 'Awesome D00d', username: 'awesome' }, + version: 'WzE3LDFd', + }) + ); + }); + + it('patch configuration without authentication', async () => { + routeHandler = await createRoute(initPatchCaseConfigure, 'patch', true); + + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'patch', + body: { + closure_type: 'close-by-pushing', + version: mockCaseConfigure[0].version, + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(res.payload).toEqual( + expect.objectContaining({ + ...mockCaseConfigure[0].attributes, + closure_type: 'close-by-pushing', + updated_at: '2020-04-09T09:43:51.778Z', + updated_by: { email: null, full_name: null, username: null }, + version: 'WzE3LDFd', + }) + ); + }); + + it('throw error when configuration have not being created', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'patch', + body: { + closure_type: 'close-by-pushing', + version: mockCaseConfigure[0].version, + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: [], + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(409); + expect(res.payload.isBoom).toEqual(true); + }); + + it('throw error when the versions are different', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'patch', + body: { + closure_type: 'close-by-pushing', + version: 'different-version', + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(409); + expect(res.payload.isBoom).toEqual(true); + }); + + it('handles undefined version correctly', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'patch', + body: { connector_id: 'no-version', version: mockCaseConfigure[0].version }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.payload).toEqual( + expect.objectContaining({ + version: '', + }) + ); + }); +}); diff --git a/x-pack/plugins/case/server/routes/api/cases/configure/post_configure.test.ts b/x-pack/plugins/case/server/routes/api/cases/configure/post_configure.test.ts new file mode 100644 index 0000000000000..7e40cad5b1298 --- /dev/null +++ b/x-pack/plugins/case/server/routes/api/cases/configure/post_configure.test.ts @@ -0,0 +1,294 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { kibanaResponseFactory, RequestHandler } from 'src/core/server'; +import { httpServerMock } from 'src/core/server/mocks'; + +import { + createMockSavedObjectsRepository, + createRoute, + createRouteContext, +} from '../../__fixtures__'; + +import { mockCaseConfigure } from '../../__fixtures__/mock_saved_objects'; +import { initPostCaseConfigure } from './post_configure'; +import { newConfiguration } from '../../__mocks__/request_responses'; + +describe('POST configuration', () => { + let routeHandler: RequestHandler<any, any, any>; + + beforeAll(async () => { + routeHandler = await createRoute(initPostCaseConfigure, 'post'); + const spyOnDate = jest.spyOn(global, 'Date') as jest.SpyInstance<{}, []>; + spyOnDate.mockImplementation(() => ({ + toISOString: jest.fn().mockReturnValue('2020-04-09T09:43:51.778Z'), + })); + }); + + it('create configuration', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(res.payload).toEqual( + expect.objectContaining({ + connector_id: '456', + connector_name: 'My connector 2', + closure_type: 'close-by-pushing', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: 'd00d@awesome.com', full_name: 'Awesome D00d', username: 'awesome' }, + updated_at: null, + updated_by: null, + }) + ); + }); + + it('create configuration without authentication', async () => { + routeHandler = await createRoute(initPostCaseConfigure, 'post', true); + + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(res.payload).toEqual( + expect.objectContaining({ + connector_id: '456', + connector_name: 'My connector 2', + closure_type: 'close-by-pushing', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: null, full_name: null, username: null }, + updated_at: null, + updated_by: null, + }) + ); + }); + + it('throws when missing connector_id', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: { + connector_name: 'My connector 2', + closure_type: 'close-by-pushing', + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(400); + expect(res.payload.isBoom).toEqual(true); + }); + + it('throws when missing connector_name', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: { + connector_id: '456', + closure_type: 'close-by-pushing', + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(400); + expect(res.payload.isBoom).toEqual(true); + }); + + it('throws when missing closure_type', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: { + connector_id: '456', + connector_name: 'My connector 2', + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(400); + expect(res.payload.isBoom).toEqual(true); + }); + + it('it deletes the previous configuration', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const savedObjectRepository = createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }); + + const context = createRouteContext(savedObjectRepository); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(savedObjectRepository.delete.mock.calls[0][1]).toBe(mockCaseConfigure[0].id); + }); + + it('it does NOT delete when not found', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const savedObjectRepository = createMockSavedObjectsRepository({ + caseConfigureSavedObject: [], + }); + + const context = createRouteContext(savedObjectRepository); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(savedObjectRepository.delete).not.toHaveBeenCalled(); + }); + + it('it deletes all configuration', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const savedObjectRepository = createMockSavedObjectsRepository({ + caseConfigureSavedObject: [ + mockCaseConfigure[0], + { ...mockCaseConfigure[0], id: 'mock-configuration-2' }, + ], + }); + + const context = createRouteContext(savedObjectRepository); + + const res = await routeHandler(context, req, kibanaResponseFactory); + + expect(res.status).toEqual(200); + expect(savedObjectRepository.delete.mock.calls[0][1]).toBe(mockCaseConfigure[0].id); + expect(savedObjectRepository.delete.mock.calls[1][1]).toBe('mock-configuration-2'); + }); + + it('returns an error if find throws an error', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: [{ ...mockCaseConfigure[0], id: 'throw-error-find' }], + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(404); + expect(res.payload.isBoom).toEqual(true); + }); + + it('returns an error if delete throws an error', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: newConfiguration, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: [{ ...mockCaseConfigure[0], id: 'throw-error-delete' }], + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(500); + expect(res.payload.isBoom).toEqual(true); + }); + + it('returns an error if post throws an error', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: { + connector_id: 'throw-error-create', + connector_name: 'My connector 2', + closure_type: 'close-by-pushing', + }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(400); + expect(res.payload.isBoom).toEqual(true); + }); + + it('handles undefined version correctly', async () => { + const req = httpServerMock.createKibanaRequest({ + path: '/api/cases/configure', + method: 'post', + body: { ...newConfiguration, connector_id: 'no-version' }, + }); + + const context = createRouteContext( + createMockSavedObjectsRepository({ + caseConfigureSavedObject: mockCaseConfigure, + }) + ); + + const res = await routeHandler(context, req, kibanaResponseFactory); + expect(res.status).toEqual(200); + expect(res.payload).toEqual( + expect.objectContaining({ + version: '', + }) + ); + }); +}); diff --git a/x-pack/plugins/case/server/routes/api/utils.test.ts b/x-pack/plugins/case/server/routes/api/utils.test.ts new file mode 100644 index 0000000000000..a22f4db30bf8d --- /dev/null +++ b/x-pack/plugins/case/server/routes/api/utils.test.ts @@ -0,0 +1,418 @@ +/* + * Copyright Elasticsearch B.V. and/or licensed to Elasticsearch B.V. under one + * or more contributor license agreements. Licensed under the Elastic License; + * you may not use this file except in compliance with the Elastic License. + */ + +import { + transformNewCase, + transformNewComment, + wrapError, + transformCases, + flattenCaseSavedObjects, + flattenCaseSavedObject, + flattenCommentSavedObjects, + transformComments, + flattenCommentSavedObject, + sortToSnake, +} from './utils'; +import { newCase } from './__mocks__/request_responses'; +import { isBoom, boomify } from 'boom'; +import { mockCases, mockCaseComments } from './__fixtures__/mock_saved_objects'; + +describe('Utils', () => { + describe('transformNewCase', () => { + it('transform correctly', () => { + const myCase = { + newCase, + createdDate: '2020-04-09T09:43:51.778Z', + email: 'elastic@elastic.co', + full_name: 'Elastic', + username: 'elastic', + }; + + const res = transformNewCase(myCase); + + expect(res).toEqual({ + ...myCase.newCase, + closed_at: null, + closed_by: null, + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: 'elastic@elastic.co', full_name: 'Elastic', username: 'elastic' }, + external_service: null, + status: 'open', + updated_at: null, + updated_by: null, + }); + }); + + it('transform correctly without optional fields', () => { + const myCase = { + newCase, + createdDate: '2020-04-09T09:43:51.778Z', + }; + + const res = transformNewCase(myCase); + + expect(res).toEqual({ + ...myCase.newCase, + closed_at: null, + closed_by: null, + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: undefined, full_name: undefined, username: undefined }, + external_service: null, + status: 'open', + updated_at: null, + updated_by: null, + }); + }); + + it('transform correctly with optional fields as null', () => { + const myCase = { + newCase, + createdDate: '2020-04-09T09:43:51.778Z', + email: null, + full_name: null, + username: null, + }; + + const res = transformNewCase(myCase); + + expect(res).toEqual({ + ...myCase.newCase, + closed_at: null, + closed_by: null, + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: null, full_name: null, username: null }, + external_service: null, + status: 'open', + updated_at: null, + updated_by: null, + }); + }); + }); + + describe('transformNewComment', () => { + it('transforms correctly', () => { + const comment = { + comment: 'A comment', + createdDate: '2020-04-09T09:43:51.778Z', + email: 'elastic@elastic.co', + full_name: 'Elastic', + username: 'elastic', + }; + + const res = transformNewComment(comment); + expect(res).toEqual({ + comment: 'A comment', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: 'elastic@elastic.co', full_name: 'Elastic', username: 'elastic' }, + pushed_at: null, + pushed_by: null, + updated_at: null, + updated_by: null, + }); + }); + + it('transform correctly without optional fields', () => { + const comment = { + comment: 'A comment', + createdDate: '2020-04-09T09:43:51.778Z', + }; + + const res = transformNewComment(comment); + + expect(res).toEqual({ + comment: 'A comment', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: undefined, full_name: undefined, username: undefined }, + pushed_at: null, + pushed_by: null, + updated_at: null, + updated_by: null, + }); + }); + + it('transform correctly with optional fields as null', () => { + const comment = { + comment: 'A comment', + createdDate: '2020-04-09T09:43:51.778Z', + email: null, + full_name: null, + username: null, + }; + + const res = transformNewComment(comment); + + expect(res).toEqual({ + comment: 'A comment', + created_at: '2020-04-09T09:43:51.778Z', + created_by: { email: null, full_name: null, username: null }, + pushed_at: null, + pushed_by: null, + updated_at: null, + updated_by: null, + }); + }); + }); + + describe('wrapError', () => { + it('wraps an error', () => { + const error = new Error('Something happened'); + const res = wrapError(error); + + expect(isBoom(res.body as Error)).toBe(true); + }); + + it('it set statusCode to 500', () => { + const error = new Error('Something happened'); + const res = wrapError(error); + + expect(res.statusCode).toBe(500); + }); + + it('it set statusCode to errors status code', () => { + const error = new Error('Something happened') as any; + error.statusCode = 404; + const res = wrapError(error); + + expect(res.statusCode).toBe(404); + }); + + it('it accepts a boom error', () => { + const error = boomify(new Error('Something happened')); + const res = wrapError(error); + + // Utils returns the same boom error as body + expect(res.body).toBe(error); + }); + + it('it accepts a boom error with status code', () => { + const error = boomify(new Error('Something happened'), { statusCode: 404 }); + const res = wrapError(error); + + expect(res.statusCode).toBe(404); + }); + + it('it returns empty headers', () => { + const error = new Error('Something happened'); + const res = wrapError(error); + + expect(res.headers).toEqual({}); + }); + }); + + describe('transformCases', () => { + it('transforms correctly', () => { + const totalCommentsByCase = [ + { caseId: mockCases[0].id, totalComments: 2 }, + { caseId: mockCases[1].id, totalComments: 2 }, + { caseId: mockCases[2].id, totalComments: 2 }, + { caseId: mockCases[3].id, totalComments: 2 }, + ]; + + const res = transformCases( + { saved_objects: mockCases, total: mockCases.length, per_page: 10, page: 1 }, + 2, + 2, + totalCommentsByCase + ); + expect(res).toEqual({ + page: 1, + per_page: 10, + total: mockCases.length, + cases: flattenCaseSavedObjects(mockCases, totalCommentsByCase), + count_open_cases: 2, + count_closed_cases: 2, + }); + }); + }); + + describe('flattenCaseSavedObjects', () => { + it('flattens correctly', () => { + const totalCommentsByCase = [{ caseId: mockCases[0].id, totalComments: 2 }]; + + const res = flattenCaseSavedObjects([mockCases[0]], totalCommentsByCase); + expect(res).toEqual([ + { + id: 'mock-id-1', + closed_at: null, + closed_by: null, + created_at: '2019-11-25T21:54:48.952Z', + created_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + description: 'This is a brand new case of a bad meanie defacing data', + external_service: null, + title: 'Super Bad Security Issue', + status: 'open', + tags: ['defacement'], + updated_at: '2019-11-25T21:54:48.952Z', + updated_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + comments: [], + totalComment: 2, + version: 'WzAsMV0=', + }, + ]); + }); + + it('it handles total comments correctly', () => { + const totalCommentsByCase = [{ caseId: 'not-exist', totalComments: 2 }]; + + const res = flattenCaseSavedObjects([mockCases[0]], totalCommentsByCase); + + expect(res).toEqual([ + { + id: 'mock-id-1', + closed_at: null, + closed_by: null, + created_at: '2019-11-25T21:54:48.952Z', + created_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + description: 'This is a brand new case of a bad meanie defacing data', + external_service: null, + title: 'Super Bad Security Issue', + status: 'open', + tags: ['defacement'], + updated_at: '2019-11-25T21:54:48.952Z', + updated_by: { + full_name: 'elastic', + email: 'testemail@elastic.co', + username: 'elastic', + }, + comments: [], + totalComment: 0, + version: 'WzAsMV0=', + }, + ]); + }); + }); + + describe('flattenCaseSavedObject', () => { + it('flattens correctly', () => { + const myCase = { ...mockCases[0] }; + const res = flattenCaseSavedObject(myCase, [], 2); + expect(res).toEqual({ + id: myCase.id, + version: myCase.version, + comments: [], + totalComment: 2, + ...myCase.attributes, + }); + }); + + it('flattens correctly without version', () => { + const myCase = { ...mockCases[0] }; + myCase.version = undefined; + const res = flattenCaseSavedObject(myCase, [], 2); + expect(res).toEqual({ + id: myCase.id, + version: '0', + comments: [], + totalComment: 2, + ...myCase.attributes, + }); + }); + + it('flattens correctly with comments', () => { + const myCase = { ...mockCases[0] }; + const comments = [{ ...mockCaseComments[0] }]; + const res = flattenCaseSavedObject(myCase, comments, 2); + expect(res).toEqual({ + id: myCase.id, + version: myCase.version, + comments: flattenCommentSavedObjects(comments), + totalComment: 2, + ...myCase.attributes, + }); + }); + }); + + describe('transformComments', () => { + it('transforms correctly', () => { + const comments = { + saved_objects: mockCaseComments, + total: mockCaseComments.length, + per_page: 10, + page: 1, + }; + + const res = transformComments(comments); + expect(res).toEqual({ + page: 1, + per_page: 10, + total: mockCaseComments.length, + comments: flattenCommentSavedObjects(comments.saved_objects), + }); + }); + }); + + describe('flattenCommentSavedObjects', () => { + it('flattens correctly', () => { + const comments = [{ ...mockCaseComments[0] }, { ...mockCaseComments[1] }]; + const res = flattenCommentSavedObjects(comments); + expect(res).toEqual([ + flattenCommentSavedObject(comments[0]), + flattenCommentSavedObject(comments[1]), + ]); + }); + }); + + describe('flattenCommentSavedObject', () => { + it('flattens correctly', () => { + const comment = { ...mockCaseComments[0] }; + const res = flattenCommentSavedObject(comment); + expect(res).toEqual({ + id: comment.id, + version: comment.version, + ...comment.attributes, + }); + }); + + it('flattens correctly without version', () => { + const comment = { ...mockCaseComments[0] }; + comment.version = undefined; + const res = flattenCommentSavedObject(comment); + expect(res).toEqual({ + id: comment.id, + version: '0', + ...comment.attributes, + }); + }); + }); + + describe('sortToSnake', () => { + it('it transforms status correctly', () => { + expect(sortToSnake('status')).toBe('status'); + }); + + it('it transforms createdAt correctly', () => { + expect(sortToSnake('createdAt')).toBe('created_at'); + }); + + it('it transforms created_at correctly', () => { + expect(sortToSnake('created_at')).toBe('created_at'); + }); + + it('it transforms closedAt correctly', () => { + expect(sortToSnake('closedAt')).toBe('closed_at'); + }); + + it('it transforms closed_at correctly', () => { + expect(sortToSnake('closed_at')).toBe('closed_at'); + }); + + it('it transforms default correctly', () => { + expect(sortToSnake('not-exist')).toBe('created_at'); + }); + }); +});

kCbAFrnrvi1y$?L2<5~xtW^1 zQ6b)p@`naH;H&fqaL%-Qp27`tO;^2`(vh5ZorS5p69?mgNB{3Vp}ZR z*n9{XBbycrgf`#c4}d|;k#%5oT7j+7v3Q`ARQTn0t%>F<($ZH8eB{3OS7bB(?OgXr zoI(0j;(D^%GAQpdE=9wOQ(rKn@0{h{p>yjeuaYm`5s8VuP_zB?ffT{uckbDuVlUas zj)w%rpollU#YUF-ifor>!#j;$Y2R}1k^T=&;is_+PXXzNaQD_v9&G~-@MzvU+v7>k z=xmcS&0ClLRKfknBSf9KpY`27>y8e=WDNCeIs9De)64E&fZqbGU)sxq?$ZI@TOY&j z^wpVVdkUj{JMM0{Rmbr16Izp%#g)vP>)0us%3FN450CRy+iMkj)z$e{U!J8%pZgXD z{w^hbCG>z#pu!9|EO@wt?ZI~s8V@XS>-tw}h7g|&Cg+c+x2~7B$}V2KXl);TWZTpgTQP_IP+0R5aO8HBhv*V5~N)%A>&}ARYbV1tGjuKr$pn^HlIsc z8>M3+vI$htt+ntU7=8fIh`zUj8A5d*zRKTgeW5CZ`RvuKn&5#`2V7vIba3Dc8WM zlV>*N^Z3<&>W&x#9>|f8?VS|uYl+abz;%7eXY1U=vYm#OLn1h?SgNy-(bv?8=oU1~ zoBU5mV2mN^DoNqS4w6H^6T3=PtIPkVj#ec=YvVs2$V>~JETYD!+Eu+7 zgd^v#Y-j-@y^Z%LbpRoT-Pye%6<@vrL#X^N+rU=;*kJo~(fT!86UySL?V%E|gqecX zhvFEnCr!V?bdFf4}*Oh;4XnZWe|t8}BhS8~%0D@aYx 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 Q1@I#&CMQ}btn2gt0O?oeDF6Tf literal 0 HcmV?d00001 diff --git a/docs/apm/using-the-apm-ui.asciidoc b/docs/apm/using-the-apm-ui.asciidoc index b1b7ed7307986..904718999069d 100644 --- a/docs/apm/using-the-apm-ui.asciidoc +++ b/docs/apm/using-the-apm-ui.asciidoc @@ -15,6 +15,7 @@ APM is available via the navigation sidebar in {Kib}. * <> * <> * <> +* <> * <> * <> * <> @@ -37,6 +38,8 @@ include::errors.asciidoc[] include::metrics.asciidoc[] +include::apm-alerts.asciidoc[] + include::agent-configuration.asciidoc[] include::custom-links.asciidoc[] From 13fe738b2a59c5117e15aca4af1c155e00129a37 Mon Sep 17 00:00:00 2001 From: gchaps <33642766+gchaps@users.noreply.github.com> Date: Thu, 9 Apr 2020 08:55:29 -0700 Subject: [PATCH 004/102] [UI COPY] Fixes typo in max_shingle_size for search_as_you_type (#63071) --- .../field_parameters/max_shingle_size_parameter.tsx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/x-pack/plugins/index_management/public/application/components/mappings_editor/components/document_fields/field_parameters/max_shingle_size_parameter.tsx b/x-pack/plugins/index_management/public/application/components/mappings_editor/components/document_fields/field_parameters/max_shingle_size_parameter.tsx index bc1917b2da966..cec97fb925eef 100644 --- a/x-pack/plugins/index_management/public/application/components/mappings_editor/components/document_fields/field_parameters/max_shingle_size_parameter.tsx +++ b/x-pack/plugins/index_management/public/application/components/mappings_editor/components/document_fields/field_parameters/max_shingle_size_parameter.tsx @@ -23,7 +23,7 @@ export const MaxShingleSizeParameter = ({ defaultToggleValue }: Props) => ( })} description={i18n.translate('xpack.idxMgmt.mappingsEditor.maxShingleSizeFieldDescription', { defaultMessage: - 'The default is three shingle subfields. More subfields enables more specific queries, but increases index size.', + 'The default is three shingle subfields. More subfields enable more specific queries, but increase index size.', })} defaultToggleValue={defaultToggleValue} > From 5e1c0be501b672174b2553dbca74d4eba16295f6 Mon Sep 17 00:00:00 2001 From: Paul Tavares <56442535+paul-tavares@users.noreply.github.com> Date: Thu, 9 Apr 2020 11:56:03 -0400 Subject: [PATCH 005/102] [Endpoint] Add link to Logs UI to the Host Details view (#62852) * Add LinktoApp to host details for logs * initial setup for testing link on details * Export interface AppContextTestRender for reference in tests * Refactor hosts tests to use AppContextTestRender * Render full details and validate link to logs * one more test to ensure we navigate to app (not full page refresh) * Fixes post master merge --- .../endpoint/components/link_to_app.tsx | 2 +- .../endpoint/mocks/app_context_render.tsx | 2 +- .../store/hosts/mock_host_result_list.ts | 13 ++- .../endpoint/view/hosts/details.tsx | 28 +++++ .../endpoint/view/hosts/index.test.tsx | 106 +++++++++++++----- 5 files changed, 119 insertions(+), 32 deletions(-) diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx index b110d32442c2c..858dac864b58a 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/components/link_to_app.tsx @@ -12,7 +12,7 @@ import { useNavigateToAppEventHandler } from '../hooks/use_navigate_to_app_event export type LinkToAppProps = EuiLinkProps & { /** the app id - normally the value of the `id` in that plugin's `kibana.json` */ appId: string; - /** Any app specic path (route) */ + /** Any app specific path (route) */ appPath?: string; appState?: any; onClick?: MouseEventHandler; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/mocks/app_context_render.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/mocks/app_context_render.tsx index af34205e2310f..7cb1031ef9a09 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/mocks/app_context_render.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/mocks/app_context_render.tsx @@ -18,7 +18,7 @@ type UiRender = (ui: React.ReactElement, options?: RenderOptions) => RenderResul /** * Mocked app root context renderer */ -interface AppContextTestRender { +export interface AppContextTestRender { store: ReturnType; history: ReturnType; coreStart: ReturnType; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/store/hosts/mock_host_result_list.ts b/x-pack/plugins/endpoint/public/applications/endpoint/store/hosts/mock_host_result_list.ts index d4c2602e34387..20aa973ffc93d 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/store/hosts/mock_host_result_list.ts +++ b/x-pack/plugins/endpoint/public/applications/endpoint/store/hosts/mock_host_result_list.ts @@ -4,7 +4,7 @@ * you may not use this file except in compliance with the Elastic License. */ -import { HostResultList, HostStatus } from '../../../../../common/types'; +import { HostInfo, HostResultList, HostStatus } from '../../../../../common/types'; import { EndpointDocGenerator } from '../../../../../common/generate_data'; export const mockHostResultList: (options?: { @@ -40,3 +40,14 @@ export const mockHostResultList: (options?: { }; return mock; }; + +/** + * returns a mocked API response for retrieving a single host metadata + */ +export const mockHostDetailsApiResult = (): HostInfo => { + const generator = new EndpointDocGenerator('seed'); + return { + metadata: generator.generateHostMetadata(), + host_status: HostStatus.ERROR, + }; +}; diff --git a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx index 37080e8568350..90829f7ad4cbe 100644 --- a/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx +++ b/x-pack/plugins/endpoint/public/applications/endpoint/view/hosts/details.tsx @@ -28,6 +28,7 @@ import { useHostListSelector } from './hooks'; import { urlFromQueryParams } from './url_from_query_params'; import { FormattedDateAndTime } from '../formatted_date_time'; import { uiQueryParams, detailsData, detailsError } from './../../store/hosts/selectors'; +import { LinkToApp } from '../../components/link_to_app'; const HostIds = styled(EuiListGroupItem)` margin-top: 0; @@ -37,6 +38,7 @@ const HostIds = styled(EuiListGroupItem)` `; const HostDetails = memo(({ details }: { details: HostMetadata }) => { + const { appId, appPath, url } = useHostLogsUrl(details.host.id); const detailsResultsUpper = useMemo(() => { return [ { @@ -113,6 +115,20 @@ const HostDetails = memo(({ details }: { details: HostMetadata }) => { listItems={detailsResultsLower} data-test-subj="hostDetailsLowerList" /> + +