@backstage/config-loader 0.9.3 → 0.9.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @backstage/config-loader
 
+## 0.9.4
+
+### Patch Changes
+
+- 1ed305728b: Bump `node-fetch` to version 2.6.7 and `cross-fetch` to version 3.1.5
+- c77c5c7eb6: Added `backstage.role` to `package.json`
+- Updated dependencies
+  - @backstage/errors@0.2.1
+  - @backstage/cli-common@0.1.7
+  - @backstage/config@0.1.14
+  - @backstage/types@0.1.2
+
 ## 0.9.3
 
 ### Patch Changes

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@backstage/config-loader",
   "description": "Config loading functionality used by Backstage backend, and CLI",
-  "version": "0.9.3",
+  "version": "0.9.4",
   "private": false,
   "publishConfig": {
     "access": "public",
@@ -9,6 +9,9 @@
     "module": "dist/index.esm.js",
     "types": "dist/index.d.ts"
   },
+  "backstage": {
+    "role": "node-library"
+  },
   "homepage": "https://backstage.io",
   "repository": {
     "type": "git",
@@ -22,18 +25,19 @@
   "main": "dist/index.cjs.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "backstage-cli build",
-    "lint": "backstage-cli lint",
-    "test": "backstage-cli test",
-    "prepack": "backstage-cli prepack",
-    "postpack": "backstage-cli postpack",
-    "clean": "backstage-cli clean"
+    "build": "backstage-cli package build",
+    "lint": "backstage-cli package lint",
+    "test": "backstage-cli package test",
+    "prepack": "backstage-cli package prepack",
+    "postpack": "backstage-cli package postpack",
+    "clean": "backstage-cli package clean",
+    "start": "backstage-cli package start"
   },
   "dependencies": {
-    "@backstage/cli-common": "^0.1.6",
-    "@backstage/config": "^0.1.13",
-    "@backstage/errors": "^0.2.0",
-    "@backstage/types": "^0.1.1",
+    "@backstage/cli-common": "^0.1.7",
+    "@backstage/config": "^0.1.14",
+    "@backstage/errors": "^0.2.1",
+    "@backstage/types": "^0.1.2",
     "@types/json-schema": "^7.0.6",
     "ajv": "^7.0.3",
     "chokidar": "^3.5.2",
@@ -41,7 +45,7 @@
     "json-schema": "^0.4.0",
     "json-schema-merge-allof": "^0.8.1",
     "json-schema-traverse": "^1.0.0",
-    "node-fetch": "^2.6.1",
+    "node-fetch": "^2.6.7",
     "typescript-json-schema": "^0.52.0",
     "yaml": "^1.9.2",
     "yup": "^0.32.9"
@@ -58,6 +62,6 @@
   "files": [
     "dist"
   ],
-  "gitHead": "600d6e3c854bbfb12a0078ca6f726d1c0d1fea0b",
+  "gitHead": "4805c3d13ce9bfc369e53c271b1b95e722b3b4dc",
   "module": "dist/index.esm.js"
 }

package/dist/index.d.ts

@@ -1,174 +0,0 @@
-import { AppConfig } from '@backstage/config';
-import { JSONSchema7 } from 'json-schema';
-import { JsonObject } from '@backstage/types';
-
-/**
- * Read runtime configuration from the environment.
- *
- * Only environment variables prefixed with APP_CONFIG_ will be considered.
- *
- * For each variable, the prefix will be removed, and rest of the key will
- * be split by '_'. Each part will then be used as keys to build up a nested
- * config object structure. The treatment of the entire environment variable
- * is case-sensitive.
- *
- * The value of the variable should be JSON serialized, as it will be parsed
- * and the type will be kept intact. For example "true" and true are treated
- * differently, as well as "42" and 42.
- *
- * For example, to set the config app.title to "My Title", use the following:
- *
- * APP_CONFIG_app_title='"My Title"'
- *
- * @public
- */
-declare function readEnvConfig(env: {
-    [name: string]: string | undefined;
-}): AppConfig[];
-
-/**
- * A type representing the possible configuration value visibilities
- *
- * @public
- */
-declare type ConfigVisibility = 'frontend' | 'backend' | 'secret';
-/**
- * A function used to transform primitive configuration values.
- *
- * @public
- */
-declare type TransformFunc<T extends number | string | boolean> = (value: T, context: {
-    visibility: ConfigVisibility;
-}) => T | undefined;
-/**
- * Options used to process configuration data with a schema.
- *
- * @public
- */
-declare type ConfigSchemaProcessingOptions = {
-    /**
-     * The visibilities that should be included in the output data.
-     * If omitted, the data will not be filtered by visibility.
-     */
-    visibility?: ConfigVisibility[];
-    /**
-     * A transform function that can be used to transform primitive configuration values
-     * during validation. The value returned from the transform function will be used
-     * instead of the original value. If the transform returns `undefined`, the value
-     * will be omitted.
-     */
-    valueTransform?: TransformFunc<any>;
-    /**
-     * Whether or not to include the `filteredKeys` property in the output `AppConfig`s.
-     *
-     * Default: `false`.
-     */
-    withFilteredKeys?: boolean;
-    /**
-     * Whether or not to include the `deprecatedKeys` property in the output `AppConfig`s.
-     *
-     * Default: `true`.
-     */
-    withDeprecatedKeys?: boolean;
-};
-/**
- * A loaded configuration schema that is ready to process configuration data.
- *
- * @public
- */
-declare type ConfigSchema = {
-    process(appConfigs: AppConfig[], options?: ConfigSchemaProcessingOptions): AppConfig[];
-    serialize(): JsonObject;
-};
-
-/**
- * Given a list of configuration schemas from packages, merge them
- * into a single json schema.
- *
- * @public
- */
-declare function mergeConfigSchemas(schemas: JSONSchema7[]): JSONSchema7;
-
-/**
- * Options that control the loading of configuration schema files in the backend.
- *
- * @public
- */
-declare type LoadConfigSchemaOptions = {
-    dependencies: string[];
-    packagePaths?: string[];
-} | {
-    serialized: JsonObject;
-};
-/**
- * Loads config schema for a Backstage instance.
- *
- * @public
- */
-declare function loadConfigSchema(options: LoadConfigSchemaOptions): Promise<ConfigSchema>;
-
-/** @public */
-declare type ConfigTarget = {
-    path: string;
-} | {
-    url: string;
-};
-/** @public */
-declare type LoadConfigOptionsWatch = {
-    /**
-     * A listener that is called when a config file is changed.
-     */
-    onChange: (configs: AppConfig[]) => void;
-    /**
-     * An optional signal that stops the watcher once the promise resolves.
-     */
-    stopSignal?: Promise<void>;
-};
-/** @public */
-declare type LoadConfigOptionsRemote = {
-    /**
-     * A remote config reloading period, in seconds
-     */
-    reloadIntervalSeconds: number;
-};
-/**
- * Options that control the loading of configuration files in the backend.
- *
- * @public
- */
-declare type LoadConfigOptions = {
-    configRoot: string;
-    configTargets: ConfigTarget[];
-    /**
-     * Custom environment variable loading function
-     *
-     * @experimental This API is not stable and may change at any point
-     */
-    experimentalEnvFunc?: (name: string) => Promise<string | undefined>;
-    /**
-     * An optional remote config
-     */
-    remote?: LoadConfigOptionsRemote;
-    /**
-     * An optional configuration that enables watching of config files.
-     */
-    watch?: LoadConfigOptionsWatch;
-};
-/**
- * Results of loading configuration files.
- * @public
- */
-declare type LoadConfigResult = {
-    /**
-     * Array of all loaded configs.
-     */
-    appConfigs: AppConfig[];
-};
-/**
- * Load configuration data.
- *
- * @public
- */
-declare function loadConfig(options: LoadConfigOptions): Promise<LoadConfigResult>;
-
-export { ConfigSchema, ConfigSchemaProcessingOptions, ConfigTarget, ConfigVisibility, LoadConfigOptions, LoadConfigOptionsRemote, LoadConfigOptionsWatch, LoadConfigResult, LoadConfigSchemaOptions, TransformFunc, loadConfig, loadConfigSchema, mergeConfigSchemas, readEnvConfig };

package/dist/index.esm.js

