feat: add creditCardIssuer

[beninsydney]

Adds method for randomly selecting a credit card provider from the keys of faker.definitions.finance.credit_card

> faker.finance.creditCardProvider()
'visa'
> faker.finance.creditCardProvider()
'diners_club'

For pull request #882

[ST-DDT]

Please add a test for this.

expect(Object.keys(.....credit_card)).toContain(actual)

[codecov]

Codecov Report

Merging #888 (6306222) into main (36cd461) will increase coverage by 0.00%.
The diff coverage is 100.00%.

@@           Coverage Diff           @@
##             main     #888   +/-   ##
=======================================
  Coverage   99.41%   99.41%           
=======================================
  Files        1959     1959           
  Lines      210905   210917   +12     
  Branches      906      907    +1     
=======================================
+ Hits       209675   209687   +12     
  Misses       1172     1172           
  Partials       58       58           

Impacted Files	Coverage Δ
src/definitions/finance.ts	100.00% <100.00%> (ø)
src/finance.ts	99.31% <100.00%> (+0.01%)	⬆️

[ST-DDT]

Docs Preview (Click to expand)

[Shinigami92]

Should we focus and merge #503 first?

[beninsydney]

I've got this ready locally but I've noticed 'provider' is also used in src/finance.ts in creditCardNumber() and in src/definitions/finance.ts in a description block, do you want me to go ahead and update the nomenclature in those files too for consistency?

  /**
   * Generates a random credit card number.
   *
   * @param provider The name of the provider (case insensitive) or the format used to generate one.
   *
   * @example
   * faker.finance.creditCardNumber() // '4427163488668'
   * faker.finance.creditCardNumber('visa') // '4882664999003'
   * faker.finance.creditCardNumber('63[7-9]#-####-####-###L') // '6375-3265-4676-6644'
   */
  creditCardNumber(provider = ''): string {
    let format: string;
    const localeFormat = this.faker.definitions.finance.credit_card;
    const normalizedProvider = provider.toLowerCase();
    if (normalizedProvider in localeFormat) {
      format = this.faker.random.arrayElement(localeFormat[normalizedProvider]);
    } else if (provider.match(/#/)) {
      // The user chose an optional scheme
      format = provider;
    } else {
      // Choose a random provider
      // Credit cards are in an object structure
      const formats = this.faker.random.objectElement(localeFormat, 'value'); // There could be multiple formats
      format = this.faker.random.arrayElement(formats);
    }
    format = format.replace(/\//g, '');
    return this.faker.helpers.replaceCreditCardSymbols(format);
  }

[Shinigami92]

test/finance.spec.ts line 397