feat(command-deploy): add a --prodIfUnlocked flag (#1988)

Author: kasbah

docs/commands/deploy.md

@@ -87,6 +87,7 @@ netlify deploy
 - `dir` (*string*) - Specify a folder to deploy
 - `functions` (*string*) - Specify a functions folder to deploy
 - `prod` (*boolean*) - Deploy to production
+- `prodIfUnlocked` (*boolean*) - Deploy to production if unlocked, create a draft otherwise
 - `alias` (*string*) - Specifies the alias for deployment. Useful for creating predictable deployment URLs. Maximum 37 characters.
 - `branch` (*string*) - Serves the same functionality as --alias. Deprecated and will be removed in future versions
 - `open` (*boolean*) - Open site after deploy
@@ -107,6 +108,7 @@ netlify deploy
 netlify deploy
 netlify deploy --prod
 netlify deploy --prod --open
+netlify deploy --prodIfUnlocked
 netlify deploy --message "A message with an $ENV_VAR"
 netlify deploy --auth $NETLIFY_AUTH_TOKEN
 netlify deploy --trigger

src/commands/deploy.js

@@ -350,7 +350,6 @@ class DeployCommand extends Command {
       warn('--branch flag has been renamed to --alias and will be removed in future versions')
     }
 
-    const deployToProduction = flags.prod
     await this.authenticate(flags.auth)
 
     await this.config.runHook('analytics', {
@@ -406,6 +405,8 @@ class DeployCommand extends Command {
       }
     }
 
+    const deployToProduction = flags.prod || (flags.prodIfUnlocked && !siteData.published_deploy.locked)
+
     if (flags.trigger) {
       return triggerDeploy({ api, siteId, siteData, log, error })
     }
@@ -545,6 +546,7 @@ DeployCommand.examples = [
   'netlify deploy',
   'netlify deploy --prod',
   'netlify deploy --prod --open',
+  'netlify deploy --prodIfUnlocked',
   'netlify deploy --message "A message with an $ENV_VAR"',
   'netlify deploy --auth $NETLIFY_AUTH_TOKEN',
   'netlify deploy --trigger',
@@ -563,7 +565,12 @@ DeployCommand.flags = {
     char: 'p',
     description: 'Deploy to production',
     default: false,
-    exclusive: ['alias', 'branch'],
+    exclusive: ['alias', 'branch', 'prodIfUnlocked'],
+  }),
+  prodIfUnlocked: flagsLib.boolean({
+    description: 'Deploy to production if unlocked, create a draft otherwise',
+    default: false,
+    exclusive: ['alias', 'branch', 'prod'],
   }),
   alias: flagsLib.string({
     description: