asyncforge
Version:
`asyncforge` allows you to remove singletons from your codebase with the use of [`AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage).
93 lines (68 loc) • 1.67 kB
Markdown
`asyncforge` allows you to remove singletons from your codebase with the
use of [`AsyncLocalStorage`](https://nodejs.org/api/async_context.html#class-asynclocalstorage).
It provides helpers to build Next.js-style helpers to access "singletons".
```sh
npm i asyncforge
```
```js
import { create, memo } from 'asyncforge.js'
const a = memo()
const b = memo()
const store = create()
store.run(() => {
a.set(42)
b.set(123)
// simulate an event loop turn
setImmediate(() => {
console.log('-- first event loop turn --')
console.log('a', a())
console.log('b', b())
})
})
create(() => {
a.set(43)
b.set(321)
// simulate an event loop turn
setImmediate(() => {
console.log('-- second event loop turn --')
console.log('a', a())
console.log('b', b())
store.run(() => {
setImmediate(() => {
console.log('-- third event loop turn --')
console.log('a', a())
console.log('b', b())
})
})
setImmediate(() => {
store.enterWith()
console.log('-- fourth event loop turn --')
console.log('a', a())
console.log('b', b())
})
})
})
```
You can call the `asyncforge` functions in a type-safe way:
```ts
import { create, memo } from "asyncforge";
const memoNum = memo<number>();
const test = memo<string>();
const store = create()
store.run(() => {
// This is okay for TypeScript, since you're passing a number
memoNum.set(123);
// This will not build
memoNum.set('wrong');
})
store.run(() => {
// The `result` var will be of type `number`
const result = memoNum()
})
```
MIT