@@ -1,737 +0,0 @@
-import { assertError, ForwardedError } from '@backstage/errors';
-import yaml from 'yaml';
-import { extname, resolve, dirname, sep, relative, isAbsolute, basename } from 'path';
-import Ajv from 'ajv';
-import mergeAllOf from 'json-schema-merge-allof';
-import traverse from 'json-schema-traverse';
-import { ConfigReader } from '@backstage/config';
-import fs from 'fs-extra';
-import { getProgramFromFiles, generateSchema } from 'typescript-json-schema';
-import chokidar from 'chokidar';
-import fetch from 'node-fetch';
-
-const ENV_PREFIX = "APP_CONFIG_";
-const CONFIG_KEY_PART_PATTERN = /^[a-z][a-z0-9]*(?:[-_][a-z][a-z0-9]*)*$/i;
-function readEnvConfig(env) {
-  var _a;
-  let data = void 0;
-  for (const [name, value] of Object.entries(env)) {
-    if (!value) {
-      continue;
-    }
-    if (name.startsWith(ENV_PREFIX)) {
-      const key = name.replace(ENV_PREFIX, "");
-      const keyParts = key.split("_");
-      let obj = data = data != null ? data : {};
-      for (const [index, part] of keyParts.entries()) {
-        if (!CONFIG_KEY_PART_PATTERN.test(part)) {
-          throw new TypeError(`Invalid env config key '${key}'`);
-        }
-        if (index < keyParts.length - 1) {
-          obj = obj[part] = (_a = obj[part]) != null ? _a : {};
-          if (typeof obj !== "object" || Array.isArray(obj)) {
-            const subKey = keyParts.slice(0, index + 1).join("_");
-            throw new TypeError(`Could not nest config for key '${key}' under existing value '${subKey}'`);
-          }
-        } else {
-          if (part in obj) {
-            throw new TypeError(`Refusing to override existing config at key '${key}'`);
-          }
-          try {
-            const [, parsedValue] = safeJsonParse(value);
-            if (parsedValue === null) {
-              throw new Error("value may not be null");
-            }
-            obj[part] = parsedValue;
-          } catch (error) {
-            throw new TypeError(`Failed to parse JSON-serialized config value for key '${key}', ${error}`);
-          }
-        }
-      }
-    }
-  }
-  return data ? [{ data, context: "env" }] : [];
-}
-function safeJsonParse(str) {
-  try {
-    return [null, JSON.parse(str)];
-  } catch (err) {
-    assertError(err);
-    return [err, str];
-  }
-}
-
-function isObject(obj) {
-  if (typeof obj !== "object") {
-    return false;
-  } else if (Array.isArray(obj)) {
-    return false;
-  }
-  return obj !== null;
-}
-
-async function applyConfigTransforms(initialDir, input, transforms) {
-  async function transform(inputObj, path, baseDir) {
-    var _a;
-    let obj = inputObj;
-    let dir = baseDir;
-    for (const tf of transforms) {
-      try {
-        const result = await tf(inputObj, baseDir);
-        if (result.applied) {
-          if (result.value === void 0) {
-            return void 0;
-          }
-          obj = result.value;
-          dir = (_a = result.newBaseDir) != null ? _a : dir;
-          break;
-        }
-      } catch (error) {
-        assertError(error);
-        throw new Error(`error at ${path}, ${error.message}`);
-      }
-    }
-    if (typeof obj !== "object") {
-      return obj;
-    } else if (obj === null) {
-      return void 0;
-    } else if (Array.isArray(obj)) {
-      const arr = new Array();
-      for (const [index, value] of obj.entries()) {
-        const out2 = await transform(value, `${path}[${index}]`, dir);
-        if (out2 !== void 0) {
-          arr.push(out2);
-        }
-      }
-      return arr;
-    }
-    const out = {};
-    for (const [key, value] of Object.entries(obj)) {
-      if (value !== void 0) {
-        const result = await transform(value, `${path}.${key}`, dir);
-        if (result !== void 0) {
-          out[key] = result;
-        }
-      }
-    }
-    return out;
-  }
-  const finalData = await transform(input, "", initialDir);
-  if (!isObject(finalData)) {
-    throw new TypeError("expected object at config root");
-  }
-  return finalData;
-}
-
-const includeFileParser = {
-  ".json": async (content) => JSON.parse(content),
-  ".yaml": async (content) => yaml.parse(content),
-  ".yml": async (content) => yaml.parse(content)
-};
-function createIncludeTransform(env, readFile, substitute) {
-  return async (input, baseDir) => {
-    if (!isObject(input)) {
-      return { applied: false };
-    }
-    const [includeKey] = Object.keys(input).filter((key) => key.startsWith("$"));
-    if (includeKey) {
-      if (Object.keys(input).length !== 1) {
-        throw new Error(`include key ${includeKey} should not have adjacent keys`);
-      }
-    } else {
-      return { applied: false };
-    }
-    const rawIncludedValue = input[includeKey];
-    if (typeof rawIncludedValue !== "string") {
-      throw new Error(`${includeKey} include value is not a string`);
-    }
-    const substituteResults = await substitute(rawIncludedValue, baseDir);
-    const includeValue = substituteResults.applied ? substituteResults.value : rawIncludedValue;
-    if (includeValue === void 0 || typeof includeValue !== "string") {
-      throw new Error(`${includeKey} substitution value was undefined`);
-    }
-    switch (includeKey) {
-      case "$file":
-        try {
-          const value = await readFile(resolve(baseDir, includeValue));
-          return { applied: true, value };
-        } catch (error) {
-          throw new Error(`failed to read file ${includeValue}, ${error}`);
-        }
-      case "$env":
-        try {
-          return { applied: true, value: await env(includeValue) };
-        } catch (error) {
-          throw new Error(`failed to read env ${includeValue}, ${error}`);
-        }
-      case "$include": {
-        const [filePath, dataPath] = includeValue.split(/#(.*)/);
-        const ext = extname(filePath);
-        const parser = includeFileParser[ext];
-        if (!parser) {
-          throw new Error(`no configuration parser available for included file ${filePath}`);
-        }
-        const path = resolve(baseDir, filePath);
-        const content = await readFile(path);
-        const newBaseDir = dirname(path);
-        const parts = dataPath ? dataPath.split(".") : [];
-        let value;
-        try {
-          value = await parser(content);
-        } catch (error) {
-          throw new Error(`failed to parse included file ${filePath}, ${error}`);
-        }
-        for (const [index, part] of parts.entries()) {
-          if (!isObject(value)) {
-            const errPath = parts.slice(0, index).join(".");
-            throw new Error(`value at '${errPath}' in included file ${filePath} is not an object`);
-          }
-          value = value[part];
-        }
-        return {
-          applied: true,
-          value,
-          newBaseDir: newBaseDir !== baseDir ? newBaseDir : void 0
-        };
-      }
-      default:
-        throw new Error(`unknown include ${includeKey}`);
-    }
-  };
-}
-
-function createSubstitutionTransform(env) {
-  return async (input) => {
-    if (typeof input !== "string") {
-      return { applied: false };
-    }
-    const parts = input.split(/(\$?\$\{[^{}]*\})/);
-    for (let i = 1; i < parts.length; i += 2) {
-      const part = parts[i];
-      if (part.startsWith("$$")) {
-        parts[i] = part.slice(1);
-      } else {
-        parts[i] = await env(part.slice(2, -1).trim());
-      }
-    }
-    if (parts.some((part) => part === void 0)) {
-      return { applied: true, value: void 0 };
-    }
-    return { applied: true, value: parts.join("") };
-  };
-}
-
-const CONFIG_VISIBILITIES = ["frontend", "backend", "secret"];
-const DEFAULT_CONFIG_VISIBILITY = "backend";
-
-function compileConfigSchemas(schemas) {
-  const visibilityByDataPath = /* @__PURE__ */ new Map();
-  const deprecationByDataPath = /* @__PURE__ */ new Map();
-  const ajv = new Ajv({
-    allErrors: true,
-    allowUnionTypes: true,
-    schemas: {
-      "https://backstage.io/schema/config-v1": true
-    }
-  }).addKeyword({
-    keyword: "visibility",
-    metaSchema: {
-      type: "string",
-      enum: CONFIG_VISIBILITIES
-    },
-    compile(visibility) {
-      return (_data, context) => {
-        if ((context == null ? void 0 : context.dataPath) === void 0) {
-          return false;
-        }
-        if (visibility && visibility !== "backend") {
-          const normalizedPath = context.dataPath.replace(/\['?(.*?)'?\]/g, (_, segment) => `/${segment}`);
-          visibilityByDataPath.set(normalizedPath, visibility);
-        }
-        return true;
-      };
-    }
-  }).removeKeyword("deprecated").addKeyword({
-    keyword: "deprecated",
-    metaSchema: { type: "string" },
-    compile(deprecationDescription) {
-      return (_data, context) => {
-        if ((context == null ? void 0 : context.dataPath) === void 0) {
-          return false;
-        }
-        const normalizedPath = context.dataPath.replace(/\['?(.*?)'?\]/g, (_, segment) => `/${segment}`);
-        deprecationByDataPath.set(normalizedPath, deprecationDescription);
-        return true;
-      };
-    }
-  });
-  for (const schema of schemas) {
-    try {
-      ajv.compile(schema.value);
-    } catch (error) {
-      throw new Error(`Schema at ${schema.path} is invalid, ${error}`);
-    }
-  }
-  const merged = mergeConfigSchemas(schemas.map((_) => _.value));
-  const validate = ajv.compile(merged);
-  const visibilityBySchemaPath = /* @__PURE__ */ new Map();
-  traverse(merged, (schema, path) => {
-    if (schema.visibility && schema.visibility !== "backend") {
-      visibilityBySchemaPath.set(path, schema.visibility);
-    }
-  });
-  return (configs) => {
-    var _a;
-    const config = ConfigReader.fromConfigs(configs).get();
-    visibilityByDataPath.clear();
-    const valid = validate(config);
-    if (!valid) {
-      return {
-        errors: (_a = validate.errors) != null ? _a : [],
-        visibilityByDataPath: new Map(visibilityByDataPath),
-        visibilityBySchemaPath,
-        deprecationByDataPath
-      };
-    }
-    return {
-      visibilityByDataPath: new Map(visibilityByDataPath),
-      visibilityBySchemaPath,
-      deprecationByDataPath
-    };
-  };
-}
-function mergeConfigSchemas(schemas) {
-  const merged = mergeAllOf({ allOf: schemas }, {
-    ignoreAdditionalProperties: true,
-    resolvers: {
-      visibility(values, path) {
-        const hasFrontend = values.some((_) => _ === "frontend");
-        const hasSecret = values.some((_) => _ === "secret");
-        if (hasFrontend && hasSecret) {
-          throw new Error(`Config schema visibility is both 'frontend' and 'secret' for ${path.join("/")}`);
-        } else if (hasFrontend) {
-          return "frontend";
-        } else if (hasSecret) {
-          return "secret";
-        }
-        return "backend";
-      }
-    }
-  });
-  return merged;
-}
-
-const req = typeof __non_webpack_require__ === "undefined" ? require : __non_webpack_require__;
-async function collectConfigSchemas(packageNames, packagePaths) {
-  const schemas = new Array();
-  const tsSchemaPaths = new Array();
-  const visitedPackageVersions = /* @__PURE__ */ new Map();
-  const currentDir = await fs.realpath(process.cwd());
-  async function processItem(item) {
-    var _a, _b, _c, _d;
-    let pkgPath = item.packagePath;
-    if (pkgPath) {
-      const pkgExists = await fs.pathExists(pkgPath);
-      if (!pkgExists) {
-        return;
-      }
-    } else if (item.name) {
-      const { name, parentPath } = item;
-      try {
-        pkgPath = req.resolve(`${name}/package.json`, parentPath && {
-          paths: [parentPath]
-        });
-      } catch {
-      }
-    }
-    if (!pkgPath) {
-      return;
-    }
-    const pkg = await fs.readJson(pkgPath);
-    let versions = visitedPackageVersions.get(pkg.name);
-    if (versions == null ? void 0 : versions.has(pkg.version)) {
-      return;
-    }
-    if (!versions) {
-      versions = /* @__PURE__ */ new Set();
-      visitedPackageVersions.set(pkg.name, versions);
-    }
-    versions.add(pkg.version);
-    const depNames = [
-      ...Object.keys((_a = pkg.dependencies) != null ? _a : {}),
-      ...Object.keys((_b = pkg.devDependencies) != null ? _b : {}),
-      ...Object.keys((_c = pkg.optionalDependencies) != null ? _c : {}),
-      ...Object.keys((_d = pkg.peerDependencies) != null ? _d : {})
-    ];
-    const hasSchema = "configSchema" in pkg;
-    const hasBackstageDep = depNames.some((_) => _.startsWith("@backstage/"));
-    if (!hasSchema && !hasBackstageDep) {
-      return;
-    }
-    if (hasSchema) {
-      if (typeof pkg.configSchema === "string") {
-        const isJson = pkg.configSchema.endsWith(".json");
-        const isDts = pkg.configSchema.endsWith(".d.ts");
-        if (!isJson && !isDts) {
-          throw new Error(`Config schema files must be .json or .d.ts, got ${pkg.configSchema}`);
-        }
-        if (isDts) {
-          tsSchemaPaths.push(relative(currentDir, resolve(dirname(pkgPath), pkg.configSchema)));
-        } else {
-          const path = resolve(dirname(pkgPath), pkg.configSchema);
-          const value = await fs.readJson(path);
-          schemas.push({
-            value,
-            path: relative(currentDir, path)
-          });
-        }
-      } else {
-        schemas.push({
-          value: pkg.configSchema,
-          path: relative(currentDir, pkgPath)
-        });
-      }
-    }
-    await Promise.all(depNames.map((depName) => processItem({ name: depName, parentPath: pkgPath })));
-  }
-  await Promise.all([
-    ...packageNames.map((name) => processItem({ name, parentPath: currentDir })),
-    ...packagePaths.map((path) => processItem({ name: path, packagePath: path }))
-  ]);
-  const tsSchemas = compileTsSchemas(tsSchemaPaths);
-  return schemas.concat(tsSchemas);
-}
-function compileTsSchemas(paths) {
-  if (paths.length === 0) {
-    return [];
-  }
-  const program = getProgramFromFiles(paths, {
-    incremental: false,
-    isolatedModules: true,
-    lib: ["ES5"],
-    noEmit: true,
-    noResolve: true,
-    skipLibCheck: true,
-    skipDefaultLibCheck: true,
-    strict: true,
-    typeRoots: [],
-    types: []
-  });
-  const tsSchemas = paths.map((path) => {
-    let value;
-    try {
-      value = generateSchema(program, "Config", {
-        required: true,
-        validationKeywords: ["visibility", "deprecated"]
-      }, [path.split(sep).join("/")]);
-    } catch (error) {
-      assertError(error);
-      if (error.message !== "type Config not found") {
-        throw error;
-      }
-    }
-    if (!value) {
-      throw new Error(`Invalid schema in ${path}, missing Config export`);
-    }
-    return { path, value };
-  });
-  return tsSchemas;
-}
-
-function filterByVisibility(data, includeVisibilities, visibilityByDataPath, deprecationByDataPath, transformFunc, withFilteredKeys, withDeprecatedKeys) {
-  var _a;
-  const filteredKeys = new Array();
-  const deprecatedKeys = new Array();
-  function transform(jsonVal, visibilityPath, filterPath) {
-    var _a2;
-    const visibility = (_a2 = visibilityByDataPath.get(visibilityPath)) != null ? _a2 : DEFAULT_CONFIG_VISIBILITY;
-    const isVisible = includeVisibilities.includes(visibility);
-    const deprecation = deprecationByDataPath.get(visibilityPath);
-    if (deprecation) {
-      deprecatedKeys.push({ key: filterPath, description: deprecation });
-    }
-    if (typeof jsonVal !== "object") {
-      if (isVisible) {
-        if (transformFunc) {
-          return transformFunc(jsonVal, { visibility });
-        }
-        return jsonVal;
-      }
-      if (withFilteredKeys) {
-        filteredKeys.push(filterPath);
-      }
-      return void 0;
-    } else if (jsonVal === null) {
-      return void 0;
-    } else if (Array.isArray(jsonVal)) {
-      const arr = new Array();
-      for (const [index, value] of jsonVal.entries()) {
-        let path = visibilityPath;
-        const hasVisibilityInIndex = visibilityByDataPath.get(`${visibilityPath}/${index}`);
-        if (hasVisibilityInIndex || typeof value === "object") {
-          path = `${visibilityPath}/${index}`;
-        }
-        const out = transform(value, path, `${filterPath}[${index}]`);
-        if (out !== void 0) {
-          arr.push(out);
-        }
-      }
-      if (arr.length > 0 || isVisible) {
-        return arr;
-      }
-      return void 0;
-    }
-    const outObj = {};
-    let hasOutput = false;
-    for (const [key, value] of Object.entries(jsonVal)) {
-      if (value === void 0) {
-        continue;
-      }
-      const out = transform(value, `${visibilityPath}/${key}`, filterPath ? `${filterPath}.${key}` : key);
-      if (out !== void 0) {
-        outObj[key] = out;
-        hasOutput = true;
-      }
-    }
-    if (hasOutput || isVisible) {
-      return outObj;
-    }
-    return void 0;
-  }
-  return {
-    filteredKeys: withFilteredKeys ? filteredKeys : void 0,
-    deprecatedKeys: withDeprecatedKeys ? deprecatedKeys : void 0,
-    data: (_a = transform(data, "", "")) != null ? _a : {}
-  };
-}
-function filterErrorsByVisibility(errors, includeVisibilities, visibilityByDataPath, visibilityBySchemaPath) {
-  if (!errors) {
-    return [];
-  }
-  if (!includeVisibilities) {
-    return errors;
-  }
-  const visibleSchemaPaths = Array.from(visibilityBySchemaPath).filter(([, v]) => includeVisibilities.includes(v)).map(([k]) => k);
-  return errors.filter((error) => {
-    var _a;
-    if (error.keyword === "type" && ["object", "array"].includes(error.params.type)) {
-      return true;
-    }
-    if (error.keyword === "required") {
-      const trimmedPath = error.schemaPath.slice(1, -"/required".length);
-      const fullPath = `${trimmedPath}/properties/${error.params.missingProperty}`;
-      if (visibleSchemaPaths.some((visiblePath) => visiblePath.startsWith(fullPath))) {
-        return true;
-      }
-    }
-    const vis = (_a = visibilityByDataPath.get(error.dataPath)) != null ? _a : DEFAULT_CONFIG_VISIBILITY;
-    return vis && includeVisibilities.includes(vis);
-  });
-}
-
-function errorsToError(errors) {
-  const messages = errors.map(({ dataPath, message, params }) => {
-    const paramStr = Object.entries(params).map(([name, value]) => `${name}=${value}`).join(" ");
-    return `Config ${message || ""} { ${paramStr} } at ${dataPath}`;
-  });
-  const error = new Error(`Config validation failed, ${messages.join("; ")}`);
-  error.messages = messages;
-  return error;
-}
-async function loadConfigSchema(options) {
-  var _a;
-  let schemas;
-  if ("dependencies" in options) {
-    schemas = await collectConfigSchemas(options.dependencies, (_a = options.packagePaths) != null ? _a : []);
-  } else {
-    const { serialized } = options;
-    if ((serialized == null ? void 0 : serialized.backstageConfigSchemaVersion) !== 1) {
-      throw new Error("Serialized configuration schema is invalid or has an invalid version number");
-    }
-    schemas = serialized.schemas;
-  }
-  const validate = compileConfigSchemas(schemas);
-  return {
-    process(configs, { visibility, valueTransform, withFilteredKeys, withDeprecatedKeys } = {}) {
-      const result = validate(configs);
-      const visibleErrors = filterErrorsByVisibility(result.errors, visibility, result.visibilityByDataPath, result.visibilityBySchemaPath);
-      if (visibleErrors.length > 0) {
-        throw errorsToError(visibleErrors);
-      }
-      let processedConfigs = configs;
-      if (visibility) {
-        processedConfigs = processedConfigs.map(({ data, context }) => ({
-          context,
-          ...filterByVisibility(data, visibility, result.visibilityByDataPath, result.deprecationByDataPath, valueTransform, withFilteredKeys, withDeprecatedKeys)
-        }));
-      } else if (valueTransform) {
-        processedConfigs = processedConfigs.map(({ data, context }) => ({
-          context,
-          ...filterByVisibility(data, Array.from(CONFIG_VISIBILITIES), result.visibilityByDataPath, result.deprecationByDataPath, valueTransform, withFilteredKeys, withDeprecatedKeys)
-        }));
-      }
-      return processedConfigs;
-    },
-    serialize() {
-      return {
-        schemas,
-        backstageConfigSchemaVersion: 1
-      };
-    }
-  };
-}
-
-function isValidUrl(url) {
-  try {
-    new URL(url);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function loadConfig(options) {
-  const { configRoot, experimentalEnvFunc: envFunc, watch, remote } = options;
-  const configPaths = options.configTargets.slice().filter((e) => e.hasOwnProperty("path")).map((configTarget) => configTarget.path);
-  const configUrls = options.configTargets.slice().filter((e) => e.hasOwnProperty("url")).map((configTarget) => configTarget.url);
-  if (remote === void 0) {
-    if (configUrls.length > 0) {
-      throw new Error(`Please make sure you are passing the remote option when loading remote configurations. See https://backstage.io/docs/conf/writing#configuration-files for detailed info.`);
-    }
-  } else if (remote.reloadIntervalSeconds <= 0) {
-    throw new Error(`Remote config must be contain a non zero reloadIntervalSeconds: <seconds> value`);
-  }
-  if (configPaths.length === 0 && configUrls.length === 0) {
-    configPaths.push(resolve(configRoot, "app-config.yaml"));
-    const localConfig = resolve(configRoot, "app-config.local.yaml");
-    if (await fs.pathExists(localConfig)) {
-      configPaths.push(localConfig);
-    }
-  }
-  const env = envFunc != null ? envFunc : async (name) => process.env[name];
-  const loadConfigFiles = async () => {
-    const configs = [];
-    for (const configPath of configPaths) {
-      if (!isAbsolute(configPath)) {
-        throw new Error(`Config load path is not absolute: '${configPath}'`);
-      }
-      const dir = dirname(configPath);
-      const readFile = (path) => fs.readFile(resolve(dir, path), "utf8");
-      const input = yaml.parse(await readFile(configPath));
-      const substitutionTransform = createSubstitutionTransform(env);
-      const data = await applyConfigTransforms(dir, input, [
-        createIncludeTransform(env, readFile, substitutionTransform),
-        substitutionTransform
-      ]);
-      configs.push({ data, context: basename(configPath) });
-    }
-    return configs;
-  };
-  const loadRemoteConfigFiles = async () => {
-    const configs = [];
-    const readConfigFromUrl = async (url) => {
-      const response = await fetch(url);
-      if (!response.ok) {
-        throw new Error(`Could not read config file at ${url}`);
-      }
-      return await response.text();
-    };
-    for (let i = 0; i < configUrls.length; i++) {
-      const configUrl = configUrls[i];
-      if (!isValidUrl(configUrl)) {
-        throw new Error(`Config load path is not valid: '${configUrl}'`);
-      }
-      const remoteConfigContent = await readConfigFromUrl(configUrl);
-      if (!remoteConfigContent) {
-        throw new Error(`Config is not valid`);
-      }
-      const configYaml = yaml.parse(remoteConfigContent);
-      const substitutionTransform = createSubstitutionTransform(env);
-      const data = await applyConfigTransforms(configRoot, configYaml, [
-        substitutionTransform
-      ]);
-      configs.push({ data, context: configUrl });
-    }
-    return configs;
-  };
-  let fileConfigs;
-  try {
-    fileConfigs = await loadConfigFiles();
-  } catch (error) {
-    throw new ForwardedError("Failed to read static configuration file", error);
-  }
-  let remoteConfigs = [];
-  if (remote) {
-    try {
-      remoteConfigs = await loadRemoteConfigFiles();
-    } catch (error) {
-      throw new ForwardedError(`Failed to read remote configuration file`, error);
-    }
-  }
-  const envConfigs = await readEnvConfig(process.env);
-  const watchConfigFile = (watchProp) => {
-    const watcher = chokidar.watch(configPaths, {
-      usePolling: process.env.NODE_ENV === "test"
-    });
-    let currentSerializedConfig = JSON.stringify(fileConfigs);
-    watcher.on("change", async () => {
-      try {
-        const newConfigs = await loadConfigFiles();
-        const newSerializedConfig = JSON.stringify(newConfigs);
-        if (currentSerializedConfig === newSerializedConfig) {
-          return;
-        }
-        currentSerializedConfig = newSerializedConfig;
-        watchProp.onChange([...remoteConfigs, ...newConfigs, ...envConfigs]);
-      } catch (error) {
-        console.error(`Failed to reload configuration files, ${error}`);
-      }
-    });
-    if (watchProp.stopSignal) {
-      watchProp.stopSignal.then(() => {
-        watcher.close();
-      });
-    }
-  };
-  const watchRemoteConfig = (watchProp, remoteProp) => {
-    const hasConfigChanged = async (oldRemoteConfigs, newRemoteConfigs) => {
-      return JSON.stringify(oldRemoteConfigs) !== JSON.stringify(newRemoteConfigs);
-    };
-    let handle;
-    try {
-      handle = setInterval(async () => {
-        console.info(`Checking for config update`);
-        const newRemoteConfigs = await loadRemoteConfigFiles();
-        if (await hasConfigChanged(remoteConfigs, newRemoteConfigs)) {
-          remoteConfigs = newRemoteConfigs;
-          console.info(`Remote config change, reloading config ...`);
-          watchProp.onChange([...remoteConfigs, ...fileConfigs, ...envConfigs]);
-          console.info(`Remote config reloaded`);
-        }
-      }, remoteProp.reloadIntervalSeconds * 1e3);
-    } catch (error) {
-      console.error(`Failed to reload configuration files, ${error}`);
-    }
-    if (watchProp.stopSignal) {
-      watchProp.stopSignal.then(() => {
-        if (handle !== void 0) {
-          console.info(`Stopping remote config watch`);
-          clearInterval(handle);
-          handle = void 0;
-        }
-      });
-    }
-  };
-  if (watch) {
-    watchConfigFile(watch);
-  }
-  if (watch && remote) {
-    watchRemoteConfig(watch, remote);
-  }
-  return {
-    appConfigs: remote ? [...remoteConfigs, ...fileConfigs, ...envConfigs] : [...fileConfigs, ...envConfigs]
-  };
-}
-
-export { loadConfig, loadConfigSchema, mergeConfigSchemas, readEnvConfig };
-//# sourceMappingURL=index.esm.js.map

package/dist/index.esm.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.esm.js","sources":["../src/lib/env.ts","../src/lib/transform/utils.ts","../src/lib/transform/apply.ts","../src/lib/transform/include.ts","../src/lib/transform/substitution.ts","../src/lib/schema/types.ts","../src/lib/schema/compile.ts","../src/lib/schema/collect.ts","../src/lib/schema/filtering.ts","../src/lib/schema/load.ts","../src/lib/urls.ts","../src/loader.ts"],"sourcesContent":["/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppConfig } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\nimport { assertError } from '@backstage/errors';\n\nconst ENV_PREFIX = 'APP_CONFIG_';\n\n// Update the same pattern in config package if this is changed\nconst CONFIG_KEY_PART_PATTERN = /^[a-z][a-z0-9]*(?:[-_][a-z][a-z0-9]*)*$/i;\n\n/**\n * Read runtime configuration from the environment.\n *\n * Only environment variables prefixed with APP_CONFIG_ will be considered.\n *\n * For each variable, the prefix will be removed, and rest of the key will\n * be split by '_'. Each part will then be used as keys to build up a nested\n * config object structure. The treatment of the entire environment variable\n * is case-sensitive.\n *\n * The value of the variable should be JSON serialized, as it will be parsed\n * and the type will be kept intact. For example \"true\" and true are treated\n * differently, as well as \"42\" and 42.\n *\n * For example, to set the config app.title to \"My Title\", use the following:\n *\n * APP_CONFIG_app_title='\"My Title\"'\n *\n * @public\n */\nexport function readEnvConfig(env: {\n  [name: string]: string | undefined;\n}): AppConfig[] {\n  let data: JsonObject | undefined = undefined;\n\n  for (const [name, value] of Object.entries(env)) {\n    if (!value) {\n      continue;\n    }\n    if (name.startsWith(ENV_PREFIX)) {\n      const key = name.replace(ENV_PREFIX, '');\n      const keyParts = key.split('_');\n\n      let obj = (data = data ?? {});\n      for (const [index, part] of keyParts.entries()) {\n        if (!CONFIG_KEY_PART_PATTERN.test(part)) {\n          throw new TypeError(`Invalid env config key '${key}'`);\n        }\n        if (index < keyParts.length - 1) {\n          obj = (obj[part] = obj[part] ?? {}) as JsonObject;\n          if (typeof obj !== 'object' || Array.isArray(obj)) {\n            const subKey = keyParts.slice(0, index + 1).join('_');\n            throw new TypeError(\n              `Could not nest config for key '${key}' under existing value '${subKey}'`,\n            );\n          }\n        } else {\n          if (part in obj) {\n            throw new TypeError(\n              `Refusing to override existing config at key '${key}'`,\n            );\n          }\n          try {\n            const [, parsedValue] = safeJsonParse(value);\n            if (parsedValue === null) {\n              throw new Error('value may not be null');\n            }\n            obj[part] = parsedValue;\n          } catch (error) {\n            throw new TypeError(\n              `Failed to parse JSON-serialized config value for key '${key}', ${error}`,\n            );\n          }\n        }\n      }\n    }\n  }\n\n  return data ? [{ data, context: 'env' }] : [];\n}\n\nfunction safeJsonParse(str: string): [Error | null, any] {\n  try {\n    return [null, JSON.parse(str)];\n  } catch (err) {\n    assertError(err);\n    return [err, str];\n  }\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonValue, JsonObject } from '@backstage/types';\n\nexport function isObject(obj: JsonValue | undefined): obj is JsonObject {\n  if (typeof obj !== 'object') {\n    return false;\n  } else if (Array.isArray(obj)) {\n    return false;\n  }\n  return obj !== null;\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonObject, JsonValue } from '@backstage/types';\nimport { assertError } from '@backstage/errors';\nimport { TransformFunc } from './types';\nimport { isObject } from './utils';\n\n/**\n * Applies a set of transforms to raw configuration data.\n */\nexport async function applyConfigTransforms(\n  initialDir: string,\n  input: JsonValue,\n  transforms: TransformFunc[],\n): Promise<JsonObject> {\n  async function transform(\n    inputObj: JsonValue,\n    path: string,\n    baseDir: string,\n  ): Promise<JsonValue | undefined> {\n    let obj = inputObj;\n    let dir = baseDir;\n\n    for (const tf of transforms) {\n      try {\n        const result = await tf(inputObj, baseDir);\n        if (result.applied) {\n          if (result.value === undefined) {\n            return undefined;\n          }\n          obj = result.value;\n          dir = result.newBaseDir ?? dir;\n          break;\n        }\n      } catch (error) {\n        assertError(error);\n        throw new Error(`error at ${path}, ${error.message}`);\n      }\n    }\n\n    if (typeof obj !== 'object') {\n      return obj;\n    } else if (obj === null) {\n      return undefined;\n    } else if (Array.isArray(obj)) {\n      const arr = new Array<JsonValue>();\n\n      for (const [index, value] of obj.entries()) {\n        const out = await transform(value, `${path}[${index}]`, dir);\n        if (out !== undefined) {\n          arr.push(out);\n        }\n      }\n\n      return arr;\n    }\n\n    const out: JsonObject = {};\n\n    for (const [key, value] of Object.entries(obj)) {\n      // undefined covers optional fields\n      if (value !== undefined) {\n        const result = await transform(value, `${path}.${key}`, dir);\n        if (result !== undefined) {\n          out[key] = result;\n        }\n      }\n    }\n\n    return out;\n  }\n\n  const finalData = await transform(input, '', initialDir);\n  if (!isObject(finalData)) {\n    throw new TypeError('expected object at config root');\n  }\n  return finalData;\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport yaml from 'yaml';\nimport { extname, dirname, resolve as resolvePath } from 'path';\nimport { JsonObject, JsonValue } from '@backstage/types';\nimport { isObject } from './utils';\nimport { TransformFunc, EnvFunc, ReadFileFunc } from './types';\n\n// Parsers for each type of included file\nconst includeFileParser: {\n  [ext in string]: (content: string) => Promise<JsonObject>;\n} = {\n  '.json': async content => JSON.parse(content),\n  '.yaml': async content => yaml.parse(content),\n  '.yml': async content => yaml.parse(content),\n};\n\n/**\n * Transforms a include description into the actual included value.\n */\nexport function createIncludeTransform(\n  env: EnvFunc,\n  readFile: ReadFileFunc,\n  substitute: TransformFunc,\n): TransformFunc {\n  return async (input: JsonValue, baseDir: string) => {\n    if (!isObject(input)) {\n      return { applied: false };\n    }\n    // Check if there's any key that starts with a '$', in that case we treat\n    // this entire object as an include description.\n    const [includeKey] = Object.keys(input).filter(key => key.startsWith('$'));\n    if (includeKey) {\n      if (Object.keys(input).length !== 1) {\n        throw new Error(\n          `include key ${includeKey} should not have adjacent keys`,\n        );\n      }\n    } else {\n      return { applied: false };\n    }\n\n    const rawIncludedValue = input[includeKey];\n    if (typeof rawIncludedValue !== 'string') {\n      throw new Error(`${includeKey} include value is not a string`);\n    }\n\n    const substituteResults = await substitute(rawIncludedValue, baseDir);\n    const includeValue = substituteResults.applied\n      ? substituteResults.value\n      : rawIncludedValue;\n\n    // The second string check is needed for Typescript to know this is a string.\n    if (includeValue === undefined || typeof includeValue !== 'string') {\n      throw new Error(`${includeKey} substitution value was undefined`);\n    }\n\n    switch (includeKey) {\n      case '$file':\n        try {\n          const value = await readFile(resolvePath(baseDir, includeValue));\n          return { applied: true, value };\n        } catch (error) {\n          throw new Error(`failed to read file ${includeValue}, ${error}`);\n        }\n      case '$env':\n        try {\n          return { applied: true, value: await env(includeValue) };\n        } catch (error) {\n          throw new Error(`failed to read env ${includeValue}, ${error}`);\n        }\n\n      case '$include': {\n        const [filePath, dataPath] = includeValue.split(/#(.*)/);\n\n        const ext = extname(filePath);\n        const parser = includeFileParser[ext];\n        if (!parser) {\n          throw new Error(\n            `no configuration parser available for included file ${filePath}`,\n          );\n        }\n\n        const path = resolvePath(baseDir, filePath);\n        const content = await readFile(path);\n        const newBaseDir = dirname(path);\n\n        const parts = dataPath ? dataPath.split('.') : [];\n\n        let value: JsonValue | undefined;\n        try {\n          value = await parser(content);\n        } catch (error) {\n          throw new Error(\n            `failed to parse included file ${filePath}, ${error}`,\n          );\n        }\n\n        // This bit handles selecting a subtree in the included file, if a path was provided after a #\n        for (const [index, part] of parts.entries()) {\n          if (!isObject(value)) {\n            const errPath = parts.slice(0, index).join('.');\n            throw new Error(\n              `value at '${errPath}' in included file ${filePath} is not an object`,\n            );\n          }\n          value = value[part];\n        }\n\n        return {\n          applied: true,\n          value,\n          newBaseDir: newBaseDir !== baseDir ? newBaseDir : undefined,\n        };\n      }\n\n      default:\n        throw new Error(`unknown include ${includeKey}`);\n    }\n  };\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonValue } from '@backstage/types';\nimport { TransformFunc, EnvFunc } from './types';\n\n/**\n * A environment variable substitution transform that transforms e.g. 'token ${MY_TOKEN}'\n * to 'token abc' if MY_TOKEN is 'abc'. If any of the substituted variables are undefined,\n * the entire expression ends up undefined.\n */\nexport function createSubstitutionTransform(env: EnvFunc): TransformFunc {\n  return async (input: JsonValue) => {\n    if (typeof input !== 'string') {\n      return { applied: false };\n    }\n\n    const parts: (string | undefined)[] = input.split(/(\\$?\\$\\{[^{}]*\\})/);\n    for (let i = 1; i < parts.length; i += 2) {\n      const part = parts[i]!;\n      if (part.startsWith('$$')) {\n        parts[i] = part.slice(1);\n      } else {\n        parts[i] = await env(part.slice(2, -1).trim());\n      }\n    }\n\n    if (parts.some(part => part === undefined)) {\n      return { applied: true, value: undefined };\n    }\n    return { applied: true, value: parts.join('') };\n  };\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppConfig } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\n\n/**\n * An sub-set of configuration schema.\n */\nexport type ConfigSchemaPackageEntry = {\n  /**\n   * The configuration schema itself.\n   */\n  value: JsonObject;\n  /**\n   * The relative path that the configuration schema was discovered at.\n   */\n  path: string;\n};\n\n/**\n * A list of all possible configuration value visibilities.\n */\nexport const CONFIG_VISIBILITIES = ['frontend', 'backend', 'secret'] as const;\n\n/**\n * A type representing the possible configuration value visibilities\n *\n * @public\n */\nexport type ConfigVisibility = 'frontend' | 'backend' | 'secret';\n\n/**\n * The default configuration visibility if no other values is given.\n */\nexport const DEFAULT_CONFIG_VISIBILITY: ConfigVisibility = 'backend';\n\n/**\n * An explanation of a configuration validation error.\n */\nexport type ValidationError = {\n  keyword: string;\n  dataPath: string;\n  schemaPath: string;\n  params: Record<string, any>;\n  propertyName?: string;\n  message?: string;\n};\n\n/**\n * The result of validating configuration data using a schema.\n */\ntype ValidationResult = {\n  /**\n   * Errors that where emitted during validation, if any.\n   */\n  errors?: ValidationError[];\n  /**\n   * The configuration visibilities that were discovered during validation.\n   *\n   * The path in the key uses the form `/<key>/<sub-key>/<array-index>/<leaf-key>`\n   */\n  visibilityByDataPath: Map<string, ConfigVisibility>;\n\n  /**\n   * The configuration visibilities that were discovered during validation.\n   *\n   * The path in the key uses the form `/properties/<key>/items/additionalProperties/<leaf-key>`\n   */\n  visibilityBySchemaPath: Map<string, ConfigVisibility>;\n\n  /**\n   * The deprecated options that were discovered during validation.\n   *\n   * The path in the key uses the form `/<key>/<sub-key>/<array-index>/<leaf-key>`\n   */\n  deprecationByDataPath: Map<string, string>;\n};\n\n/**\n * A function used validate configuration data.\n */\nexport type ValidationFunc = (configs: AppConfig[]) => ValidationResult;\n\n/**\n * A function used to transform primitive configuration values.\n *\n * @public\n */\nexport type TransformFunc<T extends number | string | boolean> = (\n  value: T,\n  context: { visibility: ConfigVisibility },\n) => T | undefined;\n\n/**\n * Options used to process configuration data with a schema.\n *\n * @public\n */\nexport type ConfigSchemaProcessingOptions = {\n  /**\n   * The visibilities that should be included in the output data.\n   * If omitted, the data will not be filtered by visibility.\n   */\n  visibility?: ConfigVisibility[];\n\n  /**\n   * A transform function that can be used to transform primitive configuration values\n   * during validation. The value returned from the transform function will be used\n   * instead of the original value. If the transform returns `undefined`, the value\n   * will be omitted.\n   */\n  valueTransform?: TransformFunc<any>;\n\n  /**\n   * Whether or not to include the `filteredKeys` property in the output `AppConfig`s.\n   *\n   * Default: `false`.\n   */\n  withFilteredKeys?: boolean;\n\n  /**\n   * Whether or not to include the `deprecatedKeys` property in the output `AppConfig`s.\n   *\n   * Default: `true`.\n   */\n  withDeprecatedKeys?: boolean;\n};\n\n/**\n * A loaded configuration schema that is ready to process configuration data.\n *\n * @public\n */\nexport type ConfigSchema = {\n  process(\n    appConfigs: AppConfig[],\n    options?: ConfigSchemaProcessingOptions,\n  ): AppConfig[];\n\n  serialize(): JsonObject;\n};\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport Ajv from 'ajv';\nimport { JSONSchema7 as JSONSchema } from 'json-schema';\nimport mergeAllOf, { Resolvers } from 'json-schema-merge-allof';\nimport traverse from 'json-schema-traverse';\nimport { ConfigReader } from '@backstage/config';\nimport {\n  ConfigSchemaPackageEntry,\n  ValidationFunc,\n  CONFIG_VISIBILITIES,\n  ConfigVisibility,\n} from './types';\n\n/**\n * This takes a collection of Backstage configuration schemas from various\n * sources and compiles them down into a single schema validation function.\n *\n * It also handles the implementation of the custom \"visibility\" keyword used\n * to specify the scope of different config paths.\n */\nexport function compileConfigSchemas(\n  schemas: ConfigSchemaPackageEntry[],\n): ValidationFunc {\n  // The ajv instance below is stateful and doesn't really allow for additional\n  // output during validation. We work around this by having this extra piece\n  // of state that we reset before each validation.\n  const visibilityByDataPath = new Map<string, ConfigVisibility>();\n  const deprecationByDataPath = new Map<string, string>();\n\n  const ajv = new Ajv({\n    allErrors: true,\n    allowUnionTypes: true,\n    schemas: {\n      'https://backstage.io/schema/config-v1': true,\n    },\n  })\n    .addKeyword({\n      keyword: 'visibility',\n      metaSchema: {\n        type: 'string',\n        enum: CONFIG_VISIBILITIES,\n      },\n      compile(visibility: ConfigVisibility) {\n        return (_data, context) => {\n          if (context?.dataPath === undefined) {\n            return false;\n          }\n          if (visibility && visibility !== 'backend') {\n            const normalizedPath = context.dataPath.replace(\n              /\\['?(.*?)'?\\]/g,\n              (_, segment) => `/${segment}`,\n            );\n            visibilityByDataPath.set(normalizedPath, visibility);\n          }\n          return true;\n        };\n      },\n    })\n    .removeKeyword('deprecated') // remove `deprecated` keyword so that we can implement our own compiler\n    .addKeyword({\n      keyword: 'deprecated',\n      metaSchema: { type: 'string' },\n      compile(deprecationDescription: string) {\n        return (_data, context) => {\n          if (context?.dataPath === undefined) {\n            return false;\n          }\n          const normalizedPath = context.dataPath.replace(\n            /\\['?(.*?)'?\\]/g,\n            (_, segment) => `/${segment}`,\n          );\n          // create mapping of deprecation description and data path of property\n          deprecationByDataPath.set(normalizedPath, deprecationDescription);\n          return true;\n        };\n      },\n    });\n\n  for (const schema of schemas) {\n    try {\n      ajv.compile(schema.value);\n    } catch (error) {\n      throw new Error(`Schema at ${schema.path} is invalid, ${error}`);\n    }\n  }\n\n  const merged = mergeConfigSchemas(schemas.map(_ => _.value));\n\n  const validate = ajv.compile(merged);\n\n  const visibilityBySchemaPath = new Map<string, ConfigVisibility>();\n  traverse(merged, (schema, path) => {\n    if (schema.visibility && schema.visibility !== 'backend') {\n      visibilityBySchemaPath.set(path, schema.visibility);\n    }\n  });\n\n  return configs => {\n    const config = ConfigReader.fromConfigs(configs).get();\n\n    visibilityByDataPath.clear();\n\n    const valid = validate(config);\n\n    if (!valid) {\n      return {\n        errors: validate.errors ?? [],\n        visibilityByDataPath: new Map(visibilityByDataPath),\n        visibilityBySchemaPath,\n        deprecationByDataPath,\n      };\n    }\n\n    return {\n      visibilityByDataPath: new Map(visibilityByDataPath),\n      visibilityBySchemaPath,\n      deprecationByDataPath,\n    };\n  };\n}\n\n/**\n * Given a list of configuration schemas from packages, merge them\n * into a single json schema.\n *\n * @public\n */\nexport function mergeConfigSchemas(schemas: JSONSchema[]): JSONSchema {\n  const merged = mergeAllOf(\n    { allOf: schemas },\n    {\n      // JSONSchema is typically subtractive, as in it always reduces the set of allowed\n      // inputs through constraints. This changes the object property merging to be additive\n      // rather than subtractive.\n      ignoreAdditionalProperties: true,\n      resolvers: {\n        // This ensures that the visibilities across different schemas are sound, and\n        // selects the most specific visibility for each path.\n        visibility(values: string[], path: string[]) {\n          const hasFrontend = values.some(_ => _ === 'frontend');\n          const hasSecret = values.some(_ => _ === 'secret');\n          if (hasFrontend && hasSecret) {\n            throw new Error(\n              `Config schema visibility is both 'frontend' and 'secret' for ${path.join(\n                '/',\n              )}`,\n            );\n          } else if (hasFrontend) {\n            return 'frontend';\n          } else if (hasSecret) {\n            return 'secret';\n          }\n\n          return 'backend';\n        },\n      } as Partial<Resolvers<JSONSchema>>,\n    },\n  );\n  return merged;\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs-extra';\nimport {\n  resolve as resolvePath,\n  relative as relativePath,\n  dirname,\n  sep,\n} from 'path';\nimport { ConfigSchemaPackageEntry } from './types';\nimport { getProgramFromFiles, generateSchema } from 'typescript-json-schema';\nimport { JsonObject } from '@backstage/types';\nimport { assertError } from '@backstage/errors';\n\ntype Item = {\n  name?: string;\n  parentPath?: string;\n  packagePath?: string;\n};\n\nconst req =\n  typeof __non_webpack_require__ === 'undefined'\n    ? require\n    : __non_webpack_require__;\n\n/**\n * This collects all known config schemas across all dependencies of the app.\n */\nexport async function collectConfigSchemas(\n  packageNames: string[],\n  packagePaths: string[],\n): Promise<ConfigSchemaPackageEntry[]> {\n  const schemas = new Array<ConfigSchemaPackageEntry>();\n  const tsSchemaPaths = new Array<string>();\n  const visitedPackageVersions = new Map<string, Set<string>>(); // pkgName: [versions...]\n\n  const currentDir = await fs.realpath(process.cwd());\n\n  async function processItem(item: Item) {\n    let pkgPath = item.packagePath;\n\n    if (pkgPath) {\n      const pkgExists = await fs.pathExists(pkgPath);\n      if (!pkgExists) {\n        return;\n      }\n    } else if (item.name) {\n      const { name, parentPath } = item;\n\n      try {\n        pkgPath = req.resolve(\n          `${name}/package.json`,\n          parentPath && {\n            paths: [parentPath],\n          },\n        );\n      } catch {\n        // We can somewhat safely ignore packages that don't export package.json,\n        // as they are likely not part of the Backstage ecosystem anyway.\n      }\n    }\n    if (!pkgPath) {\n      return;\n    }\n\n    const pkg = await fs.readJson(pkgPath);\n\n    // Ensures that we only process the same version of each package once.\n    let versions = visitedPackageVersions.get(pkg.name);\n    if (versions?.has(pkg.version)) {\n      return;\n    }\n    if (!versions) {\n      versions = new Set();\n      visitedPackageVersions.set(pkg.name, versions);\n    }\n    versions.add(pkg.version);\n\n    const depNames = [\n      ...Object.keys(pkg.dependencies ?? {}),\n      ...Object.keys(pkg.devDependencies ?? {}),\n      ...Object.keys(pkg.optionalDependencies ?? {}),\n      ...Object.keys(pkg.peerDependencies ?? {}),\n    ];\n\n    // TODO(Rugvip): Trying this out to avoid having to traverse the full dependency graph,\n    //               since that's pretty slow. We probably need a better way to determine when\n    //               we've left the Backstage ecosystem, but this will do for now.\n    const hasSchema = 'configSchema' in pkg;\n    const hasBackstageDep = depNames.some(_ => _.startsWith('@backstage/'));\n    if (!hasSchema && !hasBackstageDep) {\n      return;\n    }\n    if (hasSchema) {\n      if (typeof pkg.configSchema === 'string') {\n        const isJson = pkg.configSchema.endsWith('.json');\n        const isDts = pkg.configSchema.endsWith('.d.ts');\n        if (!isJson && !isDts) {\n          throw new Error(\n            `Config schema files must be .json or .d.ts, got ${pkg.configSchema}`,\n          );\n        }\n        if (isDts) {\n          tsSchemaPaths.push(\n            relativePath(\n              currentDir,\n              resolvePath(dirname(pkgPath), pkg.configSchema),\n            ),\n          );\n        } else {\n          const path = resolvePath(dirname(pkgPath), pkg.configSchema);\n          const value = await fs.readJson(path);\n          schemas.push({\n            value,\n            path: relativePath(currentDir, path),\n          });\n        }\n      } else {\n        schemas.push({\n          value: pkg.configSchema,\n          path: relativePath(currentDir, pkgPath),\n        });\n      }\n    }\n\n    await Promise.all(\n      depNames.map(depName =>\n        processItem({ name: depName, parentPath: pkgPath }),\n      ),\n    );\n  }\n\n  await Promise.all([\n    ...packageNames.map(name => processItem({ name, parentPath: currentDir })),\n    ...packagePaths.map(path => processItem({ name: path, packagePath: path })),\n  ]);\n\n  const tsSchemas = compileTsSchemas(tsSchemaPaths);\n\n  return schemas.concat(tsSchemas);\n}\n\n// This handles the support of TypeScript .d.ts config schema declarations.\n// We collect all typescript schema definition and compile them all in one go.\n// This is much faster than compiling them separately.\nfunction compileTsSchemas(paths: string[]) {\n  if (paths.length === 0) {\n    return [];\n  }\n\n  const program = getProgramFromFiles(paths, {\n    incremental: false,\n    isolatedModules: true,\n    lib: ['ES5'], // Skipping most libs speeds processing up a lot, we just need the primitive types anyway\n    noEmit: true,\n    noResolve: true,\n    skipLibCheck: true, // Skipping lib checks speeds things up\n    skipDefaultLibCheck: true,\n    strict: true,\n    typeRoots: [], // Do not include any additional types\n    types: [],\n  });\n\n  const tsSchemas = paths.map(path => {\n    let value;\n    try {\n      value = generateSchema(\n        program,\n        // All schemas should export a `Config` symbol\n        'Config',\n        // This enables usage of @visibility and @deprecated in doc comments\n        {\n          required: true,\n          validationKeywords: ['visibility', 'deprecated'],\n        },\n        [path.split(sep).join('/')], // Unix paths are expected for all OSes here\n      ) as JsonObject | null;\n    } catch (error) {\n      assertError(error);\n      if (error.message !== 'type Config not found') {\n        throw error;\n      }\n    }\n\n    if (!value) {\n      throw new Error(`Invalid schema in ${path}, missing Config export`);\n    }\n    return { path, value };\n  });\n\n  return tsSchemas;\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { JsonObject, JsonValue } from '@backstage/types';\nimport {\n  ConfigVisibility,\n  DEFAULT_CONFIG_VISIBILITY,\n  TransformFunc,\n  ValidationError,\n} from './types';\n\n/**\n * This filters data by visibility by discovering the visibility of each\n * value, and then only keeping the ones that are specified in `includeVisibilities`.\n */\nexport function filterByVisibility(\n  data: JsonObject,\n  includeVisibilities: ConfigVisibility[],\n  visibilityByDataPath: Map<string, ConfigVisibility>,\n  deprecationByDataPath: Map<string, string>,\n  transformFunc?: TransformFunc<number | string | boolean>,\n  withFilteredKeys?: boolean,\n  withDeprecatedKeys?: boolean,\n): {\n  data: JsonObject;\n  filteredKeys?: string[];\n  deprecatedKeys?: { key: string; description: string }[];\n} {\n  const filteredKeys = new Array<string>();\n  const deprecatedKeys = new Array<{ key: string; description: string }>();\n\n  function transform(\n    jsonVal: JsonValue,\n    visibilityPath: string, // Matches the format we get from ajv\n    filterPath: string, // Matches the format of the ConfigReader\n  ): JsonValue | undefined {\n    const visibility =\n      visibilityByDataPath.get(visibilityPath) ?? DEFAULT_CONFIG_VISIBILITY;\n    const isVisible = includeVisibilities.includes(visibility);\n\n    // deprecated keys are added regardless of visibility indicator\n    const deprecation = deprecationByDataPath.get(visibilityPath);\n    if (deprecation) {\n      deprecatedKeys.push({ key: filterPath, description: deprecation });\n    }\n\n    if (typeof jsonVal !== 'object') {\n      if (isVisible) {\n        if (transformFunc) {\n          return transformFunc(jsonVal, { visibility });\n        }\n        return jsonVal;\n      }\n      if (withFilteredKeys) {\n        filteredKeys.push(filterPath);\n      }\n      return undefined;\n    } else if (jsonVal === null) {\n      return undefined;\n    } else if (Array.isArray(jsonVal)) {\n      const arr = new Array<JsonValue>();\n\n      for (const [index, value] of jsonVal.entries()) {\n        let path = visibilityPath;\n        const hasVisibilityInIndex = visibilityByDataPath.get(\n          `${visibilityPath}/${index}`,\n        );\n\n        if (hasVisibilityInIndex || typeof value === 'object') {\n          path = `${visibilityPath}/${index}`;\n        }\n\n        const out = transform(value, path, `${filterPath}[${index}]`);\n\n        if (out !== undefined) {\n          arr.push(out);\n        }\n      }\n\n      if (arr.length > 0 || isVisible) {\n        return arr;\n      }\n      return undefined;\n    }\n\n    const outObj: JsonObject = {};\n    let hasOutput = false;\n\n    for (const [key, value] of Object.entries(jsonVal)) {\n      if (value === undefined) {\n        continue;\n      }\n      const out = transform(\n        value,\n        `${visibilityPath}/${key}`,\n        filterPath ? `${filterPath}.${key}` : key,\n      );\n      if (out !== undefined) {\n        outObj[key] = out;\n        hasOutput = true;\n      }\n    }\n\n    if (hasOutput || isVisible) {\n      return outObj;\n    }\n    return undefined;\n  }\n\n  return {\n    filteredKeys: withFilteredKeys ? filteredKeys : undefined,\n    deprecatedKeys: withDeprecatedKeys ? deprecatedKeys : undefined,\n    data: (transform(data, '', '') as JsonObject) ?? {},\n  };\n}\n\nexport function filterErrorsByVisibility(\n  errors: ValidationError[] | undefined,\n  includeVisibilities: ConfigVisibility[] | undefined,\n  visibilityByDataPath: Map<string, ConfigVisibility>,\n  visibilityBySchemaPath: Map<string, ConfigVisibility>,\n): ValidationError[] {\n  if (!errors) {\n    return [];\n  }\n  if (!includeVisibilities) {\n    return errors;\n  }\n\n  const visibleSchemaPaths = Array.from(visibilityBySchemaPath)\n    .filter(([, v]) => includeVisibilities.includes(v))\n    .map(([k]) => k);\n\n  // If we're filtering by visibility we only care about the errors that happened\n  // in a visible path.\n  return errors.filter(error => {\n    // We always include structural errors as we don't know whether there are\n    // any visible paths within the structures.\n    if (\n      error.keyword === 'type' &&\n      ['object', 'array'].includes(error.params.type)\n    ) {\n      return true;\n    }\n\n    // For fields that were required we use the schema path to determine whether\n    // it was visible in addition to the data path. This is because the data path\n    // visibilities are only populated for values that we reached, which we won't\n    // if the value is missing.\n    // We don't use this method for all the errors as the data path is more robust\n    // and doesn't require us to properly trim the schema path.\n    if (error.keyword === 'required') {\n      const trimmedPath = error.schemaPath.slice(1, -'/required'.length);\n      const fullPath = `${trimmedPath}/properties/${error.params.missingProperty}`;\n      if (\n        visibleSchemaPaths.some(visiblePath => visiblePath.startsWith(fullPath))\n      ) {\n        return true;\n      }\n    }\n\n    const vis =\n      visibilityByDataPath.get(error.dataPath) ?? DEFAULT_CONFIG_VISIBILITY;\n    return vis && includeVisibilities.includes(vis);\n  });\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { AppConfig } from '@backstage/config';\nimport { JsonObject } from '@backstage/types';\nimport { compileConfigSchemas } from './compile';\nimport { collectConfigSchemas } from './collect';\nimport { filterByVisibility, filterErrorsByVisibility } from './filtering';\nimport {\n  ValidationError,\n  ConfigSchema,\n  ConfigSchemaPackageEntry,\n  CONFIG_VISIBILITIES,\n} from './types';\n\n/**\n * Options that control the loading of configuration schema files in the backend.\n *\n * @public\n */\nexport type LoadConfigSchemaOptions =\n  | {\n      dependencies: string[];\n      packagePaths?: string[];\n    }\n  | {\n      serialized: JsonObject;\n    };\n\nfunction errorsToError(errors: ValidationError[]): Error {\n  const messages = errors.map(({ dataPath, message, params }) => {\n    const paramStr = Object.entries(params)\n      .map(([name, value]) => `${name}=${value}`)\n      .join(' ');\n    return `Config ${message || ''} { ${paramStr} } at ${dataPath}`;\n  });\n  const error = new Error(`Config validation failed, ${messages.join('; ')}`);\n  (error as any).messages = messages;\n  return error;\n}\n\n/**\n * Loads config schema for a Backstage instance.\n *\n * @public\n */\nexport async function loadConfigSchema(\n  options: LoadConfigSchemaOptions,\n): Promise<ConfigSchema> {\n  let schemas: ConfigSchemaPackageEntry[];\n\n  if ('dependencies' in options) {\n    schemas = await collectConfigSchemas(\n      options.dependencies,\n      options.packagePaths ?? [],\n    );\n  } else {\n    const { serialized } = options;\n    if (serialized?.backstageConfigSchemaVersion !== 1) {\n      throw new Error(\n        'Serialized configuration schema is invalid or has an invalid version number',\n      );\n    }\n    schemas = serialized.schemas as ConfigSchemaPackageEntry[];\n  }\n\n  const validate = compileConfigSchemas(schemas);\n\n  return {\n    process(\n      configs: AppConfig[],\n      { visibility, valueTransform, withFilteredKeys, withDeprecatedKeys } = {},\n    ): AppConfig[] {\n      const result = validate(configs);\n\n      const visibleErrors = filterErrorsByVisibility(\n        result.errors,\n        visibility,\n        result.visibilityByDataPath,\n        result.visibilityBySchemaPath,\n      );\n      if (visibleErrors.length > 0) {\n        throw errorsToError(visibleErrors);\n      }\n\n      let processedConfigs = configs;\n\n      if (visibility) {\n        processedConfigs = processedConfigs.map(({ data, context }) => ({\n          context,\n          ...filterByVisibility(\n            data,\n            visibility,\n            result.visibilityByDataPath,\n            result.deprecationByDataPath,\n            valueTransform,\n            withFilteredKeys,\n            withDeprecatedKeys,\n          ),\n        }));\n      } else if (valueTransform) {\n        processedConfigs = processedConfigs.map(({ data, context }) => ({\n          context,\n          ...filterByVisibility(\n            data,\n            Array.from(CONFIG_VISIBILITIES),\n            result.visibilityByDataPath,\n            result.deprecationByDataPath,\n            valueTransform,\n            withFilteredKeys,\n            withDeprecatedKeys,\n          ),\n        }));\n      }\n\n      return processedConfigs;\n    },\n    serialize(): JsonObject {\n      return {\n        schemas,\n        backstageConfigSchemaVersion: 1,\n      };\n    },\n  };\n}\n","/*\n * Copyright 2021 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function isValidUrl(url: string): boolean {\n  try {\n    // eslint-disable-next-line no-new\n    new URL(url);\n    return true;\n  } catch {\n    return false;\n  }\n}\n","/*\n * Copyright 2020 The Backstage Authors\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport fs from 'fs-extra';\nimport yaml from 'yaml';\nimport chokidar from 'chokidar';\nimport { basename, dirname, isAbsolute, resolve as resolvePath } from 'path';\nimport { AppConfig } from '@backstage/config';\nimport { ForwardedError } from '@backstage/errors';\nimport {\n  applyConfigTransforms,\n  createIncludeTransform,\n  createSubstitutionTransform,\n  isValidUrl,\n  readEnvConfig,\n} from './lib';\nimport fetch from 'node-fetch';\n\n/** @public */\nexport type ConfigTarget = { path: string } | { url: string };\n\n/** @public */\nexport type LoadConfigOptionsWatch = {\n  /**\n   * A listener that is called when a config file is changed.\n   */\n  onChange: (configs: AppConfig[]) => void;\n\n  /**\n   * An optional signal that stops the watcher once the promise resolves.\n   */\n  stopSignal?: Promise<void>;\n};\n\n/** @public */\nexport type LoadConfigOptionsRemote = {\n  /**\n   * A remote config reloading period, in seconds\n   */\n  reloadIntervalSeconds: number;\n};\n\n/**\n * Options that control the loading of configuration files in the backend.\n *\n * @public\n */\nexport type LoadConfigOptions = {\n  // The root directory of the config loading context. Used to find default configs.\n  configRoot: string;\n\n  // Paths to load config files from. Configs from earlier paths have lower priority.\n  configTargets: ConfigTarget[];\n\n  /**\n   * Custom environment variable loading function\n   *\n   * @experimental This API is not stable and may change at any point\n   */\n  experimentalEnvFunc?: (name: string) => Promise<string | undefined>;\n\n  /**\n   * An optional remote config\n   */\n  remote?: LoadConfigOptionsRemote;\n\n  /**\n   * An optional configuration that enables watching of config files.\n   */\n  watch?: LoadConfigOptionsWatch;\n};\n\n/**\n * Results of loading configuration files.\n * @public\n */\nexport type LoadConfigResult = {\n  /**\n   * Array of all loaded configs.\n   */\n  appConfigs: AppConfig[];\n};\n\n/**\n * Load configuration data.\n *\n * @public\n */\nexport async function loadConfig(\n  options: LoadConfigOptions,\n): Promise<LoadConfigResult> {\n  const { configRoot, experimentalEnvFunc: envFunc, watch, remote } = options;\n\n  const configPaths: string[] = options.configTargets\n    .slice()\n    .filter((e): e is { path: string } => e.hasOwnProperty('path'))\n    .map(configTarget => configTarget.path);\n\n  const configUrls: string[] = options.configTargets\n    .slice()\n    .filter((e): e is { url: string } => e.hasOwnProperty('url'))\n    .map(configTarget => configTarget.url);\n\n  if (remote === undefined) {\n    if (configUrls.length > 0) {\n      throw new Error(\n        `Please make sure you are passing the remote option when loading remote configurations. See https://backstage.io/docs/conf/writing#configuration-files for detailed info.`,\n      );\n    }\n  } else if (remote.reloadIntervalSeconds <= 0) {\n    throw new Error(\n      `Remote config must be contain a non zero reloadIntervalSeconds: <seconds> value`,\n    );\n  }\n\n  // If no paths are provided, we default to reading\n  // `app-config.yaml` and, if it exists, `app-config.local.yaml`\n  if (configPaths.length === 0 && configUrls.length === 0) {\n    configPaths.push(resolvePath(configRoot, 'app-config.yaml'));\n\n    const localConfig = resolvePath(configRoot, 'app-config.local.yaml');\n    if (await fs.pathExists(localConfig)) {\n      configPaths.push(localConfig);\n    }\n  }\n\n  const env = envFunc ?? (async (name: string) => process.env[name]);\n\n  const loadConfigFiles = async () => {\n    const configs = [];\n\n    for (const configPath of configPaths) {\n      if (!isAbsolute(configPath)) {\n        throw new Error(`Config load path is not absolute: '${configPath}'`);\n      }\n\n      const dir = dirname(configPath);\n      const readFile = (path: string) =>\n        fs.readFile(resolvePath(dir, path), 'utf8');\n\n      const input = yaml.parse(await readFile(configPath));\n      const substitutionTransform = createSubstitutionTransform(env);\n      const data = await applyConfigTransforms(dir, input, [\n        createIncludeTransform(env, readFile, substitutionTransform),\n        substitutionTransform,\n      ]);\n\n      configs.push({ data, context: basename(configPath) });\n    }\n\n    return configs;\n  };\n\n  const loadRemoteConfigFiles = async () => {\n    const configs: AppConfig[] = [];\n\n    const readConfigFromUrl = async (url: string) => {\n      const response = await fetch(url);\n      if (!response.ok) {\n        throw new Error(`Could not read config file at ${url}`);\n      }\n\n      return await response.text();\n    };\n\n    for (let i = 0; i < configUrls.length; i++) {\n      const configUrl = configUrls[i];\n      if (!isValidUrl(configUrl)) {\n        throw new Error(`Config load path is not valid: '${configUrl}'`);\n      }\n\n      const remoteConfigContent = await readConfigFromUrl(configUrl);\n      if (!remoteConfigContent) {\n        throw new Error(`Config is not valid`);\n      }\n      const configYaml = yaml.parse(remoteConfigContent);\n      const substitutionTransform = createSubstitutionTransform(env);\n      const data = await applyConfigTransforms(configRoot, configYaml, [\n        substitutionTransform,\n      ]);\n\n      configs.push({ data, context: configUrl });\n    }\n\n    return configs;\n  };\n\n  let fileConfigs: AppConfig[];\n  try {\n    fileConfigs = await loadConfigFiles();\n  } catch (error) {\n    throw new ForwardedError('Failed to read static configuration file', error);\n  }\n\n  let remoteConfigs: AppConfig[] = [];\n  if (remote) {\n    try {\n      remoteConfigs = await loadRemoteConfigFiles();\n    } catch (error) {\n      throw new ForwardedError(\n        `Failed to read remote configuration file`,\n        error,\n      );\n    }\n  }\n\n  const envConfigs = await readEnvConfig(process.env);\n\n  const watchConfigFile = (watchProp: LoadConfigOptionsWatch) => {\n    const watcher = chokidar.watch(configPaths, {\n      usePolling: process.env.NODE_ENV === 'test',\n    });\n\n    let currentSerializedConfig = JSON.stringify(fileConfigs);\n    watcher.on('change', async () => {\n      try {\n        const newConfigs = await loadConfigFiles();\n        const newSerializedConfig = JSON.stringify(newConfigs);\n\n        if (currentSerializedConfig === newSerializedConfig) {\n          return;\n        }\n        currentSerializedConfig = newSerializedConfig;\n\n        watchProp.onChange([...remoteConfigs, ...newConfigs, ...envConfigs]);\n      } catch (error) {\n        console.error(`Failed to reload configuration files, ${error}`);\n      }\n    });\n\n    if (watchProp.stopSignal) {\n      watchProp.stopSignal.then(() => {\n        watcher.close();\n      });\n    }\n  };\n\n  const watchRemoteConfig = (\n    watchProp: LoadConfigOptionsWatch,\n    remoteProp: LoadConfigOptionsRemote,\n  ) => {\n    const hasConfigChanged = async (\n      oldRemoteConfigs: AppConfig[],\n      newRemoteConfigs: AppConfig[],\n    ) => {\n      return (\n        JSON.stringify(oldRemoteConfigs) !== JSON.stringify(newRemoteConfigs)\n      );\n    };\n\n    let handle: NodeJS.Timeout | undefined;\n    try {\n      handle = setInterval(async () => {\n        console.info(`Checking for config update`);\n        const newRemoteConfigs = await loadRemoteConfigFiles();\n        if (await hasConfigChanged(remoteConfigs, newRemoteConfigs)) {\n          remoteConfigs = newRemoteConfigs;\n          console.info(`Remote config change, reloading config ...`);\n          watchProp.onChange([...remoteConfigs, ...fileConfigs, ...envConfigs]);\n          console.info(`Remote config reloaded`);\n        }\n      }, remoteProp.reloadIntervalSeconds * 1000);\n    } catch (error) {\n      console.error(`Failed to reload configuration files, ${error}`);\n    }\n\n    if (watchProp.stopSignal) {\n      watchProp.stopSignal.then(() => {\n        if (handle !== undefined) {\n          console.info(`Stopping remote config watch`);\n          clearInterval(handle);\n          handle = undefined;\n        }\n      });\n    }\n  };\n\n  // Set up config file watching if requested by the caller\n  if (watch) {\n    watchConfigFile(watch);\n  }\n\n  if (watch && remote) {\n    watchRemoteConfig(watch, remote);\n  }\n\n  return {\n    appConfigs: remote\n      ? [...remoteConfigs, ...fileConfigs, ...envConfigs]\n      : [...fileConfigs, ...envConfigs],\n  };\n}\n"],"names":["resolvePath","relativePath"],"mappings":"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"}