Method loadSpec

src/openapi-loader.ts:26–46

(
    profile: Profile,
    options?: {
      refresh?: boolean;
    }
  )

  }

  async loadSpec(
    profile: Profile,
    options?: {
      refresh?: boolean;
    }
  ): Promise<unknown> {
    const cachePath = profile.openapiSpecCache;

    if (!options?.refresh && this.fs.existsSync(cachePath)) {
      const cached = this.fs.readFileSync(cachePath, "utf-8");
      return JSON.parse(cached);
    }

    const spec = await this.loadAndResolveSpec(profile.openapiSpecSource);
    this.ensureCacheDir(cachePath);

    const serialized = JSON.stringify(spec, null, 2);
    this.fs.writeFileSync(cachePath, serialized);

    return spec;
  }

  private async loadAndResolveSpec(source: string): Promise<unknown> {
    const rawDocCache = new Map<string, unknown>();