feat: 🔥 First punt at priority option

packages/falso/jest.config.ts

@@ -13,4 +13,5 @@ module.exports = {
   moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx'],
   coverageDirectory: '../../coverage/packages/falso',
   preset: '../../jest.preset.ts',
+  snapshotResolver: './snapshot-resolver.js',
 };

packages/falso/snapshot-resolver.js

@@ -0,0 +1,11 @@
+module.exports = {
+  testPathForConsistencyCheck: 'some/tests/example.spec.ts',
+  resolveSnapshotPath: (testPath, snapshotExtension) => {
+    return testPath.replace('tests/', 'tests/__snapshots__/') + snapshotExtension
+  },
+  resolveTestPath: (snapshotFilePath, snapshotExtension) => {
+    return snapshotFilePath
+      .replace('tests/__snapshots__/', 'tests/')
+      .slice(0, -snapshotExtension.length)
+  },
+}

packages/falso/src/lib/abbreviation.ts

@@ -14,6 +14,10 @@ import { data } from './abbreviation.json';
  *
  * randAbbreviation({ length: 10 })
  *
+ * @example
+ *
+ * randAbbreviation({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAbbreviation<O extends FakeOptions = never>(options?: O) {
   return fake(data, options);

packages/falso/src/lib/accessory.ts

@@ -14,6 +14,10 @@ import { data } from './accessory.json';
  *
  * randAccessory({ length: 10 })
  *
+ * @example
+ *
+ * randAccessory({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAccessory<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/account.ts

@@ -21,6 +21,10 @@ export interface AccountOptions extends FakeOptions {
  *
  * randAccount({ length: 10 })
  *
+ * @example
+ *
+ * randAccount({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAccount<Options extends AccountOptions = never>(
   options?: Options

packages/falso/src/lib/address.ts

@@ -4,6 +4,7 @@ import { randStreetAddress } from './street-address';
 import { randZipCode } from './zip-code';
 import { randCounty } from './county';
 import { randCountry } from './country';
+import { objectIsUnique } from './core/unique-validators';
 
 export interface AddressOptions extends FakeOptions {
   includeCounty?: boolean;
@@ -39,6 +40,10 @@ export interface Address {
  *
  * randAddress({ length: 10 })
  *
+ * @example
+ *
+ * randAddress({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAddress<Options extends AddressOptions = never>(
   options?: Options
@@ -64,5 +69,10 @@ export function randAddress<Options extends AddressOptions = never>(
     return address;
   };
 
-  return fake(factory, options);
+  return fake(factory, options, { uniqueComparer: checkUnique });
 }
+
+const checkUnique: (address: Address, addresses: Address[]) => boolean = (
+  address: Address,
+  addresses: Address[]
+) => objectIsUnique(address, addresses, ['street', 'zipCode']);

packages/falso/src/lib/airline.ts

@@ -14,6 +14,10 @@ import { data } from './airline.json';
  *
  * randAirline({ length: 10 })
  *
+ * @example
+ *
+ * randAirline({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAirline<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/airport-code.ts

@@ -15,6 +15,10 @@ import { rand } from './rand';
  *
  * randAirportCode({ length: 10 })
  *
+ * @example
+ *
+ * randAirportCode({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAirportCode<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/airport-name.ts

@@ -15,6 +15,10 @@ import { rand } from './rand';
  *
  * randAirportName({ length: 10 })
  *
+ * @example
+ *
+ * randAirportName({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAirportName<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/airport.ts

@@ -21,6 +21,10 @@ export interface Airport {
  *
  * randAirport({ length: 10 })
  *
+ * @example
+ *
+ * randAirport({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAirport<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/alpha-numeric.ts

@@ -16,6 +16,10 @@ import { randNumber } from './number';
  *
  * randAlphaNumeric({ length: 3 })
  *
+ * @example
+ *
+ * randAlphaNumeric({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAlphaNumeric<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/alpha.ts

@@ -14,6 +14,10 @@ import { alphaChars } from './sequence';
  *
  * randAlpha({ length: 3 })
  *
+ * @example
+ *
+ * randAlpha({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAlpha<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/american-football-team.ts

@@ -14,6 +14,10 @@ import { data } from './american-football-team.json';
  *
  * randAmericanFootballTeam({ length: 10 })
  *
+ * @example
+ *
+ * randAmericanFootballTeam({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAmericanFootballTeam<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/animal-type.ts

@@ -14,6 +14,10 @@ import { data } from './animal-type.json';
  *
  * randAnimalType({ length: 10 })
  *
+ * @example
+ *
+ * randAnimalType({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAnimalType<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/arn.ts

@@ -35,6 +35,10 @@ const serviceArn: Record<string, () => string> = {
  *
  * randArn({ length: 10 })
  *
+ * @example
+ *
+ * randArn({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randArn<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/avatar.ts

@@ -15,11 +15,15 @@ interface AvatarOptions extends FakeOptions {
  *
  * @example
  *
+ * randAvatar({ size: 200 }) // default is 100
+ *
+ * @example
+ *
  * randAvatar({ length: 10 })
  *
  * @example
  *
- * randAvatar({ size: 200 }) // default is 100
+ * randAvatar({ length: 10, priority: 'unique' }) // default priority is 'length'
  *
  */
 export function randAvatar<Options extends AvatarOptions = never>(

packages/falso/src/lib/aws-region.ts

@@ -14,6 +14,10 @@ import { data } from './aws-region.json';
  *
  * randAwsRegion({ length: 10 })
  *
+ * @example
+ *
+ * randAwsRegion({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAwsRegion<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/aws-request-id.ts

@@ -14,6 +14,10 @@ import { fake, FakeOptions } from './core/core';
  *
  * randAwsRequestId({ length: 10 })
  *
+ * @example
+ *
+ * randAwsRequestId({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAwsRequestId<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/aws-service.ts

@@ -14,6 +14,10 @@ import { data } from './aws-service.json';
  *
  * randAwsService({ length: 10 })
  *
+ * @example
+ *
+ * randAwsService({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randAwsService<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/baseball-team.ts

@@ -14,6 +14,10 @@ import { data } from './baseball-team.json';
  *
  * randBaseballTeam({ length: 10 })
  *
+ * @example
+ *
+ * randBaseballTeam({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBaseballTeam<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/basketball-team.ts

@@ -14,6 +14,10 @@ import { data } from './basketball-team.json';
  *
  * randBasketballTeam({ length: 10 })
  *
+ * @example
+ *
+ * randBasketballTeam({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBasketballTeam<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/bear.ts

@@ -14,6 +14,10 @@ import { data } from './bear.json';
  *
  * randBear({ length: 10 })
  *
+ * @example
+ *
+ * randBear({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBear<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/between-date.ts

@@ -1,5 +1,6 @@
 import { fake, FakeOptions } from './core/core';
 import { randNumber } from './number';
+import { dateIsUnique } from './core/unique-validators';
 
 interface BetweenOptions extends FakeOptions {
   from: Date | string;
@@ -19,6 +20,10 @@ interface BetweenOptions extends FakeOptions {
  *
  * randBetweenDate({ from: new Date('10/07/2020'), to: new Date(), length: 10 })
  *
+ * @example
+ *
+ * randBetweenDate({ from: new Date('10/07/2020'), to: new Date(), length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBetweenDate<Options extends BetweenOptions = never>(
   options: Options
@@ -39,5 +44,5 @@ export function randBetweenDate<Options extends BetweenOptions = never>(
     );
   };
 
-  return fake(generator, options);
+  return fake(generator, options, { uniqueComparer: dateIsUnique });
 }

packages/falso/src/lib/binary.ts

@@ -13,6 +13,10 @@ import { FakeOptions, fake, getRandomInRange } from './core/core';
  *
  * randBinary({ length: 10 })
  *
+ * @example
+ *
+ * randBinary({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBinary<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/bird.ts

@@ -14,6 +14,10 @@ import { data } from './bird.i18n.json';
  *
  * randBird({ length: 10 })
  *
+ * @example
+ *
+ * randBird({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBird<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/bitcoin-address.ts

@@ -14,6 +14,10 @@ import { randSequence } from './sequence';
  *
  * randBitcoinAddress({ length: 10 })
  *
+ * @example
+ *
+ * randBitcoinAddress({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBitcoinAddress<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/book.ts

@@ -29,11 +29,15 @@ export interface Book {
  *
  * @example
  *
+ * randBook({ category: 'Comedy' })
+ *
+ * @example
+ *
  * randBook({ length: 10 })
  *
  * @example
  *
- * randBook({ category: 'Comedy' })
+ * randBook({ length: 10, priority: 'unique' }) // default priority is 'length'
  *
  */
 export function randBook<Options extends BookOptions = never>(

packages/falso/src/lib/boolean.ts

@@ -13,6 +13,10 @@ import { fake, FakeOptions, randElement } from './core/core';
  *
  * randBoolean({ length: 10 })
  *
+ * @example
+ *
+ * randBoolean({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBoolean<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/brand.ts

@@ -14,6 +14,10 @@ import { data } from './brand.json';
  *
  * randBrand({ length: 10 })
  *
+ * @example
+ *
+ * randBrand({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBrand<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/browser.ts

@@ -14,6 +14,10 @@ import { data } from './browser.json';
  *
  * randBrowser({ length: 10 })
  *
+ * @example
+ *
+ * randBrowser({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randBrowser<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/cardinal-direction.ts

@@ -14,6 +14,10 @@ import { data } from './cardinal-direction.json';
  *
  * randCardinalDirection({ length: 10 })
  *
+ * @example
+ *
+ * randCardinalDirection({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randCardinalDirection<Options extends FakeOptions = never>(
   options?: Options

packages/falso/src/lib/cat.ts

@@ -14,6 +14,10 @@ import { data } from './cat.json';
  *
  * randCat({ length: 10 })
  *
+ * @example
+ *
+ * randCat({ length: 10, priority: 'unique' }) // default priority is 'length'
+ *
  */
 export function randCat<Options extends FakeOptions = never>(
   options?: Options