thingies
v2.5.0
Published
Useful TypeScript utilities.
Downloads
10,640,025
Readme
thingies
Useful TypeScript utilities.
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 invertedPromise
, an object which allows you to imperatively control the behavior of aPromise
.
@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 theMap
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 theLruMap
class.
LruCache
— a Least Recently Used Cache implemented usingObject
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 aPromise
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 toTimedQueue
, 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 aPromise
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 trueawait 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
andmutex()
— same ascodeMutex
, 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 tolocalStorage
for a specific key for a specified duration.
hasKeys
— returnstrue
if an object has at lest on key.
timeout
— waits for async code to complete within a given time frame, otherwise throws an error.