thingies

Useful TypeScript utilities.

- __Code reference__.
- __Test coverage__.

Menu

- base64 — Base64 encoding end decoding functions for Node.js.

---

- Cache — implementation of local memory cache for database records. Can cache
retrieved database records for few dozen seconds and has garbage collection logic
which clears the memory of old items after some time.

---

- Defer — an inverted Promise, an object which allows you to imperatively
control the behavior of a Promise.

---

- @debug — a class method or function decorator, which logs
the input and output of the function in non-production environments.

---

- hash — a fast and simple utility, which hashes a string to an integer. Useful
for generating a shard index of a record based on its ID.

---

- LruMap — tiny and fast Least Recently Used Cache implemented on top of the Map class.
The default limit is around 1 billion items (2^30 - 1).

---

- LruTtlMap — tiny and fast Least Recently Used Cache with expiration timestamp
stored for each entry implemented on top of the LruMap class.

---

- LruCache — a Least Recently Used Cache implemented using Object and doubly linked list.
The default limit is around 1 billion items (2^30 - 1).

---

- normalizeEmail — normalizes email by stripping out . and + characters and
removing everything after the + character and lower-casing the e-mail. Useful for
getting an e-mail into a common form when throttling requests by e-mail.

---

- of — returns result of a Promise as a 3-tuple [value, error, isError].

---

- promiseMap — maps a list of values to an async function and waits until
all results complete execution.

---

- randomStr — generates a random string of given size. Alphabet for character
picking can be provided. Useful for generating random database record IDs.

---

- TimedQueue — a queue which can be flushed manually, or which flushes
automatically when the number of queued items reaches a threshold or when a timeout
expires since the first item was added to the queue. Useful for batching multiple
messages or requests for bulk processing.

---

- TimedState — works similar to TimedQueue, but instead of keeping track of
all items pushed, it invokes a reducer to update the state with the information from
the last pushed item.

---

- tick — returns a Promise which resolves after a given number of milliseconds,
useful for releasing the event loop for a short period of time, await tick(5).

---

- until — waits for some condition to become true await until(() => condition),
useful when waiting for some asynchronous task to happen in a test.

---

- concurrency — limits the number of concurrent executions of asynchronous
code. concurrencyDecorator limits the number of concurrent executions of a
class method.

---

- codeMutex — a mutex which can be used to synchronize code execution. Code
wrapped by this mutex will execute only one at a time, for all parallel calls to
the same mutex.

- @mutex and mutex() — same as codeMutex, but can be used as a decorator
or a higher order function.

---

- once — a class method decorator, which limits method execution to once
per instance. Returns the result of the first execution for all subsequent calls.

---

- loadCss — loads a CSS file into the DOM, given a URL. Does nothing on the
server.

---

- dataUri — converts a string to a data URI.

---

- FanOut — a class which allows to fan out a single event to multiple
listeners. Useful for implementing event emitters. In just 12 lines of code.

---

- createRace — constructs a "race" function, which takes a function as
a single argument, the function is executed immediately only if no other
function is currently executing. If another function is currently executing,
the current function is discarded.

---

- xorShift32 — generates random 32-bit integers using the very fast xorshift
algorithm. makeXorShift32(seed) returns a function which can be used to generate
random numbers.

---

- Locks — a lock manager, which allows to acquire an exclusive lock in
browser across multiple tabs. Acquires a lock by writing to localStorage for
a specific key for a specified duration.

---

- hasKeys — returns true if an object has at lest on key.

---

- timeout — waits for async code to complete within a given time frame,
otherwise throws an error.

License

MIT © Vadim Dalecky.