feat: fetch latest pacts for provider by branch

lib/cli.ts

@@ -47,6 +47,7 @@ program
     .arguments('<swagger> <mock>')
     .option('-p, --provider [string]', 'The name of the provider in the pact broker')
     .option('-t, --tag [string]', 'The tag to filter pacts retrieved from the pact broker')
+    .option('-b, --branch [string]', 'The branch to filter pacts retrieved from the pact broker')
     .option('-u, --user [USERNAME:PASSWORD]', 'The basic auth username and password to access the pact broker')
     .option('-a, --analyticsUrl [string]', 'The url to send analytics events to as a http post')
     .option('-o, --outputDepth [integer]', 'Specifies the number of times to recurse ' +
@@ -84,6 +85,7 @@ If the pact broker has basic auth enabled, pass a --user option with username an
                 providerName: options.provider,
                 specPathOrUrl: swagger,
                 tag: options.tag,
+                branch: options.branch,
                 additionalPropertiesInResponse: options.additionalPropertiesInResponse,
                 requiredPropertiesInResponse: options.requiredPropertiesInResponse
             });

lib/swagger-mock-validator.ts

@@ -160,7 +160,8 @@
       ? this.pactBroker.loadPacts({
           pactBrokerUrl: options.mockPathOrUrl,
           providerName: options.providerName,
-          tag: options.tag
+          tag: options.tag,
+          branch: options.branch
         })
       : this.getPactFromFileOrUrl(options.mockPathOrUrl);
 
@@ -250,7 +251,7 @@
           specSource: options.specSource,
           validationOutcome
         });
       } catch (error) {
         // do not fail tool on analytics errors
       }
     }

lib/swagger-mock-validator/pact-broker.ts

@@ -7,6 +7,7 @@ import {
     PactBrokerRootResponse,
     PactBrokerUserOptions,
     PactBrokerUserOptionsWithTag,
+    PactBrokerUserOptionsWithBranch,
     SerializedMock
 } from './types';
 
@@ -29,12 +30,21 @@ export class PactBroker {
         const pactBrokerRootResponse =
             await this.pactBrokerClient.loadAsObject<PactBrokerRootResponse>(options.pactBrokerUrl);
 
-        return options.tag
-            ? this.getUrlForProviderPactsByTag(pactBrokerRootResponse, {
+        if (options.tag){
+            return this.getUrlForProviderPactsByTag(pactBrokerRootResponse, {
                 pactBrokerUrl: options.pactBrokerUrl,
                 providerName: options.providerName,
                 tag: options.tag
-            }) : this.getUrlForAllProviderPacts(pactBrokerRootResponse, options);
+            })
+        } else if (options.branch){
+            return this.getUrlForProviderPactsByBranch(pactBrokerRootResponse, {
+                pactBrokerUrl: options.pactBrokerUrl,
+                providerName: options.providerName,
+                branch: options.branch
+            })
+        } else {
+            return this.getUrlForAllProviderPacts(pactBrokerRootResponse, options);
+        }
     }
 
     private getUrlForProviderPactsByTag(pactBrokerRootResponse: PactBrokerRootResponse,
@@ -56,6 +66,25 @@ export class PactBroker {
         );
     }
 
+    private getUrlForProviderPactsByBranch(pactBrokerRootResponse: PactBrokerRootResponse,
+                                        options: PactBrokerUserOptionsWithBranch): string {
+        const providerTemplateUrl = PactBroker.getProviderTemplateUrl(
+            pactBrokerRootResponse,
+            '_links.pb:latest-provider-pacts-with-branch.href'
+        );
+
+        if (!providerTemplateUrl) {
+            throw new SwaggerMockValidatorErrorImpl(
+                'SWAGGER_MOCK_VALIDATOR_READ_ERROR',
+                `Unable to read "${options.pactBrokerUrl}": No latest pact file url found for tag`
+            );
+        }
+
+        return this.getSpecificUrlFromTemplate(
+            providerTemplateUrl, {provider: options.providerName, branch: options.branch}
+        );
+    }
+
     private getUrlForAllProviderPacts(
         pactBrokerRootResponse: PactBrokerRootResponse,
         options: PactBrokerUserOptions

lib/swagger-mock-validator/types.d.ts

@@ -31,6 +31,7 @@ export interface SwaggerMockValidatorUserOptions {
     providerName?: string;
     specPathOrUrl: string;
     tag?: string;
+    branch?: string;
     additionalPropertiesInResponse?: string;
     requiredPropertiesInResponse?: string;
 }
@@ -39,11 +40,15 @@ export interface PactBrokerUserOptions {
     pactBrokerUrl: string;
     providerName: string;
     tag?: string;
+    branch?: string;
 }
 
 export type PactBrokerUserOptionsWithTag = PactBrokerUserOptions & {
     tag: string;
 };
+export type PactBrokerUserOptionsWithBranch = PactBrokerUserOptions & {
+    branch: string;
+};
 
 export type AutoDetectFormat = 'auto-detect';
 
@@ -74,6 +79,7 @@ interface ParsedSwaggerMockValidatorOptions {
     specPathOrUrl: string;
     specSource: SpecSource;
     tag?: string;
+    branch?: string;
     additionalPropertiesInResponse: boolean;
     requiredPropertiesInResponse: boolean;
 }