@redocly/openapi-core 1.34.3 → 2.0.0-next.0

package/src/config/config.ts

@@ -1,423 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { parseYaml, stringifyYaml } from '../js-yaml';
-import { slash, doesYamlFileExist, isPlainObject, showWarningForDeprecatedField } from '../utils';
-import { SpecVersion, SpecMajorVersion } from '../oas-types';
-import { isBrowser } from '../env';
-import { getResolveConfig } from './utils';
-import { isAbsoluteUrl } from '../ref-utils';
-
-import type { NormalizedProblem } from '../walk';
-import type {
-  Oas2RuleSet,
-  Oas3RuleSet,
-  Async2RuleSet,
-  Async3RuleSet,
-  Arazzo1RuleSet,
-  Overlay1RuleSet,
-} from '../oas-types';
-import type { NodeType } from '../types';
-import type {
-  DecoratorConfig,
-  Plugin,
-  PreprocessorConfig,
-  Region,
-  ResolveConfig,
-  ResolvedApi,
-  ResolvedConfig,
-  ResolvedStyleguideConfig,
-  RuleConfig,
-  RuleSettings,
-  Telemetry,
-  ThemeRawConfig,
-} from './types';
-
-export const IGNORE_FILE = '.redocly.lint-ignore.yaml';
-const IGNORE_BANNER =
-  `# This file instructs Redocly's linter to ignore the rules contained for specific parts of your API.\n` +
-  `# See https://redocly.com/docs/cli/ for more information.\n`;
-
-function getIgnoreFilePath(configFile?: string): string | undefined {
-  if (configFile) {
-    return doesYamlFileExist(configFile)
-      ? path.join(path.dirname(configFile), IGNORE_FILE)
-      : path.join(configFile, IGNORE_FILE);
-  } else {
-    return isBrowser ? undefined : path.join(process.cwd(), IGNORE_FILE);
-  }
-}
-
-export class StyleguideConfig {
-  plugins: Plugin[];
-  ignore: Record<string, Record<string, Set<string>>> = {};
-  doNotResolveExamples: boolean;
-  rules: Record<SpecVersion, Record<string, RuleConfig>>;
-  preprocessors: Record<SpecVersion, Record<string, PreprocessorConfig>>;
-  decorators: Record<SpecVersion, Record<string, DecoratorConfig>>;
-
-  private _usedRules: Set<string> = new Set();
-  private _usedVersions: Set<SpecVersion> = new Set();
-
-  recommendedFallback: boolean;
-
-  extendPaths: string[];
-  pluginPaths: string[];
-
-  constructor(public rawConfig: ResolvedStyleguideConfig, public configFile?: string) {
-    this.plugins = rawConfig.plugins || [];
-    this.doNotResolveExamples = !!rawConfig.doNotResolveExamples;
-    this.recommendedFallback = rawConfig.recommendedFallback || false;
-
-    const ruleGroups: (keyof ResolvedStyleguideConfig)[] = [
-      'rules',
-      'oas2Rules',
-      'oas3_0Rules',
-      'oas3_1Rules',
-      'async2Rules',
-      'async3Rules',
-      'arazzo1Rules',
-      'overlay1Rules',
-    ];
-
-    replaceSpecWithStruct(ruleGroups, rawConfig);
-
-    this.rules = {
-      [SpecVersion.OAS2]: { ...rawConfig.rules, ...rawConfig.oas2Rules },
-      [SpecVersion.OAS3_0]: { ...rawConfig.rules, ...rawConfig.oas3_0Rules },
-      [SpecVersion.OAS3_1]: { ...rawConfig.rules, ...rawConfig.oas3_1Rules },
-      [SpecVersion.Async2]: { ...rawConfig.rules, ...rawConfig.async2Rules },
-      [SpecVersion.Async3]: { ...rawConfig.rules, ...rawConfig.async3Rules },
-      [SpecVersion.Arazzo1]: { ...rawConfig.rules, ...rawConfig.arazzo1Rules },
-      [SpecVersion.Overlay1]: { ...rawConfig.rules, ...rawConfig.overlay1Rules },
-    };
-
-    this.preprocessors = {
-      [SpecVersion.OAS2]: { ...rawConfig.preprocessors, ...rawConfig.oas2Preprocessors },
-      [SpecVersion.OAS3_0]: { ...rawConfig.preprocessors, ...rawConfig.oas3_0Preprocessors },
-      [SpecVersion.OAS3_1]: { ...rawConfig.preprocessors, ...rawConfig.oas3_1Preprocessors },
-      [SpecVersion.Async2]: { ...rawConfig.preprocessors, ...rawConfig.async2Preprocessors },
-      [SpecVersion.Async3]: { ...rawConfig.preprocessors, ...rawConfig.async3Preprocessors },
-      [SpecVersion.Arazzo1]: { ...rawConfig.arazzo1Preprocessors },
-      [SpecVersion.Overlay1]: { ...rawConfig.preprocessors, ...rawConfig.overlay1Preprocessors },
-    };
-
-    this.decorators = {
-      [SpecVersion.OAS2]: { ...rawConfig.decorators, ...rawConfig.oas2Decorators },
-      [SpecVersion.OAS3_0]: { ...rawConfig.decorators, ...rawConfig.oas3_0Decorators },
-      [SpecVersion.OAS3_1]: { ...rawConfig.decorators, ...rawConfig.oas3_1Decorators },
-      [SpecVersion.Async2]: { ...rawConfig.decorators, ...rawConfig.async2Decorators },
-      [SpecVersion.Async3]: { ...rawConfig.decorators, ...rawConfig.async3Decorators },
-      [SpecVersion.Arazzo1]: { ...rawConfig.arazzo1Decorators },
-      [SpecVersion.Overlay1]: { ...rawConfig.decorators, ...rawConfig.overlay1Decorators },
-    };
-
-    this.extendPaths = rawConfig.extendPaths || [];
-    this.pluginPaths = rawConfig.pluginPaths || [];
-    this.resolveIgnore(getIgnoreFilePath(configFile));
-  }
-
-  resolveIgnore(ignoreFile?: string) {
-    if (!ignoreFile || !doesYamlFileExist(ignoreFile)) return;
-
-    this.ignore =
-      (parseYaml(fs.readFileSync(ignoreFile, 'utf-8')) as Record<
-        string,
-        Record<string, Set<string>>
-      >) || {};
-
-    replaceSpecWithStruct(Object.keys(this.ignore), this.ignore);
-
-    // resolve ignore paths
-    for (const fileName of Object.keys(this.ignore)) {
-      this.ignore[
-        isAbsoluteUrl(fileName) ? fileName : path.resolve(path.dirname(ignoreFile), fileName)
-      ] = this.ignore[fileName];
-
-      for (const ruleId of Object.keys(this.ignore[fileName])) {
-        this.ignore[fileName][ruleId] = new Set(this.ignore[fileName][ruleId]);
-      }
-
-      if (!isAbsoluteUrl(fileName)) {
-        delete this.ignore[fileName];
-      }
-    }
-  }
-
-  saveIgnore() {
-    const dir = this.configFile ? path.dirname(this.configFile) : process.cwd();
-    const ignoreFile = path.join(dir, IGNORE_FILE);
-    const mapped: Record<string, any> = {};
-    for (const absFileName of Object.keys(this.ignore)) {
-      const mappedDefinitionName = isAbsoluteUrl(absFileName)
-        ? absFileName
-        : slash(path.relative(dir, absFileName));
-      const ignoredRules = (mapped[mappedDefinitionName] = this.ignore[absFileName]);
-
-      for (const ruleId of Object.keys(ignoredRules)) {
-        ignoredRules[ruleId] = Array.from(ignoredRules[ruleId]) as any;
-      }
-    }
-    fs.writeFileSync(ignoreFile, IGNORE_BANNER + stringifyYaml(mapped));
-  }
-
-  addIgnore(problem: NormalizedProblem) {
-    const ignore = this.ignore;
-    const loc = problem.location[0];
-    if (loc.pointer === undefined) return;
-
-    const fileIgnore = (ignore[loc.source.absoluteRef] = ignore[loc.source.absoluteRef] || {});
-    const ruleIgnore = (fileIgnore[problem.ruleId] = fileIgnore[problem.ruleId] || new Set());
-
-    ruleIgnore.add(loc.pointer);
-  }
-
-  addProblemToIgnore(problem: NormalizedProblem) {
-    const loc = problem.location[0];
-    if (loc.pointer === undefined) return problem;
-
-    const fileIgnore = this.ignore[loc.source.absoluteRef] || {};
-    const ruleIgnore = fileIgnore[problem.ruleId];
-    const ignored = ruleIgnore && ruleIgnore.has(loc.pointer);
-    return ignored
-      ? {
-          ...problem,
-          ignored,
-        }
-      : problem;
-  }
-
-  extendTypes(types: Record<string, NodeType>, version: SpecVersion) {
-    let extendedTypes = types;
-    for (const plugin of this.plugins) {
-      if (plugin.typeExtension !== undefined) {
-        switch (version) {
-          case SpecVersion.OAS3_0:
-          case SpecVersion.OAS3_1:
-            if (!plugin.typeExtension.oas3) continue;
-            extendedTypes = plugin.typeExtension.oas3(extendedTypes, version);
-            break;
-          case SpecVersion.OAS2:
-            if (!plugin.typeExtension.oas2) continue;
-            extendedTypes = plugin.typeExtension.oas2(extendedTypes, version);
-            break;
-          case SpecVersion.Async2:
-            if (!plugin.typeExtension.async2) continue;
-            extendedTypes = plugin.typeExtension.async2(extendedTypes, version);
-            break;
-          case SpecVersion.Async3:
-            if (!plugin.typeExtension.async3) continue;
-            extendedTypes = plugin.typeExtension.async3(extendedTypes, version);
-            break;
-          case SpecVersion.Arazzo1:
-            if (!plugin.typeExtension.arazzo1) continue;
-            extendedTypes = plugin.typeExtension.arazzo1(extendedTypes, version);
-            break;
-          case SpecVersion.Overlay1:
-            if (!plugin.typeExtension.overlay1) continue;
-            extendedTypes = plugin.typeExtension.overlay1(extendedTypes, version);
-            break;
-          default:
-            throw new Error('Not implemented');
-        }
-      }
-    }
-    return extendedTypes;
-  }
-
-  getRuleSettings(ruleId: string, oasVersion: SpecVersion): RuleSettings {
-    this._usedRules.add(ruleId);
-    this._usedVersions.add(oasVersion);
-    const settings = this.rules[oasVersion][ruleId] || 'off';
-    if (typeof settings === 'string') {
-      return {
-        severity: settings,
-      };
-    } else {
-      return { severity: 'error', ...settings };
-    }
-  }
-
-  getPreprocessorSettings(ruleId: string, oasVersion: SpecVersion): RuleSettings {
-    this._usedRules.add(ruleId);
-    this._usedVersions.add(oasVersion);
-
-    const settings = this.preprocessors[oasVersion][ruleId] || 'off';
-    if (typeof settings === 'string') {
-      return {
-        severity: settings === 'on' ? 'error' : settings,
-      };
-    } else {
-      return { severity: 'error', ...settings };
-    }
-  }
-
-  getDecoratorSettings(ruleId: string, oasVersion: SpecVersion): RuleSettings {
-    this._usedRules.add(ruleId);
-    this._usedVersions.add(oasVersion);
-    const settings = this.decorators[oasVersion][ruleId] || 'off';
-    if (typeof settings === 'string') {
-      return {
-        severity: settings === 'on' ? 'error' : settings,
-      };
-    } else {
-      return { severity: 'error', ...settings };
-    }
-  }
-
-  getUnusedRules() {
-    const rules = [];
-    const decorators = [];
-    const preprocessors = [];
-
-    for (const usedVersion of Array.from(this._usedVersions)) {
-      rules.push(
-        ...Object.keys(this.rules[usedVersion]).filter((name) => !this._usedRules.has(name))
-      );
-      decorators.push(
-        ...Object.keys(this.decorators[usedVersion]).filter((name) => !this._usedRules.has(name))
-      );
-      preprocessors.push(
-        ...Object.keys(this.preprocessors[usedVersion]).filter((name) => !this._usedRules.has(name))
-      );
-    }
-
-    return {
-      rules,
-      preprocessors,
-      decorators,
-    };
-  }
-
-  getRulesForSpecVersion(version: SpecMajorVersion) {
-    switch (version) {
-      case SpecMajorVersion.OAS3:
-        // eslint-disable-next-line no-case-declarations
-        const oas3Rules: Oas3RuleSet[] = [];
-        this.plugins.forEach((p) => p.preprocessors?.oas3 && oas3Rules.push(p.preprocessors.oas3));
-        this.plugins.forEach((p) => p.rules?.oas3 && oas3Rules.push(p.rules.oas3));
-        this.plugins.forEach((p) => p.decorators?.oas3 && oas3Rules.push(p.decorators.oas3));
-        return oas3Rules;
-      case SpecMajorVersion.OAS2:
-        // eslint-disable-next-line no-case-declarations
-        const oas2Rules: Oas2RuleSet[] = [];
-        this.plugins.forEach((p) => p.preprocessors?.oas2 && oas2Rules.push(p.preprocessors.oas2));
-        this.plugins.forEach((p) => p.rules?.oas2 && oas2Rules.push(p.rules.oas2));
-        this.plugins.forEach((p) => p.decorators?.oas2 && oas2Rules.push(p.decorators.oas2));
-        return oas2Rules;
-      case SpecMajorVersion.Async2:
-        // eslint-disable-next-line no-case-declarations
-        const asyncApi2Rules: Async2RuleSet[] = [];
-        this.plugins.forEach(
-          (p) => p.preprocessors?.async2 && asyncApi2Rules.push(p.preprocessors.async2)
-        );
-        this.plugins.forEach((p) => p.rules?.async2 && asyncApi2Rules.push(p.rules.async2));
-        this.plugins.forEach(
-          (p) => p.decorators?.async2 && asyncApi2Rules.push(p.decorators.async2)
-        );
-        return asyncApi2Rules;
-      case SpecMajorVersion.Async3:
-        // eslint-disable-next-line no-case-declarations
-        const asyncApi3Rules: Async3RuleSet[] = [];
-        this.plugins.forEach(
-          (p) => p.preprocessors?.async3 && asyncApi3Rules.push(p.preprocessors.async3)
-        );
-        this.plugins.forEach((p) => p.rules?.async3 && asyncApi3Rules.push(p.rules.async3));
-        this.plugins.forEach(
-          (p) => p.decorators?.async3 && asyncApi3Rules.push(p.decorators.async3)
-        );
-        return asyncApi3Rules;
-      case SpecMajorVersion.Arazzo1:
-        // eslint-disable-next-line no-case-declarations
-        const arazzo1Rules: Arazzo1RuleSet[] = [];
-        this.plugins.forEach(
-          (p) => p.preprocessors?.arazzo1 && arazzo1Rules.push(p.preprocessors.arazzo1)
-        );
-        this.plugins.forEach((p) => p.rules?.arazzo1 && arazzo1Rules.push(p.rules.arazzo1));
-        this.plugins.forEach(
-          (p) => p.decorators?.arazzo1 && arazzo1Rules.push(p.decorators.arazzo1)
-        );
-        return arazzo1Rules;
-      case SpecMajorVersion.Overlay1:
-        // eslint-disable-next-line no-case-declarations
-        const overlay1Rules: Overlay1RuleSet[] = [];
-        this.plugins.forEach(
-          (p) => p.preprocessors?.overlay1 && overlay1Rules.push(p.preprocessors.overlay1)
-        );
-        this.plugins.forEach((p) => p.rules?.overlay1 && overlay1Rules.push(p.rules.overlay1));
-        this.plugins.forEach(
-          (p) => p.decorators?.overlay1 && overlay1Rules.push(p.decorators.overlay1)
-        );
-        return overlay1Rules;
-    }
-  }
-
-  skipRules(rules?: string[]) {
-    for (const ruleId of rules || []) {
-      for (const version of Object.values(SpecVersion)) {
-        if (this.rules[version][ruleId]) {
-          this.rules[version][ruleId] = 'off';
-        } else if (Array.isArray(this.rules[version].assertions)) {
-          // skip assertions
-          for (const configurableRule of this.rules[version].assertions) {
-            if (configurableRule.assertionId === ruleId) {
-              configurableRule.severity = 'off';
-            }
-          }
-        }
-      }
-    }
-  }
-
-  skipPreprocessors(preprocessors?: string[]) {
-    for (const preprocessorId of preprocessors || []) {
-      for (const version of Object.values(SpecVersion)) {
-        if (this.preprocessors[version][preprocessorId]) {
-          this.preprocessors[version][preprocessorId] = 'off';
-        }
-      }
-    }
-  }
-
-  skipDecorators(decorators?: string[]) {
-    for (const decoratorId of decorators || []) {
-      for (const version of Object.values(SpecVersion)) {
-        if (this.decorators[version][decoratorId]) {
-          this.decorators[version][decoratorId] = 'off';
-        }
-      }
-    }
-  }
-}
-
-// To support backwards compatibility with the old `spec` key we rename it to `struct`.
-function replaceSpecWithStruct(ruleGroups: string[], config: Record<string, unknown>) {
-  for (const ruleGroup of ruleGroups) {
-    if (config[ruleGroup] && isPlainObject(config[ruleGroup]) && 'spec' in config[ruleGroup]) {
-      showWarningForDeprecatedField('spec', 'struct');
-      config[ruleGroup].struct = config[ruleGroup].spec;
-      delete config[ruleGroup].spec;
-    }
-  }
-}
-
-export class Config {
-  apis: Record<string, ResolvedApi>;
-  styleguide: StyleguideConfig;
-  resolve: ResolveConfig;
-  licenseKey?: string;
-  region?: Region;
-  theme: ThemeRawConfig;
-  organization?: string;
-  files: string[];
-  telemetry?: Telemetry;
-  constructor(public rawConfig: ResolvedConfig, public configFile?: string) {
-    this.apis = rawConfig.apis || {};
-    this.styleguide = new StyleguideConfig(rawConfig.styleguide || {}, configFile);
-    this.theme = rawConfig.theme || {};
-    this.resolve = getResolveConfig(rawConfig?.resolve);
-    this.region = rawConfig.region;
-    this.organization = rawConfig.organization;
-    this.files = rawConfig.files || [];
-    this.telemetry = rawConfig.telemetry;
-  }
-}

