Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/supabase-community/copycat
Generate deterministic fake values: The same input will always generate the same fake-output.
https://github.com/supabase-community/copycat
database-seeding deterministic fake fake-data fake-data-generator
Last synced: about 18 hours ago
JSON representation
Generate deterministic fake values: The same input will always generate the same fake-output.
- Host: GitHub
- URL: https://github.com/supabase-community/copycat
- Owner: supabase-community
- License: mit
- Created: 2022-04-26T08:36:45.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-11T08:31:39.000Z (2 months ago)
- Last Synced: 2024-12-08T20:59:25.677Z (5 days ago)
- Topics: database-seeding, deterministic, fake, fake-data, fake-data-generator
- Language: TypeScript
- Homepage: https://www.snaplet.dev
- Size: 2.94 MB
- Stars: 841
- Watchers: 9
- Forks: 31
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 
```js
import { copycat } from '@snaplet/copycat'
copycat.email('foo')
// => '[email protected]'
copycat.email('bar')
// => '[email protected]'
copycat.email('foo')
// => '[email protected]'
```
## Motivation
### The problem
Many of the use cases we aim to solve with [snaplet](https://snaplet.dev/) involves anonymizing sensitive information. In practice, this involves replacing each bit of sensitive data with something else that _resembles_ the original value, yet does not allow the original value to be inferred.
To do this, we initially turned to [faker](https://fakerjs.dev/) for replacing the sensitive data with fake data. This approach took us quite far. However, we struggled with getting the replacement data to be _deterministic_: we found we did not have enough control over how results are generated to be able to easily ensure that for each value of the original data we wanted to replace, we'd always get the same replacement value out.
Faker allows one to seed a pseudo-random number generator (PRNG), such that the same sequence of values will be generated every time. While this means the sequence is deterministic, the problem was we did not have enough control over where the next value in the sequence was going to be used. Changes to the contents or structure in the original data we're replacing and changes to how we are using faker both had an effect on the way we used this sequence, which in turn had an effect on the resulting replacement value for any particular value in the original data. In other words, we had determinism, but not in a way that is useful for our purpose.
### The solution
What we were really needing was not the same _sequence_ of generated values every time, but the same _mapping_ to generated values every time.
This is exactly what we designed `Copycat` to do. For each method provided by Copycat, a given input value will always map to the same output value.
```js
import { copycat } from '@snaplet/copycat'
copycat.email('foo')
// => '[email protected]'
copycat.email('bar')
// => '[email protected]'
copycat.email('foo')
// => '[email protected]'
```
Copycat works statelessly: for the same input, the same value will be returned regardless of the environment, process, call ordering, or any other external factors.
Under the hood, Copycat hashes the input values (using [SipHash](https://en.wikipedia.org/wiki/SipHash)), with the intention of making it computationally infeasible for the input values to be inferred from the output values.
### Alternative approaches
It is still technically possible to make use of faker or similar libraries that offer deterministic PRNG - with some modification. That said, these solutions came with practical limitations that we decided made them less viable for us:
* It is possible to simply seed the PRNG for every identifier, and then use it to generate only a single value. This seems to be a misuse of these libraries though: there is an up-front cost to seeding these PRNGs that can be expensive if done for each and every value to be generated. [Here are benchmarks](https://gist.github.com/justinvdm/eaae3a59c1a1790704db9674e1785afa) that point to this up-front cost.
* You can generate a sequence of N values, hash identifiers to some integer smaller than N, then simply use that as an index to lookup a value in the sequence. This can even be done lazily. Still, you're now limiting the uniqueness of the values to N. The larger N is, the larger the cost of keeping these sequences in memory, or the more computationally expensive it is if you do not hold onto the sequences in memory. The smaller N is, the less unique your generated values are.
Note though that for either of these approaches, hashing might also still be needed to make it infeasible for the inputs to be inferred from the outputs.
## API Reference
### Overview
All Copycat functions take in an `input` value as their first parameter:
```js
import { copycat } from '@snaplet/copycat'
copycat.email('foo')
// => '[email protected]'
```
The given input can be any JSON-serializable value. For any two calls to the same function, the input given in each call serializes down to the same value and the same output will be returned.
Note that unlike `JSON.stringify()`, object property ordering is not considered.
## Working with PII (Personal Identifiable Information)
If you're using sensitive information as input to Copycat, the fact that Copycat makes use of [SipHash](https://en.wikipedia.org/wiki/SipHash) means it is difficult for the original input value to be inferred from the output value - it is computationally infeasible.
```js
// It is difficult to infer 'Some sensitive input' from 'Rhianna Ebert'
copycat.fullName('Some sensitive input')
// -> 'Rhianna Ebert'
```
That said, there is still something we need to watch out for: with enough guessing, the input values can still be figured out from the output values.
Lets say we replaced all the first names in some table of data. Included in this data was the name `'Susan'`, which was replaced with `'Therese'`:
```js
copycat.firstName('Susan') // -> 'Therese'
```
While the attacker is able to see the name `Therese`, it is difficult for them to look at Copycat's code, and figure out `'Susan'` from `'Therese'`. But the attacker knows they're dealing with first names, and they have access to the Copycat library. What they can do, is input a list of first names into Copycat, until they find a matching name.
Let's say they input the name `'John'`. The result is `'April'`, which does not match `'Therese'`, so they move on. They next try `'Sarah'`, which maps to `'Florencio'` - again no match, they move on. They next try `Susan`, which maps to the name they see - `Therese`. This means they have a match, and now know that the original name was `Susan`:
```js
copycat.firstName('John') // -> 'April', no match
copycat.firstName('Sarah') // -> 'Florencio', no match
copycat.firstName('Susan') // -> 'Therese', match!
```
To prevent this, you'll need to give copycat a key to use when hashing the values:
```js
// store this somewhere safe
const key = copycat.generateHashKey('g9u*rT#!72R$zl5e')
copycat.fullName('foo')
// => 'Mohamed Weissnat'
copycat.setHashKey(key)
copycat.fullName('foo')
// => 'Bertha Sauer'
```
The idea is that while Copycat's code is publicly known, the key isn't publically known. This means that even though attackers have access to Copycat's
code, they are not able to figure out which inputs map to which outputs, since they do not have access to the key.
### `faker`
A re-export of `faker` from [`@faker-js/faker`](https://github.com/faker-js/faker). We do not alter faker in any way, and do not seed it.
### `fictional`
A re-export of [`fictional`](https://github.com/oftherivier/fictional), a library used under the hood by copycat for mapping inputs to primitive values.
### `copycat.scramble(input[, options])`
Takes in an `input` value, and returns a value of the same type and length, but with each character/digit replaced with a different character/digit.
For string, the replacement characters will be in the same character range:
* By default, spaces are preserved (see `preserve` option below)
* Lower case ASCII characters are replaced with lower case ASCII letters
* Upper case ASCII characters are replaced with upper case ASCII letters
* Digits are replaced with digits
* Any other ASCII character in the code point range 32 to 126 (0x20 - 0x7e) is replaced with either an alphanumeric character, or `_`, `-`, or `+`
* Any other character is replaced with a Latin-1 character in the range of (0x20 - 0x7e, or 0xa0 - 0xff)
```js
copycat.scramble('Zakary Hessel')
// => 'Vqjmtp Rkbqyl'
```
If a number is given, each digit will be replaced, and the floating point (if relevant) will be preserved:
```js
copycat.scramble(782364.902374)
// => 239724.505138
```
If an object or array is given, the values inside the object or array will be recursively scrambled:
```js
copycat.scramble({
a: [
{
b: 23,
c: 'foo',
},
],
})
// => { a: [ { b: 10, c: 'mem' } ] }
```
If a date is given, each segment in the date will be scrambled:
```js
copycat.scramble(new Date('2022-10-25T19:08:39.374Z'))
// => {}
```
If a boolean or null value is given, the value will simply be returned.
If a value of any other type is given, an error will be thrown
#### `options`
- **preserve**: An array of characters that should remain the same if present in the given input string
```js
copycat.scramble('[email protected]', { preserve: ['@', '.'] })
// => '[email protected]'
```
### `copycat.oneOf(input, values[, options])`
Takes in an [`input`](#input) value and an array of `values`, and returns an item in `values` that corresponds to that `input`:
```js
copycat.oneOf('foo', ['red', 'green', 'blue'])
// => 'green'
```
### `copycat.oneOfString(input, values[, options])`
Like `oneOf()`, takes in an [`input`](#input) value and an array of `values`, and returns an item in `values` that corresponds to that `input`. However, `values` needs to be an array of _string_ values, and only values within the character limit set by the `limit` option will be picked.
```js
copycat.oneOfString('foo', ['short', 'loooooooong'], { limit: 6 })
// => 'short'
```
#### `options`
- **`limit`**: If the `values` are strings, the picked value will be constrained to be less than `limit`'s amount of characters
- **`fallback: string | (input) => string`**: When `limit` is specified but no values match the given `limit`, fallback is called with the given input value.
#### `options`
- **`limit`**: If the `values` are strings, the picked value will be constrained to be less than or equal `limit`'s amount of characters
- **`fallback: string | `**: When `limit` is specified but no values match the given `limit`, fallback will be used.
```js
copycat.oneOfString('foo', ['short', 'loooooooong'], { limit: 2 })
// => 'ta'
```
### `copycat.someOf(input, range, values)`
Takes in an [`input`](#input) value and an array of `values`, repeatedly picks items from that array a number of times within the given range that corresponds to that `input`. Each item will be picked no more than once.
```js
copycat.someOf('foo', [1,2], ['paper', 'rock'])
// => [ 'rock' ]
```
### `copycat.int(input[, options])`
Takes in an [`input`](#input) value and returns an integer.
```js
copycat.int('foo')
// => 5208378699696662
```
#### `options`
- **`min=0` and `max=Infinity`:** the minimum and maximum possible values for returned numbers
### `copycat.bool(input)`
Takes in an [`input`](#input) value and returns a boolean.
```js
copycat.bool('foo')
// => false
```
### `copycat.float(input[, options])`
Takes in an [`input`](#input) value and returns a number value with both a whole and decimal segment.
```js
copycat.float('foo', { min: 0, max: 1 })
// => 0.5782461953370469
```
### `copycat.char(input)`
Takes in an [`input`](#input) value and returns a string with a single character.
```js
copycat.char('foo')
// => 'a'
```
The generated character will be an alphanumeric: lower and upper case ASCII letters and digits 0 to 9.
### `copycat.digit(input)`
Takes in an [`input`](#input) value and returns a string with a single digit value.
```js
copycat.digit('foo')
// => '2'
```
### `copycat.hex(input)`
Takes in an [`input`](#input) value and returns a string with a single hex value.
```js
copycat.hex('foo')
// => '6'
```
#### `options`
- **`min=0` and `max=Infinity`:** the minimum and maximum possible values for returned numbers
### `copycat.dateString(input[, options])`
Takes in an [`input`](#input) value and returns a string representing a date in [ISO 8601](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date/toISOString) format.
```js
copycat.dateString('foo')
// => '2002-03-15T14:10:10.000Z'
```
#### `options`
- **`minYear=1980` and `maxYear=2019`:** the minimum and maximum possible year values for returned dates
- **`min=new Date(Date.UTC(1980, 0, 1)): Date | string amd max=new Date(Date.UTC(2019, 11, 31, 23, 59, 59, 999)): Date | string`:** the minimum and maximum possible values.
- **`min: Date | string amd max: Date | string`:** alternatively to `minYear` and `maxYear` you can provide exact values.
### `copycat.uuid(input)`
Takes in an [input](#input) and returns a string value resembling a [uuid](https://en.wikipedia.org/wiki/Universally_unique_identifier).
```js
copycat.uuid('foo')
// => '2fabe7f3-6216-5e0b-a885-4fb9951363f5'
```
### `copycat.email(input)`
Takes in an [input](#input) and returns a string value resembling an email address.
```js
copycat.email('foo')
// => '[email protected]'
```
#### `options`
- **`limit`:** Constrain generated values to be less than or equal to `limit` number of chars
- **`domain`:** Constrain the generated email addresses to use the given `domain`
```js
copycat.email('foo', { domain: 'acme.org' })
// => '[email protected]'
```
### `copycat.url(input)`
Takes in an [input](#input) and returns a string value resembling a URL.
```js
copycat.url('foo')
// => 'https://noisy-shoe.biz'
```
#### `options`
- **`limit`:** Constrain generated values to be less than or equal to `limit` number of chars
### `copycat.firstName(input)`
Takes in an [input](#input) and returns a string value resembling a first name.
```js
copycat.firstName('foo')
// => 'Morris'
```
#### `options`
- **`limit`:** Constrain generated values to be less than or equal to `limit` number of chars
### `copycat.lastName(input)`
Takes in an [input](#input) and returns a string value resembling a last name.
```js
copycat.lastName('foo')
// => 'Gleichner'
```
#### `options`
- **`limit`:** Constrain generated values to be less than or equal to `limit` number of chars
### `copycat.fullName(input)`
Takes in an [input](#input) and returns a string value resembling a full name.
```js
copycat.fullName('foo')
// => 'Bertha Sauer'
```
#### `options`
- **`limit`:** Constrain generated values to be less than or equal to `limit` number of chars
### `copycat.phoneNumber(input[, options])`
Takes in an [input](#input) and returns a string value resembling a [phone number](https://en.wikipedia.org/wiki/MSISDN).
```js
copycat.phoneNumber('foo')
// => '+208438699696662'
```
```js
copycat.phoneNumber('foo', { prefixes: ['+3319900', '+3363998'], length: 11 })
// => '+3363998462'
```
**note** The strings _resemble_ phone numbers, but will not always be valid. For example, the country dialing code may not exist, or for a particular country, the number of digits may be incorrect. Please let us know if you need valid
phone numbers, and feel free to contribute :)
#### `options`
- **`length={ min: 12, max: 16 }: { min: number, max: number } | number`:** Constrain generated values to the given length. If `length` is given as a `number` (e.g. `{ length: 16 })`, the generated values will have exactly this length. If `length` is given as `{ min: number, max: number }` (e.g. `{ length: { min: 12, max: 16 } }`), the generated values will have a length greater than or equal to `min`, and less than or equal to `max` (i.e. `min <= length <= max`)
- **`prefixes=[]: string[]`:** An array of strings that should be used as prefixes for the generated phone numbers. Allowing to control the country dialing code.
### `copycat.username(input)`
Takes in an [input](#input) and returns a string value resembling a username.
```js
copycat.username('foo')
// => 'Albin.Goyette47922'
```
#### `options`
- **`limit`:** Constrain generated values to be less than or equal to `limit` number of chars
### `copycat.unique(input, method, store, options)`
The `unique` function is tailored to maintain uniqueness of values after they have undergone a specific transformation.
This method is especially useful when the transformed values need to be unique, regardless of whether the input values are identical.
It will do so by trying to generate a new value multiples times (up to attempts time) until it finds a unique one.
**note** This method will try its best to generate unique values, but be aware of these limitations:
1. The uniqueness is not guaranteed, but the probability of generating a duplicate is lower as the number of attempts increases.
2. On the contrary of the other methods, the `unique` method is not stateless. It will store the generated values in the `store` object to ensure uniqueness.
Meaning that the deterministic property over input is not guaranteed anymore. Now the determinism is based over a combination of:
- the `input` value
- the state of the `store` object
- the number of `attempts`
3. The `unique` method as it alter the global copycat hashKey between attemps before restoring the original one, it is not thread safe.
4. If duplicates exists in the passed `input` accross calls, the method might hide those duplicates by generating a unique value for each of them.
If you want to ensure duplicate value for duplicate input you should use the `uniqueByInput` method.
#### `parameters`
- **`input`** (_Input_): The seed input for the generation method.
- **`method`** (_Function_): A deterministic function that takes `input` and returns a value of type `T`.
- **`store`** (_Store_): A store object to track generated values and ensure uniqueness. It must have `has(value: T): boolean` and `add(value: T): void` methods.
- **`options`** (_UniqueOptions_): An optional configuration object for additional control.
#### `options`
- **`attempts`** (_number_): The maximum number of attempts to generate a unique value. Defaults to 10.
- **`attemptsReached`** (_Function_): An optional callback function that is called when the maximum number of attempts is reached.
```js
// Define a method to generate a value
const generateValue = (seed) => {
return copycat.int(seed, { max: 3 });
};
// Create a store to track unique values
const store = new Set();
// Use the unique method to generate a unique number
copycat.unique('exampleSeed', generateValue, store);
// => 3
copycat.unique('exampleSeed1', generateValue, store);
// => 1
copycat.unique('exampleSeed', generateValue, store);
// => 0
```
### `copycat.uniqueByInput(input, method, inputStore, resultStore, options)`
The `uniqueByInput` function is designed to generate unique values while preserving duplicates for identical inputs.
It is particularly useful in scenarios where input consistency needs to be maintained alongside the uniqueness of the transformed values.
- **Preserving Input Duplication**: If the same input is provided multiple times, `uniqueByInput` ensures that the transformed value is consistently the same for each occurrence of that input.
- **Uniqueness Preservation**: For new and unique inputs, `uniqueByInput` employs the `unique` method to generate distinct values, avoiding duplicates in the `resultStore`.
#### `parameters`
- **`input`** (_Input_): The seed input for the generation method.
- **`method`** (_Function_): A deterministic function that takes `input` and returns a value of type `T`.
- **`inputStore`** (_Store_): A store object to track the inputs and ensure consistent output for duplicate inputs.
- **`resultStore`** (_Store_): A store object to track the generated values and ensure their uniqueness.
- **`options`** (_UniqueOptions_): An optional configuration object for additional control.
#### `options`
- **`attempts`** (_number_): The maximum number of attempts to generate a unique value after transformation. Defaults to 10.
- **`attemptsReached`** (_Function_): An optional callback function that is invoked when the maximum number of attempts is reached.
```js
// Define a method to generate a value
const method = (seed) => {
return copycat.int(seed, { max: 3 });
};
// Create stores to track unique values and inputs
const resultStore = new Set();
const inputStore = new Set();
// Generate a unique number or retrieve the existing one for duplicate input
copycat.uniqueByInput('exampleSeed', method, inputStore, resultStore);
// => 3
copycat.uniqueByInput('exampleSeed1', method, inputStore, resultStore);
// => 1
copycat.uniqueByInput('exampleSeed', method, inputStore, resultStore);
// => 3
```
### `copycat.password(input)`
Takes in an [`input`](#input) value and returns a string value resembling a password.
```js
copycat.password('foo')
// => 'orq[s$^zgx6L'
```
**Note:** not recommended for use as a personal password generator.
### `copycat.city(input)`
Takes in an [input](#input) and returns a string value representing a city.
```js
copycat.city('foo')
// => 'Rockford'
```
### `copycat.country(input)`
Takes in an [input](#input) and returns a string value representing a country.
```js
copycat.country('foo')
// => 'Tajikistan'
```
### `copycat.streetName(input)`
Takes in an [input](#input) and returns a string value representing a fictitious street name.
```js
copycat.streetName('foo')
// => 'Jewel Forge'
```
### `copycat.streetAddress(input)`
Takes in an [input](#input) and returns a string value representing a fictitious street address.
```js
copycat.streetAddress('foo')
// => '11 Maximilian Isle'
```
### `copycat.postalAddress(input)`
Takes in an [input](#input) and returns a string value representing a fictitious postal address.
```js
copycat.postalAddress('foo')
// => '114 Pfeffer Bypass, Newport News 1276, Armenia'
```
### `copycat.countryCode(input)`
Takes in an [input](#input) and returns a string value representing a country code.
```js
copycat.countryCode('foo')
// => 'GB'
```
### `copycat.timezone(input)`
Takes in an [input](#input) and returns a string value representing a time zone.
```js
copycat.timezone('foo')
// => 'America/Caracas'
```
### `copycat.word(input)`
Takes in an [`input`](#input) value and returns a string value resembling a fictitious word.
```js
copycat.word('foo')
// => 'Explicet'
```
#### `options`
- **`capitalize=true`:** whether or not the word should start with an upper case letter
- **`minSyllables=1` and `maxSyllables=4`:** the minimum and maximum possible number of syllables that returned words will contain
```js
copycat.word('id-2', {
minSyllables: 3,
maxSyllables: 6,
unicode: 0.382
})
// => 'Nullam'
```
### `copycat.words(input)`
Takes in an [`input`](#input) value and returns a string value resembling fictitious words.
```js
copycat.words('foo')
// => 'Aequo ophortatis'
```
#### `options`
- **`min=2` and `max=3`:** the minimum and maximum possible number of words that returned strings will contain.
- **`capitalize='first'`:** whether or not the words should start with upper
case letters. If `true` or `'all'` is given, each string returned will start with an upper case letter in each word. If `'first'` is given, for each string returned, only the first word will start with an upper case letter. If `false` is given, each string returned will always contain only lower case letters.
- **`minSyllables=1` and `maxSyllables=4`:** the minimum and maximum possible number of syllables that returned words will contain
### `copycat.sentence(input)`
Takes in an [`input`](#input) value and returns a string value resembling a sentence of fictitious words.
```js
copycat.sentence('foo')
// => 'Poetista graecis ne vel loque sic horum, eo quae aliquaque ut multo.'
```
#### `options`
- **`minClauses=1` and `maxClauses=2`:** the minimum and maximum possible number of clauses that a returned sentence will contain.
- **`minWords=5` and `maxWords=8`:** the minimum and maximum possible number of words that each clause will contain.
- **`minSyllables=1` and `maxSyllables=4`:** the minimum and maximum possible number of syllables that returned words will contain
### `copycat.paragraph(input)`
Takes in an [`input`](#input) value and returns a string value resembling a paragraph of fictitious words.
```js
copycat.paragraph('foo')
// => 'Et modo lucilias legatomnem et. Quis ratio iudicur ut defuitur quod interessar endis, doloria romandum athenisse explicem quia. Expeten quam hoc ex amus ant sive, providintem ad claudicur torquato nes nihil nec ut. Audiri dicerea summum arisset ne exceperem tam si, amartifex doloris nam quae ipsum. Et causa iudicitat extremum endam tota tum antippus, de vidi videbo rerum ut. Affere ab mundi nimium summa partemerror causae, his am semperfruique in sapiens gloriatur et dicenim.'
```
#### `options`
- **`minSentences=3` and `maxSentences=7`:** the minimum and maximum possible number of sentences that a returned paragraph will contain.
- **`minClauses=1` and `maxClauses=2`:** the minimum and maximum possible number of clauses that each sentence will contain.
- **`minWords=5` and `maxWords=8`:** the minimum and maximum possible number of words that each clause will contain.
- **`minSyllables=1` and `maxSyllables=4`:** the minimum and maximum possible number of syllables that returned words will contain
### `copycat.ipv4(input)`
Takes in an [`input`](#input) value and returns a string value resembling an [IPv4](https://en.wikipedia.org/wiki/IPv4) address.
```js
copycat.ipv4('foo')
// => '215.127.85.213'
```
### `copycat.mac(input)`
Takes in an [`input`](#input) value and returns a string value resembling a [MAC](https://en.wikipedia.org/wiki/MAC_address) address.
```js
copycat.mac('foo')
// => '96:d4:46:1a:e9:88'
```
### `copycat.userAgent(input)`
Takes in an [`input`](#input) value and returns a string value resembling a browser [User Agent](https://en.wikipedia.org/wiki/User_agent) string.
```js
copycat.userAgent('foo')
// => 'Mozilla/5.0 (Windows NT 6.1; WOW64; rv:14.4) Gecko/20100101 Firefox/4284.1468.5020'
```
**note** For simplicity, this is currently working off of a list of 500 pre-defined user agent strings. If this is too limiting
for your needs and you need something more dynamic than this, please let us know, and feel free to contribute :)
### `copycat.times(input, range, fn)`
Takes in an [`input`](#input) value and a function `fn`, calls that function repeatedly (each time with a unique input) for a number of times within the given `range`, and returns the results as an array:
```js
copycat.times('foo', [4, 5], copycat.word)
// => [ 'Conspecta', 'Mihi', 'Fuisse', 'Philos', 'Divelistius' ]
```
As shown above, `range` can be a tuple array of the minimum and maximum possible number of times the maker should be called. It can also be given as a number, in which case `fn` will be called exactly that number of times:
```js
copycat.times('foo', 2, copycat.word)
// => [ 'Pugnari', 'Conspecta' ]
```
### `copycat.setHashKey(key)`
Takes in a key and changes copycat's internal state to use it when mapping inputs to output values.
`key` can either be a string, or an array of four 32-bit integers (as is returned by [`copycat.generateHashKey()`](#api-copycat-generateHashKey)). If the key is a string is given, four 32-bit integers will be derived from it.
See [Working with PII](#pii) for more.
```js
const key = copycat.generateHashKey('Lhz1Xe7l$vPIwWr3')
copycat.setHashKey(key)
```
### `copycat.generateHashKey(secret)`
Takes in a secret value, and returns an array with four 32-bit integer number values:
```js
// Note: If the secret is shorter or longer than 16 byte characters seeding key will be derivated from it.
copycat.generateHashKey('Lhz1Xe7l$vPIwWr3')
// => Uint32Array(4) [ 830105676, 1815569752, 1230009892, 863131511 ]
```
See [Working with PII](#pii) for more.