fix: add deprecation warnings for pact cli tools in pact-js-core

All CLI/API functionality provided by the Pact CLI tools (ruby based) will be moved in pact-js-core 15.x to pact-js-cli.

* Repo

    * https://github.com/pact-foundation/pact-js-cli/

* NPM Package

    * https://www.npmjs.com/package/@pact-foundation/pact-cli

* imports

    * `@pact-foundation/pact-core` imports will now become `@pact-foundation/pact-cli` for programatic usage of the CLI tools

* npx usage

    * `npx --package=@pact-foundation/pact-cli@15.0.1 -c pact-broker`

Author: YOU54F

bin/pact-broker.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 const { error, status } = childProcess.spawnSync(

bin/pact-message.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 

bin/pact-mock-service.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 

bin/pact-provider-verifier.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 

bin/pact-stub-service.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 

bin/pact.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 

bin/pactflow.ts

@@ -5,8 +5,10 @@ import {
   standalone,
   standaloneUseShell,
   setStandaloneArgs,
+  showStandaloneDeprecationWarning,
 } from '../src/pact-standalone';
 
+showStandaloneDeprecationWarning();
 const args = process.argv.slice(2);
 const opts = standaloneUseShell ? { shell: true } : {};
 

src/pact-standalone.ts

@@ -1,6 +1,7 @@
 import * as path from 'path';
 import { getBinaryEntry } from '../standalone/install';
 import pactEnvironment from './pact-environment';
+import logger from './logger';
 
 export interface PactStandalone {
   cwd: string;
@@ -110,6 +111,17 @@ export function setStandaloneArgs(
   return parsedArgs;
 }
 
+export function showStandaloneDeprecationWarning(): void {
+  const silenceDeprecationWarnings =
+    process.env['PACT_SILENCE_DEPRECATION_WARNINGS'] === 'true';
+
+  if (!silenceDeprecationWarnings) {
+    logger.warn(
+      'DEPRECATION NOTICE: \n  pact standalone tools will be removed in pact-js-core 15.x. \n  Please update imports to @pact-foundation/pact-cli \n  https://github.com/pact-foundation/pact-js-core/issues/488'
+    );
+  }
+}
+
 export const standaloneUseShell = isWindows;
 
 export default standalone();

src/service.ts

@@ -12,6 +12,7 @@ import spawn, { CliVerbOptions } from './spawn';
 import { LogLevel } from './logger/types';
 import logger, { setLogLevel } from './logger';
 import { ServiceOptions } from './types';
+import { showStandaloneDeprecationWarning } from './pact-standalone';
 
 // Get a reference to the global setTimeout object in case it is mocked by a testing library later
 const { setTimeout } = global;
@@ -93,6 +94,8 @@ export abstract class AbstractService extends events.EventEmitter {
           'Like a Boss, you used a port outside of the recommended range (1024 to 49151); I too like to live dangerously.'
         );
       }
+
+      showStandaloneDeprecationWarning();
     }
 
     // ssl check