- Added query and path parameter serialization from OpenAPI / Swagger

  metadata
  - Added support for array and object-style query parameters such as
  `deepObject`, `pipeDelimited`, and Swagger 2 collection formats
  - Added automatic API base URL detection from OAS `servers`
  - Added automatic API base URL detection from Swagger 2 `host`, `basePath`,
  and `schemes`
  - Added operation-level and path-level server overrides when the spec defines
  endpoint-specific targets

Author: snow-ghost

src/cli.ts

@@ -34,7 +34,7 @@ const defaultHttpClient: HttpClient = {
 };
 
 interface AddProfileArgs {
-  "api-base-url": string;
+  "api-base-url"?: string;
   "openapi-spec": string;
   "api-basic-auth"?: string;
   "api-bearer-token"?: string;
@@ -530,7 +530,7 @@ export async function run(argv: string[], options?: RunOptions): Promise<void> {
 
     const profile: Profile = {
       name: profileName,
-      apiBaseUrl: args["api-base-url"],
+      apiBaseUrl: args["api-base-url"] ?? "",
       apiBasicAuth: args["api-basic-auth"] ?? "",
       apiBearerToken: args["api-bearer-token"] ?? "",
       openapiSpecSource: args["openapi-spec"],
@@ -541,7 +541,11 @@ export async function run(argv: string[], options?: RunOptions): Promise<void> {
       customHeaders,
     };
 
-    await openapiLoader.loadSpec(profile, { refresh: true });
+    const spec = await openapiLoader.loadSpec(profile, { refresh: true });
+    profile.apiBaseUrl = profile.apiBaseUrl || deriveApiBaseUrlFromSpec(spec);
+    if (!profile.apiBaseUrl) {
+      throw new Error("Unable to determine API base URL. Provide --api-base-url explicitly.");
+    }
     profileStore.saveProfile(cwd, profile, { makeCurrent: true });
   };