package/src/config/index.ts

@@ -1,7 +0,0 @@
-export * from './config';
-export * from './types';
-export * from './rules';
-export * from './builtIn';
-export * from './load';
-export * from './utils';
-export * from './config-resolvers';

package/src/config/load.ts

@@ -1,213 +0,0 @@
-import * as fs from 'fs';
-import * as path from 'path';
-import { RedoclyClient } from '../redocly';
-import { isEmptyObject } from '../utils';
-import { parseYaml } from '../js-yaml';
-import { ConfigValidationError, transformConfig, deepCloneMapWithJSON } from './utils';
-import { resolveConfig, resolveConfigFileAndRefs } from './config-resolvers';
-import { bundleConfig } from '../bundle';
-import { BaseResolver } from '../resolve';
-import { isBrowser } from '../env';
-import { DOMAINS } from '../redocly/domains';
-
-import type { Config } from './config';
-import type { Document, ResolvedRefMap } from '../resolve';
-import type { RegionalToken, RegionalTokenWithValidity } from '../redocly/redocly-client-types';
-import type { RawConfig, RawUniversalConfig, Region } from './types';
-
-async function addConfigMetadata({
-  rawConfig,
-  customExtends,
-  configPath,
-  tokens,
-  files,
-  region,
-  externalRefResolver,
-}: {
-  rawConfig: RawConfig;
-  customExtends?: string[];
-  configPath?: string;
-  tokens?: RegionalToken[];
-  files?: string[];
-  region?: Region;
-  externalRefResolver?: BaseResolver;
-}): Promise<Config> {
-  if (customExtends !== undefined) {
-    rawConfig.styleguide = rawConfig.styleguide || {};
-    rawConfig.styleguide.extends = customExtends;
-  } else if (isEmptyObject(rawConfig)) {
-    rawConfig.styleguide = { extends: ['recommended'], recommendedFallback: true };
-  }
-
-  if (tokens?.length) {
-    if (!rawConfig.resolve) rawConfig.resolve = {};
-    if (!rawConfig.resolve.http) rawConfig.resolve.http = {};
-    rawConfig.resolve.http.headers = [...(rawConfig.resolve.http.headers ?? [])];
-
-    for (const item of tokens) {
-      const domain = DOMAINS[item.region as Region];
-      rawConfig.resolve.http.headers.push(
-        {
-          matches: `https://api.${domain}/registry/**`,
-          name: 'Authorization',
-          envVariable: undefined,
-          value: item.token,
-        },
-        //support redocly.com domain for future compatibility
-        ...(item.region === 'us'
-          ? [
-              {
-                matches: `https://api.redoc.ly/registry/**`,
-                name: 'Authorization',
-                envVariable: undefined,
-                value: item.token,
-              },
-            ]
-          : [])
-      );
-    }
-  }
-
-  return resolveConfig({
-    rawConfig: {
-      ...rawConfig,
-      files: files ?? rawConfig.files,
-      region: region ?? rawConfig.region,
-    },
-    configPath,
-    externalRefResolver,
-  });
-}
-
-export type RawConfigProcessor = (params: {
-  document: Document;
-  resolvedRefMap: ResolvedRefMap;
-  config: Config;
-  parsed: Document['parsed'];
-}) => void | Promise<void>;
-
-export async function loadConfig(
-  options: {
-    configPath?: string;
-    customExtends?: string[];
-    processRawConfig?: RawConfigProcessor;
-    externalRefResolver?: BaseResolver;
-    files?: string[];
-    region?: Region;
-  } = {}
-): Promise<Config> {
-  const {
-    configPath = findConfig(),
-    customExtends,
-    processRawConfig,
-    files,
-    region,
-    externalRefResolver,
-  } = options;
-
-  const { rawConfig, document, parsed, resolvedRefMap } = await getConfig({
-    configPath,
-    externalRefResolver,
-  });
-
-  const redoclyClient = isBrowser ? undefined : new RedoclyClient();
-  const tokens = redoclyClient && redoclyClient.hasTokens() ? redoclyClient.getAllTokens() : [];
-
-  const config = await addConfigMetadata({
-    rawConfig,
-    customExtends,
-    configPath,
-    tokens,
-    files,
-    region,
-    externalRefResolver,
-  });
-
-  if (document && parsed && resolvedRefMap && typeof processRawConfig === 'function') {
-    try {
-      await processRawConfig({
-        document,
-        resolvedRefMap,
-        config,
-        parsed,
-      });
-    } catch (e) {
-      if (e instanceof ConfigValidationError) {
-        throw e;
-      }
-      throw new Error(`Error parsing config file at '${configPath}': ${e.message}`);
-    }
-  }
-
-  return config;
-}
-
-export const CONFIG_FILE_NAMES = ['redocly.yaml', 'redocly.yml', '.redocly.yaml', '.redocly.yml'];
-
-export function findConfig(dir?: string): string | undefined {
-  if (!fs?.hasOwnProperty?.('existsSync')) return;
-  const existingConfigFiles = CONFIG_FILE_NAMES.map((name) =>
-    dir ? path.resolve(dir, name) : name
-  ).filter(fs.existsSync);
-  if (existingConfigFiles.length > 1) {
-    throw new Error(`
-      Multiple configuration files are not allowed.
-      Found the following files: ${existingConfigFiles.join(', ')}.
-      Please use 'redocly.yaml' instead.
-    `);
-  }
-  return existingConfigFiles[0];
-}
-
-export async function getConfig(
-  options: {
-    configPath?: string;
-    externalRefResolver?: BaseResolver;
-  } = {}
-): Promise<{
-  rawConfig: RawConfig;
-  document?: Document;
-  parsed?: Document['parsed'];
-  resolvedRefMap?: ResolvedRefMap;
-}> {
-  const { configPath = findConfig(), externalRefResolver = new BaseResolver() } = options;
-  if (!configPath) return { rawConfig: {} };
-
-  try {
-    const { document, resolvedRefMap } = await resolveConfigFileAndRefs({
-      configPath,
-      externalRefResolver,
-    });
-
-    const bundledRefMap = deepCloneMapWithJSON(resolvedRefMap);
-    const parsed = await bundleConfig(JSON.parse(JSON.stringify(document)), bundledRefMap);
-
-    return {
-      rawConfig: transformConfig(parsed),
-      document,
-      parsed,
-      resolvedRefMap,
-    };
-  } catch (e) {
-    throw new Error(`Error parsing config file at '${configPath}': ${e.message}`);
-  }
-}
-
-type CreateConfigOptions = {
-  extends?: string[];
-  tokens?: RegionalTokenWithValidity[];
-  configPath?: string;
-  externalRefResolver?: BaseResolver;
-};
-
-export async function createConfig(
-  config: string | RawUniversalConfig,
-  options?: CreateConfigOptions
-): Promise<Config> {
-  return addConfigMetadata({
-    rawConfig: transformConfig(
-      typeof config === 'string' ? (parseYaml(config) as RawConfig) : config
-    ),
-    ...options,
-  });
-}